@plumbus/core 0.7.1 → 0.8.0-beta.1

package/dist/durable/opaque-dispatch.js.map

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

package/dist/durable/persist-before-ack.d.ts

@@ -0,0 +1,52 @@
+import type { TenantTx } from './memory-store.js';
+import { type DispatchOutboxRow, type TenantExecutionState } from './types.js';
+export interface AcceptInput {
+    executionId: string;
+    tenantRef: string;
+    definitionId: string;
+    definitionVersion: string;
+    firstStepId: string;
+    correlationId: string;
+    idempotencyKey: string;
+    workClassId?: string;
+    priorityClassId?: string;
+}
+export interface PersistAcceptanceResult {
+    kind: 'accepted' | 'duplicate';
+    execution: TenantExecutionState;
+    outbox?: DispatchOutboxRow;
+}
+export declare function persistAcceptance(tx: TenantTx, input: AcceptInput, nowIso: string): PersistAcceptanceResult;
+export interface StepCompletionInput {
+    executionId: string;
+    expectedRevision: number;
+    tenantEpoch: number;
+    stepId: string;
+    nextStepId?: string;
+    sideEffectKey: string;
+    sideEffectLabel: string;
+}
+export type PersistStepResult = {
+    kind: 'committed';
+    execution: TenantExecutionState;
+    outbox?: DispatchOutboxRow;
+    sideEffectApplied: boolean;
+} | {
+    kind: 'stale';
+    execution?: TenantExecutionState;
+} | {
+    kind: 'missing';
+} | {
+    kind: 'epoch-mismatch';
+};
+export declare function persistStepCompletion(tx: TenantTx, input: StepCompletionInput, nowIso: string): PersistStepResult;
+export interface RetryScheduleInput {
+    executionId: string;
+    expectedRevision: number;
+    tenantEpoch: number;
+    stepId: string;
+    notBefore: string;
+}
+export declare function persistRetrySchedule(tx: TenantTx, input: RetryScheduleInput, nowIso: string): PersistStepResult;
+export declare function assertCasCommitted(result: PersistStepResult, executionId: string, expectedRevision: number): void;
+//# sourceMappingURL=persist-before-ack.d.ts.map

package/dist/durable/persist-before-ack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persist-before-ack.d.ts","sourceRoot":"","sources":["../../src/durable/persist-before-ack.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,UAAU,GAAG,WAAW,CAAC;IAC/B,SAAS,EAAE,oBAAoB,CAAC;IAChC,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,MAAM,GACb,uBAAuB,CAgCzB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,iBAAiB,GACzB;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,oBAAoB,CAAC;IAChC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;CAC5B,GACD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,oBAAoB,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAE/B,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,MAAM,GACb,iBAAiB,CAqDnB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,QAAQ,EACZ,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,MAAM,GACb,iBAAiB,CAqCnB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,iBAAiB,EACzB,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,GACvB,IAAI,CAIN"}

package/dist/durable/persist-before-ack.js

@@ -0,0 +1,153 @@
+// Persist-before-ack: every state transition CAS-updates tenant execution
+// state and writes a dispatch-outbox row in the same transaction. The caller
+// must not acknowledge inbound work until this function returns (the tenant
+// commit has already happened). Publication to the spine is post-commit.
+import { randomUUID } from 'node:crypto';
+import { DEFAULT_PRIORITY_CLASS_ID, DEFAULT_WORK_CLASS_ID, DurableExecutionStatus, DurableStepStatus, RevisionConflictError, } from './types.js';
+export function persistAcceptance(tx, input, nowIso) {
+    if (tx.hasIdempotency(input.idempotencyKey)) {
+        const existing = tx.getExecution(input.executionId);
+        if (!existing) {
+            throw new Error(`idempotency key ${input.idempotencyKey} has no execution`);
+        }
+        return { kind: 'duplicate', execution: existing };
+    }
+    const stateRefId = `state:${input.executionId}`;
+    const execution = {
+        executionId: input.executionId,
+        stateRefId,
+        tenantRef: input.tenantRef,
+        revision: 1,
+        tenantEpoch: tx.epoch,
+        status: DurableExecutionStatus.Created,
+        definitionId: input.definitionId,
+        definitionVersion: input.definitionVersion,
+        currentStepId: input.firstStepId,
+        stepIndex: 0,
+        attempt: 0,
+        correlationId: input.correlationId,
+        createdAt: nowIso,
+        updatedAt: nowIso,
+        terminal: false,
+    };
+    const outbox = newOutbox(tx, execution, input.firstStepId, nowIso, input);
+    tx.insertExecution(execution);
+    tx.insertOutbox(outbox);
+    tx.putIdempotency(input.idempotencyKey);
+    return { kind: 'accepted', execution, outbox };
+}
+export function persistStepCompletion(tx, input, nowIso) {
+    const current = tx.getExecution(input.executionId);
+    if (!current)
+        return { kind: 'missing' };
+    if (current.tenantEpoch !== input.tenantEpoch)
+        return { kind: 'epoch-mismatch' };
+    if (current.revision !== input.expectedRevision) {
+        return { kind: 'stale', execution: current };
+    }
+    if (current.terminal)
+        return { kind: 'stale', execution: current };
+    const applied = tx.applySideEffect(input.sideEffectKey, input.sideEffectLabel);
+    const nextStepId = input.nextStepId;
+    const terminal = nextStepId === undefined;
+    const next = {
+        ...current,
+        revision: input.expectedRevision + 1,
+        status: terminal ? DurableExecutionStatus.Succeeded : DurableExecutionStatus.Running,
+        currentStepId: input.nextStepId ?? current.currentStepId,
+        stepIndex: current.stepIndex + 1,
+        attempt: 0,
+        terminal,
+        wakeAt: undefined,
+        updatedAt: nowIso,
+    };
+    const cas = tx.casExecution(input.executionId, input.expectedRevision, next);
+    if (cas !== 'ok') {
+        return cas === 'missing' ? { kind: 'missing' } : { kind: 'stale', execution: current };
+    }
+    tx.putStep({
+        stepExecutionId: `${input.executionId}:${input.stepId}:${current.attempt}`,
+        executionId: input.executionId,
+        stepId: input.stepId,
+        attempt: current.attempt,
+        state: DurableStepStatus.Succeeded,
+        startedAt: nowIso,
+        updatedAt: nowIso,
+        completedAt: nowIso,
+    });
+    if (terminal) {
+        tx.putTerminal({
+            terminalStateId: `term:${input.executionId}`,
+            executionId: input.executionId,
+            operationalState: 'succeeded',
+            finalRevision: next.revision,
+            completedAt: nowIso,
+        });
+        return { kind: 'committed', execution: next, sideEffectApplied: applied };
+    }
+    const outbox = newOutbox(tx, next, nextStepId, nowIso);
+    tx.insertOutbox(outbox);
+    return { kind: 'committed', execution: next, outbox, sideEffectApplied: applied };
+}
+export function persistRetrySchedule(tx, input, nowIso) {
+    const current = tx.getExecution(input.executionId);
+    if (!current)
+        return { kind: 'missing' };
+    if (current.tenantEpoch !== input.tenantEpoch)
+        return { kind: 'epoch-mismatch' };
+    if (current.revision !== input.expectedRevision) {
+        return { kind: 'stale', execution: current };
+    }
+    const next = {
+        ...current,
+        revision: input.expectedRevision + 1,
+        status: DurableExecutionStatus.RetryScheduled,
+        currentStepId: input.stepId,
+        attempt: current.attempt + 1,
+        wakeAt: input.notBefore,
+        updatedAt: nowIso,
+        terminal: false,
+    };
+    const cas = tx.casExecution(input.executionId, input.expectedRevision, next);
+    if (cas !== 'ok') {
+        return cas === 'missing' ? { kind: 'missing' } : { kind: 'stale', execution: current };
+    }
+    tx.putWait({
+        waitStateId: `wait:${input.executionId}:${next.revision}`,
+        executionId: input.executionId,
+        stepId: input.stepId,
+        kind: 'retry',
+        state: 'waiting',
+        createdAt: nowIso,
+        updatedAt: nowIso,
+        notBefore: input.notBefore,
+    });
+    const outbox = newOutbox(tx, next, input.stepId, nowIso, { notBefore: input.notBefore });
+    tx.insertOutbox(outbox);
+    return { kind: 'committed', execution: next, outbox, sideEffectApplied: false };
+}
+export function assertCasCommitted(result, executionId, expectedRevision) {
+    if (result.kind === 'stale') {
+        throw new RevisionConflictError(executionId, expectedRevision, result.execution?.revision);
+    }
+}
+function newOutbox(tx, execution, stepId, nowIso, extra) {
+    return {
+        outboxId: `outbox:${execution.executionId}:${execution.revision}:${randomUUID()}`,
+        executionId: execution.executionId,
+        stateRefId: execution.stateRefId,
+        expectedRevision: execution.revision,
+        tenantEpoch: tx.epoch,
+        tenantRef: execution.tenantRef,
+        stepId,
+        definitionId: execution.definitionId,
+        definitionVersion: execution.definitionVersion,
+        correlationId: execution.correlationId,
+        workClassId: extra?.workClassId ?? DEFAULT_WORK_CLASS_ID,
+        priorityClassId: extra?.priorityClassId ?? DEFAULT_PRIORITY_CLASS_ID,
+        notBefore: extra?.notBefore ?? nowIso,
+        createdAt: nowIso,
+        superseded: false,
+    };
+}
+//# sourceMappingURL=persist-before-ack.js.map

package/dist/durable/persist-before-ack.js.map

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

package/dist/durable/pg-env.d.ts

@@ -0,0 +1,9 @@
+export interface TestPostgresAdmin {
+    host: string;
+    port: number;
+    database: string;
+    user: string;
+    password: string;
+}
+export declare function resolveTestPostgresAdmin(env?: Record<string, string | undefined>): TestPostgresAdmin;
+//# sourceMappingURL=pg-env.d.ts.map

package/dist/durable/pg-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-env.d.ts","sourceRoot":"","sources":["../../src/durable/pg-env.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CACtC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GACpD,iBAAiB,CAkBnB"}

package/dist/durable/pg-env.js

@@ -0,0 +1,20 @@
+// Postgres admin coordinates for durable harness tests.
+// Every port comes from the environment — never a literal in source.
+export function resolveTestPostgresAdmin(env = process.env) {
+    const portRaw = env.PLUMBUS_TEST_PG_PORT ?? env.PGPORT ?? env.DB_PORT;
+    if (!portRaw?.trim()) {
+        throw new Error('Durable test harness needs a Postgres port from PLUMBUS_TEST_PG_PORT, PGPORT, or DB_PORT');
+    }
+    const port = Number(portRaw);
+    if (!Number.isInteger(port) || port < 1 || port > 65535) {
+        throw new Error(`Invalid Postgres port from environment: ${portRaw}`);
+    }
+    return {
+        host: env.PLUMBUS_TEST_PG_HOST ?? env.PGHOST ?? env.DB_HOST ?? 'localhost',
+        port,
+        database: env.PLUMBUS_TEST_PG_DATABASE ?? env.PGDATABASE ?? 'postgres',
+        user: env.PLUMBUS_TEST_PG_USER ?? env.PGUSER ?? env.DB_USER ?? 'postgres',
+        password: env.PLUMBUS_TEST_PG_PASSWORD ?? env.PGPASSWORD ?? env.DB_PASSWORD ?? 'postgres',
+    };
+}
+//# sourceMappingURL=pg-env.js.map

package/dist/durable/pg-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-env.js","sourceRoot":"","sources":["../../src/durable/pg-env.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,qEAAqE;AAUrE,MAAM,UAAU,wBAAwB,CACtC,MAA0C,OAAO,CAAC,GAAG;IAErD,MAAM,OAAO,GAAG,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC;IACtE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,2CAA2C,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IACD,OAAO;QACL,IAAI,EAAE,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,WAAW;QAC1E,IAAI;QACJ,QAAQ,EAAE,GAAG,CAAC,wBAAwB,IAAI,GAAG,CAAC,UAAU,IAAI,UAAU;QACtE,IAAI,EAAE,GAAG,CAAC,oBAAoB,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,UAAU;QACzE,QAAQ,EAAE,GAAG,CAAC,wBAAwB,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,WAAW,IAAI,UAAU;KAC1F,CAAC;AACJ,CAAC"}

package/dist/durable/postgres-persist.d.ts

@@ -0,0 +1,33 @@
+import type { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
+import { type DispatchOutboxRow, type OpaqueDispatchRecord, type TenantExecutionState } from './types.js';
+export declare function loadExecutionState(db: PostgresJsDatabase, executionId: string, schemaName?: string): Promise<TenantExecutionState | undefined>;
+export declare function persistAcceptanceOnDb(db: PostgresJsDatabase, input: {
+    executionId: string;
+    tenantRef: string;
+    definitionId: string;
+    definitionVersion: string;
+    firstStepId: string;
+    correlationId: string;
+    nowIso: string;
+}, schemaName?: string): Promise<{
+    execution: TenantExecutionState;
+    outbox: DispatchOutboxRow;
+}>;
+export declare function casAdvanceExecution(db: PostgresJsDatabase, input: {
+    executionId: string;
+    expectedRevision: number;
+    nextStatus: TenantExecutionState['status'];
+    nextStepId: string;
+    terminal: boolean;
+    nowIso: string;
+    sideEffectKey?: string;
+    sideEffectLabel?: string;
+}, schemaName?: string): Promise<'ok' | 'stale' | 'missing'>;
+export declare function insertDispatchOutbox(db: PostgresJsDatabase, execution: TenantExecutionState, stepId: string, nowIso: string, schemaName?: string): Promise<DispatchOutboxRow>;
+export declare function listUnpublishedOutbox(db: PostgresJsDatabase, schemaName?: string): Promise<DispatchOutboxRow[]>;
+export declare function markOutboxPublished(db: PostgresJsDatabase, outboxId: string, spineRowId: string, nowIso: string, schemaName?: string): Promise<void>;
+export declare function markOutboxAcked(db: PostgresJsDatabase, outboxId: string, nowIso: string, schemaName?: string): Promise<void>;
+export declare function publishOutboxToSpine(tenantDb: PostgresJsDatabase, spineDb: PostgresJsDatabase, outbox: DispatchOutboxRow, dispatchId: string, nowIso: string, schemaName?: string): Promise<OpaqueDispatchRecord>;
+export declare function bumpTenantEpochOnDb(db: PostgresJsDatabase, schemaName?: string): Promise<number>;
+export declare function listSideEffects(db: PostgresJsDatabase, schemaName?: string): Promise<string[]>;
+//# sourceMappingURL=postgres-persist.d.ts.map

package/dist/durable/postgres-persist.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-persist.d.ts","sourceRoot":"","sources":["../../src/durable/postgres-persist.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAOlE,OAAO,EAKL,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AAiEpB,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,kBAAkB,EACtB,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAO3C;AAED,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,kBAAkB,EACtB,KAAK,EAAE;IACL,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB,EACD,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC;IAAE,SAAS,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC,CA2CzE;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,kBAAkB,EACtB,KAAK,EAAE;IACL,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,EACD,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC,CA6BrC;AAED,wBAAsB,oBAAoB,CACxC,EAAE,EAAE,kBAAkB,EACtB,SAAS,EAAE,oBAAoB,EAC/B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC,iBAAiB,CAAC,CAqB5B;AAED,wBAAsB,qBAAqB,CACzC,EAAE,EAAE,kBAAkB,EACtB,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAM9B;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,kBAAkB,EACtB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,eAAe,CACnC,EAAE,EAAE,kBAAkB,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,kBAAkB,EAC5B,OAAO,EAAE,kBAAkB,EAC3B,MAAM,EAAE,iBAAiB,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC,oBAAoB,CAAC,CAuB/B;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,kBAAkB,EACtB,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED,wBAAsB,eAAe,CACnC,EAAE,EAAE,kBAAkB,EACtB,UAAU,GAAE,MAAyB,GACpC,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB"}

package/dist/durable/postgres-persist.js

@@ -0,0 +1,239 @@
+// Tenant-local Protocol A writes against real Postgres. Same CAS + outbox
+// pairing as persist-before-ack.ts; used by the flow engine when spineDispatch
+// is configured.
+import { sql } from 'drizzle-orm';
+import { randomUUID } from 'node:crypto';
+import { PlumbusError } from '../errors/index.js';
+import { FRAMEWORK_SCHEMA } from '../data/schema-generator.js';
+import { qualifyTable } from './apply-ddl.js';
+import { createOpaqueDispatchRecord } from './opaque-dispatch.js';
+import { upsertSpineDispatch } from './spine-claim.js';
+import { DEFAULT_PRIORITY_CLASS_ID, DEFAULT_WORK_CLASS_ID, DurableExecutionStatus, SpineDeliveryState, } from './types.js';
+function asRows(result) {
+    if (Array.isArray(result))
+        return result;
+    return [];
+}
+function toIso(value) {
+    if (value == null)
+        return undefined;
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === 'string')
+        return value;
+    return String(value);
+}
+function requiredIso(value, field) {
+    const instant = toIso(value);
+    if (instant === undefined)
+        throw new PlumbusError('internal', 'Durable record is missing a required timestamp', { field });
+    return instant;
+}
+function mapExecution(row) {
+    return {
+        executionId: String(row.execution_id),
+        stateRefId: String(row.state_ref_id),
+        tenantRef: String(row.tenant_ref),
+        revision: Number(row.revision),
+        tenantEpoch: Number(row.tenant_epoch),
+        status: row.status,
+        definitionId: String(row.definition_id),
+        definitionVersion: String(row.definition_version),
+        currentStepId: String(row.current_step_id),
+        stepIndex: Number(row.step_index),
+        attempt: Number(row.attempt),
+        correlationId: String(row.correlation_id),
+        createdAt: requiredIso(row.created_at, 'created_at'),
+        updatedAt: requiredIso(row.updated_at, 'updated_at'),
+        wakeAt: toIso(row.wake_at),
+        terminal: Boolean(row.terminal),
+    };
+}
+function mapOutbox(row) {
+    return {
+        outboxId: String(row.outbox_id),
+        executionId: String(row.execution_id),
+        stateRefId: String(row.state_ref_id),
+        expectedRevision: Number(row.expected_revision),
+        tenantEpoch: Number(row.tenant_epoch),
+        tenantRef: String(row.tenant_ref),
+        stepId: String(row.step_id),
+        definitionId: String(row.definition_id),
+        definitionVersion: String(row.definition_version),
+        correlationId: String(row.correlation_id),
+        workClassId: String(row.work_class_id),
+        priorityClassId: String(row.priority_class_id),
+        notBefore: requiredIso(row.not_before, 'not_before'),
+        createdAt: requiredIso(row.created_at, 'created_at'),
+        publishedAt: toIso(row.published_at),
+        spineRowId: row.spine_row_id == null ? undefined : String(row.spine_row_id),
+        spineAckedAt: toIso(row.spine_acked_at),
+        superseded: Boolean(row.superseded),
+    };
+}
+export async function loadExecutionState(db, executionId, schemaName = FRAMEWORK_SCHEMA) {
+    const table = qualifyTable(schemaName, 'execution_state');
+    const result = await db.execute(sql `SELECT * FROM ${sql.raw(table)} WHERE execution_id = ${executionId} LIMIT 1`);
+    const row = asRows(result)[0];
+    return row ? mapExecution(row) : undefined;
+}
+export async function persistAcceptanceOnDb(db, input, schemaName = FRAMEWORK_SCHEMA) {
+    const executionTable = qualifyTable(schemaName, 'execution_state');
+    const outboxTable = qualifyTable(schemaName, 'dispatch_outbox');
+    const stateRefId = `state:${input.executionId}`;
+    const outboxId = `outbox:${input.executionId}:1:${randomUUID()}`;
+    await db.execute(sql `
+    INSERT INTO ${sql.raw(executionTable)} (
+      execution_id, state_ref_id, tenant_ref, revision, tenant_epoch, status,
+      definition_id, definition_version, current_step_id, step_index, attempt,
+      correlation_id, created_at, updated_at, terminal
+    ) VALUES (
+      ${input.executionId}, ${stateRefId}, ${input.tenantRef}, 1, 1, ${DurableExecutionStatus.Created},
+      ${input.definitionId}, ${input.definitionVersion}, ${input.firstStepId}, 0, 0,
+      ${input.correlationId}, ${input.nowIso}::timestamptz, ${input.nowIso}::timestamptz, false
+    )
+    ON CONFLICT (execution_id) DO NOTHING
+  `);
+    await db.execute(sql `
+    INSERT INTO ${sql.raw(outboxTable)} (
+      outbox_id, execution_id, state_ref_id, expected_revision, tenant_epoch,
+      tenant_ref, step_id, definition_id, definition_version, correlation_id,
+      work_class_id, priority_class_id, not_before, created_at, superseded
+    ) VALUES (
+      ${outboxId}, ${input.executionId}, ${stateRefId}, 1, 1,
+      ${input.tenantRef}, ${input.firstStepId}, ${input.definitionId}, ${input.definitionVersion},
+      ${input.correlationId}, ${DEFAULT_WORK_CLASS_ID}, ${DEFAULT_PRIORITY_CLASS_ID},
+      ${input.nowIso}::timestamptz, ${input.nowIso}::timestamptz, false
+    )
+    ON CONFLICT (outbox_id) DO NOTHING
+  `);
+    const execution = await loadExecutionState(db, input.executionId, schemaName);
+    if (!execution)
+        throw new Error('persistAcceptanceOnDb wrote no execution_state');
+    const outboxRows = asRows(await db.execute(sql `SELECT * FROM ${sql.raw(outboxTable)} WHERE execution_id = ${input.executionId} AND expected_revision = 1 LIMIT 1`));
+    const outbox = outboxRows[0] ? mapOutbox(outboxRows[0]) : undefined;
+    if (!outbox)
+        throw new Error('persistAcceptanceOnDb wrote no dispatch_outbox');
+    return { execution, outbox };
+}
+export async function casAdvanceExecution(db, input, schemaName = FRAMEWORK_SCHEMA) {
+    const executionTable = qualifyTable(schemaName, 'execution_state');
+    const result = await db.execute(sql `
+    UPDATE ${sql.raw(executionTable)}
+    SET revision = ${input.expectedRevision + 1},
+        status = ${input.nextStatus},
+        current_step_id = ${input.nextStepId},
+        step_index = step_index + 1,
+        terminal = ${input.terminal},
+        updated_at = ${input.nowIso}::timestamptz,
+        wake_at = NULL
+    WHERE execution_id = ${input.executionId}
+      AND revision = ${input.expectedRevision}
+      AND terminal = false
+    RETURNING execution_id
+  `);
+    if (asRows(result).length === 0) {
+        const existing = await loadExecutionState(db, input.executionId, schemaName);
+        return existing ? 'stale' : 'missing';
+    }
+    if (input.sideEffectKey && input.sideEffectLabel) {
+        const effects = qualifyTable(schemaName, 'side_effect_log');
+        await db.execute(sql `
+      INSERT INTO ${sql.raw(effects)} (effect_key, label, applied_at)
+      VALUES (${input.sideEffectKey}, ${input.sideEffectLabel}, ${input.nowIso}::timestamptz)
+      ON CONFLICT (effect_key) DO NOTHING
+    `);
+    }
+    return 'ok';
+}
+export async function insertDispatchOutbox(db, execution, stepId, nowIso, schemaName = FRAMEWORK_SCHEMA) {
+    const outboxTable = qualifyTable(schemaName, 'dispatch_outbox');
+    const outboxId = `outbox:${execution.executionId}:${execution.revision}:${randomUUID()}`;
+    await db.execute(sql `
+    INSERT INTO ${sql.raw(outboxTable)} (
+      outbox_id, execution_id, state_ref_id, expected_revision, tenant_epoch,
+      tenant_ref, step_id, definition_id, definition_version, correlation_id,
+      work_class_id, priority_class_id, not_before, created_at, superseded
+    ) VALUES (
+      ${outboxId}, ${execution.executionId}, ${execution.stateRefId}, ${execution.revision},
+      ${execution.tenantEpoch}, ${execution.tenantRef}, ${stepId}, ${execution.definitionId},
+      ${execution.definitionVersion}, ${execution.correlationId}, ${DEFAULT_WORK_CLASS_ID},
+      ${DEFAULT_PRIORITY_CLASS_ID}, ${nowIso}::timestamptz, ${nowIso}::timestamptz, false
+    )
+  `);
+    const rows = asRows(await db.execute(sql `SELECT * FROM ${sql.raw(outboxTable)} WHERE outbox_id = ${outboxId}`));
+    const row = rows[0];
+    if (!row)
+        throw new PlumbusError('internal', 'Inserted dispatch outbox row could not be read');
+    return mapOutbox(row);
+}
+export async function listUnpublishedOutbox(db, schemaName = FRAMEWORK_SCHEMA) {
+    const outboxTable = qualifyTable(schemaName, 'dispatch_outbox');
+    const result = await db.execute(sql `SELECT * FROM ${sql.raw(outboxTable)} WHERE superseded = false AND spine_acked_at IS NULL`);
+    return asRows(result).map(mapOutbox);
+}
+export async function markOutboxPublished(db, outboxId, spineRowId, nowIso, schemaName = FRAMEWORK_SCHEMA) {
+    const outboxTable = qualifyTable(schemaName, 'dispatch_outbox');
+    await db.execute(sql `
+    UPDATE ${sql.raw(outboxTable)}
+    SET published_at = ${nowIso}::timestamptz, spine_row_id = ${spineRowId}
+    WHERE outbox_id = ${outboxId}
+  `);
+}
+export async function markOutboxAcked(db, outboxId, nowIso, schemaName = FRAMEWORK_SCHEMA) {
+    const outboxTable = qualifyTable(schemaName, 'dispatch_outbox');
+    await db.execute(sql `
+    UPDATE ${sql.raw(outboxTable)}
+    SET spine_acked_at = ${nowIso}::timestamptz
+    WHERE outbox_id = ${outboxId}
+  `);
+}
+export async function publishOutboxToSpine(tenantDb, spineDb, outbox, dispatchId, nowIso, schemaName = FRAMEWORK_SCHEMA) {
+    const record = createOpaqueDispatchRecord({
+        dispatchId,
+        tenantRouteId: outbox.tenantRef,
+        executionId: outbox.executionId,
+        definitionId: outbox.definitionId,
+        definitionVersion: outbox.definitionVersion,
+        stepId: outbox.stepId,
+        tenantExecutionStateRefId: outbox.stateRefId,
+        expectedRevision: outbox.expectedRevision,
+        tenantEpoch: outbox.tenantEpoch,
+        workClassId: outbox.workClassId,
+        priorityClassId: outbox.priorityClassId,
+        deliveryState: SpineDeliveryState.Ready,
+        attempt: 0,
+        notBefore: outbox.notBefore,
+        correlationId: outbox.correlationId,
+        createdAt: nowIso,
+        updatedAt: nowIso,
+    });
+    const upserted = await upsertSpineDispatch(spineDb, record);
+    await markOutboxPublished(tenantDb, outbox.outboxId, upserted.dispatchId, nowIso, schemaName);
+    return upserted;
+}
+export async function bumpTenantEpochOnDb(db, schemaName = FRAMEWORK_SCHEMA) {
+    const executionTable = qualifyTable(schemaName, 'execution_state');
+    const outboxTable = qualifyTable(schemaName, 'dispatch_outbox');
+    const result = await db.execute(sql `
+    UPDATE ${sql.raw(executionTable)}
+    SET tenant_epoch = tenant_epoch + 1, updated_at = now()
+    RETURNING tenant_epoch
+  `);
+    const rows = asRows(result);
+    const nextEpoch = rows[0] ? Number(rows[0].tenant_epoch) : 2;
+    await db.execute(sql `
+    UPDATE ${sql.raw(outboxTable)}
+    SET tenant_epoch = ${nextEpoch},
+        published_at = NULL,
+        spine_row_id = NULL
+    WHERE spine_acked_at IS NULL
+  `);
+    return nextEpoch;
+}
+export async function listSideEffects(db, schemaName = FRAMEWORK_SCHEMA) {
+    const table = qualifyTable(schemaName, 'side_effect_log');
+    const result = await db.execute(sql `SELECT label FROM ${sql.raw(table)} ORDER BY applied_at`);
+    return asRows(result).map((row) => String(row.label));
+}
+//# sourceMappingURL=postgres-persist.js.map

package/dist/durable/postgres-persist.js.map

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

package/dist/durable/reconciliation.d.ts

@@ -0,0 +1,20 @@
+import type { MemorySpineStore, MemoryTenantStore } from './memory-store.js';
+import { spineDispatchKey } from './memory-store.js';
+import { type DispatchOutboxRow, type OpaqueDispatchRecord } from './types.js';
+export interface SweepClock {
+    nowIso(): string;
+    /** Outbox older than this many ms is eligible. 0 = any unacked row. */
+    outboxAgeMs: number;
+    /** Spine row older than this many ms is eligible. 0 = any expired/unacked row. */
+    spineAgeMs: number;
+}
+export interface SweepHooks {
+    publish(row: DispatchOutboxRow): OpaqueDispatchRecord;
+    afterTenantRepublish?(): void;
+    afterSpineAck?(): void;
+}
+export declare function runTenantSweep(tenant: MemoryTenantStore, _spine: MemorySpineStore, clock: SweepClock, hooks: SweepHooks): number;
+export declare function runSpineSweep(tenant: MemoryTenantStore, spine: MemorySpineStore, clock: SweepClock, hooks?: Pick<SweepHooks, 'afterSpineAck'>): number;
+export declare function publishOutboxRow(tenant: MemoryTenantStore, spine: MemorySpineStore, row: DispatchOutboxRow, nowIso: string, idFactory: () => string): OpaqueDispatchRecord;
+export { spineDispatchKey };
+//# sourceMappingURL=reconciliation.d.ts.map

package/dist/durable/reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconciliation.d.ts","sourceRoot":"","sources":["../../src/durable/reconciliation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,OAAO,EAAsB,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEnG,MAAM,WAAW,UAAU;IACzB,MAAM,IAAI,MAAM,CAAC;IACjB,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,GAAG,EAAE,iBAAiB,GAAG,oBAAoB,CAAC;IACtD,oBAAoB,CAAC,IAAI,IAAI,CAAC;IAC9B,aAAa,CAAC,IAAI,IAAI,CAAC;CACxB;AAMD,wBAAgB,cAAc,CAC5B,MAAM,EAAE,iBAAiB,EACzB,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,UAAU,EACjB,KAAK,EAAE,UAAU,GAChB,MAAM,CA+BR;AAED,wBAAgB,aAAa,CAC3B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,gBAAgB,EACvB,KAAK,EAAE,UAAU,EACjB,KAAK,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,GACxC,MAAM,CA2BR;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,KAAK,EAAE,gBAAgB,EACvB,GAAG,EAAE,iBAAiB,EACtB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,MAAM,GACtB,oBAAoB,CAyBtB;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}