@kensio/yulin 1.6.0 → 1.7.0

package/dist/serve/http/local-server/node-server-port-binder.d.ts

@@ -0,0 +1,39 @@
+import type { Server } from "node:http";
+interface NodeServerPortBinderProperties {
+    readonly server: Server;
+    readonly address?: string;
+    readonly waitMs?: number;
+    readonly waitIntervalMs?: number;
+}
+/**
+ * Binds a Node HTTP server to a port, waiting out a port that is still held.
+ *
+ * Restarting local development overlaps the process being replaced: the
+ * outgoing one is still letting go of its listening socket while the incoming
+ * one asks for the same number. Giving up on the first `EADDRINUSE` makes that
+ * overlap fatal and loses the pinned port, so the bind is retried for a short
+ * bounded period first. The bound is finite because a port held by an unrelated
+ * process is never going to come free, and waiting forever would hide that.
+ */
+export declare class NodeServerPortBinder {
+    private readonly server;
+    private readonly address;
+    private readonly waitMs;
+    private readonly waitIntervalMs;
+    constructor(properties: NodeServerPortBinderProperties);
+    /**
+     * Start listening on the given port, waiting briefly for another listener to
+     * release it. Port zero asks the operating system for a free port, so it
+     * never waits.
+     */
+    bind(port: number): Promise<void>;
+    /**
+     * Try to bind once, and try again later if the port is only busy for now.
+     *
+     * A listen that failed leaves the server without a handle, so a later attempt
+     * is an ordinary fresh listen on the same server rather than a reopening.
+     */
+    private attempt;
+}
+export {};
+//# sourceMappingURL=node-server-port-binder.d.ts.map

package/dist/serve/http/local-server/node-server-port-binder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-server-port-binder.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/local-server/node-server-port-binder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAKxC,UAAU,8BAA8B;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;;;;;;GASG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC,YAAY,UAAU,EAAE,8BAA8B,EAWrD;IAED;;;;OAIG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtC;IAED;;;;;OAKG;YACW,OAAO;CAiBtB"}

package/dist/serve/http/local-server/node-server-port-binder.js

@@ -0,0 +1,71 @@
+import { simAwsLocalConfig } from "./sim-aws-local.config.js";
+import { SimAwsLocalPortInUse } from "./sim-aws-local-port.error.js";
+import { waitNodeServerListen } from "./wait-node-server-listen.js";
+/**
+ * Binds a Node HTTP server to a port, waiting out a port that is still held.
+ *
+ * Restarting local development overlaps the process being replaced: the
+ * outgoing one is still letting go of its listening socket while the incoming
+ * one asks for the same number. Giving up on the first `EADDRINUSE` makes that
+ * overlap fatal and loses the pinned port, so the bind is retried for a short
+ * bounded period first. The bound is finite because a port held by an unrelated
+ * process is never going to come free, and waiting forever would hide that.
+ */
+export class NodeServerPortBinder {
+    server;
+    address;
+    waitMs;
+    waitIntervalMs;
+    constructor(properties) {
+        const { server, address = simAwsLocalConfig.loopbackAddress, waitMs = simAwsLocalConfig.portWaitMs, waitIntervalMs = simAwsLocalConfig.portWaitIntervalMs, } = properties;
+        this.server = server;
+        this.address = address;
+        this.waitMs = waitMs;
+        this.waitIntervalMs = waitIntervalMs;
+    }
+    /**
+     * Start listening on the given port, waiting briefly for another listener to
+     * release it. Port zero asks the operating system for a free port, so it
+     * never waits.
+     */
+    async bind(port) {
+        await this.attempt(port, Date.now() + this.waitMs);
+    }
+    /**
+     * Try to bind once, and try again later if the port is only busy for now.
+     *
+     * A listen that failed leaves the server without a handle, so a later attempt
+     * is an ordinary fresh listen on the same server rather than a reopening.
+     */
+    async attempt(port, giveUpAt) {
+        try {
+            this.server.listen(port, this.address);
+            await waitNodeServerListen(this.server);
+        }
+        catch (error) {
+            if (!isPortInUse(error)) {
+                throw error;
+            }
+            if (Date.now() >= giveUpAt) {
+                throw new SimAwsLocalPortInUse(port, this.waitMs);
+            }
+            await pause(this.waitIntervalMs);
+            await this.attempt(port, giveUpAt);
+        }
+    }
+}
+/**
+ * Recognise the one listen failure that is worth waiting out.
+ */
+function isPortInUse(error) {
+    return (error instanceof Error && "code" in error && error.code === "EADDRINUSE");
+}
+/**
+ * Wait before the next attempt.
+ */
+async function pause(milliseconds) {
+    await new Promise((resolve) => {
+        setTimeout(resolve, milliseconds);
+    });
+}
+//# sourceMappingURL=node-server-port-binder.js.map

package/dist/serve/http/local-server/node-server-port-binder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-server-port-binder.js","sourceRoot":"","sources":["../../../../src/serve/http/local-server/node-server-port-binder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AASpE;;;;;;;;;GASG;AACH,MAAM,OAAO,oBAAoB;IACd,MAAM,CAAS;IACf,OAAO,CAAS;IAChB,MAAM,CAAS;IACf,cAAc,CAAS;IAExC,YAAY,UAA0C;QACpD,MAAM,EACJ,MAAM,EACN,OAAO,GAAG,iBAAiB,CAAC,eAAe,EAC3C,MAAM,GAAG,iBAAiB,CAAC,UAAU,EACrC,cAAc,GAAG,iBAAiB,CAAC,kBAAkB,GACtD,GAAG,UAAU,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,IAAY;QACrB,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACK,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,QAAgB;QAClD,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACvC,MAAM,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxB,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,oBAAoB,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACpD,CAAC;YAED,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YACjC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CACzE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,KAAK,CAAC,YAAoB;IACvC,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC5B,UAAU,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/serve/http/local-server/node-server-port.d.ts

@@ -0,0 +1,10 @@
+import type { Server } from "node:http";
+/**
+ * Read the TCP port a Node server took.
+ *
+ * A server that has not started listening has no port, and one listening on a
+ * Unix socket has an address that is not a port at all. Neither is a number to
+ * return, so both are refused rather than guessed at.
+ */
+export declare function nodeServerPort(server: Server): string;
+//# sourceMappingURL=node-server-port.d.ts.map

package/dist/serve/http/local-server/node-server-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-server-port.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/local-server/node-server-port.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAarD"}

package/dist/serve/http/local-server/node-server-port.js

@@ -0,0 +1,19 @@
+/**
+ * Read the TCP port a Node server took.
+ *
+ * A server that has not started listening has no port, and one listening on a
+ * Unix socket has an address that is not a port at all. Neither is a number to
+ * return, so both are refused rather than guessed at.
+ */
+export function nodeServerPort(server) {
+    if (!server.listening) {
+        throw new Error("Server is not yet listening, cannot get port number");
+    }
+    const address = 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);
+}
+//# sourceMappingURL=node-server-port.js.map

package/dist/serve/http/local-server/node-server-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-server-port.js","sourceRoot":"","sources":["../../../../src/serve/http/local-server/node-server-port.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;IAEjC,iDAAiD;IACjD,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Thrown when a port stays held by another listener for the whole wait.
+ *
+ * A local development restart usually overlaps the process it replaces, so a
+ * pinned port being busy for a moment is expected and is waited out. Still
+ * being busy at the end of that wait means something else owns the port, which
+ * no amount of further waiting will fix.
+ */
+export declare class SimAwsLocalPortInUse extends Error {
+    readonly name = "SimAwsLocalPortInUse";
+    constructor(port: number, waitedMs: number);
+}
+//# sourceMappingURL=sim-aws-local-port.error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-local-port.error.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local-port.error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,SAAyB,IAAI,0BAA0B;IAEvD,YAAY,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAKzC;CACF"}

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

@@ -0,0 +1,16 @@
+/**
+ * Thrown when a port stays held by another listener for the whole wait.
+ *
+ * A local development restart usually overlaps the process it replaces, so a
+ * pinned port being busy for a moment is expected and is waited out. Still
+ * being busy at the end of that wait means something else owns the port, which
+ * no amount of further waiting will fix.
+ */
+export class SimAwsLocalPortInUse extends Error {
+    name = "SimAwsLocalPortInUse";
+    constructor(port, waitedMs) {
+        super(`Port ${String(port)} is held by another listener. ` +
+            `It was still held after waiting ${String(waitedMs)}ms for it to be released.`);
+    }
+}
+//# sourceMappingURL=sim-aws-local-port.error.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sim-aws-local-port.error.js","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local-port.error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpB,IAAI,GAAG,sBAAsB,CAAC;IAEvD,YAAY,IAAY,EAAE,QAAgB;QACxC,KAAK,CACH,QAAQ,MAAM,CAAC,IAAI,CAAC,gCAAgC;YAClD,mCAAmC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,CACjF,CAAC;IACJ,CAAC;CACF"}

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

@@ -1,5 +1,10 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { SimAwsHttp } from "../sim-aws-http.js";
+import type { SimLiveReload } from "../live-reload/sim-live-reload.js";
+interface SimAwsLocalRequestHandlerProperties {
+    readonly simAwsHttp: SimAwsHttp;
+    readonly liveReload?: SimLiveReload;
+}
 /**
  * Bridges Node's HTTP server callbacks to the Fetch-shaped simulated AWS HTTP
  * interface.
@@ -7,17 +12,25 @@ import type { SimAwsHttp } from "../sim-aws-http.js";
  * 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.
+ *
+ * Live reload sits either side of `SimAwsHttp` rather than inside it. That
+ * interface is also the SDK interception path and the in-process test path, so
+ * keeping the reload channel and the injected script out here means only a real
+ * browser talking to the local server ever sees either of them.
  */
 export declare class SimAwsLocalRequestHandler {
     private readonly simAwsHttp;
+    private readonly liveReload;
     private readonly nodeFetchHttpAdapter;
-    constructor(simAwsHttp: SimAwsHttp);
+    constructor(properties: SimAwsLocalRequestHandlerProperties);
     /**
      * 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 served;
     private respondWithError;
 }
+export {};
 //# sourceMappingURL=sim-aws-local-request-handler.d.ts.map

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

@@ -1 +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"}
+{"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;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAEvE,UAAU,mCAAmC;IAC3C,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC;CACrC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,yBAAyB;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA8B;IAEnE,YAAY,UAAU,EAAE,mCAAmC,EAI1D;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,GAAG,IAAI,CAUvE;YAEa,OAAO;YAcP,MAAM;IAWpB,OAAO,CAAC,gBAAgB;CAgBzB"}

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

@@ -6,18 +6,30 @@ import { NodeFetchHttpAdapter } from "../node-fetch-http-adapter.js";
  * 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.
+ *
+ * Live reload sits either side of `SimAwsHttp` rather than inside it. That
+ * interface is also the SDK interception path and the in-process test path, so
+ * keeping the reload channel and the injected script out here means only a real
+ * browser talking to the local server ever sees either of them.
  */
 export class SimAwsLocalRequestHandler {
     simAwsHttp;
+    liveReload;
     nodeFetchHttpAdapter = new NodeFetchHttpAdapter();
-    constructor(simAwsHttp) {
+    constructor(properties) {
+        const { simAwsHttp, liveReload } = properties;
         this.simAwsHttp = simAwsHttp;
+        this.liveReload = liveReload;
     }
     /**
      * Handle one Node HTTP request, reporting any failure on the response rather
      * than letting it escape into an unhandled rejection.
      */
     handle(nodeRequest, nodeResponse) {
+        if (this.liveReload?.isChannelRequest(nodeRequest) === true) {
+            this.liveReload.connect(nodeResponse);
+            return;
+        }
         // eslint-disable-next-line unicorn/prefer-await
         this.respond(nodeRequest, nodeResponse).catch((error) => {
             this.respondWithError(error, nodeResponse);
@@ -26,7 +38,13 @@ export class SimAwsLocalRequestHandler {
     async respond(nodeRequest, nodeResponse) {
         const request = this.nodeFetchHttpAdapter.nodeRequestToFetchRequest(nodeRequest);
         const response = await this.simAwsHttp.handleRequest(request);
-        await this.nodeFetchHttpAdapter.sendFetchResponse(nodeResponse, response);
+        await this.nodeFetchHttpAdapter.sendFetchResponse(nodeResponse, await this.served(request, response));
+    }
+    async served(request, response) {
+        if (this.liveReload === undefined) {
+            return response;
+        }
+        return this.liveReload.injectInto(request, response);
     }
     respondWithError(error, nodeResponse) {
         /* v8 ignore if */

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

@@ -1 +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"}
+{"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;AASrE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,yBAAyB;IACnB,UAAU,CAAa;IACvB,UAAU,CAA4B;IACtC,oBAAoB,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAEnE,YAAY,UAA+C;QACzD,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC;QAC9C,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAA4B,EAAE,YAA4B;QAC/D,IAAI,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,WAAW,CAAC,KAAK,IAAI,EAAE,CAAC;YAC5D,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,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,CAC/C,YAAY,EACZ,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CACrC,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,MAAM,CAClB,OAAgB,EAChB,QAAkB;QAElB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvD,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"}

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

@@ -1,6 +1,7 @@
 import { SimAws } from "../../../service/aws/sim-aws.js";
 interface SimAwsLocalServerProperties {
     readonly simAws?: SimAws;
+    readonly liveReload?: boolean;
 }
 /**
  * Local HTTP server for a simulated AWS environment.
@@ -9,7 +10,9 @@ interface SimAwsLocalServerProperties {
 export declare class SimAwsLocalServer {
     private readonly requestHandler;
     private readonly server;
+    private readonly portBinder;
     private readonly dnsServer;
+    private readonly liveReload;
     constructor(properties?: SimAwsLocalServerProperties);
     /**
      * Start serving simulated AWS services on localhost.
@@ -24,6 +27,9 @@ export declare class SimAwsLocalServer {
      * the resolver returns first, which is commonly `::1`. DNS answers with the
      * IPv4 loopback address, so binding it explicitly is what makes the address in
      * a DNS answer one that actually serves HTTP.
+     *
+     * A pinned port that is still held is waited for rather than refused, so a
+     * restart that overlaps the process it replaces still gets its port back.
      */
     listen(port?: number): Promise<this>;
     /**
@@ -44,8 +50,24 @@ export declare class SimAwsLocalServer {
     get dnsPort(): string;
     /**
      * Stop serving simulated AWS services.
+     *
+     * Open connections are ended rather than left to finish. Node's own close
+     * stops the server accepting and lets go of the connections that are idle,
+     * but one that is in use, which is what a browser part way through a request
+     * or a live reload stream holds, keeps its socket open and the process with
+     * it. Local development restarts on that process exiting, so the connections
+     * go. Closing the listening socket first means nothing new is accepted while
+     * the open ones are being ended.
      */
     close(): void;
+    /**
+     * Reload every browser connected to this server.
+     *
+     * For a change that needs no restart, such as new content in a simulated
+     * Bucket. A change to the code that built the environment needs the process
+     * to restart, and the pages reload themselves when it comes back.
+     */
+    reload(): void;
     /**
      * Adapt a simulated AWS URL for this local server instance.
      */
@@ -54,6 +76,7 @@ export declare class SimAwsLocalServer {
 interface ServeSimAwsProperties {
     readonly simAws?: SimAws;
     readonly port?: number;
+    readonly liveReload?: boolean;
 }
 /**
  * Serve a simulated AWS environment on localhost.

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

@@ -1 +1 @@
-{"version":3,"file":"sim-aws-local-server.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAQzD,UAAU,2BAA2B;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAE5C,YAAY,UAAU,GAAE,2BAAgC,EASvD;IAED;;;;;;;;;;;;;OAaG;IACG,MAAM,CAAC,IAAI,GAAE,MAAsC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKxE;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAYjB;IAED;;;;;;OAMG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAGZ;IAED;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,CAGjC;CACF;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,GAAE,qBAA0B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAK5B"}
+{"version":3,"file":"sim-aws-local-server.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local-server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAUzD,UAAU,2BAA2B;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4B;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAEhD,YAAY,UAAU,GAAE,2BAAgC,EAavD;IAED;;;;;;;;;;;;;;;;OAgBG;IACG,MAAM,CAAC,IAAI,GAAE,MAAsC,GAAG,OAAO,CAAC,IAAI,CAAC,CAOxE;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;;;;OAMG;IACH,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;;;;;;;;;OAUG;IACH,KAAK,IAAI,IAAI,CAKZ;IAED;;;;;;OAMG;IACH,MAAM,IAAI,IAAI,CAEb;IAED;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,GAAG,GAAG,CAGjC;CACF;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,UAAU,GAAE,qBAA0B,GACrC,OAAO,CAAC,iBAAiB,CAAC,CAQ5B"}

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

@@ -3,9 +3,11 @@ import { SimAws } from "../../../service/aws/sim-aws.js";
 import { simAwsLocalConfig } from "./sim-aws-local.config.js";
 import { SimAwsHttp } from "../sim-aws-http.js";
 import { SimAwsLocalUrl } from "../url/sim-aws-local-url.js";
-import { waitNodeServerListen } from "./wait-node-server-listen.js";
+import { NodeServerPortBinder } from "./node-server-port-binder.js";
+import { nodeServerPort } from "./node-server-port.js";
 import { SimAwsLocalRequestHandler } from "./sim-aws-local-request-handler.js";
 import { SimAwsDnsServer } from "../../dns/sim-aws-dns-server.js";
+import { SimLocalLiveReload } from "../live-reload/sim-local-live-reload.js";
 /**
  * Local HTTP server for a simulated AWS environment.
  * Useful for local integration testing and local development.
@@ -13,14 +15,22 @@ import { SimAwsDnsServer } from "../../dns/sim-aws-dns-server.js";
 export class SimAwsLocalServer {
     requestHandler;
     server;
+    portBinder;
     dnsServer;
+    liveReload;
     constructor(properties = {}) {
-        const { simAws = new SimAws() } = properties;
-        this.requestHandler = new SimAwsLocalRequestHandler(new SimAwsHttp({ simAws }));
+        const { simAws = new SimAws(), liveReload = false } = properties;
+        this.liveReload = new SimLocalLiveReload({ enabled: liveReload });
+        const channel = this.liveReload.channel();
+        this.requestHandler = new SimAwsLocalRequestHandler({
+            simAwsHttp: new SimAwsHttp({ simAws }),
+            ...(channel !== undefined && { liveReload: channel }),
+        });
         this.dnsServer = new SimAwsDnsServer({ simAws });
         this.server = http.createServer((request, response) => {
             this.requestHandler.handle(request, response);
         });
+        this.portBinder = new NodeServerPortBinder({ server: this.server });
     }
     /**
      * Start serving simulated AWS services on localhost.
@@ -35,11 +45,14 @@ export class SimAwsLocalServer {
      * the resolver returns first, which is commonly `::1`. DNS answers with the
      * IPv4 loopback address, so binding it explicitly is what makes the address in
      * a DNS answer one that actually serves HTTP.
+     *
+     * A pinned port that is still held is waited for rather than refused, so a
+     * restart that overlaps the process it replaces still gets its port back.
      */
     async listen(port = simAwsLocalConfig.defaultPort) {
-        this.server.listen(port, simAwsLocalConfig.loopbackAddress);
-        await waitNodeServerListen(this.server);
+        await this.portBinder.bind(port);
         await this.dnsServer.listen(Number(this.port));
+        this.liveReload.serving(this.port);
         return this;
     }
     /**
@@ -52,15 +65,7 @@ export class SimAwsLocalServer {
      * 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);
+        return nodeServerPort(this.server);
     }
     /**
      * Get the UDP port on which DNS queries are answered.
@@ -74,11 +79,31 @@ export class SimAwsLocalServer {
     }
     /**
      * Stop serving simulated AWS services.
+     *
+     * Open connections are ended rather than left to finish. Node's own close
+     * stops the server accepting and lets go of the connections that are idle,
+     * but one that is in use, which is what a browser part way through a request
+     * or a live reload stream holds, keeps its socket open and the process with
+     * it. Local development restarts on that process exiting, so the connections
+     * go. Closing the listening socket first means nothing new is accepted while
+     * the open ones are being ended.
      */
     close() {
+        this.liveReload.stopping();
         this.server.close();
+        this.server.closeAllConnections();
         this.dnsServer.close();
     }
+    /**
+     * Reload every browser connected to this server.
+     *
+     * For a change that needs no restart, such as new content in a simulated
+     * Bucket. A change to the code that built the environment needs the process
+     * to restart, and the pages reload themselves when it comes back.
+     */
+    reload() {
+        this.liveReload.reload();
+    }
     /**
      * Adapt a simulated AWS URL for this local server instance.
      */
@@ -91,8 +116,8 @@ export class SimAwsLocalServer {
  * Serve a simulated AWS environment on localhost.
  */
 export async function serveSimAws(properties = {}) {
-    const { simAws = new SimAws(), port = simAwsLocalConfig.defaultPort } = properties;
-    const server = new SimAwsLocalServer({ simAws });
+    const { simAws = new SimAws(), port = simAwsLocalConfig.defaultPort, liveReload = false, } = properties;
+    const server = new SimAwsLocalServer({ simAws, liveReload });
     return server.listen(port);
 }
 //# sourceMappingURL=sim-aws-local-server.js.map

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

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

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

@@ -5,5 +5,7 @@ export declare const simAwsLocalConfig: {
     hostname: string;
     defaultPort: number;
     loopbackAddress: string;
+    portWaitMs: number;
+    portWaitIntervalMs: number;
 };
 //# sourceMappingURL=sim-aws-local.config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"sim-aws-local.config.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,QAAQ;IACR,WAAW;IAIX,eAAe;CAChB,CAAC"}
+{"version":3,"file":"sim-aws-local.config.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,iBAAiB;IAC5B,QAAQ;IACR,WAAW;IAIX,eAAe;IAKf,UAAU;IACV,kBAAkB;CACnB,CAAC"}

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

@@ -8,5 +8,11 @@ export const simAwsLocalConfig = {
     // names that resolve to a simulated service, so a lookup and an HTTP request
     // for the same name reach the same place.
     loopbackAddress: "127.0.0.1",
+    // How long a pinned port is waited for when something else still holds it.
+    // A restart overlaps the process it replaces for a moment, and long enough to
+    // outlast that is the whole requirement. Anything still holding the port after
+    // this is not going to let go.
+    portWaitMs: 2000,
+    portWaitIntervalMs: 25,
 };
 //# sourceMappingURL=sim-aws-local.config.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"sim-aws-local.config.js","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,CAAC;IACd,2EAA2E;IAC3E,6EAA6E;IAC7E,0CAA0C;IAC1C,eAAe,EAAE,WAAW;CAC7B,CAAC"}
+{"version":3,"file":"sim-aws-local.config.js","sourceRoot":"","sources":["../../../../src/serve/http/local-server/sim-aws-local.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,mBAAmB;IAC7B,WAAW,EAAE,CAAC;IACd,2EAA2E;IAC3E,6EAA6E;IAC7E,0CAA0C;IAC1C,eAAe,EAAE,WAAW;IAC5B,2EAA2E;IAC3E,8EAA8E;IAC9E,+EAA+E;IAC/E,+BAA+B;IAC/B,UAAU,EAAE,IAAI;IAChB,kBAAkB,EAAE,EAAE;CACvB,CAAC"}

package/dist/serve/index.d.ts

@@ -2,6 +2,9 @@ export { SimAwsHttp } from "./http/sim-aws-http.js";
 export { SimAwsDns } from "./dns/sim-aws-dns.js";
 export { SimAwsDnsServer } from "./dns/sim-aws-dns-server.js";
 export { serveSimAws, SimAwsLocalServer, } from "./http/local-server/sim-aws-local-server.js";
+export { SimAwsLocalPortInUse } from "./http/local-server/sim-aws-local-port.error.js";
+export { SimLiveReload } from "./http/live-reload/sim-live-reload.js";
+export { simLiveReloadConfig, simLiveReloadHeaderName, } from "./http/live-reload/sim-live-reload.config.js";
 export { type SimAwsServiceController, SimAwsServiceRequest, type SimAwsServiceTarget, } from "./controller/sim-service-controller.js";
 export { simAwsAuthHeaderName, simAwsErrorDetailHeaderName, simAwsErrorHeaderName, } from "./http/response/sim-aws-response-hints.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EACL,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,2CAA2C,CAAC"}
+{"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,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EACL,KAAK,uBAAuB,EAC5B,oBAAoB,EACpB,KAAK,mBAAmB,GACzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,2CAA2C,CAAC"}

package/dist/serve/index.js

@@ -2,6 +2,9 @@ export { SimAwsHttp } from "./http/sim-aws-http.js";
 export { SimAwsDns } from "./dns/sim-aws-dns.js";
 export { SimAwsDnsServer } from "./dns/sim-aws-dns-server.js";
 export { serveSimAws, SimAwsLocalServer, } from "./http/local-server/sim-aws-local-server.js";
+export { SimAwsLocalPortInUse } from "./http/local-server/sim-aws-local-port.error.js";
+export { SimLiveReload } from "./http/live-reload/sim-live-reload.js";
+export { simLiveReloadConfig, simLiveReloadHeaderName, } from "./http/live-reload/sim-live-reload.config.js";
 export { SimAwsServiceRequest, } from "./controller/sim-service-controller.js";
 export { simAwsAuthHeaderName, simAwsErrorDetailHeaderName, simAwsErrorHeaderName, } from "./http/response/sim-aws-response-hints.js";
 //# sourceMappingURL=index.js.map

package/dist/serve/index.js.map

@@ -1 +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,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAEL,oBAAoB,GAErB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,2CAA2C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serve/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AACtE,OAAO,EACL,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAEL,oBAAoB,GAErB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACL,oBAAoB,EACpB,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,2CAA2C,CAAC"}

package/dist/service/acm/cfn/sim-cfn-acm-resource-factory.d.ts

@@ -8,12 +8,21 @@ interface SimAcmCfnResourceFactoryProperties {
  * CloudFormation Resource factory for simulated ACM resources.
  */
 export declare class SimAcmCfnResourceFactory implements SimCfnServiceResourceFactory {
+    private readonly acm;
     private readonly certificateCreator;
     constructor(properties?: SimAcmCfnResourceFactoryProperties);
     /**
      * Create a simulated ACM resource from a CloudFormation Resource.
      */
     create(resourceTypeName: string, resource: SimCfnResource, context: SimCloudFormationResourceCreateContext): Promise<object | undefined>;
+    /**
+     * Delete a simulated ACM resource created from a CloudFormation Resource.
+     *
+     * DeleteCertificate refuses a certificate that is still in use, so a
+     * certificate a CloudFront Distribution still names comes down after that
+     * Distribution, which the teardown order arranges.
+     */
+    delete(resourceTypeName: string, resource: SimCfnResource): Promise<void>;
 }
 export {};
 //# sourceMappingURL=sim-cfn-acm-resource-factory.d.ts.map

package/dist/service/acm/cfn/sim-cfn-acm-resource-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sim-cfn-acm-resource-factory.d.ts","sourceRoot":"","sources":["../../../../src/service/acm/cfn/sim-cfn-acm-resource-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,sCAAsC,EACvC,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wEAAwE,CAAC;AAC3H,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,wBAAyB,YAAW,4BAA4B;IAC3E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA8B;IAEjE,YAAY,UAAU,GAAE,kCAAuC,EAI9D;IAED;;OAEG;IACG,MAAM,CACV,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,sCAAsC,GAC9C,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;CACF"}
+{"version":3,"file":"sim-cfn-acm-resource-factory.d.ts","sourceRoot":"","sources":["../../../../src/service/acm/cfn/sim-cfn-acm-resource-factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,sCAAsC,EACvC,MAAM,mDAAmD,CAAC;AAC3D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wEAAwE,CAAC;AAC3H,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAKvC,UAAU,kCAAkC;IAC1C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,wBAAyB,YAAW,4BAA4B;IAC3E,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA8B;IAEjE,YAAY,UAAU,GAAE,kCAAuC,EAK9D;IAED;;OAEG;IACG,MAAM,CACV,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,sCAAsC,GAC9C,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAW7B;IAED;;;;;;OAMG;IACG,MAAM,CACV,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CAgBf;CACF"}