openworkflow 0.3.0 → 0.4.1

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

@@ -0,0 +1,45 @@
+import { DatabaseSync } from "node:sqlite";
+export type Database = DatabaseSync;
+export declare const DEFAULT_DATABASE_PATH = ":memory:";
+/**
+ * newDatabase creates a new SQLite database connection.
+ */
+export declare function newDatabase(path?: string): Database;
+/**
+ * migrations returns the list of 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.
+ */
+export declare function migrate(db: Database): void;
+/**
+ * Helper to generate UUIDs (SQLite doesn't have built-in UUID generation)
+ */
+export declare function generateUUID(): string;
+/**
+ * Helper to get current timestamp in ISO8601 format
+ */
+export declare function now(): string;
+/**
+ * Helper to add milliseconds to a date and return ISO8601 string
+ */
+export declare function addMilliseconds(date: string, ms: number): string;
+/**
+ * Helper to serialize JSON for SQLite storage
+ */
+export declare function toJSON(value: unknown): string | null;
+/**
+ * Helper to deserialize JSON from SQLite storage
+ */
+export declare function fromJSON(value: string | null): unknown;
+/**
+ * Helper to convert Date to ISO8601 string for SQLite
+ */
+export declare function toISO(date: Date | null): string | null;
+/**
+ * Helper to convert ISO8601 string from SQLite to Date
+ */
+export declare function fromISO(dateStr: string | null): Date | null;
+//# sourceMappingURL=sqlite.d.ts.map

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

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

package/dist/backend-sqlite/sqlite.js

@@ -0,0 +1,229 @@
+import { randomUUID } from "node:crypto";
+import { DatabaseSync } from "node:sqlite";
+export const DEFAULT_DATABASE_PATH = ":memory:";
+/**
+ * newDatabase creates a new SQLite database connection.
+ */
+export function newDatabase(path = DEFAULT_DATABASE_PATH) {
+    const db = new DatabaseSync(path);
+    // Only enable WAL mode for file-based databases
+    if (path !== ":memory:") {
+        db.exec("PRAGMA journal_mode = WAL;");
+    }
+    db.exec("PRAGMA foreign_keys = ON;");
+    return db;
+}
+/**
+ * migrations returns the list of migration SQL statements.
+ */
+export function migrations() {
+    return [
+        // 0 - init
+        `BEGIN;
+
+    CREATE TABLE IF NOT EXISTS "openworkflow_migrations" (
+      "version" INTEGER NOT NULL PRIMARY KEY
+    );
+
+    INSERT OR IGNORE INTO "openworkflow_migrations" ("version")
+    VALUES (0);
+
+    COMMIT;`,
+        // 1 - add workflow_runs and step_attempts tables
+        `BEGIN;
+
+    PRAGMA defer_foreign_keys = ON;
+
+    CREATE TABLE IF NOT EXISTS "workflow_runs" (
+      "namespace_id" TEXT NOT NULL,
+      "id" TEXT NOT NULL,
+      --
+      "workflow_name" TEXT NOT NULL,
+      "version" TEXT,
+      "status" TEXT NOT NULL,
+      "idempotency_key" TEXT,
+      "config" TEXT NOT NULL,
+      "context" TEXT,
+      "input" TEXT,
+      "output" TEXT,
+      "error" TEXT,
+      "attempts" INTEGER NOT NULL,
+      "parent_step_attempt_namespace_id" TEXT,
+      "parent_step_attempt_id" TEXT,
+      "worker_id" TEXT,
+      "available_at" TEXT,
+      "deadline_at" TEXT,
+      "started_at" TEXT,
+      "finished_at" TEXT,
+      "created_at" TEXT NOT NULL,
+      "updated_at" TEXT NOT NULL,
+      PRIMARY KEY ("namespace_id", "id"),
+      FOREIGN KEY ("parent_step_attempt_namespace_id", "parent_step_attempt_id")
+        REFERENCES "step_attempts" ("namespace_id", "id")
+        ON DELETE SET NULL
+    );
+
+    CREATE TABLE IF NOT EXISTS "step_attempts" (
+      "namespace_id" TEXT NOT NULL,
+      "id" TEXT NOT NULL,
+      --
+      "workflow_run_id" TEXT NOT NULL,
+      "step_name" TEXT NOT NULL,
+      "kind" TEXT NOT NULL,
+      "status" TEXT NOT NULL,
+      "config" TEXT NOT NULL,
+      "context" TEXT,
+      "output" TEXT,
+      "error" TEXT,
+      "child_workflow_run_namespace_id" TEXT,
+      "child_workflow_run_id" TEXT,
+      "started_at" TEXT,
+      "finished_at" TEXT,
+      "created_at" TEXT NOT NULL,
+      "updated_at" TEXT NOT NULL,
+      PRIMARY KEY ("namespace_id", "id"),
+      FOREIGN KEY ("namespace_id", "workflow_run_id")
+        REFERENCES "workflow_runs" ("namespace_id", "id")
+        ON DELETE CASCADE,
+      FOREIGN KEY ("child_workflow_run_namespace_id", "child_workflow_run_id")
+        REFERENCES "workflow_runs" ("namespace_id", "id")
+        ON DELETE SET NULL
+    );
+
+    INSERT OR IGNORE INTO "openworkflow_migrations" ("version")
+    VALUES (1);
+
+    COMMIT;`,
+        // 2 - foreign keys
+        `BEGIN;
+
+    -- Foreign keys are defined in migration 1 since SQLite requires them during table creation
+    -- This migration exists for version parity with PostgreSQL backend
+
+    INSERT OR IGNORE INTO "openworkflow_migrations" ("version")
+    VALUES (2);
+
+    COMMIT;`,
+        // 3 - validate foreign keys
+        `BEGIN;
+
+    -- Foreign key validation happens automatically in SQLite when PRAGMA foreign_keys = ON
+    -- This migration exists for version parity with PostgreSQL backend
+
+    INSERT OR IGNORE INTO "openworkflow_migrations" ("version")
+    VALUES (3);
+
+    COMMIT;`,
+        // 4 - indexes
+        `BEGIN;
+
+    CREATE INDEX IF NOT EXISTS "workflow_runs_status_available_at_created_at_idx"
+    ON "workflow_runs" ("namespace_id", "status", "available_at", "created_at");
+
+    CREATE INDEX IF NOT EXISTS "workflow_runs_workflow_name_idempotency_key_created_at_idx"
+    ON "workflow_runs" ("namespace_id", "workflow_name", "idempotency_key", "created_at");
+
+    CREATE INDEX IF NOT EXISTS "workflow_runs_parent_step_idx"
+    ON "workflow_runs" ("parent_step_attempt_namespace_id", "parent_step_attempt_id")
+    WHERE parent_step_attempt_namespace_id IS NOT NULL AND parent_step_attempt_id IS NOT NULL;
+
+    CREATE INDEX IF NOT EXISTS "workflow_runs_created_at_desc_idx"
+    ON "workflow_runs" ("namespace_id", "created_at" DESC);
+
+    CREATE INDEX IF NOT EXISTS "workflow_runs_status_created_at_desc_idx"
+    ON "workflow_runs" ("namespace_id", "status", "created_at" DESC);
+
+    CREATE INDEX IF NOT EXISTS "workflow_runs_workflow_name_status_created_at_desc_idx"
+    ON "workflow_runs" ("namespace_id", "workflow_name", "status", "created_at" DESC);
+
+    CREATE INDEX IF NOT EXISTS "step_attempts_workflow_run_created_at_idx"
+    ON "step_attempts" ("namespace_id", "workflow_run_id", "created_at");
+
+    CREATE INDEX IF NOT EXISTS "step_attempts_workflow_run_step_name_created_at_idx"
+    ON "step_attempts" ("namespace_id", "workflow_run_id", "step_name", "created_at");
+
+    CREATE INDEX IF NOT EXISTS "step_attempts_child_workflow_run_idx"
+    ON "step_attempts" ("child_workflow_run_namespace_id", "child_workflow_run_id")
+    WHERE child_workflow_run_namespace_id IS NOT NULL AND child_workflow_run_id IS NOT NULL;
+
+    INSERT OR IGNORE INTO "openworkflow_migrations" ("version")
+    VALUES (4);
+
+    COMMIT;`,
+    ];
+}
+/**
+ * migrate applies pending migrations to the database. Does nothing if the
+ * database is already up to date.
+ */
+export function migrate(db) {
+    const currentMigrationVersion = getCurrentMigrationVersion(db);
+    for (const [i, migrationSql] of migrations().entries()) {
+        if (i <= currentMigrationVersion)
+            continue; // already applied
+        db.exec(migrationSql);
+    }
+}
+/**
+ * getCurrentMigrationVersion returns the current migration version of the database.
+ */
+function getCurrentMigrationVersion(db) {
+    // check if migrations table exists
+    const existsStmt = db.prepare(`
+    SELECT COUNT(*) as count
+    FROM sqlite_master
+    WHERE type = 'table' AND name = 'openworkflow_migrations'
+  `);
+    const existsResult = existsStmt.get();
+    if (!existsResult || existsResult.count === 0)
+        return -1;
+    // get current version
+    const versionStmt = db.prepare(`SELECT MAX("version") AS "version" FROM "openworkflow_migrations";`);
+    const versionResult = versionStmt.get();
+    return versionResult?.version ?? -1;
+}
+/**
+ * Helper to generate UUIDs (SQLite doesn't have built-in UUID generation)
+ */
+export function generateUUID() {
+    return randomUUID();
+}
+/**
+ * Helper to get current timestamp in ISO8601 format
+ */
+export function now() {
+    return new Date().toISOString();
+}
+/**
+ * Helper to add milliseconds to a date and return ISO8601 string
+ */
+export function addMilliseconds(date, ms) {
+    const d = new Date(date);
+    d.setMilliseconds(d.getMilliseconds() + ms);
+    return d.toISOString();
+}
+/**
+ * Helper to serialize JSON for SQLite storage
+ */
+export function toJSON(value) {
+    return value === null || value === undefined ? null : JSON.stringify(value);
+}
+/**
+ * Helper to deserialize JSON from SQLite storage
+ */
+export function fromJSON(value) {
+    return value === null ? null : JSON.parse(value);
+}
+/**
+ * Helper to convert Date to ISO8601 string for SQLite
+ */
+export function toISO(date) {
+    return date ? date.toISOString() : null;
+}
+/**
+ * Helper to convert ISO8601 string from SQLite to Date
+ */
+export function fromISO(dateStr) {
+    return dateStr ? new Date(dateStr) : null;
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/backend-sqlite/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../backend-sqlite/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAI3C,MAAM,CAAC,MAAM,qBAAqB,GAAG,UAAU,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,OAAe,qBAAqB;IAC9D,MAAM,EAAE,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAClC,gDAAgD;IAChD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,EAAE,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;IACxC,CAAC;IACD,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACrC,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO;QACL,WAAW;QACX;;;;;;;;;YASQ;QAER,iDAAiD;QACjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA+DQ;QAER,mBAAmB;QACnB;;;;;;;;YAQQ;QAER,4BAA4B;QAC5B;;;;;;;;YAQQ;QAER,cAAc;QACd;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAkCQ;KACT,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,OAAO,CAAC,EAAY;IAClC,MAAM,uBAAuB,GAAG,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAE/D,KAAK,MAAM,CAAC,CAAC,EAAE,YAAY,CAAC,IAAI,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC,IAAI,uBAAuB;YAAE,SAAS,CAAC,kBAAkB;QAE9D,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,0BAA0B,CAAC,EAAY;IAC9C,mCAAmC;IACnC,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAAC;;;;GAI7B,CAAC,CAAC;IACH,MAAM,YAAY,GAAG,UAAU,CAAC,GAAG,EAAmC,CAAC;IACvE,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,KAAK,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IAEzD,sBAAsB;IACtB,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAC5B,oEAAoE,CACrE,CAAC;IACF,MAAM,aAAa,GAAG,WAAW,CAAC,GAAG,EAAqC,CAAC;IAC3E,OAAO,aAAa,EAAE,OAAO,IAAI,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,EAAE,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG;IACjB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,EAAU;IACtD,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5C,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,IAAiB;IACrC,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,OAAsB;IAC5C,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC"}

package/dist/config/config.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Backend type discriminator
+ */
+export type BackendKind = "postgres" | "sqlite";
+/**
+ * PostgreSQL backend configuration
+ */
+export interface PostgresConfig {
+    /**
+     * PostgreSQL connection URL
+     * @example "postgresql://user:password@localhost:5432/database"
+     */
+    url: string;
+    /**
+     * Optional namespace ID to isolate workflows
+     */
+    namespaceId?: string;
+}
+/**
+ * SQLite backend configuration
+ */
+export interface SqliteConfig {
+    /**
+     * SQLite database file path, or ":memory:" for in-memory database
+     * @example ":memory:"
+     * @example "./data/workflows.db"
+     */
+    file: string;
+}
+/**
+ * Backend configuration with discriminated union
+ */
+export interface BackendConfig {
+    /**
+     * Backend type to use
+     */
+    kind: BackendKind;
+    /**
+     * PostgreSQL-specific configuration (required if kind is "postgres")
+     */
+    postgres?: PostgresConfig;
+    /**
+     * SQLite-specific configuration (required if kind is "sqlite")
+     */
+    sqlite?: SqliteConfig;
+}
+/**
+ * Worker configuration options
+ */
+export interface WorkerConfig {
+    /**
+     * Maximum number of concurrent workflow executions
+     * @default 10
+     */
+    concurrency?: number;
+}
+/**
+ * OpenWorkflow configuration
+ */
+export interface OpenWorkflowConfig {
+    /**
+     * Backend configuration
+     */
+    backend: BackendConfig;
+    /**
+     * Worker configuration
+     */
+    worker?: WorkerConfig;
+    /**
+     * Glob patterns to locate workflow definition files.
+     * @example ["./src/workflows/*.ts"]
+     * @example ["**\/workflows\/**\/*.ts"]
+     */
+    workflowDirs?: string[];
+}
+/**
+ * Define an OpenWorkflow configuration with type safety and autocomplete support.
+ *
+ * @param config - The configuration object
+ * @returns The same configuration object (identity function for type inference)
+ *
+ * @example
+ * ```typescript
+ * import { defineConfig } from "openworkflow/config";
+ *
+ * export default defineConfig({
+ *   backend: {
+ *     kind: "postgres",
+ *     postgres: {
+ *       url: process.env.DATABASE_URL!,
+ *       namespaceId: "my-app"
+ *     }
+ *   },
+ *   worker: {
+ *     concurrency: 5
+ *   },
+ *   workflowDirs: ["./src/workflows/*.ts"]
+ * });
+ * ```
+ */
+export declare function defineConfig(config: OpenWorkflowConfig): OpenWorkflowConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../config/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,IAAI,EAAE,WAAW,CAAC;IAClB;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,aAAa,CAAC;IACvB;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAE3E"}

package/dist/config/config.js

@@ -0,0 +1,29 @@
+/**
+ * Define an OpenWorkflow configuration with type safety and autocomplete support.
+ *
+ * @param config - The configuration object
+ * @returns The same configuration object (identity function for type inference)
+ *
+ * @example
+ * ```typescript
+ * import { defineConfig } from "openworkflow/config";
+ *
+ * export default defineConfig({
+ *   backend: {
+ *     kind: "postgres",
+ *     postgres: {
+ *       url: process.env.DATABASE_URL!,
+ *       namespaceId: "my-app"
+ *     }
+ *   },
+ *   worker: {
+ *     concurrency: 5
+ *   },
+ *   workflowDirs: ["./src/workflows/*.ts"]
+ * });
+ * ```
+ */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../config/config.ts"],"names":[],"mappings":"AAiFA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,3 @@
+export type { BackendConfig, BackendKind, OpenWorkflowConfig, PostgresConfig, SqliteConfig, WorkerConfig, } from "./config.js";
+export { defineConfig } from "./config.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../config/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export { defineConfig } from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../config/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,28 @@
+import type { OpenWorkflow } from "./sdk/sdk.js";
+import type { WorkerOptions } from "./worker/worker.js";
+export type WorkerConfig = Pick<WorkerOptions, "concurrency">;
+/**
+ * Configuration object for OpenWorkflow.
+ * This is the expected shape of the default export from openworkflow.config.ts
+ */
+export interface OpenWorkflowConfig {
+    ow: OpenWorkflow;
+    worker?: WorkerConfig;
+}
+/**
+ * Load OpenWorkflow configuration using c12.
+ * This function searches for openworkflow.config.{ts,js,mjs,cjs} files
+ * in the current working directory and returns the configuration.
+ *
+ * Note: This function requires Node.js and will only work in Node environments.
+ * For non-Node environments (browser, edge), create OpenWorkflow instances manually.
+ *
+ * @param options - Optional configuration options
+ * @param options.cwd - The directory to search for config files (defaults to process.cwd())
+ * @returns The loaded configuration
+ * @throws Error if config file is not found or invalid
+ */
+export declare function loadConfig(options?: {
+    cwd?: string;
+}): Promise<OpenWorkflowConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAE9D;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,YAAY,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoC9B"}

package/dist/config.js

@@ -0,0 +1,41 @@
+/**
+ * Load OpenWorkflow configuration using c12.
+ * This function searches for openworkflow.config.{ts,js,mjs,cjs} files
+ * in the current working directory and returns the configuration.
+ *
+ * Note: This function requires Node.js and will only work in Node environments.
+ * For non-Node environments (browser, edge), create OpenWorkflow instances manually.
+ *
+ * @param options - Optional configuration options
+ * @param options.cwd - The directory to search for config files (defaults to process.cwd())
+ * @returns The loaded configuration
+ * @throws Error if config file is not found or invalid
+ */
+export async function loadConfig(options) {
+    // Dynamic import to avoid breaking non-Node environments
+    // This is lazy-loaded only when actually calling loadConfig()
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const { loadConfig: c12LoadConfig } = await import("c12");
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-call
+    const result = await c12LoadConfig({
+        name: "openworkflow",
+        ...(options?.cwd ? { cwd: options.cwd } : {}),
+    });
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+    const config = result.config;
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+    const configFile = result.configFile;
+    // Check if a config file was actually found and loaded
+    // configFile will be a full path if found, or just the base name if not found
+    const hasConfigFile = configFile?.includes("/") ?? false;
+    // If no config file was found, throw a specific error
+    if (!hasConfigFile) {
+        throw new Error("OpenWorkflow config file not found. Expected: openworkflow.config.{ts,js,mjs,cjs}\nRun 'ow init' to create one.");
+    }
+    // If config file exists but doesn't have the required structure
+    if (!config || typeof config !== "object" || !("ow" in config)) {
+        throw new Error("Config missing 'ow' property. Add 'ow: new OpenWorkflow(...)' to your config export.");
+    }
+    return config;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../config.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAEhC;IACC,yDAAyD;IACzD,8DAA8D;IAC9D,mEAAmE;IACnE,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;IAE1D,sGAAsG;IACtG,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;QACjC,IAAI,EAAE,cAAc;QACpB,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9C,CAAC,CAAC;IAEH,sEAAsE;IACtE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAwC,CAAC;IAC/D,sEAAsE;IACtE,MAAM,UAAU,GAAuB,MAAM,CAAC,UAAU,CAAC;IAEzD,uDAAuD;IACvD,8EAA8E;IAC9E,MAAM,aAAa,GAAG,UAAU,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC;IAEzD,sDAAsD;IACtD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,iHAAiH,CAClH,CAAC;IACJ,CAAC;IAED,gEAAgE;IAChE,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CACb,sFAAsF,CACvF,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/core/backend-test-suite.d.ts

@@ -0,0 +1,22 @@
+import type { Backend } from "./backend.js";
+/**
+ * A factory function that creates a new Backend instance.
+ * Each call should return a fresh, isolated backend (e.g., with a unique namespace).
+ */
+export type BackendFactory = () => Promise<Backend>;
+/**
+ * A teardown function that cleans up a Backend instance.
+ */
+export type BackendTeardown = (backend: Backend) => Promise<void>;
+/**
+ * Runs the Backend compliance test suite.
+ *
+ * This function wraps all the tests that verify a Backend implementation
+ * conforms to the Backend interface contract. It uses the factory to create
+ * backend instances and the teardown function to clean them up.
+ *
+ * @param factory - Creates a new isolated Backend instance
+ * @param teardown - Cleans up a Backend instance
+ */
+export declare function testBackend(factory: BackendFactory, teardown: BackendTeardown): void;
+//# sourceMappingURL=backend-test-suite.d.ts.map

package/dist/core/backend-test-suite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-test-suite.d.ts","sourceRoot":"","sources":["../../core/backend-test-suite.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAI5C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAElE;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,eAAe,GACxB,IAAI,CAulCN"}