@duraflows/kysely 0.4.0

package/README.md

@@ -0,0 +1,127 @@
+# @duraflows/kysely
+
+[Kysely](https://kysely.dev/) persistence adapter for [duraflows](https://github.com/camcima/duraflows).
+
+Part of the [duraflows](https://github.com/camcima/duraflows) monorepo.
+
+## Features
+
+- Full implementation of `@duraflows/core` persistence interfaces using Kysely query builder
+- Row-level locking with `SKIP LOCKED` for concurrent access safety
+- JSONB storage for workflow context, metadata, and command results
+- Transaction sharing via `AsyncLocalStorage` -- run Duraflows and your own queries in a single Kysely transaction
+- Type-safe `WorkflowDatabase` interface for composing with your own Kysely database types
+
+## Installation
+
+```bash
+npm install @duraflows/core @duraflows/kysely kysely pg
+```
+
+## Quick Start
+
+```ts
+import { WorkflowRuntime, InMemoryDefinitionRegistry, InMemoryCommandRegistry } from "@duraflows/core";
+import { kyselyWorkflowProviders } from "@duraflows/kysely";
+import { Kysely, PostgresDialect } from "kysely";
+import { Pool } from "pg";
+
+const db = new Kysely({
+  dialect: new PostgresDialect({ pool: new Pool({ connectionString: process.env.DATABASE_URL }) }),
+});
+
+const persistence = kyselyWorkflowProviders(db);
+
+const runtime = new WorkflowRuntime({
+  definitionRegistry,
+  commandRegistry,
+  ...persistence,
+  clock: { now: () => new Date() },
+});
+```
+
+## Sharing a Transaction
+
+The primary use case for this package is running Duraflows workflow transitions and your own database writes in a single atomic transaction.
+
+```ts
+import { KyselyTransactionContext } from "@duraflows/kysely";
+
+// Seed the transaction context so Duraflows participates in your transaction
+await db.transaction().execute(async (trx) => {
+  await KyselyTransactionContext.run(trx, async () => {
+    // Your own writes -- uses trx
+    await trx.insertInto("orders").values({ id: "ORD-1", status: "paid" }).execute();
+
+    // Duraflows writes -- also uses trx (same transaction)
+    await runtime.triggerEvent({
+      workflowInstanceUuid: instanceUuid,
+      eventName: "PaymentReceived",
+    });
+  });
+});
+// Both commit or both rollback -- no split-brain
+```
+
+### How It Works
+
+`KyselyTransactionContext` uses Node.js `AsyncLocalStorage` to propagate the active Kysely transaction through the async call chain. When Duraflows' internal `WorkflowTransactionRunner.runInTransaction()` is called, it checks for an existing transaction in the context:
+
+- **Found:** Reuses it (no nested transaction)
+- **Not found:** Starts a new Kysely transaction and seeds the context
+
+This re-entrancy contract means your application code controls the transaction boundary.
+
+## Composing Database Types
+
+Merge `WorkflowDatabase` with your own Kysely database type:
+
+```ts
+import type { WorkflowDatabase } from "@duraflows/kysely";
+
+interface MyDatabase extends WorkflowDatabase {
+  orders: OrdersTable;
+  products: ProductsTable;
+}
+
+const db = new Kysely<MyDatabase>({ ... });
+```
+
+## Database Setup
+
+This package uses the same database schema as `@duraflows/pg`. Use the migration generator from `@duraflows/pg` or copy the reference migration:
+
+```ts
+import { generateMigrationSql } from "@duraflows/pg";
+
+const { up, down } = generateMigrationSql();
+```
+
+See the [`@duraflows/pg` README](https://github.com/camcima/duraflows/tree/main/packages/duraflows-pg#database-setup) for full details.
+
+## API
+
+### `kyselyWorkflowProviders(db): WorkflowPersistenceProvider`
+
+Factory function that creates all required persistence providers from a `Kysely<WorkflowDatabase>` instance. Returns:
+
+- `instanceStore` -- `KyselyWorkflowInstanceStore`
+- `historyStore` -- `KyselyWorkflowHistoryStore`
+- `transactionRunner` -- `KyselyTransactionRunner`
+
+### `kyselyWorkflowProvidersFromTransaction(trx): WorkflowPersistenceProvider`
+
+Convenience factory for short-lived runtimes pre-bound to an existing transaction. The returned transaction runner seeds the context with the bound `trx` if no context already exists.
+
+### `KyselyTransactionContext`
+
+- `getTransaction()` -- Returns the active `Transaction<WorkflowDatabase>` or `undefined`
+- `run(trx, callback)` -- Executes `callback` with `trx` as the active transaction context
+
+## Documentation
+
+See the full documentation in the [duraflows repository](https://github.com/camcima/duraflows).
+
+## License
+
+MIT

package/dist/cjs/index.d.ts

@@ -0,0 +1,24 @@
+import type { Kysely, Transaction } from "kysely";
+import type { WorkflowPersistenceProvider } from "@duraflows/core";
+import type { WorkflowDatabase } from "./kysely-database.js";
+export { KyselyTransactionContext } from "./kysely-transaction-context.js";
+export { KyselyTransactionRunner } from "./kysely-transaction-runner.js";
+export { KyselyWorkflowInstanceStore } from "./kysely-instance-store.js";
+export { KyselyWorkflowHistoryStore } from "./kysely-history-store.js";
+export type { WorkflowDatabase, WorkflowInstancesTable, WorkflowHistoryTable } from "./kysely-database.js";
+/**
+ * Creates long-lived persistence providers from a Kysely instance.
+ *
+ * Generic so callers can pass `Kysely<MyDb & WorkflowDatabase>`.
+ * Internally narrows to `Kysely<WorkflowDatabase>` (safe — stores
+ * only access workflow tables; the `unknown` cast is needed because
+ * Kysely is invariant in its DB type parameter).
+ */
+export declare function kyselyWorkflowProviders<DB extends WorkflowDatabase>(db: Kysely<DB>): WorkflowPersistenceProvider;
+/**
+ * Creates providers pre-bound to an existing Kysely transaction.
+ *
+ * Generic so callers can pass `Transaction<MyDb & WorkflowDatabase>`.
+ */
+export declare function kyselyWorkflowProvidersFromTransaction<DB extends WorkflowDatabase>(trx: Transaction<DB>): WorkflowPersistenceProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE3G;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,SAAS,gBAAgB,EACjE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GACb,2BAA2B,CAM7B;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CAAC,EAAE,SAAS,gBAAgB,EAChF,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GACnB,2BAA2B,CAc7B"}

package/dist/cjs/index.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KyselyWorkflowHistoryStore = exports.KyselyWorkflowInstanceStore = exports.KyselyTransactionRunner = exports.KyselyTransactionContext = void 0;
+exports.kyselyWorkflowProviders = kyselyWorkflowProviders;
+exports.kyselyWorkflowProvidersFromTransaction = kyselyWorkflowProvidersFromTransaction;
+const kysely_instance_store_js_1 = require("./kysely-instance-store.js");
+const kysely_history_store_js_1 = require("./kysely-history-store.js");
+const kysely_transaction_runner_js_1 = require("./kysely-transaction-runner.js");
+const kysely_transaction_context_js_1 = require("./kysely-transaction-context.js");
+var kysely_transaction_context_js_2 = require("./kysely-transaction-context.js");
+Object.defineProperty(exports, "KyselyTransactionContext", { enumerable: true, get: function () { return kysely_transaction_context_js_2.KyselyTransactionContext; } });
+var kysely_transaction_runner_js_2 = require("./kysely-transaction-runner.js");
+Object.defineProperty(exports, "KyselyTransactionRunner", { enumerable: true, get: function () { return kysely_transaction_runner_js_2.KyselyTransactionRunner; } });
+var kysely_instance_store_js_2 = require("./kysely-instance-store.js");
+Object.defineProperty(exports, "KyselyWorkflowInstanceStore", { enumerable: true, get: function () { return kysely_instance_store_js_2.KyselyWorkflowInstanceStore; } });
+var kysely_history_store_js_2 = require("./kysely-history-store.js");
+Object.defineProperty(exports, "KyselyWorkflowHistoryStore", { enumerable: true, get: function () { return kysely_history_store_js_2.KyselyWorkflowHistoryStore; } });
+/**
+ * Creates long-lived persistence providers from a Kysely instance.
+ *
+ * Generic so callers can pass `Kysely<MyDb & WorkflowDatabase>`.
+ * Internally narrows to `Kysely<WorkflowDatabase>` (safe — stores
+ * only access workflow tables; the `unknown` cast is needed because
+ * Kysely is invariant in its DB type parameter).
+ */
+function kyselyWorkflowProviders(db) {
+    const narrowed = db;
+    const transactionRunner = new kysely_transaction_runner_js_1.KyselyTransactionRunner(narrowed);
+    const instanceStore = new kysely_instance_store_js_1.KyselyWorkflowInstanceStore(narrowed);
+    const historyStore = new kysely_history_store_js_1.KyselyWorkflowHistoryStore(narrowed);
+    return { instanceStore, historyStore, transactionRunner };
+}
+/**
+ * Creates providers pre-bound to an existing Kysely transaction.
+ *
+ * Generic so callers can pass `Transaction<MyDb & WorkflowDatabase>`.
+ */
+function kyselyWorkflowProvidersFromTransaction(trx) {
+    const narrowed = trx;
+    const transactionRunner = {
+        async runInTransaction(callback) {
+            const existing = kysely_transaction_context_js_1.KyselyTransactionContext.getTransaction();
+            if (existing) {
+                return callback();
+            }
+            return kysely_transaction_context_js_1.KyselyTransactionContext.run(trx, callback);
+        },
+    };
+    const instanceStore = new kysely_instance_store_js_1.KyselyWorkflowInstanceStore(narrowed);
+    const historyStore = new kysely_history_store_js_1.KyselyWorkflowHistoryStore(narrowed);
+    return { instanceStore, historyStore, transactionRunner };
+}
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAsBA,0DAQC;AAOD,wFAgBC;AAlDD,yEAAyE;AACzE,uEAAuE;AACvE,iFAAyE;AACzE,mFAA2E;AAE3E,iFAA2E;AAAlE,yIAAA,wBAAwB,OAAA;AACjC,+EAAyE;AAAhE,uIAAA,uBAAuB,OAAA;AAChC,uEAAyE;AAAhE,uIAAA,2BAA2B,OAAA;AACpC,qEAAuE;AAA9D,qIAAA,0BAA0B,OAAA;AAGnC;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CACrC,EAAc;IAEd,MAAM,QAAQ,GAAG,EAAyC,CAAC;IAC3D,MAAM,iBAAiB,GAAG,IAAI,sDAAuB,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,IAAI,sDAA2B,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,IAAI,oDAA0B,CAAC,QAAQ,CAAC,CAAC;IAC9D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAC5D,CAAC;AAED;;;;GAIG;AACH,SAAgB,sCAAsC,CACpD,GAAoB;IAEpB,MAAM,QAAQ,GAAG,GAA0C,CAAC;IAC5D,MAAM,iBAAiB,GAAqD;QAC1E,KAAK,CAAC,gBAAgB,CAAI,QAA0B;YAClD,MAAM,QAAQ,GAAG,wDAAwB,CAAC,cAAc,EAAE,CAAC;YAC3D,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,QAAQ,EAAE,CAAC;YACpB,CAAC;YACD,OAAO,wDAAwB,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC;KACF,CAAC;IACF,MAAM,aAAa,GAAG,IAAI,sDAA2B,CAAC,QAAQ,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,IAAI,oDAA0B,CAAC,QAAQ,CAAC,CAAC;IAC9D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,CAAC;AAC5D,CAAC"}

package/dist/cjs/kysely-database.d.ts

@@ -0,0 +1,44 @@
+import type { ColumnType, Generated } from "kysely";
+/**
+ * JSON column type that accepts Record<string, unknown> in TS
+ * but is stored as JSONB in PostgreSQL.
+ *
+ * - Select: returns parsed object
+ * - Insert: accepts string (caller uses JSON.stringify)
+ * - Update: accepts string (caller uses JSON.stringify)
+ */
+type JsonObjectColumn = ColumnType<Record<string, unknown>, string, string>;
+/**
+ * JSON array column type for command_results_json.
+ */
+type JsonArrayColumn = ColumnType<Record<string, unknown>[], string, string>;
+export interface WorkflowInstancesTable {
+    uuid: string;
+    workflow_name: string;
+    current_state: string;
+    version: number;
+    expires_at: Date | null;
+    last_transition_at: Date;
+    context_json: JsonObjectColumn;
+    metadata_json: JsonObjectColumn;
+    created_at: Generated<Date>;
+    updated_at: Generated<Date>;
+}
+export interface WorkflowHistoryTable {
+    uuid: Generated<string>;
+    workflow_instance_uuid: string;
+    from_state: string | null;
+    event_name: string;
+    to_state: string;
+    outcome: string;
+    error_message: string | null;
+    command_results_json: JsonArrayColumn;
+    trigger_metadata_json: JsonObjectColumn;
+    created_at: Generated<Date>;
+}
+export interface WorkflowDatabase {
+    workflow_instances: WorkflowInstancesTable;
+    workflow_history: WorkflowHistoryTable;
+}
+export {};
+//# sourceMappingURL=kysely-database.d.ts.map

package/dist/cjs/kysely-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-database.d.ts","sourceRoot":"","sources":["../../src/kysely-database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEpD;;;;;;;GAOG;AACH,KAAK,gBAAgB,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE5E;;GAEG;AACH,KAAK,eAAe,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAE7E,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,kBAAkB,EAAE,IAAI,CAAC;IACzB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,aAAa,EAAE,gBAAgB,CAAC;IAChC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5B,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,oBAAoB,EAAE,eAAe,CAAC;IACtC,qBAAqB,EAAE,gBAAgB,CAAC;IACxC,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,kBAAkB,EAAE,sBAAsB,CAAC;IAC3C,gBAAgB,EAAE,oBAAoB,CAAC;CACxC"}

package/dist/cjs/kysely-database.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=kysely-database.js.map

package/dist/cjs/kysely-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-database.js","sourceRoot":"","sources":["../../src/kysely-database.ts"],"names":[],"mappings":""}

package/dist/cjs/kysely-history-store.d.ts

@@ -0,0 +1,14 @@
+import type { Kysely } from "kysely";
+import type { WorkflowHistoryStore, WorkflowHistoryRecord } from "@duraflows/core";
+import type { WorkflowDatabase } from "./kysely-database.js";
+export declare class KyselyWorkflowHistoryStore implements WorkflowHistoryStore {
+    private readonly db;
+    constructor(db: Kysely<WorkflowDatabase>);
+    private getExecutor;
+    append(entry: WorkflowHistoryRecord): Promise<string>;
+    findByInstanceUuid(workflowInstanceUuid: string, options?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<WorkflowHistoryRecord[]>;
+}
+//# sourceMappingURL=kysely-history-store.d.ts.map

package/dist/cjs/kysely-history-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-history-store.d.ts","sourceRoot":"","sources":["../../src/kysely-history-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,qBAAa,0BAA2B,YAAW,oBAAoB;IACzD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,MAAM,CAAC,gBAAgB,CAAC;IAEzD,OAAO,CAAC,WAAW;IAIb,MAAM,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBrD,kBAAkB,CACtB,oBAAoB,EAAE,MAAM,EAC5B,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC5C,OAAO,CAAC,qBAAqB,EAAE,CAAC;CAyBpC"}

package/dist/cjs/kysely-history-store.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KyselyWorkflowHistoryStore = void 0;
+const kysely_transaction_context_js_1 = require("./kysely-transaction-context.js");
+class KyselyWorkflowHistoryStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    getExecutor() {
+        return kysely_transaction_context_js_1.KyselyTransactionContext.getTransaction() ?? this.db;
+    }
+    async append(entry) {
+        const executor = this.getExecutor();
+        const row = await executor
+            .insertInto("workflow_history")
+            .values({
+            workflow_instance_uuid: entry.workflowInstanceUuid,
+            from_state: entry.fromState,
+            event_name: entry.eventName,
+            to_state: entry.toState,
+            outcome: entry.outcome,
+            error_message: entry.errorMessage ?? null,
+            command_results_json: JSON.stringify(entry.commandResultsJson),
+            trigger_metadata_json: JSON.stringify(entry.triggerMetadata ?? {}),
+        })
+            .returning("uuid")
+            .executeTakeFirstOrThrow();
+        return row.uuid;
+    }
+    async findByInstanceUuid(workflowInstanceUuid, options) {
+        const executor = this.getExecutor();
+        const limit = options?.limit ?? 50;
+        const offset = options?.offset ?? 0;
+        const rows = await executor
+            .selectFrom("workflow_history")
+            .selectAll()
+            .where("workflow_instance_uuid", "=", workflowInstanceUuid)
+            .orderBy("created_at", "desc")
+            .limit(limit)
+            .offset(offset)
+            .execute();
+        return rows.map((row) => ({
+            workflowInstanceUuid: row.workflow_instance_uuid,
+            fromState: row.from_state,
+            eventName: row.event_name,
+            toState: row.to_state,
+            outcome: row.outcome,
+            errorMessage: row.error_message ?? undefined,
+            commandResultsJson: row.command_results_json,
+            triggerMetadata: row.trigger_metadata_json,
+        }));
+    }
+}
+exports.KyselyWorkflowHistoryStore = KyselyWorkflowHistoryStore;
+//# sourceMappingURL=kysely-history-store.js.map

package/dist/cjs/kysely-history-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-history-store.js","sourceRoot":"","sources":["../../src/kysely-history-store.ts"],"names":[],"mappings":";;;AAGA,mFAA2E;AAE3E,MAAa,0BAA0B;IACR;IAA7B,YAA6B,EAA4B;QAA5B,OAAE,GAAF,EAAE,CAA0B;IAAG,CAAC;IAErD,WAAW;QACjB,OAAO,wDAAwB,CAAC,cAAc,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;IAC9D,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAA4B;QACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,MAAM,QAAQ;aACvB,UAAU,CAAC,kBAAkB,CAAC;aAC9B,MAAM,CAAC;YACN,sBAAsB,EAAE,KAAK,CAAC,oBAAoB;YAClD,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,UAAU,EAAE,KAAK,CAAC,SAAS;YAC3B,QAAQ,EAAE,KAAK,CAAC,OAAO;YACvB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,aAAa,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;YACzC,oBAAoB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,kBAAkB,CAAC;YAC9D,qBAAqB,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC;SACnE,CAAC;aACD,SAAS,CAAC,MAAM,CAAC;aACjB,uBAAuB,EAAE,CAAC;QAE7B,OAAO,GAAG,CAAC,IAAI,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,oBAA4B,EAC5B,OAA6C;QAE7C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,CAAC,CAAC;QAEpC,MAAM,IAAI,GAAG,MAAM,QAAQ;aACxB,UAAU,CAAC,kBAAkB,CAAC;aAC9B,SAAS,EAAE;aACX,KAAK,CAAC,wBAAwB,EAAE,GAAG,EAAE,oBAAoB,CAAC;aAC1D,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;aAC7B,KAAK,CAAC,KAAK,CAAC;aACZ,MAAM,CAAC,MAAM,CAAC;aACd,OAAO,EAAE,CAAC;QAEb,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACxB,oBAAoB,EAAE,GAAG,CAAC,sBAAsB;YAChD,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,OAAO,EAAE,GAAG,CAAC,QAAQ;YACrB,OAAO,EAAE,GAAG,CAAC,OAAgC;YAC7C,YAAY,EAAE,GAAG,CAAC,aAAa,IAAI,SAAS;YAC5C,kBAAkB,EAAE,GAAG,CAAC,oBAA8E;YACtG,eAAe,EAAE,GAAG,CAAC,qBAA4D;SAClF,CAAC,CAAC,CAAC;IACN,CAAC;CACF;AAvDD,gEAuDC"}

package/dist/cjs/kysely-instance-store.d.ts

@@ -0,0 +1,15 @@
+import type { Kysely } from "kysely";
+import type { WorkflowInstanceStore, WorkflowInstance } from "@duraflows/core";
+import type { WorkflowDatabase } from "./kysely-database.js";
+export declare class KyselyWorkflowInstanceStore implements WorkflowInstanceStore {
+    private readonly db;
+    constructor(db: Kysely<WorkflowDatabase>);
+    private getExecutor;
+    create(instance: WorkflowInstance): Promise<void>;
+    findByUuid(uuid: string): Promise<WorkflowInstance | null>;
+    lockByUuid(uuid: string): Promise<WorkflowInstance | null>;
+    update(instance: WorkflowInstance): Promise<void>;
+    findExpired(limit: number, now: Date): Promise<WorkflowInstance[]>;
+    private mapRow;
+}
+//# sourceMappingURL=kysely-instance-store.d.ts.map

package/dist/cjs/kysely-instance-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-instance-store.d.ts","sourceRoot":"","sources":["../../src/kysely-instance-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,QAAQ,CAAC;AACjD,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE/E,OAAO,KAAK,EAAE,gBAAgB,EAA0B,MAAM,sBAAsB,CAAC;AAGrF,qBAAa,2BAA4B,YAAW,qBAAqB;IAC3D,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,MAAM,CAAC,gBAAgB,CAAC;IAEzD,OAAO,CAAC,WAAW;IAIb,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAQ1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAgB1D,MAAM,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BjD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAmBxE,OAAO,CAAC,MAAM;CAcf"}

package/dist/cjs/kysely-instance-store.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KyselyWorkflowInstanceStore = void 0;
+const core_1 = require("@duraflows/core");
+const kysely_transaction_context_js_1 = require("./kysely-transaction-context.js");
+class KyselyWorkflowInstanceStore {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    getExecutor() {
+        return kysely_transaction_context_js_1.KyselyTransactionContext.getTransaction() ?? this.db;
+    }
+    async create(instance) {
+        const executor = this.getExecutor();
+        await executor
+            .insertInto("workflow_instances")
+            .values({
+            uuid: instance.uuid,
+            workflow_name: instance.workflowName,
+            current_state: instance.currentState,
+            version: instance.version,
+            expires_at: instance.expiresAt,
+            last_transition_at: instance.lastTransitionAt,
+            context_json: JSON.stringify(instance.context),
+            metadata_json: JSON.stringify(instance.metadata),
+            created_at: instance.createdAt,
+            updated_at: instance.updatedAt,
+        })
+            .execute();
+    }
+    async findByUuid(uuid) {
+        const executor = this.getExecutor();
+        const row = await executor.selectFrom("workflow_instances").selectAll().where("uuid", "=", uuid).executeTakeFirst();
+        if (!row)
+            return null;
+        return this.mapRow(row);
+    }
+    async lockByUuid(uuid) {
+        const trx = kysely_transaction_context_js_1.KyselyTransactionContext.getTransaction();
+        if (!trx) {
+            throw new Error("lockByUuid requires an active transaction");
+        }
+        const row = await trx
+            .selectFrom("workflow_instances")
+            .selectAll()
+            .where("uuid", "=", uuid)
+            .forUpdate()
+            .executeTakeFirst();
+        if (!row)
+            return null;
+        return this.mapRow(row);
+    }
+    async update(instance) {
+        const executor = this.getExecutor();
+        const expectedVersion = instance.version - 1;
+        const result = await executor
+            .updateTable("workflow_instances")
+            .set({
+            current_state: instance.currentState,
+            version: instance.version,
+            expires_at: instance.expiresAt,
+            last_transition_at: instance.lastTransitionAt,
+            context_json: JSON.stringify(instance.context),
+            metadata_json: JSON.stringify(instance.metadata),
+            updated_at: instance.updatedAt,
+        })
+            .where("uuid", "=", instance.uuid)
+            .where("version", "=", expectedVersion)
+            .execute();
+        const numUpdatedRows = result[0]?.numUpdatedRows ?? BigInt(0);
+        if (numUpdatedRows === BigInt(0)) {
+            throw new core_1.WorkflowError(`Optimistic locking failure: workflow instance "${instance.uuid}" was modified concurrently (expected version ${expectedVersion})`);
+        }
+    }
+    async findExpired(limit, now) {
+        const trx = kysely_transaction_context_js_1.KyselyTransactionContext.getTransaction();
+        if (!trx) {
+            throw new Error("findExpired requires an active transaction");
+        }
+        const rows = await trx
+            .selectFrom("workflow_instances")
+            .selectAll()
+            .where("expires_at", "is not", null)
+            .where("expires_at", "<", now)
+            .orderBy("expires_at")
+            .forUpdate()
+            .skipLocked()
+            .limit(limit)
+            .execute();
+        return rows.map((row) => this.mapRow(row));
+    }
+    mapRow(row) {
+        return {
+            uuid: row.uuid,
+            workflowName: row.workflow_name,
+            currentState: row.current_state,
+            version: row.version,
+            expiresAt: row.expires_at,
+            lastTransitionAt: row.last_transition_at,
+            context: row.context_json,
+            metadata: row.metadata_json,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+}
+exports.KyselyWorkflowInstanceStore = KyselyWorkflowInstanceStore;
+//# sourceMappingURL=kysely-instance-store.js.map

package/dist/cjs/kysely-instance-store.js.map

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

package/dist/cjs/kysely-transaction-context.d.ts

@@ -0,0 +1,16 @@
+import type { Transaction } from "kysely";
+import type { WorkflowDatabase } from "./kysely-database.js";
+export declare const KyselyTransactionContext: {
+    getTransaction(): Transaction<WorkflowDatabase> | undefined;
+    /**
+     * Executes callback with `trx` as the active transaction context.
+     *
+     * Generic so callers can pass `Transaction<MyDb & WorkflowDatabase>`
+     * (Kysely is invariant in DB, so a non-generic signature would reject
+     * intersection-typed transactions). The stored value is narrowed to
+     * `Transaction<WorkflowDatabase>` which is safe — stores only access
+     * workflow tables.
+     */
+    run<T, DB extends WorkflowDatabase = WorkflowDatabase>(trx: Transaction<DB>, callback: () => T): T;
+};
+//# sourceMappingURL=kysely-transaction-context.d.ts.map

package/dist/cjs/kysely-transaction-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-transaction-context.d.ts","sourceRoot":"","sources":["../../src/kysely-transaction-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAI7D,eAAO,MAAM,wBAAwB;sBACjB,WAAW,CAAC,gBAAgB,CAAC,GAAG,SAAS;IAI3D;;;;;;;;OAQG;QACC,CAAC,EAAE,EAAE,SAAS,gBAAgB,0BAC3B,WAAW,CAAC,EAAE,CAAC,YACV,MAAM,CAAC,GAChB,CAAC;CAGL,CAAC"}

package/dist/cjs/kysely-transaction-context.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KyselyTransactionContext = void 0;
+const node_async_hooks_1 = require("node:async_hooks");
+const storage = new node_async_hooks_1.AsyncLocalStorage();
+exports.KyselyTransactionContext = {
+    getTransaction() {
+        return storage.getStore();
+    },
+    /**
+     * Executes callback with `trx` as the active transaction context.
+     *
+     * Generic so callers can pass `Transaction<MyDb & WorkflowDatabase>`
+     * (Kysely is invariant in DB, so a non-generic signature would reject
+     * intersection-typed transactions). The stored value is narrowed to
+     * `Transaction<WorkflowDatabase>` which is safe — stores only access
+     * workflow tables.
+     */
+    run(trx, callback) {
+        return storage.run(trx, callback);
+    },
+};
+//# sourceMappingURL=kysely-transaction-context.js.map

package/dist/cjs/kysely-transaction-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-transaction-context.js","sourceRoot":"","sources":["../../src/kysely-transaction-context.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAIrD,MAAM,OAAO,GAAG,IAAI,oCAAiB,EAAiC,CAAC;AAE1D,QAAA,wBAAwB,GAAG;IACtC,cAAc;QACZ,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED;;;;;;;;OAQG;IACH,GAAG,CACD,GAAoB,EACpB,QAAiB;QAEjB,OAAO,OAAO,CAAC,GAAG,CAAC,GAA+C,EAAE,QAAQ,CAAC,CAAC;IAChF,CAAC;CACF,CAAC"}

package/dist/cjs/kysely-transaction-runner.d.ts

@@ -0,0 +1,9 @@
+import type { Kysely } from "kysely";
+import type { WorkflowTransactionRunner } from "@duraflows/core";
+import type { WorkflowDatabase } from "./kysely-database.js";
+export declare class KyselyTransactionRunner implements WorkflowTransactionRunner {
+    private readonly db;
+    constructor(db: Kysely<WorkflowDatabase>);
+    runInTransaction<T>(callback: () => Promise<T>): Promise<T>;
+}
+//# sourceMappingURL=kysely-transaction-runner.d.ts.map

package/dist/cjs/kysely-transaction-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-transaction-runner.d.ts","sourceRoot":"","sources":["../../src/kysely-transaction-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,qBAAa,uBAAwB,YAAW,yBAAyB;IAC3D,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,MAAM,CAAC,gBAAgB,CAAC;IAEnD,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAUlE"}

package/dist/cjs/kysely-transaction-runner.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KyselyTransactionRunner = void 0;
+const kysely_transaction_context_js_1 = require("./kysely-transaction-context.js");
+class KyselyTransactionRunner {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    async runInTransaction(callback) {
+        const existing = kysely_transaction_context_js_1.KyselyTransactionContext.getTransaction();
+        if (existing) {
+            return callback();
+        }
+        return this.db.transaction().execute(async (trx) => {
+            return kysely_transaction_context_js_1.KyselyTransactionContext.run(trx, callback);
+        });
+    }
+}
+exports.KyselyTransactionRunner = KyselyTransactionRunner;
+//# sourceMappingURL=kysely-transaction-runner.js.map

package/dist/cjs/kysely-transaction-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely-transaction-runner.js","sourceRoot":"","sources":["../../src/kysely-transaction-runner.ts"],"names":[],"mappings":";;;AAGA,mFAA2E;AAE3E,MAAa,uBAAuB;IACL;IAA7B,YAA6B,EAA4B;QAA5B,OAAE,GAAF,EAAE,CAA0B;IAAG,CAAC;IAE7D,KAAK,CAAC,gBAAgB,CAAI,QAA0B;QAClD,MAAM,QAAQ,GAAG,wDAAwB,CAAC,cAAc,EAAE,CAAC;QAC3D,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,EAAE,CAAC;QACpB,CAAC;QAED,OAAO,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YACjD,OAAO,wDAAwB,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAbD,0DAaC"}

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+import type { Kysely, Transaction } from "kysely";
+import type { WorkflowPersistenceProvider } from "@duraflows/core";
+import type { WorkflowDatabase } from "./kysely-database.js";
+export { KyselyTransactionContext } from "./kysely-transaction-context.js";
+export { KyselyTransactionRunner } from "./kysely-transaction-runner.js";
+export { KyselyWorkflowInstanceStore } from "./kysely-instance-store.js";
+export { KyselyWorkflowHistoryStore } from "./kysely-history-store.js";
+export type { WorkflowDatabase, WorkflowInstancesTable, WorkflowHistoryTable } from "./kysely-database.js";
+/**
+ * Creates long-lived persistence providers from a Kysely instance.
+ *
+ * Generic so callers can pass `Kysely<MyDb & WorkflowDatabase>`.
+ * Internally narrows to `Kysely<WorkflowDatabase>` (safe — stores
+ * only access workflow tables; the `unknown` cast is needed because
+ * Kysely is invariant in its DB type parameter).
+ */
+export declare function kyselyWorkflowProviders<DB extends WorkflowDatabase>(db: Kysely<DB>): WorkflowPersistenceProvider;
+/**
+ * Creates providers pre-bound to an existing Kysely transaction.
+ *
+ * Generic so callers can pass `Transaction<MyDb & WorkflowDatabase>`.
+ */
+export declare function kyselyWorkflowProvidersFromTransaction<DB extends WorkflowDatabase>(trx: Transaction<DB>): WorkflowPersistenceProvider;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAM7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AACvE,YAAY,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE3G;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,SAAS,gBAAgB,EACjE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC,GACb,2BAA2B,CAM7B;AAED;;;;GAIG;AACH,wBAAgB,sCAAsC,CAAC,EAAE,SAAS,gBAAgB,EAChF,GAAG,EAAE,WAAW,CAAC,EAAE,CAAC,GACnB,2BAA2B,CAc7B"}