pipework 0.1.0

package/dist/jobs/queue.js

@@ -0,0 +1,162 @@
+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 rows = await db.execute(sql `INSERT INTO ${sql.raw(tableQ)} (job_type, priority, payload, max_attempts)
+               VALUES (${opts.type}, ${priority}, ${payload}::jsonb, ${maxAttempts})
+               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":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAElC,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAyDhD,MAAM,UAAU,WAAW,CAAC,SAAsB,EAAE;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,eAAe,CAAA;IAC7C,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,OAAO,CAAA;IACvD,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,IAAI,uBAAuB,CAAA;IAC/D,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,CAAC,CAAA;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAA;IAE9B,qBAAqB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;IAC3C,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;IAEhD,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,EAAE,aAAa,CAAC,CAAA;IACpD,MAAM,QAAQ,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IAEjD,KAAK,UAAU,OAAO,CAAC,EAAM,EAAE,IAAoB;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAA;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAE5C,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAC3B,GAAG,CAAA,eAAe,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;yBACd,IAAI,CAAC,IAAI,KAAK,QAAQ,KAAK,OAAO,YAAY,WAAW;kCAChD,CAC7B,CAAA;QACD,OAAO,IAAI,CAAC,CAAC,CAAE,CAAC,IAAI,CAAW,CAAA;IACjC,CAAC;IAED,KAAK,UAAU,KAAK,CAAC,EAAM,EAAE,QAAgB;QAC3C,MAAM,UAAU,GAAG,CAAC,CAAA;QACpB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC;gBACH,MAAM,iBAAiB,GAAG,MAAM,CAAC,WAAW;oBAC1C,CAAC,CAAC,GAAG,CAAA,SAAS,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG;oBACnD,CAAC,CAAC,GAAG,CAAA,EAAE,CAAA;gBAET,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;mBACtB,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;;;;0BAIR,QAAQ;;6BAEL,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;4FACgD,iBAAiB;;;;;mEAK1C,CAAC,CAAA;gBAE5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,IAAI,CAAA;gBAElC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAA;gBACpB,OAAO;oBACL,EAAE,EAAE,GAAG,CAAC,IAAI,CAAW;oBACvB,IAAI,EAAE,GAAG,CAAC,UAAU,CAAW;oBAC/B,OAAO,EAAE,GAAG,CAAC,SAAS,CAAC;oBACvB,UAAU,EAAE,GAAG,CAAC,aAAa,CAAW;iBACzC,CAAA;YACH,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,IAAI,GAAI,GAAyB,CAAC,IAAI,CAAA;gBAC5C,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,CAAC,IAAI,OAAO,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;oBACvE,SAAQ;gBACV,CAAC;gBACD,MAAM,GAAG,CAAA;YACX,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,UAAU,SAAS,CAAC,EAAM,EAAE,KAAa;QAC5C,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,wCAAwC,KAAK,QAAQ,CAClF,CAAA;IACH,CAAC;IAED,KAAK,UAAU,QAAQ,CAAC,EAAM,EAAE,KAAa,EAAE,MAAgB;QAC7D,MAAM,UAAU,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;QACvE,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,6DAA6D,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAA,GAAG,UAAU,SAAS,CAAC,CAAC,CAAC,GAAG,CAAA,MAAM;4BAC9H,KAAK,QAAQ,CACpC,CAAA;QACD,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,oBAAoB,OAAO,KAAK,KAAK,GAAG,CAC5C,CAAA;IACH,CAAC;IAED,SAAS,cAAc,CAAC,YAAoB;QAC1C,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,CAAA;QACtB,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,CAAA;QACpD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAA;QACzD,OAAO,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACvF,CAAC;IAED,KAAK,UAAU,IAAI,CAAC,EAAM,EAAE,KAAa,EAAE,KAAc;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;QAEjH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAC9B,GAAG,CAAA,2CAA2C,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,eAAe,KAAK,QAAQ,CAC1F,CAAA;QACD,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;QACtB,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,+BAA+B,KAAK,oBAAoB,CAAC,CAAA;QAC3E,CAAC;QAED,MAAM,YAAY,GAAG,GAAG,CAAC,eAAe,CAAW,CAAA;QACnD,MAAM,cAAc,GAAG,GAAG,CAAC,cAAc,CAAW,CAAA;QACpD,MAAM,WAAW,GAAG,YAAY,GAAG,CAAC,CAAA;QAEpC,IAAI,WAAW,GAAG,cAAc,EAAE,CAAC;YACjC,MAAM,OAAO,GAAG,cAAc,CAAC,YAAY,CAAC,CAAA;YAC5C,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,UAAU,CAAA;YAC3D,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;;gCAEJ,WAAW;gCACX,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA,WAAW,YAAY,YAAY,CAAC,CAAC,CAAC,GAAG,CAAA,MAAM;gCAChE,SAAS;;;;yBAIhB,KAAK,QAAQ,CAC/B,CAAA;QACH,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;;gCAEJ,WAAW;;gCAEX,SAAS;yBAChB,KAAK,QAAQ,CAC/B,CAAA;YACD,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,oBAAoB,OAAO,KAAK,KAAK,GAAG,CAC5C,CAAA;QACH,CAAC;IACH,CAAC;IAED,KAAK,UAAU,MAAM,CAAC,EAAM,EAAE,KAAa;QACzC,MAAM,EAAE,CAAC,OAAO,CACd,GAAG,CAAA,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;4BACN,KAAK,6CAA6C,CACzE,CAAA;IACH,CAAC;IAED,KAAK,UAAU,IAAI,CAAC,EAAM;QACxB,MAAM,aAAa,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,UAAU,CAAA;QACpE,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAC3B,GAAG,CAAA,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;mCACC,yCAAyC;;8CAE9B,aAAa;4BAC/B,CACvB,CAAA;QACD,OAAO,IAAI,CAAC,MAAM,CAAA;IACpB,CAAC;IAED,KAAK,UAAU,iBAAiB,CAAC,EAAM,EAAE,KAAa;QACpD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAC3B,GAAG,CAAA,UAAU,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC;kEACgC,WAAW;;;qBAGxD,KAAK;qBACL,CAChB,CAAA;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,iDAAiD,CAAC,CAAA;QAC3G,CAAC;IACH,CAAC;IAED,KAAK,UAAU,aAAa,CAAC,MAAoB;QAC/C,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;IAC9B,CAAC;IAED,KAAK,UAAU,YAAY;QACzB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IACvB,CAAC;IAED,KAAK,UAAU,OAAO,CAAC,EAAM,EAAE,KAAa,EAAE,IAAiB;QAC7D,OAAO,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;IAC1C,CAAC;IAED,KAAK,UAAU,cAAc,CAAC,EAAM,EAAE,IAAoB,EAAE,QAAqB;QAC/E,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAA;QACrC,OAAO,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAA;IAC9C,CAAC;IAED,MAAM,KAAK,GAAG,eAAe,CAAC,EAAE,OAAO,EAAE,EAAE,MAAM,CAAC,CAAA;IAElD,OAAO;QACL,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB;QAC1E,aAAa,EAAE,YAAY,EAAE,OAAO,EAAE,cAAc;QACpD,QAAQ,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;QAChD,UAAU,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC;QACpD,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC;QAC9C,cAAc,EAAE,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC;QACnD,aAAa,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE;KAClC,CAAA;AACH,CAAC"}

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"}

package/dist/lifecycle/drain.js

@@ -0,0 +1,24 @@
+export function setupDrain(app) {
+    let count = 0;
+    app.addHook('onRequest', () => { count++; return Promise.resolve(); });
+    app.addHook('onResponse', () => { count--; return Promise.resolve(); });
+    return {
+        inFlight: () => count,
+        waitForDrain: (timeoutMs) => new Promise((resolve, reject) => {
+            if (count === 0)
+                return resolve();
+            const deadline = setTimeout(() => {
+                clearInterval(poll);
+                reject(new Error(`[pipework] Drain timeout: ${count} requests still in-flight after ${timeoutMs}ms`));
+            }, timeoutMs);
+            const poll = setInterval(() => {
+                if (count === 0) {
+                    clearTimeout(deadline);
+                    clearInterval(poll);
+                    resolve();
+                }
+            }, 50);
+        }),
+    };
+}
+//# sourceMappingURL=drain.js.map

package/dist/lifecycle/drain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.js","sourceRoot":"","sources":["../../src/lifecycle/drain.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,UAAU,CAAC,GAAoB;IAC7C,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;IACrE,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;IAEtE,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK;QACrB,YAAY,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACzE,IAAI,KAAK,KAAK,CAAC;gBAAE,OAAO,OAAO,EAAE,CAAA;YAEjC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC/B,aAAa,CAAC,IAAI,CAAC,CAAA;gBACnB,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,KAAK,mCAAmC,SAAS,IAAI,CAAC,CAAC,CAAA;YACvG,CAAC,EAAE,SAAS,CAAC,CAAA;YAEb,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;gBAC5B,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;oBAChB,YAAY,CAAC,QAAQ,CAAC,CAAA;oBACtB,aAAa,CAAC,IAAI,CAAC,CAAA;oBACnB,OAAO,EAAE,CAAA;gBACX,CAAC;YACH,CAAC,EAAE,EAAE,CAAC,CAAA;QACR,CAAC,CAAC;KACH,CAAA;AACH,CAAC"}

package/dist/lifecycle/health.d.ts

@@ -0,0 +1,8 @@
+import type { FastifyInstance } from 'fastify';
+import type { Manifold } from '../pipework.js';
+import type { HealthCheck } from './types.js';
+export declare function registerHealthRoutes(app: FastifyInstance, instance: Manifold, checks: readonly HealthCheck[], paths: {
+    health: string;
+    ready: string;
+}): void;
+//# sourceMappingURL=health.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/lifecycle/health.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAmC,MAAM,YAAY,CAAA;AAK9E,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,eAAe,EACpB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,SAAS,WAAW,EAAE,EAC9B,KAAK,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC,IAAI,CAoCN"}

package/dist/lifecycle/health.js

@@ -0,0 +1,62 @@
+import { sql } from '../db/sql.js';
+const startedAt = Date.now();
+export function registerHealthRoutes(app, instance, checks, paths) {
+    app.get(paths.health, async (_req, reply) => {
+        return reply.status(200).send({ status: 'healthy', uptime: Date.now() - startedAt });
+    });
+    app.get(paths.ready, async (_req, reply) => {
+        const results = {};
+        let overall = 'healthy';
+        const dbChecks = await checkDatabases(instance);
+        for (const [name, result] of Object.entries(dbChecks)) {
+            results[name] = result;
+            if (result.status === 'unhealthy')
+                overall = 'unhealthy';
+            else if (result.status === 'degraded' && overall !== 'unhealthy')
+                overall = 'degraded';
+        }
+        for (const check of checks) {
+            const start = Date.now();
+            try {
+                const result = await check.check();
+                results[check.name] = { ...result, latencyMs: result.latencyMs ?? (Date.now() - start) };
+                if (result.status === 'unhealthy')
+                    overall = 'unhealthy';
+                else if (result.status === 'degraded' && overall !== 'unhealthy')
+                    overall = 'degraded';
+            }
+            catch (err) {
+                results[check.name] = {
+                    status: 'unhealthy',
+                    message: err instanceof Error ? err.message : 'check failed',
+                    latencyMs: Date.now() - start,
+                };
+                overall = 'unhealthy';
+            }
+        }
+        const status = { status: overall, uptime: Date.now() - startedAt, checks: results };
+        return reply.status(overall === 'unhealthy' ? 503 : 200).send(status);
+    });
+}
+async function checkDatabases(instance) {
+    const results = {};
+    const dbNames = instance.config.databaseNames();
+    for (const name of dbNames) {
+        const start = Date.now();
+        try {
+            const dbConfig = instance.config.database(name);
+            const conn = instance.pool.getOrCreate(dbConfig);
+            await conn.drizzle.execute(sql `SELECT 1`);
+            results[`db:${name}`] = { status: 'healthy', latencyMs: Date.now() - start };
+        }
+        catch (err) {
+            results[`db:${name}`] = {
+                status: 'unhealthy',
+                message: err instanceof Error ? err.message : 'connection failed',
+                latencyMs: Date.now() - start,
+            };
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=health.js.map

package/dist/lifecycle/health.js.map

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

package/dist/lifecycle/index.d.ts

@@ -0,0 +1,5 @@
+export { orchestrateStartup, type StartupOptions } from './startup.js';
+export { registerHealthRoutes } from './health.js';
+export { setupDrain, type DrainState } from './drain.js';
+export type { LifecycleConfig, StartupHook, ShutdownHook, HealthCheck, HealthCheckResult, HealthStatus } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACxD,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}

package/dist/lifecycle/index.js

@@ -0,0 +1,4 @@
+export { orchestrateStartup } from './startup.js';
+export { registerHealthRoutes } from './health.js';
+export { setupDrain } from './drain.js';
+//# sourceMappingURL=index.js.map

package/dist/lifecycle/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lifecycle/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAuB,MAAM,cAAc,CAAA;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EAAE,UAAU,EAAmB,MAAM,YAAY,CAAA"}

package/dist/lifecycle/namespace.d.ts

@@ -0,0 +1,5 @@
+import { orchestrateStartup } from './startup.js';
+export declare const lifecycle: {
+    orchestrate: typeof orchestrateStartup;
+};
+//# sourceMappingURL=namespace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/lifecycle/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,eAAO,MAAM,SAAS;;CAErB,CAAA"}

package/dist/lifecycle/namespace.js

@@ -0,0 +1,5 @@
+import { orchestrateStartup } from './startup.js';
+export const lifecycle = {
+    orchestrate: orchestrateStartup,
+};
+//# sourceMappingURL=namespace.js.map

package/dist/lifecycle/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/lifecycle/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AAEjD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,WAAW,EAAE,kBAAkB;CAChC,CAAA"}

package/dist/lifecycle/startup.d.ts

@@ -0,0 +1,8 @@
+import type { Manifold } from '../pipework.js';
+import type { StartupHook } from './types.js';
+export interface StartupOptions {
+    readonly hooks?: readonly StartupHook[];
+    readonly timeoutMs?: number;
+}
+export declare function orchestrateStartup(instance: Manifold, options?: StartupOptions): Promise<void>;
+//# sourceMappingURL=startup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"startup.d.ts","sourceRoot":"","sources":["../../src/lifecycle/startup.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAG7C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IACvC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BxG"}

package/dist/lifecycle/startup.js

@@ -0,0 +1,43 @@
+import { sql } from '../db/sql.js';
+import { getBaseLogger } from '../logging/index.js';
+export async function orchestrateStartup(instance, options = {}) {
+    const logger = getBaseLogger();
+    const timeoutMs = options.timeoutMs ?? 30000;
+    const doStartupWork = async () => {
+        await verifyDatabases(instance, logger);
+        if (options.hooks) {
+            for (const hook of options.hooks) {
+                logger.info({ hook: hook.name }, 'Running pre-start hook');
+                await hook.execute();
+            }
+        }
+    };
+    const timeoutPromise = new Promise((_, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`[pipework] Startup timed out after ${timeoutMs}ms.\n\n` +
+                '  This usually means a database is unreachable or a pre-start hook is hanging.\n' +
+                '  Check your DATABASE_URL values and network connectivity.\n'));
+        }, timeoutMs);
+        timer.unref();
+    });
+    await Promise.race([doStartupWork(), timeoutPromise]);
+}
+async function verifyDatabases(instance, logger) {
+    const dbNames = instance.config.databaseNames();
+    for (const name of dbNames) {
+        const dbConfig = instance.config.database(name);
+        const conn = instance.pool.getOrCreate(dbConfig);
+        try {
+            await conn.drizzle.execute(sql `SELECT 1`);
+            logger.info({ database: name }, 'Database connectivity verified');
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`[pipework] Cannot connect to database "${name}".\n\n` +
+                `  URL: ${dbConfig.url.replace(/\/\/[^@]+@/, '//***@')}\n` +
+                `  Error: ${message}\n\n` +
+                '  Check that the database is running and the URL is correct.\n');
+        }
+    }
+}
+//# sourceMappingURL=startup.js.map

package/dist/lifecycle/startup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup.js","sourceRoot":"","sources":["../../src/lifecycle/startup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAGlC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAOnD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAkB,EAAE,UAA0B,EAAE;IACvF,MAAM,MAAM,GAAG,aAAa,EAAE,CAAA;IAC9B,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,KAAK,CAAA;IAE5C,MAAM,aAAa,GAAG,KAAK,IAAI,EAAE;QAC/B,MAAM,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;QAEvC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,wBAAwB,CAAC,CAAA;gBAC1D,MAAM,IAAI,CAAC,OAAO,EAAE,CAAA;YACtB,CAAC;QACH,CAAC;IACH,CAAC,CAAA;IAED,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QACtD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,KAAK,CACd,sCAAsC,SAAS,SAAS;gBACxD,kFAAkF;gBAClF,8DAA8D,CAC/D,CAAC,CAAA;QACJ,CAAC,EAAE,SAAS,CAAC,CAAA;QACb,KAAK,CAAC,KAAK,EAAE,CAAA;IACf,CAAC,CAAC,CAAA;IAEF,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE,cAAc,CAAC,CAAC,CAAA;AACvD,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAkB,EAAE,MAAkE;IACnH,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,CAAA;IAE/C,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAA;QAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;QAChD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAA,UAAU,CAAC,CAAA;YACzC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,gCAAgC,CAAC,CAAA;QACnE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAChE,MAAM,IAAI,KAAK,CACb,0CAA0C,IAAI,QAAQ;gBACtD,UAAU,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,QAAQ,CAAC,IAAI;gBAC1D,YAAY,OAAO,MAAM;gBACzB,gEAAgE,CACjE,CAAA;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/lifecycle/types.d.ts

@@ -0,0 +1,30 @@
+export interface LifecycleConfig {
+    readonly preStart?: readonly StartupHook[];
+    readonly preShutdown?: readonly ShutdownHook[];
+    readonly healthChecks?: readonly HealthCheck[];
+    readonly drainTimeoutMs?: number;
+    readonly startupTimeoutMs?: number;
+}
+export interface StartupHook {
+    readonly name: string;
+    execute(): Promise<void>;
+}
+export interface ShutdownHook {
+    readonly name: string;
+    execute(): Promise<void>;
+}
+export interface HealthCheck {
+    readonly name: string;
+    check(): Promise<HealthCheckResult>;
+}
+export interface HealthCheckResult {
+    readonly status: 'healthy' | 'degraded' | 'unhealthy';
+    readonly message?: string;
+    readonly latencyMs?: number;
+}
+export interface HealthStatus {
+    readonly status: 'healthy' | 'degraded' | 'unhealthy';
+    readonly uptime: number;
+    readonly checks: Record<string, HealthCheckResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/lifecycle/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,YAAY,EAAE,CAAA;IAC9C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAC9C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,KAAK,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAA;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAA;IACrD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CACnD"}

package/dist/lifecycle/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/lifecycle/types.js.map

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

package/dist/log/namespace.d.ts

@@ -0,0 +1,9 @@
+import { createPipeworkLogger, getLogger, getBaseLogger, setLoggingConfig } from '../logging/logger.js';
+export declare const log: import("../index.js").PipeworkLogger & {
+    create: typeof createPipeworkLogger;
+    get: typeof getLogger;
+    getBase: typeof getBaseLogger;
+    configure: typeof setLoggingConfig;
+    REDACT_PATHS: readonly string[];
+};
+//# sourceMappingURL=namespace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../src/log/namespace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAwB,MAAM,sBAAsB,CAAA;AAE7H,eAAO,MAAM,GAAG;;;;;;CAMd,CAAA"}

package/dist/log/namespace.js

@@ -0,0 +1,10 @@
+import { log as logProxy } from '../logging/proxy.js';
+import { createPipeworkLogger, getLogger, getBaseLogger, setLoggingConfig, DEFAULT_REDACT_PATHS } from '../logging/logger.js';
+export const log = Object.assign(logProxy, {
+    create: createPipeworkLogger,
+    get: getLogger,
+    getBase: getBaseLogger,
+    configure: setLoggingConfig,
+    REDACT_PATHS: DEFAULT_REDACT_PATHS,
+});
+//# sourceMappingURL=namespace.js.map

package/dist/log/namespace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.js","sourceRoot":"","sources":["../../src/log/namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,IAAI,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAE7H,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;IACzC,MAAM,EAAE,oBAAoB;IAC5B,GAAG,EAAE,SAAS;IACd,OAAO,EAAE,aAAa;IACtB,SAAS,EAAE,gBAAgB;IAC3B,YAAY,EAAE,oBAAoB;CACnC,CAAC,CAAA"}

package/dist/logging/context.d.ts

@@ -0,0 +1,11 @@
+export interface CorrelationFields {
+    requestId?: string;
+    tenantId?: string;
+    userId?: string;
+    sessionId?: string;
+    traceId?: string;
+    jobType?: string;
+    [key: string]: string | undefined;
+}
+export declare function getCorrelationFields(): CorrelationFields;
+//# sourceMappingURL=context.d.ts.map