This is a teeny-tiny AWS SDK implementation for TypeScript using Proxies that fits everything into ~49 KB
, including all Services and APIs. The name is an homage to the awesome itty-router.
๐ This is a highly experimental API, do not use for anything serious.
Known to work:
- โ Any modern API using plain JSON protocol should work out of the box.
- โ DynamoDB
- โ EventBridge
- โ SQS
- โ
S3
CreateBucket
,GetObject
,HeadObject
,PutObject
,DeleteObject
,ListObjectsV2
- โ๏ธ S3 the remaining S3 APis likely don't work due to inconsistencies in the XML API.
- โ๏ธ SNS (see: #2)
We want a lightweight AWS SDK that has no impact on Lambda cold starts and a standard API design. The AWS SDK v3 traded off usability to save on bundle size with the introduction of client.send(Command)
and still didn't achieve a lightweight experience. None of this should be necessary - we can have our cake and eat it too!
This project aims to eliminate the following issues with the official AWS SDK:
- Bundle size and cold start times degrades as a piece of code uses more AWS APIs
- Some APIs are excessively heavy (looking at you, S3).
- Relying on an AWS SDK provided in the Lambda environment doesn't always save time either, since just require/import-ing it takes time because of how large the code is.
- Bring back the
client.apiName(..)
design without compromising performance (e.g.dynamo.getItem(..)
instead ofdynamo.send(GetItemCommand)
).
The entire AWS SDK (including all Services and APIs) fits in to a
- Minified bundle size of:
22 KB
. - Un-minified bundle size of:
32 KB
.
๐ช It is possible to reduce this even further.
npm install itty-aws
Import the top-level AWS
object from itty-aws
and instantiate a client for the Service you want. The SDK is constant size, so your performance is not impacted by the number or choice of AWS services. The APIs are methods on the client - just like AWS SDK v2, except minus the .promise()
.
import { AWS } from "itty-aws";
const ddb = new AWS.DynamoDB();
const response = await ddb.getItem({
TableName,
Key: {
pk: {
S: "key",
},
},
});
console.log(response.Item);
Instead of generating heavy classes and functions for the SDK like AWS does, we instead generate type declarations off of the AWS SDK v2 and provide a generic implementation for all clients using a Proxy. You can find this file in ./src/index.ts.
- Performance has not been tested - it's possible that our use of
https
orfetch
is slower than whatever magic the AWS SDK is doing. - We're still importing some heavy code from the AWS SDK for signing requests - including tslib (for whatever reason). We should investigate hand-rolling replacements that don't have these dependencies or at least minimize them.