@spfn/core 0.2.0-beta.45 → 0.2.0-beta.47

package/dist/event/index.d.ts

@@ -1,6 +1,10 @@
 import { TSchema, Static } from '@sinclair/typebox';
-import { a as EventDef } from '../router-Di7ENoah.js';
-export { e as EventHandler, E as EventRouterDef, I as InferEventNames, f as InferEventPayload, c as InferEventPayloads, b as InferRouterEventPayload, J as JobQueueSender, P as PubSubCache, d as defineEventRouter } from '../router-Di7ENoah.js';
+import { a as EventDef } from '../token-manager-DSwIDD-_.js';
+export { e as EventHandler, E as EventRouterDef, I as InferEventNames, f as InferEventPayload, c as InferEventPayloads, b as InferRouterEventPayload, J as JobQueueSender, P as PubSubCache, d as defineEventRouter } from '../token-manager-DSwIDD-_.js';
+export { defineWSRouter } from './ws/index.js';
+import '../types-FuJb3yrP.js';
+import 'hono';
+import 'node:http';
 
 /**
  * Event System

package/dist/event/index.js

@@ -130,7 +130,18 @@ function defineEventRouter(events) {
     _types: {}
   };
 }
+logger.child("@spfn/core:ws");
 
-export { defineEvent, defineEventRouter, eventRouteMap };
+// src/event/ws/index.ts
+function defineWSRouter(def) {
+  return {
+    events: def.events,
+    eventNames: Object.keys(def.events),
+    messages: def.messages ?? {},
+    _types: {}
+  };
+}
+
+export { defineEvent, defineEventRouter, defineWSRouter, eventRouteMap };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/event/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/event/event.ts","../../src/event/sse/route-map.ts","../../src/event/router.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Event System\n *\n * Decoupled pub/sub event system with optional cache integration for multi-instance support\n *\n * @example\n * ```typescript\n * // Define event\n * const userCreated = defineEvent('user.created', Type.Object({\n *     userId: Type.String(),\n * }));\n *\n * // Subscribe (in-memory)\n * userCreated.subscribe((payload) => {\n *     console.log('User created:', payload.userId);\n * });\n *\n * // Emit\n * await userCreated.emit({ userId: '123' });\n *\n * // With cache for multi-instance\n * const event = defineEvent('user.created', schema);\n * await event.useCache(cache);  // Must await before emitting\n * await event.emit({ userId: '123' });  // Broadcast to all instances\n * ```\n */\n\nimport type { TSchema, Static } from '@sinclair/typebox';\nimport { logger } from '@spfn/core/logger';\nimport type { EventDef, EventHandler, JobQueueSender, PubSubCache } from './types';\n\nconst eventLogger = logger.child('@spfn/core:event');\n\n/**\n * Log handler error with consistent format\n */\nfunction logHandlerError(eventName: string, error: unknown): void\n{\n    eventLogger.error(`Event handler error: ${eventName}`, {\n        error: error instanceof Error ? error.message : String(error),\n    });\n}\n\n/**\n * Log job queue error with consistent format\n */\nfunction logJobQueueError(queueName: string, error: unknown): void\n{\n    eventLogger.error(`Failed to send event to job queue: ${queueName}`, {\n        error: error instanceof Error ? error.message : String(error),\n    });\n}\n\n/**\n * Create handler subscription manager\n */\nfunction createHandlerManager<TPayload>(name: string)\n{\n    const handlers: Set<EventHandler<TPayload>> = new Set();\n\n    return {\n        add: (handler: EventHandler<TPayload>): (() => void) =>\n        {\n            handlers.add(handler);\n            eventLogger.debug(`Subscribed to event: ${name}`, { handlerCount: handlers.size });\n\n            return () =>\n            {\n                handlers.delete(handler);\n                eventLogger.debug(`Unsubscribed from event: ${name}`, { handlerCount: handlers.size });\n            };\n        },\n\n        clear: (): void =>\n        {\n            handlers.clear();\n            eventLogger.debug(`Unsubscribed all from event: ${name}`);\n        },\n\n        trigger: async (payload: TPayload): Promise<void> =>\n        {\n            const results = await Promise.allSettled(\n                [...handlers].map((handler) => handler(payload))\n            );\n\n            for (const result of results)\n            {\n                if (result.status === 'rejected')\n                {\n                    logHandlerError(name, result.reason);\n                }\n            }\n        },\n    };\n}\n\n/**\n * Create job queue manager\n */\nfunction createJobQueueManager(name: string)\n{\n    const jobQueues: Map<string, JobQueueSender> = new Map();\n\n    return {\n        register: (queueName: string, sender: JobQueueSender): void =>\n        {\n            jobQueues.set(queueName, sender);\n            eventLogger.debug(`Registered job queue for event: ${name}`, { queueName });\n        },\n\n        send: async (payload: unknown): Promise<void> =>\n        {\n            if (jobQueues.size === 0)\n            {\n                return;\n            }\n\n            const entries = [...jobQueues.entries()];\n            const results = await Promise.allSettled(\n                entries.map(([queueName, sender]) => sender(queueName, payload))\n            );\n\n            for (const [i, result] of results.entries())\n            {\n                if (result.status === 'rejected')\n                {\n                    logJobQueueError(entries[i][0], result.reason);\n                }\n            }\n        },\n\n        get size(): number\n        {\n            return jobQueues.size;\n        },\n    };\n}\n\n/**\n * Internal: Create event implementation\n */\nfunction createEventImpl<TPayload>(\n    name: string,\n    schema?: TSchema\n): EventDef<TPayload>\n{\n    const handlerManager = createHandlerManager<TPayload>(name);\n    const jobQueueManager = createJobQueueManager(name);\n    let cache: PubSubCache | undefined;\n    let cacheSubscribed = false;\n\n    const emit = async (payload?: TPayload): Promise<void> =>\n    {\n        eventLogger.debug(`Emitting event: ${name}`, {\n            payload,\n            hasCache: !!cache,\n            jobQueueCount: jobQueueManager.size,\n        });\n\n        if (cache)\n        {\n            await cache.publish(name, payload);\n        }\n        else\n        {\n            await handlerManager.trigger(payload as TPayload);\n        }\n\n        await jobQueueManager.send(payload);\n        eventLogger.debug(`Event emitted: ${name}`);\n    };\n\n    const useCache = async (newCache: PubSubCache): Promise<EventDef<TPayload>> =>\n    {\n        if (cacheSubscribed)\n        {\n            eventLogger.warn(`Cache already configured for event: ${name}`);\n            return self;\n        }\n\n        cache = newCache;\n        cacheSubscribed = true;\n\n        await newCache.subscribe(name, async (message: unknown) =>\n        {\n            eventLogger.debug(`Received event from cache: ${name}`);\n            await handlerManager.trigger(message as TPayload);\n        });\n\n        eventLogger.debug(`Cache subscription ready for event: ${name}`);\n        return self;\n    };\n\n    const self: EventDef<TPayload> = {\n        name,\n        schema,\n        subscribe: handlerManager.add,\n        unsubscribeAll: handlerManager.clear,\n        emit: emit as EventDef<TPayload>['emit'],\n        useCache,\n        _registerJobQueue: jobQueueManager.register,\n        _payload: undefined as unknown as TPayload,\n    };\n\n    return self;\n}\n\n/**\n * Define an event without payload\n */\nexport function defineEvent(name: string): EventDef<void>;\n\n/**\n * Define an event with typed payload\n */\nexport function defineEvent<T extends TSchema>(\n    name: string,\n    schema: T\n): EventDef<Static<T>>;\n\n/**\n * Define an event for decoupled pub/sub\n *\n * @example\n * ```typescript\n * // Define event with payload\n * export const userCreated = defineEvent('user.created', Type.Object({\n *     userId: Type.String(),\n * }));\n *\n * // Subscribe to event (in-memory)\n * const unsubscribe = userCreated.subscribe((payload) => {\n *     console.log('User created:', payload.userId);\n * });\n *\n * // Emit event\n * await userCreated.emit({ userId: '123' });\n *\n * // Unsubscribe when done\n * unsubscribe();\n *\n * // Multi-instance with cache\n * await userCreated.useCache(cache);\n * await userCreated.emit({ userId: '123' });  // Broadcast to all instances\n * ```\n */\nexport function defineEvent<T extends TSchema>(\n    name: string,\n    schema?: T\n): EventDef<Static<T>> | EventDef\n{\n    if (schema)\n    {\n        return createEventImpl<Static<T>>(name, schema);\n    }\n\n    return createEventImpl<void>(name);\n}\n","/**\n * SSE Event Route Map\n *\n * Static route map for SSE token endpoint.\n * Merge into RPC proxy routeMap so `eventsToken` resolves to `POST /events/token`.\n *\n * @example\n * ```typescript\n * // app/api/rpc/[routeName]/route.ts\n * import { createRpcProxy } from '@spfn/core/nextjs/server';\n * import { eventRouteMap } from '@spfn/core/event';\n * import { authRouteMap } from '@spfn/auth';\n * import { routeMap } from '@/generated/route-map';\n *\n * export const { GET, POST } = createRpcProxy({\n *     routeMap: { ...routeMap, ...authRouteMap, ...eventRouteMap },\n * });\n * ```\n */\nexport const eventRouteMap = {\n    eventsToken: { method: 'POST' as const, path: '/events/token' },\n};\n","/**\n * Event Router\n *\n * Type-safe event router for SSE subscription\n *\n * @example\n * ```typescript\n * import { defineEvent, defineEventRouter } from '@spfn/core/event';\n * import { Type } from '@sinclair/typebox';\n *\n * const userCreated = defineEvent('user.created', Type.Object({\n *     userId: Type.String(),\n * }));\n *\n * const orderPlaced = defineEvent('order.placed', Type.Object({\n *     orderId: Type.String(),\n *     amount: Type.Number(),\n * }));\n *\n * export const eventRouter = defineEventRouter({\n *     userCreated,\n *     orderPlaced,\n * });\n *\n * export type EventRouter = typeof eventRouter;\n * ```\n */\n\nimport type { EventDef } from './types';\n\n/**\n * Event Router Definition\n */\nexport interface EventRouterDef<TEvents extends Record<string, EventDef<any>>>\n{\n    /**\n     * Event definitions\n     */\n    readonly events: TEvents;\n\n    /**\n     * Event names as array\n     */\n    readonly eventNames: (keyof TEvents)[];\n\n    /**\n     * Type inference helper - payload types by event name\n     */\n    readonly _types: {\n        [K in keyof TEvents]: TEvents[K]['_payload'];\n    };\n}\n\n/**\n * Infer event names from EventRouter\n */\nexport type InferEventNames<T> = T extends EventRouterDef<infer E>\n    ? keyof E & string\n    : never;\n\n/**\n * Infer payload type for specific event\n */\nexport type InferEventPayload<\n    T extends EventRouterDef<any>,\n    K extends InferEventNames<T>\n> = T['_types'][K];\n\n/**\n * Infer all event payloads map\n */\nexport type InferEventPayloads<T extends EventRouterDef<any>> = T['_types'];\n\n/**\n * Define an event router for SSE subscription\n *\n * @example\n * ```typescript\n * export const eventRouter = defineEventRouter({\n *     userCreated,\n *     orderPlaced,\n * });\n *\n * // Type inference\n * type Names = InferEventNames<typeof eventRouter>;\n * // 'userCreated' | 'orderPlaced'\n *\n * type Payload = InferEventPayload<typeof eventRouter, 'userCreated'>;\n * // { userId: string }\n * ```\n */\nexport function defineEventRouter<\n    TEvents extends Record<string, EventDef<any>>\n>(events: TEvents): EventRouterDef<TEvents>\n{\n    return {\n        events,\n        eventNames: Object.keys(events) as (keyof TEvents)[],\n        _types: {} as EventRouterDef<TEvents>['_types'],\n    };\n}"]}
+{"version":3,"sources":["../../src/event/event.ts","../../src/event/sse/route-map.ts","../../src/event/router.ts","../../src/event/ws/handler.ts","../../src/event/ws/index.ts"],"names":["logger"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Event System\n *\n * Decoupled pub/sub event system with optional cache integration for multi-instance support\n *\n * @example\n * ```typescript\n * // Define event\n * const userCreated = defineEvent('user.created', Type.Object({\n *     userId: Type.String(),\n * }));\n *\n * // Subscribe (in-memory)\n * userCreated.subscribe((payload) => {\n *     console.log('User created:', payload.userId);\n * });\n *\n * // Emit\n * await userCreated.emit({ userId: '123' });\n *\n * // With cache for multi-instance\n * const event = defineEvent('user.created', schema);\n * await event.useCache(cache);  // Must await before emitting\n * await event.emit({ userId: '123' });  // Broadcast to all instances\n * ```\n */\n\nimport type { TSchema, Static } from '@sinclair/typebox';\nimport { logger } from '@spfn/core/logger';\nimport type { EventDef, EventHandler, JobQueueSender, PubSubCache } from './types';\n\nconst eventLogger = logger.child('@spfn/core:event');\n\n/**\n * Log handler error with consistent format\n */\nfunction logHandlerError(eventName: string, error: unknown): void\n{\n    eventLogger.error(`Event handler error: ${eventName}`, {\n        error: error instanceof Error ? error.message : String(error),\n    });\n}\n\n/**\n * Log job queue error with consistent format\n */\nfunction logJobQueueError(queueName: string, error: unknown): void\n{\n    eventLogger.error(`Failed to send event to job queue: ${queueName}`, {\n        error: error instanceof Error ? error.message : String(error),\n    });\n}\n\n/**\n * Create handler subscription manager\n */\nfunction createHandlerManager<TPayload>(name: string)\n{\n    const handlers: Set<EventHandler<TPayload>> = new Set();\n\n    return {\n        add: (handler: EventHandler<TPayload>): (() => void) =>\n        {\n            handlers.add(handler);\n            eventLogger.debug(`Subscribed to event: ${name}`, { handlerCount: handlers.size });\n\n            return () =>\n            {\n                handlers.delete(handler);\n                eventLogger.debug(`Unsubscribed from event: ${name}`, { handlerCount: handlers.size });\n            };\n        },\n\n        clear: (): void =>\n        {\n            handlers.clear();\n            eventLogger.debug(`Unsubscribed all from event: ${name}`);\n        },\n\n        trigger: async (payload: TPayload): Promise<void> =>\n        {\n            const results = await Promise.allSettled(\n                [...handlers].map((handler) => handler(payload))\n            );\n\n            for (const result of results)\n            {\n                if (result.status === 'rejected')\n                {\n                    logHandlerError(name, result.reason);\n                }\n            }\n        },\n    };\n}\n\n/**\n * Create job queue manager\n */\nfunction createJobQueueManager(name: string)\n{\n    const jobQueues: Map<string, JobQueueSender> = new Map();\n\n    return {\n        register: (queueName: string, sender: JobQueueSender): void =>\n        {\n            jobQueues.set(queueName, sender);\n            eventLogger.debug(`Registered job queue for event: ${name}`, { queueName });\n        },\n\n        send: async (payload: unknown): Promise<void> =>\n        {\n            if (jobQueues.size === 0)\n            {\n                return;\n            }\n\n            const entries = [...jobQueues.entries()];\n            const results = await Promise.allSettled(\n                entries.map(([queueName, sender]) => sender(queueName, payload))\n            );\n\n            for (const [i, result] of results.entries())\n            {\n                if (result.status === 'rejected')\n                {\n                    logJobQueueError(entries[i][0], result.reason);\n                }\n            }\n        },\n\n        get size(): number\n        {\n            return jobQueues.size;\n        },\n    };\n}\n\n/**\n * Internal: Create event implementation\n */\nfunction createEventImpl<TPayload>(\n    name: string,\n    schema?: TSchema\n): EventDef<TPayload>\n{\n    const handlerManager = createHandlerManager<TPayload>(name);\n    const jobQueueManager = createJobQueueManager(name);\n    let cache: PubSubCache | undefined;\n    let cacheSubscribed = false;\n\n    const emit = async (payload?: TPayload): Promise<void> =>\n    {\n        eventLogger.debug(`Emitting event: ${name}`, {\n            payload,\n            hasCache: !!cache,\n            jobQueueCount: jobQueueManager.size,\n        });\n\n        if (cache)\n        {\n            await cache.publish(name, payload);\n        }\n        else\n        {\n            await handlerManager.trigger(payload as TPayload);\n        }\n\n        await jobQueueManager.send(payload);\n        eventLogger.debug(`Event emitted: ${name}`);\n    };\n\n    const useCache = async (newCache: PubSubCache): Promise<EventDef<TPayload>> =>\n    {\n        if (cacheSubscribed)\n        {\n            eventLogger.warn(`Cache already configured for event: ${name}`);\n            return self;\n        }\n\n        cache = newCache;\n        cacheSubscribed = true;\n\n        await newCache.subscribe(name, async (message: unknown) =>\n        {\n            eventLogger.debug(`Received event from cache: ${name}`);\n            await handlerManager.trigger(message as TPayload);\n        });\n\n        eventLogger.debug(`Cache subscription ready for event: ${name}`);\n        return self;\n    };\n\n    const self: EventDef<TPayload> = {\n        name,\n        schema,\n        subscribe: handlerManager.add,\n        unsubscribeAll: handlerManager.clear,\n        emit: emit as EventDef<TPayload>['emit'],\n        useCache,\n        _registerJobQueue: jobQueueManager.register,\n        _payload: undefined as unknown as TPayload,\n    };\n\n    return self;\n}\n\n/**\n * Define an event without payload\n */\nexport function defineEvent(name: string): EventDef<void>;\n\n/**\n * Define an event with typed payload\n */\nexport function defineEvent<T extends TSchema>(\n    name: string,\n    schema: T\n): EventDef<Static<T>>;\n\n/**\n * Define an event for decoupled pub/sub\n *\n * @example\n * ```typescript\n * // Define event with payload\n * export const userCreated = defineEvent('user.created', Type.Object({\n *     userId: Type.String(),\n * }));\n *\n * // Subscribe to event (in-memory)\n * const unsubscribe = userCreated.subscribe((payload) => {\n *     console.log('User created:', payload.userId);\n * });\n *\n * // Emit event\n * await userCreated.emit({ userId: '123' });\n *\n * // Unsubscribe when done\n * unsubscribe();\n *\n * // Multi-instance with cache\n * await userCreated.useCache(cache);\n * await userCreated.emit({ userId: '123' });  // Broadcast to all instances\n * ```\n */\nexport function defineEvent<T extends TSchema>(\n    name: string,\n    schema?: T\n): EventDef<Static<T>> | EventDef\n{\n    if (schema)\n    {\n        return createEventImpl<Static<T>>(name, schema);\n    }\n\n    return createEventImpl<void>(name);\n}\n","/**\n * SSE Event Route Map\n *\n * Static route map for SSE token endpoint.\n * Merge into RPC proxy routeMap so `eventsToken` resolves to `POST /events/token`.\n *\n * @example\n * ```typescript\n * // app/api/rpc/[routeName]/route.ts\n * import { createRpcProxy } from '@spfn/core/nextjs/server';\n * import { eventRouteMap } from '@spfn/core/event';\n * import { authRouteMap } from '@spfn/auth';\n * import { routeMap } from '@/generated/route-map';\n *\n * export const { GET, POST } = createRpcProxy({\n *     routeMap: { ...routeMap, ...authRouteMap, ...eventRouteMap },\n * });\n * ```\n */\nexport const eventRouteMap = {\n    eventsToken: { method: 'POST' as const, path: '/events/token' },\n};\n","/**\n * Event Router\n *\n * Type-safe event router for SSE subscription\n *\n * @example\n * ```typescript\n * import { defineEvent, defineEventRouter } from '@spfn/core/event';\n * import { Type } from '@sinclair/typebox';\n *\n * const userCreated = defineEvent('user.created', Type.Object({\n *     userId: Type.String(),\n * }));\n *\n * const orderPlaced = defineEvent('order.placed', Type.Object({\n *     orderId: Type.String(),\n *     amount: Type.Number(),\n * }));\n *\n * export const eventRouter = defineEventRouter({\n *     userCreated,\n *     orderPlaced,\n * });\n *\n * export type EventRouter = typeof eventRouter;\n * ```\n */\n\nimport type { EventDef } from './types';\n\n/**\n * Event Router Definition\n */\nexport interface EventRouterDef<TEvents extends Record<string, EventDef<any>>>\n{\n    /**\n     * Event definitions\n     */\n    readonly events: TEvents;\n\n    /**\n     * Event names as array\n     */\n    readonly eventNames: (keyof TEvents)[];\n\n    /**\n     * Type inference helper - payload types by event name\n     */\n    readonly _types: {\n        [K in keyof TEvents]: TEvents[K]['_payload'];\n    };\n}\n\n/**\n * Infer event names from EventRouter\n */\nexport type InferEventNames<T> = T extends EventRouterDef<infer E>\n    ? keyof E & string\n    : never;\n\n/**\n * Infer payload type for specific event\n */\nexport type InferEventPayload<\n    T extends EventRouterDef<any>,\n    K extends InferEventNames<T>\n> = T['_types'][K];\n\n/**\n * Infer all event payloads map\n */\nexport type InferEventPayloads<T extends EventRouterDef<any>> = T['_types'];\n\n/**\n * Define an event router for SSE subscription\n *\n * @example\n * ```typescript\n * export const eventRouter = defineEventRouter({\n *     userCreated,\n *     orderPlaced,\n * });\n *\n * // Type inference\n * type Names = InferEventNames<typeof eventRouter>;\n * // 'userCreated' | 'orderPlaced'\n *\n * type Payload = InferEventPayload<typeof eventRouter, 'userCreated'>;\n * // { userId: string }\n * ```\n */\nexport function defineEventRouter<\n    TEvents extends Record<string, EventDef<any>>\n>(events: TEvents): EventRouterDef<TEvents>\n{\n    return {\n        events,\n        eventNames: Object.keys(events) as (keyof TEvents)[],\n        _types: {} as EventRouterDef<TEvents>['_types'],\n    };\n}","/**\n * WebSocket Handler\n *\n * Attaches a WebSocket server to an existing Node.js http.Server.\n * Handles authentication, event subscription, and client message routing.\n */\n\nimport type { Server } from 'node:http';\nimport type { EventDef } from '../types';\nimport type {\n    WSRouterDef,\n    WSHandlerConfig,\n    WSHandlerAuthConfig,\n    WSMessageHandlers,\n    WSRawConnection,\n} from './types';\nimport type { SSETokenManager } from '../sse/token-manager';\nimport { logger } from '@spfn/core/logger';\n\nconst wsLogger = logger.child('@spfn/core:ws');\n\n// ============================================================================\n// Public API\n// ============================================================================\n\n/**\n * Attach a WebSocket server to a Node.js http.Server\n *\n * @returns cleanup function that closes the WebSocket server\n */\nexport async function attachWSHandler<\n    TEvents extends Record<string, EventDef<any>>,\n    TMessages extends WSMessageHandlers\n>(\n    server: Server,\n    router: WSRouterDef<TEvents, TMessages>,\n    config: WSHandlerConfig & { path?: string } = {},\n    tokenManager?: SSETokenManager\n): Promise<() => Promise<void>>\n{\n    const WebSocketServer = await loadWSServer();\n\n    const {\n        pingInterval = 30000,\n        path = '/ws',\n        auth: authConfig,\n    } = config;\n\n    if (authConfig?.enabled && !tokenManager)\n    {\n        throw new Error(\n            'WebSocket auth.enabled=true requires a tokenManager. ' +\n            'Pass tokenManager or use .websockets(router, { auth: { enabled: true } }) via startServer.'\n        );\n    }\n\n    const wss = new WebSocketServer({ server, path });\n\n    // Track live connections for graceful shutdown\n    const clients = new Set<any>();\n\n    wss.on('connection', (ws: any, req: any) =>\n    {\n        clients.add(ws);\n        ws.on('close', () => clients.delete(ws));\n        handleConnection(ws, req, router, authConfig, tokenManager, pingInterval)\n            .catch((err: Error) =>\n            {\n                wsLogger.error('WebSocket connection handler error', err);\n                if (ws.readyState === 1) ws.close(1011, 'Internal server error');\n            });\n    });\n\n    wss.on('error', (err: Error) =>\n    {\n        wsLogger.error('WebSocket server error', err);\n    });\n\n    wsLogger.info(`✓ WebSocket endpoint registered at ${path}`, {\n        events: router.eventNames,\n        auth: !!authConfig?.enabled,\n    });\n\n    return () => new Promise<void>((resolve, reject) =>\n    {\n        // Close all existing connections with 1001 Going Away\n        for (const client of clients)\n        {\n            client.close(1001, 'Server shutting down');\n        }\n        clients.clear();\n\n        wss.close((err?: Error) =>\n        {\n            if (err) reject(err);\n            else resolve();\n        });\n    });\n}\n\n// ============================================================================\n// Connection Handler\n// ============================================================================\n\nasync function handleConnection(\n    ws: any,\n    req: any,\n    router: WSRouterDef<any, any>,\n    authConfig: WSHandlerAuthConfig | undefined,\n    tokenManager: SSETokenManager | undefined,\n    pingInterval: number\n): Promise<void>\n{\n    // Register close handler before any await — ensures we never miss the event even during auth\n    let pingTimer: ReturnType<typeof setInterval> | undefined;\n    let connectionUnsubscribes: (() => void)[] = [];\n    let subscribedEvents: string[] = [];\n    ws.on('close', () =>\n    {\n        clearInterval(pingTimer);\n        connectionUnsubscribes.forEach(fn => fn());\n        if (subscribedEvents.length > 0)\n            wsLogger.info('WebSocket connection closed', { events: subscribedEvents });\n    });\n\n    const url = parseURL(req);\n    if (!url)\n    {\n        ws.close(1002, 'Invalid request URL');\n        return;\n    }\n\n    // ── 1. Authenticate ──\n    const subject = await resolveSubject(url, authConfig?.enabled ? tokenManager : undefined);\n    if (subject === false)\n    {\n        ws.close(4001, 'Missing token');\n        return;\n    }\n    if (subject === null)\n    {\n        ws.close(4001, 'Invalid or expired token');\n        return;\n    }\n\n    // ── 2. Resolve subscribed events ──\n    const requestedEvents = parseRequestedEvents(url, router.eventNames as string[]);\n    if (requestedEvents.length === 0)\n    {\n        ws.close(4000, 'No valid event names specified');\n        return;\n    }\n\n    // ── 3. Authorize ──\n    const allowedEvents = await resolveAllowedEvents(subject, requestedEvents, authConfig);\n    if (allowedEvents === null)\n    {\n        ws.close(4003, 'Not authorized for any requested events');\n        return;\n    }\n\n    subscribedEvents = allowedEvents;\n    wsLogger.info('WebSocket connection established', {\n        events: allowedEvents,\n        subject: subject ?? undefined,\n    });\n\n    // ── 4. Build connection wrapper ──\n    const connection = createConnection(ws);\n\n    // ── 5. Subscribe to server-push events ──\n    connectionUnsubscribes = subscribeEvents(ws, router, allowedEvents, subject, authConfig);\n\n    // If socket closed during auth awaits, clean up and bail\n    if (ws.readyState !== 1)\n    {\n        connectionUnsubscribes.forEach(fn => fn());\n        connectionUnsubscribes = [];\n        return;\n    }\n\n    // ── 6. Handle incoming messages ──\n    ws.on('message', (data: Buffer | string) =>\n    {\n        onClientMessage(data, router, connection, subject)\n            .catch((err: Error) => wsLogger.error('Unhandled message error', err));\n    });\n\n    // ── 7. Keep-alive ping ──\n    if (pingInterval > 0)\n    {\n        pingTimer = setInterval(() =>\n        {\n            if (ws.readyState === 1) ws.ping();\n        }, pingInterval);\n    }\n\n    // ── 9. Send connected ack ──\n    connection.send('__connected', {\n        subscribedEvents: allowedEvents,\n        timestamp: Date.now(),\n    });\n}\n\n// ============================================================================\n// Helpers\n// ============================================================================\n\nfunction parseURL(req: any): URL | null\n{\n    try\n    {\n        return new URL(req.url ?? '/', 'ws://localhost');\n    }\n    catch\n    {\n        return null;\n    }\n}\n\n/**\n * Resolve subject from token\n * - undefined: no auth required\n * - false: token param missing (when required)\n * - null: token invalid/expired\n * - string: authenticated subject\n */\nasync function resolveSubject(\n    url: URL,\n    tokenManager?: SSETokenManager\n): Promise<string | undefined | false | null>\n{\n    if (!tokenManager)\n    {\n        return undefined;\n    }\n\n    const token = url.searchParams.get('token');\n    if (!token)\n    {\n        return false;\n    }\n\n    return await tokenManager.verify(token);\n}\n\nfunction parseRequestedEvents(url: URL, validEventNames: string[]): string[]\n{\n    const eventsParam = url.searchParams.get('events');\n    if (!eventsParam)\n    {\n        return [];\n    }\n\n    return eventsParam\n        .split(',')\n        .map(e => e.trim())\n        .filter(e => validEventNames.includes(e));\n}\n\nasync function resolveAllowedEvents(\n    subject: string | undefined,\n    requestedEvents: string[],\n    authConfig?: WSHandlerAuthConfig\n): Promise<string[] | null>\n{\n    if (!subject || !authConfig?.authorize)\n    {\n        return requestedEvents;\n    }\n\n    const allowed = await authConfig.authorize(subject, requestedEvents);\n    return allowed.length === 0 ? null : allowed;\n}\n\nfunction createConnection(ws: any): WSRawConnection\n{\n    return {\n        send: (type, payload) =>\n        {\n            if (ws.readyState !== 1) return;\n            ws.send(JSON.stringify({ type, data: payload }));\n        },\n        close: (code, reason) => ws.close(code, reason),\n    };\n}\n\nfunction subscribeEvents(\n    ws: any,\n    router: WSRouterDef<any, any>,\n    allowedEvents: string[],\n    subject: string | undefined,\n    authConfig?: WSHandlerAuthConfig\n): (() => void)[]\n{\n    const unsubscribes: (() => void)[] = [];\n\n    for (const eventName of allowedEvents)\n    {\n        const eventDef = router.events[eventName];\n        if (!eventDef) continue;\n\n        const unsubscribe = eventDef.subscribe((payload: unknown) =>\n        {\n            if (ws.readyState !== 1) return;\n\n            if (subject && authConfig?.filter?.[eventName])\n            {\n                if (!authConfig.filter[eventName](subject, payload)) return;\n            }\n\n            try\n            {\n                ws.send(JSON.stringify({ type: eventName, data: payload }));\n            }\n            catch\n            {\n                // Socket closed between readyState check and send — ignore\n            }\n        });\n\n        unsubscribes.push(unsubscribe);\n    }\n\n    return unsubscribes;\n}\n\nasync function onClientMessage(\n    data: Buffer | string,\n    router: WSRouterDef<any, any>,\n    connection: WSRawConnection,\n    subject: string | undefined\n): Promise<void>\n{\n    let message: { type?: string; data?: unknown };\n\n    try\n    {\n        message = JSON.parse(data.toString());\n    }\n    catch\n    {\n        return;\n    }\n\n    const { type, data: payload } = message;\n    if (!type) return;\n\n    const handler = router.messages[type];\n    if (!handler) return;\n\n    try\n    {\n        await handler({ payload, subject, ws: connection });\n    }\n    catch (err)\n    {\n        wsLogger.error(`WebSocket message handler error: ${type}`, err as Error);\n    }\n}\n\n// ============================================================================\n// Dynamic import for optional 'ws' dependency\n// ============================================================================\n\nasync function loadWSServer(): Promise<any>\n{\n    try\n    {\n        // ws is a CJS package: module.exports = WebSocket, WebSocket.WebSocketServer is set on it.\n        // ESM dynamic import wraps CJS default export under .default\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const mod = await import('ws') as any;\n        const WS = mod.default ?? mod;\n        const WSS = WS.WebSocketServer ?? WS.Server;\n\n        if (typeof WSS !== 'function')\n        {\n            throw new Error(\n                'WebSocketServer not found in ws module. ' +\n                'Ensure ws@^8 is installed: pnpm add ws'\n            );\n        }\n\n        return WSS;\n    }\n    catch (err)\n    {\n        if (err instanceof Error && err.message.includes('WebSocketServer not found'))\n        {\n            throw err;\n        }\n        throw new Error(\n            '@spfn/core WebSocket support requires the \"ws\" package.\\n' +\n            'Install it with: pnpm add ws'\n        );\n    }\n}\n","/**\n * WebSocket Module\n *\n * Type-safe WebSocket server with event-based pub/sub and bidirectional messaging.\n *\n * @example Server setup\n * ```typescript\n * // src/server/ws.ts\n * import { defineWSRouter } from '@spfn/core/event/ws';\n * import { defineEvent } from '@spfn/core/event';\n * import { Type } from '@sinclair/typebox';\n *\n * const userUpdated = defineEvent('user.updated', Type.Object({ userId: Type.String() }));\n * const notification = defineEvent('notification', Type.Object({ message: Type.String() }));\n *\n * export const wsRouter = defineWSRouter({\n *     events: { userUpdated, notification },\n *     messages: {\n *         ping: ({ ws }) => ws.send('pong', {}),\n *     },\n * });\n *\n * export type WSRouter = typeof wsRouter;\n *\n * // server.config.ts\n * defineServerConfig()\n *     .websockets(wsRouter)\n *     .build();\n * ```\n *\n * @example Client usage\n * ```typescript\n * import { createWSClient } from '@spfn/core/event/ws/client';\n * import type { WSRouter } from '@/server/ws';\n *\n * const client = createWSClient<WSRouter>();\n *\n * client.subscribe({\n *     events: ['userUpdated', 'notification'],\n *     handlers: {\n *         userUpdated: ({ userId }) => console.log(userId),\n *         notification: ({ message }) => console.log(message),\n *     },\n * });\n *\n * client.send('ping', {});\n * ```\n */\n\nimport type { EventDef } from '../types';\nimport type { WSRouterDef, WSMessageHandlers } from './types';\n\nexport { attachWSHandler } from './handler';\nexport type {\n    WSRouterDef,\n    WSHandlerConfig,\n    WSAuthConfig,\n    WSHandlerAuthConfig,\n    WSMessageContext,\n    WSMessageHandlerFn,\n    WSMessageHandlers,\n    WSRawConnection,\n    WSClientConfig,\n    WSConnectionState,\n    WSEventHandlers,\n    WSSubscribeOptions,\n    WSUnsubscribe,\n} from './types';\n\n/**\n * Define a WebSocket router\n *\n * Combines server→client event push with client→server message handlers.\n *\n * @example\n * ```typescript\n * export const wsRouter = defineWSRouter({\n *     events: { userUpdated, notification },\n *     messages: {\n *         ping: ({ ws }) => ws.send('pong', {}),\n *         'chat.send': ({ payload, subject }) => handleChat(payload, subject),\n *     },\n * });\n * ```\n */\nexport function defineWSRouter<\n    TEvents extends Record<string, EventDef<any>>,\n    TMessages extends WSMessageHandlers = WSMessageHandlers\n>(def: {\n    events: TEvents;\n    messages?: TMessages;\n}): WSRouterDef<TEvents, TMessages>\n{\n    return {\n        events: def.events,\n        eventNames: Object.keys(def.events) as (keyof TEvents)[],\n        messages: (def.messages ?? {}) as TMessages,\n        _types: {} as WSRouterDef<TEvents, TMessages>['_types'],\n    };\n}\n"]}

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

@@ -1,5 +1,5 @@
-import { E as EventRouterDef, I as InferEventNames } from '../../router-Di7ENoah.js';
-import { k as SSESubscribeOptions, m as SSEUnsubscribe, l as SSEConnectionState, h as SSEClientConfig } from '../../types-DKQ90YL7.js';
+import { E as EventRouterDef, I as InferEventNames } from '../../token-manager-DSwIDD-_.js';
+import { g as SSESubscribeOptions, i as SSEUnsubscribe, h as SSEConnectionState, d as SSEClientConfig } from '../../types-BOOUBu9l.js';
 import '@sinclair/typebox';
 import 'hono';
 

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

@@ -1,7 +1,8 @@
 import { Context } from 'hono';
-import { E as EventRouterDef } from '../../router-Di7ENoah.js';
-import { S as SSEHandlerConfig, b as SSETokenManager } from '../../types-DKQ90YL7.js';
-export { C as CacheTokenStore, a as SSEAuthConfig, h as SSEClientConfig, l as SSEConnectionState, i as SSEEventHandler, j as SSEEventHandlers, g as SSEHandlerAuthConfig, f as SSEMessage, k as SSESubscribeOptions, c as SSEToken, e as SSETokenManagerConfig, d as SSETokenStore, m as SSEUnsubscribe } from '../../types-DKQ90YL7.js';
+import { E as EventRouterDef, S as SSETokenManager } from '../../token-manager-DSwIDD-_.js';
+export { C as CacheTokenStore, g as SSEToken, i as SSETokenManagerConfig, h as SSETokenStore } from '../../token-manager-DSwIDD-_.js';
+import { S as SSEHandlerConfig } from '../../types-BOOUBu9l.js';
+export { a as SSEAuthConfig, d as SSEClientConfig, h as SSEConnectionState, e as SSEEventHandler, f as SSEEventHandlers, c as SSEHandlerAuthConfig, b as SSEMessage, g as SSESubscribeOptions, i as SSEUnsubscribe } from '../../types-BOOUBu9l.js';
 import '@sinclair/typebox';
 
 /**

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

@@ -0,0 +1,59 @@
+import { W as WSRouterDef, k as WSSubscribeOptions, l as WSUnsubscribe, i as WSConnectionState, h as WSClientConfig } from '../../types-FuJb3yrP.js';
+import 'hono';
+import '../../token-manager-DSwIDD-_.js';
+import '@sinclair/typebox';
+
+/**
+ * WebSocket Client
+ *
+ * Type-safe browser WebSocket wrapper for event subscription and bidirectional messaging.
+ *
+ * @example
+ * ```typescript
+ * import { createWSClient } from '@spfn/core/event/ws/client';
+ * import type { WSRouter } from '@/server/ws';
+ *
+ * const client = createWSClient<WSRouter>();
+ *
+ * const unsubscribe = client.subscribe({
+ *     events: ['userUpdated', 'notification'],
+ *     handlers: {
+ *         userUpdated: ({ userId }) => console.log(userId),
+ *         notification: ({ message }) => console.log(message),
+ *     },
+ *     onOpen: () => console.log('connected'),
+ * });
+ *
+ * // Send message to server
+ * client.send('ping', {});
+ *
+ * // Cleanup
+ * unsubscribe();
+ * ```
+ */
+
+interface WSClient<TRouter extends WSRouterDef<any, any>> {
+    /**
+     * Subscribe to server-push events
+     * Returns an unsubscribe function
+     */
+    subscribe(options: WSSubscribeOptions<TRouter>): WSUnsubscribe;
+    /**
+     * Send a message to the server
+     */
+    send<TType extends string>(type: TType, payload: unknown): void;
+    /**
+     * Get current connection state
+     */
+    getState(): WSConnectionState;
+    /**
+     * Close the connection permanently
+     */
+    close(): void;
+}
+/**
+ * Create a type-safe WebSocket client
+ */
+declare function createWSClient<TRouter extends WSRouterDef<any, any>>(config?: WSClientConfig): WSClient<TRouter>;
+
+export { type WSClient, createWSClient };

package/dist/event/ws/client.js

@@ -0,0 +1,273 @@
+// src/event/ws/client.ts
+function deriveWSHost() {
+  const apiUrl = typeof process !== "undefined" ? process.env.NEXT_PUBLIC_SPFN_API_URL || "http://localhost:8790" : "http://localhost:8790";
+  return apiUrl.replace(/^https:\/\//, "wss://").replace(/^http:\/\//, "ws://");
+}
+var WS_DEFAULTS = {
+  get host() {
+    return deriveWSHost();
+  },
+  pathname: "/ws"
+};
+function createWSClient(config = {}) {
+  const {
+    host = WS_DEFAULTS.host,
+    pathname = WS_DEFAULTS.pathname,
+    reconnect = true,
+    reconnectDelay = 3e3,
+    maxReconnectAttempts = 0,
+    acquireToken
+  } = config;
+  const baseUrl = `${host}${pathname}`;
+  let socket = null;
+  let state = "closed";
+  let reconnectAttempts = 0;
+  let reconnectTimer = null;
+  let destroyed = false;
+  let intentionalReconnect = false;
+  let sentEvents = /* @__PURE__ */ new Set();
+  let connectedEvents = /* @__PURE__ */ new Set();
+  const subscriptions = /* @__PURE__ */ new Set();
+  function setState(next) {
+    state = next;
+  }
+  function buildURL(events, token) {
+    const params = new URLSearchParams();
+    params.set("events", events.join(","));
+    if (token) params.set("token", token);
+    return `${baseUrl}?${params.toString()}`;
+  }
+  function mergeEventNames() {
+    const names = /* @__PURE__ */ new Set();
+    for (const sub of subscriptions) {
+      if (sub.active) {
+        sub.options.events.forEach((e) => names.add(e));
+      }
+    }
+    return [...names];
+  }
+  function dispatch(type, payload) {
+    for (const sub of subscriptions) {
+      if (!sub.active) continue;
+      const handler = sub.options.handlers[type];
+      if (handler) handler(payload);
+    }
+  }
+  function onOpen() {
+    setState("open");
+    reconnectAttempts = 0;
+    connectedEvents = new Set(sentEvents);
+    const current = mergeEventNames();
+    const hasNewEvents = current.some((e) => !connectedEvents.has(e));
+    if (hasNewEvents) {
+      intentionalReconnect = true;
+      socket?.close();
+      return;
+    }
+    for (const sub of subscriptions) {
+      if (sub.active) sub.options.onOpen?.();
+    }
+  }
+  function onError(evt) {
+    setState("error");
+    for (const sub of subscriptions) {
+      if (sub.active) sub.options.onError?.(evt);
+    }
+  }
+  function onClose() {
+    socket = null;
+    connectedEvents = /* @__PURE__ */ new Set();
+    sentEvents = /* @__PURE__ */ new Set();
+    if (destroyed) {
+      setState("closed");
+      for (const sub of subscriptions) {
+        if (sub.active) {
+          sub.options.onClose?.();
+          sub.active = false;
+        }
+      }
+      subscriptions.clear();
+      return;
+    }
+    if (intentionalReconnect) {
+      intentionalReconnect = false;
+      connect();
+      return;
+    }
+    const hasActive = [...subscriptions].some((s) => s.active);
+    if (!reconnect || !hasActive) {
+      setState("closed");
+      if (!reconnect && hasActive) {
+        for (const sub of subscriptions) {
+          if (sub.active) {
+            sub.options.onClose?.();
+            sub.active = false;
+          }
+        }
+        subscriptions.clear();
+      }
+      return;
+    }
+    if (maxReconnectAttempts > 0 && reconnectAttempts >= maxReconnectAttempts) {
+      setState("closed");
+      for (const sub of subscriptions) {
+        if (sub.active) {
+          sub.options.onClose?.();
+          sub.active = false;
+        }
+      }
+      subscriptions.clear();
+      return;
+    }
+    setState("closed");
+    reconnectAttempts++;
+    for (const sub of subscriptions) {
+      if (sub.active) sub.options.onReconnect?.(reconnectAttempts);
+    }
+    reconnectTimer = setTimeout(() => connect(), reconnectDelay);
+  }
+  function onMessage(evt) {
+    let msg;
+    try {
+      msg = JSON.parse(evt.data);
+    } catch {
+      return;
+    }
+    const { type, data } = msg;
+    if (!type || type === "__connected") return;
+    dispatch(type, data);
+  }
+  async function connect() {
+    if (destroyed) return;
+    if (state === "connecting") return;
+    const events = mergeEventNames();
+    if (events.length === 0) return;
+    sentEvents = new Set(events);
+    setState("connecting");
+    let token;
+    if (acquireToken) {
+      try {
+        token = await acquireToken();
+      } catch {
+        setState("error");
+        const errorEvent = new Event("error");
+        for (const sub of subscriptions) {
+          if (sub.active) sub.options.onError?.(errorEvent);
+        }
+        const permanentlyClose = destroyed || !reconnect || maxReconnectAttempts > 0 && reconnectAttempts >= maxReconnectAttempts;
+        if (permanentlyClose) {
+          setState("closed");
+          sentEvents = /* @__PURE__ */ new Set();
+          for (const sub of subscriptions) {
+            if (sub.active) {
+              sub.options.onClose?.();
+              sub.active = false;
+            }
+          }
+          subscriptions.clear();
+          return;
+        }
+        reconnectAttempts++;
+        for (const sub of subscriptions) {
+          if (sub.active) sub.options.onReconnect?.(reconnectAttempts);
+        }
+        if (reconnectTimer) clearTimeout(reconnectTimer);
+        reconnectTimer = setTimeout(() => connect(), reconnectDelay);
+        return;
+      }
+      if (destroyed) {
+        setState("closed");
+        sentEvents = /* @__PURE__ */ new Set();
+        for (const sub of subscriptions) {
+          if (sub.active) {
+            sub.options.onClose?.();
+            sub.active = false;
+          }
+        }
+        subscriptions.clear();
+        return;
+      }
+      const currentEvents = mergeEventNames();
+      if (currentEvents.length === 0) {
+        setState("closed");
+        sentEvents = /* @__PURE__ */ new Set();
+        return;
+      }
+      if (currentEvents.some((e) => !sentEvents.has(e)) || sentEvents.size !== currentEvents.length) {
+        sentEvents = new Set(currentEvents);
+      }
+    }
+    const url = buildURL([...sentEvents], token);
+    const thisSocket = new WebSocket(url);
+    socket = thisSocket;
+    socket.onopen = onOpen;
+    socket.onerror = onError;
+    socket.onclose = () => {
+      if (socket === thisSocket) onClose();
+    };
+    socket.onmessage = onMessage;
+  }
+  function subscribe(options) {
+    const sub = { options, active: true };
+    subscriptions.add(sub);
+    if (!destroyed && (state === "closed" || state === "error") && !socket) {
+      if (reconnectTimer) {
+        clearTimeout(reconnectTimer);
+        reconnectTimer = null;
+      }
+      connect();
+    } else if (state === "open") {
+      const hasNewEvents = options.events.some((e) => !connectedEvents.has(e));
+      if (hasNewEvents) {
+        intentionalReconnect = true;
+        socket.close();
+      }
+    }
+    return () => {
+      if (!sub.active) return;
+      sub.active = false;
+      subscriptions.delete(sub);
+      if (!destroyed) {
+        const hasActive = [...subscriptions].some((s) => s.active);
+        if (!hasActive && socket) {
+          socket.close();
+        }
+      }
+      options.onClose?.();
+    };
+  }
+  function send(type, payload) {
+    if (destroyed || !socket || socket.readyState !== WebSocket.OPEN) return;
+    socket.send(JSON.stringify({ type, data: payload }));
+  }
+  function close() {
+    destroyed = true;
+    if (reconnectTimer) {
+      clearTimeout(reconnectTimer);
+      reconnectTimer = null;
+    }
+    if (socket) {
+      socket.close();
+    } else {
+      setState("closed");
+      sentEvents = /* @__PURE__ */ new Set();
+      for (const sub of subscriptions) {
+        if (sub.active) {
+          sub.options.onClose?.();
+          sub.active = false;
+        }
+      }
+      subscriptions.clear();
+    }
+  }
+  return {
+    subscribe,
+    send,
+    getState: () => state,
+    close
+  };
+}
+
+export { createWSClient };
+//# sourceMappingURL=client.js.map
+//# sourceMappingURL=client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/event/ws/client.ts"],"names":[],"mappings":"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","file":"client.js","sourcesContent":["/**\n * WebSocket Client\n *\n * Type-safe browser WebSocket wrapper for event subscription and bidirectional messaging.\n *\n * @example\n * ```typescript\n * import { createWSClient } from '@spfn/core/event/ws/client';\n * import type { WSRouter } from '@/server/ws';\n *\n * const client = createWSClient<WSRouter>();\n *\n * const unsubscribe = client.subscribe({\n *     events: ['userUpdated', 'notification'],\n *     handlers: {\n *         userUpdated: ({ userId }) => console.log(userId),\n *         notification: ({ message }) => console.log(message),\n *     },\n *     onOpen: () => console.log('connected'),\n * });\n *\n * // Send message to server\n * client.send('ping', {});\n *\n * // Cleanup\n * unsubscribe();\n * ```\n */\n\nimport type { WSRouterDef, WSClientConfig, WSSubscribeOptions, WSUnsubscribe, WSConnectionState } from './types';\n\n// ============================================================================\n// Public Interface\n// ============================================================================\n\nexport interface WSClient<TRouter extends WSRouterDef<any, any>>\n{\n    /**\n     * Subscribe to server-push events\n     * Returns an unsubscribe function\n     */\n    subscribe(options: WSSubscribeOptions<TRouter>): WSUnsubscribe;\n\n    /**\n     * Send a message to the server\n     */\n    send<TType extends string>(\n        type: TType,\n        payload: unknown\n    ): void;\n\n    /**\n     * Get current connection state\n     */\n    getState(): WSConnectionState;\n\n    /**\n     * Close the connection permanently\n     */\n    close(): void;\n}\n\n// ============================================================================\n// Defaults\n// ============================================================================\n\nfunction deriveWSHost(): string\n{\n    const apiUrl = typeof process !== 'undefined'\n        ? (process.env.NEXT_PUBLIC_SPFN_API_URL || 'http://localhost:8790')\n        : 'http://localhost:8790';\n\n    return apiUrl\n        .replace(/^https:\\/\\//, 'wss://')\n        .replace(/^http:\\/\\//, 'ws://');\n}\n\nconst WS_DEFAULTS = {\n    get host() { return deriveWSHost(); },\n    pathname: '/ws',\n} as const;\n\n// ============================================================================\n// Factory\n// ============================================================================\n\n/**\n * Create a type-safe WebSocket client\n */\nexport function createWSClient<TRouter extends WSRouterDef<any, any>>(\n    config: WSClientConfig = {}\n): WSClient<TRouter>\n{\n    const {\n        host = WS_DEFAULTS.host,\n        pathname = WS_DEFAULTS.pathname,\n        reconnect = true,\n        reconnectDelay = 3000,\n        maxReconnectAttempts = 0,\n        acquireToken,\n    } = config;\n\n    const baseUrl = `${host}${pathname}`;\n\n    let socket: WebSocket | null = null;\n    let state: WSConnectionState = 'closed';\n    let reconnectAttempts = 0;\n    let reconnectTimer: ReturnType<typeof setTimeout> | null = null;\n    let destroyed = false;\n    // Set before intentionally closing socket (new events merge) — skips delay/counter in onClose\n    let intentionalReconnect = false;\n    // Events actually sent in the current/last connect() URL\n    let sentEvents: Set<string> = new Set();\n    // Events the server confirmed it has subscribed (set on onOpen)\n    let connectedEvents: Set<string> = new Set();\n\n    // Active subscriptions: each entry is one subscribe() call\n    type Subscription = {\n        options: WSSubscribeOptions<TRouter>;\n        active: boolean;\n    };\n    const subscriptions: Set<Subscription> = new Set();\n\n    // ── Internal helpers ──\n\n    function setState(next: WSConnectionState)\n    {\n        state = next;\n    }\n\n    function buildURL(events: string[], token?: string): string\n    {\n        const params = new URLSearchParams();\n        params.set('events', events.join(','));\n        if (token) params.set('token', token);\n        return `${baseUrl}?${params.toString()}`;\n    }\n\n    function mergeEventNames(): string[]\n    {\n        const names = new Set<string>();\n        for (const sub of subscriptions)\n        {\n            if (sub.active)\n            {\n                (sub.options.events as string[]).forEach(e => names.add(e));\n            }\n        }\n        return [...names];\n    }\n\n    function dispatch(type: string, payload: unknown)\n    {\n        for (const sub of subscriptions)\n        {\n            if (!sub.active) continue;\n            const handler = (sub.options.handlers as Record<string, ((p: unknown) => void) | undefined>)[type];\n            if (handler) handler(payload);\n        }\n    }\n\n    function onOpen()\n    {\n        setState('open');\n        reconnectAttempts = 0;\n        // Use sentEvents (what was in the URL), not mergeEventNames()\n        // New subscriptions added during CONNECTING are NOT yet on the server\n        connectedEvents = new Set(sentEvents);\n\n        // Check reconnect need BEFORE firing callbacks to avoid spurious onOpen calls\n        const current = mergeEventNames();\n        const hasNewEvents = current.some(e => !connectedEvents.has(e));\n        if (hasNewEvents)\n        {\n            intentionalReconnect = true;\n            socket?.close();\n            return;\n        }\n\n        for (const sub of subscriptions)\n        {\n            if (sub.active) sub.options.onOpen?.();\n        }\n    }\n\n    function onError(evt: Event)\n    {\n        setState('error');\n        for (const sub of subscriptions)\n        {\n            if (sub.active) sub.options.onError?.(evt);\n        }\n    }\n\n    function onClose()\n    {\n        socket = null;\n        connectedEvents = new Set();\n        sentEvents = new Set();\n\n        if (destroyed)\n        {\n            setState('closed');\n            for (const sub of subscriptions)\n            {\n                if (sub.active)\n                {\n                    sub.options.onClose?.();\n                    sub.active = false;\n                }\n            }\n            subscriptions.clear();\n            return;\n        }\n\n        // Intentional reconnect (new events merged): skip delay, counter, and callbacks\n        if (intentionalReconnect)\n        {\n            intentionalReconnect = false;\n            connect();\n            return;\n        }\n\n        const hasActive = [...subscriptions].some(s => s.active);\n        if (!reconnect || !hasActive)\n        {\n            setState('closed');\n            if (!reconnect && hasActive)\n            {\n                for (const sub of subscriptions)\n                {\n                    if (sub.active)\n                    {\n                        sub.options.onClose?.();\n                        sub.active = false;\n                    }\n                }\n                subscriptions.clear();\n            }\n            return;\n        }\n\n        if (maxReconnectAttempts > 0 && reconnectAttempts >= maxReconnectAttempts)\n        {\n            setState('closed');\n            for (const sub of subscriptions)\n            {\n                if (sub.active)\n                {\n                    sub.options.onClose?.();\n                    sub.active = false;\n                }\n            }\n            subscriptions.clear();\n            return;\n        }\n\n        setState('closed');\n        reconnectAttempts++;\n        for (const sub of subscriptions)\n        {\n            if (sub.active) sub.options.onReconnect?.(reconnectAttempts);\n        }\n\n        reconnectTimer = setTimeout(() => connect(), reconnectDelay);\n    }\n\n    function onMessage(evt: MessageEvent)\n    {\n        let msg: { type?: string; data?: unknown };\n        try\n        {\n            msg = JSON.parse(evt.data as string);\n        }\n        catch\n        {\n            return;\n        }\n\n        const { type, data } = msg;\n        if (!type || type === '__connected') return;\n\n        dispatch(type, data);\n    }\n\n    async function connect()\n    {\n        if (destroyed) return;\n        if (state === 'connecting') return;\n\n        const events = mergeEventNames();\n        if (events.length === 0) return;\n\n        sentEvents = new Set(events);  // record what we're sending in the URL\n        setState('connecting');\n\n        let token: string | undefined;\n        if (acquireToken)\n        {\n            try\n            {\n                token = await acquireToken();\n            }\n            catch\n            {\n                setState('error');\n                const errorEvent = new Event('error');\n                for (const sub of subscriptions)\n                {\n                    if (sub.active) sub.options.onError?.(errorEvent);\n                }\n\n                const permanentlyClose = destroyed || !reconnect\n                    || (maxReconnectAttempts > 0 && reconnectAttempts >= maxReconnectAttempts);\n\n                if (permanentlyClose)\n                {\n                    setState('closed');\n                    sentEvents = new Set();\n                    for (const sub of subscriptions)\n                    {\n                        if (sub.active) { sub.options.onClose?.(); sub.active = false; }\n                    }\n                    subscriptions.clear();\n                    return;\n                }\n\n                reconnectAttempts++;\n                for (const sub of subscriptions)\n                {\n                    if (sub.active) sub.options.onReconnect?.(reconnectAttempts);\n                }\n                if (reconnectTimer) clearTimeout(reconnectTimer);\n                reconnectTimer = setTimeout(() => connect(), reconnectDelay);\n                return;\n            }\n\n            // close() may have been called while awaiting the token\n            if (destroyed)\n            {\n                setState('closed');\n                sentEvents = new Set();\n                for (const sub of subscriptions)\n                {\n                    if (sub.active)\n                    {\n                        sub.options.onClose?.();\n                        sub.active = false;\n                    }\n                }\n                subscriptions.clear();\n                return;\n            }\n\n            // Subscriptions may have changed while awaiting the token — recompute\n            const currentEvents = mergeEventNames();\n            if (currentEvents.length === 0)\n            {\n                setState('closed');\n                sentEvents = new Set();\n                return;\n            }\n            // Update sentEvents to reflect what we're actually connecting with\n            if (currentEvents.some(e => !sentEvents.has(e)) || sentEvents.size !== currentEvents.length)\n            {\n                sentEvents = new Set(currentEvents);\n            }\n        }\n\n        const url = buildURL([...sentEvents], token);\n        const thisSocket = new WebSocket(url);\n        socket = thisSocket;\n        socket.onopen = onOpen;\n        socket.onerror = onError;\n        // Guard against a stale close event from a previous socket overwriting the\n        // current socket reference. This can happen when onError fires (state→'error'),\n        // subscribe() immediately calls connect() creating a new socket, and then the\n        // old socket's onclose finally arrives and sets socket = null on the new one.\n        socket.onclose = () => { if (socket === thisSocket) onClose(); };\n        socket.onmessage = onMessage;\n    }\n\n    // ── Public API ──\n\n    function subscribe(options: WSSubscribeOptions<TRouter>): WSUnsubscribe\n    {\n        const sub: Subscription = { options, active: true };\n        subscriptions.add(sub);\n\n        if (!destroyed && (state === 'closed' || state === 'error') && !socket)\n        {\n            if (reconnectTimer)\n            {\n                clearTimeout(reconnectTimer);\n                reconnectTimer = null;\n            }\n            connect();\n        }\n        else if (state === 'open')\n        {\n            // Reconnect if the new subscription requests events not yet subscribed\n            const hasNewEvents = (options.events as string[]).some(e => !connectedEvents.has(e));\n            if (hasNewEvents)\n            {\n                intentionalReconnect = true;\n                socket!.close();  // triggers onClose → connect() immediately, no delay/counter\n            }\n        }\n        // state === 'connecting': onOpen will detect new events and do intentionalReconnect\n\n        return () =>\n        {\n            if (!sub.active) return;\n            sub.active = false;\n            subscriptions.delete(sub);\n\n            if (!destroyed)\n            {\n                const hasActive = [...subscriptions].some(s => s.active);\n                if (!hasActive && socket)\n                {\n                    socket.close();\n                }\n            }\n\n            options.onClose?.();\n        };\n    }\n\n    function send(type: string, payload: unknown): void\n    {\n        if (destroyed || !socket || socket.readyState !== WebSocket.OPEN) return;\n        socket.send(JSON.stringify({ type, data: payload }));\n    }\n\n    function close(): void\n    {\n        destroyed = true;\n        if (reconnectTimer)\n        {\n            clearTimeout(reconnectTimer);\n            reconnectTimer = null;\n        }\n        if (socket)\n        {\n            socket.close();  // onClose() will fire and clean up\n        }\n        else\n        {\n            // No socket (e.g. waiting for reconnect timer) — onClose won't fire, clean up directly\n            setState('closed');\n            sentEvents = new Set();\n            for (const sub of subscriptions)\n            {\n                if (sub.active)\n                {\n                    sub.options.onClose?.();\n                    sub.active = false;\n                }\n            }\n            subscriptions.clear();\n        }\n    }\n\n    return {\n        subscribe,\n        send,\n        getState: () => state,\n        close,\n    };\n}\n"]}

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

@@ -0,0 +1,94 @@
+import { a as EventDef, S as SSETokenManager } from '../../token-manager-DSwIDD-_.js';
+import { b as WSMessageHandlers, W as WSRouterDef, a as WSHandlerConfig } from '../../types-FuJb3yrP.js';
+export { c as WSAuthConfig, h as WSClientConfig, i as WSConnectionState, j as WSEventHandlers, d as WSHandlerAuthConfig, e as WSMessageContext, f as WSMessageHandlerFn, g as WSRawConnection, k as WSSubscribeOptions, l as WSUnsubscribe } from '../../types-FuJb3yrP.js';
+import { Server } from 'node:http';
+import '@sinclair/typebox';
+import 'hono';
+
+/**
+ * WebSocket Handler
+ *
+ * Attaches a WebSocket server to an existing Node.js http.Server.
+ * Handles authentication, event subscription, and client message routing.
+ */
+
+/**
+ * Attach a WebSocket server to a Node.js http.Server
+ *
+ * @returns cleanup function that closes the WebSocket server
+ */
+declare function attachWSHandler<TEvents extends Record<string, EventDef<any>>, TMessages extends WSMessageHandlers>(server: Server, router: WSRouterDef<TEvents, TMessages>, config?: WSHandlerConfig & {
+    path?: string;
+}, tokenManager?: SSETokenManager): Promise<() => Promise<void>>;
+
+/**
+ * WebSocket Module
+ *
+ * Type-safe WebSocket server with event-based pub/sub and bidirectional messaging.
+ *
+ * @example Server setup
+ * ```typescript
+ * // src/server/ws.ts
+ * import { defineWSRouter } from '@spfn/core/event/ws';
+ * import { defineEvent } from '@spfn/core/event';
+ * import { Type } from '@sinclair/typebox';
+ *
+ * const userUpdated = defineEvent('user.updated', Type.Object({ userId: Type.String() }));
+ * const notification = defineEvent('notification', Type.Object({ message: Type.String() }));
+ *
+ * export const wsRouter = defineWSRouter({
+ *     events: { userUpdated, notification },
+ *     messages: {
+ *         ping: ({ ws }) => ws.send('pong', {}),
+ *     },
+ * });
+ *
+ * export type WSRouter = typeof wsRouter;
+ *
+ * // server.config.ts
+ * defineServerConfig()
+ *     .websockets(wsRouter)
+ *     .build();
+ * ```
+ *
+ * @example Client usage
+ * ```typescript
+ * import { createWSClient } from '@spfn/core/event/ws/client';
+ * import type { WSRouter } from '@/server/ws';
+ *
+ * const client = createWSClient<WSRouter>();
+ *
+ * client.subscribe({
+ *     events: ['userUpdated', 'notification'],
+ *     handlers: {
+ *         userUpdated: ({ userId }) => console.log(userId),
+ *         notification: ({ message }) => console.log(message),
+ *     },
+ * });
+ *
+ * client.send('ping', {});
+ * ```
+ */
+
+/**
+ * Define a WebSocket router
+ *
+ * Combines server→client event push with client→server message handlers.
+ *
+ * @example
+ * ```typescript
+ * export const wsRouter = defineWSRouter({
+ *     events: { userUpdated, notification },
+ *     messages: {
+ *         ping: ({ ws }) => ws.send('pong', {}),
+ *         'chat.send': ({ payload, subject }) => handleChat(payload, subject),
+ *     },
+ * });
+ * ```
+ */
+declare function defineWSRouter<TEvents extends Record<string, EventDef<any>>, TMessages extends WSMessageHandlers = WSMessageHandlers>(def: {
+    events: TEvents;
+    messages?: TMessages;
+}): WSRouterDef<TEvents, TMessages>;
+
+export { WSHandlerConfig, WSMessageHandlers, WSRouterDef, attachWSHandler, defineWSRouter };