pipework 0.7.12 → 0.7.13

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## 0.7.13
+
+- **Source reorganized by concern** — `src/` directories grouped under `core/`, `data/`, `request/`, `auth/`, `async/`, `infra/`. No public API changes — all exports and namespace objects remain identical (#190).
+- **Config loader no longer rewrites `.js→.ts` inside `dist/` directories** — the ESM resolve hook now skips compiled output, fixing CLI commands for workspace packages with compiled dependencies (#193).
+
 ## 0.7.12
 
 - **Branded types flow through `select()`/`returning()` automatically** — `DefinedTable` now parameterizes `PgTable` with `ProjectedColumns`, so Drizzle's column metadata carries named, branded types. Query results are correctly typed without casts. `eq()` enforces brand safety at compile time (#186).

package/dist/async/jobs/cron.d.ts

@@ -0,0 +1,11 @@
+/** Parsed cron schedule — arrays of valid minutes, hours, days, months, weekdays. */
+export interface CronSchedule {
+    readonly minutes: readonly number[];
+    readonly hours: readonly number[];
+    readonly daysOfMonth: readonly number[];
+    readonly months: readonly number[];
+    readonly daysOfWeek: readonly number[];
+}
+export declare function parseCron(expression: string): CronSchedule;
+export declare function nextTick(schedule: CronSchedule, after: Date, timezone?: string): Date;
+//# sourceMappingURL=cron.d.ts.map

package/dist/async/jobs/cron.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cron.d.ts","sourceRoot":"","sources":["../../../src/async/jobs/cron.ts"],"names":[],"mappings":"AAEA,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAUD,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,YAAY,CAgB1D;AA8CD,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAmErF"}

package/dist/async/jobs/cron.js

@@ -0,0 +1,176 @@
+import { ValidationError } from '../../core/errors/index.js';
+const FIELD_RANGES = [
+    [0, 59], // minute
+    [0, 23], // hour
+    [1, 31], // day of month
+    [1, 12], // month
+    [0, 6], // day of week (0=Sun)
+];
+export function parseCron(expression) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        throw new ValidationError(`Invalid cron expression "${expression}": expected 5 fields (minute hour day month weekday), got ${parts.length}`);
+    }
+    const [minutes, hours, daysOfMonth, months, daysOfWeek] = parts;
+    return {
+        minutes: parseField(minutes, FIELD_RANGES[0], 'minute'),
+        hours: parseField(hours, FIELD_RANGES[1], 'hour'),
+        daysOfMonth: parseField(daysOfMonth, FIELD_RANGES[2], 'day-of-month'),
+        months: parseField(months, FIELD_RANGES[3], 'month'),
+        daysOfWeek: parseField(daysOfWeek, FIELD_RANGES[4], 'day-of-week'),
+    };
+}
+function parseField(field, [min, max], name) {
+    const values = new Set();
+    for (const part of field.split(',')) {
+        const stepMatch = part.match(/^(.+)\/(\d+)$/);
+        const step = stepMatch ? parseInt(stepMatch[2], 10) : null;
+        const rangePart = stepMatch ? stepMatch[1] : part;
+        if (step !== null && (step < 1 || step > max)) {
+            throw new ValidationError(`Invalid cron ${name}: step "${step}" out of range`);
+        }
+        if (rangePart === '*') {
+            for (let i = min; i <= max; i += (step ?? 1)) {
+                values.add(i);
+            }
+        }
+        else if (rangePart.includes('-')) {
+            const [startStr, endStr] = rangePart.split('-');
+            const start = parseInt(startStr, 10);
+            const end = parseInt(endStr, 10);
+            if (Number.isNaN(start) || Number.isNaN(end) || start < min || end > max || start > end) {
+                throw new ValidationError(`Invalid cron ${name}: range "${rangePart}" out of bounds (${min}-${max})`);
+            }
+            for (let i = start; i <= end; i += (step ?? 1)) {
+                values.add(i);
+            }
+        }
+        else {
+            const val = parseInt(rangePart, 10);
+            if (Number.isNaN(val) || val < min || val > max) {
+                throw new ValidationError(`Invalid cron ${name}: value "${rangePart}" out of range (${min}-${max})`);
+            }
+            if (step !== null) {
+                for (let i = val; i <= max; i += step) {
+                    values.add(i);
+                }
+            }
+            else {
+                values.add(val);
+            }
+        }
+    }
+    return [...values].sort((a, b) => a - b);
+}
+export function nextTick(schedule, after, timezone) {
+    const tz = timezone ?? 'UTC';
+    const formatter = new Intl.DateTimeFormat('en-US', {
+        timeZone: tz,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+    });
+    const parts = extractParts(formatter, after);
+    let year = parts.year;
+    let month = parts.month;
+    let day = parts.day;
+    let hour = parts.hour;
+    let minute = parts.minute + 1;
+    for (let guard = 0; guard < 5 * 366; guard++) {
+        if (minute > 59) {
+            minute = 0;
+            hour++;
+        }
+        if (hour > 23) {
+            hour = 0;
+            day++;
+        }
+        const dim = getDaysInMonth(year, month);
+        if (day > dim) {
+            day = 1;
+            month++;
+        }
+        if (month > 12) {
+            month = 1;
+            year++;
+        }
+        if (!schedule.months.includes(month)) {
+            month++;
+            day = schedule.daysOfMonth[0];
+            hour = schedule.hours[0];
+            minute = schedule.minutes[0];
+            continue;
+        }
+        if (!schedule.daysOfMonth.includes(day)) {
+            day++;
+            hour = schedule.hours[0];
+            minute = schedule.minutes[0];
+            continue;
+        }
+        const dow = getDayOfWeekForDate(year, month, day);
+        if (!schedule.daysOfWeek.includes(dow)) {
+            day++;
+            hour = schedule.hours[0];
+            minute = schedule.minutes[0];
+            continue;
+        }
+        if (!schedule.hours.includes(hour)) {
+            const nextHour = schedule.hours.find(h => h > hour);
+            if (nextHour !== undefined) {
+                hour = nextHour;
+                minute = schedule.minutes[0];
+            }
+            else {
+                day++;
+                hour = schedule.hours[0];
+                minute = schedule.minutes[0];
+            }
+            continue;
+        }
+        if (!schedule.minutes.includes(minute)) {
+            const nextMin = schedule.minutes.find(m => m >= minute);
+            if (nextMin !== undefined) {
+                minute = nextMin;
+            }
+            else {
+                hour++;
+                minute = schedule.minutes[0];
+            }
+            continue;
+        }
+        return buildDate(tz, year, month, day, hour, minute);
+    }
+    throw new Error('Could not find next cron tick within search window');
+}
+function extractParts(formatter, date) {
+    const resolved = formatter.formatToParts(date);
+    const get = (type) => parseInt(resolved.find(p => p.type === type).value, 10);
+    return { year: get('year'), month: get('month'), day: get('day'), hour: get('hour'), minute: get('minute') };
+}
+function getDayOfWeekForDate(year, month, day) {
+    return new Date(Date.UTC(year, month - 1, day, 12, 0, 0)).getUTCDay();
+}
+function getDaysInMonth(year, month) {
+    return new Date(year, month, 0).getDate();
+}
+function buildDate(tz, year, month, day, hour, minute) {
+    if (tz === 'UTC') {
+        return new Date(Date.UTC(year, month - 1, day, hour, minute, 0, 0));
+    }
+    const iso = `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}T${String(hour).padStart(2, '0')}:${String(minute).padStart(2, '0')}:00`;
+    const formatter = new Intl.DateTimeFormat('en-US', { timeZone: tz, timeZoneName: 'longOffset' });
+    const refParts = formatter.formatToParts(new Date(iso + 'Z'));
+    const tzPart = refParts.find(p => p.type === 'timeZoneName')?.value ?? '+00:00';
+    const offsetMatch = tzPart.match(/GMT([+-]\d{1,2}):?(\d{2})?/);
+    if (!offsetMatch)
+        return new Date(iso + 'Z');
+    const offsetHours = parseInt(offsetMatch[1], 10);
+    const offsetMinutes = parseInt(offsetMatch[2] ?? '0', 10);
+    const totalOffsetMs = (offsetHours * 60 + (offsetHours < 0 ? -offsetMinutes : offsetMinutes)) * 60_000;
+    return new Date(new Date(iso + 'Z').getTime() - totalOffsetMs);
+}
+//# sourceMappingURL=cron.js.map

package/dist/async/jobs/cron.js.map

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

package/dist/async/jobs/execute.d.ts

@@ -0,0 +1,12 @@
+import type { Manifold } from '../../core/pipework.js';
+import type { Handler } from '../../request/di/types.js';
+export interface ExecuteJobOptions {
+    instance: Manifold;
+    jobId?: string;
+    jobType?: string;
+    auth?: unknown;
+    tenant?: string | null;
+    input?: unknown;
+}
+export declare function executeJob<TDeps extends Record<string, unknown>, TReturn>(handler: Handler<TDeps, TReturn>, options: ExecuteJobOptions): Promise<TReturn>;
+//# sourceMappingURL=execute.d.ts.map

package/dist/async/jobs/execute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/async/jobs/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AAKxD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,wBAAsB,UAAU,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAC7E,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,OAAO,CAAC,CAWlB"}

package/dist/async/jobs/execute.js

@@ -0,0 +1,19 @@
+import { runInContext } from '../../request/context/store.js';
+import { createJobContext } from '../../request/context/create.js';
+import { resolveAndExecute } from '../../request/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/async/jobs/execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/async/jobs/execute.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAW/D,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/async/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/async/jobs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/async/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/async/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/async/jobs/index.js.map

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

@@ -0,0 +1,32 @@
+import type { DB } from '../../data/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/async/jobs/listener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../../../src/async/jobs/listener.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAA;AAEhD,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/async/jobs/listener.js

@@ -0,0 +1,95 @@
+import { sql } from '../../data/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/async/jobs/listener.js.map

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

package/dist/async/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/async/jobs/namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespace.d.ts","sourceRoot":"","sources":["../../../src/async/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/async/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/async/jobs/namespace.js.map

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

@@ -0,0 +1,58 @@
+import type { DB } from '../../data/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/async/jobs/queue.d.ts.map

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