delaykit 0.1.0

package/dist/schedulers/posthook.d.ts

@@ -0,0 +1,29 @@
+import type { Scheduler, ScheduleRequest } from "../types.js";
+export interface PosthookSchedulerOptions {
+    /** Posthook API key. */
+    apiKey: string;
+    /** Posthook signing key for webhook verification. */
+    signingKey: string;
+    /** Base path where createHandler() is mounted (e.g., '/api/delaykit').
+     *  Handler name is appended automatically: '/api/delaykit/send-reminder'. */
+    basePath: string;
+    /** Override the Posthook API base URL (for development). */
+    baseURL?: string;
+}
+export declare class PosthookScheduler implements Scheduler {
+    private client;
+    private basePath;
+    readonly signingKey: string;
+    constructor(options: PosthookSchedulerOptions);
+    /** Maximum total attempts Posthook supports (1 initial + 15 retries). */
+    readonly maxAttempts = 16;
+    schedule(req: ScheduleRequest): Promise<string | null>;
+    cancel(schedulerRef: string): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    verifyDelivery<T = Record<string, unknown>>(body: string, headers: Headers | Record<string, string | string[] | undefined>): {
+        hookId: string;
+        data: T;
+    };
+}
+//# sourceMappingURL=posthook.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"posthook.d.ts","sourceRoot":"","sources":["../../src/schedulers/posthook.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAwB,MAAM,aAAa,CAAC;AAEpF,MAAM,WAAW,wBAAwB;IACvC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB;iFAC6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,iBAAkB,YAAW,SAAS;IACjD,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,OAAO,EAAE,wBAAwB;IAS7C,yEAAyE;IACzE,QAAQ,CAAC,WAAW,MAAM;IAEpB,QAAQ,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUtD,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAE3B,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,GAC/D;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,CAAA;KAAE;CAI/B"}

package/dist/schedulers/posthook.js

@@ -0,0 +1,49 @@
+import Posthook from "@posthook/node";
+export class PosthookScheduler {
+    client;
+    basePath;
+    signingKey;
+    constructor(options) {
+        this.client = new Posthook(options.apiKey, {
+            signingKey: options.signingKey,
+            ...(options.baseURL ? { baseURL: options.baseURL } : {}),
+        });
+        this.basePath = options.basePath.replace(/\/+$/, ""); // strip trailing slash
+        this.signingKey = options.signingKey;
+    }
+    /** Maximum total attempts Posthook supports (1 initial + 15 retries). */
+    maxAttempts = 16;
+    async schedule(req) {
+        const hook = await this.client.hooks.schedule({
+            path: `${this.basePath}/${encodeURIComponent(req.handler)}`,
+            postAt: req.at.toISOString(),
+            data: { jobId: req.id, ...(req.key ? { key: req.key } : {}) },
+            ...(req.retry && req.retry.attempts > 1 ? { retryOverride: toPosthookRetry(req.retry) } : {}),
+        });
+        return hook.id;
+    }
+    async cancel(schedulerRef) {
+        await this.client.hooks.delete(schedulerRef);
+    }
+    async start() { }
+    async stop() { }
+    verifyDelivery(body, headers) {
+        const delivery = this.client.signatures.parseDelivery(body, headers);
+        return { hookId: delivery.hookId, data: delivery.data };
+    }
+}
+function toPosthookRetry(retry) {
+    const strategy = retry.backoff === "exponential" ? "exponential" : "fixed";
+    const delaySecs = Math.min(Math.max(5, Math.ceil(retry.initialDelayMs / 1000)), 60);
+    const minRetries = Math.min(retry.attempts - 1, 15);
+    return {
+        minRetries,
+        delaySecs,
+        strategy,
+        jitter: retry.jitter,
+        ...(strategy === "exponential" ? {
+            maxDelaySecs: Math.max(60, Math.min(Math.ceil(retry.maxDelayMs / 1000), 3600)),
+        } : {}),
+    };
+}
+//# sourceMappingURL=posthook.js.map

package/dist/schedulers/posthook.js.map

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

package/dist/stores/memory.d.ts

@@ -0,0 +1,28 @@
+import type { Job, Store } from "../types.js";
+export declare class MemoryStore implements Store {
+    private jobs;
+    private keyIndex;
+    private evictionTimer;
+    constructor();
+    createJob(job: Omit<Job, "createdAt">): Promise<Job>;
+    getJob(id: string): Promise<Job | null>;
+    getActiveJobByKey(handler: string, key: string): Promise<Job | null>;
+    cancelJob(id: string): Promise<boolean>;
+    updateScheduledFor(id: string, scheduledFor: Date): Promise<void>;
+    deleteJob(id: string): Promise<void>;
+    updatePatternEvent(key: string, handler: string, kind: "debounce" | "throttle", now: Date, waitMs: number, maxWaitMs: number | null): Promise<Job | null>;
+    markRunning(id: string, version: number): Promise<boolean>;
+    markCompleted(id: string, version: number): Promise<boolean>;
+    markFailed(id: string, version: number, error: Error): Promise<boolean>;
+    retryJob(id: string, version: number, nextAttempt: number, scheduledFor: Date, lastError: string): Promise<boolean>;
+    rescheduleDueAt(id: string, version: number): Promise<Job | null>;
+    requeueForNextWindow(id: string): Promise<Job | null>;
+    replaceJob(id: string, scheduledFor: Date, maxAttempts: number): Promise<Job | null>;
+    updateSchedulerRef(id: string, version: number, ref: string): Promise<boolean>;
+    reclaimStalled(id: string, leaseMs: number): Promise<Job | null>;
+    reclaimStalledJobs(handlerTimeouts: Map<string, number>): Promise<Job[]>;
+    getDueJobs(limit: number): Promise<Job[]>;
+    close(): Promise<void>;
+    private evictTerminal;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/stores/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/stores/memory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAU9C,qBAAa,WAAY,YAAW,KAAK;IACvC,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,aAAa,CAA+C;;IAM9D,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IAgBpD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAKvC,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAYpE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASvC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpC,kBAAkB,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,UAAU,GAAG,UAAU,EAC7B,GAAG,EAAE,IAAI,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IA2ChB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS1D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5D,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAanH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAUjE,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAerD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAYpF,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO9E,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAwBhE,kBAAkB,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAgCxE,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAczC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B,OAAO,CAAC,aAAa;CAYtB"}

package/dist/stores/memory.js

@@ -0,0 +1,282 @@
+import { ACTIVE_STATUSES, DEFAULT_TIMEOUT_MS, STALLED_GRACE_MS } from "../types.js";
+const EVICTION_INTERVAL = 60_000;
+const EVICTION_AGE = 5 * 60_000;
+function indexKey(handler, key) {
+    return `${handler}\0${key}`;
+}
+export class MemoryStore {
+    jobs = new Map();
+    keyIndex = new Map(); // indexKey(handler, key) → jobId
+    evictionTimer = null;
+    constructor() {
+        this.evictionTimer = setInterval(() => this.evictTerminal(), EVICTION_INTERVAL);
+    }
+    async createJob(job) {
+        const ik = indexKey(job.handler, job.key);
+        const existingId = this.keyIndex.get(ik);
+        if (existingId) {
+            const existing = this.jobs.get(existingId);
+            if (existing && ACTIVE_STATUSES.has(existing.status)) {
+                throw new Error(`Job with active key "${job.key}" already exists (concurrent insert)`);
+            }
+        }
+        const full = { ...job, createdAt: new Date() };
+        this.jobs.set(full.id, full);
+        this.keyIndex.set(ik, full.id);
+        return full;
+    }
+    async getJob(id) {
+        const job = this.jobs.get(id);
+        return job ? { ...job } : null;
+    }
+    async getActiveJobByKey(handler, key) {
+        const ik = indexKey(handler, key);
+        const id = this.keyIndex.get(ik);
+        if (!id)
+            return null;
+        const job = this.jobs.get(id);
+        if (!job || !ACTIVE_STATUSES.has(job.status)) {
+            this.keyIndex.delete(ik);
+            return null;
+        }
+        return { ...job };
+    }
+    async cancelJob(id) {
+        const job = this.jobs.get(id);
+        if (!job || job.status !== "pending")
+            return false;
+        job.status = "cancelled";
+        job.completedAt = new Date();
+        this.keyIndex.delete(indexKey(job.handler, job.key));
+        return true;
+    }
+    async updateScheduledFor(id, scheduledFor) {
+        const job = this.jobs.get(id);
+        if (job)
+            job.scheduledFor = scheduledFor;
+    }
+    async deleteJob(id) {
+        const job = this.jobs.get(id);
+        if (job)
+            this.keyIndex.delete(job.key);
+        this.jobs.delete(id);
+    }
+    async updatePatternEvent(key, handler, kind, now, waitMs, maxWaitMs) {
+        const id = this.keyIndex.get(indexKey(handler, key));
+        if (!id)
+            return null;
+        const job = this.jobs.get(id);
+        if (!job || !ACTIVE_STATUSES.has(job.status))
+            return null;
+        // Validate frozen config
+        if (job.kind !== kind) {
+            throw new Error(`Cannot use ${kind} for key "${key}": an active ${job.kind} job exists for this key.`);
+        }
+        if (job.handler !== handler) {
+            throw new Error(`Config mismatch for key "${key}": active job uses handler "${job.handler}" but "${handler}" was requested.`);
+        }
+        if (job.waitMs !== waitMs) {
+            throw new Error(`Config mismatch for key "${key}": active job uses wait=${job.waitMs}ms but ${waitMs}ms was requested.`);
+        }
+        if (job.maxWaitMs !== maxWaitMs) {
+            throw new Error(`Config mismatch for key "${key}": active job uses maxWait=${job.maxWaitMs}ms but ${maxWaitMs}ms was requested.`);
+        }
+        job.version += 1;
+        job.lastAt = now;
+        if (job.status === "running") {
+            // Only reset firstAt on the FIRST event after execution started.
+            // Subsequent events during the same execution just update lastAt.
+            // This keeps throttle windows anchored and debounce maxWait stable.
+            if (!job.startedAt || job.firstAt.getTime() <= job.startedAt.getTime()) {
+                job.firstAt = now;
+            }
+        }
+        return { ...job };
+    }
+    async markRunning(id, version) {
+        const job = this.jobs.get(id);
+        if (!job || job.status !== "pending" || job.version !== version)
+            return false;
+        job.status = "running";
+        job.claimedVersion = version;
+        job.startedAt = new Date();
+        return true;
+    }
+    async markCompleted(id, version) {
+        const job = this.jobs.get(id);
+        if (!job || job.status !== "running" || job.version !== version)
+            return false;
+        job.status = "completed";
+        job.completedAt = new Date();
+        this.keyIndex.delete(indexKey(job.handler, job.key));
+        return true;
+    }
+    async markFailed(id, version, error) {
+        const job = this.jobs.get(id);
+        if (!job || job.status !== "running" || job.version !== version)
+            return false;
+        job.status = "failed";
+        job.lastError = error.message;
+        job.completedAt = new Date();
+        this.keyIndex.delete(indexKey(job.handler, job.key));
+        return true;
+    }
+    async retryJob(id, version, nextAttempt, scheduledFor, lastError) {
+        const job = this.jobs.get(id);
+        if (!job || job.status !== "running" || job.version !== version)
+            return false;
+        job.status = "pending";
+        job.attempt = nextAttempt;
+        job.scheduledFor = scheduledFor;
+        job.startedAt = null;
+        job.completedAt = null;
+        job.claimedVersion = null;
+        job.lastError = lastError;
+        return true;
+    }
+    async rescheduleDueAt(id, version) {
+        const job = this.jobs.get(id);
+        if (!job || job.status !== "pending" || job.version !== version)
+            return null;
+        if (!job.lastAt || !job.waitMs)
+            return null;
+        job.scheduledFor = computePatternDueAt(job);
+        job.version += 1;
+        return { ...job };
+    }
+    async requeueForNextWindow(id) {
+        const job = this.jobs.get(id);
+        if (!job || job.status !== "running")
+            return null;
+        if (!job.lastAt || !job.waitMs)
+            return null;
+        job.status = "pending";
+        job.scheduledFor = computePatternDueAt(job);
+        job.startedAt = null;
+        job.completedAt = null;
+        job.claimedVersion = null;
+        job.attempt = 0;
+        job.version += 1;
+        return { ...job };
+    }
+    async replaceJob(id, scheduledFor, maxAttempts) {
+        const job = this.jobs.get(id);
+        if (!job || job.status !== "pending")
+            return null;
+        job.version += 1;
+        job.scheduledFor = scheduledFor;
+        job.attempt = 0;
+        job.maxAttempts = maxAttempts;
+        job.schedulerRef = null;
+        job.lastError = null;
+        return { ...job };
+    }
+    async updateSchedulerRef(id, version, ref) {
+        const job = this.jobs.get(id);
+        if (!job || job.version !== version)
+            return false;
+        job.schedulerRef = ref;
+        return true;
+    }
+    async reclaimStalled(id, leaseMs) {
+        const job = this.jobs.get(id);
+        if (!job || job.status !== "running" || !job.startedAt)
+            return null;
+        if (Date.now() - job.startedAt.getTime() <= leaseMs)
+            return null;
+        if (job.kind !== "once" && job.claimedVersion != null && job.version > job.claimedVersion) {
+            // Pattern with version advance: requeue fresh window
+            job.status = "pending";
+            job.scheduledFor = computePatternDueAt(job);
+            job.startedAt = null;
+            job.completedAt = null;
+            job.claimedVersion = null;
+            job.attempt = 0;
+            job.version += 1;
+        }
+        else {
+            // Reclaim: increment attempt, set pending. Caller decides if exhausted.
+            job.status = "pending";
+            job.attempt += 1;
+            job.startedAt = null;
+            job.claimedVersion = null;
+        }
+        return { ...job };
+    }
+    async reclaimStalledJobs(handlerTimeouts) {
+        const reclaimed = [];
+        const now = Date.now();
+        for (const job of this.jobs.values()) {
+            if (job.status !== "running" || !job.startedAt)
+                continue;
+            const timeout = handlerTimeouts.get(job.handler) ?? DEFAULT_TIMEOUT_MS;
+            if (now - job.startedAt.getTime() > timeout + STALLED_GRACE_MS) {
+                if (job.kind !== "once" && job.claimedVersion != null && job.version > job.claimedVersion) {
+                    // Pattern with version advance: requeue fresh window
+                    job.status = "pending";
+                    job.scheduledFor = computePatternDueAt(job);
+                    job.startedAt = null;
+                    job.completedAt = null;
+                    job.claimedVersion = null;
+                    job.attempt = 0;
+                    job.version += 1;
+                    reclaimed.push({ ...job });
+                }
+                else {
+                    // Reclaim: increment attempt, set pending. Caller handles exhaustion + onFailure.
+                    job.status = "pending";
+                    job.attempt += 1;
+                    job.startedAt = null;
+                    job.claimedVersion = null;
+                    reclaimed.push({ ...job });
+                }
+            }
+        }
+        return reclaimed;
+    }
+    async getDueJobs(limit) {
+        const now = new Date();
+        const due = [];
+        for (const job of this.jobs.values()) {
+            if (job.status === "pending" && job.scheduledFor <= now) {
+                due.push(job);
+            }
+        }
+        due.sort((a, b) => a.scheduledFor.getTime() - b.scheduledFor.getTime());
+        return due.slice(0, limit);
+    }
+    async close() {
+        if (this.evictionTimer) {
+            clearInterval(this.evictionTimer);
+            this.evictionTimer = null;
+        }
+        this.jobs.clear();
+        this.keyIndex.clear();
+    }
+    evictTerminal() {
+        const cutoff = Date.now() - EVICTION_AGE;
+        for (const [id, job] of this.jobs) {
+            if (!ACTIVE_STATUSES.has(job.status) &&
+                job.completedAt &&
+                job.completedAt.getTime() < cutoff) {
+                this.jobs.delete(id);
+            }
+        }
+    }
+}
+function computePatternDueAt(job) {
+    if (job.kind === "throttle") {
+        // Throttle: fixed window from first event of the burst
+        return new Date(job.firstAt.getTime() + job.waitMs);
+    }
+    // Debounce: sliding window from last event, capped by maxWait
+    let nextAt = new Date(job.lastAt.getTime() + job.waitMs);
+    if (job.maxWaitMs != null && job.firstAt) {
+        const deadline = new Date(job.firstAt.getTime() + job.maxWaitMs);
+        if (nextAt.getTime() > deadline.getTime()) {
+            nextAt = deadline;
+        }
+    }
+    return nextAt;
+}
+//# sourceMappingURL=memory.js.map

package/dist/stores/memory.js.map

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

package/dist/stores/postgres-migrations.d.ts

@@ -0,0 +1,6 @@
+export declare const SCHEMA = "delaykit";
+export declare const MIGRATIONS: {
+    version: number;
+    sql: string;
+}[];
+//# sourceMappingURL=postgres-migrations.d.ts.map

package/dist/stores/postgres-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-migrations.d.ts","sourceRoot":"","sources":["../../src/stores/postgres-migrations.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,aAAa,CAAC;AAEjC,eAAO,MAAM,UAAU;;;GA8DtB,CAAC"}

package/dist/stores/postgres-migrations.js

@@ -0,0 +1,65 @@
+export const SCHEMA = "delaykit";
+export const MIGRATIONS = [
+    {
+        version: 1,
+        sql: `
+      CREATE SCHEMA IF NOT EXISTS delaykit;
+
+      CREATE TABLE IF NOT EXISTS delaykit.jobs (
+        id              UUID PRIMARY KEY,
+        kind            TEXT NOT NULL DEFAULT 'once',
+        handler         TEXT NOT NULL,
+        key             TEXT NOT NULL,
+        version         INT NOT NULL DEFAULT 1,
+        claimed_version INT,
+        status          TEXT NOT NULL DEFAULT 'pending',
+        scheduled_for   TIMESTAMPTZ NOT NULL,
+        started_at      TIMESTAMPTZ,
+        completed_at    TIMESTAMPTZ,
+        attempt         INT NOT NULL DEFAULT 0,
+        max_attempts    INT NOT NULL DEFAULT 1,
+        scheduler_ref   TEXT,
+        last_error      TEXT,
+        created_at      TIMESTAMPTZ NOT NULL DEFAULT now(),
+        first_at        TIMESTAMPTZ,
+        last_at         TIMESTAMPTZ,
+        wait_ms         INT,
+        max_wait_ms     INT
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_jobs_status_scheduled
+        ON delaykit.jobs (scheduled_for)
+        WHERE status = 'pending';
+
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_jobs_key_active
+        ON delaykit.jobs (handler, key)
+        WHERE status IN ('pending', 'running');
+
+      CREATE INDEX IF NOT EXISTS idx_jobs_status_running
+        ON delaykit.jobs (started_at)
+        WHERE status = 'running';
+
+      CREATE TABLE IF NOT EXISTS delaykit.migrations (
+        version INT PRIMARY KEY,
+        applied_at TIMESTAMPTZ NOT NULL DEFAULT now()
+      );
+
+      INSERT INTO delaykit.migrations (version) VALUES (1) ON CONFLICT DO NOTHING;
+    `,
+    },
+    {
+        version: 2,
+        sql: `
+      -- Scope active-job uniqueness to (handler, key) instead of just (key).
+      -- This allows different handlers to use the same key concurrently.
+      DROP INDEX IF EXISTS delaykit.idx_jobs_key_active;
+
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_jobs_key_active
+        ON delaykit.jobs (handler, key)
+        WHERE status IN ('pending', 'running');
+
+      INSERT INTO delaykit.migrations (version) VALUES (2) ON CONFLICT DO NOTHING;
+    `,
+    },
+];
+//# sourceMappingURL=postgres-migrations.js.map

package/dist/stores/postgres-migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-migrations.js","sourceRoot":"","sources":["../../src/stores/postgres-migrations.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,CAAC;AAEjC,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB;QACE,OAAO,EAAE,CAAC;QACV,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2CJ;KACF;IACD;QACE,OAAO,EAAE,CAAC;QACV,GAAG,EAAE;;;;;;;;;;KAUJ;KACF;CACF,CAAC"}

package/dist/stores/postgres.d.ts

@@ -0,0 +1,32 @@
+import postgres from "postgres";
+import type { Job, Store } from "../types.js";
+export interface PostgresStoreOptions {
+    runMigrations?: boolean;
+}
+export declare class PostgresStore implements Store {
+    private sql;
+    private constructor();
+    static connect(connectionStringOrClient?: string | postgres.Sql, options?: PostgresStoreOptions): Promise<PostgresStore>;
+    private migrate;
+    createJob(job: Omit<Job, "createdAt">): Promise<Job>;
+    getJob(id: string): Promise<Job | null>;
+    getActiveJobByKey(handler: string, key: string): Promise<Job | null>;
+    cancelJob(id: string): Promise<boolean>;
+    updateScheduledFor(id: string, scheduledFor: Date): Promise<void>;
+    deleteJob(id: string): Promise<void>;
+    updatePatternEvent(key: string, handler: string, kind: "debounce" | "throttle", now: Date, waitMs: number, maxWaitMs: number | null): Promise<Job | null>;
+    markRunning(id: string, version: number): Promise<boolean>;
+    markCompleted(id: string, version: number): Promise<boolean>;
+    markFailed(id: string, version: number, error: Error): Promise<boolean>;
+    retryJob(id: string, version: number, nextAttempt: number, scheduledFor: Date, lastError: string): Promise<boolean>;
+    rescheduleDueAt(id: string, version: number): Promise<Job | null>;
+    requeueForNextWindow(id: string): Promise<Job | null>;
+    replaceJob(id: string, scheduledFor: Date, maxAttempts: number): Promise<Job | null>;
+    updateSchedulerRef(id: string, version: number, ref: string): Promise<boolean>;
+    reclaimStalled(id: string, leaseMs: number): Promise<Job | null>;
+    reclaimStalledJobs(handlerTimeouts: Map<string, number>): Promise<Job[]>;
+    getDueJobs(limit: number): Promise<Job[]>;
+    close(): Promise<void>;
+    private rowToJob;
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/stores/postgres.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../src/stores/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAEhC,OAAO,KAAK,EAAE,GAAG,EAAa,KAAK,EAAE,MAAM,aAAa,CAAC;AAQzD,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,qBAAa,aAAc,YAAW,KAAK;IACzC,OAAO,CAAC,GAAG,CAAe;IAE1B,OAAO;WAIM,OAAO,CAClB,wBAAwB,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC,GAAG,EAChD,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,aAAa,CAAC;YAsBX,OAAO;IAqBf,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;IA2BpD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAavC,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IASpE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASvC,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjE,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpC,kBAAkB,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,UAAU,GAAG,UAAU,EAC7B,GAAG,EAAE,IAAI,EACT,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAAG,IAAI,GACvB,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAqChB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU1D,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAU5D,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAUvE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAYnH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAqBjE,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAyBrD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAYpF,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS9E,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC;IAyChE,kBAAkB,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAwDxE,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAUzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,QAAQ;CAuBjB"}