fremail / ask-sdk-router

Simple Router for Alexa Skill Kit SDK v2 on Node.js

Router for Alexa Skill Kit SDK v2

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);