aws-lite
is simple, extremely fast, extensible Node.js client for interacting with AWS services.
(It's got good error reporting, too.)
You can think of it as a community-driven alternative to AWS's JavaScript SDK.
Who made this?
aws-lite
is developed and maintained by the folks at OpenJS Foundation Architect. We <3 AWS!
So, what is aws-lite
?
aws-lite
is a simple, extremely fast, extensible Node.js client for interacting with AWS services.
(It's got good error reporting, too.)
You can think of it as a community-driven alternative to AWS's JavaScript SDK.
Why not use aws-sdk
/ @aws-sdk/*
?
Amazon has historically done a great job of maintaining its SDKs. However, AWS has deprecated its widely-adopted v2 SDK; its v3 SDK relies on generated code, resulting in large dependencies, poor performance, awkward semantics, difficult to understand documentation, and errors without usable stack traces.
We rely on and believe in AWS, so we built aws-lite
to provide a simpler, faster, more stable position from which to work with AWS services in Node.js.
Features
- 2-5x faster than AWS SDK v3
- Simple semantics & straightforward promise-based interface
- Human-readable documentation
- Customizable
- Errors with stack traces and line numbers
- Built-in pagination
- Secured with AWS Signature v4
- Interacts with any AWS service without needing any plugins
- Automatically parses / serializes JSON, AWS-flavored JSON, and XML request / response payloads
- Easily integrates with local testing suites and AWS service mocks
- Use existing service plugins, or develop your own
- Debug mode for inspecting raw requests and responses
- Just two dependencies
Install aws-lite
Install the client:
npm i @aws-lite/client
You can use the client as-is to quickly interact with AWS service APIs, or extend it with specific service plugins like so:
npm i @aws-lite/dynamodb
Generally, types are available as optional @aws-lite/*-types
packages, and can be added like so:
npm i -D @aws-lite/dynamodb-types
Learn more about aws-lite
types.
Example
Now start making calls to AWS:
import awsLite from '@aws-lite/client'
const config = { region: 'us-west-1' }
const aws = await awsLite(config)
await aws({
service: 'lambda',
path: '/2015-03-31/functions/$function-name/configuration',
})
await aws({
service: 'lambda',
path: '/2015-03-31/functions/$function-name/invocations',
payload: { ok: true },
})
await aws.DynamoDB.GetItem({
pk: '$item-key',
})
Learn more
Credential and general configuration options for aws-lite
Using aws-lite
to make requests and receiving responses
Guide and examples for using TypeScript with aws-lite
Docs and examples for the aws-lite
plugin API
Open, reproducible, real-world metrics for the performance of aws-lite
and other AWS SDKs
Open source contributor guidelines, methodology, and instructions
List of official @aws-lite/*
plugins