@kelpie/server 0.13.0 → 0.15.0

package/dist/boot.d.ts

@@ -4,6 +4,7 @@ import type { IdFactory } from './lib/ids.ts';
 import type { KelpieConfigInput } from './lib/kelpieConfigFile.ts';
 import type { Logger } from './lib/logger.ts';
 import type { CredentialDependencies } from './modules/auth/credentials.ts';
+import type { JobsRuntime } from './runtime/jobs.ts';
 import type { ModuleContributions } from './runtime/registry.ts';
 /**
  * A resolved assembly: config parsed, database connected, modules registered.
@@ -24,6 +25,14 @@ export interface AssemblyBoot {
     readonly createId: IdFactory;
     readonly credentials: CredentialDependencies;
     readonly contributions: ModuleContributions;
+    /**
+     * The pg-boss-backed job runtime the modules registered against. The
+     * entry point owns its lifecycle: call `jobs.migrate()` alongside
+     * `runMigrations`, `jobs.start()` before serving, and — on the worker —
+     * `jobs.startWorking()` right after. `jobs.stop()` drains before
+     * `database.close()`.
+     */
+    readonly jobs: JobsRuntime;
 }
 /**
  * Resolves an assembly's config, connects the database, and runs the module

package/dist/boot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAG7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAG3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAGhE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAA;IAC5C,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAA;CAC5C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,iBAAiB,EAC/B,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,YAAY,CAAC,CAmCvB"}
+{"version":3,"file":"boot.d.ts","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAEhE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAE3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAElE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAG7C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAG3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAGhE;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;IAC5B,QAAQ,CAAC,WAAW,EAAE,sBAAsB,CAAA;IAC5C,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAA;IAC3C;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAC3B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAChC,YAAY,EAAE,iBAAiB,EAC/B,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,YAAY,CAAC,CA2CvB"}

package/dist/boot.js

@@ -5,6 +5,7 @@ import { createLogger, createTransportForDestination } from './lib/logger.js';
 import { readModuleConfigFile } from './lib/moduleConfig.js';
 import { resolveActorFrom } from './modules/auth/credentials.js';
 import { createEventBus } from './runtime/events.js';
+import { createJobsRuntime } from './runtime/jobs.js';
 import { registerModules } from './runtime/registry.js';
 import { createTransactionScope } from './runtime/transaction.js';
 /**
@@ -28,6 +29,7 @@ export async function bootAssembly(kelpieConfig, environment) {
     });
     const database = connectDatabase(config.databaseUrl, logger);
     const events = createEventBus(logger);
+    const jobs = createJobsRuntime({ connectionString: config.databaseUrl, logger });
     const createId = createIdFactory();
     const credentials = { db: database.db, now: () => new Date() };
     const moduleConfig = readModuleConfigFile(config.moduleConfigPath);
@@ -37,10 +39,17 @@ export async function bootAssembly(kelpieConfig, environment) {
         logger,
         events,
         moduleConfig,
+        jobs: jobs.registry,
         resolveActor: (context) => resolveActorFrom(credentials, context),
         services: {
             db: database.db,
-            transaction: createTransactionScope({ db: database.db, bus: events, logger, createId }),
+            transaction: createTransactionScope({
+                db: database.db,
+                bus: events,
+                logger,
+                createId,
+                enqueueOnTx: jobs.enqueueOnTx,
+            }),
             createId,
             now: () => new Date(),
             appBaseUrl: config.appBaseUrl,
@@ -53,6 +62,6 @@ export async function bootAssembly(kelpieConfig, environment) {
         // `kelpie.config.ts`. `from` is the address on every outgoing message.
         email: { provider: config.email.EMAIL_PROVIDER, from: config.email.EMAIL_FROM },
     });
-    return { config, logger, database, createId, credentials, contributions };
+    return { config, logger, database, createId, credentials, contributions, jobs };
 }
 //# sourceMappingURL=boot.js.map

package/dist/boot.js.map

@@ -1 +1 @@
-{"version":3,"file":"boot.js","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAE/D,OAAO,EAAE,YAAY,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAA;AAE7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAEhE,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAuBjE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,YAA+B,EAC/B,WAAwB;IAExB,MAAM,MAAM,GAAG,mBAAmB,CAAC,YAAY,EAAE,WAAW,CAAC,CAAA;IAC7D,MAAM,MAAM,GAAG,YAAY,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;QAC3B,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,6BAA6B,CAAC;KAC3E,CAAC,CAAA;IACF,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IAC5D,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAA;IACrC,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAA;IAClC,MAAM,WAAW,GAA2B,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAA;IACtF,MAAM,YAAY,GAAG,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAA;IAClE,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC;QAC1C,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,WAAW,EAAE,MAAM,CAAC,GAAG;QACvB,MAAM;QACN,MAAM;QACN,YAAY;QACZ,YAAY,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,WAAW,EAAE,OAAO,CAAC;QACjE,QAAQ,EAAE;YACR,EAAE,EAAE,QAAQ,CAAC,EAAE;YACf,WAAW,EAAE,sBAAsB,CAAC,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YACvF,QAAQ;YACR,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;YACzC,cAAc,EAAE,MAAM,CAAC,OAAO,KAAK,MAAM;SAC1C;QACD,0EAA0E;QAC1E,qEAAqE;QACrE,uEAAuE;QACvE,uEAAuE;QACvE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,cAAc,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE;KAChF,CAAC,CAAA;IAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,CAAA;AAC3E,CAAC"}
+{"version":3,"file":"boot.js","sourceRoot":"","sources":["../src/boot.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -3,6 +3,11 @@ export { createApp } from './app.ts';
 export type { AppDependencies, AppBindings } from './app.ts';
 export { bootAssembly } from './boot.ts';
 export type { AssemblyBoot } from './boot.ts';
+export { startWorker } from './worker.ts';
+export { createJobsRuntime } from './runtime/jobs.ts';
+export type { JobsRuntime, JobsRuntimeOptions } from './runtime/jobs.ts';
+export { deadLetterQueueName } from './lib/jobs.ts';
+export type { EnqueueOptions, JobContext, JobDefaults, JobDefinition, JobHandle, JobHandler, JobRegistry, TransactionJobs, } from './lib/jobs.ts';
 export { WebBundleError, serveWebBundle } from './webBundle.ts';
 export type { WebBundleOptions } from './webBundle.ts';
 export { ConfigurationError, loadConfig } from './lib/config.ts';
@@ -41,7 +46,7 @@ export { RECORD_OBJECT_TYPES, checkEventCycle, createEventBus, currentEventChain
 export type { AnyEventHandler, CycleGuardOutcome, EventBus, EventBusOptions, EventCatalog, EventChainEntry, EventHandler, EventName, KelpieEventMap, RecordObjectType, SubscribeOptions, } from './runtime/events.ts';
 export type { ModuleEventCatalog } from './runtime/module.ts';
 export { createTransactionScope } from './runtime/transaction.ts';
-export type { BufferedEvents, Transaction, TransactionContext, TransactionOptions, TransactionScope, TransactionScopeDependencies, } from './runtime/transaction.ts';
+export type { BufferedEvents, EnqueueOnTransaction, Transaction, TransactionContext, TransactionOptions, TransactionScope, TransactionScopeDependencies, } from './runtime/transaction.ts';
 export { planMigrations, runMigrations } from './runtime/migrate.ts';
 export type { MigrationPlanStep } from './runtime/migrate.ts';
 export { coreMigrationsDirectory, coreModules } from './modules/core.ts';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -4,6 +4,9 @@
 import './modules/eventCatalogs.js';
 export { createApp } from './app.js';
 export { bootAssembly } from './boot.js';
+export { startWorker } from './worker.js';
+export { createJobsRuntime } from './runtime/jobs.js';
+export { deadLetterQueueName } from './lib/jobs.js';
 export { WebBundleError, serveWebBundle } from './webBundle.js';
 export { ConfigurationError, loadConfig } from './lib/config.js';
 export { fromEnv, isFromEnvMarker, resolveMarker, resolveMarkers } from './lib/fromEnv.js';

package/dist/index.js.map

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

package/dist/lib/jobs.d.ts

@@ -0,0 +1,110 @@
+import type { ZodType } from 'zod';
+import type { Logger } from './logger.ts';
+/**
+ * The port core runs background work through.
+ *
+ * A module declares a handle at register time with `context.jobs.define(...)`
+ * and enqueues against it from a service. The insert lives inside the same
+ * Drizzle transaction as the write it belongs to, so a rolled-back write
+ * never leaves an orphan job behind. Handlers run out of process — on the
+ * worker entry point, or inline when the API runs its own worker — and see
+ * the same payload the caller passed, validated against the module's Zod
+ * schema before it reaches user code.
+ *
+ * The port itself knows nothing about pg-boss. `runtime/jobs.ts` binds it to
+ * a real provider at boot; tests bind it to a stub. Nothing outside the
+ * runtime imports the provider directly.
+ *
+ * Why a handle rather than a global name map: consumers of `@kelpie/server`
+ * installed from npm lost the `KelpieEventMap` augmentation until every
+ * catalog was pulled in from the entry point (see
+ * `modules/eventCatalogs.ts`). A handle keeps the payload type on the value
+ * the module exports, so `enqueue(handle, data)` typechecks without
+ * declaration merging across the package boundary.
+ */
+/**
+ * Marker property carrying the handle's payload type. Never assigned at
+ * runtime; the `?` on the property makes an untagged plain object satisfy the
+ * shape at read time, so a stub handle in a test can be built without
+ * `unsafeCast`.
+ */
+declare const JobHandleDataMarker: unique symbol;
+/** A typed reference a module exports after `define()`. */
+export interface JobHandle<Data> {
+    readonly name: string;
+    readonly [JobHandleDataMarker]?: Data;
+}
+/**
+ * Defaults every enqueue on this queue inherits, unless the caller overrides
+ * on a per-`enqueue` basis. `localConcurrency` sizes the work loop on the
+ * worker; the rest match pg-boss's `QueueOptions` names.
+ *
+ * `retryDelay` is in seconds. pg-boss's default is 0 (immediate retry).
+ * `retryLimit` counts the retries pg-boss does after the first run; a job
+ * with `retryLimit: 2` runs at most three times.
+ */
+export interface JobDefaults {
+    readonly retryLimit?: number;
+    readonly retryDelay?: number;
+    readonly retryBackoff?: boolean;
+    readonly retryDelayMax?: number;
+    readonly expireInSeconds?: number;
+    readonly localConcurrency?: number;
+}
+/** Passed to a job handler when a worker picks the job up. */
+export interface JobContext<Data> {
+    readonly id: string;
+    readonly data: Data;
+    readonly log: Logger;
+    /** Fires when pg-boss decides the job has expired. Long-running handlers should honour it. */
+    readonly signal: AbortSignal;
+}
+export type JobHandler<Data> = (context: JobContext<Data>) => Promise<void>;
+export interface JobDefinition<Data> {
+    /**
+     * The queue name pg-boss stores against. Must be unique across the
+     * assembly; a second `define()` with the same name fails boot.
+     *
+     * Prefix with the module id — `webhooks.deliver`, `agent-tasks.dispatch` —
+     * so operators reading `pgboss.job` see who owns it.
+     */
+    readonly name: string;
+    /**
+     * Parses the payload at handle time before it reaches user code. A job
+     * whose payload no longer matches fails, retries, and eventually
+     * dead-letters like any other failure.
+     */
+    readonly schema: ZodType<Data>;
+    readonly handler: JobHandler<Data>;
+    readonly defaults?: JobDefaults;
+}
+/**
+ * The registration surface exposed to a module through `context.jobs`. Modules
+ * hand a definition in and receive a typed handle to enqueue against.
+ */
+export interface JobRegistry {
+    define<Data>(definition: JobDefinition<Data>): JobHandle<Data>;
+}
+/**
+ * Options a caller may override per `enqueue`. Deliberately narrow: features
+ * beyond retries, a singleton key, and a deferred start are out of scope until
+ * a consumer needs them (`crm-brief.md` cost/maintainability trade-offs).
+ */
+export interface EnqueueOptions {
+    readonly retryLimit?: number;
+    readonly retryBackoff?: boolean;
+    readonly singletonKey?: string;
+    readonly startAfter?: number | string | Date;
+}
+/**
+ * Exposed on the transaction context next to `events`. `enqueue` runs its
+ * insert inside the caller's transaction via pg-boss's `fromDrizzle` adapter,
+ * so a rollback discards the job with the write.
+ */
+export interface TransactionJobs {
+    enqueue<Data>(handle: JobHandle<Data>, data: Data, options?: EnqueueOptions): Promise<string | null>;
+}
+/** The name pg-boss stores the dead-letter queue under, given a handle name. */
+export declare function deadLetterQueueName(jobName: string): string;
+export {};
+//# sourceMappingURL=jobs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/lib/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAElC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH;;;;;GAKG;AACH,OAAO,CAAC,MAAM,mBAAmB,EAAE,OAAO,MAAM,CAAA;AAEhD,2DAA2D;AAC3D,MAAM,WAAW,SAAS,CAAC,IAAI;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,CAAC,mBAAmB,CAAC,CAAC,EAAE,IAAI,CAAA;CACtC;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED,8DAA8D;AAC9D,MAAM,WAAW,UAAU,CAAC,IAAI;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,8FAA8F;IAC9F,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAC7B;AAED,MAAM,MAAM,UAAU,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;AAE3E,MAAM,WAAW,aAAa,CAAC,IAAI;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,CAAC,CAAA;IAClC,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAA;CAChC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;CAC/D;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;CAC7C;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,IAAI,EACV,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,EACvB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CAC1B;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/lib/jobs.js

@@ -0,0 +1,5 @@
+/** The name pg-boss stores the dead-letter queue under, given a handle name. */
+export function deadLetterQueueName(jobName) {
+    return `${jobName}.dead`;
+}
+//# sourceMappingURL=jobs.js.map

package/dist/lib/jobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.js","sourceRoot":"","sources":["../../src/lib/jobs.ts"],"names":[],"mappings":"AA0HA,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,OAAe;IACjD,OAAO,GAAG,OAAO,OAAO,CAAA;AAC1B,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';
@@ -225,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.