@spfn/core 0.2.0-beta.2 → 0.2.0-beta.3

package/README.md

@@ -6,7 +6,7 @@ Full-stack type-safe framework for building Next.js + Node.js applications with
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.3-blue)](https://www.typescriptlang.org/)
 
-> **Alpha Release**: SPFN is currently in alpha. APIs may change. Use `@alpha` tag for installation.
+> **Beta Release**: SPFN is currently in beta. Core APIs are stable but may have minor changes before 1.0.
 
 ---
 
@@ -200,7 +200,7 @@ route.get('/users/:id')
     |-- Type Inference: RouteDef<TInput, TResponse>
     |-- Validation: TypeBox schema
     |-- Middleware: Skip control per route
-    |-- Response: c.success() / c.error()
+    |-- Response: Direct return / c.json() / helpers
 ```
 
 **Key Components**:
@@ -431,6 +431,57 @@ Return NextResponse
 
 ---
 
+### 9. Job System (`src/job/`)
+
+**Purpose**: Background job processing with pg-boss
+
+**Architecture**:
+
+```
+job('send-email')
+    .input(schema)
+    .options({ retryLimit: 3 })
+    .cron('0 9 * * *')
+    .on(eventDef)
+    .handler(async (input) => { ... })
+```
+
+**Key Components**:
+
+- `job()`: Fluent job builder
+- `defineJobRouter()`: Group jobs for registration
+- Job types: Standard, Cron, RunOnce, Event-driven
+- `initBoss()`, `registerJobs()`: pg-boss lifecycle
+
+**Design Pattern**: Builder pattern (same as routes)
+
+---
+
+### 10. Event System (`src/event/`)
+
+**Purpose**: Decoupled pub/sub event system
+
+**Architecture**:
+
+```
+defineEvent('user.created', schema)
+    → emit(payload)
+    → handlers (in-memory)
+    → job queues (pg-boss)
+    → cache pub/sub (multi-instance)
+```
+
+**Key Components**:
+
+- `defineEvent()`: Define typed events
+- `event.emit()`: Emit event to all subscribers
+- `event.subscribe()`: In-memory subscription
+- `event.useCache()`: Multi-instance pub/sub via Redis
+
+**Integration**: `job().on(event)` for event-driven jobs
+
+---
+
 ## Type System
 
 ### End-to-End Type Safety Flow
@@ -469,8 +520,8 @@ export const getUser = route.get('/users/:id')
         const user = await findOne(users, { id: params.id });
         //    ^? User | null
 
-        return c.success(user);
-        //       ^? Response inferred from return value
+        return user;
+        //     ^? Response type inferred from return value
     });
 
 // 3. Router Type Export
@@ -884,7 +935,7 @@ export const getUser = route.get('/users/:id')
     })
     .handler(async (c) => {
         const { params } = await c.data();
-        return c.success({ id: params.id, name: 'John' });
+        return { id: params.id, name: 'John' };
     });
 
 // router.ts
@@ -1076,6 +1127,40 @@ import {
 import { env, envSchema } from '@spfn/core/config';
 ```
 
+### Job System
+
+```typescript
+import {
+    job,
+    defineJobRouter,
+    registerJobs,
+    initBoss,
+    getBoss,
+    stopBoss,
+} from '@spfn/core/job';
+
+import type {
+    JobDef,
+    JobRouter,
+    JobOptions,
+    BossOptions,
+    InferJobInput,
+} from '@spfn/core/job';
+```
+
+### Event System
+
+```typescript
+import { defineEvent } from '@spfn/core/event';
+
+import type {
+    EventDef,
+    EventHandler,
+    InferEventPayload,
+    PubSubCache,
+} from '@spfn/core/event';
+```
+
 ---
 
 ## Quick Reference
@@ -1133,7 +1218,7 @@ export const getUser = route.get('/users/:id')
     .input({ params: Type.Object({ id: Type.String() }) })
     .handler(async (c) => {
         const { params } = await c.data();
-        return c.success({ id: params.id, name: 'John' });
+        return { id: params.id, name: 'John' };
     });
 ```
 

package/dist/{boss-D-fGtVgM.d.ts → boss-BO8ty33K.d.ts}

@@ -134,39 +134,79 @@ type InferJobInput<TJob> = TJob extends JobDef<infer TInput> ? TInput : never;
  */
 
 /**
- * pg-boss configuration options
+ * Options for pg-boss initialization
+ *
+ * @example
+ * ```typescript
+ * await initBoss({
+ *     connectionString: process.env.DATABASE_URL,
+ *     schema: 'spfn_queue',
+ *     clearOnStart: process.env.NODE_ENV === 'development',
+ * });
+ * ```
  */
-interface BossConfig {
+interface BossOptions {
     /**
      * PostgreSQL connection string
+     *
+     * @example 'postgresql://user:password@localhost:5432/mydb'
      */
     connectionString: string;
     /**
      * Schema name for pg-boss tables
+     *
+     * pg-boss creates its own tables in this schema.
+     *
      * @default 'spfn_queue'
      */
     schema?: string;
     /**
      * Maintenance interval in seconds
+     *
+     * pg-boss runs maintenance tasks (cleanup, archiving) at this interval.
+     *
      * @default 120
      */
     maintenanceIntervalSeconds?: number;
     /**
      * Monitor state changes interval in seconds
+     *
+     * When set, pg-boss emits state change events at this interval.
+     *
      * @default undefined (disabled)
      */
     monitorIntervalSeconds?: number;
     /**
      * Clear all pending/scheduled jobs on startup
-     * Useful for development mode
+     *
+     * Useful for development mode to start with a clean queue.
+     * Should be false in production.
+     *
      * @default false
      */
     clearOnStart?: boolean;
 }
+/**
+ * @deprecated Use BossOptions instead
+ */
+type BossConfig = BossOptions;
 /**
  * Initialize pg-boss with the given configuration
+ *
+ * Must be called before registerJobs(). Typically handled by defineServerConfig().
+ *
+ * @param options - pg-boss configuration options
+ * @returns The pg-boss instance
+ *
+ * @example
+ * ```typescript
+ * const boss = await initBoss({
+ *     connectionString: process.env.DATABASE_URL!,
+ *     schema: 'spfn_queue',
+ * });
+ * ```
  */
-declare function initBoss(config: BossConfig): Promise<PgBoss>;
+declare function initBoss(options: BossOptions): Promise<PgBoss>;
 /**
  * Get the current pg-boss instance
  */
@@ -184,4 +224,4 @@ declare function isBossRunning(): boolean;
  */
 declare function shouldClearOnStart(): boolean;
 
-export { type BossConfig as B, type InferJobInput as I, type JobRouter as J, type JobOptions as a, type JobHandler as b, type JobDef as c, type JobRouterEntry as d, type JobSendOptions as e, isBossRunning as f, getBoss as g, shouldClearOnStart as h, initBoss as i, stopBoss as s };
+export { type BossOptions as B, type InferJobInput as I, type JobRouter as J, type JobOptions as a, type JobHandler as b, type JobDef as c, type JobRouterEntry as d, type JobSendOptions as e, isBossRunning as f, getBoss as g, shouldClearOnStart as h, initBoss as i, type BossConfig as j, stopBoss as s };

package/dist/job/index.d.ts

@@ -1,5 +1,5 @@
-import { a as JobOptions, b as JobHandler, c as JobDef, d as JobRouterEntry, J as JobRouter } from '../boss-D-fGtVgM.js';
-export { B as BossConfig, I as InferJobInput, e as JobSendOptions, g as getBoss, i as initBoss, f as isBossRunning, h as shouldClearOnStart, s as stopBoss } from '../boss-D-fGtVgM.js';
+import { a as JobOptions, b as JobHandler, c as JobDef, d as JobRouterEntry, J as JobRouter } from '../boss-BO8ty33K.js';
+export { j as BossConfig, B as BossOptions, I as InferJobInput, e as JobSendOptions, g as getBoss, i as initBoss, f as isBossRunning, h as shouldClearOnStart, s as stopBoss } from '../boss-BO8ty33K.js';
 import * as _sinclair_typebox from '@sinclair/typebox';
 import { Static } from '@sinclair/typebox';
 import { EventDef, InferEventPayload } from '@spfn/core/event';
@@ -166,7 +166,38 @@ declare function collectJobs(router: JobRouter<any>, prefix?: string): JobDef<an
 
 /**
  * Register all jobs from a JobRouter with pg-boss
+ *
+ * This function:
+ * 1. Collects all jobs from the router (including nested routers)
+ * 2. Optionally clears existing jobs (if clearOnStart is enabled)
+ * 3. Registers each job's worker handler with pg-boss
+ * 4. Sets up cron schedules for scheduled jobs
+ * 5. Queues runOnce jobs
+ * 6. Connects event subscriptions to job queues
+ *
+ * @param router - JobRouter containing job definitions
+ *
+ * @example
+ * ```typescript
+ * // Define jobs
+ * const sendEmail = job('send-email')
+ *     .input(Type.Object({ to: Type.String() }))
+ *     .handler(async (input) => { ... });
+ *
+ * const dailyReport = job('daily-report')
+ *     .cron('0 9 * * *')
+ *     .handler(async () => { ... });
+ *
+ * // Create router
+ * const jobRouter = defineJobRouter({ sendEmail, dailyReport });
+ *
+ * // Initialize pg-boss first
+ * await initBoss({ connectionString: process.env.DATABASE_URL! });
+ *
+ * // Register jobs
+ * await registerJobs(jobRouter);
+ * ```
  */
 declare function registerJobs(router: JobRouter<any>): Promise<void>;
 
-export { JobBuilder, JobDef, JobHandler, JobOptions, JobRouter, JobRouterEntry, collectJobs, defineJobRouter, isJobDef, isJobRouter, job, registerJobs };
+export { JobDef, JobHandler, JobOptions, JobRouter, JobRouterEntry, collectJobs, defineJobRouter, isJobDef, isJobRouter, job, registerJobs };

package/dist/job/index.js

@@ -5,18 +5,18 @@ import { logger } from '@spfn/core/logger';
 var jobLogger = logger.child("@spfn/core:job");
 var bossInstance = null;
 var bossConfig = null;
-async function initBoss(config) {
+async function initBoss(options) {
   if (bossInstance) {
     jobLogger.warn("pg-boss already initialized, returning existing instance");
     return bossInstance;
   }
   jobLogger.info("Initializing pg-boss...");
-  bossConfig = config;
+  bossConfig = options;
   bossInstance = new PgBoss({
-    connectionString: config.connectionString,
-    schema: config.schema ?? "spfn_queue",
-    maintenanceIntervalSeconds: config.maintenanceIntervalSeconds ?? 120,
-    monitorIntervalSeconds: config.monitorIntervalSeconds
+    connectionString: options.connectionString,
+    schema: options.schema ?? "spfn_queue",
+    maintenanceIntervalSeconds: options.maintenanceIntervalSeconds ?? 120,
+    monitorIntervalSeconds: options.monitorIntervalSeconds
   });
   bossInstance.on("error", (error) => {
     jobLogger.error("pg-boss error:", error);
@@ -356,6 +356,6 @@ async function registerJob(job2) {
   jobLogger2.debug(`Job registered: ${job2.name}`);
 }
 
-export { JobBuilder, collectJobs, defineJobRouter, getBoss, initBoss, isBossRunning, isJobDef, isJobRouter, job, registerJobs, shouldClearOnStart, stopBoss };
+export { collectJobs, defineJobRouter, getBoss, initBoss, isBossRunning, isJobDef, isJobRouter, job, registerJobs, shouldClearOnStart, stopBoss };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/job/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/job/boss.ts","../../src/job/job-builder.ts","../../src/job/job-router.ts","../../src/job/register-jobs.ts"],"names":["jobLogger","logger","job"],"mappings":";;;;AASA,IAAM,SAAA,GAAY,MAAA,CAAO,KAAA,CAAM,gBAAgB,CAAA;AAK/C,IAAI,YAAA,GAA8B,IAAA;AAKlC,IAAI,UAAA,GAAgC,IAAA;AAyCpC,eAAsB,SAAS,MAAA,EAC/B;AACI,EAAA,IAAI,YAAA,EACJ;AACI,IAAA,SAAA,CAAU,KAAK,0DAA0D,CAAA;AACzE,IAAA,OAAO,YAAA;AAAA,EACX;AAEA,EAAA,SAAA,CAAU,KAAK,yBAAyB,CAAA;AAExC,EAAA,UAAA,GAAa,MAAA;AACb,EAAA,YAAA,GAAe,IAAI,MAAA,CAAO;AAAA,IACtB,kBAAkB,MAAA,CAAO,gBAAA;AAAA,IACzB,MAAA,EAAQ,OAAO,MAAA,IAAU,YAAA;AAAA,IACzB,0BAAA,EAA4B,OAAO,0BAAA,IAA8B,GAAA;AAAA,IACjE,wBAAwB,MAAA,CAAO;AAAA,GAClC,CAAA;AAGD,EAAA,YAAA,CAAa,EAAA,CAAG,OAAA,EAAS,CAAC,KAAA,KAC1B;AACI,IAAA,SAAA,CAAU,KAAA,CAAM,kBAAkB,KAAK,CAAA;AAAA,EAC3C,CAAC,CAAA;AAED,EAAA,MAAM,aAAa,KAAA,EAAM;AAEzB,EAAA,SAAA,CAAU,KAAK,8BAA8B,CAAA;AAE7C,EAAA,OAAO,YAAA;AACX;AAKO,SAAS,OAAA,GAChB;AACI,EAAA,OAAO,YAAA;AACX;AAKA,eAAsB,QAAA,GACtB;AACI,EAAA,IAAI,CAAC,YAAA,EACL;AACI,IAAA;AAAA,EACJ;AAEA,EAAA,SAAA,CAAU,KAAK,qBAAqB,CAAA;AAEpC,EAAA,IACA;AACI,IAAA,MAAM,aAAa,IAAA,CAAK,EAAE,UAAU,IAAA,EAAM,OAAA,EAAS,KAAO,CAAA;AAC1D,IAAA,SAAA,CAAU,KAAK,4BAA4B,CAAA;AAAA,EAC/C,SACO,KAAA,EACP;AACI,IAAA,SAAA,CAAU,KAAA,CAAM,2BAA2B,KAAK,CAAA;AAChD,IAAA,MAAM,KAAA;AAAA,EACV,CAAA,SACA;AAEI,IAAA,YAAA,GAAe,IAAA;AACf,IAAA,UAAA,GAAa,IAAA;AAAA,EACjB;AACJ;AAKO,SAAS,aAAA,GAChB;AACI,EAAA,OAAO,YAAA,KAAiB,IAAA;AAC5B;AAKO,SAAS,kBAAA,GAChB;AACI,EAAA,OAAO,YAAY,YAAA,IAAgB,KAAA;AACvC;;;AChIA,SAAS,kBAAA,CACL,UACA,WAAA,EAEJ;AACI,EAAA,MAAM,UAAmC,EAAC;AAG1C,EAAA,IAAI,aAAa,UAAA,EACjB;AACI,IAAA,OAAA,CAAQ,aAAa,WAAA,CAAY,UAAA;AAAA,EACrC;AACA,EAAA,IAAI,aAAa,YAAA,EACjB;AACI,IAAA,OAAA,CAAQ,eAAe,WAAA,CAAY,YAAA;AAAA,EACvC;AACA,EAAA,IAAI,WAAA,EAAa,aAAa,MAAA,EAC9B;AACI,IAAA,OAAA,CAAQ,WAAW,WAAA,CAAY,QAAA;AAAA,EACnC;AAGA,EAAA,IAAI,QAAA,EAAU,eAAe,MAAA,EAC7B;AACI,IAAA,OAAA,CAAQ,aAAa,QAAA,CAAS,UAAA;AAAA,EAClC;AACA,EAAA,IAAI,QAAA,EAAU,eAAe,MAAA,EAC7B;AACI,IAAA,OAAA,CAAQ,aAAa,QAAA,CAAS,UAAA;AAAA,EAClC;AACA,EAAA,IAAI,QAAA,EAAU,oBAAoB,MAAA,EAClC;AACI,IAAA,OAAA,CAAQ,kBAAkB,QAAA,CAAS,eAAA;AAAA,EACvC;AACA,EAAA,IAAI,QAAA,EAAU,QAAA,KAAa,MAAA,IAAa,WAAA,EAAa,aAAa,MAAA,EAClE;AACI,IAAA,OAAA,CAAQ,WAAW,QAAA,CAAS,QAAA;AAAA,EAChC;AACA,EAAA,IAAI,QAAA,EAAU,YAAA,IAAgB,CAAC,WAAA,EAAa,YAAA,EAC5C;AACI,IAAA,OAAA,CAAQ,eAAe,QAAA,CAAS,YAAA;AAAA,EACpC;AACA,EAAA,IAAI,QAAA,EAAU,qBAAqB,MAAA,EACnC;AACI,IAAA,OAAA,CAAQ,mBAAmB,QAAA,CAAS,gBAAA;AAAA,EACxC;AAEA,EAAA,OAAO,OAAA;AACX;AAKO,IAAM,UAAA,GAAN,MAAM,WAAA,CACb;AAAA,EACY,KAAA;AAAA,EACA,YAAA;AAAA,EACA,eAAA;AAAA,EACA,QAAA;AAAA,EACA,gBAAA;AAAA,EACA,mBAAA;AAAA,EACA,QAAA;AAAA,EACA,QAAA;AAAA,EAER,YAAY,IAAA,EACZ;AACI,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,MACI,MAAA,EAEJ;AACI,IAAA,MAAM,OAAA,GAAU,IAAI,WAAA,CAA4B,IAAA,CAAK,KAAK,CAAA;AAC1D,IAAA,OAAA,CAAQ,YAAA,GAAe,MAAA;AACvB,IAAA,OAAA,CAAQ,kBAAkB,IAAA,CAAK,eAAA;AAC/B,IAAA,OAAA,CAAQ,WAAW,IAAA,CAAK,QAAA;AACxB,IAAA,OAAA,CAAQ,mBAAmB,IAAA,CAAK,gBAAA;AAChC,IAAA,OAAA,CAAQ,WAAW,IAAA,CAAK,QAAA;AACxB,IAAA,OAAO,OAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,GACI,KAAA,EAEJ;AACI,IAAA,MAAM,OAAA,GAAU,IAAI,WAAA,CAAsC,IAAA,CAAK,KAAK,CAAA;AACpE,IAAA,OAAA,CAAQ,eAAe,KAAA,CAAM,MAAA;AAC7B,IAAA,OAAA,CAAQ,mBAAmB,KAAA,CAAM,IAAA;AACjC,IAAA,OAAA,CAAQ,mBAAA,GAAsB,KAAA;AAC9B,IAAA,OAAA,CAAQ,kBAAkB,IAAA,CAAK,eAAA;AAC/B,IAAA,OAAA,CAAQ,WAAW,IAAA,CAAK,QAAA;AACxB,IAAA,OAAA,CAAQ,WAAW,IAAA,CAAK,QAAA;AACxB,IAAA,OAAO,OAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,KAAK,UAAA,EACL;AACI,IAAA,IAAA,CAAK,eAAA,GAAkB,UAAA;AACvB,IAAA,OAAO,IAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,OAAA,GACA;AACI,IAAA,IAAA,CAAK,QAAA,GAAW,IAAA;AAChB,IAAA,OAAO,IAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,OAAA,EACR;AACI,IAAA,IAAA,CAAK,QAAA,GAAW,OAAA;AAChB,IAAA,OAAO,IAAA;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,EAAA,EACR;AACI,IAAA,IAAA,CAAK,QAAA,GAAW,EAAA;AAEhB,IAAA,MAAM,OAAO,IAAA,CAAK,KAAA;AAClB,IAAA,MAAM,cAAc,IAAA,CAAK,YAAA;AACzB,IAAA,MAAM,iBAAiB,IAAA,CAAK,eAAA;AAC5B,IAAA,MAAM,UAAU,IAAA,CAAK,QAAA;AACrB,IAAA,MAAM,kBAAkB,IAAA,CAAK,gBAAA;AAC7B,IAAA,MAAM,qBAAqB,IAAA,CAAK,mBAAA;AAChC,IAAA,MAAM,UAAU,IAAA,CAAK,QAAA;AACrB,IAAA,MAAM,UAAU,IAAA,CAAK,QAAA;AAGrB,IAAA,MAAM,IAAA,GAAO,OACT,cAAA,EACA,YAAA,KAEJ;AACI,MAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,MAAA,IAAI,CAAC,IAAA,EACL;AACI,QAAA,MAAM,IAAI,KAAA;AAAA,UACN,QAAQ,IAAI,CAAA,sFAAA;AAAA,SAEhB;AAAA,MACJ;AAGA,MAAA,MAAM,CAAC,KAAA,EAAO,WAAW,CAAA,GAAI,WAAA,GACvB,CAAC,cAAA,EAA0B,YAAY,CAAA,GACvC,CAAC,MAAA,EAAW,cAA4C,CAAA;AAE9D,MAAA,OAAO,MAAM,IAAA,CAAK,IAAA;AAAA,QACd,IAAA;AAAA,QACA,SAAS,EAAC;AAAA,QACV,kBAAA,CAAmB,SAAS,WAAW;AAAA,OAC3C;AAAA,IACJ,CAAA;AAGA,IAAA,MAAM,GAAA,GAAM,OAAO,KAAA,KACnB;AACI,MAAA,IAAI,WAAA,EACJ;AACI,QAAA,MAAO,QAA6C,KAAe,CAAA;AAAA,MACvE,CAAA,MAEA;AACI,QAAA,MAAO,OAAA,EAAgC;AAAA,MAC3C;AAAA,IACJ,CAAA;AAEA,IAAA,OAAO;AAAA,MACH,IAAA;AAAA,MACA,WAAA;AAAA,MACA,cAAA;AAAA,MACA,OAAA;AAAA,MACA,eAAA;AAAA,MACA,mBAAA,EAAqB,kBAAA;AAAA,MACrB,OAAA;AAAA,MACA,OAAA;AAAA,MACA,IAAA;AAAA,MACA,GAAA;AAAA,MACA,MAAA,EAAQ;AAAA,KACZ;AAAA,EACJ;AACJ;AAmDO,SAAS,IAAI,IAAA,EACpB;AACI,EAAA,OAAO,IAAI,WAAW,IAAI,CAAA;AAC9B;;;AC7QO,SAAS,SAAS,KAAA,EACzB;AACI,EAAA,OACI,KAAA,KAAU,IAAA,IACV,OAAO,KAAA,KAAU,QAAA,IACjB,MAAA,IAAU,KAAA,IACV,SAAA,IAAa,KAAA,IACb,MAAA,IAAU,KAAA,IACV,KAAA,IAAS,KAAA;AAEjB;AAKO,SAAS,YAAY,KAAA,EAC5B;AACI,EAAA,OACI,UAAU,IAAA,IACV,OAAO,UAAU,QAAA,IACjB,MAAA,IAAU,SACV,OAAA,IAAW,KAAA;AAEnB;AAiCO,SAAS,gBAEd,IAAA,EACF;AACI,EAAA,OAAO;AAAA,IACH,IAAA;AAAA,IACA,KAAA,EAAO;AAAA,GACX;AACJ;AAKO,SAAS,WAAA,CACZ,MAAA,EACA,MAAA,GAAS,EAAA,EAEb;AACI,EAAA,MAAM,OAAsB,EAAC;AAE7B,EAAA,KAAA,MAAW,CAAC,KAAK,KAAK,CAAA,IAAK,OAAO,OAAA,CAAQ,MAAA,CAAO,IAAI,CAAA,EACrD;AACI,IAAA,MAAM,OAAO,MAAA,GAAS,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,GAAG,CAAA,CAAA,GAAK,GAAA;AAE3C,IAAA,IAAI,WAAA,CAAY,KAAK,CAAA,EACrB;AAEI,MAAA,IAAA,CAAK,IAAA,CAAK,GAAG,WAAA,CAAY,KAAA,EAAO,IAAI,CAAC,CAAA;AAAA,IACzC,CAAA,MAAA,IACS,QAAA,CAAS,KAAK,CAAA,EACvB;AACI,MAAA,IAAA,CAAK,KAAK,KAAK,CAAA;AAAA,IACnB;AAAA,EACJ;AAEA,EAAA,OAAO,IAAA;AACX;AC1FA,IAAMA,UAAAA,GAAYC,MAAAA,CAAO,KAAA,CAAM,gBAAgB,CAAA;AAKxC,SAAS,kBAAkB,SAAA,EAClC;AACI,EAAA,OAAO,SAAS,SAAS,CAAA,CAAA;AAC7B;AAKA,SAAS,qBAAqB,OAAA,EAC9B;AACI,EAAA,OAAO;AAAA,IACH,UAAA,EAAY,SAAS,UAAA,IAAc,CAAA;AAAA,IACnC,UAAA,EAAY,SAAS,UAAA,IAAc,GAAA;AAAA,IACnC,eAAA,EAAiB,SAAS,eAAA,IAAmB;AAAA,GACjD;AACJ;AAKA,eAAsB,aAAa,MAAA,EACnC;AACI,EAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,EAAA,IAAI,CAAC,IAAA,EACL;AACI,IAAA,MAAM,IAAI,KAAA;AAAA,MACN;AAAA,KACJ;AAAA,EACJ;AAEA,EAAA,MAAM,IAAA,GAAO,YAAY,MAAM,CAAA;AAC/B,EAAA,MAAM,eAAe,kBAAA,EAAmB;AAExC,EAAAD,UAAAA,CAAU,IAAA,CAAK,CAAA,YAAA,EAAe,IAAA,CAAK,MAAM,CAAA,UAAA,CAAY,CAAA;AAGrD,EAAA,IAAI,YAAA,EACJ;AACI,IAAAA,UAAAA,CAAU,KAAK,+CAA+C,CAAA;AAC9D,IAAA,KAAA,MAAWE,QAAO,IAAA,EAClB;AAEI,MAAA,MAAM,IAAA,CAAK,aAAA,CAAcA,IAAAA,CAAI,IAAI,CAAA;AAGjC,MAAA,IAAIA,KAAI,eAAA,EACR;AACI,QAAA,MAAM,UAAA,GAAa,iBAAA,CAAkBA,IAAAA,CAAI,eAAe,CAAA;AACxD,QAAA,MAAM,IAAA,CAAK,cAAc,UAAU,CAAA;AAAA,MACvC;AAAA,IACJ;AACA,IAAAF,UAAAA,CAAU,KAAK,uBAAuB,CAAA;AAAA,EAC1C;AAEA,EAAA,KAAA,MAAWE,QAAO,IAAA,EAClB;AACI,IAAA,MAAM,YAAYA,IAAG,CAAA;AAAA,EACzB;AAEA,EAAAF,UAAAA,CAAU,KAAK,kCAAkC,CAAA;AACrD;AAKA,eAAe,cAAA,CACX,IAAA,EACAE,IAAAA,EACA,SAAA,EAEJ;AACI,EAAA,MAAM,IAAA,CAAK,IAAA;AAAA,IACP,SAAA;AAAA,IACA,EAAE,WAAW,CAAA,EAAE;AAAA,IACf,OAAO,IAAA,KACP;AACI,MAAA,KAAA,MAAW,aAAa,IAAA,EACxB;AACI,QAAAF,UAAAA,CAAU,KAAA,CAAM,CAAA,KAAA,EAAQE,IAAAA,CAAI,IAAI,kBAAkB,EAAE,KAAA,EAAO,SAAA,CAAU,EAAA,EAAI,CAAA;AAEzE,QAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAE3B,QAAA,IACA;AACI,UAAA,IAAIA,KAAI,WAAA,EACR;AACI,YAAA,MAAOA,IAAAA,CAAI,OAAA,CAA8C,SAAA,CAAU,IAAI,CAAA;AAAA,UAC3E,CAAA,MAEA;AACI,YAAA,MAAOA,KAAI,OAAA,EAAgC;AAAA,UAC/C;AAEA,UAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA;AAC9B,UAAAF,WAAU,IAAA,CAAK,CAAA,KAAA,EAAQE,KAAI,IAAI,CAAA,eAAA,EAAkB,QAAQ,CAAA,EAAA,CAAA,EAAM;AAAA,YAC3D,OAAO,SAAA,CAAU,EAAA;AAAA,YACjB;AAAA,WACH,CAAA;AAAA,QACL,SACO,KAAA,EACP;AACI,UAAA,MAAM,QAAA,GAAW,IAAA,CAAK,GAAA,EAAI,GAAI,SAAA;AAC9B,UAAAF,WAAU,KAAA,CAAM,CAAA,KAAA,EAAQE,KAAI,IAAI,CAAA,eAAA,EAAkB,QAAQ,CAAA,EAAA,CAAA,EAAM;AAAA,YAC5D,OAAO,SAAA,CAAU,EAAA;AAAA,YACjB,QAAA;AAAA,YACA,OAAO,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,OAAA,GAAU,OAAO,KAAK;AAAA,WAC/D,CAAA;AACD,UAAA,MAAM,KAAA;AAAA,QACV;AAAA,MACJ;AAAA,IACJ;AAAA,GACJ;AACJ;AAKA,SAAS,mBAAA,CACL,IAAA,EACAA,IAAAA,EACA,SAAA,EAEJ;AACI,EAAA,IAAI,CAACA,KAAI,mBAAA,EACT;AACI,IAAA;AAAA,EACJ;AAEA,EAAA,MAAM,WAAWA,IAAAA,CAAI,mBAAA;AACrB,EAAA,QAAA,CAAS,iBAAA,CAAkB,SAAA,EAAW,OAAO,KAAA,EAAO,OAAA,KACpD;AACI,IAAA,MAAM,KAAK,IAAA,CAAK,KAAA,EAAO,SAAmB,oBAAA,CAAqBA,IAAAA,CAAI,OAAO,CAAC,CAAA;AAAA,EAC/E,CAAC,CAAA;AAED,EAAAF,UAAAA,CAAU,MAAM,CAAA,KAAA,EAAQE,IAAAA,CAAI,IAAI,CAAA,sBAAA,EAAyBA,IAAAA,CAAI,eAAe,CAAA,CAAE,CAAA;AAClF;AAKA,eAAe,oBAAA,CAAqB,MAAcA,IAAAA,EAClD;AACI,EAAA,IAAI,CAACA,KAAI,cAAA,EACT;AACI,IAAA;AAAA,EACJ;AAEA,EAAAF,UAAAA,CAAU,MAAM,CAAA,KAAA,EAAQE,IAAAA,CAAI,IAAI,CAAA,mBAAA,EAAsBA,IAAAA,CAAI,cAAc,CAAA,CAAE,CAAA;AAE1E,EAAA,MAAM,IAAA,CAAK,QAAA;AAAA,IACPA,IAAAA,CAAI,IAAA;AAAA,IACJA,IAAAA,CAAI,cAAA;AAAA,IACJ,EAAC;AAAA,IACD,oBAAA,CAAqBA,KAAI,OAAO;AAAA,GACpC;AAEA,EAAAF,UAAAA,CAAU,KAAK,CAAA,KAAA,EAAQE,IAAAA,CAAI,IAAI,CAAA,kBAAA,EAAqBA,IAAAA,CAAI,cAAc,CAAA,CAAE,CAAA;AAC5E;AAKA,eAAe,eAAA,CAAgB,MAAcA,IAAAA,EAC7C;AACI,EAAA,IAAI,CAACA,KAAI,OAAA,EACT;AACI,IAAA;AAAA,EACJ;AAEA,EAAAF,UAAAA,CAAU,KAAA,CAAM,CAAA,KAAA,EAAQE,IAAAA,CAAI,IAAI,CAAA,qBAAA,CAAuB,CAAA;AAEvD,EAAA,MAAM,IAAA,CAAK,IAAA;AAAA,IACPA,IAAAA,CAAI,IAAA;AAAA,IACJ,EAAC;AAAA,IACD;AAAA,MACI,GAAG,oBAAA,CAAqBA,IAAAA,CAAI,OAAO,CAAA;AAAA,MACnC,YAAA,EAAc,CAAA,QAAA,EAAWA,IAAAA,CAAI,IAAI,CAAA;AAAA;AACrC,GACJ;AAEA,EAAAF,UAAAA,CAAU,IAAA,CAAK,CAAA,KAAA,EAAQE,IAAAA,CAAI,IAAI,CAAA,oBAAA,CAAsB,CAAA;AACzD;AAKA,eAAe,YAAYA,IAAAA,EAC3B;AACI,EAAA,MAAM,OAAO,OAAA,EAAQ;AACrB,EAAA,IAAI,CAAC,IAAA,EACL;AACI,IAAA,MAAM,IAAI,MAAM,yBAAyB,CAAA;AAAA,EAC7C;AAEA,EAAA,MAAM,YAAYA,IAAAA,CAAI,eAAA,GAChB,kBAAkBA,IAAAA,CAAI,eAAe,IACrCA,IAAAA,CAAI,IAAA;AAEV,EAAAF,UAAAA,CAAU,KAAA,CAAM,CAAA,iBAAA,EAAoBE,IAAAA,CAAI,IAAI,CAAA,CAAA,EAAI;AAAA,IAC5C,SAAA;AAAA,IACA,iBAAiBA,IAAAA,CAAI;AAAA,GACxB,CAAA;AAED,EAAA,MAAM,cAAA,CAAe,IAAA,EAAMA,IAAAA,EAAK,SAAS,CAAA;AACzC,EAAA,mBAAA,CAAoB,IAAA,EAAMA,MAAK,SAAS,CAAA;AACxC,EAAA,MAAM,oBAAA,CAAqB,MAAMA,IAAG,CAAA;AACpC,EAAA,MAAM,eAAA,CAAgB,MAAMA,IAAG,CAAA;AAE/B,EAAAF,UAAAA,CAAU,KAAA,CAAM,CAAA,gBAAA,EAAmBE,IAAAA,CAAI,IAAI,CAAA,CAAE,CAAA;AACjD","file":"index.js","sourcesContent":["/**\n * pg-boss Wrapper\n *\n * Manages pg-boss instance lifecycle\n */\n\nimport PgBoss from 'pg-boss';\nimport { logger } from '@spfn/core/logger';\n\nconst jobLogger = logger.child('@spfn/core:job');\n\n/**\n * Global pg-boss instance\n */\nlet bossInstance: PgBoss | null = null;\n\n/**\n * Stored config for access during registration\n */\nlet bossConfig: BossConfig | null = null;\n\n/**\n * pg-boss configuration options\n */\nexport interface BossConfig\n{\n    /**\n     * PostgreSQL connection string\n     */\n    connectionString: string;\n\n    /**\n     * Schema name for pg-boss tables\n     * @default 'spfn_queue'\n     */\n    schema?: string;\n\n    /**\n     * Maintenance interval in seconds\n     * @default 120\n     */\n    maintenanceIntervalSeconds?: number;\n\n    /**\n     * Monitor state changes interval in seconds\n     * @default undefined (disabled)\n     */\n    monitorIntervalSeconds?: number;\n\n    /**\n     * Clear all pending/scheduled jobs on startup\n     * Useful for development mode\n     * @default false\n     */\n    clearOnStart?: boolean;\n}\n\n/**\n * Initialize pg-boss with the given configuration\n */\nexport async function initBoss(config: BossConfig): Promise<PgBoss>\n{\n    if (bossInstance)\n    {\n        jobLogger.warn('pg-boss already initialized, returning existing instance');\n        return bossInstance;\n    }\n\n    jobLogger.info('Initializing pg-boss...');\n\n    bossConfig = config;\n    bossInstance = new PgBoss({\n        connectionString: config.connectionString,\n        schema: config.schema ?? 'spfn_queue',\n        maintenanceIntervalSeconds: config.maintenanceIntervalSeconds ?? 120,\n        monitorIntervalSeconds: config.monitorIntervalSeconds,\n    });\n\n    // Event handlers\n    bossInstance.on('error', (error) =>\n    {\n        jobLogger.error('pg-boss error:', error);\n    });\n\n    await bossInstance.start();\n\n    jobLogger.info('pg-boss started successfully');\n\n    return bossInstance;\n}\n\n/**\n * Get the current pg-boss instance\n */\nexport function getBoss(): PgBoss | null\n{\n    return bossInstance;\n}\n\n/**\n * Stop pg-boss gracefully\n */\nexport async function stopBoss(): Promise<void>\n{\n    if (!bossInstance)\n    {\n        return;\n    }\n\n    jobLogger.info('Stopping pg-boss...');\n\n    try\n    {\n        await bossInstance.stop({ graceful: true, timeout: 30000 });\n        jobLogger.info('pg-boss stopped gracefully');\n    }\n    catch (error)\n    {\n        jobLogger.error('Error stopping pg-boss:', error);\n        throw error;\n    }\n    finally\n    {\n        bossInstance = null;\n        bossConfig = null;\n    }\n}\n\n/**\n * Check if pg-boss is initialized and running\n */\nexport function isBossRunning(): boolean\n{\n    return bossInstance !== null;\n}\n\n/**\n * Check if jobs should be cleared on start\n */\nexport function shouldClearOnStart(): boolean\n{\n    return bossConfig?.clearOnStart ?? false;\n}\n","/**\n * Job Builder\n *\n * Fluent API for defining jobs, similar to route builder pattern\n */\n\nimport type { Static, TSchema } from '@sinclair/typebox';\nimport type { JobDef, JobHandler, JobOptions, JobSendOptions } from './types';\nimport type { EventDef, InferEventPayload } from '@spfn/core/event';\nimport { getBoss } from './boss';\n\n/**\n * Build pg-boss options from job defaults and send options\n */\nfunction buildPgBossOptions(\n    defaults?: JobOptions,\n    sendOptions?: JobSendOptions\n): Record<string, unknown>\n{\n    const options: Record<string, unknown> = {};\n\n    // Send options (per-job invocation)\n    if (sendOptions?.startAfter)\n    {\n        options.startAfter = sendOptions.startAfter;\n    }\n    if (sendOptions?.singletonKey)\n    {\n        options.singletonKey = sendOptions.singletonKey;\n    }\n    if (sendOptions?.priority !== undefined)\n    {\n        options.priority = sendOptions.priority;\n    }\n\n    // Default options (from job definition)\n    if (defaults?.retryLimit !== undefined)\n    {\n        options.retryLimit = defaults.retryLimit;\n    }\n    if (defaults?.retryDelay !== undefined)\n    {\n        options.retryDelay = defaults.retryDelay;\n    }\n    if (defaults?.expireInSeconds !== undefined)\n    {\n        options.expireInSeconds = defaults.expireInSeconds;\n    }\n    if (defaults?.priority !== undefined && sendOptions?.priority === undefined)\n    {\n        options.priority = defaults.priority;\n    }\n    if (defaults?.singletonKey && !sendOptions?.singletonKey)\n    {\n        options.singletonKey = defaults.singletonKey;\n    }\n    if (defaults?.retentionSeconds !== undefined)\n    {\n        options.retentionSeconds = defaults.retentionSeconds;\n    }\n\n    return options;\n}\n\n/**\n * Job builder class with fluent API\n */\nexport class JobBuilder<TInput = void>\n{\n    private _name: string;\n    private _inputSchema?: TSchema;\n    private _cronExpression?: string;\n    private _runOnce?: boolean;\n    private _subscribedEvent?: string;\n    private _subscribedEventDef?: EventDef<any>;\n    private _options?: JobOptions;\n    private _handler?: JobHandler<TInput>;\n\n    constructor(name: string)\n    {\n        this._name = name;\n    }\n\n    /**\n     * Define input schema with TypeBox\n     */\n    input<TSchema extends import('@sinclair/typebox').TSchema>(\n        schema: TSchema\n    ): JobBuilder<Static<TSchema>>\n    {\n        const builder = new JobBuilder<Static<TSchema>>(this._name);\n        builder._inputSchema = schema;\n        builder._cronExpression = this._cronExpression;\n        builder._runOnce = this._runOnce;\n        builder._subscribedEvent = this._subscribedEvent;\n        builder._options = this._options;\n        return builder;\n    }\n\n    /**\n     * Subscribe to an event (decoupled triggering)\n     *\n     * @example\n     * ```typescript\n     * const userCreated = defineEvent('user.created', Type.Object({\n     *     userId: Type.String(),\n     * }));\n     *\n     * const sendWelcomeEmail = job('send-welcome-email')\n     *     .on(userCreated)\n     *     .handler(async (payload) => {\n     *         // payload is typed as { userId: string }\n     *     });\n     * ```\n     */\n    on<TEvent extends EventDef<any>>(\n        event: TEvent\n    ): JobBuilder<InferEventPayload<TEvent>>\n    {\n        const builder = new JobBuilder<InferEventPayload<TEvent>>(this._name);\n        builder._inputSchema = event.schema;\n        builder._subscribedEvent = event.name;\n        builder._subscribedEventDef = event;\n        builder._cronExpression = this._cronExpression;\n        builder._runOnce = this._runOnce;\n        builder._options = this._options;\n        return builder;\n    }\n\n    /**\n     * Set cron expression for scheduled execution\n     */\n    cron(expression: string): this\n    {\n        this._cronExpression = expression;\n        return this;\n    }\n\n    /**\n     * Mark job to run once on server start\n     */\n    runOnce(): this\n    {\n        this._runOnce = true;\n        return this;\n    }\n\n    /**\n     * Set job options (retry, expiration, etc.)\n     */\n    options(options: JobOptions): this\n    {\n        this._options = options;\n        return this;\n    }\n\n    /**\n     * Define the job handler and finalize the job definition\n     */\n    handler(fn: JobHandler<TInput>): JobDef<TInput>\n    {\n        this._handler = fn;\n\n        const name = this._name;\n        const inputSchema = this._inputSchema;\n        const cronExpression = this._cronExpression;\n        const runOnce = this._runOnce;\n        const subscribedEvent = this._subscribedEvent;\n        const subscribedEventDef = this._subscribedEventDef;\n        const options = this._options;\n        const handler = this._handler;\n\n        // Create send function\n        const send = async (\n            inputOrOptions?: TInput | JobSendOptions,\n            maybeOptions?: JobSendOptions\n        ): Promise<string | null> =>\n        {\n            const boss = getBoss();\n            if (!boss)\n            {\n                throw new Error(\n                    `[Job:${name}] pg-boss not initialized. ` +\n                    'Ensure jobs are registered with defineServerConfig().jobs()'\n                );\n            }\n\n            // Determine input and options based on whether job has input schema\n            const [input, sendOptions] = inputSchema\n                ? [inputOrOptions as TInput, maybeOptions]\n                : [undefined, inputOrOptions as JobSendOptions | undefined];\n\n            return await boss.send(\n                name,\n                input ?? {},\n                buildPgBossOptions(options, sendOptions)\n            );\n        };\n\n        // Create run function (synchronous execution)\n        const run = async (input?: TInput): Promise<void> =>\n        {\n            if (inputSchema)\n            {\n                await (handler as (input: TInput) => Promise<void>)(input as TInput);\n            }\n            else\n            {\n                await (handler as () => Promise<void>)();\n            }\n        };\n\n        return {\n            name,\n            inputSchema,\n            cronExpression,\n            runOnce,\n            subscribedEvent,\n            _subscribedEventDef: subscribedEventDef,\n            options,\n            handler,\n            send: send as JobDef<TInput>['send'],\n            run: run as JobDef<TInput>['run'],\n            _input: undefined as unknown as TInput,\n        };\n    }\n}\n\n/**\n * Create a new job definition\n *\n * @example\n * ```typescript\n * // Simple job without input\n * export const cleanupJob = job('cleanup')\n *     .handler(async () => {\n *         await db.cleanup();\n *     });\n *\n * // Job with typed input\n * export const sendEmailJob = job('send-email')\n *     .input(Type.Object({\n *         to: Type.String(),\n *         subject: Type.String(),\n *         body: Type.String(),\n *     }))\n *     .handler(async (input) => {\n *         await emailService.send(input.to, input.subject, input.body);\n *     });\n *\n * // Cron job\n * export const dailyReportJob = job('daily-report')\n *     .cron('0 9 * * *')\n *     .handler(async () => {\n *         await reportService.generateDaily();\n *     });\n *\n * // Run once on server start\n * export const initCacheJob = job('init-cache')\n *     .runOnce()\n *     .handler(async () => {\n *         await cache.warmup();\n *     });\n *\n * // With options\n * export const importantJob = job('important-task')\n *     .input(Type.Object({ id: Type.String() }))\n *     .options({\n *         retryLimit: 5,\n *         retryDelay: 5000,\n *         priority: 10,\n *     })\n *     .handler(async (input) => {\n *         await processImportant(input.id);\n *     });\n * ```\n */\nexport function job(name: string): JobBuilder<void>\n{\n    return new JobBuilder(name);\n}\n","/**\n * Job Router\n *\n * Groups job definitions for registration with the server\n */\n\nimport type { JobDef, JobRouter, JobRouterEntry } from './types';\n\n/**\n * Type guard to check if value is a JobDef\n */\nexport function isJobDef(value: unknown): value is JobDef<any>\n{\n    return (\n        value !== null &&\n        typeof value === 'object' &&\n        'name' in value &&\n        'handler' in value &&\n        'send' in value &&\n        'run' in value\n    );\n}\n\n/**\n * Type guard to check if value is a JobRouter\n */\nexport function isJobRouter(value: unknown): value is JobRouter<any>\n{\n    return (\n        value !== null &&\n        typeof value === 'object' &&\n        'jobs' in value &&\n        '_jobs' in value\n    );\n}\n\n/**\n * Define a job router to group jobs together\n *\n * @example\n * ```typescript\n * // Flat structure\n * export const jobRouter = defineJobRouter({\n *     sendWelcomeEmail,\n *     dailyReport,\n *     initCache,\n * });\n *\n * // Nested structure\n * export const jobRouter = defineJobRouter({\n *     email: defineJobRouter({\n *         sendWelcome: sendWelcomeEmailJob,\n *         sendReset: sendResetPasswordJob,\n *     }),\n *     reports: defineJobRouter({\n *         daily: dailyReportJob,\n *         weekly: weeklyReportJob,\n *     }),\n * });\n *\n * // Mixed\n * export const jobRouter = defineJobRouter({\n *     initCache,  // flat\n *     email: defineJobRouter({ ... }),  // nested\n * });\n * ```\n */\nexport function defineJobRouter<\n    TJobs extends Record<string, JobRouterEntry>\n>(jobs: TJobs): JobRouter<TJobs>\n{\n    return {\n        jobs,\n        _jobs: jobs,\n    };\n}\n\n/**\n * Collect all JobDefs from a JobRouter (including nested)\n */\nexport function collectJobs(\n    router: JobRouter<any>,\n    prefix = ''\n): JobDef<any>[]\n{\n    const jobs: JobDef<any>[] = [];\n\n    for (const [key, value] of Object.entries(router.jobs))\n    {\n        const name = prefix ? `${prefix}.${key}` : key;\n\n        if (isJobRouter(value))\n        {\n            // Nested router - recurse\n            jobs.push(...collectJobs(value, name));\n        }\n        else if (isJobDef(value))\n        {\n            jobs.push(value);\n        }\n    }\n\n    return jobs;\n}\n","/**\n * Job Registration\n *\n * Registers jobs with pg-boss\n */\n\nimport type PgBoss from 'pg-boss';\nimport { logger } from '@spfn/core/logger';\nimport type { JobDef, JobOptions, JobRouter } from './types';\nimport type { EventDef } from '@spfn/core/event';\nimport { collectJobs } from './job-router';\nimport { getBoss, shouldClearOnStart } from './boss';\n\nconst jobLogger = logger.child('@spfn/core:job');\n\n/**\n * Get the pg-boss queue name for an event\n */\nexport function getEventQueueName(eventName: string): string\n{\n    return `event:${eventName}`;\n}\n\n/**\n * Build default pg-boss options for a job\n */\nfunction getDefaultJobOptions(options?: JobOptions): PgBoss.SendOptions\n{\n    return {\n        retryLimit: options?.retryLimit ?? 3,\n        retryDelay: options?.retryDelay ?? 1000,\n        expireInSeconds: options?.expireInSeconds ?? 300,\n    };\n}\n\n/**\n * Register all jobs from a JobRouter with pg-boss\n */\nexport async function registerJobs(router: JobRouter<any>): Promise<void>\n{\n    const boss = getBoss();\n    if (!boss)\n    {\n        throw new Error(\n            'pg-boss not initialized. Call initBoss() before registerJobs()'\n        );\n    }\n\n    const jobs = collectJobs(router);\n    const clearOnStart = shouldClearOnStart();\n\n    jobLogger.info(`Registering ${jobs.length} job(s)...`);\n\n    // Clear existing jobs if requested (useful for development)\n    if (clearOnStart)\n    {\n        jobLogger.info('Clearing existing jobs before registration...');\n        for (const job of jobs)\n        {\n            // Clear job queue\n            await boss.deleteAllJobs(job.name);\n\n            // Also clear event queue if subscribed\n            if (job.subscribedEvent)\n            {\n                const eventQueue = getEventQueueName(job.subscribedEvent);\n                await boss.deleteAllJobs(eventQueue);\n            }\n        }\n        jobLogger.info('Existing jobs cleared');\n    }\n\n    for (const job of jobs)\n    {\n        await registerJob(job);\n    }\n\n    jobLogger.info('All jobs registered successfully');\n}\n\n/**\n * Register worker handler for a job\n */\nasync function registerWorker(\n    boss: PgBoss,\n    job: JobDef<any>,\n    queueName: string\n): Promise<void>\n{\n    await boss.work(\n        queueName,\n        { batchSize: 1 },\n        async (jobs) =>\n        {\n            for (const pgBossJob of jobs)\n            {\n                jobLogger.debug(`[Job:${job.name}] Executing...`, { jobId: pgBossJob.id });\n\n                const startTime = Date.now();\n\n                try\n                {\n                    if (job.inputSchema)\n                    {\n                        await (job.handler as (input: unknown) => Promise<void>)(pgBossJob.data);\n                    }\n                    else\n                    {\n                        await (job.handler as () => Promise<void>)();\n                    }\n\n                    const duration = Date.now() - startTime;\n                    jobLogger.info(`[Job:${job.name}] Completed in ${duration}ms`, {\n                        jobId: pgBossJob.id,\n                        duration,\n                    });\n                }\n                catch (error)\n                {\n                    const duration = Date.now() - startTime;\n                    jobLogger.error(`[Job:${job.name}] Failed after ${duration}ms`, {\n                        jobId: pgBossJob.id,\n                        duration,\n                        error: error instanceof Error ? error.message : String(error),\n                    });\n                    throw error;\n                }\n            }\n        }\n    );\n}\n\n/**\n * Connect event to pg-boss queue\n */\nfunction connectEventToQueue(\n    boss: PgBoss,\n    job: JobDef<any>,\n    queueName: string\n): void\n{\n    if (!job._subscribedEventDef)\n    {\n        return;\n    }\n\n    const eventDef = job._subscribedEventDef as EventDef<any>;\n    eventDef._registerJobQueue(queueName, async (queue, payload) =>\n    {\n        await boss.send(queue, payload as object, getDefaultJobOptions(job.options));\n    });\n\n    jobLogger.debug(`[Job:${job.name}] Connected to event: ${job.subscribedEvent}`);\n}\n\n/**\n * Register cron schedule for a job\n */\nasync function registerCronSchedule(boss: PgBoss, job: JobDef<any>): Promise<void>\n{\n    if (!job.cronExpression)\n    {\n        return;\n    }\n\n    jobLogger.debug(`[Job:${job.name}] Scheduling cron: ${job.cronExpression}`);\n\n    await boss.schedule(\n        job.name,\n        job.cronExpression,\n        {},\n        getDefaultJobOptions(job.options)\n    );\n\n    jobLogger.info(`[Job:${job.name}] Cron scheduled: ${job.cronExpression}`);\n}\n\n/**\n * Queue a runOnce job\n */\nasync function queueRunOnceJob(boss: PgBoss, job: JobDef<any>): Promise<void>\n{\n    if (!job.runOnce)\n    {\n        return;\n    }\n\n    jobLogger.debug(`[Job:${job.name}] Queuing runOnce job`);\n\n    await boss.send(\n        job.name,\n        {},\n        {\n            ...getDefaultJobOptions(job.options),\n            singletonKey: `runOnce:${job.name}`,\n        }\n    );\n\n    jobLogger.info(`[Job:${job.name}] runOnce job queued`);\n}\n\n/**\n * Register a single job with pg-boss\n */\nasync function registerJob(job: JobDef<any>): Promise<void>\n{\n    const boss = getBoss();\n    if (!boss)\n    {\n        throw new Error('pg-boss not initialized');\n    }\n\n    const queueName = job.subscribedEvent\n        ? getEventQueueName(job.subscribedEvent)\n        : job.name;\n\n    jobLogger.debug(`Registering job: ${job.name}`, {\n        queueName,\n        subscribedEvent: job.subscribedEvent,\n    });\n\n    await registerWorker(boss, job, queueName);\n    connectEventToQueue(boss, job, queueName);\n    await registerCronSchedule(boss, job);\n    await queueRunOnceJob(boss, job);\n\n    jobLogger.debug(`Job registered: ${job.name}`);\n}\n"]}
+{"version":3,"sources":["../../src/job/boss.ts","../../src/job/job-builder.ts","../../src/job/job-router.ts","../../src/job/register-jobs.ts"],"names":["jobLogger","logger","job"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * pg-boss Wrapper\n *\n * Manages pg-boss instance lifecycle\n */\n\nimport PgBoss from 'pg-boss';\nimport { logger } from '@spfn/core/logger';\n\nconst jobLogger = logger.child('@spfn/core:job');\n\n/**\n * Global pg-boss instance\n */\nlet bossInstance: PgBoss | null = null;\n\n/**\n * Stored config for access during registration\n */\nlet bossConfig: BossConfig | null = null;\n\n/**\n * Options for pg-boss initialization\n *\n * @example\n * ```typescript\n * await initBoss({\n *     connectionString: process.env.DATABASE_URL,\n *     schema: 'spfn_queue',\n *     clearOnStart: process.env.NODE_ENV === 'development',\n * });\n * ```\n */\nexport interface BossOptions\n{\n    /**\n     * PostgreSQL connection string\n     *\n     * @example 'postgresql://user:password@localhost:5432/mydb'\n     */\n    connectionString: string;\n\n    /**\n     * Schema name for pg-boss tables\n     *\n     * pg-boss creates its own tables in this schema.\n     *\n     * @default 'spfn_queue'\n     */\n    schema?: string;\n\n    /**\n     * Maintenance interval in seconds\n     *\n     * pg-boss runs maintenance tasks (cleanup, archiving) at this interval.\n     *\n     * @default 120\n     */\n    maintenanceIntervalSeconds?: number;\n\n    /**\n     * Monitor state changes interval in seconds\n     *\n     * When set, pg-boss emits state change events at this interval.\n     *\n     * @default undefined (disabled)\n     */\n    monitorIntervalSeconds?: number;\n\n    /**\n     * Clear all pending/scheduled jobs on startup\n     *\n     * Useful for development mode to start with a clean queue.\n     * Should be false in production.\n     *\n     * @default false\n     */\n    clearOnStart?: boolean;\n}\n\n/**\n * @deprecated Use BossOptions instead\n */\nexport type BossConfig = BossOptions;\n\n/**\n * Initialize pg-boss with the given configuration\n *\n * Must be called before registerJobs(). Typically handled by defineServerConfig().\n *\n * @param options - pg-boss configuration options\n * @returns The pg-boss instance\n *\n * @example\n * ```typescript\n * const boss = await initBoss({\n *     connectionString: process.env.DATABASE_URL!,\n *     schema: 'spfn_queue',\n * });\n * ```\n */\nexport async function initBoss(options: BossOptions): Promise<PgBoss>\n{\n    if (bossInstance)\n    {\n        jobLogger.warn('pg-boss already initialized, returning existing instance');\n        return bossInstance;\n    }\n\n    jobLogger.info('Initializing pg-boss...');\n\n    bossConfig = options;\n    bossInstance = new PgBoss({\n        connectionString: options.connectionString,\n        schema: options.schema ?? 'spfn_queue',\n        maintenanceIntervalSeconds: options.maintenanceIntervalSeconds ?? 120,\n        monitorIntervalSeconds: options.monitorIntervalSeconds,\n    });\n\n    // Event handlers\n    bossInstance.on('error', (error) =>\n    {\n        jobLogger.error('pg-boss error:', error);\n    });\n\n    await bossInstance.start();\n\n    jobLogger.info('pg-boss started successfully');\n\n    return bossInstance;\n}\n\n/**\n * Get the current pg-boss instance\n */\nexport function getBoss(): PgBoss | null\n{\n    return bossInstance;\n}\n\n/**\n * Stop pg-boss gracefully\n */\nexport async function stopBoss(): Promise<void>\n{\n    if (!bossInstance)\n    {\n        return;\n    }\n\n    jobLogger.info('Stopping pg-boss...');\n\n    try\n    {\n        await bossInstance.stop({ graceful: true, timeout: 30000 });\n        jobLogger.info('pg-boss stopped gracefully');\n    }\n    catch (error)\n    {\n        jobLogger.error('Error stopping pg-boss:', error);\n        throw error;\n    }\n    finally\n    {\n        bossInstance = null;\n        bossConfig = null;\n    }\n}\n\n/**\n * Check if pg-boss is initialized and running\n */\nexport function isBossRunning(): boolean\n{\n    return bossInstance !== null;\n}\n\n/**\n * Check if jobs should be cleared on start\n */\nexport function shouldClearOnStart(): boolean\n{\n    return bossConfig?.clearOnStart ?? false;\n}\n","/**\n * Job Builder\n *\n * Fluent API for defining jobs, similar to route builder pattern\n */\n\nimport type { Static, TSchema } from '@sinclair/typebox';\nimport type { JobDef, JobHandler, JobOptions, JobSendOptions } from './types';\nimport type { EventDef, InferEventPayload } from '@spfn/core/event';\nimport { getBoss } from './boss';\n\n/**\n * Build pg-boss options from job defaults and send options\n */\nfunction buildPgBossOptions(\n    defaults?: JobOptions,\n    sendOptions?: JobSendOptions\n): Record<string, unknown>\n{\n    const options: Record<string, unknown> = {};\n\n    // Send options (per-job invocation)\n    if (sendOptions?.startAfter)\n    {\n        options.startAfter = sendOptions.startAfter;\n    }\n    if (sendOptions?.singletonKey)\n    {\n        options.singletonKey = sendOptions.singletonKey;\n    }\n    if (sendOptions?.priority !== undefined)\n    {\n        options.priority = sendOptions.priority;\n    }\n\n    // Default options (from job definition)\n    if (defaults?.retryLimit !== undefined)\n    {\n        options.retryLimit = defaults.retryLimit;\n    }\n    if (defaults?.retryDelay !== undefined)\n    {\n        options.retryDelay = defaults.retryDelay;\n    }\n    if (defaults?.expireInSeconds !== undefined)\n    {\n        options.expireInSeconds = defaults.expireInSeconds;\n    }\n    if (defaults?.priority !== undefined && sendOptions?.priority === undefined)\n    {\n        options.priority = defaults.priority;\n    }\n    if (defaults?.singletonKey && !sendOptions?.singletonKey)\n    {\n        options.singletonKey = defaults.singletonKey;\n    }\n    if (defaults?.retentionSeconds !== undefined)\n    {\n        options.retentionSeconds = defaults.retentionSeconds;\n    }\n\n    return options;\n}\n\n/**\n * Job builder class with fluent API\n */\nexport class JobBuilder<TInput = void>\n{\n    private _name: string;\n    private _inputSchema?: TSchema;\n    private _cronExpression?: string;\n    private _runOnce?: boolean;\n    private _subscribedEvent?: string;\n    private _subscribedEventDef?: EventDef<any>;\n    private _options?: JobOptions;\n    private _handler?: JobHandler<TInput>;\n\n    constructor(name: string)\n    {\n        this._name = name;\n    }\n\n    /**\n     * Define input schema with TypeBox\n     */\n    input<TSchema extends import('@sinclair/typebox').TSchema>(\n        schema: TSchema\n    ): JobBuilder<Static<TSchema>>\n    {\n        const builder = new JobBuilder<Static<TSchema>>(this._name);\n        builder._inputSchema = schema;\n        builder._cronExpression = this._cronExpression;\n        builder._runOnce = this._runOnce;\n        builder._subscribedEvent = this._subscribedEvent;\n        builder._options = this._options;\n        return builder;\n    }\n\n    /**\n     * Subscribe to an event (decoupled triggering)\n     *\n     * @example\n     * ```typescript\n     * const userCreated = defineEvent('user.created', Type.Object({\n     *     userId: Type.String(),\n     * }));\n     *\n     * const sendWelcomeEmail = job('send-welcome-email')\n     *     .on(userCreated)\n     *     .handler(async (payload) => {\n     *         // payload is typed as { userId: string }\n     *     });\n     * ```\n     */\n    on<TEvent extends EventDef<any>>(\n        event: TEvent\n    ): JobBuilder<InferEventPayload<TEvent>>\n    {\n        const builder = new JobBuilder<InferEventPayload<TEvent>>(this._name);\n        builder._inputSchema = event.schema;\n        builder._subscribedEvent = event.name;\n        builder._subscribedEventDef = event;\n        builder._cronExpression = this._cronExpression;\n        builder._runOnce = this._runOnce;\n        builder._options = this._options;\n        return builder;\n    }\n\n    /**\n     * Set cron expression for scheduled execution\n     */\n    cron(expression: string): this\n    {\n        this._cronExpression = expression;\n        return this;\n    }\n\n    /**\n     * Mark job to run once on server start\n     */\n    runOnce(): this\n    {\n        this._runOnce = true;\n        return this;\n    }\n\n    /**\n     * Set job options (retry, expiration, etc.)\n     */\n    options(options: JobOptions): this\n    {\n        this._options = options;\n        return this;\n    }\n\n    /**\n     * Define the job handler and finalize the job definition\n     */\n    handler(fn: JobHandler<TInput>): JobDef<TInput>\n    {\n        this._handler = fn;\n\n        const name = this._name;\n        const inputSchema = this._inputSchema;\n        const cronExpression = this._cronExpression;\n        const runOnce = this._runOnce;\n        const subscribedEvent = this._subscribedEvent;\n        const subscribedEventDef = this._subscribedEventDef;\n        const options = this._options;\n        const handler = this._handler;\n\n        // Create send function\n        const send = async (\n            inputOrOptions?: TInput | JobSendOptions,\n            maybeOptions?: JobSendOptions\n        ): Promise<string | null> =>\n        {\n            const boss = getBoss();\n            if (!boss)\n            {\n                throw new Error(\n                    `[Job:${name}] pg-boss not initialized. ` +\n                    'Ensure jobs are registered with defineServerConfig().jobs()'\n                );\n            }\n\n            // Determine input and options based on whether job has input schema\n            const [input, sendOptions] = inputSchema\n                ? [inputOrOptions as TInput, maybeOptions]\n                : [undefined, inputOrOptions as JobSendOptions | undefined];\n\n            return await boss.send(\n                name,\n                input ?? {},\n                buildPgBossOptions(options, sendOptions)\n            );\n        };\n\n        // Create run function (synchronous execution)\n        const run = async (input?: TInput): Promise<void> =>\n        {\n            if (inputSchema)\n            {\n                await (handler as (input: TInput) => Promise<void>)(input as TInput);\n            }\n            else\n            {\n                await (handler as () => Promise<void>)();\n            }\n        };\n\n        return {\n            name,\n            inputSchema,\n            cronExpression,\n            runOnce,\n            subscribedEvent,\n            _subscribedEventDef: subscribedEventDef,\n            options,\n            handler,\n            send: send as JobDef<TInput>['send'],\n            run: run as JobDef<TInput>['run'],\n            _input: undefined as unknown as TInput,\n        };\n    }\n}\n\n/**\n * Create a new job definition\n *\n * @example\n * ```typescript\n * // Simple job without input\n * export const cleanupJob = job('cleanup')\n *     .handler(async () => {\n *         await db.cleanup();\n *     });\n *\n * // Job with typed input\n * export const sendEmailJob = job('send-email')\n *     .input(Type.Object({\n *         to: Type.String(),\n *         subject: Type.String(),\n *         body: Type.String(),\n *     }))\n *     .handler(async (input) => {\n *         await emailService.send(input.to, input.subject, input.body);\n *     });\n *\n * // Cron job\n * export const dailyReportJob = job('daily-report')\n *     .cron('0 9 * * *')\n *     .handler(async () => {\n *         await reportService.generateDaily();\n *     });\n *\n * // Run once on server start\n * export const initCacheJob = job('init-cache')\n *     .runOnce()\n *     .handler(async () => {\n *         await cache.warmup();\n *     });\n *\n * // With options\n * export const importantJob = job('important-task')\n *     .input(Type.Object({ id: Type.String() }))\n *     .options({\n *         retryLimit: 5,\n *         retryDelay: 5000,\n *         priority: 10,\n *     })\n *     .handler(async (input) => {\n *         await processImportant(input.id);\n *     });\n * ```\n */\nexport function job(name: string): JobBuilder<void>\n{\n    return new JobBuilder(name);\n}\n","/**\n * Job Router\n *\n * Groups job definitions for registration with the server\n */\n\nimport type { JobDef, JobRouter, JobRouterEntry } from './types';\n\n/**\n * Type guard to check if value is a JobDef\n */\nexport function isJobDef(value: unknown): value is JobDef<any>\n{\n    return (\n        value !== null &&\n        typeof value === 'object' &&\n        'name' in value &&\n        'handler' in value &&\n        'send' in value &&\n        'run' in value\n    );\n}\n\n/**\n * Type guard to check if value is a JobRouter\n */\nexport function isJobRouter(value: unknown): value is JobRouter<any>\n{\n    return (\n        value !== null &&\n        typeof value === 'object' &&\n        'jobs' in value &&\n        '_jobs' in value\n    );\n}\n\n/**\n * Define a job router to group jobs together\n *\n * @example\n * ```typescript\n * // Flat structure\n * export const jobRouter = defineJobRouter({\n *     sendWelcomeEmail,\n *     dailyReport,\n *     initCache,\n * });\n *\n * // Nested structure\n * export const jobRouter = defineJobRouter({\n *     email: defineJobRouter({\n *         sendWelcome: sendWelcomeEmailJob,\n *         sendReset: sendResetPasswordJob,\n *     }),\n *     reports: defineJobRouter({\n *         daily: dailyReportJob,\n *         weekly: weeklyReportJob,\n *     }),\n * });\n *\n * // Mixed\n * export const jobRouter = defineJobRouter({\n *     initCache,  // flat\n *     email: defineJobRouter({ ... }),  // nested\n * });\n * ```\n */\nexport function defineJobRouter<\n    TJobs extends Record<string, JobRouterEntry>\n>(jobs: TJobs): JobRouter<TJobs>\n{\n    return {\n        jobs,\n        _jobs: jobs,\n    };\n}\n\n/**\n * Collect all JobDefs from a JobRouter (including nested)\n */\nexport function collectJobs(\n    router: JobRouter<any>,\n    prefix = ''\n): JobDef<any>[]\n{\n    const jobs: JobDef<any>[] = [];\n\n    for (const [key, value] of Object.entries(router.jobs))\n    {\n        const name = prefix ? `${prefix}.${key}` : key;\n\n        if (isJobRouter(value))\n        {\n            // Nested router - recurse\n            jobs.push(...collectJobs(value, name));\n        }\n        else if (isJobDef(value))\n        {\n            jobs.push(value);\n        }\n    }\n\n    return jobs;\n}\n","/**\n * Job Registration\n *\n * Registers jobs with pg-boss\n */\n\nimport type PgBoss from 'pg-boss';\nimport { logger } from '@spfn/core/logger';\nimport type { JobDef, JobOptions, JobRouter } from './types';\nimport type { EventDef } from '@spfn/core/event';\nimport { collectJobs } from './job-router';\nimport { getBoss, shouldClearOnStart } from './boss';\n\nconst jobLogger = logger.child('@spfn/core:job');\n\n/**\n * Get the pg-boss queue name for an event\n */\nexport function getEventQueueName(eventName: string): string\n{\n    return `event:${eventName}`;\n}\n\n/**\n * Build default pg-boss options for a job\n */\nfunction getDefaultJobOptions(options?: JobOptions): PgBoss.SendOptions\n{\n    return {\n        retryLimit: options?.retryLimit ?? 3,\n        retryDelay: options?.retryDelay ?? 1000,\n        expireInSeconds: options?.expireInSeconds ?? 300,\n    };\n}\n\n/**\n * Register all jobs from a JobRouter with pg-boss\n *\n * This function:\n * 1. Collects all jobs from the router (including nested routers)\n * 2. Optionally clears existing jobs (if clearOnStart is enabled)\n * 3. Registers each job's worker handler with pg-boss\n * 4. Sets up cron schedules for scheduled jobs\n * 5. Queues runOnce jobs\n * 6. Connects event subscriptions to job queues\n *\n * @param router - JobRouter containing job definitions\n *\n * @example\n * ```typescript\n * // Define jobs\n * const sendEmail = job('send-email')\n *     .input(Type.Object({ to: Type.String() }))\n *     .handler(async (input) => { ... });\n *\n * const dailyReport = job('daily-report')\n *     .cron('0 9 * * *')\n *     .handler(async () => { ... });\n *\n * // Create router\n * const jobRouter = defineJobRouter({ sendEmail, dailyReport });\n *\n * // Initialize pg-boss first\n * await initBoss({ connectionString: process.env.DATABASE_URL! });\n *\n * // Register jobs\n * await registerJobs(jobRouter);\n * ```\n */\nexport async function registerJobs(router: JobRouter<any>): Promise<void>\n{\n    const boss = getBoss();\n    if (!boss)\n    {\n        throw new Error(\n            'pg-boss not initialized. Call initBoss() before registerJobs()'\n        );\n    }\n\n    const jobs = collectJobs(router);\n    const clearOnStart = shouldClearOnStart();\n\n    jobLogger.info(`Registering ${jobs.length} job(s)...`);\n\n    // Clear existing jobs if requested (useful for development)\n    if (clearOnStart)\n    {\n        jobLogger.info('Clearing existing jobs before registration...');\n        for (const job of jobs)\n        {\n            // Clear job queue\n            await boss.deleteAllJobs(job.name);\n\n            // Also clear event queue if subscribed\n            if (job.subscribedEvent)\n            {\n                const eventQueue = getEventQueueName(job.subscribedEvent);\n                await boss.deleteAllJobs(eventQueue);\n            }\n        }\n        jobLogger.info('Existing jobs cleared');\n    }\n\n    for (const job of jobs)\n    {\n        await registerJob(job);\n    }\n\n    jobLogger.info('All jobs registered successfully');\n}\n\n/**\n * Register worker handler for a job\n */\nasync function registerWorker(\n    boss: PgBoss,\n    job: JobDef<any>,\n    queueName: string\n): Promise<void>\n{\n    await boss.work(\n        queueName,\n        { batchSize: 1 },\n        async (jobs) =>\n        {\n            for (const pgBossJob of jobs)\n            {\n                jobLogger.debug(`[Job:${job.name}] Executing...`, { jobId: pgBossJob.id });\n\n                const startTime = Date.now();\n\n                try\n                {\n                    if (job.inputSchema)\n                    {\n                        await (job.handler as (input: unknown) => Promise<void>)(pgBossJob.data);\n                    }\n                    else\n                    {\n                        await (job.handler as () => Promise<void>)();\n                    }\n\n                    const duration = Date.now() - startTime;\n                    jobLogger.info(`[Job:${job.name}] Completed in ${duration}ms`, {\n                        jobId: pgBossJob.id,\n                        duration,\n                    });\n                }\n                catch (error)\n                {\n                    const duration = Date.now() - startTime;\n                    jobLogger.error(`[Job:${job.name}] Failed after ${duration}ms`, {\n                        jobId: pgBossJob.id,\n                        duration,\n                        error: error instanceof Error ? error.message : String(error),\n                    });\n                    throw error;\n                }\n            }\n        }\n    );\n}\n\n/**\n * Connect event to pg-boss queue\n */\nfunction connectEventToQueue(\n    boss: PgBoss,\n    job: JobDef<any>,\n    queueName: string\n): void\n{\n    if (!job._subscribedEventDef)\n    {\n        return;\n    }\n\n    const eventDef = job._subscribedEventDef as EventDef<any>;\n    eventDef._registerJobQueue(queueName, async (queue, payload) =>\n    {\n        await boss.send(queue, payload as object, getDefaultJobOptions(job.options));\n    });\n\n    jobLogger.debug(`[Job:${job.name}] Connected to event: ${job.subscribedEvent}`);\n}\n\n/**\n * Register cron schedule for a job\n */\nasync function registerCronSchedule(boss: PgBoss, job: JobDef<any>): Promise<void>\n{\n    if (!job.cronExpression)\n    {\n        return;\n    }\n\n    jobLogger.debug(`[Job:${job.name}] Scheduling cron: ${job.cronExpression}`);\n\n    await boss.schedule(\n        job.name,\n        job.cronExpression,\n        {},\n        getDefaultJobOptions(job.options)\n    );\n\n    jobLogger.info(`[Job:${job.name}] Cron scheduled: ${job.cronExpression}`);\n}\n\n/**\n * Queue a runOnce job\n */\nasync function queueRunOnceJob(boss: PgBoss, job: JobDef<any>): Promise<void>\n{\n    if (!job.runOnce)\n    {\n        return;\n    }\n\n    jobLogger.debug(`[Job:${job.name}] Queuing runOnce job`);\n\n    await boss.send(\n        job.name,\n        {},\n        {\n            ...getDefaultJobOptions(job.options),\n            singletonKey: `runOnce:${job.name}`,\n        }\n    );\n\n    jobLogger.info(`[Job:${job.name}] runOnce job queued`);\n}\n\n/**\n * Register a single job with pg-boss\n */\nasync function registerJob(job: JobDef<any>): Promise<void>\n{\n    const boss = getBoss();\n    if (!boss)\n    {\n        throw new Error('pg-boss not initialized');\n    }\n\n    const queueName = job.subscribedEvent\n        ? getEventQueueName(job.subscribedEvent)\n        : job.name;\n\n    jobLogger.debug(`Registering job: ${job.name}`, {\n        queueName,\n        subscribedEvent: job.subscribedEvent,\n    });\n\n    await registerWorker(boss, job, queueName);\n    connectEventToQueue(boss, job, queueName);\n    await registerCronSchedule(boss, job);\n    await queueRunOnceJob(boss, job);\n\n    jobLogger.debug(`Job registered: ${job.name}`);\n}\n"]}

package/dist/middleware/index.d.ts

@@ -6,46 +6,137 @@ import { Context, Next } from 'hono';
  * Handles SerializableError with automatic serialization and standard errors
  */
 
+/**
+ * Options for ErrorHandler middleware
+ */
 interface ErrorHandlerOptions {
     /**
-     * Include stack trace in response
+     * Include stack trace in error response
+     *
+     * Useful for debugging in development, should be disabled in production.
+     *
      * @default env.NODE_ENV !== 'production'
      */
     includeStack?: boolean;
     /**
-     * Enable error logging
+     * Enable error logging to console
+     *
+     * Logs errors with appropriate level (warn for 4xx, error for 5xx).
+     *
      * @default true
      */
     enableLogging?: boolean;
 }
 /**
- * Error handler middleware
+ * Error handler middleware for Hono
+ *
+ * Handles SerializableError with automatic serialization and standard errors.
+ * SerializableError instances are serialized using their toJSON() method,
+ * preserving custom fields like `resource`, `fields`, etc.
+ *
+ * @param options - Configuration options
+ * @returns Error handler function for Hono's onError hook
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { ErrorHandler } from '@spfn/core/middleware';
  *
- * Used in Hono's onError hook
+ * const app = new Hono();
+ *
+ * // Register error handler
+ * app.onError(ErrorHandler({
+ *     includeStack: process.env.NODE_ENV !== 'production',
+ *     enableLogging: true,
+ * }));
+ *
+ * // Throw SerializableError in routes
+ * app.get('/users/:id', (c) => {
+ *     throw new NotFoundError({ message: 'User not found', resource: 'User' });
+ *     // Response: { __type: 'NotFoundError', message: 'User not found', resource: 'User' }
+ * });
+ * ```
  */
 declare function ErrorHandler(options?: ErrorHandlerOptions): (err: Error, c: Context) => Response | Promise<Response>;
 
-interface RequestLoggerConfig {
+/**
+ * Options for RequestLogger middleware
+ */
+interface RequestLoggerOptions {
     /**
-     * Paths to exclude from logging (health checks, etc.)
+     * Paths to exclude from logging
+     *
+     * Supports exact match and prefix match (e.g., '/health' excludes '/health/db').
+     *
+     * @default ['/health', '/ping', '/favicon.ico']
+     *
+     * @example
+     * ```typescript
+     * excludePaths: ['/health', '/metrics', '/_next']
+     * ```
      */
     excludePaths?: string[];
     /**
-     * Field names to mask for sensitive data
+     * Field names to mask in logged request bodies
+     *
+     * Case-insensitive partial matching (e.g., 'password' masks 'userPassword').
+     *
+     * @default ['password', 'token', 'apiKey', 'secret', 'authorization']
+     *
+     * @example
+     * ```typescript
+     * sensitiveFields: ['password', 'creditCard', 'ssn']
+     * ```
      */
     sensitiveFields?: string[];
     /**
-     * Slow request threshold (ms)
+     * Threshold in milliseconds for marking requests as slow
+     *
+     * Slow requests are logged with `slow: true` flag.
+     *
+     * @default 1000
      */
     slowRequestThreshold?: number;
 }
+/**
+ * @deprecated Use RequestLoggerOptions instead
+ */
+type RequestLoggerConfig = RequestLoggerOptions;
 /**
  * Mask sensitive data with circular reference handling
  */
 declare function maskSensitiveData(obj: any, sensitiveFields: string[], seen?: WeakSet<object>): any;
 /**
- * Request Logger middleware
+ * Request logger middleware for Hono
+ *
+ * Logs incoming requests with method, path, IP, and user agent.
+ * Logs completed requests with status code and duration.
+ * Automatically generates unique request IDs and masks sensitive data.
+ *
+ * @param options - Configuration options
+ * @returns Hono middleware function
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { RequestLogger } from '@spfn/core/middleware';
+ *
+ * const app = new Hono();
+ *
+ * // Add request logging
+ * app.use(RequestLogger({
+ *     excludePaths: ['/health', '/metrics'],
+ *     sensitiveFields: ['password', 'token'],
+ *     slowRequestThreshold: 2000,
+ * }));
+ *
+ * // Access request ID in handlers
+ * app.get('/users', (c) => {
+ *     const requestId = c.get('requestId');
+ *     return c.json({ requestId });
+ * });
+ * ```
  */
-declare function RequestLogger(config?: RequestLoggerConfig): (c: Context, next: Next) => Promise<void>;
+declare function RequestLogger(options?: RequestLoggerOptions): (c: Context, next: Next) => Promise<void>;
 
-export { ErrorHandler, type ErrorHandlerOptions, RequestLogger, type RequestLoggerConfig, maskSensitiveData };
+export { ErrorHandler, type ErrorHandlerOptions, RequestLogger, type RequestLoggerConfig, type RequestLoggerOptions, maskSensitiveData };

package/dist/middleware/index.js

@@ -86,8 +86,8 @@ function maskSensitiveData(obj, sensitiveFields, seen = /* @__PURE__ */ new Weak
   }
   return masked;
 }
-function RequestLogger(config) {
-  const cfg = { ...DEFAULT_CONFIG, ...config };
+function RequestLogger(options) {
+  const cfg = { ...DEFAULT_CONFIG, ...options };
   const apiLogger = logger.child("@spfn/core:api");
   return async (c, next) => {
     const path = new URL(c.req.url).pathname;