bunderstack 0.17.0-beta.2 → 0.17.0-beta.4

package/dist/jobs/slots.d.ts

@@ -0,0 +1,25 @@
+import { type ParsedCron } from './cron.js';
+/** Slot granularity. Every slot timestamp satisfies `slot % SLOT_MS === 0`. */
+export declare const SLOT_MS = 60000;
+/** Reserved job-type prefix for cron occurrences. */
+export declare const CRON_PREFIX = "cron:";
+/** How far back either catch-up mode will look. */
+export declare const DEFAULT_CATCH_UP_WINDOW_MS: number;
+export type CatchUp = 'latest' | 'all';
+/** Aligns `ms` down to its containing slot. */
+export declare function floorSlot(ms: number): number;
+/**
+ * Slots matching `cron` in the half-open range `(from, to]`, oldest first.
+ *
+ * `from` is exclusive so a stored watermark is never re-emitted. Both modes are
+ * clamped to `catchUpWindowMs` — without it a watermark far in the past would
+ * make this iterate unbounded minutes.
+ */
+export declare function slotsDue(args: {
+    cron: ParsedCron;
+    from: number;
+    to: number;
+    catchUp?: CatchUp;
+    catchUpWindowMs?: number;
+}): number[];
+//# sourceMappingURL=slots.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/jobs/slots.ts"],"names":[],"mappings":"AACA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAA;AAErD,+EAA+E;AAC/E,eAAO,MAAM,OAAO,QAAS,CAAA;AAE7B,qDAAqD;AACrD,eAAO,MAAM,WAAW,UAAU,CAAA;AAElC,mDAAmD;AACnD,eAAO,MAAM,0BAA0B,QAAe,CAAA;AAEtD,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAA;AAEtC,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAC7B,IAAI,EAAE,UAAU,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB,GAAG,MAAM,EAAE,CAmBX"}

package/dist/jobs/slots.js

@@ -0,0 +1,41 @@
+// src/jobs/slots.ts — cron slot enumeration. Pure; no db, no clock reads.
+import { cronMatches } from './cron.js';
+/** Slot granularity. Every slot timestamp satisfies `slot % SLOT_MS === 0`. */
+export const SLOT_MS = 60_000;
+/** Reserved job-type prefix for cron occurrences. */
+export const CRON_PREFIX = 'cron:';
+/** How far back either catch-up mode will look. */
+export const DEFAULT_CATCH_UP_WINDOW_MS = 60 * SLOT_MS;
+/** Aligns `ms` down to its containing slot. */
+export function floorSlot(ms) {
+    return Math.floor(ms / SLOT_MS) * SLOT_MS;
+}
+/**
+ * Slots matching `cron` in the half-open range `(from, to]`, oldest first.
+ *
+ * `from` is exclusive so a stored watermark is never re-emitted. Both modes are
+ * clamped to `catchUpWindowMs` — without it a watermark far in the past would
+ * make this iterate unbounded minutes.
+ */
+export function slotsDue(args) {
+    const catchUp = args.catchUp ?? 'latest';
+    const windowMs = args.catchUpWindowMs ?? DEFAULT_CATCH_UP_WINDOW_MS;
+    const to = floorSlot(args.to);
+    const from = Math.max(floorSlot(args.from), to - windowMs);
+    if (to <= from)
+        return [];
+    if (catchUp === 'latest') {
+        for (let s = to; s > from; s -= SLOT_MS) {
+            if (cronMatches(args.cron, s))
+                return [s];
+        }
+        return [];
+    }
+    const slots = [];
+    for (let s = from + SLOT_MS; s <= to; s += SLOT_MS) {
+        if (cronMatches(args.cron, s))
+            slots.push(s);
+    }
+    return slots;
+}
+//# sourceMappingURL=slots.js.map

package/dist/jobs/slots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slots.js","sourceRoot":"","sources":["../../src/jobs/slots.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,OAAO,EAAE,WAAW,EAAmB,MAAM,QAAQ,CAAA;AAErD,+EAA+E;AAC/E,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAA;AAE7B,qDAAqD;AACrD,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAA;AAElC,mDAAmD;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,GAAG,OAAO,CAAA;AAItD,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,EAAU;IAClC,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,GAAG,OAAO,CAAA;AAC3C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,QAAQ,CAAC,IAMxB;IACC,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAA;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,IAAI,0BAA0B,CAAA;IACnE,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,QAAQ,CAAC,CAAA;IAC1D,IAAI,EAAE,IAAI,IAAI;QAAE,OAAO,EAAE,CAAA;IAEzB,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;YACxC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC,CAAC,CAAA;QAC3C,CAAC;QACD,OAAO,EAAE,CAAA;IACX,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,OAAO,EAAE,CAAC;QACnD,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/jobs/worker.d.ts

@@ -0,0 +1,12 @@
+import type { AnyDb } from '../dialect.js';
+import type { JobsDefs, JobsRuntimeFacade, TickResult } from './define.js';
+export declare function createJobRunner(deps: {
+    db: AnyDb;
+    defs: JobsDefs;
+    /** Handler ctx WITHOUT `jobs`; the facade is injected via setJobsFacade. */
+    ctx: Record<string, unknown>;
+}): {
+    tick(now?: number): Promise<TickResult>;
+    setJobsFacade(f: JobsRuntimeFacade): void;
+};
+//# sourceMappingURL=worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/jobs/worker.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,KAAK,EAEV,QAAQ,EACR,iBAAiB,EACjB,UAAU,EACX,MAAM,UAAU,CAAA;AAgDjB,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,EAAE,EAAE,KAAK,CAAA;IACT,IAAI,EAAE,QAAQ,CAAA;IACd,4EAA4E;IAC5E,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7B;eAmSmB,MAAM,GAAgB,OAAO,CAAC,UAAU,CAAC;qBASxC,iBAAiB;EAIrC"}

package/dist/jobs/worker.js

@@ -0,0 +1,311 @@
+// src/jobs/worker.ts — the queue worker. One `tick()` is a full cycle:
+// recover expired leases → reap old succeeded rows → claim and run queue jobs.
+import { and, eq, inArray, is, isNotNull, lt, lte, max, sql } from 'drizzle-orm';
+import { PgDatabase } from 'drizzle-orm/pg-core';
+import { jobsTableFor } from '../internal-tables.js';
+import { validateStandardSchema } from '../standard-schema.js';
+import { parseCron } from './cron.js';
+import { backoffMs, DEFAULT_RETRIES, DEFAULT_TIMEOUT_MS } from './define.js';
+import { enqueueJob } from './queue.js';
+import { CRON_PREFIX, floorSlot, slotsDue, SLOT_MS } from './slots.js';
+const CLAIM_BATCH = 10;
+const SUCCEEDED_RETENTION_MS = 24 * 60 * 60 * 1000;
+const REAP_INTERVAL_MS = 60 * 60_000;
+function toError(err) {
+    return err instanceof Error ? err : new Error(String(err));
+}
+function maxAttempts(def) {
+    return 1 + (def.retries ?? DEFAULT_RETRIES);
+}
+/** Resolve a stored row type back to its definition. Cron rows carry the
+ *  reserved prefix; queue rows use the definition key verbatim. */
+function definitionFor(defs, type) {
+    if (type.startsWith(CRON_PREFIX)) {
+        const def = defs[type.slice(CRON_PREFIX.length)];
+        return def?.kind === 'cron' ? def : undefined;
+    }
+    const def = defs[type];
+    return def?.kind === 'job' ? def : undefined;
+}
+/** Terminal queue rows release their dedupe key. */
+function terminalPatch() {
+    return { dedupeKey: null };
+}
+export function createJobRunner(deps) {
+    const { db, defs } = deps;
+    const t = jobsTableFor(db);
+    const ctx = { ...deps.ctx };
+    let lastReapAt = 0;
+    /** Cron rows carry no payload — their handler input is the slot itself. */
+    function resolveInput(def, row) {
+        if (def.kind === 'cron') {
+            return { scheduledFor: new Date(Number(row.runAt)) };
+        }
+        const raw = JSON.parse(row.payloadJson);
+        return def.input
+            ? validateStandardSchema(def.input, raw, 'job payload')
+            : undefined;
+    }
+    /**
+     * The watermark is the newest slot we already stored for this cron. When no
+     * rows exist — a newly declared cron, or one whose rows were reaped — anchor
+     * one slot before now so the current minute is eligible and nothing older is.
+     */
+    async function cronWatermark(type, now) {
+        const rows = await db
+            .select({ latest: max(t.runAt) })
+            .from(t)
+            .where(eq(t.type, type));
+        const latest = rows[0]?.latest;
+        return latest == null ? floorSlot(now) - SLOT_MS : Number(latest);
+    }
+    /** Enqueue a row per due slot. The unique(type, dedupeKey) constraint makes
+     *  this safe to run concurrently in any number of processes. */
+    async function materializeCronSlots(now) {
+        for (const [name, def] of Object.entries(defs)) {
+            if (def.kind !== 'cron')
+                continue;
+            const type = `${CRON_PREFIX}${name}`;
+            const from = await cronWatermark(type, now);
+            const slots = slotsDue({
+                cron: parseCron(def.schedule),
+                from,
+                to: now,
+                catchUp: def.catchUp,
+                catchUpWindowMs: def.catchUpWindow,
+            });
+            for (const slot of slots) {
+                await enqueueJob(db, defs, name, null, {
+                    runAt: slot,
+                    dedupeKey: String(slot),
+                });
+            }
+        }
+    }
+    async function fireOnFailed(def, input, error) {
+        if (!def.onFailed)
+            return;
+        try {
+            await def.onFailed(input, error, ctx);
+        }
+        catch (hookErr) {
+            console.error('[bunderstack] onFailed hook threw:', hookErr);
+        }
+    }
+    /** running rows whose lease expired → pending (or failed when exhausted). */
+    async function recoverExpiredLeases(now) {
+        const expired = await db
+            .select({
+            id: t.id,
+            type: t.type,
+            payloadJson: t.payloadJson,
+            attempts: t.attempts,
+            lastError: t.lastError,
+            runAt: t.runAt,
+        })
+            .from(t)
+            .where(and(eq(t.status, 'running'), isNotNull(t.lockedUntil), lt(t.lockedUntil, now)));
+        for (const row of expired) {
+            const def = definitionFor(defs, row.type);
+            const error = new Error('lease expired (worker crashed or timed out)');
+            if (!def) {
+                await db
+                    .update(t)
+                    .set({
+                    status: 'failed',
+                    finishedAt: now,
+                    lockedUntil: null,
+                    lastError: `unknown job type "${row.type}"`,
+                    dedupeKey: null,
+                })
+                    .where(eq(t.id, row.id));
+                continue;
+            }
+            if (Number(row.attempts) >= maxAttempts(def)) {
+                await db
+                    .update(t)
+                    .set({
+                    status: 'failed',
+                    finishedAt: now,
+                    lockedUntil: null,
+                    lastError: error.message,
+                    ...terminalPatch(),
+                })
+                    .where(eq(t.id, row.id));
+                await fireOnFailed(def, resolveInput(def, row), error);
+            }
+            else {
+                await db
+                    .update(t)
+                    .set({
+                    status: 'pending',
+                    lockedUntil: null,
+                    runAt: now + backoffMs(def, Number(row.attempts)),
+                    lastError: error.message,
+                })
+                    .where(eq(t.id, row.id));
+            }
+        }
+    }
+    async function reapSucceeded(now) {
+        await db
+            .delete(t)
+            .where(and(eq(t.status, 'succeeded'), lt(t.finishedAt, now - SUCCEEDED_RETENTION_MS)));
+    }
+    /** Atomically claim up to `limit` runnable jobs of one type. */
+    async function claim(type, limit, now, leaseUntil) {
+        const pendingIds = db
+            .select({ id: t.id })
+            .from(t)
+            .where(and(eq(t.type, type), eq(t.status, 'pending'), lte(t.runAt, now)))
+            .orderBy(t.runAt)
+            .limit(limit);
+        // PG: lock the selected rows so concurrent replicas skip them. SQLite's
+        // single-writer model makes the one-statement UPDATE atomic on its own.
+        const sub = is(db, PgDatabase)
+            ? pendingIds.for('update', { skipLocked: true })
+            : pendingIds;
+        const rows = await db
+            .update(t)
+            .set({
+            status: 'running',
+            lockedUntil: leaseUntil,
+            attempts: sql `${t.attempts} + 1`,
+        })
+            .where(and(inArray(t.id, sub), eq(t.status, 'pending')))
+            .returning({
+            id: t.id,
+            type: t.type,
+            payloadJson: t.payloadJson,
+            attempts: t.attempts,
+            runAt: t.runAt,
+        });
+        return rows;
+    }
+    // `now` is the tick's injected clock: retry runAt math uses it so tests can
+    // drive backoff deterministically. finishedAt uses the real clock (a handler
+    // may run long past the tick's start).
+    async function runJob(row, def, now, leaseUntil) {
+        let input;
+        try {
+            input = resolveInput(def, row);
+        }
+        catch (err) {
+            // Stored payload no longer parses (schema drift): retrying can't help.
+            const e = toError(err);
+            const updated = await db
+                .update(t)
+                .set({
+                status: 'failed',
+                finishedAt: Date.now(),
+                lockedUntil: null,
+                lastError: e.message,
+                ...terminalPatch(),
+            })
+                .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))
+                .returning({ id: t.id });
+            if (!updated[0])
+                return 'lost';
+            await fireOnFailed(def, undefined, e);
+            return 'failed';
+        }
+        try {
+            await def.handler(input, ctx);
+            const updated = await db
+                .update(t)
+                .set({
+                status: 'succeeded',
+                finishedAt: Date.now(),
+                lockedUntil: null,
+                ...terminalPatch(),
+            })
+                .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))
+                .returning({ id: t.id });
+            if (!updated[0])
+                return 'lost';
+            return 'ran';
+        }
+        catch (err) {
+            const e = toError(err);
+            if (Number(row.attempts) < maxAttempts(def)) {
+                const updated = await db
+                    .update(t)
+                    .set({
+                    status: 'pending',
+                    lockedUntil: null,
+                    runAt: now + backoffMs(def, Number(row.attempts)),
+                    lastError: e.message,
+                })
+                    .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))
+                    .returning({ id: t.id });
+                if (!updated[0])
+                    return 'lost';
+            }
+            else {
+                const updated = await db
+                    .update(t)
+                    .set({
+                    status: 'failed',
+                    finishedAt: Date.now(),
+                    lockedUntil: null,
+                    lastError: e.message,
+                    ...terminalPatch(),
+                })
+                    .where(and(eq(t.id, row.id), eq(t.lockedUntil, leaseUntil)))
+                    .returning({ id: t.id });
+                if (!updated[0])
+                    return 'lost';
+                await fireOnFailed(def, input, e);
+            }
+            return 'failed';
+        }
+    }
+    async function runClaimable(now) {
+        const work = [];
+        let totalClaimed = 0;
+        for (const [name, def] of Object.entries(defs)) {
+            const type = def.kind === 'cron' ? `${CRON_PREFIX}${name}` : name;
+            let limit = CLAIM_BATCH;
+            if (def.kind === 'job' && def.concurrency !== undefined) {
+                const runningRows = await db
+                    .select({ id: t.id })
+                    .from(t)
+                    .where(and(eq(t.type, type), eq(t.status, 'running')));
+                const capacity = def.concurrency - runningRows.length;
+                if (capacity <= 0)
+                    continue;
+                limit = Math.min(limit, capacity);
+            }
+            const leaseUntil = now + (def.timeout ?? DEFAULT_TIMEOUT_MS);
+            const claimed = await claim(type, limit, now, leaseUntil);
+            totalClaimed += claimed.length;
+            for (const row of claimed)
+                work.push(runJob(row, def, now, leaseUntil));
+        }
+        const outcomes = await Promise.all(work);
+        let ran = 0;
+        let failed = 0;
+        for (const outcome of outcomes) {
+            if (outcome === 'ran')
+                ran++;
+            else if (outcome === 'failed')
+                failed++;
+        }
+        return { claimed: totalClaimed, ran, failed };
+    }
+    return {
+        async tick(now = Date.now()) {
+            await materializeCronSlots(now);
+            await recoverExpiredLeases(now);
+            if (now - lastReapAt >= REAP_INTERVAL_MS) {
+                lastReapAt = now;
+                await reapSucceeded(now);
+            }
+            return runClaimable(now);
+        },
+        setJobsFacade(f) {
+            ctx.jobs = f;
+        },
+    };
+}
+//# sourceMappingURL=worker.js.map

package/dist/jobs/worker.js.map

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

package/dist/lifecycle.d.ts

@@ -0,0 +1,10 @@
+export type Cleanup = () => void | Promise<void>;
+export type LifecycleStatus = 'ready' | 'closing' | 'closed';
+export declare class Lifecycle {
+    #private;
+    get signal(): AbortSignal;
+    get status(): LifecycleStatus;
+    add(cleanup: Cleanup): () => void;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;AAChD,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE5D,qBAAa,SAAS;;IAMpB,IAAI,MAAM,IAAI,WAAW,CAExB;IAED,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,IAAI;IAQjC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBvB"}

package/dist/lifecycle.js

@@ -0,0 +1,37 @@
+export class Lifecycle {
+    #controller = new AbortController();
+    #status = 'ready';
+    #cleanups = new Set();
+    #closePromise;
+    get signal() {
+        return this.#controller.signal;
+    }
+    get status() {
+        return this.#status;
+    }
+    add(cleanup) {
+        if (this.#status !== 'ready') {
+            throw new Error('[bunderstack] application lifecycle is closed');
+        }
+        this.#cleanups.add(cleanup);
+        return () => this.#cleanups.delete(cleanup);
+    }
+    close() {
+        if (this.#closePromise)
+            return this.#closePromise;
+        this.#status = 'closing';
+        this.#controller.abort();
+        this.#closePromise = (async () => {
+            const cleanups = [...this.#cleanups].reverse();
+            this.#cleanups.clear();
+            const results = await Promise.allSettled(cleanups.map(async (cleanup) => cleanup()));
+            this.#status = 'closed';
+            const errors = results.flatMap((result) => result.status === 'rejected' ? [result.reason] : []);
+            if (errors.length > 0) {
+                throw new AggregateError(errors, '[bunderstack] lifecycle cleanup failed');
+            }
+        })();
+        return this.#closePromise;
+    }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,SAAS;IACpB,WAAW,GAAG,IAAI,eAAe,EAAE,CAAA;IACnC,OAAO,GAAoB,OAAO,CAAA;IAClC,SAAS,GAAG,IAAI,GAAG,EAAW,CAAA;IAC9B,aAAa,CAA2B;IAExC,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAA;IAChC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED,GAAG,CAAC,OAAgB;QAClB,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;QAClE,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QAC3B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC7C,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,IAAI,CAAC,aAAa,CAAA;QACjD,IAAI,CAAC,OAAO,GAAG,SAAS,CAAA;QACxB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAA;QACxB,IAAI,CAAC,aAAa,GAAG,CAAC,KAAK,IAAI,EAAE;YAC/B,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAA;YAC9C,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAA;YACtB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAC3C,CAAA;YACD,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAA;YACvB,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CACxC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CACpD,CAAA;YACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,cAAc,CACtB,MAAM,EACN,wCAAwC,CACzC,CAAA;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAA;QACJ,OAAO,IAAI,CAAC,aAAa,CAAA;IAC3B,CAAC;CACF"}

package/dist/list-query.d.ts

@@ -0,0 +1,62 @@
+import { getTableColumns, type SQL } from 'drizzle-orm';
+import type { ResolvedTableAccess, SortOrder } from './access.js';
+import type { AnyDb } from './dialect.js';
+/** Caps both `?limit=` and the number of values in an `IN` filter. */
+export declare const MAX_LIST_LIMIT = 200;
+/** Default page size when a request omits `limit`. */
+export declare const DEFAULT_LIST_LIMIT = 20;
+/**
+ * What a list procedure accepts. Shape and column types are enforced by the
+ * generated input schema, so by the time these params arrive they are already
+ * validated and coerced — this module only applies policy (defaults, the limit
+ * cap, cursor rules).
+ */
+export type ListParamsInput = {
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+    sort?: string;
+    order?: SortOrder;
+    q?: string;
+    count?: boolean;
+    filters?: Record<string, unknown>;
+};
+export type ParsedListParams = {
+    limit: number;
+    offset?: number;
+    sort: string;
+    order: SortOrder;
+    q: string;
+    cursor?: string;
+    count: boolean;
+    filters: Record<string, unknown>;
+};
+export type ListResult<T> = {
+    items: T[];
+    limit: number;
+    offset?: number;
+    cursor?: string;
+    nextCursor?: string;
+    hasMore: boolean;
+    total?: number;
+    q?: string;
+    sort: string;
+    order: SortOrder;
+};
+type CursorPayload = {
+    sort: string;
+    order: SortOrder;
+    v: string | number | null;
+    id: string | number;
+};
+/**
+ * Applies list policy to already-validated input: defaults, the limit cap, and
+ * the rules a schema cannot express (cursor excludes offset, and a cursor must
+ * agree with the sort it was minted for).
+ */
+export declare function resolveListParams(input: ListParamsInput, access: ResolvedTableAccess): ParsedListParams;
+export declare function encodeCursor(payload: CursorPayload): string;
+export declare function decodeCursor(cursor: string): CursorPayload;
+export declare function executeList<T extends Record<string, unknown>>(db: AnyDb, table: Parameters<typeof getTableColumns>[0], access: ResolvedTableAccess, params: ParsedListParams, idCol: unknown, scopeWhere?: SQL): Promise<ListResult<T>>;
+export {};
+//# sourceMappingURL=list-query.d.ts.map

package/dist/list-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-query.d.ts","sourceRoot":"","sources":["../src/list-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,eAAe,EASf,KAAK,GAAG,EACT,MAAM,aAAa,CAAA;AAGpB,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAA;AAItC,sEAAsE;AACtE,eAAO,MAAM,cAAc,MAAM,CAAA;AAEjC,sDAAsD;AACtD,eAAO,MAAM,kBAAkB,KAAK,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,CAAC,EAAE,MAAM,CAAA;IACT,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAC1B,KAAK,EAAE,CAAC,EAAE,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,OAAO,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;CACjB,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IACzB,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CACpB,CAAA;AAkBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,MAAM,EAAE,mBAAmB,GAC1B,gBAAgB,CA6BlB;AAiED,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAE3D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAU1D;AAqCD,wBAAsB,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,EAAE,EAAE,KAAK,EACT,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC,EAC5C,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,OAAO,EACd,UAAU,CAAC,EAAE,GAAG,GACf,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CA+ExB"}