hikoutei 0.2.0

package/dist/infrastructure/storage/sync/outbound/effectOutbox.js

@@ -0,0 +1,396 @@
+/**
+ * Effect outbox claim, apply, and recovery operations.
+ *
+ * Per design concurrency/writer-rpc.md and storage-schema.md:
+ * - Effects are claimed atomically (CAS on status = 'pending').
+ * - Only one worker can claim an effect at a time.
+ * - Apply results must pass fencing validation (epoch + token).
+ * - Supersede/replan atomically closes old effect and inserts new one.
+ */
+import { STORAGE_ERROR_CODES, StorageError } from "../../errors.js";
+import { withSqlSavepoint } from "../../sqlite/sqlTransaction.js";
+import { isFencingValid, isFencingValidWithSql, } from "../shared/writerLease.js";
+import { toSqlNullable } from "../../sqlite/sqlState.js";
+import { APPLY_EFFECT_RESULT_SQL, CLAIM_EFFECT_SQL, COUNT_PENDING_OR_PROCESSING_EFFECTS_SQL, INSERT_PENDING_EFFECT_SQL, INSERT_REPLANNED_EFFECT_SQL, RECOVER_EXPIRED_LEASES_SQL, REQUEUE_CLAIMED_EFFECT_SQL, RELEASE_UNPROCESSED_EFFECT_SQL, SELECT_PENDING_EFFECTS_BY_TARGET_SQL, SELECT_READY_EFFECTS_SQL, SUPERSEDE_EFFECT_SQL, } from "./effectOutboxSql.js";
+import { applyEffectResultParameters, AsyncFenceLostError, claimEffectParameters, fenceParameters, pendingEffectParameters, replannedEffectParameters, requireCurrentFence, requireCurrentFenceWithSql, validateApplyResultOptions, validateEffectLeaseDuration, validateReadyEffectLimit, writeProjectionConfirmation, writeProjectionConfirmationWithSql, } from "./effectOutboxSupport.js";
+export { SYNC_EFFECT_RECOVERY_ERROR_CODES } from "./effectOutboxContracts.js";
+export function claimEffect(db, options) {
+    if (!isFencingValid(db, options)) {
+        return {
+            effectId: options.effectId,
+            claimToken: options.claimToken,
+            success: false,
+            reason: "stale_fencing",
+        };
+    }
+    validateEffectLeaseDuration(options.leaseDurationMs);
+    const result = db
+        .prepare(CLAIM_EFFECT_SQL)
+        .run(options.claimToken, options.writerEpoch, options.now + options.leaseDurationMs, options.effectId, ...fenceParameters(options));
+    const success = result.changes > 0;
+    return {
+        effectId: options.effectId,
+        claimToken: options.claimToken,
+        success,
+        reason: success
+            ? "claimed"
+            : isFencingValid(db, options) ? "not_claimable" : "stale_fencing",
+    };
+}
+/**
+ * Claims a pending effect through an already-active async SQL context.
+ *
+ * The compare-and-set query and both fencing checks use the same connection,
+ * so a MikroORM-backed worker cannot accidentally claim through a second
+ * SQLite connection.
+ */
+export async function claimEffectWithSql(sql, options) {
+    if (!(await isFencingValidWithSql(sql, options))) {
+        return {
+            effectId: options.effectId,
+            claimToken: options.claimToken,
+            success: false,
+            reason: "stale_fencing",
+        };
+    }
+    validateEffectLeaseDuration(options.leaseDurationMs);
+    const result = await sql.run(CLAIM_EFFECT_SQL, claimEffectParameters(options));
+    const success = result.changes > 0;
+    return {
+        effectId: options.effectId,
+        claimToken: options.claimToken,
+        success,
+        reason: success
+            ? "claimed"
+            : await isFencingValidWithSql(sql, options) ? "not_claimable" : "stale_fencing",
+    };
+}
+/** Claims one effect inside an adapter-owned transaction. */
+export async function claimEffectWithAdapter(storage, options) {
+    return storage.transaction(({ sql }) => claimEffectWithSql(sql, options));
+}
+/**
+ * Appends pending effects under the supplied writer fence.
+ *
+ * This is used for conflict/quarantine effects that do not accompany a
+ * canonical field commit. It owns a savepoint so a duplicate dedupe key or a
+ * lost fence cannot leave only part of an effect set behind.
+ */
+export function appendPendingEffects(db, fence, effects) {
+    if (effects.length === 0)
+        return isFencingValid(db, fence);
+    if (!isFencingValid(db, fence))
+        return false;
+    db.exec("SAVEPOINT append_pending_effects");
+    try {
+        for (const effect of effects) {
+            const result = db.prepare(INSERT_PENDING_EFFECT_SQL).run(effect.effectId, effect.effectKind, effect.commitId, effect.logicalSheetId, effect.physicalSheetId, effect.projection, toSqlNullable(effect.rowBindingId), toSqlNullable(effect.conflictId), effect.targetKind, effect.targetId, toSqlNullable(effect.targetEntityRevision), toSqlNullable(effect.targetFieldRevisionHash), toSqlNullable(effect.targetCanonicalCommitId), effect.expectedVisibleRevision, effect.expectedVisibleHash, toSqlNullable(effect.repairGuardHash), toSqlNullable(effect.sourceQuarantineId), effect.payloadJson, effect.payloadHash, effect.effectDedupeKey, effect.streamSequence, fence.now, ...fenceParameters(fence));
+            if (result.changes !== 1) {
+                if (!isFencingValid(db, fence)) {
+                    db.exec("ROLLBACK TO append_pending_effects");
+                    db.exec("RELEASE append_pending_effects");
+                    return false;
+                }
+                throw new StorageError(STORAGE_ERROR_CODES.EFFECT_WRITE_FAILED, `could not insert effect ${effect.effectId}`);
+            }
+        }
+        db.exec("RELEASE append_pending_effects");
+        return true;
+    }
+    catch (error) {
+        db.exec("ROLLBACK TO append_pending_effects");
+        db.exec("RELEASE append_pending_effects");
+        throw error;
+    }
+}
+/**
+ * Appends pending effects inside an already-active async SQL transaction.
+ *
+ * This is the MikroORM-compatible path used when an entity mutation and its
+ * Sheets outbox records must commit or roll back together.
+ */
+export async function appendPendingEffectsWithSql(sql, fence, effects) {
+    if (effects.length === 0)
+        return isFencingValidWithSql(sql, fence);
+    if (!(await isFencingValidWithSql(sql, fence)))
+        return false;
+    try {
+        return await withSqlSavepoint(sql, "append_pending_effects", async () => {
+            for (const effect of effects) {
+                const result = await sql.run(INSERT_PENDING_EFFECT_SQL, pendingEffectParameters(effect, fence));
+                if (result.changes === 1)
+                    continue;
+                if (!(await isFencingValidWithSql(sql, fence))) {
+                    throw new AsyncFenceLostError();
+                }
+                throw new StorageError(STORAGE_ERROR_CODES.EFFECT_WRITE_FAILED, `could not insert effect ${effect.effectId}`);
+            }
+            return true;
+        });
+    }
+    catch (error) {
+        if (error instanceof AsyncFenceLostError)
+            return false;
+        throw error;
+    }
+}
+/** Appends pending effects in one adapter-owned transaction. */
+export async function appendPendingEffectsWithAdapter(storage, fence, effects) {
+    return storage.transaction(({ sql }) => appendPendingEffectsWithSql(sql, fence, effects));
+}
+/**
+ * Applies a result to a claimed effect.
+ * Validates fencing (claim token + writer epoch) before applying.
+ * Returns true if the result was applied, false if fencing failed.
+ */
+export function applyEffectResult(db, options) {
+    if (!isFencingValid(db, options)) {
+        return false;
+    }
+    validateApplyResultOptions(options);
+    db.exec("SAVEPOINT apply_effect_result");
+    try {
+        const result = db
+            .prepare(APPLY_EFFECT_RESULT_SQL)
+            .run(options.status, toSqlNullable(options.lastErrorCode), toSqlNullable(options.lastErrorMessage), options.effectId, options.claimToken, options.writerEpoch, options.now, ...fenceParameters(options));
+        if (result.changes !== 1) {
+            db.exec("ROLLBACK TO apply_effect_result");
+            db.exec("RELEASE apply_effect_result");
+            return false;
+        }
+        if (options.projectionConfirmation !== undefined) {
+            writeProjectionConfirmation(db, options.projectionConfirmation);
+        }
+        db.exec("RELEASE apply_effect_result");
+        return true;
+    }
+    catch (error) {
+        try {
+            db.exec("ROLLBACK TO apply_effect_result");
+            db.exec("RELEASE apply_effect_result");
+        }
+        catch {
+            // Preserve the storage error that caused the result write to fail.
+        }
+        throw error;
+    }
+}
+/**
+ * Applies a claimed effect result through an already-active async SQL context.
+ *
+ * If projection confirmation fails, the savepoint rolls the effect transition
+ * back too; confirmed visible state can never advance without its outbox row.
+ */
+export async function applyEffectResultWithSql(sql, options) {
+    if (!(await isFencingValidWithSql(sql, options)))
+        return false;
+    validateApplyResultOptions(options);
+    return withSqlSavepoint(sql, "apply_effect_result", async () => {
+        const result = await sql.run(APPLY_EFFECT_RESULT_SQL, applyEffectResultParameters(options));
+        if (result.changes !== 1)
+            return false;
+        if (options.projectionConfirmation !== undefined) {
+            await writeProjectionConfirmationWithSql(sql, options.projectionConfirmation);
+        }
+        return true;
+    });
+}
+/** Applies one effect result inside an adapter-owned transaction. */
+export async function applyEffectResultWithAdapter(storage, options) {
+    return storage.transaction(({ sql }) => applyEffectResultWithSql(sql, options));
+}
+/**
+ * Supersedes an old effect and inserts a new replacement effect atomically.
+ * Used for repair replan when the canonical target has advanced.
+ *
+ * Per design: the old effect is marked 'superseded', a new effect with a new
+ * effect_id and new dedupe_key is inserted, and the new effect's
+ * predecessor_effect_id links to the old one.
+ */
+export function supersedeAndReplan(db, fence, oldEffectId, newEffect) {
+    requireCurrentFence(db, fence);
+    db.exec("SAVEPOINT replan");
+    try {
+        const superseded = db.prepare(SUPERSEDE_EFFECT_SQL)
+            .run(newEffect.effectId, oldEffectId, ...fenceParameters(fence));
+        if (superseded.changes !== 1) {
+            requireCurrentFence(db, fence);
+            throw new StorageError(STORAGE_ERROR_CODES.EFFECT_REPLAN_CONFLICT, `effect ${oldEffectId} cannot be replanned from its current status`);
+        }
+        const inserted = db.prepare(INSERT_REPLANNED_EFFECT_SQL).run(newEffect.effectId, newEffect.effectKind, newEffect.commitId, newEffect.logicalSheetId, newEffect.physicalSheetId, newEffect.projection, toSqlNullable(newEffect.rowBindingId), toSqlNullable(newEffect.conflictId), newEffect.targetKind, newEffect.targetId, toSqlNullable(newEffect.targetEntityRevision), toSqlNullable(newEffect.targetFieldRevisionHash), toSqlNullable(newEffect.targetCanonicalCommitId), newEffect.expectedVisibleRevision, newEffect.expectedVisibleHash, toSqlNullable(newEffect.repairGuardHash), toSqlNullable(newEffect.sourceQuarantineId), newEffect.payloadJson, newEffect.payloadHash, newEffect.effectDedupeKey, newEffect.streamSequence, oldEffectId, fence.now, ...fenceParameters(fence));
+        if (inserted.changes !== 1) {
+            requireCurrentFence(db, fence);
+            throw new StorageError(STORAGE_ERROR_CODES.EFFECT_WRITE_FAILED, `effect ${newEffect.effectId} could not be inserted during replan`);
+        }
+        db.exec("RELEASE replan");
+    }
+    catch (error) {
+        db.exec("ROLLBACK TO replan");
+        db.exec("RELEASE replan");
+        throw error;
+    }
+}
+/** Supersedes and replans an effect through an already-active async SQL context. */
+export async function supersedeAndReplanWithSql(sql, fence, oldEffectId, newEffect) {
+    await requireCurrentFenceWithSql(sql, fence);
+    await withSqlSavepoint(sql, "replan", async () => {
+        const superseded = await sql.run(SUPERSEDE_EFFECT_SQL, [
+            newEffect.effectId,
+            oldEffectId,
+            ...fenceParameters(fence),
+        ]);
+        if (superseded.changes !== 1) {
+            await requireCurrentFenceWithSql(sql, fence);
+            throw new StorageError(STORAGE_ERROR_CODES.EFFECT_REPLAN_CONFLICT, `effect ${oldEffectId} cannot be replanned from its current status`);
+        }
+        const inserted = await sql.run(INSERT_REPLANNED_EFFECT_SQL, replannedEffectParameters(newEffect, oldEffectId, fence));
+        if (inserted.changes !== 1) {
+            await requireCurrentFenceWithSql(sql, fence);
+            throw new StorageError(STORAGE_ERROR_CODES.EFFECT_WRITE_FAILED, `effect ${newEffect.effectId} could not be inserted during replan`);
+        }
+    });
+}
+/** Supersedes and replans an effect inside an adapter-owned transaction. */
+export async function supersedeAndReplanWithAdapter(storage, fence, oldEffectId, newEffect) {
+    await storage.transaction(({ sql }) => supersedeAndReplanWithSql(sql, fence, oldEffectId, newEffect));
+}
+/**
+ * Marks expired processing effects as requiring postcondition recovery.
+ *
+ * The worker must read the remote postcondition before it schedules a retry;
+ * an expired lease is not evidence that the remote write did not happen.
+ */
+export function recoverExpiredLeases(db, fence) {
+    requireCurrentFence(db, fence);
+    const result = db
+        .prepare(RECOVER_EXPIRED_LEASES_SQL)
+        .run(fence.now, ...fenceParameters(fence));
+    return result.changes;
+}
+/** Marks expired effect leases through an already-active async SQL context. */
+export async function recoverExpiredLeasesWithSql(sql, fence) {
+    await requireCurrentFenceWithSql(sql, fence);
+    const result = await sql.run(RECOVER_EXPIRED_LEASES_SQL, [
+        fence.now,
+        ...fenceParameters(fence),
+    ]);
+    return result.changes;
+}
+/** Marks expired effect leases inside an adapter-owned transaction. */
+export async function recoverExpiredLeasesWithAdapter(storage, fence) {
+    return storage.transaction(({ sql }) => recoverExpiredLeasesWithSql(sql, fence));
+}
+/**
+ * Returns an acknowledged-but-unprocessed batch suffix to pending.
+ *
+ * This is intentionally narrower than a generic redrive: it may be used only
+ * after a valid gateway response explicitly says the batch budget stopped
+ * before this effect.  Unknown response loss remains failed until read-back.
+ */
+export function releaseUnprocessedEffect(db, options) {
+    if (!isFencingValid(db, options))
+        return false;
+    const result = db.prepare(RELEASE_UNPROCESSED_EFFECT_SQL).run(options.effectId, options.claimToken, options.writerEpoch, options.now, ...fenceParameters(options));
+    return result.changes === 1;
+}
+/** Returns one acknowledged-but-unprocessed effect through an async SQL context. */
+export async function releaseUnprocessedEffectWithSql(sql, options) {
+    if (!(await isFencingValidWithSql(sql, options)))
+        return false;
+    const result = await sql.run(RELEASE_UNPROCESSED_EFFECT_SQL, [
+        options.effectId,
+        options.claimToken,
+        options.writerEpoch,
+        options.now,
+        ...fenceParameters(options),
+    ]);
+    return result.changes === 1;
+}
+/** Returns one acknowledged-but-unprocessed effect inside an adapter transaction. */
+export async function releaseUnprocessedEffectWithAdapter(storage, options) {
+    return storage.transaction(({ sql }) => releaseUnprocessedEffectWithSql(sql, options));
+}
+/** Input for returning a claimed effect to the redrive queue after read-back. */
+/** Requeues a claimed effect only after the current fence still owns it. */
+export function retryClaimedEffect(db, options) {
+    if (!isFencingValid(db, options))
+        return false;
+    const result = db.prepare(REQUEUE_CLAIMED_EFFECT_SQL).run(options.lastErrorCode, options.lastErrorMessage, options.effectId, options.claimToken, options.writerEpoch, options.now, ...fenceParameters(options));
+    return result.changes === 1;
+}
+/** Requeues a claimed effect through an already-active async SQL context. */
+export async function retryClaimedEffectWithSql(sql, options) {
+    if (!(await isFencingValidWithSql(sql, options)))
+        return false;
+    const result = await sql.run(REQUEUE_CLAIMED_EFFECT_SQL, [
+        options.lastErrorCode,
+        options.lastErrorMessage,
+        options.effectId,
+        options.claimToken,
+        options.writerEpoch,
+        options.now,
+        ...fenceParameters(options),
+    ]);
+    return result.changes === 1;
+}
+/** Requeues a claimed effect inside an adapter-owned transaction. */
+export async function retryClaimedEffectWithAdapter(storage, options) {
+    return storage.transaction(({ sql }) => retryClaimedEffectWithSql(sql, options));
+}
+/**
+ * Finds pending effects for a given stream (target), ordered by stream_sequence.
+ * Returns the head-of-line effects for a target stream.
+ */
+export function findPendingEffectsByTarget(db, logicalSheetId, targetKind, targetId) {
+    return db
+        .prepare(SELECT_PENDING_EFFECTS_BY_TARGET_SQL)
+        .all(logicalSheetId, targetKind, targetId);
+}
+/** Reads one target stream through an already-active async SQL context. */
+export async function findPendingEffectsByTargetWithSql(sql, logicalSheetId, targetKind, targetId) {
+    return sql.all(SELECT_PENDING_EFFECTS_BY_TARGET_SQL, [
+        logicalSheetId,
+        targetKind,
+        targetId,
+    ]);
+}
+/** Reads one target stream through a fresh adapter read context. */
+export async function findPendingEffectsByTargetWithAdapter(storage, logicalSheetId, targetKind, targetId) {
+    return storage.read(({ sql }) => {
+        return findPendingEffectsByTargetWithSql(sql, logicalSheetId, targetKind, targetId);
+    });
+}
+/**
+ * Returns ordered head-of-line effects across streams for one bounded worker pass.
+ *
+ * Claiming still performs the authoritative CAS, so a concurrent worker can
+ * safely race this advisory selection without processing a later stream item.
+ */
+export function listReadyEffects(db, limit) {
+    validateReadyEffectLimit(limit);
+    return db.prepare(SELECT_READY_EFFECTS_SQL).all(limit);
+}
+/** Reads bounded head-of-line effects through an already-active async SQL context. */
+export async function listReadyEffectsWithSql(sql, limit) {
+    validateReadyEffectLimit(limit);
+    return sql.all(SELECT_READY_EFFECTS_SQL, [limit]);
+}
+/** Reads bounded head-of-line effects through a fresh adapter read context. */
+export async function listReadyEffectsWithAdapter(storage, limit) {
+    return storage.read(({ sql }) => listReadyEffectsWithSql(sql, limit));
+}
+/** Returns whether normal outbox work is still pending or actively processing. */
+export function hasPendingOrProcessingEffects(db) {
+    const row = db.prepare(COUNT_PENDING_OR_PROCESSING_EFFECTS_SQL).get();
+    return row !== undefined && row.count > 0;
+}
+/** Checks whether the durable outbox still has pending or processing work. */
+export async function hasPendingOrProcessingEffectsWithSql(sql) {
+    const row = await sql.get(COUNT_PENDING_OR_PROCESSING_EFFECTS_SQL);
+    return row !== undefined && row.count > 0;
+}
+/** Checks outbox activity through a fresh adapter read context. */
+export async function hasPendingOrProcessingEffectsWithAdapter(storage) {
+    return storage.read(({ sql }) => hasPendingOrProcessingEffectsWithSql(sql));
+}
+//# sourceMappingURL=effectOutbox.js.map

package/dist/infrastructure/storage/sync/outbound/effectOutbox.js.map

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

package/dist/infrastructure/storage/sync/outbound/effectOutboxContracts.d.ts

@@ -0,0 +1,101 @@
+/** Public contracts for durable effect outbox rows and transitions. */
+import type { Applicability, EffectKind, EffectTargetKind, Presence } from "../../../../domain/index.js";
+import type { FencingContext } from "../shared/writerLease.js";
+export declare const SYNC_EFFECT_RECOVERY_ERROR_CODES: {
+    readonly LEASE_EXPIRED_REQUIRES_POSTCONDITION: "lease_expired_requires_postcondition";
+    readonly GATEWAY_RETRYABLE_ERROR: "gateway_retryable_error";
+    readonly POSTCONDITION_READ_FAILED: "postcondition_read_failed";
+    readonly POSTCONDITION_UNAVAILABLE: "postcondition_unavailable";
+    readonly POSTCONDITION_UNAPPLIED_REQUIRES_REDRIVE: "postcondition_unapplied_requires_redrive";
+};
+export interface ClaimResult {
+    readonly effectId: string;
+    readonly claimToken: string;
+    readonly success: boolean;
+    readonly reason: "claimed" | "stale_fencing" | "not_claimable";
+}
+/** Input required to claim an effect with the current worker fence. */
+export interface ClaimEffectOptions extends FencingContext {
+    readonly effectId: string;
+    readonly claimToken: string;
+    readonly leaseDurationMs: number;
+}
+export interface ApplyResultOptions extends FencingContext {
+    readonly effectId: string;
+    readonly claimToken: string;
+    readonly status: "applied" | "blocked_candidate" | "superseded" | "conflict" | "failed";
+    readonly lastErrorCode: Presence<string>;
+    readonly lastErrorMessage: Presence<string>;
+    /**
+     * Gateway read-back evidence that advances confirmed projection state in the
+     * same savepoint as an applied outbox result.  It is intentionally optional
+     * for legacy callers that do not materialize a projection row.
+     */
+    readonly projectionConfirmation?: EffectProjectionConfirmation;
+}
+/** Confirmed projection state returned only after a gateway postcondition read. */
+export interface EffectProjectionConfirmation {
+    readonly physicalSheetId: string;
+    readonly projection: string;
+    readonly rowBindingId: string;
+    readonly visibleRevision: number;
+    readonly visibleHash: string;
+    readonly entityRevision: Applicability<number>;
+    readonly fieldHashes: Readonly<Record<string, string>>;
+}
+/** A pending outbox row prepared by the writer transaction. */
+export interface NewEffect {
+    readonly effectId: string;
+    readonly effectKind: EffectKind;
+    readonly commitId: string;
+    readonly logicalSheetId: string;
+    readonly physicalSheetId: string;
+    readonly projection: string;
+    readonly rowBindingId: Presence<string>;
+    readonly conflictId: Presence<string>;
+    readonly targetKind: EffectTargetKind;
+    readonly targetId: string;
+    readonly targetEntityRevision: Applicability<number>;
+    readonly targetFieldRevisionHash: Applicability<string>;
+    readonly targetCanonicalCommitId: Applicability<string>;
+    readonly expectedVisibleRevision: number;
+    readonly expectedVisibleHash: string;
+    readonly repairGuardHash: Presence<string>;
+    readonly sourceQuarantineId: Presence<string>;
+    readonly payloadJson: string;
+    readonly payloadHash: string;
+    readonly effectDedupeKey: string;
+    readonly streamSequence: number;
+}
+export interface RetryClaimedEffectOptions extends Pick<FencingContext, "role" | "writerEpoch" | "fencingToken" | "now"> {
+    readonly effectId: string;
+    readonly claimToken: string;
+    readonly lastErrorCode: string;
+    readonly lastErrorMessage: string;
+}
+export interface PendingEffect {
+    readonly effect_id: string;
+    readonly effect_kind: string;
+    readonly commit_id: string;
+    readonly logical_sheet_id: string;
+    readonly physical_sheet_id: string;
+    readonly projection: string;
+    readonly row_binding_id: string | null;
+    readonly conflict_id: string | null;
+    readonly target_kind: string;
+    readonly target_id: string;
+    readonly target_entity_revision: number | null;
+    readonly target_field_revision_hash: string | null;
+    readonly target_canonical_commit_id: string | null;
+    readonly expected_visible_revision: number;
+    readonly expected_visible_hash: string;
+    readonly repair_guard_hash: string | null;
+    readonly source_quarantine_id: string | null;
+    readonly payload_json: string;
+    readonly payload_hash: string;
+    readonly effect_dedupe_key: string;
+    readonly stream_sequence: number;
+    readonly created_at: number;
+    readonly status: string;
+}
+//# sourceMappingURL=effectOutboxContracts.d.ts.map

package/dist/infrastructure/storage/sync/outbound/effectOutboxContracts.d.ts.map

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

package/dist/infrastructure/storage/sync/outbound/effectOutboxContracts.js

@@ -0,0 +1,9 @@
+/** Public contracts for durable effect outbox rows and transitions. */
+export const SYNC_EFFECT_RECOVERY_ERROR_CODES = {
+    LEASE_EXPIRED_REQUIRES_POSTCONDITION: "lease_expired_requires_postcondition",
+    GATEWAY_RETRYABLE_ERROR: "gateway_retryable_error",
+    POSTCONDITION_READ_FAILED: "postcondition_read_failed",
+    POSTCONDITION_UNAVAILABLE: "postcondition_unavailable",
+    POSTCONDITION_UNAPPLIED_REQUIRES_REDRIVE: "postcondition_unapplied_requires_redrive",
+};
+//# sourceMappingURL=effectOutboxContracts.js.map

package/dist/infrastructure/storage/sync/outbound/effectOutboxContracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectOutboxContracts.js","sourceRoot":"","sources":["../../../../../src/infrastructure/storage/sync/outbound/effectOutboxContracts.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAUvE,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,oCAAoC,EAAE,sCAAsC;IAC5E,uBAAuB,EAAE,yBAAyB;IAClD,yBAAyB,EAAE,2BAA2B;IACtD,yBAAyB,EAAE,2BAA2B;IACtD,wCAAwC,EAAE,0CAA0C;CAC5E,CAAC"}

package/dist/infrastructure/storage/sync/outbound/effectOutboxSql.d.ts

@@ -0,0 +1,21 @@
+/** SQL statements used by the effect outbox state machine. */
+export declare const RECOVERABLE_EFFECT_ERROR_CODE_SQL: string;
+export declare const FENCE_EXISTS_SQL = "\n  SELECT 1 FROM writer_lease\n  WHERE role = ? AND writer_epoch = ? AND fencing_token = ? AND lease_until > ?\n";
+export declare const CLAIM_EFFECT_SQL = "\n  UPDATE sheet_effect_outbox AS candidate\n  SET status = 'processing', claim_token = ?, writer_epoch = ?, lease_until = ?,\n      attempts = attempts + 1\n  WHERE candidate.effect_id = ?\n    AND candidate.status IN ('pending', 'failed')\n    AND EXISTS (\n  SELECT 1 FROM writer_lease\n  WHERE role = ? AND writer_epoch = ? AND fencing_token = ? AND lease_until > ?\n)\n    AND NOT EXISTS (\n      SELECT 1\n      FROM sheet_effect_outbox AS predecessor\n      WHERE predecessor.logical_sheet_id = candidate.logical_sheet_id\n        AND predecessor.target_kind = candidate.target_kind\n        AND predecessor.target_id = candidate.target_id\n        AND predecessor.stream_sequence < candidate.stream_sequence\n        AND predecessor.status NOT IN ('applied', 'superseded')\n    )\n";
+export declare const INSERT_PENDING_EFFECT_SQL = "\n  INSERT INTO sheet_effect_outbox (\n    effect_id, effect_kind, commit_id, logical_sheet_id, physical_sheet_id,\n    projection, row_binding_id, conflict_id, target_kind, target_id,\n    target_entity_revision, target_field_revision_hash, target_canonical_commit_id,\n    expected_visible_revision, expected_visible_hash, repair_guard_hash,\n    source_quarantine_id, payload_json, payload_hash, effect_dedupe_key,\n    stream_sequence, created_at, status\n  )\n  SELECT ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'pending'\n  WHERE EXISTS (\n  SELECT 1 FROM writer_lease\n  WHERE role = ? AND writer_epoch = ? AND fencing_token = ? AND lease_until > ?\n)\n";
+export declare const APPLY_EFFECT_RESULT_SQL = "\n  UPDATE sheet_effect_outbox\n  SET status = ?, last_error_code = ?, last_error_message = ?,\n      claim_token = NULL, lease_until = NULL\n  WHERE effect_id = ?\n    AND status = 'processing'\n    AND claim_token = ?\n    AND writer_epoch = ?\n    AND lease_until IS NOT NULL\n    AND lease_until > ?\n    AND EXISTS (\n  SELECT 1 FROM writer_lease\n  WHERE role = ? AND writer_epoch = ? AND fencing_token = ? AND lease_until > ?\n)\n";
+export declare const SUPERSEDE_EFFECT_SQL = "\n  UPDATE sheet_effect_outbox\n  SET status = 'superseded', supersedes_effect_id = ?\n  WHERE effect_id = ?\n    AND status IN ('pending', 'processing', 'blocked_candidate', 'conflict', 'failed')\n    AND EXISTS (\n  SELECT 1 FROM writer_lease\n  WHERE role = ? AND writer_epoch = ? AND fencing_token = ? AND lease_until > ?\n)\n";
+export declare const INSERT_REPLANNED_EFFECT_SQL = "\n  INSERT INTO sheet_effect_outbox (\n    effect_id, effect_kind, commit_id, logical_sheet_id, physical_sheet_id,\n    projection, row_binding_id, conflict_id, target_kind, target_id,\n    target_entity_revision, target_field_revision_hash, target_canonical_commit_id,\n    expected_visible_revision, expected_visible_hash, repair_guard_hash,\n    source_quarantine_id, payload_json, payload_hash, effect_dedupe_key,\n    stream_sequence, predecessor_effect_id, created_at, status\n  )\n  SELECT ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'pending'\n  WHERE EXISTS (\n  SELECT 1 FROM writer_lease\n  WHERE role = ? AND writer_epoch = ? AND fencing_token = ? AND lease_until > ?\n)\n";
+export declare const RECOVER_EXPIRED_LEASES_SQL: string;
+export declare const REQUEUE_CLAIMED_EFFECT_SQL = "\n  UPDATE sheet_effect_outbox\n  SET status = 'pending', claim_token = NULL, lease_until = NULL,\n      last_error_code = ?, last_error_message = ?\n  WHERE effect_id = ? AND status = 'processing' AND claim_token = ?\n    AND writer_epoch = ? AND lease_until IS NOT NULL AND lease_until > ?\n    AND EXISTS (\n  SELECT 1 FROM writer_lease\n  WHERE role = ? AND writer_epoch = ? AND fencing_token = ? AND lease_until > ?\n)\n";
+export declare const RELEASE_UNPROCESSED_EFFECT_SQL = "\n  UPDATE sheet_effect_outbox\n  SET status = 'pending', claim_token = NULL, lease_until = NULL,\n      last_error_code = 'gateway_batch_deferred',\n      last_error_message = 'Gateway acknowledged a bounded batch before this effect.'\n  WHERE effect_id = ? AND status = 'processing' AND claim_token = ?\n    AND writer_epoch = ? AND lease_until IS NOT NULL AND lease_until > ?\n    AND EXISTS (\n  SELECT 1 FROM writer_lease\n  WHERE role = ? AND writer_epoch = ? AND fencing_token = ? AND lease_until > ?\n)\n";
+export declare const SELECT_PENDING_EFFECTS_BY_TARGET_SQL = "\n  SELECT effect_id, effect_kind, commit_id, logical_sheet_id, physical_sheet_id,\n         projection, row_binding_id, conflict_id, target_kind, target_id,\n         target_entity_revision, target_field_revision_hash, target_canonical_commit_id,\n         expected_visible_revision, expected_visible_hash, repair_guard_hash,\n         source_quarantine_id, payload_json, payload_hash, effect_dedupe_key,\n         stream_sequence, created_at, status\n  FROM sheet_effect_outbox\n  WHERE logical_sheet_id = ? AND target_kind = ? AND target_id = ?\n    AND status = 'pending'\n    AND NOT EXISTS (\n      SELECT 1\n      FROM sheet_effect_outbox AS predecessor\n      WHERE predecessor.logical_sheet_id = sheet_effect_outbox.logical_sheet_id\n        AND predecessor.target_kind = sheet_effect_outbox.target_kind\n        AND predecessor.target_id = sheet_effect_outbox.target_id\n        AND predecessor.stream_sequence < sheet_effect_outbox.stream_sequence\n        AND predecessor.status NOT IN ('applied', 'superseded')\n    )\n  ORDER BY stream_sequence\n";
+export declare const SELECT_READY_EFFECTS_SQL: string;
+export declare const COUNT_PENDING_OR_PROCESSING_EFFECTS_SQL = "\n  SELECT COUNT(*) AS count\n  FROM sheet_effect_outbox\n  WHERE status IN ('pending', 'processing')\n";
+export declare const UPSERT_VISIBLE_STATE_SQL = "\n  INSERT INTO sheet_visible_state (\n    physical_sheet_id, projection, row_binding_id, confirmed_snapshot_hash,\n    confirmed_visible_revision, confirmed_entity_revision, last_observed_hash\n  ) VALUES (?, ?, ?, ?, ?, ?, ?)\n  ON CONFLICT(physical_sheet_id, projection, row_binding_id)\n  DO UPDATE SET\n    confirmed_snapshot_hash = excluded.confirmed_snapshot_hash,\n    confirmed_visible_revision = excluded.confirmed_visible_revision,\n    confirmed_entity_revision = excluded.confirmed_entity_revision,\n    last_observed_hash = excluded.last_observed_hash\n  WHERE sheet_visible_state.confirmed_visible_revision <= excluded.confirmed_visible_revision\n";
+export declare const UPSERT_VISIBLE_FIELD_STATE_SQL = "\n  INSERT INTO sheet_visible_field_state (\n    physical_sheet_id, projection, row_binding_id, field_name,\n    confirmed_field_hash, confirmed_visible_revision, candidate_epoch,\n    last_observed_field_hash\n  ) VALUES (?, ?, ?, ?, ?, ?, 0, ?)\n  ON CONFLICT(physical_sheet_id, projection, row_binding_id, field_name)\n  DO UPDATE SET\n    confirmed_field_hash = excluded.confirmed_field_hash,\n    confirmed_visible_revision = excluded.confirmed_visible_revision,\n    last_observed_field_hash = excluded.last_observed_field_hash\n  WHERE sheet_visible_field_state.confirmed_visible_revision <= excluded.confirmed_visible_revision\n";
+/**
+ * Claims a pending effect for processing.
+ * Uses CAS on status to ensure only one worker wins.
+ */
+//# sourceMappingURL=effectOutboxSql.d.ts.map

package/dist/infrastructure/storage/sync/outbound/effectOutboxSql.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effectOutboxSql.d.ts","sourceRoot":"","sources":["../../../../../src/infrastructure/storage/sync/outbound/effectOutboxSql.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAI9D,eAAO,MAAM,iCAAiC,QAOjC,CAAC;AAEd,eAAO,MAAM,gBAAgB,sHAG5B,CAAC;AAEF,eAAO,MAAM,gBAAgB,0xBAgB5B,CAAC;AAEF,eAAO,MAAM,yBAAyB,grBAWrC,CAAC;AAEF,eAAO,MAAM,uBAAuB,0bAWnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,+UAMhC,CAAC;AAEF,eAAO,MAAM,2BAA2B,0sBAWvC,CAAC;AAEF,eAAO,MAAM,0BAA0B,QAOtC,CAAC;AAEF,eAAO,MAAM,0BAA0B,8aAOtC,CAAC;AAEF,eAAO,MAAM,8BAA8B,qgBAQ1C,CAAC;AAEF,eAAO,MAAM,oCAAoC,yiCAoBhD,CAAC;AAEF,eAAO,MAAM,wBAAwB,QA2BpC,CAAC;AAEF,eAAO,MAAM,uCAAuC,4GAInD,CAAC;AAEF,eAAO,MAAM,wBAAwB,2pBAYpC,CAAC;AAEF,eAAO,MAAM,8BAA8B,ioBAY1C,CAAC;AAGF;;;GAGG"}