Testing bootstrap for routing websocket messages to locally running lambdas.

The route configuration file is a dictionary of route actions that maps to Lambda's that will be executed when a message with that route selection property exists.

{
  'route selection value': {
  		id: 'The name of the lamnda in the template.yaml',
  		debug: true|false,
  		debugPort: 15988 
  }
}

The structure of the route-config.json is simple. Just sepcify the Route Key value that will trigger the lambda as the key in the dictionary. Then supply an object in the form {id: , debug: }.

Install the node module:

yarn add aws-websocket-api-helper -D

Then update your package.json scripts to include a script to test locally.

"scripts": {
	"debug-local": "websocket-api start route-config.json"
}

After installing and adding the script to your package.json you can simply type:

yarn debug-local

This fires up the websocket server on the default port of 9090 (you can override that with the -p or --port command line argument). Now all you need to do is send your JSON messages to the websocket server as if you app was connecting to the websocket API. You do not need to wrap the json in an event envelope as the websocket server will do this for you.

If your route is configured to connect to a debugger the lambda will start up and wait for your debugger to connect.

Because in your lambda you will be using the APIGW Admin api to talk back to your websocket clients you have no way of doing that right now. It would be great to mock that up locally so we can also respond to the websocket requests.