@kelpie/server 0.12.0 → 0.14.0

package/dist/runtime/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/runtime/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/runtime/events.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAGpD,OAAO,QAAQ,MAAM,UAAU,CAAA;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGjD;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ;IACR,SAAS;IACT,UAAU;IACV,MAAM;IACN,SAAS;IACT,aAAa;IACb,aAAa;IACb,OAAO;IACP,MAAM;IACN,WAAW;IACX,OAAO;IACP,YAAY;IACZ,eAAe;IACf,MAAM;CACE,CAAA;AAoDV;;;;;;;GAOG;AACH,MAAM,YAAY,GAAG,IAAI,iBAAiB,EAA8B,CAAA;AAExE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAA;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAiC,EACjC,IAAY,EACZ,MAAmB,EACnB,QAAgB;IAEhB,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAA;IAC1B,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC;YAC5F,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAA;QAC3B,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;AACvB,CAAC;AA2DD,MAAM,0BAA0B,GAAG,IAAI,CAAA;AA0BvC,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,OAAO,GAAoB,EAAE;IAC1E,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAkC,CAAA;IAC/D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAmB,CAAA;IAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,MAAM,cAAc,GAAoB,EAAE,CAAA;IAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAA;IAC5C,MAAM,gBAAgB,GAAG,OAAO,CAAC,uBAAuB,IAAI,0BAA0B,CAAA;IAEtF,SAAS,IAAI,CACX,KAAa,EACb,SAAiB,EACjB,OAA+C,EAC/C,OAA4D;QAE5D,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;YACrB,IAAI,WAAuC,CAAA;YAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,CAAA;YAClC,MAAM,KAAK,GAAG,IAAI,OAAO,CAAkB,CAAC,OAAO,EAAE,EAAE;gBACrD,WAAW,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAA;gBAC5D,WAAW,CAAC,KAAK,EAAE,EAAE,CAAA;YACvB,CAAC,CAAC,CAAA;YAEF,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;oBACjC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;oBAC5C,KAAK;iBACN,CAAC,CAAA;gBACF,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACzB,MAAM,CAAC,KAAK,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;gBAClF,CAAC;YACH,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE;oBACnC,KAAK;oBACL,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC;oBAC5B,GAAG,OAAO,CAAC,KAAK,CAAC;iBAClB,CAAC,CAAA;YACJ,CAAC;oBAAS,CAAC;gBACT,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAC9B,YAAY,CAAC,WAAW,CAAC,CAAA;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC,CAAA;IACH,CAAC;IAED,OAAO;QACL,eAAe,CAAC,OAAO;YACrB,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC5D,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBACjC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;oBAC3B,MAAM,IAAI,KAAK,CACb,UAAU,IAAI,iCAAiC,QAAQ,iBAAiB,OAAO,CAAC,QAAQ,GAAG,CAC5F,CAAA;gBACH,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAA;gBAClC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YAC3B,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,IAAI;YACX,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC1B,CAAC;QAED,SAAS,CAAC,IAAI;YACZ,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC1B,CAAC;QAED,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,gBAAgB;YACvC,MAAM,KAAK,GAAG,gBAAgB,EAAE,KAAK,IAAI,IAAI,CAAA;YAC7C,MAAM,SAAS,GAAG,gBAAgB,EAAE,SAAS,IAAI,gBAAgB,CAAA;YACjE,MAAM,OAAO,GAAG,IAAI,CAClB,KAAK,EACL,SAAS,EACT,CAAC,KAAK,EAAE,EAAE;gBACR,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAoC,CAAA;gBAC3D,OAAO,OAAO,CAAC,QAAiB,CAAC,CAAA;YACnC,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;gBACR,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAoC,CAAA;gBAC3D,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,EAAE,CAAA;YACvD,CAAC,CACF,CAAA;YACD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC5B,CAAC;QAED,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,gBAAgB;YAC/C,MAAM,KAAK,GAAG,gBAAgB,EAAE,KAAK,IAAI,GAAG,MAAM,GAAG,CAAA;YACrD,MAAM,SAAS,GAAG,gBAAgB,EAAE,SAAS,IAAI,gBAAgB,CAAA;YACjE,cAAc,CAAC,IAAI,CAAC;gBAClB,MAAM;gBACN,KAAK;gBACL,GAAG,EAAE,IAAI,CACP,KAAK,EACL,SAAS,EACT,OAAO,EACP,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CACtD;aACF,CAAC,CAAA;QACJ,CAAC;QAED,OAAO,CAAC,KAAK;YACX,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAA;YAC5C,MAAM,KAAK,GAAsB;gBAC/B,GAAG,MAAM;gBACT;oBACE,EAAE,EAAE,KAAK,CAAC,EAAE;oBACZ,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI;oBAC7B,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;iBAC1B;aACF,CAAA;YAED,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;YACtF,MAAM,UAAU,GAAG,KAAqC,CAAA;YAExD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAC3C,OAAO,CAAC,UAAU,CAAC;gBACjB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,UAAU,CAAC;gBACrC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;aAClD,CAAC,CACH,CAAA;YAED,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACrB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE;gBACxB,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;YAC1B,CAAC,CAAC,CAAA;YAEF,OAAO,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAA;QACtC,CAAC;QAED,KAAK,CAAC,KAAK;YACT,0EAA0E;YAC1E,iDAAiD;YACjD,OAAO,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACzB,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAA;YACzC,CAAC;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/runtime/jobs.d.ts

@@ -0,0 +1,63 @@
+import type { Logger } from '../lib/logger.ts';
+import type { EnqueueOptions, JobHandle, JobRegistry } from '../lib/jobs.ts';
+import type { Transaction } from './transaction.ts';
+export interface JobsRuntimeOptions {
+    readonly connectionString: string;
+    readonly logger: Logger;
+    /**
+     * Polling floor. LISTEN/NOTIFY wakes a worker immediately when a job is
+     * inserted via `send()`, but pg-boss's own retry re-insert (inside
+     * `fail()`) never notifies, so a retried job is only ever picked up by
+     * this poll — as is a fresh job if the listener never opened. Also used
+     * as pg-boss's `notifyPollingIntervalSeconds`, so NOTIFY-active queues
+     * poll no slower than this either. Default 2s in production; tests pass
+     * a shorter value so a retry runs within the test's own budget.
+     */
+    readonly pollingIntervalSeconds?: number;
+    /**
+     * How many workers the runtime spins up per handle when a definition does
+     * not override `defaults.localConcurrency`. Matches pg-boss's default.
+     */
+    readonly defaultLocalConcurrency?: number;
+}
+export interface JobsRuntime {
+    /** The port modules bind to at register time. */
+    readonly registry: JobRegistry;
+    /** True once `register` has been called with this name. Used by tests. */
+    hasHandle(name: string): boolean;
+    /**
+     * Applies pg-boss's own schema migration. Idempotent: safe to run on every
+     * boot. Uses a throwaway `PgBoss` in `migrate: true, createSchema: true`
+     * mode, matching the release-command flow the cloud runs.
+     */
+    migrate(): Promise<void>;
+    /**
+     * Opens the persistent pg-boss instance and declares every registered
+     * queue plus its dead-letter counterpart. Must run before `enqueueOnTx`
+     * or `startWorking`. `migrate: false` here: `migrate()` above owns that
+     * step, so instances never race the migration.
+     */
+    start(): Promise<void>;
+    /**
+     * Starts the `work()` loop for every registered handle. The worker entry
+     * point calls this; the API calls it too unless `--no-worker` is set.
+     * Handler errors are logged and rethrown so pg-boss retries or
+     * dead-letters the job.
+     */
+    startWorking(): Promise<void>;
+    /**
+     * Enqueues a job on the caller's transaction via `fromDrizzle(tx, sql)`.
+     * The insert commits with the surrounding write; a rollback discards it.
+     * Rejects when no `handle` was registered for `name` (this would be a
+     * boot-time bug, not a runtime one).
+     */
+    enqueueOnTx<Data>(tx: Transaction, handle: JobHandle<Data>, data: Data, options?: EnqueueOptions): Promise<string | null>;
+    /**
+     * Drains in-flight work and closes the pg-boss instance. `offWork({wait:
+     * true})` awaits every handler mid-flight; `boss.stop` then tears down
+     * the connection pool.
+     */
+    stop(): Promise<void>;
+}
+export declare function createJobsRuntime(options: JobsRuntimeOptions): JobsRuntime;
+//# sourceMappingURL=jobs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/runtime/jobs.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,KAAK,EACV,cAAc,EAGd,SAAS,EACT,WAAW,EACZ,MAAM,gBAAgB,CAAA;AAEvB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAqCnD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;IACxC;;;OAGG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;CAC1C;AAED,MAAM,WAAW,WAAW;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAA;IAC9B,0EAA0E;IAC1E,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAChC;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB;;;;;OAKG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7B;;;;;OAKG;IACH,WAAW,CAAC,IAAI,EACd,EAAE,EAAE,WAAW,EACf,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EACvB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IACzB;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAiP1E"}

package/dist/runtime/jobs.js

@@ -0,0 +1,231 @@
+import { sql } from 'drizzle-orm';
+import { PgBoss, fromDrizzle } from 'pg-boss';
+import { describeThrown } from '../lib/errors.js';
+import { deadLetterQueueName } from '../lib/jobs.js';
+/**
+ * The pg-boss provider that binds the job port defined in `lib/jobs.ts` to a
+ * real Postgres-backed queue.
+ *
+ * Two phases:
+ *
+ * 1. Registration, at boot. Modules call `context.jobs.define(...)` during
+ *    `register`. The registry records the definition (fails boot on a
+ *    duplicate name) and returns the handle. Nothing touches the database
+ *    yet.
+ * 2. `start()`, from the entry point. Opens the pg-boss instance, primes the
+ *    queue cache, and calls `createQueue` for every registered handle plus
+ *    its dead-letter queue. Idempotent (`create_queue` upserts).
+ *
+ * The API and the worker both call `start()`: the API needs a boss instance
+ * to insert jobs on request-scoped transactions; the worker adds a
+ * `startWorking()` step that runs `work()` per handle.
+ *
+ * @see modules.md for how jobs sit next to the event bus.
+ */
+/**
+ * The pg-boss schema name. Fixed here rather than configurable per assembly:
+ * self-hosters run one Postgres per Kelpie install and would gain nothing
+ * from renaming the schema.
+ */
+const PGBOSS_SCHEMA = 'pgboss';
+const DEFAULT_LOCAL_CONCURRENCY = 5;
+export function createJobsRuntime(options) {
+    const registered = new Map();
+    // Tracks which handles have had `createQueue` run and which have had
+    // `work()` called, so a runtime that registers a fresh handle after
+    // `start()` (a test that adds one mid-suite) still gets its queue built
+    // and its worker started without redoing the ones already up.
+    const queuesCreated = new Set();
+    const workersStarted = new Set();
+    let boss;
+    function requireBoss() {
+        if (boss === undefined) {
+            throw new Error('jobs runtime used before start(): call jobs.start() at boot');
+        }
+        return boss;
+    }
+    const registry = {
+        define(definition) {
+            if (registered.has(definition.name)) {
+                throw new Error(`job "${definition.name}" is defined twice`);
+            }
+            const handle = { name: definition.name };
+            registered.set(definition.name, {
+                definition: definition,
+                handle: handle,
+            });
+            return handle;
+        },
+    };
+    async function migrate() {
+        // A throwaway instance in migrate/createSchema mode. Cheaper than
+        // vendoring the SQL: pg-boss owns its schema, and `getConstructionPlans`
+        // / `getMigrationPlans` produce statements we would just execute in the
+        // same order the library does itself. `supervise: false, schedule: false`
+        // keeps the instance from spawning any background work while it lives.
+        const migrator = new PgBoss({
+            connectionString: options.connectionString,
+            schema: PGBOSS_SCHEMA,
+            migrate: true,
+            createSchema: true,
+            supervise: false,
+            schedule: false,
+        });
+        try {
+            await migrator.start();
+        }
+        finally {
+            await migrator.stop({ graceful: false, close: true, timeout: 5_000 });
+        }
+    }
+    async function ensureQueuesFor(instance) {
+        for (const { definition } of registered.values()) {
+            if (queuesCreated.has(definition.name)) {
+                continue;
+            }
+            const deadLetter = deadLetterQueueName(definition.name);
+            // Dead letter queue must exist before the main queue references it.
+            await instance.createQueue(deadLetter, {
+                policy: 'standard',
+                notify: false,
+            });
+            await instance.createQueue(definition.name, {
+                policy: 'standard',
+                deadLetter,
+                notify: true,
+                ...(definition.defaults?.retryLimit === undefined
+                    ? {}
+                    : { retryLimit: definition.defaults.retryLimit }),
+                ...(definition.defaults?.retryDelay === undefined
+                    ? {}
+                    : { retryDelay: definition.defaults.retryDelay }),
+                ...(definition.defaults?.retryBackoff === undefined
+                    ? {}
+                    : { retryBackoff: definition.defaults.retryBackoff }),
+                ...(definition.defaults?.retryDelayMax === undefined
+                    ? {}
+                    : { retryDelayMax: definition.defaults.retryDelayMax }),
+                ...(definition.defaults?.expireInSeconds === undefined
+                    ? {}
+                    : { expireInSeconds: definition.defaults.expireInSeconds }),
+            });
+            queuesCreated.add(definition.name);
+        }
+    }
+    async function start() {
+        if (boss === undefined) {
+            const instance = new PgBoss({
+                connectionString: options.connectionString,
+                schema: PGBOSS_SCHEMA,
+                migrate: false,
+                createSchema: false,
+                supervise: false,
+                schedule: false,
+                useListenNotify: true,
+            });
+            instance.on('error', (error) => {
+                options.logger.error('pg-boss error', { error: describeThrown(error) });
+            });
+            await instance.start();
+            boss = instance;
+        }
+        await ensureQueuesFor(boss);
+    }
+    async function startWorking() {
+        const instance = requireBoss();
+        const pollingIntervalSeconds = options.pollingIntervalSeconds ?? 2;
+        const defaultLocalConcurrency = options.defaultLocalConcurrency ?? DEFAULT_LOCAL_CONCURRENCY;
+        for (const { definition } of registered.values()) {
+            if (workersStarted.has(definition.name)) {
+                continue;
+            }
+            const localConcurrency = definition.defaults?.localConcurrency ?? defaultLocalConcurrency;
+            await instance.work(definition.name, {
+                batchSize: 1,
+                localConcurrency,
+                pollingIntervalSeconds,
+                notifyPollingIntervalSeconds: pollingIntervalSeconds,
+            }, async (batch) => {
+                const job = batch[0];
+                if (job === undefined) {
+                    return;
+                }
+                const parsed = definition.schema.safeParse(job.data);
+                if (!parsed.success) {
+                    options.logger.error('job payload rejected by schema', {
+                        job: definition.name,
+                        id: job.id,
+                        issues: parsed.error.issues,
+                    });
+                    throw new Error(`job "${definition.name}" payload does not match its schema: ${parsed.error.issues
+                        .map((issue) => issue.message)
+                        .join('; ')}`);
+                }
+                const jobLogger = options.logger.child({ job: definition.name, jobId: job.id });
+                const context = {
+                    id: job.id,
+                    data: parsed.data,
+                    log: jobLogger,
+                    signal: job.signal,
+                };
+                try {
+                    await definition.handler(context);
+                }
+                catch (error) {
+                    jobLogger.error('job handler failed', { error: describeThrown(error) });
+                    throw error;
+                }
+            });
+            workersStarted.add(definition.name);
+        }
+    }
+    async function enqueueOnTx(tx, handle, data, enqueueOptions = {}) {
+        const instance = requireBoss();
+        const entry = registered.get(handle.name);
+        if (entry === undefined) {
+            throw new Error(`enqueue for unregistered job "${handle.name}"`);
+        }
+        return instance.send(handle.name, data, {
+            db: fromDrizzle(tx, sql),
+            ...(enqueueOptions.retryLimit === undefined ? {} : { retryLimit: enqueueOptions.retryLimit }),
+            ...(enqueueOptions.retryBackoff === undefined
+                ? {}
+                : { retryBackoff: enqueueOptions.retryBackoff }),
+            ...(enqueueOptions.singletonKey === undefined
+                ? {}
+                : { singletonKey: enqueueOptions.singletonKey }),
+            ...(enqueueOptions.startAfter === undefined ? {} : { startAfter: enqueueOptions.startAfter }),
+        });
+    }
+    async function stop() {
+        const instance = boss;
+        if (instance === undefined) {
+            return;
+        }
+        for (const name of workersStarted) {
+            try {
+                await instance.offWork(name, { wait: true });
+            }
+            catch (error) {
+                options.logger.error('offWork failed', {
+                    job: name,
+                    error: describeThrown(error),
+                });
+            }
+        }
+        workersStarted.clear();
+        await instance.stop({ graceful: true, close: true, timeout: 30_000 });
+        boss = undefined;
+        queuesCreated.clear();
+    }
+    return {
+        registry,
+        hasHandle: (name) => registered.has(name),
+        migrate,
+        start,
+        startWorking,
+        enqueueOnTx,
+        stop,
+    };
+}
+//# sourceMappingURL=jobs.js.map

package/dist/runtime/jobs.js.map

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

package/dist/runtime/module.d.ts

@@ -4,6 +4,7 @@ import type { Actor } from '../lib/actor.ts';
 import type { Database } from '../lib/database.ts';
 import type { EmailSender } from '../lib/email.ts';
 import type { IdFactory } from '../lib/ids.ts';
+import type { JobRegistry } from '../lib/jobs.ts';
 import type { Logger } from '../lib/logger.ts';
 import type { SecretEncryptionConfig } from '../lib/secrets.ts';
 import type { EntitlementRegistry } from './entitlements.ts';
@@ -119,6 +120,14 @@ export interface ModuleServices {
      * `secretEncryption`. Same fallback pattern as `appBaseUrl`.
      */
     readonly secretEncryption?: SecretEncryptionConfig | undefined;
+    /**
+     * Whether the instance accepts a brand-new account, from `kelpie.config.ts`'s
+     * `signups` (or `SIGNUPS`). Undefined defaults to `true` (open), the same
+     * default `loadConfig` and `resolveKelpieConfig` use, so a caller that has
+     * not thought about it — a test, an older assembly — sees no change in
+     * behaviour.
+     */
+    readonly signupsEnabled?: boolean;
 }
 export interface ModuleContext extends ModuleServices {
     /** Registers routes. They mount under `/v1` and are public API like any other. */
@@ -217,6 +226,17 @@ export interface ModuleContext extends ModuleServices {
      * commits, and must be idempotent.
      */
     readonly events: EventBus;
+    /**
+     * Declares a background job. Modules call `context.jobs.define(...)` at
+     * register time and receive a typed handle to enqueue against. The insert
+     * lives inside the caller's transaction (`services.transaction`) so a
+     * rollback discards the job.
+     *
+     * A second `define` with the same name fails boot. Handlers run out of
+     * process on the worker entry point, or inline when the API runs its own
+     * worker.
+     */
+    readonly jobs: JobRegistry;
     /**
      * Declare capabilities and check grants. Every check is granted and unlimited
      * until a module registers a provider.

package/dist/runtime/module.d.ts.map

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

package/dist/runtime/registry.d.ts

@@ -3,6 +3,7 @@ import type { Context, Handler, MiddlewareHandler } from 'hono';
 import type { Actor } from '../lib/actor.ts';
 import type { Environment } from '../lib/config.ts';
 import type { EmailSender } from '../lib/email.ts';
+import type { JobRegistry } from '../lib/jobs.ts';
 import type { Logger } from '../lib/logger.ts';
 import type { EntitlementRegistry } from './entitlements.ts';
 import type { EventBus } from './events.ts';
@@ -85,6 +86,13 @@ export interface ModuleRuntimeOptions {
      * two modules had registered it.
      */
     readonly additionalEmailProviders?: ReadonlyMap<string, EmailSender> | undefined;
+    /**
+     * The job registry modules bind to at register time. Bound to the pg-boss
+     * runtime in production (`runtime/jobs.ts`) and to a stub in unit tests
+     * that never define a job. A module that calls `context.jobs.define` when
+     * this is absent gets a boot-time error naming the module.
+     */
+    readonly jobs?: JobRegistry | undefined;
     /**
      * The deploy-time module override (`lib/moduleConfig.ts`), parsed. A locked
      * module id wins over whatever a workspace's own settings say.

package/dist/runtime/registry.d.ts.map

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

package/dist/runtime/registry.js

@@ -25,6 +25,97 @@ function assertMountablePath(moduleId, kind, path) {
         }
     }
 }
+/** Verb methods a module can call on the router — full Hono set. */
+const ROUTER_VERB_METHODS = ['get', 'post', 'put', 'patch', 'delete', 'options', 'all'];
+function isRouterVerbMethod(name) {
+    return ROUTER_VERB_METHODS.includes(name);
+}
+/**
+ * Wraps a Hono router so every route the module registers runs `gate` first,
+ * and only that module's own routes. The straightforward alternative —
+ * `router.use('*', gate)` — attaches at `/v1/*` on the app once the router is
+ * mounted (Hono flattens sub-routers onto the parent prefix), so the gate
+ * fires for every module's routes, not just this module's. Prepending the gate
+ * to each declared route keeps the check local.
+ *
+ * The full router surface is covered so a future contributor cannot silently
+ * reintroduce the leak by reaching for a method that was not wrapped:
+ *
+ * - HTTP verbs and `on`: prepend `gate`, then the module's handlers.
+ * - `use(pattern, ...)` at a specific path: prepend `gate`, then the mw.
+ * - `route(subPath, subApp)`: recursively wrap `subApp` before mounting, so
+ *   every route it contributes still runs the gate first.
+ *
+ * And the calls that cannot be made module-local through wrapping fail at
+ * boot with a message naming the module, rather than shipping a subtle leak:
+ *
+ * - `use()` with no path, `use('*')`, `use('/*')`, `use('/')`: any of these
+ *   register a middleware at `/v1/*` on the parent app once the router is
+ *   mounted — the exact bug this wrapper prevents. A module that wants to
+ *   share middleware across many of its routes must name a specific path
+ *   (`/things/*`) or attach the middleware per route.
+ * - `notFound` / `onError`: fire for every unmatched or failing `/v1`
+ *   request once the router is flattened, so a module's handler would run
+ *   for other modules' traffic. Handle failures inside the module's own
+ *   route handlers instead.
+ */
+function gateRouter(router, moduleId, gate) {
+    const proxy = new Proxy(router, {
+        get(target, property, receiver) {
+            if (typeof property !== 'string') {
+                return Reflect.get(target, property, receiver);
+            }
+            if (isRouterVerbMethod(property)) {
+                return (path, ...handlers) => {
+                    const method = target[property];
+                    method.call(target, path, gate, ...handlers);
+                    return proxy;
+                };
+            }
+            if (property === 'on') {
+                return (method, path, ...handlers) => {
+                    target.on(method, path, gate, ...handlers);
+                    return proxy;
+                };
+            }
+            if (property === 'use') {
+                return (...args) => {
+                    const first = args[0];
+                    const isAppWide = typeof first !== 'string' || first === '*' || first === '/*' || first === '/';
+                    if (isAppWide) {
+                        throw new ModuleBootError([
+                            `module "${moduleId}" called router.use() with an app-wide pattern (${typeof first === 'string' ? `"${first}"` : 'no path'}). Hono flattens the module router onto "/v1", so this would fire for every module's routes. Name a specific path ("/things/*") or attach middleware per route.`,
+                        ]);
+                    }
+                    const [pattern, ...handlers] = args;
+                    target.use(pattern, gate, ...handlers);
+                    return proxy;
+                };
+            }
+            if (property === 'route') {
+                return (path, subApp) => {
+                    // The sub-app's routes were registered on it before this call, so a
+                    // proxy over `subApp` cannot retroactively prepend the gate to them.
+                    // Instead attach the gate as middleware scoped to the sub-router's
+                    // mount prefix on this router — once flattened onto `/v1`, the
+                    // middleware covers exactly `/v1${path}/*`, which is the module's
+                    // own routes. `use` must land before `route` so composition order
+                    // runs the gate first.
+                    target.use(`${path.replace(/\/+$/, '')}/*`, gate);
+                    target.route(path, subApp);
+                    return proxy;
+                };
+            }
+            if (property === 'notFound' || property === 'onError') {
+                throw new ModuleBootError([
+                    `module "${moduleId}" called router.${property}(). A module router's ${property} fires for every unmatched or failing "/v1" request once the router is mounted; handle failures inside the module's own route handlers instead.`,
+                ]);
+            }
+            return Reflect.get(target, property, receiver);
+        },
+    });
+    return proxy;
+}
 /**
  * The email sender every module writes through. `target` is set once, after
  * all modules have registered, from the provider `email.provider` picked. Until
@@ -79,10 +170,25 @@ class ExternalSignInProxy {
  * that tries to register under this name fails boot.
  */
 const LOG_PROVIDER_NAME = 'log';
+/**
+ * Refuses `define` for a module that reached `context.jobs` when the runtime
+ * booted without a jobs registry. Named so a boot log points at the module
+ * whose declaration cannot be honoured, rather than a bare stack trace.
+ */
+function createMissingJobsRegistry(moduleId) {
+    return {
+        define() {
+            throw new ModuleBootError([
+                `module "${moduleId}" defines a job but the assembly booted without a jobs runtime`,
+            ]);
+        },
+    };
+}
 function createModuleContext(module, accumulator, options, events, entitlements, moduleCatalog, emailProxy, providers, externalSignIn) {
     return {
         ...options.services,
         email: emailProxy,
+        jobs: options.jobs ?? createMissingJobsRegistry(module.id),
         provideExternalSignIn(handler) {
             externalSignIn.install(module.id, handler);
         },
@@ -105,19 +211,23 @@ function createModuleContext(module, accumulator, options, events, entitlements,
         },
         routes(mount) {
             const router = new Hono();
-            // Gate first, so it runs before anything `mount` adds: Hono composes a
-            // path's handlers in the order they were registered on this router,
-            // middleware included, and registering after the routes it should guard
-            // would run it too late to block them.
+            // Gate must run before anything `mount` adds. A `router.use('*', gate)`
+            // here would attach at `/v1/*` on the app after mounting (Hono flattens
+            // the sub-router onto the parent prefix), which would fire the gate for
+            // every module's routes, not just this one's. So the gate is prepended
+            // to each individual route through `gateRouter` instead.
             if (module.structural !== true && options.resolveActor !== undefined) {
                 const { resolveActor } = options;
-                router.use('*', async (context, next) => {
+                const gate = async (context, next) => {
                     const actor = await resolveActor(context);
                     await requireCapability(entitlements, requireWorkspaceId(actor), moduleCapabilityName(module.id));
                     await next();
-                });
+                };
+                mount(gateRouter(router, module.id, gate));
+            }
+            else {
+                mount(router);
             }
-            mount(router);
             accumulator.routers.push({ moduleId: module.id, router });
         },
         publicRoutes(mount) {