@opendatalabs/personal-server-ts-core 1.34.2 → 1.35.1

package/dist/replication/host-driver.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The host side of replication scheduling (host contract §4.4).
+ *
+ * A host owns only *when* to step: one timer at the coordinator's `nextWake`
+ * and explicit triggers (foreground, local write, network back, "Sync now").
+ * Retries, backoff, deadlines and phase order stay in the coordinator. This
+ * driver adds no semantic scheduling; it only turns `nextWake` into one timer,
+ * keeps steps single-flight and drains the running step on stop.
+ *
+ * Browser-safe: Node (`packages/server`) and PS-Lite use the same driver.
+ */
+import { type ProgressReport, type ReplicaBudget } from "./coordinator.js";
+/** Never step more often than this from the timer alone. */
+export declare const REPLICA_WAKE_MIN_MS = 1000;
+/** Idle cadence: also the delay when the coordinator reports no deadline. */
+export declare const REPLICA_WAKE_MAX_MS: number;
+/** Delay after a step that threw (a bug or a closed store, never a verdict). */
+export declare const REPLICA_STEP_ERROR_DELAY_MS = 60000;
+/**
+ * A committed local write steps within this window. Writes inside the window
+ * share its one step, so a connector run steps at most once per window
+ * instead of once per page.
+ */
+export declare const REPLICA_LOCAL_WRITE_DEBOUNCE_MS = 2000;
+/** One finite step. Node's transport worker and PS-Lite's runtime implement it. */
+export interface ReplicationStepper {
+    step(input: {
+        budget: ReplicaBudget;
+        signal: AbortSignal;
+    }): Promise<ProgressReport>;
+    /** Host-observed dependency change, e.g. `mapping:<connection>`. */
+    onDependencyChanged?(key: string): unknown;
+}
+export interface ReplicationTimers {
+    now(): number;
+    setTimeout(run: () => void, ms: number): unknown;
+    clearTimeout(handle: unknown): void;
+}
+export interface ReplicationDriverStatus {
+    state: "stopped" | "running" | "stopping";
+    stepping: boolean;
+    lastStepAt?: number;
+    nextWakeAt?: number;
+    /** Counts from the last finished step; full entries go to `onReport`. */
+    last?: {
+        receipts: number;
+        waits: number;
+        problems: number;
+        quarantines: number;
+        unsupported: number;
+    };
+    lastError?: string;
+}
+export interface ReplicationDriver {
+    /** Idempotent. Steps once now, then follows `nextWake`. */
+    start(): void;
+    /**
+     * Request a step now. Single-flight: while a step runs, this returns that
+     * step's report and runs one more step after it, so a write committed
+     * during the step is not left for the idle timer.
+     */
+    trigger(): Promise<ProgressReport | undefined>;
+    /** Forward a dependency change to the stepper, then trigger. */
+    wake(key: string): void;
+    /**
+     * A local write committed (or may have: a rolled-back write may call it
+     * too). Steps within the debounce window. The window starts at the first
+     * write after the last debounced step and is not extended by later writes,
+     * so continuous writes cannot postpone the step.
+     */
+    localWrite(): void;
+    status(): ReplicationDriverStatus;
+    /**
+     * Stop scheduling, abort the running step and wait at most `graceMs` for
+     * it to settle. Resolves true when nothing is still running.
+     */
+    stop(graceMs: number): Promise<boolean>;
+}
+/** The timer delay for a coordinator `nextWake`, clamped to [1 s, 15 min]. */
+export declare function replicaWakeDelay(nextWake: number | undefined, now: number): number;
+export declare function createReplicationDriver(input: {
+    stepper: ReplicationStepper;
+    budget: ReplicaBudget;
+    /**
+     * Abort a step that runs longer than this. The coordinator settles the
+     * running attempt as a retry; checkpoints already committed stay.
+     */
+    deadlineMs?: number;
+    timers?: ReplicationTimers;
+    onReport?: (report: ProgressReport) => void;
+    onError?: (error: unknown) => void;
+    /** Positive milliseconds; defaults to REPLICA_LOCAL_WRITE_DEBOUNCE_MS. */
+    localWriteDebounceMs?: number;
+}): ReplicationDriver;
+//# sourceMappingURL=host-driver.d.ts.map

package/dist/replication/host-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-driver.d.ts","sourceRoot":"","sources":["../../src/replication/host-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,aAAa,EACnB,MAAM,kBAAkB,CAAC;AAE1B,4DAA4D;AAC5D,eAAO,MAAM,mBAAmB,OAAQ,CAAC;AACzC,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,QAAc,CAAC;AAC/C,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAClD;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,OAAQ,CAAC;AAErD,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,KAAK,EAAE;QACV,MAAM,EAAE,aAAa,CAAC;QACtB,MAAM,EAAE,WAAW,CAAC;KACrB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAC5B,oEAAoE;IACpE,mBAAmB,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,IAAI,MAAM,CAAC;IACd,UAAU,CAAC,GAAG,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACjD,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,IAAI,CAAC,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,KAAK,IAAI,IAAI,CAAC;IACd;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC/C,gEAAgE;IAChE,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;OAKG;IACH,UAAU,IAAI,IAAI,CAAC;IACnB,MAAM,IAAI,uBAAuB,CAAC;IAClC;;;OAGG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC;AASD,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,MAAM,GACV,MAAM,CAMR;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,EAAE,aAAa,CAAC;IACtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,0EAA0E;IAC1E,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,GAAG,iBAAiB,CAsKpB"}

package/dist/replication/host-driver.js

@@ -0,0 +1,202 @@
+/**
+ * The host side of replication scheduling (host contract §4.4).
+ *
+ * A host owns only *when* to step: one timer at the coordinator's `nextWake`
+ * and explicit triggers (foreground, local write, network back, "Sync now").
+ * Retries, backoff, deadlines and phase order stay in the coordinator. This
+ * driver adds no semantic scheduling; it only turns `nextWake` into one timer,
+ * keeps steps single-flight and drains the running step on stop.
+ *
+ * Browser-safe: Node (`packages/server`) and PS-Lite use the same driver.
+ */
+import { validateReplicaStep, } from "./coordinator.js";
+/** Never step more often than this from the timer alone. */
+export const REPLICA_WAKE_MIN_MS = 1_000;
+/** Idle cadence: also the delay when the coordinator reports no deadline. */
+export const REPLICA_WAKE_MAX_MS = 15 * 60_000;
+/** Delay after a step that threw (a bug or a closed store, never a verdict). */
+export const REPLICA_STEP_ERROR_DELAY_MS = 60_000;
+/**
+ * A committed local write steps within this window. Writes inside the window
+ * share its one step, so a connector run steps at most once per window
+ * instead of once per page.
+ */
+export const REPLICA_LOCAL_WRITE_DEBOUNCE_MS = 2_000;
+const defaultTimers = {
+    now: () => Date.now(),
+    setTimeout: (run, ms) => globalThis.setTimeout(run, ms),
+    clearTimeout: (handle) => globalThis.clearTimeout(handle),
+};
+/** The timer delay for a coordinator `nextWake`, clamped to [1 s, 15 min]. */
+export function replicaWakeDelay(nextWake, now) {
+    if (nextWake === undefined)
+        return REPLICA_WAKE_MAX_MS;
+    return Math.min(REPLICA_WAKE_MAX_MS, Math.max(REPLICA_WAKE_MIN_MS, nextWake - now));
+}
+export function createReplicationDriver(input) {
+    const timers = input.timers ?? defaultTimers;
+    // Reject an invalid host budget at construction, not on the first timer.
+    validateReplicaStep({ now: 0, budget: input.budget });
+    if (input.deadlineMs !== undefined &&
+        (!Number.isSafeInteger(input.deadlineMs) || input.deadlineMs < 1))
+        throw new RangeError("invalid replication step deadline");
+    const debounceMs = input.localWriteDebounceMs ?? REPLICA_LOCAL_WRITE_DEBOUNCE_MS;
+    if (!Number.isSafeInteger(debounceMs) || debounceMs < 1)
+        throw new RangeError("invalid replication local-write debounce");
+    /** The pending debounced local-write step, separate from the wake timer. */
+    let writeTimer;
+    let state = "stopped";
+    let timer;
+    let nextWakeAt;
+    let running;
+    let controller;
+    let deadline;
+    let again = false;
+    let lastStepAt;
+    let last;
+    let lastError;
+    /** The wake delay the running step chose; read by `settle`. */
+    let nextDelay = REPLICA_WAKE_MAX_MS;
+    function arm(delay) {
+        if (timer !== undefined)
+            timers.clearTimeout(timer);
+        timer = undefined;
+        nextWakeAt = undefined;
+        if (state !== "running")
+            return;
+        nextWakeAt = timers.now() + delay;
+        timer = timers.setTimeout(() => {
+            timer = undefined;
+            void trigger();
+        }, delay);
+    }
+    async function run() {
+        const step = (controller = new AbortController());
+        deadline =
+            input.deadlineMs === undefined
+                ? undefined
+                : timers.setTimeout(() => step.abort(new DOMException("replication step deadline", "TimeoutError")), input.deadlineMs);
+        nextDelay = REPLICA_WAKE_MAX_MS;
+        try {
+            const report = await input.stepper.step({
+                budget: input.budget,
+                signal: step.signal,
+            });
+            lastStepAt = timers.now();
+            lastError = undefined;
+            last = {
+                receipts: report.receipts.length,
+                waits: report.waits.length,
+                problems: report.problems.length,
+                quarantines: report.quarantines.length,
+                unsupported: report.unsupported.length,
+            };
+            nextDelay = replicaWakeDelay(report.nextWake, timers.now());
+            input.onReport?.(report);
+            return report;
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error.message : String(error);
+            nextDelay = REPLICA_STEP_ERROR_DELAY_MS;
+            input.onError?.(error);
+            return undefined;
+        }
+    }
+    /**
+     * Runs after `trigger` has assigned `running`, so a stepper that throws
+     * before its first await still clears it. Doing this inside `run` would
+     * clear `running` first and then have `trigger` overwrite it with a settled
+     * promise, leaving the driver stalled for good.
+     */
+    function settle() {
+        if (deadline !== undefined)
+            timers.clearTimeout(deadline);
+        deadline = undefined;
+        controller = undefined;
+        running = undefined;
+        if (state === "running") {
+            if (again) {
+                again = false;
+                void trigger();
+            }
+            else
+                arm(nextDelay);
+        }
+    }
+    function trigger() {
+        if (state !== "running")
+            return Promise.resolve(undefined);
+        if (running) {
+            again = true;
+            return running;
+        }
+        if (timer !== undefined)
+            timers.clearTimeout(timer);
+        timer = undefined;
+        nextWakeAt = undefined;
+        const current = run();
+        running = current;
+        void current.then(settle, settle);
+        return current;
+    }
+    return {
+        start() {
+            if (state !== "stopped")
+                return;
+            state = "running";
+            void trigger();
+        },
+        trigger,
+        wake(key) {
+            input.stepper.onDependencyChanged?.(key);
+            void trigger();
+        },
+        localWrite() {
+            if (state !== "running" || writeTimer !== undefined)
+                return;
+            writeTimer = timers.setTimeout(() => {
+                writeTimer = undefined;
+                void trigger();
+            }, debounceMs);
+        },
+        status: () => ({
+            state,
+            stepping: running !== undefined,
+            ...(lastStepAt !== undefined && { lastStepAt }),
+            ...(nextWakeAt !== undefined && { nextWakeAt }),
+            ...(last && { last }),
+            ...(lastError !== undefined && { lastError }),
+        }),
+        async stop(graceMs) {
+            if (!Number.isFinite(graceMs) || graceMs < 0)
+                throw new RangeError("invalid replication stop grace");
+            if (state === "stopped")
+                return running === undefined;
+            state = "stopping";
+            again = false;
+            if (timer !== undefined)
+                timers.clearTimeout(timer);
+            timer = undefined;
+            if (writeTimer !== undefined)
+                timers.clearTimeout(writeTimer);
+            writeTimer = undefined;
+            nextWakeAt = undefined;
+            const current = running;
+            controller?.abort(new DOMException("replication stopped", "AbortError"));
+            let settled = current === undefined;
+            if (current) {
+                let grace;
+                settled = await Promise.race([
+                    current.then(() => true),
+                    new Promise((resolve) => {
+                        grace = timers.setTimeout(() => resolve(false), graceMs);
+                    }),
+                ]);
+                timers.clearTimeout(grace);
+            }
+            state = "stopped";
+            return settled;
+        },
+    };
+}
+//# sourceMappingURL=host-driver.js.map

package/dist/replication/host-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-driver.js","sourceRoot":"","sources":["../../src/replication/host-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,mBAAmB,GAGpB,MAAM,kBAAkB,CAAC;AAE1B,4DAA4D;AAC5D,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AACzC,6EAA6E;AAC7E,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,GAAG,MAAM,CAAC;AAC/C,gFAAgF;AAChF,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC;AAClD;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,KAAK,CAAC;AA4DrD,MAAM,aAAa,GAAsB;IACvC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE;IACrB,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC;IACvD,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE,CACvB,UAAU,CAAC,YAAY,CAAC,MAAuC,CAAC;CACnE,CAAC;AAEF,8EAA8E;AAC9E,MAAM,UAAU,gBAAgB,CAC9B,QAA4B,EAC5B,GAAW;IAEX,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,mBAAmB,CAAC;IACvD,OAAO,IAAI,CAAC,GAAG,CACb,mBAAmB,EACnB,IAAI,CAAC,GAAG,CAAC,mBAAmB,EAAE,QAAQ,GAAG,GAAG,CAAC,CAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAavC;IACC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,aAAa,CAAC;IAC7C,yEAAyE;IACzE,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,IACE,KAAK,CAAC,UAAU,KAAK,SAAS;QAC9B,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;QAEjE,MAAM,IAAI,UAAU,CAAC,mCAAmC,CAAC,CAAC;IAC5D,MAAM,UAAU,GACd,KAAK,CAAC,oBAAoB,IAAI,+BAA+B,CAAC;IAChE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC;QACrD,MAAM,IAAI,UAAU,CAAC,0CAA0C,CAAC,CAAC;IACnE,4EAA4E;IAC5E,IAAI,UAAmB,CAAC;IACxB,IAAI,KAAK,GAAqC,SAAS,CAAC;IACxD,IAAI,KAAc,CAAC;IACnB,IAAI,UAA8B,CAAC;IACnC,IAAI,OAAwD,CAAC;IAC7D,IAAI,UAAuC,CAAC;IAC5C,IAAI,QAAiB,CAAC;IACtB,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,UAA8B,CAAC;IACnC,IAAI,IAAqC,CAAC;IAC1C,IAAI,SAA6B,CAAC;IAClC,+DAA+D;IAC/D,IAAI,SAAS,GAAG,mBAAmB,CAAC;IAEpC,SAAS,GAAG,CAAC,KAAa;QACxB,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACpD,KAAK,GAAG,SAAS,CAAC;QAClB,UAAU,GAAG,SAAS,CAAC;QACvB,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO;QAChC,UAAU,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAClC,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;YAC7B,KAAK,GAAG,SAAS,CAAC;YAClB,KAAK,OAAO,EAAE,CAAC;QACjB,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;IAED,KAAK,UAAU,GAAG;QAChB,MAAM,IAAI,GAAG,CAAC,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC,CAAC;QAClD,QAAQ;YACN,KAAK,CAAC,UAAU,KAAK,SAAS;gBAC5B,CAAC,CAAC,SAAS;gBACX,CAAC,CAAC,MAAM,CAAC,UAAU,CACf,GAAG,EAAE,CACH,IAAI,CAAC,KAAK,CACR,IAAI,YAAY,CAAC,2BAA2B,EAAE,cAAc,CAAC,CAC9D,EACH,KAAK,CAAC,UAAU,CACjB,CAAC;QACR,SAAS,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;gBACtC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,UAAU,GAAG,MAAM,CAAC,GAAG,EAAE,CAAC;YAC1B,SAAS,GAAG,SAAS,CAAC;YACtB,IAAI,GAAG;gBACL,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;gBAChC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;gBAC1B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM;gBAChC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM;gBACtC,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM;aACvC,CAAC;YACF,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;YAC5D,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,SAAS,GAAG,2BAA2B,CAAC;YACxC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,SAAS,MAAM;QACb,IAAI,QAAQ,KAAK,SAAS;YAAE,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC1D,QAAQ,GAAG,SAAS,CAAC;QACrB,UAAU,GAAG,SAAS,CAAC;QACvB,OAAO,GAAG,SAAS,CAAC;QACpB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,KAAK,EAAE,CAAC;gBACV,KAAK,GAAG,KAAK,CAAC;gBACd,KAAK,OAAO,EAAE,CAAC;YACjB,CAAC;;gBAAM,GAAG,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,SAAS,OAAO;QACd,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,GAAG,IAAI,CAAC;YACb,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACpD,KAAK,GAAG,SAAS,CAAC;QAClB,UAAU,GAAG,SAAS,CAAC;QACvB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC;QACtB,OAAO,GAAG,OAAO,CAAC;QAClB,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,OAAO;QACL,KAAK;YACH,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO;YAChC,KAAK,GAAG,SAAS,CAAC;YAClB,KAAK,OAAO,EAAE,CAAC;QACjB,CAAC;QACD,OAAO;QACP,IAAI,CAAC,GAAG;YACN,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC,GAAG,CAAC,CAAC;YACzC,KAAK,OAAO,EAAE,CAAC;QACjB,CAAC;QACD,UAAU;YACR,IAAI,KAAK,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO;YAC5D,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;gBAClC,UAAU,GAAG,SAAS,CAAC;gBACvB,KAAK,OAAO,EAAE,CAAC;YACjB,CAAC,EAAE,UAAU,CAAC,CAAC;QACjB,CAAC;QACD,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;YACb,KAAK;YACL,QAAQ,EAAE,OAAO,KAAK,SAAS;YAC/B,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;YAC/C,GAAG,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,CAAC;YAC/C,GAAG,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;YACrB,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;SAC9C,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,OAAO;YAChB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC;gBAC1C,MAAM,IAAI,UAAU,CAAC,gCAAgC,CAAC,CAAC;YACzD,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,OAAO,KAAK,SAAS,CAAC;YACtD,KAAK,GAAG,UAAU,CAAC;YACnB,KAAK,GAAG,KAAK,CAAC;YACd,IAAI,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YACpD,KAAK,GAAG,SAAS,CAAC;YAClB,IAAI,UAAU,KAAK,SAAS;gBAAE,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;YAC9D,UAAU,GAAG,SAAS,CAAC;YACvB,UAAU,GAAG,SAAS,CAAC;YACvB,MAAM,OAAO,GAAG,OAAO,CAAC;YACxB,UAAU,EAAE,KAAK,CAAC,IAAI,YAAY,CAAC,qBAAqB,EAAE,YAAY,CAAC,CAAC,CAAC;YACzE,IAAI,OAAO,GAAG,OAAO,KAAK,SAAS,CAAC;YACpC,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,KAAc,CAAC;gBACnB,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;oBACxB,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,EAAE;wBAC/B,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;oBAC3D,CAAC,CAAC;iBACH,CAAC,CAAC;gBACH,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;YAC7B,CAAC;YACD,KAAK,GAAG,SAAS,CAAC;YAClB,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/replication/host-ports.d.ts

@@ -0,0 +1,48 @@
+import { type GatewayClient } from "@opendatalabs/vana-sdk/browser";
+import type { DeclarationSnapshot } from "../pdpp/types.js";
+import type { DataPointFeedPort } from "../ports/index.js";
+import type { ServerConfig } from "../schemas/server-config.js";
+import type { ServerSigner } from "../signing/index.js";
+import type { BoundedStorageAdapter } from "../storage/adapters/interface.js";
+import { type ReplicaTransportPort } from "./dpv2.js";
+import { replicaDeclarationContext } from "./host-config.js";
+import { type ReplicaRosterPort } from "./roster.js";
+import type { ReplicaEnvironment } from "./writer-identity.js";
+/** The network side of replication: carrier and roster. */
+export interface ReplicationNetworkPorts {
+    transport: ReplicaTransportPort;
+    roster: ReplicaRosterPort;
+}
+/** DPv2 on Vana storage and the gateway, with finalized RPC evidence. */
+export declare function createReplicationNetworkPorts(input: {
+    config: Pick<ServerConfig, "gateway">;
+    owner: `0x${string}`;
+    masterKey: Uint8Array;
+    storage: BoundedStorageAdapter;
+    gateway: Pick<GatewayClient, "registerDataPoint">;
+    feed: DataPointFeedPort;
+    signer: Pick<ServerSigner, "signAddData">;
+}): ReplicationNetworkPorts;
+/** A host's replication partition, or why replication cannot run this boot. */
+export type ReplicationHostPlan = {
+    state: "ready";
+    /** The owner as the partition compares it (lowercase). */
+    owner: `0x${string}`;
+    environment: ReplicaEnvironment;
+    context: ReturnType<typeof replicaDeclarationContext>;
+} | {
+    state: "blocked";
+    reason: string;
+};
+/**
+ * The partition and declaration bindings for one owner. A chain without a
+ * signed environment, no retained declarations or a stream that cannot be
+ * bound blocks replication: the first baseline freezes the binding set, so
+ * an empty or guessed one would never match a peer.
+ */
+export declare function planReplicationHost(input: {
+    owner: string;
+    chainId: number;
+    declarations: readonly DeclarationSnapshot[];
+}): ReplicationHostPlan;
+//# sourceMappingURL=host-ports.d.ts.map

package/dist/replication/host-ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-ports.d.ts","sourceRoot":"","sources":["../../src/replication/host-ports.ts"],"names":[],"mappings":"AAOA,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAC9E,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,WAAW,CAAC;AAGnB,OAAO,EACL,yBAAyB,EAG1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,2DAA2D;AAC3D,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,oBAAoB,CAAC;IAChC,MAAM,EAAE,iBAAiB,CAAC;CAC3B;AAED,yEAAyE;AACzE,wBAAgB,6BAA6B,CAAC,KAAK,EAAE;IACnD,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;IACtC,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,UAAU,CAAC;IACtB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC;IAClD,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;CAC3C,GAAG,uBAAuB,CAwB1B;AAED,+EAA+E;AAC/E,MAAM,MAAM,mBAAmB,GAC3B;IACE,KAAK,EAAE,OAAO,CAAC;IACf,0DAA0D;IAC1D,KAAK,EAAE,KAAK,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,kBAAkB,CAAC;IAChC,OAAO,EAAE,UAAU,CAAC,OAAO,yBAAyB,CAAC,CAAC;CACvD,GACD;IAAE,KAAK,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAC9C,GAAG,mBAAmB,CAoBtB"}

package/dist/replication/host-ports.js

@@ -0,0 +1,69 @@
+/**
+ * What every replication host builds the same way before its first step:
+ * the partition it joins, the declarations it binds and the network ports
+ * it talks to (host contract §4.1, §4.2). Node and PS-Lite both assemble
+ * replication here and differ only in their storage adapter and persistence.
+ */
+import { createPublicClient, http } from "viem";
+import { getChainConfig, } from "@opendatalabs/vana-sdk/browser";
+import { createDpv2ReplicaTransport, } from "./dpv2.js";
+import { createReplicaEvidenceAdapter } from "./evidence.js";
+import { createReplicaFinalityHints } from "./finality.js";
+import { replicaDeclarationContext, replicaEnvironmentForChain, replicaPartitionOwner, } from "./host-config.js";
+import { createGatewayReplicaRoster, } from "./roster.js";
+/** DPv2 on Vana storage and the gateway, with finalized RPC evidence. */
+export function createReplicationNetworkPorts(input) {
+    const { gateway } = input.config;
+    const chain = getChainConfig(gateway.chainId);
+    if (!chain)
+        throw new Error(`no RPC for chain ${gateway.chainId}`);
+    const rpc = createPublicClient({ chain, transport: http() });
+    return {
+        transport: createDpv2ReplicaTransport({
+            owner: input.owner,
+            masterKey: input.masterKey,
+            storage: input.storage,
+            gateway: input.gateway,
+            feed: input.feed,
+            signer: input.signer,
+            finality: createReplicaFinalityHints({ rpc }),
+            evidence: createReplicaEvidenceAdapter({
+                owner: input.owner,
+                registry: gateway.contracts.dataRegistry,
+                chainId: gateway.chainId,
+                rpc: rpc,
+                gatewayUrl: gateway.url,
+            }),
+        }),
+        roster: createGatewayReplicaRoster({ gatewayUrl: gateway.url }),
+    };
+}
+/**
+ * The partition and declaration bindings for one owner. A chain without a
+ * signed environment, no retained declarations or a stream that cannot be
+ * bound blocks replication: the first baseline freezes the binding set, so
+ * an empty or guessed one would never match a peer.
+ */
+export function planReplicationHost(input) {
+    const environment = replicaEnvironmentForChain(input.chainId);
+    if (!environment)
+        return { state: "blocked", reason: `unsupported_chain:${input.chainId}` };
+    if (input.declarations.length === 0)
+        return { state: "blocked", reason: "no_retained_declarations" };
+    try {
+        const owner = replicaPartitionOwner(input.owner);
+        return {
+            state: "ready",
+            owner,
+            environment,
+            context: replicaDeclarationContext(owner, input.declarations),
+        };
+    }
+    catch (error) {
+        return {
+            state: "blocked",
+            reason: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+//# sourceMappingURL=host-ports.js.map

package/dist/replication/host-ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-ports.js","sourceRoot":"","sources":["../../src/replication/host-ports.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAY,MAAM,MAAM,CAAC;AAC1D,OAAO,EACL,cAAc,GAEf,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EACL,0BAA0B,GAE3B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,4BAA4B,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAAE,0BAA0B,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EACL,yBAAyB,EACzB,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,0BAA0B,GAE3B,MAAM,aAAa,CAAC;AASrB,yEAAyE;AACzE,MAAM,UAAU,6BAA6B,CAAC,KAQ7C;IACC,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC;IACjC,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACnE,MAAM,GAAG,GAAG,kBAAkB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7D,OAAO;QACL,SAAS,EAAE,0BAA0B,CAAC;YACpC,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,QAAQ,EAAE,0BAA0B,CAAC,EAAE,GAAG,EAAE,CAAC;YAC7C,QAAQ,EAAE,4BAA4B,CAAC;gBACrC,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,YAAmB;gBAC/C,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,GAAG,EAAE,GAAgE;gBACrE,UAAU,EAAE,OAAO,CAAC,GAAG;aACxB,CAAC;SACH,CAAC;QACF,MAAM,EAAE,0BAA0B,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC;AAaD;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAInC;IACC,MAAM,WAAW,GAAG,0BAA0B,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9D,IAAI,CAAC,WAAW;QACd,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;IAC5E,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;QACjC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,0BAA0B,EAAE,CAAC;IAClE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAkB,CAAC;QAClE,OAAO;YACL,KAAK,EAAE,OAAO;YACd,KAAK;YACL,WAAW;YACX,OAAO,EAAE,yBAAyB,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC;SAC9D,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC/D,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/replication/identity.d.ts

@@ -0,0 +1,13 @@
+export interface ConnectionIdentity {
+    owner: string;
+    sourceId: string;
+    connectionId: string;
+}
+/** Verified local mapping, supplied by the host; never inferred from source alone. */
+export interface LocalConnectionMapping extends ConnectionIdentity {
+    localInstanceId: string;
+}
+export declare function connectionKey(identity: ConnectionIdentity): string;
+/** Local instance handles carry no replicated grant or token authority. */
+export declare function resolveLocalInstance(identity: ConnectionIdentity, mappings: readonly LocalConnectionMapping[]): string | undefined;
+//# sourceMappingURL=identity.d.ts.map

package/dist/replication/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/replication/identity.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,sFAAsF;AACtF,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAMlE;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,kBAAkB,EAC5B,QAAQ,EAAE,SAAS,sBAAsB,EAAE,GAC1C,MAAM,GAAG,SAAS,CAkBpB"}

package/dist/replication/identity.js

@@ -0,0 +1,22 @@
+export function connectionKey(identity) {
+    return JSON.stringify([
+        identity.owner,
+        identity.sourceId,
+        identity.connectionId,
+    ]);
+}
+/** Local instance handles carry no replicated grant or token authority. */
+export function resolveLocalInstance(identity, mappings) {
+    const matches = mappings.filter((entry) => connectionKey(entry) === connectionKey(identity));
+    const handles = new Set(matches.map((entry) => entry.localInstanceId));
+    if (handles.size > 1)
+        throw new Error("ambiguous local connection mapping");
+    const handle = matches[0]?.localInstanceId;
+    if (handle !== undefined &&
+        mappings.some((entry) => entry.localInstanceId === handle &&
+            connectionKey(entry) !== connectionKey(identity))) {
+        throw new Error("local instance maps independent connections together");
+    }
+    return handle;
+}
+//# sourceMappingURL=identity.js.map

package/dist/replication/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/replication/identity.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,aAAa,CAAC,QAA4B;IACxD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,QAAQ,CAAC,KAAK;QACd,QAAQ,CAAC,QAAQ;QACjB,QAAQ,CAAC,YAAY;KACtB,CAAC,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,oBAAoB,CAClC,QAA4B,EAC5B,QAA2C;IAE3C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAC7B,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,KAAK,aAAa,CAAC,QAAQ,CAAC,CAC5D,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,IAAI,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC;IAC3C,IACE,MAAM,KAAK,SAAS;QACpB,QAAQ,CAAC,IAAI,CACX,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,eAAe,KAAK,MAAM;YAChC,aAAa,CAAC,KAAK,CAAC,KAAK,aAAa,CAAC,QAAQ,CAAC,CACnD,EACD,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/replication/limits.d.ts

@@ -0,0 +1,124 @@
+export declare const REPLICA_MAX_FRAGMENTS = 100000;
+/** vana-storage DEFAULT_MAX_BLOB_SIZE. Compare the actual encrypted request. */
+export declare const REPLICA_MAX_BLOB_BYTES: number;
+/** Per-fragment framing allowance used by the #500 aggregate ciphertext check. */
+export declare const REPLICA_FRAGMENT_OVERHEAD_BYTES = 4096;
+/** Same source-write bounds used by the Node PDPP routes. */
+export declare const REPLICA_SOURCE_MAX_BLOB_BYTES: number;
+export declare const REPLICA_SOURCE_MAX_RECORD_JSON_BYTES: number;
+/** Node capture's persisted batch target and operation count. */
+export declare const REPLICA_BATCH_TARGET_BYTES: number;
+export declare const REPLICA_BATCH_OPERATION_LIMIT = 10000;
+/** Node prepares 4 MiB payload chunks before #500 encryption overhead. */
+export declare const REPLICA_DEFAULT_FRAGMENT_BYTES: number;
+export declare const REPLICA_MAX_OPERATIONS = 10000;
+/** One retained evidence row is created for each manifest fragment. */
+export declare const REPLICA_MAX_EVIDENCE_ROWS = 100000;
+export declare const REPLICA_LIMITS_VERSION = 2;
+/**
+ * Operation metadata can repeat the record key and carries declaration-bound
+ * source/method identifiers. Bound that overhead by a second ingest body plus
+ * the largest retained declaration and fixed replication fields.
+ */
+export declare const REPLICA_MAX_OPERATION_ENVELOPE_BYTES: number;
+/** The payload-level header is fixed apart from its retained declaration IDs. */
+export declare const REPLICA_MAX_PAYLOAD_ENVELOPE_BYTES: number;
+export declare const REPLICA_MAX_SINGLE_OPERATION_BYTES: number;
+/**
+ * The first operation may exceed the target, then later operations may fill
+ * the target; otherwise every operation fits the target and count is binding.
+ */
+export declare const REPLICA_MAX_TOTAL_BYTES: number;
+/** Each streamed operation is bounded by the admitted payload that contains it. */
+export declare const REPLICA_MAX_OPERATION_BYTES: number;
+/** A blob cannot exceed the actual Node source write cap. */
+export declare const REPLICA_MAX_SINGLE_BLOB_BYTES: number;
+/** Base64 blob bytes are part of totalBytes, so their sum cannot exceed it. */
+export declare const REPLICA_MAX_BLOB_TOTAL_BYTES: number;
+/**
+ * The maximum encrypted fragment bytes for a payload of `totalBytes` and
+ * `count` fragments: base64 payload bytes plus #500's per-fragment framing.
+ */
+export declare function replicaFramedBytesBound(totalBytes: number, count: number): number;
+/** Maximum declared encrypted bytes for an honest payload and 100,000 fragments. */
+export declare const REPLICA_MAX_AGGREGATE_CIPHERTEXT_BYTES: number;
+/** Four live representations: ciphertext, plaintext, parsed JSON and decoded bytes. */
+export declare const REPLICA_LIVE_COPY_FACTOR = 4;
+/** The retained JSON string plus its parsed operation tree. */
+export declare const REPLICA_ENVELOPE_LIVE_COPY_FACTOR = 2;
+/** 100 MiB #500 per-object cap × four copies = 400 MiB, below this budget. */
+export declare const REPLICA_DEFAULT_BYTE_BUDGET_BYTES: number;
+export interface ReplicaResourceLimits {
+    maxSourceBlobBytes: number;
+    maxRecordJsonBytes: number;
+    maxManifestCiphertextBytes: number;
+    maxFragmentCiphertextBytes: number;
+    maxAggregateCiphertextBytes: number;
+    maxFragments: number;
+    maxEvidenceRows: number;
+    maxTotalBytes: number;
+    maxOperations: number;
+    maxOperationBytes: number;
+    maxSingleBlobBytes: number;
+    maxBlobTotalBytes: number;
+}
+export declare const REPLICA_DEFAULT_LIMITS: ReplicaResourceLimits;
+export declare function replicaResourceLimits(overrides?: Partial<ReplicaResourceLimits>): ReplicaResourceLimits;
+export interface DeclaredReplicaManifest {
+    totalBytes: number;
+    digest?: string;
+    owner?: string;
+    fragments: readonly {
+        bytes: number;
+    }[];
+}
+export type ResourceRefusal = {
+    kind: "resource_unsupported";
+    limit: string;
+    limitsVersion: number;
+} | {
+    kind: "resource_busy";
+    requestedBytes: number;
+    availableBytes: number;
+};
+/** Reservation ledger shared by concurrently running replication steps. */
+export declare class ReplicaByteBudget {
+    readonly maxBytes: number;
+    private reservedBytes;
+    private readonly reservations;
+    constructor(maxBytes: number);
+    get reserved(): number;
+    reserve(bytes: number, group?: object): (() => void) | ResourceRefusal;
+}
+declare const admissionBrand: unique symbol;
+export interface Admission {
+    readonly [admissionBrand]: true;
+    readonly admissionId: string;
+    readonly repositoryId: string;
+    readonly owner: string;
+    readonly manifestDigest: string;
+    readonly payloadBytes: number;
+    readonly limitsVersion: number;
+    reserveObject(ciphertextBytes: number, reservationGroup?: object): (() => void) | ResourceRefusal;
+    reserveEnvelope(jsonBytes: number, reservationGroup?: object): (() => void) | ResourceRefusal;
+}
+export type AdmissionResult = Admission | ResourceRefusal;
+export declare class ReplicaResourceLimitError extends Error {
+    readonly limit: string;
+    readonly actual: number;
+    readonly maximum: number;
+    readonly code = "replica_resource_limit_exceeded";
+    constructor(limit: string, actual: number, maximum: number);
+}
+export declare class ReplicaResourceBusyError extends Error {
+    readonly code = "resource_busy";
+    constructor();
+}
+/** Check manifest-declared totals and issue an object-reservation capability. */
+export declare function admit(manifest: DeclaredReplicaManifest, budget: ReplicaByteBudget, identity: {
+    repositoryId: string;
+    owner: string;
+    manifestDigest: string;
+}, limits?: ReplicaResourceLimits): AdmissionResult;
+export {};
+//# sourceMappingURL=limits.d.ts.map

package/dist/replication/limits.d.ts.map

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