pipework 0.8.6 → 0.8.8

package/dist/jobs/execute.js

@@ -0,0 +1,19 @@
+import { runInContext } from '../context/store.js';
+import { createJobContext } from '../context/create.js';
+import { resolveAndExecute } from '../di/resolve.js';
+export async function executeJob(handler, options) {
+    const jobCtxOptions = {
+        instance: options.instance,
+    };
+    if (options.jobId !== undefined)
+        jobCtxOptions.jobId = options.jobId;
+    if (options.jobType !== undefined)
+        jobCtxOptions.jobType = options.jobType;
+    if (options.auth !== undefined)
+        jobCtxOptions.auth = options.auth;
+    if (options.tenant !== undefined)
+        jobCtxOptions.tenant = options.tenant;
+    const ctx = createJobContext(jobCtxOptions);
+    return runInContext(ctx, () => resolveAndExecute(handler, options.input));
+}
+//# sourceMappingURL=execute.js.map

package/dist/jobs/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../src/jobs/execute.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAWpD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,OAAgC,EAChC,OAA0B;IAE1B,MAAM,aAAa,GAA2C;QAC5D,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAA;IACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;QAAE,aAAa,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;IACpE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS;QAAE,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAA;IAC1E,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,aAAa,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAA;IACjE,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS;QAAE,aAAa,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAEvE,MAAM,GAAG,GAAG,gBAAgB,CAAC,aAAa,CAAC,CAAA;IAC3C,OAAO,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,CAAA;AAC3E,CAAC"}

package/dist/jobs/index.d.ts

@@ -0,0 +1,8 @@
+export { executeJob } from './execute.js';
+export { createQueue } from './queue.js';
+export type { Queue, QueueConfig, EnqueueOptions, ClaimedJob, JobResult, BackoffConfig } from './queue.js';
+export type { WaitOptions, WaitResult, ListenClient, ListenHandle } from './listener.js';
+export { parseCron, nextTick } from './cron.js';
+export type { CronSchedule } from './cron.js';
+export type { ScheduleSpec, ScheduleInfo, SchedulerOptions } from './scheduler.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC1G,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACxF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAC/C,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/jobs/index.js

@@ -0,0 +1,4 @@
+export { executeJob } from './execute.js';
+export { createQueue } from './queue.js';
+export { parseCron, nextTick } from './cron.js';
+//# sourceMappingURL=index.js.map

package/dist/jobs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/jobs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA"}

package/dist/jobs/listener.d.ts

@@ -0,0 +1,32 @@
+import type { DB } from '../db/index.js';
+export interface WaitOptions {
+    readonly timeoutMs: number;
+}
+export interface WaitResult {
+    readonly jobId: string;
+    readonly status: 'completed' | 'failed' | 'dead_letter' | 'cancelled' | 'timeout';
+    readonly output?: unknown;
+    readonly error?: unknown;
+}
+export interface ListenHandle {
+    unlisten(): Promise<void>;
+}
+export interface ListenClient {
+    listen(channel: string, cb: (payload: string) => void): Promise<ListenHandle>;
+}
+export declare class JobListener {
+    private readonly channel;
+    private readonly tableQ;
+    private readonly waiters;
+    private handle;
+    private listening;
+    constructor(channel: string, tableQ: string);
+    start(client: ListenClient): Promise<void>;
+    stop(): Promise<void>;
+    get isListening(): boolean;
+    waitFor(db: DB, jobId: string, opts: WaitOptions): Promise<WaitResult>;
+    private dispatch;
+    pollJob(db: DB, jobId: string): Promise<WaitResult | null>;
+    private pollUntil;
+}
+//# sourceMappingURL=listener.d.ts.map

package/dist/jobs/listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../../src/jobs/listener.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AAExC,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAA;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CAC9E;AAQD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,SAAS,CAAQ;gBAEb,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAKrC,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B,IAAI,WAAW,IAAI,OAAO,CAEzB;IAEK,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IA0B5E,OAAO,CAAC,QAAQ;IAWV,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;YAgBlD,SAAS;CAUxB"}

package/dist/jobs/listener.js

@@ -0,0 +1,95 @@
+import { sql } from '../db/sql.js';
+export class JobListener {
+    channel;
+    tableQ;
+    waiters = new Map();
+    handle = null;
+    listening = false;
+    constructor(channel, tableQ) {
+        this.channel = channel;
+        this.tableQ = tableQ;
+    }
+    async start(client) {
+        if (this.listening)
+            return;
+        this.handle = await client.listen(this.channel, (payload) => {
+            this.dispatch(payload);
+        });
+        this.listening = true;
+    }
+    async stop() {
+        if (!this.listening || !this.handle)
+            return;
+        await this.handle.unlisten();
+        this.handle = null;
+        this.listening = false;
+        for (const [jobId, waiter] of this.waiters) {
+            clearTimeout(waiter.timer);
+            waiter.resolve({ jobId, status: 'timeout' });
+        }
+        this.waiters.clear();
+    }
+    get isListening() {
+        return this.listening;
+    }
+    async waitFor(db, jobId, opts) {
+        if (!this.listening) {
+            const existing = await this.pollJob(db, jobId);
+            if (existing !== null)
+                return existing;
+            return this.pollUntil(db, jobId, opts.timeoutMs);
+        }
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                this.waiters.delete(jobId);
+                resolve({ jobId, status: 'timeout' });
+            }, opts.timeoutMs);
+            const waiter = { resolve, timer, db };
+            this.waiters.set(jobId, waiter);
+            void this.pollJob(db, jobId).then((result) => {
+                if (result !== null && this.waiters.has(jobId)) {
+                    this.waiters.delete(jobId);
+                    clearTimeout(timer);
+                    resolve(result);
+                }
+            });
+        });
+    }
+    dispatch(jobId) {
+        const waiter = this.waiters.get(jobId);
+        if (!waiter)
+            return;
+        this.waiters.delete(jobId);
+        clearTimeout(waiter.timer);
+        void this.pollJob(waiter.db, jobId).then((result) => {
+            waiter.resolve(result ?? { jobId, status: 'completed' });
+        });
+    }
+    async pollJob(db, jobId) {
+        const rows = await db.execute(sql `SELECT status, output, error_payload FROM ${sql.raw(this.tableQ)} WHERE id = ${jobId}::uuid`);
+        if (rows.length === 0)
+            return null;
+        const row = rows[0];
+        const status = row['status'];
+        if (status === 'pending' || status === 'claimed' || status === 'running')
+            return null;
+        return {
+            jobId,
+            status: status,
+            output: row['output'] ?? undefined,
+            error: row['error_payload'] ?? undefined,
+        };
+    }
+    async pollUntil(db, jobId, timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        const interval = 500;
+        while (Date.now() < deadline) {
+            const result = await this.pollJob(db, jobId);
+            if (result !== null)
+                return result;
+            await new Promise(r => setTimeout(r, Math.min(interval, deadline - Date.now())));
+        }
+        return { jobId, status: 'timeout' };
+    }
+}
+//# sourceMappingURL=listener.js.map

package/dist/jobs/listener.js.map

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

package/dist/jobs/namespace.d.ts

@@ -0,0 +1,15 @@
+import { createQueue } from './queue.js';
+import { executeJob } from './execute.js';
+import { parseCron, nextTick } from './cron.js';
+/** Background job queue namespace — Postgres-backed with SKIP LOCKED, LISTEN/NOTIFY, cron scheduling. */
+export declare const jobs: {
+    /** Creates a job queue with claim/complete/fail lifecycle, heartbeat, and dead letter requeue. */
+    createQueue: typeof createQueue;
+    /** Executes a fitting handler as a background job with its own Flow context. */
+    execute: typeof executeJob;
+    /** Parses a 5-field cron expression into a CronSchedule (minute, hour, dom, month, dow). */
+    parseCron: typeof parseCron;
+    /** Computes the next fire time for a CronSchedule after a given date, with optional timezone. */
+    nextTick: typeof nextTick;
+};
+//# sourceMappingURL=namespace.d.ts.map

package/dist/jobs/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/jobs/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAE/C,yGAAyG;AACzG,eAAO,MAAM,IAAI;IACf,kGAAkG;;IAElG,gFAAgF;;IAEhF,4FAA4F;;IAE5F,iGAAiG;;CAElG,CAAA"}

package/dist/jobs/namespace.js

@@ -0,0 +1,15 @@
+import { createQueue } from './queue.js';
+import { executeJob } from './execute.js';
+import { parseCron, nextTick } from './cron.js';
+/** Background job queue namespace — Postgres-backed with SKIP LOCKED, LISTEN/NOTIFY, cron scheduling. */
+export const jobs = {
+    /** Creates a job queue with claim/complete/fail lifecycle, heartbeat, and dead letter requeue. */
+    createQueue,
+    /** Executes a fitting handler as a background job with its own Flow context. */
+    execute: executeJob,
+    /** Parses a 5-field cron expression into a CronSchedule (minute, hour, dom, month, dow). */
+    parseCron,
+    /** Computes the next fire time for a CronSchedule after a given date, with optional timezone. */
+    nextTick,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/jobs/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/jobs/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAE/C,yGAAyG;AACzG,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,kGAAkG;IAClG,WAAW;IACX,gFAAgF;IAChF,OAAO,EAAE,UAAU;IACnB,4FAA4F;IAC5F,SAAS;IACT,iGAAiG;IACjG,QAAQ;CACT,CAAA"}

package/dist/jobs/queue.d.ts

@@ -0,0 +1,58 @@
+import type { DB } from '../db/index.js';
+import type { ListenClient, WaitOptions, WaitResult } from './listener.js';
+import type { ScheduleSpec, ScheduleInfo, SchedulerOptions } from './scheduler.js';
+export interface BackoffConfig {
+    readonly type: 'exponential' | 'fixed';
+    readonly delayMs: number;
+    readonly maxDelayMs?: number;
+}
+/** Queue configuration — table name, stale timeout, max attempts, backoff strategy. */
+export interface QueueConfig {
+    readonly table?: string;
+    readonly staleTimeoutMs?: number;
+    readonly notifyChannel?: string;
+    readonly claimFilter?: (candidateAlias: string) => string;
+    readonly maxAttempts?: number;
+    readonly backoff?: BackoffConfig;
+}
+/** Options for enqueuing a job — type, payload, priority, max attempts. */
+export interface EnqueueOptions {
+    readonly type: string;
+    readonly priority?: number;
+    readonly payload: unknown;
+    readonly maxAttempts?: number;
+}
+/** A job claimed by a worker — includes ID, type, payload, and created LSN. */
+export interface ClaimedJob {
+    readonly id: string;
+    readonly type: string;
+    readonly payload: unknown;
+    readonly createdLsn: string;
+}
+export interface JobResult {
+    readonly status: 'completed' | 'failed' | 'cancelled' | 'timeout' | 'dead_letter';
+    readonly output?: unknown;
+    readonly error?: unknown;
+}
+/** Job queue instance with claim/complete/fail lifecycle, LISTEN/NOTIFY, and cron scheduling. */
+export interface Queue {
+    enqueue(db: DB, opts: EnqueueOptions): Promise<string>;
+    claim(db: DB, workerId: string): Promise<ClaimedJob | null>;
+    heartbeat(db: DB, jobId: string): Promise<void>;
+    complete(db: DB, jobId: string, output?: unknown): Promise<void>;
+    fail(db: DB, jobId: string, error: unknown): Promise<void>;
+    cancel(db: DB, jobId: string): Promise<void>;
+    reap(db: DB): Promise<number>;
+    requeueDeadLetter(db: DB, jobId: string): Promise<void>;
+    startListener(client: ListenClient): Promise<void>;
+    stopListener(): Promise<void>;
+    waitFor(db: DB, jobId: string, opts: WaitOptions): Promise<WaitResult>;
+    enqueueAndWait(db: DB, opts: EnqueueOptions, waitOpts: WaitOptions): Promise<WaitResult>;
+    schedule(db: DB, spec: ScheduleSpec): Promise<void>;
+    unschedule(db: DB, name: string): Promise<boolean>;
+    listSchedules(db: DB): Promise<ScheduleInfo[]>;
+    startScheduler(db: DB, opts?: SchedulerOptions): void;
+    stopScheduler(): void;
+}
+export declare function createQueue(config?: QueueConfig): Queue;
+//# sourceMappingURL=queue.d.ts.map

package/dist/jobs/queue.d.ts.map

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

package/dist/jobs/queue.js

@@ -0,0 +1,163 @@
+import { sql } from '../db/sql.js';
+import { assertValidIdentifier, quoteIdentifier } from '../db/identifiers.js';
+import { JobListener } from './listener.js';
+import { createScheduler } from './scheduler.js';
+export function createQueue(config = {}) {
+    const table = config.table ?? 'pipework_jobs';
+    const staleTimeoutMs = config.staleTimeoutMs ?? 120_000;
+    const channel = config.notifyChannel ?? 'pipework_job_complete';
+    const maxAttempts = config.maxAttempts ?? 1;
+    const backoff = config.backoff;
+    assertValidIdentifier(table, 'queue table');
+    assertValidIdentifier(channel, 'notify channel');
+    const tableQ = quoteIdentifier(table, 'queue table');
+    const listener = new JobListener(channel, tableQ);
+    async function enqueue(db, opts) {
+        const priority = opts.priority ?? 0;
+        const payload = JSON.stringify(opts.payload);
+        const attempts = opts.maxAttempts ?? maxAttempts;
+        const rows = await db.execute(sql `INSERT INTO ${sql.raw(tableQ)} (job_type, priority, payload, max_attempts)
+               VALUES (${opts.type}, ${priority}, ${payload}::jsonb, ${attempts})
+               RETURNING id::text`);
+        return rows[0]['id'];
+    }
+    async function claim(db, workerId) {
+        const maxRetries = 3;
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            try {
+                const claimFilterClause = config.claimFilter
+                    ? sql ` AND (${sql.raw(config.claimFilter(table))})`
+                    : sql ``;
+                const rows = await db.execute(sql `
+          UPDATE ${sql.raw(tableQ)} SET
+            status = 'claimed',
+            claimed_at = now(),
+            heartbeat_at = now(),
+            worker_id = ${workerId}
+          WHERE id = (
+            SELECT id FROM ${sql.raw(tableQ)}
+            WHERE status = 'pending' AND (next_retry_at IS NULL OR next_retry_at <= now())${claimFilterClause}
+            ORDER BY priority DESC, queued_at ASC
+            FOR UPDATE SKIP LOCKED
+            LIMIT 1
+          )
+          RETURNING id::text, job_type, payload, created_lsn::text`);
+                if (rows.length === 0)
+                    return null;
+                const row = rows[0];
+                return {
+                    id: row['id'],
+                    type: row['job_type'],
+                    payload: row['payload'],
+                    createdLsn: row['created_lsn'],
+                };
+            }
+            catch (err) {
+                const code = err.code;
+                if ((code === '40001' || code === '40P01') && attempt < maxRetries - 1) {
+                    continue;
+                }
+                throw err;
+            }
+        }
+        return null;
+    }
+    async function heartbeat(db, jobId) {
+        await db.execute(sql `UPDATE ${sql.raw(tableQ)} SET heartbeat_at = now() WHERE id = ${jobId}::uuid`);
+    }
+    async function complete(db, jobId, output) {
+        const outputJson = output !== undefined ? JSON.stringify(output) : null;
+        await db.execute(sql `UPDATE ${sql.raw(tableQ)} SET status = 'completed', completed_at = now(), output = ${outputJson !== null ? sql `${outputJson}::jsonb` : sql `NULL`}
+               WHERE id = ${jobId}::uuid`);
+        await db.execute(sql `SELECT pg_notify(${channel}, ${jobId})`);
+    }
+    function calculateDelay(attemptCount) {
+        if (!backoff)
+            return 0;
+        if (backoff.type === 'fixed')
+            return backoff.delayMs;
+        const delay = backoff.delayMs * Math.pow(2, attemptCount);
+        return backoff.maxDelayMs !== undefined ? Math.min(delay, backoff.maxDelayMs) : delay;
+    }
+    async function fail(db, jobId, error) {
+        const errorJson = JSON.stringify(error instanceof Error ? { message: error.message, stack: error.stack } : error);
+        const jobRows = await db.execute(sql `SELECT attempt_count, max_attempts FROM ${sql.raw(tableQ)} WHERE id = ${jobId}::uuid`);
+        const job = jobRows[0];
+        if (!job) {
+            throw new Error(`[pipework] Cannot fail job "${jobId}" — job not found.`);
+        }
+        const attemptCount = job['attempt_count'];
+        const jobMaxAttempts = job['max_attempts'];
+        const nextAttempt = attemptCount + 1;
+        if (nextAttempt < jobMaxAttempts) {
+            const delayMs = calculateDelay(attemptCount);
+            const delaySeconds = `${Math.ceil(delayMs / 1000)} seconds`;
+            await db.execute(sql `UPDATE ${sql.raw(tableQ)} SET
+              status = 'pending',
+              attempt_count = ${nextAttempt},
+              next_retry_at = ${delayMs > 0 ? sql `now() + ${delaySeconds}::interval` : sql `NULL`},
+              error_payload = ${errorJson}::jsonb,
+              claimed_at = NULL,
+              heartbeat_at = NULL,
+              worker_id = NULL
+            WHERE id = ${jobId}::uuid`);
+        }
+        else {
+            await db.execute(sql `UPDATE ${sql.raw(tableQ)} SET
+              status = 'dead_letter',
+              attempt_count = ${nextAttempt},
+              completed_at = now(),
+              error_payload = ${errorJson}::jsonb
+            WHERE id = ${jobId}::uuid`);
+            await db.execute(sql `SELECT pg_notify(${channel}, ${jobId})`);
+        }
+    }
+    async function cancel(db, jobId) {
+        await db.execute(sql `UPDATE ${sql.raw(tableQ)} SET status = 'cancelled', completed_at = now()
+               WHERE id = ${jobId}::uuid AND status IN ('pending', 'claimed')`);
+    }
+    async function reap(db) {
+        const staleInterval = `${Math.floor(staleTimeoutMs / 1000)} seconds`;
+        const rows = await db.execute(sql `UPDATE ${sql.raw(tableQ)} SET status = 'failed', completed_at = now(),
+                 error_payload = ${'{"message":"reaped: heartbeat timeout"}'}::jsonb
+               WHERE status IN ('claimed', 'running')
+                 AND heartbeat_at < now() - ${staleInterval}::interval
+               RETURNING id`);
+        return rows.length;
+    }
+    async function requeueDeadLetter(db, jobId) {
+        const rows = await db.execute(sql `UPDATE ${sql.raw(tableQ)} SET
+          status = 'pending', attempt_count = 0, max_attempts = ${maxAttempts},
+          completed_at = NULL, next_retry_at = NULL, claimed_at = NULL,
+          heartbeat_at = NULL, worker_id = NULL
+        WHERE id = ${jobId}::uuid AND status = 'dead_letter'
+        RETURNING id`);
+        if (rows.length === 0) {
+            throw new Error(`[pipework] Cannot requeue job "${jobId}" — job not found or not in dead_letter status.`);
+        }
+    }
+    async function startListener(client) {
+        await listener.start(client);
+    }
+    async function stopListener() {
+        await listener.stop();
+    }
+    async function waitFor(db, jobId, opts) {
+        return listener.waitFor(db, jobId, opts);
+    }
+    async function enqueueAndWait(db, opts, waitOpts) {
+        const jobId = await enqueue(db, opts);
+        return listener.waitFor(db, jobId, waitOpts);
+    }
+    const sched = createScheduler({ enqueue }, tableQ);
+    return {
+        enqueue, claim, heartbeat, complete, fail, cancel, reap, requeueDeadLetter,
+        startListener, stopListener, waitFor, enqueueAndWait,
+        schedule: (db, spec) => sched.schedule(db, spec),
+        unschedule: (db, name) => sched.unschedule(db, name),
+        listSchedules: (db) => sched.listSchedules(db),
+        startScheduler: (db, opts) => sched.start(db, opts),
+        stopScheduler: () => sched.stop(),
+    };
+}
+//# sourceMappingURL=queue.js.map

package/dist/jobs/queue.js.map

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

package/dist/jobs/scheduler.d.ts

@@ -0,0 +1,31 @@
+import type { DB } from '../db/index.js';
+import type { EnqueueOptions } from './queue.js';
+export interface Enqueuer {
+    enqueue(db: DB, opts: EnqueueOptions): Promise<string>;
+}
+export interface ScheduleSpec {
+    readonly name: string;
+    readonly cron: string;
+    readonly timezone?: string;
+    readonly payload?: unknown;
+}
+export interface ScheduleInfo {
+    readonly name: string;
+    readonly cronExpression: string;
+    readonly timezone: string;
+    readonly payload: unknown;
+    readonly lastRunAt: Date | null;
+    readonly nextRunAt: Date;
+}
+export interface SchedulerOptions {
+    readonly checkIntervalMs?: number;
+}
+export interface Scheduler {
+    schedule(db: DB, spec: ScheduleSpec): Promise<void>;
+    unschedule(db: DB, name: string): Promise<boolean>;
+    listSchedules(db: DB): Promise<ScheduleInfo[]>;
+    start(db: DB, opts?: SchedulerOptions): void;
+    stop(): void;
+}
+export declare function createScheduler(enqueuer: Enqueuer, jobsTableQ: string): Scheduler;
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/jobs/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/jobs/scheduler.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAA;AAExC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,MAAM,WAAW,QAAQ;IACvB,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAA;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAClC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,UAAU,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAClD,aAAa,CAAC,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC9C,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC5C,IAAI,IAAI,IAAI,CAAA;CACb;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,CAwGjF"}

package/dist/jobs/scheduler.js

@@ -0,0 +1,94 @@
+import { sql } from '../db/sql.js';
+import { parseCron, nextTick } from './cron.js';
+export function createScheduler(enqueuer, jobsTableQ) {
+    let intervalHandle = null;
+    let running = false;
+    async function schedule(db, spec) {
+        const parsed = parseCron(spec.cron);
+        const tz = spec.timezone ?? 'UTC';
+        const nextRunAt = nextTick(parsed, new Date(), tz);
+        const payloadJson = spec.payload !== undefined ? JSON.stringify(spec.payload) : null;
+        await db.execute(sql `
+      INSERT INTO pipework_schedules (name, cron_expression, timezone, payload, next_run_at)
+      VALUES (${spec.name}, ${spec.cron}, ${tz}, ${payloadJson !== null ? sql `${payloadJson}::jsonb` : sql `NULL`}, ${nextRunAt.toISOString()}::timestamptz)
+      ON CONFLICT (name) DO UPDATE SET
+        cron_expression = EXCLUDED.cron_expression,
+        timezone = EXCLUDED.timezone,
+        payload = EXCLUDED.payload,
+        next_run_at = EXCLUDED.next_run_at,
+        updated_at = now()
+    `);
+    }
+    async function unschedule(db, name) {
+        const rows = await db.execute(sql `DELETE FROM pipework_schedules WHERE name = ${name} RETURNING name`);
+        return rows.length > 0;
+    }
+    async function listSchedules(db) {
+        const rows = await db.execute(sql `SELECT name, cron_expression, timezone, payload, last_run_at, next_run_at
+          FROM pipework_schedules ORDER BY name`);
+        return rows.map(row => ({
+            name: row['name'],
+            cronExpression: row['cron_expression'],
+            timezone: row['timezone'],
+            payload: row['payload'] ?? null,
+            lastRunAt: row['last_run_at'] !== null && row['last_run_at'] !== undefined ? new Date(row['last_run_at']) : null,
+            nextRunAt: new Date(row['next_run_at']),
+        }));
+    }
+    async function tick(db) {
+        const dueRows = await db.execute(sql `
+      SELECT name, cron_expression, timezone, payload
+      FROM pipework_schedules
+      WHERE next_run_at <= now()
+      FOR UPDATE SKIP LOCKED
+    `);
+        for (const row of dueRows) {
+            const name = row['name'];
+            const cronExpr = row['cron_expression'];
+            const tz = row['timezone'];
+            const payload = row['payload'];
+            const pending = await db.execute(sql `
+        SELECT 1 FROM ${sql.raw(jobsTableQ)}
+        WHERE job_type = ${name} AND status IN ('pending', 'claimed')
+        LIMIT 1
+      `);
+            if (pending.length > 0) {
+                const parsed = parseCron(cronExpr);
+                const next = nextTick(parsed, new Date(), tz);
+                await db.execute(sql `
+          UPDATE pipework_schedules SET next_run_at = ${next.toISOString()}::timestamptz, updated_at = now()
+          WHERE name = ${name}
+        `);
+                continue;
+            }
+            await enqueuer.enqueue(db, { type: name, payload: payload ?? {} });
+            const parsed = parseCron(cronExpr);
+            const next = nextTick(parsed, new Date(), tz);
+            await db.execute(sql `
+        UPDATE pipework_schedules SET
+          last_run_at = now(),
+          next_run_at = ${next.toISOString()}::timestamptz,
+          updated_at = now()
+        WHERE name = ${name}
+      `);
+        }
+    }
+    function start(db, opts) {
+        if (running)
+            return;
+        running = true;
+        const intervalMs = opts?.checkIntervalMs ?? 60_000;
+        intervalHandle = setInterval(() => {
+            void tick(db);
+        }, intervalMs);
+    }
+    function stop() {
+        if (!running || intervalHandle === null)
+            return;
+        clearInterval(intervalHandle);
+        intervalHandle = null;
+        running = false;
+    }
+    return { schedule, unschedule, listSchedules, start, stop };
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/jobs/scheduler.js.map

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

package/dist/lifecycle/drain.d.ts

@@ -0,0 +1,7 @@
+import type { FastifyInstance } from 'fastify';
+export interface DrainState {
+    readonly inFlight: () => number;
+    readonly waitForDrain: (timeoutMs: number) => Promise<void>;
+}
+export declare function setupDrain(app: FastifyInstance): DrainState;
+//# sourceMappingURL=drain.d.ts.map

package/dist/lifecycle/drain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.d.ts","sourceRoot":"","sources":["../../src/lifecycle/drain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAA;IAC/B,QAAQ,CAAC,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CAC5D;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,eAAe,GAAG,UAAU,CAyB3D"}