@emulators/aws 0.4.0 → 0.4.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +71 -0
  2. package/package.json +2 -2
package/README.md ADDED
@@ -0,0 +1,71 @@
1
+ # @emulators/aws
2
+
3
+ S3, SQS, IAM, and STS emulation with REST-style S3 paths and query-style SQS/IAM/STS endpoints. All responses use AWS-compatible XML.
4
+
5
+ Part of [emulate](https://github.com/vercel-labs/emulate) — local drop-in replacement services for CI and no-network sandboxes.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ npm install @emulators/aws
11
+ ```
12
+
13
+ ## Endpoints
14
+
15
+ ### S3
16
+ - `GET /s3/` — list all buckets
17
+ - `PUT /s3/:bucket` — create bucket
18
+ - `DELETE /s3/:bucket` — delete bucket
19
+ - `HEAD /s3/:bucket` — check existence
20
+ - `GET /s3/:bucket` — list objects (prefix, delimiter, max-keys)
21
+ - `PUT /s3/:bucket/:key` — put object (supports copy via `x-amz-copy-source`)
22
+ - `GET /s3/:bucket/:key` — get object
23
+ - `HEAD /s3/:bucket/:key` — head object
24
+ - `DELETE /s3/:bucket/:key` — delete object
25
+
26
+ ### SQS
27
+ All operations via `POST /sqs/` with `Action` parameter:
28
+ - `CreateQueue`, `ListQueues`, `GetQueueUrl`, `GetQueueAttributes`
29
+ - `SendMessage`, `ReceiveMessage`, `DeleteMessage`
30
+ - `PurgeQueue`, `DeleteQueue`
31
+
32
+ ### IAM
33
+ All operations via `POST /iam/` with `Action` parameter:
34
+ - `CreateUser`, `GetUser`, `ListUsers`, `DeleteUser`
35
+ - `CreateAccessKey`, `ListAccessKeys`, `DeleteAccessKey`
36
+ - `CreateRole`, `GetRole`, `ListRoles`, `DeleteRole`
37
+
38
+ ### STS
39
+ All operations via `POST /sts/` with `Action` parameter:
40
+ - `GetCallerIdentity`, `AssumeRole`
41
+
42
+ ## Auth
43
+
44
+ Bearer tokens or IAM access key credentials. Default key pair always seeded: `AKIAIOSFODNN7EXAMPLE` / `wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY`.
45
+
46
+ ## Seed Configuration
47
+
48
+ ```yaml
49
+ aws:
50
+ region: us-east-1
51
+ s3:
52
+ buckets:
53
+ - name: my-app-bucket
54
+ - name: my-app-uploads
55
+ sqs:
56
+ queues:
57
+ - name: my-app-events
58
+ - name: my-app-dlq
59
+ iam:
60
+ users:
61
+ - user_name: developer
62
+ create_access_key: true
63
+ roles:
64
+ - role_name: lambda-execution-role
65
+ description: Role for Lambda function execution
66
+ ```
67
+
68
+ ## Links
69
+
70
+ - [Full documentation](https://emulate.dev/aws)
71
+ - [GitHub](https://github.com/vercel-labs/emulate)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@emulators/aws",
3
- "version": "0.4.0",
3
+ "version": "0.4.1",
4
4
  "license": "Apache-2.0",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -28,7 +28,7 @@
28
28
  ],
29
29
  "dependencies": {
30
30
  "hono": "^4",
31
- "@emulators/core": "0.4.0"
31
+ "@emulators/core": "0.4.1"
32
32
  },
33
33
  "devDependencies": {
34
34
  "tsup": "^8",