release v1.1.0 / runtime version 4 - adds support for async handlers

Author: jimleuk

Cakefile

@@ -92,22 +92,25 @@ task 'test', 'runs test',
     console.log 'packaging test... ok'
 
     console.log 'running test...'
-    { stdout, stderr } = await exec "
-	    docker run
-            --rm
-            -v $(PWD)/test/lambda:/var/task
-            -v $(PWD)/test/layer:/opt
-            lambci/lambda:provided
-            index.handler
-    "
 
-    [ result ] = stdout.split(/\n/)
+    handlers = [ 'handlerCallback', 'handlerAsync' ]
+
+    results = await Promise.all handlers.map (name) ->
+        exec "
+            docker run
+                --rm
+                -v $(PWD)/test/lambda:/var/task
+                -v $(PWD)/test/layer:/opt
+                lambci/lambda:provided
+                index.#{name}
+        "
+
     expected = '{"statusCode":200,"body":"{\\"message\\":\\"CoffeeScript Serverless v1.0! Your function executed successfully!\\",\\"input\\":{}}"}'
+    outputs = (result.stdout.split(/\n/)[0] is expected for result in results)
 
-    passed = result is expected
-    console.log "running test... #{if passed then 'PASS' else 'FAIL'}"
+    console.log "running test (#{handlers[index]}) ... #{if output then 'PASS' else 'FAIL'}" for output, index in outputs
 
-    if not passed
+    if not outputs.every (output) -> output
         console.log stderr
         process.exit 1
 

README.md

@@ -3,18 +3,26 @@
 A custom runtime for AWS Lambda to execute functions in CoffeeScript.
 
 > **Note**: This repository is essentially a CoffeeScript port and fork of 
-[Node-Custom-Lambda](https://github.com/lambci/node-custom-lambda). The only 
-real difference is where `Node-Custom-Lambda` expects functions to return a 
-promise, `coffeescript-lambda-runtime` opts to stay with the traditional 
-callback method.
+[Node-Custom-Lambda](https://github.com/lambci/node-custom-lambda).
 
 > **New to CoffeeScript?**  
 > I recommend starting at https://coffeescript.org/
 
 ## How does it work?
-`CoffeeScript-lambda-runtime` works by taking care of the compiling and execution of CoffeeScript source code at time of request. This means end-users of the runtime are no longer required to compile their CoffeeScript code to javascript before uploading their functions to AWS Lambda.
+`CoffeeScript-lambda-runtime` works by taking care of the compiling and execution of CoffeeScript source code at time of request. This means end-users of the runtime are not required to compile their CoffeeScript code to javascript before uploading their functions to AWS Lambda.
 
-Simply write your functions as you would for NodeJs and it should just work.
+Simply write your functions as you would for Node.js and it should just work.
+```coffeescript
+# feel alive again!
+exports.handler = (event, context) ->
+    statusCode: 200,
+    body:
+        JSON.stringify
+            message: 'CoffeeScript Serverless v1.0! Your function executed successfully!',
+            input: event,
+```
+
+alternatively, if you prefer the callback method:
 ```coffeescript
 # feel alive again!
 exports.handler = (event, context, callback) ->
@@ -32,7 +40,7 @@ exports.handler = (event, context, callback) ->
 
 Project|CoffeeScript|NodeJS|ARN|
 |-|-|-|-|
-|v1.0.0|v2.3.2|v8.10.0|arn:aws:lambda:eu-west-2:321742921541:layer:coffeescript:3|
+|v1.1.0|v2.3.2|v8.10.0|arn:aws:lambda:eu-west-2:321742921541:layer:coffeescript:4|
 
 ## Building the runtime layer
 

bootstrap.coffee

@@ -1,4 +1,5 @@
 http = require 'http'
+util = require 'util'
 
 RUNTIME_PATH = '/2018-06-01/runtime'
 
@@ -30,16 +31,20 @@ start = () ->
         return process.exit 1
 
 processEvents = (handler) ->
+    isAsync = isAsyncHandler handler
     while true
         { event, context } = await nextInvocation()
 
         try
-            result = await new Promise (resolve) ->
-                handler event, context, (err, response) ->
-                    throw new Error err if err?
-                    resolve response
+            if not isAsync
+                result = await new Promise (resolve) ->
+                    handler event, context, (err, response) ->
+                        throw new Error err if err?
+                        resolve response
+                        return
                     return
-                return
+            else
+                result = await handler event, context
         catch e
             await invokeError e, context
             continue
@@ -164,4 +169,9 @@ toLambdaErr = ({ name, message, stack }) ->
         stackTrace: if stack then stack.split('\n').slice 1 else '',
     }
 
+isAsyncHandler = (handler) ->
+    if util.types isnt undefined then util.types.isAsyncFunction handler
+    else if handler.constructor.name is 'AsyncFunction' then true
+    else handler.length < 3
+
 start()

package.json

@@ -1,7 +1,7 @@
 {
   "name": "coffeescript-lambda-runtime",
   "private": true,
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A CoffeeScript custom runtime for aws lambda",
   "main": "index.js",
   "engines": {

test/lambda/index.coffee

@@ -1,7 +1,7 @@
 # Test that global requires work
 import aws4 from 'aws4'
 
-exports.handler = (event, context, callback) ->
+exports.handlerCallback = (event, context, callback) ->
     response =
         statusCode: 200,
         body:
@@ -10,3 +10,10 @@ exports.handler = (event, context, callback) ->
                 input: event,
 
     callback null, response
+
+exports.handlerAsync = (event, context) ->
+    statusCode: 200,
+    body:
+        JSON.stringify
+            message: 'CoffeeScript Serverless v1.0! Your function executed successfully!',
+            input: event,