openworkflow 0.4.1 → 0.6.0

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

@@ -1,23 +1,16 @@
-import { BackendPostgres } from "../../backend-postgres/backend.js";
-import { DEFAULT_DATABASE_URL } from "../../backend-postgres/postgres.js";
-import { OpenWorkflow } from "./sdk.js";
+import { OpenWorkflow } from "./client.js";
+import { BackendPostgres } from "./postgres.js";
+import { DEFAULT_POSTGRES_URL } from "./postgres/postgres.js";
+import { defineWorkflowSpec } from "./workflow.js";
 import { type as arkType } from "arktype";
 import { randomUUID } from "node:crypto";
 import * as v from "valibot";
-import { afterAll, beforeAll, describe, expect, test } from "vitest";
+import { describe, expect, test } from "vitest";
 import { number as yupNumber, object as yupObject, string as yupString, } from "yup";
 import { z } from "zod";
 describe("OpenWorkflow", () => {
-    let backend;
-    beforeAll(async () => {
-        backend = await BackendPostgres.connect(DEFAULT_DATABASE_URL, {
-            namespaceId: randomUUID(),
-        });
-    });
-    afterAll(async () => {
-        await backend.stop();
-    });
     test("enqueues workflow runs via backend", async () => {
+        const backend = await createBackend();
         const client = new OpenWorkflow({ backend });
         const workflow = client.defineWorkflow({ name: "enqueue-test" }, noopFn);
         await workflow.run({ docUrl: "https://example.com" });
@@ -37,6 +30,7 @@ describe("OpenWorkflow", () => {
                 count: z.number().int().positive(),
             });
             test("accepts valid input", async () => {
+                const backend = await createBackend();
                 const client = new OpenWorkflow({ backend });
                 const workflow = client.defineWorkflow({ name: "schema-zod-valid", schema }, noopFn);
                 const handle = await workflow.run({
@@ -46,6 +40,7 @@ describe("OpenWorkflow", () => {
                 await handle.cancel();
             });
             test("rejects invalid input", async () => {
+                const backend = await createBackend();
                 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();
@@ -57,6 +52,7 @@ describe("OpenWorkflow", () => {
                 platform: "'android' | 'ios'",
             });
             test("accepts valid input", async () => {
+                const backend = await createBackend();
                 const client = new OpenWorkflow({ backend });
                 const workflow = client.defineWorkflow({ name: "schema-arktype-valid", schema }, noopFn);
                 const handle = await workflow.run({
@@ -66,6 +62,7 @@ describe("OpenWorkflow", () => {
                 await handle.cancel();
             });
             test("rejects invalid input", async () => {
+                const backend = await createBackend();
                 const client = new OpenWorkflow({ backend });
                 const workflow = client.defineWorkflow({ name: "schema-arktype-invalid", schema }, noopFn);
                 await expect(workflow.run({ name: "Riley", platform: "web" })).rejects.toThrow();
@@ -77,6 +74,7 @@ describe("OpenWorkflow", () => {
                 key2: v.number(),
             });
             test("accepts valid input", async () => {
+                const backend = await createBackend();
                 const client = new OpenWorkflow({ backend });
                 const workflow = client.defineWorkflow({ name: "schema-valibot-valid", schema }, noopFn);
                 const handle = await workflow.run({
@@ -86,6 +84,7 @@ describe("OpenWorkflow", () => {
                 await handle.cancel();
             });
             test("rejects invalid input", async () => {
+                const backend = await createBackend();
                 const client = new OpenWorkflow({ backend });
                 const workflow = client.defineWorkflow({ name: "schema-valibot-invalid", schema }, noopFn);
                 await expect(workflow.run({ key1: "value", key2: "oops" })).rejects.toThrow();
@@ -97,6 +96,7 @@ describe("OpenWorkflow", () => {
                 age: yupNumber().required().integer().positive(),
             });
             test("accepts valid input", async () => {
+                const backend = await createBackend();
                 const client = new OpenWorkflow({ backend });
                 const workflow = client.defineWorkflow({ name: "schema-yup-valid", schema }, noopFn);
                 const handle = await workflow.run({
@@ -106,6 +106,7 @@ describe("OpenWorkflow", () => {
                 await handle.cancel();
             });
             test("rejects invalid input", async () => {
+                const backend = await createBackend();
                 const client = new OpenWorkflow({ backend });
                 const workflow = client.defineWorkflow({ name: "schema-yup-invalid", schema }, noopFn);
                 await expect(workflow.run({ name: "Mona", age: -10 })).rejects.toThrow();
@@ -113,6 +114,7 @@ describe("OpenWorkflow", () => {
         });
     });
     test("result resolves when workflow succeeds", async () => {
+        const backend = await createBackend();
         const client = new OpenWorkflow({ backend });
         const workflow = client.defineWorkflow({ name: "result-success" }, noopFn);
         const handle = await workflow.run({ value: 1 });
@@ -134,6 +136,7 @@ describe("OpenWorkflow", () => {
         expect(result).toEqual({ ok: true });
     });
     test("result rejects when workflow fails", async () => {
+        const backend = await createBackend();
         const client = new OpenWorkflow({ backend });
         const workflow = client.defineWorkflow({ name: "result-failure" }, noopFn);
         await workflow.run({ value: 1 });
@@ -158,6 +161,7 @@ describe("OpenWorkflow", () => {
         expect(rescheduled?.error).toEqual({ message: "boom" });
     });
     test("creates workflow run with deadline", async () => {
+        const backend = await createBackend();
         const client = new OpenWorkflow({ backend });
         const workflow = client.defineWorkflow({ name: "deadline-test" }, noopFn);
         const deadline = new Date(Date.now() + 60_000); // in 1 minute
@@ -166,18 +170,21 @@ describe("OpenWorkflow", () => {
         expect(handle.workflowRun.deadlineAt?.getTime()).toBe(deadline.getTime());
     });
     test("creates workflow run with version", async () => {
+        const backend = await createBackend();
         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 backend = await createBackend();
         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 backend = await createBackend();
         const client = new OpenWorkflow({ backend });
         const workflow = client.defineWorkflow({ name: "cancel-test" }, noopFn);
         const handle = await workflow.run({ value: 1 });
@@ -188,8 +195,117 @@ describe("OpenWorkflow", () => {
         expect(workflowRun?.status).toBe("canceled");
         expect(workflowRun?.finishedAt).not.toBeNull();
     });
+    describe("defineWorkflowSpec / implementWorkflow API", () => {
+        test("defineWorkflowSpec returns a spec that can be used to schedule runs", async () => {
+            const backend = await createBackend();
+            const client = new OpenWorkflow({ backend });
+            const spec = defineWorkflowSpec({ 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 backend = await createBackend();
+            const client = new OpenWorkflow({ backend });
+            const spec = defineWorkflowSpec({ 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 backend = await createBackend();
+            const client = new OpenWorkflow({ backend });
+            const spec = defineWorkflowSpec({ 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 backend = await createBackend();
+            const client = new OpenWorkflow({ backend });
+            const specV1 = defineWorkflowSpec({
+                name: "multi-version",
+                version: "v1",
+            });
+            const specV2 = defineWorkflowSpec({
+                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 backend = await createBackend();
+            const client = new OpenWorkflow({ backend });
+            const spec1 = defineWorkflowSpec({
+                name: "version-duplicate",
+                version: "v1",
+            });
+            const spec2 = defineWorkflowSpec({
+                name: "version-duplicate",
+                version: "v1",
+            });
+            client.implementWorkflow(spec1, noopFn);
+            expect(() => {
+                client.implementWorkflow(spec2, noopFn);
+            }).toThrow('Workflow "version-duplicate" (version: v1) is already registered');
+        });
+        test("defineWorkflowSpec with schema validates input on runWorkflow", async () => {
+            const backend = await createBackend();
+            const client = new OpenWorkflow({ backend });
+            const schema = z.object({
+                email: z.email(),
+            });
+            const spec = defineWorkflowSpec({
+                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("defineWorkflowSpec with version sets version on workflow run", async () => {
+            const backend = await createBackend();
+            const client = new OpenWorkflow({ backend });
+            const spec = defineWorkflowSpec({
+                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 defines a workflow", async () => {
+            const backend = await createBackend();
+            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 });
+        });
+    });
 });
+async function createBackend() {
+    return await BackendPostgres.connect(DEFAULT_POSTGRES_URL, {
+        namespaceId: randomUUID(), // unique namespace per test
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 async function noopFn() {
     // no-op
 }
-//# sourceMappingURL=sdk.test.js.map

package/dist/core/duration.d.ts

@@ -11,10 +11,12 @@ type Unit = Years | Months | Weeks | Days | Hours | Minutes | Seconds | Millisec
 type UnitAnyCase = Capitalize<Unit> | Uppercase<Unit> | Lowercase<Unit>;
 export type DurationString = `${number}` | `${number}${UnitAnyCase}` | `${number} ${UnitAnyCase}`;
 /**
- * Parse a duration string into milliseconds. Exmaples:
+ * Parse a duration string into milliseconds. Examples:
  * - short units: "1ms", "5s", "30m", "2h", "7d", "3w", "1y"
  * - long units: "1 millisecond", "5 seconds", "30 minutes", "2 hours", "7 days", "3 weeks", "1 year"
+ * @param str - Duration string
+ * @returns Milliseconds
  */
-export declare function parseDuration(str: DurationString): Result<number, Error>;
+export declare function parseDuration(str: DurationString): Result<number>;
 export {};
 //# sourceMappingURL=duration.d.ts.map

package/dist/core/duration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../core/duration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,GAAG,CAAC;AACnD,KAAK,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;AACxC,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,GAAG,CAAC;AACpC,KAAK,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC;AACjC,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,GAAG,CAAC;AACnD,KAAK,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC;AAC3D,KAAK,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC;AAC3D,KAAK,YAAY,GAAG,cAAc,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;AAC7E,KAAK,IAAI,GACL,KAAK,GACL,MAAM,GACN,KAAK,GACL,IAAI,GACJ,KAAK,GACL,OAAO,GACP,OAAO,GACP,YAAY,CAAC;AACjB,KAAK,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AACxE,MAAM,MAAM,cAAc,GACtB,GAAG,MAAM,EAAE,GACX,GAAG,MAAM,GAAG,WAAW,EAAE,GACzB,GAAG,MAAM,IAAI,WAAW,EAAE,CAAC;AAE/B;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAiExE"}
+{"version":3,"file":"duration.d.ts","sourceRoot":"","sources":["../../core/duration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,GAAG,CAAC;AACnD,KAAK,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,IAAI,CAAC;AACxC,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,GAAG,CAAC;AACpC,KAAK,IAAI,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC;AACjC,KAAK,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,GAAG,CAAC;AACnD,KAAK,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC;AAC3D,KAAK,OAAO,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC;AAC3D,KAAK,YAAY,GAAG,cAAc,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC;AAC7E,KAAK,IAAI,GACL,KAAK,GACL,MAAM,GACN,KAAK,GACL,IAAI,GACJ,KAAK,GACL,OAAO,GACP,OAAO,GACP,YAAY,CAAC;AACjB,KAAK,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AACxE,MAAM,MAAM,cAAc,GACtB,GAAG,MAAM,EAAE,GACX,GAAG,MAAM,GAAG,WAAW,EAAE,GACzB,GAAG,MAAM,IAAI,WAAW,EAAE,CAAC;AAE/B;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAiEjE"}

package/dist/core/duration.js

@@ -1,8 +1,10 @@
 import { ok, err } from "./result.js";
 /**
- * Parse a duration string into milliseconds. Exmaples:
+ * Parse a duration string into milliseconds. Examples:
  * - short units: "1ms", "5s", "30m", "2h", "7d", "3w", "1y"
  * - long units: "1 millisecond", "5 seconds", "30 minutes", "2 hours", "7 days", "3 weeks", "1 year"
+ * @param str - Duration string
+ * @returns Milliseconds
  */
 export function parseDuration(str) {
     if (typeof str !== "string") {
@@ -59,4 +61,3 @@ export function parseDuration(str) {
     }
     return ok(numValue * multiplier);
 }
-//# sourceMappingURL=duration.js.map

package/dist/core/duration.test.js

@@ -261,4 +261,3 @@ describe("parseDuration", () => {
         });
     });
 });
-//# sourceMappingURL=duration.test.js.map

package/dist/core/error.d.ts

@@ -0,0 +1,14 @@
+import type { JsonValue } from "./json.js";
+export interface SerializedError {
+    name?: string;
+    message: string;
+    stack?: string;
+    [key: string]: JsonValue;
+}
+/**
+ * Serialize an error to a JSON-compatible format.
+ * @param error - The error to serialize (can be Error instance or any value)
+ * @returns A JSON-serializable error object
+ */
+export declare function serializeError(error: unknown): SerializedError;
+//# sourceMappingURL=error.d.ts.map

package/dist/core/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../core/error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAc9D"}

package/dist/core/error.js

@@ -0,0 +1,17 @@
+/**
+ * Serialize an error to a JSON-compatible format.
+ * @param error - The error to serialize (can be Error instance or any value)
+ * @returns A JSON-serializable error object
+ */
+export function serializeError(error) {
+    if (error instanceof Error) {
+        const { name, message, stack } = error;
+        if (stack) {
+            return { name, message, stack };
+        }
+        return { name, message };
+    }
+    return {
+        message: String(error),
+    };
+}

package/dist/core/error.test.d.ts

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

package/dist/core/error.test.d.ts.map

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

package/dist/core/error.test.js

@@ -0,0 +1,60 @@
+import { serializeError } from "./error.js";
+import { describe, expect, test } from "vitest";
+describe("serializeError", () => {
+    test("serializes Error instance with name, message, and stack", () => {
+        const error = new Error("Something went wrong");
+        const result = serializeError(error);
+        expect(result.name).toBe("Error");
+        expect(result.message).toBe("Something went wrong");
+        expect(result.stack).toBeDefined();
+        expect(typeof result.stack).toBe("string");
+    });
+    test("serializes TypeError with correct name", () => {
+        const error = new TypeError("Invalid type");
+        const result = serializeError(error);
+        expect(result.name).toBe("TypeError");
+        expect(result.message).toBe("Invalid type");
+    });
+    test("serializes custom Error subclass", () => {
+        class CustomError extends Error {
+            constructor(message) {
+                super(message);
+                this.name = "CustomError";
+            }
+        }
+        const error = new CustomError("Custom error message");
+        const result = serializeError(error);
+        expect(result.name).toBe("CustomError");
+        expect(result.message).toBe("Custom error message");
+    });
+    test("serializes Error without stack as undefined", () => {
+        const error = new Error("No stack");
+        // @ts-expect-error testing edge case
+        error.stack = undefined;
+        const result = serializeError(error);
+        expect(result.stack).toBeUndefined();
+    });
+    test("serializes string to message", () => {
+        const result = serializeError("string error");
+        expect(result.message).toBe("string error");
+        expect(result.name).toBeUndefined();
+        expect(result.stack).toBeUndefined();
+    });
+    test("serializes number to message", () => {
+        const result = serializeError(42);
+        expect(result.message).toBe("42");
+    });
+    test("serializes null to message", () => {
+        const result = serializeError(null);
+        expect(result.message).toBe("null");
+    });
+    test("serializes undefined to message", () => {
+        // eslint-disable-next-line unicorn/no-useless-undefined
+        const result = serializeError(undefined);
+        expect(result.message).toBe("undefined");
+    });
+    test("serializes object to message using String()", () => {
+        const result = serializeError({ foo: "bar" });
+        expect(result.message).toBe("[object Object]");
+    });
+});

package/dist/core/json.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=json.js.map

package/dist/core/result.d.ts

@@ -1,12 +1,22 @@
-export type Result<T, E> = Ok<T> | Err<E>;
+export type Result<T> = Ok<T> | Err;
 export interface Ok<T> {
     ok: true;
     value: T;
 }
-export interface Err<E> {
+export interface Err {
     ok: false;
-    error: E;
+    error: Error;
 }
+/**
+ * Create an Ok result.
+ * @param value - Result value
+ * @returns Ok result
+ */
 export declare function ok<T>(value: T): Ok<T>;
-export declare function err<E>(error: E): Err<E>;
+/**
+ * Create an Err result.
+ * @param error - Result error
+ * @returns Err result
+ */
+export declare function err(error: Readonly<Error>): Err;
 //# sourceMappingURL=result.d.ts.map

package/dist/core/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../core/result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;AAE1C,MAAM,WAAW,EAAE,CAAC,CAAC;IACnB,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,GAAG,CAAC,CAAC;IACpB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,CAAC,CAAC;CACV;AAED,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAErC;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAEvC"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../core/result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAEpC,MAAM,WAAW,EAAE,CAAC,CAAC;IACnB,EAAE,EAAE,IAAI,CAAC;IACT,KAAK,EAAE,CAAC,CAAC;CACV;AAED,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAErC;AAED;;;;GAIG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,GAAG,CAE/C"}

package/dist/core/result.js

@@ -1,7 +1,16 @@
+/**
+ * Create an Ok result.
+ * @param value - Result value
+ * @returns Ok result
+ */
 export function ok(value) {
     return { ok: true, value };
 }
+/**
+ * Create an Err result.
+ * @param error - Result error
+ * @returns Err result
+ */
 export function err(error) {
     return { ok: false, error };
 }
-//# sourceMappingURL=result.js.map

package/dist/core/result.test.js

@@ -5,7 +5,7 @@ describe("Result helpers", () => {
         expect(ok(123)).toEqual({ ok: true, value: 123 });
     });
     test("err creates error result", () => {
-        expect(err("oops")).toEqual({ ok: false, error: "oops" });
+        const error = new Error("oops");
+        expect(err(error)).toEqual({ ok: false, error });
     });
 });
-//# sourceMappingURL=result.test.js.map

package/dist/core/retry.d.ts

@@ -4,13 +4,4 @@ export declare const DEFAULT_RETRY_POLICY: {
     readonly maximumIntervalMs: number;
     readonly maximumAttempts: number;
 };
-export type RetryPolicy = typeof DEFAULT_RETRY_POLICY;
-/**
- * Calculate the next retry delay using exponential backoff.
- */
-export declare function calculateRetryDelayMs(attemptNumber: number): number;
-/**
- * Check if an operation should be retried based on the retry policy.
- */
-export declare function shouldRetry(retryPolicy: RetryPolicy, attemptNumber: number): boolean;
 //# sourceMappingURL=retry.d.ts.map

package/dist/core/retry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../core/retry.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,OAAO,oBAAoB,CAAC;AAEtD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAQnE;AAED;;GAEG;AACH,wBAAgB,WAAW,CACzB,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,MAAM,GACpB,OAAO,CAET"}
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../core/retry.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB;;;;;CAKvB,CAAC"}

package/dist/core/retry.js

@@ -4,18 +4,3 @@ export const DEFAULT_RETRY_POLICY = {
     maximumIntervalMs: 100 * 1000, // 100s
     maximumAttempts: Infinity, // unlimited
 };
-/**
- * Calculate the next retry delay using exponential backoff.
- */
-export function calculateRetryDelayMs(attemptNumber) {
-    const { initialIntervalMs, backoffCoefficient, maximumIntervalMs } = DEFAULT_RETRY_POLICY;
-    const backoffMs = initialIntervalMs * Math.pow(backoffCoefficient, attemptNumber - 1);
-    return Math.min(backoffMs, maximumIntervalMs);
-}
-/**
- * Check if an operation should be retried based on the retry policy.
- */
-export function shouldRetry(retryPolicy, attemptNumber) {
-    return attemptNumber < retryPolicy.maximumAttempts;
-}
-//# sourceMappingURL=retry.js.map

package/dist/core/schema.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=schema.js.map

package/dist/core/step.d.ts

@@ -41,51 +41,23 @@ export interface StepAttempt {
  * Immutable cache for step attempts, keyed by step name.
  */
 export type StepAttemptCache = ReadonlyMap<string, StepAttempt>;
-/**
- * Serialized error format for JSON compatibility.
- */
-export interface SerializedError {
-    message: string;
-    name?: string;
-    stack?: string | null;
-    [key: string]: JsonValue;
-}
-/**
- * Serialize an error to a JSON-compatible format. Pure function that converts
- * any error into a SerializedError object.
- *
- * @param error - The error to serialize (can be Error instance or any value)
- * @returns A JSON-serializable error object
- */
-export declare function serializeError(error: unknown): SerializedError;
 /**
  * Create a step attempt cache from an array of attempts. Only includes
  * successful attempts (completed or succeeded status).
- *
  * @param attempts - Array of step attempts to cache
  * @returns An immutable map of step name to successful attempt
  */
 export declare function createStepAttemptCacheFromAttempts(attempts: readonly StepAttempt[]): StepAttemptCache;
 /**
  * Get a cached step attempt by name.
- *
  * @param cache - The step attempt cache
  * @param stepName - The name of the step to look up
  * @returns The cached attempt or undefined if not found
  */
 export declare function getCachedStepAttempt(cache: StepAttemptCache, stepName: string): StepAttempt | undefined;
-/**
- * Check if a step attempt is cached (has completed successfully).
- *
- * @param cache - The step attempt cache
- * @param stepName - The name of the step to check
- * @returns True if the step has a cached successful result
- */
-export declare function hasCompletedStep(cache: StepAttemptCache, stepName: string): boolean;
 /**
  * Add a step attempt to the cache (returns new cache, original unchanged). This
  * is an immutable operation.
- *
  * @param cache - The existing step attempt cache
  * @param attempt - The attempt to add
  * @returns A new cache with the attempt added
@@ -94,22 +66,19 @@ export declare function addToStepAttemptCache(cache: StepAttemptCache, attempt:
 /**
  * Convert a step function result to a JSON-compatible value. Undefined values
  * are converted to null for JSON serialization.
- *
  * @param result - The result from a step function
  * @returns A JSON-serializable value
  */
 export declare function normalizeStepOutput(result: unknown): JsonValue;
 /**
  * Calculate the resume time for a sleep step.
- *
  * @param duration - The duration string to sleep for
  * @param now - The current timestamp (defaults to Date.now())
  * @returns A Result containing the resume Date or an Error
  */
-export declare function calculateSleepResumeAt(duration: DurationString, now?: number): Result<Date, Error>;
+export declare function calculateSleepResumeAt(duration: DurationString, now?: number): Result<Date>;
 /**
  * Create the context object for a sleep step attempt.
- *
  * @param resumeAt - The time when the sleep should resume
  * @returns The context object for the sleep step
  */

package/dist/core/step.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../core/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAY9D;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,gBAAgB,CAUlB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,GACf,WAAW,GAAG,SAAS,CAEzB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,GACf,OAAO,CAET;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC7B,gBAAgB,CAElB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,GAAG,GAAE,MAAmB,GACvB,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAQrB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG;IAC5D,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAKA"}
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../core/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAG1C;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,WAAW,GACX,WAAW,GACX,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACnC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IACxB,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,IAAI,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,SAAS,WAAW,EAAE,GAC/B,gBAAgB,CAUlB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,gBAAgB,EACvB,QAAQ,EAAE,MAAM,GACf,WAAW,GAAG,SAAS,CAEzB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,QAAQ,CAAC,WAAW,CAAC,GAC7B,gBAAgB,CAElB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,GAAG,GAAE,MAAmB,GACvB,MAAM,CAAC,IAAI,CAAC,CAQd;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG;IAC5D,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB,CAKA"}