AWS CloudFront Lambda@Edge serverless application router.
npm install @lambda-lambda-lambda/router     
AWS CloudFront Lambda@Edge serverless application router.
- Request/Response handling API.
- Routes and URI Resource support.
- Local/Globally scoped Middleware.
- Visual Studio Code integration.
- Open Source, MIT licensed, FREE.
- Lightweight (no dependencies).
In its most basic form the library provides helper methods that translate the CloudFront Lambda@Edge origin-request allowing you to handle response processing without the need to construct complex Lambda dependent responses.
To better visualize how L³ fits in the current AWS ecosystem the following high-level graph describes the _HTTP Request/Response lifecycle_ and role of each AWS provided service.
!HTTP Request/Response lifecycle
The easiest way to created an application, without the need to manually install this package, is to use the L³ Visual Studio Code extension. Doing so allows you to..
- Scaffold app sources and dependencies.
- Run it locally (in Remote - Containers)
- Test code changes in realtime.
- Deploy app sources to AWS.
- Generate JSDoc/Swagger documentation.
If you're not using the L³ VS Code extension and want to _run this package locally_ you must install the following dependencies:
If you just looking to leverage the Request/Response handling API in your Lambda functions, install this package using NPM.
$ npm install @lambda-lambda-lambda/router
- Introduction
- Getting Started
- AWS requirements
- Running your App
- Usage
- Common methods
- Complex routing
- Middleware
- Developers
- Testing
Going forward, it is recommended that you build your L³ application using async handlers in anticipation of the AWS changes below.
> AWS Lambda plans to remove support for callback-based function handlers starting with Node.js 24. You will need to update this function to use an async handler to use Node.js 24 or later. For more information and to provide feedback on this change, see aws/aws-lambda-nodejs-runtime-interface-client#137
While backwards compatibity will be supported for older Node.js releases this support will eventually be phased out with the deprecation of nodejs22.x (Apr 30, 2027).
See AWS Node.js Supported Runtimes for support information.
This package is maintained under the Semantic Versioning guidelines.
This package is distributed in the hope that it will be useful, but without any warranty; without even the implied warranty of merchantability or fitness for a particular purpose.
_lambda-lambda-lambda/router_ is provided under the terms of the MIT license
AWS is a registered trademark of Amazon Web Services, Inc.