hapi-alexa

Hapi plugin for building Amazon Alexa apps on NodeJS.

Installation

Install with npm

$ npm install --save hapi-alexa

Example Usage

Setup a new hapi app: Hapijs

Install Plugin:

    var Hapi = require('hapi');
    var server = new Hapi.Server();

    server.connection({
        port: 5000
    });

    server.register([{
    register: require('hapi-alexa'),
    options: {
       speechlet: {
           setup: function(done){
               done({ response: 'setup' });
           },
           tearDown: function(done) {
               done({ response: 'goodbye' });
           },
           HelloWorld: function(slot1) {
               done({response: 'hello world'});
           }
       }
    }
    }],
    function(err) {
        if (err) {
            console.error(err);
        }
        else {
            server.start(function() {
            console.info('Server started at ' + server.info.uri);
        });
    }
    });

    server.start(function() {
        console.log('Server running at:', server.info.uri);
    });

Implementing speechlet

You need to implement a javascript object to represent your speechlet. This object should respond with a json object as per the SDK documentation.

The service will automatically map intents to functions on your speechlet. You will also need to add a setup and tearDown function to handle launch and exit requests respectively.

Example "Hello World" speechlet:

module.exports = function() {
    return {
        setup: function(done) {
            done({
                outputSpeech: {
                    type: 'PlainText',
                    text: "Hello World"
                },
                shouldEndSession: false
            });
        },
        helloIntent: function(name, done) { // maps hello intent with a "name" slot
            done({
                outputSpeech: {
                    type: 'PlainText',
                    text: 'Hello ' + name
                },
                shouldEndSession: false;
            });
        },
        tearDown: function(done) {
            done({
                outputSpeech: {
                    type: 'PlainText',
                    text: 'Good bye.'
                },
                shouldEndSession: true
            });
        }
    }
}