@mokly/mokly 0.8.0

package/dist/server/review_generations.js.map

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

package/dist/server/review_responses.d.ts

@@ -0,0 +1,9 @@
+/** HTTP response helpers for served Review artifacts. */
+import type { ServerResponse } from "node:http";
+/** Redirect to a stable or immutable Review route without caching. */
+export declare function redirectReview(response: ServerResponse, location: string): void;
+/** Serve one immutable Review artifact file from its retained generation. */
+export declare function serveReviewArtifactFile(directory: string, relative: string, response: ServerResponse, method: string): void;
+/** Comparison failures stay inside the current screen and offer a retry. */
+export declare function sendReviewFailure(response: ServerResponse, error: unknown, base: string, method: string): void;
+//# sourceMappingURL=review_responses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review_responses.d.ts","sourceRoot":"","sources":["../../src/server/review_responses.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAMhD,sEAAsE;AACtE,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,GACf,IAAI,CAMN;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GACb,IAAI,CAUN;AAED,4EAA4E;AAC5E,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,GACb,IAAI,CAcN"}

package/dist/server/review_responses.js

@@ -0,0 +1,40 @@
+/** HTTP response helpers for served Review artifacts. */
+import path from "node:path";
+import { errorMessage } from "../errors.js";
+import { readConfinedFile } from "./confined_file.js";
+import { contentType, send } from "./respond.js";
+/** Redirect to a stable or immutable Review route without caching. */
+export function redirectReview(response, location) {
+    response.writeHead(302, {
+        "cache-control": "no-store",
+        location,
+    });
+    response.end();
+}
+/** Serve one immutable Review artifact file from its retained generation. */
+export function serveReviewArtifactFile(directory, relative, response, method) {
+    const content = readConfinedFile(directory, relative);
+    if (content === undefined)
+        return send(response, 404, "text/plain", "Not found", method);
+    response.writeHead(200, {
+        "cache-control": "no-store",
+        "content-type": contentType(path.resolve(directory, relative)),
+        "x-content-type-options": "nosniff",
+    });
+    response.end(method === "HEAD" ? undefined : content);
+}
+/** Comparison failures stay inside the current screen and offer a retry. */
+export function sendReviewFailure(response, error, base, method) {
+    response.writeHead(500, {
+        "cache-control": "no-store",
+        "content-type": "application/json",
+        "x-content-type-options": "nosniff",
+    });
+    response.end(method === "HEAD"
+        ? undefined
+        : JSON.stringify({
+            error: "The comparison could not be loaded. Try again.",
+            details: `Comparison with ${base}: ${errorMessage(error)}`,
+        }));
+}
+//# sourceMappingURL=review_responses.js.map

package/dist/server/review_responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review_responses.js","sourceRoot":"","sources":["../../src/server/review_responses.ts"],"names":[],"mappings":"AAAA,yDAAyD;AAEzD,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAEjD,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAC5B,QAAwB,EACxB,QAAgB;IAEhB,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;QACtB,eAAe,EAAE,UAAU;QAC3B,QAAQ;KACT,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,EAAE,CAAC;AACjB,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,QAAgB,EAChB,QAAwB,EACxB,MAAc;IAEd,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtD,IAAI,OAAO,KAAK,SAAS;QACvB,OAAO,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;IAChE,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;QACtB,eAAe,EAAE,UAAU;QAC3B,cAAc,EAAE,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC9D,wBAAwB,EAAE,SAAS;KACpC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,iBAAiB,CAC/B,QAAwB,EACxB,KAAc,EACd,IAAY,EACZ,MAAc;IAEd,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;QACtB,eAAe,EAAE,UAAU;QAC3B,cAAc,EAAE,kBAAkB;QAClC,wBAAwB,EAAE,SAAS;KACpC,CAAC,CAAC;IACH,QAAQ,CAAC,GAAG,CACV,MAAM,KAAK,MAAM;QACf,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC;YACb,KAAK,EAAE,gDAAgD;YACvD,OAAO,EAAE,mBAAmB,IAAI,KAAK,YAAY,CAAC,KAAK,CAAC,EAAE;SAC3D,CAAC,CACP,CAAC;AACJ,CAAC"}

package/dist/server/review_routes.d.ts

@@ -0,0 +1,41 @@
+/** Lazy comparison snapshots used by the catalogue diff controls. */
+import type { ServerResponse } from "node:http";
+import type { ResolvedConfig } from "../config/types.js";
+import type { GitClient } from "../review/git.js";
+import type { SelectedReviewProvider, SelectedReviewSource } from "../review/selection_types.js";
+import { type ReviewArtifactProvider } from "./review_generations.js";
+/** How Browse obtains the Review artifact it serves under `/__mokly/diffs/`. */
+export interface ServedReview extends ReviewArtifactProvider {
+    /** Comparison base ref, shown when the comparison cannot be generated. */
+    base: string;
+    selected?: SelectedReviewProvider;
+}
+/** Serve the configured Git comparison from the consumer's Review engine. */
+export declare function configuredServedReview(config: ResolvedConfig, base: string, git?: GitClient): ServedReview;
+/** Serialize lazy Review generation and serve the artifact's files. */
+export declare class ReviewRoutes {
+    private readonly review;
+    private closed;
+    private closePromise;
+    private generation;
+    private generationKind;
+    private queuedGeneration;
+    private readonly generations;
+    private stale;
+    private readonly selected;
+    constructor(review: ServedReview, source?: () => SelectedReviewSource | undefined);
+    /** Mark the cached artifact stale after an update that reloads browsers. */
+    invalidate(): void;
+    /** Drain generation work and remove retained artifacts when the server stops. */
+    close(): Promise<void>;
+    /** Respond to one `/__mokly/diffs/` or `/__mokly/diffs/<path>` request. */
+    handle(url: URL, response: ServerResponse, method: string): Promise<void>;
+    /** Reuse a fresh generation; stale and refresh requests queue after it. */
+    private ensureGenerated;
+    private startGeneration;
+    private queueGeneration;
+    private trackGeneration;
+    private finishClose;
+    private handleGeneration;
+}
+//# sourceMappingURL=review_routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review_routes.d.ts","sourceRoot":"","sources":["../../src/server/review_routes.ts"],"names":[],"mappings":"AAAA,qEAAqE;AAErE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EAEL,KAAK,sBAAsB,EAE5B,MAAM,yBAAyB,CAAC;AAWjC,gFAAgF;AAChF,MAAM,WAAW,YAAa,SAAQ,sBAAsB;IAC1D,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,sBAAsB,CAAC;CACnC;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,GAAG,CAAC,EAAE,SAAS,GACd,YAAY,CAgBd;AAED,uEAAuE;AACvE,qBAAa,YAAY;IAWrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAVzB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,UAAU,CAAwC;IAC1D,OAAO,CAAC,cAAc,CAAmC;IACzD,OAAO,CAAC,gBAAgB,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;gBAGzC,MAAM,EAAE,YAAY,EACrC,MAAM,GAAE,MAAM,oBAAoB,GAAG,SAA2B;IAQlE,4EAA4E;IAC5E,UAAU,IAAI,IAAI;IAKlB,iFAAiF;IACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,2EAA2E;IACrE,MAAM,CACV,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,IAAI,CAAC;IA0BhB,2EAA2E;IAC3E,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,eAAe;YAuBT,WAAW;YAQX,gBAAgB;CA0D/B"}

package/dist/server/review_routes.js

@@ -0,0 +1,200 @@
+/** Lazy comparison snapshots used by the catalogue diff controls. */
+import { encodeUrlPath } from "../config/paths.js";
+import { MoklyError } from "../errors.js";
+import { runReview } from "../review/run.js";
+import { RepositorySelectedReview } from "../review/selected.js";
+import { SelectedReviewRoutes } from "./selected_review_routes.js";
+import { ReviewGenerationStore, } from "./review_generations.js";
+import { redirectReview, sendReviewFailure, serveReviewArtifactFile, } from "./review_responses.js";
+import { safeDecodePath, send } from "./respond.js";
+const DIFF_ROUTE = "/__mokly/diffs/";
+const GENERATION_ROUTE = `${DIFF_ROUTE}__generations/`;
+/** Serve the configured Git comparison from the consumer's Review engine. */
+export function configuredServedReview(config, base, git) {
+    return {
+        base,
+        selected: new RepositorySelectedReview(config, git),
+        async generate(options) {
+            await runReview(config, base, config.review.outDir, git, undefined, options.changedPathExclusions);
+        },
+        outDir: config.review.outDir,
+    };
+}
+/** Serialize lazy Review generation and serve the artifact's files. */
+export class ReviewRoutes {
+    review;
+    closed = false;
+    closePromise;
+    generation;
+    generationKind;
+    queuedGeneration;
+    generations;
+    stale = false;
+    selected;
+    constructor(review, source = () => undefined) {
+        this.review = review;
+        this.generations = new ReviewGenerationStore(review);
+        this.selected = review.selected
+            ? new SelectedReviewRoutes(review.selected, source, review.base)
+            : undefined;
+    }
+    /** Mark the cached artifact stale after an update that reloads browsers. */
+    invalidate() {
+        if (!this.closed)
+            this.stale = true;
+        this.selected?.invalidate();
+    }
+    /** Drain generation work and remove retained artifacts when the server stops. */
+    close() {
+        this.closePromise ??= this.finishClose();
+        return this.closePromise;
+    }
+    /** Respond to one `/__mokly/diffs/` or `/__mokly/diffs/<path>` request. */
+    async handle(url, response, method) {
+        if (await this.selected?.handle(url, response, method))
+            return;
+        if (url.pathname.startsWith(GENERATION_ROUTE)) {
+            const requested = generationPath(url.pathname);
+            if (!requested ||
+                (!isSnapshot(requested.relative) &&
+                    !isReviewDocument(requested.relative)))
+                return send(response, 404, "text/plain", "Not found", method);
+            await this.handleGeneration(requested, url, response, method);
+            return;
+        }
+        const relative = safeDecodePath(url.pathname.slice(DIFF_ROUTE.length));
+        if (relative !== "review.json")
+            return send(response, 404, "text/plain", "Not found", method);
+        try {
+            const generation = await this.ensureGenerated(url.searchParams.get("refresh") === "1");
+            redirectReview(response, generationUrl(generation, relative));
+        }
+        catch (error) {
+            return sendReviewFailure(response, error, this.review.base, method);
+        }
+    }
+    /** Reuse a fresh generation; stale and refresh requests queue after it. */
+    ensureGenerated(refresh) {
+        if (this.closed)
+            return Promise.reject(reviewServerClosing());
+        if (this.queuedGeneration)
+            return this.queuedGeneration;
+        if (this.generation) {
+            if (this.stale || (refresh && this.generationKind === "demand")) {
+                return this.queueGeneration(this.generation);
+            }
+            return this.generation;
+        }
+        const current = this.generations.current();
+        if (current && !refresh && !this.stale)
+            return Promise.resolve(current);
+        return this.startGeneration(refresh || this.stale ? "refresh" : "demand");
+    }
+    startGeneration(kind) {
+        if (this.closed)
+            return Promise.reject(reviewServerClosing());
+        this.stale = false;
+        const generation = this.generations.generate();
+        this.trackGeneration(generation, kind);
+        return generation;
+    }
+    queueGeneration(active) {
+        const queued = active
+            .catch(() => undefined)
+            .then(() => {
+            if (this.queuedGeneration === queued)
+                this.queuedGeneration = undefined;
+            return this.startGeneration("refresh");
+        });
+        this.queuedGeneration = queued;
+        return queued;
+    }
+    trackGeneration(generation, kind) {
+        this.generation = generation;
+        this.generationKind = kind;
+        void generation.then(() => {
+            if (this.generation === generation) {
+                this.generation = undefined;
+                this.generationKind = undefined;
+            }
+        }, () => {
+            if (this.generation === generation) {
+                this.generation = undefined;
+                this.generationKind = undefined;
+                if (!this.closed)
+                    this.stale = true;
+            }
+        });
+    }
+    async finishClose() {
+        this.closed = true;
+        await this.selected?.close();
+        const pending = this.queuedGeneration ?? this.generation;
+        if (pending)
+            await Promise.allSettled([pending]);
+        await this.generations.close();
+    }
+    async handleGeneration(requested, url, response, method) {
+        const generation = this.generations.get(requested.version);
+        const current = this.generations.current();
+        const refresh = isReviewDocument(requested.relative) &&
+            url.searchParams.get("refresh") === "1";
+        const pending = this.queuedGeneration ?? this.generation;
+        const advance = refresh ||
+            (isReviewDocument(requested.relative) &&
+                (this.stale ||
+                    pending !== undefined ||
+                    (current !== undefined && current.version !== requested.version)));
+        if (advance) {
+            try {
+                const latest = refresh || this.stale || pending
+                    ? await this.ensureGenerated(refresh)
+                    : current;
+                if (latest)
+                    return redirectReview(response, generationUrl(latest, requested.relative));
+            }
+            catch (error) {
+                return sendReviewFailure(response, error, this.review.base, method);
+            }
+        }
+        if (!isSnapshot(requested.relative) &&
+            !isReviewDocument(requested.relative))
+            return send(response, 404, "text/plain", "Not found", method);
+        if (generation) {
+            return serveReviewArtifactFile(generation.directory, requested.relative, response, method);
+        }
+        if (!isReviewDocument(requested.relative))
+            return send(response, 404, "text/plain", "Not found", method);
+        try {
+            const latest = await this.ensureGenerated(false);
+            return redirectReview(response, generationUrl(latest, requested.relative));
+        }
+        catch (error) {
+            return sendReviewFailure(response, error, this.review.base, method);
+        }
+    }
+}
+function generationPath(pathname) {
+    const remainder = pathname.slice(GENERATION_ROUTE.length);
+    const separator = remainder.indexOf("/");
+    if (separator < 1)
+        return undefined;
+    const version = remainder.slice(0, separator);
+    const relative = safeDecodePath(remainder.slice(separator + 1));
+    return /^[A-Za-z0-9][A-Za-z0-9._~-]*$/.test(version) && relative
+        ? { relative, version }
+        : undefined;
+}
+function isReviewDocument(relative) {
+    return relative === "review.json";
+}
+function isSnapshot(relative) {
+    return relative.startsWith("snapshots/");
+}
+function generationUrl(generation, relative) {
+    return `${GENERATION_ROUTE}${generation.version}/${encodeUrlPath(relative)}`;
+}
+function reviewServerClosing() {
+    return new MoklyError("server-failed", "Comparison server is closing");
+}
+//# sourceMappingURL=review_routes.js.map

package/dist/server/review_routes.js.map

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

package/dist/server/selected_review_routes.d.ts

@@ -0,0 +1,22 @@
+import type { ServerResponse } from "node:http";
+import type { SelectedReviewProvider, SelectedReviewSource } from "../review/selection_types.js";
+export declare class SelectedReviewRoutes {
+    private readonly provider;
+    private readonly source;
+    private readonly base;
+    private readonly generations;
+    private readonly pending;
+    private readonly controllers;
+    private tail;
+    private epoch;
+    private closed;
+    private bytes;
+    private readonly expiry;
+    constructor(provider: SelectedReviewProvider, source: () => SelectedReviewSource | undefined, base: string);
+    invalidate(): void;
+    close(): Promise<void>;
+    handle(url: URL, response: ServerResponse, method: string): Promise<boolean>;
+    private generate;
+    private prune;
+}
+//# sourceMappingURL=selected_review_routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selected_review_routes.d.ts","sourceRoot":"","sources":["../../src/server/selected_review_routes.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,OAAO,KAAK,EAEV,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,8BAA8B,CAAC;AAiBtC,qBAAa,oBAAoB;IAc7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;IAC7D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0C;IAClE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA8B;IAC1D,OAAO,CAAC,IAAI,CAAuC;IACnD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAGb;gBAGS,QAAQ,EAAE,sBAAsB,EAChC,MAAM,EAAE,MAAM,oBAAoB,GAAG,SAAS,EAC9C,IAAI,EAAE,MAAM;IAG/B,UAAU,IAAI,IAAI;IAKZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,MAAM,CACV,GAAG,EAAE,GAAG,EACR,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC;IAwDnB,OAAO,CAAC,QAAQ;IAgFhB,OAAO,CAAC,KAAK;CAOd"}

package/dist/server/selected_review_routes.js

@@ -0,0 +1,171 @@
+/** Bounded immutable snapshots for the selected live screen or saved variant. */
+import { randomUUID } from "node:crypto";
+import { isSafeCatalogueRoute } from "../config/paths.js";
+import { MoklyError } from "../errors.js";
+import { contentType, safeDecodePath, send } from "./respond.js";
+import { redirectReview, sendReviewFailure } from "./review_responses.js";
+const PREFIX = "/__mokly/diffs/__generations/selected-";
+const RETENTION_MS = 60_000;
+const CAPACITY_BYTES = 128 * 1024 * 1024;
+export class SelectedReviewRoutes {
+    provider;
+    source;
+    base;
+    generations = new Map();
+    pending = new Map();
+    controllers = new Set();
+    tail = Promise.resolve();
+    epoch = 0;
+    closed = false;
+    bytes = 0;
+    expiry = setInterval(() => this.prune(), RETENTION_MS).unref();
+    constructor(provider, source, base) {
+        this.provider = provider;
+        this.source = source;
+        this.base = base;
+    }
+    invalidate() {
+        this.epoch++;
+        for (const controller of this.controllers)
+            controller.abort();
+    }
+    async close() {
+        this.closed = true;
+        this.invalidate();
+        clearInterval(this.expiry);
+        await this.tail;
+        this.generations.clear();
+        this.bytes = 0;
+    }
+    async handle(url, response, method) {
+        const stable = url.pathname === "/__mokly/diffs/review.json" &&
+            (url.searchParams.has("route") || url.searchParams.has("variant"));
+        if (!stable && !url.pathname.startsWith(PREFIX))
+            return false;
+        try {
+            if (stable) {
+                const selection = parseSelection(url);
+                if (!selection)
+                    send(response, 404, "text/plain", "Not found", method);
+                else
+                    redirectReview(response, generationUrl(await this.generate(selection, url.searchParams.get("refresh") === "1")));
+            }
+            else {
+                const relative = safeDecodePath(url.pathname.slice(PREFIX.length));
+                const separator = relative?.indexOf("/") ?? -1;
+                const generation = separator > 0
+                    ? this.generations.get(relative.slice(0, separator))
+                    : undefined;
+                const file = relative?.slice(separator + 1);
+                if (generation &&
+                    file === "review.json" &&
+                    url.searchParams.get("refresh") === "1")
+                    redirectReview(response, generationUrl(await this.generate(generation.selection, true)));
+                else {
+                    const bytes = file && generation?.files.get(file);
+                    if (!bytes)
+                        send(response, 404, "text/plain", "Not found", method);
+                    else {
+                        generation.expires = Date.now() + RETENTION_MS;
+                        response.writeHead(200, {
+                            "cache-control": "no-store",
+                            "content-type": contentType(file),
+                            "x-content-type-options": "nosniff",
+                        });
+                        response.end(method === "HEAD" ? undefined : bytes);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            sendReviewFailure(response, error, this.base, method);
+        }
+        return true;
+    }
+    generate(selection, refresh) {
+        if (this.closed)
+            return Promise.reject(unavailable("Comparison server is closing"));
+        const source = this.source();
+        if (!source)
+            return Promise.reject(unavailable("The catalogue comparison is not ready"));
+        this.prune();
+        const epoch = this.epoch;
+        const key = JSON.stringify([epoch, selection.route, selection.variantId]);
+        const active = this.pending.get(key);
+        if (active)
+            return active;
+        const current = [...this.generations.values()].findLast((generation) => generation.key === key);
+        if (current && !refresh) {
+            current.expires = Date.now() + RETENTION_MS;
+            return Promise.resolve(current);
+        }
+        if (this.pending.size >= 32)
+            return Promise.reject(unavailable("Comparison queue is full"));
+        const controller = new AbortController();
+        this.controllers.add(controller);
+        const timer = setTimeout(() => controller.abort(), 10_000).unref();
+        const pending = this.tail
+            .then(async () => {
+            controller.signal.throwIfAborted();
+            const artifact = await this.provider.generate(source, selection, controller.signal);
+            controller.signal.throwIfAborted();
+            if (epoch !== this.epoch || this.closed)
+                throw unavailable("Comparison generation was replaced");
+            const files = new Map([...artifact.files].map(([route, bytes]) => [
+                route,
+                Buffer.from(bytes),
+            ]));
+            files.set("review.json", Buffer.from(JSON.stringify(artifact.result)));
+            const bytes = [...files.values()].reduce((total, file) => total + file.byteLength, 0);
+            if (bytes > 64 * 1024 * 1024 ||
+                this.bytes + bytes > CAPACITY_BYTES ||
+                this.generations.size >= 64)
+                throw unavailable("Comparison snapshot capacity is full; try again shortly");
+            const generation = {
+                version: randomUUID(),
+                key,
+                selection,
+                files,
+                bytes,
+                expires: Date.now() + RETENTION_MS,
+            };
+            this.generations.set(generation.version, generation);
+            this.bytes += bytes;
+            return generation;
+        })
+            .finally(() => {
+            clearTimeout(timer);
+            this.controllers.delete(controller);
+            if (this.pending.get(key) === pending)
+                this.pending.delete(key);
+        });
+        this.pending.set(key, pending);
+        this.tail = pending.catch(() => { });
+        return pending;
+    }
+    prune() {
+        for (const [version, generation] of this.generations)
+            if (generation.expires <= Date.now()) {
+                this.generations.delete(version);
+                this.bytes -= generation.bytes;
+            }
+    }
+}
+function parseSelection(url) {
+    const route = url.searchParams.get("route");
+    const variantId = url.searchParams.get("variant");
+    if (!route ||
+        !isSafeCatalogueRoute(route) ||
+        url.searchParams.getAll("route").length !== 1 ||
+        url.searchParams.getAll("variant").length > 1 ||
+        (variantId !== null && !/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(variantId)))
+        return undefined;
+    return { route, ...(variantId !== null ? { variantId } : {}) };
+}
+function generationUrl(generation) {
+    return `${PREFIX}${generation.version}/review.json`;
+}
+function unavailable(message) {
+    return new MoklyError("review-invalid", message);
+}
+//# sourceMappingURL=selected_review_routes.js.map

package/dist/server/selected_review_routes.js.map

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

package/dist/server/serve.d.ts

@@ -0,0 +1,31 @@
+import { type GeneratedOutputStore } from "../build/output_store.js";
+import { type ConfigLoader } from "../config/load.js";
+import type { ResolvedConfig } from "../config/types.js";
+import { type CatalogueServerFactory } from "./factory.js";
+import { type CatalogueChangeClassifier } from "./component_changes.js";
+import { type ProcessSupervisorFactory } from "./supervisor.js";
+import { type ConsumerWatcherFactory } from "./watcher.js";
+/** Public Serve options after CLI validation. */
+export interface ServeOptions {
+    base?: string;
+    port: number;
+    watch: boolean;
+}
+/** Closable Serve lifecycle returned to CLI and integration tests. */
+export interface RunningServe {
+    close(): Promise<void>;
+    port: number;
+    url: string;
+}
+/** Injectable runtime collaborators for Serve orchestration. */
+export interface ServeDependencies {
+    changeClassifier?: CatalogueChangeClassifier;
+    configLoader: ConfigLoader;
+    outputStore: GeneratedOutputStore;
+    processSupervisorFactory: ProcessSupervisorFactory;
+    serverFactory: CatalogueServerFactory;
+    watcherFactory: ConsumerWatcherFactory;
+}
+/** Build a last-good snapshot and start watched or deterministic Browse. */
+export declare function serve(config: ResolvedConfig, options: ServeOptions, dependencies?: ServeDependencies): Promise<RunningServe>;
+//# sourceMappingURL=serve.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/server/serve.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAA0B,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,cAAc,CAAC;AAItB,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,gEAAgE;AAChE,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,yBAAyB,CAAC;IAC7C,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,oBAAoB,CAAC;IAClC,wBAAwB,EAAE,wBAAwB,CAAC;IACnD,aAAa,EAAE,sBAAsB,CAAC;IACtC,cAAc,EAAE,sBAAsB,CAAC;CACxC;AAYD,4EAA4E;AAC5E,wBAAsB,KAAK,CACzB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,YAAY,EACrB,YAAY,GAAE,iBAAwC,GACrD,OAAO,CAAC,YAAY,CAAC,CAwCvB"}

package/dist/server/serve.js

@@ -0,0 +1,56 @@
+import { prepareLiveRuntime } from "../build/live_runtime.js";
+import { FileSystemGeneratedOutputStore, } from "../build/output_store.js";
+import { FileSystemConfigLoader } from "../config/load.js";
+import { NodeCatalogueServerFactory, } from "./factory.js";
+import { configuredServedReview } from "./review_routes.js";
+import { RepositoryCatalogueChangeClassifier, } from "./component_changes.js";
+import { NodeProcessSupervisorFactory, } from "./supervisor.js";
+import { ChokidarWatcherFactory, } from "./watcher.js";
+import { BackgroundGeneration } from "./demand/generation.js";
+import { serveWatched } from "./serve_watched.js";
+const DEFAULT_CHANGE_CLASSIFIER = new RepositoryCatalogueChangeClassifier();
+const DEFAULT_DEPENDENCIES = {
+    changeClassifier: DEFAULT_CHANGE_CLASSIFIER,
+    configLoader: new FileSystemConfigLoader(),
+    outputStore: new FileSystemGeneratedOutputStore(),
+    processSupervisorFactory: new NodeProcessSupervisorFactory(),
+    serverFactory: new NodeCatalogueServerFactory(),
+    watcherFactory: new ChokidarWatcherFactory(),
+};
+/** Build a last-good snapshot and start watched or deterministic Browse. */
+export async function serve(config, options, dependencies = DEFAULT_DEPENDENCIES) {
+    if (!options.watch) {
+        const runtime = await prepareLiveRuntime(config);
+        config = runtime.config;
+        const base = options.base ?? config.review.base;
+        const background = new BackgroundGeneration(dependencies.outputStore, dependencies.changeClassifier ?? DEFAULT_CHANGE_CLASSIFIER, (compilation, accepted) => {
+            server.completeCatalogue?.(compilation.manifest, accepted.generation);
+            server.publishUpdate({ kind: "evidence" });
+        }, (snapshot) => server.publishUpdate({
+            kind: "evidence",
+            changedRoutes: snapshot?.changedRoutes ?? null,
+            componentChanges: snapshot ?? null,
+            changesStatus: snapshot ? "ready" : "unavailable",
+        }));
+        const server = await dependencies.serverFactory.start(config, {
+            base,
+            changesStatus: "pending",
+            onForeground: (active) => background.foreground(active),
+            manifest: runtime.manifest,
+            componentRuntime: runtime,
+            port: options.port,
+            review: configuredServedReview(config, base),
+        });
+        background.start(runtime, base);
+        return {
+            port: server.port,
+            url: server.url,
+            async close() {
+                await background.close();
+                await server.close();
+            },
+        };
+    }
+    return serveWatched(config, options, dependencies);
+}
+//# sourceMappingURL=serve.js.map