openworkflow 0.4.1 → 0.5.0

package/dist/backend-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/backend-sqlite/sqlite.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/backend-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"}

package/dist/backend-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,24 +214,32 @@ 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;

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

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

package/dist/{core/backend.d.ts → backend.d.ts}

@@ -1,6 +1,7 @@
-import { JsonValue } from "./json.js";
-import type { StepAttempt, StepAttemptContext, StepKind } from "./step.js";
-import type { WorkflowRun } from "./workflow.js";
+import type { SerializedError } from "./core/error.js";
+import { JsonValue } from "./core/json.js";
+import type { StepAttempt, StepAttemptContext, StepKind } from "./core/step.js";
+import type { WorkflowRun } from "./core/workflow.js";
 export declare const DEFAULT_NAMESPACE_ID = "default";
 /**
  * Backend is the interface for backend providers to implement.
@@ -20,6 +21,7 @@ export interface Backend {
     listStepAttempts(params: Readonly<ListStepAttemptsParams>): Promise<PaginatedResponse<StepAttempt>>;
     completeStepAttempt(params: Readonly<CompleteStepAttemptParams>): Promise<StepAttempt>;
     failStepAttempt(params: Readonly<FailStepAttemptParams>): Promise<StepAttempt>;
+    stop(): Promise<void>;
 }
 export interface CreateWorkflowRunParams {
     workflowName: string;
@@ -57,7 +59,7 @@ export interface CompleteWorkflowRunParams {
 export interface FailWorkflowRunParams {
     workflowRunId: string;
     workerId: string;
-    error: JsonValue;
+    error: SerializedError;
 }
 export interface CancelWorkflowRunParams {
     workflowRunId: string;
@@ -86,7 +88,7 @@ export interface FailStepAttemptParams {
     workflowRunId: string;
     stepAttemptId: string;
     workerId: string;
-    error: JsonValue;
+    error: SerializedError;
 }
 export interface PaginationOptions {
     limit?: number;

package/dist/backend.d.ts.map

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

package/dist/backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../backend.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,oBAAoB,GAAG,SAAS,CAAC"}

package/dist/bin/openworkflow.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=openworkflow.d.ts.map

package/dist/bin/openworkflow.d.ts.map

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

package/dist/bin/openworkflow.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+/**
+ * This script is a zero-dependency entrypoint for the OpenWorkflow CLI. It
+ * allows users to run `npx openworkflow <command>` without requiring the core
+ * 'openworkflow' package to have any production dependencies (like commander,
+ * consola, etc).
+ *
+ * Note: This file is transpiled to `./dist/bin/openworkflow.js`. Relative paths
+ * below are calculated based on that runtime location.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = fileURLToPath(new URL(".", import.meta.url));
+// get the version of the current package to ensure we call the matching CLI
+const packageJsonPath = path.join(__dirname, "../../package.json");
+const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+const version = packageJson.version;
+// capture all args passed to npx openworkflow (e.g., "init", "worker start")
+const args = process.argv.slice(2);
+// build the command, using tsx to run local TypeScript CLI if in dev and
+// otherwise using npx to run the published CLI package
+const cliScriptFilePath = path.resolve(__dirname, "../../../cli/cli.ts");
+const isMonorepo = existsSync(cliScriptFilePath);
+if (isMonorepo) {
+    console.log("⚠️ Running OpenWorkflow CLI from local source (monorepo development mode)\n");
+}
+const command = isMonorepo
+    ? // `npx tsx ../../../cli/cli.ts ...args`
+        ["tsx", cliScriptFilePath, ...args]
+    : // `npx -y @openworkflow/cli@<version> ...args`
+        // uses -y to skip the "Need to install @openworkflow/cli" prompt
+        ["-y", `@openworkflow/cli@${version}`, ...args];
+// spawn the CLI the command to run the actual CLI package
+const result = spawnSync(
+// eslint-disable-next-line sonarjs/no-os-command-from-path
+"npx", command, {
+    stdio: "inherit",
+    shell: true,
+});
+// exit with the same status code as the CLI
+process.exit(result.status ?? 0);
+//# sourceMappingURL=openworkflow.js.map

package/dist/bin/openworkflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openworkflow.js","sourceRoot":"","sources":["../../bin/openworkflow.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,4EAA4E;AAC5E,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;AACnE,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,MAAM,CAAC,CAEnE,CAAC;AACF,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;AAEpC,6EAA6E;AAC7E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,yEAAyE;AACzE,uDAAuD;AACvD,MAAM,iBAAiB,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,qBAAqB,CAAC,CAAC;AACzE,MAAM,UAAU,GAAG,UAAU,CAAC,iBAAiB,CAAC,CAAC;AAEjD,IAAI,UAAU,EAAE,CAAC;IACf,OAAO,CAAC,GAAG,CACT,6EAA6E,CAC9E,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAG,UAAU;IACxB,CAAC,CAAC,wCAAwC;QACxC,CAAC,KAAK,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IACrC,CAAC,CAAC,+CAA+C;QAC/C,iEAAiE;QACjE,CAAC,IAAI,EAAE,qBAAqB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;AAEpD,0DAA0D;AAC1D,MAAM,MAAM,GAAG,SAAS;AACtB,2DAA2D;AAC3D,KAAK,EACL,OAAO,EACP;IACE,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,IAAI;CACZ,CACF,CAAC;AAEF,4CAA4C;AAC5C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,141 @@
+import type { Backend } from "./backend.js";
+import type { StandardSchemaV1 } from "./core/schema.js";
+import type { SchemaInput, SchemaOutput, WorkflowRun } from "./core/workflow.js";
+import type { WorkflowFunction } from "./execution.js";
+import { Worker } from "./worker.js";
+import { type Workflow, type WorkflowSpec } from "./workflow.js";
+type WorkflowHandlerInput<TSchema, Input> = SchemaOutput<TSchema, Input>;
+type WorkflowRunInput<TSchema, Input> = SchemaInput<TSchema, Input>;
+/**
+ * Options for the OpenWorkflow client.
+ */
+export interface OpenWorkflowOptions {
+    backend: Backend;
+}
+/**
+ * Client used to register workflows and start runs.
+ */
+export declare class OpenWorkflow {
+    private backend;
+    private registry;
+    constructor(options: OpenWorkflowOptions);
+    /**
+     * Create a new Worker with this client's backend and workflows.
+     * @param options - Worker options
+     * @param options.concurrency - Max concurrent workflow runs
+     * @returns Worker instance
+     */
+    newWorker(options?: {
+        concurrency?: number | undefined;
+    }): Worker;
+    /**
+     * Provide the implementation for a declared workflow. This links the workflow
+     * specification to its execution logic and registers it with this
+     * OpenWorkflow instance for worker execution.
+     * @param spec - Workflow spec
+     * @param fn - Workflow implementation
+     */
+    implementWorkflow<Input, Output, RunInput = Input>(spec: WorkflowSpec<Input, Output, RunInput>, fn: WorkflowFunction<Input, Output>): void;
+    /**
+     * Run a workflow from its specification. This is the primary way to schedule
+     * a workflow using only its WorkflowSpec.
+     * @param spec - Workflow spec
+     * @param input - Workflow input
+     * @param options - Run options
+     * @returns Handle for awaiting the result
+     * @example
+     * ```ts
+     * const handle = await ow.runWorkflow(emailWorkflow, { to: 'user@example.com' });
+     * const result = await handle.result();
+     * ```
+     */
+    runWorkflow<Input, Output, RunInput = Input>(spec: WorkflowSpec<Input, Output, RunInput>, input?: RunInput, options?: WorkflowRunOptions): Promise<WorkflowRunHandle<Output>>;
+    /**
+     * Define and register a new workflow.
+     * @param spec - Workflow spec
+     * @param fn - Workflow implementation
+     * @returns Runnable workflow
+     * @example
+     * ```ts
+     * const workflow = ow.defineWorkflow(
+     *   { name: 'my-workflow' },
+     *   async ({ input, step }) => {
+     *     // workflow implementation
+     *   },
+     * );
+     * ```
+     */
+    defineWorkflow<Input, Output, TSchema extends StandardSchemaV1 | undefined = undefined>(spec: WorkflowSpec<WorkflowHandlerInput<TSchema, Input>, Output, WorkflowRunInput<TSchema, Input>>, fn: WorkflowFunction<WorkflowHandlerInput<TSchema, Input>, Output>): RunnableWorkflow<WorkflowHandlerInput<TSchema, Input>, Output, WorkflowRunInput<TSchema, Input>>;
+}
+/**
+ * A fully defined workflow with its implementation. This class is returned by
+ * `client.defineWorkflow` and provides the `.run()` method for scheduling
+ * workflow runs.
+ */
+export declare class RunnableWorkflow<Input, Output, RunInput = Input> {
+    private readonly ow;
+    readonly workflow: Workflow<Input, Output, RunInput>;
+    constructor(ow: OpenWorkflow, workflow: Workflow<Input, Output, RunInput>);
+    /**
+     * Starts a new workflow run.
+     * @param input - Workflow input
+     * @param options - Run options
+     * @returns Workflow run handle
+     */
+    run(input?: RunInput, options?: WorkflowRunOptions): Promise<WorkflowRunHandle<Output>>;
+}
+/**
+ * Options for creating a new workflow run from a runnable workflow when calling
+ * `workflowDef.run()`.
+ */
+export interface WorkflowRunOptions {
+    /**
+     * Set a deadline for the workflow run. If the workflow exceeds this deadline,
+     * it will be marked as failed.
+     */
+    deadlineAt?: Date;
+}
+/**
+ * Options for WorkflowHandle.
+ */
+export interface WorkflowHandleOptions {
+    backend: Backend;
+    workflowRun: WorkflowRun;
+    resultPollIntervalMs: number;
+    resultTimeoutMs: number;
+}
+/**
+ * Options for result() on a WorkflowRunHandle.
+ */
+export interface WorkflowRunHandleResultOptions {
+    /**
+     * Time to wait for a workflow run to complete. Throws an error if the timeout
+     * is exceeded.
+     * @default 300000 (5 minutes)
+     */
+    timeoutMs?: number;
+}
+/**
+ * Represents a started workflow run and provides methods to await its result.
+ * Returned from `workflowDef.run()`.
+ */
+export declare class WorkflowRunHandle<Output> {
+    private backend;
+    readonly workflowRun: WorkflowRun;
+    private resultPollIntervalMs;
+    private resultTimeoutMs;
+    constructor(options: WorkflowHandleOptions);
+    /**
+     * Waits for the workflow run to complete and returns the result.
+     * @param options - Options for waiting for the result
+     * @returns Workflow output
+     */
+    result(options?: WorkflowRunHandleResultOptions): Promise<Output>;
+    /**
+     * Cancels the workflow run. Only workflows in pending, running, or sleeping
+     * status can be canceled.
+     */
+    cancel(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/{sdk/sdk.js → client.js}

@@ -1,5 +1,7 @@
-import { validateInput } from "../core/workflow.js";
-import { Worker } from "../worker/worker.js";
+import { validateInput } from "./core/workflow.js";
+import { WorkflowRegistry } from "./registry.js";
+import { Worker } from "./worker.js";
+import { defineWorkflow, } from "./workflow.js";
 const DEFAULT_RESULT_POLL_INTERVAL_MS = 1000; // 1s
 const DEFAULT_RESULT_TIMEOUT_MS = 5 * 60 * 1000; // 5m
 /**
@@ -7,17 +9,20 @@ const DEFAULT_RESULT_TIMEOUT_MS = 5 * 60 * 1000; // 5m
  */
 export class OpenWorkflow {
     backend;
-    registeredWorkflows = new Map();
+    registry = new WorkflowRegistry();
     constructor(options) {
         this.backend = options.backend;
     }
     /**
      * Create a new Worker with this client's backend and workflows.
+     * @param options - Worker options
+     * @param options.concurrency - Max concurrent workflow runs
+     * @returns Worker instance
      */
     newWorker(options) {
         return new Worker({
             backend: this.backend,
-            workflows: this.registeredWorkflows,
+            workflows: this.registry.getAll(),
             concurrency: options?.concurrency,
         });
     }
@@ -25,20 +30,23 @@ export class OpenWorkflow {
      * Provide the implementation for a declared workflow. This links the workflow
      * specification to its execution logic and registers it with this
      * OpenWorkflow instance for worker execution.
+     * @param spec - Workflow spec
+     * @param fn - Workflow implementation
      */
     implementWorkflow(spec, fn) {
-        const key = getWorkflowKey(spec.name, spec.version);
-        if (this.registeredWorkflows.has(key)) {
-            const versionStr = spec.version ? ` (version: ${spec.version})` : "";
-            throw new Error(`Workflow "${spec.name}"${versionStr} is already registered`);
-        }
-        const definition = new WorkflowDefinition(this, spec, fn);
-        this.registeredWorkflows.set(key, definition);
+        const workflow = {
+            spec,
+            fn,
+        };
+        this.registry.register(workflow);
     }
     /**
      * Run a workflow from its specification. This is the primary way to schedule
      * a workflow using only its WorkflowSpec.
-     *
+     * @param spec - Workflow spec
+     * @param input - Workflow input
+     * @param options - Run options
+     * @returns Handle for awaiting the result
      * @example
      * ```ts
      * const handle = await ow.runWorkflow(emailWorkflow, { to: 'user@example.com' });
@@ -53,7 +61,7 @@ export class OpenWorkflow {
         const parsedInput = validationResult.value;
         const workflowRun = await this.backend.createWorkflowRun({
             workflowName: spec.name,
-            version: spec.version,
+            version: spec.version ?? null,
             idempotencyKey: null,
             config: {},
             context: null,
@@ -70,12 +78,9 @@ export class OpenWorkflow {
     }
     /**
      * Define and register a new workflow.
-     *
-     * This is a convenience method that combines `declareWorkflow` and
-     * `implementWorkflow` into a single call. For better code splitting and to
-     * separate declaration from implementation, consider using those methods
-     * separately.
-     *
+     * @param spec - Workflow spec
+     * @param fn - Workflow implementation
+     * @returns Runnable workflow
      * @example
      * ```ts
      * const workflow = ow.defineWorkflow(
@@ -86,67 +91,32 @@ export class OpenWorkflow {
      * );
      * ```
      */
-    defineWorkflow(config, fn) {
-        const spec = declareWorkflow(config);
-        const key = getWorkflowKey(spec.name, spec.version);
-        const definition = new WorkflowDefinition(this, spec, fn);
-        this.registeredWorkflows.set(key, definition);
-        return definition;
+    defineWorkflow(spec, fn) {
+        const workflow = defineWorkflow(spec, fn);
+        this.registry.register(workflow);
+        return new RunnableWorkflow(this, workflow);
     }
 }
-/**
- * Declare a workflow without providing its implementation (which is provided
- * separately via `implementWorkflow`). Returns a lightweight WorkflowSpec
- * that can be used to schedule workflow runs.
- *
- * @example
- * ```ts
- * export const emailWorkflow = declareWorkflow({
- *   name: 'send-email',
- *   schema: z.object({ to: z.string().email() }),
- * });
- * ```
- */
-export function declareWorkflow(config) {
-    return {
-        name: config.name,
-        version: config.version ?? null,
-        schema: config.schema ?? null,
-    };
-}
-/**
- * Generate a composite key for workflow registration that includes both name
- * and version.
- *
- * @param name - The workflow name
- * @param version - The workflow version (null for unversioned)
- * @returns A composite key string
- */
-export function getWorkflowKey(name, version) {
-    return version ? `${name}@${version}` : name;
-}
-//
-// --- Workflow Definition
-//
 /**
  * A fully defined workflow with its implementation. This class is returned by
- * `defineWorkflow` and provides the `.run()` method for scheduling workflow
- * runs.
+ * `client.defineWorkflow` and provides the `.run()` method for scheduling
+ * workflow runs.
  */
-export class WorkflowDefinition {
+export class RunnableWorkflow {
     ow;
-    spec;
-    fn;
-    constructor(ow, spec, fn) {
+    workflow;
+    constructor(ow, workflow) {
         this.ow = ow;
-        this.spec = spec;
-        this.fn = fn;
+        this.workflow = workflow;
     }
     /**
      * Starts a new workflow run.
+     * @param input - Workflow input
+     * @param options - Run options
+     * @returns Workflow run handle
      */
     async run(input, options) {
-        return this.ow.runWorkflow(this.spec, input, options);
+        return this.ow.runWorkflow(this.workflow.spec, input, options);
     }
 }
 /**
@@ -166,9 +136,12 @@ export class WorkflowRunHandle {
     }
     /**
      * Waits for the workflow run to complete and returns the result.
+     * @param options - Options for waiting for the result
+     * @returns Workflow output
      */
-    async result() {
+    async result(options) {
         const start = Date.now();
+        const timeout = options?.timeoutMs ?? this.resultTimeoutMs;
         // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
         while (true) {
             const latest = await this.backend.getWorkflowRun({
@@ -187,7 +160,7 @@ export class WorkflowRunHandle {
             if (latest.status === "canceled") {
                 throw new Error(`Workflow ${this.workflowRun.workflowName} was canceled`);
             }
-            if (Date.now() - start > this.resultTimeoutMs) {
+            if (Date.now() - start > timeout) {
                 throw new Error(`Timed out waiting for workflow run ${this.workflowRun.id} to finish`);
             }
             await new Promise((resolve) => {
@@ -205,4 +178,4 @@ export class WorkflowRunHandle {
         });
     }
 }
-//# sourceMappingURL=sdk.js.map
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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