@jungjaehoon/mama-os 0.53.0 → 0.57.0

package/dist/replay/replay-cursor.js

@@ -0,0 +1,189 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReplayCursor = createReplayCursor;
+exports.readReplayCursor = readReplayCursor;
+exports.assertReplayCursorIdentity = assertReplayCursorIdentity;
+exports.writeReplayCursor = writeReplayCursor;
+exports.markReplayDelta = markReplayDelta;
+exports.advanceReplayCursor = advanceReplayCursor;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const replay_source_catalog_js_1 = require("./replay-source-catalog.js");
+function assertEpochMs(value, field) {
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0) {
+        throw new Error(`${field} must be a nonnegative epoch-millisecond integer`);
+    }
+}
+function assertIdentity(identity) {
+    if (identity.runId.trim() === '' || identity.policyFingerprint.trim() === '') {
+        throw new Error('Replay cursor identity is required');
+    }
+    assertEpochMs(identity.fromMs, 'fromMs');
+    assertEpochMs(identity.untilMs, 'untilMs');
+    if (identity.untilMs < identity.fromMs)
+        throw new Error('untilMs must not precede fromMs');
+    const windowSizeMs = identity.windowSizeMs ?? replay_source_catalog_js_1.REPLAY_WINDOW_SIZE_MS;
+    if (!Number.isSafeInteger(windowSizeMs) || windowSizeMs < 1) {
+        throw new Error('windowSizeMs must be a positive safe integer');
+    }
+}
+function nextWindow(identity, startMs) {
+    return {
+        startMs,
+        endMs: Math.min(startMs + (identity.windowSizeMs ?? replay_source_catalog_js_1.REPLAY_WINDOW_SIZE_MS), identity.untilMs),
+        deltas: {},
+    };
+}
+function createReplayCursor(identity) {
+    assertIdentity(identity);
+    return {
+        version: 1,
+        runId: identity.runId,
+        policyFingerprint: identity.policyFingerprint,
+        fromMs: identity.fromMs,
+        untilMs: identity.untilMs,
+        windowSizeMs: identity.windowSizeMs ?? replay_source_catalog_js_1.REPLAY_WINDOW_SIZE_MS,
+        nextWindowStartMs: identity.fromMs,
+        currentWindow: nextWindow(identity, identity.fromMs),
+    };
+}
+function parseStatus(value, field) {
+    if (value !== 'accepted' && value !== 'settled')
+        throw new Error(`${field} has an invalid status`);
+    return value;
+}
+function normalizeCursor(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error('Replay cursor must contain an object');
+    }
+    const row = value;
+    if (row.version !== 1)
+        throw new Error('Replay cursor version is unsupported');
+    if (typeof row.runId !== 'string' || row.runId.trim() === '')
+        throw new Error('Replay cursor runId is invalid');
+    if (typeof row.policyFingerprint !== 'string' || row.policyFingerprint.trim() === '') {
+        throw new Error('Replay cursor policyFingerprint is invalid');
+    }
+    assertEpochMs(row.fromMs, 'cursor.fromMs');
+    assertEpochMs(row.untilMs, 'cursor.untilMs');
+    assertEpochMs(row.nextWindowStartMs, 'cursor.nextWindowStartMs');
+    if (row.untilMs < row.fromMs ||
+        row.nextWindowStartMs < row.fromMs ||
+        row.nextWindowStartMs > row.untilMs) {
+        throw new Error('Replay cursor range is invalid');
+    }
+    if (!Number.isSafeInteger(row.windowSizeMs) || Number(row.windowSizeMs) < 1) {
+        throw new Error('Replay cursor windowSizeMs is invalid');
+    }
+    const windowSizeMs = Number(row.windowSizeMs);
+    const current = row.currentWindow;
+    if (!current || typeof current !== 'object' || Array.isArray(current)) {
+        throw new Error('Replay cursor currentWindow is invalid');
+    }
+    const currentRow = current;
+    assertEpochMs(currentRow.startMs, 'cursor.currentWindow.startMs');
+    assertEpochMs(currentRow.endMs, 'cursor.currentWindow.endMs');
+    if (currentRow.endMs < currentRow.startMs || currentRow.startMs !== row.nextWindowStartMs) {
+        throw new Error('Replay cursor current window does not match nextWindowStartMs');
+    }
+    if (!currentRow.deltas ||
+        typeof currentRow.deltas !== 'object' ||
+        Array.isArray(currentRow.deltas)) {
+        throw new Error('Replay cursor deltas are invalid');
+    }
+    const deltas = {};
+    for (const [id, status] of Object.entries(currentRow.deltas)) {
+        if (id.trim() === '')
+            throw new Error('Replay cursor contains a blank stimulus id');
+        deltas[id] = parseStatus(status, `Replay cursor delta ${id}`);
+    }
+    return {
+        version: 1,
+        runId: row.runId,
+        policyFingerprint: row.policyFingerprint,
+        fromMs: row.fromMs,
+        untilMs: row.untilMs,
+        windowSizeMs,
+        nextWindowStartMs: row.nextWindowStartMs,
+        currentWindow: {
+            startMs: currentRow.startMs,
+            endMs: currentRow.endMs,
+            deltas,
+        },
+    };
+}
+function readReplayCursor(path) {
+    if (!(0, node_fs_1.existsSync)(path))
+        return null;
+    let parsed;
+    try {
+        parsed = JSON.parse((0, node_fs_1.readFileSync)(path, 'utf8'));
+    }
+    catch (error) {
+        throw new Error(`Replay cursor is unreadable: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return normalizeCursor(parsed);
+}
+function assertReplayCursorIdentity(cursor, identity) {
+    assertIdentity(identity);
+    const windowSizeMs = identity.windowSizeMs ?? replay_source_catalog_js_1.REPLAY_WINDOW_SIZE_MS;
+    if (cursor.runId !== identity.runId ||
+        cursor.policyFingerprint !== identity.policyFingerprint ||
+        cursor.fromMs !== identity.fromMs ||
+        cursor.untilMs !== identity.untilMs ||
+        cursor.windowSizeMs !== windowSizeMs) {
+        throw new Error('Replay cursor identity does not match the requested run');
+    }
+}
+/** Write a cursor with flush-and-rename so a crash leaves the previous cursor intact. */
+function writeReplayCursor(path, cursor) {
+    const normalized = normalizeCursor(cursor);
+    (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+    const temporaryPath = `${path}.${process.pid}.${Date.now()}.tmp`;
+    let descriptor;
+    try {
+        descriptor = (0, node_fs_1.openSync)(temporaryPath, 'wx', 0o600);
+        (0, node_fs_1.writeFileSync)(descriptor, `${JSON.stringify(normalized, null, 2)}\n`, 'utf8');
+        (0, node_fs_1.fsyncSync)(descriptor);
+        (0, node_fs_1.closeSync)(descriptor);
+        descriptor = undefined;
+        (0, node_fs_1.renameSync)(temporaryPath, path);
+    }
+    catch (error) {
+        if (descriptor !== undefined)
+            (0, node_fs_1.closeSync)(descriptor);
+        (0, node_fs_1.rmSync)(temporaryPath, { force: true });
+        throw error;
+    }
+}
+function markReplayDelta(cursor, stimulusId, status) {
+    if (stimulusId.trim() === '')
+        throw new Error('Replay stimulus id is required');
+    const existing = cursor.currentWindow.deltas[stimulusId];
+    if (existing === 'settled' && status === 'accepted') {
+        throw new Error(`Replay delta ${stimulusId} cannot return from settled to accepted`);
+    }
+    return {
+        ...cursor,
+        currentWindow: {
+            ...cursor.currentWindow,
+            deltas: { ...cursor.currentWindow.deltas, [stimulusId]: status },
+        },
+    };
+}
+function advanceReplayCursor(cursor) {
+    if (Object.values(cursor.currentWindow.deltas).some((status) => status !== 'settled')) {
+        throw new Error('Replay cursor cannot advance before every delta settles');
+    }
+    const nextWindowStartMs = cursor.currentWindow.endMs;
+    return {
+        ...cursor,
+        nextWindowStartMs,
+        currentWindow: {
+            startMs: nextWindowStartMs,
+            endMs: Math.min(nextWindowStartMs + cursor.windowSizeMs, cursor.untilMs),
+            deltas: {},
+        },
+    };
+}
+//# sourceMappingURL=replay-cursor.js.map

package/dist/replay/replay-cursor.js.map

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

package/dist/replay/replay-feeder.d.ts

@@ -0,0 +1,55 @@
+import type { Mailbox } from '@jungjaehoon/mama-core/runtime/mailbox';
+import { type StimulusIntake } from '../runtime/stimulus-delivery.js';
+import { ReplaySourceCatalog, type ReplayLedgerDigestItem, type ReplayWindow } from './replay-source-catalog.js';
+import type { WindowQueue } from './window-queue.js';
+import type { SourceDelta } from '../connectors/framework/polling-scheduler.js';
+export interface ReplayFeederOptions {
+    catalog: ReplaySourceCatalog;
+    intake: Pick<StimulusIntake, 'acceptSourceDelta'>;
+    mailbox: Pick<Mailbox, 'readInput'>;
+    principalId: string;
+    runId: string;
+    policyFingerprint: string;
+    fromMs: number;
+    untilMs: number;
+    cursorPath: string;
+    ledgerPath: string;
+    readLedgerDigest?: (asOfMs?: number) => readonly ReplayLedgerDigestItem[];
+    buildQueue?: (window: ReplayWindow, ledgerDigest: readonly ReplayLedgerDigestItem[] | undefined) => Promise<WindowQueue>;
+    settlePollMs?: number;
+    sleep?: (milliseconds: number) => Promise<void>;
+}
+export interface ReplayPreflight {
+    windows: readonly ReplayWindow[];
+    deltas: readonly SourceDelta[];
+    oversizedDeltas: number;
+}
+export interface ReplayFeederResult {
+    runId: string;
+    windows: number;
+    deltas: number;
+    settled: number;
+    nextWindowStartMs: number;
+}
+export declare class ReplayFeeder {
+    private readonly options;
+    private readonly settlePollMs;
+    private readonly sleep;
+    constructor(options: ReplayFeederOptions);
+    private existingCursor;
+    private identity;
+    private resolvedRunId;
+    preflight(): ReplayPreflight;
+    private row;
+    private assertNotLost;
+    /**
+     * Wait until the delivery settles. A model turn takes minutes, so there is no feeder-side
+     * deadline: the turn has its own configured timeout, a pre-dispatch failure returns the row
+     * to the mailbox's retry (dead after its attempts), and a post-dispatch failure is uncertain.
+     * Dead and uncertain stop the replay loudly in assertNotLost.
+     */
+    private waitForSettled;
+    private deliverDelta;
+    run(): Promise<ReplayFeederResult>;
+}
+//# sourceMappingURL=replay-feeder.d.ts.map

package/dist/replay/replay-feeder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-feeder.d.ts","sourceRoot":"","sources":["../../src/replay/replay-feeder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAc,MAAM,wCAAwC,CAAC;AAClF,OAAO,EAAyB,KAAK,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAU7F,OAAO,EAGL,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,YAAY,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAEhF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;IAClD,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,SAAS,sBAAsB,EAAE,CAAC;IAC1E,UAAU,CAAC,EAAE,CACX,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,SAAS,sBAAsB,EAAE,GAAG,SAAS,KACxD,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;IACjC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAC/B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AA6BD,qBAAa,YAAY;IAIX,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;gBAEnC,OAAO,EAAE,mBAAmB;IAiBzD,OAAO,CAAC,cAAc;IAItB,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,aAAa;IAIrB,SAAS,IAAI,eAAe;IAmB5B,OAAO,CAAC,GAAG;IAMX,OAAO,CAAC,aAAa;IASrB;;;;;OAKG;YACW,cAAc;YASd,YAAY;IA+DpB,GAAG,IAAI,OAAO,CAAC,kBAAkB,CAAC;CA0CzC"}

package/dist/replay/replay-feeder.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReplayFeeder = void 0;
+const stimulus_delivery_js_1 = require("../runtime/stimulus-delivery.js");
+const replay_cursor_js_1 = require("./replay-cursor.js");
+const replay_source_catalog_js_1 = require("./replay-source-catalog.js");
+const replay_ledger_js_1 = require("./replay-ledger.js");
+function assertMs(value, field) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error(`${field} is invalid`);
+}
+function sourceTimes(delta) {
+    const values = delta.refs.map((ref) => Date.parse(ref.sourceAt));
+    if (values.some((value) => !Number.isSafeInteger(value) || value < 0)) {
+        throw new Error(`Replay delta ${delta.channel} has an invalid source time`);
+    }
+    return values;
+}
+function deltaLedgerFields(delta) {
+    if (delta.refs.length === 0) {
+        if (delta.replay === undefined)
+            throw new Error('Replay delta must contain a replay window');
+        return {
+            firstSourceAtMs: delta.replay.windowStartMs,
+            lastSourceAtMs: delta.replay.windowStartMs,
+        };
+    }
+    const times = sourceTimes(delta);
+    return { firstSourceAtMs: Math.min(...times), lastSourceAtMs: Math.max(...times) };
+}
+class ReplayFeeder {
+    options;
+    settlePollMs;
+    sleep;
+    constructor(options) {
+        this.options = options;
+        if (options.principalId.trim() === '')
+            throw new Error('Replay principalId is required');
+        if (options.runId.trim() === '')
+            throw new Error('Replay runId is required');
+        if (options.policyFingerprint.trim() === '')
+            throw new Error('Replay policyFingerprint is required');
+        assertMs(options.fromMs, 'fromMs');
+        assertMs(options.untilMs, 'untilMs');
+        if (options.untilMs < options.fromMs)
+            throw new Error('untilMs must not precede fromMs');
+        this.settlePollMs = options.settlePollMs ?? 250;
+        if (!Number.isSafeInteger(this.settlePollMs) || this.settlePollMs < 0) {
+            throw new Error('settlePollMs must be a nonnegative safe integer');
+        }
+        this.sleep =
+            options.sleep ??
+                ((milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds)));
+    }
+    existingCursor() {
+        return (0, replay_cursor_js_1.readReplayCursor)(this.options.cursorPath);
+    }
+    identity(runId) {
+        return {
+            runId,
+            policyFingerprint: this.options.policyFingerprint,
+            fromMs: this.options.fromMs,
+            untilMs: this.options.untilMs,
+            windowSizeMs: replay_source_catalog_js_1.REPLAY_WINDOW_SIZE_MS,
+        };
+    }
+    resolvedRunId(existing) {
+        return existing?.runId ?? this.options.runId;
+    }
+    preflight() {
+        const existing = this.existingCursor();
+        const runId = this.resolvedRunId(existing);
+        if (existing)
+            (0, replay_cursor_js_1.assertReplayCursorIdentity)(existing, this.identity(runId));
+        const windows = this.options.catalog.windows(this.options.fromMs, this.options.untilMs);
+        const deltas = windows.flatMap((window) => this.options.catalog.deltasForWindow(runId, window.startMs, window.endMs));
+        const oversizedDeltas = deltas.filter((delta) => delta.refs.length > replay_source_catalog_js_1.REPLAY_REFERENCE_CAP).length;
+        if (oversizedDeltas > 0) {
+            throw new Error(`Replay preflight failed: ${String(oversizedDeltas)} delta(s) exceed ${String(replay_source_catalog_js_1.REPLAY_REFERENCE_CAP)} refs`);
+        }
+        return Object.freeze({ windows, deltas: Object.freeze(deltas), oversizedDeltas });
+    }
+    row(stimulusId) {
+        const found = this.options.mailbox.readInput(stimulusId, this.options.principalId);
+        if (!found)
+            throw new Error(`Replay stimulus ${stimulusId} is missing from the mailbox`);
+        return found;
+    }
+    assertNotLost(stimulusId, row) {
+        if (row.status === 'dead') {
+            throw new Error(`Replay stimulus ${stimulusId} is dead; replay stopped`);
+        }
+        if (row.nativeDelivery?.state === 'uncertain') {
+            throw new Error(`Replay stimulus ${stimulusId} is uncertain; replay stopped`);
+        }
+    }
+    /**
+     * Wait until the delivery settles. A model turn takes minutes, so there is no feeder-side
+     * deadline: the turn has its own configured timeout, a pre-dispatch failure returns the row
+     * to the mailbox's retry (dead after its attempts), and a post-dispatch failure is uncertain.
+     * Dead and uncertain stop the replay loudly in assertNotLost.
+     */
+    async waitForSettled(stimulusId) {
+        for (;;) {
+            const row = this.row(stimulusId);
+            this.assertNotLost(stimulusId, row);
+            if (row.status === 'acked' && row.nativeDelivery?.state === 'settled')
+                return;
+            await this.sleep(this.settlePollMs);
+        }
+    }
+    async deliverDelta(cursor, ledger, window, delta) {
+        const stimulusId = (0, stimulus_delivery_js_1.sourceDeltaStimulusId)(delta);
+        const status = cursor.currentWindow.deltas[stimulusId];
+        if (status === 'settled')
+            return cursor;
+        const source = deltaLedgerFields(delta);
+        try {
+            if (status === undefined) {
+                const existing = this.options.mailbox.readInput(stimulusId, this.options.principalId);
+                // The receipt's inputId is the mailbox row number, not the stimulus id; admission is
+                // proven by reading the row back under the deterministic stimulus id below.
+                if (!existing)
+                    this.options.intake.acceptSourceDelta(delta);
+                const admitted = this.row(stimulusId);
+                this.assertNotLost(stimulusId, admitted);
+                cursor = (0, replay_cursor_js_1.markReplayDelta)(cursor, stimulusId, 'accepted');
+                (0, replay_cursor_js_1.writeReplayCursor)(this.options.cursorPath, cursor);
+                ledger.append({
+                    windowStartMs: window.startMs,
+                    windowEndMs: window.endMs,
+                    stimulusId,
+                    origin: delta.collector,
+                    channelKey: delta.channel,
+                    refCount: delta.refs.length,
+                    ...source,
+                    status: 'accepted',
+                });
+            }
+            await this.waitForSettled(stimulusId);
+            cursor = (0, replay_cursor_js_1.markReplayDelta)(cursor, stimulusId, 'settled');
+            (0, replay_cursor_js_1.writeReplayCursor)(this.options.cursorPath, cursor);
+            ledger.append({
+                windowStartMs: window.startMs,
+                windowEndMs: window.endMs,
+                stimulusId,
+                origin: delta.collector,
+                channelKey: delta.channel,
+                refCount: delta.refs.length,
+                ...source,
+                status: 'settled',
+            });
+            return cursor;
+        }
+        catch (error) {
+            const row = this.options.mailbox.readInput(stimulusId, this.options.principalId);
+            if (row?.status === 'dead' || row?.nativeDelivery?.state === 'uncertain') {
+                ledger.append({
+                    windowStartMs: window.startMs,
+                    windowEndMs: window.endMs,
+                    stimulusId,
+                    origin: delta.collector,
+                    channelKey: delta.channel,
+                    refCount: delta.refs.length,
+                    ...source,
+                    status: row.nativeDelivery?.state === 'uncertain' ? 'uncertain' : 'dead',
+                });
+            }
+            throw error;
+        }
+    }
+    async run() {
+        const preflight = this.preflight();
+        const existing = this.existingCursor();
+        const runId = this.resolvedRunId(existing);
+        let cursor = existing ?? (0, replay_cursor_js_1.createReplayCursor)(this.identity(runId));
+        if (!existing)
+            (0, replay_cursor_js_1.writeReplayCursor)(this.options.cursorPath, cursor);
+        const ledger = new replay_ledger_js_1.ReplayLedger(this.options.ledgerPath);
+        let settled = 0;
+        for (const window of preflight.windows) {
+            if (cursor.nextWindowStartMs > window.startMs)
+                continue;
+            if (cursor.nextWindowStartMs < window.startMs) {
+                throw new Error('Replay cursor skipped a source window');
+            }
+            if (cursor.currentWindow.startMs !== window.startMs ||
+                cursor.currentWindow.endMs !== window.endMs) {
+                throw new Error('Replay cursor current window does not match the frozen source fence');
+            }
+            const ledgerDigest = this.options.readLedgerDigest?.(window.startMs === 0 ? 0 : window.startMs - 1);
+            const queue = await this.options.buildQueue?.(window, ledgerDigest);
+            const deltas = this.options.catalog.deltasForWindow(runId, window.startMs, window.endMs, {
+                ...(ledgerDigest === undefined ? {} : { ledgerDigest }),
+                ...(queue === undefined ? {} : { queue }),
+            });
+            for (const delta of deltas) {
+                cursor = await this.deliverDelta(cursor, ledger, window, delta);
+                settled += 1;
+            }
+            cursor = (0, replay_cursor_js_1.advanceReplayCursor)(cursor);
+            (0, replay_cursor_js_1.writeReplayCursor)(this.options.cursorPath, cursor);
+        }
+        return {
+            runId,
+            windows: preflight.windows.length,
+            deltas: preflight.deltas.length,
+            settled,
+            nextWindowStartMs: cursor.nextWindowStartMs,
+        };
+    }
+}
+exports.ReplayFeeder = ReplayFeeder;
+//# sourceMappingURL=replay-feeder.js.map

package/dist/replay/replay-feeder.js.map

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

package/dist/replay/replay-ledger.d.ts

@@ -0,0 +1,32 @@
+export type ReplayLedgerStatus = 'accepted' | 'settled' | 'dead' | 'uncertain';
+export interface ReplayLedgerEntry {
+    sequence: number;
+    windowStartMs: number;
+    windowEndMs: number;
+    stimulusId: string;
+    origin: string;
+    channelFingerprint: string;
+    refCount: number;
+    firstSourceAtMs: number;
+    lastSourceAtMs: number;
+    status: ReplayLedgerStatus;
+}
+export interface ReplayLedgerDelta {
+    windowStartMs: number;
+    windowEndMs: number;
+    stimulusId: string;
+    origin: string;
+    channelKey: string;
+    refCount: number;
+    firstSourceAtMs: number;
+    lastSourceAtMs: number;
+    status: ReplayLedgerStatus;
+}
+export declare function readReplayLedger(path: string): readonly ReplayLedgerEntry[];
+export declare class ReplayLedger {
+    private readonly path;
+    private sequence;
+    constructor(path: string);
+    append(delta: ReplayLedgerDelta): ReplayLedgerEntry;
+}
+//# sourceMappingURL=replay-ledger.d.ts.map

package/dist/replay/replay-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-ledger.d.ts","sourceRoot":"","sources":["../../src/replay/replay-ledger.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,kBAAkB,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,kBAAkB,CAAC;CAC5B;AA6CD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,iBAAiB,EAAE,CAE3E;AAED,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAS;gBAEI,IAAI,EAAE,MAAM;IAMzC,MAAM,CAAC,KAAK,EAAE,iBAAiB,GAAG,iBAAiB;CAyBpD"}

package/dist/replay/replay-ledger.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReplayLedger = void 0;
+exports.readReplayLedger = readReplayLedger;
+const node_fs_1 = require("node:fs");
+const node_crypto_1 = require("node:crypto");
+const node_path_1 = require("node:path");
+function assertMs(value, field) {
+    if (!Number.isSafeInteger(value) || value < 0)
+        throw new Error(`${field} is invalid`);
+}
+function assertEntry(entry) {
+    if (!Number.isSafeInteger(entry.sequence) || entry.sequence < 1)
+        throw new Error('Replay ledger sequence is invalid');
+    assertMs(entry.windowStartMs, 'Replay ledger windowStartMs');
+    assertMs(entry.windowEndMs, 'Replay ledger windowEndMs');
+    assertMs(entry.firstSourceAtMs, 'Replay ledger firstSourceAtMs');
+    assertMs(entry.lastSourceAtMs, 'Replay ledger lastSourceAtMs');
+    if (entry.windowEndMs < entry.windowStartMs || entry.lastSourceAtMs < entry.firstSourceAtMs) {
+        throw new Error('Replay ledger time order is invalid');
+    }
+    if (entry.stimulusId.trim() === '' || entry.origin.trim() === '')
+        throw new Error('Replay ledger identity is invalid');
+    if (!/^[a-f0-9]{64}$/.test(entry.channelFingerprint))
+        throw new Error('Replay ledger channel fingerprint is invalid');
+    if (!Number.isSafeInteger(entry.refCount) || entry.refCount < 0)
+        throw new Error('Replay ledger refCount is invalid');
+    if (!['accepted', 'settled', 'dead', 'uncertain'].includes(entry.status)) {
+        throw new Error('Replay ledger status is invalid');
+    }
+}
+function parseLedger(path) {
+    if (!(0, node_fs_1.existsSync)(path))
+        return [];
+    const source = (0, node_fs_1.readFileSync)(path, 'utf8');
+    if (source.trim() === '')
+        return [];
+    const entries = source
+        .split('\n')
+        .filter((line) => line.trim() !== '')
+        .map((line) => JSON.parse(line));
+    let previous = 0;
+    for (const entry of entries) {
+        assertEntry(entry);
+        if (entry.sequence <= previous)
+            throw new Error('Replay ledger sequence is not strictly increasing');
+        previous = entry.sequence;
+    }
+    return entries;
+}
+function readReplayLedger(path) {
+    return Object.freeze(parseLedger(path));
+}
+class ReplayLedger {
+    path;
+    sequence;
+    constructor(path) {
+        this.path = path;
+        const entries = parseLedger(path);
+        this.sequence = entries.at(-1)?.sequence ?? 0;
+        (0, node_fs_1.mkdirSync)((0, node_path_1.dirname)(path), { recursive: true });
+    }
+    append(delta) {
+        const entry = {
+            sequence: this.sequence + 1,
+            windowStartMs: delta.windowStartMs,
+            windowEndMs: delta.windowEndMs,
+            stimulusId: delta.stimulusId,
+            origin: delta.origin,
+            channelFingerprint: (0, node_crypto_1.createHash)('sha256').update(delta.channelKey, 'utf8').digest('hex'),
+            refCount: delta.refCount,
+            firstSourceAtMs: delta.firstSourceAtMs,
+            lastSourceAtMs: delta.lastSourceAtMs,
+            status: delta.status,
+        };
+        assertEntry(entry);
+        const descriptor = (0, node_fs_1.openSync)(this.path, 'a', 0o600);
+        try {
+            const line = `${JSON.stringify(entry)}\n`;
+            (0, node_fs_1.writeFileSync)(descriptor, line, 'utf8');
+            (0, node_fs_1.fsyncSync)(descriptor);
+        }
+        finally {
+            (0, node_fs_1.closeSync)(descriptor);
+        }
+        this.sequence = entry.sequence;
+        return entry;
+    }
+}
+exports.ReplayLedger = ReplayLedger;
+//# sourceMappingURL=replay-ledger.js.map

package/dist/replay/replay-ledger.js.map

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