@teamscala/service-boot 0.23.306 → 0.23.308

package/package.json

@@ -6,7 +6,7 @@
   },
   "name": "@teamscala/service-boot",
   "type": "module",
-  "version": "0.23.306",
+  "version": "0.23.308",
   "sideEffects": false,
   "files": [
     "src"

package/src/pg-boss-handler-registry.d.ts

@@ -18,7 +18,7 @@ export type PgBossJobHandler = (ctx: {
     config: ScheduledJobConfig;
     /** Per-job data payload from a one-shot `boss.send()` — absent for scheduled jobs. */
     jobData?: unknown;
-}) => Promise<void> | void;
+}) => Promise<unknown> | unknown;
 export declare const pgBossHandlerRegistry: import("@teamscala/generic-registry/create-registry").Registry<PgBossJobHandler>;
 /**
  * Register a handler for a `scheduled_job.handler_slug`. Idempotent on re-import

package/src/pg-boss-handler-registry.ts

@@ -18,7 +18,9 @@ import { createRegistry } from "@teamscala/generic-registry/create-registry";
 
 export type PgBossJobHandler = (ctx: {
 	config: ScheduledJobConfig;
-}) => Promise<void> | void;
+	/** Per-job data payload from a one-shot `boss.send()` — absent for scheduled jobs. */
+	jobData?: unknown;
+}) => Promise<unknown> | unknown;
 
 export const pgBossHandlerRegistry = createRegistry<PgBossJobHandler>(
 	"pg-boss-handlers",

package/src/pg-boss-mount.ts

@@ -35,6 +35,20 @@ import "./handlers/singleton-tools-currency-watch.ts";
 import "./handlers/registry-stale-inactive-sweep.ts";
 import "./handlers/pane-outbox-drain.ts";
 
+/**
+ * Module-level reference to the mounted PgBoss instance — set by mountPgBoss on
+ * successful start. Exposed via getPgBoss() so ORPC procedures (and other
+ * in-process callers) can submit one-shot jobs via boss.send() without a second
+ * PgBoss connection. Null before mount or when mountPgBoss found no scheduled
+ * jobs for this service (boss never created).
+ */
+let pgBossInstance: PgBoss | null = null;
+
+/** Returns the mounted PgBoss instance, or null if pg-boss is not running on this service. */
+export function getPgBoss(): PgBoss | null {
+	return pgBossInstance;
+}
+
 export interface PgBossMountContext {
 	databaseUrl: string;
 	serviceSlug: string;
@@ -86,7 +100,8 @@ export function intervalToCron(intervalSeconds: number): string {
 async function resolveHandler(
 	handlerSlug: string,
 	config: ScheduledJobConfig,
-): Promise<void> {
+	jobData?: unknown,
+): Promise<unknown> {
 	const handler = pgBossHandlerRegistry.get(handlerSlug);
 	if (!handler) {
 		throw new Error(
@@ -94,7 +109,7 @@ async function resolveHandler(
 				`register it via pgBossHandlerRegistry.register(slug, fn) before the job fires`,
 		);
 	}
-	await handler({ config });
+	return await handler({ config, jobData });
 }
 
 export async function mountPgBoss(
@@ -149,6 +164,7 @@ export async function mountPgBoss(
 	// calling schedule() before start() crashes the timekeeper with
 	// "Database not opened. Call open() before executing SQL." (pg-boss v12)
 	await boss.start();
+	pgBossInstance = boss;
 
 	for (const entry of scheduledEntries) {
 		// crash-isolation: a malformed scheduled_job row degrades to "this job
@@ -188,8 +204,8 @@ export async function mountPgBoss(
 			// underlying SQL is ON CONFLICT DO NOTHING, so calling it on every
 			// boot is a safe idempotent assert, never a duplicate-creation error.
 			await boss.createQueue(queueName);
-			await boss.work(queueName, async () => {
-				await resolveHandler(config.handler_slug, config);
+			await boss.work(queueName, async (job) => {
+				return await resolveHandler(config.handler_slug, config, job?.data);
 			});
 
 			if (config.cron) {