README.md

Typescript AWS Lambda Native Idempotency

Repository with examples of AWS Lambdas using its native idempotency validation in Typescript

Setup

1. In order to run Localstack, you will need to have Docker installed in your machine. You can follow this link to install.
2. Then, you will need to install Localstack itself. This link may help you.
3. After this, you should install awscli-local by following this link or just running this command:

pip3 install awscli-local

Running 💻

1. Start Localstack

LAMBDA_REMOTE_DOCKER=0 DEBUG=1 localstack start

2. Create the DynamoDB idempotency table

awslocal dynamodb create-table \
    --table-name idempotency \
    --attribute-definitions \
        AttributeName=identifier,AttributeType=S \
        AttributeName=idempotency_hash,AttributeType=S \
    --key-schema \
        AttributeName=identifier,KeyType=HASH \
        AttributeName=idempotency_hash,KeyType=RANGE \
    --billing-mode PAY_PER_REQUEST \
    --region us-east-1

3. Run the package.json scripts

4. After running each of them, scan the DynamoDB table to check the idempotency records.

awslocal dynamodb scan \
    --table-name idempotency

In case you want to delete the table to create it again, run the following command:

awslocal dynamodb delete-table \
    --table-name idempotency

Function Wrapper

SQS

SQS Full Event idempotent

SQS Message Body idempotent

SQS Message Body field idempotent

SQS Message Body multiple fields idempotent

SQS Message ID idempotent

SQS Message Attribute idempotent

API Gateway

API Gateway Full Path idempotent