openworkflow 0.5.0 → 0.6.0

package/dist/factory.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Drizzle-style factory function for creating OpenWorkflow instances.
+ *
+ * This module provides a factory function that follows the Drizzle ORM pattern
+ * for creating database instances. It supports multiple calling conventions:
+ *
+ * ```ts
+ * // With a pre-configured driver
+ * const ow = openworkflow(postgres(url));
+ *
+ * // With inline configuration
+ * const ow = openworkflow(postgres({ connection: url, namespace: 'app' }));
+ * ```
+ */
+import type { Backend } from "./backend.js";
+import { OpenWorkflow } from "./client.js";
+import type { Driver } from "./driver.js";
+/**
+ * Extended OpenWorkflow instance with driver metadata.
+ */
+export interface OpenWorkflowWithDriver extends OpenWorkflow {
+    /**
+     * The underlying driver used to create this instance.
+     */
+    readonly $driver: Driver;
+    /**
+     * The underlying backend instance.
+     */
+    readonly $backend: Backend;
+}
+/**
+ * Creates a new OpenWorkflow instance from a driver.
+ *
+ * This is the Drizzle-style factory function that provides a clean API for
+ * creating OpenWorkflow instances with different database backends.
+ * @param driver - A configured driver (e.g., from `postgres()` or `sqlite()`)
+ * @returns A promise that resolves to an OpenWorkflow instance
+ * @example
+ * ```ts
+ * import { openworkflow } from 'openworkflow';
+ * import { postgres } from 'openworkflow/postgres';
+ *
+ * // Simple usage
+ * const ow = await openworkflow(postgres(process.env.DATABASE_URL));
+ *
+ * // With SQLite
+ * import { sqlite } from 'openworkflow/sqlite';
+ * const ow = await openworkflow(sqlite(':memory:'));
+ *
+ * // Define and run workflows
+ * const myWorkflow = ow.defineWorkflow(
+ *   { name: 'my-workflow' },
+ *   async ({ input, step }) => {
+ *     const result = await step.run({ name: 'do-work' }, async () => {
+ *       return 'done';
+ *     });
+ *     return result;
+ *   }
+ * );
+ *
+ * const handle = await myWorkflow.run({ data: 'test' });
+ * const result = await handle.result();
+ * ```
+ */
+export declare function openworkflow(driver: Driver): Promise<OpenWorkflowWithDriver>;
+/**
+ * Synchronous version of openworkflow for drivers that support sync creation.
+ * Note: Most drivers require async creation due to migrations.
+ * @param driver - A configured driver
+ * @returns An OpenWorkflow instance
+ * @throws {TypeError} If driver requires async setup
+ */
+export declare function openworkflowSync(driver: Driver): OpenWorkflowWithDriver;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAA4B,MAAM,aAAa,CAAC;AACrE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,sBAAsB,CAAC,CAgBjC;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAsBvE"}

package/dist/factory.js

@@ -0,0 +1,72 @@
+import { OpenWorkflow } from "./client.js";
+/**
+ * Creates a new OpenWorkflow instance from a driver.
+ *
+ * This is the Drizzle-style factory function that provides a clean API for
+ * creating OpenWorkflow instances with different database backends.
+ * @param driver - A configured driver (e.g., from `postgres()` or `sqlite()`)
+ * @returns A promise that resolves to an OpenWorkflow instance
+ * @example
+ * ```ts
+ * import { openworkflow } from 'openworkflow';
+ * import { postgres } from 'openworkflow/postgres';
+ *
+ * // Simple usage
+ * const ow = await openworkflow(postgres(process.env.DATABASE_URL));
+ *
+ * // With SQLite
+ * import { sqlite } from 'openworkflow/sqlite';
+ * const ow = await openworkflow(sqlite(':memory:'));
+ *
+ * // Define and run workflows
+ * const myWorkflow = ow.defineWorkflow(
+ *   { name: 'my-workflow' },
+ *   async ({ input, step }) => {
+ *     const result = await step.run({ name: 'do-work' }, async () => {
+ *       return 'done';
+ *     });
+ *     return result;
+ *   }
+ * );
+ *
+ * const handle = await myWorkflow.run({ data: 'test' });
+ * const result = await handle.result();
+ * ```
+ */
+export async function openworkflow(driver) {
+    // Create the backend from the driver
+    const backend = await driver.createBackend();
+    // Create the OpenWorkflow instance
+    const options = {
+        backend,
+    };
+    const ow = new OpenWorkflow(options);
+    // Return an extended instance with driver metadata
+    return Object.assign(ow, {
+        $driver: driver,
+        $backend: backend,
+    });
+}
+/**
+ * Synchronous version of openworkflow for drivers that support sync creation.
+ * Note: Most drivers require async creation due to migrations.
+ * @param driver - A configured driver
+ * @returns An OpenWorkflow instance
+ * @throws {TypeError} If driver requires async setup
+ */
+export function openworkflowSync(driver) {
+    // Try to create the backend synchronously
+    const backendOrPromise = driver.createBackend();
+    if (backendOrPromise instanceof Promise) {
+        throw new TypeError(`Driver '${driver.dialect}' requires async setup. Use 'await openworkflow()' instead of 'openworkflowSync()'.`);
+    }
+    const backend = backendOrPromise;
+    const options = {
+        backend,
+    };
+    const ow = new OpenWorkflow(options);
+    return Object.assign(ow, {
+        $driver: driver,
+        $backend: backend,
+    });
+}

package/dist/index.js

@@ -2,4 +2,3 @@ export { OpenWorkflow } from "./client.js";
 export { Worker } from "./worker.js";
 export { defineWorkflowSpec, defineWorkflow, declareWorkflow, // eslint-disable-line @typescript-eslint/no-deprecated
  } from "./workflow.js";
-//# sourceMappingURL=index.js.map

package/dist/internal.d.ts

@@ -1,8 +1,7 @@
 export type { Workflow } from "./workflow.js";
 export { isWorkflow } from "./workflow.js";
-export * from "./backend.js";
-export type { JsonValue } from "./core/json.js";
-export type { WorkflowRun } from "./core/workflow.js";
-export type { StepAttempt } from "./core/step.js";
-export { DEFAULT_RETRY_POLICY } from "./core/retry.js";
+export type { Backend, PaginationOptions, PaginatedResponse, } from "./backend.js";
+export { testBackend } from "./backend.testsuite.js";
+export type { WorkflowRun, WorkflowRunStatus } from "./core/workflow.js";
+export type { StepAttempt, StepAttemptStatus, StepKind } from "./core/step.js";
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../internal.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,cAAc,cAAc,CAAC;AAG7B,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../internal.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,YAAY,EACV,OAAO,EACP,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/internal.js

@@ -1,5 +1,2 @@
 export { isWorkflow } from "./workflow.js";
-// backend
-export * from "./backend.js";
-export { DEFAULT_RETRY_POLICY } from "./core/retry.js";
-//# sourceMappingURL=internal.js.map
+export { testBackend } from "./backend.testsuite.js";

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

@@ -1,6 +1,7 @@
-import type { Backend, CancelWorkflowRunParams, ClaimWorkflowRunParams, CompleteStepAttemptParams, CompleteWorkflowRunParams, CreateStepAttemptParams, CreateWorkflowRunParams, ExtendWorkflowRunLeaseParams, FailStepAttemptParams, FailWorkflowRunParams, GetStepAttemptParams, GetWorkflowRunParams, ListStepAttemptsParams, ListWorkflowRunsParams, PaginatedResponse, SleepWorkflowRunParams } from "../backend.js";
-import type { StepAttempt } from "../core/step.js";
-import type { WorkflowRun } from "../core/workflow.js";
+import { Backend, CancelWorkflowRunParams, ClaimWorkflowRunParams, CompleteStepAttemptParams, CompleteWorkflowRunParams, CreateStepAttemptParams, CreateWorkflowRunParams, ExtendWorkflowRunLeaseParams, FailStepAttemptParams, FailWorkflowRunParams, GetStepAttemptParams, GetWorkflowRunParams, ListStepAttemptsParams, ListWorkflowRunsParams, PaginatedResponse, SleepWorkflowRunParams } from "../backend.js";
+import { StepAttempt } from "../core/step.js";
+import { WorkflowRun } from "../core/workflow.js";
+import type { DatabaseSync } from "node:sqlite";
 interface BackendSqliteOptions {
     namespaceId?: string;
     runMigrations?: boolean;
@@ -21,6 +22,15 @@ export declare class BackendSqlite implements Backend {
      * @returns A connected backend instance
      */
     static connect(path: string, options?: BackendSqliteOptions): BackendSqlite;
+    /**
+     * Create and initialize a new BackendSqlite instance from an existing
+     * SQLite database connection. This will automatically run migrations on
+     * startup unless `runMigrations` is set to false.
+     * @param db - SQLite database connection
+     * @param options - Backend options
+     * @returns A connected backend instance
+     */
+    static fromClient(db: DatabaseSync, options?: BackendSqliteOptions): BackendSqlite;
     stop(): Promise<void>;
     createWorkflowRun(params: CreateWorkflowRunParams): Promise<WorkflowRun>;
     getWorkflowRun(params: GetWorkflowRunParams): Promise<WorkflowRun | null>;
@@ -39,4 +49,4 @@ export declare class BackendSqlite implements Backend {
     failStepAttempt(params: FailStepAttemptParams): Promise<StepAttempt>;
 }
 export {};
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=backend.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../node-sqlite/backend.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,OAAO,EACP,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,EAC5B,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYlD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIhD,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,CAAe;IACzB,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAKP;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,aAAa;IAgB3E;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CACf,EAAE,EAAE,YAAY,EAChB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa;IAeV,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/index.js → node-sqlite/backend.js}

@@ -1,4 +1,4 @@
-import { DEFAULT_NAMESPACE_ID } from "../backend.js";
+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;
@@ -32,6 +32,25 @@ export class BackendSqlite {
         }
         return new BackendSqlite(db, namespaceId);
     }
+    /**
+     * Create and initialize a new BackendSqlite instance from an existing
+     * SQLite database connection. This will automatically run migrations on
+     * startup unless `runMigrations` is set to false.
+     * @param db - SQLite database connection
+     * @param options - Backend options
+     * @returns A connected backend instance
+     */
+    static fromClient(db, options) {
+        const { namespaceId, runMigrations } = {
+            namespaceId: DEFAULT_NAMESPACE_ID,
+            runMigrations: true,
+            ...options,
+        };
+        if (runMigrations) {
+            migrate(db);
+        }
+        return new BackendSqlite(db, namespaceId);
+    }
     // eslint-disable-next-line @typescript-eslint/require-await
     async stop() {
         this.db.close();
@@ -310,12 +329,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"
@@ -652,4 +671,3 @@ function decodeCursor(cursor) {
         id: parsed.id,
     };
 }
-//# sourceMappingURL=index.js.map

package/dist/node-sqlite/index.d.ts

@@ -0,0 +1,11 @@
+import { BackendSqlite } from "./backend.js";
+import type { DatabaseSync } from "node:sqlite";
+/**
+ * Create a SQLite-backed OpenWorkflow backend using node:sqlite.
+ * @param client - SQLite client or database path
+ * @param options - Backend options
+ * @returns A connected backend instance
+ */
+export declare function openworkflow(client: DatabaseSync, options?: Parameters<typeof BackendSqlite.fromClient>[1]): BackendSqlite;
+export declare function openworkflow(path: string, options?: Parameters<typeof BackendSqlite.connect>[1]): BackendSqlite;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../node-sqlite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GACvD,aAAa,CAAC;AACjB,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACpD,aAAa,CAAC"}

package/dist/node-sqlite/index.js

@@ -0,0 +1,7 @@
+import { BackendSqlite } from "./backend.js";
+export function openworkflow(clientOrPath, options) {
+    if (typeof clientOrPath === "string") {
+        return BackendSqlite.connect(clientOrPath, options);
+    }
+    return BackendSqlite.fromClient(clientOrPath, options);
+}

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

@@ -1,11 +1,10 @@
 import { DatabaseSync } from "node:sqlite";
-export type Database = DatabaseSync;
 /**
  * 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): DatabaseSync;
 /**
  * migrations returns the list of migration SQL statements.
  * @returns Migration SQL statements
@@ -16,7 +15,7 @@ export declare function migrations(): string[];
  * database is already up to date.
  * @param db - SQLite database
  */
-export declare function migrate(db: Database): void;
+export declare function migrate(db: DatabaseSync): void;
 /**
  * Helper to generate UUIDs (SQLite doesn't have built-in UUID generation)
  * @returns A UUID string

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

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../node-sqlite/sqlite.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAQtD;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,MAAM,EAAE,CA2IrC;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAQ9C;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"}

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

@@ -244,4 +244,3 @@ export function toISO(date) {
 export function fromISO(dateStr) {
     return dateStr ? new Date(dateStr) : null;
 }
-//# sourceMappingURL=sqlite.js.map

package/dist/{pg → postgres}/backend.d.ts

@@ -1,4 +1,6 @@
-import { Backend, CancelWorkflowRunParams, ClaimWorkflowRunParams, CreateStepAttemptParams, CreateWorkflowRunParams, GetStepAttemptParams, GetWorkflowRunParams, ExtendWorkflowRunLeaseParams, ListStepAttemptsParams, ListWorkflowRunsParams, PaginatedResponse, FailStepAttemptParams, CompleteStepAttemptParams, FailWorkflowRunParams, CompleteWorkflowRunParams, SleepWorkflowRunParams, StepAttempt, WorkflowRun } from "openworkflow/internal";
+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 BackendPostgresOptions {
     namespaceId?: string;
     runMigrations?: boolean;

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

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../postgres/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;AAWlD,UAAU,sBAAsB;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,OAAO;IAC7C,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAKP;;;;;;;OAOG;WACU,OAAO,CAClB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,eAAe,CAAC;IAiBrB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,iBAAiB,CACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC;IA0CjB,cAAc,CAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAYxB,gBAAgB,CACpB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IA2B1C,OAAO,CAAC,0BAA0B;IA0B5B,gBAAgB,CACpB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAmDxB,sBAAsB,CAC1B,MAAM,EAAE,4BAA4B,GACnC,OAAO,CAAC,WAAW,CAAC;IAkBjB,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwBtE,mBAAmB,CACvB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,WAAW,CAAC;IAuBjB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;IAgEpE,iBAAiB,CACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC;IA2CjB,iBAAiB,CACrB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,WAAW,CAAC;IAoCjB,cAAc,CAClB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAWxB,gBAAgB,CACpB,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;IA2B1C,OAAO,CAAC,0BAA0B;IA6BlC,OAAO,CAAC,wBAAwB;IAyC1B,mBAAmB,CACvB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,WAAW,CAAC;IA0BjB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,WAAW,CAAC;CAyB3E"}

package/dist/{pg → postgres}/backend.js

@@ -1,5 +1,6 @@
+import { DEFAULT_NAMESPACE_ID, } from "../backend.js";
+import { DEFAULT_RETRY_POLICY } from "../core/retry.js";
 import { newPostgres, newPostgresMaxOne, migrate, DEFAULT_SCHEMA, } from "./postgres.js";
-import { DEFAULT_NAMESPACE_ID, DEFAULT_RETRY_POLICY, } from "openworkflow/internal";
 const DEFAULT_PAGINATION_PAGE_SIZE = 100;
 /**
  * Manages a connection to a Postgres database for workflow operations.
@@ -98,8 +99,8 @@ export class BackendPostgres {
         }
         const whereClause = this.buildListWorkflowRunsWhere(params, cursor);
         const order = before
-            ? this.pg `ORDER BY "created_at" DESC, "id" DESC`
-            : this.pg `ORDER BY "created_at" ASC, "id" ASC`;
+            ? this.pg `ORDER BY "created_at" ASC, "id" ASC`
+            : this.pg `ORDER BY "created_at" DESC, "id" DESC`;
         const rows = await this.pg `
       SELECT *
       FROM "openworkflow"."workflow_runs"
@@ -113,7 +114,7 @@ export class BackendPostgres {
         const { after } = params;
         const conditions = [this.pg `"namespace_id" = ${this.namespaceId}`];
         if (cursor) {
-            const op = after ? this.pg `>` : this.pg `<`;
+            const op = after ? this.pg `<` : this.pg `>`;
             conditions.push(this.pg `("created_at", "id") ${op} (${cursor.createdAt}, ${cursor.id})`);
         }
         let whereClause = conditions[0];
@@ -531,4 +532,3 @@ function decodeCursor(cursor) {
         id: parsed.id,
     };
 }
-//# sourceMappingURL=backend.js.map

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

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

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

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

package/dist/postgres/backend.test.js

@@ -0,0 +1,19 @@
+import { testBackend } from "../internal.js";
+import { BackendPostgres } from "./backend.js";
+import { DEFAULT_POSTGRES_URL } from "./postgres.js";
+import assert from "node:assert";
+import { randomUUID } from "node:crypto";
+import { test } from "vitest";
+test("it is a test file (workaround for sonarjs/no-empty-test-file linter)", () => {
+    assert.ok(true);
+});
+testBackend({
+    setup: async () => {
+        return await BackendPostgres.connect(DEFAULT_POSTGRES_URL, {
+            namespaceId: randomUUID(),
+        });
+    },
+    teardown: async (backend) => {
+        await backend.stop();
+    },
+});

package/dist/postgres/driver.d.ts

@@ -0,0 +1,81 @@
+/**
+ * PostgreSQL driver for OpenWorkflow using the Drizzle-style API.
+ *
+ * This module provides a `postgres()` function that creates a driver
+ * for connecting to PostgreSQL databases.
+ * @example
+ * ```ts
+ * import { openworkflow } from 'openworkflow';
+ * import { postgres } from 'openworkflow/postgres';
+ *
+ * // Simple usage with connection string
+ * const ow = await openworkflow(postgres(process.env.DATABASE_URL));
+ *
+ * // With configuration options
+ * const ow = await openworkflow(postgres({
+ *   connection: process.env.DATABASE_URL,
+ *   namespace: 'my-app',
+ *   runMigrations: true,
+ * }));
+ *
+ * // With existing postgres.js client
+ * import postgresJs from 'postgres';
+ * const client = postgresJs(process.env.DATABASE_URL);
+ * const ow = await openworkflow(postgres({ client }));
+ * ```
+ */
+import type { Backend, Driver, DriverConfig } from "openworkflow/internal";
+/**
+ * PostgreSQL-specific driver configuration.
+ */
+export interface PostgresDriverConfig extends DriverConfig {
+    /**
+     * PostgreSQL connection string URL.
+     */
+    connection?: string;
+    /**
+     * Existing postgres.js client instance.
+     * If provided, the driver will use this client instead of creating a new one.
+     */
+    client?: PostgresClient;
+}
+/**
+ * Type for postgres.js client.
+ * This is a simplified interface that matches the postgres.js interface.
+ */
+export interface PostgresClient {
+    end(): Promise<void>;
+    [key: string]: any;
+}
+/**
+ * PostgreSQL driver instance.
+ */
+export interface PostgresDriver extends Driver {
+    readonly dialect: "postgres";
+    readonly $client: PostgresClient | undefined;
+    createBackend(): Promise<Backend>;
+}
+/**
+ * Creates a PostgreSQL driver for OpenWorkflow.
+ *
+ * This function follows the Drizzle ORM pattern and supports multiple
+ * calling conventions:
+ * @param config - Connection string or configuration object
+ * @returns A PostgresDriver instance
+ * @example
+ * ```ts
+ * // With connection string
+ * postgres(process.env.DATABASE_URL)
+ *
+ * // With config object
+ * postgres({
+ *   connection: process.env.DATABASE_URL,
+ *   namespace: 'my-app',
+ * })
+ *
+ * // With existing client
+ * postgres({ client: existingPostgresClient })
+ * ```
+ */
+export declare function postgres(config: string | PostgresDriverConfig): PostgresDriver;
+//# sourceMappingURL=driver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../../postgres/driver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAErB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,MAAM;IAC5C,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAC;IAC7C,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CACtB,MAAM,EAAE,MAAM,GAAG,oBAAoB,GACpC,cAAc,CA6DhB"}

package/dist/postgres/driver.js

@@ -0,0 +1,63 @@
+/**
+ * Creates a PostgreSQL driver for OpenWorkflow.
+ *
+ * This function follows the Drizzle ORM pattern and supports multiple
+ * calling conventions:
+ * @param config - Connection string or configuration object
+ * @returns A PostgresDriver instance
+ * @example
+ * ```ts
+ * // With connection string
+ * postgres(process.env.DATABASE_URL)
+ *
+ * // With config object
+ * postgres({
+ *   connection: process.env.DATABASE_URL,
+ *   namespace: 'my-app',
+ * })
+ *
+ * // With existing client
+ * postgres({ client: existingPostgresClient })
+ * ```
+ */
+export function postgres(config) {
+    // Normalize config
+    const normalizedConfig = typeof config === "string" ? { connection: config } : config;
+    // Store the client reference (will be set on createBackend)
+    let clientRef = normalizedConfig.client;
+    return {
+        dialect: "postgres",
+        get $client() {
+            return clientRef;
+        },
+        async createBackend() {
+            // Dynamically import BackendPostgres to avoid requiring the postgres
+            // package as a direct dependency of the openworkflow package
+            const { BackendPostgres } = await import("@openworkflow/backend-postgres");
+            // Determine the connection URL
+            const connectionUrl = normalizedConfig.connection;
+            if (!connectionUrl && !normalizedConfig.client) {
+                throw new Error("PostgreSQL driver requires either a connection string or an existing client. " +
+                    "Provide `connection` URL or `client` in the config.");
+            }
+            // If we have an existing client, we need to handle it differently
+            // For now, we use the BackendPostgres.connect which creates its own client
+            if (!connectionUrl) {
+                throw new Error("Using an existing postgres.js client is not yet supported. " +
+                    "Please provide a connection string via the `connection` option.");
+            }
+            const options = {
+                runMigrations: normalizedConfig.runMigrations ?? true,
+            };
+            if (normalizedConfig.namespace) {
+                options.namespaceId = normalizedConfig.namespace;
+            }
+            const backend = await BackendPostgres.connect(connectionUrl, options);
+            // Store client reference for $client getter
+            // Note: BackendPostgres doesn't expose the client, so this remains undefined
+            // In the future, we could extend BackendPostgres to expose the client
+            clientRef = undefined;
+            return backend;
+        },
+    };
+}

package/dist/postgres/index.d.ts

@@ -0,0 +1,11 @@
+import { BackendPostgres } from "./backend.js";
+import type { Postgres } from "./postgres.js";
+/**
+ * Create a Postgres-backed OpenWorkflow backend using postgres.js.
+ * @param client - postgres.js client or connection URL
+ * @param options - Backend options
+ * @returns A connected backend instance
+ */
+export declare function openworkflow(client: Postgres, options?: Parameters<typeof BackendPostgres.fromClient>[1]): Promise<BackendPostgres>;
+export declare function openworkflow(url: string, options?: Parameters<typeof BackendPostgres.connect>[1]): Promise<BackendPostgres>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../postgres/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,QAAQ,EAChB,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GACzD,OAAO,CAAC,eAAe,CAAC,CAAC;AAC5B,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACtD,OAAO,CAAC,eAAe,CAAC,CAAC"}

package/dist/postgres/index.js

@@ -0,0 +1,7 @@
+import { BackendPostgres } from "./backend.js";
+export async function openworkflow(clientOrUrl, options) {
+    if (typeof clientOrUrl === "string") {
+        return BackendPostgres.connect(clientOrUrl, options);
+    }
+    return BackendPostgres.fromClient(clientOrUrl, options);
+}

package/dist/postgres/internal.d.ts

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

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

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

package/dist/postgres/internal.js

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

package/dist/postgres/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../postgres/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,eAAO,MAAM,oBAAoB,2DACyB,CAAC;AAO3D,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAE7C,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC;AACnD,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAE7D;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,oBAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,oBAEvE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CA+JnD;AAED;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAQzD;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,iBAE5D"}

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

@@ -231,4 +231,3 @@ async function getCurrentMigrationVersion(pg, schema) {
     const currentVersionRes = await pg.unsafe(`SELECT MAX("version") AS "version" FROM "${schema}"."openworkflow_migrations";`);
     return currentVersionRes[0]?.version ?? -1;
 }
-//# sourceMappingURL=postgres.js.map

package/dist/postgres/postgres.test.d.ts

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

package/dist/postgres/postgres.test.d.ts.map

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