@durable-effect/jobs 0.0.1-next.1

package/dist/errors.d.ts

@@ -0,0 +1,119 @@
+export { StorageError, SchedulerError } from "@durable-effect/core";
+declare const JobNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "JobNotFoundError";
+} & Readonly<A>;
+/**
+ * Job type not found in registry.
+ */
+export declare class JobNotFoundError extends JobNotFoundError_base<{
+    readonly type: string;
+    readonly name: string;
+}> {
+    get message(): string;
+}
+declare const InstanceNotFoundError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "InstanceNotFoundError";
+} & Readonly<A>;
+/**
+ * Instance not found (no metadata stored).
+ */
+export declare class InstanceNotFoundError extends InstanceNotFoundError_base<{
+    readonly instanceId: string;
+}> {
+    get message(): string;
+}
+declare const InvalidStateError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "InvalidStateError";
+} & Readonly<A>;
+/**
+ * Invalid state transition.
+ */
+export declare class InvalidStateError extends InvalidStateError_base<{
+    readonly expected: string;
+    readonly actual: string;
+    readonly operation: string;
+}> {
+    get message(): string;
+}
+declare const ValidationError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ValidationError";
+} & Readonly<A>;
+/**
+ * Schema validation failed.
+ */
+export declare class ValidationError extends ValidationError_base<{
+    readonly schemaName: string;
+    readonly issues: unknown;
+}> {
+    get message(): string;
+}
+declare const ExecutionError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "ExecutionError";
+} & Readonly<A>;
+/**
+ * Execution of user function failed.
+ */
+export declare class ExecutionError extends ExecutionError_base<{
+    readonly jobType: string;
+    readonly jobName: string;
+    readonly instanceId: string;
+    readonly cause: unknown;
+}> {
+    get message(): string;
+}
+declare const RetryExhaustedError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "RetryExhaustedError";
+} & Readonly<A>;
+/**
+ * Retry attempts exhausted (WorkerPool job).
+ */
+export declare class RetryExhaustedError extends RetryExhaustedError_base<{
+    readonly eventId: string;
+    readonly attempts: number;
+    readonly lastError: unknown;
+}> {
+    get message(): string;
+}
+declare const UnknownJobTypeError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "UnknownJobTypeError";
+} & Readonly<A>;
+/**
+ * Unknown job type in request.
+ */
+export declare class UnknownJobTypeError extends UnknownJobTypeError_base<{
+    readonly type: string;
+}> {
+    get message(): string;
+}
+declare const DuplicateEventError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "DuplicateEventError";
+} & Readonly<A>;
+/**
+ * Duplicate event (idempotency check failed).
+ */
+export declare class DuplicateEventError extends DuplicateEventError_base<{
+    readonly eventId: string;
+}> {
+    get message(): string;
+}
+declare const TerminateSignal_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "TerminateSignal";
+} & Readonly<A>;
+/**
+ * Signal that the job should terminate.
+ *
+ * Not a true error - used to short-circuit execution from within
+ * the execute function via ctx.terminate().
+ */
+export declare class TerminateSignal extends TerminateSignal_base<{
+    readonly reason: string | undefined;
+    readonly purgeState: boolean;
+}> {
+    get message(): string;
+}
+import type { StorageError as CoreStorageError, SchedulerError as CoreSchedulerError } from "@durable-effect/core";
+/**
+ * Union of all job errors.
+ */
+export type JobError = CoreStorageError | CoreSchedulerError | JobNotFoundError | InstanceNotFoundError | InvalidStateError | ValidationError | ExecutionError | RetryExhaustedError | UnknownJobTypeError | DuplicateEventError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;;;;AAEpE;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,sBAEpC;IACA,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;;;;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,2BAEzC;IACA,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;;;;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,uBAAsC;IAC3E,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B,CAAC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;;;;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B,CAAC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;;;;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;;;;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,yBAEvC;IACA,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAAC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;;;;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,yBAEvC;IACA,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;;;;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,yBAEvC;IACA,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;;;;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,qBAAoC;IACvE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B,CAAC;IACA,IAAI,OAAO,IAAI,MAAM,CAEpB;CACF;AAGD,OAAO,KAAK,EACV,YAAY,IAAI,gBAAgB,EAChC,cAAc,IAAI,kBAAkB,EACrC,MAAM,sBAAsB,CAAC;AAE9B;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,gBAAgB,GAChB,qBAAqB,GACrB,iBAAiB,GACjB,eAAe,GACf,cAAc,GACd,mBAAmB,GACnB,mBAAmB,GACnB,mBAAmB,CAAC"}

package/dist/errors.js

@@ -0,0 +1,80 @@
+// packages/jobs/src/errors.ts
+import { Data } from "effect";
+// Re-export core errors for convenience
+export { StorageError, SchedulerError } from "@durable-effect/core";
+/**
+ * Job type not found in registry.
+ */
+export class JobNotFoundError extends Data.TaggedError("JobNotFoundError") {
+    get message() {
+        return `Job not found: ${this.type}/${this.name}`;
+    }
+}
+/**
+ * Instance not found (no metadata stored).
+ */
+export class InstanceNotFoundError extends Data.TaggedError("InstanceNotFoundError") {
+    get message() {
+        return `Instance not found: ${this.instanceId}`;
+    }
+}
+/**
+ * Invalid state transition.
+ */
+export class InvalidStateError extends Data.TaggedError("InvalidStateError") {
+    get message() {
+        return `Invalid state for ${this.operation}: expected ${this.expected}, got ${this.actual}`;
+    }
+}
+/**
+ * Schema validation failed.
+ */
+export class ValidationError extends Data.TaggedError("ValidationError") {
+    get message() {
+        return `Validation failed for ${this.schemaName}`;
+    }
+}
+/**
+ * Execution of user function failed.
+ */
+export class ExecutionError extends Data.TaggedError("ExecutionError") {
+    get message() {
+        return `Execution failed for ${this.jobType}/${this.jobName} (${this.instanceId})`;
+    }
+}
+/**
+ * Retry attempts exhausted (WorkerPool job).
+ */
+export class RetryExhaustedError extends Data.TaggedError("RetryExhaustedError") {
+    get message() {
+        return `Retry exhausted for event ${this.eventId} after ${this.attempts} attempts`;
+    }
+}
+/**
+ * Unknown job type in request.
+ */
+export class UnknownJobTypeError extends Data.TaggedError("UnknownJobTypeError") {
+    get message() {
+        return `Unknown job type: ${this.type}`;
+    }
+}
+/**
+ * Duplicate event (idempotency check failed).
+ */
+export class DuplicateEventError extends Data.TaggedError("DuplicateEventError") {
+    get message() {
+        return `Duplicate event: ${this.eventId}`;
+    }
+}
+/**
+ * Signal that the job should terminate.
+ *
+ * Not a true error - used to short-circuit execution from within
+ * the execute function via ctx.terminate().
+ */
+export class TerminateSignal extends Data.TaggedError("TerminateSignal") {
+    get message() {
+        return `Terminate signal${this.reason ? `: ${this.reason}` : ""}`;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAE9B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,wCAAwC;AACxC,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEpE;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,IAAI,CAAC,WAAW,CACpD,kBAAkB,CAIlB;IACA,IAAI,OAAO;QACT,OAAO,kBAAkB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACpD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,IAAI,CAAC,WAAW,CACzD,uBAAuB,CAGvB;IACA,IAAI,OAAO;QACT,OAAO,uBAAuB,IAAI,CAAC,UAAU,EAAE,CAAC;IAClD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAIzE;IACA,IAAI,OAAO;QACT,OAAO,qBAAqB,IAAI,CAAC,SAAS,cAAc,IAAI,CAAC,QAAQ,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;IAC9F,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAGrE;IACA,IAAI,OAAO;QACT,OAAO,yBAAyB,IAAI,CAAC,UAAU,EAAE,CAAC;IACpD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAKnE;IACA,IAAI,OAAO;QACT,OAAO,wBAAwB,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,UAAU,GAAG,CAAC;IACrF,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CACvD,qBAAqB,CAKrB;IACA,IAAI,OAAO;QACT,OAAO,6BAA6B,IAAI,CAAC,OAAO,UAAU,IAAI,CAAC,QAAQ,WAAW,CAAC;IACrF,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CACvD,qBAAqB,CAGrB;IACA,IAAI,OAAO;QACT,OAAO,qBAAqB,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CACvD,qBAAqB,CAGrB;IACA,IAAI,OAAO;QACT,OAAO,oBAAoB,IAAI,CAAC,OAAO,EAAE,CAAC;IAC5C,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,IAAI,CAAC,WAAW,CAAC,iBAAiB,CAGrE;IACA,IAAI,OAAO;QACT,OAAO,mBAAmB,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpE,CAAC;CACF"}

package/dist/factory.d.ts

@@ -0,0 +1,97 @@
+import { DurableJobsEngine } from "./engine";
+import { type AnyUnregisteredDefinition, type TypedJobRegistry, type RuntimeJobRegistry } from "./registry";
+import { type JobsClientFactory } from "./client";
+/**
+ * Result of creating durable jobs.
+ */
+export interface CreateDurableJobsResult<T extends Record<string, AnyUnregisteredDefinition>> {
+    /**
+     * The Durable Object class to export for Cloudflare.
+     *
+     * @example
+     * ```ts
+     * // Export in worker entry point
+     * export { Jobs };
+     * ```
+     */
+    readonly Jobs: typeof DurableJobsEngine;
+    /**
+     * Factory for creating typed clients.
+     *
+     * @example
+     * ```ts
+     * const client = JobsClient.fromBinding(env.JOBS);
+     * await client.continuous("tokenRefresher").start({ id: "user-123", input: {...} });
+     * ```
+     */
+    readonly JobsClient: JobsClientFactory<TypedJobRegistry<T>>;
+    /**
+     * The typed job registry with full type information.
+     */
+    readonly registry: TypedJobRegistry<T>;
+    /**
+     * Runtime registry for handler use (backwards compatibility).
+     */
+    readonly runtimeRegistry: RuntimeJobRegistry;
+}
+/**
+ * Type alias for backwards compatibility.
+ * @deprecated Use TypedJobRegistry directly instead.
+ */
+export type InferRegistryFromDefinitions<T extends Record<string, AnyUnregisteredDefinition>> = TypedJobRegistry<T>;
+/**
+ * Create a Durable Jobs engine for a set of jobs.
+ *
+ * This is the main factory function for creating production jobs engines.
+ * It returns:
+ * - `Jobs`: The Durable Object class to export
+ * - `JobsClient`: Factory for creating typed clients
+ * - `registry`: The job registry (for advanced use cases)
+ *
+ * @param definitions - Object of job definitions (keys become job names)
+ *
+ * @example
+ * ```ts
+ * import { Schema } from "effect";
+ * import { createDurableJobs, Continuous, Debounce, WorkerPool } from "@durable-effect/jobs";
+ *
+ * // Define jobs
+ * const tokenRefresher = Continuous.make({
+ *   stateSchema: Schema.Struct({
+ *     accessToken: Schema.String,
+ *     refreshToken: Schema.String,
+ *     expiresAt: Schema.Number,
+ *   }),
+ *   schedule: Continuous.every("30 minutes"),
+ *   execute: (ctx) => Effect.gen(function* () {
+ *     // Refresh token logic
+ *     ctx.setState({ ...ctx.state, accessToken: "new_token" });
+ *   }),
+ * });
+ *
+ * // Create engine and client - keys become job names
+ * const { Jobs, JobsClient } = createDurableJobs({
+ *   tokenRefresher,
+ * });
+ *
+ * // Export for Cloudflare
+ * export { Jobs };
+ *
+ * // Use client in worker
+ * export default {
+ *   async fetch(request: Request, env: Env): Promise<Response> {
+ *     const client = JobsClient.fromBinding(env.JOBS);
+ *
+ *     // Start continuous job - name comes from object key
+ *     yield* client.continuous("tokenRefresher").start({
+ *       id: "user-123",
+ *       input: { accessToken: "", refreshToken: "rt_abc", expiresAt: 0 },
+ *     });
+ *
+ *     return new Response("OK");
+ *   },
+ * };
+ * ```
+ */
+export declare function createDurableJobs<const T extends Record<string, AnyUnregisteredDefinition>>(definitions: T): CreateDurableJobsResult<T>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAyB,MAAM,UAAU,CAAC;AACpE,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,UAAU,CAAC;AAElB;;GAEG;AACH,MAAM,WAAW,uBAAuB,CACtC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAEnD;;;;;;;;OAQG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,iBAAiB,CAAC;IAExC;;;;;;;;OAQG;IACH,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5D;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAEvC;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,kBAAkB,CAAC;CAC9C;AAED;;;GAGG;AACH,MAAM,MAAM,4BAA4B,CACtC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,IACjD,gBAAgB,CAAC,CAAC,CAAC,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,EAEzD,WAAW,EAAE,CAAC,GACb,uBAAuB,CAAC,CAAC,CAAC,CAuC5B"}

package/dist/factory.js

@@ -0,0 +1,94 @@
+// packages/jobs/src/factory.ts
+import { Context } from "effect";
+import { DurableJobsEngine } from "./engine";
+import { createTypedJobRegistry, toRuntimeRegistry, } from "./registry";
+import { createJobsClient, } from "./client";
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create a Durable Jobs engine for a set of jobs.
+ *
+ * This is the main factory function for creating production jobs engines.
+ * It returns:
+ * - `Jobs`: The Durable Object class to export
+ * - `JobsClient`: Factory for creating typed clients
+ * - `registry`: The job registry (for advanced use cases)
+ *
+ * @param definitions - Object of job definitions (keys become job names)
+ *
+ * @example
+ * ```ts
+ * import { Schema } from "effect";
+ * import { createDurableJobs, Continuous, Debounce, WorkerPool } from "@durable-effect/jobs";
+ *
+ * // Define jobs
+ * const tokenRefresher = Continuous.make({
+ *   stateSchema: Schema.Struct({
+ *     accessToken: Schema.String,
+ *     refreshToken: Schema.String,
+ *     expiresAt: Schema.Number,
+ *   }),
+ *   schedule: Continuous.every("30 minutes"),
+ *   execute: (ctx) => Effect.gen(function* () {
+ *     // Refresh token logic
+ *     ctx.setState({ ...ctx.state, accessToken: "new_token" });
+ *   }),
+ * });
+ *
+ * // Create engine and client - keys become job names
+ * const { Jobs, JobsClient } = createDurableJobs({
+ *   tokenRefresher,
+ * });
+ *
+ * // Export for Cloudflare
+ * export { Jobs };
+ *
+ * // Use client in worker
+ * export default {
+ *   async fetch(request: Request, env: Env): Promise<Response> {
+ *     const client = JobsClient.fromBinding(env.JOBS);
+ *
+ *     // Start continuous job - name comes from object key
+ *     yield* client.continuous("tokenRefresher").start({
+ *       id: "user-123",
+ *       input: { accessToken: "", refreshToken: "rt_abc", expiresAt: 0 },
+ *     });
+ *
+ *     return new Response("OK");
+ *   },
+ * };
+ * ```
+ */
+export function createDurableJobs(definitions) {
+    // Create typed registry from definitions (preserves literal keys)
+    const registry = createTypedJobRegistry(definitions);
+    // Create runtime registry for handlers (uses object lookup)
+    const runtimeRegistry = toRuntimeRegistry(registry);
+    // Create bound DO class with runtime registry injected
+    class BoundJobsEngine extends DurableJobsEngine {
+        constructor(state, env) {
+            // Inject runtime registry into environment
+            const enrichedEnv = {
+                ...env,
+                __JOB_REGISTRY__: runtimeRegistry,
+            };
+            super(state, enrichedEnv);
+        }
+    }
+    // Create Effect Tag for the client
+    const ClientTag = Context.GenericTag("@durable-effect/jobs/Client");
+    // Create client factory - no phantom type cast needed!
+    // The registry already has __definitions as a real property
+    const JobsClientFactory = {
+        fromBinding: (binding) => createJobsClient(binding, registry),
+        Tag: ClientTag,
+    };
+    return {
+        Jobs: BoundJobsEngine,
+        JobsClient: JobsClientFactory,
+        registry,
+        runtimeRegistry,
+    };
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAyB,MAAM,UAAU,CAAC;AACpE,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAIlB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,gBAAgB,GAGjB,MAAM,UAAU,CAAC;AAiDlB,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AACH,MAAM,UAAU,iBAAiB,CAG/B,WAAc;IAEd,kEAAkE;IAClE,MAAM,QAAQ,GAAG,sBAAsB,CAAC,WAAW,CAAC,CAAC;IAErD,4DAA4D;IAC5D,MAAM,eAAe,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAEpD,uDAAuD;IACvD,MAAM,eAAgB,SAAQ,iBAAiB;QAC7C,YAAY,KAAyB,EAAE,GAAY;YACjD,2CAA2C;YAC3C,MAAM,WAAW,GAAqB;gBACpC,GAAI,GAAc;gBAClB,gBAAgB,EAAE,eAAe;aAClC,CAAC;YAEF,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;QAC5B,CAAC;KACF;IAED,mCAAmC;IACnC,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAElC,6BAA6B,CAAC,CAAC;IAEjC,uDAAuD;IACvD,4DAA4D;IAC5D,MAAM,iBAAiB,GAA2C;QAChE,WAAW,EAAE,CAAC,OAA+B,EAAE,EAAE,CAC/C,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC;QACrC,GAAG,EAAE,SAAS;KACf,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,eAA2C;QACjD,UAAU,EAAE,iBAAiB;QAC7B,QAAQ;QACR,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/handlers/continuous/context.d.ts

@@ -0,0 +1,25 @@
+import type { ContinuousContext } from "../../registry/types";
+/**
+ * State holder for mutable state updates during execution.
+ *
+ * The context provides setState/updateState methods that modify this holder.
+ * After execution, we read the final state from here.
+ */
+export interface StateHolder<S> {
+    current: S;
+    dirty: boolean;
+}
+/**
+ * Create a ContinuousContext for user's execute function.
+ *
+ * The context provides:
+ * - state: Current state (read-only reference)
+ * - setState: Replace entire state
+ * - updateState: Update state via function
+ * - terminate: Terminate this job instance
+ * - instanceId: DO instance identifier
+ * - runCount: Number of times execute has been called
+ * - jobName: Name of the job
+ */
+export declare function createContinuousContext<S>(stateHolder: StateHolder<S>, instanceId: string, runCount: number, jobName: string, attempt?: number): ContinuousContext<S>;
+//# sourceMappingURL=context.d.ts.map

package/dist/handlers/continuous/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/handlers/continuous/context.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,sBAAsB,CAAC;AAOhF;;;;;GAKG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,EAC3B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAU,GAClB,iBAAiB,CAAC,CAAC,CAAC,CA8BtB"}

package/dist/handlers/continuous/context.js

@@ -0,0 +1,38 @@
+// packages/jobs/src/handlers/continuous/context.ts
+import { Effect } from "effect";
+import { TerminateSignal } from "../../errors";
+/**
+ * Create a ContinuousContext for user's execute function.
+ *
+ * The context provides:
+ * - state: Current state (read-only reference)
+ * - setState: Replace entire state
+ * - updateState: Update state via function
+ * - terminate: Terminate this job instance
+ * - instanceId: DO instance identifier
+ * - runCount: Number of times execute has been called
+ * - jobName: Name of the job
+ */
+export function createContinuousContext(stateHolder, instanceId, runCount, jobName, attempt = 1) {
+    return {
+        state: Effect.sync(() => stateHolder.current),
+        setState: (newState) => Effect.sync(() => {
+            stateHolder.current = newState;
+            stateHolder.dirty = true;
+        }),
+        updateState: (fn) => Effect.sync(() => {
+            stateHolder.current = fn(stateHolder.current);
+            stateHolder.dirty = true;
+        }),
+        instanceId,
+        runCount,
+        jobName,
+        attempt,
+        isRetry: attempt > 1,
+        terminate: (options) => Effect.fail(new TerminateSignal({
+            reason: options?.reason,
+            purgeState: true,
+        })),
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/handlers/continuous/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/handlers/continuous/context.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAEnD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAiB/C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAA2B,EAC3B,UAAkB,EAClB,QAAgB,EAChB,OAAe,EACf,UAAkB,CAAC;IAEnB,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC;QAE7C,QAAQ,EAAE,CAAC,QAAW,EAAE,EAAE,CACxB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YACf,WAAW,CAAC,OAAO,GAAG,QAAQ,CAAC;YAC/B,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;QAEJ,WAAW,EAAE,CAAC,EAAqB,EAAE,EAAE,CACrC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;YACf,WAAW,CAAC,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YAC9C,WAAW,CAAC,KAAK,GAAG,IAAI,CAAC;QAC3B,CAAC,CAAC;QAEJ,UAAU;QACV,QAAQ;QACR,OAAO;QACP,OAAO;QACP,OAAO,EAAE,OAAO,GAAG,CAAC;QAEpB,SAAS,EAAE,CAAC,OAA0B,EAAE,EAAE,CACxC,MAAM,CAAC,IAAI,CACT,IAAI,eAAe,CAAC;YAClB,MAAM,EAAE,OAAO,EAAE,MAAM;YACvB,UAAU,EAAE,IAAI;SACjB,CAAC,CACmC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/handlers/continuous/executor.d.ts

@@ -0,0 +1,10 @@
+import { Effect } from "effect";
+import type { ContinuousDefinition } from "../../registry/types";
+import type { EntityStateServiceI } from "../../services/entity-state";
+import { type PrimitiveError } from "../../errors";
+/**
+ * @deprecated Use the inline executeUserFunction in handler.ts instead.
+ * This function is kept for backwards compatibility with existing tests.
+ */
+export declare function executeUserFunction<S>(def: ContinuousDefinition<S, unknown, never>, stateService: EntityStateServiceI<S>, instanceId: string, runCount: number): Effect.Effect<S | null, PrimitiveError>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/handlers/continuous/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/handlers/continuous/executor.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACvE,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EACnC,GAAG,EAAE,oBAAoB,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,EAC5C,YAAY,EAAE,mBAAmB,CAAC,CAAC,CAAC,EACpC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,EAAE,cAAc,CAAC,CAsFzC"}

package/dist/handlers/continuous/executor.js

@@ -0,0 +1,83 @@
+// packages/jobs/src/handlers/continuous/executor.ts
+//
+// NOTE: The execution logic has been moved directly into handler.ts
+// as the executeUserFunction helper. This file is kept for backwards
+// compatibility with tests but the implementation is deprecated.
+//
+// The inline implementation in handler.ts:
+// - Uses proper Effect patterns (catchAll, Effect.try)
+// - Has better error handling
+// - Avoids the matchEffect anti-pattern
+//
+// This file can be removed once tests are updated.
+import { Effect } from "effect";
+import { ExecutionError } from "../../errors";
+import { createContinuousContext } from "./context";
+/**
+ * @deprecated Use the inline executeUserFunction in handler.ts instead.
+ * This function is kept for backwards compatibility with existing tests.
+ */
+export function executeUserFunction(def, stateService, instanceId, runCount) {
+    const primitiveName = def.name;
+    return Effect.gen(function* () {
+        // Get current state
+        const currentState = yield* stateService.get().pipe(Effect.mapError((e) => new ExecutionError({
+            primitiveType: "continuous",
+            primitiveName,
+            instanceId,
+            cause: e,
+        })));
+        if (currentState === null) {
+            return null;
+        }
+        // Create mutable state holder
+        const stateHolder = {
+            current: currentState,
+            dirty: false,
+        };
+        // Create context for user function
+        const ctx = createContinuousContext(stateHolder, instanceId, runCount, def.name);
+        // Execute user function with error handling
+        yield* Effect.try({
+            try: () => def.execute(ctx),
+            catch: (e) => new ExecutionError({
+                primitiveType: "continuous",
+                primitiveName: def.name,
+                instanceId,
+                cause: e,
+            }),
+        }).pipe(Effect.flatten, Effect.catchAll((error) => {
+            if (def.onError) {
+                return Effect.try({
+                    try: () => def.onError(error, ctx),
+                    catch: (e) => new ExecutionError({
+                        primitiveType: "continuous",
+                        primitiveName: def.name,
+                        instanceId,
+                        cause: e,
+                    }),
+                }).pipe(Effect.flatten, Effect.asVoid);
+            }
+            return Effect.fail(error instanceof ExecutionError
+                ? error
+                : new ExecutionError({
+                    primitiveType: "continuous",
+                    primitiveName: def.name,
+                    instanceId,
+                    cause: error,
+                }));
+        }));
+        // Persist state if modified
+        if (stateHolder.dirty) {
+            yield* stateService.set(stateHolder.current).pipe(Effect.mapError((e) => new ExecutionError({
+                primitiveType: "continuous",
+                primitiveName: def.name,
+                instanceId,
+                cause: e,
+            })));
+            return stateHolder.current;
+        }
+        return null;
+    });
+}
+//# sourceMappingURL=executor.js.map

package/dist/handlers/continuous/executor.js.map

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

package/dist/handlers/continuous/handler.d.ts

@@ -0,0 +1,14 @@
+import { Context, Layer } from "effect";
+import { RuntimeAdapter, StorageAdapter } from "@durable-effect/core";
+import { MetadataService } from "../../services/metadata";
+import { AlarmService } from "../../services/alarm";
+import { RegistryService } from "../../services/registry";
+import { JobExecutionService } from "../../services/execution";
+import { RetryExecutor } from "../../retry";
+import type { ContinuousHandlerI } from "./types";
+declare const ContinuousHandler_base: Context.TagClass<ContinuousHandler, "@durable-effect/jobs/ContinuousHandler", ContinuousHandlerI>;
+export declare class ContinuousHandler extends ContinuousHandler_base {
+}
+export declare const ContinuousHandlerLayer: Layer.Layer<ContinuousHandler, never, MetadataService | RuntimeAdapter | StorageAdapter | AlarmService | RegistryService | RetryExecutor | JobExecutionService>;
+export {};
+//# sourceMappingURL=handler.d.ts.map

package/dist/handlers/continuous/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/handlers/continuous/handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAU,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EACL,cAAc,EACd,cAAc,EAGf,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAkB,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAwB,MAAM,0BAA0B,CAAC;AAOrF,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,KAAK,EAAE,kBAAkB,EAAsB,MAAM,SAAS,CAAC;;AAGtE,qBAAa,iBAAkB,SAAQ,sBAEG;CAAG;AAI7C,eAAO,MAAM,sBAAsB,iKAsYlC,CAAC"}