delaykit 0.1.0

package/dist/stores/postgres.js

@@ -0,0 +1,382 @@
+import postgres from "postgres";
+import { randomUUID } from "node:crypto";
+import { DEFAULT_TIMEOUT_MS, STALLED_GRACE_MS } from "../types.js";
+import { MIGRATIONS, SCHEMA } from "./postgres-migrations.js";
+// https://www.postgresql.org/docs/current/errcodes-appendix.html
+const PG_UNIQUE_VIOLATION = "23505";
+const PG_INVALID_TEXT_REPRESENTATION = "22P02";
+export class PostgresStore {
+    sql;
+    constructor(sql) {
+        this.sql = sql;
+    }
+    static async connect(connectionStringOrClient, options) {
+        let sql;
+        if (typeof connectionStringOrClient === "string" || connectionStringOrClient == null) {
+            const resolved = connectionStringOrClient ?? process.env.DELAYKIT_DATABASE_URL;
+            if (!resolved) {
+                throw new Error("Database connection string is required. Pass it as the first argument or set the DELAYKIT_DATABASE_URL environment variable.");
+            }
+            sql = postgres(resolved);
+        }
+        else {
+            sql = connectionStringOrClient;
+        }
+        const store = new PostgresStore(sql);
+        if (options?.runMigrations !== false) {
+            await store.migrate();
+        }
+        return store;
+    }
+    async migrate() {
+        const exists = await this.sql `
+      SELECT 1 FROM information_schema.tables
+      WHERE table_schema = ${SCHEMA} AND table_name = 'migrations'
+    `;
+        let currentVersion = 0;
+        if (exists.length > 0) {
+            const result = await this.sql `
+        SELECT COALESCE(MAX(version), 0) as version FROM delaykit.migrations
+      `;
+            currentVersion = result[0].version;
+        }
+        for (const migration of MIGRATIONS) {
+            if (migration.version > currentVersion) {
+                await this.sql.unsafe(migration.sql);
+            }
+        }
+    }
+    async createJob(job) {
+        const id = job.id || randomUUID();
+        try {
+            const rows = await this.sql `
+        INSERT INTO delaykit.jobs (
+          id, kind, handler, key, version, claimed_version, status,
+          scheduled_for, started_at, completed_at,
+          attempt, max_attempts, scheduler_ref, last_error,
+          first_at, last_at, wait_ms, max_wait_ms
+        ) VALUES (
+          ${id}, ${job.kind}, ${job.handler}, ${job.key},
+          ${job.version}, ${job.claimedVersion}, ${job.status},
+          ${job.scheduledFor}, ${job.startedAt}, ${job.completedAt},
+          ${job.attempt}, ${job.maxAttempts}, ${job.schedulerRef}, ${job.lastError},
+          ${job.firstAt}, ${job.lastAt}, ${job.waitMs}, ${job.maxWaitMs}
+        )
+        RETURNING *
+      `;
+            return this.rowToJob(rows[0]);
+        }
+        catch (err) {
+            if (err.code === PG_UNIQUE_VIOLATION) {
+                throw new Error(`Job with active key "${job.key}" already exists (concurrent insert)`);
+            }
+            throw err;
+        }
+    }
+    async getJob(id) {
+        try {
+            const rows = await this.sql `
+        SELECT * FROM delaykit.jobs WHERE id = ${id}
+      `;
+            return rows.length > 0 ? this.rowToJob(rows[0]) : null;
+        }
+        catch (err) {
+            // Invalid UUID format → treat as not found
+            if (err.code === PG_INVALID_TEXT_REPRESENTATION)
+                return null;
+            throw err;
+        }
+    }
+    async getActiveJobByKey(handler, key) {
+        const rows = await this.sql `
+      SELECT * FROM delaykit.jobs
+      WHERE handler = ${handler} AND key = ${key} AND status IN ('pending', 'running')
+      LIMIT 1
+    `;
+        return rows.length > 0 ? this.rowToJob(rows[0]) : null;
+    }
+    async cancelJob(id) {
+        const result = await this.sql `
+      UPDATE delaykit.jobs
+      SET status = 'cancelled', completed_at = NOW()
+      WHERE id = ${id} AND status = 'pending'
+    `;
+        return result.count > 0;
+    }
+    async updateScheduledFor(id, scheduledFor) {
+        await this.sql `
+      UPDATE delaykit.jobs
+      SET scheduled_for = ${scheduledFor}
+      WHERE id = ${id}
+    `;
+    }
+    async deleteJob(id) {
+        await this.sql `DELETE FROM delaykit.jobs WHERE id = ${id}`;
+    }
+    async updatePatternEvent(key, handler, kind, now, waitMs, maxWaitMs) {
+        const rows = await this.sql `
+      UPDATE delaykit.jobs
+      SET version = version + 1,
+          last_at = ${now},
+          first_at = CASE
+            WHEN status = 'running' AND (first_at IS NULL OR first_at <= started_at)
+            THEN ${now}
+            ELSE first_at
+          END
+      WHERE key = ${key}
+        AND status IN ('pending', 'running')
+        AND kind = ${kind}
+        AND handler = ${handler}
+        AND wait_ms = ${waitMs}
+        AND (max_wait_ms IS NOT DISTINCT FROM ${maxWaitMs})
+      RETURNING *
+    `;
+        if (rows.length === 0) {
+            // Check if mismatch vs missing
+            const existing = await this.getActiveJobByKey(handler, key);
+            if (existing) {
+                if (existing.kind !== kind) {
+                    throw new Error(`Cannot use ${kind} for key "${key}": an active ${existing.kind} job exists for this key.`);
+                }
+                if (existing.handler !== handler) {
+                    throw new Error(`Config mismatch for key "${key}": active job uses handler "${existing.handler}" but "${handler}" was requested.`);
+                }
+                if (existing.waitMs !== waitMs || existing.maxWaitMs !== maxWaitMs) {
+                    throw new Error(`Config mismatch for key "${key}": wait/maxWait does not match active window.`);
+                }
+            }
+            return null;
+        }
+        return this.rowToJob(rows[0]);
+    }
+    async markRunning(id, version) {
+        const rows = await this.sql `
+      UPDATE delaykit.jobs
+      SET status = 'running', started_at = now(), claimed_version = ${version}
+      WHERE id = ${id} AND status = 'pending' AND version = ${version}
+      RETURNING id
+    `;
+        return rows.length > 0;
+    }
+    async markCompleted(id, version) {
+        const rows = await this.sql `
+      UPDATE delaykit.jobs
+      SET status = 'completed', completed_at = now()
+      WHERE id = ${id} AND status = 'running' AND version = ${version}
+      RETURNING id
+    `;
+        return rows.length > 0;
+    }
+    async markFailed(id, version, error) {
+        const rows = await this.sql `
+      UPDATE delaykit.jobs
+      SET status = 'failed', last_error = ${error.message}, completed_at = now()
+      WHERE id = ${id} AND status = 'running' AND version = ${version}
+      RETURNING id
+    `;
+        return rows.length > 0;
+    }
+    async retryJob(id, version, nextAttempt, scheduledFor, lastError) {
+        const rows = await this.sql `
+      UPDATE delaykit.jobs
+      SET status = 'pending', attempt = ${nextAttempt}, scheduled_for = ${scheduledFor},
+          started_at = NULL, completed_at = NULL, claimed_version = NULL,
+          last_error = ${lastError}
+      WHERE id = ${id} AND status = 'running' AND version = ${version}
+      RETURNING id
+    `;
+        return rows.length > 0;
+    }
+    async rescheduleDueAt(id, version) {
+        // Only debounce reschedules (throttle always fires), but formula handles both
+        const rows = await this.sql `
+      UPDATE delaykit.jobs
+      SET version = version + 1,
+          scheduled_for = CASE
+            WHEN kind = 'throttle' THEN first_at + (wait_ms * INTERVAL '1 millisecond')
+            ELSE LEAST(
+              last_at + (wait_ms * INTERVAL '1 millisecond'),
+              CASE WHEN max_wait_ms IS NOT NULL
+                THEN first_at + (max_wait_ms * INTERVAL '1 millisecond')
+                ELSE last_at + (wait_ms * INTERVAL '1 millisecond')
+              END
+            )
+          END
+      WHERE id = ${id} AND status = 'pending' AND version = ${version}
+      RETURNING *
+    `;
+        return rows.length > 0 ? this.rowToJob(rows[0]) : null;
+    }
+    async requeueForNextWindow(id) {
+        const rows = await this.sql `
+      UPDATE delaykit.jobs
+      SET status = 'pending',
+          version = version + 1,
+          started_at = NULL,
+          completed_at = NULL,
+          claimed_version = NULL,
+          attempt = 0,
+          scheduled_for = CASE
+            WHEN kind = 'throttle' THEN first_at + (wait_ms * INTERVAL '1 millisecond')
+            ELSE LEAST(
+              last_at + (wait_ms * INTERVAL '1 millisecond'),
+              CASE WHEN max_wait_ms IS NOT NULL
+                THEN first_at + (max_wait_ms * INTERVAL '1 millisecond')
+                ELSE last_at + (wait_ms * INTERVAL '1 millisecond')
+              END
+            )
+          END
+      WHERE id = ${id} AND status = 'running'
+      RETURNING *
+    `;
+        return rows.length > 0 ? this.rowToJob(rows[0]) : null;
+    }
+    async replaceJob(id, scheduledFor, maxAttempts) {
+        const rows = await this.sql `
+      UPDATE delaykit.jobs
+      SET version = version + 1, scheduled_for = ${scheduledFor}, status = 'pending',
+          attempt = 0, max_attempts = ${maxAttempts}, scheduler_ref = NULL,
+          last_error = NULL, started_at = NULL, completed_at = NULL, claimed_version = NULL
+      WHERE id = ${id} AND status = 'pending'
+      RETURNING *
+    `;
+        return rows.length > 0 ? this.rowToJob(rows[0]) : null;
+    }
+    async updateSchedulerRef(id, version, ref) {
+        const result = await this.sql `
+      UPDATE delaykit.jobs
+      SET scheduler_ref = ${ref}
+      WHERE id = ${id} AND version = ${version}
+    `;
+        return result.count > 0;
+    }
+    async reclaimStalled(id, leaseMs) {
+        // Pattern with version advance: requeue fresh window
+        const requeued = await this.sql `
+      UPDATE delaykit.jobs
+      SET status = 'pending',
+          version = version + 1,
+          attempt = 0,
+          started_at = NULL, completed_at = NULL, claimed_version = NULL,
+          scheduled_for = CASE
+            WHEN kind = 'throttle' THEN first_at + (wait_ms * INTERVAL '1 millisecond')
+            ELSE LEAST(
+              last_at + (wait_ms * INTERVAL '1 millisecond'),
+              CASE WHEN max_wait_ms IS NOT NULL
+                THEN first_at + (max_wait_ms * INTERVAL '1 millisecond')
+                ELSE last_at + (wait_ms * INTERVAL '1 millisecond')
+              END
+            )
+          END
+      WHERE id = ${id} AND status = 'running'
+        AND started_at IS NOT NULL
+        AND started_at + (${leaseMs} * INTERVAL '1 millisecond') < now()
+        AND kind != 'once'
+        AND claimed_version IS NOT NULL
+        AND version > claimed_version
+      RETURNING *
+    `;
+        if (requeued.length > 0)
+            return this.rowToJob(requeued[0]);
+        // Normal reclaim: increment attempt, caller handles exhaustion + onFailure
+        const rows = await this.sql `
+      UPDATE delaykit.jobs
+      SET status = 'pending', attempt = attempt + 1,
+          started_at = NULL, claimed_version = NULL
+      WHERE id = ${id} AND status = 'running'
+        AND started_at IS NOT NULL
+        AND started_at + (${leaseMs} * INTERVAL '1 millisecond') < now()
+      RETURNING *
+    `;
+        return rows.length > 0 ? this.rowToJob(rows[0]) : null;
+    }
+    async reclaimStalledJobs(handlerTimeouts) {
+        const rows = await this.sql `
+      SELECT * FROM delaykit.jobs
+      WHERE status = 'running' AND started_at IS NOT NULL
+    `;
+        const reclaimed = [];
+        const now = Date.now();
+        for (const row of rows) {
+            const job = this.rowToJob(row);
+            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
+                    const requeued = await this.sql `
+            UPDATE delaykit.jobs
+            SET status = 'pending',
+                version = version + 1,
+                started_at = NULL, completed_at = NULL, claimed_version = NULL,
+                attempt = 0,
+                scheduled_for = CASE
+                  WHEN kind = 'throttle' THEN first_at + (wait_ms * INTERVAL '1 millisecond')
+                  ELSE LEAST(
+                    last_at + (wait_ms * INTERVAL '1 millisecond'),
+                    CASE WHEN max_wait_ms IS NOT NULL
+                      THEN first_at + (max_wait_ms * INTERVAL '1 millisecond')
+                      ELSE last_at + (wait_ms * INTERVAL '1 millisecond')
+                    END
+                  )
+                END
+            WHERE id = ${job.id} AND status = 'running'
+            RETURNING *
+          `;
+                    if (requeued.length > 0)
+                        reclaimed.push(this.rowToJob(requeued[0]));
+                }
+                else {
+                    // Reclaim: increment attempt. Caller handles exhaustion + onFailure.
+                    await this.sql `
+            UPDATE delaykit.jobs
+            SET status = 'pending', attempt = attempt + 1,
+                started_at = NULL, claimed_version = NULL
+            WHERE id = ${job.id} AND status = 'running'
+          `;
+                    job.status = "pending";
+                    job.attempt += 1;
+                    job.startedAt = null;
+                    job.claimedVersion = null;
+                    reclaimed.push(job);
+                }
+            }
+        }
+        return reclaimed;
+    }
+    async getDueJobs(limit) {
+        const rows = await this.sql `
+      SELECT * FROM delaykit.jobs
+      WHERE status = 'pending' AND scheduled_for <= now()
+      ORDER BY scheduled_for ASC
+      LIMIT ${limit}
+    `;
+        return rows.map((r) => this.rowToJob(r));
+    }
+    async close() {
+        await this.sql.end();
+    }
+    rowToJob(row) {
+        return {
+            id: row.id,
+            kind: row.kind,
+            handler: row.handler,
+            key: row.key,
+            version: row.version,
+            claimedVersion: row.claimed_version ?? null,
+            status: row.status,
+            scheduledFor: new Date(row.scheduled_for),
+            startedAt: row.started_at ? new Date(row.started_at) : null,
+            completedAt: row.completed_at ? new Date(row.completed_at) : null,
+            attempt: row.attempt,
+            maxAttempts: row.max_attempts,
+            schedulerRef: row.scheduler_ref,
+            lastError: row.last_error,
+            createdAt: new Date(row.created_at),
+            firstAt: row.first_at ? new Date(row.first_at) : null,
+            lastAt: row.last_at ? new Date(row.last_at) : null,
+            waitMs: row.wait_ms,
+            maxWaitMs: row.max_wait_ms,
+        };
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/stores/postgres.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,192 @@
+/**
+ * Job status state machine:
+ *
+ * once:     pending → running → completed | failed
+ * pattern:  pending → running → completed | failed | pending (requeue)
+ * any:      pending → cancelled
+ */
+export type JobStatus = "pending" | "running" | "completed" | "failed" | "cancelled";
+export declare const ACTIVE_STATUSES: ReadonlySet<JobStatus>;
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+export declare const STALLED_GRACE_MS = 5000;
+export interface Job {
+    id: string;
+    kind: "once" | "debounce" | "throttle";
+    handler: string;
+    key: string;
+    version: number;
+    claimedVersion: number | null;
+    status: JobStatus;
+    scheduledFor: Date;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    attempt: number;
+    maxAttempts: number;
+    schedulerRef: string | null;
+    lastError: string | null;
+    createdAt: Date;
+    firstAt: Date | null;
+    lastAt: Date | null;
+    waitMs: number | null;
+    maxWaitMs: number | null;
+}
+export interface ScheduleOptions {
+    key: string;
+    delay?: string;
+    at?: Date;
+    onDuplicate?: "skip" | "replace";
+}
+export interface DebounceOptions {
+    key: string;
+    wait: string;
+    maxWait?: string;
+}
+export interface ThrottleOptions {
+    key: string;
+    wait: string;
+}
+export interface HandlerContext {
+    key: string;
+    job: Job;
+    signal: AbortSignal;
+}
+export type HandlerFn = (ctx: HandlerContext) => Promise<void>;
+export interface RetryConfig {
+    attempts: number;
+    backoff: "exponential" | "linear" | "fixed";
+    initialDelay: string;
+    maxDelay?: string;
+    jitter?: boolean;
+}
+export interface HandlerConfig {
+    handler: HandlerFn;
+    timeout?: string;
+    retry?: RetryConfig;
+    onFailure?: (ctx: {
+        key: string;
+        error: Error;
+        attempts: number;
+    }) => Promise<void>;
+}
+export interface Store {
+    createJob(job: Omit<Job, "createdAt">): Promise<Job>;
+    getJob(id: string): Promise<Job | null>;
+    getActiveJobByKey(handler: string, key: string): Promise<Job | null>;
+    deleteJob(id: string): Promise<void>;
+    cancelJob(id: string): Promise<boolean>;
+    updateScheduledFor(id: string, scheduledFor: Date): 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>;
+    getDueJobs(limit: number): Promise<Job[]>;
+    reclaimStalled(id: string, leaseMs: number): Promise<Job | null>;
+    reclaimStalledJobs(handlerTimeouts: Map<string, number>): Promise<Job[]>;
+    close(): Promise<void>;
+}
+export interface SchedulerRetryConfig {
+    attempts: number;
+    backoff: "exponential" | "linear" | "fixed";
+    initialDelayMs: number;
+    maxDelayMs: number;
+    jitter: boolean;
+}
+export interface ScheduleRequest {
+    id: string;
+    version: number;
+    at: Date;
+    handler: string;
+    key?: string;
+    retry?: SchedulerRetryConfig;
+}
+export interface SchedulerContext {
+    store: Store;
+    handlers: Map<string, {
+        fn: (ctx: HandlerContext) => Promise<void>;
+        timeoutMs: number;
+    }>;
+    emit: EmitFn;
+}
+export interface Scheduler {
+    /** Maximum total attempts this scheduler supports. Omit for unlimited. */
+    maxAttempts?: number;
+    /** Called by DelayKit before start() with shared dependencies. */
+    init?(ctx: SchedulerContext): void;
+    schedule(req: ScheduleRequest): Promise<string | null>;
+    cancel(schedulerRef: string): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Signing key for webhook verification. Set by PosthookScheduler. */
+    signingKey?: string;
+    /** Verify a webhook delivery. Implemented by PosthookScheduler. */
+    verifyDelivery?<T = Record<string, unknown>>(body: string, headers: Headers | Record<string, string | string[] | undefined>): {
+        hookId: string;
+        data: T;
+    };
+}
+export interface JobScheduledEvent {
+    type: "job:scheduled";
+    job: Job;
+    timestamp: Date;
+}
+export interface JobStartedEvent {
+    type: "job:started";
+    job: Job;
+    timestamp: Date;
+    attempt: number;
+}
+export interface JobCompletedEvent {
+    type: "job:completed";
+    job: Job;
+    timestamp: Date;
+    durationMs: number;
+}
+export interface JobFailedEvent {
+    type: "job:failed";
+    job: Job;
+    timestamp: Date;
+    error: Error;
+    attempts: number;
+    durationMs: number;
+}
+export interface JobRetryingEvent {
+    type: "job:retrying";
+    job: Job;
+    timestamp: Date;
+    error: Error;
+    attempt: number;
+    nextAttempt: number;
+    scheduledFor: Date;
+}
+export interface JobCancelledEvent {
+    type: "job:cancelled";
+    job: Job;
+    timestamp: Date;
+}
+export interface JobStalledEvent {
+    type: "job:stalled";
+    job: Job;
+    timestamp: Date;
+    stalledMs: number;
+    reclaimed: boolean;
+}
+export interface JobEventMap {
+    "job:scheduled": JobScheduledEvent;
+    "job:started": JobStartedEvent;
+    "job:completed": JobCompletedEvent;
+    "job:failed": JobFailedEvent;
+    "job:retrying": JobRetryingEvent;
+    "job:cancelled": JobCancelledEvent;
+    "job:stalled": JobStalledEvent;
+}
+export type JobEventType = keyof JobEventMap;
+export type JobEvent = JobEventMap[JobEventType];
+export type JobEventListener<E extends JobEventType> = (event: JobEventMap[E]) => void | Promise<void>;
+/** Typed emit function. Synchronous; listener errors are caught internally. */
+export type EmitFn = <E extends JobEventType>(event: JobEventMap[E]) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,4 @@
+export const ACTIVE_STATUSES = new Set(["pending", "running"]);
+export const DEFAULT_TIMEOUT_MS = 30_000;
+export const STALLED_GRACE_MS = 5_000;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,eAAe,GAA2B,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAEvF,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC"}