@kensio/yulin 0.2.0 → 0.3.0

package/README.md

@@ -10,7 +10,82 @@ npm i -D @kensio/yulin
 
 ## Usage
 
-Still in alpha!
+### Direct interaction with simulated AWS
+
+Create and interact directly with a simulated AWS:
+
+```typescript
+import { SimAws } from "@kensio/yulin";
+import { CreateTableCommand } from "@aws-sdk/client-dynamodb";
+
+const simAws = new SimAws();
+
+// Default Account and Region.
+await simAws.dynamoDb().createTable(
+ new CreateTableCommand({
+   TableName: "FoobarTable",
+   KeySchema: [{ AttributeName: "id", KeyType: "HASH" }],
+ }),
+);
+
+// Specify Account.
+await simAws.account("111111111111").dynamoDb().createTable({ ... });
+
+// Specify Region.
+await simAws.region("eu-west-2").dynamoDb().createTable({ ... });
+
+// Specify Account and Region.
+await simAws.account("111111111111").region("eu-west-2").dynamoDb().createTable({ ... });
+```
+
+AWS state is simulated internally, so you can test realistic interactions with multiple AWS
+services.
+
+Each instance of `SimAws` is cheap and encapsulated so you can create them wherever you need them.
+It's fine to create a new instance of `SimAws` in every test case or in shared test setup.
+
+If you prefer, you can also instantiate simulated services individually:
+
+```typescript
+import { SimS3 } from "@kensio/yulin/s3";
+import { CreateBucketCommand } from "@aws-sdk/client-s3";
+
+const simS3 = new SimS3();
+
+await simS3.createBucket(new CreateBucketCommand({ Bucket: "foo-bucket" }));
+```
+
+That simulated service then has its own isolated state.
+
+### Serve simulated AWS on localhost
+
+You can listen on a port to serve your simulated AWS on localhost:
+
+```typescript
+import { SimAws } from "@kensio/yulin";
+import { serveSimAws } from "@kensio/yulin/serve";
+
+const simAws = new SimAws();
+const srv = await serveSimAws(simAws); // Chooses available port on localhost.
+
+const simS3 = srv.simAws.region("eu-west-2").s3();
+await simS3.createBucket(new CreateBucketCommand({ Bucket: "foo-site" }));
+await simS3.putObject(
+    new PutObjectCommand({
+       Bucket: "foo-site",
+       Key: "index.html",
+       Body: "<h1>Hello, world!</h1>",
+       Metadata: {
+          "content-type": "text/html; charset=utf-8",
+       },
+    }),
+);
+
+// Fetch from the simulated S3 bucket via port on localhost.
+const res = await fetch(
+    `http://foo-site.s3-website.eu-west-2.sim-aws.localhost:${srv.port}/index.html`,
+);
+```
 
 ## What is yulin?
 

package/dist/serve/controller/sim-aws-service-controller-container.d.ts

@@ -0,0 +1,17 @@
+import type { SimAws } from "../../service/aws/sim-aws.js";
+import type { SimAwsServiceName } from "../../service/aws/sim-aws-services.js";
+import type { SimAwsServiceController } from "./sim-service-controller.js";
+/**
+ * Registry for simulated AWS localhost service controllers.
+ */
+export declare class SimAwsServiceControllerContainer {
+    private readonly simAws;
+    private readonly controllers;
+    private readonly controllerFactories;
+    constructor(simAws: SimAws);
+    /**
+     * Get the singleton controller for a simulated AWS service.
+     */
+    controllerForService(service: SimAwsServiceName): SimAwsServiceController;
+}
+//# sourceMappingURL=sim-aws-service-controller-container.d.ts.map

package/dist/serve/controller/sim-aws-service-controller-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-service-controller-container.d.ts","sourceRoot":"","sources":["../../../src/serve/controller/sim-aws-service-controller-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG/E,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,6BAA6B,CAAC;AAErC;;GAEG;AACH,qBAAa,gCAAgC;IAc/B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAbnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IAEnE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CASjC;gBAE0B,MAAM,EAAE,MAAM;IAE3C;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,iBAAiB,GAAG,uBAAuB;CAW1E"}

package/dist/serve/controller/sim-aws-service-controller-container.js

@@ -0,0 +1,29 @@
+import { SimS3ServiceController } from "../../service/s3/serve/sim-s3-controller.js";
+import { Memo } from "../../util/memo/memo.js";
+/**
+ * Registry for simulated AWS localhost service controllers.
+ */
+export class SimAwsServiceControllerContainer {
+    simAws;
+    controllers = new Memo();
+    controllerFactories = new Map([
+        [
+            "s3",
+            (simAws) => new SimS3ServiceController(simAws),
+        ],
+    ]);
+    constructor(simAws) {
+        this.simAws = simAws;
+    }
+    /**
+     * Get the singleton controller for a simulated AWS service.
+     */
+    controllerForService(service) {
+        const factory = this.controllerFactories.get(service);
+        if (factory === undefined) {
+            throw new Error(`No controller implemented for simulated AWS service ${service}`);
+        }
+        return this.controllers.getOrCreate(service, () => factory(this.simAws));
+    }
+}
+//# sourceMappingURL=sim-aws-service-controller-container.js.map

package/dist/serve/controller/sim-aws-service-controller-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-service-controller-container.js","sourceRoot":"","sources":["../../../src/serve/controller/sim-aws-service-controller-container.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAM/C;;GAEG;AACH,MAAM,OAAO,gCAAgC;IAcd;IAbZ,WAAW,GAAG,IAAI,IAAI,EAA2B,CAAC;IAElD,mBAAmB,GAAG,IAAI,GAAG,CAG5C;QACA;YACE,IAAI;YACJ,CAAC,MAAc,EAA0B,EAAE,CACzC,IAAI,sBAAsB,CAAC,MAAM,CAAC;SACrC;KACF,CAAC,CAAC;IAEH,YAA6B,MAAc;QAAd,WAAM,GAAN,MAAM,CAAQ;IAAG,CAAC;IAE/C;;OAEG;IACH,oBAAoB,CAAC,OAA0B;QAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEtD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,uDAAuD,OAAO,EAAE,CACjE,CAAC;QACJ,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/serve/controller/sim-service-controller.d.ts

@@ -0,0 +1,22 @@
+import type { SimAwsServiceName } from "../../service/aws/sim-aws-services.js";
+import type { AwsRegionName } from "../../service/aws/sim-aws-region.js";
+import type { SimAws } from "../../service/aws/sim-aws.js";
+export interface SimAwsServiceTarget {
+    readonly service: SimAwsServiceName;
+    readonly resourceName: string;
+    readonly regionName?: AwsRegionName;
+}
+/**
+ * Factory function for making instances of simulated AWS service controllers.
+ */
+export type SimAwsServiceControllerFactory = (simAws: SimAws) => SimAwsServiceController;
+/**
+ * Controller for a simulated AWS service exposed through HTTP.
+ */
+export interface SimAwsServiceController {
+    /**
+     * Handle an HTTP request routed to this simulated AWS service.
+     */
+    handleRequest(target: SimAwsServiceTarget, request: Request): Promise<Response>;
+}
+//# sourceMappingURL=sim-service-controller.d.ts.map

package/dist/serve/controller/sim-service-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-service-controller.d.ts","sourceRoot":"","sources":["../../../src/serve/controller/sim-service-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,CAC3C,MAAM,EAAE,MAAM,KACX,uBAAuB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,aAAa,CACX,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,QAAQ,CAAC,CAAC;CACtB"}

package/dist/serve/controller/sim-service-controller.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sim-service-controller.js.map

package/dist/serve/controller/sim-service-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-service-controller.js","sourceRoot":"","sources":["../../../src/serve/controller/sim-service-controller.ts"],"names":[],"mappings":""}

package/dist/serve/http/sim-aws-http.d.ts

@@ -0,0 +1,20 @@
+import { SimAws } from "../../service/aws/sim-aws.js";
+/**
+ * HTTP interface for sending requests into a simulated AWS environment.
+ */
+export declare class SimAwsHttp {
+    readonly simAws: SimAws;
+    private readonly serviceResolver;
+    private readonly controllers;
+    constructor(simAws?: SimAws);
+    /**
+     * Send a Fetch API request to simulated AWS.
+     */
+    fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>;
+    /**
+     * Handle a simulated AWS HTTP request.
+     */
+    handleRequest(request: Request): Promise<Response>;
+    private hostnameFromRequest;
+}
+//# sourceMappingURL=sim-aws-http.d.ts.map

package/dist/serve/http/sim-aws-http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-http.d.ts","sourceRoot":"","sources":["../../../src/serve/http/sim-aws-http.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtD;;GAEG;AACH,qBAAa,UAAU;aAIO,MAAM,EAAE,MAAM;IAH1C,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoC;IACpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmC;gBAEnC,MAAM,GAAE,MAAqB;IAIzD;;OAEG;IACG,KAAK,CACT,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,OAAO,EAC7B,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,QAAQ,CAAC;IAIpB;;OAEG;IACG,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IA8BxD,OAAO,CAAC,mBAAmB;CAS5B"}

package/dist/serve/http/sim-aws-http.js

@@ -0,0 +1,57 @@
+import { SimAwsLocalServiceResolver } from "../resolve/sim-aws-local-service-resolver.js";
+import { SimAwsServiceControllerContainer } from "../controller/sim-aws-service-controller-container.js";
+import { SimAws } from "../../service/aws/sim-aws.js";
+/**
+ * HTTP interface for sending requests into a simulated AWS environment.
+ */
+export class SimAwsHttp {
+    simAws;
+    serviceResolver = new SimAwsLocalServiceResolver();
+    controllers;
+    constructor(simAws = new SimAws()) {
+        this.simAws = simAws;
+        this.controllers = new SimAwsServiceControllerContainer(simAws);
+    }
+    /**
+     * Send a Fetch API request to simulated AWS.
+     */
+    async fetch(input, init) {
+        return this.handleRequest(new Request(input, init));
+    }
+    /**
+     * Handle a simulated AWS HTTP request.
+     */
+    async handleRequest(request) {
+        try {
+            const hostname = this.hostnameFromRequest(request);
+            if (hostname === undefined) {
+                return new Response("Missing Host header\n", { status: 400 });
+            }
+            const target = this.serviceResolver.resolveHost(hostname);
+            if (target === undefined) {
+                return new Response(`Unknown simulated AWS host ${hostname} \n`, {
+                    status: 501,
+                    headers: {
+                        "content-type": "text/plain; charset=utf-8",
+                    },
+                });
+            }
+            const controller = this.controllers.controllerForService(target.service);
+            return await controller.handleRequest(target, request);
+        }
+        catch (error) {
+            /* v8 ignore next */
+            return new Response(error instanceof Error
+                ? `${error.message}\n`
+                : "Internal server error\n", { status: 500 });
+        }
+    }
+    hostnameFromRequest(request) {
+        const hostname = new URL(request.url).hostname.toLowerCase();
+        if (hostname.length === 0) {
+            return undefined;
+        }
+        return hostname;
+    }
+}
+//# sourceMappingURL=sim-aws-http.js.map

package/dist/serve/http/sim-aws-http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-http.js","sourceRoot":"","sources":["../../../src/serve/http/sim-aws-http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,gCAAgC,EAAE,MAAM,uDAAuD,CAAC;AACzG,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAEtD;;GAEG;AACH,MAAM,OAAO,UAAU;IAIO;IAHX,eAAe,GAAG,IAAI,0BAA0B,EAAE,CAAC;IACnD,WAAW,CAAmC;IAE/D,YAA4B,SAAiB,IAAI,MAAM,EAAE;QAA7B,WAAM,GAAN,MAAM,CAAuB;QACvD,IAAI,CAAC,WAAW,GAAG,IAAI,gCAAgC,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CACT,KAA6B,EAC7B,IAAkB;QAElB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,OAAgB;QAClC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YACnD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,IAAI,QAAQ,CAAC,uBAAuB,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YAChE,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;YAC1D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,OAAO,IAAI,QAAQ,CAAC,8BAA8B,QAAQ,KAAK,EAAE;oBAC/D,MAAM,EAAE,GAAG;oBACX,OAAO,EAAE;wBACP,cAAc,EAAE,2BAA2B;qBAC5C;iBACF,CAAC,CAAC;YACL,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,oBAAoB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YACzE,OAAO,MAAM,UAAU,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oBAAoB;YACpB,OAAO,IAAI,QAAQ,CACjB,KAAK,YAAY,KAAK;gBACpB,CAAC,CAAC,GAAG,KAAK,CAAC,OAAO,IAAI;gBACtB,CAAC,CAAC,yBAAyB,EAC7B,EAAE,MAAM,EAAE,GAAG,EAAE,CAChB,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,mBAAmB,CAAC,OAAgB;QAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAE7D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/serve/http/sim-aws-local-server.d.ts

@@ -0,0 +1,37 @@
+import { SimAws } from "../../service/aws/sim-aws.js";
+/**
+ * Local HTTP server for a simulated AWS environment.
+ * Useful for local integration testing and local development.
+ */
+export declare class SimAwsLocalServer {
+    readonly simAws: SimAws;
+    private readonly simAwsHttp;
+    private readonly server;
+    constructor(simAws?: SimAws);
+    /**
+     * Start serving simulated AWS services on localhost.
+     */
+    listen(port?: number): Promise<this>;
+    /**
+     * Get the hostname on which this local server is listening.
+     */
+    get hostname(): string;
+    /**
+     * Get the TCP port on which this local server is listening.
+     */
+    get port(): string;
+    /**
+     * Stop serving simulated AWS services.
+     */
+    close(): void;
+    private waitForListening;
+    private handleRequest;
+    private nodeRequestToFetchRequest;
+    private nodeRequestHeaders;
+    private sendFetchResponse;
+}
+/**
+ * Serve a simulated AWS environment on localhost.
+ */
+export declare function serveSimAws(simAws?: SimAws, port?: number): Promise<SimAwsLocalServer>;
+//# sourceMappingURL=sim-aws-local-server.d.ts.map

package/dist/serve/http/sim-aws-local-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-local-server.d.ts","sourceRoot":"","sources":["../../../src/serve/http/sim-aws-local-server.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAKtD;;;GAGG;AACH,qBAAa,iBAAiB;aAIA,MAAM,EAAE,MAAM;IAH1C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEJ,MAAM,GAAE,MAAqB;IAOzD;;OAEG;IACG,MAAM,CAAC,IAAI,GAAE,MAAoC,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvE;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAYjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;YAIC,gBAAgB;YA4BhB,aAAa;IAU3B,OAAO,CAAC,yBAAyB;IAmBjC,OAAO,CAAC,kBAAkB;YAsBZ,iBAAiB;CAiBhC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,GAAE,MAAqB,EAC7B,IAAI,GAAE,MAAoC,GACzC,OAAO,CAAC,iBAAiB,CAAC,CAG5B"}

package/dist/serve/http/sim-aws-local-server.js

@@ -0,0 +1,132 @@
+import http, {} from "node:http";
+import { SimAws } from "../../service/aws/sim-aws.js";
+import { simAwsLocalConf } from "./sim-aws-local.conf.js";
+import { SimAwsHttp } from "./sim-aws-http.js";
+import { assertDefined } from "../../util/defined.js";
+/**
+ * Local HTTP server for a simulated AWS environment.
+ * Useful for local integration testing and local development.
+ */
+export class SimAwsLocalServer {
+    simAws;
+    simAwsHttp;
+    server;
+    constructor(simAws = new SimAws()) {
+        this.simAws = simAws;
+        this.simAwsHttp = new SimAwsHttp(simAws);
+        this.server = http.createServer((request, response) => {
+            void this.handleRequest(request, response);
+        });
+    }
+    /**
+     * Start serving simulated AWS services on localhost.
+     */
+    async listen(port = simAwsLocalConf.defaultPort) {
+        this.server.listen(port, this.hostname);
+        await this.waitForListening();
+        return this;
+    }
+    /**
+     * Get the hostname on which this local server is listening.
+     */
+    get hostname() {
+        return simAwsLocalConf.hostname;
+    }
+    /**
+     * Get the TCP port on which this local server is listening.
+     */
+    get port() {
+        if (!this.server.listening) {
+            throw new Error("Server is not yet listening, cannot get port number");
+        }
+        const address = this.server.address();
+        /* v8 ignore if -- does not happen in practice */
+        if (address === null || typeof address === "string") {
+            throw new Error("Expected local HTTP server to listen on a TCP port");
+        }
+        return String(address.port);
+    }
+    /**
+     * Stop serving simulated AWS services.
+     */
+    close() {
+        this.server.close();
+    }
+    async waitForListening() {
+        /* v8 ignore if -- cannot happen in practice */
+        if (this.server.listening) {
+            return;
+        }
+        await new Promise((resolve, reject) => {
+            const listening = () => {
+                cleanup();
+                resolve();
+            };
+            /* v8 ignore next */
+            const error = (cause) => {
+                cleanup();
+                reject(cause);
+            };
+            const cleanup = () => {
+                this.server.off("listening", listening);
+                this.server.off("error", error);
+            };
+            this.server.once("listening", listening);
+            this.server.once("error", error);
+        });
+    }
+    async handleRequest(nodeRequest, nodeResponse) {
+        const request = this.nodeRequestToFetchRequest(nodeRequest);
+        const response = await this.simAwsHttp.handleRequest(request);
+        await this.sendFetchResponse(nodeResponse, response);
+    }
+    nodeRequestToFetchRequest(nodeRequest) {
+        const host = nodeRequest.headers.host;
+        assertDefined(host, "local sim server nodeRequest.headers.host");
+        const url = new URL(nodeRequest.url ?? "/", `http://${host}`);
+        return new Request(url, {
+            method: nodeRequest.method,
+            headers: this.nodeRequestHeaders(nodeRequest),
+            body: nodeRequest.method === "GET" || nodeRequest.method === "HEAD"
+                ? undefined
+                : nodeRequest,
+            duplex: nodeRequest.method === "GET" || nodeRequest.method === "HEAD"
+                ? undefined
+                : "half",
+        });
+    }
+    nodeRequestHeaders(nodeRequest) {
+        const headers = new Headers();
+        for (const [name, value] of Object.entries(nodeRequest.headers)) {
+            /* v8 ignore if -- does not happen in practice */
+            if (value === undefined) {
+                continue;
+            }
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    headers.append(name, item);
+                }
+                continue;
+            }
+            headers.set(name, value);
+        }
+        return headers;
+    }
+    async sendFetchResponse(nodeResponse, response) {
+        nodeResponse.writeHead(response.status, Object.fromEntries(response.headers.entries()));
+        if (response.body === null) {
+            nodeResponse.end();
+            return;
+        }
+        const body = Buffer.from(await response.arrayBuffer());
+        nodeResponse.end(body);
+    }
+}
+/**
+ * Serve a simulated AWS environment on localhost.
+ */
+export async function serveSimAws(simAws = new SimAws(), port = simAwsLocalConf.defaultPort) {
+    const server = new SimAwsLocalServer(simAws);
+    return server.listen(port);
+}
+//# sourceMappingURL=sim-aws-local-server.js.map

package/dist/serve/http/sim-aws-local-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-local-server.js","sourceRoot":"","sources":["../../../src/serve/http/sim-aws-local-server.ts"],"names":[],"mappings":"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"}

package/dist/serve/http/sim-aws-local.conf.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Default configuration for serving simulated AWS on localhost.
+ */
+export declare const simAwsLocalConf: {
+    hostname: string;
+    defaultPort: number;
+};
+//# sourceMappingURL=sim-aws-local.conf.d.ts.map

package/dist/serve/http/sim-aws-local.conf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-local.conf.d.ts","sourceRoot":"","sources":["../../../src/serve/http/sim-aws-local.conf.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,eAAe;;;CAG3B,CAAC"}

package/dist/serve/http/sim-aws-local.conf.js

@@ -0,0 +1,8 @@
+/**
+ * Default configuration for serving simulated AWS on localhost.
+ */
+export const simAwsLocalConf = {
+    hostname: "sim-aws.localhost",
+    defaultPort: 0,
+};
+//# sourceMappingURL=sim-aws-local.conf.js.map

package/dist/serve/http/sim-aws-local.conf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-local.conf.js","sourceRoot":"","sources":["../../../src/serve/http/sim-aws-local.conf.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,CAAC;CACf,CAAC"}

package/dist/serve/index.d.ts

@@ -0,0 +1,3 @@
+export { SimAwsHttp } from "./http/sim-aws-http.js";
+export { serveSimAws, SimAwsLocalServer } from "./http/sim-aws-local-server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/serve/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/serve/index.js

@@ -0,0 +1,3 @@
+export { SimAwsHttp } from "./http/sim-aws-http.js";
+export { serveSimAws, SimAwsLocalServer } from "./http/sim-aws-local-server.js";
+//# sourceMappingURL=index.js.map

package/dist/serve/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC"}

package/dist/serve/resolve/sim-aws-local-service-resolver.d.ts

@@ -0,0 +1,13 @@
+import type { SimAwsServiceTarget } from "../controller/sim-service-controller.js";
+export declare const localhostSuffix: string;
+/**
+ * Default resolver for localhost subdomains to simulated AWS services.
+ */
+export declare class SimAwsLocalServiceResolver {
+    /**
+     * Resolve a localhost subdomain hostname to a simulated AWS service target.
+     */
+    resolveHost(hostname: string): SimAwsServiceTarget | undefined;
+    private builtinLocalhostServiceTarget;
+}
+//# sourceMappingURL=sim-aws-local-service-resolver.d.ts.map

package/dist/serve/resolve/sim-aws-local-service-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-local-service-resolver.d.ts","sourceRoot":"","sources":["../../../src/serve/resolve/sim-aws-local-service-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAInF,eAAO,MAAM,eAAe,QAAiC,CAAC;AAG9D;;GAEG;AACH,qBAAa,0BAA0B;IACrC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAI9D,OAAO,CAAC,6BAA6B;CAgCtC"}

package/dist/serve/resolve/sim-aws-local-service-resolver.js

@@ -0,0 +1,38 @@
+import { simAwsLocalConf } from "../http/sim-aws-local.conf.js";
+export const localhostSuffix = `.${simAwsLocalConf.hostname}`;
+const s3WebsiteServiceLabel = "s3-website";
+/**
+ * Default resolver for localhost subdomains to simulated AWS services.
+ */
+export class SimAwsLocalServiceResolver {
+    /**
+     * Resolve a localhost subdomain hostname to a simulated AWS service target.
+     */
+    resolveHost(hostname) {
+        return this.builtinLocalhostServiceTarget(hostname);
+    }
+    builtinLocalhostServiceTarget(hostname) {
+        if (!hostname.endsWith(localhostSuffix)) {
+            return undefined;
+        }
+        const labels = hostname.slice(0, -localhostSuffix.length).split(".");
+        if (labels.length < 3) {
+            return undefined;
+        }
+        const service = labels.at(-2);
+        const regionName = labels.at(-1);
+        if (service === s3WebsiteServiceLabel && regionName !== undefined) {
+            const resourceName = labels.slice(0, -2).join(".");
+            if (resourceName.length === 0 || regionName.length === 0) {
+                return undefined;
+            }
+            return {
+                service: "s3",
+                resourceName,
+                regionName,
+            };
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=sim-aws-local-service-resolver.js.map

package/dist/serve/resolve/sim-aws-local-service-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-local-service-resolver.js","sourceRoot":"","sources":["../../../src/serve/resolve/sim-aws-local-service-resolver.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,eAAe,CAAC,QAAQ,EAAE,CAAC;AAC9D,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,0BAA0B;IACrC;;OAEG;IACH,WAAW,CAAC,QAAgB;QAC1B,OAAO,IAAI,CAAC,6BAA6B,CAAC,QAAQ,CAAC,CAAC;IACtD,CAAC;IAEO,6BAA6B,CACnC,QAAgB;QAEhB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACxC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAErE,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,UAAU,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAA8B,CAAC;QAE9D,IAAI,OAAO,KAAK,qBAAqB,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAClE,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEnD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzD,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,YAAY;gBACZ,UAAU;aACX,CAAC;QACJ,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/service/aws/arn.d.ts

@@ -0,0 +1,17 @@
+import { type AwsRegionName } from "./sim-aws-region.js";
+import { type SimAwsAccountId } from "./sim-aws-account.js";
+import { type SimAwsServiceName } from "./sim-aws-services.js";
+export type SimArn = `arn:aws:${SimAwsServiceName}:${AwsRegionName}:${SimAwsAccountId}:${string}/${string}`;
+export interface SimArnComponents {
+    partition: "aws";
+    service: SimAwsServiceName;
+    region: AwsRegionName;
+    accountId: SimAwsAccountId;
+    resourceType: string;
+    resourceId: string;
+}
+/**
+ * Generate a fake ARN.
+ */
+export declare function makeSimArn(overrides?: Partial<SimArnComponents>): SimArn;
+//# sourceMappingURL=arn.d.ts.map

package/dist/service/aws/arn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arn.d.ts","sourceRoot":"","sources":["../../../src/service/aws/arn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAqB,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,MAAM,MAAM,GAChB,WAAW,iBAAiB,IAAI,aAAa,IAAI,eAAe,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAEzF,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,KAAK,CAAC;IACjB,OAAO,EAAE,iBAAiB,CAAC;IAC3B,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,eAAe,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAWD;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAGxE"}

package/dist/service/aws/arn.js

@@ -0,0 +1,21 @@
+import { makeAwsRegionName } from "./sim-aws-region.js";
+import { makeSimAwsAccountId, } from "./sim-aws-account.js";
+import { DynamicFactory } from "@kensio/part-factory";
+import { faker } from "@faker-js/faker";
+import { SIM_AWS_SERVICE_NAMES, } from "./sim-aws-services.js";
+const simArnComponentsFactory = new DynamicFactory(() => ({
+    partition: "aws",
+    service: faker.helpers.arrayElement(SIM_AWS_SERVICE_NAMES),
+    region: makeAwsRegionName(),
+    accountId: makeSimAwsAccountId(),
+    resourceType: "resource",
+    resourceId: faker.string.alphanumeric({ length: 10 }),
+}));
+/**
+ * Generate a fake ARN.
+ */
+export function makeSimArn(overrides) {
+    const components = simArnComponentsFactory.make(overrides);
+    return `arn:${components.partition}:${components.service}:${components.region}:${components.accountId}:${components.resourceType}/${components.resourceId}`;
+}
+//# sourceMappingURL=arn.js.map

package/dist/service/aws/arn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arn.js","sourceRoot":"","sources":["../../../src/service/aws/arn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EACL,mBAAmB,GAEpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AACxC,OAAO,EACL,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAc/B,MAAM,uBAAuB,GAAG,IAAI,cAAc,CAAmB,GAAG,EAAE,CAAC,CAAC;IAC1E,SAAS,EAAE,KAAK;IAChB,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,qBAAqB,CAAC;IAC1D,MAAM,EAAE,iBAAiB,EAAE;IAC3B,SAAS,EAAE,mBAAmB,EAAE;IAChC,YAAY,EAAE,UAAU;IACxB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;CACtD,CAAC,CAAC,CAAC;AAEJ;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,SAAqC;IAC9D,MAAM,UAAU,GAAG,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3D,OAAO,OAAO,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,YAAY,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;AAC9J,CAAC"}

package/dist/service/aws/sim-aws-account-region-scope.d.ts

@@ -0,0 +1,38 @@
+import { type SimAwsAccount, type SimAwsAccountId } from "./sim-aws-account.js";
+import { type AwsRegionName, type SimAwsRegion } from "./sim-aws-region.js";
+import type { SimAwsServices } from "./sim-aws-services.js";
+import { SimDynamoDb } from "../dynamodb/sim-dynamodb.js";
+import { SimS3 } from "../s3/sim-s3.js";
+import { SimAws } from "./sim-aws.js";
+import { DynamicFactory } from "@kensio/part-factory";
+import type { SimS3GlobalRegistry } from "../s3/sim-s3-global-registry.js";
+export type SimAccountRegionScopeKey = `${SimAwsAccountId}:${AwsRegionName}`;
+/**
+ * Combined simulated AWS Account and Region scope.
+ */
+export declare class SimAwsAccountRegionContainer implements SimAwsServices {
+    private readonly simAws;
+    readonly account: SimAwsAccount;
+    readonly region: SimAwsRegion;
+    private readonly s3GlobalRegistry;
+    private readonly memo;
+    private readonly accountRegionScope;
+    constructor(simAws?: SimAws, account?: SimAwsAccount, region?: SimAwsRegion, s3GlobalRegistry?: SimS3GlobalRegistry);
+    /**
+     * Get the simulated DynamoDB service for this account and region.
+     */
+    dynamoDb(): SimDynamoDb;
+    /**
+     * Get the simulated S3 service for this account and region.
+     */
+    s3(): SimS3;
+}
+export interface SimAwsAccountRegionScope {
+    accountId: SimAwsAccountId;
+    regionName: AwsRegionName;
+}
+/**
+ * Generates fake simulated AWS resource scopes.
+ */
+export declare const simAwsAccountRegionScopeFactory: DynamicFactory<SimAwsAccountRegionScope>;
+//# sourceMappingURL=sim-aws-account-region-scope.d.ts.map