@forinda/kickjs-ws 7.2.1 → 7.2.2

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 { s as WsAuthenticatedUser } from "./interfaces-taaD_-I8.mjs";
2
+ import { m as InjectionToken, s as WsAuthenticatedUser } from "./interfaces-DmgYiknr.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>`. */
@@ -78,7 +78,7 @@ export type CentrifugoConnectReply = {
78
78
  */
79
79
  export declare function centrifugoConnect<Req>(request: Req, resolveUser: (request: Req) => Promise<WsAuthenticatedUser | null> | WsAuthenticatedUser | null): Promise<CentrifugoConnectReply>;
80
80
  /** DI token for the {@link CentrifugoClient} registered by {@link CentrifugoAdapter}. */
81
- export declare const CENTRIFUGO: import("@forinda/kickjs").InjectionToken<CentrifugoClient>;
81
+ export declare const CENTRIFUGO: InjectionToken<CentrifugoClient>;
82
82
  export interface CentrifugoAdapterOptions extends CentrifugoClientOptions {
83
83
  /**
84
84
  * `client.subscribe_to_user_personal_channel.personal_channel_namespace`.
@@ -1 +1 @@
1
- {"version":3,"file":"centrifugo.d.mts","names":[],"sources":["../src/centrifugo.ts"],"mappings":";;;iBA4BiB;;EAEf;;EAEA;;EAEA,eAAe;;;;;;EAMf;;;iBAIe;;EAEf,QAAQ,iBAAiB,gBAAgB;;EAEzC,UAAU,oBAAoB,gBAAgB;;EAE9C,UAAU,cAAc,kBAAkB;;EAE1C,WAAW,eAAe;;;qBAIf,2BAA2B;WAE3B;WACA;EAFX,YACW,gBACA,cACT;;wBAOY,mBACd,KACA,QACA,OAAO,WACP,aACC,0BAA0B;iBA6BZ;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;wBASc,kBACd,QACA,KACA,kBACA,MACA,YACC;;YAcS;EACN;IAAU;;;EACV;IAAc;IAAc;;;EAC5B;IAAS;IAAc;;;;;;;;;;;;;wBAYP,kBAAkB,KACtC,SAAS,KACT,cAAc,SAAS,QAAQ,QAAQ,8BAA8B,6BACpE,QAAQ;;qBAYE,sCAAU,eAAA;iBAEN,iCAAiC;;;;;;EAMhD;;;;;;;;;qBAUW,6CAAiB,eAAA"}
1
+ {"version":3,"file":"centrifugo.d.mts","names":["_$_forinda_kickjs_di0.InjectionToken"],"sources":["../src/centrifugo.ts"],"mappings":";;;iBA4BiB;;EAEf;;EAEA;;EAEA,eAAe;;;;;;EAMf;;;iBAIe;;EAEf,QAAQ,iBAAiB,gBAAgB;;EAEzC,UAAU,oBAAoB,gBAAgB;;EAE9C,UAAU,cAAc,kBAAkB;;EAE1C,WAAW,eAAe;;;qBAIf,2BAA2B;WAE3B;WACA;EAFX,YACW,gBACA,cACT;;wBAOY,mBACd,KACA,QACA,OAAO,WACP,aACC,0BAA0B;iBA6BZ;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;wBASc,kBACd,QACA,KACA,kBACA,MACA,YACC;;YAcS;EACN;IAAU;;;EACV;IAAc;IAAc;;;EAC5B;IAAS;IAAc;;;;;;;;;;;;;wBAYP,kBAAkB,KACtC,SAAS,KACT,cAAc,SAAS,QAAQ,QAAQ,8BAA8B,6BACpE,QAAQ;;qBAYE,YAAUA,eAAA;iBAEN,iCAAiC;;;;;;EAMhD;;;;;;;;;qBAUW,6CAAiB,eAAA"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.1
2
+ * @forinda/kickjs-ws v7.2.2
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-CjTywEet.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-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};
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-taaD_-I8.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-DmgYiknr.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.1
2
+ * @forinda/kickjs-ws v7.2.2
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-CjTywEet.mjs";import{n as RoomManager,r as WsContext}from"./room-manager-CrLn-g5b.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-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
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,6 +1,92 @@
1
1
 
2
2
  import { WebSocket } from "ws";
3
+ import "reflect-metadata";
3
4
  import { IncomingMessage } from "node:http";
5
+ //#region ../di/dist/index.d.mts
6
+ //#endregion
7
+ //#region src/token.d.ts
8
+ /**
9
+ * Collision-safe injection tokens with phantom type parameters.
10
+ *
11
+ * `createToken<T>(name)` is the recommended way to declare any DI token
12
+ * that isn't a class. Each call returns a unique frozen object — even if
13
+ * two files write `createToken<X>('Logger')`, they produce two distinct
14
+ * references that the container treats as different tokens. Collisions
15
+ * become impossible by construction, not by convention.
16
+ *
17
+ * The phantom type parameter `T` lets `container.resolve(token)` infer
18
+ * the correct return type without any codegen.
19
+ *
20
+ * ## Hardening layers
21
+ *
22
+ * KickJS has four DI token kinds, listed from safest to riskiest:
23
+ *
24
+ * 1. **Class identity** — `container.resolve(UserService)`. Reference
25
+ * equality, never collides. Type-safe via `Constructor<T>` overload.
26
+ * 2. **`createToken<T>(name)`** — frozen object identity, never collides.
27
+ * Type-safe via the `InjectionToken<T>` overload.
28
+ * 3. **Symbol** — `Symbol('foo')` is unique per call but `Symbol.for('foo')`
29
+ * is interned and CAN collide. Discouraged.
30
+ * 4. **Raw string `@Inject('foo')`** — high collision risk, untyped.
31
+ * Reserved for legacy code and runtime-computed token names.
32
+ *
33
+ * Prefer (1) and (2). Use (4) only when you have to.
34
+ *
35
+ * @example
36
+ * ```ts
37
+ * // src/tokens.ts
38
+ * export const DATABASE_URL = createToken<string>('config.database.url')
39
+ * export const FEATURE_FLAGS = createToken<FeatureFlags>('app.features')
40
+ *
41
+ * // bootstrap
42
+ * container.registerInstance(DATABASE_URL, process.env.DATABASE_URL!)
43
+ *
44
+ * // anywhere else
45
+ * const url = container.resolve(DATABASE_URL) // typed as `string`
46
+ * ```
47
+ *
48
+ * @module @forinda/kickjs/core/token
49
+ */
50
+ /**
51
+ * Symbol marker stamped on every InjectionToken so the container can
52
+ * detect them at runtime regardless of which package created them.
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.
57
+ */
58
+ declare const INJECTION_TOKEN: unique symbol;
59
+ /**
60
+ * A type-safe DI token. Each `createToken()` call returns a unique frozen
61
+ * object identified by reference, not by the `name` string. Two
62
+ * `createToken<X>('foo')` calls in different files produce two distinct
63
+ * tokens that the container treats independently.
64
+ *
65
+ * The phantom `_type` parameter is never assigned at runtime — it exists
66
+ * solely to thread the type through `container.resolve(token)`.
67
+ */
68
+ interface InjectionToken<T> {
69
+ readonly [INJECTION_TOKEN]: true;
70
+ /** Descriptive name used in error messages, logs, and devtools */
71
+ readonly name: string;
72
+ /** Phantom — never assigned at runtime */
73
+ readonly _type?: T;
74
+ }
75
+ /**
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.
85
+ */
86
+ declare global {
87
+ interface KickEnv {}
88
+ }
89
+ //#endregion
4
90
  //#region src/room-manager.d.ts
5
91
  declare class RoomManager {
6
92
  private readonly onSend?;
@@ -160,11 +246,11 @@ interface WsUserBroadcaster {
160
246
  roomFor(userId: string): string;
161
247
  }
162
248
  /** DI token for the live {@link WsAdapter} instance. */
163
- declare const WS_ADAPTER: import("@forinda/kickjs").InjectionToken<unknown>;
249
+ declare const WS_ADAPTER: InjectionToken<unknown>;
164
250
  /** DI token for the shared {@link RoomManager}. */
165
- declare const WS_ROOM_MANAGER: import("@forinda/kickjs").InjectionToken<RoomManager>;
251
+ declare const WS_ROOM_MANAGER: InjectionToken<RoomManager>;
166
252
  /** DI token for the per-user broadcaster helper. */
167
- declare const WS_USER_BROADCASTER: import("@forinda/kickjs").InjectionToken<WsUserBroadcaster>;
253
+ declare const WS_USER_BROADCASTER: InjectionToken<WsUserBroadcaster>;
168
254
  //#endregion
169
- export { WsAdapterOptions as a, WsBroker as c, WsHandlerType as d, WsUserBroadcaster as f, WS_USER_BROADCASTER as i, WsBrokerMessage as l, 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 };
170
- //# sourceMappingURL=interfaces-taaD_-I8.d.mts.map
255
+ 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
@@ -0,0 +1 @@
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"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.1
2
+ * @forinda/kickjs-ws v7.2.2
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-CjTywEet.mjs.map
12
+ //# sourceMappingURL=interfaces-b-7CXldq.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"interfaces-CjTywEet.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-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"}
package/dist/redis.d.mts CHANGED
@@ -1,5 +1,5 @@
1
1
 
2
- import { c as WsBroker } from "./interfaces-taaD_-I8.mjs";
2
+ import { c as WsBroker } from "./interfaces-DmgYiknr.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 {
@@ -8,6 +8,8 @@ export interface RedisPubSubClient {
8
8
  unsubscribe(channel: string): unknown;
9
9
  on(event: 'message', listener: (channel: string, message: string) => void): unknown;
10
10
  off?(event: 'message', listener: (channel: string, message: string) => void): unknown;
11
+ /** ioredis connection status — `'end'` once the client has quit. */
12
+ status?: string;
11
13
  }
12
14
  export interface RedisBrokerOptions {
13
15
  /** Connection used for `PUBLISH`. Can be shared with the rest of the app. */
@@ -21,8 +23,9 @@ export interface RedisBrokerOptions {
21
23
  channel?: string;
22
24
  }
23
25
  /**
24
- * Both connections stay the caller's: `shutdown` unsubscribes but does not
25
- * quit them, since the publisher is often the app's shared client.
26
+ * Both connections stay the caller's: `close` unsubscribes but does not quit
27
+ * them, since the publisher is often the app's shared client. If the app has
28
+ * already quit the subscriber, `close` has nothing to do and doesn't throw.
26
29
  */
27
30
  export declare function redisBroker({ publisher, subscriber, channel }: RedisBrokerOptions): WsBroker;
28
31
  //#endregion
@@ -1 +1 @@
1
- {"version":3,"file":"redis.d.mts","names":[],"sources":["../src/redis.ts"],"mappings":";;;;iBAmBiB;EACf,QAAQ,iBAAiB;EACzB,UAAU;EACV,YAAY;EACZ,GAAG,kBAAkB,WAAW,iBAAiB;EACjD,KAAK,kBAAkB,WAAW,iBAAiB;;iBAGpC;;EAEf,WAAW;;;;;EAKX,YAAY;;EAEZ;;;;;;wBAOc,cACd,WACA,YACA,WACC,qBAAqB"}
1
+ {"version":3,"file":"redis.d.mts","names":[],"sources":["../src/redis.ts"],"mappings":";;;;iBAmBiB;EACf,QAAQ,iBAAiB;EACzB,UAAU;EACV,YAAY;EACZ,GAAG,kBAAkB,WAAW,iBAAiB;EACjD,KAAK,kBAAkB,WAAW,iBAAiB;;EAEnD;;iBAGe;;EAEf,WAAW;;;;;EAKX,YAAY;;EAEZ;;;;;;;wBAQc,cACd,WACA,YACA,WACC,qBAAqB"}
package/dist/redis.mjs CHANGED
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.1
2
+ * @forinda/kickjs-ws v7.2.2
3
3
  *
4
4
  * Copyright (c) Felix Orinda
5
5
  *
@@ -8,5 +8,5 @@
8
8
  *
9
9
  * @license MIT
10
10
  */
11
- function redisBroker({publisher,subscriber,channel=`kickjs:ws`}){let listener;return{async publish(message){await publisher.publish(channel,JSON.stringify(message))},async subscribe(onMessage){listener=(from,raw)=>{if(from!==channel)return;let message;try{message=JSON.parse(raw)}catch{return}onMessage(message)},subscriber.on(`message`,listener),await subscriber.subscribe(channel)},async close(){listener&&subscriber.off?.(`message`,listener),await subscriber.unsubscribe(channel)}}}export{redisBroker};
11
+ function redisBroker({publisher,subscriber,channel=`kickjs:ws`}){let listener;return{async publish(message){await publisher.publish(channel,JSON.stringify(message))},async subscribe(onMessage){listener=(from,raw)=>{if(from!==channel)return;let message;try{message=JSON.parse(raw)}catch{return}onMessage(message)},subscriber.on(`message`,listener),await subscriber.subscribe(channel)},async close(){listener&&subscriber.off?.(`message`,listener);try{await subscriber.unsubscribe(channel)}catch(err){if(!(subscriber.status===`end`||/Connection is closed/i.test(String(err?.message))))throw err}}}}export{redisBroker};
12
12
  //# sourceMappingURL=redis.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"redis.mjs","names":[],"sources":["../src/redis.ts"],"sourcesContent":["/**\n * Redis pub/sub broker for {@link WsAdapter} — rooms, namespace broadcasts and\n * per-user sends reach sockets on every instance.\n *\n * ```ts\n * import Redis from 'ioredis'\n * import { getEnv } from '@forinda/kickjs'\n * import { WsAdapter } from '@forinda/kickjs-ws'\n * import { redisBroker } from '@forinda/kickjs-ws/redis'\n *\n * const redis = new Redis(getEnv('REDIS_URL'))\n * WsAdapter({ broker: redisBroker({ publisher: redis, subscriber: redis.duplicate() }) })\n * ```\n *\n * @module @forinda/kickjs-ws/redis\n */\nimport type { WsBroker, WsBrokerMessage } from './interfaces'\n\n/** The part of a Redis client the broker calls. An ioredis client fits as-is. */\nexport interface RedisPubSubClient {\n publish(channel: string, message: string): unknown\n subscribe(channel: string): unknown\n unsubscribe(channel: string): unknown\n on(event: 'message', listener: (channel: string, message: string) => void): unknown\n off?(event: 'message', listener: (channel: string, message: string) => void): unknown\n}\n\nexport interface RedisBrokerOptions {\n /** Connection used for `PUBLISH`. Can be shared with the rest of the app. */\n publisher: RedisPubSubClient\n /**\n * A separate connection — a Redis connection in subscribe mode cannot run\n * other commands. With ioredis, `publisher.duplicate()`.\n */\n subscriber: RedisPubSubClient\n /** Channel shared by every instance of one app. Default `kickjs:ws`; change it to run two apps on one Redis. */\n channel?: string\n}\n\n/**\n * Both connections stay the caller's: `shutdown` unsubscribes but does not\n * quit them, since the publisher is often the app's shared client.\n */\nexport function redisBroker({\n publisher,\n subscriber,\n channel = 'kickjs:ws',\n}: RedisBrokerOptions): WsBroker {\n let listener: ((channel: string, message: string) => void) | undefined\n\n return {\n async publish(message) {\n await publisher.publish(channel, JSON.stringify(message))\n },\n\n async subscribe(onMessage) {\n listener = (from, raw) => {\n if (from !== channel) return\n let message: unknown\n try {\n message = JSON.parse(raw)\n } catch {\n return // not ours — another publisher on the same channel\n }\n // Valid JSON is not a valid message (`null`, `42`, a foreign object).\n // WsAdapter checks the shape before using it, for every broker, so this\n // only passes it on.\n onMessage(message as WsBrokerMessage)\n }\n subscriber.on('message', listener)\n await subscriber.subscribe(channel)\n },\n\n async close() {\n if (listener) subscriber.off?.('message', listener)\n await subscriber.unsubscribe(channel)\n },\n }\n}\n"],"mappings":";;;;;;;;;;AA2CA,SAAgB,YAAY,CAC1B,UACA,WACA,QAAU,aACqB,CAC/B,IAAI,SAEJ,MAAO,CACL,MAAM,QAAQ,QAAS,CACrB,MAAM,UAAU,QAAQ,QAAS,KAAK,UAAU,OAAO,CAAC,CAC1D,EAEA,MAAM,UAAU,UAAW,CACzB,UAAY,KAAM,MAAQ,CACxB,GAAI,OAAS,QAAS,OACtB,IAAI,QACJ,GAAI,CACF,QAAU,KAAK,MAAM,GAAG,CAC1B,MAAQ,CACN,MACF,CAIA,UAAU,OAA0B,CACtC,EACA,WAAW,GAAG,UAAW,QAAQ,EACjC,MAAM,WAAW,UAAU,OAAO,CACpC,EAEA,MAAM,OAAQ,CACR,UAAU,WAAW,MAAM,UAAW,QAAQ,EAClD,MAAM,WAAW,YAAY,OAAO,CACtC,CACF,CACF"}
1
+ {"version":3,"file":"redis.mjs","names":[],"sources":["../src/redis.ts"],"sourcesContent":["/**\n * Redis pub/sub broker for {@link WsAdapter} — rooms, namespace broadcasts and\n * per-user sends reach sockets on every instance.\n *\n * ```ts\n * import Redis from 'ioredis'\n * import { getEnv } from '@forinda/kickjs'\n * import { WsAdapter } from '@forinda/kickjs-ws'\n * import { redisBroker } from '@forinda/kickjs-ws/redis'\n *\n * const redis = new Redis(getEnv('REDIS_URL'))\n * WsAdapter({ broker: redisBroker({ publisher: redis, subscriber: redis.duplicate() }) })\n * ```\n *\n * @module @forinda/kickjs-ws/redis\n */\nimport type { WsBroker, WsBrokerMessage } from './interfaces'\n\n/** The part of a Redis client the broker calls. An ioredis client fits as-is. */\nexport interface RedisPubSubClient {\n publish(channel: string, message: string): unknown\n subscribe(channel: string): unknown\n unsubscribe(channel: string): unknown\n on(event: 'message', listener: (channel: string, message: string) => void): unknown\n off?(event: 'message', listener: (channel: string, message: string) => void): unknown\n /** ioredis connection status — `'end'` once the client has quit. */\n status?: string\n}\n\nexport interface RedisBrokerOptions {\n /** Connection used for `PUBLISH`. Can be shared with the rest of the app. */\n publisher: RedisPubSubClient\n /**\n * A separate connection — a Redis connection in subscribe mode cannot run\n * other commands. With ioredis, `publisher.duplicate()`.\n */\n subscriber: RedisPubSubClient\n /** Channel shared by every instance of one app. Default `kickjs:ws`; change it to run two apps on one Redis. */\n channel?: string\n}\n\n/**\n * Both connections stay the caller's: `close` unsubscribes but does not quit\n * them, since the publisher is often the app's shared client. If the app has\n * already quit the subscriber, `close` has nothing to do and doesn't throw.\n */\nexport function redisBroker({\n publisher,\n subscriber,\n channel = 'kickjs:ws',\n}: RedisBrokerOptions): WsBroker {\n let listener: ((channel: string, message: string) => void) | undefined\n\n return {\n async publish(message) {\n await publisher.publish(channel, JSON.stringify(message))\n },\n\n async subscribe(onMessage) {\n listener = (from, raw) => {\n if (from !== channel) return\n let message: unknown\n try {\n message = JSON.parse(raw)\n } catch {\n return // not ours — another publisher on the same channel\n }\n // Valid JSON is not a valid message (`null`, `42`, a foreign object).\n // WsAdapter checks the shape before using it, for every broker, so this\n // only passes it on.\n onMessage(message as WsBrokerMessage)\n }\n subscriber.on('message', listener)\n await subscriber.subscribe(channel)\n },\n\n async close() {\n if (listener) subscriber.off?.('message', listener)\n try {\n await subscriber.unsubscribe(channel)\n } catch (err) {\n // The app quit the connection first — its own shutdown runs beside\n // this one. A closed connection holds no subscription to remove. Any\n // other failure on a live connection leaves the subscription behind,\n // so it is not swallowed.\n const closed =\n subscriber.status === 'end' ||\n /Connection is closed/i.test(String((err as Error)?.message))\n if (!closed) throw err\n }\n },\n }\n}\n"],"mappings":";;;;;;;;;;AA8CA,SAAgB,YAAY,CAC1B,UACA,WACA,QAAU,aACqB,CAC/B,IAAI,SAEJ,MAAO,CACL,MAAM,QAAQ,QAAS,CACrB,MAAM,UAAU,QAAQ,QAAS,KAAK,UAAU,OAAO,CAAC,CAC1D,EAEA,MAAM,UAAU,UAAW,CACzB,UAAY,KAAM,MAAQ,CACxB,GAAI,OAAS,QAAS,OACtB,IAAI,QACJ,GAAI,CACF,QAAU,KAAK,MAAM,GAAG,CAC1B,MAAQ,CACN,MACF,CAIA,UAAU,OAA0B,CACtC,EACA,WAAW,GAAG,UAAW,QAAQ,EACjC,MAAM,WAAW,UAAU,OAAO,CACpC,EAEA,MAAM,OAAQ,CACR,UAAU,WAAW,MAAM,UAAW,QAAQ,EAClD,GAAI,CACF,MAAM,WAAW,YAAY,OAAO,CACtC,OAAS,IAAK,CAQZ,GAAI,EAFF,WAAW,SAAW,OACtB,wBAAwB,KAAK,OAAQ,KAAe,OAAO,CAAC,GACjD,MAAM,GACrB,CACF,CACF,CACF"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.1
2
+ * @forinda/kickjs-ws v7.2.2
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-CrLn-g5b.mjs.map
12
+ //# sourceMappingURL=room-manager-CD-OQhwc.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"room-manager-CrLn-g5b.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-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,10 +1,10 @@
1
1
 
2
- import { o as WsAuthConfig } from "./interfaces-taaD_-I8.mjs";
2
+ import { m as InjectionToken, o as WsAuthConfig } from "./interfaces-DmgYiknr.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
6
6
  /** DI token for the Socket.IO `Server`. */
7
- export declare const SOCKET_IO: import("@forinda/kickjs").InjectionToken<Server<import("socket.io").DefaultEventsMap, import("socket.io").DefaultEventsMap, import("socket.io").DefaultEventsMap, any>>;
7
+ export declare const SOCKET_IO: InjectionToken<Server<import("socket.io").DefaultEventsMap, import("socket.io").DefaultEventsMap, import("socket.io").DefaultEventsMap, any>>;
8
8
  /** Socket.IO server options (`cors`, `path`, `adapter`, …) plus the shared auth hook. */
9
9
  export interface SocketIoAdapterOptions extends Partial<ServerOptions> {
10
10
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"socket-io.d.mts","names":[],"sources":["../src/socket-io.ts"],"mappings":";;;;;;qBA0Ca,qCAAS,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;;;;;;;;;;;;qBAkB7B,2CAAe,eAAA"}
@@ -1,5 +1,5 @@
1
1
  /**
2
- * @forinda/kickjs-ws v7.2.1
2
+ * @forinda/kickjs-ws v7.2.2
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-CjTywEet.mjs";import{i as parseCookies,t as MAX_ROOMS_PER_SOCKET}from"./room-manager-CrLn-g5b.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-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};
12
12
  //# sourceMappingURL=socket-io.mjs.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@forinda/kickjs-ws",
3
- "version": "7.2.1",
3
+ "version": "7.2.2",
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",
@@ -57,7 +57,7 @@
57
57
  "typescript": "^7.0.2",
58
58
  "vitest": "^5.0.3",
59
59
  "ws": "^8.22.0",
60
- "@forinda/kickjs": "10.2.0"
60
+ "@forinda/kickjs": "10.4.0"
61
61
  },
62
62
  "publishConfig": {
63
63
  "access": "public"
@@ -1 +0,0 @@
1
- {"version":3,"file":"interfaces-taaD_-I8.d.mts","names":[],"sources":["../src/room-manager.ts","../src/interfaces.ts"],"mappings":";;;;cAmBa;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,sCAAU;;cAEV,2CAAe,eAAA;;cAEf,+CAAmB,eAAA"}