@emulators/aws

S3, SQS, IAM, and STS emulation with REST-style S3 paths and query-style SQS/IAM/STS endpoints. All responses use AWS-compatible XML.

Part of emulate — local drop-in replacement services for CI and no-network sandboxes.

Install

npm install @emulators/aws

Endpoints

S3

• GET /s3/ — list all buckets
• PUT /s3/:bucket — create bucket
• DELETE /s3/:bucket — delete bucket
• HEAD /s3/:bucket — check existence
• GET /s3/:bucket — list objects (prefix, delimiter, max-keys)
• PUT /s3/:bucket/:key — put object (supports copy via x-amz-copy-source)
• GET /s3/:bucket/:key — get object
• HEAD /s3/:bucket/:key — head object
• DELETE /s3/:bucket/:key — delete object

SQS

All operations via POST /sqs/ with Action parameter:

• CreateQueue, ListQueues, GetQueueUrl, GetQueueAttributes
• SendMessage, ReceiveMessage, DeleteMessage
• PurgeQueue, DeleteQueue

IAM

All operations via POST /iam/ with Action parameter:

• CreateUser, GetUser, ListUsers, DeleteUser
• CreateAccessKey, ListAccessKeys, DeleteAccessKey
• CreateRole, GetRole, ListRoles, DeleteRole

STS

All operations via POST /sts/ with Action parameter:

• GetCallerIdentity, AssumeRole

Auth

Bearer tokens or IAM access key credentials. Default key pair always seeded: AKIAIOSFODNN7EXAMPLE / wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY.

Seed Configuration

aws:
  region: us-east-1
  s3:
    buckets:
      - name: my-app-bucket
      - name: my-app-uploads
  sqs:
    queues:
      - name: my-app-events
      - name: my-app-dlq
  iam:
    users:
      - user_name: developer
        create_access_key: true
    roles:
      - role_name: lambda-execution-role
        description: Role for Lambda function execution

Links

• Full documentation
• GitHub