Initial commit

.gitattributes

@@ -0,0 +1,12 @@
+* text=auto
+
+/.github export-ignore
+/tests export-ignore
+.gitattributes export-ignore
+.gitignore export-ignore
+.php_cs export-ignore
+.styleci.yml export-ignore
+.travis.yml export-ignore
+phpunit.xml export-ignore
+CHANGELOG.md export-ignore
+CONTRIBUTING.md export-ignore

.gitignore

@@ -0,0 +1,5 @@
+.idea/
+.DS_Store
+composer.lock
+.php_cs.cache
+/vendor/

.php_cs

@@ -0,0 +1,8 @@
+<?php
+
+// Needed to get styleci-bridge loaded
+require_once __DIR__.'/vendor/sllh/php-cs-fixer-styleci-bridge/autoload.php';
+
+use SLLH\StyleCIBridge\ConfigBridge;
+
+return ConfigBridge::create();

.styleci.yml

@@ -0,0 +1,6 @@
+preset: laravel
+
+enabled:
+  - unalign_double_arrow
+
+linting: true

.travis.yml

@@ -0,0 +1,19 @@
+language: php
+
+php:
+  - 7.0
+  - 7.1
+
+before_script:
+  - travis_retry composer self-update --preview
+  - travis_retry composer install --prefer-dist --no-interaction
+
+script:
+  - vendor/bin/phpunit --coverage-clover=coverage.xml
+
+before_install:
+  - pip install --user codecov
+  - echo "extension = redis.so" >> ~/.phpenv/versions/$(phpenv version-name)/etc/php.ini
+
+after_success:
+  - codecov

CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+Contributions are **welcome** and will be fully **credited**. We accept contributions via Pull Requests on [Github](https://github.com/botman/driver-facebook).
+
+## Pull Requests
+
+- **[PSR-2 Coding Standard.](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md)** The easiest way to apply the conventions is to install [PHP CS Fixer](https://github.com/FriendsOfPHP/PHP-CS-Fixer).
+- **Add tests!** Your patch won't be accepted if it doesn't have tests.
+- **Document any change in behaviour.** Make sure the `README.md` and any other relevant documentation are kept up-to-date.
+- **Consider our release cycle.** We try to follow [SemVer v2.0.0](http://semver.org/). Randomly breaking public APIs is not an option.
+- **Create feature branches.** Don't ask us to pull from your master branch.
+- **One pull request per feature.** If you want to do more than one thing, send multiple pull requests.
+- **Send coherent history.** Make sure each individual commit in your pull request is meaningful. If you had to make multiple intermediate commits while developing, please [squash them](http://www.git-scm.com/book/en/v2/Git-Tools-Rewriting-History#Changing-Multiple-Commit-Messages) before submitting.
+
+## Running Tests
+
+```bash
+$ phpunit
+```
+
+
+*Happy coding!*

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2017 Marcel Pociot
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,21 @@
+# BotMan Amazon Alexa Driver
+
+BotMan driver to connect Amazon Alexa with [BotMan](https://github.com/botman/botman)
+
+[![Latest Version on Packagist](https://img.shields.io/packagist/v/botman/driver-amazon-alexa.svg?style=flat-square)](https://packagist.org/packages/botman/driver-amazon-alexa)
+[![Build Status](https://travis-ci.org/botman/driver-amazon-alexa.svg?branch=master)](https://travis-ci.org/botman/driver-amazon-alexa)
+[![codecov](https://codecov.io/gh/botman/driver-amazon-alexa/branch/master/graph/badge.svg)](https://codecov.io/gh/botman/driver-amazon-alexa)
+
+
+## Contributing
+
+Please see [CONTRIBUTING](CONTRIBUTING.md) for details.
+
+## Security Vulnerabilities
+
+If you discover a security vulnerability within BotMan, please send an e-mail to Marcel Pociot at [email protected]. All security vulnerabilities will be promptly addressed.
+
+## License
+
+BotMan is free software distributed under the terms of the MIT license.
+

composer.json

@@ -0,0 +1,42 @@
+{
+    "name": "botman/driver-amazon-alexa",
+    "license": "MIT",
+    "description": "Amazon Alexa driver for BotMan",
+    "keywords": [
+        "Bot",
+        "BotMan",
+        "Amazon Alexa",
+        "Alexa"
+    ],
+    "homepage": "http://github.com/botman/driver-amazon-alexa",
+    "authors": [
+        {
+            "name": "Marcel Pociot",
+            "email": "[email protected]"
+        }
+    ],
+    "require": {
+        "php": ">=7.0",
+        "botman/botman": "~2.0",
+        "minicodemonkey/amazon-alexa-php": "^0.1.5"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "~5.0",
+        "mockery/mockery": "dev-master",
+        "ext-curl": "*"
+    },
+    "autoload": {
+        "psr-4": {
+            "BotMan\\Drivers\\AmazonAlexa\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\": "tests/"
+        }
+    },
+    "scripts": {
+        "test": "vendor/bin/phpunit",
+        "cs": "php-cs-fixer fix"
+    }
+}

discovery.json

@@ -0,0 +1,5 @@
+{
+    "botman/driver": [
+        "BotMan\\Drivers\\AmazonAlexa\\AmazonAlexaDriver"
+    ]
+}

phpunit.xml

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit backupGlobals="false"
+         backupStaticAttributes="false"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+         convertErrorsToExceptions="true"
+         convertNoticesToExceptions="true"
+         convertWarningsToExceptions="true"
+         processIsolation="false"
+         stopOnFailure="false"
+         syntaxCheck="false"
+        >
+    <testsuites>
+        <testsuite name="Package Test Suite">
+            <directory>tests/</directory>
+        </testsuite>
+    </testsuites>
+    <filter>
+        <whitelist>
+            <directory suffix=".php">src/</directory>
+        </whitelist>
+    </filter>
+</phpunit>

src/AmazonAlexaDriver.php

@@ -0,0 +1,168 @@
+<?php
+
+namespace BotMan\Drivers\AmazonAlexa;
+
+use BotMan\BotMan\Users\User;
+use Illuminate\Support\Collection;
+use BotMan\BotMan\Drivers\HttpDriver;
+use BotMan\BotMan\Messages\Incoming\Answer;
+use BotMan\BotMan\Messages\Outgoing\Question;
+use Alexa\Response\Response as AlexaResponse;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use BotMan\BotMan\Drivers\Events\GenericEvent;
+use BotMan\Drivers\AmazonAlexa\Extensions\Card;
+use BotMan\BotMan\Interfaces\DriverEventInterface;
+use BotMan\BotMan\Messages\Incoming\IncomingMessage;
+use BotMan\BotMan\Messages\Outgoing\OutgoingMessage;
+
+class AmazonAlexaDriver extends HttpDriver
+{
+    const DRIVER_NAME = 'AmazonAlexa';
+    const LAUNCH_REQUEST = 'LaunchRequest';
+
+    protected $messages = [];
+
+    /**
+     * @param Request $request
+     */
+    public function buildPayload(Request $request)
+    {
+        $this->payload = Collection::make((array) json_decode($request->getContent(), true));
+        $this->event = Collection::make((array) $this->payload->get('request'));
+        $this->config = Collection::make($this->config->get('amazon-alexa', []));
+    }
+
+    /**
+     * @param IncomingMessage $matchingMessage
+     * @return \BotMan\BotMan\Users\User
+     */
+    public function getUser(IncomingMessage $matchingMessage)
+    {
+        return new User($matchingMessage->getSender());
+    }
+
+    /**
+     * Determine if the request is for this driver.
+     *
+     * @return bool
+     */
+    public function matchesRequest()
+    {
+        return $this->event->has('requestId') && $this->event->has('type');
+    }
+
+    /**
+     * @param  IncomingMessage $message
+     * @return \BotMan\BotMan\Messages\Incoming\Answer
+     */
+    public function getConversationAnswer(IncomingMessage $message)
+    {
+        return Answer::create($message->getText())->setMessage($message);
+    }
+
+    /**
+     * Retrieve the chat message.
+     *
+     * @return array
+     */
+    public function getMessages()
+    {
+        if (empty($this->messages)) {
+            $intent = $this->event->get('intent');
+            $session = $this->payload->get('session');
+
+            $message = new IncomingMessage($intent['name'], $session['user']['userId'], $session['sessionId']);
+            $message->addExtras('slots', Collection::make($intent['slots']));
+
+            $this->messages = [$message];
+        }
+
+        return $this->messages;
+    }
+
+    /**
+     * @return bool|DriverEventInterface
+     */
+    public function hasMatchingEvent()
+    {
+        $type = $this->event->get('type');
+        if ($type === self::LAUNCH_REQUEST) {
+            $event = new GenericEvent($this->event);
+            $event->setName($type);
+
+            return $event;
+        }
+
+        return false;
+    }
+
+    /**
+     * @return bool
+     */
+    public function isBot()
+    {
+        return false;
+    }
+
+    /**
+     * @param string|Question|IncomingMessage $message
+     * @param IncomingMessage $matchingMessage
+     * @param array $additionalParameters
+     * @return Response
+     */
+    public function buildServicePayload($message, $matchingMessage, $additionalParameters = [])
+    {
+        $parameters = $additionalParameters;
+
+        if ($message instanceof Question) {
+            $text = $message->getText();
+        } elseif ($message instanceof OutgoingMessage) {
+            $text = $message->getText();
+            $attachment = $message->getAttachment();
+            if ($attachment instanceof Card) {
+                $parameters['card'] = $attachment;
+            }
+        } else {
+            $text = $message;
+        }
+
+        $parameters['text'] = $text;
+
+        return $parameters;
+    }
+
+    /**
+     * @param mixed $payload
+     * @return Response
+     */
+    public function sendPayload($payload)
+    {
+        $response = new AlexaResponse();
+        $response->respond($payload['text']);
+        $response->card = $payload['card'] ?? null;
+
+        return Response::create(json_encode($response->render()))->send();
+    }
+
+    /**
+     * @return bool
+     */
+    public function isConfigured()
+    {
+        return true;
+    }
+
+    /**
+     * Low-level method to perform driver specific API requests.
+     *
+     * @param string $endpoint
+     * @param array $parameters
+     * @param IncomingMessage $matchingMessage
+     * @return Response
+     */
+    public function sendRequest($endpoint, array $parameters, IncomingMessage $matchingMessage)
+    {
+        //
+    }
+}