@abloatai/ablo 0.35.0 → 0.37.0

package/dist/transactions/mutations/commitOutboxStore.js

@@ -1,26 +0,0 @@
-/**
- * Narrow persistence port for crash-durable commit envelopes.
- *
- * Browser clients use {@link DatabaseCommitOutboxStore}. Agent/Node hosts can
- * inject a workflow-, SQLite-, or filesystem-backed implementation without
- * coupling MutationQueue to the browser database/cache implementation.
- */
-/** Strict IndexedDB adapter backed by Database's `__transactions` store. */
-export class DatabaseCommitOutboxStore {
-    database;
-    constructor(database) {
-        this.database = database;
-    }
-    async seal(envelope, consumedRecordIds) {
-        // This adapter deliberately has no duck-typed fallback. Reporting a
-        // successful seal after a no-op or a non-atomic save/delete handoff would
-        // authorize network dispatch without the durability this port promises.
-        await this.database.sealTransactionRecord(envelope, consumedRecordIds);
-    }
-    async list() {
-        return this.database.getPersistedTransactions();
-    }
-    async remove(envelopeRecordId) {
-        await this.database.removeTransaction(envelopeRecordId);
-    }
-}

package/dist/transactions/mutations/commitPayload.d.ts

@@ -1,164 +0,0 @@
-/**
- * The vocabulary a local transaction uses on the wire. This module defines the
- * {@link QueuedMutation} record and the helpers that turn a transaction into a
- * wire-safe commit operation: schema-field projection
- * ({@link projectCommitPayload}), write-option projection
- * ({@link applyWriteOptions}), foreign-key-aware priority scoring
- * ({@link computePriorityScore}), and the structural checks used to classify
- * transport errors. Nothing here holds queue state or timers, so the batched
- * queue path and the HTTP commit path share the same projection.
- */
-import { MutationOperationType } from '../../transaction/types/index.js';
-import type { OnStaleMode } from '../../transaction/coordination/schema.js';
-import type { MutationOptions, WriteOptions } from '../../interfaces/index.js';
-import type { CommitEnvelopeMember } from '../../transaction/transactions/settlement/commitEnvelope.js';
-export interface UserContext {
-    userId: string;
-    organizationId: string;
-    role?: string;
-    teamIds?: string[];
-}
-/** Wire-format mutation payload (post-projection). */
-export type MutationInput = Record<string, unknown>;
-/**
- * Projects a model's serialized data onto the fields declared in its schema and
- * returns a wire-safe commit payload. It does two things:
- *
- *   1. Drops framework-internal keys (`__class`, `__typename`, `clientId`,
- *      `syncStatus`) and anything not declared on the model's schema.
- *   2. Takes a fresh plain JSON snapshot of the projected values. JSON-typed
- *      fields stay objects rather than pre-serialized strings, while reactive
- *      proxies cannot leak into persistence or the wire payload.
- *
- * For updates (`dropUndefined: true`), `undefined` values are also removed so
- * they are not written as `SET column = NULL` on the server.
- *
- * Field metadata comes from the model registry, populated when the schema is
- * registered at initialization. If a model has no registered field metadata —
- * for example a manually registered model — projection snapshots all serialized
- * data apart from the framework keys.
- */
-export declare function projectCommitPayload(modelName: string, source: Record<string, unknown>, opts: {
-    dropUndefined: boolean;
-}): MutationInput;
-export interface QueuedMutation {
-    id: string;
-    type: 'create' | 'update' | 'delete' | 'archive' | 'unarchive';
-    modelName: string;
-    modelId: string;
-    modelKey: string;
-    data?: MutationInput;
-    previousData?: MutationInput | null;
-    context: UserContext;
-    status: 'pending' | 'executing' | 'awaiting_delta' | 'completed' | 'failed' | 'rolled_back';
-    createdAt: number;
-    attempts: number;
-    priority: 'normal' | 'high';
-    priorityScore: number;
-    writeOptions?: WriteOptions;
-    batchId?: string;
-    /**
-     * Stable identity of the wire commit that currently owns this operation.
-     *
-     * A transport failure is ambiguous: the server may have committed the
-     * batch even though the acknowledgement never reached this client. Keeping
-     * this envelope on every member lets the queue replay the exact same ordered
-     * batch with the exact same idempotency key instead of accidentally
-     * re-batching its operations under a fresh key.
-     */
-    commitEnvelope?: CommitEnvelopeMember;
-    /** Pending-mutation journal entries atomically consumed by this envelope. */
-    sourceMutationIds?: string[];
-    /** Completed locally without a server operation; no sync echo will arrive. */
-    localOnly?: boolean;
-    /** Sync-id threshold: the transaction confirms once a delta with an id at least this value arrives. */
-    syncIdNeededForCompletion?: number;
-    /**
-     * Opaque customer-side batch identity returned with a queued source receipt.
-     * It is retained durably and is the only identity a live WAL delta may use
-     * to settle this pending commit. Server-side replay additionally proves the
-     * complete stored operation-id set before returning `confirmed`.
-     */
-    correlationId?: string;
-    /**
-     * A queued forward has no authoritative sync-id watermark yet. It may only
-     * confirm when a WAL delta carries its opaque server-derived correlation;
-     * unrelated deltas must never satisfy it by advancing the global watermark.
-     */
-    requiresCorrelatedDelta?: boolean;
-    /**
-     * Resolves once the server has confirmed this transaction, whether by a delta
-     * or an HTTP acknowledgement. It rejects with the originating error if the
-     * transaction is permanently rolled back; for a source-forwarded write it
-     * also rejects with `replication_lag_timeout` when the accepted write's WAL
-     * echo misses the confirmation deadline. That timeout does not roll back or
-     * fail the transaction: it remains pending and may confirm when replication
-     * recovers. This gives a caller one place to await the answer to "did my write
-     * land?", matching the
-     * `commits.create({ wait: 'confirmed' })` and
-     * {@link MutationQueue.waitForConfirmation} vocabulary, so a failure
-     * surfaces at the call site instead of only as a silent local rollback. The
-     * permanent-rejection value is the same {@link AbloError} carried on the
-     * queue's `transaction:failed` event.
-     */
-    confirmation?: Promise<void>;
-}
-export declare const normalizeModelKey: (modelName: string) => string;
-export declare const stripModelSuffix: (modelName: string) => string;
-/**
- * Returns the priority score used to order create operations by foreign-key
- * depth, so a parent row commits before its children.
- *
- * The score comes from a priority map on the runtime configuration, built once
- * at initialization by walking the schema's `belongsTo` graph. No model names
- * are hard-coded here, and an application can override specific priorities
- * through `configOverrides.modelCreatePriority`.
- *
- * Non-create operations (update, delete, archive, unarchive) need no
- * foreign-key ordering because the row already exists, so they all share the
- * configured default non-create priority.
- */
-export declare const computePriorityScore: (type: QueuedMutation["type"], modelName: string) => number;
-export declare const TX_TYPE_TO_MUTATION_OP: Record<QueuedMutation['type'], MutationOperationType>;
-export declare function hasStaleWriteOptions(options?: WriteOptions): boolean;
-/** Options whose identity/audit semantics forbid merging two caller writes. */
-export declare function hasCommitCoalescingBarrier(options?: WriteOptions): boolean;
-export interface WriteOperationFields {
-    readAt?: number | null;
-    onStale?: OnStaleMode | null;
-    fenceToken?: number | null;
-    options?: Pick<MutationOptions, 'idempotencyKey' | 'label'>;
-}
-/**
- * Copies a transaction's `writeOptions` onto the wire operation. The
- * stale-context guards (`readAt` and `onStale`) sit at the operation's root,
- * while `idempotencyKey` and `label` go in its `options` slot — the
- * `mutation_log` cache key and audit tag. This is the one place caller-supplied
- * write options cross onto the wire.
- */
-export declare function applyWriteOptions<T extends object>(op: T, transaction: QueuedMutation): T & WriteOperationFields;
-/**
- * The structural shape used to inspect transport-layer errors. It covers the
- * GraphQL-style and HTTP-style error shapes the mutation executor can surface,
- * and is kept intentionally narrow so it does not claim fields the runtime may
- * not supply.
- */
-export interface TransportError {
-    message?: string;
-    code?: string | number;
-    extensions?: Record<string, unknown>;
-    locations?: readonly unknown[];
-    path?: readonly (string | number)[];
-    response?: {
-        status?: number;
-        errors?: readonly {
-            extensions?: {
-                code?: string;
-            };
-            message?: string;
-        }[];
-    };
-    error?: string;
-}
-export declare function asTransportError(value: unknown): TransportError;
-export declare function extractStatusCode(error: unknown): number | undefined;

package/dist/transactions/mutations/commitPayload.js

@@ -1,152 +0,0 @@
-/**
- * The vocabulary a local transaction uses on the wire. This module defines the
- * {@link QueuedMutation} record and the helpers that turn a transaction into a
- * wire-safe commit operation: schema-field projection
- * ({@link projectCommitPayload}), write-option projection
- * ({@link applyWriteOptions}), foreign-key-aware priority scoring
- * ({@link computePriorityScore}), and the structural checks used to classify
- * transport errors. Nothing here holds queue state or timers, so the batched
- * queue path and the HTTP commit path share the same projection.
- */
-import { getContext } from '../../context.js';
-import { MutationOperationType } from '../../transaction/types/index.js';
-import { snapshotJsonValue } from '../../transaction/utils/json.js';
-/**
- * Framework-internal keys added by `Model.toJSON()` that must never
- * reach the wire. The server treats each top-level key as a target
- * column, so shipping these would blow up the INSERT/UPDATE.
- */
-const FRAMEWORK_KEYS = new Set(['__class', '__typename', 'clientId', 'syncStatus']);
-/**
- * Projects a model's serialized data onto the fields declared in its schema and
- * returns a wire-safe commit payload. It does two things:
- *
- *   1. Drops framework-internal keys (`__class`, `__typename`, `clientId`,
- *      `syncStatus`) and anything not declared on the model's schema.
- *   2. Takes a fresh plain JSON snapshot of the projected values. JSON-typed
- *      fields stay objects rather than pre-serialized strings, while reactive
- *      proxies cannot leak into persistence or the wire payload.
- *
- * For updates (`dropUndefined: true`), `undefined` values are also removed so
- * they are not written as `SET column = NULL` on the server.
- *
- * Field metadata comes from the model registry, populated when the schema is
- * registered at initialization. If a model has no registered field metadata —
- * for example a manually registered model — projection snapshots all serialized
- * data apart from the framework keys.
- */
-export function projectCommitPayload(modelName, source, opts) {
-    const metadata = getContext().getModelMetadata(modelName);
-    const fields = metadata?.fields;
-    const out = {};
-    if (!fields) {
-        // Unknown registration — strip framework keys and ship the rest.
-        for (const [k, v] of Object.entries(source)) {
-            if (FRAMEWORK_KEYS.has(k))
-                continue;
-            if (opts.dropUndefined && v === undefined)
-                continue;
-            out[k] = v;
-        }
-        return snapshotJsonValue(out, '$.input');
-    }
-    for (const key of Object.keys(fields)) {
-        if (!(key in source))
-            continue;
-        const value = source[key];
-        if (opts.dropUndefined && value === undefined)
-            continue;
-        // JSON-typed fields (stored as jsonb on the server) are sent as objects,
-        // not pre-serialized strings. Pre-stringifying here corrupts a round trip:
-        //
-        //   1. The client stringifies `position: {x, y}` to `'{"x":...}'`.
-        //   2. The server writes it to the jsonb column, parsing the string, fine.
-        //   3. The server's delta echoes the input, where `position` is still the
-        //      string from step 1.
-        //   4. The client merges the delta and sets `model.position` to that string.
-        //   5. The next edit spreads the string character by character, producing a
-        //      corrupted, index-keyed object.
-        //   6. That corrupt object lands in the next commit and is stored in jsonb.
-        //
-        // Sending objects avoids the mismatch: the value travels through the delta
-        // and the commit unchanged, and the Postgres driver serializes a JS object
-        // to jsonb correctly once the column is identified as jsonb.
-        out[key] = value;
-    }
-    return snapshotJsonValue(out, '$.input');
-}
-export const normalizeModelKey = (modelName) => modelName.replace('Model', '').toLowerCase();
-export const stripModelSuffix = (modelName) => modelName.replace('Model', '');
-/**
- * Returns the priority score used to order create operations by foreign-key
- * depth, so a parent row commits before its children.
- *
- * The score comes from a priority map on the runtime configuration, built once
- * at initialization by walking the schema's `belongsTo` graph. No model names
- * are hard-coded here, and an application can override specific priorities
- * through `configOverrides.modelCreatePriority`.
- *
- * Non-create operations (update, delete, archive, unarchive) need no
- * foreign-key ordering because the row already exists, so they all share the
- * configured default non-create priority.
- */
-export const computePriorityScore = (type, modelName) => {
-    const { modelCreatePriority, defaultCreatePriority, defaultNonCreatePriority } = getContext().config;
-    if (type !== 'create')
-        return defaultNonCreatePriority;
-    return modelCreatePriority.get(modelName) ?? defaultCreatePriority;
-};
-export const TX_TYPE_TO_MUTATION_OP = {
-    create: MutationOperationType.CREATE,
-    update: MutationOperationType.UPDATE,
-    delete: MutationOperationType.DELETE,
-    archive: MutationOperationType.ARCHIVE,
-    unarchive: MutationOperationType.UNARCHIVE,
-};
-export function hasStaleWriteOptions(options) {
-    return (options?.readAt !== undefined ||
-        options?.onStale !== undefined);
-}
-/** Options whose identity/audit semantics forbid merging two caller writes. */
-export function hasCommitCoalescingBarrier(options) {
-    return (hasStaleWriteOptions(options) ||
-        typeof options?.idempotencyKey === 'string' ||
-        typeof options?.label === 'string');
-}
-/**
- * Copies a transaction's `writeOptions` onto the wire operation. The
- * stale-context guards (`readAt` and `onStale`) sit at the operation's root,
- * while `idempotencyKey` and `label` go in its `options` slot — the
- * `mutation_log` cache key and audit tag. This is the one place caller-supplied
- * write options cross onto the wire.
- */
-export function applyWriteOptions(op, transaction) {
-    const operation = op;
-    const writeOptions = transaction.writeOptions;
-    if (!writeOptions)
-        return operation;
-    if (writeOptions.readAt !== undefined) {
-        operation.readAt = writeOptions.readAt;
-    }
-    if (writeOptions.onStale !== undefined) {
-        operation.onStale = writeOptions.onStale;
-    }
-    if (writeOptions.fenceToken !== undefined) {
-        operation.fenceToken = writeOptions.fenceToken;
-    }
-    if (writeOptions.idempotencyKey != null || writeOptions.label !== undefined) {
-        operation.options = {
-            ...(writeOptions.idempotencyKey != null
-                ? { idempotencyKey: writeOptions.idempotencyKey }
-                : {}),
-            ...(writeOptions.label !== undefined ? { label: writeOptions.label } : {}),
-        };
-    }
-    return operation;
-}
-export function asTransportError(value) {
-    return (value && typeof value === 'object' ? value : {});
-}
-export function extractStatusCode(error) {
-    return asTransportError(error).response?.status;
-}

package/dist/transactions/mutations/deltaConfirmation.d.ts

@@ -1,59 +0,0 @@
-/**
- * Tracks whether the confirming delta for a write has arrived. It holds the
- * acknowledgement watermark (through the shared {@link LogPosition}), the
- * per-transaction confirmation timeouts, and the retry-with-backoff and
- * reconciliation policy for transactions in the `awaiting_delta` status. It
- * reaches back to {@link MutationQueue} only through the small
- * {@link DeltaConfirmationContext} interface, not the queue class itself, so it
- * has no cyclic dependency and can be tested on its own.
- */
-import type { LogPosition } from '../../transaction/logPosition.js';
-import type { QueuedMutation } from './commitPayload.js';
-/**
- * The subset of {@link MutationQueue} that the confirmation tracker needs:
- * store lookups and status changes, removing optimistic entries once a write
- * confirms, the queue's event emitter (`transaction:completed`,
- * `reconciliation:needed`, and so on), a connection check (so timeouts
- * re-schedule instead of escalating while offline), and the shared client
- * position (`noteAck` advances the acknowledgement cursor; diagnostics read the
- * applied cursor).
- */
-export interface DeltaConfirmationContext {
-    store: {
-        get(id: string): QueuedMutation | undefined;
-        getByStatus(status: QueuedMutation['status']): QueuedMutation[];
-        updateStatus(id: string, status: QueuedMutation['status']): void;
-    };
-    optimisticUpdates: {
-        delete(id: string): boolean;
-    };
-    emit(event: string, payload?: unknown): void;
-    isConnected(): boolean;
-    position: LogPosition;
-}
-export declare class DeltaConfirmationTracker {
-    private readonly ctx;
-    private static readonly DELTA_MAX_RETRIES;
-    private static readonly DELTA_MAX_TIMEOUT_MS;
-    private deltaConfirmationTimeouts;
-    private deltaConfirmationRetries;
-    constructor(ctx: DeltaConfirmationContext);
-    /** Applied-cursor alias, kept so the read sites below stay legible. */
-    private get lastSeenSyncId();
-    private matchesSourceEcho;
-    noteAck(lastSyncId: number | undefined): void;
-    /**
-     * Confirms every awaiting transaction whose sync-id threshold this delta
-     * meets or exceeds.
-     * @param syncId - The sync id of the received delta.
-     */
-    onDeltaReceived(syncId: number, correlationId?: string): void;
-    scheduleDeltaConfirmationTimeout(tx: QueuedMutation, timeoutMs: number): void;
-    private cancelDeltaConfirmationTimeout;
-    /**
-     * Clears every armed confirmation timer, one per in-flight transaction.
-     * {@link MutationQueue.dispose} calls this; without it a disposed queue
-     * would keep the process alive and fire callbacks against a cleared store.
-     */
-    dispose(): void;
-}

package/dist/transactions/mutations/deltaConfirmation.js

@@ -1,233 +0,0 @@
-/**
- * Tracks whether the confirming delta for a write has arrived. It holds the
- * acknowledgement watermark (through the shared {@link LogPosition}), the
- * per-transaction confirmation timeouts, and the retry-with-backoff and
- * reconciliation policy for transactions in the `awaiting_delta` status. It
- * reaches back to {@link MutationQueue} only through the small
- * {@link DeltaConfirmationContext} interface, not the queue class itself, so it
- * has no cyclic dependency and can be tested on its own.
- */
-import { getContext } from '../../context.js';
-export class DeltaConfirmationTracker {
-    ctx;
-    // Retry configuration for delta confirmation, using exponential backoff.
-    // Maximum retries before requesting a full reconciliation.
-    static DELTA_MAX_RETRIES = 5;
-    // Upper bound on the backoff timeout.
-    static DELTA_MAX_TIMEOUT_MS = 120_000;
-    // Pending confirmation timeouts for transactions awaiting their delta. On
-    // timeout the tracker retries with backoff rather than rolling back.
-    deltaConfirmationTimeouts = new Map();
-    // Track retry attempts per transaction for exponential backoff
-    deltaConfirmationRetries = new Map();
-    constructor(ctx) {
-        this.ctx = ctx;
-    }
-    /** Applied-cursor alias, kept so the read sites below stay legible. */
-    get lastSeenSyncId() {
-        return this.ctx.position.applied;
-    }
-    matchesSourceEcho(tx, correlationId) {
-        return (correlationId !== undefined &&
-            tx.correlationId !== undefined &&
-            correlationId === tx.correlationId);
-    }
-    noteAck(lastSyncId) {
-        this.ctx.position.noteAck(lastSyncId);
-    }
-    /**
-     * Confirms every awaiting transaction whose sync-id threshold this delta
-     * meets or exceeds.
-     * @param syncId - The sync id of the received delta.
-     */
-    onDeltaReceived(syncId, correlationId) {
-        // The cursor advances where the delta is applied (the store calls
-        // position.advanceApplied / advancePersisted); this hook only resolves
-        // confirmation thresholds against the incoming id.
-        const awaitingTxs = this.ctx.store.getByStatus('awaiting_delta');
-        const executingTxs = this.ctx.store.getByStatus('executing');
-        // Debug: Show state when delta arrives
-        if (awaitingTxs.length > 0 || executingTxs.length > 0) {
-            getContext().logger.debug('tx:delta_received', {
-                syncId,
-                lastSeenSyncId: this.lastSeenSyncId,
-                awaitingCount: awaitingTxs.length,
-                executingCount: executingTxs.length,
-                awaitingThresholds: awaitingTxs.map((tx) => ({
-                    txId: tx.id.slice(0, 8),
-                    model: tx.modelName,
-                    needed: tx.syncIdNeededForCompletion,
-                    requiresCorrelatedDelta: tx.requiresCorrelatedDelta === true,
-                    willConfirm: tx.requiresCorrelatedDelta === true
-                        ? this.matchesSourceEcho(tx, correlationId)
-                        : tx.syncIdNeededForCompletion !== undefined &&
-                            syncId >= tx.syncIdNeededForCompletion,
-                })),
-            });
-        }
-        // Fast path: no awaiting transactions
-        if (awaitingTxs.length === 0)
-            return;
-        let confirmedCount = 0;
-        for (const tx of awaitingTxs) {
-            // Queued forward receipts deliberately have no watermark. They confirm
-            // only when the authoritative source echoes the receipt's opaque,
-            // authenticated-scope batch identity; the legacy anomaly path continues
-            // to use its sync-id threshold.
-            const confirmedByCorrelation = tx.requiresCorrelatedDelta === true &&
-                this.matchesSourceEcho(tx, correlationId);
-            const confirmedByThreshold = tx.requiresCorrelatedDelta !== true &&
-                tx.syncIdNeededForCompletion !== undefined &&
-                syncId >= tx.syncIdNeededForCompletion;
-            if (confirmedByCorrelation || confirmedByThreshold) {
-                this.cancelDeltaConfirmationTimeout(tx.id);
-                this.ctx.store.updateStatus(tx.id, 'completed');
-                this.ctx.emit('transaction:completed', tx);
-                this.ctx.emit(`transaction:completed:${tx.id}`, tx);
-                this.ctx.optimisticUpdates.delete(tx.id);
-                confirmedCount++;
-                getContext().logger.debug('tx:confirm_via_delta', {
-                    txId: tx.id.slice(0, 8),
-                    model: tx.modelName,
-                    neededSyncId: tx.syncIdNeededForCompletion,
-                    receivedSyncId: syncId,
-                    confirmation: confirmedByCorrelation ? 'source_correlation' : 'sync_id',
-                });
-            }
-        }
-        // Log batch summary only if we confirmed something
-        if (confirmedCount > 0) {
-            // Leave a breadcrumb when transactions confirm.
-            getContext().observability.breadcrumb('Transactions confirmed via delta', 'sync.transaction', 'info', {
-                count: confirmedCount,
-                syncId,
-                remainingAwaiting: awaitingTxs.length - confirmedCount,
-            });
-        }
-    }
-    // Schedule the confirmation wait for a transaction. On timeout the tracker
-    // retries with exponential backoff and requests reconciliation to catch up on
-    // missed deltas, rather than rolling back, which would discard state the
-    // server has already confirmed. A rollback happens only on an explicit server
-    // rejection, never on a timeout.
-    scheduleDeltaConfirmationTimeout(tx, timeoutMs) {
-        // Cancel any existing timeout for this transaction
-        this.cancelDeltaConfirmationTimeout(tx.id);
-        // Deliberately not an async callback: the body is fully synchronous, and
-        // `setTimeout(async …)` would turn any throw into an unhandled promise
-        // rejection instead of a catchable synchronous error.
-        const timeoutHandle = setTimeout(() => {
-            const currentTx = this.ctx.store.get(tx.id);
-            if (currentTx?.status !== 'awaiting_delta') {
-                this.deltaConfirmationRetries.delete(tx.id);
-                return; // Already confirmed or failed
-            }
-            // If disconnected, re-schedule with same timeout (no backoff while offline)
-            if (!this.ctx.isConnected()) {
-                // Self-healing: re-schedule the confirmation wait while offline, no
-                // consumer action needed → debug.
-                getContext().logger.debug('[MutationQueue] Timeout fired while disconnected - re-scheduling', {
-                    txId: tx.id.slice(0, 8),
-                    model: tx.modelName,
-                });
-                this.deltaConfirmationTimeouts.delete(tx.id);
-                this.scheduleDeltaConfirmationTimeout(tx, timeoutMs);
-                return;
-            }
-            const retryCount = this.deltaConfirmationRetries.get(tx.id) ?? 0;
-            getContext().observability.captureReconciliation({
-                reason: 'delta_timeout',
-                model: tx.modelName,
-                modelId: tx.modelId,
-                syncIdNeeded: currentTx.syncIdNeededForCompletion,
-                lastSeenSyncId: this.lastSeenSyncId,
-                retryCount,
-                connectionState: this.ctx.isConnected() ? 'connected' : 'disconnected',
-            });
-            if (retryCount < DeltaConfirmationTracker.DELTA_MAX_RETRIES) {
-                // Retry: request reconciliation and re-schedule with exponential
-                // backoff. The server has already committed the mutation; only the
-                // delta is outstanding.
-                this.deltaConfirmationRetries.set(tx.id, retryCount + 1);
-                this.deltaConfirmationTimeouts.delete(tx.id);
-                // Exponential backoff: 30s → 60s → 120s → 120s → 120s (capped)
-                const nextTimeout = Math.min(timeoutMs * 2, DeltaConfirmationTracker.DELTA_MAX_TIMEOUT_MS);
-                // Request reconciliation so the client can cycle the connection and
-                // catch up on missed deltas from the server.
-                this.ctx.emit('reconciliation:needed', {
-                    reason: 'delta_confirmation_timeout',
-                    txId: tx.id,
-                    model: tx.modelName,
-                    modelId: tx.modelId,
-                    syncIdNeeded: currentTx.syncIdNeededForCompletion,
-                    lastSeenSyncId: this.lastSeenSyncId,
-                    retryCount: retryCount + 1,
-                });
-                // Self-healing retry with backoff — the server already committed; we're
-                // just waiting on the delta. No consumer action → debug.
-                getContext().logger.debug('[MutationQueue] Re-scheduling with backoff', {
-                    txId: tx.id.slice(0, 8),
-                    model: tx.modelName,
-                    nextTimeoutMs: nextTimeout,
-                    retry: retryCount + 1,
-                });
-                this.scheduleDeltaConfirmationTimeout(tx, nextTimeout);
-            }
-            else {
-                // Retries exhausted: persist the awaiting state instead of rolling back.
-                // The commit succeeded on the server, so the data exists there. Saving
-                // the awaiting state lets it survive the page closing; on the next
-                // session, reconnecting and catching up on deltas will confirm it.
-                this.deltaConfirmationRetries.delete(tx.id);
-                this.deltaConfirmationTimeouts.delete(tx.id);
-                getContext().observability.captureDeltaRetryExhausted({
-                    txId: tx.id,
-                    model: tx.modelName,
-                    modelId: tx.modelId,
-                    retryCount: DeltaConfirmationTracker.DELTA_MAX_RETRIES,
-                    syncIdNeeded: currentTx.syncIdNeededForCompletion,
-                });
-                // Emit the persist event; the client performs the write to local storage.
-                this.ctx.emit('transaction:persist_awaiting', {
-                    txId: tx.id,
-                    model: tx.modelName,
-                    modelId: tx.modelId,
-                    operationType: tx.type,
-                    syncIdNeeded: currentTx.syncIdNeededForCompletion,
-                });
-                // Also request one final reconciliation cycle
-                this.ctx.emit('reconciliation:needed', {
-                    reason: 'delta_retries_exhausted',
-                    txId: tx.id,
-                    model: tx.modelName,
-                    modelId: tx.modelId,
-                    syncIdNeeded: currentTx.syncIdNeededForCompletion,
-                    lastSeenSyncId: this.lastSeenSyncId,
-                    retryCount: DeltaConfirmationTracker.DELTA_MAX_RETRIES,
-                });
-            }
-        }, timeoutMs);
-        this.deltaConfirmationTimeouts.set(tx.id, timeoutHandle);
-    }
-    // Cancel a pending delta confirmation timeout and clean up retry tracking
-    cancelDeltaConfirmationTimeout(id) {
-        const timeoutHandle = this.deltaConfirmationTimeouts.get(id);
-        if (timeoutHandle) {
-            clearTimeout(timeoutHandle);
-            this.deltaConfirmationTimeouts.delete(id);
-        }
-        this.deltaConfirmationRetries.delete(id);
-    }
-    /**
-     * Clears every armed confirmation timer, one per in-flight transaction.
-     * {@link MutationQueue.dispose} calls this; without it a disposed queue
-     * would keep the process alive and fire callbacks against a cleared store.
-     */
-    dispose() {
-        for (const timeoutHandle of this.deltaConfirmationTimeouts.values()) {
-            clearTimeout(timeoutHandle);
-        }
-        this.deltaConfirmationTimeouts.clear();
-        this.deltaConfirmationRetries.clear();
-    }
-}

package/dist/transactions/mutations/durableWriteStore.d.ts

@@ -1,14 +0,0 @@
-/**
- * The durable-write port moved to the settlement core (ADR 0016): it is a
- * contract over commit envelopes and holds no local rows. Re-exported here so
- * the existing `transactions/mutations/durableWriteStore` import path keeps
- * resolving for the queue, the outbox, and the client options.
- *
- * The port and its config live in the core's `durableWrites` module (a behavior
- * contract, not a persisted shape); the records that cross it are owned by
- * `transactions/settlement/pendingWrite`.
- */
-export { durableWriteStoreSchema, durableWritesConfigSchema, } from '../../transaction/durableWrites.js';
-export type { DurableWriteStore, DurableWritesConfig, } from '../../transaction/durableWrites.js';
-export { pendingWriteSchema } from '../../transaction/transactions/settlement/pendingWrite.js';
-export type { PendingWrite } from '../../transaction/transactions/settlement/pendingWrite.js';

package/dist/transactions/mutations/durableWriteStore.js

@@ -1,12 +0,0 @@
-/**
- * The durable-write port moved to the settlement core (ADR 0016): it is a
- * contract over commit envelopes and holds no local rows. Re-exported here so
- * the existing `transactions/mutations/durableWriteStore` import path keeps
- * resolving for the queue, the outbox, and the client options.
- *
- * The port and its config live in the core's `durableWrites` module (a behavior
- * contract, not a persisted shape); the records that cross it are owned by
- * `transactions/settlement/pendingWrite`.
- */
-export { durableWriteStoreSchema, durableWritesConfigSchema, } from '../../transaction/durableWrites.js';
-export { pendingWriteSchema } from '../../transaction/transactions/settlement/pendingWrite.js';