bam-lambda

!BAM! header
![bam 💥](https://bam-lambda.com)
![npm](https://www.npmjs.com/package/bam-lambda)
![license](https://www.npmjs.com/package/bam-lambda)

BAM! is a serverless framework that makes it quick (hence, the name) and easy to get small applications up & running using Node.js and Amazon Web Services (AWS). It is optimized for the deployment of AWS Lambda functions integrated with Amazon API Gateway endpoints, but also allows for the creation of Amazon DynamoDB tables, which can help persist data between lambda invocations.

As long as you meet the prerequisites (see below), there is no need to perform any configuration; BAM! presumes some configuration details by default and uses AWS STS to pull in your account number. That said, there is an option to update your default configuration if you'd like to do that.

Assuming you've written a JavaScript file according to the AWS Lambda programming pattern for Node.js, only one command is needed to push it to AWS and integrate it with an API Gateway endpoint.

bam deploy

If you're new to AWS Lambda, we've included templates for common scenarios (see documentation for bam create in the command section below). These will help you handle requests made using a variety of HTTP methods and expose query/path parameters.

For those more familiar with AWS, we did our best to structure BAM! to allow you to work with existing lambdas & make changes to resources using the AWS console (or other frameworks).

Thanks for trying out BAM! We hope you'll like it! 💥

The Team

Takayoshi Sampson Software Engineer New York, NY

Jocie Moore Software Engineer San Francisco, CA

Jason Overby Software Engineer Portland, OR

Getting Started

$3

* AWS account
* AWS CLI
* Node.js >= 22
* NPM

BAM! requires that you have an account with AWS and you have set up an AWS CLI configuration on your local machine. If you have not already done so, please visit Configuring the AWS CLI for instructions. BAM! will use the default profile and region you have specified within that profile when interacting with AWS services.

$3

 bash
npm install -g bam-lambda


---
Commands

BAM! commands conform to the following structure:`bam [] [--]`

For all commands, BAM! will look for in your current directory. This can be either a file called .js or a directory called containing a file called .js.

---

#### bam configupdates default settings

---

#### bam create creates local file (or directory) based on template

--invoker: creates a local file/directory with lambda templated to invoke another lambda

--html: creates local directory containing index.html, application.js, main.css, and [resourceName].js

--db: creates local file/directory templated to work with a DynamoDB table

--verbose: creates template with instructional comments

---

#### bam deploy deploys lambda + endpoint

--role: specifies role for this deployment

--permitDb: adds policy with scan, put, get, delete DynamoDB permissions

--methods: specifies HTTP method(s) for the endpoint

--lambdaOnly: deploys the lambda without an endpoint

---

#### bam redeploy updates existing lambda and endpoint

--role: specifies role for this deployment

--permitDb: adds policy with scan, put, get, delete DynamoDB permissions

--methods: specifies HTTP method(s) for the endpoint

--rmMethods: specifies a HTTP method or methods to remove from endpoint

--addEndpoint: connects endpoint to lambda

--revokeDb: changes role associated with lambda to role specified in user config

--runtime: changes Node runtime of the lambda

---

#### bam delete deletes existing lambda + endpoint

--dbtable: deletes DynamoDB table

--endpointOnly: deletes endpoint only

---

#### bam get pulls lambda code from AWS into a local directory

---

#### bam listlists lambdas, endpoints, and dbtables

`Lambdas and endpoints deployed from this machine using BAM!: nameOfLambda1 description: a description of the lambda endpoint: http://associatedEndpoint/bam http methods: GET

nameOfLambda2 description: a description of the lambda endpoint:: http://associatedEndpoint/bam http methods: GET, POST, DELETE

Other lambdas on AWS anotherLambda yetAnotherLambda

DynamoDB tables deployed from this machine using BAM!: nameOfTable1 partition key: id (number)

nameOfTable2 partition key: id (number) sort key: name (string)`

--dbtables: lists only DynamoDB tables created with BAM!

--lambdas: lists only lambdas and associated endpoints

---

#### bam dbtable creates a DynamoDB table[tableName] on AWS

---

#### bam --man|help|hdocumentation of commands

--: logs a description of the command options

--all: logs descriptions of all command options

---

#### bam --version|vdisplays version

---------------

`Additional Resources`


* AWS Console
* AWS CLI
* What is AWS Lambda?
* What is Amazon API Gateway?
* What is Amazon DynamoDB?
* AWS Lambda SDK
* Amazon API Gateway SDK
* Amazon DynamoDB Document Client SDK
Release Notes

#### Version 6.0.0 (September 2025)
* Updated default Node runtime to

nodejs22.x

.
* Added

nodejs20.x and nodejs22.x

 to valid runtimes for Lambda functions.
* Removed

nodejs16.x and nodejs18.x

 from valid runtimes for Lambda functions because they are no longer supported (https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).
#### Version 5.0.0 (November 2023)
* Updated default Node runtime to

nodejs18.x

.
* Added

nodejs16.x and nodejs18.x

 to valid runtimes for Lambda functions.
* Removed

nodejs12.x and nodejs14.x

 from valid runtimes for Lambda functions because they are no longer supported (https://docs.aws.amazon.com/lambda/latest/dg/runtime-support-policy.html).
#### Version 4.0.0 (August 2021)
* Updated default Node runtime to

nodejs14.x

.
* Added

nodejs12.x

 to valid runtimes for Lambda functions.
* Removed

nodejs10.x

 from valid runtimes for Lambda functions because Node 10.x will no longer be supported after July 30, 2021 (https://docs.aws.amazon.com/lambda/latest/dg/runtime-support-policy.html).
#### Version 3.0.0 (November 2019)
* Updated the Node runtime to

nodejs10.x

 for newly created lambda functions because Node 8.x is reaching EOL on December 31, 2019 (https://github.com/nodejs/Release).
* Added a

--runtime` flag to the redeploy command so that previously created lambda functions can be updated and therefore continued to be maintained after 2019.

!BAM! header
![bam 💥](https://bam-lambda.com)
![npm](https://www.npmjs.com/package/bam-lambda)
![license](https://www.npmjs.com/package/bam-lambda)

Assuming you've written a JavaScript file according to the AWS Lambda programming pattern for Node.js, only one command is needed to push it to AWS and integrate it with an API Gateway endpoint.

bam deploy

For those more familiar with AWS, we did our best to structure BAM! to allow you to work with existing lambdas & make changes to resources using the AWS console (or other frameworks).

Thanks for trying out BAM! We hope you'll like it! 💥

The Team

Takayoshi Sampson Software Engineer New York, NY

Jocie Moore Software Engineer San Francisco, CA

Jason Overby Software Engineer Portland, OR

Getting Started

$3

* AWS account
* AWS CLI
* Node.js >= 22
* NPM

$3

 bash
npm install -g bam-lambda


---
Commands

BAM! commands conform to the following structure:`bam [] [--]`

For all commands, BAM! will look for in your current directory. This can be either a file called .js or a directory called containing a file called .js.

---

#### bam configupdates default settings

---

#### bam create creates local file (or directory) based on template

--invoker: creates a local file/directory with lambda templated to invoke another lambda

--html: creates local directory containing index.html, application.js, main.css, and [resourceName].js

--db: creates local file/directory templated to work with a DynamoDB table

--verbose: creates template with instructional comments

---

#### bam deploy deploys lambda + endpoint

--role: specifies role for this deployment

--permitDb: adds policy with scan, put, get, delete DynamoDB permissions

--methods: specifies HTTP method(s) for the endpoint

--lambdaOnly: deploys the lambda without an endpoint

---

#### bam redeploy updates existing lambda and endpoint

--role: specifies role for this deployment

--permitDb: adds policy with scan, put, get, delete DynamoDB permissions

--methods: specifies HTTP method(s) for the endpoint

--rmMethods: specifies a HTTP method or methods to remove from endpoint

--addEndpoint: connects endpoint to lambda

--revokeDb: changes role associated with lambda to role specified in user config

--runtime: changes Node runtime of the lambda

---

#### bam delete deletes existing lambda + endpoint

--dbtable: deletes DynamoDB table

--endpointOnly: deletes endpoint only

---

#### bam get pulls lambda code from AWS into a local directory

---

#### bam listlists lambdas, endpoints, and dbtables

`Lambdas and endpoints deployed from this machine using BAM!: nameOfLambda1 description: a description of the lambda endpoint: http://associatedEndpoint/bam http methods: GET

nameOfLambda2 description: a description of the lambda endpoint:: http://associatedEndpoint/bam http methods: GET, POST, DELETE

Other lambdas on AWS anotherLambda yetAnotherLambda

DynamoDB tables deployed from this machine using BAM!: nameOfTable1 partition key: id (number)

nameOfTable2 partition key: id (number) sort key: name (string)`

--dbtables: lists only DynamoDB tables created with BAM!

--lambdas: lists only lambdas and associated endpoints

---

#### bam dbtable creates a DynamoDB table[tableName] on AWS

---

#### bam --man|help|hdocumentation of commands

--: logs a description of the command options

--all: logs descriptions of all command options

---

#### bam --version|vdisplays version

---------------

`Additional Resources`


* AWS Console
* AWS CLI
* What is AWS Lambda?
* What is Amazon API Gateway?
* What is Amazon DynamoDB?
* AWS Lambda SDK
* Amazon API Gateway SDK
* Amazon DynamoDB Document Client SDK
Release Notes

#### Version 6.0.0 (September 2025)
* Updated default Node runtime to

nodejs22.x

.
* Added

nodejs20.x and nodejs22.x

 to valid runtimes for Lambda functions.
* Removed

nodejs16.x and nodejs18.x

 from valid runtimes for Lambda functions because they are no longer supported (https://docs.aws.amazon.com/lambda/latest/dg/lambda-runtimes.html#runtimes-supported).
#### Version 5.0.0 (November 2023)
* Updated default Node runtime to

nodejs18.x

.
* Added

nodejs16.x and nodejs18.x

 to valid runtimes for Lambda functions.
* Removed

nodejs12.x and nodejs14.x

 from valid runtimes for Lambda functions because they are no longer supported (https://docs.aws.amazon.com/lambda/latest/dg/runtime-support-policy.html).
#### Version 4.0.0 (August 2021)
* Updated default Node runtime to

nodejs14.x

.
* Added

nodejs12.x

 to valid runtimes for Lambda functions.
* Removed

nodejs10.x

 from valid runtimes for Lambda functions because Node 10.x will no longer be supported after July 30, 2021 (https://docs.aws.amazon.com/lambda/latest/dg/runtime-support-policy.html).
#### Version 3.0.0 (November 2019)
* Updated the Node runtime to

nodejs10.x

 for newly created lambda functions because Node 8.x is reaching EOL on December 31, 2019 (https://github.com/nodejs/Release).
* Added a

--runtime` flag to the redeploy command so that previously created lambda functions can be updated and therefore continued to be maintained after 2019.

The Team

Getting Started

$3

$3

Commands

Additional Resources

Release Notes

bam-lambda

The Team

Getting Started

$3

$3

Commands

Additional Resources

Release Notes

Dist Tags

`Additional Resources`

`Additional Resources`