@durable-effect/jobs 0.0.1-next.1

package/dist/client/client.js

@@ -0,0 +1,427 @@
+// packages/jobs/src/client/client.ts
+import { Effect } from "effect";
+import { narrowResponseEffect } from "./response";
+// =============================================================================
+// Instance ID Resolution
+// =============================================================================
+/**
+ * Create instance ID for a job.
+ *
+ * Format: {jobType}:{jobName}:{userProvidedId}
+ */
+function createInstanceId(type, name, id) {
+    return `${type}:${name}:${id}`;
+}
+/**
+ * Consistent hash for partition key routing.
+ */
+function consistentHash(key, buckets) {
+    let hash = 0;
+    for (let i = 0; i < key.length; i++) {
+        const char = key.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash; // Convert to 32-bit integer
+    }
+    return Math.abs(hash) % buckets;
+}
+// =============================================================================
+// DO Stub Helper
+// =============================================================================
+/**
+ * Get a typed DO stub for an instance.
+ *
+ * Note: We use a runtime cast here because Cloudflare's DurableObjectNamespace
+ * generic typing doesn't work well with the DurableObjectBranded constraint.
+ * The call() method signature is validated by our response narrowing.
+ */
+function getStub(binding, instanceId) {
+    const id = binding.idFromName(instanceId);
+    // The DO stub implements our interface; we validate responses at runtime
+    return binding.get(id);
+}
+// =============================================================================
+// Client Factory
+// =============================================================================
+/**
+ * Create a jobs client from a Durable Object binding.
+ *
+ * The client provides typed access to all registered jobs and
+ * handles instance ID resolution and routing.
+ *
+ * @example
+ * ```ts
+ * const client = createJobsClient(env.JOBS, registry);
+ *
+ * // Access continuous job
+ * await client.continuous("tokenRefresher").start({
+ *   id: "user-123",
+ *   input: { refreshToken: "rt_abc" },
+ * });
+ *
+ * // Access debounce job
+ * await client.debounce("webhookDebounce").add({
+ *   id: "contact-456",
+ *   event: { type: "contact.updated", data: {...} },
+ * });
+ *
+ * // Access workerPool job (auto-routes to instance)
+ * await client.workerPool("emailWorkerPool").enqueue({
+ *   id: "email-789",
+ *   event: { to: "user@example.com", template: "welcome" },
+ * });
+ * ```
+ */
+export function createJobsClient(binding, registry) {
+    return {
+        // -------------------------------------------------------------------------
+        // Continuous Client
+        // -------------------------------------------------------------------------
+        continuous: (name) => {
+            const client = {
+                start: ({ id, input }) => {
+                    const instanceId = createInstanceId("continuous", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "continuous",
+                        action: "start",
+                        name,
+                        id,
+                        input,
+                    }), "continuous.start");
+                },
+                terminate: (id, options) => {
+                    const instanceId = createInstanceId("continuous", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "continuous",
+                        action: "terminate",
+                        name,
+                        id,
+                        reason: options?.reason,
+                    }), "continuous.terminate");
+                },
+                trigger: (id) => {
+                    const instanceId = createInstanceId("continuous", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "continuous",
+                        action: "trigger",
+                        name,
+                        id,
+                    }), "continuous.trigger");
+                },
+                status: (id) => {
+                    const instanceId = createInstanceId("continuous", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "continuous",
+                        action: "status",
+                        name,
+                        id,
+                    }), "continuous.status");
+                },
+                getState: (id) => {
+                    const instanceId = createInstanceId("continuous", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "continuous",
+                        action: "getState",
+                        name,
+                        id,
+                    }), "continuous.getState");
+                },
+            };
+            return client;
+        },
+        // -------------------------------------------------------------------------
+        // Debounce Client
+        // -------------------------------------------------------------------------
+        debounce: (name) => {
+            const client = {
+                add: ({ id, event }) => {
+                    const instanceId = createInstanceId("debounce", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "debounce",
+                        action: "add",
+                        name,
+                        id,
+                        event,
+                    }), "debounce.add");
+                },
+                flush: (id) => {
+                    const instanceId = createInstanceId("debounce", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "debounce",
+                        action: "flush",
+                        name,
+                        id,
+                    }), "debounce.flush");
+                },
+                clear: (id) => {
+                    const instanceId = createInstanceId("debounce", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "debounce",
+                        action: "clear",
+                        name,
+                        id,
+                    }), "debounce.clear");
+                },
+                status: (id) => {
+                    const instanceId = createInstanceId("debounce", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "debounce",
+                        action: "status",
+                        name,
+                        id,
+                    }), "debounce.status");
+                },
+                getState: (id) => {
+                    const instanceId = createInstanceId("debounce", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "debounce",
+                        action: "getState",
+                        name,
+                        id,
+                    }), "debounce.getState");
+                },
+            };
+            return client;
+        },
+        // -------------------------------------------------------------------------
+        // WorkerPool Client
+        // -------------------------------------------------------------------------
+        workerPool: (name) => {
+            const def = registry.workerPool[name];
+            const concurrency = def?.concurrency ?? 1;
+            // Round-robin counter for load distribution
+            let roundRobinCounter = 0;
+            const client = {
+                enqueue: ({ id, event, partitionKey, priority }) => {
+                    // Route to specific instance based on partitionKey or round-robin
+                    const instanceIndex = partitionKey
+                        ? consistentHash(partitionKey, concurrency)
+                        : roundRobinCounter++ % concurrency;
+                    const instanceId = createInstanceId("workerPool", name, instanceIndex);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "workerPool",
+                        action: "enqueue",
+                        name,
+                        instanceIndex,
+                        eventId: id,
+                        event,
+                        partitionKey,
+                        priority,
+                    }), "workerPool.enqueue");
+                },
+                pause: (instanceIndex) => {
+                    if (instanceIndex !== undefined) {
+                        const instanceId = createInstanceId("workerPool", name, instanceIndex);
+                        const stub = getStub(binding, instanceId);
+                        return narrowResponseEffect(stub.call({
+                            type: "workerPool",
+                            action: "pause",
+                            name,
+                            instanceIndex,
+                        }), "workerPool.pause");
+                    }
+                    // Pause all instances
+                    return Effect.gen(function* () {
+                        const results = yield* Effect.all(Array.from({ length: concurrency }, (_, i) => {
+                            const instanceId = createInstanceId("workerPool", name, i);
+                            const stub = getStub(binding, instanceId);
+                            return narrowResponseEffect(stub.call({
+                                type: "workerPool",
+                                action: "pause",
+                                name,
+                                instanceIndex: i,
+                            }), "workerPool.pause");
+                        }), { concurrency: "unbounded" });
+                        return {
+                            _type: "workerPool.pause",
+                            paused: results.every((r) => r.paused),
+                        };
+                    });
+                },
+                resume: (instanceIndex) => {
+                    if (instanceIndex !== undefined) {
+                        const instanceId = createInstanceId("workerPool", name, instanceIndex);
+                        const stub = getStub(binding, instanceId);
+                        return narrowResponseEffect(stub.call({
+                            type: "workerPool",
+                            action: "resume",
+                            name,
+                            instanceIndex,
+                        }), "workerPool.resume");
+                    }
+                    // Resume all instances
+                    return Effect.gen(function* () {
+                        const results = yield* Effect.all(Array.from({ length: concurrency }, (_, i) => {
+                            const instanceId = createInstanceId("workerPool", name, i);
+                            const stub = getStub(binding, instanceId);
+                            return narrowResponseEffect(stub.call({
+                                type: "workerPool",
+                                action: "resume",
+                                name,
+                                instanceIndex: i,
+                            }), "workerPool.resume");
+                        }), { concurrency: "unbounded" });
+                        return {
+                            _type: "workerPool.resume",
+                            resumed: results.every((r) => r.resumed),
+                        };
+                    });
+                },
+                cancel: (eventId) => {
+                    // Cancel needs to find the right instance
+                    // For now, broadcast to all instances
+                    return Effect.gen(function* () {
+                        const results = yield* Effect.all(Array.from({ length: concurrency }, (_, i) => {
+                            const instanceId = createInstanceId("workerPool", name, i);
+                            const stub = getStub(binding, instanceId);
+                            return narrowResponseEffect(stub.call({
+                                type: "workerPool",
+                                action: "cancel",
+                                name,
+                                instanceIndex: i,
+                                eventId,
+                            }), "workerPool.cancel");
+                        }), { concurrency: "unbounded" });
+                        // Return first success or last result
+                        const success = results.find((r) => r.cancelled);
+                        return success ?? results[results.length - 1];
+                    });
+                },
+                status: () => {
+                    // Aggregate status from all instances
+                    return Effect.gen(function* () {
+                        const instances = yield* Effect.all(Array.from({ length: concurrency }, (_, i) => {
+                            const instanceId = createInstanceId("workerPool", name, i);
+                            const stub = getStub(binding, instanceId);
+                            return narrowResponseEffect(stub.call({
+                                type: "workerPool",
+                                action: "status",
+                                name,
+                                instanceIndex: i,
+                            }), "workerPool.status");
+                        }), { concurrency: "unbounded" });
+                        const aggregated = {
+                            instances,
+                            totalPending: instances.reduce((sum, i) => sum + (i.pendingCount ?? 0), 0),
+                            totalProcessed: instances.reduce((sum, i) => sum + (i.processedCount ?? 0), 0),
+                            activeInstances: instances.filter((i) => i.status === "processing" || i.status === "idle").length,
+                            pausedInstances: instances.filter((i) => i.status === "paused")
+                                .length,
+                        };
+                        return aggregated;
+                    });
+                },
+                instanceStatus: (instanceIndex) => {
+                    const instanceId = createInstanceId("workerPool", name, instanceIndex);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "workerPool",
+                        action: "status",
+                        name,
+                        instanceIndex,
+                    }), "workerPool.status");
+                },
+                drain: (instanceIndex) => {
+                    if (instanceIndex !== undefined) {
+                        const instanceId = createInstanceId("workerPool", name, instanceIndex);
+                        const stub = getStub(binding, instanceId);
+                        return narrowResponseEffect(stub.call({
+                            type: "workerPool",
+                            action: "drain",
+                            name,
+                            instanceIndex,
+                        }), "workerPool.drain");
+                    }
+                    // Drain all instances
+                    return Effect.gen(function* () {
+                        const results = yield* Effect.all(Array.from({ length: concurrency }, (_, i) => {
+                            const instanceId = createInstanceId("workerPool", name, i);
+                            const stub = getStub(binding, instanceId);
+                            return narrowResponseEffect(stub.call({
+                                type: "workerPool",
+                                action: "drain",
+                                name,
+                                instanceIndex: i,
+                            }), "workerPool.drain");
+                        }), { concurrency: "unbounded" });
+                        return {
+                            _type: "workerPool.drain",
+                            drained: results.every((r) => r.drained),
+                        };
+                    });
+                },
+            };
+            return client;
+        },
+        // -------------------------------------------------------------------------
+        // Task Client
+        // -------------------------------------------------------------------------
+        task: (name) => {
+            const client = {
+                send: ({ id, event }) => {
+                    const instanceId = createInstanceId("task", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "task",
+                        action: "send",
+                        name,
+                        id,
+                        event,
+                    }), "task.send");
+                },
+                trigger: (id) => {
+                    const instanceId = createInstanceId("task", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "task",
+                        action: "trigger",
+                        name,
+                        id,
+                    }), "task.trigger");
+                },
+                terminate: (id) => {
+                    const instanceId = createInstanceId("task", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "task",
+                        action: "terminate",
+                        name,
+                        id,
+                    }), "task.terminate");
+                },
+                status: (id) => {
+                    const instanceId = createInstanceId("task", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "task",
+                        action: "status",
+                        name,
+                        id,
+                    }), "task.status");
+                },
+                getState: (id) => {
+                    const instanceId = createInstanceId("task", name, id);
+                    const stub = getStub(binding, instanceId);
+                    return narrowResponseEffect(stub.call({
+                        type: "task",
+                        action: "getState",
+                        name,
+                        id,
+                    }), "task.getState");
+                },
+            };
+            return client;
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client/client.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,4 @@
+export { createJobsClient } from "./client";
+export { narrowResponse, narrowResponseAsync, narrowResponseEffect, isResponseType, UnexpectedResponseError, jobCallError, type JobCallError, type ClientError, type ResponseTypeMap, type ResponseType, } from "./response";
+export type { ContinuousClient, DebounceClient, WorkerPoolClient, WorkerPoolAggregatedStatus, JobsClient, JobsClientFactory, ContinuousKeys, DebounceKeys, WorkerPoolKeys, ContinuousStateType, DebounceEventType, DebounceStateType, WorkerPoolEventType, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAEV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,0BAA0B,EAE1B,UAAU,EACV,iBAAiB,EAEjB,cAAc,EACd,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,4 @@
+// packages/jobs/src/client/index.ts
+export { createJobsClient } from "./client";
+export { narrowResponse, narrowResponseAsync, narrowResponseEffect, isResponseType, UnexpectedResponseError, jobCallError, } from "./response";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,uBAAuB,EACvB,YAAY,GAKb,MAAM,YAAY,CAAC"}

package/dist/client/response.d.ts

@@ -0,0 +1,99 @@
+import { Effect } from "effect";
+import type { JobResponse, ContinuousStartResponse, ContinuousTerminateResponse, ContinuousTriggerResponse, ContinuousStatusResponse, ContinuousGetStateResponse, DebounceAddResponse, DebounceFlushResponse, DebounceClearResponse, DebounceStatusResponse, DebounceGetStateResponse, WorkerPoolEnqueueResponse, WorkerPoolPauseResponse, WorkerPoolResumeResponse, WorkerPoolCancelResponse, WorkerPoolStatusResponse, WorkerPoolDrainResponse, TaskSendResponse, TaskTriggerResponse, TaskTerminateResponse, TaskStatusResponse, TaskGetStateResponse } from "../runtime/types";
+/**
+ * Error when DO call fails.
+ */
+export interface JobCallError {
+    readonly _tag: "JobCallError";
+    readonly cause: unknown;
+}
+/**
+ * Create a JobCallError.
+ */
+export declare const jobCallError: (cause: unknown) => JobCallError;
+/**
+ * Maps response _type discriminants to their full types.
+ */
+export interface ResponseTypeMap {
+    "continuous.start": ContinuousStartResponse;
+    "continuous.terminate": ContinuousTerminateResponse;
+    "continuous.trigger": ContinuousTriggerResponse;
+    "continuous.status": ContinuousStatusResponse;
+    "continuous.getState": ContinuousGetStateResponse;
+    "debounce.add": DebounceAddResponse;
+    "debounce.flush": DebounceFlushResponse;
+    "debounce.clear": DebounceClearResponse;
+    "debounce.status": DebounceStatusResponse;
+    "debounce.getState": DebounceGetStateResponse;
+    "workerPool.enqueue": WorkerPoolEnqueueResponse;
+    "workerPool.pause": WorkerPoolPauseResponse;
+    "workerPool.resume": WorkerPoolResumeResponse;
+    "workerPool.cancel": WorkerPoolCancelResponse;
+    "workerPool.status": WorkerPoolStatusResponse;
+    "workerPool.drain": WorkerPoolDrainResponse;
+    "task.send": TaskSendResponse;
+    "task.trigger": TaskTriggerResponse;
+    "task.terminate": TaskTerminateResponse;
+    "task.status": TaskStatusResponse;
+    "task.getState": TaskGetStateResponse;
+}
+/**
+ * All valid response type discriminants.
+ */
+export type ResponseType = keyof ResponseTypeMap;
+/**
+ * Runtime error for unexpected response types.
+ */
+export declare class UnexpectedResponseError extends Error {
+    readonly _tag = "UnexpectedResponseError";
+    readonly expected: ResponseType;
+    readonly actual: string;
+    constructor(expected: ResponseType, actual: string);
+}
+/**
+ * Type guard to check if a response has a specific _type.
+ */
+export declare function isResponseType<T extends ResponseType>(response: JobResponse, expectedType: T): response is ResponseTypeMap[T];
+/**
+ * Narrow a response to a specific type with runtime validation.
+ *
+ * This provides both compile-time type safety AND runtime validation,
+ * unlike raw type casts which only provide compile-time types.
+ *
+ * @throws UnexpectedResponseError if the response type doesn't match
+ */
+export declare function narrowResponse<T extends ResponseType>(response: JobResponse, expectedType: T): ResponseTypeMap[T];
+/**
+ * Narrow a Promise<JobResponse> to a specific type.
+ *
+ * @example
+ * ```ts
+ * const response = await narrowResponseAsync(
+ *   stub.call({ type: "continuous", action: "start", ... }),
+ *   "continuous.start"
+ * );
+ * // response is typed as ContinuousStartResponse
+ * ```
+ */
+export declare function narrowResponseAsync<T extends ResponseType>(promise: Promise<JobResponse>, expectedType: T): Promise<ResponseTypeMap[T]>;
+/**
+ * Combined error type for client operations.
+ */
+export type ClientError = JobCallError | UnexpectedResponseError;
+/**
+ * Narrow a Promise<JobResponse> to a specific type, returning an Effect.
+ *
+ * This is the Effect-based version that properly handles errors and can be used
+ * with Effect.gen and yield*.
+ *
+ * @example
+ * ```ts
+ * const response = yield* narrowResponseEffect(
+ *   stub.call({ type: "continuous", action: "start", ... }),
+ *   "continuous.start"
+ * );
+ * // response is typed as ContinuousStartResponse
+ * ```
+ */
+export declare function narrowResponseEffect<T extends ResponseType>(promise: Promise<JobResponse>, expectedType: T): Effect.Effect<ResponseTypeMap[T], ClientError>;
+//# sourceMappingURL=response.d.ts.map

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

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