ask-sdk-router

    2.1.0 • Public • Published

    Router for Alexa Skill Kit SDK v2

    Min Node Version Build Status Code Coverage Vulnerabilities License

    When you need more than you have.

    This library extends the routing in Alexa Skill Kit SDK v2. It has several simple methods to manage the process of request handling.

    In two words, it tests canHandle() function of each request handler - does the same as built-in ASk SDK routing, but with methods to go to the next suitable handler or restart routing.

    Please see CHANGELOG and make sure to read UPGRADING when upgrading from a previous version.

    Installation

    npm i --save ask-sdk-router

    Usage

    Init Router with object containing all your request handlers. Very close to way you did it in skillBuilder.addRequestHandlers(), but you have to wrap all the items in one object.

    const Router = require('ask-sdk-router');
     
    const router = new Router({
      // list your request handlers here like you did it in skillBuilder.addRequestHandlers()
      SessionEndedRequestHandler,
      CancelIntentHandler,
      HelpIntentHandler,
      FallbackHandler,
      // also you can use another syntax for the object
      'CrazyJump': CrazyJumpHandler,
      10: TenthHandler,
    });
     
    exports.handler = skillBuilder
      .addRequestHandlers(router.handle())
      .addRequestInterceptors(router.interceptor())
      .lambda();

    Now you can use the router in any part of your skill! The router is stored in request attributes with router key.

    const router = handlerInput.attributesManager.getRequestAttributes().router;
    return await router.next(handlerInput);

    What router can do?

    Go to next suitable request handler

    return await router.next(handlerInput);

    Go to first suitable request handler from beginning

    return await router.restart(handlerInput);

    Jump to selected request handler (from v2.0.0)

    // jump to CancelIntentHandler without canHandle test
    return await router.jumpTo(handlerInput, 'CancelIntentHandler');
     
    // jump to CrazyJumpHandler only if canHandle returns true, otherwise jumpTo() will return false
    return await router.jumpTo(handlerInput, 'CrazyJump', true);

    Install

    npm i ask-sdk-router

    DownloadsWeekly Downloads

    4

    Version

    2.1.0

    License

    MIT

    Unpacked Size

    14.3 kB

    Total Files

    12

    Last publish

    Collaborators

    • fremail