@forinda/kickjs-ws 7.2.2 → 7.2.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,5 +1,5 @@
1
1
 
2
- import { m as InjectionToken, s as WsAuthenticatedUser } from "./interfaces-DmgYiknr.mjs";
2
+ import { m as InjectionToken, s as WsAuthenticatedUser } from "./interfaces-yROEyB3E.mjs";
3
3
  //#region src/centrifugo.d.ts
4
4
  export interface CentrifugoClientOptions {
5
5
  /** Centrifugo base URL, e.g. `http://centrifugo:8000`. The client calls `<url>/api/<method>`. */
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.2
2
+ * @forinda/kickjs-ws v7.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{i as WS_USER_BROADCASTER}from"./interfaces-b-7CXldq.mjs";import{createHmac}from"node:crypto";import{createLogger,createToken,defineAdapter}from"@forinda/kickjs";const log=createLogger(`CentrifugoAdapter`);var CentrifugoApiError=class extends Error{method;code;constructor(method,code,message){super(`Centrifugo ${method} failed (${code}): ${message}`),this.method=method,this.code=code,this.name=`CentrifugoApiError`}};function centrifugoClient({url,apiKey,fetch:fetchImpl=globalThis.fetch,timeoutMs=1e4}){let base=url.replace(/\/+$/,``),call=async(method,body)=>{let res=await fetchImpl(`${base}/api/${method}`,{method:`POST`,headers:{"Content-Type":`application/json`,"X-API-Key":apiKey},body:JSON.stringify(body),signal:AbortSignal.timeout(timeoutMs)});if(!res.ok)throw new CentrifugoApiError(method,res.status,res.statusText||`HTTP error`);let reply=await res.json().catch(()=>({}));if(reply.error)throw new CentrifugoApiError(method,reply.error.code,reply.error.message)};return{publish:(channel,data)=>call(`publish`,{channel,data}),broadcast:(channels,data)=>call(`broadcast`,{channels,data}),subscribe:(user,channel)=>call(`subscribe`,{user,channel}),disconnect:user=>call(`disconnect`,{user})}}const base64url=input=>Buffer.from(input).toString(`base64url`);function connectionToken({secret,sub,expiresInSeconds,info,channels}){let claims={sub};expiresInSeconds!==void 0&&(claims.exp=Math.floor(Date.now()/1e3)+expiresInSeconds),info!==void 0&&(claims.info=info),channels!==void 0&&(claims.channels=channels);let unsigned=`${base64url(JSON.stringify({alg:`HS256`,typ:`JWT`}))}.${base64url(JSON.stringify(claims))}`;return`${unsigned}.${createHmac(`sha256`,secret).update(unsigned).digest(`base64url`)}`}async function centrifugoConnect(request,resolveUser){try{let user=await resolveUser(request);return!user||!user.id?{disconnect:{code:4401,reason:`unauthorized`}}:{result:{user:String(user.id)}}}catch(err){return log.error({err},`Centrifugo connect proxy: resolveUser threw`),{error:{code:100,message:`internal server error`}}}}const CENTRIFUGO=createToken(`kick/ws/Centrifugo`),CentrifugoAdapter=defineAdapter({name:`CentrifugoAdapter`,build:options=>{let client=centrifugoClient(options),roomFor=userId=>options.personalChannelNamespace?`${options.personalChannelNamespace}:#${userId}`:`#${userId}`,broadcastToUser=(userId,event,data)=>{client.publish(roomFor(userId),{event,data}).catch(err=>log.error({err},`Centrifugo publish failed`))},broadcaster={roomFor,broadcastToUser,toUser:id=>({send:(event,data)=>broadcastToUser(id,event,data)})};return{beforeStart({container}){container.registerInstance(CENTRIFUGO,client),container.registerInstance(WS_USER_BROADCASTER,broadcaster)}}}});export{CENTRIFUGO,CentrifugoAdapter,CentrifugoApiError,centrifugoClient,centrifugoConnect,connectionToken};
11
+ import{i as WS_USER_BROADCASTER}from"./interfaces-Gcx4mGd7.mjs";import{createHmac}from"node:crypto";import{createLogger,createToken,defineAdapter}from"@forinda/kickjs";const log=createLogger(`CentrifugoAdapter`);var CentrifugoApiError=class extends Error{method;code;constructor(method,code,message){super(`Centrifugo ${method} failed (${code}): ${message}`),this.method=method,this.code=code,this.name=`CentrifugoApiError`}};function centrifugoClient({url,apiKey,fetch:fetchImpl=globalThis.fetch,timeoutMs=1e4}){let base=url.replace(/\/+$/,``),call=async(method,body)=>{let res=await fetchImpl(`${base}/api/${method}`,{method:`POST`,headers:{"Content-Type":`application/json`,"X-API-Key":apiKey},body:JSON.stringify(body),signal:AbortSignal.timeout(timeoutMs)});if(!res.ok)throw new CentrifugoApiError(method,res.status,res.statusText||`HTTP error`);let reply=await res.json().catch(()=>({}));if(reply.error)throw new CentrifugoApiError(method,reply.error.code,reply.error.message)};return{publish:(channel,data)=>call(`publish`,{channel,data}),broadcast:(channels,data)=>call(`broadcast`,{channels,data}),subscribe:(user,channel)=>call(`subscribe`,{user,channel}),disconnect:user=>call(`disconnect`,{user})}}const base64url=input=>Buffer.from(input).toString(`base64url`);function connectionToken({secret,sub,expiresInSeconds,info,channels}){let claims={sub};expiresInSeconds!==void 0&&(claims.exp=Math.floor(Date.now()/1e3)+expiresInSeconds),info!==void 0&&(claims.info=info),channels!==void 0&&(claims.channels=channels);let unsigned=`${base64url(JSON.stringify({alg:`HS256`,typ:`JWT`}))}.${base64url(JSON.stringify(claims))}`;return`${unsigned}.${createHmac(`sha256`,secret).update(unsigned).digest(`base64url`)}`}async function centrifugoConnect(request,resolveUser){try{let user=await resolveUser(request);return!user||!user.id?{disconnect:{code:4401,reason:`unauthorized`}}:{result:{user:String(user.id)}}}catch(err){return log.error({err},`Centrifugo connect proxy: resolveUser threw`),{error:{code:100,message:`internal server error`}}}}const CENTRIFUGO=createToken(`kick/ws/Centrifugo`),CentrifugoAdapter=defineAdapter({name:`CentrifugoAdapter`,build:options=>{let client=centrifugoClient(options),roomFor=userId=>options.personalChannelNamespace?`${options.personalChannelNamespace}:#${userId}`:`#${userId}`,broadcastToUser=(userId,event,data)=>{client.publish(roomFor(userId),{event,data}).catch(err=>log.error({err},`Centrifugo publish failed`))},broadcaster={roomFor,broadcastToUser,toUser:id=>({send:(event,data)=>broadcastToUser(id,event,data)})};return{beforeStart({container}){container.registerInstance(CENTRIFUGO,client),container.registerInstance(WS_USER_BROADCASTER,broadcaster)}}}});export{CENTRIFUGO,CentrifugoAdapter,CentrifugoApiError,centrifugoClient,centrifugoConnect,connectionToken};
12
12
  //# sourceMappingURL=centrifugo.mjs.map
package/dist/index.d.mts CHANGED
@@ -1,5 +1,5 @@
1
1
 
2
- import { a as WsAdapterOptions, c as WsBroker, d as WsHandlerType, f as WsUserBroadcaster, i as WS_USER_BROADCASTER, l as WsBrokerMessage, n as WS_METADATA, o as WsAuthConfig, p as RoomManager, r as WS_ROOM_MANAGER, s as WsAuthenticatedUser, t as WS_ADAPTER, u as WsHandlerDefinition } from "./interfaces-DmgYiknr.mjs";
2
+ import { a as WsAdapterOptions, c as WsBroker, d as WsHandlerType, f as WsUserBroadcaster, i as WS_USER_BROADCASTER, l as WsBrokerMessage, n as WS_METADATA, o as WsAuthConfig, p as RoomManager, r as WS_ROOM_MANAGER, s as WsAuthenticatedUser, t as WS_ADAPTER, u as WsHandlerDefinition } from "./interfaces-yROEyB3E.mjs";
3
3
  import { WebSocket, WebSocketServer } from "ws";
4
4
  import { Ref } from "@forinda/kickjs";
5
5
  import { IncomingMessage } from "node:http";
package/dist/index.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.2
2
+ * @forinda/kickjs-ws v7.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,7 +8,7 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{a as wsControllerRegistry,i as WS_USER_BROADCASTER,n as WS_METADATA,r as WS_ROOM_MANAGER,t as WS_ADAPTER}from"./interfaces-b-7CXldq.mjs";import{n as RoomManager,r as WsContext}from"./room-manager-CD-OQhwc.mjs";import{randomUUID}from"node:crypto";import{WebSocketServer}from"ws";import{Service,createLogger,defineAdapter,getClassMeta,getClassMetaOrUndefined,pushClassMeta,ref,setClassMeta}from"@forinda/kickjs";const log=createLogger(`WsAdapter`),WsAdapter=defineAdapter({name:`WsAdapter`,defaults:{path:`/ws`,heartbeatInterval:3e4},build:options=>{let basePath=options.path,heartbeatInterval=options.heartbeatInterval,maxPayload=options.maxPayload,auth=options.auth,userRoomPrefix=options.auth?.userRoomPrefix??`user:`,wss=null,container=null,namespaces=/* @__PURE__ */ new Map,heartbeatTimer=null,detachUpgrade=null,totalConnections=ref(0),activeConnections=ref(0),messagesReceived=ref(0),messagesSent=ref(0),wsErrors=ref(0),countSent=n=>{messagesSent.value+=n},broker=options.broker,origin=randomUUID(),relay=message=>{try{Promise.resolve(broker.publish(message)).catch(err=>log.error({err},`WS broker publish failed`))}catch(err){log.error({err},`WS broker publish failed`)}},relayRoom=broker?(room,event,data,exclude)=>relay({origin,room,event,data,exclude}):void 0,relayNamespace=broker?(namespace,event,data,exclude)=>relay({origin,namespace,event,data,exclude}):void 0,roomManager=new RoomManager(countSent,relayRoom),isBrokerMessage=m=>typeof m==`object`&&!!m&&typeof m.origin==`string`&&typeof m.event==`string`&&(m.exclude===void 0||typeof m.exclude==`string`)&&typeof m.room==`string`!=(typeof m.namespace==`string`)&&(m.room===void 0||typeof m.room==`string`)&&(m.namespace===void 0||typeof m.namespace==`string`),onRelayed=message=>{if(!isBrokerMessage(message)||message.origin===origin)return;let{room,namespace,event,data,exclude}=message;if(room!==void 0)return roomManager.deliver(room,event,data,exclude);let frame=JSON.stringify({event,data}),sent=0;for(let entry of namespaces.values())if(entry.namespace===namespace)for(let[id,socket]of entry.sockets)id!==exclude&&socket.readyState===socket.OPEN&&(socket.send(frame),sent++);sent&&countSent(sent)},userRoom=userId=>userRoomPrefix+userId,broadcastToUser=(userId,event,data)=>{roomManager.broadcast(userRoom(userId),event,data)},buildUserBroadcaster=()=>({roomFor:id=>userRoom(id),broadcastToUser:(id,event,data)=>broadcastToUser(id,event,data),toUser:id=>({send:(event,data)=>broadcastToUser(id,event,data)})}),getStats=()=>{let namespaceStats={};for(let[path,entry]of namespaces)namespaceStats[path]={connections:entry.sockets.size,handlers:entry.handlers.length,events:entry.handlers.flatMap(h=>h.type===`message`&&h.event?[h.event]:[])};return{totalConnections:totalConnections.value,activeConnections:activeConnections.value,messagesReceived:messagesReceived.value,messagesSent:messagesSent.value,errors:wsErrors.value,namespaces:namespaceStats,rooms:roomManager.getAllRooms()}},safeInvoke=async(controller,method,ctx)=>{try{await controller[method](ctx)}catch(err){log.error({err},`WS handler error in ${method}`)}},invokeHandlers=async(controller,handlers,type,ctx)=>{await Promise.all(handlers.filter(handler=>handler.type===type).map(handler=>safeInvoke(controller,handler.handlerName,ctx)))},authenticate=async ctx=>{if(!auth)return!0;try{let user=await auth.resolveUser(ctx.request);return ctx.socket.readyState===ctx.socket.OPEN?!user||!user.id?(ctx.socket.close(4401,`Unauthorized`),!1):(ctx.set(`user`,user),ctx.set(`userId`,user.id),auth.autoJoinUserRoom!==!1&&ctx.join(userRoom(user.id)),!0):!1}catch(err){return log.warn(`WS auth failed`,err),ctx.socket.close(4401,`Unauthorized`),!1}},handleConnection=(ws,entry,request)=>{let socketId=randomUUID();ws.__alive=!0,entry.sockets.set(socketId,ws),totalConnections.value++,activeConnections.value++;let ctx=new WsContext(ws,wss,roomManager,entry.sockets,socketId,entry.namespace,request,countSent,relayNamespace);entry.contexts.set(socketId,ctx);let controller=container.resolve(entry.controllerClass);ws.on(`pong`,()=>{ws.__alive=!0});let handleMessage=raw=>{messagesReceived.value++;try{let parsed=JSON.parse(raw.toString()),event=parsed.event,data=parsed.data;if(!event||typeof event!=`string`){ctx.send(`error`,{message:`Invalid message format: missing "event" field`});return}let messageCtx=Object.create(ctx);messageCtx.event=event,messageCtx.data=data;let handler=entry.handlers.find(h=>h.type===`message`&&h.event===event);if(handler)safeInvoke(controller,handler.handlerName,messageCtx);else{let catchAll=entry.handlers.find(h=>h.type===`message`&&h.event===`*`);catchAll&&safeInvoke(controller,catchAll.handlerName,messageCtx)}}catch{let errorCtx=Object.create(ctx);errorCtx.data={message:`Invalid JSON`},invokeHandlers(controller,entry.handlers,`error`,errorCtx)}},ready=!1,pending=[],pendingBytes=0,dropPending=()=>{pending.length=0,pendingBytes=0};ws.on(`message`,raw=>{if(ready)return handleMessage(raw);let size=typeof raw==`string`?Buffer.byteLength(raw):raw.length;pending.length>=64||pendingBytes+size>1048576?(dropPending(),ws.close(1008,`Too many messages before connect`)):(pending.push(raw),pendingBytes+=size)}),(auth?authenticate(ctx):Promise.resolve(!0)).then(async ok=>{if(!ok||ws.readyState!==ws.OPEN||(await invokeHandlers(controller,entry.handlers,`connect`,ctx),ws.readyState!==ws.OPEN))return dropPending();ready=!0;for(let raw of pending.splice(0))handleMessage(raw);pendingBytes=0}),ws.on(`close`,()=>{dropPending(),activeConnections.value--,invokeHandlers(controller,entry.handlers,`disconnect`,ctx),roomManager.leaveAll(socketId),entry.sockets.delete(socketId),entry.contexts.delete(socketId)}),ws.on(`error`,err=>{wsErrors.value++;let errorCtx=Object.create(ctx);errorCtx.data={message:err.message,name:err.name},invokeHandlers(controller,entry.handlers,`error`,errorCtx)})};return{getStats,userRoom,broadcastToUser,totalConnections,activeConnections,messagesReceived,messagesSent,wsErrors,async beforeStart({container:containerArg}){container=containerArg,container.registerInstance(WS_ADAPTER,{getStats,userRoom,broadcastToUser,totalConnections,activeConnections,messagesReceived,messagesSent,wsErrors}),container.registerInstance(WS_ROOM_MANAGER,roomManager),container.registerInstance(WS_USER_BROADCASTER,buildUserBroadcaster());for(let controllerClass of wsControllerRegistry){let namespace=getClassMetaOrUndefined(WS_METADATA.WS_CONTROLLER,controllerClass);if(namespace===void 0)continue;let handlers=getClassMeta(WS_METADATA.WS_HANDLERS,controllerClass,[]),fullPath=basePath+(namespace===`/`?``:namespace);namespaces.set(fullPath,{namespace,controllerClass,handlers,sockets:/* @__PURE__ */ new Map,contexts:/* @__PURE__ */ new Map}),log.info(`Registered WS namespace: ${fullPath} (${controllerClass.name})`)}broker&&await broker.subscribe(onRelayed)},afterStart({server}){if(!server)return;wss=new WebSocketServer({noServer:!0,maxPayload});let onUpgrade=(request,socket,head)=>{let pathname=(request.url||`/`).split(`?`)[0],entry=namespaces.get(pathname);if(entry)wss.handleUpgrade(request,socket,head,ws=>{handleConnection(ws,entry,request)});else{if(server.listenerCount(`upgrade`)>1)return;socket.write(`HTTP/1.1 404 Not Found\r
11
+ import{a as wsControllerRegistry,i as WS_USER_BROADCASTER,n as WS_METADATA,r as WS_ROOM_MANAGER,t as WS_ADAPTER}from"./interfaces-Gcx4mGd7.mjs";import{n as RoomManager,r as WsContext}from"./room-manager-BOWZ_xdd.mjs";import{randomUUID}from"node:crypto";import{WebSocketServer}from"ws";import{Service,createLogger,defineAdapter,getClassMeta,getClassMetaOrUndefined,pushClassMeta,ref,setClassMeta}from"@forinda/kickjs";const log=createLogger(`WsAdapter`),WsAdapter=defineAdapter({name:`WsAdapter`,defaults:{path:`/ws`,heartbeatInterval:3e4},build:options=>{let basePath=options.path,heartbeatInterval=options.heartbeatInterval,maxPayload=options.maxPayload,auth=options.auth,userRoomPrefix=options.auth?.userRoomPrefix??`user:`,wss=null,container=null,namespaces=/* @__PURE__ */ new Map,heartbeatTimer=null,detachUpgrade=null,totalConnections=ref(0),activeConnections=ref(0),messagesReceived=ref(0),messagesSent=ref(0),wsErrors=ref(0),countSent=n=>{messagesSent.value+=n},broker=options.broker,origin=randomUUID(),relay=message=>{try{Promise.resolve(broker.publish(message)).catch(err=>log.error({err},`WS broker publish failed`))}catch(err){log.error({err},`WS broker publish failed`)}},relayRoom=broker?(room,event,data,exclude)=>relay({origin,room,event,data,exclude}):void 0,relayNamespace=broker?(namespace,event,data,exclude)=>relay({origin,namespace,event,data,exclude}):void 0,roomManager=new RoomManager(countSent,relayRoom),isBrokerMessage=m=>typeof m==`object`&&!!m&&typeof m.origin==`string`&&typeof m.event==`string`&&(m.exclude===void 0||typeof m.exclude==`string`)&&typeof m.room==`string`!=(typeof m.namespace==`string`)&&(m.room===void 0||typeof m.room==`string`)&&(m.namespace===void 0||typeof m.namespace==`string`),onRelayed=message=>{if(!isBrokerMessage(message)||message.origin===origin)return;let{room,namespace,event,data,exclude}=message;if(room!==void 0)return roomManager.deliver(room,event,data,exclude);let frame=JSON.stringify({event,data}),sent=0;for(let entry of namespaces.values())if(entry.namespace===namespace)for(let[id,socket]of entry.sockets)id!==exclude&&socket.readyState===socket.OPEN&&(socket.send(frame),sent++);sent&&countSent(sent)},userRoom=userId=>userRoomPrefix+userId,broadcastToUser=(userId,event,data)=>{roomManager.broadcast(userRoom(userId),event,data)},buildUserBroadcaster=()=>({roomFor:id=>userRoom(id),broadcastToUser:(id,event,data)=>broadcastToUser(id,event,data),toUser:id=>({send:(event,data)=>broadcastToUser(id,event,data)})}),getStats=()=>{let namespaceStats={};for(let[path,entry]of namespaces)namespaceStats[path]={connections:entry.sockets.size,handlers:entry.handlers.length,events:entry.handlers.flatMap(h=>h.type===`message`&&h.event?[h.event]:[])};return{totalConnections:totalConnections.value,activeConnections:activeConnections.value,messagesReceived:messagesReceived.value,messagesSent:messagesSent.value,errors:wsErrors.value,namespaces:namespaceStats,rooms:roomManager.getAllRooms()}},safeInvoke=async(controller,method,ctx)=>{try{await controller[method](ctx)}catch(err){log.error({err},`WS handler error in ${method}`)}},invokeHandlers=async(controller,handlers,type,ctx)=>{await Promise.all(handlers.filter(handler=>handler.type===type).map(handler=>safeInvoke(controller,handler.handlerName,ctx)))},authenticate=async ctx=>{if(!auth)return!0;try{let user=await auth.resolveUser(ctx.request);return ctx.socket.readyState===ctx.socket.OPEN?!user||!user.id?(ctx.socket.close(4401,`Unauthorized`),!1):(ctx.set(`user`,user),ctx.set(`userId`,user.id),auth.autoJoinUserRoom!==!1&&ctx.join(userRoom(user.id)),!0):!1}catch(err){return log.warn(`WS auth failed`,err),ctx.socket.close(4401,`Unauthorized`),!1}},handleConnection=(ws,entry,request)=>{let socketId=randomUUID();ws.__alive=!0,entry.sockets.set(socketId,ws),totalConnections.value++,activeConnections.value++;let ctx=new WsContext(ws,wss,roomManager,entry.sockets,socketId,entry.namespace,request,countSent,relayNamespace);entry.contexts.set(socketId,ctx);let controller=container.resolve(entry.controllerClass);ws.on(`pong`,()=>{ws.__alive=!0});let handleMessage=raw=>{messagesReceived.value++;try{let parsed=JSON.parse(raw.toString()),event=parsed.event,data=parsed.data;if(!event||typeof event!=`string`){ctx.send(`error`,{message:`Invalid message format: missing "event" field`});return}let messageCtx=Object.create(ctx);messageCtx.event=event,messageCtx.data=data;let handler=entry.handlers.find(h=>h.type===`message`&&h.event===event);if(handler)safeInvoke(controller,handler.handlerName,messageCtx);else{let catchAll=entry.handlers.find(h=>h.type===`message`&&h.event===`*`);catchAll&&safeInvoke(controller,catchAll.handlerName,messageCtx)}}catch{let errorCtx=Object.create(ctx);errorCtx.data={message:`Invalid JSON`},invokeHandlers(controller,entry.handlers,`error`,errorCtx)}},ready=!1,pending=[],pendingBytes=0,dropPending=()=>{pending.length=0,pendingBytes=0};ws.on(`message`,raw=>{if(ready)return handleMessage(raw);let size=typeof raw==`string`?Buffer.byteLength(raw):raw.length;pending.length>=64||pendingBytes+size>1048576?(dropPending(),ws.close(1008,`Too many messages before connect`)):(pending.push(raw),pendingBytes+=size)}),(auth?authenticate(ctx):Promise.resolve(!0)).then(async ok=>{if(!ok||ws.readyState!==ws.OPEN||(await invokeHandlers(controller,entry.handlers,`connect`,ctx),ws.readyState!==ws.OPEN))return dropPending();ready=!0;for(let raw of pending.splice(0))handleMessage(raw);pendingBytes=0}),ws.on(`close`,()=>{dropPending(),activeConnections.value--,invokeHandlers(controller,entry.handlers,`disconnect`,ctx),roomManager.leaveAll(socketId),entry.sockets.delete(socketId),entry.contexts.delete(socketId)}),ws.on(`error`,err=>{wsErrors.value++;let errorCtx=Object.create(ctx);errorCtx.data={message:err.message,name:err.name},invokeHandlers(controller,entry.handlers,`error`,errorCtx)})};return{getStats,userRoom,broadcastToUser,totalConnections,activeConnections,messagesReceived,messagesSent,wsErrors,async beforeStart({container:containerArg}){container=containerArg,container.registerInstance(WS_ADAPTER,{getStats,userRoom,broadcastToUser,totalConnections,activeConnections,messagesReceived,messagesSent,wsErrors}),container.registerInstance(WS_ROOM_MANAGER,roomManager),container.registerInstance(WS_USER_BROADCASTER,buildUserBroadcaster());for(let controllerClass of wsControllerRegistry){let namespace=getClassMetaOrUndefined(WS_METADATA.WS_CONTROLLER,controllerClass);if(namespace===void 0)continue;let handlers=getClassMeta(WS_METADATA.WS_HANDLERS,controllerClass,[]),fullPath=basePath+(namespace===`/`?``:namespace);namespaces.set(fullPath,{namespace,controllerClass,handlers,sockets:/* @__PURE__ */ new Map,contexts:/* @__PURE__ */ new Map}),log.info(`Registered WS namespace: ${fullPath} (${controllerClass.name})`)}broker&&await broker.subscribe(onRelayed)},afterStart({server}){if(!server)return;wss=new WebSocketServer({noServer:!0,maxPayload});let onUpgrade=(request,socket,head)=>{let pathname=(request.url||`/`).split(`?`)[0],entry=namespaces.get(pathname);if(entry)wss.handleUpgrade(request,socket,head,ws=>{handleConnection(ws,entry,request)});else{if(server.listenerCount(`upgrade`)>1)return;socket.write(`HTTP/1.1 404 Not Found\r
12
12
  \r
13
13
  `),socket.destroy()}};server.on(`upgrade`,onUpgrade),detachUpgrade=()=>server.off(`upgrade`,onUpgrade),heartbeatInterval>0&&(heartbeatTimer=setInterval(()=>{for(let[,entry]of namespaces)for(let[,socket]of entry.sockets)socket.__alive===!1?socket.terminate():(socket.__alive=!1,socket.ping())},heartbeatInterval));let totalHandlers=Array.from(namespaces.values()).reduce((sum,e)=>sum+e.handlers.length,0);log.info(`WebSocket ready — ${namespaces.size} namespace(s), ${totalHandlers} handler(s)`)},async shutdown(){heartbeatTimer&&clearInterval(heartbeatTimer);for(let[,entry]of namespaces){for(let[,socket]of entry.sockets)socket.close(1001,`Server shutting down`);entry.sockets.clear(),entry.contexts.clear()}detachUpgrade?.(),detachUpgrade=null,wss?.close(),await broker?.close?.()}}}});function WsController(namespace){return target=>{Service()(target),setClassMeta(WS_METADATA.WS_CONTROLLER,namespace||`/`,target),wsControllerRegistry.add(target)}}function createWsHandlerDecorator(type,event){return()=>(target,propertyKey)=>{pushClassMeta(WS_METADATA.WS_HANDLERS,target.constructor,{type,event,handlerName:propertyKey})}}const OnConnect=createWsHandlerDecorator(`connect`),OnDisconnect=createWsHandlerDecorator(`disconnect`),OnError=createWsHandlerDecorator(`error`);function OnMessage(event){return(target,propertyKey)=>{pushClassMeta(WS_METADATA.WS_HANDLERS,target.constructor,{type:`message`,event,handlerName:propertyKey})}}export{OnConnect,OnDisconnect,OnError,OnMessage,RoomManager,WS_ADAPTER,WS_METADATA,WS_ROOM_MANAGER,WS_USER_BROADCASTER,WsAdapter,WsContext,WsController};
14
14
  //# sourceMappingURL=index.mjs.map
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.2
2
+ * @forinda/kickjs-ws v7.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -9,4 +9,4 @@
9
9
  * @license MIT
10
10
  */
11
11
  import{createToken}from"@forinda/kickjs";const WS_METADATA={WS_CONTROLLER:`kick/ws/controller`,WS_HANDLERS:`kick/ws/handlers`},WS_ADAPTER=createToken(`kick/ws/Adapter`),WS_ROOM_MANAGER=createToken(`kick/ws/RoomManager`),WS_USER_BROADCASTER=createToken(`kick/ws/UserBroadcaster`),wsControllerRegistry=/* @__PURE__ */ new Set;export{wsControllerRegistry as a,WS_USER_BROADCASTER as i,WS_METADATA as n,WS_ROOM_MANAGER as r,WS_ADAPTER as t};
12
- //# sourceMappingURL=interfaces-b-7CXldq.mjs.map
12
+ //# sourceMappingURL=interfaces-Gcx4mGd7.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"interfaces-b-7CXldq.mjs","names":[],"sources":["../src/interfaces.ts"],"sourcesContent":["import type { IncomingMessage } from 'node:http'\nimport { createToken } from '@forinda/kickjs'\nimport type { RoomManager } from './room-manager'\n\ntype Constructor = new (...args: any[]) => any\n\n// String metadata keys (post-Symbol migration). Slash-delimited under\n// `kick/ws/` for consistency with other framework decorators and to keep\n// Reflect.metadata storage collision-safe.\nexport const WS_METADATA = {\n WS_CONTROLLER: 'kick/ws/controller',\n WS_HANDLERS: 'kick/ws/handlers',\n} as const\n\nexport type WsHandlerType = 'connect' | 'disconnect' | 'message' | 'error'\n\nexport interface WsHandlerDefinition {\n type: WsHandlerType\n /** Event name — only for 'message' type */\n event?: string\n /** Method name on the controller class */\n handlerName: string\n}\n\n/**\n * Resolved principal returned from {@link WsAuthConfig.resolveUser}. Only `id`\n * is required. The whole object is stored on the `WsContext` as `user`, and\n * `id` alone as `userId` — read them with `ctx.get('user')` / `ctx.get('userId')`.\n */\nexport interface WsAuthenticatedUser {\n id: string\n [key: string]: unknown\n}\n\nexport interface WsAuthConfig {\n /**\n * Resolve a user from the upgrade request. Called once per socket, before\n * any `@OnConnect` handler fires. Return `null` or throw to reject.\n *\n * A rejected socket is accepted and then closed with code `4401` — a\n * WebSocket close code, not an HTTP status. Browsers do not expose a failed\n * handshake's status to script, so a close code is what a client can act on.\n *\n * Messages the client sends before this settles are held and delivered once\n * `@OnConnect` has settled, up to 64 messages or 1 MiB; beyond either the socket is\n * closed with `1008`. A socket that closes while this runs never reaches\n * `@OnConnect` or its user room.\n *\n * `handshakeAuth` is Socket.IO only: the payload of the client's `auth`\n * option (`io(url, { auth: { token } })`) — the usual place for a token,\n * since a browser cannot set headers on a WebSocket. `WsAdapter` omits it.\n */\n resolveUser: (\n request: IncomingMessage,\n handshakeAuth?: Record<string, unknown>,\n ) => Promise<WsAuthenticatedUser | null> | WsAuthenticatedUser | null\n /**\n * Join each authenticated socket to `user:<id>` as soon as `resolveUser`\n * resolves (default: `true` — pass `false` to opt out). Pairs with\n * {@link WsUserBroadcaster}.\n */\n autoJoinUserRoom?: boolean\n /**\n * Room name prefix for per-user broadcasting (default: `'user:'`).\n * Must match what `@forinda/kickjs-ws`'s `WsUserBroadcaster` targets.\n */\n userRoomPrefix?: string\n}\n\nexport interface WsAdapterOptions {\n /** Base path for WebSocket upgrade (default: '/ws') */\n path?: string\n /** Heartbeat ping interval in ms (default: 30000). Set to 0 to disable. */\n heartbeatInterval?: number\n /** Maximum message payload size in bytes */\n maxPayload?: number\n /** Optional authenticated-handshake configuration. */\n auth?: WsAuthConfig\n /**\n * Relays broadcasts between instances. Without one, rooms, namespace\n * broadcasts and per-user sends reach sockets in this process only.\n * Use `redisBroker` from `@forinda/kickjs-ws/redis`, or implement\n * {@link WsBroker} over any pub/sub.\n */\n broker?: WsBroker\n}\n\n/** A broadcast relayed between instances. Exactly one of `room` / `namespace` is set. */\nexport type WsBrokerMessage = {\n /** Id of the publishing instance — each instance skips its own messages. */\n origin: string\n event: string\n data: unknown\n /** Socket id that must not receive it (the sender of `ctx.broadcast`). */\n exclude?: string\n} & (\n | {\n /** Room broadcast: `ctx.to(room)`, `WS_ROOM_MANAGER`, per-user sends. */\n room: string\n namespace?: never\n }\n | {\n /** Namespace broadcast: `ctx.broadcast()` / `ctx.broadcastAll()`. */\n namespace: string\n room?: never\n }\n)\n\n/**\n * Cross-instance pub/sub for {@link WsAdapter}. The adapter delivers every\n * broadcast to its own sockets immediately, then publishes it; other\n * instances deliver it to theirs. `data` must be JSON-serialisable — it\n * already is, since it is sent to clients as JSON.\n */\nexport interface WsBroker {\n /**\n * Called synchronously from the broadcasting handler. Serialise `message`\n * before the first `await`: the handler may mutate `data` afterwards, and\n * local sockets already received the value as it was.\n */\n publish(message: WsBrokerMessage): void | Promise<void>\n /** Called once from the adapter's `beforeStart`; startup waits for it. */\n subscribe(onMessage: (message: WsBrokerMessage) => void): void | Promise<void>\n /** Called from the adapter's `shutdown`. Connections the caller passed in stay theirs to close. */\n close?(): void | Promise<void>\n}\n\n/**\n * Per-user broadcasting across all WS namespaces. Always registered on the DI\n * container. With {@link WsAdapterOptions.auth} sockets join `user:<id>`\n * automatically; without it a controller can join the room manually and the\n * helper works the same.\n *\n * Reaches sockets in this process only, unless the adapter has a\n * {@link WsAdapterOptions.broker}.\n */\nexport interface WsUserBroadcaster {\n /** Send a single event to every socket bound to this user. */\n toUser(userId: string): { send(event: string, data: unknown): void }\n /** Convenience — `toUser(id).send(event, data)` in one call. */\n broadcastToUser(userId: string, event: string, data: unknown): void\n /** Room name for a given user (respects `userRoomPrefix`). */\n roomFor(userId: string): string\n}\n\n/** DI token for the live {@link WsAdapter} instance. */\nexport const WS_ADAPTER = createToken<unknown>('kick/ws/Adapter')\n/** DI token for the shared {@link RoomManager}. */\nexport const WS_ROOM_MANAGER = createToken<RoomManager>('kick/ws/RoomManager')\n/** DI token for the per-user broadcaster helper. */\nexport const WS_USER_BROADCASTER = createToken<WsUserBroadcaster>('kick/ws/UserBroadcaster')\n\n/** Registry of all @WsController classes — populated at decorator time */\nexport const wsControllerRegistry = new Set<Constructor>()\n"],"mappings":";;;;;;;;;;yCASA,MAAa,YAAc,CACzB,cAAe,qBACf,YAAa,kBACf,EAsIa,WAAa,YAAqB,iBAAiB,EAEnD,gBAAkB,YAAyB,qBAAqB,EAEhE,oBAAsB,YAA+B,yBAAyB,EAG9E,qCAAuB,IAAI"}
1
+ {"version":3,"file":"interfaces-Gcx4mGd7.mjs","names":[],"sources":["../src/interfaces.ts"],"sourcesContent":["import type { IncomingMessage } from 'node:http'\nimport { createToken } from '@forinda/kickjs'\nimport type { RoomManager } from './room-manager'\n\ntype Constructor = new (...args: any[]) => any\n\n// String metadata keys (post-Symbol migration). Slash-delimited under\n// `kick/ws/` for consistency with other framework decorators and to keep\n// Reflect.metadata storage collision-safe.\nexport const WS_METADATA = {\n WS_CONTROLLER: 'kick/ws/controller',\n WS_HANDLERS: 'kick/ws/handlers',\n} as const\n\nexport type WsHandlerType = 'connect' | 'disconnect' | 'message' | 'error'\n\nexport interface WsHandlerDefinition {\n type: WsHandlerType\n /** Event name — only for 'message' type */\n event?: string\n /** Method name on the controller class */\n handlerName: string\n}\n\n/**\n * Resolved principal returned from {@link WsAuthConfig.resolveUser}. Only `id`\n * is required. The whole object is stored on the `WsContext` as `user`, and\n * `id` alone as `userId` — read them with `ctx.get('user')` / `ctx.get('userId')`.\n */\nexport interface WsAuthenticatedUser {\n id: string\n [key: string]: unknown\n}\n\nexport interface WsAuthConfig {\n /**\n * Resolve a user from the upgrade request. Called once per socket, before\n * any `@OnConnect` handler fires. Return `null` or throw to reject.\n *\n * A rejected socket is accepted and then closed with code `4401` — a\n * WebSocket close code, not an HTTP status. Browsers do not expose a failed\n * handshake's status to script, so a close code is what a client can act on.\n *\n * Messages the client sends before this settles are held and delivered once\n * `@OnConnect` has settled, up to 64 messages or 1 MiB; beyond either the socket is\n * closed with `1008`. A socket that closes while this runs never reaches\n * `@OnConnect` or its user room.\n *\n * `handshakeAuth` is Socket.IO only: the payload of the client's `auth`\n * option (`io(url, { auth: { token } })`) — the usual place for a token,\n * since a browser cannot set headers on a WebSocket. `WsAdapter` omits it.\n */\n resolveUser: (\n request: IncomingMessage,\n handshakeAuth?: Record<string, unknown>,\n ) => Promise<WsAuthenticatedUser | null> | WsAuthenticatedUser | null\n /**\n * Join each authenticated socket to `user:<id>` as soon as `resolveUser`\n * resolves (default: `true` — pass `false` to opt out). Pairs with\n * {@link WsUserBroadcaster}.\n */\n autoJoinUserRoom?: boolean\n /**\n * Room name prefix for per-user broadcasting (default: `'user:'`).\n * Must match what `@forinda/kickjs-ws`'s `WsUserBroadcaster` targets.\n */\n userRoomPrefix?: string\n}\n\nexport interface WsAdapterOptions {\n /** Base path for WebSocket upgrade (default: '/ws') */\n path?: string\n /** Heartbeat ping interval in ms (default: 30000). Set to 0 to disable. */\n heartbeatInterval?: number\n /** Maximum message payload size in bytes */\n maxPayload?: number\n /** Optional authenticated-handshake configuration. */\n auth?: WsAuthConfig\n /**\n * Relays broadcasts between instances. Without one, rooms, namespace\n * broadcasts and per-user sends reach sockets in this process only.\n * Use `redisBroker` from `@forinda/kickjs-ws/redis`, or implement\n * {@link WsBroker} over any pub/sub.\n */\n broker?: WsBroker\n}\n\n/** A broadcast relayed between instances. Exactly one of `room` / `namespace` is set. */\nexport type WsBrokerMessage = {\n /** Id of the publishing instance — each instance skips its own messages. */\n origin: string\n event: string\n data: unknown\n /** Socket id that must not receive it (the sender of `ctx.broadcast`). */\n exclude?: string\n} & (\n | {\n /** Room broadcast: `ctx.to(room)`, `WS_ROOM_MANAGER`, per-user sends. */\n room: string\n namespace?: never\n }\n | {\n /** Namespace broadcast: `ctx.broadcast()` / `ctx.broadcastAll()`. */\n namespace: string\n room?: never\n }\n)\n\n/**\n * Cross-instance pub/sub for {@link WsAdapter}. The adapter delivers every\n * broadcast to its own sockets immediately, then publishes it; other\n * instances deliver it to theirs. `data` must be JSON-serialisable — it\n * already is, since it is sent to clients as JSON.\n */\nexport interface WsBroker {\n /**\n * Called synchronously from the broadcasting handler. Serialise `message`\n * before the first `await`: the handler may mutate `data` afterwards, and\n * local sockets already received the value as it was.\n */\n publish(message: WsBrokerMessage): void | Promise<void>\n /** Called once from the adapter's `beforeStart`; startup waits for it. */\n subscribe(onMessage: (message: WsBrokerMessage) => void): void | Promise<void>\n /** Called from the adapter's `shutdown`. Connections the caller passed in stay theirs to close. */\n close?(): void | Promise<void>\n}\n\n/**\n * Per-user broadcasting across all WS namespaces. Always registered on the DI\n * container. With {@link WsAdapterOptions.auth} sockets join `user:<id>`\n * automatically; without it a controller can join the room manually and the\n * helper works the same.\n *\n * Reaches sockets in this process only, unless the adapter has a\n * {@link WsAdapterOptions.broker}.\n */\nexport interface WsUserBroadcaster {\n /** Send a single event to every socket bound to this user. */\n toUser(userId: string): { send(event: string, data: unknown): void }\n /** Convenience — `toUser(id).send(event, data)` in one call. */\n broadcastToUser(userId: string, event: string, data: unknown): void\n /** Room name for a given user (respects `userRoomPrefix`). */\n roomFor(userId: string): string\n}\n\n/** DI token for the live {@link WsAdapter} instance. */\nexport const WS_ADAPTER = createToken<unknown>('kick/ws/Adapter')\n/** DI token for the shared {@link RoomManager}. */\nexport const WS_ROOM_MANAGER = createToken<RoomManager>('kick/ws/RoomManager')\n/** DI token for the per-user broadcaster helper. */\nexport const WS_USER_BROADCASTER = createToken<WsUserBroadcaster>('kick/ws/UserBroadcaster')\n\n/** Registry of all @WsController classes — populated at decorator time */\nexport const wsControllerRegistry = new Set<Constructor>()\n"],"mappings":";;;;;;;;;;yCASA,MAAa,YAAc,CACzB,cAAe,qBACf,YAAa,kBACf,EAsIa,WAAa,YAAqB,iBAAiB,EAEnD,gBAAkB,YAAyB,qBAAqB,EAEhE,oBAAsB,YAA+B,yBAAyB,EAG9E,qCAAuB,IAAI"}
@@ -19,7 +19,7 @@ import { IncomingMessage } from "node:http";
19
19
  *
20
20
  * ## Hardening layers
21
21
  *
22
- * KickJS has four DI token kinds, listed from safest to riskiest:
22
+ * The container takes four kinds of token, listed from safest to riskiest:
23
23
  *
24
24
  * 1. **Class identity** — `container.resolve(UserService)`. Reference
25
25
  * equality, never collides. Type-safe via `Constructor<T>` overload.
@@ -45,15 +45,14 @@ import { IncomingMessage } from "node:http";
45
45
  * const url = container.resolve(DATABASE_URL) // typed as `string`
46
46
  * ```
47
47
  *
48
- * @module @forinda/kickjs/core/token
48
+ * @module @forinda/kickjs-di/token
49
49
  */
50
50
  /**
51
51
  * Symbol marker stamped on every InjectionToken so the container can
52
52
  * detect them at runtime regardless of which package created them.
53
53
  *
54
- * Uses `Symbol.for()` so cross-package isolation (different copies of
55
- * `@forinda/kickjs` loaded under different module identities) still
56
- * shares the same marker.
54
+ * Uses `Symbol.for()` so two copies of this package loaded under
55
+ * different module identities still share the same marker.
57
56
  */
58
57
  declare const INJECTION_TOKEN: unique symbol;
59
58
  /**
@@ -73,15 +72,10 @@ interface InjectionToken<T> {
73
72
  readonly _type?: T;
74
73
  }
75
74
  /**
76
- * Global ambient registry of typed environment variables, populated by
77
- * `kick typegen` from the project's env schema (typically
78
- * `src/env.ts`'s `export default defineEnv(...)`).
79
- *
80
- * Empty by default — declarations come from `.kickjs/types/env.ts`
81
- * generated alongside the rest of the typegen output. Once populated,
82
- * `@Value('PORT')` autocompletes the key, type-checks the default
83
- * value, and `process.env.PORT` is also typed via the parallel
84
- * `NodeJS.ProcessEnv` augmentation in the same generated file.
75
+ * Global ambient registry of typed environment variables. Empty by default;
76
+ * declare your keys to have `@Value('PORT')` autocomplete the key and
77
+ * type-check its default. In KickJS, `kick typegen` writes it from the env
78
+ * schema.
85
79
  */
86
80
  declare global {
87
81
  interface KickEnv {}
@@ -253,4 +247,4 @@ declare const WS_ROOM_MANAGER: InjectionToken<RoomManager>;
253
247
  declare const WS_USER_BROADCASTER: InjectionToken<WsUserBroadcaster>;
254
248
  //#endregion
255
249
  export { WsAdapterOptions as a, WsBroker as c, WsHandlerType as d, WsUserBroadcaster as f, WS_USER_BROADCASTER as i, WsBrokerMessage as l, InjectionToken as m, WS_METADATA as n, WsAuthConfig as o, RoomManager as p, WS_ROOM_MANAGER as r, WsAuthenticatedUser as s, WS_ADAPTER as t, WsHandlerDefinition as u };
256
- //# sourceMappingURL=interfaces-DmgYiknr.d.mts.map
250
+ //# sourceMappingURL=interfaces-yROEyB3E.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"interfaces-yROEyB3E.d.mts","names":["_$_forinda_kickjs_di0.InjectionToken"],"sources":["../../di/dist/index.d.mts","../src/room-manager.ts","../src/interfaces.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAiJqB;;;;;;;;;;UAUX,eAAe;YACb;;WAED;;WAEA,QAAQ;;;;;;;;QAqdX;YACI;;;;cCnmBC;mBAMQ;mBACA;;;;;EAFnB,YACmB,WAAU,qCACV,gBACf,cACA,eACA,WACA;;UAKI;;UAEA;;;;;;;;EASR,KAAK,kBAAkB,QAAQ,WAAW;EAmB1C,MAAM,kBAAkB;;EAWxB,SAAS;EAaT,SAAS;EAIT,WAAW,eAAe,YAAY;;EAKtC,eAAe;;EASf,UAAU,cAAc,eAAe,WAAW;;EAMlD,QAAQ,cAAc,eAAe,WAAW;;;;cCxGrC;WACX;WACA;;KAGU;UAEK;EACf,MAAM;;EAEN;;EAEA;;;;;;;UAQe;EACf;GACC;;UAGc;;;;;;;;;;;;;;;;;;EAkBf,cACE,SAAS,iBACT,gBAAgB,4BACb,QAAQ,8BAA8B;;;;;;EAM3C;;;;;EAKA;;UAGe;;EAEf;;EAEA;;EAEA;;EAEA,OAAO;;;;;;;EAOP,SAAS;;;KAIC;;EAEV;EACA;EACA;;EAEA;;;EAII;EACA;;;EAIA;EACA;;;;;;;;UAUW;;;;;;EAMf,QAAQ,SAAS,yBAAyB;;EAE1C,UAAU,YAAY,SAAS,kCAAkC;;EAEjE,iBAAiB;;;;;;;;;;;UAYF;;EAEf,OAAO;IAAmB,KAAK,eAAe;;;EAE9C,gBAAgB,gBAAgB,eAAe;;EAE/C,QAAQ;;;cAIG,YAAAA;;cAEA,iBAAeA,eAAA;;cAEf,qBAAmBA,eAAA"}
package/dist/redis.d.mts CHANGED
@@ -1,5 +1,5 @@
1
1
 
2
- import { c as WsBroker } from "./interfaces-DmgYiknr.mjs";
2
+ import { c as WsBroker } from "./interfaces-yROEyB3E.mjs";
3
3
  //#region src/redis.d.ts
4
4
  /** The part of a Redis client the broker calls. An ioredis client fits as-is. */
5
5
  export interface RedisPubSubClient {
package/dist/redis.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.2
2
+ * @forinda/kickjs-ws v7.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.2
2
+ * @forinda/kickjs-ws v7.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -9,4 +9,4 @@
9
9
  * @license MIT
10
10
  */
11
11
  function parseCookies(header){if(!header)return{};let out={};for(let part of header.split(`;`)){let idx=part.indexOf(`=`);if(idx===-1)continue;let k=part.slice(0,idx).trim(),v=part.slice(idx+1).trim();if(k)try{out[k]=decodeURIComponent(v)}catch{out[k]=v}}return out}var WsContext=class{socket;server;roomManager;namespaceSockets;onSend;onBroadcast;id;data;event;namespace;request;metadata=/* @__PURE__ */ new Map;constructor(socket,server,roomManager,namespaceSockets,id,namespace,request,onSend,onBroadcast){this.socket=socket,this.server=server,this.roomManager=roomManager,this.namespaceSockets=namespaceSockets,this.onSend=onSend,this.onBroadcast=onBroadcast,this.id=id,this.namespace=namespace,this.request=request,this.data=null,this.event=``}get cookies(){return parseCookies(this.request.headers.cookie)}get(key){return this.metadata.get(key)}set(key,value){this.metadata.set(key,value)}send(event,data){this.socket.readyState===this.socket.OPEN&&(this.socket.send(JSON.stringify({event,data})),this.onSend?.(1))}broadcast(event,data){let message=JSON.stringify({event,data}),sent=0;for(let[id,socket]of this.namespaceSockets)id!==this.id&&socket.readyState===socket.OPEN&&(socket.send(message),sent++);sent&&this.onSend?.(sent),this.onBroadcast?.(this.namespace,event,data,this.id)}broadcastAll(event,data){let message=JSON.stringify({event,data}),sent=0;for(let[,socket]of this.namespaceSockets)socket.readyState===socket.OPEN&&(socket.send(message),sent++);sent&&this.onSend?.(sent),this.onBroadcast?.(this.namespace,event,data)}join(room){this.roomManager.join(this.id,this.socket,room)}leave(room){this.roomManager.leave(this.id,room)}rooms(){return this.roomManager.getRooms(this.id)}to(room){return{send:(event,data)=>{this.roomManager.broadcast(room,event,data)}}}};const MAX_ROOMS_PER_SOCKET=1e3;var RoomManager=class{onSend;onBroadcast;constructor(onSend,onBroadcast){this.onSend=onSend,this.onBroadcast=onBroadcast}socketRooms=/* @__PURE__ */ new Map;roomSockets=/* @__PURE__ */ new Map;join(socketId,socket,room){if(socket.readyState!==socket.OPEN)return;this.socketRooms.has(socketId)||this.socketRooms.set(socketId,/* @__PURE__ */ new Set);let rooms=this.socketRooms.get(socketId);if(!rooms.has(room)&&rooms.size>=1e3)throw Error(`WebSocket ${socketId} is already in ${MAX_ROOMS_PER_SOCKET} rooms; leave one before joining '${room}'`);rooms.add(room),this.roomSockets.has(room)||this.roomSockets.set(room,/* @__PURE__ */ new Map),this.roomSockets.get(room).set(socketId,socket)}leave(socketId,room){this.socketRooms.get(socketId)?.delete(room),this.roomSockets.get(room)?.delete(socketId),this.roomSockets.get(room)?.size===0&&this.roomSockets.delete(room)}leaveAll(socketId){let rooms=this.socketRooms.get(socketId);if(rooms)for(let room of rooms)this.roomSockets.get(room)?.delete(socketId),this.roomSockets.get(room)?.size===0&&this.roomSockets.delete(room);this.socketRooms.delete(socketId)}getRooms(socketId){return Array.from(this.socketRooms.get(socketId)??[])}getSockets(room){return this.roomSockets.get(room)??/* @__PURE__ */ new Map}getAllRooms(){let result={};for(let[room,sockets]of this.roomSockets)result[room]=sockets.size;return result}broadcast(room,event,data,excludeId){this.deliver(room,event,data,excludeId),this.onBroadcast?.(room,event,data,excludeId)}deliver(room,event,data,excludeId){let sockets=this.roomSockets.get(room);if(!sockets)return;let message=JSON.stringify({event,data}),sent=0;for(let[id,socket]of sockets)id!==excludeId&&socket.readyState===socket.OPEN&&(socket.send(message),sent++);sent&&this.onSend?.(sent)}};export{parseCookies as i,RoomManager as n,WsContext as r,MAX_ROOMS_PER_SOCKET as t};
12
- //# sourceMappingURL=room-manager-CD-OQhwc.mjs.map
12
+ //# sourceMappingURL=room-manager-BOWZ_xdd.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"room-manager-CD-OQhwc.mjs","names":[],"sources":["../src/ws-context.ts","../src/room-manager.ts"],"sourcesContent":["import type { IncomingMessage } from 'node:http'\nimport type { WebSocket, WebSocketServer } from 'ws'\nimport type { RoomManager } from './room-manager'\n\n/** Raw `Cookie` header parse, shared by the ws and Socket.IO contexts. */\nexport function parseCookies(header: string | undefined): Record<string, string> {\n if (!header) return {}\n const out: Record<string, string> = {}\n for (const part of header.split(';')) {\n const idx = part.indexOf('=')\n if (idx === -1) continue\n const k = part.slice(0, idx).trim()\n const v = part.slice(idx + 1).trim()\n if (!k) continue\n try {\n out[k] = decodeURIComponent(v)\n } catch {\n out[k] = v // malformed %-encoding: keep it raw rather than fail the handler\n }\n }\n return out\n}\n\n/**\n * Context object passed to WebSocket handler methods.\n * Analogous to RequestContext for HTTP controllers.\n *\n * @example\n * ```ts\n * @OnMessage('chat:send')\n * handleSend(ctx: WsContext) {\n * console.log(ctx.data) // parsed message payload\n * ctx.send('chat:ack', { ok: true })\n * ctx.broadcast('chat:receive', ctx.data)\n * ctx.join('room-1')\n * ctx.to('room-1').send('chat:receive', ctx.data)\n * }\n * ```\n */\nexport class WsContext {\n /** Unique connection ID */\n readonly id: string\n /** Parsed message payload (set for @OnMessage handlers) */\n data: any\n /** Event name from the message envelope (set for @OnMessage handlers) */\n event: string\n /** The namespace this connection belongs to */\n readonly namespace: string\n /** The HTTP upgrade request — available from @OnConnect onward. Use to read\n * cookies, headers, query string, and client IP for authenticated handshakes. */\n readonly request: IncomingMessage\n\n private metadata = new Map<string, any>()\n\n constructor(\n readonly socket: WebSocket,\n readonly server: WebSocketServer,\n private readonly roomManager: RoomManager,\n private readonly namespaceSockets: Map<string, WebSocket>,\n id: string,\n namespace: string,\n request: IncomingMessage,\n /** Called with the number of frames each send wrote — feeds `messagesSent`. */\n private readonly onSend?: (count: number) => void,\n /** Relays namespace broadcasts to other instances when the adapter has a broker. */\n private readonly onBroadcast?: (\n namespace: string,\n event: string,\n data: any,\n excludeId?: string,\n ) => void,\n ) {\n this.id = id\n this.namespace = namespace\n this.request = request\n this.data = null\n this.event = ''\n }\n\n /** Parsed cookies from the upgrade request (raw `Cookie` header parse). */\n get cookies(): Record<string, string> {\n return parseCookies(this.request.headers.cookie)\n }\n\n /** Get a metadata value */\n get<T = any>(key: string): T | undefined {\n return this.metadata.get(key)\n }\n\n /** Set a metadata value (persists for the lifetime of the connection) */\n set(key: string, value: any): void {\n this.metadata.set(key, value)\n }\n\n /** Send a message to this socket */\n send(event: string, data: any): void {\n if (this.socket.readyState === this.socket.OPEN) {\n this.socket.send(JSON.stringify({ event, data }))\n this.onSend?.(1)\n }\n }\n\n /** Send to all sockets in the same namespace except this one */\n broadcast(event: string, data: any): void {\n const message = JSON.stringify({ event, data })\n let sent = 0\n for (const [id, socket] of this.namespaceSockets) {\n if (id !== this.id && socket.readyState === socket.OPEN) {\n socket.send(message)\n sent++\n }\n }\n if (sent) this.onSend?.(sent)\n this.onBroadcast?.(this.namespace, event, data, this.id)\n }\n\n /** Send to all sockets in the same namespace including this one */\n broadcastAll(event: string, data: any): void {\n const message = JSON.stringify({ event, data })\n let sent = 0\n for (const [, socket] of this.namespaceSockets) {\n if (socket.readyState === socket.OPEN) {\n socket.send(message)\n sent++\n }\n }\n if (sent) this.onSend?.(sent)\n this.onBroadcast?.(this.namespace, event, data)\n }\n\n /** Join a room. Names are global across namespaces — see {@link RoomManager}. */\n join(room: string): void {\n this.roomManager.join(this.id, this.socket, room)\n }\n\n /** Leave a room */\n leave(room: string): void {\n this.roomManager.leave(this.id, room)\n }\n\n /** Get all rooms this socket is in */\n rooms(): string[] {\n return this.roomManager.getRooms(this.id)\n }\n\n /** Send to all sockets in a room */\n to(room: string): { send(event: string, data: any): void } {\n return {\n send: (event: string, data: any) => {\n this.roomManager.broadcast(room, event, data)\n },\n }\n }\n}\n","import type { WebSocket } from 'ws'\n\n/**\n * Manages WebSocket room membership and broadcasting.\n * Standalone from ws/socket.io — can be swapped for socket.io's built-in rooms.\n *\n * Room names are GLOBAL, not per namespace: a room joined from `/ws/chat` and\n * one joined from `/ws/admin` with the same name are the same room. That is\n * what lets a service broadcast through `WS_ROOM_MANAGER` and lets `user:<id>`\n * reach a user's sockets in every namespace — prefix names (`chat:lobby`) when\n * namespaces must not overlap.\n *\n * Membership lives in this process only: `getSockets` and `getAllRooms`\n * describe this instance. `broadcast` reaches other instances when the adapter\n * has a broker.\n */\n// ponytail: fixed cap; raise it if an app really keeps a socket in more rooms.\nexport const MAX_ROOMS_PER_SOCKET = 1000\n\nexport class RoomManager {\n /**\n * @param onSend Called with the number of frames each broadcast wrote.\n * @param onBroadcast Relays each broadcast to other instances.\n */\n constructor(\n private readonly onSend?: (count: number) => void,\n private readonly onBroadcast?: (\n room: string,\n event: string,\n data: any,\n excludeId?: string,\n ) => void,\n ) {}\n\n /** socketId → set of room names */\n private socketRooms = new Map<string, Set<string>>()\n /** room name → set of { socketId, socket } */\n private roomSockets = new Map<string, Map<string, WebSocket>>()\n\n /**\n * Add a socket to a room. Skipped for a socket that is no longer open: a\n * handler that awaits and then joins after the client hung up would\n * otherwise leave an entry `leaveAll` (run once, on close) never removes.\n * At most {@link MAX_ROOMS_PER_SOCKET} rooms per socket — room names often\n * come from what the client sends.\n */\n join(socketId: string, socket: WebSocket, room: string): void {\n if (socket.readyState !== socket.OPEN) return\n if (!this.socketRooms.has(socketId)) {\n this.socketRooms.set(socketId, new Set())\n }\n const rooms = this.socketRooms.get(socketId)!\n if (!rooms.has(room) && rooms.size >= MAX_ROOMS_PER_SOCKET) {\n throw new Error(\n `WebSocket ${socketId} is already in ${MAX_ROOMS_PER_SOCKET} rooms; leave one before joining '${room}'`,\n )\n }\n rooms.add(room)\n\n if (!this.roomSockets.has(room)) {\n this.roomSockets.set(room, new Map())\n }\n this.roomSockets.get(room)!.set(socketId, socket)\n }\n\n leave(socketId: string, room: string): void {\n this.socketRooms.get(socketId)?.delete(room)\n this.roomSockets.get(room)?.delete(socketId)\n\n // Clean up empty rooms\n if (this.roomSockets.get(room)?.size === 0) {\n this.roomSockets.delete(room)\n }\n }\n\n /** Remove socket from all rooms (called on disconnect) */\n leaveAll(socketId: string): void {\n const rooms = this.socketRooms.get(socketId)\n if (rooms) {\n for (const room of rooms) {\n this.roomSockets.get(room)?.delete(socketId)\n if (this.roomSockets.get(room)?.size === 0) {\n this.roomSockets.delete(room)\n }\n }\n }\n this.socketRooms.delete(socketId)\n }\n\n getRooms(socketId: string): string[] {\n return Array.from(this.socketRooms.get(socketId) ?? [])\n }\n\n getSockets(room: string): Map<string, WebSocket> {\n return this.roomSockets.get(room) ?? new Map()\n }\n\n /** Get all rooms with their member counts */\n getAllRooms(): Record<string, number> {\n const result: Record<string, number> = {}\n for (const [room, sockets] of this.roomSockets) {\n result[room] = sockets.size\n }\n return result\n }\n\n /** Broadcast to all sockets in a room, optionally excluding one — on every instance when a broker is set. */\n broadcast(room: string, event: string, data: any, excludeId?: string): void {\n this.deliver(room, event, data, excludeId)\n this.onBroadcast?.(room, event, data, excludeId)\n }\n\n /** Send to this instance's members of a room only. Relayed broadcasts land here. */\n deliver(room: string, event: string, data: any, excludeId?: string): void {\n const sockets = this.roomSockets.get(room)\n if (!sockets) return\n\n const message = JSON.stringify({ event, data })\n let sent = 0\n for (const [id, socket] of sockets) {\n if (id !== excludeId && socket.readyState === socket.OPEN) {\n socket.send(message)\n sent++\n }\n }\n if (sent) this.onSend?.(sent)\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"room-manager-BOWZ_xdd.mjs","names":[],"sources":["../src/ws-context.ts","../src/room-manager.ts"],"sourcesContent":["import type { IncomingMessage } from 'node:http'\nimport type { WebSocket, WebSocketServer } from 'ws'\nimport type { RoomManager } from './room-manager'\n\n/** Raw `Cookie` header parse, shared by the ws and Socket.IO contexts. */\nexport function parseCookies(header: string | undefined): Record<string, string> {\n if (!header) return {}\n const out: Record<string, string> = {}\n for (const part of header.split(';')) {\n const idx = part.indexOf('=')\n if (idx === -1) continue\n const k = part.slice(0, idx).trim()\n const v = part.slice(idx + 1).trim()\n if (!k) continue\n try {\n out[k] = decodeURIComponent(v)\n } catch {\n out[k] = v // malformed %-encoding: keep it raw rather than fail the handler\n }\n }\n return out\n}\n\n/**\n * Context object passed to WebSocket handler methods.\n * Analogous to RequestContext for HTTP controllers.\n *\n * @example\n * ```ts\n * @OnMessage('chat:send')\n * handleSend(ctx: WsContext) {\n * console.log(ctx.data) // parsed message payload\n * ctx.send('chat:ack', { ok: true })\n * ctx.broadcast('chat:receive', ctx.data)\n * ctx.join('room-1')\n * ctx.to('room-1').send('chat:receive', ctx.data)\n * }\n * ```\n */\nexport class WsContext {\n /** Unique connection ID */\n readonly id: string\n /** Parsed message payload (set for @OnMessage handlers) */\n data: any\n /** Event name from the message envelope (set for @OnMessage handlers) */\n event: string\n /** The namespace this connection belongs to */\n readonly namespace: string\n /** The HTTP upgrade request — available from @OnConnect onward. Use to read\n * cookies, headers, query string, and client IP for authenticated handshakes. */\n readonly request: IncomingMessage\n\n private metadata = new Map<string, any>()\n\n constructor(\n readonly socket: WebSocket,\n readonly server: WebSocketServer,\n private readonly roomManager: RoomManager,\n private readonly namespaceSockets: Map<string, WebSocket>,\n id: string,\n namespace: string,\n request: IncomingMessage,\n /** Called with the number of frames each send wrote — feeds `messagesSent`. */\n private readonly onSend?: (count: number) => void,\n /** Relays namespace broadcasts to other instances when the adapter has a broker. */\n private readonly onBroadcast?: (\n namespace: string,\n event: string,\n data: any,\n excludeId?: string,\n ) => void,\n ) {\n this.id = id\n this.namespace = namespace\n this.request = request\n this.data = null\n this.event = ''\n }\n\n /** Parsed cookies from the upgrade request (raw `Cookie` header parse). */\n get cookies(): Record<string, string> {\n return parseCookies(this.request.headers.cookie)\n }\n\n /** Get a metadata value */\n get<T = any>(key: string): T | undefined {\n return this.metadata.get(key)\n }\n\n /** Set a metadata value (persists for the lifetime of the connection) */\n set(key: string, value: any): void {\n this.metadata.set(key, value)\n }\n\n /** Send a message to this socket */\n send(event: string, data: any): void {\n if (this.socket.readyState === this.socket.OPEN) {\n this.socket.send(JSON.stringify({ event, data }))\n this.onSend?.(1)\n }\n }\n\n /** Send to all sockets in the same namespace except this one */\n broadcast(event: string, data: any): void {\n const message = JSON.stringify({ event, data })\n let sent = 0\n for (const [id, socket] of this.namespaceSockets) {\n if (id !== this.id && socket.readyState === socket.OPEN) {\n socket.send(message)\n sent++\n }\n }\n if (sent) this.onSend?.(sent)\n this.onBroadcast?.(this.namespace, event, data, this.id)\n }\n\n /** Send to all sockets in the same namespace including this one */\n broadcastAll(event: string, data: any): void {\n const message = JSON.stringify({ event, data })\n let sent = 0\n for (const [, socket] of this.namespaceSockets) {\n if (socket.readyState === socket.OPEN) {\n socket.send(message)\n sent++\n }\n }\n if (sent) this.onSend?.(sent)\n this.onBroadcast?.(this.namespace, event, data)\n }\n\n /** Join a room. Names are global across namespaces — see {@link RoomManager}. */\n join(room: string): void {\n this.roomManager.join(this.id, this.socket, room)\n }\n\n /** Leave a room */\n leave(room: string): void {\n this.roomManager.leave(this.id, room)\n }\n\n /** Get all rooms this socket is in */\n rooms(): string[] {\n return this.roomManager.getRooms(this.id)\n }\n\n /** Send to all sockets in a room */\n to(room: string): { send(event: string, data: any): void } {\n return {\n send: (event: string, data: any) => {\n this.roomManager.broadcast(room, event, data)\n },\n }\n }\n}\n","import type { WebSocket } from 'ws'\n\n/**\n * Manages WebSocket room membership and broadcasting.\n * Standalone from ws/socket.io — can be swapped for socket.io's built-in rooms.\n *\n * Room names are GLOBAL, not per namespace: a room joined from `/ws/chat` and\n * one joined from `/ws/admin` with the same name are the same room. That is\n * what lets a service broadcast through `WS_ROOM_MANAGER` and lets `user:<id>`\n * reach a user's sockets in every namespace — prefix names (`chat:lobby`) when\n * namespaces must not overlap.\n *\n * Membership lives in this process only: `getSockets` and `getAllRooms`\n * describe this instance. `broadcast` reaches other instances when the adapter\n * has a broker.\n */\n// ponytail: fixed cap; raise it if an app really keeps a socket in more rooms.\nexport const MAX_ROOMS_PER_SOCKET = 1000\n\nexport class RoomManager {\n /**\n * @param onSend Called with the number of frames each broadcast wrote.\n * @param onBroadcast Relays each broadcast to other instances.\n */\n constructor(\n private readonly onSend?: (count: number) => void,\n private readonly onBroadcast?: (\n room: string,\n event: string,\n data: any,\n excludeId?: string,\n ) => void,\n ) {}\n\n /** socketId → set of room names */\n private socketRooms = new Map<string, Set<string>>()\n /** room name → set of { socketId, socket } */\n private roomSockets = new Map<string, Map<string, WebSocket>>()\n\n /**\n * Add a socket to a room. Skipped for a socket that is no longer open: a\n * handler that awaits and then joins after the client hung up would\n * otherwise leave an entry `leaveAll` (run once, on close) never removes.\n * At most {@link MAX_ROOMS_PER_SOCKET} rooms per socket — room names often\n * come from what the client sends.\n */\n join(socketId: string, socket: WebSocket, room: string): void {\n if (socket.readyState !== socket.OPEN) return\n if (!this.socketRooms.has(socketId)) {\n this.socketRooms.set(socketId, new Set())\n }\n const rooms = this.socketRooms.get(socketId)!\n if (!rooms.has(room) && rooms.size >= MAX_ROOMS_PER_SOCKET) {\n throw new Error(\n `WebSocket ${socketId} is already in ${MAX_ROOMS_PER_SOCKET} rooms; leave one before joining '${room}'`,\n )\n }\n rooms.add(room)\n\n if (!this.roomSockets.has(room)) {\n this.roomSockets.set(room, new Map())\n }\n this.roomSockets.get(room)!.set(socketId, socket)\n }\n\n leave(socketId: string, room: string): void {\n this.socketRooms.get(socketId)?.delete(room)\n this.roomSockets.get(room)?.delete(socketId)\n\n // Clean up empty rooms\n if (this.roomSockets.get(room)?.size === 0) {\n this.roomSockets.delete(room)\n }\n }\n\n /** Remove socket from all rooms (called on disconnect) */\n leaveAll(socketId: string): void {\n const rooms = this.socketRooms.get(socketId)\n if (rooms) {\n for (const room of rooms) {\n this.roomSockets.get(room)?.delete(socketId)\n if (this.roomSockets.get(room)?.size === 0) {\n this.roomSockets.delete(room)\n }\n }\n }\n this.socketRooms.delete(socketId)\n }\n\n getRooms(socketId: string): string[] {\n return Array.from(this.socketRooms.get(socketId) ?? [])\n }\n\n getSockets(room: string): Map<string, WebSocket> {\n return this.roomSockets.get(room) ?? new Map()\n }\n\n /** Get all rooms with their member counts */\n getAllRooms(): Record<string, number> {\n const result: Record<string, number> = {}\n for (const [room, sockets] of this.roomSockets) {\n result[room] = sockets.size\n }\n return result\n }\n\n /** Broadcast to all sockets in a room, optionally excluding one — on every instance when a broker is set. */\n broadcast(room: string, event: string, data: any, excludeId?: string): void {\n this.deliver(room, event, data, excludeId)\n this.onBroadcast?.(room, event, data, excludeId)\n }\n\n /** Send to this instance's members of a room only. Relayed broadcasts land here. */\n deliver(room: string, event: string, data: any, excludeId?: string): void {\n const sockets = this.roomSockets.get(room)\n if (!sockets) return\n\n const message = JSON.stringify({ event, data })\n let sent = 0\n for (const [id, socket] of sockets) {\n if (id !== excludeId && socket.readyState === socket.OPEN) {\n socket.send(message)\n sent++\n }\n }\n if (sent) this.onSend?.(sent)\n }\n}\n"],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
 
2
- import { m as InjectionToken, o as WsAuthConfig } from "./interfaces-DmgYiknr.mjs";
2
+ import { m as InjectionToken, o as WsAuthConfig } from "./interfaces-yROEyB3E.mjs";
3
3
  import { Server, ServerOptions, Socket } from "socket.io";
4
4
  import { IncomingMessage } from "node:http";
5
5
  //#region src/socket-io.d.ts
@@ -55,15 +55,6 @@ export declare class SocketIoContext {
55
55
  send(event: string, data: any): void;
56
56
  };
57
57
  }
58
- /**
59
- * Serves `@WsController` classes over Socket.IO. Namespaces map one-to-one
60
- * (`@WsController('/chat')` → `io.of('/chat')`), `@OnMessage('send')` handles
61
- * the client's `socket.emit('send', data)`, and `@OnMessage('*')` catches events
62
- * no other handler claims.
63
- *
64
- * Registers {@link SOCKET_IO} and `WS_USER_BROADCASTER`. Not `WS_ROOM_MANAGER`:
65
- * Socket.IO keeps its own rooms — reach them through `SOCKET_IO`.
66
- */
67
58
  export declare const SocketIoAdapter: import("@forinda/kickjs").AdapterFactory<SocketIoAdapterOptions, unknown>;
68
59
  //#endregion
69
60
  //# sourceMappingURL=socket-io.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"socket-io.d.mts","names":["_$_forinda_kickjs_di0.InjectionToken"],"sources":["../src/socket-io.ts"],"mappings":";;;;;;qBA0Ca,WAASA,eAAA,2BAAA,sCAAA,sCAAA;;iBAGL,+BAA+B,QAAQ;;;;;;EAMtD,OAAO;;;;;;;;qBASI;WASA,QAAQ;WACR,QAAQ;;WAER;;EAVX;;EAEA;UAEQ;EAER,YACW,QAAQ,QACR,QAAQ;;EAER;MAGP;;MAKA,WAAW;MAIX,WAAW;EAIf,IAAI,SAAS,cAAc;EAI3B,IAAI,aAAa;;EAKjB,KAAK,eAAe;;EAKpB,UAAU,eAAe;;EAKzB,aAAa,eAAe;;EAK5B,KAAK,sBAAsB;EAc3B,MAAM,sBAAsB;;EAK5B;;EAKA,GAAG;IAAiB,KAAK,eAAe;;;;;;;;;;;;qBAkB7B,2CAAe,eAAA"}
1
+ {"version":3,"file":"socket-io.d.mts","names":["_$_forinda_kickjs_di0.InjectionToken"],"sources":["../src/socket-io.ts"],"mappings":";;;;;;qBA0Ca,WAASA,eAAA,2BAAA,sCAAA,sCAAA;;iBAGL,+BAA+B,QAAQ;;;;;;EAMtD,OAAO;;;;;;;;qBASI;WASA,QAAQ;WACR,QAAQ;;WAER;;EAVX;;EAEA;UAEQ;EAER,YACW,QAAQ,QACR,QAAQ;;EAER;MAGP;;MAKA,WAAW;MAIX,WAAW;EAIf,IAAI,SAAS,cAAc;EAI3B,IAAI,aAAa;;EAKjB,KAAK,eAAe;;EAKpB,UAAU,eAAe;;EAKzB,aAAa,eAAe;;EAK5B,KAAK,sBAAsB;EAc3B,MAAM,sBAAsB;;EAK5B;;EAKA,GAAG;IAAiB,KAAK,eAAe;;;qBA6B7B,2CAAe,eAAA"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.2
2
+ * @forinda/kickjs-ws v7.2.3
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- import{a as wsControllerRegistry,i as WS_USER_BROADCASTER,n as WS_METADATA}from"./interfaces-b-7CXldq.mjs";import{i as parseCookies,t as MAX_ROOMS_PER_SOCKET}from"./room-manager-CD-OQhwc.mjs";import{createLogger,createToken,defineAdapter,getClassMeta,getClassMetaOrUndefined}from"@forinda/kickjs";import{Server}from"socket.io";const log=createLogger(`SocketIoAdapter`),SOCKET_IO=createToken(`kick/ws/SocketIo`);var SocketIoContext=class{socket;server;namespace;data=null;event=``;metadata=/* @__PURE__ */ new Map;constructor(socket,server,namespace){this.socket=socket,this.server=server,this.namespace=namespace}get id(){return this.socket.id}get request(){return this.socket.request}get cookies(){return parseCookies(this.request.headers.cookie)}get(key){return this.metadata.get(key)}set(key,value){this.metadata.set(key,value)}send(event,data){this.socket.emit(event,data)}broadcast(event,data){this.socket.broadcast.emit(event,data)}broadcastAll(event,data){this.socket.nsp.emit(event,data)}join(room){if(this.socket.connected){if(!this.socket.rooms.has(room)&&this.socket.rooms.size-1>=1e3)throw Error(`Socket ${this.socket.id} is already in ${MAX_ROOMS_PER_SOCKET} rooms; leave one before joining '${room}'`);return this.socket.join(room)}}leave(room){return this.socket.leave(room)}rooms(){return[...this.socket.rooms].filter(room=>room!==this.socket.id)}to(room){return{send:(event,data)=>{this.socket.nsp.to(room).emit(event,data)}}}};const SocketIoAdapter=defineAdapter({name:`SocketIoAdapter`,build:({auth,...serverOptions})=>{let io=new Server(serverOptions),detachFromServer=null,namespaces=[],userRoomPrefix=auth?.userRoomPrefix??`user:`,userRoom=userId=>userRoomPrefix+userId,invoke=async(controller,method,ctx)=>{try{await controller[method](ctx)}catch(err){log.error({err},`Socket.IO handler error in ${method}`)}},invokeAll=(controller,handlers,type,ctx)=>Promise.all(handlers.filter(h=>h.type===type).map(h=>invoke(controller,h.handlerName,ctx))),userBroadcaster={roomFor:userRoom,broadcastToUser:(userId,event,data)=>{for(let nsp of namespaces)nsp.to(userRoom(userId)).emit(event,data)},toUser:userId=>({send:(event,data)=>userBroadcaster.broadcastToUser(userId,event,data)})},handleConnection=(socket,namespace,handlers,controller)=>{let ctx=new SocketIoContext(socket,io,namespace),user=socket.data.user,userRoomJoined;user&&(ctx.set(`user`,user),ctx.set(`userId`,user.id),auth?.autoJoinUserRoom!==!1&&(userRoomJoined=ctx.join(userRoom(user.id))));let forEvent=(event,data)=>{let eventCtx=Object.create(ctx);return eventCtx.event=event,eventCtx.data=data,eventCtx},dispatch=(event,data)=>{let handler=handlers.find(h=>h.type===`message`&&h.event===event)??handlers.find(h=>h.type===`message`&&h.event===`*`);handler&&invoke(controller,handler.handlerName,forEvent(event,data))},ready=!1,pending=[],pendingBytes=0;socket.onAny((event,data)=>{if(ready)return dispatch(event,data);let size=Buffer.byteLength(JSON.stringify([event,data]));pending.length>=64||pendingBytes+size>1048576?(pending.length=0,pendingBytes=0,socket.disconnect(!0)):(pending.push([event,data]),pendingBytes+=size)}),socket.on(`disconnect`,()=>{pending.length=0,pendingBytes=0,invokeAll(controller,handlers,`disconnect`,ctx)}),socket.on(`error`,err=>{let errorCtx=forEvent(ctx.event,{message:err.message,name:err.name});invokeAll(controller,handlers,`error`,errorCtx)}),Promise.resolve(userRoomJoined).then(()=>invokeAll(controller,handlers,`connect`,ctx)).then(()=>{if(socket.connected){ready=!0,pendingBytes=0;for(let[event,data]of pending.splice(0))dispatch(event,data)}}).catch(err=>{log.error({err},`Socket.IO user-room join failed; disconnecting`),pending.length=0,pendingBytes=0,socket.disconnect(!0)})};return{beforeStart({container}){container.registerInstance(SOCKET_IO,io),container.registerInstance(WS_USER_BROADCASTER,userBroadcaster);for(let controllerClass of wsControllerRegistry){let namespace=getClassMetaOrUndefined(WS_METADATA.WS_CONTROLLER,controllerClass);if(namespace===void 0)continue;let handlers=getClassMeta(WS_METADATA.WS_HANDLERS,controllerClass,[]),nsp=io.of(namespace);namespaces.push(nsp),auth&&nsp.use(async(socket,next)=>{try{let resolved=await auth.resolveUser(socket.request,socket.handshake.auth);if(!resolved?.id)return next(/* @__PURE__ */ Error(`Unauthorized`));socket.data.user=resolved,next()}catch{next(/* @__PURE__ */ Error(`Unauthorized`))}}),nsp.on(`connection`,socket=>handleConnection(socket,namespace,handlers,container.resolve(controllerClass))),log.info(`Registered Socket.IO namespace: ${namespace} (${controllerClass.name})`)}},afterStart({server}){if(!server)return;let events=[`request`,`upgrade`,`close`,`listening`],before=new Map(events.map(event=>[event,server.listeners(event)]));io.attach(server);let changes=events.map(event=>{let prior=before.get(event),after=server.listeners(event);return{event,added:after.filter(listener=>!prior.includes(listener)),displaced:prior.filter(listener=>!after.includes(listener))}});detachFromServer=()=>{for(let{event,added,displaced}of changes){for(let listener of added)server.off(event,listener);for(let listener of displaced)server.listeners(event).includes(listener)||server.on(event,listener)}}},async shutdown(){await Promise.allSettled(namespaces.map(async nsp=>{nsp.disconnectSockets(!0),await nsp.adapter.close()})),io.engine?.close(),detachFromServer?.(),detachFromServer=null}}}});export{SOCKET_IO,SocketIoAdapter,SocketIoContext};
11
+ import{a as wsControllerRegistry,i as WS_USER_BROADCASTER,n as WS_METADATA}from"./interfaces-Gcx4mGd7.mjs";import{i as parseCookies,t as MAX_ROOMS_PER_SOCKET}from"./room-manager-BOWZ_xdd.mjs";import{createLogger,createToken,defineAdapter,getClassMeta,getClassMetaOrUndefined}from"@forinda/kickjs";import{Server}from"socket.io";const log=createLogger(`SocketIoAdapter`),SOCKET_IO=createToken(`kick/ws/SocketIo`);var SocketIoContext=class{socket;server;namespace;data=null;event=``;metadata=/* @__PURE__ */ new Map;constructor(socket,server,namespace){this.socket=socket,this.server=server,this.namespace=namespace}get id(){return this.socket.id}get request(){return this.socket.request}get cookies(){return parseCookies(this.request.headers.cookie)}get(key){return this.metadata.get(key)}set(key,value){this.metadata.set(key,value)}send(event,data){this.socket.emit(event,data)}broadcast(event,data){this.socket.broadcast.emit(event,data)}broadcastAll(event,data){this.socket.nsp.emit(event,data)}join(room){if(this.socket.connected){if(!this.socket.rooms.has(room)&&this.socket.rooms.size-1>=1e3)throw Error(`Socket ${this.socket.id} is already in ${MAX_ROOMS_PER_SOCKET} rooms; leave one before joining '${room}'`);return this.socket.join(room)}}leave(room){return this.socket.leave(room)}rooms(){return[...this.socket.rooms].filter(room=>room!==this.socket.id)}to(room){return{send:(event,data)=>{this.socket.nsp.to(room).emit(event,data)}}}};const retired=/* @__PURE__ */ new WeakMap,unwrap=listener=>retired.get(listener)?.flatMap(unwrap)??[listener],SocketIoAdapter=defineAdapter({name:`SocketIoAdapter`,build:({auth,...serverOptions})=>{let io=new Server(serverOptions),detachFromServer=null,namespaces=[],userRoomPrefix=auth?.userRoomPrefix??`user:`,userRoom=userId=>userRoomPrefix+userId,invoke=async(controller,method,ctx)=>{try{await controller[method](ctx)}catch(err){log.error({err},`Socket.IO handler error in ${method}`)}},invokeAll=(controller,handlers,type,ctx)=>Promise.all(handlers.filter(h=>h.type===type).map(h=>invoke(controller,h.handlerName,ctx))),userBroadcaster={roomFor:userRoom,broadcastToUser:(userId,event,data)=>{for(let nsp of namespaces)nsp.to(userRoom(userId)).emit(event,data)},toUser:userId=>({send:(event,data)=>userBroadcaster.broadcastToUser(userId,event,data)})},handleConnection=(socket,namespace,handlers,controller)=>{let ctx=new SocketIoContext(socket,io,namespace),user=socket.data.user,userRoomJoined;user&&(ctx.set(`user`,user),ctx.set(`userId`,user.id),auth?.autoJoinUserRoom!==!1&&(userRoomJoined=ctx.join(userRoom(user.id))));let forEvent=(event,data)=>{let eventCtx=Object.create(ctx);return eventCtx.event=event,eventCtx.data=data,eventCtx},dispatch=(event,data)=>{let handler=handlers.find(h=>h.type===`message`&&h.event===event)??handlers.find(h=>h.type===`message`&&h.event===`*`);handler&&invoke(controller,handler.handlerName,forEvent(event,data))},ready=!1,pending=[],pendingBytes=0;socket.onAny((event,data)=>{if(ready)return dispatch(event,data);let size=Buffer.byteLength(JSON.stringify([event,data]));pending.length>=64||pendingBytes+size>1048576?(pending.length=0,pendingBytes=0,socket.disconnect(!0)):(pending.push([event,data]),pendingBytes+=size)}),socket.on(`disconnect`,()=>{pending.length=0,pendingBytes=0,invokeAll(controller,handlers,`disconnect`,ctx)}),socket.on(`error`,err=>{let errorCtx=forEvent(ctx.event,{message:err.message,name:err.name});invokeAll(controller,handlers,`error`,errorCtx)}),Promise.resolve(userRoomJoined).then(()=>invokeAll(controller,handlers,`connect`,ctx)).then(()=>{if(socket.connected){ready=!0,pendingBytes=0;for(let[event,data]of pending.splice(0))dispatch(event,data)}}).catch(err=>{log.error({err},`Socket.IO user-room join failed; disconnecting`),pending.length=0,pendingBytes=0,socket.disconnect(!0)})};return{beforeStart({container}){container.registerInstance(SOCKET_IO,io),container.registerInstance(WS_USER_BROADCASTER,userBroadcaster);for(let controllerClass of wsControllerRegistry){let namespace=getClassMetaOrUndefined(WS_METADATA.WS_CONTROLLER,controllerClass);if(namespace===void 0)continue;let handlers=getClassMeta(WS_METADATA.WS_HANDLERS,controllerClass,[]),nsp=io.of(namespace);namespaces.push(nsp),auth&&nsp.use(async(socket,next)=>{try{let resolved=await auth.resolveUser(socket.request,socket.handshake.auth);if(!resolved?.id)return next(/* @__PURE__ */ Error(`Unauthorized`));socket.data.user=resolved,next()}catch{next(/* @__PURE__ */ Error(`Unauthorized`))}}),nsp.on(`connection`,socket=>handleConnection(socket,namespace,handlers,container.resolve(controllerClass))),log.info(`Registered Socket.IO namespace: ${namespace} (${controllerClass.name})`)}},afterStart({server}){if(!server)return;let events=[`request`,`upgrade`,`close`,`listening`],before=new Map(events.map(event=>[event,server.listeners(event)]));io.attach(server);let changes=events.map(event=>{let prior=before.get(event),after=server.listeners(event);return{event,added:after.filter(listener=>!prior.includes(listener)),displaced:prior.filter(listener=>!after.includes(listener))}});detachFromServer=()=>{for(let{event,added,displaced}of changes){let current=server.listeners(event),gone=added.filter(listener=>!current.includes(listener));for(let listener of added)server.off(event,listener);if(gone.length)for(let listener of gone)retired.set(listener,displaced);else for(let listener of displaced.flatMap(unwrap))server.listeners(event).includes(listener)||server.on(event,listener)}}},async shutdown(){await Promise.allSettled(namespaces.map(async nsp=>{nsp.disconnectSockets(!0),await nsp.adapter.close()})),io.engine?.close(),detachFromServer?.(),detachFromServer=null}}}});export{SOCKET_IO,SocketIoAdapter,SocketIoContext};
12
12
  //# sourceMappingURL=socket-io.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"socket-io.mjs","names":[],"sources":["../src/socket-io.ts"],"sourcesContent":["/**\n * Socket.IO transport for the same `@WsController` classes {@link WsAdapter}\n * serves. Pick it for what Socket.IO brings — client reconnection, long-polling\n * fallback, acknowledgements — and scale it with Socket.IO's own adapters\n * (`@socket.io/redis-adapter`) rather than a {@link WsBroker}.\n *\n * ```ts\n * import { SocketIoAdapter } from '@forinda/kickjs-ws/socket.io'\n *\n * bootstrap({ modules, adapters: [SocketIoAdapter({ cors: { origin: 'https://app.example.com' } })] })\n * ```\n *\n * @module @forinda/kickjs-ws/socket.io\n */\nimport type { IncomingMessage } from 'node:http'\nimport { Server, type Namespace, type ServerOptions, type Socket } from 'socket.io'\nimport {\n createLogger,\n createToken,\n defineAdapter,\n getClassMeta,\n getClassMetaOrUndefined,\n} from '@forinda/kickjs'\nimport {\n WS_METADATA,\n WS_USER_BROADCASTER,\n wsControllerRegistry,\n type WsAuthConfig,\n type WsHandlerDefinition,\n type WsUserBroadcaster,\n} from './interfaces'\nimport { parseCookies } from './ws-context'\nimport { MAX_ROOMS_PER_SOCKET } from './room-manager'\n\nconst log = createLogger('SocketIoAdapter')\n\n/** Events held from a socket whose async `@OnConnect` has not settled. */\nconst MAX_PENDING_BEFORE_CONNECT = 64\n/** Total payload held meanwhile, measured as JSON. */\nconst MAX_PENDING_BYTES_BEFORE_CONNECT = 1024 * 1024\n\n/** DI token for the Socket.IO `Server`. */\nexport const SOCKET_IO = createToken<Server>('kick/ws/SocketIo')\n\n/** Socket.IO server options (`cors`, `path`, `adapter`, …) plus the shared auth hook. */\nexport interface SocketIoAdapterOptions extends Partial<ServerOptions> {\n /**\n * Same contract as {@link WsAdapterOptions.auth}, run as namespace\n * middleware before the connection is accepted. A rejection reaches the\n * client as a `connect_error` whose message is `Unauthorized`.\n */\n auth?: WsAuthConfig\n}\n\n/**\n * What `@WsController` handlers receive under {@link SocketIoAdapter}. Mirrors\n * `WsContext`, so a controller written against one runs on the other — with\n * one difference: Socket.IO rooms belong to a namespace, where `ws` rooms are\n * shared across namespaces.\n */\nexport class SocketIoContext {\n /** Payload of the current event (set for `@OnMessage` handlers). */\n data: any = null\n /** Name of the current event (set for `@OnMessage` handlers). */\n event = ''\n\n private metadata = new Map<string, any>()\n\n constructor(\n readonly socket: Socket,\n readonly server: Server,\n /** The `@WsController` namespace, e.g. `/chat`. */\n readonly namespace: string,\n ) {}\n\n get id(): string {\n return this.socket.id\n }\n\n /** The handshake request — cookies, headers, query, client IP. */\n get request(): IncomingMessage {\n return this.socket.request\n }\n\n get cookies(): Record<string, string> {\n return parseCookies(this.request.headers.cookie)\n }\n\n get<T = any>(key: string): T | undefined {\n return this.metadata.get(key)\n }\n\n set(key: string, value: any): void {\n this.metadata.set(key, value)\n }\n\n /** Emit to this socket. */\n send(event: string, data: any): void {\n this.socket.emit(event, data)\n }\n\n /** Emit to every socket in the namespace except this one. */\n broadcast(event: string, data: any): void {\n this.socket.broadcast.emit(event, data)\n }\n\n /** Emit to every socket in the namespace, this one included. */\n broadcastAll(event: string, data: any): void {\n this.socket.nsp.emit(event, data)\n }\n\n /** Join a room in this namespace. Returns the adapter's promise when its join is async. */\n join(room: string): void | Promise<void> {\n // Socket.IO removes a socket from its rooms once, on disconnect; a join\n // after that (a handler that awaited) would stay for good.\n if (!this.socket.connected) return\n // Same cap as RoomManager. Socket.IO puts every socket in a room named\n // after its own id, which doesn't count.\n if (!this.socket.rooms.has(room) && this.socket.rooms.size - 1 >= MAX_ROOMS_PER_SOCKET) {\n throw new Error(\n `Socket ${this.socket.id} is already in ${MAX_ROOMS_PER_SOCKET} rooms; leave one before joining '${room}'`,\n )\n }\n return this.socket.join(room)\n }\n\n leave(room: string): void | Promise<void> {\n return this.socket.leave(room)\n }\n\n /** Rooms this socket joined, without Socket.IO's own per-socket room. */\n rooms(): string[] {\n return [...this.socket.rooms].filter((room) => room !== this.socket.id)\n }\n\n /** Emit to every socket in a room of this namespace, this one included. */\n to(room: string): { send(event: string, data: any): void } {\n return {\n send: (event: string, data: any) => {\n this.socket.nsp.to(room).emit(event, data)\n },\n }\n }\n}\n\n/**\n * Serves `@WsController` classes over Socket.IO. Namespaces map one-to-one\n * (`@WsController('/chat')` → `io.of('/chat')`), `@OnMessage('send')` handles\n * the client's `socket.emit('send', data)`, and `@OnMessage('*')` catches events\n * no other handler claims.\n *\n * Registers {@link SOCKET_IO} and `WS_USER_BROADCASTER`. Not `WS_ROOM_MANAGER`:\n * Socket.IO keeps its own rooms — reach them through `SOCKET_IO`.\n */\nexport const SocketIoAdapter = defineAdapter<SocketIoAdapterOptions>({\n name: 'SocketIoAdapter',\n build: ({ auth, ...serverOptions }) => {\n const io = new Server(serverOptions)\n /** Undoes what `io.attach()` did to the HTTP server — see afterStart. */\n let detachFromServer: (() => void) | null = null\n const namespaces: Namespace[] = []\n const userRoomPrefix = auth?.userRoomPrefix ?? 'user:'\n const userRoom = (userId: string): string => userRoomPrefix + userId\n\n const invoke = async (controller: any, method: string, ctx: SocketIoContext): Promise<void> => {\n try {\n await controller[method](ctx)\n } catch (err) {\n log.error({ err }, `Socket.IO handler error in ${method}`)\n }\n }\n const invokeAll = (\n controller: any,\n handlers: WsHandlerDefinition[],\n type: WsHandlerDefinition['type'],\n ctx: SocketIoContext,\n ): Promise<unknown> =>\n Promise.all(\n handlers.filter((h) => h.type === type).map((h) => invoke(controller, h.handlerName, ctx)),\n )\n\n // Socket.IO rooms are per namespace, so a user's sockets sit in `user:<id>`\n // once per namespace they connected to. Emitting through each namespace\n // also crosses instances when a Socket.IO adapter is configured.\n const userBroadcaster: WsUserBroadcaster = {\n roomFor: userRoom,\n broadcastToUser: (userId, event, data) => {\n for (const nsp of namespaces) nsp.to(userRoom(userId)).emit(event, data)\n },\n toUser: (userId) => ({\n send: (event, data) => userBroadcaster.broadcastToUser(userId, event, data),\n }),\n }\n\n const handleConnection = (\n socket: Socket,\n namespace: string,\n handlers: WsHandlerDefinition[],\n controller: any,\n ): void => {\n const ctx = new SocketIoContext(socket, io, namespace)\n const user = socket.data.user\n let userRoomJoined: void | Promise<void> = undefined\n if (user) {\n ctx.set('user', user)\n ctx.set('userId', user.id)\n if (auth?.autoJoinUserRoom !== false) userRoomJoined = ctx.join(userRoom(user.id))\n }\n\n // One context per event, inheriting the socket's (methods, get/set\n // store): a handler suspended on an await must not read the next event's\n // data off a shared object.\n const forEvent = (event: string, data: unknown): SocketIoContext => {\n const eventCtx: SocketIoContext = Object.create(ctx)\n eventCtx.event = event\n eventCtx.data = data\n return eventCtx\n }\n\n const dispatch = (event: string, data: unknown): void => {\n const handler =\n handlers.find((h) => h.type === 'message' && h.event === event) ??\n handlers.find((h) => h.type === 'message' && h.event === '*')\n if (!handler) return\n void invoke(controller, handler.handlerName, forEvent(event, data))\n }\n\n // Listeners go on now — Socket.IO drops events nobody listens for — but\n // events are held until every @OnConnect settles, so handlers never see a\n // socket whose connect setup is unfinished. Same limits as WsAdapter;\n // payloads arrive parsed, so their size is measured as JSON.\n let ready = false\n const pending: Array<[string, unknown]> = []\n let pendingBytes = 0\n socket.onAny((event: string, data: unknown) => {\n if (ready) return dispatch(event, data)\n // The event name is client-controlled and held too, so it counts.\n const size = Buffer.byteLength(JSON.stringify([event, data]))\n if (\n pending.length >= MAX_PENDING_BEFORE_CONNECT ||\n pendingBytes + size > MAX_PENDING_BYTES_BEFORE_CONNECT\n ) {\n pending.length = 0\n pendingBytes = 0\n socket.disconnect(true)\n return\n }\n pending.push([event, data])\n pendingBytes += size\n })\n\n socket.on('disconnect', () => {\n pending.length = 0\n pendingBytes = 0\n void invokeAll(controller, handlers, 'disconnect', ctx)\n })\n socket.on('error', (err: Error) => {\n const errorCtx = forEvent(ctx.event, { message: err.message, name: err.name })\n void invokeAll(controller, handlers, 'error', errorCtx)\n })\n\n // The user-room join can be async with some Socket.IO adapters; @OnConnect\n // must not emit to `user:<id>` before this socket is in it.\n void Promise.resolve(userRoomJoined)\n .then(() => invokeAll(controller, handlers, 'connect', ctx))\n .then(() => {\n if (!socket.connected) return\n ready = true\n pendingBytes = 0\n for (const [event, data] of pending.splice(0)) dispatch(event, data)\n })\n // A rejected join would otherwise leave the socket connected with its\n // events held forever. Handlers never reject (errors are logged).\n .catch((err) => {\n log.error({ err }, 'Socket.IO user-room join failed; disconnecting')\n pending.length = 0\n pendingBytes = 0\n socket.disconnect(true)\n })\n }\n\n return {\n beforeStart({ container }) {\n container.registerInstance(SOCKET_IO, io)\n container.registerInstance(WS_USER_BROADCASTER, userBroadcaster)\n\n for (const controllerClass of wsControllerRegistry) {\n const namespace = getClassMetaOrUndefined<string>(\n WS_METADATA.WS_CONTROLLER,\n controllerClass,\n )\n if (namespace === undefined) continue\n const handlers = getClassMeta<WsHandlerDefinition[]>(\n WS_METADATA.WS_HANDLERS,\n controllerClass,\n [],\n )\n\n const nsp = io.of(namespace)\n namespaces.push(nsp)\n\n if (auth) {\n nsp.use(async (socket, next) => {\n try {\n const resolved = await auth.resolveUser(socket.request, socket.handshake.auth)\n if (!resolved?.id) return next(new Error('Unauthorized'))\n socket.data.user = resolved\n next()\n } catch {\n next(new Error('Unauthorized'))\n }\n })\n }\n\n nsp.on('connection', (socket) =>\n handleConnection(socket, namespace, handlers, container.resolve(controllerClass)),\n )\n log.info(`Registered Socket.IO namespace: ${namespace} (${controllerClass.name})`)\n }\n },\n\n afterStart({ server }) {\n if (!server) return\n // engine.io's attach() adds upgrade / close / listening listeners and\n // swaps the server's own request listeners for a wrapper around them.\n // On a dev reload the server outlives this adapter, so shutdown undoes\n // exactly that — otherwise the next adapter shares the server with a\n // dead engine, and the app's request handler (Vite's, in dev) stays\n // wrapped by it.\n const events = ['request', 'upgrade', 'close', 'listening'] as const\n const before = new Map(events.map((event) => [event, server.listeners(event)]))\n io.attach(server)\n // The delta is taken now, not at shutdown: a listener the app or another\n // adapter adds later is not attach()'s, and removing it would take a\n // live handler off the shared server.\n const changes = events.map((event) => {\n const prior = before.get(event)!\n const after = server.listeners(event)\n return {\n event,\n added: after.filter((listener) => !prior.includes(listener)),\n displaced: prior.filter((listener) => !after.includes(listener)),\n }\n })\n detachFromServer = () => {\n for (const { event, added, displaced } of changes) {\n for (const listener of added) server.off(event, listener as (...args: any[]) => void)\n for (const listener of displaced) {\n if (!server.listeners(event).includes(listener)) {\n server.on(event, listener as (...args: any[]) => void)\n }\n }\n }\n }\n },\n\n async shutdown() {\n // Not io.close(): it also closes the HTTP server, which KickJS owns.\n await Promise.allSettled(\n namespaces.map(async (nsp) => {\n nsp.disconnectSockets(true)\n await nsp.adapter.close()\n }),\n )\n io.engine?.close()\n detachFromServer?.()\n detachFromServer = null\n },\n }\n },\n})\n"],"mappings":"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"}
1
+ {"version":3,"file":"socket-io.mjs","names":[],"sources":["../src/socket-io.ts"],"sourcesContent":["/**\n * Socket.IO transport for the same `@WsController` classes {@link WsAdapter}\n * serves. Pick it for what Socket.IO brings — client reconnection, long-polling\n * fallback, acknowledgements — and scale it with Socket.IO's own adapters\n * (`@socket.io/redis-adapter`) rather than a {@link WsBroker}.\n *\n * ```ts\n * import { SocketIoAdapter } from '@forinda/kickjs-ws/socket.io'\n *\n * bootstrap({ modules, adapters: [SocketIoAdapter({ cors: { origin: 'https://app.example.com' } })] })\n * ```\n *\n * @module @forinda/kickjs-ws/socket.io\n */\nimport type { IncomingMessage } from 'node:http'\nimport { Server, type Namespace, type ServerOptions, type Socket } from 'socket.io'\nimport {\n createLogger,\n createToken,\n defineAdapter,\n getClassMeta,\n getClassMetaOrUndefined,\n} from '@forinda/kickjs'\nimport {\n WS_METADATA,\n WS_USER_BROADCASTER,\n wsControllerRegistry,\n type WsAuthConfig,\n type WsHandlerDefinition,\n type WsUserBroadcaster,\n} from './interfaces'\nimport { parseCookies } from './ws-context'\nimport { MAX_ROOMS_PER_SOCKET } from './room-manager'\n\nconst log = createLogger('SocketIoAdapter')\n\n/** Events held from a socket whose async `@OnConnect` has not settled. */\nconst MAX_PENDING_BEFORE_CONNECT = 64\n/** Total payload held meanwhile, measured as JSON. */\nconst MAX_PENDING_BYTES_BEFORE_CONNECT = 1024 * 1024\n\n/** DI token for the Socket.IO `Server`. */\nexport const SOCKET_IO = createToken<Server>('kick/ws/SocketIo')\n\n/** Socket.IO server options (`cors`, `path`, `adapter`, …) plus the shared auth hook. */\nexport interface SocketIoAdapterOptions extends Partial<ServerOptions> {\n /**\n * Same contract as {@link WsAdapterOptions.auth}, run as namespace\n * middleware before the connection is accepted. A rejection reaches the\n * client as a `connect_error` whose message is `Unauthorized`.\n */\n auth?: WsAuthConfig\n}\n\n/**\n * What `@WsController` handlers receive under {@link SocketIoAdapter}. Mirrors\n * `WsContext`, so a controller written against one runs on the other — with\n * one difference: Socket.IO rooms belong to a namespace, where `ws` rooms are\n * shared across namespaces.\n */\nexport class SocketIoContext {\n /** Payload of the current event (set for `@OnMessage` handlers). */\n data: any = null\n /** Name of the current event (set for `@OnMessage` handlers). */\n event = ''\n\n private metadata = new Map<string, any>()\n\n constructor(\n readonly socket: Socket,\n readonly server: Server,\n /** The `@WsController` namespace, e.g. `/chat`. */\n readonly namespace: string,\n ) {}\n\n get id(): string {\n return this.socket.id\n }\n\n /** The handshake request — cookies, headers, query, client IP. */\n get request(): IncomingMessage {\n return this.socket.request\n }\n\n get cookies(): Record<string, string> {\n return parseCookies(this.request.headers.cookie)\n }\n\n get<T = any>(key: string): T | undefined {\n return this.metadata.get(key)\n }\n\n set(key: string, value: any): void {\n this.metadata.set(key, value)\n }\n\n /** Emit to this socket. */\n send(event: string, data: any): void {\n this.socket.emit(event, data)\n }\n\n /** Emit to every socket in the namespace except this one. */\n broadcast(event: string, data: any): void {\n this.socket.broadcast.emit(event, data)\n }\n\n /** Emit to every socket in the namespace, this one included. */\n broadcastAll(event: string, data: any): void {\n this.socket.nsp.emit(event, data)\n }\n\n /** Join a room in this namespace. Returns the adapter's promise when its join is async. */\n join(room: string): void | Promise<void> {\n // Socket.IO removes a socket from its rooms once, on disconnect; a join\n // after that (a handler that awaited) would stay for good.\n if (!this.socket.connected) return\n // Same cap as RoomManager. Socket.IO puts every socket in a room named\n // after its own id, which doesn't count.\n if (!this.socket.rooms.has(room) && this.socket.rooms.size - 1 >= MAX_ROOMS_PER_SOCKET) {\n throw new Error(\n `Socket ${this.socket.id} is already in ${MAX_ROOMS_PER_SOCKET} rooms; leave one before joining '${room}'`,\n )\n }\n return this.socket.join(room)\n }\n\n leave(room: string): void | Promise<void> {\n return this.socket.leave(room)\n }\n\n /** Rooms this socket joined, without Socket.IO's own per-socket room. */\n rooms(): string[] {\n return [...this.socket.rooms].filter((room) => room !== this.socket.id)\n }\n\n /** Emit to every socket in a room of this namespace, this one included. */\n to(room: string): { send(event: string, data: any): void } {\n return {\n send: (event: string, data: any) => {\n this.socket.nsp.to(room).emit(event, data)\n },\n }\n }\n}\n\n/**\n * Serves `@WsController` classes over Socket.IO. Namespaces map one-to-one\n * (`@WsController('/chat')` → `io.of('/chat')`), `@OnMessage('send')` handles\n * the client's `socket.emit('send', data)`, and `@OnMessage('*')` catches events\n * no other handler claims.\n *\n * Registers {@link SOCKET_IO} and `WS_USER_BROADCASTER`. Not `WS_ROOM_MANAGER`:\n * Socket.IO keeps its own rooms — reach them through `SOCKET_IO`.\n */\ntype Listener = (...args: any[]) => void\n\n/**\n * A detached adapter's wrapper that a later attach() captured → the listeners\n * it displaced. When that later adapter detaches, it restores these, not the\n * dead wrapper.\n */\nconst retired = new WeakMap<Listener, Listener[]>()\nconst unwrap = (listener: Listener): Listener[] =>\n retired.get(listener)?.flatMap(unwrap) ?? [listener]\n\nexport const SocketIoAdapter = defineAdapter<SocketIoAdapterOptions>({\n name: 'SocketIoAdapter',\n build: ({ auth, ...serverOptions }) => {\n const io = new Server(serverOptions)\n /** Undoes what `io.attach()` did to the HTTP server — see afterStart. */\n let detachFromServer: (() => void) | null = null\n const namespaces: Namespace[] = []\n const userRoomPrefix = auth?.userRoomPrefix ?? 'user:'\n const userRoom = (userId: string): string => userRoomPrefix + userId\n\n const invoke = async (controller: any, method: string, ctx: SocketIoContext): Promise<void> => {\n try {\n await controller[method](ctx)\n } catch (err) {\n log.error({ err }, `Socket.IO handler error in ${method}`)\n }\n }\n const invokeAll = (\n controller: any,\n handlers: WsHandlerDefinition[],\n type: WsHandlerDefinition['type'],\n ctx: SocketIoContext,\n ): Promise<unknown> =>\n Promise.all(\n handlers.filter((h) => h.type === type).map((h) => invoke(controller, h.handlerName, ctx)),\n )\n\n // Socket.IO rooms are per namespace, so a user's sockets sit in `user:<id>`\n // once per namespace they connected to. Emitting through each namespace\n // also crosses instances when a Socket.IO adapter is configured.\n const userBroadcaster: WsUserBroadcaster = {\n roomFor: userRoom,\n broadcastToUser: (userId, event, data) => {\n for (const nsp of namespaces) nsp.to(userRoom(userId)).emit(event, data)\n },\n toUser: (userId) => ({\n send: (event, data) => userBroadcaster.broadcastToUser(userId, event, data),\n }),\n }\n\n const handleConnection = (\n socket: Socket,\n namespace: string,\n handlers: WsHandlerDefinition[],\n controller: any,\n ): void => {\n const ctx = new SocketIoContext(socket, io, namespace)\n const user = socket.data.user\n let userRoomJoined: void | Promise<void> = undefined\n if (user) {\n ctx.set('user', user)\n ctx.set('userId', user.id)\n if (auth?.autoJoinUserRoom !== false) userRoomJoined = ctx.join(userRoom(user.id))\n }\n\n // One context per event, inheriting the socket's (methods, get/set\n // store): a handler suspended on an await must not read the next event's\n // data off a shared object.\n const forEvent = (event: string, data: unknown): SocketIoContext => {\n const eventCtx: SocketIoContext = Object.create(ctx)\n eventCtx.event = event\n eventCtx.data = data\n return eventCtx\n }\n\n const dispatch = (event: string, data: unknown): void => {\n const handler =\n handlers.find((h) => h.type === 'message' && h.event === event) ??\n handlers.find((h) => h.type === 'message' && h.event === '*')\n if (!handler) return\n void invoke(controller, handler.handlerName, forEvent(event, data))\n }\n\n // Listeners go on now — Socket.IO drops events nobody listens for — but\n // events are held until every @OnConnect settles, so handlers never see a\n // socket whose connect setup is unfinished. Same limits as WsAdapter;\n // payloads arrive parsed, so their size is measured as JSON.\n let ready = false\n const pending: Array<[string, unknown]> = []\n let pendingBytes = 0\n socket.onAny((event: string, data: unknown) => {\n if (ready) return dispatch(event, data)\n // The event name is client-controlled and held too, so it counts.\n const size = Buffer.byteLength(JSON.stringify([event, data]))\n if (\n pending.length >= MAX_PENDING_BEFORE_CONNECT ||\n pendingBytes + size > MAX_PENDING_BYTES_BEFORE_CONNECT\n ) {\n pending.length = 0\n pendingBytes = 0\n socket.disconnect(true)\n return\n }\n pending.push([event, data])\n pendingBytes += size\n })\n\n socket.on('disconnect', () => {\n pending.length = 0\n pendingBytes = 0\n void invokeAll(controller, handlers, 'disconnect', ctx)\n })\n socket.on('error', (err: Error) => {\n const errorCtx = forEvent(ctx.event, { message: err.message, name: err.name })\n void invokeAll(controller, handlers, 'error', errorCtx)\n })\n\n // The user-room join can be async with some Socket.IO adapters; @OnConnect\n // must not emit to `user:<id>` before this socket is in it.\n void Promise.resolve(userRoomJoined)\n .then(() => invokeAll(controller, handlers, 'connect', ctx))\n .then(() => {\n if (!socket.connected) return\n ready = true\n pendingBytes = 0\n for (const [event, data] of pending.splice(0)) dispatch(event, data)\n })\n // A rejected join would otherwise leave the socket connected with its\n // events held forever. Handlers never reject (errors are logged).\n .catch((err) => {\n log.error({ err }, 'Socket.IO user-room join failed; disconnecting')\n pending.length = 0\n pendingBytes = 0\n socket.disconnect(true)\n })\n }\n\n return {\n beforeStart({ container }) {\n container.registerInstance(SOCKET_IO, io)\n container.registerInstance(WS_USER_BROADCASTER, userBroadcaster)\n\n for (const controllerClass of wsControllerRegistry) {\n const namespace = getClassMetaOrUndefined<string>(\n WS_METADATA.WS_CONTROLLER,\n controllerClass,\n )\n if (namespace === undefined) continue\n const handlers = getClassMeta<WsHandlerDefinition[]>(\n WS_METADATA.WS_HANDLERS,\n controllerClass,\n [],\n )\n\n const nsp = io.of(namespace)\n namespaces.push(nsp)\n\n if (auth) {\n nsp.use(async (socket, next) => {\n try {\n const resolved = await auth.resolveUser(socket.request, socket.handshake.auth)\n if (!resolved?.id) return next(new Error('Unauthorized'))\n socket.data.user = resolved\n next()\n } catch {\n next(new Error('Unauthorized'))\n }\n })\n }\n\n nsp.on('connection', (socket) =>\n handleConnection(socket, namespace, handlers, container.resolve(controllerClass)),\n )\n log.info(`Registered Socket.IO namespace: ${namespace} (${controllerClass.name})`)\n }\n },\n\n afterStart({ server }) {\n if (!server) return\n // engine.io's attach() adds upgrade / close / listening listeners and\n // swaps the server's own request listeners for a wrapper around them.\n // On a dev reload the server outlives this adapter, so shutdown undoes\n // exactly that — otherwise the next adapter shares the server with a\n // dead engine, and the app's request handler (Vite's, in dev) stays\n // wrapped by it.\n const events = ['request', 'upgrade', 'close', 'listening'] as const\n const before = new Map(events.map((event) => [event, server.listeners(event)]))\n io.attach(server)\n // The delta is taken now, not at shutdown: a listener the app or another\n // adapter adds later is not attach()'s, and removing it would take a\n // live handler off the shared server.\n const changes = events.map((event) => {\n const prior = before.get(event)!\n const after = server.listeners(event)\n return {\n event,\n added: after.filter((listener) => !prior.includes(listener)),\n displaced: prior.filter((listener) => !after.includes(listener)),\n }\n })\n detachFromServer = () => {\n for (const { event, added, displaced } of changes) {\n const current = server.listeners(event)\n // A later attach() swapped our wrapper into its own, which still\n // calls the listeners we displaced: re-adding them would run the\n // app twice per request. Leave them where the wrapper reaches them,\n // and note them so that adapter's own detach restores them, not us.\n const gone = added.filter((listener) => !current.includes(listener))\n for (const listener of added) server.off(event, listener as Listener)\n if (gone.length) {\n for (const listener of gone)\n retired.set(listener as Listener, displaced as Listener[])\n continue\n }\n for (const listener of (displaced as Listener[]).flatMap(unwrap)) {\n if (!server.listeners(event).includes(listener)) {\n server.on(event, listener)\n }\n }\n }\n }\n },\n\n async shutdown() {\n // Not io.close(): it also closes the HTTP server, which KickJS owns.\n await Promise.allSettled(\n namespaces.map(async (nsp) => {\n nsp.disconnectSockets(true)\n await nsp.adapter.close()\n }),\n )\n io.engine?.close()\n detachFromServer?.()\n detachFromServer = null\n },\n }\n },\n})\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@forinda/kickjs-ws",
3
- "version": "7.2.2",
3
+ "version": "7.2.3",
4
4
  "description": "Realtime for KickJS: decorator-driven WebSocket controllers on ws or Socket.IO, a Redis broker for multiple instances, and a Centrifugo integration",
5
5
  "keywords": [
6
6
  "kickjs",
@@ -48,16 +48,16 @@
48
48
  },
49
49
  "devDependencies": {
50
50
  "@socket.io/redis-adapter": "^8.3.0",
51
- "@swc/core": "^1.16.13",
51
+ "@swc/core": "^1.16.18",
52
52
  "@types/node": "^26.6.5",
53
53
  "@types/ws": "^8.18.2",
54
54
  "ioredis": "^6.0.0",
55
55
  "socket.io": "^4.8.4",
56
56
  "socket.io-client": "^4.8.4",
57
57
  "typescript": "^7.0.2",
58
- "vitest": "^5.0.3",
58
+ "vitest": "^5.0.5",
59
59
  "ws": "^8.22.0",
60
- "@forinda/kickjs": "10.4.0"
60
+ "@forinda/kickjs": "10.13.2"
61
61
  },
62
62
  "publishConfig": {
63
63
  "access": "public"
@@ -1 +0,0 @@
1
- {"version":3,"file":"interfaces-DmgYiknr.d.mts","names":["_$_forinda_kickjs_di0.InjectionToken"],"sources":["../../di/dist/index.d.mts","../src/room-manager.ts","../src/interfaces.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgJqB;;;;;;;;;;UAUX,eAAe;YACb;;WAED;;WAEA,QAAQ;;;;;;;;;;;;;QAuYX;YACI;;;;cCphBC;mBAMQ;mBACA;;;;;EAFnB,YACmB,WAAU,qCACV,gBACf,cACA,eACA,WACA;;UAKI;;UAEA;;;;;;;;EASR,KAAK,kBAAkB,QAAQ,WAAW;EAmB1C,MAAM,kBAAkB;;EAWxB,SAAS;EAaT,SAAS;EAIT,WAAW,eAAe,YAAY;;EAKtC,eAAe;;EASf,UAAU,cAAc,eAAe,WAAW;;EAMlD,QAAQ,cAAc,eAAe,WAAW;;;;cCxGrC;WACX;WACA;;KAGU;UAEK;EACf,MAAM;;EAEN;;EAEA;;;;;;;UAQe;EACf;GACC;;UAGc;;;;;;;;;;;;;;;;;;EAkBf,cACE,SAAS,iBACT,gBAAgB,4BACb,QAAQ,8BAA8B;;;;;;EAM3C;;;;;EAKA;;UAGe;;EAEf;;EAEA;;EAEA;;EAEA,OAAO;;;;;;;EAOP,SAAS;;;KAIC;;EAEV;EACA;EACA;;EAEA;;;EAII;EACA;;;EAIA;EACA;;;;;;;;UAUW;;;;;;EAMf,QAAQ,SAAS,yBAAyB;;EAE1C,UAAU,YAAY,SAAS,kCAAkC;;EAEjE,iBAAiB;;;;;;;;;;;UAYF;;EAEf,OAAO;IAAmB,KAAK,eAAe;;;EAE9C,gBAAgB,gBAAgB,eAAe;;EAE/C,QAAQ;;;cAIG,YAAAA;;cAEA,iBAAeA,eAAA;;cAEf,qBAAmBA,eAAA"}