@loomwork/ui-hydration 0.0.0-stage → 0.1.0

package/dist/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../src/select.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAMjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,kBAAkB,GAC1B,cAAc,GACd,iBAAiB,GACjB,oBAAoB,GACpB,WAAW,GACX,cAAc,GACd,cAAc,CAAC;AAEnB,MAAM,MAAM,aAAa,GACrB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAC5B;IACE,EAAE,EAAE,KAAK,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,2FAA2F;IAC3F,WAAW,CAAC,EAAE,kBAAkB,CAAC;CAClC,CAAC;AAEN,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAc1E"}

package/dist/select.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonPathSelect = jsonPathSelect;
+const plan_1 = require("./plan");
+function jsonPathSelect(value, path) {
+    if (path === "" || path === "$")
+        return { ok: true, value };
+    const out = (0, plan_1.resolvePath)(value, path);
+    if (out === undefined)
+        return {
+            ok: false,
+            failureKind: "selects-nothing",
+            finding: {
+                code: "reshape-failed",
+                severity: "error",
+                message: `JSONPath "${path}" selects nothing from the tool output`,
+            },
+        };
+    return { ok: true, value: out };
+}
+//# sourceMappingURL=select.js.map

package/dist/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../src/select.ts"],"names":[],"mappings":";;AA4CA,wCAcC;AAzDD,iCAAqC;AA2CrC,SAAgB,cAAc,CAAC,KAAc,EAAE,IAAY;IACzD,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC5D,MAAM,GAAG,GAAG,IAAA,kBAAW,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACrC,IAAI,GAAG,KAAK,SAAS;QACnB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,WAAW,EAAE,iBAAiB;YAC9B,OAAO,EAAE;gBACP,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,aAAa,IAAI,wCAAwC;aACnE;SACF,CAAC;IACJ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAClC,CAAC"}

package/dist/shape.d.ts

@@ -0,0 +1,3 @@
+/** The output-shape fingerprint. The planner pins `ProviderSpec.outputShapeHash` with THIS function. */
+export declare function outputShapeHashOf(value: unknown): string;
+//# sourceMappingURL=shape.d.ts.map

package/dist/shape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.d.ts","sourceRoot":"","sources":["../src/shape.ts"],"names":[],"mappings":"AAmCA,wGAAwG;AACxG,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAExD"}

package/dist/shape.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.outputShapeHashOf = outputShapeHashOf;
+const core_1 = require("@loomwork/core");
+const MAX_SHAPE_DEPTH = 1024;
+function shapeAt(value, depth) {
+    if (value === null)
+        return "null";
+    const t = typeof value;
+    if (t === "string" || t === "number" || t === "boolean")
+        return t;
+    if (depth >= MAX_SHAPE_DEPTH) {
+        throw new Error(`shapeOf: depth limit exceeded (${MAX_SHAPE_DEPTH})`);
+    }
+    if (Array.isArray(value)) {
+        const shapes = new Map();
+        for (const v of value) {
+            const s = shapeAt(v, depth + 1);
+            shapes.set(JSON.stringify(s), s);
+        }
+        return [...shapes.entries()].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)).map(([, s]) => s);
+    }
+    if (t === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            if (v !== undefined)
+                out[k] = shapeAt(v, depth + 1);
+        }
+        return out;
+    }
+    return t;
+}
+/** The output-shape fingerprint. The planner pins `ProviderSpec.outputShapeHash` with THIS function. */
+function outputShapeHashOf(value) {
+    return (0, core_1.jsonSchemaHash)(shapeAt(value, 0));
+}
+//# sourceMappingURL=shape.js.map

package/dist/shape.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shape.js","sourceRoot":"","sources":["../src/shape.ts"],"names":[],"mappings":";;AAoCA,8CAEC;AAtCD,yCAAgD;AAQhD,MAAM,eAAe,GAAG,IAAI,CAAC;AAE7B,SAAS,OAAO,CAAC,KAAc,EAAE,KAAa;IAC5C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,MAAM,CAAC,GAAG,OAAO,KAAK,CAAC;IACvB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAClE,IAAI,KAAK,IAAI,eAAe,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kCAAkC,eAAe,GAAG,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;YAChC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IACD,IAAI,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnB,MAAM,GAAG,GAA6B,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAgC,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,KAAK,SAAS;gBAAE,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,wGAAwG;AACxG,SAAgB,iBAAiB,CAAC,KAAc;IAC9C,OAAO,IAAA,qBAAc,EAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/dist/split/client.d.ts

@@ -0,0 +1,132 @@
+import type { Audience, Finding, Priority } from "@loomwork/ui-core";
+import { type LoadParams } from "../params";
+import { type HydrationStore } from "../projection";
+import { type HandleLoadResult, type TimerFn } from "../scheduler";
+export interface HandleRef {
+    readonly handle: string;
+    readonly priority: Priority;
+    /** Argument names a load may override (the sorted union of the provider's `overridable`). */
+    readonly params: readonly string[];
+    /**
+     * Opaque: changes when the provider behind the handle changes. Never the provider, nor an
+     * unkeyed function of it — `InventoryOptions.revisionOf` derives it on the server.
+     */
+    readonly revision: string;
+    /** Set when the handle cannot load (no provider): published as an error, never requested. */
+    readonly finding?: Finding;
+}
+export interface HandleInventory {
+    readonly experienceId: string;
+    readonly versionHash: string;
+    readonly handles: readonly HandleRef[];
+}
+export interface HandleLoadRequest {
+    readonly experienceId: string;
+    readonly versionHash: string;
+    readonly handle: string;
+    /** Only the params this handle declares (the controller filters by `HandleRef.params`). */
+    readonly params: LoadParams;
+}
+/** The app's transport. Each method answers or rejects; a rejection errors the handles it carried. */
+export interface HandleLoader {
+    load(request: HandleLoadRequest, signal: AbortSignal): Promise<HandleLoadResult>;
+    /**
+     * Several requests in ONE round trip, answered in request order — the server's `serveHandles`,
+     * so they share a pass and handles sharing an upstream step share the call. Required: that
+     * sharing is not optional. `signal` aborts once every request in the group has been abandoned.
+     */
+    loadMany(requests: readonly HandleLoadRequest[], signal: AbortSignal): Promise<readonly HandleLoadResult[]>;
+}
+export interface SplitControllerOptions {
+    readonly loader: HandleLoader;
+    readonly store: HydrationStore;
+    /**
+     * The audience this controller draws for. When given it must agree with the store's
+     * `scope.audience` both ways, or the constructor throws `HydrationAudienceMismatchError` (as
+     * `HydrationController` always does). Omitted = the viewer audience: a broadcast store then throws.
+     */
+    readonly audience?: Audience;
+    readonly setTimer?: TimerFn;
+    readonly batchWindowMs?: number;
+    /** Params every load starts from (e.g. `DEFAULT_TIME_RANGE`); `setParams` layers over them. */
+    readonly defaultParams?: LoadParams;
+}
+/**
+ * Client-side hydration across a trust boundary. Same scheduling as `HydrationController` (P0 now,
+ * P1 batched, P2 on `markVisible`, once per question, supersede, dispose) over a `HandleInventory`,
+ * loading through the injected `HandleLoader` — a group the scheduler starts together as ONE
+ * `loadMany` — and publishing to a `HydrationStore`. A question is the handle's opaque revision
+ * plus its params (defaults < global < handle-scoped, filtered to the names the inventory lists
+ * for it). No cache, no clock and no drift handling here: all three are the server's.
+ */
+export declare class SplitHydrationController {
+    private readonly opts;
+    private readonly sched;
+    private current;
+    private globalParams;
+    private readonly scopedParams;
+    /**
+     * Throws `TypeError` for a loader missing `load` or `loadMany`, `RangeError` for
+     * unrepresentable `defaultParams`.
+     */
+    constructor(opts: SplitControllerOptions);
+    /**
+     * Publish a value for a handle that no loader serves (a live transcript this page folds), through
+     * the inventory's gate: only a handle the server LISTED is accepted (a restricted or unknown one is
+     * absent from it, so it is refused), and the value must pass the contract of `kind`, which the caller
+     * names (this side holds no catalogue). Refused = a finding and nothing written. NOTE: the inventory
+     * does not say what KIND a listed handle feeds, so this cannot verify that `kind` is the handle's
+     * widget: that is the page author's code naming its own handle, the viewer gate (listed or not) is
+     * the part that is enforced here.
+     */
+    publishValue(handle: string, value: unknown, options: {
+        readonly state?: "ready" | "pending";
+        readonly kind: string;
+    }): {
+        ok: true;
+    } | {
+        ok: false;
+        finding: Finding;
+    };
+    /** Bind an inventory; a second `load` IS a recompose. */
+    load(inventory: HandleInventory): {
+        findings: Finding[];
+    };
+    /** A new inventory replaces the current one: drop unlisted handles, keep the rest, load new ones. */
+    recompose(next: HandleInventory): {
+        findings: Finding[];
+    };
+    /** The surface reports a lazy (P2) widget entered the viewport. */
+    markVisible(handle: string): void;
+    /**
+     * Replace the global params (no `scope.handle`) or one handle's scoped params, then re-ask
+     * every bound handle whose question changed — only those, so a handle that ended on `error`
+     * with an unchanged question is NOT retried here (`invalidate` retries it). `{}` clears.
+     * Refused, with nothing changed, for params `checkParams` refuses or a reserved handle.
+     */
+    setParams(params: LoadParams, scope?: {
+        readonly handle?: string;
+    }): {
+        findings: Finding[];
+    };
+    /** Ask again (one handle or all): supersedes in-flight loads; a lazy handle stays lazy. */
+    invalidate(handle?: string): {
+        findings: Finding[];
+    };
+    inFlight(): string[];
+    /** Terminal: every in-flight load is aborted and reported, and nothing schedules again. */
+    dispose(): void;
+    private bind;
+    /** Pure: the jobs `inventory` asks for right now, and the handles that cannot load (with why). */
+    private jobs;
+    /**
+     * The scheduler starts a group's jobs in one synchronous turn; each joins the group's queue and
+     * the first schedules the flush, so the whole group leaves as one request.
+     */
+    private enqueue;
+    private flush;
+    private loadOne;
+    /** One `loadMany` for the group; its signal aborts once every member has been abandoned. */
+    private loadGroup;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/split/client.d.ts.map

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

package/dist/split/client.js

@@ -0,0 +1,313 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SplitHydrationController = void 0;
+const browser_1 = require("@loomwork/ui-core/browser");
+const params_1 = require("../params");
+const projection_1 = require("../projection");
+const scheduler_1 = require("../scheduler");
+const shared_1 = require("./shared");
+const isFinding = (f) => f !== null &&
+    typeof f === "object" &&
+    typeof f.code === "string" &&
+    typeof f.message === "string" &&
+    (f.severity === "error" || f.severity === "warn");
+const malformedResult = (handle) => (0, shared_1.refuse)("load-malformed", `the loader answered "${handle}" with something that is not a load result`);
+const failedResult = (handle, e) => (0, shared_1.refuse)("load-failed", `loading "${handle}" failed: ${(0, shared_1.errorMessage)(e)}`);
+/** A loader's answer crossed a boundary: believe only what has the shape of a load result. */
+function asLoadResult(x, handle) {
+    if (x === null || typeof x !== "object")
+        return malformedResult(handle);
+    const r = x;
+    const finding = isFinding(r.finding) ? r.finding : undefined;
+    if (r.state === "ready")
+        return finding === undefined
+            ? { state: "ready", value: r.value }
+            : { state: "ready", value: r.value, finding };
+    // `empty` (loom ADR 0100) carries its finding and never a value: a value beside it is dropped.
+    if ((r.state === "stale" || r.state === "error" || r.state === "empty") && finding !== undefined)
+        return { state: r.state, finding };
+    return malformedResult(handle);
+}
+const PRIORITIES = new Set(["P0", "P1", "P2"]);
+/** The inventory crossed a boundary too: believe only what has the shape of one. */
+function isInventory(x) {
+    if (x === null || typeof x !== "object")
+        return false;
+    const inv = x;
+    return (typeof inv.experienceId === "string" &&
+        typeof inv.versionHash === "string" &&
+        Array.isArray(inv.handles) &&
+        inv.handles.every((r) => {
+            if (r === null || typeof r !== "object")
+                return false;
+            const ref = r;
+            return (typeof ref.handle === "string" &&
+                PRIORITIES.has(ref.priority) &&
+                typeof ref.revision === "string" &&
+                Array.isArray(ref.params) &&
+                ref.params.every((p) => typeof p === "string") &&
+                (ref.finding === undefined || isFinding(ref.finding)));
+        }));
+}
+/**
+ * Client-side hydration across a trust boundary. Same scheduling as `HydrationController` (P0 now,
+ * P1 batched, P2 on `markVisible`, once per question, supersede, dispose) over a `HandleInventory`,
+ * loading through the injected `HandleLoader` — a group the scheduler starts together as ONE
+ * `loadMany` — and publishing to a `HydrationStore`. A question is the handle's opaque revision
+ * plus its params (defaults < global < handle-scoped, filtered to the names the inventory lists
+ * for it). No cache, no clock and no drift handling here: all three are the server's.
+ */
+class SplitHydrationController {
+    opts;
+    sched;
+    current;
+    globalParams = {};
+    scopedParams = new Map();
+    /**
+     * Throws `TypeError` for a loader missing `load` or `loadMany`, `RangeError` for
+     * unrepresentable `defaultParams`.
+     */
+    constructor(opts) {
+        this.opts = opts;
+        const broadcast = (0, browser_1.isBroadcast)(opts.audience);
+        if (broadcast !== (0, browser_1.isBroadcast)(opts.store.scope.audience))
+            throw new projection_1.HydrationAudienceMismatchError(broadcast);
+        const loader = opts.loader;
+        if (typeof loader?.load !== "function" || typeof loader.loadMany !== "function")
+            throw new TypeError("SplitHydrationController: the loader must implement load and loadMany");
+        if (opts.defaultParams !== undefined) {
+            const bad = (0, params_1.checkParams)(opts.defaultParams);
+            if (bad)
+                throw new RangeError(bad.message);
+        }
+        this.sched = new scheduler_1.HandleScheduler(opts.store, {
+            newGroup: () => ({ queue: [] }),
+            run: (job, signal, group) => this.enqueue(job, signal, group),
+        }, opts.setTimer ?? scheduler_1.defaultTimer, opts.batchWindowMs ?? 50);
+    }
+    /**
+     * Publish a value for a handle that no loader serves (a live transcript this page folds), through
+     * the inventory's gate: only a handle the server LISTED is accepted (a restricted or unknown one is
+     * absent from it, so it is refused), and the value must pass the contract of `kind`, which the caller
+     * names (this side holds no catalogue). Refused = a finding and nothing written. NOTE: the inventory
+     * does not say what KIND a listed handle feeds, so this cannot verify that `kind` is the handle's
+     * widget: that is the page author's code naming its own handle, the viewer gate (listed or not) is
+     * the part that is enforced here.
+     */
+    publishValue(handle, value, options) {
+        const listed = !this.sched.isDisposed &&
+            !(0, projection_1.isReservedHandle)(handle) &&
+            this.current?.handles.some((r) => r.handle === handle && r.finding === undefined) === true;
+        if (!listed)
+            return {
+                ok: false,
+                finding: {
+                    code: "publish-unbound",
+                    severity: "error",
+                    message: "the handle is not in the current inventory; the value was refused",
+                },
+            };
+        if (!(0, browser_1.hasKindContract)(options.kind))
+            return {
+                ok: false,
+                finding: {
+                    code: "publish-uncontracted",
+                    severity: "error",
+                    message: "the named kind has no value contract; refused",
+                },
+            };
+        const check = (0, browser_1.checkKindValue)(options.kind, value);
+        if (!check.ok)
+            return { ok: false, finding: check.finding };
+        this.opts.store.setValue(handle, value, { state: options.state ?? "ready" });
+        return { ok: true };
+    }
+    /** Bind an inventory; a second `load` IS a recompose. */
+    load(inventory) {
+        if (this.sched.isDisposed)
+            return { findings: [(0, scheduler_1.disposedFinding)("load")] };
+        if (!isInventory(inventory))
+            return { findings: [invalidInventory()] };
+        if (this.current !== undefined)
+            return this.recompose(inventory);
+        return this.bind(inventory);
+    }
+    /** A new inventory replaces the current one: drop unlisted handles, keep the rest, load new ones. */
+    recompose(next) {
+        if (this.sched.isDisposed)
+            return { findings: [(0, scheduler_1.disposedFinding)("recompose")] };
+        // Before anything is dropped: an inventory we refuse must leave the current one as it was.
+        if (!isInventory(next))
+            return { findings: [invalidInventory()] };
+        this.sched.retain(new Set(next.handles.map((r) => r.handle)));
+        return this.bind(next);
+    }
+    /** The surface reports a lazy (P2) widget entered the viewport. */
+    markVisible(handle) {
+        this.sched.markVisible(handle);
+    }
+    /**
+     * Replace the global params (no `scope.handle`) or one handle's scoped params, then re-ask
+     * every bound handle whose question changed — only those, so a handle that ended on `error`
+     * with an unchanged question is NOT retried here (`invalidate` retries it). `{}` clears.
+     * Refused, with nothing changed, for params `checkParams` refuses or a reserved handle.
+     */
+    setParams(params, scope = {}) {
+        if (this.sched.isDisposed)
+            return { findings: [(0, scheduler_1.disposedFinding)("setParams")] };
+        const bad = (0, params_1.checkParams)(params);
+        if (bad)
+            return { findings: [bad] };
+        if (scope.handle !== undefined && (0, projection_1.isReservedHandle)(scope.handle))
+            return { findings: [(0, shared_1.reservedFinding)(scope.handle)] };
+        const before = this.current === undefined
+            ? new Map()
+            : new Map(this.jobs(this.current).jobs.map((j) => [j.handle, j.fingerprint]));
+        // A copy (own enumerable keys only): a caller mutating its object later changes nothing.
+        const copy = Object.fromEntries(Object.entries(params));
+        if (scope.handle === undefined)
+            this.globalParams = copy;
+        else
+            this.scopedParams.set(scope.handle, copy);
+        if (this.current !== undefined)
+            this.sched.schedule(this.jobs(this.current).jobs.filter((j) => before.get(j.handle) !== j.fingerprint));
+        return { findings: [] };
+    }
+    /** Ask again (one handle or all): supersedes in-flight loads; a lazy handle stays lazy. */
+    invalidate(handle) {
+        if (this.sched.isDisposed)
+            return { findings: [(0, scheduler_1.disposedFinding)("invalidate")] };
+        if (this.current === undefined)
+            return { findings: [] };
+        const { jobs } = this.jobs(this.current);
+        this.sched.reload(handle === undefined ? jobs : jobs.filter((j) => j.handle === handle));
+        return { findings: [] };
+    }
+    inFlight() {
+        return this.sched.inFlight();
+    }
+    /** Terminal: every in-flight load is aborted and reported, and nothing schedules again. */
+    dispose() {
+        this.sched.dispose();
+        this.current = undefined;
+        this.globalParams = {};
+        this.scopedParams.clear();
+    }
+    bind(inventory) {
+        this.current = inventory;
+        const listed = new Set(inventory.handles.map((r) => r.handle));
+        for (const handle of [...this.scopedParams.keys()])
+            if (!listed.has(handle))
+                this.scopedParams.delete(handle);
+        const { jobs, findings, missing } = this.jobs(inventory);
+        for (const m of missing)
+            this.opts.store.setStatus(m.handle, { state: "error", finding: m.finding });
+        this.sched.schedule(jobs);
+        return { findings };
+    }
+    /** Pure: the jobs `inventory` asks for right now, and the handles that cannot load (with why). */
+    jobs(inventory) {
+        const jobs = [];
+        const findings = [];
+        const missing = [];
+        for (const ref of inventory.handles) {
+            // The inventory crossed a boundary: a reserved handle is refused here too.
+            if ((0, projection_1.isReservedHandle)(ref.handle)) {
+                findings.push((0, shared_1.reservedFinding)(ref.handle));
+                continue;
+            }
+            if (ref.finding !== undefined) {
+                findings.push(ref.finding);
+                missing.push({ handle: ref.handle, finding: ref.finding });
+                continue;
+            }
+            const params = (0, params_1.pickParams)({ ...this.opts.defaultParams, ...this.globalParams, ...this.scopedParams.get(ref.handle) }, ref.params);
+            jobs.push({
+                handle: ref.handle,
+                priority: ref.priority,
+                params,
+                experienceId: inventory.experienceId,
+                versionHash: inventory.versionHash,
+                fingerprint: `${ref.revision}${scheduler_1.KEY_SEP}${(0, params_1.paramsKey)(params)}`,
+            });
+        }
+        return { jobs, findings, missing };
+    }
+    /**
+     * The scheduler starts a group's jobs in one synchronous turn; each joins the group's queue and
+     * the first schedules the flush, so the whole group leaves as one request.
+     */
+    enqueue(job, signal, group) {
+        return new Promise((resolve) => {
+            group.queue.push({ job, signal, resolve });
+            if (group.queue.length === 1)
+                queueMicrotask(() => this.flush(group));
+        });
+    }
+    flush(group) {
+        const queued = group.queue;
+        group.queue = [];
+        // Abandoned before it left (superseded, dropped, disposed): its result would be dropped anyway.
+        const live = [];
+        for (const q of queued) {
+            if (q.signal.aborted)
+                q.resolve((0, shared_1.refuse)("aborted", `the load of "${q.job.handle}" was abandoned`));
+            else
+                live.push(q);
+        }
+        if (live.length > 1) {
+            this.loadGroup(live).then((results) => {
+                live.forEach((q, i) => q.resolve(results[i] ?? malformedResult(q.job.handle)));
+            });
+            return;
+        }
+        for (const q of live)
+            this.loadOne(q).then(q.resolve);
+    }
+    async loadOne(q) {
+        try {
+            return asLoadResult(await this.opts.loader.load(request(q.job), q.signal), q.job.handle);
+        }
+        catch (e) {
+            return failedResult(q.job.handle, e);
+        }
+    }
+    /** One `loadMany` for the group; its signal aborts once every member has been abandoned. */
+    async loadGroup(live) {
+        const ac = new AbortController();
+        let remaining = live.length;
+        const onAbort = () => {
+            remaining -= 1;
+            if (remaining === 0)
+                ac.abort();
+        };
+        for (const q of live)
+            q.signal.addEventListener("abort", onAbort, { once: true });
+        try {
+            const answer = await this.opts.loader.loadMany(live.map((q) => request(q.job)), ac.signal);
+            if (!Array.isArray(answer) || answer.length !== live.length)
+                return live.map((q) => malformedResult(q.job.handle));
+            return live.map((q, i) => asLoadResult(answer[i], q.job.handle));
+        }
+        catch (e) {
+            return live.map((q) => failedResult(q.job.handle, e));
+        }
+        finally {
+            for (const q of live)
+                q.signal.removeEventListener("abort", onAbort);
+        }
+    }
+}
+exports.SplitHydrationController = SplitHydrationController;
+const invalidInventory = () => ({
+    code: "invalid-inventory",
+    severity: "error",
+    message: "not a handle inventory: expected an experienceId, a versionHash and well-formed handle refs",
+});
+const request = (job) => ({
+    experienceId: job.experienceId,
+    versionHash: job.versionHash,
+    handle: job.handle,
+    params: job.params,
+});
+//# sourceMappingURL=client.js.map

package/dist/split/client.js.map

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

package/dist/split/index.d.ts

@@ -0,0 +1,5 @@
+export { DEFAULT_MAX_BATCH, DEFAULT_MAX_CONCURRENT_CALLS, createServeSurface, handleInventory, publicFinding, serveHandle, serveHandles, } from "./server";
+export type { InventoryOptions, RevisionFn, ServeOptions, ServeSurface } from "./server";
+export { SplitHydrationController } from "./client";
+export type { HandleInventory, HandleLoadRequest, HandleLoader, HandleRef, SplitControllerOptions, } from "./client";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/split/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,kBAAkB,EAClB,eAAe,EACf,aAAa,EACb,WAAW,EACX,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AACpD,YAAY,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,sBAAsB,GACvB,MAAM,UAAU,CAAC"}

package/dist/split/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SplitHydrationController = exports.serveHandles = exports.serveHandle = exports.publicFinding = exports.handleInventory = exports.createServeSurface = exports.DEFAULT_MAX_CONCURRENT_CALLS = exports.DEFAULT_MAX_BATCH = void 0;
+var server_1 = require("./server");
+Object.defineProperty(exports, "DEFAULT_MAX_BATCH", { enumerable: true, get: function () { return server_1.DEFAULT_MAX_BATCH; } });
+Object.defineProperty(exports, "DEFAULT_MAX_CONCURRENT_CALLS", { enumerable: true, get: function () { return server_1.DEFAULT_MAX_CONCURRENT_CALLS; } });
+Object.defineProperty(exports, "createServeSurface", { enumerable: true, get: function () { return server_1.createServeSurface; } });
+Object.defineProperty(exports, "handleInventory", { enumerable: true, get: function () { return server_1.handleInventory; } });
+Object.defineProperty(exports, "publicFinding", { enumerable: true, get: function () { return server_1.publicFinding; } });
+Object.defineProperty(exports, "serveHandle", { enumerable: true, get: function () { return server_1.serveHandle; } });
+Object.defineProperty(exports, "serveHandles", { enumerable: true, get: function () { return server_1.serveHandles; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "SplitHydrationController", { enumerable: true, get: function () { return client_1.SplitHydrationController; } });
+//# sourceMappingURL=index.js.map

package/dist/split/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/split/index.ts"],"names":[],"mappings":";;;AAAA,mCAQkB;AAPhB,2GAAA,iBAAiB,OAAA;AACjB,sHAAA,4BAA4B,OAAA;AAC5B,4GAAA,kBAAkB,OAAA;AAClB,yGAAA,eAAe,OAAA;AACf,uGAAA,aAAa,OAAA;AACb,qGAAA,WAAW,OAAA;AACX,sGAAA,YAAY,OAAA;AAGd,mCAAoD;AAA3C,kHAAA,wBAAwB,OAAA"}