javascript-studio / studio-gateway Goto Github PK

The AWS extensions to Swagger are listed here: http://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-swagger-extensions.html

💻 Reproduce:

The requestParameters and the responseParameters are currently ignored for Lambda integrations.

One of the cool feature of AWS API Gateway is custom security Lambda functions. This needs to be supported here also.

💻 Reproduce:

Currently the security config is ignored entirely.

❓ Expected:

A Lambda function that is configured for custom security should be invoked and if successful, the result should be cached for some time.

❗ Actual:

The Lambda function is never invoked.

When an SNS integration is called, it should emit a "notification" or "sns" event to allow hooking this up with @studio/notifications.

When invoking a Lambda function with an SNS message, it must have this form: https://gist.github.com/yyolk/cd22e8a3faf7fd75997b

Also have a look here: http://stackoverflow.com/questions/34213464/aws-api-gateway-communicating-to-sns

Currently, the context is just an empty object. It should contain the following properties that are also available in the actual AWS context and would also be useful when running the @studio/gateway standalone:

• getRemainingTimeInMillis()
• functionName
• memoryLimitInMB
• functionVersion
• invokedFunctionArn
• awsRequestId

Swagger files for AWS easily become massive. A tool should be added here to make swagger files easier to manage. The local gateway implementation can then run the pre-processing on the fly.

• Allow external files to be loaded with $ref so that it can be split up.
• Support variables of some sorts (e.g. ${myVar}).
• Use variables from process.env and optionally support loading env files for the current stage.
• Add a command to upload and deploy the API to a stage.

It might also be a good idea to support swagger as JS files so that they can be generated with ES6 template string.

This might be useful on it's own as a command to create (and maybe upload) modular swagger definitions. There is no need to couple this to the custom API gateway.

The tool can then be used by the JavaScript Studio API, and this project can consume the new project's API.