openworkflow 0.4.1 → 0.6.0

package/dist/registry.test.js

@@ -0,0 +1,109 @@
+import { WorkflowRegistry } from "./registry.js";
+import { defineWorkflow } from "./workflow.js";
+import { describe, expect, test } from "vitest";
+describe("WorkflowRegistry", () => {
+    describe("register", () => {
+        test("registers a workflow without version", () => {
+            const registry = new WorkflowRegistry();
+            const workflow = createMockWorkflow("my-workflow");
+            registry.register(workflow);
+            expect(registry.get("my-workflow", null)).toBe(workflow);
+        });
+        test("registers a workflow with version", () => {
+            const registry = new WorkflowRegistry();
+            const workflow = createMockWorkflow("my-workflow", "v1");
+            registry.register(workflow);
+            expect(registry.get("my-workflow", "v1")).toBe(workflow);
+        });
+        test("registers multiple versions of the same workflow", () => {
+            const registry = new WorkflowRegistry();
+            const v1 = createMockWorkflow("my-workflow", "v1");
+            const v2 = createMockWorkflow("my-workflow", "v2");
+            registry.register(v1);
+            registry.register(v2);
+            expect(registry.get("my-workflow", "v1")).toBe(v1);
+            expect(registry.get("my-workflow", "v2")).toBe(v2);
+        });
+        test("registers different workflows with same version", () => {
+            const registry = new WorkflowRegistry();
+            const workflow1 = createMockWorkflow("workflow-a", "v1");
+            const workflow2 = createMockWorkflow("workflow-b", "v1");
+            registry.register(workflow1);
+            registry.register(workflow2);
+            expect(registry.get("workflow-a", "v1")).toBe(workflow1);
+            expect(registry.get("workflow-b", "v1")).toBe(workflow2);
+        });
+        test("throws when registering duplicate unversioned workflow", () => {
+            const registry = new WorkflowRegistry();
+            registry.register(createMockWorkflow("my-workflow"));
+            expect(() => {
+                registry.register(createMockWorkflow("my-workflow"));
+            }).toThrow('Workflow "my-workflow" is already registered');
+        });
+        test("throws when registering duplicate versioned workflow", () => {
+            const registry = new WorkflowRegistry();
+            registry.register(createMockWorkflow("my-workflow", "v1"));
+            expect(() => {
+                registry.register(createMockWorkflow("my-workflow", "v1"));
+            }).toThrow('Workflow "my-workflow" (version: v1) is already registered');
+        });
+        test("allows same name with different versions", () => {
+            const registry = new WorkflowRegistry();
+            const versioned = createMockWorkflow("my-workflow", "v1");
+            const unversioned = createMockWorkflow("my-workflow");
+            registry.register(versioned);
+            registry.register(unversioned);
+            expect(registry.get("my-workflow", "v1")).toBe(versioned);
+            expect(registry.get("my-workflow", null)).toBe(unversioned);
+        });
+    });
+    describe("get", () => {
+        test("returns undefined for non-existent workflow", () => {
+            const registry = new WorkflowRegistry();
+            expect(registry.get("non-existent", null)).toBeUndefined();
+        });
+        test("returns undefined for wrong version", () => {
+            const registry = new WorkflowRegistry();
+            registry.register(createMockWorkflow("my-workflow", "v1"));
+            expect(registry.get("my-workflow", "v2")).toBeUndefined();
+            expect(registry.get("my-workflow", null)).toBeUndefined();
+        });
+        test("returns undefined for versioned lookup on unversioned workflow", () => {
+            const registry = new WorkflowRegistry();
+            registry.register(createMockWorkflow("my-workflow"));
+            expect(registry.get("my-workflow", "v1")).toBeUndefined();
+        });
+        test("returns the registered workflow", () => {
+            const registry = new WorkflowRegistry();
+            const workflow = createMockWorkflow("my-workflow");
+            registry.register(workflow);
+            expect(registry.get("my-workflow", null)).toBe(workflow);
+        });
+    });
+    describe("getAll", () => {
+        test("returns all registered workflows", () => {
+            const registry = new WorkflowRegistry();
+            const a = createMockWorkflow("workflow-a");
+            const b = createMockWorkflow("workflow-b", "v1");
+            const c = createMockWorkflow("workflow-a", "v2");
+            registry.register(a);
+            registry.register(b);
+            registry.register(c);
+            const all = registry.getAll();
+            expect(all).toHaveLength(3);
+            expect(all).toEqual(expect.arrayContaining([a, b, c]));
+        });
+        test("returns empty array when none registered", () => {
+            const registry = new WorkflowRegistry();
+            expect(registry.getAll()).toEqual([]);
+        });
+    });
+});
+function createMockWorkflow(name, version) {
+    return defineWorkflow({
+        name,
+        ...(version && { version }),
+    }, async () => {
+        // no-op
+    });
+}

package/dist/{backend-sqlite → sqlite}/backend.d.ts

@@ -1,5 +1,6 @@
-import { Backend, CancelWorkflowRunParams, ClaimWorkflowRunParams, CreateStepAttemptParams, CreateWorkflowRunParams, GetStepAttemptParams, GetWorkflowRunParams, ExtendWorkflowRunLeaseParams, ListStepAttemptsParams, ListWorkflowRunsParams, PaginatedResponse, FailStepAttemptParams, CompleteStepAttemptParams, FailWorkflowRunParams, CompleteWorkflowRunParams, SleepWorkflowRunParams, StepAttempt, WorkflowRun } from "../index.js";
-export declare const DEFAULT_PAGINATION_PAGE_SIZE = 100;
+import { Backend, CancelWorkflowRunParams, ClaimWorkflowRunParams, CreateStepAttemptParams, CreateWorkflowRunParams, GetStepAttemptParams, GetWorkflowRunParams, ExtendWorkflowRunLeaseParams, ListStepAttemptsParams, ListWorkflowRunsParams, PaginatedResponse, FailStepAttemptParams, CompleteStepAttemptParams, FailWorkflowRunParams, CompleteWorkflowRunParams, SleepWorkflowRunParams } from "../backend.js";
+import { StepAttempt } from "../core/step.js";
+import { WorkflowRun } from "../core/workflow.js";
 interface BackendSqliteOptions {
     namespaceId?: string;
     runMigrations?: boolean;
@@ -15,9 +16,12 @@ export declare class BackendSqlite implements Backend {
      * Create and initialize a new BackendSqlite instance. This will
      * automatically run migrations on startup unless `runMigrations` is set to
      * false.
+     * @param path - Database path
+     * @param options - Backend options
+     * @returns A connected backend instance
      */
-    static connect(path?: string, options?: BackendSqliteOptions): BackendSqlite;
-    stop(): void;
+    static connect(path: string, options?: BackendSqliteOptions): BackendSqlite;
+    stop(): Promise<void>;
     createWorkflowRun(params: CreateWorkflowRunParams): Promise<WorkflowRun>;
     getWorkflowRun(params: GetWorkflowRunParams): Promise<WorkflowRun | null>;
     claimWorkflowRun(params: ClaimWorkflowRunParams): Promise<WorkflowRun | null>;

package/dist/sqlite/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../sqlite/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,OAAO,EACP,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,qBAAqB,EACrB,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAgBlD,UAAU,oBAAoB;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,aAAc,YAAW,OAAO;IAC3C,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAKP;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa;IAiBrE,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,iBAAiB,CACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC;IAgDvB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAenE,gBAAgB,CACpB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA0FxB,sBAAsB,CAC1B,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,WAAW,CAAC;IAmCjB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;IAoCtE,mBAAmB,CACvB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,WAAW,CAAC;IAyCjB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;IA+DpE,iBAAiB,CACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC;IAuDvB,gBAAgB,CACd,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAgE1C,gBAAgB,CACd,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAmE1C,OAAO,CAAC,wBAAwB;IAyC1B,iBAAiB,CACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC;IAwCvB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAenE,mBAAmB,CACvB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,WAAW,CAAC;IA0DjB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;CAyD3E"}

package/dist/{backend-sqlite → sqlite}/backend.js

@@ -1,6 +1,7 @@
-import { newDatabase, migrate, generateUUID, now, addMilliseconds, toJSON, fromJSON, toISO, fromISO, DEFAULT_DATABASE_PATH, } from "./sqlite.js";
-import { DEFAULT_NAMESPACE_ID, DEFAULT_RETRY_POLICY, } from "../index.js";
-export const DEFAULT_PAGINATION_PAGE_SIZE = 100;
+import { DEFAULT_NAMESPACE_ID, } from "../backend.js";
+import { DEFAULT_RETRY_POLICY } from "../core/retry.js";
+import { newDatabase, migrate, generateUUID, now, addMilliseconds, toJSON, fromJSON, toISO, fromISO, } from "./sqlite.js";
+const DEFAULT_PAGINATION_PAGE_SIZE = 100;
 /**
  * Manages a connection to a SQLite database for workflow operations.
  */
@@ -15,8 +16,11 @@ export class BackendSqlite {
      * Create and initialize a new BackendSqlite instance. This will
      * automatically run migrations on startup unless `runMigrations` is set to
      * false.
+     * @param path - Database path
+     * @param options - Backend options
+     * @returns A connected backend instance
      */
-    static connect(path = DEFAULT_DATABASE_PATH, options) {
+    static connect(path, options) {
         const { namespaceId, runMigrations } = {
             namespaceId: DEFAULT_NAMESPACE_ID,
             runMigrations: true,
@@ -28,7 +32,8 @@ export class BackendSqlite {
         }
         return new BackendSqlite(db, namespaceId);
     }
-    stop() {
+    // eslint-disable-next-line @typescript-eslint/require-await
+    async stop() {
         this.db.close();
     }
     async createWorkflowRun(params) {
@@ -305,12 +310,12 @@ export class BackendSqlite {
             cursor = decodeCursor(before);
         }
         const order = before
-            ? `ORDER BY "created_at" DESC, "id" DESC`
-            : `ORDER BY "created_at" ASC, "id" ASC`;
+            ? `ORDER BY "created_at" ASC, "id" ASC`
+            : `ORDER BY "created_at" DESC, "id" DESC`;
         let query;
         let queryParams;
         if (cursor) {
-            const op = after ? ">" : "<";
+            const op = after ? "<" : ">";
             query = `
         SELECT *
         FROM "workflow_runs"
@@ -551,6 +556,12 @@ export class BackendSqlite {
     }
 }
 // Conversion functions
+/**
+ * Convert a database row to a WorkflowRun.
+ * @param row - Workflow run row
+ * @returns Workflow run
+ * @throws {Error} If required fields are missing
+ */
 function rowToWorkflowRun(row) {
     const createdAt = fromISO(row.created_at);
     const updatedAt = fromISO(row.updated_at);
@@ -585,6 +596,12 @@ function rowToWorkflowRun(row) {
         updatedAt,
     };
 }
+/**
+ * Convert a database row to a StepAttempt.
+ * @param row - Step attempt row
+ * @returns Step attempt
+ * @throws {Error} If required fields are missing
+ */
 function rowToStepAttempt(row) {
     const createdAt = fromISO(row.created_at);
     const updatedAt = fromISO(row.updated_at);
@@ -614,9 +631,19 @@ function rowToStepAttempt(row) {
         updatedAt,
     };
 }
+/**
+ * Encode a pagination cursor to a string.
+ * @param item - Cursor data
+ * @returns Encoded cursor
+ */
 function encodeCursor(item) {
     return Buffer.from(JSON.stringify({ createdAt: item.createdAt, id: item.id })).toString("base64");
 }
+/**
+ * Decode a pagination cursor from a string.
+ * @param cursor - Encoded cursor
+ * @returns Cursor data
+ */
 function decodeCursor(cursor) {
     const decoded = Buffer.from(cursor, "base64").toString("utf8");
     const parsed = JSON.parse(decoded);
@@ -625,4 +652,3 @@ function decodeCursor(cursor) {
         id: parsed.id,
     };
 }
-//# sourceMappingURL=backend.js.map

package/dist/sqlite/backend.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=backend.test.d.ts.map

package/dist/sqlite/backend.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.test.d.ts","sourceRoot":"","sources":["../../sqlite/backend.test.ts"],"names":[],"mappings":""}

package/dist/sqlite/backend.test.js

@@ -0,0 +1,50 @@
+import { testBackend } from "../internal.js";
+import { BackendSqlite } from "./backend.js";
+import assert from "node:assert";
+import { randomUUID } from "node:crypto";
+import { unlinkSync, existsSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { test, describe, afterAll } from "vitest";
+test("it is a test file (workaround for sonarjs/no-empty-test-file linter)", () => {
+    assert.ok(true);
+});
+describe("BackendSqlite (in-memory)", () => {
+    testBackend({
+        setup: () => {
+            return Promise.resolve(BackendSqlite.connect(":memory:", {
+                namespaceId: randomUUID(),
+            }));
+        },
+        teardown: async (backend) => {
+            await backend.stop();
+        },
+    });
+});
+describe("BackendSqlite (file-based)", () => {
+    const testDbPath = path.join(tmpdir(), `openworkflow-test-${randomUUID()}.db`);
+    afterAll(() => {
+        const walPath = `${testDbPath}-wal`;
+        const shmPath = `${testDbPath}-shm`;
+        // clean up the test database, WAL, and SHM files if they exist
+        if (existsSync(testDbPath)) {
+            unlinkSync(testDbPath);
+        }
+        if (existsSync(walPath)) {
+            unlinkSync(walPath);
+        }
+        if (existsSync(shmPath)) {
+            unlinkSync(shmPath);
+        }
+    });
+    testBackend({
+        setup: () => {
+            return Promise.resolve(BackendSqlite.connect(testDbPath, {
+                namespaceId: randomUUID(),
+            }));
+        },
+        teardown: async (backend) => {
+            await backend.stop();
+        },
+    });
+});

package/dist/sqlite/driver.d.ts

@@ -0,0 +1,79 @@
+/**
+ * SQLite driver for OpenWorkflow using the Drizzle-style API.
+ *
+ * This module provides a `sqlite()` function that creates a driver
+ * for connecting to SQLite databases.
+ * @example
+ * ```ts
+ * import { openworkflow } from 'openworkflow';
+ * import { sqlite } from 'openworkflow/sqlite';
+ *
+ * // In-memory database (great for testing)
+ * const ow = await openworkflow(sqlite(':memory:'));
+ *
+ * // File-based database
+ * const ow = await openworkflow(sqlite('./data/workflow.db'));
+ *
+ * // With configuration options
+ * const ow = await openworkflow(sqlite({
+ *   path: './data/workflow.db',
+ *   namespace: 'my-app',
+ *   runMigrations: true,
+ * }));
+ * ```
+ */
+import type { Backend, Driver, DriverConfig } from "openworkflow/internal";
+/**
+ * SQLite-specific driver configuration.
+ */
+export interface SqliteDriverConfig extends DriverConfig {
+    /**
+     * Path to the SQLite database file.
+     * Use ':memory:' for an in-memory database.
+     */
+    path?: string;
+    /**
+     * Existing SQLite database instance.
+     * If provided, the driver will use this database instead of creating a new one.
+     */
+    database?: SqliteDatabase;
+}
+/**
+ * Interface for SQLite database instance.
+ * This matches the node:sqlite DatabaseSync interface.
+ */
+export interface SqliteDatabase {
+    close(): void;
+    exec(sql: string): void;
+    prepare(sql: string): any;
+}
+/**
+ * SQLite driver instance.
+ */
+export interface SqliteDriver extends Driver {
+    readonly dialect: "sqlite";
+    readonly $client: SqliteDatabase | undefined;
+    createBackend(): Backend;
+}
+/**
+ * Creates a SQLite driver for OpenWorkflow.
+ *
+ * This function follows the Drizzle ORM pattern and supports multiple
+ * calling conventions:
+ * @param config - Database path or configuration object
+ * @returns A SqliteDriver instance
+ * @example
+ * ```ts
+ * // With database path
+ * sqlite('./data/workflow.db')
+ * sqlite(':memory:')
+ *
+ * // With config object
+ * sqlite({
+ *   path: './data/workflow.db',
+ *   namespace: 'my-app',
+ * })
+ * ```
+ */
+export declare function sqlite(config: string | SqliteDriverConfig): SqliteDriver;
+//# sourceMappingURL=driver.d.ts.map

package/dist/sqlite/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../sqlite/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,IAAI,IAAI,CAAC;IACd,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,MAAM;IAC1C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IAC7C,aAAa,IAAI,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,GAAG,YAAY,CAqExE"}

package/dist/sqlite/driver.js

@@ -0,0 +1,62 @@
+/**
+ * Creates a SQLite driver for OpenWorkflow.
+ *
+ * This function follows the Drizzle ORM pattern and supports multiple
+ * calling conventions:
+ * @param config - Database path or configuration object
+ * @returns A SqliteDriver instance
+ * @example
+ * ```ts
+ * // With database path
+ * sqlite('./data/workflow.db')
+ * sqlite(':memory:')
+ *
+ * // With config object
+ * sqlite({
+ *   path: './data/workflow.db',
+ *   namespace: 'my-app',
+ * })
+ * ```
+ */
+export function sqlite(config) {
+    // Normalize config
+    const normalizedConfig = typeof config === "string" ? { path: config } : config;
+    // Store the database reference (will be set on createBackend)
+    let databaseRef = normalizedConfig.database;
+    return {
+        dialect: "sqlite",
+        get $client() {
+            return databaseRef;
+        },
+        createBackend() {
+            // Dynamically import BackendSqlite to avoid requiring the sqlite
+            // package as a direct dependency of the openworkflow package
+            // Note: We use require here because sqlite is synchronous
+            // Determine the database path
+            const databasePath = normalizedConfig.path;
+            if (!databasePath && !normalizedConfig.database) {
+                throw new Error("SQLite driver requires either a database path or an existing database. " +
+                    "Provide `path` or `database` in the config.");
+            }
+            // If we have an existing database, we need to handle it differently
+            if (!databasePath) {
+                throw new Error("Using an existing SQLite database is not yet supported. " +
+                    "Please provide a database path via the `path` option.");
+            }
+            // Import and create the backend synchronously
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            const { BackendSqlite } = require("@openworkflow/backend-sqlite");
+            const options = {
+                runMigrations: normalizedConfig.runMigrations ?? true,
+            };
+            if (normalizedConfig.namespace) {
+                options.namespaceId = normalizedConfig.namespace;
+            }
+            const backend = BackendSqlite.connect(databasePath, options);
+            // Store database reference for $client getter
+            // Note: BackendSqlite doesn't expose the database, so this remains undefined
+            databaseRef = undefined;
+            return backend;
+        },
+    };
+}

package/dist/sqlite/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SQLite driver for OpenWorkflow.
+ * @example
+ * ```ts
+ * import { openworkflow } from 'openworkflow';
+ * import { sqlite } from 'openworkflow/sqlite';
+ *
+ * const ow = await openworkflow(sqlite(':memory:'));
+ * ```
+ */
+export { sqlite } from "./driver.js";
+export type { SqliteDriver, SqliteDriverConfig, SqliteDatabase, } from "./driver.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../sqlite/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC"}

package/dist/sqlite/index.js

@@ -0,0 +1,11 @@
+/**
+ * SQLite driver for OpenWorkflow.
+ * @example
+ * ```ts
+ * import { openworkflow } from 'openworkflow';
+ * import { sqlite } from 'openworkflow/sqlite';
+ *
+ * const ow = await openworkflow(sqlite(':memory:'));
+ * ```
+ */
+export { sqlite } from "./driver.js";

package/dist/sqlite/internal.d.ts

@@ -0,0 +1,2 @@
+export * from "./sqlite.js";
+//# sourceMappingURL=internal.d.ts.map

package/dist/sqlite/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../sqlite/internal.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/sqlite/internal.js

@@ -0,0 +1 @@
+export * from "./sqlite.js";

package/dist/{backend-sqlite → sqlite}/sqlite.d.ts

@@ -1,45 +1,61 @@
 import { DatabaseSync } from "node:sqlite";
 export type Database = DatabaseSync;
-export declare const DEFAULT_DATABASE_PATH = ":memory:";
 /**
  * newDatabase creates a new SQLite database connection.
+ * @param path - Database file path (or ":memory:") for testing
+ * @returns SQLite database connection
  */
-export declare function newDatabase(path?: string): Database;
+export declare function newDatabase(path: string): Database;
 /**
  * migrations returns the list of migration SQL statements.
+ * @returns Migration SQL statements
  */
 export declare function migrations(): string[];
 /**
  * migrate applies pending migrations to the database. Does nothing if the
  * database is already up to date.
+ * @param db - SQLite database
  */
 export declare function migrate(db: Database): void;
 /**
  * Helper to generate UUIDs (SQLite doesn't have built-in UUID generation)
+ * @returns A UUID string
  */
 export declare function generateUUID(): string;
 /**
  * Helper to get current timestamp in ISO8601 format
+ * @returns ISO8601 timestamp string
  */
 export declare function now(): string;
 /**
  * Helper to add milliseconds to a date and return ISO8601 string
+ * @param date - ISO8601 date string
+ * @param ms - Milliseconds to add
+ * @returns Updated ISO8601 date string
  */
 export declare function addMilliseconds(date: string, ms: number): string;
 /**
  * Helper to serialize JSON for SQLite storage
+ * @param value - Value to serialize
+ * @returns JSON string or null
  */
 export declare function toJSON(value: unknown): string | null;
 /**
  * Helper to deserialize JSON from SQLite storage
+ * @param value - JSON string or null
+ * @returns Parsed value
  */
 export declare function fromJSON(value: string | null): unknown;
 /**
  * Helper to convert Date to ISO8601 string for SQLite
+ * @param date - Date or null
+ * @returns ISO8601 date string or null
  */
 export declare function toISO(date: Date | null): string | null;
 /**
  * Helper to convert ISO8601 string from SQLite to Date
+ * @param dateStr - ISO8601 date string or null
+ * @returns Date or null
  */
 export declare function fromISO(dateStr: string | null): Date | null;
 //# sourceMappingURL=sqlite.d.ts.map

package/dist/sqlite/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../sqlite/sqlite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,QAAQ,GAAG,YAAY,CAAC;AAEpC;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAQlD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,EAAE,CA2IrC;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAQ1C;AAyBD;;;GAGG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;GAGG;AACH,wBAAgB,GAAG,IAAI,MAAM,CAE5B;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAEpD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAE3D"}