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

package/dist/event/sse/client.d.ts

@@ -0,0 +1,82 @@
+import { E as EventRouterDef, I as InferEventNames } from '../../router-Di7ENoah.js';
+import { e as SSESubscribeOptions, g as SSEUnsubscribe, f as SSEConnectionState, b as SSEClientConfig } from '../../types-B-e_f2dQ.js';
+import '@sinclair/typebox';
+
+/**
+ * SSE Client
+ *
+ * Type-safe EventSource wrapper for event subscription
+ *
+ * @example
+ * ```typescript
+ * import { createSSEClient } from '@spfn/core/event/sse/client';
+ * import type { EventRouter } from '@/server/events';
+ *
+ * // Uses defaults: NEXT_PUBLIC_SPFN_API_URL + /events/stream
+ * const client = createSSEClient<EventRouter>();
+ *
+ * // Or with custom host/pathname
+ * const client = createSSEClient<EventRouter>({
+ *     host: 'https://api.example.com',
+ *     pathname: '/sse',
+ * });
+ *
+ * const unsubscribe = client.subscribe({
+ *     events: ['userCreated', 'orderPlaced'],
+ *     handlers: {
+ *         userCreated: (payload) => console.log('User:', payload.userId),
+ *         orderPlaced: (payload) => console.log('Order:', payload.orderId),
+ *     },
+ * });
+ *
+ * // Later: cleanup
+ * unsubscribe();
+ * ```
+ */
+
+/**
+ * SSE Client instance
+ */
+interface SSEClient<TRouter extends EventRouterDef<any>> {
+    /**
+     * Subscribe to events
+     */
+    subscribe(options: SSESubscribeOptions<TRouter>): SSEUnsubscribe;
+    /**
+     * Get current connection state
+     */
+    getState(): SSEConnectionState;
+    /**
+     * Close all connections
+     */
+    close(): void;
+}
+declare function createSSEClient<TRouter extends EventRouterDef<any>>(config?: SSEClientConfig): SSEClient<TRouter>;
+/**
+ * Simple subscribe function for one-off subscriptions
+ *
+ * @example
+ * ```typescript
+ * import { subscribeToEvents } from '@spfn/core/event/sse/client';
+ * import type { EventRouter } from '@/server/events';
+ *
+ * // Using defaults
+ * const unsubscribe = subscribeToEvents<EventRouter>(
+ *     ['userCreated', 'orderPlaced'],
+ *     {
+ *         userCreated: (payload) => console.log('User:', payload),
+ *         orderPlaced: (payload) => console.log('Order:', payload),
+ *     }
+ * );
+ *
+ * // With custom host
+ * const unsubscribe = subscribeToEvents<EventRouter>(
+ *     ['userCreated'],
+ *     { userCreated: (payload) => console.log('User:', payload) },
+ *     { host: 'https://api.example.com' }
+ * );
+ * ```
+ */
+declare function subscribeToEvents<TRouter extends EventRouterDef<any>>(events: InferEventNames<TRouter>[], handlers: SSESubscribeOptions<TRouter>['handlers'], options?: SSEClientConfig): SSEUnsubscribe;
+
+export { type SSEClient, createSSEClient, subscribeToEvents };

package/dist/event/sse/client.js

@@ -0,0 +1,115 @@
+// src/event/sse/client.ts
+var SSE_DEFAULTS = {
+  host: typeof process !== "undefined" ? process.env.NEXT_PUBLIC_SPFN_API_URL || "http://localhost:8790" : "http://localhost:8790",
+  pathname: "/events/stream"
+};
+function createSSEClient(config = {}) {
+  const {
+    url,
+    host = SSE_DEFAULTS.host,
+    pathname = SSE_DEFAULTS.pathname,
+    reconnect = true,
+    reconnectDelay = 3e3,
+    maxReconnectAttempts = 0,
+    withCredentials = false
+  } = config;
+  const baseUrl = url || `${host}${pathname}`;
+  let eventSource = null;
+  let state = "closed";
+  let reconnectAttempts = 0;
+  let reconnectTimer = null;
+  function subscribe(options) {
+    const { events, handlers, onOpen, onError, onReconnect } = options;
+    const eventNames = events;
+    const streamUrl = `${baseUrl}?events=${eventNames.join(",")}`;
+    function connect() {
+      state = "connecting";
+      eventSource = new EventSource(streamUrl, {
+        withCredentials
+      });
+      eventSource.onopen = () => {
+        state = "open";
+        reconnectAttempts = 0;
+        onOpen?.();
+      };
+      eventSource.onerror = (error) => {
+        state = "error";
+        onError?.(error);
+        if (reconnect && eventSource?.readyState === EventSource.CLOSED) {
+          if (maxReconnectAttempts === 0 || reconnectAttempts < maxReconnectAttempts) {
+            reconnectAttempts++;
+            onReconnect?.(reconnectAttempts);
+            reconnectTimer = setTimeout(() => {
+              connect();
+            }, reconnectDelay);
+          }
+        }
+      };
+      eventSource.addEventListener("connected", (e) => {
+        try {
+          const data = JSON.parse(e.data);
+          console.debug("[SSE] Connected:", data);
+        } catch {
+        }
+      });
+      eventSource.addEventListener("ping", () => {
+      });
+      for (const eventName of eventNames) {
+        const handler = handlers[eventName];
+        if (!handler) {
+          continue;
+        }
+        eventSource.addEventListener(eventName, (e) => {
+          try {
+            const message = JSON.parse(e.data);
+            handler(message.data);
+          } catch (err) {
+            console.error(`[SSE] Failed to parse event "${eventName}":`, err);
+          }
+        });
+      }
+    }
+    connect();
+    return () => {
+      if (reconnectTimer) {
+        clearTimeout(reconnectTimer);
+        reconnectTimer = null;
+      }
+      if (eventSource) {
+        eventSource.close();
+        eventSource = null;
+      }
+      state = "closed";
+    };
+  }
+  function getState() {
+    return state;
+  }
+  function close() {
+    if (reconnectTimer) {
+      clearTimeout(reconnectTimer);
+      reconnectTimer = null;
+    }
+    if (eventSource) {
+      eventSource.close();
+      eventSource = null;
+    }
+    state = "closed";
+  }
+  return {
+    subscribe,
+    getState,
+    close
+  };
+}
+function subscribeToEvents(events, handlers, options) {
+  const client = createSSEClient(options);
+  return client.subscribe({
+    events,
+    handlers
+  });
+}
+
+export { createSSEClient, subscribeToEvents };
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

package/dist/event/sse/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/event/sse/client.ts"],"names":[],"mappings":";AAqGA,IAAM,YAAA,GAAe;AAAA,EACjB,MAAM,OAAO,OAAA,KAAY,cAClB,OAAA,CAAQ,GAAA,CAAI,4BAA4B,uBAAA,GACzC,uBAAA;AAAA,EACN,QAAA,EAAU;AACd,CAAA;AAEO,SAAS,eAAA,CACZ,MAAA,GAA0B,EAAC,EAE/B;AACI,EAAA,MAAM;AAAA,IACF,GAAA;AAAA,IACA,OAAO,YAAA,CAAa,IAAA;AAAA,IACpB,WAAW,YAAA,CAAa,QAAA;AAAA,IACxB,SAAA,GAAY,IAAA;AAAA,IACZ,cAAA,GAAiB,GAAA;AAAA,IACjB,oBAAA,GAAuB,CAAA;AAAA,IACvB,eAAA,GAAkB;AAAA,GACtB,GAAI,MAAA;AAGJ,EAAA,MAAM,OAAA,GAAU,GAAA,IAAO,CAAA,EAAG,IAAI,GAAG,QAAQ,CAAA,CAAA;AAEzC,EAAA,IAAI,WAAA,GAAkC,IAAA;AACtC,EAAA,IAAI,KAAA,GAA4B,QAAA;AAChC,EAAA,IAAI,iBAAA,GAAoB,CAAA;AACxB,EAAA,IAAI,cAAA,GAAuD,IAAA;AAE3D,EAAA,SAAS,UAAU,OAAA,EACnB;AACI,IAAA,MAAM,EAAE,MAAA,EAAQ,QAAA,EAAU,MAAA,EAAQ,OAAA,EAAS,aAAY,GAAI,OAAA;AAG3D,IAAA,MAAM,UAAA,GAAa,MAAA;AACnB,IAAA,MAAM,YAAY,CAAA,EAAG,OAAO,WAAW,UAAA,CAAW,IAAA,CAAK,GAAG,CAAC,CAAA,CAAA;AAE3D,IAAA,SAAS,OAAA,GACT;AACI,MAAA,KAAA,GAAQ,YAAA;AAER,MAAA,WAAA,GAAc,IAAI,YAAY,SAAA,EAAW;AAAA,QACrC;AAAA,OACH,CAAA;AAGD,MAAA,WAAA,CAAY,SAAS,MACrB;AACI,QAAA,KAAA,GAAQ,MAAA;AACR,QAAA,iBAAA,GAAoB,CAAA;AACpB,QAAA,MAAA,IAAS;AAAA,MACb,CAAA;AAGA,MAAA,WAAA,CAAY,OAAA,GAAU,CAAC,KAAA,KACvB;AACI,QAAA,KAAA,GAAQ,OAAA;AACR,QAAA,OAAA,GAAU,KAAK,CAAA;AAGf,QAAA,IAAI,SAAA,IAAa,WAAA,EAAa,UAAA,KAAe,WAAA,CAAY,MAAA,EACzD;AACI,UAAA,IAAI,oBAAA,KAAyB,CAAA,IAAK,iBAAA,GAAoB,oBAAA,EACtD;AACI,YAAA,iBAAA,EAAA;AACA,YAAA,WAAA,GAAc,iBAAiB,CAAA;AAE/B,YAAA,cAAA,GAAiB,WAAW,MAC5B;AACI,cAAA,OAAA,EAAQ;AAAA,YACZ,GAAG,cAAc,CAAA;AAAA,UACrB;AAAA,QACJ;AAAA,MACJ,CAAA;AAGA,MAAA,WAAA,CAAY,gBAAA,CAAiB,WAAA,EAAa,CAAC,CAAA,KAC3C;AACI,QAAA,IACA;AACI,UAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,CAAA,CAAE,IAAI,CAAA;AAC9B,UAAA,OAAA,CAAQ,KAAA,CAAM,oBAAoB,IAAI,CAAA;AAAA,QAC1C,CAAA,CAAA,MAEA;AAAA,QAEA;AAAA,MACJ,CAAC,CAAA;AAGD,MAAA,WAAA,CAAY,gBAAA,CAAiB,QAAQ,MACrC;AAAA,MAEA,CAAC,CAAA;AAGD,MAAA,KAAA,MAAW,aAAa,UAAA,EACxB;AAEI,QAAA,MAAM,OAAA,GAAW,SAAsE,SAAS,CAAA;AAEhG,QAAA,IAAI,CAAC,OAAA,EACL;AACI,UAAA;AAAA,QACJ;AAEA,QAAA,WAAA,CAAY,gBAAA,CAAiB,SAAA,EAAW,CAAC,CAAA,KACzC;AACI,UAAA,IACA;AACI,YAAA,MAAM,OAAA,GAAsB,IAAA,CAAK,KAAA,CAAM,CAAA,CAAE,IAAI,CAAA;AAC7C,YAAA,OAAA,CAAQ,QAAQ,IAAI,CAAA;AAAA,UACxB,SACO,GAAA,EACP;AACI,YAAA,OAAA,CAAQ,KAAA,CAAM,CAAA,6BAAA,EAAgC,SAAS,CAAA,EAAA,CAAA,EAAM,GAAG,CAAA;AAAA,UACpE;AAAA,QACJ,CAAC,CAAA;AAAA,MACL;AAAA,IACJ;AAGA,IAAA,OAAA,EAAQ;AAGR,IAAA,OAAO,MACP;AACI,MAAA,IAAI,cAAA,EACJ;AACI,QAAA,YAAA,CAAa,cAAc,CAAA;AAC3B,QAAA,cAAA,GAAiB,IAAA;AAAA,MACrB;AAEA,MAAA,IAAI,WAAA,EACJ;AACI,QAAA,WAAA,CAAY,KAAA,EAAM;AAClB,QAAA,WAAA,GAAc,IAAA;AAAA,MAClB;AAEA,MAAA,KAAA,GAAQ,QAAA;AAAA,IACZ,CAAA;AAAA,EACJ;AAEA,EAAA,SAAS,QAAA,GACT;AACI,IAAA,OAAO,KAAA;AAAA,EACX;AAEA,EAAA,SAAS,KAAA,GACT;AACI,IAAA,IAAI,cAAA,EACJ;AACI,MAAA,YAAA,CAAa,cAAc,CAAA;AAC3B,MAAA,cAAA,GAAiB,IAAA;AAAA,IACrB;AAEA,IAAA,IAAI,WAAA,EACJ;AACI,MAAA,WAAA,CAAY,KAAA,EAAM;AAClB,MAAA,WAAA,GAAc,IAAA;AAAA,IAClB;AAEA,IAAA,KAAA,GAAQ,QAAA;AAAA,EACZ;AAEA,EAAA,OAAO;AAAA,IACH,SAAA;AAAA,IACA,QAAA;AAAA,IACA;AAAA,GACJ;AACJ;AA2BO,SAAS,iBAAA,CACZ,MAAA,EACA,QAAA,EACA,OAAA,EAEJ;AACI,EAAA,MAAM,MAAA,GAAS,gBAAyB,OAAO,CAAA;AAE/C,EAAA,OAAO,OAAO,SAAA,CAAU;AAAA,IACpB,MAAA;AAAA,IACA;AAAA,GACH,CAAA;AACL","file":"client.js","sourcesContent":["/**\n * SSE Client\n *\n * Type-safe EventSource wrapper for event subscription\n *\n * @example\n * ```typescript\n * import { createSSEClient } from '@spfn/core/event/sse/client';\n * import type { EventRouter } from '@/server/events';\n *\n * // Uses defaults: NEXT_PUBLIC_SPFN_API_URL + /events/stream\n * const client = createSSEClient<EventRouter>();\n *\n * // Or with custom host/pathname\n * const client = createSSEClient<EventRouter>({\n *     host: 'https://api.example.com',\n *     pathname: '/sse',\n * });\n *\n * const unsubscribe = client.subscribe({\n *     events: ['userCreated', 'orderPlaced'],\n *     handlers: {\n *         userCreated: (payload) => console.log('User:', payload.userId),\n *         orderPlaced: (payload) => console.log('Order:', payload.orderId),\n *     },\n * });\n *\n * // Later: cleanup\n * unsubscribe();\n * ```\n */\n\nimport type { EventRouterDef, InferEventNames } from '../router';\nimport type {\n    SSEClientConfig,\n    SSESubscribeOptions,\n    SSEUnsubscribe,\n    SSEConnectionState,\n    SSEMessage,\n} from './types';\n\n/**\n * SSE Client instance\n */\nexport interface SSEClient<TRouter extends EventRouterDef<any>>\n{\n    /**\n     * Subscribe to events\n     */\n    subscribe(options: SSESubscribeOptions<TRouter>): SSEUnsubscribe;\n\n    /**\n     * Get current connection state\n     */\n    getState(): SSEConnectionState;\n\n    /**\n     * Close all connections\n     */\n    close(): void;\n}\n\n/**\n * Create type-safe SSE client\n *\n * @example\n * ```typescript\n * // Uses defaults (NEXT_PUBLIC_SPFN_API_URL + /events/stream)\n * const client = createSSEClient<EventRouter>();\n *\n * // Or with custom configuration\n * const client = createSSEClient<EventRouter>({\n *     host: 'https://api.example.com',\n *     pathname: '/sse',\n *     reconnect: true,\n *     reconnectDelay: 3000,\n * });\n *\n * // Subscribe to events\n * const unsubscribe = client.subscribe({\n *     events: ['userCreated', 'orderPlaced'],\n *     handlers: {\n *         userCreated: (payload) => {\n *             console.log('New user:', payload.userId);\n *         },\n *         orderPlaced: (payload) => {\n *             console.log('New order:', payload.orderId);\n *         },\n *     },\n *     onOpen: () => console.log('Connected'),\n *     onError: (err) => console.error('Error:', err),\n *     onReconnect: (attempt) => console.log('Reconnecting...', attempt),\n * });\n *\n * // Cleanup\n * unsubscribe();\n * ```\n */\n/**\n * Default SSE configuration\n */\nconst SSE_DEFAULTS = {\n    host: typeof process !== 'undefined'\n        ? (process.env.NEXT_PUBLIC_SPFN_API_URL || 'http://localhost:8790')\n        : 'http://localhost:8790',\n    pathname: '/events/stream',\n} as const;\n\nexport function createSSEClient<TRouter extends EventRouterDef<any>>(\n    config: SSEClientConfig = {}\n): SSEClient<TRouter>\n{\n    const {\n        url,\n        host = SSE_DEFAULTS.host,\n        pathname = SSE_DEFAULTS.pathname,\n        reconnect = true,\n        reconnectDelay = 3000,\n        maxReconnectAttempts = 0,\n        withCredentials = false,\n    } = config;\n\n    // Build base URL: url takes precedence, otherwise host + pathname\n    const baseUrl = url || `${host}${pathname}`;\n\n    let eventSource: EventSource | null = null;\n    let state: SSEConnectionState = 'closed';\n    let reconnectAttempts = 0;\n    let reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n\n    function subscribe(options: SSESubscribeOptions<TRouter>): SSEUnsubscribe\n    {\n        const { events, handlers, onOpen, onError, onReconnect } = options;\n\n        // Build URL with events query parameter\n        const eventNames = events as string[];\n        const streamUrl = `${baseUrl}?events=${eventNames.join(',')}`;\n\n        function connect()\n        {\n            state = 'connecting';\n\n            eventSource = new EventSource(streamUrl, {\n                withCredentials,\n            });\n\n            // Handle open\n            eventSource.onopen = () =>\n            {\n                state = 'open';\n                reconnectAttempts = 0;\n                onOpen?.();\n            };\n\n            // Handle errors\n            eventSource.onerror = (error) =>\n            {\n                state = 'error';\n                onError?.(error);\n\n                // Auto reconnect\n                if (reconnect && eventSource?.readyState === EventSource.CLOSED)\n                {\n                    if (maxReconnectAttempts === 0 || reconnectAttempts < maxReconnectAttempts)\n                    {\n                        reconnectAttempts++;\n                        onReconnect?.(reconnectAttempts);\n\n                        reconnectTimer = setTimeout(() =>\n                        {\n                            connect();\n                        }, reconnectDelay);\n                    }\n                }\n            };\n\n            // Handle connected event (server sends this on connection)\n            eventSource.addEventListener('connected', (e: MessageEvent) =>\n            {\n                try\n                {\n                    const data = JSON.parse(e.data);\n                    console.debug('[SSE] Connected:', data);\n                }\n                catch\n                {\n                    // Ignore parse errors\n                }\n            });\n\n            // Handle ping (keep-alive)\n            eventSource.addEventListener('ping', () =>\n            {\n                // Ping received, connection is alive\n            });\n\n            // Register handlers for each event\n            for (const eventName of eventNames)\n            {\n                // Type assertion needed here - runtime type safety is ensured by EventRouter\n                const handler = (handlers as Record<string, ((payload: unknown) => void) | undefined>)[eventName];\n\n                if (!handler)\n                {\n                    continue;\n                }\n\n                eventSource.addEventListener(eventName, (e: MessageEvent) =>\n                {\n                    try\n                    {\n                        const message: SSEMessage = JSON.parse(e.data);\n                        handler(message.data);\n                    }\n                    catch (err)\n                    {\n                        console.error(`[SSE] Failed to parse event \"${eventName}\":`, err);\n                    }\n                });\n            }\n        }\n\n        // Start connection\n        connect();\n\n        // Return unsubscribe function\n        return () =>\n        {\n            if (reconnectTimer)\n            {\n                clearTimeout(reconnectTimer);\n                reconnectTimer = null;\n            }\n\n            if (eventSource)\n            {\n                eventSource.close();\n                eventSource = null;\n            }\n\n            state = 'closed';\n        };\n    }\n\n    function getState(): SSEConnectionState\n    {\n        return state;\n    }\n\n    function close()\n    {\n        if (reconnectTimer)\n        {\n            clearTimeout(reconnectTimer);\n            reconnectTimer = null;\n        }\n\n        if (eventSource)\n        {\n            eventSource.close();\n            eventSource = null;\n        }\n\n        state = 'closed';\n    }\n\n    return {\n        subscribe,\n        getState,\n        close,\n    };\n}\n\n/**\n * Simple subscribe function for one-off subscriptions\n *\n * @example\n * ```typescript\n * import { subscribeToEvents } from '@spfn/core/event/sse/client';\n * import type { EventRouter } from '@/server/events';\n *\n * // Using defaults\n * const unsubscribe = subscribeToEvents<EventRouter>(\n *     ['userCreated', 'orderPlaced'],\n *     {\n *         userCreated: (payload) => console.log('User:', payload),\n *         orderPlaced: (payload) => console.log('Order:', payload),\n *     }\n * );\n *\n * // With custom host\n * const unsubscribe = subscribeToEvents<EventRouter>(\n *     ['userCreated'],\n *     { userCreated: (payload) => console.log('User:', payload) },\n *     { host: 'https://api.example.com' }\n * );\n * ```\n */\nexport function subscribeToEvents<TRouter extends EventRouterDef<any>>(\n    events: InferEventNames<TRouter>[],\n    handlers: SSESubscribeOptions<TRouter>['handlers'],\n    options?: SSEClientConfig\n): SSEUnsubscribe\n{\n    const client = createSSEClient<TRouter>(options);\n\n    return client.subscribe({\n        events,\n        handlers,\n    });\n}\n"]}

package/dist/event/sse/index.d.ts

@@ -0,0 +1,40 @@
+import { Context } from 'hono';
+import { E as EventRouterDef } from '../../router-Di7ENoah.js';
+import { S as SSEHandlerConfig } from '../../types-B-e_f2dQ.js';
+export { b as SSEClientConfig, f as SSEConnectionState, c as SSEEventHandler, d as SSEEventHandlers, a as SSEMessage, e as SSESubscribeOptions, g as SSEUnsubscribe } from '../../types-B-e_f2dQ.js';
+import '@sinclair/typebox';
+
+/**
+ * SSE Handler for Hono
+ *
+ * Creates SSE stream endpoint for event subscription
+ *
+ * @example
+ * ```typescript
+ * import { Hono } from 'hono';
+ * import { createSSEHandler } from '@spfn/core/event/sse';
+ * import { eventRouter } from './events';
+ *
+ * const app = new Hono();
+ *
+ * // GET /events/stream?events=userCreated,orderPlaced
+ * app.get('/events/stream', createSSEHandler(eventRouter));
+ * ```
+ */
+
+/**
+ * Create SSE handler for Hono
+ *
+ * Query parameters:
+ * - events: Comma-separated list of event names to subscribe
+ *
+ * @example
+ * ```typescript
+ * app.get('/events/stream', createSSEHandler(eventRouter, {
+ *     pingInterval: 30000,
+ * }));
+ * ```
+ */
+declare function createSSEHandler<TRouter extends EventRouterDef<any>>(router: TRouter, config?: SSEHandlerConfig): (c: Context) => Promise<Response>;
+
+export { SSEHandlerConfig, createSSEHandler };

package/dist/event/sse/index.js

@@ -0,0 +1,92 @@
+import { streamSSE } from 'hono/streaming';
+import { logger } from '@spfn/core/logger';
+
+// src/event/sse/handler.ts
+var sseLogger = logger.child("@spfn/core:sse");
+function createSSEHandler(router, config = {}) {
+  const {
+    pingInterval = 3e4
+    // headers: customHeaders = {},  // Reserved for future use
+  } = config;
+  return async (c) => {
+    const eventsParam = c.req.query("events");
+    if (!eventsParam) {
+      return c.json({ error: "Missing events parameter" }, 400);
+    }
+    const requestedEvents = eventsParam.split(",").map((e) => e.trim());
+    const validEventNames = router.eventNames;
+    const invalidEvents = requestedEvents.filter((e) => !validEventNames.includes(e));
+    if (invalidEvents.length > 0) {
+      return c.json({
+        error: "Invalid event names",
+        invalidEvents,
+        validEvents: validEventNames
+      }, 400);
+    }
+    sseLogger.debug("SSE connection requested", {
+      events: requestedEvents,
+      clientIp: c.req.header("x-forwarded-for") || c.req.header("x-real-ip")
+    });
+    return streamSSE(c, async (stream) => {
+      const unsubscribes = [];
+      let messageId = 0;
+      for (const eventName of requestedEvents) {
+        const eventDef = router.events[eventName];
+        if (!eventDef) {
+          continue;
+        }
+        const unsubscribe = eventDef.subscribe((payload) => {
+          messageId++;
+          const message = {
+            event: eventName,
+            data: payload
+          };
+          sseLogger.debug("SSE sending event", {
+            event: eventName,
+            messageId
+          });
+          void stream.writeSSE({
+            id: String(messageId),
+            event: eventName,
+            data: JSON.stringify(message)
+          });
+        });
+        unsubscribes.push(unsubscribe);
+      }
+      sseLogger.info("SSE connection established", {
+        events: requestedEvents,
+        subscriptionCount: unsubscribes.length
+      });
+      await stream.writeSSE({
+        event: "connected",
+        data: JSON.stringify({
+          subscribedEvents: requestedEvents,
+          timestamp: Date.now()
+        })
+      });
+      const pingTimer = setInterval(() => {
+        void stream.writeSSE({
+          event: "ping",
+          data: JSON.stringify({ timestamp: Date.now() })
+        });
+      }, pingInterval);
+      const abortSignal = c.req.raw.signal;
+      while (!abortSignal.aborted) {
+        await stream.sleep(pingInterval);
+      }
+      clearInterval(pingTimer);
+      unsubscribes.forEach((fn) => fn());
+      sseLogger.info("SSE connection closed", {
+        events: requestedEvents
+      });
+    }, async (err) => {
+      sseLogger.error("SSE stream error", {
+        error: err.message
+      });
+    });
+  };
+}
+
+export { createSSEHandler };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/event/sse/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/event/sse/handler.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * SSE Handler for Hono\n *\n * Creates SSE stream endpoint for event subscription\n *\n * @example\n * ```typescript\n * import { Hono } from 'hono';\n * import { createSSEHandler } from '@spfn/core/event/sse';\n * import { eventRouter } from './events';\n *\n * const app = new Hono();\n *\n * // GET /events/stream?events=userCreated,orderPlaced\n * app.get('/events/stream', createSSEHandler(eventRouter));\n * ```\n */\n\nimport type { Context } from 'hono';\nimport { streamSSE } from 'hono/streaming';\nimport { logger } from '@spfn/core/logger';\nimport type { EventRouterDef, InferEventNames } from '../router';\nimport type { SSEHandlerConfig } from './types';\n\nconst sseLogger = logger.child('@spfn/core:sse');\n\n/**\n * Create SSE handler for Hono\n *\n * Query parameters:\n * - events: Comma-separated list of event names to subscribe\n *\n * @example\n * ```typescript\n * app.get('/events/stream', createSSEHandler(eventRouter, {\n *     pingInterval: 30000,\n * }));\n * ```\n */\nexport function createSSEHandler<TRouter extends EventRouterDef<any>>(\n    router: TRouter,\n    config: SSEHandlerConfig = {}\n)\n{\n    const {\n        pingInterval = 30000,\n        // headers: customHeaders = {},  // Reserved for future use\n    } = config;\n\n    return async (c: Context) =>\n    {\n        // Parse events from query parameter\n        const eventsParam = c.req.query('events');\n\n        if (!eventsParam)\n        {\n            return c.json({ error: 'Missing events parameter' }, 400);\n        }\n\n        const requestedEvents = eventsParam.split(',').map(e => e.trim());\n\n        // Validate event names\n        const validEventNames = router.eventNames as string[];\n        const invalidEvents = requestedEvents.filter(e => !validEventNames.includes(e));\n\n        if (invalidEvents.length > 0)\n        {\n            return c.json({\n                error: 'Invalid event names',\n                invalidEvents,\n                validEvents: validEventNames,\n            }, 400);\n        }\n\n        sseLogger.debug('SSE connection requested', {\n            events: requestedEvents,\n            clientIp: c.req.header('x-forwarded-for') || c.req.header('x-real-ip'),\n        });\n\n        // Start SSE stream\n        return streamSSE(c, async (stream) =>\n        {\n            const unsubscribes: (() => void)[] = [];\n            let messageId = 0;\n\n            // Subscribe to each requested event\n            for (const eventName of requestedEvents as InferEventNames<TRouter>[])\n            {\n                const eventDef = router.events[eventName];\n\n                if (!eventDef)\n                {\n                    continue;\n                }\n\n                const unsubscribe = eventDef.subscribe((payload: unknown) =>\n                {\n                    messageId++;\n\n                    const message = {\n                        event: eventName,\n                        data: payload,\n                    };\n\n                    sseLogger.debug('SSE sending event', {\n                        event: eventName,\n                        messageId,\n                    });\n\n                    // Fire-and-forget in sync callback\n                    void stream.writeSSE({\n                        id: String(messageId),\n                        event: eventName as string,\n                        data: JSON.stringify(message),\n                    });\n                });\n\n                unsubscribes.push(unsubscribe);\n            }\n\n            sseLogger.info('SSE connection established', {\n                events: requestedEvents,\n                subscriptionCount: unsubscribes.length,\n            });\n\n            // Send initial connection message\n            await stream.writeSSE({\n                event: 'connected',\n                data: JSON.stringify({\n                    subscribedEvents: requestedEvents,\n                    timestamp: Date.now(),\n                }),\n            });\n\n            // Keep-alive ping\n            const pingTimer = setInterval(() =>\n            {\n                // Fire-and-forget in sync callback\n                void stream.writeSSE({\n                    event: 'ping',\n                    data: JSON.stringify({ timestamp: Date.now() }),\n                });\n            }, pingInterval);\n\n            // Wait for client disconnect using abort signal\n            const abortSignal = c.req.raw.signal;\n\n            while (!abortSignal.aborted)\n            {\n                await stream.sleep(pingInterval);\n            }\n\n            // Cleanup\n            clearInterval(pingTimer);\n            unsubscribes.forEach(fn => fn());\n\n            sseLogger.info('SSE connection closed', {\n                events: requestedEvents,\n            });\n        }, async (err: Error) =>\n        {\n            sseLogger.error('SSE stream error', {\n                error: err.message,\n            });\n        });\n    };\n}\n\n"]}

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,19 +5,22 @@ 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;
-  bossInstance = new PgBoss({
-    connectionString: config.connectionString,
-    schema: config.schema ?? "spfn_queue",
-    maintenanceIntervalSeconds: config.maintenanceIntervalSeconds ?? 120,
-    monitorIntervalSeconds: config.monitorIntervalSeconds
-  });
+  bossConfig = options;
+  const pgBossOptions = {
+    connectionString: options.connectionString,
+    schema: options.schema ?? "spfn_queue",
+    maintenanceIntervalSeconds: options.maintenanceIntervalSeconds ?? 120
+  };
+  if (options.monitorIntervalSeconds !== void 0 && options.monitorIntervalSeconds >= 1) {
+    pgBossOptions.monitorIntervalSeconds = options.monitorIntervalSeconds;
+  }
+  bossInstance = new PgBoss(pgBossOptions);
   bossInstance.on("error", (error) => {
     jobLogger.error("pg-boss error:", error);
   });
@@ -269,7 +272,11 @@ async function registerJobs(router) {
   }
   jobLogger2.info("All jobs registered successfully");
 }
+async function ensureQueue(boss, queueName) {
+  await boss.createQueue(queueName);
+}
 async function registerWorker(boss, job2, queueName) {
+  await ensureQueue(boss, queueName);
   await boss.work(
     queueName,
     { batchSize: 1 },
@@ -316,6 +323,7 @@ async function registerCronSchedule(boss, job2) {
     return;
   }
   jobLogger2.debug(`[Job:${job2.name}] Scheduling cron: ${job2.cronExpression}`);
+  await ensureQueue(boss, job2.name);
   await boss.schedule(
     job2.name,
     job2.cronExpression,
@@ -329,6 +337,7 @@ async function queueRunOnceJob(boss, job2) {
     return;
   }
   jobLogger2.debug(`[Job:${job2.name}] Queuing runOnce job`);
+  await ensureQueue(boss, job2.name);
   await boss.send(
     job2.name,
     {},
@@ -356,6 +365,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":"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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 * 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\n    const pgBossOptions: PgBoss.ConstructorOptions = {\n        connectionString: options.connectionString,\n        schema: options.schema ?? 'spfn_queue',\n        maintenanceIntervalSeconds: options.maintenanceIntervalSeconds ?? 120,\n    };\n\n    // Only set monitorIntervalSeconds if explicitly provided (must be >= 1)\n    if (options.monitorIntervalSeconds !== undefined && options.monitorIntervalSeconds >= 1)\n    {\n        pgBossOptions.monitorIntervalSeconds = options.monitorIntervalSeconds;\n    }\n\n    bossInstance = new PgBoss(pgBossOptions);\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 * Create queue if not exists (required for pg-boss v11+)\n */\nasync function ensureQueue(boss: PgBoss, queueName: string): Promise<void>\n{\n    await boss.createQueue(queueName);\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    // Ensure queue exists before registering worker\n    await ensureQueue(boss, queueName);\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    // Ensure queue exists for cron jobs (uses job.name as queue)\n    await ensureQueue(boss, job.name);\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    // Ensure queue exists for runOnce jobs (uses job.name as queue)\n    await ensureQueue(boss, job.name);\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"]}