@durable-effect/jobs 0.0.1-next.1

package/dist/retry/executor.d.ts

@@ -0,0 +1,53 @@
+import { Context, Effect, Layer } from "effect";
+import { StorageAdapter, RuntimeAdapter, type StorageError } from "@durable-effect/core";
+import { AlarmService } from "../services/alarm";
+import type { JobRetryConfig } from "./types";
+import { RetryExhaustedSignal, RetryScheduledSignal } from "./errors";
+/**
+ * RetryExecutor handles retry logic for job executions.
+ *
+ * Key responsibilities:
+ * - Track retry attempts via durable storage
+ * - Calculate retry delays using configured backoff
+ * - Schedule retry alarms
+ * - Signal when retries are exhausted
+ *
+ * Important: TerminateSignal bypasses retry logic entirely.
+ * All other errors from user code are considered retryable.
+ */
+export interface RetryExecutorI {
+    /**
+     * Execute an effect with retry logic.
+     *
+     * - On success: resets retry state and returns result
+     * - On TerminateSignal: bypasses retry, propagates signal
+     * - On failure with retries remaining: schedules retry, fails with RetryScheduledSignal
+     * - On failure with retries exhausted: resets retry state, fails with RetryExhaustedSignal
+     */
+    readonly executeWithRetry: <A, E, R>(effect: Effect.Effect<A, E, R>, config: JobRetryConfig, context: {
+        jobType: "continuous" | "debounce" | "task" | "workerPool";
+        jobName: string;
+    }) => Effect.Effect<A, E | RetryExhaustedSignal | RetryScheduledSignal, R>;
+    /**
+     * Check if we're currently in a retry sequence.
+     */
+    readonly isRetrying: () => Effect.Effect<boolean, StorageError>;
+    /**
+     * Get current attempt number (1 = first attempt).
+     */
+    readonly getAttempt: () => Effect.Effect<number, StorageError>;
+    /**
+     * Reset retry state (called after success or exhaustion).
+     */
+    readonly reset: () => Effect.Effect<void, StorageError>;
+    /**
+     * Get the scheduled retry timestamp, if any.
+     */
+    readonly getScheduledAt: () => Effect.Effect<number | undefined, StorageError>;
+}
+declare const RetryExecutor_base: Context.TagClass<RetryExecutor, "@durable-effect/jobs/RetryExecutor", RetryExecutorI>;
+export declare class RetryExecutor extends RetryExecutor_base {
+}
+export declare const RetryExecutorLayer: Layer.Layer<RetryExecutor, never, RuntimeAdapter | StorageAdapter | AlarmService>;
+export {};
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/retry/executor.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAY,MAAM,QAAQ,CAAC;AAC1D,OAAO,EACL,cAAc,EACd,cAAc,EAGd,KAAK,YAAY,EAClB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAOtE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;OAOG;IACH,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EACjC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC9B,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE;QACP,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;QAC3D,OAAO,EAAE,MAAM,CAAC;KACjB,KACE,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,oBAAoB,GAAG,oBAAoB,EAAE,CAAC,CAAC,CAAC;IAE1E;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAEhE;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IAExD;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,SAAS,EAAE,YAAY,CAAC,CAAC;CAChF;;AAMD,qBAAa,aAAc,SAAQ,kBAED;CAAG;AAMrC,eAAO,MAAM,kBAAkB,mFAkJ9B,CAAC"}

package/dist/retry/executor.js

@@ -0,0 +1,112 @@
+// packages/jobs/src/retry/executor.ts
+import { Context, Effect, Layer, Duration } from "effect";
+import { StorageAdapter, RuntimeAdapter, resolveDelay, addJitter, } from "@durable-effect/core";
+import { AlarmService } from "../services/alarm";
+import { KEYS } from "../storage-keys";
+import { RetryExhaustedSignal, RetryScheduledSignal } from "./errors";
+import { TerminateSignal } from "../errors";
+// =============================================================================
+// Service Tag
+// =============================================================================
+export class RetryExecutor extends Context.Tag("@durable-effect/jobs/RetryExecutor")() {
+}
+// =============================================================================
+// Implementation
+// =============================================================================
+export const RetryExecutorLayer = Layer.effect(RetryExecutor, Effect.gen(function* () {
+    const storage = yield* StorageAdapter;
+    const runtime = yield* RuntimeAdapter;
+    const alarm = yield* AlarmService;
+    // Storage helpers
+    const getAttempt = () => storage.get(KEYS.RETRY.ATTEMPT).pipe(Effect.map((a) => a ?? 1));
+    const setAttempt = (attempt) => storage.put(KEYS.RETRY.ATTEMPT, attempt);
+    const getStartedAt = () => storage.get(KEYS.RETRY.STARTED_AT);
+    const setStartedAt = (timestamp) => storage.put(KEYS.RETRY.STARTED_AT, timestamp);
+    const setLastError = (error) => storage.put(KEYS.RETRY.LAST_ERROR, error);
+    const getScheduledAt = () => storage.get(KEYS.RETRY.SCHEDULED_AT);
+    const setScheduledAt = (timestamp) => storage.put(KEYS.RETRY.SCHEDULED_AT, timestamp);
+    const reset = () => Effect.gen(function* () {
+        yield* storage.delete(KEYS.RETRY.ATTEMPT);
+        yield* storage.delete(KEYS.RETRY.STARTED_AT);
+        yield* storage.delete(KEYS.RETRY.LAST_ERROR);
+        yield* storage.delete(KEYS.RETRY.SCHEDULED_AT);
+    });
+    return {
+        executeWithRetry: (effect, config, context) => Effect.gen(function* () {
+            const attempt = yield* getAttempt();
+            const now = yield* runtime.now();
+            // Initialize started_at on first attempt
+            if (attempt === 1) {
+                yield* setStartedAt(now);
+            }
+            // Check max duration before executing
+            if (config.maxDuration !== undefined) {
+                const startedAt = yield* getStartedAt();
+                if (startedAt !== undefined) {
+                    const elapsed = now - startedAt;
+                    const duration = Duration.decode(config.maxDuration);
+                    const maxMs = Duration.toMillis(duration);
+                    if (elapsed >= maxMs) {
+                        // Duration exceeded - signal exhaustion
+                        yield* reset();
+                        return yield* Effect.fail(new RetryExhaustedSignal({
+                            ...context,
+                            instanceId: runtime.instanceId,
+                            attempts: attempt,
+                            lastError: new Error("Max duration exceeded"),
+                            totalDurationMs: elapsed,
+                            reason: "max_duration_exceeded",
+                        }));
+                    }
+                }
+            }
+            // Execute the effect, but let TerminateSignal bypass retry
+            const result = yield* effect.pipe(Effect.map((a) => ({ _tag: "Success", value: a })), Effect.catchAll((e) => {
+                // TerminateSignal bypasses retry entirely
+                if (e instanceof TerminateSignal) {
+                    return Effect.fail(e);
+                }
+                // Regular errors go through retry logic
+                return Effect.succeed({ _tag: "Failure", error: e });
+            }));
+            if (result._tag === "Success") {
+                // Success - reset retry state
+                yield* reset();
+                return result.value;
+            }
+            // Failure - all errors are retryable (removed isRetryable check)
+            const error = result.error;
+            // Check if attempts exhausted
+            if (attempt >= config.maxAttempts) {
+                // Exhausted - signal it (handler will call onRetryExhausted or terminate)
+                const startedAt = (yield* getStartedAt()) ?? now;
+                yield* reset();
+                return yield* Effect.fail(new RetryExhaustedSignal({
+                    ...context,
+                    instanceId: runtime.instanceId,
+                    attempts: attempt,
+                    lastError: error,
+                    totalDurationMs: now - startedAt,
+                    reason: "max_attempts_exceeded",
+                }));
+            }
+            // Schedule retry
+            yield* setLastError(error);
+            yield* setAttempt(attempt + 1);
+            const baseDelay = resolveDelay(config.delay, attempt);
+            const delayMs = config.jitter !== false ? addJitter(baseDelay) : baseDelay;
+            const resumeAt = now + delayMs;
+            yield* alarm.schedule(resumeAt);
+            yield* setScheduledAt(resumeAt);
+            // Return a signal that the handler will catch
+            return yield* Effect.fail(new RetryScheduledSignal({ resumeAt, attempt: attempt + 1 }));
+        }).pipe(
+        // Map storage/scheduler errors to defects (they shouldn't happen)
+        Effect.catchTag("StorageError", (e) => Effect.die(e)), Effect.catchTag("SchedulerError", (e) => Effect.die(e))),
+        isRetrying: () => getAttempt().pipe(Effect.map((a) => a > 1)),
+        getAttempt,
+        reset,
+        getScheduledAt,
+    };
+}));
+//# sourceMappingURL=executor.js.map

package/dist/retry/executor.js.map

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

package/dist/retry/index.d.ts

@@ -0,0 +1,4 @@
+export type { JobRetryConfig, RetryExhaustedInfo } from "./types";
+export { RetryExhaustedSignal, RetryScheduledSignal } from "./errors";
+export { RetryExecutor, RetryExecutorLayer, type RetryExecutorI, } from "./executor";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retry/index.ts"],"names":[],"mappings":"AAEA,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,KAAK,cAAc,GACpB,MAAM,YAAY,CAAC"}

package/dist/retry/index.js

@@ -0,0 +1,4 @@
+// packages/jobs/src/retry/index.ts
+export { RetryExhaustedSignal, RetryScheduledSignal } from "./errors";
+export { RetryExecutor, RetryExecutorLayer, } from "./executor";
+//# sourceMappingURL=index.js.map

package/dist/retry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retry/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAGnC,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACtE,OAAO,EACL,aAAa,EACb,kBAAkB,GAEnB,MAAM,YAAY,CAAC"}

package/dist/retry/types.d.ts

@@ -0,0 +1,29 @@
+import type { BaseRetryConfig } from "@durable-effect/core";
+/**
+ * Information provided when all retry attempts are exhausted.
+ *
+ * This is passed to the RetryExhaustedSignal and can be used by
+ * the job's onRetryExhausted handler.
+ */
+export interface RetryExhaustedInfo {
+    readonly jobType: "continuous" | "debounce" | "task" | "workerPool";
+    readonly jobName: string;
+    readonly instanceId: string;
+    readonly attempts: number;
+    readonly lastError: unknown;
+    readonly totalDurationMs: number;
+}
+/**
+ * Retry configuration for job execute handlers.
+ *
+ * Simplified configuration focused only on retry timing.
+ * All errors from execute are retryable - use onRetryExhausted
+ * at the job definition level for custom exhaustion handling.
+ *
+ * When retries are exhausted:
+ * - If onRetryExhausted is defined on the job: it's called with the typed error
+ * - If not defined: the job is terminated (state purged) by default
+ */
+export interface JobRetryConfig extends BaseRetryConfig {
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/retry/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,GAAG,YAAY,CAAC;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAe,SAAQ,eAAe;CAMtD"}

package/dist/retry/types.js

@@ -0,0 +1,3 @@
+// packages/jobs/src/retry/types.ts
+export {};
+//# sourceMappingURL=types.js.map

package/dist/retry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/retry/types.ts"],"names":[],"mappings":"AAAA,mCAAmC"}

package/dist/runtime/dispatcher.d.ts

@@ -0,0 +1,39 @@
+import { Context, Effect, Layer } from "effect";
+import { MetadataService } from "../services/metadata";
+import { ContinuousHandler } from "../handlers/continuous";
+import { DebounceHandler } from "../handlers/debounce";
+import { TaskHandler } from "../handlers/task";
+import { type JobError } from "../errors";
+import type { JobRequest, JobResponse } from "./types";
+/**
+ * Dispatcher routes requests to job handlers.
+ *
+ * This is the central routing hub for all job operations:
+ * - handle(request): Routes to the appropriate handler based on request.type
+ * - handleAlarm(): Reads metadata to determine type, then routes to handler
+ */
+export interface DispatcherServiceI {
+    /**
+     * Handle a job request.
+     * Routes to the appropriate handler based on request.type.
+     */
+    readonly handle: (request: JobRequest) => Effect.Effect<JobResponse, JobError, any>;
+    /**
+     * Handle an alarm.
+     * Reads metadata to determine which job type to route to.
+     */
+    readonly handleAlarm: () => Effect.Effect<void, JobError, any>;
+}
+declare const Dispatcher_base: Context.TagClass<Dispatcher, "@durable-effect/jobs/Dispatcher", DispatcherServiceI>;
+export declare class Dispatcher extends Dispatcher_base {
+}
+/**
+ * Creates the dispatcher that routes to job handlers.
+ *
+ * Phase 3: Routes to ContinuousHandler
+ * Phase 4: Add routing to DebounceHandler
+ * Phase 5: Add routing to WorkerPoolHandler
+ */
+export declare const DispatcherLayer: Layer.Layer<Dispatcher, never, MetadataService | ContinuousHandler | DebounceHandler | TaskHandler>;
+export {};
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/runtime/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/runtime/dispatcher.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAuB,KAAK,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAMvD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,CACf,OAAO,EAAE,UAAU,KAChB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;CAChE;;AAMD,qBAAa,UAAW,SAAQ,eAEG;CAAG;AAMtC;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,qGA6E3B,CAAC"}

package/dist/runtime/dispatcher.js

@@ -0,0 +1,76 @@
+// packages/jobs/src/runtime/dispatcher.ts
+import { Context, Effect, Layer } from "effect";
+import { MetadataService } from "../services/metadata";
+import { ContinuousHandler } from "../handlers/continuous";
+import { DebounceHandler } from "../handlers/debounce";
+import { TaskHandler } from "../handlers/task";
+import { UnknownJobTypeError } from "../errors";
+// =============================================================================
+// Service Tag
+// =============================================================================
+export class Dispatcher extends Context.Tag("@durable-effect/jobs/Dispatcher")() {
+}
+// =============================================================================
+// Layer Implementation
+// =============================================================================
+/**
+ * Creates the dispatcher that routes to job handlers.
+ *
+ * Phase 3: Routes to ContinuousHandler
+ * Phase 4: Add routing to DebounceHandler
+ * Phase 5: Add routing to WorkerPoolHandler
+ */
+export const DispatcherLayer = Layer.effect(Dispatcher, Effect.gen(function* () {
+    const metadata = yield* MetadataService;
+    const continuous = yield* ContinuousHandler;
+    const debounce = yield* DebounceHandler;
+    const task = yield* TaskHandler;
+    return {
+        handle: (request) => Effect.gen(function* () {
+            switch (request.type) {
+                case "continuous":
+                    return yield* continuous.handle(request);
+                case "debounce":
+                    return yield* debounce.handle(request);
+                case "task":
+                    return yield* task.handle(request);
+                case "workerPool":
+                    // TODO: Route to WorkerPoolHandler in Phase 5
+                    return yield* Effect.fail(new UnknownJobTypeError({
+                        type: `workerPool (handler not implemented)`,
+                    }));
+                default:
+                    // TypeScript exhaustiveness check
+                    const _exhaustive = request;
+                    return yield* Effect.fail(new UnknownJobTypeError({
+                        type: request.type,
+                    }));
+            }
+        }),
+        handleAlarm: () => Effect.gen(function* () {
+            const meta = yield* metadata.get();
+            // No metadata = instance was never initialized, nothing to do
+            if (!meta) {
+                return;
+            }
+            switch (meta.type) {
+                case "continuous":
+                    yield* continuous.handleAlarm();
+                    break;
+                case "debounce":
+                    yield* debounce.handleAlarm();
+                    break;
+                case "task":
+                    yield* task.handleAlarm();
+                    break;
+                case "workerPool":
+                    // TODO: Route to WorkerPoolHandler.handleAlarm in Phase 5
+                    yield* Effect.logInfo(`Alarm for workerPool/${meta.name} (handler not implemented)`);
+                    break;
+                default:
+                    yield* Effect.logWarning(`Unknown job type in alarm: ${meta.type}`);
+            }
+        }),
+    };
+}));
+//# sourceMappingURL=dispatcher.js.map

package/dist/runtime/dispatcher.js.map

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

package/dist/runtime/index.d.ts

@@ -0,0 +1,4 @@
+export type { JobRequest, JobResponse, ContinuousRequest, DebounceRequest, WorkerPoolRequest, ContinuousStartResponse, ContinuousTerminateResponse, ContinuousTriggerResponse, ContinuousStatusResponse, ContinuousGetStateResponse, DebounceAddResponse, DebounceFlushResponse, DebounceClearResponse, DebounceStatusResponse, DebounceGetStateResponse, WorkerPoolEnqueueResponse, WorkerPoolPauseResponse, WorkerPoolResumeResponse, WorkerPoolCancelResponse, WorkerPoolStatusResponse, WorkerPoolDrainResponse, } from "./types";
+export { Dispatcher, DispatcherLayer, type DispatcherServiceI, } from "./dispatcher";
+export { createJobsRuntime, createJobsRuntimeFromLayer, type JobsRuntime, type JobsRuntimeConfig, } from "./runtime";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,2BAA2B,EAC3B,yBAAyB,EACzB,wBAAwB,EACxB,0BAA0B,EAC1B,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,UAAU,EACV,eAAe,EACf,KAAK,kBAAkB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,iBAAiB,EACjB,0BAA0B,EAC1B,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,WAAW,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,6 @@
+// packages/jobs/src/runtime/index.ts
+// Dispatcher
+export { Dispatcher, DispatcherLayer, } from "./dispatcher";
+// Runtime
+export { createJobsRuntime, createJobsRuntimeFromLayer, } from "./runtime";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,qCAAqC;AA2BrC,aAAa;AACb,OAAO,EACL,UAAU,EACV,eAAe,GAEhB,MAAM,cAAc,CAAC;AAEtB,UAAU;AACV,OAAO,EACL,iBAAiB,EACjB,0BAA0B,GAG3B,MAAM,WAAW,CAAC"}

package/dist/runtime/runtime.d.ts

@@ -0,0 +1,88 @@
+import { type RuntimeLayer } from "@durable-effect/core";
+import type { JobRequest, JobResponse } from "./types";
+import type { RuntimeJobRegistry } from "../registry/typed";
+/**
+ * Configuration for creating a jobs runtime.
+ */
+export interface JobsRuntimeConfig {
+    /**
+     * Durable Object state (provides storage + alarm).
+     */
+    readonly doState: DurableObjectState;
+    /**
+     * Registry of job definitions.
+     * Required for handlers to look up definitions.
+     */
+    readonly registry: RuntimeJobRegistry;
+}
+/**
+ * The jobs runtime interface.
+ *
+ * This is what the DO shell delegates to. It's a simple interface
+ * that hides all the Effect complexity from the DO class.
+ */
+export interface JobsRuntime {
+    /**
+     * Handle a job request.
+     */
+    readonly handle: (request: JobRequest) => Promise<JobResponse>;
+    /**
+     * Handle an alarm.
+     */
+    readonly handleAlarm: () => Promise<void>;
+    /**
+     * Flush any pending events.
+     * Should be called via waitUntil after handle/handleAlarm.
+     */
+    readonly flush: () => Promise<void>;
+}
+/**
+ * Creates a jobs runtime from DO state.
+ *
+ * This is the main entry point for the runtime layer. The DO class
+ * creates this once in its constructor and delegates all operations to it.
+ *
+ * @example
+ * ```ts
+ * class DurableJobsEngine extends DurableObject {
+ *   #runtime: JobsRuntime;
+ *
+ *   constructor(state: DurableObjectState, env: Env) {
+ *     super(state, env);
+ *     this.#runtime = createJobsRuntime({
+ *       doState: state,
+ *       registry: env.__JOB_REGISTRY__,
+ *     });
+ *   }
+ *
+ *   async call(request: JobRequest): Promise<JobResponse> {
+ *     const result = await this.#runtime.handle(request);
+ *     this.ctx.waitUntil(this.#runtime.flush());
+ *     return result;
+ *   }
+ *
+ *   async alarm(): Promise<void> {
+ *     await this.#runtime.handleAlarm();
+ *     this.ctx.waitUntil(this.#runtime.flush());
+ *   }
+ * }
+ * ```
+ */
+export declare function createJobsRuntime(config: JobsRuntimeConfig): JobsRuntime;
+/**
+ * Creates a jobs runtime from a provided layer with a registry.
+ *
+ * Used for testing with in-memory adapters.
+ *
+ * @example
+ * ```ts
+ * const { layer, handles } = createTestRuntime("test-instance", 1000000);
+ * const runtime = createJobsRuntimeFromLayer(layer, registry);
+ *
+ * await runtime.handle({ type: "continuous", action: "start", ... });
+ * handles.scheduler.fire();
+ * await runtime.handleAlarm();
+ * ```
+ */
+export declare function createJobsRuntimeFromLayer(coreLayer: RuntimeLayer, registry: RuntimeJobRegistry): JobsRuntime;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime.ts"],"names":[],"mappings":"AAGA,OAAO,EAA2C,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAIlG,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAM5D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAErC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;CACvC;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAqFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,iBAAiB,GACxB,WAAW,CASb;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,YAAY,EACvB,QAAQ,EAAE,kBAAkB,GAC3B,WAAW,CAIb"}

package/dist/runtime/runtime.js

@@ -0,0 +1,116 @@
+// packages/jobs/src/runtime/runtime.ts
+import { Effect, Layer } from "effect";
+import { createDurableObjectRuntime, flushEvents } from "@durable-effect/core";
+import { RuntimeServicesLayer, RegistryServiceLayer, JobExecutionServiceLayer, CleanupServiceLayer } from "../services";
+import { JobHandlersLayer, RetryExecutorLayer } from "../handlers";
+import { Dispatcher, DispatcherLayer } from "./dispatcher";
+// =============================================================================
+// Shared Layer Composition
+// =============================================================================
+/**
+ * Create the full dispatcher layer from a core layer and registry.
+ *
+ * This is the shared layer composition logic used by both
+ * createJobsRuntime and createJobsRuntimeFromLayer.
+ */
+function createDispatcherLayer(coreLayer, registry) {
+    // Registry layer
+    const registryLayer = RegistryServiceLayer(registry);
+    // Runtime services layer (MetadataService, AlarmService, IdempotencyService)
+    const servicesLayer = RuntimeServicesLayer.pipe(Layer.provideMerge(coreLayer));
+    // Cleanup service layer (depends on AlarmService and StorageAdapter)
+    const cleanupLayer = CleanupServiceLayer.pipe(Layer.provideMerge(servicesLayer));
+    // Retry executor layer (depends on AlarmService from servicesLayer)
+    const retryLayer = RetryExecutorLayer.pipe(Layer.provideMerge(servicesLayer));
+    // Job Execution Service (depends on RetryExecutor, CleanupService, and Core)
+    const executionLayer = JobExecutionServiceLayer.pipe(Layer.provideMerge(retryLayer), Layer.provideMerge(cleanupLayer), Layer.provideMerge(coreLayer));
+    // Handlers layer (ContinuousHandler, DebounceHandler, etc.)
+    // Depends on: registry, services, retry executor, execution service
+    const handlersLayer = JobHandlersLayer.pipe(Layer.provideMerge(registryLayer), Layer.provideMerge(servicesLayer), Layer.provideMerge(retryLayer), Layer.provideMerge(executionLayer));
+    // Dispatcher layer (routes requests to handlers)
+    return DispatcherLayer.pipe(Layer.provideMerge(handlersLayer));
+}
+/**
+ * Create runtime implementation from dispatcher layer.
+ */
+function createRuntimeFromDispatcherLayer(dispatcherLayer) {
+    // Helper to run effects with full layer stack
+    const runEffect = (effect) => Effect.runPromise(effect.pipe(Effect.provide(dispatcherLayer)));
+    return {
+        handle: (request) => runEffect(Effect.gen(function* () {
+            const dispatcher = yield* Dispatcher;
+            return yield* dispatcher.handle(request);
+        })),
+        handleAlarm: () => runEffect(Effect.gen(function* () {
+            const dispatcher = yield* Dispatcher;
+            yield* dispatcher.handleAlarm();
+        })),
+        flush: () => runEffect(flushEvents),
+    };
+}
+// =============================================================================
+// Factory Functions
+// =============================================================================
+/**
+ * Creates a jobs runtime from DO state.
+ *
+ * This is the main entry point for the runtime layer. The DO class
+ * creates this once in its constructor and delegates all operations to it.
+ *
+ * @example
+ * ```ts
+ * class DurableJobsEngine extends DurableObject {
+ *   #runtime: JobsRuntime;
+ *
+ *   constructor(state: DurableObjectState, env: Env) {
+ *     super(state, env);
+ *     this.#runtime = createJobsRuntime({
+ *       doState: state,
+ *       registry: env.__JOB_REGISTRY__,
+ *     });
+ *   }
+ *
+ *   async call(request: JobRequest): Promise<JobResponse> {
+ *     const result = await this.#runtime.handle(request);
+ *     this.ctx.waitUntil(this.#runtime.flush());
+ *     return result;
+ *   }
+ *
+ *   async alarm(): Promise<void> {
+ *     await this.#runtime.handleAlarm();
+ *     this.ctx.waitUntil(this.#runtime.flush());
+ *   }
+ * }
+ * ```
+ */
+export function createJobsRuntime(config) {
+    if (!config.registry) {
+        throw new Error("createJobsRuntime requires a registry");
+    }
+    const coreLayer = createDurableObjectRuntime(config.doState);
+    const dispatcherLayer = createDispatcherLayer(coreLayer, config.registry);
+    return createRuntimeFromDispatcherLayer(dispatcherLayer);
+}
+// =============================================================================
+// Test Runtime Factory
+// =============================================================================
+/**
+ * Creates a jobs runtime from a provided layer with a registry.
+ *
+ * Used for testing with in-memory adapters.
+ *
+ * @example
+ * ```ts
+ * const { layer, handles } = createTestRuntime("test-instance", 1000000);
+ * const runtime = createJobsRuntimeFromLayer(layer, registry);
+ *
+ * await runtime.handle({ type: "continuous", action: "start", ... });
+ * handles.scheduler.fire();
+ * await runtime.handleAlarm();
+ * ```
+ */
+export function createJobsRuntimeFromLayer(coreLayer, registry) {
+    const dispatcherLayer = createDispatcherLayer(coreLayer, registry);
+    return createRuntimeFromDispatcherLayer(dispatcherLayer);
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime/runtime.js.map

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