@kensio/yulin 1.6.1 → 1.7.0

package/dist/serve/http/live-reload/sim-live-reload-injectable.js

@@ -0,0 +1,86 @@
+const sigV4AuthorizationPrefix = "AWS4-HMAC-SHA256";
+const htmlContentType = "text/html";
+const awsNamePrefix = "x-amz-";
+/**
+ * Whether any of these header or query parameter names is an AWS one.
+ */
+function hasAwsPrefixed(names) {
+    for (const name of names) {
+        if (name.toLowerCase().startsWith(awsNamePrefix)) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * Decides whether a response can carry the live reload script.
+ *
+ * The simulator's own account of a request goes in headers and never in the
+ * body, so that a response keeps the shape the real service returns. Injecting
+ * a script breaks that rule, and these checks are what keep the breakage to the
+ * one case it is worth it for: an HTML page a browser is about to render.
+ *
+ * Everything else comes back untouched. An SDK reading an HTML Object out of a
+ * Bucket has to get the bytes that were stored, and a range or an encoded body
+ * cannot take an insertion at all.
+ */
+export class SimLiveReloadInjectable {
+    /**
+     * Whether the script belongs in this response.
+     */
+    allows(request, response) {
+        return (this.hasBody(request, response) &&
+            this.isWholeResponse(response) &&
+            this.isPlainHtml(response) &&
+            this.isBrowserRequest(request) &&
+            !this.isSignedRequest(request) &&
+            !this.isSdkRequest(request));
+    }
+    hasBody(request, response) {
+        return request.method !== "HEAD" && response.body !== null;
+    }
+    /**
+     * A partial response is a slice of a body, and a slice cannot take an
+     * insertion without the offsets the client already asked for going wrong.
+     */
+    isWholeResponse(response) {
+        return response.status !== 206;
+    }
+    /**
+     * The media type has to be `text/html` itself, not merely start with it, so a
+     * type such as `text/htmlx` is left alone. An encoded body would have to be
+     * decoded, changed and re-encoded, and the simulator has no reason to be in
+     * that business.
+     */
+    isPlainHtml(response) {
+        const contentType = response.headers.get("content-type") ?? "";
+        const [mediaType = ""] = contentType.split(";");
+        return (mediaType.trim().toLowerCase() === htmlContentType &&
+            !response.headers.has("content-encoding"));
+    }
+    /**
+     * Something asking for HTML is something that will render it.
+     */
+    isBrowserRequest(request) {
+        const accept = request.headers.get("accept") ?? "";
+        return accept.toLowerCase().includes(htmlContentType);
+    }
+    /**
+     * A signature comes either in a header or, for a presigned URL, in the query
+     * string. A presigned URL is the one signed request a browser makes with an
+     * ordinary HTML `accept` header, which is what an address bar sends, so
+     * missing it would mean handing back an Object with bytes added to it.
+     */
+    isSignedRequest(request) {
+        const authorization = request.headers.get("authorization") ?? "";
+        return (authorization.startsWith(sigV4AuthorizationPrefix) ||
+            hasAwsPrefixed(new URL(request.url).searchParams.keys()));
+    }
+    /**
+     * An `x-amz-*` header is an AWS client talking, whether it signed or not.
+     */
+    isSdkRequest(request) {
+        return hasAwsPrefixed(request.headers.keys());
+    }
+}
+//# sourceMappingURL=sim-live-reload-injectable.js.map

package/dist/serve/http/live-reload/sim-live-reload-injectable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload-injectable.js","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload-injectable.ts"],"names":[],"mappings":"AAAA,MAAM,wBAAwB,GAAG,kBAAkB,CAAC;AACpD,MAAM,eAAe,GAAG,WAAW,CAAC;AACpC,MAAM,aAAa,GAAG,QAAQ,CAAC;AAE/B;;GAEG;AACH,SAAS,cAAc,CAAC,KAA+B;IACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YACjD,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,uBAAuB;IAClC;;OAEG;IACH,MAAM,CAAC,OAAgB,EAAE,QAAkB;QACzC,OAAO,CACL,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC;YAC/B,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC;YAC9B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;YAC1B,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;YAC9B,CAAC,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;YAC9B,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAC5B,CAAC;IACJ,CAAC;IAEO,OAAO,CAAC,OAAgB,EAAE,QAAkB;QAClD,OAAO,OAAO,CAAC,MAAM,KAAK,MAAM,IAAI,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC;IAC7D,CAAC;IAED;;;OAGG;IACK,eAAe,CAAC,QAAkB;QACxC,OAAO,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC;IACjC,CAAC;IAED;;;;;OAKG;IACK,WAAW,CAAC,QAAkB;QACpC,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;QAC/D,MAAM,CAAC,SAAS,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEhD,OAAO,CACL,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,eAAe;YAClD,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAC1C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB,CAAC,OAAgB;QACvC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnD,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACK,eAAe,CAAC,OAAgB;QACtC,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC;QAEjE,OAAO,CACL,aAAa,CAAC,UAAU,CAAC,wBAAwB,CAAC;YAClD,cAAc,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CACzD,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,OAAgB;QACnC,OAAO,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/serve/http/live-reload/sim-live-reload-injector.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Puts the live reload script into HTML on its way to a browser.
+ *
+ * The script goes in at the end of the document, so the page has parsed before
+ * a connection is opened. The bytes of the body change, so anything describing
+ * those bytes has to change with them: `content-length` is recomputed, and
+ * `etag` and `last-modified` are dropped rather than left describing the
+ * stored Object the page no longer is.
+ *
+ * An injected page is also not stored. A cached copy would outlive the reload
+ * it was injected for, and a page held in the browser cache is a page live
+ * reload cannot reach.
+ */
+export declare class SimLiveReloadInjector {
+    private readonly injectable;
+    /**
+     * Return the response a browser should get, injected if it can take it.
+     */
+    injectInto(request: Request, response: Response): Promise<Response>;
+    private inject;
+}
+//# sourceMappingURL=sim-live-reload-injector.d.ts.map

package/dist/serve/http/live-reload/sim-live-reload-injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload-injector.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload-injector.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiC;IAE5D;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAMxE;YAEa,MAAM;CAgBrB"}

package/dist/serve/http/live-reload/sim-live-reload-injector.js

@@ -0,0 +1,72 @@
+import { SimLiveReloadInjectable } from "./sim-live-reload-injectable.js";
+import { simLiveReloadScriptTag } from "./sim-live-reload-script.js";
+import { simLiveReloadHeaderName } from "./sim-live-reload.config.js";
+/**
+ * Puts the live reload script into HTML on its way to a browser.
+ *
+ * The script goes in at the end of the document, so the page has parsed before
+ * a connection is opened. The bytes of the body change, so anything describing
+ * those bytes has to change with them: `content-length` is recomputed, and
+ * `etag` and `last-modified` are dropped rather than left describing the
+ * stored Object the page no longer is.
+ *
+ * An injected page is also not stored. A cached copy would outlive the reload
+ * it was injected for, and a page held in the browser cache is a page live
+ * reload cannot reach.
+ */
+export class SimLiveReloadInjector {
+    injectable = new SimLiveReloadInjectable();
+    /**
+     * Return the response a browser should get, injected if it can take it.
+     */
+    async injectInto(request, response) {
+        if (!this.injectable.allows(request, response)) {
+            return response;
+        }
+        return this.inject(response);
+    }
+    async inject(response) {
+        const body = insertScriptTag(await response.text());
+        const headers = new Headers(response.headers);
+        headers.delete("etag");
+        headers.delete("last-modified");
+        headers.set("content-length", String(Buffer.byteLength(body)));
+        headers.set("cache-control", "no-store");
+        headers.set(simLiveReloadHeaderName, "injected");
+        return new Response(body, {
+            status: response.status,
+            statusText: response.statusText,
+            headers,
+        });
+    }
+}
+// Matched against the document as written, rather than against a lowercased
+// copy, because lowercasing can change a string's length and move every offset
+// after the character that changed.
+const closingTagPatterns = [/<\/body\s*>/gi, /<\/html\s*>/gi];
+/**
+ * Put the script at the end of the document, wherever that turns out to be.
+ *
+ * A closing tag is the ordinary case. HTML without one is still something a
+ * browser will render, so appending is better than declining to reload it.
+ */
+function insertScriptTag(html) {
+    for (const pattern of closingTagPatterns) {
+        const at = lastMatchIndex(html, pattern);
+        if (at !== -1) {
+            return html.slice(0, at) + simLiveReloadScriptTag + html.slice(at);
+        }
+    }
+    return html + simLiveReloadScriptTag;
+}
+/**
+ * Where the document's own closing tag is, rather than one inside it.
+ */
+function lastMatchIndex(html, pattern) {
+    let index = -1;
+    for (const match of html.matchAll(pattern)) {
+        index = match.index;
+    }
+    return index;
+}
+//# sourceMappingURL=sim-live-reload-injector.js.map

package/dist/serve/http/live-reload/sim-live-reload-injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload-injector.js","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload-injector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,qBAAqB;IACf,UAAU,GAAG,IAAI,uBAAuB,EAAE,CAAC;IAE5D;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,OAAgB,EAAE,QAAkB;QACnD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC/C,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,MAAM,CAAC,QAAkB;QACrC,MAAM,IAAI,GAAG,eAAe,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAE9C,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,UAAU,CAAC,CAAC;QAEjD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;YACxB,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,OAAO;SACR,CAAC,CAAC;IACL,CAAC;CACF;AAED,4EAA4E;AAC5E,+EAA+E;AAC/E,oCAAoC;AACpC,MAAM,kBAAkB,GAAG,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC;AAE9D;;;;;GAKG;AACH,SAAS,eAAe,CAAC,IAAY;IACnC,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,MAAM,EAAE,GAAG,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEzC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,sBAAsB,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,GAAG,sBAAsB,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,OAAe;IACnD,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IAEf,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/serve/http/live-reload/sim-live-reload-report.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Says on startup that live reload is on.
+ *
+ * Live reload is the one thing the simulator does that changes a response body,
+ * which is otherwise the shape the real service returns. Something a served
+ * page did not ask for is worth being told about, once, at the point it starts
+ * happening, rather than being found later in a page's source.
+ *
+ * It goes to the console because the simulator has no logger of its own, the
+ * same as every other warning it raises.
+ */
+export declare class SimLiveReloadReport {
+    /**
+     * Report live reload on a server that has just started listening.
+     */
+    announce(port: string): void;
+}
+//# sourceMappingURL=sim-live-reload-report.d.ts.map

package/dist/serve/http/live-reload/sim-live-reload-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload-report.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload-report.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAC9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAU3B;CACF"}

package/dist/serve/http/live-reload/sim-live-reload-report.js

@@ -0,0 +1,27 @@
+import { simAwsLocalConfig } from "../local-server/sim-aws-local.config.js";
+import { simLiveReloadConfig } from "./sim-live-reload.config.js";
+/**
+ * Says on startup that live reload is on.
+ *
+ * Live reload is the one thing the simulator does that changes a response body,
+ * which is otherwise the shape the real service returns. Something a served
+ * page did not ask for is worth being told about, once, at the point it starts
+ * happening, rather than being found later in a page's source.
+ *
+ * It goes to the console because the simulator has no logger of its own, the
+ * same as every other warning it raises.
+ */
+export class SimLiveReloadReport {
+    /**
+     * Report live reload on a server that has just started listening.
+     */
+    announce(port) {
+        const channel = `http://${simAwsLocalConfig.hostname}:${port}${simLiveReloadConfig.channelPath}`;
+        // eslint-disable-next-line no-console
+        console.warn(`Simulated AWS live reload is on. HTML responses to browser requests ` +
+            `carry a reload script, so those responses are not byte for byte what ` +
+            `the real service would return. The reload channel is served at ` +
+            `${channel} on every served hostname.`);
+    }
+}
+//# sourceMappingURL=sim-live-reload-report.js.map

package/dist/serve/http/live-reload/sim-live-reload-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload-report.js","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload-report.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,mBAAmB;IAC9B;;OAEG;IACH,QAAQ,CAAC,IAAY;QACnB,MAAM,OAAO,GAAG,UAAU,iBAAiB,CAAC,QAAQ,IAAI,IAAI,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC;QAEjG,sCAAsC;QACtC,OAAO,CAAC,IAAI,CACV,sEAAsE;YACpE,uEAAuE;YACvE,iEAAiE;YACjE,GAAG,OAAO,4BAA4B,CACzC,CAAC;IACJ,CAAC;CACF"}

package/dist/serve/http/live-reload/sim-live-reload-script.d.ts

@@ -0,0 +1,20 @@
+/**
+ * The script a served page runs to reload itself.
+ *
+ * It reloads on two signals. An explicit `reload` event is a reload the
+ * simulator asked for. A `boot` event carrying an id other than the one this
+ * page first saw means it is talking to a process that has restarted, which is
+ * how a restart reaches a page without the outgoing and incoming processes
+ * having to agree on anything. Reconnecting to the same id, which is what a
+ * dropped connection to a still running process gives, does nothing.
+ *
+ * A `reloading` event says a reload is on its way. The page is left to decide
+ * what to make of that, through an attribute it can style, rather than having
+ * anything drawn over it.
+ */
+export declare const simLiveReloadScript: string;
+/**
+ * The script as it goes into a page.
+ */
+export declare const simLiveReloadScriptTag: string;
+//# sourceMappingURL=sim-live-reload-script.d.ts.map

package/dist/serve/http/live-reload/sim-live-reload-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload-script.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload-script.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,mBAAmB,QAwB1B,CAAC;AAEP;;GAEG;AACH,eAAO,MAAM,sBAAsB,QAAqE,CAAC"}

package/dist/serve/http/live-reload/sim-live-reload-script.js

@@ -0,0 +1,45 @@
+import { simLiveReloadConfig } from "./sim-live-reload.config.js";
+/**
+ * The script a served page runs to reload itself.
+ *
+ * It reloads on two signals. An explicit `reload` event is a reload the
+ * simulator asked for. A `boot` event carrying an id other than the one this
+ * page first saw means it is talking to a process that has restarted, which is
+ * how a restart reaches a page without the outgoing and incoming processes
+ * having to agree on anything. Reconnecting to the same id, which is what a
+ * dropped connection to a still running process gives, does nothing.
+ *
+ * A `reloading` event says a reload is on its way. The page is left to decide
+ * what to make of that, through an attribute it can style, rather than having
+ * anything drawn over it.
+ */
+export const simLiveReloadScript = `(() => {
+  if (window.simAwsLiveReload) {
+    return;
+  }
+  window.simAwsLiveReload = true;
+
+  let bootId = null;
+  const source = new EventSource("${simLiveReloadConfig.channelPath}");
+
+  source.addEventListener("boot", (event) => {
+    if (bootId !== null && bootId !== event.data) {
+      window.location.reload();
+      return;
+    }
+    bootId = event.data;
+  });
+
+  source.addEventListener("reload", () => {
+    window.location.reload();
+  });
+
+  source.addEventListener("reloading", () => {
+    document.documentElement.dataset.simAwsLiveReload = "reloading";
+  });
+})();`;
+/**
+ * The script as it goes into a page.
+ */
+export const simLiveReloadScriptTag = `<script data-sim-aws-live-reload>${simLiveReloadScript}</script>`;
+//# sourceMappingURL=sim-live-reload-script.js.map

package/dist/serve/http/live-reload/sim-live-reload-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload-script.js","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;oCAOC,mBAAmB,CAAC,WAAW;;;;;;;;;;;;;;;;;MAiB7D,CAAC;AAEP;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,oCAAoC,mBAAmB,WAAW,CAAC"}

package/dist/serve/http/live-reload/sim-live-reload.config.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Configuration for the live reload channel served on localhost.
+ */
+export declare const simLiveReloadConfig: {
+    channelPath: string;
+    clientRetryMs: number;
+};
+/**
+ * Reports that a response carries the injected live reload script.
+ */
+export declare const simLiveReloadHeaderName = "x-sim-aws-live-reload";
+//# sourceMappingURL=sim-live-reload.config.d.ts.map

package/dist/serve/http/live-reload/sim-live-reload.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload.config.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAK9B,WAAW;IAIX,aAAa;CACd,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,uBAAuB,0BAA0B,CAAC"}

package/dist/serve/http/live-reload/sim-live-reload.config.js

@@ -0,0 +1,19 @@
+/**
+ * Configuration for the live reload channel served on localhost.
+ */
+export const simLiveReloadConfig = {
+    // Reserved on every served hostname, so the injected script can ask for it
+    // with a relative path whatever host the page was served from. The cost is
+    // that a simulated distribution cannot serve anything at this path while live
+    // reload is on.
+    channelPath: "/__sim-aws/live-reload",
+    // How soon a browser reconnects after the connection drops. The default is
+    // several seconds, which is the gap between a restarted process being ready
+    // and the page noticing.
+    clientRetryMs: 500,
+};
+/**
+ * Reports that a response carries the injected live reload script.
+ */
+export const simLiveReloadHeaderName = "x-sim-aws-live-reload";
+//# sourceMappingURL=sim-live-reload.config.js.map

package/dist/serve/http/live-reload/sim-live-reload.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload.config.js","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload.config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,2EAA2E;IAC3E,2EAA2E;IAC3E,8EAA8E;IAC9E,gBAAgB;IAChB,WAAW,EAAE,wBAAwB;IACrC,2EAA2E;IAC3E,4EAA4E;IAC5E,yBAAyB;IACzB,aAAa,EAAE,GAAG;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,uBAAuB,CAAC"}

package/dist/serve/http/live-reload/sim-live-reload.d.ts

@@ -0,0 +1,52 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+interface SimLiveReloadProperties {
+    readonly bootId?: string;
+}
+/**
+ * Reloads a browser looking at a page the simulator served.
+ *
+ * Yulin is the only thing in the response path for a page served from a
+ * simulated distribution, Function URL or Bucket website, so it is the only
+ * thing that can tell the browser to reload. Pages get a script, the script
+ * holds a connection open, and this is the end that decides what to say on it.
+ *
+ * The boot id is what makes a restart work. It identifies this process to the
+ * pages connected to it, and a page that reconnects to a different one knows
+ * it is looking at output from a process that is no longer running.
+ */
+export declare class SimLiveReload {
+    private readonly bootId;
+    private readonly clients;
+    private readonly injector;
+    constructor(properties?: SimLiveReloadProperties);
+    /**
+     * Whether this request is for the reload channel rather than for a simulated
+     * service. The path is reserved on every served hostname, so a page can ask
+     * for it relative to wherever it was served from.
+     */
+    isChannelRequest(request: IncomingMessage): boolean;
+    /**
+     * Open the reload channel for a browser, and tell it which process it has
+     * reached.
+     */
+    connect(response: ServerResponse): void;
+    /**
+     * Put the reload script into a response, if that response can take it.
+     */
+    injectInto(request: Request, response: Response): Promise<Response>;
+    /**
+     * Reload every connected browser now.
+     */
+    reload(): void;
+    /**
+     * Say a reload is coming, then let the connections go.
+     *
+     * The page learns that the gap it is about to see is a restart rather than a
+     * server that has died. Ending the connections rather than leaving them for
+     * the browser to notice is what makes the reconnection prompt.
+     */
+    stopping(): void;
+    private send;
+}
+export {};
+//# sourceMappingURL=sim-live-reload.d.ts.map

package/dist/serve/http/live-reload/sim-live-reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAKjE,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IAExD,YAAY,UAAU,GAAE,uBAA4B,EAGnD;IAED;;;;OAIG;IACH,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAWlD;IAED;;;OAGG;IACH,OAAO,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAUtC;IAED;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAExE;IAED;;OAEG;IACH,MAAM,IAAI,IAAI,CAEb;IAED;;;;;;OAMG;IACH,QAAQ,IAAI,IAAI,CAQf;IAED,OAAO,CAAC,IAAI;CAKb"}

package/dist/serve/http/live-reload/sim-live-reload.js

@@ -0,0 +1,82 @@
+import { randomUUID } from "node:crypto";
+import { SimLiveReloadClient } from "./sim-live-reload-client.js";
+import { SimLiveReloadInjector } from "./sim-live-reload-injector.js";
+import { simLiveReloadConfig } from "./sim-live-reload.config.js";
+/**
+ * Reloads a browser looking at a page the simulator served.
+ *
+ * Yulin is the only thing in the response path for a page served from a
+ * simulated distribution, Function URL or Bucket website, so it is the only
+ * thing that can tell the browser to reload. Pages get a script, the script
+ * holds a connection open, and this is the end that decides what to say on it.
+ *
+ * The boot id is what makes a restart work. It identifies this process to the
+ * pages connected to it, and a page that reconnects to a different one knows
+ * it is looking at output from a process that is no longer running.
+ */
+export class SimLiveReload {
+    bootId;
+    clients = new Set();
+    injector = new SimLiveReloadInjector();
+    constructor(properties = {}) {
+        const { bootId = randomUUID() } = properties;
+        this.bootId = bootId;
+    }
+    /**
+     * Whether this request is for the reload channel rather than for a simulated
+     * service. The path is reserved on every served hostname, so a page can ask
+     * for it relative to wherever it was served from.
+     */
+    isChannelRequest(request) {
+        if (request.method !== "GET") {
+            return false;
+        }
+        const path = new URL(request.url ?? "/", "http://sim-aws.invalid").pathname.replace(/\/$/, "");
+        return path === simLiveReloadConfig.channelPath;
+    }
+    /**
+     * Open the reload channel for a browser, and tell it which process it has
+     * reached.
+     */
+    connect(response) {
+        const client = new SimLiveReloadClient(response);
+        this.clients.add(client);
+        client.onClose(() => {
+            this.clients.delete(client);
+        });
+        client.open();
+        client.send("boot", this.bootId);
+    }
+    /**
+     * Put the reload script into a response, if that response can take it.
+     */
+    async injectInto(request, response) {
+        return this.injector.injectInto(request, response);
+    }
+    /**
+     * Reload every connected browser now.
+     */
+    reload() {
+        this.send("reload");
+    }
+    /**
+     * Say a reload is coming, then let the connections go.
+     *
+     * The page learns that the gap it is about to see is a restart rather than a
+     * server that has died. Ending the connections rather than leaving them for
+     * the browser to notice is what makes the reconnection prompt.
+     */
+    stopping() {
+        this.send("reloading");
+        for (const client of this.clients) {
+            client.end();
+        }
+        this.clients.clear();
+    }
+    send(event) {
+        for (const client of this.clients) {
+            client.send(event, this.bootId);
+        }
+    }
+}
+//# sourceMappingURL=sim-live-reload.js.map

package/dist/serve/http/live-reload/sim-live-reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-live-reload.js","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-live-reload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMlE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,aAAa;IACP,MAAM,CAAS;IACf,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IACzC,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAExD,YAAY,UAAU,GAA4B,EAAE;QAClD,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,EAAE,GAAG,UAAU,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,gBAAgB,CAAC,OAAwB;QACvC,IAAI,OAAO,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;YAC7B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,GAAG,CAClB,OAAO,CAAC,GAAG,IAAI,GAAG,EAClB,wBAAwB,CACzB,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAE9B,OAAO,IAAI,KAAK,mBAAmB,CAAC,WAAW,CAAC;IAClD,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,QAAwB;QAC9B,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAEjD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzB,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;YAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,OAAgB,EAAE,QAAkB;QACnD,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACtB,CAAC;IAED;;;;;;OAMG;IACH,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEvB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAEO,IAAI,CAAC,KAAa;QACxB,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;CACF"}

package/dist/serve/http/live-reload/sim-local-live-reload.d.ts

@@ -0,0 +1,42 @@
+import { SimLiveReload } from "./sim-live-reload.js";
+import { type SimWatchRuntime } from "../../../watch/sim-watch-runtime.js";
+interface SimLocalLiveReloadProperties {
+    readonly enabled: boolean;
+    readonly watch?: SimWatchRuntime;
+}
+/**
+ * Live reload as the local server has to hold it: on or off, and wired into the
+ * server's own lifecycle either way.
+ *
+ * Keeping it here leaves `SimAwsLocalServer` with sockets and ports, which is
+ * enough for one class, and puts the three things that only matter together in
+ * one place: whether it is on, the notice given on startup, and the warning
+ * from a `yulin watch` supervisor that the process is about to be replaced.
+ */
+export declare class SimLocalLiveReload {
+    private readonly liveReload;
+    private readonly watch;
+    private readonly onSupervisorStopping;
+    constructor(properties: SimLocalLiveReloadProperties);
+    /**
+     * The channel to hand to the request handler, if there is one.
+     */
+    channel(): SimLiveReload | undefined;
+    /**
+     * Say live reload is on, and start listening for a supervised restart.
+     *
+     * Under `yulin watch` the process is killed rather than asked to close, so
+     * this is where a served page finds out a restart is coming.
+     */
+    serving(port: string): void;
+    /**
+     * Tell connected browsers a reload is coming, and stop listening.
+     */
+    stopping(): void;
+    /**
+     * Reload connected browsers now.
+     */
+    reload(): void;
+}
+export {};
+//# sourceMappingURL=sim-local-live-reload.d.ts.map

package/dist/serve/http/live-reload/sim-local-live-reload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-local-live-reload.d.ts","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-local-live-reload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,qCAAqC,CAAC;AAE7C,UAAU,4BAA4B;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC;CAClC;AAED;;;;;;;;GAQG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IAExC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAEnC;IAEF,YAAY,UAAU,EAAE,4BAA4B,EAInD;IAED;;OAEG;IACH,OAAO,IAAI,aAAa,GAAG,SAAS,CAEnC;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAO1B;IAED;;OAEG;IACH,QAAQ,IAAI,IAAI,CAGf;IAED;;OAEG;IACH,MAAM,IAAI,IAAI,CAQb;CACF"}

package/dist/serve/http/live-reload/sim-local-live-reload.js

@@ -0,0 +1,60 @@
+import { SimLiveReload } from "./sim-live-reload.js";
+import { SimLiveReloadReport } from "./sim-live-reload-report.js";
+import { simWatch, } from "../../../watch/sim-watch-runtime.js";
+/**
+ * Live reload as the local server has to hold it: on or off, and wired into the
+ * server's own lifecycle either way.
+ *
+ * Keeping it here leaves `SimAwsLocalServer` with sockets and ports, which is
+ * enough for one class, and puts the three things that only matter together in
+ * one place: whether it is on, the notice given on startup, and the warning
+ * from a `yulin watch` supervisor that the process is about to be replaced.
+ */
+export class SimLocalLiveReload {
+    liveReload;
+    watch;
+    onSupervisorStopping = () => {
+        this.liveReload?.stopping();
+    };
+    constructor(properties) {
+        const { enabled, watch = simWatch } = properties;
+        this.liveReload = enabled ? new SimLiveReload() : undefined;
+        this.watch = watch;
+    }
+    /**
+     * The channel to hand to the request handler, if there is one.
+     */
+    channel() {
+        return this.liveReload;
+    }
+    /**
+     * Say live reload is on, and start listening for a supervised restart.
+     *
+     * Under `yulin watch` the process is killed rather than asked to close, so
+     * this is where a served page finds out a restart is coming.
+     */
+    serving(port) {
+        if (this.liveReload === undefined) {
+            return;
+        }
+        new SimLiveReloadReport().announce(port);
+        this.watch.onStopping(this.onSupervisorStopping);
+    }
+    /**
+     * Tell connected browsers a reload is coming, and stop listening.
+     */
+    stopping() {
+        this.watch.offStopping(this.onSupervisorStopping);
+        this.liveReload?.stopping();
+    }
+    /**
+     * Reload connected browsers now.
+     */
+    reload() {
+        if (this.liveReload === undefined) {
+            throw new Error("Live reload is off for this server, serve with { liveReload: true } to use reload()");
+        }
+        this.liveReload.reload();
+    }
+}
+//# sourceMappingURL=sim-local-live-reload.js.map

package/dist/serve/http/live-reload/sim-local-live-reload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-local-live-reload.js","sourceRoot":"","sources":["../../../../src/serve/http/live-reload/sim-local-live-reload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EACL,QAAQ,GAET,MAAM,qCAAqC,CAAC;AAO7C;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAkB;IACZ,UAAU,CAA4B;IACtC,KAAK,CAAkB;IAEvB,oBAAoB,GAAG,GAAS,EAAE;QACjD,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC,CAAC;IAEF,YAAY,UAAwC;QAClD,MAAM,EAAE,OAAO,EAAE,KAAK,GAAG,QAAQ,EAAE,GAAG,UAAU,CAAC;QACjD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAC5D,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAY;QAClB,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,OAAO;QACT,CAAC;QAED,IAAI,mBAAmB,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAClD,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YAClC,MAAM,IAAI,KAAK,CACb,qFAAqF,CACtF,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;CACF"}