@zhivex-ai/core 1.17.0 → 1.19.1

package/dist/workflow-state-service/postgres.js

@@ -0,0 +1,179 @@
+import { ConflictError } from "../errors.js";
+import { assertPostgresClient } from "../postgres-client.js";
+import { validateIdentifier, workflowStateKey, legacyWorkflowStateKey, parseWorkflowStateJson, getRecordField, matchesWorkflowStateLookup, cloneRecord, assertExpectedRevision, createRecord } from "./shared.js";
+const ensurePostgresTable = (() => {
+    const initializedTables = new WeakMap();
+    return async (client, tableName, createSql) => {
+        let tables = initializedTables.get(client);
+        if (!tables) {
+            tables = new Map();
+            initializedTables.set(client, tables);
+        }
+        let initialization = tables.get(tableName);
+        if (!initialization) {
+            initialization = Promise.resolve(client.query(createSql, [])).then(() => undefined);
+            tables.set(tableName, initialization);
+        }
+        await initialization;
+    };
+})();
+export const createPostgresWorkflowStateService = (options) => {
+    assertPostgresClient(options.client);
+    const tableName = validateIdentifier(options.tableName ?? "zhivex_workflow_states", "tableName");
+    const createSql = `
+    CREATE TABLE IF NOT EXISTS ${tableName} (
+      workflow_state_key TEXT PRIMARY KEY,
+      app_name TEXT NOT NULL,
+      user_id TEXT NOT NULL,
+      session_id TEXT NOT NULL,
+      workflow_key TEXT NOT NULL,
+      run_id TEXT NOT NULL,
+      status TEXT NOT NULL,
+      state_json JSONB NOT NULL,
+      created_at_ms BIGINT NOT NULL,
+      updated_at_ms BIGINT NOT NULL
+    )
+  `;
+    const load = async (input) => {
+        await ensurePostgresTable(options.client, tableName, createSql);
+        for (const key of [workflowStateKey(input), legacyWorkflowStateKey(input)]) {
+            const result = await options.client.query(`SELECT state_json FROM ${tableName} WHERE workflow_state_key = $1`, [key]);
+            const record = parseWorkflowStateJson(getRecordField(result.rows[0], ["state_json", "stateJson"]));
+            if (record && matchesWorkflowStateLookup(record, input)) {
+                return record;
+            }
+        }
+        return undefined;
+    };
+    const save = async (record, saveOptions) => {
+        await ensurePostgresTable(options.client, tableName, createSql);
+        if (saveOptions?.expectedRevision !== undefined && saveOptions.existing) {
+            const result = await options.client.query(`UPDATE ${tableName}
+         SET app_name = $2,
+             user_id = $3,
+             session_id = $4,
+             workflow_key = $5,
+             run_id = $6,
+             status = $7,
+             state_json = $8::jsonb,
+             updated_at_ms = $9
+         WHERE workflow_state_key = $1
+           AND updated_at_ms = $10
+         RETURNING state_json`, [
+                workflowStateKey(record),
+                record.appName,
+                record.userId,
+                record.sessionId,
+                record.workflowKey,
+                record.runId,
+                record.status,
+                JSON.stringify(record),
+                record.updatedAt,
+                saveOptions.existing.updatedAt
+            ]);
+            if (result.rows.length === 0) {
+                const migrated = await options.client.query(`UPDATE ${tableName}
+           SET workflow_state_key = $1,
+               app_name = $2,
+               user_id = $3,
+               session_id = $4,
+               workflow_key = $5,
+               run_id = $6,
+               status = $7,
+               state_json = $8::jsonb,
+               updated_at_ms = $9
+           WHERE workflow_state_key = $10
+             AND updated_at_ms = $11
+           RETURNING state_json`, [
+                    workflowStateKey(record),
+                    record.appName,
+                    record.userId,
+                    record.sessionId,
+                    record.workflowKey,
+                    record.runId,
+                    record.status,
+                    JSON.stringify(record),
+                    record.updatedAt,
+                    legacyWorkflowStateKey(record),
+                    saveOptions.existing.updatedAt
+                ]);
+                if (migrated.rows.length === 0) {
+                    throw new ConflictError("WorkflowStateRecord revision conflict.");
+                }
+            }
+        }
+        else {
+            await options.client.query(`INSERT INTO ${tableName} (
+           workflow_state_key, app_name, user_id, session_id, workflow_key, run_id, status, state_json, created_at_ms, updated_at_ms
+         )
+         VALUES ($1, $2, $3, $4, $5, $6, $7, $8::jsonb, $9, $10)
+         ON CONFLICT(workflow_state_key) DO UPDATE SET
+           app_name = EXCLUDED.app_name,
+           user_id = EXCLUDED.user_id,
+           session_id = EXCLUDED.session_id,
+           workflow_key = EXCLUDED.workflow_key,
+           run_id = EXCLUDED.run_id,
+           status = EXCLUDED.status,
+           state_json = EXCLUDED.state_json,
+           updated_at_ms = EXCLUDED.updated_at_ms`, [
+                workflowStateKey(record),
+                record.appName,
+                record.userId,
+                record.sessionId,
+                record.workflowKey,
+                record.runId,
+                record.status,
+                JSON.stringify(record),
+                record.createdAt,
+                record.updatedAt
+            ]);
+        }
+        const legacyResult = await options.client.query(`SELECT state_json FROM ${tableName} WHERE workflow_state_key = $1`, [legacyWorkflowStateKey(record)]);
+        const legacy = parseWorkflowStateJson(getRecordField(legacyResult.rows[0], ["state_json", "stateJson"]));
+        if (legacy && matchesWorkflowStateLookup(legacy, record)) {
+            await options.client.query(`DELETE FROM ${tableName} WHERE workflow_state_key = $1`, [legacyWorkflowStateKey(record)]);
+        }
+        return cloneRecord(record);
+    };
+    return {
+        async saveWorkflowState(input) {
+            const existing = await load(input);
+            assertExpectedRevision(existing, input.expectedRevision);
+            return save(createRecord(input, existing), {
+                existing,
+                expectedRevision: input.expectedRevision
+            });
+        },
+        loadWorkflowState(input) {
+            return load(input);
+        },
+        async listWorkflowStates(input) {
+            await ensurePostgresTable(options.client, tableName, createSql);
+            const result = await options.client.query(`SELECT state_json FROM ${tableName}
+         WHERE app_name = $1
+           AND user_id = $2
+           AND ($3::text IS NULL OR session_id = $3)
+           AND ($4::text IS NULL OR workflow_key = $4)
+           AND ($5::text IS NULL OR status = $5)
+         ORDER BY updated_at_ms ASC, workflow_key ASC`, [input.appName, input.userId, input.sessionId ?? null, input.workflowKey ?? null, input.status ?? null]);
+            const records = new Map();
+            for (const row of result.rows) {
+                const record = parseWorkflowStateJson(getRecordField(row, ["state_json", "stateJson"]));
+                if (record) {
+                    records.set(workflowStateKey(record), record);
+                }
+            }
+            return [...records.values()];
+        },
+        async deleteWorkflowState(input) {
+            await ensurePostgresTable(options.client, tableName, createSql);
+            await options.client.query(`DELETE FROM ${tableName} WHERE workflow_state_key = $1`, [workflowStateKey(input)]);
+            const legacyResult = await options.client.query(`SELECT state_json FROM ${tableName} WHERE workflow_state_key = $1`, [legacyWorkflowStateKey(input)]);
+            const legacy = parseWorkflowStateJson(getRecordField(legacyResult.rows[0], ["state_json", "stateJson"]));
+            if (legacy && matchesWorkflowStateLookup(legacy, input)) {
+                await options.client.query(`DELETE FROM ${tableName} WHERE workflow_state_key = $1`, [legacyWorkflowStateKey(input)]);
+            }
+        }
+    };
+};
+//# sourceMappingURL=postgres.js.map

package/dist/workflow-state-service/postgres.js.map

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

package/dist/workflow-state-service/shared.d.ts

@@ -0,0 +1,43 @@
+import type { PostgresClientLike, SqliteDatabaseLike } from "../types.js";
+import { WORKFLOW_STATE_RECORD_SCHEMA_VERSION, type WorkflowStateListInput, type WorkflowStateRecord, type WorkflowStateSaveInput, type WorkflowStateServiceLookup } from "../workflow-state-contracts.js";
+export interface FileWorkflowStateServiceOptions {
+    directory: string;
+}
+export interface FileWorkflowStateStorePruneOptions extends FileWorkflowStateServiceOptions {
+    olderThanMs?: number;
+    keepLast?: number;
+    now?: number;
+    dryRun?: boolean;
+}
+export interface FileWorkflowStateStorePruneResult {
+    directory: string;
+    dryRun: boolean;
+    deletedWorkflowStateKeys: string[];
+    keptWorkflowStateKeys: string[];
+}
+export interface SqliteWorkflowStateServiceOptions {
+    db: SqliteDatabaseLike;
+    tableName?: string;
+}
+export interface PostgresWorkflowStateServiceOptions {
+    client: PostgresClientLike;
+    tableName?: string;
+}
+export type WorkflowStateRecordMigrationTarget = typeof WORKFLOW_STATE_RECORD_SCHEMA_VERSION;
+export type WorkflowStateLookup = WorkflowStateServiceLookup;
+export declare const workflowStateParts: (input: WorkflowStateLookup) => readonly [string, string, string, string];
+export declare const workflowStateKey: (input: WorkflowStateLookup) => string;
+export declare const legacyWorkflowStateKey: (input: WorkflowStateLookup) => string;
+export declare const matchesWorkflowStateLookup: (record: WorkflowStateRecord, input: WorkflowStateLookup) => boolean;
+export declare const normalizeWorkflowStateRecord: (value: unknown) => WorkflowStateRecord;
+export declare const migrateWorkflowStateRecord: (value: unknown, targetVersion?: WorkflowStateRecordMigrationTarget) => WorkflowStateRecord;
+export declare const assertExpectedRevision: (current: {
+    revision: number;
+} | undefined, expectedRevision: number | undefined) => void;
+export declare const cloneRecord: (record: WorkflowStateRecord) => WorkflowStateRecord;
+export declare const createRecord: (input: WorkflowStateSaveInput, existing?: WorkflowStateRecord) => WorkflowStateRecord;
+export declare const matchesListInput: (record: WorkflowStateRecord, input: WorkflowStateListInput) => boolean;
+export declare const validateIdentifier: (value: string, fieldName: string) => string;
+export declare const getRecordField: (value: unknown, candidates: string[]) => unknown;
+export declare const parseWorkflowStateJson: (value: unknown) => WorkflowStateRecord | undefined;
+//# sourceMappingURL=shared.d.ts.map

package/dist/workflow-state-service/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/workflow-state-service/shared.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAGL,oCAAoC,EACpC,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAEhC,MAAM,gCAAgC,CAAC;AAMxC,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kCAAmC,SAAQ,+BAA+B;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,iCAAiC;IAChD,EAAE,EAAE,kBAAkB,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kCAAkC,GAAG,OAAO,oCAAoC,CAAC;AAE7F,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;AAE7D,eAAO,MAAM,kBAAkB,UAAW,mBAAmB,8CACe,CAAC;AAE7E,eAAO,MAAM,gBAAgB,UAAW,mBAAmB,KAAG,MACE,CAAC;AAEjE,eAAO,MAAM,sBAAsB,UAAW,mBAAmB,KAAG,MACQ,CAAC;AAE7E,eAAO,MAAM,0BAA0B,WAAY,mBAAmB,SAAS,mBAAmB,YAIxD,CAAC;AAE3C,eAAO,MAAM,4BAA4B,UAAW,OAAO,KAAG,mBAkC7D,CAAC;AAEF,eAAO,MAAM,0BAA0B,UAC9B,OAAO,kBACC,kCAAkC,KAChD,mBAKF,CAAC;AAEF,eAAO,MAAM,sBAAsB,YACxB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,oBACvB,MAAM,GAAG,SAAS,SAKrC,CAAC;AAEF,eAAO,MAAM,WAAW,WAAY,mBAAmB,KAAG,mBAAsE,CAAC;AAEjI,eAAO,MAAM,YAAY,UAAW,sBAAsB,aAAa,mBAAmB,KAAG,mBAgB5F,CAAC;AAEF,eAAO,MAAM,gBAAgB,WAAY,mBAAmB,SAAS,sBAAsB,KAAG,OAK9B,CAAC;AAEjE,eAAO,MAAM,kBAAkB,UAAW,MAAM,aAAa,MAAM,KAAG,MAKrE,CAAC;AAEF,eAAO,MAAM,cAAc,UAAW,OAAO,cAAc,MAAM,EAAE,KAAG,OAWrE,CAAC;AAEF,eAAO,MAAM,sBAAsB,UAAW,OAAO,KAAG,mBAAmB,GAAG,SAQ7E,CAAC"}

package/dist/workflow-state-service/shared.js

@@ -0,0 +1,107 @@
+import { ConflictError, ValidationError } from "../errors.js";
+import { canonicalStoreKey } from "../store-key.js";
+import { normalizeWorkflowRunState, WORKFLOW_RUN_STATE_SCHEMA_VERSION, WORKFLOW_STATE_RECORD_SCHEMA_VERSION } from "../workflow-state-contracts.js";
+const cloneJson = (value) => JSON.parse(JSON.stringify(value));
+const identifierPattern = /^[A-Za-z_][A-Za-z0-9_]*$/;
+export const workflowStateParts = (input) => [input.appName, input.userId, input.sessionId, input.workflowKey];
+export const workflowStateKey = (input) => canonicalStoreKey("workflow-state", workflowStateParts(input));
+export const legacyWorkflowStateKey = (input) => `${input.appName}:${input.userId}:${input.sessionId}:${input.workflowKey}`;
+export const matchesWorkflowStateLookup = (record, input) => record.appName === input.appName &&
+    record.userId === input.userId &&
+    record.sessionId === input.sessionId &&
+    record.workflowKey === input.workflowKey;
+export const normalizeWorkflowStateRecord = (value) => {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new ValidationError("WorkflowStateRecord must be an object.");
+    }
+    const record = value;
+    if (record.schemaVersion !== undefined && record.schemaVersion > WORKFLOW_STATE_RECORD_SCHEMA_VERSION) {
+        throw new ValidationError(`Unsupported WorkflowStateRecord schemaVersion ${record.schemaVersion}.`);
+    }
+    if (typeof record.appName !== "string" ||
+        typeof record.userId !== "string" ||
+        typeof record.sessionId !== "string" ||
+        typeof record.workflowKey !== "string" ||
+        typeof record.runId !== "string" ||
+        typeof record.status !== "string" ||
+        typeof record.createdAt !== "number" ||
+        typeof record.updatedAt !== "number" ||
+        !record.state) {
+        throw new ValidationError("WorkflowStateRecord is missing required fields.");
+    }
+    return {
+        schemaVersion: WORKFLOW_STATE_RECORD_SCHEMA_VERSION,
+        revision: typeof record.revision === "number" ? record.revision : 1,
+        appName: record.appName,
+        userId: record.userId,
+        sessionId: record.sessionId,
+        workflowKey: record.workflowKey,
+        state: normalizeWorkflowRunState(record.state),
+        status: record.status,
+        runId: record.runId,
+        createdAt: record.createdAt,
+        updatedAt: record.updatedAt
+    };
+};
+export const migrateWorkflowStateRecord = (value, targetVersion = WORKFLOW_STATE_RECORD_SCHEMA_VERSION) => {
+    if (targetVersion !== WORKFLOW_STATE_RECORD_SCHEMA_VERSION) {
+        throw new ValidationError(`Unsupported WorkflowStateRecord migration target ${targetVersion}.`);
+    }
+    return normalizeWorkflowStateRecord(value);
+};
+export const assertExpectedRevision = (current, expectedRevision) => {
+    if (expectedRevision !== undefined && (current?.revision ?? 0) !== expectedRevision) {
+        throw new ConflictError("WorkflowStateRecord revision conflict.");
+    }
+};
+export const cloneRecord = (record) => cloneJson(normalizeWorkflowStateRecord(record));
+export const createRecord = (input, existing) => {
+    const now = Date.now();
+    const state = normalizeWorkflowRunState(input.state);
+    return {
+        schemaVersion: WORKFLOW_STATE_RECORD_SCHEMA_VERSION,
+        revision: existing ? existing.revision + 1 : 1,
+        appName: input.appName,
+        userId: input.userId,
+        sessionId: input.sessionId,
+        workflowKey: input.workflowKey,
+        state: cloneJson({ ...state, schemaVersion: WORKFLOW_RUN_STATE_SCHEMA_VERSION }),
+        status: state.status,
+        runId: state.runId,
+        createdAt: existing?.createdAt ?? now,
+        updatedAt: now
+    };
+};
+export const matchesListInput = (record, input) => record.appName === input.appName &&
+    record.userId === input.userId &&
+    (input.sessionId === undefined || record.sessionId === input.sessionId) &&
+    (input.workflowKey === undefined || record.workflowKey === input.workflowKey) &&
+    (input.status === undefined || record.status === input.status);
+export const validateIdentifier = (value, fieldName) => {
+    if (!identifierPattern.test(value)) {
+        throw new ValidationError(`The "${fieldName}" option must match the SQL identifier pattern [A-Za-z_][A-Za-z0-9_]*.`);
+    }
+    return value;
+};
+export const getRecordField = (value, candidates) => {
+    if (!value || typeof value !== "object") {
+        return undefined;
+    }
+    const record = value;
+    for (const candidate of candidates) {
+        if (candidate in record) {
+            return record[candidate];
+        }
+    }
+    return undefined;
+};
+export const parseWorkflowStateJson = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    if (typeof value === "string") {
+        return normalizeWorkflowStateRecord(JSON.parse(value));
+    }
+    return normalizeWorkflowStateRecord(value);
+};
+//# sourceMappingURL=shared.js.map

package/dist/workflow-state-service/shared.js.map

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

package/dist/workflow-state-service/sqlite.d.ts

@@ -0,0 +1,4 @@
+import { type WorkflowStateService } from "../workflow-state-contracts.js";
+import { type SqliteWorkflowStateServiceOptions } from "./shared.js";
+export declare const createSqliteWorkflowStateService: (options: SqliteWorkflowStateServiceOptions) => WorkflowStateService;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/workflow-state-service/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/workflow-state-service/sqlite.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4B,KAAK,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACrG,OAAO,EACL,KAAK,iCAAiC,EAWvC,MAAM,aAAa,CAAC;AAwBrB,eAAO,MAAM,gCAAgC,YAAa,iCAAiC,KAAG,oBAmL7F,CAAC"}

package/dist/workflow-state-service/sqlite.js

@@ -0,0 +1,183 @@
+import { ConflictError, ValidationError } from "../errors.js";
+import { validateIdentifier, workflowStateKey, legacyWorkflowStateKey, parseWorkflowStateJson, getRecordField, matchesWorkflowStateLookup, cloneRecord, assertExpectedRevision, createRecord } from "./shared.js";
+const sqliteMutationCount = (result) => {
+    if (!result || typeof result !== "object") {
+        return undefined;
+    }
+    const record = result;
+    const value = record.changes ?? record.changeset ?? record.rowCount;
+    return typeof value === "number" ? value : undefined;
+};
+const prepareSqliteStatement = (db, sql) => {
+    if (typeof db.prepare === "function") {
+        return db.prepare(sql);
+    }
+    if (typeof db.query === "function") {
+        return db.query(sql);
+    }
+    throw new ValidationError('The "db" option must expose either a "prepare()" or "query()" method.');
+};
+export const createSqliteWorkflowStateService = (options) => {
+    const tableName = validateIdentifier(options.tableName ?? "zhivex_workflow_states", "tableName");
+    options.db.exec(`
+    CREATE TABLE IF NOT EXISTS ${tableName} (
+      workflow_state_key TEXT PRIMARY KEY,
+      app_name TEXT NOT NULL,
+      user_id TEXT NOT NULL,
+      session_id TEXT NOT NULL,
+      workflow_key TEXT NOT NULL,
+      run_id TEXT NOT NULL,
+      status TEXT NOT NULL,
+      state_json TEXT NOT NULL,
+      created_at_ms INTEGER NOT NULL,
+      updated_at_ms INTEGER NOT NULL
+    )
+  `);
+    const loadStatement = prepareSqliteStatement(options.db, `SELECT state_json FROM ${tableName} WHERE workflow_state_key = ?`);
+    const listStatement = prepareSqliteStatement(options.db, `SELECT state_json FROM ${tableName}
+     WHERE app_name = ?
+       AND user_id = ?
+       AND (? IS NULL OR session_id = ?)
+       AND (? IS NULL OR workflow_key = ?)
+       AND (? IS NULL OR status = ?)
+     ORDER BY updated_at_ms ASC, workflow_key ASC`);
+    const saveStatement = prepareSqliteStatement(options.db, `
+    INSERT INTO ${tableName} (
+      workflow_state_key, app_name, user_id, session_id, workflow_key, run_id, status, state_json, created_at_ms, updated_at_ms
+    )
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    ON CONFLICT(workflow_state_key) DO UPDATE SET
+      app_name = excluded.app_name,
+      user_id = excluded.user_id,
+      session_id = excluded.session_id,
+      workflow_key = excluded.workflow_key,
+      run_id = excluded.run_id,
+      status = excluded.status,
+      state_json = excluded.state_json,
+      updated_at_ms = excluded.updated_at_ms
+  `);
+    const updateCasStatement = prepareSqliteStatement(options.db, `
+    UPDATE ${tableName}
+    SET app_name = ?,
+        user_id = ?,
+        session_id = ?,
+        workflow_key = ?,
+        run_id = ?,
+        status = ?,
+        state_json = ?,
+        updated_at_ms = ?
+    WHERE workflow_state_key = ?
+      AND updated_at_ms = ?
+  `);
+    const deleteStatement = prepareSqliteStatement(options.db, `DELETE FROM ${tableName} WHERE workflow_state_key = ?`);
+    const load = (input) => {
+        for (const key of [workflowStateKey(input), legacyWorkflowStateKey(input)]) {
+            const record = parseWorkflowStateJson(getRecordField(loadStatement.get([key]), ["state_json", "stateJson"]));
+            if (record && matchesWorkflowStateLookup(record, input)) {
+                return record;
+            }
+        }
+        return undefined;
+    };
+    const save = (record, options) => {
+        if (options?.expectedRevision !== undefined && options.existing) {
+            const canonical = parseWorkflowStateJson(getRecordField(loadStatement.get([workflowStateKey(record)]), ["state_json", "stateJson"]));
+            if (canonical && matchesWorkflowStateLookup(canonical, record)) {
+                const result = updateCasStatement.run([
+                    record.appName,
+                    record.userId,
+                    record.sessionId,
+                    record.workflowKey,
+                    record.runId,
+                    record.status,
+                    JSON.stringify(record),
+                    record.updatedAt,
+                    workflowStateKey(record),
+                    options.existing.updatedAt
+                ]);
+                if (sqliteMutationCount(result) === 0) {
+                    throw new ConflictError("WorkflowStateRecord revision conflict.");
+                }
+            }
+            else {
+                const legacy = parseWorkflowStateJson(getRecordField(loadStatement.get([legacyWorkflowStateKey(record)]), ["state_json", "stateJson"]));
+                if (!legacy || !matchesWorkflowStateLookup(legacy, record) || legacy.updatedAt !== options.existing.updatedAt) {
+                    throw new ConflictError("WorkflowStateRecord revision conflict.");
+                }
+                saveStatement.run([
+                    workflowStateKey(record),
+                    record.appName,
+                    record.userId,
+                    record.sessionId,
+                    record.workflowKey,
+                    record.runId,
+                    record.status,
+                    JSON.stringify(record),
+                    record.createdAt,
+                    record.updatedAt
+                ]);
+            }
+        }
+        else {
+            saveStatement.run([
+                workflowStateKey(record),
+                record.appName,
+                record.userId,
+                record.sessionId,
+                record.workflowKey,
+                record.runId,
+                record.status,
+                JSON.stringify(record),
+                record.createdAt,
+                record.updatedAt
+            ]);
+        }
+        const legacy = parseWorkflowStateJson(getRecordField(loadStatement.get([legacyWorkflowStateKey(record)]), ["state_json", "stateJson"]));
+        if (legacy && matchesWorkflowStateLookup(legacy, record)) {
+            deleteStatement.run([legacyWorkflowStateKey(record)]);
+        }
+        return cloneRecord(record);
+    };
+    return {
+        saveWorkflowState(input) {
+            const existing = load(input);
+            assertExpectedRevision(existing, input.expectedRevision);
+            return save(createRecord(input, existing), {
+                existing,
+                expectedRevision: input.expectedRevision
+            });
+        },
+        loadWorkflowState(input) {
+            return load(input);
+        },
+        listWorkflowStates(input) {
+            const params = [
+                input.appName,
+                input.userId,
+                input.sessionId ?? null,
+                input.sessionId ?? null,
+                input.workflowKey ?? null,
+                input.workflowKey ?? null,
+                input.status ?? null,
+                input.status ?? null
+            ];
+            const rows = listStatement.all?.(params) ?? [];
+            const records = new Map();
+            for (const row of rows) {
+                const record = parseWorkflowStateJson(getRecordField(row, ["state_json", "stateJson"]));
+                if (record) {
+                    records.set(workflowStateKey(record), record);
+                }
+            }
+            return [...records.values()];
+        },
+        deleteWorkflowState(input) {
+            deleteStatement.run([workflowStateKey(input)]);
+            const legacy = parseWorkflowStateJson(getRecordField(loadStatement.get([legacyWorkflowStateKey(input)]), ["state_json", "stateJson"]));
+            if (legacy && matchesWorkflowStateLookup(legacy, input)) {
+                deleteStatement.run([legacyWorkflowStateKey(input)]);
+            }
+        }
+    };
+};
+//# sourceMappingURL=sqlite.js.map

package/dist/workflow-state-service/sqlite.js.map

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

package/dist/workflow-state-service.d.ts

@@ -1,36 +1,9 @@
-import type { PostgresClientLike, SqliteDatabaseLike } from "./types.js";
-import { WORKFLOW_STATE_RECORD_SCHEMA_VERSION, type WorkflowStateRecord, type WorkflowStateService } from "./workflow-state-contracts.js";
+/** Compatibility facade. Backend implementations live in dedicated internal modules. */
 export { WORKFLOW_STATE_RECORD_SCHEMA_VERSION } from "./workflow-state-contracts.js";
 export type { WorkflowStateListInput, WorkflowStateRecord, WorkflowStateSaveInput, WorkflowStateService, WorkflowStateServiceLookup as WorkflowStateLookup } from "./workflow-state-contracts.js";
-export interface FileWorkflowStateServiceOptions {
-    directory: string;
-}
-export interface FileWorkflowStateStorePruneOptions extends FileWorkflowStateServiceOptions {
-    olderThanMs?: number;
-    keepLast?: number;
-    now?: number;
-    dryRun?: boolean;
-}
-export interface FileWorkflowStateStorePruneResult {
-    directory: string;
-    dryRun: boolean;
-    deletedWorkflowStateKeys: string[];
-    keptWorkflowStateKeys: string[];
-}
-export interface SqliteWorkflowStateServiceOptions {
-    db: SqliteDatabaseLike;
-    tableName?: string;
-}
-export interface PostgresWorkflowStateServiceOptions {
-    client: PostgresClientLike;
-    tableName?: string;
-}
-export type WorkflowStateRecordMigrationTarget = typeof WORKFLOW_STATE_RECORD_SCHEMA_VERSION;
-export declare const normalizeWorkflowStateRecord: (value: unknown) => WorkflowStateRecord;
-export declare const migrateWorkflowStateRecord: (value: unknown, targetVersion?: WorkflowStateRecordMigrationTarget) => WorkflowStateRecord;
-export declare const createInMemoryWorkflowStateService: () => WorkflowStateService;
-export declare const createFileWorkflowStateService: (options: FileWorkflowStateServiceOptions) => WorkflowStateService;
-export declare const pruneFileWorkflowStateStore: (options: FileWorkflowStateStorePruneOptions) => Promise<FileWorkflowStateStorePruneResult>;
-export declare const createSqliteWorkflowStateService: (options: SqliteWorkflowStateServiceOptions) => WorkflowStateService;
-export declare const createPostgresWorkflowStateService: (options: PostgresWorkflowStateServiceOptions) => WorkflowStateService;
+export { type FileWorkflowStateServiceOptions, type FileWorkflowStateStorePruneOptions, type FileWorkflowStateStorePruneResult, type SqliteWorkflowStateServiceOptions, type PostgresWorkflowStateServiceOptions, type WorkflowStateRecordMigrationTarget, normalizeWorkflowStateRecord, migrateWorkflowStateRecord } from "./workflow-state-service/shared.js";
+export { createInMemoryWorkflowStateService } from "./workflow-state-service/memory.js";
+export { createFileWorkflowStateService, pruneFileWorkflowStateStore } from "./workflow-state-service/file.js";
+export { createSqliteWorkflowStateService } from "./workflow-state-service/sqlite.js";
+export { createPostgresWorkflowStateService } from "./workflow-state-service/postgres.js";
 //# sourceMappingURL=workflow-state-service.d.ts.map

package/dist/workflow-state-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-state-service.d.ts","sourceRoot":"","sources":["../src/workflow-state-service.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAa,kBAAkB,EAAE,kBAAkB,EAAuB,MAAM,YAAY,CAAC;AACzG,OAAO,EAGL,oCAAoC,EAEpC,KAAK,mBAAmB,EAExB,KAAK,oBAAoB,EAG1B,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,oCAAoC,EAAE,MAAM,+BAA+B,CAAC;AACrF,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,IAAI,mBAAmB,EAClD,MAAM,+BAA+B,CAAC;AAKvC,MAAM,WAAW,+BAA+B;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kCAAmC,SAAQ,+BAA+B;IACzF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,iCAAiC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,wBAAwB,EAAE,MAAM,EAAE,CAAC;IACnC,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,iCAAiC;IAChD,EAAE,EAAE,kBAAkB,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kCAAkC,GAAG,OAAO,oCAAoC,CAAC;AAsB7F,eAAO,MAAM,4BAA4B,UAAW,OAAO,KAAG,mBAkC7D,CAAC;AAEF,eAAO,MAAM,0BAA0B,UAC9B,OAAO,kBACC,kCAAkC,KAChD,mBAKF,CAAC;AA2GF,eAAO,MAAM,kCAAkC,QAAO,oBAwBrD,CAAC;AAEF,eAAO,MAAM,8BAA8B,YAAa,+BAA+B,KAAG,oBA4FzF,CAAC;AAEF,eAAO,MAAM,2BAA2B,YAC7B,kCAAkC,KAC1C,OAAO,CAAC,iCAAiC,CAsD3C,CAAC;AAEF,eAAO,MAAM,gCAAgC,YAAa,iCAAiC,KAAG,oBAmL7F,CAAC;AAEF,eAAO,MAAM,kCAAkC,YAAa,mCAAmC,KAAG,oBA2LjG,CAAC"}
+{"version":3,"file":"workflow-state-service.d.ts","sourceRoot":"","sources":["../src/workflow-state-service.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,EAAE,oCAAoC,EAAE,MAAM,+BAA+B,CAAC;AACrF,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,oBAAoB,EACpB,0BAA0B,IAAI,mBAAmB,EAClD,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,+BAA+B,EACpC,KAAK,kCAAkC,EACvC,KAAK,iCAAiC,EACtC,KAAK,iCAAiC,EACtC,KAAK,mCAAmC,EACxC,KAAK,kCAAkC,EACvC,4BAA4B,EAC5B,0BAA0B,EAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,kCAAkC,EACnC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,8BAA8B,EAC9B,2BAA2B,EAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,gCAAgC,EACjC,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,kCAAkC,EACnC,MAAM,sCAAsC,CAAC"}