delaykit 0.1.0

package/dist/emitter.js

@@ -0,0 +1,41 @@
+export class JobEventEmitter {
+    listeners = new Map();
+    /** Bound emit function — safe to pass as a dependency. Single instance, no closure per access. */
+    emit = (event) => {
+        const set = this.listeners.get(event.type);
+        if (!set || set.size === 0)
+            return;
+        for (const listener of set) {
+            try {
+                const result = listener(event);
+                if (result instanceof Promise) {
+                    result.catch((err) => {
+                        console.error(`[delaykit] Async event listener error for "${event.type}":`, err);
+                    });
+                }
+            }
+            catch (err) {
+                console.error(`[delaykit] Event listener error for "${event.type}":`, err);
+            }
+        }
+    };
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return () => { set.delete(listener); };
+    }
+}
+export function emitStalled(emit, job, stalledMs) {
+    emit?.({
+        type: "job:stalled",
+        job: { ...job },
+        timestamp: new Date(),
+        stalledMs,
+        reclaimed: true,
+    });
+}
+//# sourceMappingURL=emitter.js.map

package/dist/emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.js","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAe;IAClB,SAAS,GAAG,IAAI,GAAG,EAA4C,CAAC;IAExE,kGAAkG;IACzF,IAAI,GAAW,CAAC,KAAK,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO;QACnC,KAAK,MAAM,QAAQ,IAAI,GAAG,EAAE,CAAC;YAC3B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAyB,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACrD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;oBAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;wBAC5B,OAAO,CAAC,KAAK,CAAC,8CAA8C,KAAK,CAAC,IAAI,IAAI,EAAE,GAAG,CAAC,CAAC;oBACnF,CAAC,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,wCAAwC,KAAK,CAAC,IAAI,IAAI,EAAE,GAAG,CAAC,CAAC;YAC7E,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,EAAE,CAAyB,KAAQ,EAAE,QAA6B;QAChE,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClB,OAAO,GAAG,EAAE,GAAG,GAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,IAAwB,EAAE,GAAQ,EAAE,SAAiB;IAC/E,IAAI,EAAE,CAAC;QACL,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE;QACf,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,SAAS;QACT,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;AACL,CAAC"}

package/dist/executor.d.ts

@@ -0,0 +1,41 @@
+import type { HandlerContext, Job, Store, EmitFn } from "./types.js";
+export interface HandlerEntry {
+    fn: (ctx: HandlerContext) => Promise<void>;
+    timeoutMs: number;
+}
+export type ExecutionResult = {
+    status: "completed";
+    job: Job;
+    startedAt: number;
+} | {
+    status: "handler_succeeded";
+    job: Job;
+    startedAt: number;
+} | {
+    status: "handler_error";
+    error: Error;
+    job: Job;
+    startedAt: number;
+} | {
+    status: "needs_reschedule";
+    job: Job;
+} | {
+    status: "skipped";
+};
+export interface TriggerPayload {
+    jobId: string;
+    version: number;
+}
+/**
+ * Claims a job and runs the handler. Returns a decision signal
+ * for the scheduler to act on.
+ *
+ * For kind='once': marks completed on success, returns "completed".
+ * For patterns: returns "handler_succeeded" — the scheduler handles
+ *   the markCompleted/requeueForNextWindow decision.
+ * For debounce not settled: returns "needs_reschedule" — the scheduler
+ *   does scheduler-first + rescheduleDueAt.
+ * On failure: returns "handler_error" — the scheduler decides retry vs terminal.
+ */
+export declare function executeJob(trigger: TriggerPayload, store: Store, handlers: Map<string, HandlerEntry>, emit?: EmitFn): Promise<ExecutionResult>;
+//# sourceMappingURL=executor.d.ts.map

package/dist/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../src/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAIrE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,MAAM,EAAE,mBAAmB,CAAC;IAAC,GAAG,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC5D;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,GAAG,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,MAAM,EAAE,kBAAkB,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GACxC;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1B,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACnC,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAgF1B"}

package/dist/executor.js

@@ -0,0 +1,98 @@
+import { DEFAULT_TIMEOUT_MS, STALLED_GRACE_MS } from "./types.js";
+import { emitStalled } from "./emitter.js";
+/**
+ * Claims a job and runs the handler. Returns a decision signal
+ * for the scheduler to act on.
+ *
+ * For kind='once': marks completed on success, returns "completed".
+ * For patterns: returns "handler_succeeded" — the scheduler handles
+ *   the markCompleted/requeueForNextWindow decision.
+ * For debounce not settled: returns "needs_reschedule" — the scheduler
+ *   does scheduler-first + rescheduleDueAt.
+ * On failure: returns "handler_error" — the scheduler decides retry vs terminal.
+ */
+export async function executeJob(trigger, store, handlers, emit) {
+    let job = await store.getJob(trigger.jobId);
+    if (!job)
+        return { status: "skipped" };
+    if (job.version !== trigger.version)
+        return { status: "skipped" };
+    // Inline stalled recovery: if the row is running with an expired lease,
+    // reclaim it before the pending check. This handles the case where a
+    // previous process died mid-handler and a redelivery arrives.
+    if (job.status === "running" && job.startedAt) {
+        const entry = handlers.get(job.handler);
+        const leaseMs = (entry?.timeoutMs ?? DEFAULT_TIMEOUT_MS) + STALLED_GRACE_MS;
+        const stalledMs = Date.now() - job.startedAt.getTime();
+        const reclaimed = await store.reclaimStalled(job.id, leaseMs);
+        if (reclaimed) {
+            emitStalled(emit, job, stalledMs);
+            // Check if retry budget is exhausted after reclaim
+            if (reclaimed.attempt >= reclaimed.maxAttempts) {
+                await store.markRunning(reclaimed.id, reclaimed.version);
+                const error = new Error("Job stalled (process crash or timeout)");
+                await store.markFailed(reclaimed.id, reclaimed.version, error);
+                return { status: "handler_error", error, job: reclaimed, startedAt: Date.now() };
+            }
+            job = reclaimed;
+        }
+    }
+    if (job.status !== "pending")
+        return { status: "skipped" };
+    // Debounce settlement check (before claiming)
+    if (job.kind === "debounce") {
+        const now = Date.now();
+        const settled = job.lastAt != null && (now - job.lastAt.getTime()) >= (job.waitMs ?? 0);
+        const maxWaitExceeded = job.maxWaitMs != null && job.firstAt != null &&
+            (now - job.firstAt.getTime()) >= job.maxWaitMs;
+        if (!settled && !maxWaitExceeded) {
+            return { status: "needs_reschedule", job };
+        }
+    }
+    const entry = handlers.get(job.handler);
+    if (!entry) {
+        console.error(`[delaykit] No handler registered for "${job.handler}". Job ${job.id} marked failed.`);
+        await store.markRunning(job.id, job.version);
+        await store.markFailed(job.id, job.version, new Error(`No handler registered for "${job.handler}"`));
+        return { status: "handler_error", error: new Error(`No handler registered for "${job.handler}"`), job, startedAt: Date.now() };
+    }
+    const claimed = await store.markRunning(job.id, job.version);
+    if (!claimed)
+        return { status: "skipped" };
+    const startedAt = Date.now();
+    const startedDate = new Date(startedAt);
+    emit?.({
+        type: "job:started",
+        job: { ...job, status: "running", claimedVersion: job.version, startedAt: startedDate },
+        timestamp: startedDate,
+        attempt: job.attempt,
+    });
+    const ac = new AbortController();
+    const ctx = { key: job.key, job, signal: ac.signal };
+    try {
+        await executeWithTimeout(entry.fn, ctx, ac, entry.timeoutMs);
+        if (job.kind === "once") {
+            await store.markCompleted(job.id, job.version);
+            return { status: "completed", job, startedAt };
+        }
+        // Pattern: return decision signal for scheduler to handle
+        return { status: "handler_succeeded", job, startedAt };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error(String(err));
+        return { status: "handler_error", error, job, startedAt };
+    }
+}
+function executeWithTimeout(fn, ctx, ac, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            ac.abort();
+            reject(new Error(`Handler "${ctx.job.handler}" timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        fn(ctx)
+            .then(resolve)
+            .catch(reject)
+            .finally(() => clearTimeout(timer));
+    });
+}
+//# sourceMappingURL=executor.js.map

package/dist/executor.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { DelayKit } from "./delaykit.js";
+export type { DelayKitOptions } from "./delaykit.js";
+export { executeJob } from "./executor.js";
+export type { HandlerEntry, ExecutionResult, TriggerPayload } from "./executor.js";
+export { ACTIVE_STATUSES } from "./types.js";
+export type { Job, JobStatus, Store, Scheduler, ScheduleOptions, DebounceOptions, ThrottleOptions, HandlerFn, HandlerConfig, HandlerContext, RetryConfig, ScheduleRequest, SchedulerRetryConfig, } from "./types.js";
+export { parseDuration, delayToDate } from "./duration.js";
+export { JobEventEmitter } from "./emitter.js";
+export type { JobEvent, JobEventType, JobEventMap, JobEventListener, EmitFn, JobScheduledEvent, JobStartedEvent, JobCompletedEvent, JobFailedEvent, JobRetryingEvent, JobCancelledEvent, JobStalledEvent, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EACV,GAAG,EACH,SAAS,EACT,KAAK,EACL,SAAS,EACT,eAAe,EACf,eAAe,EACf,eAAe,EACf,SAAS,EACT,aAAa,EACb,cAAc,EACd,WAAW,EACX,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,gBAAgB,EAChB,MAAM,EACN,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { DelayKit } from "./delaykit.js";
+export { executeJob } from "./executor.js";
+export { ACTIVE_STATUSES } from "./types.js";
+export { parseDuration, delayToDate } from "./duration.js";
+export { JobEventEmitter } from "./emitter.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAgB7C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/result-handler.d.ts

@@ -0,0 +1,23 @@
+import type { ExecutionResult } from "./executor.js";
+import type { Store, EmitFn, ScheduleRequest } from "./types.js";
+import type { PollingHandlerEntry, RetryConfig } from "./schedulers/polling.js";
+export interface ResultHandlerDeps {
+    store: Store;
+    handlers: Map<string, PollingHandlerEntry>;
+    schedule: (req: ScheduleRequest) => Promise<string | null>;
+    cancel?: (schedulerRef: string) => Promise<void>;
+    /** When true, the external scheduler owns retry timing (PosthookScheduler).
+     *  Handler failures just return "retry" without calling retryJob(). */
+    externalRetries?: boolean;
+    emit?: EmitFn;
+}
+/**
+ * Shared post-execution result handling for both PollingScheduler and webhook delivery.
+ *
+ * Returns:
+ * - "ok" — completed, requeued, or skipped (caller returns 200)
+ * - "retry" — handler failed with retries remaining (caller returns 500 for Posthook retry)
+ */
+export declare function handleResult(result: ExecutionResult, deps: ResultHandlerDeps): Promise<"ok" | "retry">;
+export declare function calculateRetryDelay(retry: RetryConfig, attempt: number): number;
+//# sourceMappingURL=result-handler.d.ts.map

package/dist/result-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-handler.d.ts","sourceRoot":"","sources":["../src/result-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,KAAK,EAAO,MAAM,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEhF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC3C,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD;2EACuE;IACvE,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,CA2GzB;AAwBD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAsB/E"}

package/dist/result-handler.js

@@ -0,0 +1,155 @@
+/**
+ * Shared post-execution result handling for both PollingScheduler and webhook delivery.
+ *
+ * Returns:
+ * - "ok" — completed, requeued, or skipped (caller returns 200)
+ * - "retry" — handler failed with retries remaining (caller returns 500 for Posthook retry)
+ */
+export async function handleResult(result, deps) {
+    if (result.status === "skipped") {
+        return "ok";
+    }
+    if (result.status === "completed") {
+        const now = Date.now();
+        deps.emit?.({
+            type: "job:completed",
+            job: { ...result.job, status: "completed" },
+            timestamp: new Date(now),
+            durationMs: now - result.startedAt,
+        });
+        return "ok";
+    }
+    if (result.status === "needs_reschedule") {
+        const updated = await deps.store.rescheduleDueAt(result.job.id, result.job.version);
+        if (updated)
+            await materializeWake(updated, deps);
+        return "ok";
+    }
+    if (result.status === "handler_succeeded") {
+        const completed = await deps.store.markCompleted(result.job.id, result.job.version);
+        if (completed) {
+            const now = Date.now();
+            deps.emit?.({
+                type: "job:completed",
+                job: { ...result.job, status: "completed" },
+                timestamp: new Date(now),
+                durationMs: now - result.startedAt,
+            });
+        }
+        else if (result.job.kind !== "once") {
+            const requeued = await deps.store.requeueForNextWindow(result.job.id);
+            if (requeued)
+                await materializeWake(requeued, deps);
+        }
+        return "ok";
+    }
+    if (result.status === "handler_error") {
+        const entry = deps.handlers.get(result.job.handler);
+        if (!entry) {
+            await deps.store.markFailed(result.job.id, result.job.version, result.error);
+            return "ok";
+        }
+        if (result.job.attempt + 1 < entry.retry.maxAttempts) {
+            const scheduledFor = deps.externalRetries
+                ? new Date()
+                : new Date(Date.now() + calculateRetryDelay(entry.retry, result.job.attempt));
+            const retried = await deps.store.retryJob(result.job.id, result.job.version, result.job.attempt + 1, scheduledFor, result.error.message);
+            if (retried) {
+                deps.emit?.({
+                    type: "job:retrying",
+                    job: { ...result.job },
+                    timestamp: new Date(),
+                    error: result.error,
+                    attempt: result.job.attempt,
+                    nextAttempt: result.job.attempt + 1,
+                    scheduledFor,
+                });
+            }
+            else if (result.job.kind !== "once") {
+                const requeued = await deps.store.requeueForNextWindow(result.job.id);
+                if (requeued)
+                    await materializeWake(requeued, deps);
+                return "ok";
+            }
+            return deps.externalRetries ? "retry" : "ok";
+        }
+        // Exhausted: terminal failure
+        const failed = await deps.store.markFailed(result.job.id, result.job.version, result.error);
+        if (failed) {
+            const now = Date.now();
+            deps.emit?.({
+                type: "job:failed",
+                job: { ...result.job, status: "failed" },
+                timestamp: new Date(now),
+                error: result.error,
+                attempts: result.job.attempt + 1,
+                durationMs: now - result.startedAt,
+            });
+        }
+        else if (result.job.kind !== "once") {
+            const requeued = await deps.store.requeueForNextWindow(result.job.id);
+            if (requeued)
+                await materializeWake(requeued, deps);
+        }
+        if (entry.retry.onFailure) {
+            try {
+                await entry.retry.onFailure({
+                    key: result.job.key,
+                    error: result.error,
+                    attempts: result.job.attempt + 1,
+                });
+            }
+            catch (e) {
+                console.error(`[delaykit] onFailure handler threw for job ${result.job.id}:`, e);
+            }
+        }
+        return "ok";
+    }
+    return "ok";
+}
+/**
+ * Schedule an external wake and store the ref (version-guarded).
+ * If the version advanced while we were creating the hook (e.g., a new
+ * pattern event arrived during the network round-trip), the CAS fails.
+ * Cancel the orphaned hook so it doesn't deliver and get silently ignored.
+ */
+async function materializeWake(job, deps) {
+    const entry = deps.handlers.get(job.handler);
+    const retry = entry && entry.retry.maxAttempts > 1
+        ? { ...entry.retry, attempts: entry.retry.maxAttempts }
+        : undefined;
+    const ref = await deps.schedule({
+        id: job.id, version: job.version, at: job.scheduledFor,
+        handler: job.handler, key: job.key, retry,
+    });
+    if (!ref)
+        return;
+    const stored = await deps.store.updateSchedulerRef(job.id, job.version, ref);
+    if (!stored && deps.cancel) {
+        try {
+            await deps.cancel(ref);
+        }
+        catch { /* best-effort cleanup */ }
+    }
+}
+export function calculateRetryDelay(retry, attempt) {
+    let delay;
+    switch (retry.backoff) {
+        case "exponential":
+            delay = retry.initialDelayMs * Math.pow(2, attempt);
+            break;
+        case "linear":
+            delay = retry.initialDelayMs * (attempt + 1);
+            break;
+        case "fixed":
+            delay = retry.initialDelayMs;
+            break;
+    }
+    delay = Math.min(delay, retry.maxDelayMs);
+    if (retry.jitter) {
+        const jitterRange = delay * 0.25;
+        delay += (Math.random() * 2 - 1) * jitterRange;
+    }
+    return Math.max(delay, 0);
+}
+//# sourceMappingURL=result-handler.js.map

package/dist/result-handler.js.map

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

package/dist/schedulers/polling.d.ts

@@ -0,0 +1,46 @@
+import type { HandlerEntry } from "../executor.js";
+import type { Scheduler, SchedulerContext } from "../types.js";
+export interface RetryConfig {
+    maxAttempts: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    backoff: "exponential" | "linear" | "fixed";
+    jitter: boolean;
+    onFailure?: (ctx: {
+        key: string;
+        error: Error;
+        attempts: number;
+    }) => Promise<void>;
+}
+export interface PollingHandlerEntry extends HandlerEntry {
+    retry: RetryConfig;
+}
+export interface PollingSchedulerOptions {
+    /** Polling interval in milliseconds. Default: 1000 (1 second). */
+    interval?: number;
+    /** Stalled job check interval in milliseconds. Default: 30000 (30 seconds). */
+    stalledCheckInterval?: number;
+}
+export declare class PollingScheduler implements Scheduler {
+    private interval;
+    private stalledCheckInterval;
+    private store;
+    private handlers;
+    private _emit;
+    private timer;
+    private stalledTimer;
+    private running;
+    constructor(options?: PollingSchedulerOptions);
+    init(ctx: SchedulerContext): void;
+    schedule(_req: unknown): Promise<string | null>;
+    cancel(_schedulerRef: string): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    private scheduleNextPoll;
+    private poll;
+    private scheduleNextStalledCheck;
+    private sweepStalled;
+    private handleJob;
+    private detectServerless;
+}
+//# sourceMappingURL=polling.d.ts.map

package/dist/schedulers/polling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling.d.ts","sourceRoot":"","sources":["../../src/schedulers/polling.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAiB,MAAM,aAAa,CAAC;AAK9E,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,mBAAoB,SAAQ,YAAY;IACvD,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,gBAAiB,YAAW,SAAS;IAChD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,QAAQ,CAAiD;IACjE,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,YAAY,CAA8C;IAClE,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,CAAC,EAAE,uBAAuB;IAK7C,IAAI,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI;IAM3B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAI/C,MAAM,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAE5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAY3B,OAAO,CAAC,gBAAgB;YAQV,IAAI;IAgBlB,OAAO,CAAC,wBAAwB;YAQlB,YAAY;YA8CZ,SAAS;IAYvB,OAAO,CAAC,gBAAgB;CAiBzB"}

package/dist/schedulers/polling.js

@@ -0,0 +1,148 @@
+import { executeJob } from "../executor.js";
+import { DEFAULT_TIMEOUT_MS, STALLED_GRACE_MS } from "../types.js";
+import { emitStalled } from "../emitter.js";
+import { handleResult, calculateRetryDelay } from "../result-handler.js";
+export class PollingScheduler {
+    interval;
+    stalledCheckInterval;
+    store = null;
+    handlers = null;
+    _emit = null;
+    timer = null;
+    stalledTimer = null;
+    running = false;
+    constructor(options) {
+        this.interval = options?.interval ?? 1_000;
+        this.stalledCheckInterval = options?.stalledCheckInterval ?? 30_000;
+    }
+    init(ctx) {
+        this.store = ctx.store;
+        this.handlers = ctx.handlers;
+        this._emit = ctx.emit;
+    }
+    async schedule(_req) {
+        return null;
+    }
+    async cancel(_schedulerRef) { }
+    async start() {
+        if (this.running)
+            return;
+        this.detectServerless();
+        this.running = true;
+        this.scheduleNextPoll();
+        this.scheduleNextStalledCheck();
+    }
+    async stop() {
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        if (this.stalledTimer) {
+            clearTimeout(this.stalledTimer);
+            this.stalledTimer = null;
+        }
+    }
+    scheduleNextPoll() {
+        if (!this.running)
+            return;
+        this.timer = setTimeout(async () => {
+            await this.poll();
+            this.scheduleNextPoll();
+        }, this.interval);
+    }
+    async poll() {
+        if (!this.handlers || !this.store)
+            return;
+        try {
+            const dueJobs = await this.store.getDueJobs(100);
+            for (const job of dueJobs) {
+                const trigger = { jobId: job.id, version: job.version };
+                this.handleJob(trigger).catch((err) => {
+                    console.error(`[delaykit] Unhandled error processing job ${job.id}:`, err);
+                });
+            }
+        }
+        catch (err) {
+            console.error("[delaykit] PollingScheduler poll error:", err);
+        }
+    }
+    scheduleNextStalledCheck() {
+        if (!this.running)
+            return;
+        this.stalledTimer = setTimeout(async () => {
+            await this.sweepStalled();
+            this.scheduleNextStalledCheck();
+        }, this.stalledCheckInterval);
+    }
+    async sweepStalled() {
+        if (!this.handlers || !this.store)
+            return;
+        try {
+            const timeouts = new Map();
+            for (const [name, entry] of this.handlers) {
+                timeouts.set(name, entry.timeoutMs);
+            }
+            const reclaimed = await this.store.reclaimStalledJobs(timeouts);
+            for (const job of reclaimed) {
+                const entry = this.handlers.get(job.handler);
+                if (!entry)
+                    continue;
+                const timeout = timeouts.get(job.handler) ?? DEFAULT_TIMEOUT_MS;
+                emitStalled(this._emit ?? undefined, job, timeout + STALLED_GRACE_MS);
+                if (job.attempt >= entry.retry.maxAttempts) {
+                    // Exhausted: mark failed + call onFailure
+                    await this.store.markRunning(job.id, job.version);
+                    await this.store.markFailed(job.id, job.version, new Error("Job stalled (process crash or timeout)"));
+                    if (entry.retry.onFailure) {
+                        try {
+                            await entry.retry.onFailure({
+                                key: job.key,
+                                error: new Error("Job stalled (process crash or timeout)"),
+                                attempts: job.attempt,
+                            });
+                        }
+                        catch (e) {
+                            console.error(`[delaykit] onFailure threw for stalled job ${job.id}:`, e);
+                        }
+                    }
+                }
+                else if (job.attempt > 0) {
+                    // Retry reclaim: apply backoff delay.
+                    // Pattern requeues (attempt=0) already have correct scheduledFor from the store.
+                    const delay = calculateRetryDelay(entry.retry, job.attempt - 1);
+                    const nextAt = new Date(Date.now() + delay);
+                    await this.store.updateScheduledFor(job.id, nextAt);
+                }
+            }
+        }
+        catch (err) {
+            console.error("[delaykit] PollingScheduler stalled sweep error:", err);
+        }
+    }
+    async handleJob(trigger) {
+        if (!this.handlers || !this.store)
+            return;
+        const result = await executeJob(trigger, this.store, this.handlers, this._emit ?? undefined);
+        await handleResult(result, {
+            store: this.store,
+            handlers: this.handlers,
+            schedule: this.schedule.bind(this),
+            emit: this._emit ?? undefined,
+        });
+    }
+    detectServerless() {
+        const isVercel = typeof process !== "undefined" && process.env.VERCEL === "1";
+        const isLambda = typeof process !== "undefined" && !!process.env.AWS_LAMBDA_FUNCTION_NAME;
+        if (isVercel || isLambda) {
+            throw new Error([
+                "PollingScheduler cannot run in serverless environments (no long-running process).",
+                "",
+                "Options:",
+                "  1. Use PosthookScheduler for managed scheduling: https://delaykit.dev/vercel",
+                "  2. Run PollingScheduler on a separate VPS with triggerUrl: https://delaykit.dev/split-deploy",
+            ].join("\n"));
+        }
+    }
+}
+//# sourceMappingURL=polling.js.map

package/dist/schedulers/polling.js.map

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