@venizia/ignis-helpers 0.4.8-9 → 0.4.8

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 (199) hide show
  1. package/README.md +2 -3
  2. package/dist/esm/common/constants/app.d.ts +1 -3
  3. package/dist/esm/common/constants/app.js +1 -11
  4. package/dist/esm/common/constants/app.js.map +1 -1
  5. package/dist/esm/common/constants/http.d.ts +2 -0
  6. package/dist/esm/common/constants/http.js +3 -0
  7. package/dist/esm/common/constants/http.js.map +1 -1
  8. package/dist/esm/common/constants/mime.d.ts +0 -2
  9. package/dist/esm/common/constants/mime.js +0 -4
  10. package/dist/esm/common/constants/mime.js.map +1 -1
  11. package/dist/esm/common/redact.js.map +1 -1
  12. package/dist/esm/common/types/class.d.ts +14 -12
  13. package/dist/esm/common/types/class.js.map +1 -1
  14. package/dist/esm/common/types/const-value.d.ts +3 -3
  15. package/dist/esm/common/types/const-value.js.map +1 -1
  16. package/dist/esm/common/types/field-mapping.d.ts +6 -8
  17. package/dist/esm/common/types/field-mapping.js +0 -10
  18. package/dist/esm/common/types/field-mapping.js.map +1 -1
  19. package/dist/esm/common/types/index.d.ts +1 -0
  20. package/dist/esm/common/types/index.js +1 -0
  21. package/dist/esm/common/types/index.js.map +1 -1
  22. package/dist/esm/common/types/injection.d.ts +1 -1
  23. package/dist/esm/common/types/injection.js.map +1 -1
  24. package/dist/esm/common/types/json.d.ts +14 -0
  25. package/dist/esm/common/types/json.js +2 -0
  26. package/dist/esm/common/types/json.js.map +1 -0
  27. package/dist/esm/common/types/utility.d.ts +0 -4
  28. package/dist/esm/common/types/utility.js.map +1 -1
  29. package/dist/esm/modules/env/app-env.d.ts +17 -8
  30. package/dist/esm/modules/env/app-env.js +18 -15
  31. package/dist/esm/modules/env/app-env.js.map +1 -1
  32. package/dist/esm/modules/env/common/types.d.ts +22 -6
  33. package/dist/esm/modules/env/common/types.js.map +1 -1
  34. package/dist/esm/modules/logger/base/abstract.d.ts +6 -7
  35. package/dist/esm/modules/logger/base/abstract.js.map +1 -1
  36. package/dist/esm/modules/logger/base/base.d.ts +7 -8
  37. package/dist/esm/modules/logger/base/base.js.map +1 -1
  38. package/dist/esm/modules/logger/base/console.d.ts +6 -7
  39. package/dist/esm/modules/logger/base/console.js.map +1 -1
  40. package/dist/esm/modules/logger/common/types.d.ts +7 -7
  41. package/dist/esm/modules/logger/common/types.js.map +1 -1
  42. package/dist/esm/modules/logger/factory.js.map +1 -1
  43. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  44. package/dist/esm/modules/logger/hf/logger.d.ts +6 -7
  45. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  46. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  47. package/dist/esm/modules/logger/pino/destination.d.ts +1 -1
  48. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  49. package/dist/esm/modules/logger/pino/logger.d.ts +1 -2
  50. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  51. package/dist/esm/modules/logger/winston/formats.js +2 -2
  52. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  53. package/dist/esm/modules/logger/winston/logger.d.ts +1 -2
  54. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  55. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -1
  56. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -1
  57. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  58. package/dist/esm/modules/network/http-request/common/constants.d.ts +0 -2
  59. package/dist/esm/modules/network/http-request/common/constants.js +0 -4
  60. package/dist/esm/modules/network/http-request/common/constants.js.map +1 -1
  61. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +6 -6
  62. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  63. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +2 -3
  64. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  65. package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts +1 -1
  66. package/dist/esm/modules/network/http-request/fetcher/common/types.js.map +1 -1
  67. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +1 -2
  68. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +5 -6
  69. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  70. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts +4 -4
  71. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -1
  72. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  73. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts +3 -5
  74. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +0 -8
  75. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  76. package/dist/esm/modules/network/utilities/query-string.d.ts +2 -2
  77. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  78. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +0 -2
  79. package/dist/esm/modules/network/utilities/url-safety/common/constants.js +0 -4
  80. package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
  81. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  82. package/dist/esm/modules/queue/bullmq/helper.d.ts +23 -10
  83. package/dist/esm/modules/queue/bullmq/helper.js +57 -10
  84. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  85. package/dist/esm/modules/queue/common/constants.d.ts +6 -2
  86. package/dist/esm/modules/queue/common/constants.js +6 -4
  87. package/dist/esm/modules/queue/common/constants.js.map +1 -1
  88. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts +2 -4
  89. package/dist/esm/modules/queue/internal/sequential/common/types.js +0 -4
  90. package/dist/esm/modules/queue/internal/sequential/common/types.js.map +1 -1
  91. package/dist/esm/modules/queue/kafka/base.d.ts +1 -1
  92. package/dist/esm/modules/queue/kafka/base.js +13 -2
  93. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  94. package/dist/esm/modules/queue/kafka/common/constants.d.ts +0 -4
  95. package/dist/esm/modules/queue/kafka/common/constants.js +0 -8
  96. package/dist/esm/modules/queue/kafka/common/constants.js.map +1 -1
  97. package/dist/esm/modules/redis/base/abstract.helper.d.ts +13 -2
  98. package/dist/esm/modules/redis/base/abstract.helper.js +53 -45
  99. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  100. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -2
  101. package/dist/esm/modules/redis/cluster/cluster.helper.js +21 -9
  102. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  103. package/dist/esm/modules/redis/cluster/index.d.ts +1 -0
  104. package/dist/esm/modules/redis/cluster/index.js +1 -0
  105. package/dist/esm/modules/redis/cluster/index.js.map +1 -1
  106. package/dist/esm/modules/redis/cluster/types.d.ts +20 -0
  107. package/dist/esm/modules/redis/cluster/types.js +2 -0
  108. package/dist/esm/modules/redis/cluster/types.js.map +1 -0
  109. package/dist/esm/modules/redis/common/constants.d.ts +15 -19
  110. package/dist/esm/modules/redis/common/constants.js +16 -18
  111. package/dist/esm/modules/redis/common/constants.js.map +1 -1
  112. package/dist/esm/modules/redis/common/types.d.ts +10 -60
  113. package/dist/esm/modules/redis/common/types.js.map +1 -1
  114. package/dist/esm/modules/redis/factory.d.ts +7 -25
  115. package/dist/esm/modules/redis/factory.js +9 -18
  116. package/dist/esm/modules/redis/factory.js.map +1 -1
  117. package/dist/esm/modules/redis/sentinel/constants.d.ts +14 -0
  118. package/dist/esm/modules/redis/sentinel/constants.js +11 -0
  119. package/dist/esm/modules/redis/sentinel/constants.js.map +1 -0
  120. package/dist/esm/modules/redis/sentinel/index.d.ts +2 -0
  121. package/dist/esm/modules/redis/sentinel/index.js +2 -0
  122. package/dist/esm/modules/redis/sentinel/index.js.map +1 -1
  123. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -2
  124. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +25 -15
  125. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  126. package/dist/esm/modules/redis/sentinel/types.d.ts +26 -0
  127. package/dist/esm/modules/redis/sentinel/types.js +2 -0
  128. package/dist/esm/modules/redis/sentinel/types.js.map +1 -0
  129. package/dist/esm/modules/redis/single/index.d.ts +1 -0
  130. package/dist/esm/modules/redis/single/index.js +1 -0
  131. package/dist/esm/modules/redis/single/index.js.map +1 -1
  132. package/dist/esm/modules/redis/single/single.helper.d.ts +1 -2
  133. package/dist/esm/modules/redis/single/single.helper.js +5 -6
  134. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  135. package/dist/esm/modules/redis/single/types.d.ts +15 -0
  136. package/dist/esm/modules/redis/single/types.js +2 -0
  137. package/dist/esm/modules/redis/single/types.js.map +1 -0
  138. package/dist/esm/modules/secrets/base/abstract.helper.js +6 -1
  139. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  140. package/dist/esm/modules/secrets/common/types/registration.d.ts +25 -6
  141. package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
  142. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -1
  143. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  144. package/dist/esm/modules/secrets/factory.js +7 -6
  145. package/dist/esm/modules/secrets/factory.js.map +1 -1
  146. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +12 -10
  147. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +50 -25
  148. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  149. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -1
  150. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts +2 -2
  151. package/dist/esm/modules/socket/socket-io/common/types/client.js.map +1 -1
  152. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts +3 -1
  153. package/dist/esm/modules/socket/socket-io/common/types/server.js.map +1 -1
  154. package/dist/esm/modules/socket/socket-io/server/helper.d.ts +2 -2
  155. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  156. package/dist/esm/modules/storage/base.d.ts +24 -60
  157. package/dist/esm/modules/storage/base.js +66 -123
  158. package/dist/esm/modules/storage/base.js.map +1 -1
  159. package/dist/esm/modules/storage/bun-s3/helper.d.ts +21 -35
  160. package/dist/esm/modules/storage/bun-s3/helper.js +126 -128
  161. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  162. package/dist/esm/modules/storage/bun-s3/utility.d.ts +13 -7
  163. package/dist/esm/modules/storage/bun-s3/utility.js +63 -45
  164. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  165. package/dist/esm/modules/storage/common/constants.d.ts +29 -2
  166. package/dist/esm/modules/storage/common/constants.js +29 -4
  167. package/dist/esm/modules/storage/common/constants.js.map +1 -1
  168. package/dist/esm/modules/storage/common/errors.d.ts +9 -0
  169. package/dist/esm/modules/storage/common/errors.js +9 -0
  170. package/dist/esm/modules/storage/common/errors.js.map +1 -1
  171. package/dist/esm/modules/storage/common/types.d.ts +90 -61
  172. package/dist/esm/modules/storage/common/types.js.map +1 -1
  173. package/dist/esm/modules/storage/common/utility.d.ts +8 -0
  174. package/dist/esm/modules/storage/common/utility.js +14 -2
  175. package/dist/esm/modules/storage/common/utility.js.map +1 -1
  176. package/dist/esm/modules/storage/disk/helper.d.ts +3 -8
  177. package/dist/esm/modules/storage/disk/helper.js +1 -0
  178. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  179. package/dist/esm/modules/storage/in-memory/helper.d.ts +2 -3
  180. package/dist/esm/modules/storage/in-memory/helper.js.map +1 -1
  181. package/dist/esm/modules/worker-thread/common/types.d.ts +2 -2
  182. package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
  183. package/dist/esm/modules/worker-thread/thread/abstract.d.ts +2 -2
  184. package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
  185. package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -1
  186. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  187. package/dist/esm/utilities/module.utility.d.ts +8 -5
  188. package/dist/esm/utilities/module.utility.js +5 -1
  189. package/dist/esm/utilities/module.utility.js.map +1 -1
  190. package/dist/esm/utilities/parse.utility.d.ts +34 -6
  191. package/dist/esm/utilities/parse.utility.js +82 -15
  192. package/dist/esm/utilities/parse.utility.js.map +1 -1
  193. package/dist/esm/utilities/performance.utility.d.ts +3 -3
  194. package/dist/esm/utilities/performance.utility.js.map +1 -1
  195. package/dist/esm/utilities/promise.utility.d.ts +1 -1
  196. package/dist/esm/utilities/promise.utility.js.map +1 -1
  197. package/dist/esm/utilities/request.utility.d.ts +9 -11
  198. package/dist/esm/utilities/request.utility.js.map +1 -1
  199. package/package.json +3 -3
@@ -1 +1 @@
1
- {"version":3,"file":"browser-helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/client/browser-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 type { Socket } from 'socket.io-client';\n// The leaf files, never the `../common` barrel: it reaches the server types, which name node modules.\nimport { SocketIOClientStates, SocketIOConstants } from '../common/constants';\nimport type {\n IOptions,\n ISocketIOClientOptions,\n TSocketIOClientState,\n} from '../common/types/client';\nimport type { TSocketIOEventHandler } from '../common/types/hooks';\n\n/**\n * The socket.io client with nothing node in its graph, so a browser bundle can hold it: `socket.io-client`\n * is handed in as `module` (`{ io }` from the app's own `import`) instead of being found on disk.\n * `@venizia/ignis-helpers/socket-io` extends it and finds the module itself when none is handed in.\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 protected 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 /** The `socket.io-client` module to connect with. Here only the one handed in; a subclass may find one. */\n protected resolveModule(): typeof import('socket.io-client') {\n if (!this.clientModule) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[SocketIOClientHelper][${this.identifier}] option 'module' is required: pass { io } from 'socket.io-client'`,\n });\n }\n\n return this.clientModule;\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\n return;\n }\n\n const { io } = this.resolveModule();\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\n return;\n }\n\n if (this.state !== SocketIOClientStates.UNAUTHORIZED) {\n logger.warn('Cannot authenticate | id: %s | currentState: %s', this.identifier, this.state);\n\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\n return;\n }\n\n if (ignoreDuplicate && this.client.hasListeners(event)) {\n logger.info('Handler already exists | event: %s', event);\n\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\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\n return;\n }\n\n if (handler) {\n const wrappedHandler = this.wrappedHandlers.get(event)?.get(handler);\n\n if (!wrappedHandler) {\n logger.info('Handler was not subscribed through this helper | event: %s', event);\n\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\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\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\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\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\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":"browser-helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/client/browser-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 type { Socket } from 'socket.io-client';\n// The leaf files, never the `../common` barrel: it reaches the server types, which name node modules.\nimport { SocketIOClientStates, SocketIOConstants } from '../common/constants';\nimport type {\n IOptions,\n ISocketIOClientOptions,\n TSocketIOClientState,\n} from '../common/types/client';\nimport type { TSocketIOEventHandler } from '../common/types/hooks';\n\n/** What `socket.off` takes back: the wrapper `subscribe` registered in place of the caller's handler. */\ntype TWrappedListener = NonNullable<Parameters<Socket['off']>[1]>;\n\n/**\n * The socket.io client with nothing node in its graph, so a browser bundle can hold it: `socket.io-client`\n * is handed in as `module` (`{ io }` from the app's own `import`) instead of being found on disk.\n * `@venizia/ignis-helpers/socket-io` extends it and finds the module itself when none is handed in.\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<never>, TWrappedListener>> =\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 protected 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 /** The `socket.io-client` module to connect with. Here only the one handed in; a subclass may find one. */\n protected resolveModule(): typeof import('socket.io-client') {\n if (!this.clientModule) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[SocketIOClientHelper][${this.identifier}] option 'module' is required: pass { io } from 'socket.io-client'`,\n });\n }\n\n return this.clientModule;\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\n return;\n }\n\n const { io } = this.resolveModule();\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\n return;\n }\n\n if (this.state !== SocketIOClientStates.UNAUTHORIZED) {\n logger.warn('Cannot authenticate | id: %s | currentState: %s', this.identifier, this.state);\n\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\n return;\n }\n\n if (ignoreDuplicate && this.client.hasListeners(event)) {\n logger.info('Handler already exists | event: %s', event);\n\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\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\n return;\n }\n\n if (handler) {\n const wrappedHandler = this.wrappedHandlers.get(event)?.get(handler);\n\n if (!wrappedHandler) {\n logger.info('Handler was not subscribed through this helper | event: %s', event);\n\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\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\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\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\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\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"]}
@@ -15,7 +15,7 @@ export interface IHandshake {
15
15
  url: string;
16
16
  query: ParsedUrlQuery;
17
17
  auth: {
18
- [key: string]: any;
18
+ [key: string]: unknown;
19
19
  };
20
20
  }
21
21
  /** One of the `SocketIOClientStates` values. */
@@ -31,7 +31,7 @@ export interface ISocketIOClient {
31
31
  /** Connection options for the Socket.IO client helper: the `socket.io-client` options plus a required `path` and `extraHeaders`. */
32
32
  export interface IOptions extends SocketOptions {
33
33
  path: string;
34
- extraHeaders: Record<string | symbol | number, any>;
34
+ extraHeaders: Record<string, string>;
35
35
  }
36
36
  /** Options for the Socket.IO client helper. The `on*` callbacks fire on the matching connection or authentication event. */
37
37
  export interface ISocketIOClientOptions {
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/socket-io/common/types/client.ts"],"names":[],"mappings":"","sourcesContent":["import { type TConstValue, type ValueOrPromise } from '@/common/types';\nimport { type IncomingHttpHeaders } from 'node:http';\nimport { type ParsedUrlQuery } from 'node:querystring';\nimport type { Socket as IOSocket } from 'socket.io';\nimport type { SocketOptions } from 'socket.io-client';\nimport { type SocketIOClientStates } from '../constants';\n\n/** Handshake data of a connecting Socket.IO client; passed to the authenticate hook. */\nexport interface IHandshake {\n headers: IncomingHttpHeaders;\n time: string;\n address: string;\n xdomain: boolean;\n secure: boolean;\n issued: number;\n url: string;\n query: ParsedUrlQuery;\n auth: {\n [key: string]: any;\n };\n}\n\n/** One of the `SocketIOClientStates` values. */\nexport type TSocketIOClientState = TConstValue<typeof SocketIOClientStates>;\n\n/** A connected Socket.IO client as tracked by the server helper, with its authentication state and timers. */\nexport interface ISocketIOClient {\n id: string;\n socket: IOSocket;\n state: TSocketIOClientState;\n interval?: NodeJS.Timeout;\n authenticateTimeout?: NodeJS.Timeout;\n}\n\n/** Connection options for the Socket.IO client helper: the `socket.io-client` options plus a required `path` and `extraHeaders`. */\nexport interface IOptions extends SocketOptions {\n path: string;\n extraHeaders: Record<string | symbol | number, any>;\n}\n\n/** Options for the Socket.IO client helper. The `on*` callbacks fire on the matching connection or authentication event. */\nexport interface ISocketIOClientOptions {\n identifier: string;\n host: string;\n options: IOptions;\n\n /** `socket.io-client` itself, for a `bun build --compile` binary that has no `node_modules` to load it from. Omitted, it is loaded on `configure()`. */\n module?: typeof import('socket.io-client');\n\n onConnected?: () => ValueOrPromise<void>;\n onDisconnected?: (reason: string) => ValueOrPromise<void>;\n onError?: (error: Error) => ValueOrPromise<void>;\n onAuthenticated?: () => ValueOrPromise<void>;\n onUnauthenticated?: (message: string) => ValueOrPromise<void>;\n}\n"]}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/socket-io/common/types/client.ts"],"names":[],"mappings":"","sourcesContent":["import { type TConstValue, type ValueOrPromise } from '@/common/types';\nimport { type IncomingHttpHeaders } from 'node:http';\nimport { type ParsedUrlQuery } from 'node:querystring';\nimport type { Socket as IOSocket } from 'socket.io';\nimport type { SocketOptions } from 'socket.io-client';\nimport { type SocketIOClientStates } from '../constants';\n\n/** Handshake data of a connecting Socket.IO client; passed to the authenticate hook. */\nexport interface IHandshake {\n headers: IncomingHttpHeaders;\n time: string;\n address: string;\n xdomain: boolean;\n secure: boolean;\n issued: number;\n url: string;\n query: ParsedUrlQuery;\n auth: {\n [key: string]: unknown;\n };\n}\n\n/** One of the `SocketIOClientStates` values. */\nexport type TSocketIOClientState = TConstValue<typeof SocketIOClientStates>;\n\n/** A connected Socket.IO client as tracked by the server helper, with its authentication state and timers. */\nexport interface ISocketIOClient {\n id: string;\n socket: IOSocket;\n state: TSocketIOClientState;\n interval?: NodeJS.Timeout;\n authenticateTimeout?: NodeJS.Timeout;\n}\n\n/** Connection options for the Socket.IO client helper: the `socket.io-client` options plus a required `path` and `extraHeaders`. */\nexport interface IOptions extends SocketOptions {\n path: string;\n extraHeaders: Record<string, string>;\n}\n\n/** Options for the Socket.IO client helper. The `on*` callbacks fire on the matching connection or authentication event. */\nexport interface ISocketIOClientOptions {\n identifier: string;\n host: string;\n options: IOptions;\n\n /** `socket.io-client` itself, for a `bun build --compile` binary that has no `node_modules` to load it from. Omitted, it is loaded on `configure()`. */\n module?: typeof import('socket.io-client');\n\n onConnected?: () => ValueOrPromise<void>;\n onDisconnected?: (reason: string) => ValueOrPromise<void>;\n onError?: (error: Error) => ValueOrPromise<void>;\n onAuthenticated?: () => ValueOrPromise<void>;\n onUnauthenticated?: (message: string) => ValueOrPromise<void>;\n}\n"]}
@@ -17,10 +17,12 @@ export interface ISocketIOServerBaseOptions {
17
17
  validateRoomFn?: TSocketIOValidateRoomFn;
18
18
  clientConnectedFn?: TSocketIOClientConnectedFn;
19
19
  }
20
+ /** A `@socket.io/bun-engine` server. Socket.IO types what `io.bind` takes as `any` and the engine is an optional peer, so the helper names only that it is an object it passes on. */
21
+ export type TSocketIOBunEngine = object;
20
22
  /** Socket.IO server options for the Bun runtime; `engine` is a `@socket.io/bun-engine` server instance. */
21
23
  export interface ISocketIOServerBunOptions extends ISocketIOServerBaseOptions {
22
24
  runtime: typeof RuntimeModules.BUN;
23
- engine: any;
25
+ engine: TSocketIOBunEngine;
24
26
  }
25
27
  /** Options accepted by `SocketIOServerHelper`. */
26
28
  export type TSocketIOServerOptions = ISocketIOServerBunOptions;
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/socket-io/common/types/server.ts"],"names":[],"mappings":"","sourcesContent":["import { type RuntimeModules } from '@/common/constants';\nimport { type IRedisHelper } from '@/modules/redis';\nimport type { ServerOptions } from 'socket.io';\nimport {\n type TSocketIOAuthenticateFn,\n type TSocketIOClientConnectedFn,\n type TSocketIOValidateRoomFn,\n} from './hooks';\n\n/** Options shared by every Socket.IO server runtime. `authenticateTimeout` and `pingInterval` are milliseconds. */\nexport interface ISocketIOServerBaseOptions {\n identifier: string;\n serverOptions: Partial<ServerOptions>;\n redisConnection: IRedisHelper;\n /** @default [SocketIOConstants.ROOM_DEFAULT, SocketIOConstants.ROOM_NOTIFICATION] */\n defaultRooms?: string[];\n /** @default 10_000 */\n authenticateTimeout?: number;\n /** @default 30_000 */\n pingInterval?: number;\n\n authenticateFn: TSocketIOAuthenticateFn;\n validateRoomFn?: TSocketIOValidateRoomFn;\n clientConnectedFn?: TSocketIOClientConnectedFn;\n}\n\n/** Socket.IO server options for the Bun runtime; `engine` is a `@socket.io/bun-engine` server instance. */\nexport interface ISocketIOServerBunOptions extends ISocketIOServerBaseOptions {\n runtime: typeof RuntimeModules.BUN;\n engine: any; // @socket.io/bun-engine Server instance — typed as any since it's an optional peer dep\n}\n\n/** Options accepted by `SocketIOServerHelper`. */\nexport type TSocketIOServerOptions = ISocketIOServerBunOptions;\n"]}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/socket-io/common/types/server.ts"],"names":[],"mappings":"","sourcesContent":["import { type RuntimeModules } from '@/common/constants';\nimport { type IRedisHelper } from '@/modules/redis';\nimport type { ServerOptions } from 'socket.io';\nimport {\n type TSocketIOAuthenticateFn,\n type TSocketIOClientConnectedFn,\n type TSocketIOValidateRoomFn,\n} from './hooks';\n\n/** Options shared by every Socket.IO server runtime. `authenticateTimeout` and `pingInterval` are milliseconds. */\nexport interface ISocketIOServerBaseOptions {\n identifier: string;\n serverOptions: Partial<ServerOptions>;\n redisConnection: IRedisHelper;\n /** @default [SocketIOConstants.ROOM_DEFAULT, SocketIOConstants.ROOM_NOTIFICATION] */\n defaultRooms?: string[];\n /** @default 10_000 */\n authenticateTimeout?: number;\n /** @default 30_000 */\n pingInterval?: number;\n\n authenticateFn: TSocketIOAuthenticateFn;\n validateRoomFn?: TSocketIOValidateRoomFn;\n clientConnectedFn?: TSocketIOClientConnectedFn;\n}\n\n/** A `@socket.io/bun-engine` server. Socket.IO types what `io.bind` takes as `any` and the engine is an optional peer, so the helper names only that it is an object it passes on. */\nexport type TSocketIOBunEngine = object;\n\n/** Socket.IO server options for the Bun runtime; `engine` is a `@socket.io/bun-engine` server instance. */\nexport interface ISocketIOServerBunOptions extends ISocketIOServerBaseOptions {\n runtime: typeof RuntimeModules.BUN;\n engine: TSocketIOBunEngine;\n}\n\n/** Options accepted by `SocketIOServerHelper`. */\nexport type TSocketIOServerOptions = ISocketIOServerBunOptions;\n"]}
@@ -28,7 +28,7 @@ export declare class SocketIOServerHelper extends BaseHelper {
28
28
  scope: string;
29
29
  execution: () => ValueOrPromise<void>;
30
30
  }): void;
31
- getEngine(): any;
31
+ getEngine(): object | undefined;
32
32
  getClients(opts?: {
33
33
  id?: string;
34
34
  }): ISocketIOClient | Map<string, ISocketIOClient> | undefined;
@@ -68,7 +68,7 @@ export declare class SocketIOServerHelper extends BaseHelper {
68
68
  destination?: string;
69
69
  payload: {
70
70
  topic: string;
71
- data: any;
71
+ data: unknown;
72
72
  };
73
73
  doLog?: boolean;
74
74
  callback?: () => void;
@@ -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 { ObjectUtility } 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 { RedisUtility, type TRedisClient } from '@/modules/redis';\nimport { PromiseUtility } 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 { 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\n/** Socket.IO server over a Redis adapter. Clients must authenticate through `authenticateFn` within `authenticateTimeout` and are pinged every `pingInterval`. */\nexport class SocketIOServerHelper extends BaseHelper {\n private runtime: TRuntimeModule;\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.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\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 PromiseUtility.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 return this.bunEngine;\n }\n\n getClients(opts?: { id?: string }): ISocketIOClient | Map<string, ISocketIOClient> | undefined {\n const { id } = opts ?? {};\n\n if (id) {\n return this.clients.get(id);\n }\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\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 RedisUtility.ensureConnecting({\n clients: [this.redisPub, this.redisSub, this.redisEmitter],\n logger: this.logger,\n scope: this.configure.name,\n });\n\n await Promise.all([\n RedisUtility.waitForReady({ client: this.redisPub }),\n RedisUtility.waitForReady({ client: this.redisSub }),\n RedisUtility.waitForReady({ 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.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\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\n return;\n }\n\n const { id, handshake } = socket;\n\n if (this.clients.has(id)) {\n logger.info('Socket client already existed | id: %s', id);\n\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\n if (currentClient?.state === SocketIOClientStates.AUTHENTICATED) {\n return;\n }\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\n if (!currentClient) {\n authLogger.warn('Client no longer exists during auth | id: %s', id);\n\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\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\n return;\n }\n\n authLogger.info('Authentication completed | id: %s | result: %s', id, rs);\n\n if (rs) {\n this.onClientAuthenticated({ socket });\n\n return;\n }\n\n const failedClient = this.clients.get(id);\n\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\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\n return;\n }\n\n const { id } = socket;\n const client = this.clients.get(id);\n\n if (!client) {\n logger.info('Unknown client | id: %s', id);\n this.disconnect({ socket });\n\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 // The authenticated room first, and whatever `defaultRooms` the application configured: a broadcast must reach an\n // authenticated socket even when the application replaced the defaults.\n const rooms = [...new Set([SocketIOConstants.ROOM_AUTHENTICATED, ...this.defaultRooms])];\n\n Promise.all(rooms.map((room: string) => Promise.resolve(socket.join(room))))\n .then(() => {\n logger.info('Joined default rooms | id: %s | rooms: %s', id, rooms);\n })\n .catch((error) => {\n logger.error(\n 'Failed to join default rooms | id: %s | rooms: %s | error: %s',\n id,\n rooms,\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\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\n if (!rooms.length) {\n return;\n }\n\n const validateRoomFn = this.validateRoomFn;\n\n if (!validateRoomFn) {\n joinLogger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no validateRoomFn configured',\n id,\n rooms,\n );\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\n return;\n }\n\n joinLogger.info('Joining rooms | id: %s | rooms: %j', id, allowedRooms);\n\n for (const room of allowedRooms) {\n PromiseUtility.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\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\n return;\n }\n\n const client = this.clients.get(socket.id);\n\n if (!client) {\n logger.info('Client not found | socketId: %s', socket.id);\n\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\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\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\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\n return;\n }\n\n const sender = this.emitter.compress(true);\n\n if (destination && !ObjectUtility.isEmpty({ value: destination })) {\n sender.to(destination).emit(topic, data);\n } else {\n // Not `sender.emit`: that reaches every connected socket, the ones that have not authenticated included.\n sender.to(SocketIOConstants.ROOM_AUTHENTICATED).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 ?? SocketIOConstants.ROOM_AUTHENTICATED,\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\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: 'close',\n execution: this.io.close((error) => {\n if (error) {\n reject(error);\n\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\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 { ObjectUtility } 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 { RedisUtility, type TRedisClient } from '@/modules/redis';\nimport { PromiseUtility } 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 { 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 TSocketIOBunEngine,\n type TSocketIOServerOptions,\n type TSocketIOValidateRoomFn,\n} from '../common';\n\nconst CLIENT_AUTHENTICATE_TIMEOUT = 10_000;\nconst CLIENT_PING_INTERVAL = 30_000;\n\n/** Socket.IO server over a Redis adapter. Clients must authenticate through `authenticateFn` within `authenticateTimeout` and are pinged every `pingInterval`. */\nexport class SocketIOServerHelper extends BaseHelper {\n private runtime: TRuntimeModule;\n private bunEngine?: TSocketIOBunEngine;\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.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\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 PromiseUtility.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 return this.bunEngine;\n }\n\n getClients(opts?: { id?: string }): ISocketIOClient | Map<string, ISocketIOClient> | undefined {\n const { id } = opts ?? {};\n\n if (id) {\n return this.clients.get(id);\n }\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\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 RedisUtility.ensureConnecting({\n clients: [this.redisPub, this.redisSub, this.redisEmitter],\n logger: this.logger,\n scope: this.configure.name,\n });\n\n await Promise.all([\n RedisUtility.waitForReady({ client: this.redisPub }),\n RedisUtility.waitForReady({ client: this.redisSub }),\n RedisUtility.waitForReady({ 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.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\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\n return;\n }\n\n const { id, handshake } = socket;\n\n if (this.clients.has(id)) {\n logger.info('Socket client already existed | id: %s', id);\n\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\n if (currentClient?.state === SocketIOClientStates.AUTHENTICATED) {\n return;\n }\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\n if (!currentClient) {\n authLogger.warn('Client no longer exists during auth | id: %s', id);\n\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\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\n return;\n }\n\n authLogger.info('Authentication completed | id: %s | result: %s', id, rs);\n\n if (rs) {\n this.onClientAuthenticated({ socket });\n\n return;\n }\n\n const failedClient = this.clients.get(id);\n\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\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\n return;\n }\n\n const { id } = socket;\n const client = this.clients.get(id);\n\n if (!client) {\n logger.info('Unknown client | id: %s', id);\n this.disconnect({ socket });\n\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 // The authenticated room first, and whatever `defaultRooms` the application configured: a broadcast must reach an\n // authenticated socket even when the application replaced the defaults.\n const rooms = [...new Set([SocketIOConstants.ROOM_AUTHENTICATED, ...this.defaultRooms])];\n\n Promise.all(rooms.map((room: string) => Promise.resolve(socket.join(room))))\n .then(() => {\n logger.info('Joined default rooms | id: %s | rooms: %s', id, rooms);\n })\n .catch((error) => {\n logger.error(\n 'Failed to join default rooms | id: %s | rooms: %s | error: %s',\n id,\n rooms,\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\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: unknown) => {\n const rooms = SocketIOServerHelper.toRoomList(payload);\n\n if (!rooms.length) {\n return;\n }\n\n const validateRoomFn = this.validateRoomFn;\n\n if (!validateRoomFn) {\n joinLogger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no validateRoomFn configured',\n id,\n rooms,\n );\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\n return;\n }\n\n joinLogger.info('Joining rooms | id: %s | rooms: %j', id, allowedRooms);\n\n for (const room of allowedRooms) {\n PromiseUtility.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: unknown) => {\n const rooms = SocketIOServerHelper.toRoomList(payload);\n\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\n return;\n }\n\n const client = this.clients.get(socket.id);\n\n if (!client) {\n logger.info('Client not found | socketId: %s', socket.id);\n\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\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\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: unknown };\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\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\n return;\n }\n\n const sender = this.emitter.compress(true);\n\n if (destination && !ObjectUtility.isEmpty({ value: destination })) {\n sender.to(destination).emit(topic, data);\n } else {\n // Not `sender.emit`: that reaches every connected socket, the ones that have not authenticated included.\n sender.to(SocketIOConstants.ROOM_AUTHENTICATED).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 ?? SocketIOConstants.ROOM_AUTHENTICATED,\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\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: 'close',\n execution: this.io.close((error) => {\n if (error) {\n reject(error);\n\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\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,7 +1,6 @@
1
- import { type IDuration } from '../../common/index.js';
2
1
  import { BaseHelper } from '../base.js';
3
- import { Readable } from 'node:stream';
4
- import { type IBucketInfo, type IBucketRef, type IFileStat, type IListObjectsOptions, type IObjectInfo, type IObjectLocation, type IPostPolicy, type IObjectRef, type IStorageHelper, type IUploadFile, type IUploadResult, type TUploadNaming } from './common/index.js';
2
+ import type { Readable } from 'node:stream';
3
+ import { type IBucketInfo, type IBucketRef, type IFileStat, type IListObjectsOptions, type IObjectInfo, type IObjectLocation, type IPostPolicy, type IObjectRef, type IStorageHelper, type IStorageReadCondition, type ICopyObjectOptions, type IPresignGetOptions, type IPresignPostOptions, type IPresignPutOptions, type IUploadOptions, type IWriteStreamOptions, type TObjectStreamOptions, type IUploadFile, type IUploadResult, type TUploadNaming } from './common/index.js';
5
4
  /** Shared base for storage helpers: MIME lookup, name and path validation, and upload naming. Concrete helpers implement the backend calls. */
6
5
  export declare abstract class BaseStorageHelper extends BaseHelper implements IStorageHelper {
7
6
  constructor(opts: {
@@ -11,14 +10,17 @@ export declare abstract class BaseStorageHelper extends BaseHelper implements IS
11
10
  getMimeType(opts: {
12
11
  filename: string;
13
12
  }): string;
14
- /** One path segment or file name: at most 255 UTF-8 bytes, no separator, no traversal, no control or shell character. */
15
- isValidSegment(opts: {
16
- segment: string;
17
- }): boolean;
18
13
  static readonly DEFAULT_MAX_FOLDER_DEPTH = 2;
19
14
  private static readonly UTF8;
15
+ private static readonly DANGEROUS_NAME_CHARACTERS;
20
16
  /** Control characters, lone surrogates, the line and paragraph separators (U+2028, U+2029) and the bidirectional marks and overrides: never part of a file name or a key (the overrides make `gpj.exe` display as `exe.jpg`), and a control character or a surrogate cannot be encoded into a header. */
21
17
  private static readonly UNSAFE_NAME_CHARACTERS;
18
+ /** Every way a segment can be refused, first match wins. */
19
+ private static readonly SEGMENT_RULES;
20
+ /** One path segment or file name: at most 255 UTF-8 bytes, no separator, no traversal, no control or shell character. */
21
+ isValidSegment(opts: {
22
+ segment: string;
23
+ }): boolean;
22
24
  /** A bucket name is one segment; a separator in it would silently address a different bucket. */
23
25
  isValidBucketName(opts: {
24
26
  bucket: IBucketRef;
@@ -58,42 +60,13 @@ export declare abstract class BaseStorageHelper extends BaseHelper implements IS
58
60
  isKeyResolvedByCaller?: boolean;
59
61
  }): void;
60
62
  private validateUploadFile;
61
- upload(opts: {
62
- bucket: IBucketRef;
63
- files: IUploadFile[];
64
- normalizeNameFn?: (opts: {
65
- file: TUploadNaming;
66
- }) => string;
67
- normalizeLinkFn?: (opts: IObjectLocation) => string;
68
- /**
69
- * Folder nesting allowed.
70
- *
71
- * @default BaseStorageHelper.DEFAULT_MAX_FOLDER_DEPTH
72
- */
73
- maxFolderDepth?: number;
74
- /**
75
- * Folders the finished key may carry, a scope the `normalizeNameFn` adds included.
76
- *
77
- * @default `maxFolderDepth`
78
- */
79
- maxKeyDepth?: number;
80
- }): Promise<IUploadResult[]>;
81
- /** Correct anywhere; overridden by a backend whose transport is already a web stream. */
82
- getObjectStream(opts: IObjectLocation & {
83
- range?: {
84
- start: number;
85
- end?: number;
86
- };
87
- }): Promise<ReadableStream<Uint8Array>>;
63
+ upload(opts: IUploadOptions): Promise<IUploadResult[]>;
64
+ getObjectStream(_opts: TObjectStreamOptions): Promise<ReadableStream<Uint8Array>>;
88
65
  /**
89
66
  * Correct anywhere, and the wrong path to stay on: it buffers, so a backend whose transport takes
90
67
  * a stream overrides it. `BunS3Helper` does.
91
68
  */
92
- writeStream(opts: IObjectLocation & {
93
- source: ReadableStream<Uint8Array> | Blob | Response | Request;
94
- contentType?: string;
95
- maxFolderDepth?: number;
96
- }): Promise<void>;
69
+ writeStream(opts: IWriteStreamOptions): Promise<void>;
97
70
  /** Bounded fan-out on the shared limiter; unbounded exhausts sockets and gets rate limited. */
98
71
  protected mapWithConcurrency<Item, Result>(opts: {
99
72
  items: Item[];
@@ -108,26 +81,17 @@ export declare abstract class BaseStorageHelper extends BaseHelper implements IS
108
81
  error: unknown;
109
82
  operation: string;
110
83
  }): unknown;
111
- copyObject(_opts: {
112
- bucket: IBucketRef;
113
- source: IObjectRef;
114
- destination: IObjectRef;
115
- }): Promise<void>;
116
- presignPost(_opts: IObjectLocation & {
117
- maxBytes: number;
118
- contentType?: string;
119
- expiresIn?: IDuration;
120
- }): Promise<IPostPolicy>;
121
- presignPut(_opts: IObjectLocation & {
122
- expiresIn?: IDuration;
123
- tagging?: Record<string, string>;
124
- contentLength?: number;
125
- contentType?: string;
126
- }): Promise<string>;
127
- presignGet(_opts: IObjectLocation & {
128
- expiresIn?: IDuration;
129
- responseContentType?: string;
130
- }): Promise<string>;
84
+ /** For a backend with no ETag or versions to condition a read on: refusing is honest, ignoring would read unpinned. */
85
+ protected refuseReadCondition(opts: {
86
+ condition: IStorageReadCondition;
87
+ operation: string;
88
+ }): void;
89
+ /** The error of an operation this helper has no transport for: throwing beats returning undefined, which reads as a valid empty result. */
90
+ private unsupported;
91
+ copyObject(_opts: ICopyObjectOptions): Promise<void>;
92
+ presignPost(_opts: IPresignPostOptions): Promise<IPostPolicy>;
93
+ presignPut(_opts: IPresignPutOptions): Promise<string>;
94
+ presignGet(_opts: IPresignGetOptions): Promise<string>;
131
95
  getObjectTags(_opts: IObjectLocation): Promise<Record<string, string>>;
132
96
  replaceObjectTags(_opts: IObjectLocation & {
133
97
  tags: Record<string, string>;
@@ -146,7 +110,7 @@ export declare abstract class BaseStorageHelper extends BaseHelper implements IS
146
110
  bucket: IBucketRef;
147
111
  }): Promise<boolean>;
148
112
  abstract getObject(opts: IObjectLocation & {
149
- options?: any;
113
+ options?: unknown;
150
114
  }): Promise<Readable>;
151
115
  abstract getStat(opts: IObjectLocation): Promise<IFileStat>;
152
116
  abstract removeObject(opts: IObjectLocation): Promise<void>;