Welcome to your CDK TypeScript project

This is a blank project for CDK development with TypeScript.

The cdk.json file tells the CDK Toolkit how to execute your app.

Useful commands

• npm run build compile typescript to js
• npm run watch watch for changes and compile
• npm run test perform the jest unit tests
• npx cdk deploy deploy this stack to your default AWS account/region
• npx cdk diff compare deployed stack with current state
• npx cdk synth emits the synthesized CloudFormation template

sns-eventbridge-sqs LocalStack CDK Project

This project demonstrates an event-driven architecture using AWS CDK, LocalStack, and AWS services:

• SNS Topic triggers a Lambda function
• Lambda forwards events to a custom EventBridge Bus
• EventBridge routes transformed events to a Destination SQS Queue

All deployed locally using LocalStack for fast offline development and testing.

---

Prerequisites

• Node.js (v18.x recommended)
• npm
• Docker (LocalStack runs inside Docker)
• LocalStack CLI (v4.x)
• AWS CDK CLI (v2.x)
• cdk-local (CDK wrapper for LocalStack)

---

Installation

1. Clone the repo

   git clone <your-repo-url>
   cd sns-eventbridge-sqs
   
   

npm install

localstack start

export AWS_ACCESS_KEY_ID=test export AWS_SECRET_ACCESS_KEY=test export AWS_DEFAULT_REGION=us-east-1 export AWS_ENDPOINT_URL=http://localhost:4566

sns-eventbridge-sqs/ ├── bin/ │ └── sns-eventbridge-sqs.ts # CDK app entry point ├── lib/ │ └── sns-eventbridge-sqs-stack.ts # CDK stack defining SNS, Lambda, EventBridge, SQS ├── lambda-handler/ │ └── index.js # Lambda function handler ├── test/ │ └── localstack-test.sh # Optional test script to send SNS message and check SQS ├── cdk.json ├── package.json ├── tsconfig.json └── README.md # This file

npm install -g aws-cdk-local cdklocal bootstrap cdklocal deploy

awslocal sns list-topics

awslocal sqs receive-message
--queue-url http://localhost:4566/000000000000/destination-queue
--max-number-of-messages 1

cdklocal destroy

localstack stop

pip install localstack awscli-local npm install -g aws-cdk

cdk.json { "app": "npx ts-node bin/sns-eventbridge-sqs.ts", "context": { "aws-cdk:enableDiffNoFail": "true", "aws-cdk:use-localstack": true } }

npm install -g aws-cdk-local

cdklocal bootstrap cdklocal deploy

localstack start

export AWS_ACCESS_KEY_ID=test export AWS_SECRET_ACCESS_KEY=test export AWS_DEFAULT_REGION=us-east-1 export EDGE_PORT=4566 export AWS_ENDPOINT_URL=http://localhost:4566

cdklocal deploy

awslocal sns list-topics awslocal sqs list-queues awslocal lambda list-functions awslocal events list-event-buses

TOPIC_ARN=$(awslocal sns list-topics --query 'Topics[0].TopicArn' --output text)

awslocal sns publish
--topic-arn "$TOPIC_ARN"
--message '{"userId": 123, "action": "created"}'
--message-attributes '{"source":{"DataType":"String","StringValue":"custom.sns.source"}}'

aws sns publish
--topic-arn arn:aws:sns:us-east-1:000000000000:topic-9d42a22a
--message '{ "userId": "12345", "action": "login", "timestamp": "2025-07-30T18:22:00Z" }'
--message-attributes '{"source": {"DataType": "String", "StringValue": "custom.sns.source"}}'

QUEUE_URL=$(awslocal sqs get-queue-url --queue-name destination-queue --query 'QueueUrl' --output text)

awslocal sqs receive-message
--queue-url "$QUEUE_URL"
--message-attribute-names All
--max-number-of-messages 1

awslocal logs describe-log-groups awslocal logs describe-log-streams --log-group-name /aws/lambda/SnsToEventBridgeLambda