@venizia/ignis-helpers 0.3.6 → 0.4.1

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.
Files changed (246) hide show
  1. package/LICENSE.md +1 -1
  2. package/dist/cjs/common/redact.js +1 -1
  3. package/dist/cjs/common/redact.js.map +1 -1
  4. package/dist/cjs/modules/base.js +1 -1
  5. package/dist/cjs/modules/base.js.map +1 -1
  6. package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js +1 -1
  7. package/dist/cjs/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  8. package/dist/cjs/modules/logger/common/constants.js +1 -1
  9. package/dist/cjs/modules/logger/common/constants.js.map +1 -1
  10. package/dist/cjs/modules/logger/factory.js +1 -1
  11. package/dist/cjs/modules/logger/factory.js.map +1 -1
  12. package/dist/cjs/modules/logger/formatting/deep-splat.js +1 -1
  13. package/dist/cjs/modules/logger/formatting/deep-splat.js.map +1 -1
  14. package/dist/cjs/modules/logger/formatting/error-prettier.js +4 -4
  15. package/dist/cjs/modules/logger/formatting/error-prettier.js.map +1 -1
  16. package/dist/cjs/modules/logger/hf/flusher.js +3 -3
  17. package/dist/cjs/modules/logger/hf/flusher.js.map +1 -1
  18. package/dist/cjs/modules/logger/resolver.js +3 -3
  19. package/dist/cjs/modules/logger/resolver.js.map +1 -1
  20. package/dist/cjs/modules/logger/winston/formatters/deep-splat.js +1 -1
  21. package/dist/cjs/modules/logger/winston/formatters/deep-splat.js.map +1 -1
  22. package/dist/cjs/modules/logger/winston/logger-factory.js +1 -1
  23. package/dist/cjs/modules/logger/winston/logger-factory.js.map +1 -1
  24. package/dist/cjs/modules/logger/winston/transports/dgram.transport.js +2 -2
  25. package/dist/cjs/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  26. package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
  27. package/dist/cjs/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  28. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
  29. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
  30. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js +3 -0
  31. package/dist/cjs/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  32. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
  33. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  34. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js +34 -11
  35. package/dist/cjs/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  36. package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  37. package/dist/cjs/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  38. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
  39. package/dist/cjs/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  40. package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js +1 -1
  41. package/dist/cjs/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  42. package/dist/cjs/modules/network/utilities/query-string.d.ts +27 -2
  43. package/dist/cjs/modules/network/utilities/query-string.d.ts.map +1 -1
  44. package/dist/cjs/modules/network/utilities/query-string.js +34 -2
  45. package/dist/cjs/modules/network/utilities/query-string.js.map +1 -1
  46. package/dist/cjs/modules/network/utilities/url-safety/ingest.js +1 -1
  47. package/dist/cjs/modules/network/utilities/url-safety/ingest.js.map +1 -1
  48. package/dist/cjs/modules/network/utilities/url-safety/policy.js +1 -1
  49. package/dist/cjs/modules/network/utilities/url-safety/policy.js.map +1 -1
  50. package/dist/cjs/modules/pool/abstract.js +4 -4
  51. package/dist/cjs/modules/pool/abstract.js.map +1 -1
  52. package/dist/cjs/modules/queue/bullmq/helper.js +2 -2
  53. package/dist/cjs/modules/queue/bullmq/helper.js.map +1 -1
  54. package/dist/cjs/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
  55. package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
  56. package/dist/cjs/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
  57. package/dist/cjs/modules/queue/kafka/consumer.js +2 -2
  58. package/dist/cjs/modules/queue/kafka/consumer.js.map +1 -1
  59. package/dist/cjs/modules/queue/mqtt/helper.js +4 -4
  60. package/dist/cjs/modules/queue/mqtt/helper.js.map +1 -1
  61. package/dist/cjs/modules/redis/base/abstract.helper.js +4 -4
  62. package/dist/cjs/modules/redis/base/abstract.helper.js.map +1 -1
  63. package/dist/cjs/modules/redis/cluster/cluster.helper.js +1 -1
  64. package/dist/cjs/modules/redis/cluster/cluster.helper.js.map +1 -1
  65. package/dist/cjs/modules/redis/sentinel/sentinel.helper.js +1 -1
  66. package/dist/cjs/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  67. package/dist/cjs/modules/secrets/base/abstract.helper.js +2 -2
  68. package/dist/cjs/modules/secrets/base/abstract.helper.js.map +1 -1
  69. package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
  70. package/dist/cjs/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  71. package/dist/cjs/modules/socket/socket-io/browser.d.ts +5 -0
  72. package/dist/cjs/modules/socket/socket-io/browser.d.ts.map +1 -0
  73. package/dist/cjs/modules/socket/socket-io/browser.js +21 -0
  74. package/dist/cjs/modules/socket/socket-io/browser.js.map +1 -0
  75. package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
  76. package/dist/cjs/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
  77. package/dist/cjs/modules/socket/socket-io/client/browser-helper.js +250 -0
  78. package/dist/cjs/modules/socket/socket-io/client/browser-helper.js.map +1 -0
  79. package/dist/cjs/modules/socket/socket-io/client/helper.d.ts +8 -51
  80. package/dist/cjs/modules/socket/socket-io/client/helper.d.ts.map +1 -1
  81. package/dist/cjs/modules/socket/socket-io/client/helper.js +12 -230
  82. package/dist/cjs/modules/socket/socket-io/client/helper.js.map +1 -1
  83. package/dist/cjs/modules/socket/socket-io/server/helper.js +5 -5
  84. package/dist/cjs/modules/socket/socket-io/server/helper.js.map +1 -1
  85. package/dist/cjs/modules/socket/websocket/server/delivery.js +2 -2
  86. package/dist/cjs/modules/socket/websocket/server/delivery.js.map +1 -1
  87. package/dist/cjs/modules/socket/websocket/server/helper.js +4 -4
  88. package/dist/cjs/modules/socket/websocket/server/helper.js.map +1 -1
  89. package/dist/cjs/modules/storage/base.js +3 -3
  90. package/dist/cjs/modules/storage/base.js.map +1 -1
  91. package/dist/cjs/modules/storage/bun-s3/helper.js +1 -1
  92. package/dist/cjs/modules/storage/bun-s3/helper.js.map +1 -1
  93. package/dist/cjs/modules/storage/bun-s3/utility.js +6 -6
  94. package/dist/cjs/modules/storage/bun-s3/utility.js.map +1 -1
  95. package/dist/cjs/modules/storage/common/errors.js +1 -1
  96. package/dist/cjs/modules/storage/common/errors.js.map +1 -1
  97. package/dist/cjs/modules/storage/minio/helper.js +4 -4
  98. package/dist/cjs/modules/storage/minio/helper.js.map +1 -1
  99. package/dist/cjs/modules/temporal/abstract.js +5 -5
  100. package/dist/cjs/modules/temporal/abstract.js.map +1 -1
  101. package/dist/cjs/modules/temporal/adapters/intl.d.ts.map +1 -1
  102. package/dist/cjs/modules/temporal/adapters/intl.js +3 -1
  103. package/dist/cjs/modules/temporal/adapters/intl.js.map +1 -1
  104. package/dist/cjs/modules/temporal/locale/locale.js +4 -4
  105. package/dist/cjs/modules/temporal/locale/locale.js.map +1 -1
  106. package/dist/cjs/modules/tree/builder.js +2 -2
  107. package/dist/cjs/modules/tree/builder.js.map +1 -1
  108. package/dist/cjs/modules/uid/opaque.js +2 -2
  109. package/dist/cjs/modules/uid/opaque.js.map +1 -1
  110. package/dist/cjs/modules/uid/uuid/v5.js +1 -1
  111. package/dist/cjs/modules/uid/uuid/v5.js.map +1 -1
  112. package/dist/cjs/modules/worker-thread/bus/base.js +4 -4
  113. package/dist/cjs/modules/worker-thread/bus/base.js.map +1 -1
  114. package/dist/cjs/modules/worker-thread/worker/base.js +4 -4
  115. package/dist/cjs/modules/worker-thread/worker/base.js.map +1 -1
  116. package/dist/cjs/utilities/parse.utility.js +4 -4
  117. package/dist/cjs/utilities/parse.utility.js.map +1 -1
  118. package/dist/cjs/utilities/promise.utility.js +1 -1
  119. package/dist/cjs/utilities/promise.utility.js.map +1 -1
  120. package/dist/cjs/utilities/request.utility.js +1 -1
  121. package/dist/cjs/utilities/request.utility.js.map +1 -1
  122. package/dist/cjs/utilities/sleep.utility.js +1 -1
  123. package/dist/cjs/utilities/sleep.utility.js.map +1 -1
  124. package/dist/esm/common/redact.js +1 -1
  125. package/dist/esm/common/redact.js.map +1 -1
  126. package/dist/esm/modules/base.js +1 -1
  127. package/dist/esm/modules/base.js.map +1 -1
  128. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js +1 -1
  129. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  130. package/dist/esm/modules/logger/common/constants.js +1 -1
  131. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  132. package/dist/esm/modules/logger/factory.js +1 -1
  133. package/dist/esm/modules/logger/factory.js.map +1 -1
  134. package/dist/esm/modules/logger/formatting/deep-splat.js +1 -1
  135. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  136. package/dist/esm/modules/logger/formatting/error-prettier.js +4 -4
  137. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  138. package/dist/esm/modules/logger/hf/flusher.js +3 -3
  139. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  140. package/dist/esm/modules/logger/resolver.js +3 -3
  141. package/dist/esm/modules/logger/resolver.js.map +1 -1
  142. package/dist/esm/modules/logger/winston/formatters/deep-splat.js +1 -1
  143. package/dist/esm/modules/logger/winston/formatters/deep-splat.js.map +1 -1
  144. package/dist/esm/modules/logger/winston/logger-factory.js +1 -1
  145. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  146. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +2 -2
  147. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  148. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +1 -1
  149. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  150. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +17 -14
  151. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +1 -1
  152. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js +3 -0
  153. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  154. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +13 -4
  155. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  156. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +36 -13
  157. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  158. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  159. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  160. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
  161. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  162. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +1 -1
  163. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  164. package/dist/esm/modules/network/utilities/query-string.d.ts +27 -2
  165. package/dist/esm/modules/network/utilities/query-string.d.ts.map +1 -1
  166. package/dist/esm/modules/network/utilities/query-string.js +31 -1
  167. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  168. package/dist/esm/modules/network/utilities/url-safety/ingest.js +1 -1
  169. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  170. package/dist/esm/modules/network/utilities/url-safety/policy.js +1 -1
  171. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  172. package/dist/esm/modules/pool/abstract.js +4 -4
  173. package/dist/esm/modules/pool/abstract.js.map +1 -1
  174. package/dist/esm/modules/queue/bullmq/helper.js +2 -2
  175. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  176. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +1 -1
  177. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +1 -1
  178. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +1 -1
  179. package/dist/esm/modules/queue/kafka/consumer.js +2 -2
  180. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  181. package/dist/esm/modules/queue/mqtt/helper.js +4 -4
  182. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  183. package/dist/esm/modules/redis/base/abstract.helper.js +4 -4
  184. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  185. package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -1
  186. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  187. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -1
  188. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  189. package/dist/esm/modules/secrets/base/abstract.helper.js +2 -2
  190. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  191. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +2 -2
  192. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  193. package/dist/esm/modules/socket/socket-io/browser.d.ts +5 -0
  194. package/dist/esm/modules/socket/socket-io/browser.d.ts.map +1 -0
  195. package/dist/esm/modules/socket/socket-io/browser.js +5 -0
  196. package/dist/esm/modules/socket/socket-io/browser.js.map +1 -0
  197. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts +61 -0
  198. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +1 -0
  199. package/dist/esm/modules/socket/socket-io/client/browser-helper.js +246 -0
  200. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -0
  201. package/dist/esm/modules/socket/socket-io/client/helper.d.ts +8 -51
  202. package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +1 -1
  203. package/dist/esm/modules/socket/socket-io/client/helper.js +12 -230
  204. package/dist/esm/modules/socket/socket-io/client/helper.js.map +1 -1
  205. package/dist/esm/modules/socket/socket-io/server/helper.js +5 -5
  206. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  207. package/dist/esm/modules/socket/websocket/server/delivery.js +2 -2
  208. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  209. package/dist/esm/modules/socket/websocket/server/helper.js +4 -4
  210. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  211. package/dist/esm/modules/storage/base.js +3 -3
  212. package/dist/esm/modules/storage/base.js.map +1 -1
  213. package/dist/esm/modules/storage/bun-s3/helper.js +1 -1
  214. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  215. package/dist/esm/modules/storage/bun-s3/utility.js +6 -6
  216. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  217. package/dist/esm/modules/storage/common/errors.js +1 -1
  218. package/dist/esm/modules/storage/common/errors.js.map +1 -1
  219. package/dist/esm/modules/storage/minio/helper.js +4 -4
  220. package/dist/esm/modules/storage/minio/helper.js.map +1 -1
  221. package/dist/esm/modules/temporal/abstract.js +5 -5
  222. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  223. package/dist/esm/modules/temporal/adapters/intl.d.ts.map +1 -1
  224. package/dist/esm/modules/temporal/adapters/intl.js +3 -1
  225. package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
  226. package/dist/esm/modules/temporal/locale/locale.js +4 -4
  227. package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
  228. package/dist/esm/modules/tree/builder.js +2 -2
  229. package/dist/esm/modules/tree/builder.js.map +1 -1
  230. package/dist/esm/modules/uid/opaque.js +2 -2
  231. package/dist/esm/modules/uid/opaque.js.map +1 -1
  232. package/dist/esm/modules/uid/uuid/v5.js +1 -1
  233. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  234. package/dist/esm/modules/worker-thread/bus/base.js +4 -4
  235. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  236. package/dist/esm/modules/worker-thread/worker/base.js +4 -4
  237. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  238. package/dist/esm/utilities/parse.utility.js +4 -4
  239. package/dist/esm/utilities/parse.utility.js.map +1 -1
  240. package/dist/esm/utilities/promise.utility.js +1 -1
  241. package/dist/esm/utilities/promise.utility.js.map +1 -1
  242. package/dist/esm/utilities/request.utility.js +1 -1
  243. package/dist/esm/utilities/request.utility.js.map +1 -1
  244. package/dist/esm/utilities/sleep.utility.js +1 -1
  245. package/dist/esm/utilities/sleep.utility.js.map +1 -1
  246. package/package.json +69 -64
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/client/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport type { Socket } from 'socket.io-client';\nimport {\n type IOptions,\n type ISocketIOClientOptions,\n SocketIOClientStates,\n SocketIOConstants,\n type TSocketIOEventHandler,\n type TSocketIOClientState,\n} from '../common';\n\nexport class SocketIOClientHelper extends BaseHelper {\n private host: string;\n private options: IOptions;\n private client: Socket;\n private state: TSocketIOClientState = SocketIOClientStates.UNAUTHORIZED;\n\n // subscribe() registers a wrapper, never the caller handler: without this map unsubscribe() has nothing to hand to socket.off() and the listener stays bound forever\n private wrappedHandlers: Map<string, Map<TSocketIOEventHandler<any>, (data: any) => void>> =\n new Map();\n\n private onConnected?: () => ValueOrPromise<void>;\n private onDisconnected?: (reason: string) => ValueOrPromise<void>;\n private onError?: (error: Error) => ValueOrPromise<void>;\n private onAuthenticated?: () => ValueOrPromise<void>;\n private onUnauthenticated?: (message: string) => ValueOrPromise<void>;\n\n private readonly clientModule?: typeof import('socket.io-client');\n\n constructor(opts: ISocketIOClientOptions) {\n super({ scope: opts.identifier });\n\n this.identifier = opts.identifier;\n this.host = opts.host;\n this.options = opts.options;\n this.clientModule = opts.module;\n\n this.onConnected = opts.onConnected;\n this.onDisconnected = opts.onDisconnected;\n this.onError = opts.onError;\n this.onAuthenticated = opts.onAuthenticated;\n this.onUnauthenticated = opts.onUnauthenticated;\n\n this.configure();\n }\n\n getState(): TSocketIOClientState {\n return this.state;\n }\n\n configure() {\n const logger = this.logger.for(this.configure.name);\n\n if (this.client) {\n logger.info('SocketIO Client already established | id: %s', this.identifier);\n return;\n }\n\n // `socket.io-client` is an optional peer: loaded on connect, so a server that only imports the\n // server helper from this entry never needs it installed.\n const { io } =\n this.clientModule ??\n ModuleUtility.loadSync<typeof import('socket.io-client')>({ module: 'socket.io-client' });\n this.client = io(this.host, this.options);\n\n // Socket.IO client fires 'connect', NOT 'connection' (server-side only)\n this.client.on('connect', () => {\n logger.info('Connected | id: %s', this.identifier);\n\n Promise.resolve(this.onConnected?.()).catch(error => {\n logger.error('onConnected callback error | error: %s', error);\n });\n });\n\n this.client.on(SocketIOConstants.EVENT_DISCONNECT, (reason: string) => {\n logger.info('Disconnected | id: %s | reason: %s', this.identifier, reason);\n this.state = SocketIOClientStates.UNAUTHORIZED;\n\n Promise.resolve(this.onDisconnected?.(reason)).catch(error => {\n logger.error('onDisconnected callback error | error: %s', error);\n });\n });\n\n this.client.on('connect_error', (error: Error) => {\n logger.error('Connection error | id: %s | error: %s', this.identifier, error);\n\n Promise.resolve(this.onError?.(error)).catch(err => {\n logger.error('onError callback error | error: %s', err);\n });\n });\n\n this.client.on(SocketIOConstants.EVENT_AUTHENTICATED, (data: unknown) => {\n logger.info('Authenticated | id: %s | data: %j', this.identifier, data);\n this.state = SocketIOClientStates.AUTHENTICATED;\n\n Promise.resolve(this.onAuthenticated?.()).catch(error => {\n logger.error('onAuthenticated callback error | error: %s', error);\n });\n });\n\n this.client.on(SocketIOConstants.EVENT_UNAUTHENTICATE, (data: { message?: string }) => {\n logger.warn('Unauthenticated | id: %s | data: %j', this.identifier, data);\n this.state = SocketIOClientStates.UNAUTHORIZED;\n\n Promise.resolve(this.onUnauthenticated?.(data?.message ?? '')).catch(error => {\n logger.error('onUnauthenticated callback error | error: %s', error);\n });\n });\n\n this.client.on(SocketIOConstants.EVENT_PING, () => {\n logger.debug('Ping received | id: %s', this.identifier);\n });\n }\n\n getSocketClient(): Socket {\n return this.client;\n }\n\n authenticate() {\n const logger = this.logger.for(this.authenticate.name);\n\n if (!this.client?.connected) {\n logger.warn('Cannot authenticate | id: %s | reason: not connected', this.identifier);\n return;\n }\n\n if (this.state !== SocketIOClientStates.UNAUTHORIZED) {\n logger.warn('Cannot authenticate | id: %s | currentState: %s', this.identifier, this.state);\n return;\n }\n\n this.state = SocketIOClientStates.AUTHENTICATING;\n this.client.emit(SocketIOConstants.EVENT_AUTHENTICATE);\n logger.info('Authentication requested | id: %s', this.identifier);\n }\n\n subscribe<T = unknown>(opts: {\n event: string;\n handler: TSocketIOEventHandler<T>;\n ignoreDuplicate?: boolean;\n }) {\n const logger = this.logger.for(this.subscribe.name);\n const { event, handler, ignoreDuplicate = true } = opts;\n\n if (!handler) {\n logger.warn('No handler provided | event: %s', event);\n return;\n }\n\n if (ignoreDuplicate && this.client.hasListeners(event)) {\n logger.info('Handler already exists | event: %s', event);\n return;\n }\n\n // Wrap handler in try-catch for error safety (catches both sync throws and async rejections)\n const wrappedHandler = (data: T) => {\n try {\n Promise.resolve(handler(data)).catch(error => {\n logger.error('Handler error | event: %s | error: %s', event, error);\n });\n } catch (error) {\n logger.error('Handler error | event: %s | error: %s', event, error);\n }\n };\n\n if (!this.wrappedHandlers.has(event)) {\n this.wrappedHandlers.set(event, new Map());\n }\n this.wrappedHandlers.get(event)!.set(handler, wrappedHandler);\n\n this.client.on(event, wrappedHandler);\n logger.info('Subscribed | event: %s', event);\n }\n\n subscribeMany(opts: {\n events: Record<string, TSocketIOEventHandler>;\n ignoreDuplicate?: boolean;\n }) {\n const { events, ignoreDuplicate } = opts;\n\n for (const event in events) {\n this.subscribe({\n event,\n handler: events[event],\n ignoreDuplicate,\n });\n }\n }\n\n unsubscribe(opts: { event: string; handler?: TSocketIOEventHandler }) {\n const logger = this.logger.for(this.unsubscribe.name);\n const { event, handler } = opts;\n\n if (!this.client?.hasListeners(event)) {\n logger.info('No listeners to remove | event: %s', event);\n return;\n }\n\n if (handler) {\n const wrappedHandler = this.wrappedHandlers.get(event)?.get(handler);\n if (!wrappedHandler) {\n logger.info('Handler was not subscribed through this helper | event: %s', event);\n return;\n }\n\n this.client.off(event, wrappedHandler);\n this.wrappedHandlers.get(event)?.delete(handler);\n\n if (!this.wrappedHandlers.get(event)?.size) {\n this.wrappedHandlers.delete(event);\n }\n\n logger.info('Removed specific handler | event: %s', event);\n return;\n }\n\n this.client.off(event);\n this.wrappedHandlers.delete(event);\n logger.info('Removed all handlers | event: %s', event);\n }\n\n unsubscribeMany(opts: { events: string[] }) {\n for (const event of opts.events) {\n this.unsubscribe({ event });\n }\n }\n\n connect() {\n const logger = this.logger.for(this.connect.name);\n\n if (!this.client) {\n logger.info('Invalid client to connect | id: %s', this.identifier);\n return;\n }\n\n this.client.connect();\n }\n\n disconnect() {\n const logger = this.logger.for(this.disconnect.name);\n\n if (!this.client) {\n logger.info('Invalid client to disconnect | id: %s', this.identifier);\n return;\n }\n\n this.client.disconnect();\n }\n\n emit<T = unknown>(opts: { topic: string; data: T; doLog?: boolean; callback?: () => void }) {\n const logger = this.logger.for(this.emit.name);\n const { topic, data, doLog = false, callback } = opts;\n\n if (!this.client?.connected) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: 'Invalid socket client state to emit',\n });\n }\n\n if (!topic) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: 'Topic is required to emit',\n });\n }\n\n this.client.emit(topic, data);\n\n if (callback) {\n setImmediate(callback);\n }\n\n if (doLog) {\n logger.info('Emitted | topic: %s | data: %j', topic, data);\n }\n }\n\n joinRooms(opts: { rooms: string[] }) {\n const logger = this.logger.for(this.joinRooms.name);\n const { rooms } = opts;\n\n if (!this.client?.connected) {\n logger.warn('Cannot join rooms | id: %s | reason: not connected', this.identifier);\n return;\n }\n\n this.client.emit(SocketIOConstants.EVENT_JOIN, { rooms });\n logger.info('Join rooms requested | id: %s | rooms: %j', this.identifier, rooms);\n }\n\n leaveRooms(opts: { rooms: string[] }) {\n const logger = this.logger.for(this.leaveRooms.name);\n const { rooms } = opts;\n\n if (!this.client?.connected) {\n logger.warn('Cannot leave rooms | id: %s | reason: not connected', this.identifier);\n return;\n }\n\n this.client.emit(SocketIOConstants.EVENT_LEAVE, { rooms });\n logger.info('Leave rooms requested | id: %s | rooms: %j', this.identifier, rooms);\n }\n\n shutdown() {\n const logger = this.logger.for(this.shutdown.name);\n logger.info('Shutting down SocketIO client | id: %s', this.identifier);\n\n if (this.client) {\n this.client.removeAllListeners();\n\n if (this.client.connected) {\n this.client.disconnect();\n }\n }\n\n this.wrappedHandlers.clear();\n this.state = SocketIOClientStates.UNAUTHORIZED;\n logger.info('SocketIO client shutdown complete | id: %s', this.identifier);\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/client/helper.ts"],"names":[],"mappings":";;;AAAA,+DAA2D;AAC3D,qDAAuF;AAEvF;;;;GAIG;AACH,MAAa,oBAAqB,SAAQ,qCAA2B;IACnE,+FAA+F;IAC/F,0DAA0D;IACvC,aAAa;QAC9B,OAAO,CACL,IAAI,CAAC,YAAY;YACjB,8BAAa,CAAC,QAAQ,CAAoC,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAC1F,CAAC;IACJ,CAAC;CACF;AATD,oDASC","sourcesContent":["import { ModuleUtility } from '@/utilities/module.utility';\nimport { SocketIOClientHelper as BrowserSocketIOClientHelper } from './browser-helper';\n\n/**\n * The socket.io client for a server or a CLI: the browser-pure helper, plus a `socket.io-client`\n * found in the app's `node_modules` when no `module` is handed in. A browser bundle imports\n * `@venizia/ignis-helpers/socket-io/client` instead, which has no node dependency.\n */\nexport class SocketIOClientHelper extends BrowserSocketIOClientHelper {\n // `socket.io-client` is an optional peer: loaded on connect, so a server that only imports the\n // server helper from this entry never needs it installed.\n protected override resolveModule(): typeof import('socket.io-client') {\n return (\n this.clientModule ??\n ModuleUtility.loadSync<typeof import('socket.io-client')>({ module: 'socket.io-client' })\n );\n }\n}\n"]}
@@ -295,7 +295,7 @@ class SocketIOServerHelper extends base_1.BaseHelper {
295
295
  .then(() => {
296
296
  logger.info('Joined default rooms | id: %s | rooms: %s', id, this.defaultRooms);
297
297
  })
298
- .catch(error => {
298
+ .catch((error) => {
299
299
  logger.error('Failed to join default rooms | id: %s | rooms: %s | error: %s', id, this.defaultRooms, error);
300
300
  });
301
301
  this.registerRoomHandlers({ socket, clientId: id });
@@ -362,7 +362,7 @@ class SocketIOServerHelper extends base_1.BaseHelper {
362
362
  }
363
363
  joinLogger.info('Joined rooms | id: %s | rooms: %s', id, allowedRooms);
364
364
  })
365
- .catch(error => {
365
+ .catch((error) => {
366
366
  joinLogger.error('Failed to join rooms | id: %s | rooms: %s | error: %s', id, rooms, error);
367
367
  });
368
368
  });
@@ -376,11 +376,11 @@ class SocketIOServerHelper extends base_1.BaseHelper {
376
376
  // `Promise.resolve` per room: socket.io declares `leave(room): Promise<void> | void` - the
377
377
  // default adapter is synchronous, a clustered one is not - and `Promise.all` over a mixed
378
378
  // iterable is what the previous `any`-typed payload was hiding.
379
- Promise.all(rooms.map(room => Promise.resolve(socket.leave(room))))
379
+ Promise.all(rooms.map((room) => Promise.resolve(socket.leave(room))))
380
380
  .then(() => {
381
381
  leaveLogger.info('Left rooms | id: %s | rooms: %s', id, rooms);
382
382
  })
383
- .catch(error => {
383
+ .catch((error) => {
384
384
  leaveLogger.error('Failed to leave rooms | id: %s | rooms: %s | error: %s', id, rooms, error);
385
385
  });
386
386
  });
@@ -463,7 +463,7 @@ class SocketIOServerHelper extends base_1.BaseHelper {
463
463
  (0, promise_utility_1.voidExecution)({
464
464
  logger: this.logger,
465
465
  scope: 'close',
466
- execution: this.io.close(error => {
466
+ execution: this.io.close((error) => {
467
467
  if (error) {
468
468
  reject(error);
469
469
  return;
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/server/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { isEmpty } from '@venizia/ignis-inversion';\nimport { HTTP } from '@/common';\nimport { RuntimeModules, type TRuntimeModule } from '@/common/constants';\nimport { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport {\n ensureRedisClientsConnecting,\n type TRedisClient,\n waitForRedisReady,\n} from '@/modules/redis';\nimport { voidExecution } from '@/utilities/promise.utility';\nimport { createAdapter } from '@socket.io/redis-adapter';\nimport { Emitter } from '@socket.io/redis-emitter';\nimport { type EventEmitter } from 'node:events';\nimport { type Server as HTTPServer } from 'node:http';\nimport { Server as IOServer, type Socket as IOSocket, type ServerOptions } from 'socket.io';\nimport {\n type IHandshake,\n type ISocketIOClient,\n SocketIOClientStates,\n SocketIOConstants,\n type TSocketIOAuthenticateFn,\n type TSocketIOClientConnectedFn,\n type TSocketIOServerOptions,\n type TSocketIOValidateRoomFn,\n} from '../common';\n\nconst CLIENT_AUTHENTICATE_TIMEOUT = 10_000;\nconst CLIENT_PING_INTERVAL = 30_000;\n\nexport class SocketIOServerHelper extends BaseHelper {\n private runtime: TRuntimeModule;\n private server?: HTTPServer;\n private bunEngine?: any;\n private serverOptions: Partial<ServerOptions> = {};\n\n private io: IOServer;\n private emitter: Emitter;\n private clients: Map<string, ISocketIOClient> = new Map();\n\n private redisPub: TRedisClient;\n private redisSub: TRedisClient;\n private redisEmitter: TRedisClient;\n\n private authenticateFn: TSocketIOAuthenticateFn;\n private validateRoomFn?: TSocketIOValidateRoomFn;\n private onClientConnected?: TSocketIOClientConnectedFn;\n\n private authenticateTimeout: number;\n private pingInterval: number;\n private defaultRooms: string[];\n\n constructor(opts: TSocketIOServerOptions) {\n super({ scope: opts.identifier });\n\n this.identifier = opts.identifier;\n this.runtime = opts.runtime;\n this.serverOptions = opts?.serverOptions ?? {};\n\n this.authenticateFn = opts.authenticateFn;\n this.validateRoomFn = opts.validateRoomFn;\n this.onClientConnected = opts.clientConnectedFn;\n\n this.authenticateTimeout = opts.authenticateTimeout ?? CLIENT_AUTHENTICATE_TIMEOUT;\n this.pingInterval = opts.pingInterval ?? CLIENT_PING_INTERVAL;\n this.defaultRooms = opts.defaultRooms ?? [\n SocketIOConstants.ROOM_DEFAULT,\n SocketIOConstants.ROOM_NOTIFICATION,\n ];\n\n this.setRuntime(opts);\n this.initRedisClients(opts.redisConnection);\n }\n\n private setRuntime(opts: TSocketIOServerOptions) {\n switch (opts.runtime) {\n case RuntimeModules.NODE: {\n if (!opts.server) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[SocketIOServerHelper] Invalid HTTP server for Node.js runtime!',\n });\n }\n this.server = opts.server;\n break;\n }\n case RuntimeModules.BUN: {\n if (!opts.engine) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message:\n '[SocketIOServerHelper] Invalid @socket.io/bun-engine instance for Bun runtime!',\n });\n }\n this.bunEngine = opts.engine;\n break;\n }\n default: {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[SocketIOServerHelper] Unsupported runtime!',\n });\n }\n }\n }\n\n private initRedisClients(redisConnection: TSocketIOServerOptions['redisConnection']) {\n if (!redisConnection) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: 'Invalid redis connection to config socket.io adapter!',\n });\n }\n\n this.redisPub = redisConnection.duplicateClient();\n this.redisSub = redisConnection.duplicateClient();\n this.redisEmitter = redisConnection.duplicateClient();\n }\n\n getIOServer(): IOServer {\n return this.io;\n }\n\n /** Handlers run inside socket.io event listeners - a sync throw there kills the process; voidExecution only catches promise rejections since its argument evaluates before the try/catch. */\n protected invokeHook(opts: { scope: string; execution: () => ValueOrPromise<void> }) {\n const { scope, execution } = opts;\n\n try {\n voidExecution({ logger: this.logger, scope, execution: execution() });\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n getEngine() {\n if (this.runtime !== RuntimeModules.BUN) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[getEngine] Engine is only available for Bun runtime!',\n });\n }\n\n return this.bunEngine;\n }\n\n getClients(opts?: { id?: string }): ISocketIOClient | Map<string, ISocketIOClient> | undefined {\n const { id } = opts ?? {};\n if (id) {\n return this.clients.get(id);\n }\n return this.clients;\n }\n\n on<HandlerArgsType extends unknown[] = unknown[], HanderReturnType = void>(opts: {\n topic: string;\n handler: (...args: HandlerArgsType) => ValueOrPromise<HanderReturnType>;\n }) {\n const { topic, handler } = opts;\n if (!topic) {\n throw getError({ message: '[on] Invalid topic to start binding handler' });\n }\n\n if (!handler) {\n throw getError({ message: `[on] Invalid event handler | topic: ${topic}` });\n }\n\n if (!this.io) {\n throw getError({ message: '[on] IOServer is not initialized yet!' });\n }\n\n this.io.on(topic, handler);\n }\n\n async configure() {\n const logger = this.logger.for(this.configure.name);\n logger.info('Configuring IO Server | id: %s | runtime: %s', this.identifier, this.runtime);\n\n (this.redisPub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis adapter pub error | error: %s', error);\n });\n\n (this.redisSub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis adapter sub error | error: %s', error);\n });\n\n (this.redisEmitter as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis emitter error | error: %s', error);\n });\n\n ensureRedisClientsConnecting({\n clients: [this.redisPub, this.redisSub, this.redisEmitter],\n logger: this.logger,\n scope: this.configure.name,\n });\n\n await Promise.all([\n waitForRedisReady({ client: this.redisPub }),\n waitForRedisReady({ client: this.redisSub }),\n waitForRedisReady({ client: this.redisEmitter }),\n ]);\n logger.info('All Redis connections ready');\n\n this.initIOServer();\n\n this.io.adapter(createAdapter(this.redisPub, this.redisSub));\n logger.info('SocketIO Server initialized Redis Adapter');\n\n this.emitter = new Emitter(this.redisEmitter);\n logger.info('SocketIO Server initialized Redis Emitter');\n\n this.io.on(SocketIOConstants.EVENT_CONNECT, (socket: IOSocket) => {\n this.onClientConnect({ socket });\n });\n\n logger.info(\n 'SocketIO Server READY | path: %s | runtime: %s',\n this.serverOptions?.path ?? '',\n this.runtime,\n );\n }\n\n private initIOServer() {\n switch (this.runtime) {\n case RuntimeModules.NODE: {\n if (!this.server) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[DANGER] Invalid HTTP server instance to init Socket.io server!',\n });\n }\n this.io = new IOServer(this.server, this.serverOptions);\n break;\n }\n case RuntimeModules.BUN: {\n if (!this.bunEngine) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[DANGER] Invalid @socket.io/bun-engine instance to init Socket.io server!',\n });\n }\n this.io = new IOServer();\n this.io.bind(this.bunEngine);\n break;\n }\n default: {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[configure] Unsupported runtime: ${this.runtime}`,\n });\n }\n }\n }\n\n onClientConnect(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.onClientConnect.name);\n const { socket } = opts;\n\n if (!socket) {\n logger.info('Invalid new socket connection!');\n return;\n }\n\n const { id, handshake } = socket;\n if (this.clients.has(id)) {\n logger.info('Socket client already existed | id: %s', id);\n return;\n }\n\n logger.info('New connection request | id: %s', id);\n\n const client: ISocketIOClient = {\n id,\n socket,\n state: SocketIOClientStates.UNAUTHORIZED,\n authenticateTimeout: setTimeout(() => {\n const currentClient = this.clients.get(id);\n if (currentClient?.state === SocketIOClientStates.AUTHENTICATED) {\n return;\n }\n this.disconnect({ socket });\n }, this.authenticateTimeout),\n };\n this.clients.set(id, client);\n\n socket.on(SocketIOConstants.EVENT_DISCONNECT, () => {\n this.disconnect({ socket });\n });\n\n this.registerAuthHandler({ socket, handshake, clientId: id });\n }\n\n private registerAuthHandler(opts: { socket: IOSocket; handshake: IHandshake; clientId: string }) {\n const { socket, handshake, clientId: id } = opts;\n const authLogger = this.logger.for('onClientAuthenticate');\n\n socket.on(SocketIOConstants.EVENT_AUTHENTICATE, () => {\n const currentClient = this.clients.get(id);\n if (!currentClient) {\n authLogger.warn('Client no longer exists during auth | id: %s', id);\n return;\n }\n\n if (currentClient.state !== SocketIOClientStates.UNAUTHORIZED) {\n authLogger.warn(\n 'Client attempted auth in invalid state | id: %s | currentState: %s',\n id,\n currentClient.state,\n );\n return;\n }\n\n currentClient.state = SocketIOClientStates.AUTHENTICATING;\n\n Promise.resolve()\n .then(() => this.authenticateFn(handshake))\n .then((rs: boolean) => {\n if (!this.clients.has(id)) {\n authLogger.info('Client disconnected during authentication | id: %s', id);\n return;\n }\n\n authLogger.info('Authentication completed | id: %s | result: %s', id, rs);\n\n if (rs) {\n this.onClientAuthenticated({ socket });\n return;\n }\n\n const failedClient = this.clients.get(id);\n if (failedClient) {\n failedClient.state = SocketIOClientStates.UNAUTHORIZED;\n }\n\n this.rejectClient({\n socket,\n message: 'Invalid token to authenticate! Please login again!',\n });\n })\n .catch((error: Error) => {\n const errorClient = this.clients.get(id);\n if (errorClient) {\n errorClient.state = SocketIOClientStates.UNAUTHORIZED;\n }\n\n authLogger.error('Failed to authenticate | id: %s | error: %s', id, error);\n\n this.rejectClient({\n socket,\n message: 'Failed to authenticate connection! Please login again!',\n });\n });\n });\n }\n\n // The socket is connected to this process, so the notice goes out on it directly: routed through the Redis emitter it arrives after the disconnect and is dropped.\n private rejectClient(opts: { socket: IOSocket; message: string }) {\n const { socket, message } = opts;\n\n socket.emit(SocketIOConstants.EVENT_UNAUTHENTICATE, {\n message,\n time: new Date().toISOString(),\n });\n this.disconnect({ socket });\n }\n\n onClientAuthenticated(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.onClientAuthenticated.name);\n const { socket } = opts;\n\n if (!socket) {\n logger.info('Invalid new socket connection!');\n return;\n }\n\n const { id } = socket;\n const client = this.clients.get(id);\n if (!client) {\n logger.info('Unknown client | id: %s', id);\n this.disconnect({ socket });\n return;\n }\n\n client.state = SocketIOClientStates.AUTHENTICATED;\n\n // The authenticate deadline is over: leaving it armed keeps a timer per client alive\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n client.authenticateTimeout = undefined;\n }\n\n this.ping({ socket, doIgnoreAuth: true });\n\n logger.info(\n 'Client connected | id: %s | identifier: %s | time: %s',\n id,\n this.identifier,\n new Date().toISOString(),\n );\n\n Promise.all(this.defaultRooms.map((room: string) => Promise.resolve(socket.join(room))))\n .then(() => {\n logger.info('Joined default rooms | id: %s | rooms: %s', id, this.defaultRooms);\n })\n .catch(error => {\n logger.error(\n 'Failed to join default rooms | id: %s | rooms: %s | error: %s',\n id,\n this.defaultRooms,\n error,\n );\n });\n\n this.registerRoomHandlers({ socket, clientId: id });\n\n client.interval = setInterval(() => {\n this.ping({ socket, doIgnoreAuth: true });\n }, this.pingInterval);\n\n this.send({\n destination: socket.id,\n payload: {\n topic: SocketIOConstants.EVENT_AUTHENTICATED,\n data: {\n id: socket.id,\n time: new Date().toISOString(),\n },\n },\n });\n\n this.invokeHook({\n scope: 'clientConnectedFn',\n execution: () => this.onClientConnected?.({ socket }),\n });\n }\n\n /**\n * Narrows an untrusted room payload to the strings it actually contains.\n *\n * The listeners below run on data any authenticated client sends. Destructuring `{ rooms = [] }`\n * out of an `any` and testing `rooms?.length` accepts a STRING - `{\"rooms\":\"lobby\"}` has a\n * length of 5 - and the next line calls `rooms.map`, which a string does not have. socket.io\n * dispatches on `process.nextTick` with no try/catch around the handler, so that TypeError\n * escapes as an uncaught exception and takes the process with it.\n */\n private static toRoomList(payload: unknown): string[] {\n const rooms = (payload as { rooms?: unknown } | null | undefined)?.rooms;\n return Array.isArray(rooms)\n ? rooms.filter((room): room is string => typeof room === 'string')\n : [];\n }\n\n private registerRoomHandlers(opts: { socket: IOSocket; clientId: string }) {\n const { socket, clientId: id } = opts;\n\n const joinLogger = this.logger.for(SocketIOConstants.EVENT_JOIN);\n socket.on(SocketIOConstants.EVENT_JOIN, (payload: any) => {\n const rooms = SocketIOServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n const validateRoomFn = this.validateRoomFn;\n if (!validateRoomFn) {\n joinLogger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no validateRoomFn configured',\n id,\n rooms,\n );\n return;\n }\n\n Promise.resolve()\n .then(() => validateRoomFn({ socket, rooms }))\n .then((allowedRooms: string[]) => {\n if (!allowedRooms?.length) {\n joinLogger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no rooms allowed',\n id,\n rooms,\n );\n return;\n }\n\n joinLogger.info('Joining rooms | id: %s | rooms: %j', id, allowedRooms);\n\n for (const room of allowedRooms) {\n voidExecution({\n logger: this.logger,\n scope: SocketIOConstants.EVENT_JOIN,\n execution: socket.join(room),\n });\n }\n\n joinLogger.info('Joined rooms | id: %s | rooms: %s', id, allowedRooms);\n })\n .catch(error => {\n joinLogger.error(\n 'Failed to join rooms | id: %s | rooms: %s | error: %s',\n id,\n rooms,\n error,\n );\n });\n });\n\n const leaveLogger = this.logger.for(SocketIOConstants.EVENT_LEAVE);\n socket.on(SocketIOConstants.EVENT_LEAVE, (payload: any) => {\n const rooms = SocketIOServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n leaveLogger.info('Leaving rooms | id: %s | rooms: %j', id, rooms);\n\n // `Promise.resolve` per room: socket.io declares `leave(room): Promise<void> | void` - the\n // default adapter is synchronous, a clustered one is not - and `Promise.all` over a mixed\n // iterable is what the previous `any`-typed payload was hiding.\n Promise.all(rooms.map(room => Promise.resolve(socket.leave(room))))\n .then(() => {\n leaveLogger.info('Left rooms | id: %s | rooms: %s', id, rooms);\n })\n .catch(error => {\n leaveLogger.error(\n 'Failed to leave rooms | id: %s | rooms: %s | error: %s',\n id,\n rooms,\n error,\n );\n });\n });\n }\n\n ping(opts: { socket: IOSocket; doIgnoreAuth: boolean }) {\n const logger = this.logger.for(this.ping.name);\n const { socket, doIgnoreAuth } = opts;\n\n if (!socket) {\n logger.info('Socket is undefined to PING!');\n return;\n }\n\n const client = this.clients.get(socket.id);\n if (!client) {\n logger.info('Client not found | socketId: %s', socket.id);\n return;\n }\n\n if (!doIgnoreAuth && client.state !== SocketIOClientStates.AUTHENTICATED) {\n logger.info('Socket client is not authenticated | state: %s', client.state);\n this.disconnect({ socket });\n return;\n }\n\n socket.emit(SocketIOConstants.EVENT_PING, { time: new Date().toISOString() });\n }\n\n disconnect(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.disconnect.name);\n const { socket } = opts;\n if (!socket) {\n return;\n }\n\n const { id } = socket;\n\n if (this.clients.has(id)) {\n const client = this.clients.get(id)!;\n\n if (client.interval) {\n clearInterval(client.interval);\n }\n\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n }\n\n this.clients.delete(id);\n }\n\n logger.info('Client disconnected | id: %s | time: %s', id, new Date().toISOString());\n socket.disconnect();\n }\n\n send(opts: {\n destination?: string;\n payload: { topic: string; data: any };\n doLog?: boolean;\n callback?: () => void;\n }) {\n const logger = this.logger.for(this.send.name);\n const { destination, payload, doLog, callback } = opts;\n\n if (!payload) {\n return;\n }\n\n const { topic, data } = payload;\n if (!topic || !data) {\n return;\n }\n\n if (!this.emitter) {\n logger.error(\n 'Cannot emit | Redis emitter is not initialized | call configure() first | topic: %s',\n topic,\n );\n return;\n }\n\n const sender = this.emitter.compress(true);\n\n if (destination && !isEmpty({ value: destination })) {\n sender.to(destination).emit(topic, data);\n } else {\n sender.emit(topic, data);\n }\n\n if (callback) {\n setImmediate(callback);\n }\n\n if (doLog) {\n logger.info(\n 'Message emitted | destination: %s | topic: %s | data: %j',\n destination ?? 'all',\n topic,\n data,\n );\n }\n }\n\n private close() {\n return new Promise<void>((resolve, reject) => {\n // configure() may never have run (or may have failed): there is nothing to close, but the redis clients still have to be released by the caller\n if (!this.io) {\n this.logger.for('close').info('SKIP close | IOServer was never initialized');\n resolve();\n return;\n }\n\n voidExecution({\n logger: this.logger,\n scope: 'close',\n execution: this.io.close(error => {\n if (error) {\n reject(error);\n return;\n }\n\n resolve();\n }),\n });\n });\n }\n\n async shutdown() {\n const logger = this.logger.for(this.shutdown.name);\n logger.info('Shutting down SocketIO server...');\n\n for (const [, client] of this.clients) {\n if (client.interval) {\n clearInterval(client.interval);\n }\n\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n }\n\n client.socket.disconnect();\n }\n this.clients.clear();\n\n try {\n await this.close();\n } finally {\n // close() rejects when io.close() reports a lingering handle. Skipping the quits there leaves three live Redis sockets holding the event loop open, and a SIGTERM handler never returns.\n await Promise.all([this.redisPub?.quit(), this.redisSub?.quit(), this.redisEmitter?.quit()]);\n }\n\n logger.info('SocketIO server shutdown complete');\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/server/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { isEmpty } from '@venizia/ignis-inversion';\nimport { HTTP } from '@/common';\nimport { RuntimeModules, type TRuntimeModule } from '@/common/constants';\nimport { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport {\n ensureRedisClientsConnecting,\n type TRedisClient,\n waitForRedisReady,\n} from '@/modules/redis';\nimport { voidExecution } from '@/utilities/promise.utility';\nimport { createAdapter } from '@socket.io/redis-adapter';\nimport { Emitter } from '@socket.io/redis-emitter';\nimport { type EventEmitter } from 'node:events';\nimport { type Server as HTTPServer } from 'node:http';\nimport { Server as IOServer, type Socket as IOSocket, type ServerOptions } from 'socket.io';\nimport {\n type IHandshake,\n type ISocketIOClient,\n SocketIOClientStates,\n SocketIOConstants,\n type TSocketIOAuthenticateFn,\n type TSocketIOClientConnectedFn,\n type TSocketIOServerOptions,\n type TSocketIOValidateRoomFn,\n} from '../common';\n\nconst CLIENT_AUTHENTICATE_TIMEOUT = 10_000;\nconst CLIENT_PING_INTERVAL = 30_000;\n\nexport class SocketIOServerHelper extends BaseHelper {\n private runtime: TRuntimeModule;\n private server?: HTTPServer;\n private bunEngine?: any;\n private serverOptions: Partial<ServerOptions> = {};\n\n private io: IOServer;\n private emitter: Emitter;\n private clients: Map<string, ISocketIOClient> = new Map();\n\n private redisPub: TRedisClient;\n private redisSub: TRedisClient;\n private redisEmitter: TRedisClient;\n\n private authenticateFn: TSocketIOAuthenticateFn;\n private validateRoomFn?: TSocketIOValidateRoomFn;\n private onClientConnected?: TSocketIOClientConnectedFn;\n\n private authenticateTimeout: number;\n private pingInterval: number;\n private defaultRooms: string[];\n\n constructor(opts: TSocketIOServerOptions) {\n super({ scope: opts.identifier });\n\n this.identifier = opts.identifier;\n this.runtime = opts.runtime;\n this.serverOptions = opts?.serverOptions ?? {};\n\n this.authenticateFn = opts.authenticateFn;\n this.validateRoomFn = opts.validateRoomFn;\n this.onClientConnected = opts.clientConnectedFn;\n\n this.authenticateTimeout = opts.authenticateTimeout ?? CLIENT_AUTHENTICATE_TIMEOUT;\n this.pingInterval = opts.pingInterval ?? CLIENT_PING_INTERVAL;\n this.defaultRooms = opts.defaultRooms ?? [\n SocketIOConstants.ROOM_DEFAULT,\n SocketIOConstants.ROOM_NOTIFICATION,\n ];\n\n this.setRuntime(opts);\n this.initRedisClients(opts.redisConnection);\n }\n\n private setRuntime(opts: TSocketIOServerOptions) {\n switch (opts.runtime) {\n case RuntimeModules.NODE: {\n if (!opts.server) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[SocketIOServerHelper] Invalid HTTP server for Node.js runtime!',\n });\n }\n this.server = opts.server;\n break;\n }\n case RuntimeModules.BUN: {\n if (!opts.engine) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message:\n '[SocketIOServerHelper] Invalid @socket.io/bun-engine instance for Bun runtime!',\n });\n }\n this.bunEngine = opts.engine;\n break;\n }\n default: {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[SocketIOServerHelper] Unsupported runtime!',\n });\n }\n }\n }\n\n private initRedisClients(redisConnection: TSocketIOServerOptions['redisConnection']) {\n if (!redisConnection) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: 'Invalid redis connection to config socket.io adapter!',\n });\n }\n\n this.redisPub = redisConnection.duplicateClient();\n this.redisSub = redisConnection.duplicateClient();\n this.redisEmitter = redisConnection.duplicateClient();\n }\n\n getIOServer(): IOServer {\n return this.io;\n }\n\n /** Handlers run inside socket.io event listeners - a sync throw there kills the process; voidExecution only catches promise rejections since its argument evaluates before the try/catch. */\n protected invokeHook(opts: { scope: string; execution: () => ValueOrPromise<void> }) {\n const { scope, execution } = opts;\n\n try {\n voidExecution({ logger: this.logger, scope, execution: execution() });\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n getEngine() {\n if (this.runtime !== RuntimeModules.BUN) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[getEngine] Engine is only available for Bun runtime!',\n });\n }\n\n return this.bunEngine;\n }\n\n getClients(opts?: { id?: string }): ISocketIOClient | Map<string, ISocketIOClient> | undefined {\n const { id } = opts ?? {};\n if (id) {\n return this.clients.get(id);\n }\n return this.clients;\n }\n\n on<HandlerArgsType extends unknown[] = unknown[], HanderReturnType = void>(opts: {\n topic: string;\n handler: (...args: HandlerArgsType) => ValueOrPromise<HanderReturnType>;\n }) {\n const { topic, handler } = opts;\n if (!topic) {\n throw getError({ message: '[on] Invalid topic to start binding handler' });\n }\n\n if (!handler) {\n throw getError({ message: `[on] Invalid event handler | topic: ${topic}` });\n }\n\n if (!this.io) {\n throw getError({ message: '[on] IOServer is not initialized yet!' });\n }\n\n this.io.on(topic, handler);\n }\n\n async configure() {\n const logger = this.logger.for(this.configure.name);\n logger.info('Configuring IO Server | id: %s | runtime: %s', this.identifier, this.runtime);\n\n (this.redisPub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis adapter pub error | error: %s', error);\n });\n\n (this.redisSub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis adapter sub error | error: %s', error);\n });\n\n (this.redisEmitter as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis emitter error | error: %s', error);\n });\n\n ensureRedisClientsConnecting({\n clients: [this.redisPub, this.redisSub, this.redisEmitter],\n logger: this.logger,\n scope: this.configure.name,\n });\n\n await Promise.all([\n waitForRedisReady({ client: this.redisPub }),\n waitForRedisReady({ client: this.redisSub }),\n waitForRedisReady({ client: this.redisEmitter }),\n ]);\n logger.info('All Redis connections ready');\n\n this.initIOServer();\n\n this.io.adapter(createAdapter(this.redisPub, this.redisSub));\n logger.info('SocketIO Server initialized Redis Adapter');\n\n this.emitter = new Emitter(this.redisEmitter);\n logger.info('SocketIO Server initialized Redis Emitter');\n\n this.io.on(SocketIOConstants.EVENT_CONNECT, (socket: IOSocket) => {\n this.onClientConnect({ socket });\n });\n\n logger.info(\n 'SocketIO Server READY | path: %s | runtime: %s',\n this.serverOptions?.path ?? '',\n this.runtime,\n );\n }\n\n private initIOServer() {\n switch (this.runtime) {\n case RuntimeModules.NODE: {\n if (!this.server) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[DANGER] Invalid HTTP server instance to init Socket.io server!',\n });\n }\n this.io = new IOServer(this.server, this.serverOptions);\n break;\n }\n case RuntimeModules.BUN: {\n if (!this.bunEngine) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[DANGER] Invalid @socket.io/bun-engine instance to init Socket.io server!',\n });\n }\n this.io = new IOServer();\n this.io.bind(this.bunEngine);\n break;\n }\n default: {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[configure] Unsupported runtime: ${this.runtime}`,\n });\n }\n }\n }\n\n onClientConnect(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.onClientConnect.name);\n const { socket } = opts;\n\n if (!socket) {\n logger.info('Invalid new socket connection!');\n return;\n }\n\n const { id, handshake } = socket;\n if (this.clients.has(id)) {\n logger.info('Socket client already existed | id: %s', id);\n return;\n }\n\n logger.info('New connection request | id: %s', id);\n\n const client: ISocketIOClient = {\n id,\n socket,\n state: SocketIOClientStates.UNAUTHORIZED,\n authenticateTimeout: setTimeout(() => {\n const currentClient = this.clients.get(id);\n if (currentClient?.state === SocketIOClientStates.AUTHENTICATED) {\n return;\n }\n this.disconnect({ socket });\n }, this.authenticateTimeout),\n };\n this.clients.set(id, client);\n\n socket.on(SocketIOConstants.EVENT_DISCONNECT, () => {\n this.disconnect({ socket });\n });\n\n this.registerAuthHandler({ socket, handshake, clientId: id });\n }\n\n private registerAuthHandler(opts: { socket: IOSocket; handshake: IHandshake; clientId: string }) {\n const { socket, handshake, clientId: id } = opts;\n const authLogger = this.logger.for('onClientAuthenticate');\n\n socket.on(SocketIOConstants.EVENT_AUTHENTICATE, () => {\n const currentClient = this.clients.get(id);\n if (!currentClient) {\n authLogger.warn('Client no longer exists during auth | id: %s', id);\n return;\n }\n\n if (currentClient.state !== SocketIOClientStates.UNAUTHORIZED) {\n authLogger.warn(\n 'Client attempted auth in invalid state | id: %s | currentState: %s',\n id,\n currentClient.state,\n );\n return;\n }\n\n currentClient.state = SocketIOClientStates.AUTHENTICATING;\n\n Promise.resolve()\n .then(() => this.authenticateFn(handshake))\n .then((rs: boolean) => {\n if (!this.clients.has(id)) {\n authLogger.info('Client disconnected during authentication | id: %s', id);\n return;\n }\n\n authLogger.info('Authentication completed | id: %s | result: %s', id, rs);\n\n if (rs) {\n this.onClientAuthenticated({ socket });\n return;\n }\n\n const failedClient = this.clients.get(id);\n if (failedClient) {\n failedClient.state = SocketIOClientStates.UNAUTHORIZED;\n }\n\n this.rejectClient({\n socket,\n message: 'Invalid token to authenticate! Please login again!',\n });\n })\n .catch((error: Error) => {\n const errorClient = this.clients.get(id);\n if (errorClient) {\n errorClient.state = SocketIOClientStates.UNAUTHORIZED;\n }\n\n authLogger.error('Failed to authenticate | id: %s | error: %s', id, error);\n\n this.rejectClient({\n socket,\n message: 'Failed to authenticate connection! Please login again!',\n });\n });\n });\n }\n\n // The socket is connected to this process, so the notice goes out on it directly: routed through the Redis emitter it arrives after the disconnect and is dropped.\n private rejectClient(opts: { socket: IOSocket; message: string }) {\n const { socket, message } = opts;\n\n socket.emit(SocketIOConstants.EVENT_UNAUTHENTICATE, {\n message,\n time: new Date().toISOString(),\n });\n this.disconnect({ socket });\n }\n\n onClientAuthenticated(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.onClientAuthenticated.name);\n const { socket } = opts;\n\n if (!socket) {\n logger.info('Invalid new socket connection!');\n return;\n }\n\n const { id } = socket;\n const client = this.clients.get(id);\n if (!client) {\n logger.info('Unknown client | id: %s', id);\n this.disconnect({ socket });\n return;\n }\n\n client.state = SocketIOClientStates.AUTHENTICATED;\n\n // The authenticate deadline is over: leaving it armed keeps a timer per client alive\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n client.authenticateTimeout = undefined;\n }\n\n this.ping({ socket, doIgnoreAuth: true });\n\n logger.info(\n 'Client connected | id: %s | identifier: %s | time: %s',\n id,\n this.identifier,\n new Date().toISOString(),\n );\n\n Promise.all(this.defaultRooms.map((room: string) => Promise.resolve(socket.join(room))))\n .then(() => {\n logger.info('Joined default rooms | id: %s | rooms: %s', id, this.defaultRooms);\n })\n .catch((error) => {\n logger.error(\n 'Failed to join default rooms | id: %s | rooms: %s | error: %s',\n id,\n this.defaultRooms,\n error,\n );\n });\n\n this.registerRoomHandlers({ socket, clientId: id });\n\n client.interval = setInterval(() => {\n this.ping({ socket, doIgnoreAuth: true });\n }, this.pingInterval);\n\n this.send({\n destination: socket.id,\n payload: {\n topic: SocketIOConstants.EVENT_AUTHENTICATED,\n data: {\n id: socket.id,\n time: new Date().toISOString(),\n },\n },\n });\n\n this.invokeHook({\n scope: 'clientConnectedFn',\n execution: () => this.onClientConnected?.({ socket }),\n });\n }\n\n /**\n * Narrows an untrusted room payload to the strings it actually contains.\n *\n * The listeners below run on data any authenticated client sends. Destructuring `{ rooms = [] }`\n * out of an `any` and testing `rooms?.length` accepts a STRING - `{\"rooms\":\"lobby\"}` has a\n * length of 5 - and the next line calls `rooms.map`, which a string does not have. socket.io\n * dispatches on `process.nextTick` with no try/catch around the handler, so that TypeError\n * escapes as an uncaught exception and takes the process with it.\n */\n private static toRoomList(payload: unknown): string[] {\n const rooms = (payload as { rooms?: unknown } | null | undefined)?.rooms;\n return Array.isArray(rooms)\n ? rooms.filter((room): room is string => typeof room === 'string')\n : [];\n }\n\n private registerRoomHandlers(opts: { socket: IOSocket; clientId: string }) {\n const { socket, clientId: id } = opts;\n\n const joinLogger = this.logger.for(SocketIOConstants.EVENT_JOIN);\n socket.on(SocketIOConstants.EVENT_JOIN, (payload: any) => {\n const rooms = SocketIOServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n const validateRoomFn = this.validateRoomFn;\n if (!validateRoomFn) {\n joinLogger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no validateRoomFn configured',\n id,\n rooms,\n );\n return;\n }\n\n Promise.resolve()\n .then(() => validateRoomFn({ socket, rooms }))\n .then((allowedRooms: string[]) => {\n if (!allowedRooms?.length) {\n joinLogger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no rooms allowed',\n id,\n rooms,\n );\n return;\n }\n\n joinLogger.info('Joining rooms | id: %s | rooms: %j', id, allowedRooms);\n\n for (const room of allowedRooms) {\n voidExecution({\n logger: this.logger,\n scope: SocketIOConstants.EVENT_JOIN,\n execution: socket.join(room),\n });\n }\n\n joinLogger.info('Joined rooms | id: %s | rooms: %s', id, allowedRooms);\n })\n .catch((error) => {\n joinLogger.error(\n 'Failed to join rooms | id: %s | rooms: %s | error: %s',\n id,\n rooms,\n error,\n );\n });\n });\n\n const leaveLogger = this.logger.for(SocketIOConstants.EVENT_LEAVE);\n socket.on(SocketIOConstants.EVENT_LEAVE, (payload: any) => {\n const rooms = SocketIOServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n leaveLogger.info('Leaving rooms | id: %s | rooms: %j', id, rooms);\n\n // `Promise.resolve` per room: socket.io declares `leave(room): Promise<void> | void` - the\n // default adapter is synchronous, a clustered one is not - and `Promise.all` over a mixed\n // iterable is what the previous `any`-typed payload was hiding.\n Promise.all(rooms.map((room) => Promise.resolve(socket.leave(room))))\n .then(() => {\n leaveLogger.info('Left rooms | id: %s | rooms: %s', id, rooms);\n })\n .catch((error) => {\n leaveLogger.error(\n 'Failed to leave rooms | id: %s | rooms: %s | error: %s',\n id,\n rooms,\n error,\n );\n });\n });\n }\n\n ping(opts: { socket: IOSocket; doIgnoreAuth: boolean }) {\n const logger = this.logger.for(this.ping.name);\n const { socket, doIgnoreAuth } = opts;\n\n if (!socket) {\n logger.info('Socket is undefined to PING!');\n return;\n }\n\n const client = this.clients.get(socket.id);\n if (!client) {\n logger.info('Client not found | socketId: %s', socket.id);\n return;\n }\n\n if (!doIgnoreAuth && client.state !== SocketIOClientStates.AUTHENTICATED) {\n logger.info('Socket client is not authenticated | state: %s', client.state);\n this.disconnect({ socket });\n return;\n }\n\n socket.emit(SocketIOConstants.EVENT_PING, { time: new Date().toISOString() });\n }\n\n disconnect(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.disconnect.name);\n const { socket } = opts;\n if (!socket) {\n return;\n }\n\n const { id } = socket;\n\n if (this.clients.has(id)) {\n const client = this.clients.get(id)!;\n\n if (client.interval) {\n clearInterval(client.interval);\n }\n\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n }\n\n this.clients.delete(id);\n }\n\n logger.info('Client disconnected | id: %s | time: %s', id, new Date().toISOString());\n socket.disconnect();\n }\n\n send(opts: {\n destination?: string;\n payload: { topic: string; data: any };\n doLog?: boolean;\n callback?: () => void;\n }) {\n const logger = this.logger.for(this.send.name);\n const { destination, payload, doLog, callback } = opts;\n\n if (!payload) {\n return;\n }\n\n const { topic, data } = payload;\n if (!topic || !data) {\n return;\n }\n\n if (!this.emitter) {\n logger.error(\n 'Cannot emit | Redis emitter is not initialized | call configure() first | topic: %s',\n topic,\n );\n return;\n }\n\n const sender = this.emitter.compress(true);\n\n if (destination && !isEmpty({ value: destination })) {\n sender.to(destination).emit(topic, data);\n } else {\n sender.emit(topic, data);\n }\n\n if (callback) {\n setImmediate(callback);\n }\n\n if (doLog) {\n logger.info(\n 'Message emitted | destination: %s | topic: %s | data: %j',\n destination ?? 'all',\n topic,\n data,\n );\n }\n }\n\n private close() {\n return new Promise<void>((resolve, reject) => {\n // configure() may never have run (or may have failed): there is nothing to close, but the redis clients still have to be released by the caller\n if (!this.io) {\n this.logger.for('close').info('SKIP close | IOServer was never initialized');\n resolve();\n return;\n }\n\n voidExecution({\n logger: this.logger,\n scope: 'close',\n execution: this.io.close((error) => {\n if (error) {\n reject(error);\n return;\n }\n\n resolve();\n }),\n });\n });\n }\n\n async shutdown() {\n const logger = this.logger.for(this.shutdown.name);\n logger.info('Shutting down SocketIO server...');\n\n for (const [, client] of this.clients) {\n if (client.interval) {\n clearInterval(client.interval);\n }\n\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n }\n\n client.socket.disconnect();\n }\n this.clients.clear();\n\n try {\n await this.close();\n } finally {\n // close() rejects when io.close() reports a lingering handle. Skipping the quits there leaves three live Redis sockets holding the event loop open, and a SIGTERM handler never returns.\n await Promise.all([this.redisPub?.quit(), this.redisSub?.quit(), this.redisEmitter?.quit()]);\n }\n\n logger.info('SocketIO server shutdown complete');\n }\n}\n"]}
@@ -28,7 +28,7 @@ class WebSocketDeliveryHelper extends base_1.BaseHelper {
28
28
  if (outboundTransformer && client.encrypted) {
29
29
  Promise.resolve()
30
30
  .then(() => outboundTransformer({ client, event, data }))
31
- .then(transformed => {
31
+ .then((transformed) => {
32
32
  const outboundMessage = transformed ?? { event, data };
33
33
  this.deliverToSocket({
34
34
  client,
@@ -38,7 +38,7 @@ class WebSocketDeliveryHelper extends base_1.BaseHelper {
38
38
  data,
39
39
  });
40
40
  })
41
- .catch(error => {
41
+ .catch((error) => {
42
42
  logger.error('Outbound transformer error | id: %s | error: %s', clientId, error);
43
43
  });
44
44
  return;
@@ -1 +1 @@
1
- {"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/delivery.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { executePromiseWithLimit } from '@/utilities';\nimport { voidExecution } from '@/utilities/promise.utility';\nimport {\n type IBunServer,\n type IWebSocketClient,\n type IWebSocketMessage,\n type TWebSocketOutboundTransformer,\n WebSocketClientStates,\n WebSocketDefaults,\n} from '../common';\n\nexport interface IWebSocketDeliveryHelperOptions<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n server: IBunServer;\n /** Shared by reference with WebSocketServerHelper - never copy, both sides must see the same live maps. */\n clients: Map<string, IWebSocketClient<MetadataType>>;\n users: Map<string, Set<string>>;\n rooms: Map<string, Set<string>>;\n outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n encryptedBatchLimit: number;\n}\n\n/** Local delivery and fan-out for the WebSocket server: single client, per-user, per-room, and broadcast. */\nexport class WebSocketDeliveryHelper<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> extends BaseHelper {\n private server: IBunServer;\n private clients: Map<string, IWebSocketClient<MetadataType>>;\n private users: Map<string, Set<string>>;\n private rooms: Map<string, Set<string>>;\n private outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n private encryptedBatchLimit: number;\n\n constructor(opts: IWebSocketDeliveryHelperOptions<MetadataType>) {\n super({ scope: WebSocketDeliveryHelper.name });\n\n this.server = opts.server;\n this.clients = opts.clients;\n this.users = opts.users;\n this.rooms = opts.rooms;\n this.outboundTransformer = opts.outboundTransformer;\n this.encryptedBatchLimit = opts.encryptedBatchLimit;\n }\n\n sendToClient(opts: { clientId: string; event: string; data: unknown; doLog?: boolean }) {\n const logger = this.logger.for(this.sendToClient.name);\n const { clientId, event, data, doLog } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n // Async path - transformer intercepts before socket.send()\n const outboundTransformer = this.outboundTransformer;\n if (outboundTransformer && client.encrypted) {\n Promise.resolve()\n .then(() => outboundTransformer({ client, event, data }))\n .then(transformed => {\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({\n client,\n payload: JSON.stringify(outboundMessage),\n doLog,\n event,\n data,\n });\n })\n .catch(error => {\n logger.error('Outbound transformer error | id: %s | error: %s', clientId, error);\n });\n return;\n }\n\n // Sync path (unchanged, zero overhead when no transformer)\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), doLog, event, data });\n }\n\n private async sendToClientAsync(opts: { clientId: string; event: string; data: unknown }) {\n const { clientId, event, data } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return Promise.resolve();\n }\n\n if (!this.outboundTransformer || !client.encrypted) {\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), event, data });\n return Promise.resolve();\n }\n\n try {\n const transformed = await Promise.resolve(this.outboundTransformer({ client, event, data }));\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({ client, payload: JSON.stringify(outboundMessage), event, data });\n } catch (error) {\n this.logger\n .for(this.sendToClientAsync.name)\n .error('Outbound transformer error | id: %s | error: %s', clientId, error);\n }\n }\n\n private deliverToSocket(opts: {\n client: IWebSocketClient<MetadataType>;\n payload: string;\n doLog?: boolean;\n event?: string;\n data?: unknown;\n }) {\n const logger = this.logger.for(this.deliverToSocket.name);\n const { client, payload, doLog, event, data } = opts;\n\n try {\n const result = client.socket.send(payload);\n\n if (result === 0) {\n logger.warn('Message dropped (socket closed) | id: %s', client.id);\n }\n\n if (result === -1) {\n client.backpressured = true;\n logger.warn('Backpressure detected | id: %s', client.id);\n }\n } catch (error) {\n logger.error('Failed to send | id: %s | error: %s', client.id, error);\n }\n\n if (doLog) {\n logger.info('Message sent | id: %s | event: %s | data: %j', client.id, event, data);\n }\n }\n\n sendToUser(opts: { userId: string; event: string; data: unknown }) {\n const { userId, event, data } = opts;\n const clientIds = this.users.get(userId);\n if (!clientIds) {\n return;\n }\n\n for (const clientId of clientIds) {\n this.sendToClient({ clientId, event, data });\n }\n }\n\n private sendToRoomExcluding(opts: {\n room: string;\n event: string;\n data: unknown;\n exclude: string[];\n }) {\n const { room, event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n const roomClientIds = this.rooms.get(room);\n if (!roomClientIds) {\n return;\n }\n\n // Serialised ONCE when there is no transformer, because the payload is then identical for every\n // recipient - `sendToClient` would otherwise run `JSON.stringify` per client on a message that\n // never differs. With a transformer each client's payload really is different, so that path\n // still goes through `sendToClient`. The non-excluding fan-out already works this way.\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data });\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n\n const client = this.clients.get(clientId);\n if (client) {\n this.deliverToSocket({ client, payload, event, data });\n }\n }\n\n return;\n }\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n this.sendToClient({ clientId, event, data });\n }\n }\n\n sendToRoom(opts: { room: string; event: string; data: unknown; exclude?: string[] }) {\n const { room, event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.sendToRoomExcluding({ room, event, data, exclude });\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(room, payload);\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const roomClientIds = this.rooms.get(room);\n if (!roomClientIds) {\n return;\n }\n\n const tasks: Array<() => Promise<void>> = [];\n for (const clientId of roomClientIds) {\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n voidExecution({\n logger: this.logger,\n scope: this.sendToRoom.name,\n execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n\n private broadcastExcluding(opts: { event: string; data: unknown; exclude: string[] }) {\n const { event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n for (const [clientId, client] of this.clients) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n // Only broadcast to authenticated clients (consistent with non-exclude path which uses BROADCAST_TOPIC)\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n\n this.sendToClient({ clientId, event, data });\n }\n }\n\n broadcast(opts: { event: string; data: unknown; exclude?: string[] }) {\n const { event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.broadcastExcluding({ event, data, exclude });\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(WebSocketDefaults.BROADCAST_TOPIC, payload);\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const tasks: Array<() => Promise<void>> = [];\n for (const [clientId, client] of this.clients) {\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n voidExecution({\n logger: this.logger,\n scope: this.broadcast.name,\n execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n}\n"]}
1
+ {"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/delivery.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { executePromiseWithLimit } from '@/utilities';\nimport { voidExecution } from '@/utilities/promise.utility';\nimport {\n type IBunServer,\n type IWebSocketClient,\n type IWebSocketMessage,\n type TWebSocketOutboundTransformer,\n WebSocketClientStates,\n WebSocketDefaults,\n} from '../common';\n\nexport interface IWebSocketDeliveryHelperOptions<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n server: IBunServer;\n /** Shared by reference with WebSocketServerHelper - never copy, both sides must see the same live maps. */\n clients: Map<string, IWebSocketClient<MetadataType>>;\n users: Map<string, Set<string>>;\n rooms: Map<string, Set<string>>;\n outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n encryptedBatchLimit: number;\n}\n\n/** Local delivery and fan-out for the WebSocket server: single client, per-user, per-room, and broadcast. */\nexport class WebSocketDeliveryHelper<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> extends BaseHelper {\n private server: IBunServer;\n private clients: Map<string, IWebSocketClient<MetadataType>>;\n private users: Map<string, Set<string>>;\n private rooms: Map<string, Set<string>>;\n private outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n private encryptedBatchLimit: number;\n\n constructor(opts: IWebSocketDeliveryHelperOptions<MetadataType>) {\n super({ scope: WebSocketDeliveryHelper.name });\n\n this.server = opts.server;\n this.clients = opts.clients;\n this.users = opts.users;\n this.rooms = opts.rooms;\n this.outboundTransformer = opts.outboundTransformer;\n this.encryptedBatchLimit = opts.encryptedBatchLimit;\n }\n\n sendToClient(opts: { clientId: string; event: string; data: unknown; doLog?: boolean }) {\n const logger = this.logger.for(this.sendToClient.name);\n const { clientId, event, data, doLog } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n // Async path - transformer intercepts before socket.send()\n const outboundTransformer = this.outboundTransformer;\n if (outboundTransformer && client.encrypted) {\n Promise.resolve()\n .then(() => outboundTransformer({ client, event, data }))\n .then((transformed) => {\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({\n client,\n payload: JSON.stringify(outboundMessage),\n doLog,\n event,\n data,\n });\n })\n .catch((error) => {\n logger.error('Outbound transformer error | id: %s | error: %s', clientId, error);\n });\n return;\n }\n\n // Sync path (unchanged, zero overhead when no transformer)\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), doLog, event, data });\n }\n\n private async sendToClientAsync(opts: { clientId: string; event: string; data: unknown }) {\n const { clientId, event, data } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return Promise.resolve();\n }\n\n if (!this.outboundTransformer || !client.encrypted) {\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), event, data });\n return Promise.resolve();\n }\n\n try {\n const transformed = await Promise.resolve(this.outboundTransformer({ client, event, data }));\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({ client, payload: JSON.stringify(outboundMessage), event, data });\n } catch (error) {\n this.logger\n .for(this.sendToClientAsync.name)\n .error('Outbound transformer error | id: %s | error: %s', clientId, error);\n }\n }\n\n private deliverToSocket(opts: {\n client: IWebSocketClient<MetadataType>;\n payload: string;\n doLog?: boolean;\n event?: string;\n data?: unknown;\n }) {\n const logger = this.logger.for(this.deliverToSocket.name);\n const { client, payload, doLog, event, data } = opts;\n\n try {\n const result = client.socket.send(payload);\n\n if (result === 0) {\n logger.warn('Message dropped (socket closed) | id: %s', client.id);\n }\n\n if (result === -1) {\n client.backpressured = true;\n logger.warn('Backpressure detected | id: %s', client.id);\n }\n } catch (error) {\n logger.error('Failed to send | id: %s | error: %s', client.id, error);\n }\n\n if (doLog) {\n logger.info('Message sent | id: %s | event: %s | data: %j', client.id, event, data);\n }\n }\n\n sendToUser(opts: { userId: string; event: string; data: unknown }) {\n const { userId, event, data } = opts;\n const clientIds = this.users.get(userId);\n if (!clientIds) {\n return;\n }\n\n for (const clientId of clientIds) {\n this.sendToClient({ clientId, event, data });\n }\n }\n\n private sendToRoomExcluding(opts: {\n room: string;\n event: string;\n data: unknown;\n exclude: string[];\n }) {\n const { room, event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n const roomClientIds = this.rooms.get(room);\n if (!roomClientIds) {\n return;\n }\n\n // Serialised ONCE when there is no transformer, because the payload is then identical for every\n // recipient - `sendToClient` would otherwise run `JSON.stringify` per client on a message that\n // never differs. With a transformer each client's payload really is different, so that path\n // still goes through `sendToClient`. The non-excluding fan-out already works this way.\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data });\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n\n const client = this.clients.get(clientId);\n if (client) {\n this.deliverToSocket({ client, payload, event, data });\n }\n }\n\n return;\n }\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n this.sendToClient({ clientId, event, data });\n }\n }\n\n sendToRoom(opts: { room: string; event: string; data: unknown; exclude?: string[] }) {\n const { room, event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.sendToRoomExcluding({ room, event, data, exclude });\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(room, payload);\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const roomClientIds = this.rooms.get(room);\n if (!roomClientIds) {\n return;\n }\n\n const tasks: Array<() => Promise<void>> = [];\n for (const clientId of roomClientIds) {\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n voidExecution({\n logger: this.logger,\n scope: this.sendToRoom.name,\n execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n\n private broadcastExcluding(opts: { event: string; data: unknown; exclude: string[] }) {\n const { event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n for (const [clientId, client] of this.clients) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n // Only broadcast to authenticated clients (consistent with non-exclude path which uses BROADCAST_TOPIC)\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n\n this.sendToClient({ clientId, event, data });\n }\n }\n\n broadcast(opts: { event: string; data: unknown; exclude?: string[] }) {\n const { event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.broadcastExcluding({ event, data, exclude });\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(WebSocketDefaults.BROADCAST_TOPIC, payload);\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const tasks: Array<() => Promise<void>> = [];\n for (const [clientId, client] of this.clients) {\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n voidExecution({\n logger: this.logger,\n scope: this.broadcast.name,\n execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n}\n"]}
@@ -574,7 +574,7 @@ class WebSocketServerHelper extends base_1.BaseHelper {
574
574
  }),
575
575
  });
576
576
  })
577
- .catch(error => {
577
+ .catch((error) => {
578
578
  logger.error('Authentication error | id: %s | error: %s', clientId, error);
579
579
  this.sendToClient({
580
580
  clientId,
@@ -597,7 +597,7 @@ class WebSocketServerHelper extends base_1.BaseHelper {
597
597
  }
598
598
  const INTERNAL_PREFIX = 'ws:';
599
599
  const MAX_ROOM_NAME_LENGTH = 256;
600
- const sanitizedRooms = rooms.filter(r => {
600
+ const sanitizedRooms = rooms.filter((r) => {
601
601
  return (typeof r === 'string' &&
602
602
  r.length > 0 &&
603
603
  r.length <= MAX_ROOM_NAME_LENGTH &&
@@ -624,7 +624,7 @@ class WebSocketServerHelper extends base_1.BaseHelper {
624
624
  }
625
625
  logger.info('Joined rooms | id: %s | rooms: %j', clientId, allowedRooms);
626
626
  })
627
- .catch(error => {
627
+ .catch((error) => {
628
628
  logger.error('Failed to join rooms | id: %s | rooms: %j | error: %s', clientId, sanitizedRooms, error);
629
629
  });
630
630
  }
@@ -640,7 +640,7 @@ class WebSocketServerHelper extends base_1.BaseHelper {
640
640
  return;
641
641
  }
642
642
  // Only leave rooms the client has actually joined - prevents unsubscribing from internal topics
643
- const validRooms = rooms.filter(r => client.rooms.has(r));
643
+ const validRooms = rooms.filter((r) => client.rooms.has(r));
644
644
  if (!validRooms.length) {
645
645
  return;
646
646
  }