@sonamu-kit/tasks 0.0.1

package/dist/client.js

@@ -0,0 +1,223 @@
+import { validateInput } from "./core/workflow.js";
+import { WorkflowRegistry } from "./registry.js";
+import { Worker } from "./worker.js";
+import { defineWorkflow, defineWorkflowSpec } from "./workflow.js";
+const DEFAULT_RESULT_POLL_INTERVAL_MS = 1000; // 1s
+const DEFAULT_RESULT_TIMEOUT_MS = 5 * 60 * 1000; // 5m
+/**
+ * Client used to register workflows and start runs.
+ */ export class OpenWorkflow {
+    backend;
+    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,
+            registry: this.registry,
+            concurrency: options?.concurrency,
+            usePubSub: options?.usePubSub,
+            listenDelay: options?.listenDelay
+        });
+    }
+    /**
+   * 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 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' });
+   * const result = await handle.result();
+   * ```
+   */ async runWorkflow(spec, input, options) {
+        const validationResult = await validateInput(spec.schema, input);
+        if (!validationResult.success) {
+            throw new Error(validationResult.error);
+        }
+        const parsedInput = validationResult.value;
+        const workflowRun = await this.backend.createWorkflowRun({
+            workflowName: spec.name,
+            version: spec.version ?? null,
+            idempotencyKey: null,
+            config: {},
+            context: null,
+            input: parsedInput ?? null,
+            availableAt: null,
+            deadlineAt: options?.deadlineAt ?? null
+        });
+        if (options?.publishToChannel) {
+            await this.backend.publish(workflowRun.id);
+        }
+        return new WorkflowRunHandle({
+            backend: this.backend,
+            workflowRun: workflowRun,
+            resultPollIntervalMs: DEFAULT_RESULT_POLL_INTERVAL_MS,
+            resultTimeoutMs: DEFAULT_RESULT_TIMEOUT_MS
+        });
+    }
+    /**
+   * 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 config - Workflow config
+   * @param fn - Workflow implementation
+   * @returns Runnable workflow
+   * @example
+   * ```ts
+   * const workflow = ow.defineWorkflow(
+   *   { name: 'my-workflow' },
+   *   async ({ input, step }) => {
+   *     // workflow implementation
+   *   },
+   * );
+   * ```
+   */ defineWorkflow(spec, fn) {
+        const workflow = defineWorkflow(spec, fn);
+        this.registry.register(workflow);
+        return new RunnableWorkflow(this, workflow);
+    }
+    /**
+   * Unregister a workflow from the registry.
+   * @param name - The workflow name
+   * @param version - The workflow version (null for unversioned)
+   * @example
+   * ```ts
+   * ow.unregisterWorkflow("my-workflow", "v1");
+   * ```
+   */ unregisterWorkflow(name, version) {
+        this.registry.remove(name, version);
+    }
+    /**
+   * Check if a workflow is registered in the registry.
+   * @param name - The workflow name
+   * @param version - The workflow version (null for unversioned)
+   * @returns True if the workflow is registered, false otherwise
+   * @example
+   * ```ts
+   * ow.isWorkflowRegistered("my-workflow", "v1");
+   * ```
+   */ isWorkflowRegistered(name, version) {
+        return this.registry.has(name, version);
+    }
+}
+/**
+ * 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.
+ * @param config - Workflow config
+ * @param spec - Workflow spec
+ * @returns Workflow spec
+ * @example
+ * ```ts
+ * export const emailWorkflow = declareWorkflow({
+ *   name: 'send-email',
+ *   schema: z.object({ to: z.string().email() }),
+ * });
+ * ```
+ */ // kept for backwards compatibility, to be deprecated
+// eslint-disable-next-line unicorn/prefer-export-from
+export const declareWorkflow = defineWorkflowSpec;
+//
+// --- Workflow Definition
+//
+/**
+ * A fully defined workflow with its implementation. This class is returned by
+ * `defineWorkflow` and provides the `.run()` method for scheduling workflow
+ * runs.
+ */ export class RunnableWorkflow {
+    ow;
+    workflow;
+    constructor(ow, workflow){
+        this.ow = ow;
+        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.workflow.spec, input, options);
+    }
+}
+/**
+ * Represents a started workflow run and provides methods to await its result.
+ * Returned from `workflowDef.run()`.
+ */ export class WorkflowRunHandle {
+    backend;
+    workflowRun;
+    resultPollIntervalMs;
+    resultTimeoutMs;
+    constructor(options){
+        this.backend = options.backend;
+        this.workflowRun = options.workflowRun;
+        this.resultPollIntervalMs = options.resultPollIntervalMs;
+        this.resultTimeoutMs = options.resultTimeoutMs;
+    }
+    /**
+   * Waits for the workflow run to complete and returns the result.
+   * @returns Workflow output
+   */ async result() {
+        const start = Date.now();
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        while(true){
+            const latest = await this.backend.getWorkflowRun({
+                workflowRunId: this.workflowRun.id
+            });
+            if (!latest) {
+                throw new Error(`Workflow run ${this.workflowRun.id} no longer exists`);
+            }
+            // 'succeeded' status is deprecated
+            if (latest.status === "succeeded" || latest.status === "completed") {
+                return latest.output;
+            }
+            if (latest.status === "failed") {
+                throw new Error(`Workflow ${this.workflowRun.workflowName} failed: ${JSON.stringify(latest.error)}`);
+            }
+            if (latest.status === "canceled") {
+                throw new Error(`Workflow ${this.workflowRun.workflowName} was canceled`);
+            }
+            if (Date.now() - start > this.resultTimeoutMs) {
+                throw new Error(`Timed out waiting for workflow run ${this.workflowRun.id} to finish`);
+            }
+            await new Promise((resolve)=>{
+                setTimeout(resolve, this.resultPollIntervalMs);
+            });
+        }
+    }
+    /**
+   * Cancels the workflow run. Only workflows in pending, running, or sleeping
+   * status can be canceled.
+   */ async cancel() {
+        await this.backend.cancelWorkflowRun({
+            workflowRunId: this.workflowRun.id
+        });
+    }
+}
+
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type { Backend } from \"./backend\";\nimport type { StandardSchemaV1 } from \"./core/schema\";\nimport type { SchemaInput, SchemaOutput, WorkflowRun } from \"./core/workflow\";\nimport { validateInput } from \"./core/workflow\";\nimport type { WorkflowFunction } from \"./execution\";\nimport { WorkflowRegistry } from \"./registry\";\nimport { Worker, type WorkerOptions } from \"./worker\";\nimport { defineWorkflow, defineWorkflowSpec, type Workflow, type WorkflowSpec } from \"./workflow\";\n\nconst DEFAULT_RESULT_POLL_INTERVAL_MS = 1000; // 1s\nconst DEFAULT_RESULT_TIMEOUT_MS = 5 * 60 * 1000; // 5m\n\n/* The data the worker function receives (after transformation). */\ntype WorkflowHandlerInput<TSchema, Input> = SchemaOutput<TSchema, Input>;\n\n/* The data the client sends (before transformation) */\ntype WorkflowRunInput<TSchema, Input> = SchemaInput<TSchema, Input>;\n\n/**\n * Options for the OpenWorkflow client.\n */\nexport interface OpenWorkflowOptions {\n  backend: Backend;\n}\n\n/**\n * Client used to register workflows and start runs.\n */\nexport class OpenWorkflow {\n  private backend: Backend;\n  private registry = new WorkflowRegistry();\n\n  constructor(options: OpenWorkflowOptions) {\n    this.backend = options.backend;\n  }\n\n  /**\n   * Create a new Worker with this client's backend and workflows.\n   * @param options - Worker options\n   * @param options.concurrency - Max concurrent workflow runs\n   * @returns Worker instance\n   */\n  newWorker(options?: {\n    concurrency?: number | undefined;\n    usePubSub?: boolean;\n    listenDelay?: number;\n  }): Worker {\n    return new Worker({\n      backend: this.backend,\n      registry: this.registry,\n      concurrency: options?.concurrency,\n      usePubSub: options?.usePubSub,\n      listenDelay: options?.listenDelay,\n    } satisfies WorkerOptions);\n  }\n\n  /**\n   * Provide the implementation for a declared workflow. This links the workflow\n   * specification to its execution logic and registers it with this\n   * OpenWorkflow instance for worker execution.\n   * @param spec - Workflow spec\n   * @param fn - Workflow implementation\n   */\n  implementWorkflow<Input, Output, RunInput = Input>(\n    spec: WorkflowSpec<Input, Output, RunInput>,\n    fn: WorkflowFunction<Input, Output>,\n  ): void {\n    const workflow: Workflow<Input, Output, RunInput> = { spec, fn };\n    this.registry.register(workflow as Workflow<unknown, unknown, unknown>);\n  }\n\n  /**\n   * Run a workflow from its specification. This is the primary way to schedule\n   * a workflow using only its WorkflowSpec.\n   * @param spec - Workflow spec\n   * @param input - Workflow input\n   * @param options - Run options\n   * @returns Handle for awaiting the result\n   * @example\n   * ```ts\n   * const handle = await ow.runWorkflow(emailWorkflow, { to: 'user@example.com' });\n   * const result = await handle.result();\n   * ```\n   */\n  async runWorkflow<Input, Output, RunInput = Input>(\n    spec: WorkflowSpec<Input, Output, RunInput>,\n    input?: RunInput,\n    options?: WorkflowRunOptions,\n  ): Promise<WorkflowRunHandle<Output>> {\n    const validationResult = await validateInput(spec.schema, input);\n    if (!validationResult.success) {\n      throw new Error(validationResult.error);\n    }\n    const parsedInput = validationResult.value;\n    const workflowRun = await this.backend.createWorkflowRun({\n      workflowName: spec.name,\n      version: spec.version ?? null,\n      idempotencyKey: null,\n      config: {},\n      context: null,\n      input: parsedInput ?? null,\n      availableAt: null,\n      deadlineAt: options?.deadlineAt ?? null,\n    });\n\n    if (options?.publishToChannel) {\n      await this.backend.publish(workflowRun.id);\n    }\n\n    return new WorkflowRunHandle<Output>({\n      backend: this.backend,\n      workflowRun: workflowRun,\n      resultPollIntervalMs: DEFAULT_RESULT_POLL_INTERVAL_MS,\n      resultTimeoutMs: DEFAULT_RESULT_TIMEOUT_MS,\n    });\n  }\n\n  /**\n   * Define and register a new workflow.\n   *\n   * This is a convenience method that combines `declareWorkflow` and\n   * `implementWorkflow` into a single call. For better code splitting and to\n   * separate declaration from implementation, consider using those methods\n   * separately.\n   * @param config - Workflow config\n   * @param fn - Workflow implementation\n   * @returns Runnable workflow\n   * @example\n   * ```ts\n   * const workflow = ow.defineWorkflow(\n   *   { name: 'my-workflow' },\n   *   async ({ input, step }) => {\n   *     // workflow implementation\n   *   },\n   * );\n   * ```\n   */\n  defineWorkflow<Input, Output, TSchema extends StandardSchemaV1 | undefined = undefined>(\n    spec: WorkflowSpec<\n      WorkflowHandlerInput<TSchema, Input>,\n      Output,\n      WorkflowRunInput<TSchema, Input>\n    >,\n    fn: WorkflowFunction<WorkflowHandlerInput<TSchema, Input>, Output>,\n  ): RunnableWorkflow<\n    WorkflowHandlerInput<TSchema, Input>,\n    Output,\n    WorkflowRunInput<TSchema, Input>\n  > {\n    const workflow = defineWorkflow(spec, fn);\n    this.registry.register(workflow as Workflow<unknown, unknown, unknown>);\n    return new RunnableWorkflow(this, workflow);\n  }\n\n  /**\n   * Unregister a workflow from the registry.\n   * @param name - The workflow name\n   * @param version - The workflow version (null for unversioned)\n   * @example\n   * ```ts\n   * ow.unregisterWorkflow(\"my-workflow\", \"v1\");\n   * ```\n   */\n  unregisterWorkflow(name: string, version: string | null): void {\n    this.registry.remove(name, version);\n  }\n\n  /**\n   * Check if a workflow is registered in the registry.\n   * @param name - The workflow name\n   * @param version - The workflow version (null for unversioned)\n   * @returns True if the workflow is registered, false otherwise\n   * @example\n   * ```ts\n   * ow.isWorkflowRegistered(\"my-workflow\", \"v1\");\n   * ```\n   */\n  isWorkflowRegistered(name: string, version: string | null): boolean {\n    return this.registry.has(name, version);\n  }\n}\n\n/**\n * Declare a workflow without providing its implementation (which is provided\n * separately via `implementWorkflow`). Returns a lightweight WorkflowSpec\n * that can be used to schedule workflow runs.\n * @param config - Workflow config\n * @param spec - Workflow spec\n * @returns Workflow spec\n * @example\n * ```ts\n * export const emailWorkflow = declareWorkflow({\n *   name: 'send-email',\n *   schema: z.object({ to: z.string().email() }),\n * });\n * ```\n */\n// kept for backwards compatibility, to be deprecated\n// eslint-disable-next-line unicorn/prefer-export-from\nexport const declareWorkflow = defineWorkflowSpec;\n\n//\n// --- Workflow Definition\n//\n\n/**\n * A fully defined workflow with its implementation. This class is returned by\n * `defineWorkflow` and provides the `.run()` method for scheduling workflow\n * runs.\n */\nexport class RunnableWorkflow<Input, Output, RunInput = Input> {\n  private readonly ow: OpenWorkflow;\n  readonly workflow: Workflow<Input, Output, RunInput>;\n\n  constructor(ow: OpenWorkflow, workflow: Workflow<Input, Output, RunInput>) {\n    this.ow = ow;\n    this.workflow = workflow;\n  }\n\n  /**\n   * Starts a new workflow run.\n   * @param input - Workflow input\n   * @param options - Run options\n   * @returns Workflow run handle\n   */\n  async run(input?: RunInput, options?: WorkflowRunOptions): Promise<WorkflowRunHandle<Output>> {\n    return this.ow.runWorkflow(this.workflow.spec, input, options);\n  }\n}\n\n//\n// --- Workflow Run\n//\n\n/**\n * Options for creating a new workflow run from a runnable workflow when calling\n * `workflow.run()`.\n */\nexport interface WorkflowRunOptions {\n  /**\n   * Set a deadline for the workflow run. If the workflow exceeds this deadline,\n   * it will be marked as failed.\n   */\n  deadlineAt?: Date;\n\n  /**\n   * Publish when the workflow run is created to the channel.\n   * Default: true\n   */\n  publishToChannel?: boolean;\n}\n\n/**\n * Options for WorkflowHandle.\n */\nexport interface WorkflowHandleOptions {\n  backend: Backend;\n  workflowRun: WorkflowRun;\n  resultPollIntervalMs: number;\n  resultTimeoutMs: number;\n}\n\n/**\n * Represents a started workflow run and provides methods to await its result.\n * Returned from `workflowDef.run()`.\n */\nexport class WorkflowRunHandle<Output> {\n  private backend: Backend;\n  readonly workflowRun: WorkflowRun;\n  private resultPollIntervalMs: number;\n  private resultTimeoutMs: number;\n\n  constructor(options: WorkflowHandleOptions) {\n    this.backend = options.backend;\n    this.workflowRun = options.workflowRun;\n    this.resultPollIntervalMs = options.resultPollIntervalMs;\n    this.resultTimeoutMs = options.resultTimeoutMs;\n  }\n\n  /**\n   * Waits for the workflow run to complete and returns the result.\n   * @returns Workflow output\n   */\n  async result(): Promise<Output> {\n    const start = Date.now();\n\n    // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition\n    while (true) {\n      const latest = await this.backend.getWorkflowRun({\n        workflowRunId: this.workflowRun.id,\n      });\n\n      if (!latest) {\n        throw new Error(`Workflow run ${this.workflowRun.id} no longer exists`);\n      }\n\n      // 'succeeded' status is deprecated\n      if (latest.status === \"succeeded\" || latest.status === \"completed\") {\n        return latest.output as Output;\n      }\n\n      if (latest.status === \"failed\") {\n        throw new Error(\n          `Workflow ${this.workflowRun.workflowName} failed: ${JSON.stringify(latest.error)}`,\n        );\n      }\n\n      if (latest.status === \"canceled\") {\n        throw new Error(`Workflow ${this.workflowRun.workflowName} was canceled`);\n      }\n\n      if (Date.now() - start > this.resultTimeoutMs) {\n        throw new Error(`Timed out waiting for workflow run ${this.workflowRun.id} to finish`);\n      }\n\n      await new Promise((resolve) => {\n        setTimeout(resolve, this.resultPollIntervalMs);\n      });\n    }\n  }\n\n  /**\n   * Cancels the workflow run. Only workflows in pending, running, or sleeping\n   * status can be canceled.\n   */\n  async cancel(): Promise<void> {\n    await this.backend.cancelWorkflowRun({\n      workflowRunId: this.workflowRun.id,\n    });\n  }\n}\n"],"names":["validateInput","WorkflowRegistry","Worker","defineWorkflow","defineWorkflowSpec","DEFAULT_RESULT_POLL_INTERVAL_MS","DEFAULT_RESULT_TIMEOUT_MS","OpenWorkflow","backend","registry","options","newWorker","concurrency","usePubSub","listenDelay","implementWorkflow","spec","fn","workflow","register","runWorkflow","input","validationResult","schema","success","Error","error","parsedInput","value","workflowRun","createWorkflowRun","workflowName","name","version","idempotencyKey","config","context","availableAt","deadlineAt","publishToChannel","publish","id","WorkflowRunHandle","resultPollIntervalMs","resultTimeoutMs","RunnableWorkflow","unregisterWorkflow","remove","isWorkflowRegistered","has","declareWorkflow","ow","run","result","start","Date","now","latest","getWorkflowRun","workflowRunId","status","output","JSON","stringify","Promise","resolve","setTimeout","cancel","cancelWorkflowRun"],"mappings":"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"}

package/dist/client.test.d.ts

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

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

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

package/dist/client.test.js

@@ -0,0 +1,339 @@
+import { randomUUID } from "node:crypto";
+import { afterEach, beforeEach, describe, expect, test } from "vitest";
+import { z } from "zod";
+import { BackendPostgres } from "./index.js";
+import { declareWorkflow, OpenWorkflow } from "./client.js";
+import { KNEX_GLOBAL_CONFIG } from "./testing/connection.js";
+describe("OpenWorkflow", ()=>{
+    let backend;
+    beforeEach(async ()=>{
+        backend = await BackendPostgres.connect(KNEX_GLOBAL_CONFIG, {
+            namespaceId: randomUUID(),
+            runMigrations: false
+        });
+    });
+    afterEach(async ()=>{
+        await backend.stop();
+    });
+    test("enqueues workflow runs via backend", async ()=>{
+        const client = new OpenWorkflow({
+            backend
+        });
+        const workflow = client.defineWorkflow({
+            name: "enqueue-test"
+        }, noopFn);
+        await workflow.run({
+            docUrl: "https://example.com"
+        });
+        const workerId = "enqueue-worker";
+        const claimed = await backend.claimWorkflowRun({
+            workerId,
+            leaseDurationMs: 1000
+        });
+        expect(claimed?.workflowName).toBe("enqueue-test");
+        expect(claimed?.workerId).toBe(workerId);
+        expect(claimed?.input).toEqual({
+            docUrl: "https://example.com"
+        });
+    });
+    describe("schema validation", ()=>{
+        describe("Zod schema", ()=>{
+            const schema = z.object({
+                userId: z.uuid(),
+                count: z.number().int().positive()
+            });
+            test("accepts valid input", async ()=>{
+                const client = new OpenWorkflow({
+                    backend
+                });
+                const workflow = client.defineWorkflow({
+                    name: "schema-zod-valid",
+                    schema
+                }, noopFn);
+                const handle = await workflow.run({
+                    userId: randomUUID(),
+                    count: 3
+                });
+                await handle.cancel();
+            });
+            test("rejects invalid input", async ()=>{
+                const client = new OpenWorkflow({
+                    backend
+                });
+                const workflow = client.defineWorkflow({
+                    name: "schema-zod-invalid",
+                    schema
+                }, noopFn);
+                await expect(workflow.run({
+                    userId: "not-a-uuid",
+                    count: 0
+                })).rejects.toThrow();
+            });
+        });
+    });
+    test("result resolves when workflow succeeds", async ()=>{
+        const client = new OpenWorkflow({
+            backend
+        });
+        const workflow = client.defineWorkflow({
+            name: "result-success"
+        }, noopFn);
+        const handle = await workflow.run({
+            value: 1
+        });
+        const workerId = "test-worker";
+        const claimed = await backend.claimWorkflowRun({
+            workerId,
+            leaseDurationMs: 1000
+        });
+        expect(claimed).not.toBeNull();
+        if (!claimed) throw new Error("workflow run was not claimed");
+        await backend.completeWorkflowRun({
+            workflowRunId: claimed.id,
+            workerId,
+            output: {
+                ok: true
+            }
+        });
+        // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression
+        const result = await handle.result();
+        expect(result).toEqual({
+            ok: true
+        });
+    });
+    test("result rejects when workflow fails", async ()=>{
+        const client = new OpenWorkflow({
+            backend
+        });
+        const workflow = client.defineWorkflow({
+            name: "result-failure"
+        }, noopFn);
+        await workflow.run({
+            value: 1
+        });
+        const workerId = "test-worker";
+        const claimed = await backend.claimWorkflowRun({
+            workerId,
+            leaseDurationMs: 1000
+        });
+        expect(claimed).not.toBeNull();
+        if (!claimed) throw new Error("workflow run was not claimed");
+        // mark as failed (should reschedule))
+        await backend.failWorkflowRun({
+            workflowRunId: claimed.id,
+            workerId,
+            error: {
+                message: "boom"
+            }
+        });
+        const rescheduled = await backend.getWorkflowRun({
+            workflowRunId: claimed.id
+        });
+        expect(rescheduled?.status).toBe("pending");
+        expect(rescheduled?.error).toEqual({
+            message: "boom"
+        });
+    });
+    test("creates workflow run with deadline", async ()=>{
+        const client = new OpenWorkflow({
+            backend
+        });
+        const workflow = client.defineWorkflow({
+            name: "deadline-test"
+        }, noopFn);
+        const deadline = new Date(Date.now() + 60_000); // in 1 minute
+        const handle = await workflow.run({
+            value: 1
+        }, {
+            deadlineAt: deadline
+        });
+        expect(handle.workflowRun.deadlineAt).not.toBeNull();
+        expect(handle.workflowRun.deadlineAt?.getTime()).toBe(deadline.getTime());
+    });
+    test("creates workflow run with version", async ()=>{
+        const client = new OpenWorkflow({
+            backend
+        });
+        const workflow = client.defineWorkflow({
+            name: "versioned-test",
+            version: "v2.0"
+        }, noopFn);
+        const handle = await workflow.run({
+            value: 1
+        });
+        expect(handle.workflowRun.version).toBe("v2.0");
+    });
+    test("creates workflow run without version", async ()=>{
+        const client = new OpenWorkflow({
+            backend
+        });
+        const workflow = client.defineWorkflow({
+            name: "unversioned-test"
+        }, noopFn);
+        const handle = await workflow.run({
+            value: 1
+        });
+        expect(handle.workflowRun.version).toBeNull();
+    });
+    test("cancels workflow run via handle", async ()=>{
+        const client = new OpenWorkflow({
+            backend
+        });
+        const workflow = client.defineWorkflow({
+            name: "cancel-test"
+        }, noopFn);
+        const handle = await workflow.run({
+            value: 1
+        });
+        await handle.cancel();
+        const workflowRun = await backend.getWorkflowRun({
+            workflowRunId: handle.workflowRun.id
+        });
+        expect(workflowRun?.status).toBe("canceled");
+        expect(workflowRun?.finishedAt).not.toBeNull();
+    });
+    describe("declareWorkflow / implementWorkflow API", ()=>{
+        test("declareWorkflow returns a spec that can be used to schedule runs", async ()=>{
+            const client = new OpenWorkflow({
+                backend
+            });
+            const spec = declareWorkflow({
+                name: "declare-test"
+            });
+            const handle = await client.runWorkflow(spec, {
+                message: "hello"
+            });
+            expect(handle.workflowRun.workflowName).toBe("declare-test");
+            await handle.cancel();
+        });
+        test("implementWorkflow registers the workflow for worker execution", async ()=>{
+            const client = new OpenWorkflow({
+                backend
+            });
+            const spec = declareWorkflow({
+                name: "implement-test"
+            });
+            client.implementWorkflow(spec, ({ input })=>{
+                return {
+                    received: input
+                };
+            });
+            const handle = await client.runWorkflow(spec, {
+                data: 42
+            });
+            const worker = client.newWorker();
+            await worker.tick();
+            await sleep(100); // wait for background execution
+            const result = await handle.result();
+            expect(result).toEqual({
+                received: {
+                    data: 42
+                }
+            });
+        });
+        test("implementWorkflow throws when workflow is already registered", async ()=>{
+            const client = new OpenWorkflow({
+                backend
+            });
+            const spec = declareWorkflow({
+                name: "duplicate-test"
+            });
+            client.implementWorkflow(spec, noopFn);
+            expect(()=>{
+                client.implementWorkflow(spec, noopFn);
+            }).toThrow('Workflow "duplicate-test" is already registered');
+        });
+        test("implementWorkflow allows registering different versions of the same workflow", async ()=>{
+            const client = new OpenWorkflow({
+                backend
+            });
+            const specV1 = declareWorkflow({
+                name: "multi-version",
+                version: "v1"
+            });
+            const specV2 = declareWorkflow({
+                name: "multi-version",
+                version: "v2"
+            });
+            // no throwing...
+            client.implementWorkflow(specV1, noopFn);
+            client.implementWorkflow(specV2, noopFn);
+        });
+        test("implementWorkflow throws for same name+version combination", async ()=>{
+            const client = new OpenWorkflow({
+                backend
+            });
+            const spec1 = declareWorkflow({
+                name: "version-duplicate",
+                version: "v1"
+            });
+            const spec2 = declareWorkflow({
+                name: "version-duplicate",
+                version: "v1"
+            });
+            client.implementWorkflow(spec1, noopFn);
+            expect(()=>{
+                client.implementWorkflow(spec2, noopFn);
+            }).toThrow('Workflow "version-duplicate" (version: v1) is already registered');
+        });
+        test("declareWorkflow with schema validates input on runWorkflow", async ()=>{
+            const client = new OpenWorkflow({
+                backend
+            });
+            const schema = z.object({
+                email: z.email()
+            });
+            const spec = declareWorkflow({
+                name: "declare-schema-test",
+                schema
+            });
+            const handle = await client.runWorkflow(spec, {
+                email: "test@example.com"
+            });
+            await handle.cancel();
+            await expect(client.runWorkflow(spec, {
+                email: "not-an-email"
+            })).rejects.toThrow();
+        });
+        test("declareWorkflow with version sets version on workflow run", async ()=>{
+            const client = new OpenWorkflow({
+                backend
+            });
+            const spec = declareWorkflow({
+                name: "declare-version-test",
+                version: "v1.2.3"
+            });
+            const handle = await client.runWorkflow(spec);
+            expect(handle.workflowRun.version).toBe("v1.2.3");
+            await handle.cancel();
+        });
+        test("defineWorkflow wraps declareWorkflow and implementWorkflow", async ()=>{
+            const client = new OpenWorkflow({
+                backend
+            });
+            const workflow = client.defineWorkflow({
+                name: "define-wrap-test"
+            }, ({ input })=>({
+                    doubled: input.n * 2
+                }));
+            const handle = await workflow.run({
+                n: 21
+            });
+            const worker = client.newWorker();
+            await worker.tick();
+            await sleep(100); // wait for background execution
+            const result = await handle.result();
+            expect(result).toEqual({
+                doubled: 42
+            });
+        });
+    });
+});
+function sleep(ms) {
+    return new Promise((resolve)=>setTimeout(resolve, ms));
+}
+async function noopFn() {
+// no-op
+}
+
+//# sourceMappingURL=client.test.js.map

package/dist/client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.test.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { afterEach, beforeEach, describe, expect, test } from \"vitest\";\nimport { z } from \"zod\";\nimport { BackendPostgres } from \".\";\nimport { declareWorkflow, OpenWorkflow } from \"./client\";\nimport { KNEX_GLOBAL_CONFIG } from \"./testing/connection\";\n\ndescribe(\"OpenWorkflow\", () => {\n  let backend: BackendPostgres;\n\n  beforeEach(async () => {\n    backend = await BackendPostgres.connect(KNEX_GLOBAL_CONFIG, {\n      namespaceId: randomUUID(),\n      runMigrations: false,\n    });\n  });\n\n  afterEach(async () => {\n    await backend.stop();\n  });\n\n  test(\"enqueues workflow runs via backend\", async () => {\n    const client = new OpenWorkflow({ backend });\n\n    const workflow = client.defineWorkflow({ name: \"enqueue-test\" }, noopFn);\n    await workflow.run({ docUrl: \"https://example.com\" });\n\n    const workerId = \"enqueue-worker\";\n    const claimed = await backend.claimWorkflowRun({\n      workerId,\n      leaseDurationMs: 1000,\n    });\n\n    expect(claimed?.workflowName).toBe(\"enqueue-test\");\n    expect(claimed?.workerId).toBe(workerId);\n    expect(claimed?.input).toEqual({ docUrl: \"https://example.com\" });\n  });\n\n  describe(\"schema validation\", () => {\n    describe(\"Zod schema\", () => {\n      const schema = z.object({\n        userId: z.uuid(),\n        count: z.number().int().positive(),\n      });\n\n      test(\"accepts valid input\", async () => {\n        const client = new OpenWorkflow({ backend });\n        const workflow = client.defineWorkflow({ name: \"schema-zod-valid\", schema }, noopFn);\n\n        const handle = await workflow.run({\n          userId: randomUUID(),\n          count: 3,\n        });\n\n        await handle.cancel();\n      });\n\n      test(\"rejects invalid input\", async () => {\n        const client = new OpenWorkflow({ backend });\n        const workflow = client.defineWorkflow({ name: \"schema-zod-invalid\", schema }, noopFn);\n\n        await expect(workflow.run({ userId: \"not-a-uuid\", count: 0 } as never)).rejects.toThrow();\n      });\n    });\n  });\n\n  test(\"result resolves when workflow succeeds\", async () => {\n    const client = new OpenWorkflow({ backend });\n\n    const workflow = client.defineWorkflow({ name: \"result-success\" }, noopFn);\n    const handle = await workflow.run({ value: 1 });\n\n    const workerId = \"test-worker\";\n    const claimed = await backend.claimWorkflowRun({\n      workerId,\n      leaseDurationMs: 1000,\n    });\n    expect(claimed).not.toBeNull();\n    if (!claimed) throw new Error(\"workflow run was not claimed\");\n\n    await backend.completeWorkflowRun({\n      workflowRunId: claimed.id,\n      workerId,\n      output: { ok: true },\n    });\n\n    // eslint-disable-next-line @typescript-eslint/no-confusing-void-expression\n    const result = await handle.result();\n    expect(result).toEqual({ ok: true });\n  });\n\n  test(\"result rejects when workflow fails\", async () => {\n    const client = new OpenWorkflow({ backend });\n\n    const workflow = client.defineWorkflow({ name: \"result-failure\" }, noopFn);\n    await workflow.run({ value: 1 });\n\n    const workerId = \"test-worker\";\n    const claimed = await backend.claimWorkflowRun({\n      workerId,\n      leaseDurationMs: 1000,\n    });\n    expect(claimed).not.toBeNull();\n    if (!claimed) throw new Error(\"workflow run was not claimed\");\n\n    // mark as failed (should reschedule))\n    await backend.failWorkflowRun({\n      workflowRunId: claimed.id,\n      workerId,\n      error: { message: \"boom\" },\n    });\n\n    const rescheduled = await backend.getWorkflowRun({\n      workflowRunId: claimed.id,\n    });\n    expect(rescheduled?.status).toBe(\"pending\");\n    expect(rescheduled?.error).toEqual({ message: \"boom\" });\n  });\n\n  test(\"creates workflow run with deadline\", async () => {\n    const client = new OpenWorkflow({ backend });\n\n    const workflow = client.defineWorkflow({ name: \"deadline-test\" }, noopFn);\n    const deadline = new Date(Date.now() + 60_000); // in 1 minute\n    const handle = await workflow.run({ value: 1 }, { deadlineAt: deadline });\n\n    expect(handle.workflowRun.deadlineAt).not.toBeNull();\n    expect(handle.workflowRun.deadlineAt?.getTime()).toBe(deadline.getTime());\n  });\n\n  test(\"creates workflow run with version\", async () => {\n    const client = new OpenWorkflow({ backend });\n\n    const workflow = client.defineWorkflow({ name: \"versioned-test\", version: \"v2.0\" }, noopFn);\n    const handle = await workflow.run({ value: 1 });\n\n    expect(handle.workflowRun.version).toBe(\"v2.0\");\n  });\n\n  test(\"creates workflow run without version\", async () => {\n    const client = new OpenWorkflow({ backend });\n\n    const workflow = client.defineWorkflow({ name: \"unversioned-test\" }, noopFn);\n    const handle = await workflow.run({ value: 1 });\n\n    expect(handle.workflowRun.version).toBeNull();\n  });\n\n  test(\"cancels workflow run via handle\", async () => {\n    const client = new OpenWorkflow({ backend });\n\n    const workflow = client.defineWorkflow({ name: \"cancel-test\" }, noopFn);\n    const handle = await workflow.run({ value: 1 });\n\n    await handle.cancel();\n\n    const workflowRun = await backend.getWorkflowRun({\n      workflowRunId: handle.workflowRun.id,\n    });\n    expect(workflowRun?.status).toBe(\"canceled\");\n    expect(workflowRun?.finishedAt).not.toBeNull();\n  });\n\n  describe(\"declareWorkflow / implementWorkflow API\", () => {\n    test(\"declareWorkflow returns a spec that can be used to schedule runs\", async () => {\n      const client = new OpenWorkflow({ backend });\n\n      const spec = declareWorkflow({ name: \"declare-test\" });\n\n      const handle = await client.runWorkflow(spec, { message: \"hello\" });\n      expect(handle.workflowRun.workflowName).toBe(\"declare-test\");\n\n      await handle.cancel();\n    });\n\n    test(\"implementWorkflow registers the workflow for worker execution\", async () => {\n      const client = new OpenWorkflow({ backend });\n\n      const spec = declareWorkflow({ name: \"implement-test\" });\n      client.implementWorkflow(spec, ({ input }) => {\n        return { received: input };\n      });\n\n      const handle = await client.runWorkflow(spec, { data: 42 });\n      const worker = client.newWorker();\n      await worker.tick();\n      await sleep(100); // wait for background execution\n\n      const result = await handle.result();\n      expect(result).toEqual({ received: { data: 42 } });\n    });\n\n    test(\"implementWorkflow throws when workflow is already registered\", async () => {\n      const client = new OpenWorkflow({ backend });\n\n      const spec = declareWorkflow({ name: \"duplicate-test\" });\n      client.implementWorkflow(spec, noopFn);\n\n      expect(() => {\n        client.implementWorkflow(spec, noopFn);\n      }).toThrow('Workflow \"duplicate-test\" is already registered');\n    });\n\n    test(\"implementWorkflow allows registering different versions of the same workflow\", async () => {\n      const client = new OpenWorkflow({ backend });\n\n      const specV1 = declareWorkflow({\n        name: \"multi-version\",\n        version: \"v1\",\n      });\n      const specV2 = declareWorkflow({\n        name: \"multi-version\",\n        version: \"v2\",\n      });\n\n      // no throwing...\n      client.implementWorkflow(specV1, noopFn);\n      client.implementWorkflow(specV2, noopFn);\n    });\n\n    test(\"implementWorkflow throws for same name+version combination\", async () => {\n      const client = new OpenWorkflow({ backend });\n\n      const spec1 = declareWorkflow({\n        name: \"version-duplicate\",\n        version: \"v1\",\n      });\n      const spec2 = declareWorkflow({\n        name: \"version-duplicate\",\n        version: \"v1\",\n      });\n\n      client.implementWorkflow(spec1, noopFn);\n\n      expect(() => {\n        client.implementWorkflow(spec2, noopFn);\n      }).toThrow('Workflow \"version-duplicate\" (version: v1) is already registered');\n    });\n\n    test(\"declareWorkflow with schema validates input on runWorkflow\", async () => {\n      const client = new OpenWorkflow({ backend });\n\n      const schema = z.object({\n        email: z.email(),\n      });\n      const spec = declareWorkflow({\n        name: \"declare-schema-test\",\n        schema,\n      });\n\n      const handle = await client.runWorkflow(spec, {\n        email: \"test@example.com\",\n      });\n      await handle.cancel();\n\n      await expect(client.runWorkflow(spec, { email: \"not-an-email\" })).rejects.toThrow();\n    });\n\n    test(\"declareWorkflow with version sets version on workflow run\", async () => {\n      const client = new OpenWorkflow({ backend });\n\n      const spec = declareWorkflow({\n        name: \"declare-version-test\",\n        version: \"v1.2.3\",\n      });\n\n      const handle = await client.runWorkflow(spec);\n      expect(handle.workflowRun.version).toBe(\"v1.2.3\");\n\n      await handle.cancel();\n    });\n\n    test(\"defineWorkflow wraps declareWorkflow and implementWorkflow\", async () => {\n      const client = new OpenWorkflow({ backend });\n\n      const workflow = client.defineWorkflow({ name: \"define-wrap-test\" }, ({ input }) => ({\n        doubled: (input as { n: number }).n * 2,\n      }));\n\n      const handle = await workflow.run({ n: 21 });\n      const worker = client.newWorker();\n      await worker.tick();\n      await sleep(100); // wait for background execution\n\n      const result = await handle.result();\n      expect(result).toEqual({ doubled: 42 });\n    });\n  });\n});\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n\nasync function noopFn() {\n  // no-op\n}\n"],"names":["randomUUID","afterEach","beforeEach","describe","expect","test","z","BackendPostgres","declareWorkflow","OpenWorkflow","KNEX_GLOBAL_CONFIG","backend","connect","namespaceId","runMigrations","stop","client","workflow","defineWorkflow","name","noopFn","run","docUrl","workerId","claimed","claimWorkflowRun","leaseDurationMs","workflowName","toBe","input","toEqual","schema","object","userId","uuid","count","number","int","positive","handle","cancel","rejects","toThrow","value","not","toBeNull","Error","completeWorkflowRun","workflowRunId","id","output","ok","result","failWorkflowRun","error","message","rescheduled","getWorkflowRun","status","deadline","Date","now","deadlineAt","workflowRun","getTime","version","finishedAt","spec","runWorkflow","implementWorkflow","received","data","worker","newWorker","tick","sleep","specV1","specV2","spec1","spec2","email","doubled","n","ms","Promise","resolve","setTimeout"],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,22 @@
+import type { Backend } from "./backend";
+import type { WorkerOptions } from "./worker";
+export interface OpenWorkflowConfig {
+    backend: Backend;
+    worker?: WorkerConfig;
+}
+export type WorkerConfig = Pick<WorkerOptions, "concurrency">;
+/**
+ * Create a typed OpenWorkflow configuration.
+ * @param config - the config
+ * @returns the config
+ */
+export declare function defineConfig(config: OpenWorkflowConfig): OpenWorkflowConfig;
+/**
+ * Load the OpenWorkflow config at openworkflow.config.ts (or other extension;
+ * see https://github.com/unjs/c12)
+ * @param rootDir - Optional root directory to search from (defaults to
+ * process.cwd())
+ * @returns The loaded configuration and metadata
+ */
+export declare function loadConfig(rootDir?: string): Promise<import("c12").ResolvedConfig<OpenWorkflowConfig, import("c12").ConfigLayerMeta>>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;AAE9D;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,CAE3E;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,4FAOhD"}