@mokly/mokly 0.8.0

package/dist/server/http_routes.js

@@ -0,0 +1,68 @@
+import { redirectId, renderView } from "./view_routes.js";
+import { openEventStream, serveClientModule, serveFontAsset, } from "./browser_assets.js";
+import { homePage, notFoundPage } from "./pages.js";
+import { send } from "./respond.js";
+import { shellContext } from "./shell/context.js";
+import { SHELL_CSS } from "./shell/css.js";
+import { serveStatic } from "./static_routes.js";
+import { handleDemandRequest } from "./demand/http.js";
+/** Dispatch a request against one validated catalogue generation. */
+export async function handleCatalogueRequest(rawUrl, method, response, catalogue, config, base, currentChangedRoutes, streams, assets, currentVersion, reviewRoutes, componentChanges, renderCapability, documents, changesStatus, contentVersion) {
+    if (method !== "GET" && method !== "HEAD")
+        return send(response, 405, "text/plain", "Method not allowed", method);
+    const url = new URL(rawUrl, "http://mokly.invalid");
+    if (documents &&
+        (await handleDemandRequest(url, method, response, catalogue, documents)))
+        return;
+    const requestVersion = currentVersion();
+    const changed = componentChanges?.changedRoutes ??
+        (componentChanges?.result
+            ? componentChanges.result.changes.map((entry) => (entry.after ?? entry.before).route)
+            : currentChangedRoutes());
+    const context = shellContext(base, changed
+        ? [
+            ...new Set([
+                ...changed,
+                ...catalogue.removedEntries.map(({ entry }) => entry.route),
+            ]),
+        ]
+        : undefined, requestVersion);
+    context.comparisons = reviewRoutes !== undefined;
+    if (contentVersion !== undefined)
+        context.contentVersion = contentVersion;
+    if (documents && renderCapability)
+        context.previewGeneration = renderCapability.generation;
+    if (changesStatus)
+        context.changesStatus = changed ? "ready" : changesStatus;
+    if (componentChanges)
+        context.componentChanges = componentChanges;
+    if (renderCapability)
+        context.renderCapability = renderCapability;
+    if (url.pathname === "/")
+        return send(response, 200, "text/html", homePage(catalogue, context), method);
+    if (reviewRoutes && url.pathname.startsWith("/__mokly/diffs/")) {
+        void reviewRoutes.handle(url, response, method);
+        return;
+    }
+    if (url.pathname === "/__mokly/shell.css")
+        return send(response, 200, "text/css", SHELL_CSS, method);
+    if (url.pathname === "/__mokly/events")
+        return openEventStream(response, streams, requestVersion, method);
+    if (url.pathname.startsWith("/__mokly/client/")) {
+        return serveClientModule(response, url.pathname.slice("/__mokly/client/".length), assets.clientModules, method);
+    }
+    if (url.pathname.startsWith("/__mokly/navigation/")) {
+        return serveClientModule(response, url.pathname.slice("/__mokly/navigation/".length), assets.navigationModules, method);
+    }
+    if (url.pathname.startsWith("/__mokly/fonts/")) {
+        return serveFontAsset(response, url.pathname.slice("/__mokly/fonts/".length), assets.fontAssets, method);
+    }
+    if (url.pathname.startsWith("/id/"))
+        return redirectId(response, url, url.pathname.slice(4), catalogue, config, context, method, documents);
+    if (url.pathname.startsWith("/view/"))
+        return renderView(response, url, url.pathname.slice(6), catalogue, config, context, method, documents);
+    if (url.pathname.startsWith("/static/"))
+        return serveStatic(response, url.pathname.slice(8), config, catalogue, method);
+    return send(response, 404, "text/html", notFoundPage(url.pathname, catalogue, context), method);
+}
+//# sourceMappingURL=http_routes.js.map

package/dist/server/http_routes.js.map

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

package/dist/server/pages.d.ts

@@ -0,0 +1,11 @@
+/** Served shell pages composed from the catalogue and shell views. */
+import type { ManifestEntry } from "../registry/types.js";
+import type { Catalogue } from "./catalogue.js";
+import type { ShellContext } from "./shell/context.js";
+/** Render the catalogue home page. */
+export declare function homePage(catalogue: Catalogue, context: ShellContext): string;
+/** Render one screen, use case, or whole-document page. */
+export declare function viewPage(entry: ManifestEntry, catalogue: Catalogue, context: ShellContext): string;
+/** Render a route-aware not-found page keeping navigation available. */
+export declare function notFoundPage(detail: string, catalogue: Catalogue, context: ShellContext): string;
+//# sourceMappingURL=pages.d.ts.map

package/dist/server/pages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/server/pages.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,sCAAsC;AACtC,wBAAgB,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,CAE5E;AAED,2DAA2D;AAC3D,wBAAgB,QAAQ,CACtB,KAAK,EAAE,aAAa,EACpB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,YAAY,GACpB,MAAM,CAMR;AAED,wEAAwE;AACxE,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,YAAY,GACpB,MAAM,CAMR"}

package/dist/server/pages.js

@@ -0,0 +1,20 @@
+/** Served shell pages composed from the catalogue and shell views. */
+import { renderShellPage } from "./shell/document.js";
+import { toRouteTarget } from "./shell/target.js";
+/** Render the catalogue home page. */
+export function homePage(catalogue, context) {
+    return renderShellPage(catalogue, { kind: "home" }, context);
+}
+/** Render one screen, use case, or whole-document page. */
+export function viewPage(entry, catalogue, context) {
+    const target = toRouteTarget(entry);
+    const view = target
+        ? { kind: "target", target }
+        : { kind: "missing", requested: "kind" in entry ? entry.title : "" };
+    return renderShellPage(catalogue, view, context);
+}
+/** Render a route-aware not-found page keeping navigation available. */
+export function notFoundPage(detail, catalogue, context) {
+    return renderShellPage(catalogue, { kind: "missing", requested: detail }, context);
+}
+//# sourceMappingURL=pages.js.map

package/dist/server/pages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pages.js","sourceRoot":"","sources":["../../src/server/pages.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAKtE,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,sCAAsC;AACtC,MAAM,UAAU,QAAQ,CAAC,SAAoB,EAAE,OAAqB;IAClE,OAAO,eAAe,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,QAAQ,CACtB,KAAoB,EACpB,SAAoB,EACpB,OAAqB;IAErB,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,IAAI,GAAc,MAAM;QAC5B,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE;QAC5B,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACvE,OAAO,eAAe,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACnD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,SAAoB,EACpB,OAAqB;IAErB,OAAO,eAAe,CACpB,SAAS,EACT,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,EACtC,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/server/ports.d.ts

@@ -0,0 +1,4 @@
+import type http from "node:http";
+/** Bind from the requested port, advancing past occupied ports when allowed. */
+export declare function listenOnAvailablePort(server: http.Server, requestedPort: number, strictPort: boolean): Promise<void>;
+//# sourceMappingURL=ports.d.ts.map

package/dist/server/ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.d.ts","sourceRoot":"","sources":["../../src/server/ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAMlC,gFAAgF;AAChF,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,IAAI,CAAC,MAAM,EACnB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,OAAO,GAClB,OAAO,CAAC,IAAI,CAAC,CAkBf"}

package/dist/server/ports.js

@@ -0,0 +1,48 @@
+import { MoklyError, errorMessage } from "../errors.js";
+const MAX_PORT = 65_535;
+/** Bind from the requested port, advancing past occupied ports when allowed. */
+export async function listenOnAvailablePort(server, requestedPort, strictPort) {
+    let port = requestedPort;
+    while (true) {
+        try {
+            await listen(server, port);
+            return;
+        }
+        catch (error) {
+            if (!strictPort && port > 0 && port < MAX_PORT && isInUse(error)) {
+                port += 1;
+                continue;
+            }
+            throw new MoklyError("server-failed", `could not bind port ${port}: ${errorMessage(error)}`, { cause: error });
+        }
+    }
+}
+function listen(server, port) {
+    return new Promise((resolve, reject) => {
+        const cleanup = () => {
+            server.off("error", onError);
+            server.off("listening", onListening);
+        };
+        const onError = (error) => {
+            cleanup();
+            reject(error);
+        };
+        const onListening = () => {
+            cleanup();
+            resolve();
+        };
+        server.once("error", onError);
+        server.once("listening", onListening);
+        try {
+            server.listen(port, "127.0.0.1");
+        }
+        catch (error) {
+            cleanup();
+            reject(error);
+        }
+    });
+}
+function isInUse(error) {
+    return (error instanceof Error && "code" in error && error.code === "EADDRINUSE");
+}
+//# sourceMappingURL=ports.js.map

package/dist/server/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/server/ports.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAExD,MAAM,QAAQ,GAAG,MAAM,CAAC;AAExB,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAmB,EACnB,aAAqB,EACrB,UAAmB;IAEnB,IAAI,IAAI,GAAG,aAAa,CAAC;IACzB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjE,IAAI,IAAI,CAAC,CAAC;gBACV,SAAS;YACX,CAAC;YACD,MAAM,IAAI,UAAU,CAClB,eAAe,EACf,uBAAuB,IAAI,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE,EACrD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,MAAmB,EAAE,IAAY;IAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,GAAS,EAAE;YACzB,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACvC,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,KAAY,EAAQ,EAAE;YACrC,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC;QACF,MAAM,WAAW,GAAG,GAAS,EAAE;YAC7B,OAAO,EAAE,CAAC;YACV,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,CACL,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY,CACzE,CAAC;AACJ,CAAC"}

package/dist/server/resource_watcher.d.ts

@@ -0,0 +1,22 @@
+/** Transactional watches for resources discovered from generated output. */
+import type { Compilation } from "../build/compile.js";
+import type { ResolvedConfig } from "../config/types.js";
+import type { ConsumerWatcherFactory } from "./watcher.js";
+/** Ready resource inputs adopted only after the matching output succeeds. */
+export interface PreparedResourceWatch {
+    adopt(): void;
+    close(): Promise<void>;
+}
+/** Retain last-good watches until a complete replacement is ready. */
+export declare class ResourceWatcher {
+    #private;
+    private readonly factory;
+    private readonly changed;
+    private readonly failed;
+    constructor(factory: ConsumerWatcherFactory, changed: (candidate: string) => void, failed: (error: Error) => void);
+    get paths(): ReadonlySet<string>;
+    /** Observe new inputs before adoption and retain removed inputs until it succeeds. */
+    prepare(config: ResolvedConfig, compilation: Pick<Compilation, "outputs">, shutdownStarted: Promise<void>, allowInvalid?: boolean, incremental?: boolean): Promise<PreparedResourceWatch | undefined>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=resource_watcher.d.ts.map

package/dist/server/resource_watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource_watcher.d.ts","sourceRoot":"","sources":["../../src/server/resource_watcher.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAK5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAmB,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAO5E,6EAA6E;AAC7E,MAAM,WAAW,qBAAqB;IACpC,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,sEAAsE;AACtE,qBAAa,eAAe;;IAMxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,EACpC,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI;IAGjD,IAAI,KAAK,IAAI,WAAW,CAAC,MAAM,CAAC,CAE/B;IAED,sFAAsF;IAChF,OAAO,CACX,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EACzC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,EAC9B,YAAY,UAAQ,EACpB,WAAW,UAAQ,GAClB,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IA0FvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B"}

package/dist/server/resource_watcher.js

@@ -0,0 +1,119 @@
+/** Transactional watches for resources discovered from generated output. */
+import path from "node:path";
+import { timeAsync } from "../diagnostics/timings.js";
+import { isInside } from "../config/paths.js";
+import { NotificationGate } from "./watch_events.js";
+import { watcherReadyBeforeShutdown } from "./serve_lifecycle.js";
+import { discoverWatchResources, } from "./watch_resources.js";
+/** Retain last-good watches until a complete replacement is ready. */
+export class ResourceWatcher {
+    factory;
+    changed;
+    failed;
+    #snapshot;
+    #watcher;
+    #closed = false;
+    constructor(factory, changed, failed) {
+        this.factory = factory;
+        this.changed = changed;
+        this.failed = failed;
+    }
+    get paths() {
+        return this.#snapshot?.paths ?? new Set();
+    }
+    /** Observe new inputs before adoption and retain removed inputs until it succeeds. */
+    async prepare(config, compilation, shutdownStarted, allowInvalid = false, incremental = false) {
+        const previous = incremental ? this.#snapshot : undefined;
+        const discover = async (last) => {
+            const next = await discoverWatchResources(config, compilation, last, allowInvalid);
+            return previous ? mergeResourceSnapshots(previous, next) : next;
+        };
+        let snapshot = await timeAsync("watch.resources-discover", () => discover(this.#snapshot));
+        if (sameWatch(snapshot, this.#snapshot)) {
+            return {
+                adopt: () => {
+                    if (!this.#closed)
+                        this.#snapshot = snapshot;
+                },
+                close: async () => undefined,
+            };
+        }
+        while (!this.#closed) {
+            const gate = new NotificationGate();
+            const paths = snapshot.paths;
+            const watcher = snapshot.paths.size > 0
+                ? this.factory.create([
+                    ...new Set([...paths].map((candidate) => path.dirname(candidate))),
+                ].sort(), (candidate) => ![...paths].some((resource) => isInside(path.resolve(candidate), resource)), { followSymlinks: false })
+                : undefined;
+            watcher?.onChange((candidate) => gate.notify(candidate));
+            watcher?.onError(this.failed);
+            try {
+                if (watcher &&
+                    !(await timeAsync("watch.resources-ready", () => watcherReadyBeforeShutdown(watcher, shutdownStarted)))) {
+                    await watcher.close();
+                    return undefined;
+                }
+                const refreshed = await timeAsync("watch.resources-rediscover", () => discover(snapshot));
+                if (!sameWatch(snapshot, refreshed)) {
+                    await watcher?.close();
+                    snapshot = refreshed;
+                    continue;
+                }
+                snapshot = refreshed;
+                let adopted = false;
+                let disposed = false;
+                let previous;
+                return {
+                    adopt: () => {
+                        if (this.#closed || adopted || disposed)
+                            return;
+                        previous = this.#watcher;
+                        this.#snapshot = snapshot;
+                        this.#watcher = watcher;
+                        adopted = true;
+                        gate.open((candidate) => {
+                            if (this.#watcher === watcher && !this.#closed)
+                                this.changed(candidate);
+                        });
+                    },
+                    close: async () => {
+                        if (disposed)
+                            return;
+                        disposed = true;
+                        await (adopted ? previous : watcher)?.close();
+                    },
+                };
+            }
+            catch (error) {
+                await watcher?.close();
+                throw error;
+            }
+        }
+        return undefined;
+    }
+    async close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        await this.#watcher?.close();
+    }
+}
+function mergeResourceSnapshots(previous, next) {
+    return {
+        paths: new Set([...previous.paths, ...next.paths]),
+        invalid: new Set([...previous.invalid, ...next.invalid]),
+        references: new Map([...previous.references, ...next.references]),
+        locations: new Map([...previous.locations, ...next.locations]),
+    };
+}
+/** Replace observers after invalid entries recover, even at the same lexical path. */
+function sameWatch(left, right) {
+    return (samePaths(left.paths, right?.paths ?? new Set()) &&
+        samePaths(left.invalid, right?.invalid ?? new Set()));
+}
+function samePaths(left, right) {
+    return (left.size === right.size &&
+        [...left].every((candidate) => right.has(candidate)));
+}
+//# sourceMappingURL=resource_watcher.js.map

package/dist/server/resource_watcher.js.map

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

package/dist/server/respond.d.ts

@@ -0,0 +1,11 @@
+/** Shared HTTP response and safe-path helpers for served Mokly routes. */
+import type { ServerResponse } from "node:http";
+/** Write one complete text response, omitting the body for HEAD. */
+export declare function send(response: ServerResponse, status: number, type: string, body: string, method: string): void;
+/** Decode an encoded relative URL path, rejecting traversal and separators. */
+export declare function safeDecodePath(value: string): string | undefined;
+/** Decode one URL component, treating malformed input as empty. */
+export declare function safeDecode(value: string): string;
+/** The response content type for a served artifact or static file. */
+export declare function contentType(candidate: string): string;
+//# sourceMappingURL=respond.d.ts.map

package/dist/server/respond.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.d.ts","sourceRoot":"","sources":["../../src/server/respond.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAG1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,oEAAoE;AACpE,wBAAgB,IAAI,CAClB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,IAAI,CAMN;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkBhE;AAED,mEAAmE;AACnE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAkBrD"}

package/dist/server/respond.js

@@ -0,0 +1,57 @@
+/** Shared HTTP response and safe-path helpers for served Mokly routes. */
+import path from "node:path";
+/** Write one complete text response, omitting the body for HEAD. */
+export function send(response, status, type, body, method) {
+    response.writeHead(status, {
+        "content-type": `${type}; charset=utf-8`,
+        "x-content-type-options": "nosniff",
+    });
+    response.end(method === "HEAD" ? undefined : body);
+}
+/** Decode an encoded relative URL path, rejecting traversal and separators. */
+export function safeDecodePath(value) {
+    try {
+        const segments = value.split("/").map(decodeURIComponent);
+        if (segments.some((part) => part === "" ||
+            part === "." ||
+            part === ".." ||
+            part.includes("/") ||
+            part.includes("\\")))
+            return undefined;
+        return segments.join("/");
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Decode one URL component, treating malformed input as empty. */
+export function safeDecode(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return "";
+    }
+}
+/** The response content type for a served artifact or static file. */
+export function contentType(candidate) {
+    const extension = path.extname(candidate).toLowerCase();
+    if (extension === ".json")
+        return "application/json; charset=utf-8";
+    return extension === ".html" || extension === ".htm"
+        ? "text/html; charset=utf-8"
+        : extension === ".js"
+            ? "text/javascript; charset=utf-8"
+            : extension === ".css"
+                ? "text/css; charset=utf-8"
+                : extension === ".svg"
+                    ? "image/svg+xml"
+                    : extension === ".png"
+                        ? "image/png"
+                        : extension === ".jpg" || extension === ".jpeg"
+                            ? "image/jpeg"
+                            : extension === ".woff2"
+                                ? "font/woff2"
+                                : "application/octet-stream";
+}
+//# sourceMappingURL=respond.js.map

package/dist/server/respond.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond.js","sourceRoot":"","sources":["../../src/server/respond.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAE1E,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,oEAAoE;AACpE,MAAM,UAAU,IAAI,CAClB,QAAwB,EACxB,MAAc,EACd,IAAY,EACZ,IAAY,EACZ,MAAc;IAEd,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE;QACzB,cAAc,EAAE,GAAG,IAAI,iBAAiB;QACxC,wBAAwB,EAAE,SAAS;KACpC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAC1D,IACE,QAAQ,CAAC,IAAI,CACX,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,KAAK,EAAE;YACX,IAAI,KAAK,GAAG;YACZ,IAAI,KAAK,IAAI;YACb,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAClB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CACtB;YAED,OAAO,SAAS,CAAC;QACnB,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,SAAiB;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;IACxD,IAAI,SAAS,KAAK,OAAO;QAAE,OAAO,iCAAiC,CAAC;IACpE,OAAO,SAAS,KAAK,OAAO,IAAI,SAAS,KAAK,MAAM;QAClD,CAAC,CAAC,0BAA0B;QAC5B,CAAC,CAAC,SAAS,KAAK,KAAK;YACnB,CAAC,CAAC,gCAAgC;YAClC,CAAC,CAAC,SAAS,KAAK,MAAM;gBACpB,CAAC,CAAC,yBAAyB;gBAC3B,CAAC,CAAC,SAAS,KAAK,MAAM;oBACpB,CAAC,CAAC,eAAe;oBACjB,CAAC,CAAC,SAAS,KAAK,MAAM;wBACpB,CAAC,CAAC,WAAW;wBACb,CAAC,CAAC,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,OAAO;4BAC7C,CAAC,CAAC,YAAY;4BACd,CAAC,CAAC,SAAS,KAAK,QAAQ;gCACtB,CAAC,CAAC,YAAY;gCACd,CAAC,CAAC,0BAA0B,CAAC;AAC7C,CAAC"}

package/dist/server/review_generations.d.ts

@@ -0,0 +1,43 @@
+/** Immutable filesystem generations for served Review artifacts. */
+/** Filesystem context excluded while generating a served Review artifact. */
+export interface ReviewArtifactGenerationOptions {
+    /** Package-owned directories that must not enter changed-path evidence. */
+    readonly changedPathExclusions: readonly string[];
+}
+/** Provider that replaces one configured Review artifact directory. */
+export interface ReviewArtifactProvider {
+    /** Replace {@link outDir} with one complete Review artifact. */
+    generate(options: ReviewArtifactGenerationOptions): Promise<void>;
+    /** Configured directory holding the current Review artifact. */
+    outDir: string;
+}
+/** One immutable artifact directory addressable by its server URL version. */
+export interface ReviewGeneration {
+    readonly directory: string;
+    readonly version: string;
+}
+/** Preserve replaced artifacts briefly so in-flight pages remain coherent. */
+export declare class ReviewGenerationStore {
+    private readonly provider;
+    private archiveRoot;
+    private readonly generations;
+    private readonly retentionTimers;
+    private readonly removals;
+    private closed;
+    private currentGeneration;
+    constructor(provider: ReviewArtifactProvider);
+    /** Most recently completed generation, if the provider has run. */
+    current(): ReviewGeneration | undefined;
+    /** Find a retained generation and extend its idle retention window. */
+    get(version: string): ReviewGeneration | undefined;
+    /** Replace the current artifact while retaining its immutable predecessor. */
+    generate(): Promise<ReviewGeneration>;
+    /** Remove only temporary archives owned by this server instance. */
+    close(): Promise<void>;
+    private archive;
+    private ensureArchiveRoot;
+    private restore;
+    private scheduleExpiry;
+    private expire;
+}
+//# sourceMappingURL=review_generations.d.ts.map

package/dist/server/review_generations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review_generations.d.ts","sourceRoot":"","sources":["../../src/server/review_generations.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAWpE,6EAA6E;AAC7E,MAAM,WAAW,+BAA+B;IAC9C,2EAA2E;IAC3E,QAAQ,CAAC,qBAAqB,EAAE,SAAS,MAAM,EAAE,CAAC;CACnD;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,QAAQ,CAAC,OAAO,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,8EAA8E;AAC9E,qBAAa,qBAAqB;IAQpB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAPrC,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuC;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqC;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4B;IACrD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,iBAAiB,CAA+B;gBAE3B,QAAQ,EAAE,sBAAsB;IAE7D,mEAAmE;IACnE,OAAO,IAAI,gBAAgB,GAAG,SAAS;IAIvC,uEAAuE;IACvE,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAOlD,8EAA8E;IACxE,QAAQ,IAAI,OAAO,CAAC,gBAAgB,CAAC;IA2B3C,oEAAoE;IAC9D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAUd,OAAO;YAwBP,iBAAiB;YAYjB,OAAO;IA4BrB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,MAAM;CAcf"}

package/dist/server/review_generations.js

@@ -0,0 +1,170 @@
+/** Immutable filesystem generations for served Review artifacts. */
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { MoklyError, errorMessage } from "../errors.js";
+const GENERATION_RETENTION_MS = 60_000;
+const REVIEW_ARTIFACT_MARKER = ".mokly-review-artifact";
+/** Preserve replaced artifacts briefly so in-flight pages remain coherent. */
+export class ReviewGenerationStore {
+    provider;
+    archiveRoot;
+    generations = new Map();
+    retentionTimers = new Map();
+    removals = new Set();
+    closed = false;
+    currentGeneration;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    /** Most recently completed generation, if the provider has run. */
+    current() {
+        return this.currentGeneration;
+    }
+    /** Find a retained generation and extend its idle retention window. */
+    get(version) {
+        const generation = this.generations.get(version);
+        if (generation && generation.version !== this.currentGeneration?.version)
+            this.scheduleExpiry(generation);
+        return generation;
+    }
+    /** Replace the current artifact while retaining its immutable predecessor. */
+    async generate() {
+        const previous = this.currentGeneration;
+        const archived = previous ? await this.archive(previous) : undefined;
+        try {
+            await this.provider.generate({
+                changedPathExclusions: this.archiveRoot ? [this.archiveRoot] : [],
+            });
+            if (reviewDirectoryState(this.provider.outDir) === "missing") {
+                throw new MoklyError("server-failed", `Review provider did not generate an artifact at ${this.provider.outDir}`);
+            }
+        }
+        catch (error) {
+            if (archived)
+                await this.restore(archived, error);
+            throw error;
+        }
+        const generation = {
+            directory: path.resolve(this.provider.outDir),
+            version: randomUUID(),
+        };
+        this.currentGeneration = generation;
+        this.generations.set(generation.version, generation);
+        if (archived)
+            this.scheduleExpiry(archived);
+        return generation;
+    }
+    /** Remove only temporary archives owned by this server instance. */
+    async close() {
+        this.closed = true;
+        for (const timer of this.retentionTimers.values())
+            clearTimeout(timer);
+        this.retentionTimers.clear();
+        await Promise.allSettled([...this.removals]);
+        if (this.archiveRoot) {
+            await fs.promises.rm(this.archiveRoot, { force: true, recursive: true });
+        }
+    }
+    async archive(generation) {
+        if (reviewDirectoryState(this.provider.outDir) === "missing") {
+            this.generations.delete(generation.version);
+            this.currentGeneration = undefined;
+            return undefined;
+        }
+        const archiveRoot = await this.ensureArchiveRoot();
+        if (reviewDirectoryState(this.provider.outDir) === "missing") {
+            this.generations.delete(generation.version);
+            this.currentGeneration = undefined;
+            return undefined;
+        }
+        const archived = {
+            directory: path.join(archiveRoot, generation.version),
+            version: generation.version,
+        };
+        fs.renameSync(this.provider.outDir, archived.directory);
+        this.currentGeneration = archived;
+        this.generations.set(archived.version, archived);
+        return archived;
+    }
+    async ensureArchiveRoot() {
+        if (!this.archiveRoot) {
+            await fs.promises.mkdir(path.dirname(this.provider.outDir), {
+                recursive: true,
+            });
+            this.archiveRoot = await fs.promises.mkdtemp(path.join(path.dirname(this.provider.outDir), ".mokly-review-served-"));
+        }
+        return this.archiveRoot;
+    }
+    async restore(archived, generationError) {
+        try {
+            if (reviewDirectoryState(this.provider.outDir) === "owned") {
+                await fs.promises.rm(this.provider.outDir, {
+                    force: true,
+                    recursive: true,
+                });
+            }
+            fs.renameSync(archived.directory, this.provider.outDir);
+            const restored = {
+                directory: path.resolve(this.provider.outDir),
+                version: archived.version,
+            };
+            this.currentGeneration = restored;
+            this.generations.set(restored.version, restored);
+        }
+        catch (restoreError) {
+            throw new MoklyError("server-failed", `Review generation failed (${errorMessage(generationError)}) and its ` +
+                `previous artifact could not be restored: ${errorMessage(restoreError)}`, { cause: restoreError });
+        }
+    }
+    scheduleExpiry(generation) {
+        if (this.closed)
+            return;
+        const existing = this.retentionTimers.get(generation.version);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => this.expire(generation), GENERATION_RETENTION_MS);
+        timer.unref();
+        this.retentionTimers.set(generation.version, timer);
+    }
+    expire(generation) {
+        this.retentionTimers.delete(generation.version);
+        if (generation.version === this.currentGeneration?.version)
+            return;
+        this.generations.delete(generation.version);
+        const removal = fs.promises.rm(generation.directory, {
+            force: true,
+            recursive: true,
+        });
+        this.removals.add(removal);
+        void removal.then(() => this.removals.delete(removal), () => this.removals.delete(removal));
+    }
+}
+function reviewDirectoryState(directory) {
+    let output;
+    try {
+        output = fs.lstatSync(directory);
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return "missing";
+        throw error;
+    }
+    let marker;
+    try {
+        marker = fs.lstatSync(path.join(directory, REVIEW_ARTIFACT_MARKER));
+    }
+    catch (error) {
+        if (error.code !== "ENOENT")
+            throw error;
+        throw unownedReviewDirectory(directory);
+    }
+    if (!output.isDirectory() || !marker.isFile()) {
+        throw unownedReviewDirectory(directory);
+    }
+    return "owned";
+}
+function unownedReviewDirectory(directory) {
+    return new MoklyError("review-invalid", `refusing to replace unowned Review directory: ${directory}`);
+}
+//# sourceMappingURL=review_generations.js.map