lambda-patterns

    3.0.2 • Public • Published

    lambda-patterns · Travis Documented with emdaer

    A set of abstractions and helpers for working with lambdas.

    Installation

    yarn add lambda-patterns

    OR

    npm i --save lambda-patterns

    Usage

    Handler

    The Handler class facilitates common patterns in lambda handlers through some useful abstractions. For example, it processes events through a standard flow (init -> process -> cleanup -> respond) which allows you to alter and extend behavior in a repeatable way across multiple handlers. It also includes optional profiling functionality out-of-the-box!

    Simple Usage

    To start with, let's just look at the simplest example:

    // ./handler.js
     
    const { Handler } = require('lambda-patterns');
     
    module.exports = {
      yourHandler: Handler.create(({ event }) => ({
        statusCode: 200,
        body: JSON.stringify({
          message: 'This handler was created with lambda-patterns!',
          input: event,
        }),
      })),
    };

    Cold start detection

    Cold starts are detected with each invocation by taking advantage of the shared require cache between lambda invocations in the same container. The detection takes place in the init() step. The result is stored in the isColdStart boolean property on the handler. This allows you to alter behavior for cold starts only. For example, you might want to enable profiling only for cold starts or log a message to better understand the impact of cold starts to your application.

    // ./handler.js
     
    const { Handler } = require('lambda-patterns');
     
    module.exports = {
      yourHandler: Handler.create(handler => {
        if (handler.isColdStart) {
          console.log('Cold start!');
        }
     
        return {
          statusCode: 200,
          body: JSON.stringify({
            message: 'This handler was created with lambda-patterns!',
            input: handler.event,
          }),
        }
      }),
    };

    Enable profiling

    The Handler class also ships with an option to enable profiling with v8-lambda-profiler. The profile data will be stored in a "profile" property on the handler in the cleanup method. You can then extend Handler to store the profile data with your preferred method (write to s3 or log to CloudWatch, for example).

    // ./handler.js
     
    const { Handler } = require('lambda-patterns');
     
    class MyHandler extends Handler {
      cleanup() {
        super.cleanup();
        if (this.profile) {
          // log profile data to CloudWatch.
          console.log('Profile:', this.profile);
        }
      }
    }
     
    module.exports = {
      yourHandler: MyHandler.create(
        ({ event }) => ({
          statusCode: 200,
          body: JSON.stringify({
            message: 'This handler was created with lambda-patterns!',
            input: event,
          }),
        }),
        // shouldProfile is a function which receives the handler instance as its
        // only argument and returns either true or false to indicate whether
        // profiling data should be collected for the invocation. By default,
        // profiling is always disabled. In this example we are using the handler's
        // cold start detection to enable profiling only for cold starts.
        { shouldProfile: handler => handler.isColdStart }
      ),
    };

    Documentation

    See the DOCUMENTATION.md file.

    Contributors

    Contributors
    Peter Sieg

    License

    lambda-patterns is MIT licensed.

    Install

    npm i lambda-patterns

    DownloadsWeekly Downloads

    1

    Version

    3.0.2

    License

    MIT

    Unpacked Size

    330 kB

    Total Files

    21

    Last publish

    Collaborators

    • chasingmaxwell