openworkflow 0.4.1 → 0.6.0

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

@@ -0,0 +1,60 @@
+import { DatabaseSync } from "node:sqlite";
+/**
+ * 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): DatabaseSync;
+/**
+ * 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: DatabaseSync): 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/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

@@ -1,10 +1,11 @@
 import { randomUUID } from "node:crypto";
 import { DatabaseSync } from "node:sqlite";
-export 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 function newDatabase(path = DEFAULT_DATABASE_PATH) {
+export function newDatabase(path) {
     const db = new DatabaseSync(path);
     // Only enable WAL mode for file-based databases
     if (path !== ":memory:") {
@@ -15,6 +16,7 @@ export function newDatabase(path = DEFAULT_DATABASE_PATH) {
 }
 /**
  * migrations returns the list of migration SQL statements.
+ * @returns Migration SQL statements
  */
 export function migrations() {
     return [
@@ -155,6 +157,7 @@ export function migrations() {
 /**
  * migrate applies pending migrations to the database. Does nothing if the
  * database is already up to date.
+ * @param db - SQLite database
  */
 export function migrate(db) {
     const currentMigrationVersion = getCurrentMigrationVersion(db);
@@ -166,6 +169,8 @@ export function migrate(db) {
 }
 /**
  * getCurrentMigrationVersion returns the current migration version of the database.
+ * @param db - SQLite database
+ * @returns Current migration version
  */
 function getCurrentMigrationVersion(db) {
     // check if migrations table exists
@@ -184,18 +189,23 @@ function getCurrentMigrationVersion(db) {
 }
 /**
  * Helper to generate UUIDs (SQLite doesn't have built-in UUID generation)
+ * @returns A UUID string
  */
 export function generateUUID() {
     return randomUUID();
 }
 /**
  * Helper to get current timestamp in ISO8601 format
+ * @returns ISO8601 timestamp string
  */
 export function now() {
     return new Date().toISOString();
 }
 /**
  * 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 function addMilliseconds(date, ms) {
     const d = new Date(date);
@@ -204,26 +214,33 @@ export function addMilliseconds(date, ms) {
 }
 /**
  * Helper to serialize JSON for SQLite storage
+ * @param value - Value to serialize
+ * @returns JSON string or null
  */
 export function toJSON(value) {
     return value === null || value === undefined ? null : JSON.stringify(value);
 }
 /**
  * Helper to deserialize JSON from SQLite storage
+ * @param value - JSON string or null
+ * @returns Parsed value
  */
 export function fromJSON(value) {
     return value === null ? null : JSON.parse(value);
 }
 /**
  * Helper to convert Date to ISO8601 string for SQLite
+ * @param date - Date or null
+ * @returns ISO8601 date string or null
  */
 export function toISO(date) {
     return date ? date.toISOString() : null;
 }
 /**
  * Helper to convert ISO8601 string from SQLite to Date
+ * @param dateStr - ISO8601 date string or null
+ * @returns Date or null
  */
 export function fromISO(dateStr) {
     return dateStr ? new Date(dateStr) : null;
 }
-//# sourceMappingURL=sqlite.js.map

package/dist/postgres/backend.d.ts

@@ -0,0 +1,44 @@
+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;
+}
+/**
+ * Manages a connection to a Postgres database for workflow operations.
+ */
+export declare class BackendPostgres implements Backend {
+    private pg;
+    private namespaceId;
+    private constructor();
+    /**
+     * Create and initialize a new BackendPostgres instance. This will
+     * automatically run migrations on startup unless `runMigrations` is set to
+     * false.
+     * @param url - Postgres connection URL
+     * @param options - Backend options
+     * @returns A connected backend instance
+     */
+    static connect(url: string, options?: BackendPostgresOptions): Promise<BackendPostgres>;
+    stop(): Promise<void>;
+    createWorkflowRun(params: CreateWorkflowRunParams): Promise<WorkflowRun>;
+    getWorkflowRun(params: GetWorkflowRunParams): Promise<WorkflowRun | null>;
+    listWorkflowRuns(params: ListWorkflowRunsParams): Promise<PaginatedResponse<WorkflowRun>>;
+    private buildListWorkflowRunsWhere;
+    claimWorkflowRun(params: ClaimWorkflowRunParams): Promise<WorkflowRun | null>;
+    extendWorkflowRunLease(params: ExtendWorkflowRunLeaseParams): Promise<WorkflowRun>;
+    sleepWorkflowRun(params: SleepWorkflowRunParams): Promise<WorkflowRun>;
+    completeWorkflowRun(params: CompleteWorkflowRunParams): Promise<WorkflowRun>;
+    failWorkflowRun(params: FailWorkflowRunParams): Promise<WorkflowRun>;
+    cancelWorkflowRun(params: CancelWorkflowRunParams): Promise<WorkflowRun>;
+    createStepAttempt(params: CreateStepAttemptParams): Promise<StepAttempt>;
+    getStepAttempt(params: GetStepAttemptParams): Promise<StepAttempt | null>;
+    listStepAttempts(params: ListStepAttemptsParams): Promise<PaginatedResponse<StepAttempt>>;
+    private buildListStepAttemptsWhere;
+    private processPaginationResults;
+    completeStepAttempt(params: CompleteStepAttemptParams): Promise<StepAttempt>;
+    failStepAttempt(params: FailStepAttemptParams): Promise<StepAttempt>;
+}
+export {};
+//# sourceMappingURL=backend.d.ts.map

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"}