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

package/dist/replication/roster.js

@@ -0,0 +1,115 @@
+/**
+ * Replica membership: the owner's ServerRegistration roster at the gateway.
+ * A receiver imports only from servers that are registered now. It never
+ * accepts on an unknown roster: an unavailable answer is a Wait, not absence.
+ */
+/** The roster could not be read and no fresh answer is cached. Never absence. */
+export class ReplicaRosterUnavailableError extends Error {
+    code = "replica_roster_unavailable";
+    constructor(options) {
+        super("replica_roster_unavailable", options);
+        this.name = "ReplicaRosterUnavailableError";
+    }
+}
+/** The longest a receiver acts on one roster answer. */
+export const REPLICA_ROSTER_MAX_AGE_MS = 5 * 60_000;
+const DEFAULT_MAX_ENTRIES = 1024;
+/**
+ * A bounded roster cache. An answer, including a proven absence, is served
+ * for at most `maxAgeMs` after it was read. After that the next lookup reads
+ * the port again; if that read fails, the lookup throws
+ * ReplicaRosterUnavailableError. An expired answer is never served, so a
+ * deregistration reaches every check within `maxAgeMs` plus the gateway CDN TTL.
+ */
+export function createCachedReplicaRoster(port, options = {}) {
+    const maxAge = options.maxAgeMs ?? REPLICA_ROSTER_MAX_AGE_MS;
+    const maxEntries = options.maxEntries ?? DEFAULT_MAX_ENTRIES;
+    const now = options.now ?? Date.now;
+    if (!(maxAge >= 0) || !(maxEntries >= 1))
+        throw new RangeError("invalid roster cache bounds");
+    const answers = new Map();
+    const reads = new Map();
+    return {
+        async server(address, call) {
+            const key = address.toLowerCase();
+            const cached = answers.get(key);
+            if (cached && now() - cached.at < maxAge)
+                return cached.record;
+            answers.delete(key);
+            let read = reads.get(key);
+            if (!read) {
+                const startedAt = now();
+                read = port
+                    .server(key, call)
+                    .then((record) => {
+                    answers.set(key, { record, at: startedAt });
+                    while (answers.size > maxEntries)
+                        answers.delete(answers.keys().next().value);
+                    return record;
+                })
+                    .finally(() => reads.delete(key));
+                reads.set(key, read);
+            }
+            try {
+                return await read;
+            }
+            catch (error) {
+                throw error instanceof ReplicaRosterUnavailableError
+                    ? error
+                    : new ReplicaRosterUnavailableError({ cause: error });
+            }
+        },
+        invalidate(address) {
+            if (address === undefined)
+                answers.clear();
+            else
+                answers.delete(address.toLowerCase());
+        },
+    };
+}
+const hex = (length) => new RegExp(`^0x[0-9a-fA-F]{${length}}$`);
+/**
+ * GET /v1/servers/:address. Only the gateway's JSON "Server not found" 404
+ * proves absence; any other status or shape is unavailable, so a generic
+ * route or CDN 404 cannot refuse a registered server.
+ */
+export function createGatewayReplicaRoster(input) {
+    const base = input.gatewayUrl.replace(/\/+$/, "");
+    const get = input.fetch ?? fetch;
+    return {
+        async server(address, call) {
+            let response;
+            let body;
+            try {
+                response = await get(`${base}/v1/servers/${address.toLowerCase()}`, {
+                    signal: call?.signal,
+                    headers: { accept: "application/json" },
+                });
+                body = await response.json();
+            }
+            catch (error) {
+                throw new ReplicaRosterUnavailableError({ cause: error });
+            }
+            if (response.status === 404 &&
+                body?.error === "Server not found")
+                return null;
+            const data = body?.data;
+            if (response.status !== 200 ||
+                !data ||
+                typeof data.id !== "string" ||
+                !hex(64).test(data.id) ||
+                typeof data.ownerAddress !== "string" ||
+                !hex(40).test(data.ownerAddress) ||
+                typeof data.serverAddress !== "string" ||
+                data.serverAddress.toLowerCase() !== address.toLowerCase() ||
+                (data.revokedAt !== null && typeof data.revokedAt !== "string"))
+                throw new ReplicaRosterUnavailableError();
+            return {
+                owner: data.ownerAddress,
+                id: data.id,
+                revokedAt: data.revokedAt,
+            };
+        },
+    };
+}
+//# sourceMappingURL=roster.js.map

package/dist/replication/roster.js.map

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

package/dist/replication/schedule.d.ts

@@ -0,0 +1,73 @@
+import type { ReplicaOutcome, ReplicaPhaseOutcome } from "./outcome.js";
+/** Delay before failure attempt n (n >= 1). */
+export type ReplicaBackoff = (attempt: number) => number;
+export declare const defaultReplicaBackoff: ReplicaBackoff;
+/** Durable timing of one work item. Independent of payload and projection. */
+export interface ReplicaWorkState {
+    /** Consecutive failures only. A Wait is a successful read and resets it. */
+    attempts: number;
+    nextEligible: number;
+    waitSince: number | null;
+    /** Highest verified finalized height observed. Never a hint. */
+    checkedBlock: string | null;
+}
+export declare const initialReplicaWorkState: ReplicaWorkState;
+/** Terminal items are never due again on a timer or dependency wake. */
+export declare const REPLICA_TERMINAL: number;
+/** Dependency waits also rescan on this bound, so a lost wake cannot strand work. */
+export declare const REPLICA_WAIT_FALLBACK_MS = 60000;
+/**
+ * Pure transition from a phase verdict to the next durable state.
+ * `hints` is true when the host supplies finalized-head scheduling hints; a
+ * hint can make a parked wait eligible early but never moves a Retry deadline.
+ */
+export declare function settleReplicaWork(previous: ReplicaWorkState, outcome: ReplicaPhaseOutcome, now: number, options?: {
+    backoff?: ReplicaBackoff;
+    hints?: boolean;
+}): {
+    state: ReplicaWorkState;
+    outcome: ReplicaOutcome;
+};
+/**
+ * What the coordinator knows when it selects work: its clock reading and the
+ * optional finalized-head hint. A hint only parks finality waits; it never
+ * makes anything eligible before its durable deadline.
+ */
+export interface ReplicaEligibility {
+    now: number;
+    /** Latest finalized-head hint, or undefined when none is known. */
+    head: bigint | undefined;
+    /** When the coordinator next refreshes the hint. Required with `head`. */
+    hintRefreshAt: number | undefined;
+}
+/** Durable timing of one stored item, as the eligibility policy reads it. */
+export interface ReplicaStoredTiming {
+    /** True for a Wait whose dependency kind is finality. */
+    finalityWait: boolean;
+    nextEligible: number;
+    waitSince: number | null;
+    checkedBlock: string | null;
+}
+/**
+ * When a stored item is next eligible, or undefined when it never is on a
+ * timer (terminal or owner-resolved). The one policy behind both due
+ * selection and nextWake: an item is due iff the result is <= now.
+ *
+ * A finality wait whose verified height is not below the hint is parked: a
+ * re-read cannot succeed until the hint advances (seen at the next hint
+ * refresh) or the wait reaches ten minutes, whichever is first.
+ */
+export declare function replicaEligibleAt(item: ReplicaStoredTiming, eligibility: ReplicaEligibility): number | undefined;
+/**
+ * replicaEligibleAt as an SQL expression over a work table's columns, so
+ * selection filters parked and terminal rows before LIMIT. NULL = never on a
+ * timer. Inputs are numbers and a bigint only; nothing is user text.
+ */
+export declare function replicaEligibleAtSql(eligibility: ReplicaEligibility, columns?: {
+    outcome: string;
+    dependency: string;
+    next: string;
+    since: string;
+    checked: string;
+}): string;
+//# sourceMappingURL=schedule.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schedule.d.ts","sourceRoot":"","sources":["../../src/replication/schedule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExE,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AAEzD,eAAO,MAAM,qBAAqB,EAAE,cACqC,CAAC;AAE1E,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gEAAgE;IAChE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,eAAO,MAAM,uBAAuB,EAAE,gBAKrC,CAAC;AAEF,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,QAA0B,CAAC;AAOxD,qFAAqF;AACrF,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAqB/C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,mBAAmB,EAC5B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,cAAc,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1D;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAkItD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,mBAAmB,EACzB,WAAW,EAAE,kBAAkB,GAC9B,MAAM,GAAG,SAAS,CAgBpB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,kBAAkB,EAC/B,OAAO,GAAE;IACP,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CAOjB,GACA,MAAM,CAWR"}

package/dist/replication/schedule.js

@@ -0,0 +1,182 @@
+export const defaultReplicaBackoff = (attempt) => Math.min(3_600_000, 1000 * 2 ** Math.min(Math.max(attempt, 1) - 1, 12));
+export const initialReplicaWorkState = {
+    attempts: 0,
+    nextEligible: 0,
+    waitSince: null,
+    checkedBlock: null,
+};
+/** Terminal items are never due again on a timer or dependency wake. */
+export const REPLICA_TERMINAL = Number.MAX_SAFE_INTEGER;
+const FINALITY_POLL_MS = 2_000;
+const FINALITY_SLOW_POLL_MS = 30_000;
+const LONG_WAIT_MS = 600_000;
+const FINALITY_BACKOFF_CAP_MS = 16_000;
+const DEPENDENCY_BACKOFF_CAP_MS = 300_000;
+const DEPENDENCY_LONG_POLL_MS = 600_000;
+/** Dependency waits also rescan on this bound, so a lost wake cannot strand work. */
+export const REPLICA_WAIT_FALLBACK_MS = 60_000;
+function growingWaitDelay(age, first, cap, long) {
+    if (age >= LONG_WAIT_MS)
+        return long;
+    let interval = first;
+    let elapsed = 0;
+    while (interval < cap && age >= elapsed + interval) {
+        elapsed += interval;
+        interval = Math.min(cap, interval * 2);
+    }
+    return interval;
+}
+const maxHeight = (a, b) => a === null || BigInt(b) > BigInt(a) ? b : a;
+/**
+ * Pure transition from a phase verdict to the next durable state.
+ * `hints` is true when the host supplies finalized-head scheduling hints; a
+ * hint can make a parked wait eligible early but never moves a Retry deadline.
+ */
+export function settleReplicaWork(previous, outcome, now, options = {}) {
+    const backoff = options.backoff ?? defaultReplicaBackoff;
+    switch (outcome.tag) {
+        case "progress":
+            return {
+                outcome,
+                state: {
+                    attempts: 0,
+                    nextEligible: now,
+                    waitSince: null,
+                    checkedBlock: previous.checkedBlock,
+                },
+            };
+        case "wait": {
+            if (outcome.dependency.kind === "registration" &&
+                outcome.dependency.reason === "own_key_conflict")
+                return {
+                    outcome,
+                    state: {
+                        ...previous,
+                        nextEligible: REPLICA_TERMINAL,
+                        waitSince: previous.waitSince ?? now,
+                    },
+                };
+            const since = previous.waitSince ??
+                (outcome.dependency.kind === "registration_pending"
+                    ? outcome.dependency.since
+                    : now);
+            if (outcome.dependency.kind !== "finality" &&
+                outcome.dependency.kind !== "registration_pending")
+                return {
+                    outcome,
+                    state: {
+                        attempts: 0,
+                        nextEligible: now +
+                            growingWaitDelay(now - since, REPLICA_WAIT_FALLBACK_MS, DEPENDENCY_BACKOFF_CAP_MS, DEPENDENCY_LONG_POLL_MS),
+                        waitSince: since,
+                        checkedBlock: previous.checkedBlock,
+                    },
+                };
+            if (outcome.dependency.kind === "registration_pending" &&
+                outcome.dependency.nextCheckAt !== undefined &&
+                outcome.dependency.nextCheckAt > now)
+                return {
+                    outcome,
+                    state: {
+                        attempts: 0,
+                        nextEligible: outcome.dependency.nextCheckAt,
+                        waitSince: since,
+                        checkedBlock: previous.checkedBlock,
+                    },
+                };
+            const observed = outcome.dependency.checkedBlock;
+            if (observed === undefined)
+                return {
+                    outcome,
+                    state: {
+                        attempts: 0,
+                        nextEligible: now +
+                            growingWaitDelay(now - since, FINALITY_POLL_MS, FINALITY_BACKOFF_CAP_MS, FINALITY_SLOW_POLL_MS),
+                        waitSince: since,
+                        checkedBlock: previous.checkedBlock,
+                    },
+                };
+            const progressed = previous.checkedBlock === null ||
+                BigInt(observed) > BigInt(previous.checkedBlock);
+            const delay = options.hints === true
+                ? !progressed || now - since >= LONG_WAIT_MS
+                    ? FINALITY_SLOW_POLL_MS
+                    : FINALITY_POLL_MS
+                : growingWaitDelay(now - since, FINALITY_POLL_MS, FINALITY_BACKOFF_CAP_MS, FINALITY_SLOW_POLL_MS);
+            return {
+                outcome,
+                state: {
+                    attempts: 0,
+                    nextEligible: now + delay,
+                    waitSince: since,
+                    checkedBlock: maxHeight(previous.checkedBlock, observed),
+                },
+            };
+        }
+        case "retry": {
+            const attempts = Math.min(Number.MAX_SAFE_INTEGER - 1, previous.attempts + 1);
+            const nextEligible = now + backoff(attempts);
+            return {
+                outcome: { ...outcome, nextEligible },
+                state: {
+                    attempts,
+                    nextEligible,
+                    waitSince: null,
+                    checkedBlock: previous.checkedBlock,
+                },
+            };
+        }
+        case "quarantine":
+        case "unsupported":
+            return {
+                outcome,
+                state: { ...previous, nextEligible: REPLICA_TERMINAL },
+            };
+    }
+}
+/**
+ * When a stored item is next eligible, or undefined when it never is on a
+ * timer (terminal or owner-resolved). The one policy behind both due
+ * selection and nextWake: an item is due iff the result is <= now.
+ *
+ * A finality wait whose verified height is not below the hint is parked: a
+ * re-read cannot succeed until the hint advances (seen at the next hint
+ * refresh) or the wait reaches ten minutes, whichever is first.
+ */
+export function replicaEligibleAt(item, eligibility) {
+    if (item.nextEligible >= REPLICA_TERMINAL)
+        return undefined;
+    const { head, hintRefreshAt, now } = eligibility;
+    if (!item.finalityWait ||
+        head === undefined ||
+        item.checkedBlock === null ||
+        item.waitSince === null ||
+        BigInt(item.checkedBlock) < head ||
+        item.waitSince + LONG_WAIT_MS <= now)
+        return item.nextEligible;
+    return Math.max(item.nextEligible, Math.min(item.waitSince + LONG_WAIT_MS, hintRefreshAt ?? now));
+}
+/**
+ * replicaEligibleAt as an SQL expression over a work table's columns, so
+ * selection filters parked and terminal rows before LIMIT. NULL = never on a
+ * timer. Inputs are numbers and a bigint only; nothing is user text.
+ */
+export function replicaEligibleAtSql(eligibility, columns = {
+    outcome: "outcome",
+    dependency: "dependency",
+    next: "next_attempt",
+    since: "wait_since",
+    checked: "checked_block",
+}) {
+    const { outcome, dependency, next, since, checked } = columns;
+    const { head, hintRefreshAt, now } = eligibility;
+    const terminal = `${next} >= ${REPLICA_TERMINAL}`;
+    if (head === undefined)
+        return `(CASE WHEN ${terminal} THEN NULL ELSE ${next} END)`;
+    const h = head.toString();
+    const parked = `(${outcome} = 'wait' AND (${dependency} LIKE 'finality:%' OR ${dependency} LIKE 'registration_pending:%') AND ${checked} IS NOT NULL AND ${since} IS NOT NULL
+    AND (length(${checked}) > ${h.length} OR (length(${checked}) = ${h.length} AND ${checked} >= '${h}'))
+    AND ${since} + ${LONG_WAIT_MS} > ${now})`;
+    return `(CASE WHEN ${terminal} THEN NULL WHEN ${parked} THEN max(${next}, min(${since} + ${LONG_WAIT_MS}, ${hintRefreshAt ?? now})) ELSE ${next} END)`;
+}
+//# sourceMappingURL=schedule.js.map

package/dist/replication/schedule.js.map

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

package/dist/replication/stream.d.ts

@@ -0,0 +1,73 @@
+import { type EnvelopeExpectation, type ReplicaEnvelope } from "./envelope.js";
+import { type ReplicaFragment, type PreparedFragment, type Predecessor } from "./transport.js";
+/** Exact wire length without reading or materializing referenced binary bytes. */
+export declare function replicaPayloadByteLength(envelope: ReplicaEnvelope): number;
+/** Greedy attribution in one pass. A refused op contributes neither bytes nor blobs. */
+export declare function replicaPayloadOperationCrossings(envelope: ReplicaEnvelope, exceeds: (payloadBytes: number) => boolean): number[];
+/** Size the uncompressed stream by groups with equal index/offset digit widths.
+ * At most twice the numeric field width groups, independent of payload length;
+ * no fragment content is allocated, encoded or encrypted during a size probe.
+ */
+export declare function replicaStreamCiphertextByteLength(input: {
+    owner: string;
+    writer: string;
+    batch: string;
+    sequence: number;
+    previous: Predecessor | null;
+    collectedAt: string;
+    digest: string;
+    totalBytes: number;
+    targetChunkBytes: number;
+}, encryptedByteLength: (plaintextBytes: number) => number): number;
+/** Byte-identical to the Node payload, including descriptor order and deduplication. */
+export declare function encodeReplicaPayload(envelope: ReplicaEnvelope, readBlob: (id: string) => AsyncIterable<Uint8Array>): AsyncIterable<Uint8Array>;
+export declare function hashReplicaBytes(factory: () => AsyncIterable<Uint8Array>): Promise<{
+    digest: string;
+    totalBytes: number;
+}>;
+export declare function fragmentReplicaStream(input: {
+    owner: string;
+    writer: string;
+    batch: string;
+    sequence: number;
+    previous: Predecessor | null;
+    collectedAt: string;
+    digest: string;
+    totalBytes: number;
+    bytes: () => AsyncIterable<Uint8Array>;
+    encrypt: (scope: string, bytes: Uint8Array) => Promise<Uint8Array>;
+    maxBlobBytes?: number;
+    targetChunkBytes?: number;
+}): AsyncIterable<PreparedFragment>;
+/** Consume to completion before importing: the final digest is checked at EOF. */
+export declare function assembleReplicaStream(fragments: () => AsyncIterable<ReplicaFragment>, options?: {
+    maxBytes?: number;
+    signal?: AbortSignal;
+}): AsyncIterable<Uint8Array>;
+type BlobMetadata = {
+    blobId: string;
+    sha256: string;
+    sizeBytes: number;
+};
+type PayloadInspection = {
+    envelope: ReplicaEnvelope;
+    blobs: BlobMetadata[];
+};
+export interface ReplicaStreamedLimits {
+    maxOperations: number;
+    maxOperationBytes: number;
+    maxSingleBlobBytes: number;
+    maxBlobTotalBytes: number;
+    maxPayloadBytes: number;
+}
+export declare const DEFAULT_REPLICA_STREAMED_LIMITS: ReplicaStreamedLimits;
+/** `undefined` expectation parses the authenticated envelope without current declaration admission. */
+export declare function inspectReplicaPayload(factory: () => AsyncIterable<Uint8Array>, expected: EnvelopeExpectation | undefined, stage?: (blobId: string, bytes: Uint8Array, blobIndex: number) => void | Promise<void>, options?: {
+    limits?: ReplicaStreamedLimits;
+    signal?: AbortSignal;
+    reserveEnvelopeBytes?: (bytes: number) => void;
+}): Promise<PayloadInspection>;
+/** Inspect first, then consume this same immutable source to completion into staging. */
+export declare function readReplicaPayloadBlob(factory: () => AsyncIterable<Uint8Array>, id: string): AsyncIterable<Uint8Array>;
+export {};
+//# sourceMappingURL=stream.d.ts.map

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

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