@kensio/yulin 0.34.2 → 0.36.0

package/README.md

@@ -27,6 +27,11 @@ npm i -D @kensio/yulin
 - [S3](./docs/services/s3 "Simulated S3 docs")
 - [STS](./docs/services/sts "Simulated STS docs")
 
+## Feature specific docs
+
+- [AWS SDK interception](./docs/sdk "Simulated AWS SDK docs")
+- [Simulated time](./docs/time "Simulated time docs")
+
 ## Usage
 
 ### Intercept AWS SDK clients
@@ -170,6 +175,38 @@ console.log(bucketWebsiteUrl.toString());
 const res = await fetch(new URL("/foo/", bucketWebsiteUrl));
 ```
 
+### Control simulated time
+
+Each simulated AWS has its own clock, which you can freeze, set, or advance. This lets a test
+exercise behaviour that only happens once time passes, without waiting for it and without replacing
+the clock for the whole process:
+
+```typescript
+import { SimAws } from "@kensio/yulin";
+import { AssumeRoleCommand } from "@aws-sdk/client-sts";
+
+const simAws = new SimAws();
+
+// Assumes a ReportingRole this Account is already allowed to assume; the
+// simulated time docs below show the same example with its IAM setup.
+const { Credentials } = await simAws.sts().assumeRole(
+  new AssumeRoleCommand({
+    RoleArn: `arn:aws:iam::${simAws.defaultAccountId}:role/ReportingRole`,
+    RoleSessionName: "reporting-session",
+    DurationSeconds: 900,
+  }),
+);
+
+await simAws.clock().advanceBy({ minutes: 20 });
+
+// Those session credentials have now expired.
+```
+
+Advancing runs whatever falls due during the interval and returns once the simulation has settled,
+so the next line can assert. Time belongs to the `SimAws` instance, so moving it never disturbs
+another simulation, or the real clock. See the
+[simulated time docs](./docs/time "Simulated time docs") for full usage.
+
 ## What is yulin?
 
 TLDR: yulin is an AWS simulator for testing Node.js applications.

package/dist/index.d.ts

@@ -1,4 +1,9 @@
 export { SimAws } from "./service/aws/sim-aws.js";
 export type { AwsRegionName } from "./service/aws/sim-aws-region.js";
 export type { SimAwsAccountId } from "./service/aws/sim-aws-account.js";
+export { type SimClock, SimFixedClock, SimRealClock, } from "./util/clock/sim-clock.js";
+export { SimControllableClock } from "./util/clock/sim-controllable-clock.js";
+export { SimClockControl } from "./util/clock/sim-clock-control.js";
+export { SimDuration, type SimDurationInput, SimInvalidDuration, } from "./util/clock/sim-duration.js";
+export { SimAwsTimeNotControllable } from "./service/aws/sim-aws-timekeeping.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAClD,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,EACL,KAAK,QAAQ,EACb,aAAa,EACb,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC"}

package/dist/index.js

@@ -1,2 +1,7 @@
 export { SimAws } from "./service/aws/sim-aws.js";
+export { SimFixedClock, SimRealClock, } from "./util/clock/sim-clock.js";
+export { SimControllableClock } from "./util/clock/sim-controllable-clock.js";
+export { SimClockControl } from "./util/clock/sim-clock-control.js";
+export { SimDuration, SimInvalidDuration, } from "./util/clock/sim-duration.js";
+export { SimAwsTimeNotControllable } from "./service/aws/sim-aws-timekeeping.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AAGlD,OAAO,EAEL,aAAa,EACb,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EACL,WAAW,EAEX,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"sim-aws-service-controller-factory.d.ts","sourceRoot":"","sources":["../../../../src/serve/controller/factory/sim-aws-service-controller-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAI9D;;GAEG;AACH,qBAAa,8BAA8B;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAnC,YAA6B,MAAM,EAAE,MAAM,EAAI;IAE/C;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,uBAAuB,CAgBnD;CACF"}
+{"version":3,"file":"sim-aws-service-controller-factory.d.ts","sourceRoot":"","sources":["../../../../src/serve/controller/factory/sim-aws-service-controller-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAC5E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAM9D;;GAEG;AACH,qBAAa,8BAA8B;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAnC,YAA6B,MAAM,EAAE,MAAM,EAAI;IAE/C;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,uBAAuB,CAsBnD;CACF"}

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

@@ -1,4 +1,6 @@
 import { SimCloudFrontServiceController } from "../../../service/cloudfront/controller/sim-cloudfront-controller.js";
+import { SimLambdaServiceController } from "../../../service/lambda/serve/sim-lambda-controller.js";
+import { SimRoute53ServiceController } from "../../../service/route53/serve/sim-route53-controller.js";
 import { SimS3ServiceController } from "../../../service/s3/serve/sim-s3-controller.js";
 /**
  * Factory for simulated AWS HTTP service controllers.
@@ -21,6 +23,12 @@ export class SimAwsServiceControllerFactory {
                     simAws: this.simAws,
                 });
             }
+            case "lambda": {
+                return new SimLambdaServiceController({ simAws: this.simAws });
+            }
+            case "route53": {
+                return new SimRoute53ServiceController({ simAws: this.simAws });
+            }
             default: {
                 throw new Error(`No controller for simulated AWS service ${serviceName}`);
             }

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

@@ -1 +1 @@
-{"version":3,"file":"sim-aws-service-controller-factory.js","sourceRoot":"","sources":["../../../../src/serve/controller/factory/sim-aws-service-controller-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,8BAA8B,EAAE,MAAM,qEAAqE,CAAC;AACrH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AAExF;;GAEG;AACH,MAAM,OAAO,8BAA8B;IACZ,MAAM;IAAnC,YAA6B,MAAc;sBAAd,MAAM;IAAW,CAAC;IAE/C;;OAEG;IACH,MAAM,CAAC,WAAmB;QACxB,QAAQ,WAAW,EAAE,CAAC;YACpB,KAAK,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,KAAK,YAAY,EAAE,CAAC;gBAClB,OAAO,IAAI,8BAA8B,CAAC;oBACxC,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,CAAC;YACL,CAAC;YACD,SAAS,CAAC;gBACR,MAAM,IAAI,KAAK,CACb,2CAA2C,WAAW,EAAE,CACzD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"sim-aws-service-controller-factory.js","sourceRoot":"","sources":["../../../../src/serve/controller/factory/sim-aws-service-controller-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,8BAA8B,EAAE,MAAM,qEAAqE,CAAC;AACrH,OAAO,EAAE,0BAA0B,EAAE,MAAM,wDAAwD,CAAC;AACpG,OAAO,EAAE,2BAA2B,EAAE,MAAM,0DAA0D,CAAC;AACvG,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AAExF;;GAEG;AACH,MAAM,OAAO,8BAA8B;IACZ,MAAM;IAAnC,YAA6B,MAAc;sBAAd,MAAM;IAAW,CAAC;IAE/C;;OAEG;IACH,MAAM,CAAC,WAAmB;QACxB,QAAQ,WAAW,EAAE,CAAC;YACpB,KAAK,IAAI,EAAE,CAAC;gBACV,OAAO,IAAI,sBAAsB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAC7D,CAAC;YACD,KAAK,YAAY,EAAE,CAAC;gBAClB,OAAO,IAAI,8BAA8B,CAAC;oBACxC,MAAM,EAAE,IAAI,CAAC,MAAM;iBACpB,CAAC,CAAC;YACL,CAAC;YACD,KAAK,QAAQ,EAAE,CAAC;gBACd,OAAO,IAAI,0BAA0B,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,KAAK,SAAS,EAAE,CAAC;gBACf,OAAO,IAAI,2BAA2B,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,SAAS,CAAC;gBACR,MAAM,IAAI,KAAK,CACb,2CAA2C,WAAW,EAAE,CACzD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+import type { SimAwsServiceTarget } from "./sim-service-controller.js";
+/**
+ * The SigV4 signing name of each simulated service a request can be routed to.
+ *
+ * Service targets use the simulator's own naming, which follows the SDK client
+ * names, while a credential scope names the service the way the signer does.
+ * They agree for most services and not for CloudFront, so the two vocabularies
+ * are mapped here rather than assumed to be the same string.
+ */
+export declare function simAwsServiceSigningName(service: SimAwsServiceTarget["service"]): string;
+//# sourceMappingURL=sim-aws-service-signing-name.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-service-signing-name.d.ts","sourceRoot":"","sources":["../../../src/serve/controller/sim-aws-service-signing-name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEvE;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,GACtC,MAAM,CAeR"}

package/dist/serve/controller/sim-aws-service-signing-name.js

@@ -0,0 +1,25 @@
+/**
+ * The SigV4 signing name of each simulated service a request can be routed to.
+ *
+ * Service targets use the simulator's own naming, which follows the SDK client
+ * names, while a credential scope names the service the way the signer does.
+ * They agree for most services and not for CloudFront, so the two vocabularies
+ * are mapped here rather than assumed to be the same string.
+ */
+export function simAwsServiceSigningName(service) {
+    switch (service) {
+        case "cloudFront": {
+            return "cloudfront";
+        }
+        case "s3": {
+            return "s3";
+        }
+        case "lambda": {
+            return "lambda";
+        }
+        case "route53": {
+            return "route53";
+        }
+    }
+}
+//# sourceMappingURL=sim-aws-service-signing-name.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-service-signing-name.js","sourceRoot":"","sources":["../../../src/serve/controller/sim-aws-service-signing-name.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAuC;IAEvC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,YAAY,EAAE,CAAC;YAClB,OAAO,YAAY,CAAC;QACtB,CAAC;QACD,KAAK,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC;QACd,CAAC;QACD,KAAK,QAAQ,EAAE,CAAC;YACd,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,KAAK,SAAS,EAAE,CAAC;YACf,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC"}

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

@@ -1,10 +1,36 @@
 import type { AwsRegionName } from "../../service/aws/sim-aws-region.js";
 import type { SimAws } from "../../service/aws/sim-aws.js";
+import { SimAwsRequestCaller } from "../../service/iam/request/sim-aws-request-caller.js";
 export interface SimAwsServiceTarget {
-    readonly service: "s3" | "cloudFront";
+    readonly service: "s3" | "cloudFront" | "lambda" | "route53";
     readonly resourceName: string;
     readonly regionName?: AwsRegionName;
 }
+interface SimAwsServiceRequestProperties {
+    readonly target: SimAwsServiceTarget;
+    readonly request: Request;
+    readonly caller?: SimAwsRequestCaller | undefined;
+    readonly body?: Uint8Array | undefined;
+}
+/**
+ * One HTTP request, routed to a simulated service and attributed to a
+ * principal.
+ *
+ * Controllers are handed this rather than a bare request because everything
+ * they need has already been settled once at the boundary: which resource the
+ * hostname names, who is asking, and the request body, buffered so that both
+ * signature verification and the controller can read the same bytes.
+ *
+ * The request carries no simulator control headers, so a Lambda handler
+ * echoing `event.headers` sees the request as its client sent it.
+ */
+export declare class SimAwsServiceRequest {
+    readonly target: SimAwsServiceTarget;
+    readonly request: Request;
+    readonly caller: SimAwsRequestCaller;
+    readonly body?: Uint8Array | undefined;
+    constructor(properties: SimAwsServiceRequestProperties);
+}
 /**
  * Factory function for making instances of simulated AWS service controllers.
  */
@@ -16,6 +42,7 @@ export interface SimAwsServiceController {
     /**
      * Handle an HTTP request routed to this simulated AWS service.
      */
-    handleRequest(target: SimAwsServiceTarget, request: Request): Promise<Response>;
+    handleRequest(serviceRequest: SimAwsServiceRequest): Promise<Response>;
 }
+export {};
 //# sourceMappingURL=sim-service-controller.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sim-service-controller.d.ts","sourceRoot":"","sources":["../../../src/serve/controller/sim-service-controller.ts"],"names":[],"mappings":"AAAA,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,IAAI,GAAG,YAAY,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,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"}
+{"version":3,"file":"sim-service-controller.d.ts","sourceRoot":"","sources":["../../../src/serve/controller/sim-service-controller.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAE1F,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,IAAI,GAAG,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;CACrC;AAED,UAAU,8BAA8B;IACtC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACxC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAoB;IAC/B,SAAgB,MAAM,EAAE,mBAAmB,CAAC;IAC5C,SAAgB,OAAO,EAAE,OAAO,CAAC;IACjC,SAAgB,MAAM,EAAE,mBAAmB,CAAC;IAC5C,SAAgB,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAE9C,YAAY,UAAU,EAAE,8BAA8B,EAMrD;CACF;AAED;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,CAC3C,MAAM,EAAE,MAAM,KACX,uBAAuB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,aAAa,CAAC,cAAc,EAAE,oBAAoB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACxE"}

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

@@ -1,2 +1,27 @@
-export {};
+import { SimAwsRequestCaller } from "../../service/iam/request/sim-aws-request-caller.js";
+/**
+ * One HTTP request, routed to a simulated service and attributed to a
+ * principal.
+ *
+ * Controllers are handed this rather than a bare request because everything
+ * they need has already been settled once at the boundary: which resource the
+ * hostname names, who is asking, and the request body, buffered so that both
+ * signature verification and the controller can read the same bytes.
+ *
+ * The request carries no simulator control headers, so a Lambda handler
+ * echoing `event.headers` sees the request as its client sent it.
+ */
+export class SimAwsServiceRequest {
+    target;
+    request;
+    caller;
+    body;
+    constructor(properties) {
+        this.target = properties.target;
+        this.request = properties.request;
+        // An unattributed request is anonymous, never the Account root.
+        this.caller = properties.caller ?? SimAwsRequestCaller.anonymous();
+        this.body = properties.body;
+    }
+}
 //# sourceMappingURL=sim-service-controller.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sim-service-controller.js","sourceRoot":"","sources":["../../../src/serve/controller/sim-service-controller.ts"],"names":[],"mappings":""}
+{"version":3,"file":"sim-service-controller.js","sourceRoot":"","sources":["../../../src/serve/controller/sim-service-controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAgB1F;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,oBAAoB;IACf,MAAM,CAAsB;IAC5B,OAAO,CAAU;IACjB,MAAM,CAAsB;IAC5B,IAAI,CAA0B;IAE9C,YAAY,UAA0C;QACpD,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAClC,gEAAgE;QAChE,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,mBAAmB,CAAC,SAAS,EAAE,CAAC;QACnE,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF"}

package/dist/serve/dns/sim-aws-dns-server.d.ts

@@ -0,0 +1,39 @@
+import { SimAws } from "../../service/aws/sim-aws.js";
+interface SimAwsDnsServerProperties {
+    readonly simAws?: SimAws;
+}
+/**
+ * Local DNS server for a simulated AWS environment.
+ *
+ * Answers real DNS queries over UDP, so simulated hosted zones can be inspected
+ * with an ordinary DNS client. UDP only: a resolver falls back to TCP for
+ * responses too large for a datagram, and the simulator's answers never are.
+ */
+export declare class SimAwsDnsServer {
+    private readonly dns;
+    private socket;
+    private listening;
+    constructor(properties?: SimAwsDnsServerProperties);
+    /**
+     * Start answering DNS queries, preferring a given port number.
+     *
+     * UDP and TCP port namespaces are separate, so the number the HTTP server
+     * took on TCP is normally free on UDP and one number serves both protocols.
+     * That is a convenience rather than a guarantee: an unrelated process may
+     * already hold that UDP port, so binding falls back to an ephemeral port and
+     * reports it through `port` instead of failing to serve DNS at all.
+     */
+    listen(preferredPort: number): Promise<this>;
+    /**
+     * Get the UDP port on which this DNS server is listening.
+     */
+    get port(): string;
+    /**
+     * Stop answering DNS queries.
+     */
+    close(): void;
+    private createSocket;
+    private bind;
+}
+export {};
+//# sourceMappingURL=sim-aws-dns-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-dns-server.d.ts","sourceRoot":"","sources":["../../../src/serve/dns/sim-aws-dns-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAItD,UAAU,yBAAyB;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAY;IAChC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,SAAS,CAAS;IAE1B,YAAY,UAAU,GAAE,yBAA8B,EAIrD;IAED;;;;;;;;OAQG;IACG,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYjD;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAQjB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAOZ;IAED,OAAO,CAAC,YAAY;YA2BN,IAAI;CAcnB"}

package/dist/serve/dns/sim-aws-dns-server.js

@@ -0,0 +1,94 @@
+import dgram from "node:dgram";
+import { SimAws } from "../../service/aws/sim-aws.js";
+import { simAwsLocalConfig } from "../http/local-server/sim-aws-local.config.js";
+import { SimAwsDns } from "./sim-aws-dns.js";
+/**
+ * Local DNS server for a simulated AWS environment.
+ *
+ * Answers real DNS queries over UDP, so simulated hosted zones can be inspected
+ * with an ordinary DNS client. UDP only: a resolver falls back to TCP for
+ * responses too large for a datagram, and the simulator's answers never are.
+ */
+export class SimAwsDnsServer {
+    dns;
+    socket;
+    listening = false;
+    constructor(properties = {}) {
+        const { simAws = new SimAws() } = properties;
+        this.dns = new SimAwsDns({ simAws });
+        this.socket = this.createSocket();
+    }
+    /**
+     * Start answering DNS queries, preferring a given port number.
+     *
+     * UDP and TCP port namespaces are separate, so the number the HTTP server
+     * took on TCP is normally free on UDP and one number serves both protocols.
+     * That is a convenience rather than a guarantee: an unrelated process may
+     * already hold that UDP port, so binding falls back to an ephemeral port and
+     * reports it through `port` instead of failing to serve DNS at all.
+     */
+    async listen(preferredPort) {
+        try {
+            await this.bind(preferredPort);
+        }
+        catch {
+            // The preferred number is free on TCP but held by something else on UDP.
+            // A socket whose bind failed cannot be reused, so it is replaced.
+            this.socket.close();
+            this.socket = this.createSocket();
+            await this.bind(0);
+        }
+        return this;
+    }
+    /**
+     * Get the UDP port on which this DNS server is listening.
+     */
+    get port() {
+        if (!this.listening) {
+            throw new Error("DNS server is not yet listening, cannot get port number");
+        }
+        return String(this.socket.address().port);
+    }
+    /**
+     * Stop answering DNS queries.
+     */
+    close() {
+        if (!this.listening) {
+            return;
+        }
+        this.listening = false;
+        this.socket.close();
+    }
+    createSocket() {
+        const socket = dgram.createSocket("udp4");
+        // A socket with no error listener throws on an 'error' event, which would
+        // take the process down. Nothing useful can be done about a datagram that
+        // failed to send to a client that may no longer be there, so the error is
+        // absorbed and the server keeps answering.
+        socket.on("error", () => {
+            // Nothing to do but keep serving.
+        });
+        socket.on("message", (message, remote) => {
+            // The send callback keeps a failure here from reaching the socket's error
+            // event as an unhandled one.
+            socket.send(this.dns.handleQuery(message), remote.port, remote.address, () => {
+                // Delivery failure is the client's problem, not the server's.
+            });
+        });
+        return socket;
+    }
+    async bind(port) {
+        await new Promise((resolve, reject) => {
+            const onError = (error) => {
+                reject(error);
+            };
+            this.socket.once("error", onError);
+            this.socket.bind(port, simAwsLocalConfig.loopbackAddress, () => {
+                this.socket.off("error", onError);
+                this.listening = true;
+                resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=sim-aws-dns-server.js.map

package/dist/serve/dns/sim-aws-dns-server.js.map

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

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

@@ -0,0 +1,37 @@
+import { SimAws } from "../../service/aws/sim-aws.js";
+interface SimAwsDnsProperties {
+    readonly simAws?: SimAws;
+    readonly serviceAddress?: string;
+}
+/**
+ * DNS interface for a simulated AWS environment.
+ *
+ * Turns a query datagram into a response datagram. Holding no socket keeps this
+ * testable without networking, in the same way `SimAwsHttp` handles a request
+ * without owning a listener.
+ */
+export declare class SimAwsDns {
+    private readonly simAws;
+    private readonly serviceAddress;
+    constructor(properties?: SimAwsDnsProperties);
+    /**
+     * Answer a DNS query datagram.
+     *
+     * This never throws: a server on a socket has to answer whatever arrives.
+     *
+     * The two failure modes are kept apart because they mean different things to a
+     * resolver. A datagram that cannot be decoded is the sender's problem and gets
+     * a format error. A datagram that decoded fine but could not be answered — an
+     * unencodable stored record value, say — is the server's problem and gets a
+     * server failure, so a resolver does not conclude it sent something malformed.
+     */
+    handleQuery(message: Uint8Array): Uint8Array;
+    private answerQuery;
+    /**
+     * Answer a datagram that could not be handled, echoing its ID so the resolver
+     * can match the response to its outstanding query.
+     */
+    private errorResponse;
+}
+export {};
+//# sourceMappingURL=sim-aws-dns.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-dns.d.ts","sourceRoot":"","sources":["../../../src/serve/dns/sim-aws-dns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAWtD,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;;GAMG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,YAAY,UAAU,GAAE,mBAAwB,EAO/C;IAED;;;;;;;;;;OAUG;IACH,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAc3C;IAED,OAAO,CAAC,WAAW;IA0BnB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAUtB"}

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

@@ -0,0 +1,91 @@
+import { SimAws } from "../../service/aws/sim-aws.js";
+import { SimRoute53DnsAnswerer } from "../../service/route53/dns/answer/sim-route53-dns-answerer.js";
+import { decodeDnsQuery, } from "../../service/route53/dns/dns-query.js";
+import { dnsRcodes } from "../../service/route53/dns/dns-rcode.js";
+import { encodeDnsResponse } from "../../service/route53/dns/dns-response.js";
+import { dnsStandardQueryOpcode } from "../../service/route53/dns/wire/dns-header-flags.js";
+import { simAwsLocalConfig } from "../http/local-server/sim-aws-local.config.js";
+/**
+ * DNS interface for a simulated AWS environment.
+ *
+ * Turns a query datagram into a response datagram. Holding no socket keeps this
+ * testable without networking, in the same way `SimAwsHttp` handles a request
+ * without owning a listener.
+ */
+export class SimAwsDns {
+    simAws;
+    serviceAddress;
+    constructor(properties = {}) {
+        const { simAws = new SimAws(), serviceAddress = simAwsLocalConfig.loopbackAddress, } = properties;
+        this.simAws = simAws;
+        this.serviceAddress = serviceAddress;
+    }
+    /**
+     * Answer a DNS query datagram.
+     *
+     * This never throws: a server on a socket has to answer whatever arrives.
+     *
+     * The two failure modes are kept apart because they mean different things to a
+     * resolver. A datagram that cannot be decoded is the sender's problem and gets
+     * a format error. A datagram that decoded fine but could not be answered — an
+     * unencodable stored record value, say — is the server's problem and gets a
+     * server failure, so a resolver does not conclude it sent something malformed.
+     */
+    handleQuery(message) {
+        let query;
+        try {
+            query = decodeDnsQuery(message);
+        }
+        catch {
+            return this.errorResponse(message, dnsRcodes.formatError);
+        }
+        try {
+            return this.answerQuery(query);
+        }
+        catch {
+            return this.errorResponse(message, dnsRcodes.serverFailure);
+        }
+    }
+    answerQuery(query) {
+        if (query.opcode !== dnsStandardQueryOpcode) {
+            return encodeDnsResponse({
+                id: query.id,
+                rcode: dnsRcodes.notImplemented,
+                recursionDesired: query.recursionDesired,
+                question: query.question,
+            });
+        }
+        const answerer = new SimRoute53DnsAnswerer({
+            hostedZones: this.simAws.route53().resolvableHostedZones(),
+            serviceAddress: this.serviceAddress,
+        });
+        const answer = answerer.answer(query.question);
+        return encodeDnsResponse({
+            id: query.id,
+            rcode: answer.rcode,
+            recursionDesired: query.recursionDesired,
+            question: query.question,
+            answers: answer.answers,
+            authority: answer.authority,
+        });
+    }
+    /**
+     * Answer a datagram that could not be handled, echoing its ID so the resolver
+     * can match the response to its outstanding query.
+     */
+    errorResponse(message, rcode) {
+        return encodeDnsResponse({
+            id: queryId(message),
+            rcode,
+            recursionDesired: false,
+        });
+    }
+}
+const queryIdLength = 2;
+function queryId(message) {
+    if (message.length < queryIdLength) {
+        return 0;
+    }
+    return new DataView(message.buffer, message.byteOffset, message.byteLength).getUint16(0);
+}
+//# sourceMappingURL=sim-aws-dns.js.map

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

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

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

@@ -0,0 +1,23 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { SimAwsHttp } from "../sim-aws-http.js";
+/**
+ * Bridges Node's HTTP server callbacks to the Fetch-shaped simulated AWS HTTP
+ * interface.
+ *
+ * Node hands over a request and a response object and expects nothing back,
+ * while `SimAwsHttp` takes a `Request` and returns a `Response`. Keeping that
+ * adaptation here leaves the local server owning only the socket lifecycle.
+ */
+export declare class SimAwsLocalRequestHandler {
+    private readonly simAwsHttp;
+    private readonly nodeFetchHttpAdapter;
+    constructor(simAwsHttp: SimAwsHttp);
+    /**
+     * Handle one Node HTTP request, reporting any failure on the response rather
+     * than letting it escape into an unhandled rejection.
+     */
+    handle(nodeRequest: IncomingMessage, nodeResponse: ServerResponse): void;
+    private respond;
+    private respondWithError;
+}
+//# sourceMappingURL=sim-aws-local-request-handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-local-request-handler.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local-request-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD;;;;;;;GAOG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA8B;IAEnE,YAAY,UAAU,EAAE,UAAU,EAEjC;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,GAAG,IAAI,CAKvE;YAEa,OAAO;IAWrB,OAAO,CAAC,gBAAgB;CAgBzB"}

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

@@ -0,0 +1,44 @@
+import { NodeFetchHttpAdapter } from "../node-fetch-http-adapter.js";
+/**
+ * Bridges Node's HTTP server callbacks to the Fetch-shaped simulated AWS HTTP
+ * interface.
+ *
+ * Node hands over a request and a response object and expects nothing back,
+ * while `SimAwsHttp` takes a `Request` and returns a `Response`. Keeping that
+ * adaptation here leaves the local server owning only the socket lifecycle.
+ */
+export class SimAwsLocalRequestHandler {
+    simAwsHttp;
+    nodeFetchHttpAdapter = new NodeFetchHttpAdapter();
+    constructor(simAwsHttp) {
+        this.simAwsHttp = simAwsHttp;
+    }
+    /**
+     * Handle one Node HTTP request, reporting any failure on the response rather
+     * than letting it escape into an unhandled rejection.
+     */
+    handle(nodeRequest, nodeResponse) {
+        // eslint-disable-next-line unicorn/prefer-await
+        this.respond(nodeRequest, nodeResponse).catch((error) => {
+            this.respondWithError(error, nodeResponse);
+        });
+    }
+    async respond(nodeRequest, nodeResponse) {
+        const request = this.nodeFetchHttpAdapter.nodeRequestToFetchRequest(nodeRequest);
+        const response = await this.simAwsHttp.handleRequest(request);
+        await this.nodeFetchHttpAdapter.sendFetchResponse(nodeResponse, response);
+    }
+    respondWithError(error, nodeResponse) {
+        /* v8 ignore if */
+        if (nodeResponse.writableEnded) {
+            return;
+        }
+        if (!nodeResponse.headersSent) {
+            nodeResponse.statusCode = 400;
+            nodeResponse.setHeader("content-type", "text/plain; charset=utf-8");
+        }
+        const message = error instanceof Error ? error.message : "HTTP request processing failed";
+        nodeResponse.end(message);
+    }
+}
+//# sourceMappingURL=sim-aws-local-request-handler.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-local-request-handler.js","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local-request-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAGrE;;;;;;;GAOG;AACH,MAAM,OAAO,yBAAyB;IACnB,UAAU,CAAa;IACvB,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAEnE,YAAY,UAAsB;QAChC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAA4B,EAAE,YAA4B;QAC/D,gDAAgD;QAChD,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YAC/D,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,WAA4B,EAC5B,YAA4B;QAE5B,MAAM,OAAO,GACX,IAAI,CAAC,oBAAoB,CAAC,yBAAyB,CAAC,WAAW,CAAC,CAAC;QACnE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAE9D,MAAM,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC5E,CAAC;IAEO,gBAAgB,CAAC,KAAc,EAAE,YAA4B;QACnE,kBAAkB;QAClB,IAAI,YAAY,CAAC,aAAa,EAAE,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;YAC9B,YAAY,CAAC,UAAU,GAAG,GAAG,CAAC;YAC9B,YAAY,CAAC,SAAS,CAAC,cAAc,EAAE,2BAA2B,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,gCAAgC,CAAC;QAE5E,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC;CACF"}