New types for alexa skills and alexa smarthome events. Adding cloudwatch logs as well.

Author: astuyve

globals.d.ts

@@ -2,3 +2,72 @@ declare module '*.json' {
   const value: any
   export default value
 }
+
+export interface AlexaSmartHomeEvent {
+  header: { [name: string]: string },
+  payload: {
+    switchControlAction: string,
+    appliance: {
+      additionalApplianceDetails: { [name: string]: string },
+      applianceId: string,
+    },
+    accessToken: string
+  } 
+}
+
+export interface AlexaSkillEvent {
+  version: string,
+  session: AlexaSkillSession,
+  context: AlexaSkillContext,
+
+
+}
+
+export interface AlexaSkillSession {
+  new: boolean,
+  sessionId: string,
+  application: {
+    applicationId: string
+  },
+  attributes: {
+    [name: string]: string
+  },
+  user: AlexaSkillUser
+}
+
+export interface AlexaSkillContext {
+  System: {
+    device: {
+      deviceId: string,
+      supportedInterfaces: {
+        AudioPlayer: any
+      }
+    },
+    application: {
+      applicationId: string
+    },
+    user: AlexaSkillUser,
+    apiEndpoint: string,
+    apiAccessToken: string
+  },
+  AudioPlayer: {
+    playerActivity: string,
+    token: string,
+    offsetInMilliseconds: number,
+  }
+}
+
+export interface AlexaSkillUser {
+  userId: string,
+  accessToken: string,
+  permissions: {
+    consentToken: string
+  }
+}
+
+export interface AlexaSkillRequest {
+  type: string,
+  requestId: string,
+  timestamp: string,
+  locale: string,
+}

lib/events/aws/alexa-skill-event-template.json

@@ -0,0 +1,53 @@
+{
+  "version": "1.0",
+  "session": {
+    "new": true,
+    "sessionId": "amzn1.echo-api.session.[unique-value-here]",
+    "application": {
+      "applicationId": "amzn1.ask.skill.[unique-value-here]"
+    },
+    "attributes": {
+      "key": "string value"
+    },
+    "user": {
+      "userId": "amzn1.ask.account.[unique-value-here]",
+      "accessToken": "Atza|AAAAAAAA...",
+      "permissions": {
+        "consentToken": "ZZZZZZZ..."
+      }
+    }
+  },
+  "context": {
+    "System": {
+      "device": {
+        "deviceId": "string",
+        "supportedInterfaces": {
+          "AudioPlayer": {}
+        }
+      },
+      "application": {
+        "applicationId": "amzn1.ask.skill.[unique-value-here]"
+      },
+      "user": {
+        "userId": "amzn1.ask.account.[unique-value-here]",
+        "accessToken": "Atza|AAAAAAAA...",
+        "permissions": {
+          "consentToken": "ZZZZZZZ..."
+        }
+      },
+      "apiEndpoint": "https://api.amazonalexa.com",
+      "apiAccessToken": "AxThk..."
+    },
+    "AudioPlayer": {
+      "playerActivity": "PLAYING",
+      "token": "audioplayer-token",
+      "offsetInMilliseconds": 0
+    }
+  },
+  "request": {
+    "type": "LaunchRequest",
+    "requestId": "string",
+    "timestamp": "string",
+    "locale": "string"
+  }
+}

lib/events/aws/alexa-smart-home-event-template.json

@@ -0,0 +1,18 @@
+{
+  "header": {
+    "payloadVersion": "1",
+    "namespace": "Control",
+    "name": "SwitchOnOffRequest"
+  },
+  "payload": {
+    "switchControlAction": "TURN_ON",
+    "appliance": {
+      "additionalApplianceDetails": {
+        "key2": "value2",
+        "key1": "value1"
+      },
+      "applianceId": "sampleId"
+    },
+    "accessToken": "sampleAccessToken"
+  }
+}

lib/events/aws/cloudwatch-logs-event-template.json

@@ -0,0 +1,5 @@
+{
+  "awslogs": {
+    "data": "H4sIAIOmuFwAA8tJLVGvUqjKLFAoycgsBgAzQsm5DgAAAA=="
+  }
+}

lib/index.ts

@@ -1,5 +1,6 @@
 import { merge, cloneDeep } from 'lodash'
-import { APIGatewayEvent, ScheduledEvent, S3Event, KinesisStreamEvent, DynamoDBStreamEvent, SQSEvent, SNSEvent } from 'aws-lambda'
+import { APIGatewayEvent, ScheduledEvent, S3Event, KinesisStreamEvent, DynamoDBStreamEvent, SQSEvent, SNSEvent, CloudWatchLogsEvent } from 'aws-lambda'
+import { AlexaSmartHomeEvent, AlexaSkillEvent } from '../globals'
 import { GeneratedEvent } from './generatedEvent'
 import snsTemplate from './events/aws/sns-template.json'
 import sqsTemplate from './events/aws/sqs-template.json'
@@ -8,6 +9,9 @@ import scheduledTemplate from './events/aws/scheduled-template.json'
 import s3Template from './events/aws/s3-template.json'
 import kinesisTemplate from './events/aws/kinesis-template.json'
 import dynamoTemplate from './events/aws/dynamo-stream-event-template.json'
+import cloudwatchLogsEventTemplate from './events/aws/cloudwatch-logs-event-template.json'
+import alexaSmartHomeEventTemplate from './events/aws/alexa-smart-home-event-template.json'
+import alexaSkillEventTemplate from './events/aws/alexa-skill-event-template.json'
 
 const dictionary: any = {
   'aws:sns':  snsTemplate as SNSEvent,
@@ -17,6 +21,9 @@ const dictionary: any = {
   'aws:s3': s3Template as S3Event,
   'aws:kinesis': kinesisTemplate as KinesisStreamEvent,
   'aws:dynamo': dynamoTemplate as DynamoDBStreamEvent,
+  'aws:cloudwatchLogEvent': cloudwatchLogsEventTemplate as CloudWatchLogsEvent,
+  'aws:alexaSmartHomeEvent': alexaSmartHomeEventTemplate as AlexaSmartHomeEvent,
+  'aws:alexaSkillEvent': alexaSkillEventTemplate as AlexaSkillEvent,
 }
 
 export default function createEvent(eventType: string, body: any): GeneratedEvent {