@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
@@ -0,0 +1,250 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.SocketIOClientHelper = void 0;
4
+ const http_1 = require("../../../../common/constants/http");
5
+ const base_1 = require("../../../base");
6
+ const error_1 = require("../../../error");
7
+ // The leaf files, never the `../common` barrel: it reaches the server types, which name node modules.
8
+ const constants_1 = require("../common/constants");
9
+ /**
10
+ * The socket.io client with nothing node in its graph, so a browser bundle can hold it: `socket.io-client`
11
+ * is handed in as `module` (`{ io }` from the app's own `import`) instead of being found on disk.
12
+ * `@venizia/ignis-helpers/socket-io` extends it and finds the module itself when none is handed in.
13
+ */
14
+ class SocketIOClientHelper extends base_1.BaseHelper {
15
+ constructor(opts) {
16
+ super({ scope: opts.identifier });
17
+ this.state = constants_1.SocketIOClientStates.UNAUTHORIZED;
18
+ // 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
19
+ this.wrappedHandlers = new Map();
20
+ this.identifier = opts.identifier;
21
+ this.host = opts.host;
22
+ this.options = opts.options;
23
+ this.clientModule = opts.module;
24
+ this.onConnected = opts.onConnected;
25
+ this.onDisconnected = opts.onDisconnected;
26
+ this.onError = opts.onError;
27
+ this.onAuthenticated = opts.onAuthenticated;
28
+ this.onUnauthenticated = opts.onUnauthenticated;
29
+ this.configure();
30
+ }
31
+ /** The `socket.io-client` module to connect with. Here only the one handed in; a subclass may find one. */
32
+ resolveModule() {
33
+ if (!this.clientModule) {
34
+ throw (0, error_1.getError)({
35
+ statusCode: http_1.HTTP.ResultCodes.RS_5.InternalServerError,
36
+ message: `[SocketIOClientHelper][${this.identifier}] option 'module' is required: pass { io } from 'socket.io-client'`,
37
+ });
38
+ }
39
+ return this.clientModule;
40
+ }
41
+ getState() {
42
+ return this.state;
43
+ }
44
+ configure() {
45
+ const logger = this.logger.for(this.configure.name);
46
+ if (this.client) {
47
+ logger.info('SocketIO Client already established | id: %s', this.identifier);
48
+ return;
49
+ }
50
+ const { io } = this.resolveModule();
51
+ this.client = io(this.host, this.options);
52
+ // Socket.IO client fires 'connect', NOT 'connection' (server-side only)
53
+ this.client.on('connect', () => {
54
+ logger.info('Connected | id: %s', this.identifier);
55
+ Promise.resolve(this.onConnected?.()).catch((error) => {
56
+ logger.error('onConnected callback error | error: %s', error);
57
+ });
58
+ });
59
+ this.client.on(constants_1.SocketIOConstants.EVENT_DISCONNECT, (reason) => {
60
+ logger.info('Disconnected | id: %s | reason: %s', this.identifier, reason);
61
+ this.state = constants_1.SocketIOClientStates.UNAUTHORIZED;
62
+ Promise.resolve(this.onDisconnected?.(reason)).catch((error) => {
63
+ logger.error('onDisconnected callback error | error: %s', error);
64
+ });
65
+ });
66
+ this.client.on('connect_error', (error) => {
67
+ logger.error('Connection error | id: %s | error: %s', this.identifier, error);
68
+ Promise.resolve(this.onError?.(error)).catch((err) => {
69
+ logger.error('onError callback error | error: %s', err);
70
+ });
71
+ });
72
+ this.client.on(constants_1.SocketIOConstants.EVENT_AUTHENTICATED, (data) => {
73
+ logger.info('Authenticated | id: %s | data: %j', this.identifier, data);
74
+ this.state = constants_1.SocketIOClientStates.AUTHENTICATED;
75
+ Promise.resolve(this.onAuthenticated?.()).catch((error) => {
76
+ logger.error('onAuthenticated callback error | error: %s', error);
77
+ });
78
+ });
79
+ this.client.on(constants_1.SocketIOConstants.EVENT_UNAUTHENTICATE, (data) => {
80
+ logger.warn('Unauthenticated | id: %s | data: %j', this.identifier, data);
81
+ this.state = constants_1.SocketIOClientStates.UNAUTHORIZED;
82
+ Promise.resolve(this.onUnauthenticated?.(data?.message ?? '')).catch((error) => {
83
+ logger.error('onUnauthenticated callback error | error: %s', error);
84
+ });
85
+ });
86
+ this.client.on(constants_1.SocketIOConstants.EVENT_PING, () => {
87
+ logger.debug('Ping received | id: %s', this.identifier);
88
+ });
89
+ }
90
+ getSocketClient() {
91
+ return this.client;
92
+ }
93
+ authenticate() {
94
+ const logger = this.logger.for(this.authenticate.name);
95
+ if (!this.client?.connected) {
96
+ logger.warn('Cannot authenticate | id: %s | reason: not connected', this.identifier);
97
+ return;
98
+ }
99
+ if (this.state !== constants_1.SocketIOClientStates.UNAUTHORIZED) {
100
+ logger.warn('Cannot authenticate | id: %s | currentState: %s', this.identifier, this.state);
101
+ return;
102
+ }
103
+ this.state = constants_1.SocketIOClientStates.AUTHENTICATING;
104
+ this.client.emit(constants_1.SocketIOConstants.EVENT_AUTHENTICATE);
105
+ logger.info('Authentication requested | id: %s', this.identifier);
106
+ }
107
+ subscribe(opts) {
108
+ const logger = this.logger.for(this.subscribe.name);
109
+ const { event, handler, ignoreDuplicate = true } = opts;
110
+ if (!handler) {
111
+ logger.warn('No handler provided | event: %s', event);
112
+ return;
113
+ }
114
+ if (ignoreDuplicate && this.client.hasListeners(event)) {
115
+ logger.info('Handler already exists | event: %s', event);
116
+ return;
117
+ }
118
+ // Wrap handler in try-catch for error safety (catches both sync throws and async rejections)
119
+ const wrappedHandler = (data) => {
120
+ try {
121
+ Promise.resolve(handler(data)).catch((error) => {
122
+ logger.error('Handler error | event: %s | error: %s', event, error);
123
+ });
124
+ }
125
+ catch (error) {
126
+ logger.error('Handler error | event: %s | error: %s', event, error);
127
+ }
128
+ };
129
+ if (!this.wrappedHandlers.has(event)) {
130
+ this.wrappedHandlers.set(event, new Map());
131
+ }
132
+ this.wrappedHandlers.get(event).set(handler, wrappedHandler);
133
+ this.client.on(event, wrappedHandler);
134
+ logger.info('Subscribed | event: %s', event);
135
+ }
136
+ subscribeMany(opts) {
137
+ const { events, ignoreDuplicate } = opts;
138
+ for (const event in events) {
139
+ this.subscribe({
140
+ event,
141
+ handler: events[event],
142
+ ignoreDuplicate,
143
+ });
144
+ }
145
+ }
146
+ unsubscribe(opts) {
147
+ const logger = this.logger.for(this.unsubscribe.name);
148
+ const { event, handler } = opts;
149
+ if (!this.client?.hasListeners(event)) {
150
+ logger.info('No listeners to remove | event: %s', event);
151
+ return;
152
+ }
153
+ if (handler) {
154
+ const wrappedHandler = this.wrappedHandlers.get(event)?.get(handler);
155
+ if (!wrappedHandler) {
156
+ logger.info('Handler was not subscribed through this helper | event: %s', event);
157
+ return;
158
+ }
159
+ this.client.off(event, wrappedHandler);
160
+ this.wrappedHandlers.get(event)?.delete(handler);
161
+ if (!this.wrappedHandlers.get(event)?.size) {
162
+ this.wrappedHandlers.delete(event);
163
+ }
164
+ logger.info('Removed specific handler | event: %s', event);
165
+ return;
166
+ }
167
+ this.client.off(event);
168
+ this.wrappedHandlers.delete(event);
169
+ logger.info('Removed all handlers | event: %s', event);
170
+ }
171
+ unsubscribeMany(opts) {
172
+ for (const event of opts.events) {
173
+ this.unsubscribe({ event });
174
+ }
175
+ }
176
+ connect() {
177
+ const logger = this.logger.for(this.connect.name);
178
+ if (!this.client) {
179
+ logger.info('Invalid client to connect | id: %s', this.identifier);
180
+ return;
181
+ }
182
+ this.client.connect();
183
+ }
184
+ disconnect() {
185
+ const logger = this.logger.for(this.disconnect.name);
186
+ if (!this.client) {
187
+ logger.info('Invalid client to disconnect | id: %s', this.identifier);
188
+ return;
189
+ }
190
+ this.client.disconnect();
191
+ }
192
+ emit(opts) {
193
+ const logger = this.logger.for(this.emit.name);
194
+ const { topic, data, doLog = false, callback } = opts;
195
+ if (!this.client?.connected) {
196
+ throw (0, error_1.getError)({
197
+ statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
198
+ message: 'Invalid socket client state to emit',
199
+ });
200
+ }
201
+ if (!topic) {
202
+ throw (0, error_1.getError)({
203
+ statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
204
+ message: 'Topic is required to emit',
205
+ });
206
+ }
207
+ this.client.emit(topic, data);
208
+ if (callback) {
209
+ setImmediate(callback);
210
+ }
211
+ if (doLog) {
212
+ logger.info('Emitted | topic: %s | data: %j', topic, data);
213
+ }
214
+ }
215
+ joinRooms(opts) {
216
+ const logger = this.logger.for(this.joinRooms.name);
217
+ const { rooms } = opts;
218
+ if (!this.client?.connected) {
219
+ logger.warn('Cannot join rooms | id: %s | reason: not connected', this.identifier);
220
+ return;
221
+ }
222
+ this.client.emit(constants_1.SocketIOConstants.EVENT_JOIN, { rooms });
223
+ logger.info('Join rooms requested | id: %s | rooms: %j', this.identifier, rooms);
224
+ }
225
+ leaveRooms(opts) {
226
+ const logger = this.logger.for(this.leaveRooms.name);
227
+ const { rooms } = opts;
228
+ if (!this.client?.connected) {
229
+ logger.warn('Cannot leave rooms | id: %s | reason: not connected', this.identifier);
230
+ return;
231
+ }
232
+ this.client.emit(constants_1.SocketIOConstants.EVENT_LEAVE, { rooms });
233
+ logger.info('Leave rooms requested | id: %s | rooms: %j', this.identifier, rooms);
234
+ }
235
+ shutdown() {
236
+ const logger = this.logger.for(this.shutdown.name);
237
+ logger.info('Shutting down SocketIO client | id: %s', this.identifier);
238
+ if (this.client) {
239
+ this.client.removeAllListeners();
240
+ if (this.client.connected) {
241
+ this.client.disconnect();
242
+ }
243
+ }
244
+ this.wrappedHandlers.clear();
245
+ this.state = constants_1.SocketIOClientStates.UNAUTHORIZED;
246
+ logger.info('SocketIO client shutdown complete | id: %s', this.identifier);
247
+ }
248
+ }
249
+ exports.SocketIOClientHelper = SocketIOClientHelper;
250
+ //# sourceMappingURL=browser-helper.js.map
@@ -0,0 +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 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 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,53 +1,10 @@
1
- import { BaseHelper } from '../../../base';
2
- import type { Socket } from 'socket.io-client';
3
- import { type ISocketIOClientOptions, type TSocketIOEventHandler, type TSocketIOClientState } from '../common';
4
- export declare class SocketIOClientHelper extends BaseHelper {
5
- private host;
6
- private options;
7
- private client;
8
- private state;
9
- private wrappedHandlers;
10
- private onConnected?;
11
- private onDisconnected?;
12
- private onError?;
13
- private onAuthenticated?;
14
- private onUnauthenticated?;
15
- private readonly clientModule?;
16
- constructor(opts: ISocketIOClientOptions);
17
- getState(): TSocketIOClientState;
18
- configure(): void;
19
- getSocketClient(): Socket;
20
- authenticate(): void;
21
- subscribe<T = unknown>(opts: {
22
- event: string;
23
- handler: TSocketIOEventHandler<T>;
24
- ignoreDuplicate?: boolean;
25
- }): void;
26
- subscribeMany(opts: {
27
- events: Record<string, TSocketIOEventHandler>;
28
- ignoreDuplicate?: boolean;
29
- }): void;
30
- unsubscribe(opts: {
31
- event: string;
32
- handler?: TSocketIOEventHandler;
33
- }): void;
34
- unsubscribeMany(opts: {
35
- events: string[];
36
- }): void;
37
- connect(): void;
38
- disconnect(): void;
39
- emit<T = unknown>(opts: {
40
- topic: string;
41
- data: T;
42
- doLog?: boolean;
43
- callback?: () => void;
44
- }): void;
45
- joinRooms(opts: {
46
- rooms: string[];
47
- }): void;
48
- leaveRooms(opts: {
49
- rooms: string[];
50
- }): void;
51
- shutdown(): void;
1
+ import { SocketIOClientHelper as BrowserSocketIOClientHelper } from './browser-helper';
2
+ /**
3
+ * The socket.io client for a server or a CLI: the browser-pure helper, plus a `socket.io-client`
4
+ * found in the app's `node_modules` when no `module` is handed in. A browser bundle imports
5
+ * `@venizia/ignis-helpers/socket-io/client` instead, which has no node dependency.
6
+ */
7
+ export declare class SocketIOClientHelper extends BrowserSocketIOClientHelper {
8
+ protected resolveModule(): typeof import('socket.io-client');
52
9
  }
53
10
  //# sourceMappingURL=helper.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/client/helper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAEL,KAAK,sBAAsB,EAG3B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EAC1B,MAAM,WAAW,CAAC;AAEnB,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAA2D;IAGxE,OAAO,CAAC,eAAe,CACX;IAEZ,OAAO,CAAC,WAAW,CAAC,CAA6B;IACjD,OAAO,CAAC,cAAc,CAAC,CAA2C;IAClE,OAAO,CAAC,OAAO,CAAC,CAAyC;IACzD,OAAO,CAAC,eAAe,CAAC,CAA6B;IACrD,OAAO,CAAC,iBAAiB,CAAC,CAA4C;IAEtE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAoC;gBAEtD,IAAI,EAAE,sBAAsB;IAiBxC,QAAQ,IAAI,oBAAoB;IAIhC,SAAS;IAgET,eAAe,IAAI,MAAM;IAIzB,YAAY;IAkBZ,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAC3B,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAClC,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;IAkCD,aAAa,CAAC,IAAI,EAAE;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;QAC9C,eAAe,CAAC,EAAE,OAAO,CAAC;KAC3B;IAYD,WAAW,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,qBAAqB,CAAA;KAAE;IAgCpE,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAM1C,OAAO;IAWP,UAAU;IAWV,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE;IA6B1F,SAAS,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE;IAanC,UAAU,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE;IAapC,QAAQ;CAgBT"}
1
+ {"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/client/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,IAAI,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAEvF;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,2BAA2B;cAGhD,aAAa,IAAI,cAAc,kBAAkB,CAAC;CAMtE"}
@@ -1,237 +1,19 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.SocketIOClientHelper = void 0;
4
- const http_1 = require("../../../../common/constants/http");
5
- const base_1 = require("../../../base");
6
- const error_1 = require("../../../error");
7
4
  const module_utility_1 = require("../../../../utilities/module.utility");
8
- const common_1 = require("../common");
9
- class SocketIOClientHelper extends base_1.BaseHelper {
10
- constructor(opts) {
11
- super({ scope: opts.identifier });
12
- this.state = common_1.SocketIOClientStates.UNAUTHORIZED;
13
- // 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
14
- this.wrappedHandlers = new Map();
15
- this.identifier = opts.identifier;
16
- this.host = opts.host;
17
- this.options = opts.options;
18
- this.clientModule = opts.module;
19
- this.onConnected = opts.onConnected;
20
- this.onDisconnected = opts.onDisconnected;
21
- this.onError = opts.onError;
22
- this.onAuthenticated = opts.onAuthenticated;
23
- this.onUnauthenticated = opts.onUnauthenticated;
24
- this.configure();
25
- }
26
- getState() {
27
- return this.state;
28
- }
29
- configure() {
30
- const logger = this.logger.for(this.configure.name);
31
- if (this.client) {
32
- logger.info('SocketIO Client already established | id: %s', this.identifier);
33
- return;
34
- }
35
- // `socket.io-client` is an optional peer: loaded on connect, so a server that only imports the
36
- // server helper from this entry never needs it installed.
37
- const { io } = this.clientModule ??
38
- module_utility_1.ModuleUtility.loadSync({ module: 'socket.io-client' });
39
- this.client = io(this.host, this.options);
40
- // Socket.IO client fires 'connect', NOT 'connection' (server-side only)
41
- this.client.on('connect', () => {
42
- logger.info('Connected | id: %s', this.identifier);
43
- Promise.resolve(this.onConnected?.()).catch(error => {
44
- logger.error('onConnected callback error | error: %s', error);
45
- });
46
- });
47
- this.client.on(common_1.SocketIOConstants.EVENT_DISCONNECT, (reason) => {
48
- logger.info('Disconnected | id: %s | reason: %s', this.identifier, reason);
49
- this.state = common_1.SocketIOClientStates.UNAUTHORIZED;
50
- Promise.resolve(this.onDisconnected?.(reason)).catch(error => {
51
- logger.error('onDisconnected callback error | error: %s', error);
52
- });
53
- });
54
- this.client.on('connect_error', (error) => {
55
- logger.error('Connection error | id: %s | error: %s', this.identifier, error);
56
- Promise.resolve(this.onError?.(error)).catch(err => {
57
- logger.error('onError callback error | error: %s', err);
58
- });
59
- });
60
- this.client.on(common_1.SocketIOConstants.EVENT_AUTHENTICATED, (data) => {
61
- logger.info('Authenticated | id: %s | data: %j', this.identifier, data);
62
- this.state = common_1.SocketIOClientStates.AUTHENTICATED;
63
- Promise.resolve(this.onAuthenticated?.()).catch(error => {
64
- logger.error('onAuthenticated callback error | error: %s', error);
65
- });
66
- });
67
- this.client.on(common_1.SocketIOConstants.EVENT_UNAUTHENTICATE, (data) => {
68
- logger.warn('Unauthenticated | id: %s | data: %j', this.identifier, data);
69
- this.state = common_1.SocketIOClientStates.UNAUTHORIZED;
70
- Promise.resolve(this.onUnauthenticated?.(data?.message ?? '')).catch(error => {
71
- logger.error('onUnauthenticated callback error | error: %s', error);
72
- });
73
- });
74
- this.client.on(common_1.SocketIOConstants.EVENT_PING, () => {
75
- logger.debug('Ping received | id: %s', this.identifier);
76
- });
77
- }
78
- getSocketClient() {
79
- return this.client;
80
- }
81
- authenticate() {
82
- const logger = this.logger.for(this.authenticate.name);
83
- if (!this.client?.connected) {
84
- logger.warn('Cannot authenticate | id: %s | reason: not connected', this.identifier);
85
- return;
86
- }
87
- if (this.state !== common_1.SocketIOClientStates.UNAUTHORIZED) {
88
- logger.warn('Cannot authenticate | id: %s | currentState: %s', this.identifier, this.state);
89
- return;
90
- }
91
- this.state = common_1.SocketIOClientStates.AUTHENTICATING;
92
- this.client.emit(common_1.SocketIOConstants.EVENT_AUTHENTICATE);
93
- logger.info('Authentication requested | id: %s', this.identifier);
94
- }
95
- subscribe(opts) {
96
- const logger = this.logger.for(this.subscribe.name);
97
- const { event, handler, ignoreDuplicate = true } = opts;
98
- if (!handler) {
99
- logger.warn('No handler provided | event: %s', event);
100
- return;
101
- }
102
- if (ignoreDuplicate && this.client.hasListeners(event)) {
103
- logger.info('Handler already exists | event: %s', event);
104
- return;
105
- }
106
- // Wrap handler in try-catch for error safety (catches both sync throws and async rejections)
107
- const wrappedHandler = (data) => {
108
- try {
109
- Promise.resolve(handler(data)).catch(error => {
110
- logger.error('Handler error | event: %s | error: %s', event, error);
111
- });
112
- }
113
- catch (error) {
114
- logger.error('Handler error | event: %s | error: %s', event, error);
115
- }
116
- };
117
- if (!this.wrappedHandlers.has(event)) {
118
- this.wrappedHandlers.set(event, new Map());
119
- }
120
- this.wrappedHandlers.get(event).set(handler, wrappedHandler);
121
- this.client.on(event, wrappedHandler);
122
- logger.info('Subscribed | event: %s', event);
123
- }
124
- subscribeMany(opts) {
125
- const { events, ignoreDuplicate } = opts;
126
- for (const event in events) {
127
- this.subscribe({
128
- event,
129
- handler: events[event],
130
- ignoreDuplicate,
131
- });
132
- }
133
- }
134
- unsubscribe(opts) {
135
- const logger = this.logger.for(this.unsubscribe.name);
136
- const { event, handler } = opts;
137
- if (!this.client?.hasListeners(event)) {
138
- logger.info('No listeners to remove | event: %s', event);
139
- return;
140
- }
141
- if (handler) {
142
- const wrappedHandler = this.wrappedHandlers.get(event)?.get(handler);
143
- if (!wrappedHandler) {
144
- logger.info('Handler was not subscribed through this helper | event: %s', event);
145
- return;
146
- }
147
- this.client.off(event, wrappedHandler);
148
- this.wrappedHandlers.get(event)?.delete(handler);
149
- if (!this.wrappedHandlers.get(event)?.size) {
150
- this.wrappedHandlers.delete(event);
151
- }
152
- logger.info('Removed specific handler | event: %s', event);
153
- return;
154
- }
155
- this.client.off(event);
156
- this.wrappedHandlers.delete(event);
157
- logger.info('Removed all handlers | event: %s', event);
158
- }
159
- unsubscribeMany(opts) {
160
- for (const event of opts.events) {
161
- this.unsubscribe({ event });
162
- }
163
- }
164
- connect() {
165
- const logger = this.logger.for(this.connect.name);
166
- if (!this.client) {
167
- logger.info('Invalid client to connect | id: %s', this.identifier);
168
- return;
169
- }
170
- this.client.connect();
171
- }
172
- disconnect() {
173
- const logger = this.logger.for(this.disconnect.name);
174
- if (!this.client) {
175
- logger.info('Invalid client to disconnect | id: %s', this.identifier);
176
- return;
177
- }
178
- this.client.disconnect();
179
- }
180
- emit(opts) {
181
- const logger = this.logger.for(this.emit.name);
182
- const { topic, data, doLog = false, callback } = opts;
183
- if (!this.client?.connected) {
184
- throw (0, error_1.getError)({
185
- statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
186
- message: 'Invalid socket client state to emit',
187
- });
188
- }
189
- if (!topic) {
190
- throw (0, error_1.getError)({
191
- statusCode: http_1.HTTP.ResultCodes.RS_4.BadRequest,
192
- message: 'Topic is required to emit',
193
- });
194
- }
195
- this.client.emit(topic, data);
196
- if (callback) {
197
- setImmediate(callback);
198
- }
199
- if (doLog) {
200
- logger.info('Emitted | topic: %s | data: %j', topic, data);
201
- }
202
- }
203
- joinRooms(opts) {
204
- const logger = this.logger.for(this.joinRooms.name);
205
- const { rooms } = opts;
206
- if (!this.client?.connected) {
207
- logger.warn('Cannot join rooms | id: %s | reason: not connected', this.identifier);
208
- return;
209
- }
210
- this.client.emit(common_1.SocketIOConstants.EVENT_JOIN, { rooms });
211
- logger.info('Join rooms requested | id: %s | rooms: %j', this.identifier, rooms);
212
- }
213
- leaveRooms(opts) {
214
- const logger = this.logger.for(this.leaveRooms.name);
215
- const { rooms } = opts;
216
- if (!this.client?.connected) {
217
- logger.warn('Cannot leave rooms | id: %s | reason: not connected', this.identifier);
218
- return;
219
- }
220
- this.client.emit(common_1.SocketIOConstants.EVENT_LEAVE, { rooms });
221
- logger.info('Leave rooms requested | id: %s | rooms: %j', this.identifier, rooms);
222
- }
223
- shutdown() {
224
- const logger = this.logger.for(this.shutdown.name);
225
- logger.info('Shutting down SocketIO client | id: %s', this.identifier);
226
- if (this.client) {
227
- this.client.removeAllListeners();
228
- if (this.client.connected) {
229
- this.client.disconnect();
230
- }
231
- }
232
- this.wrappedHandlers.clear();
233
- this.state = common_1.SocketIOClientStates.UNAUTHORIZED;
234
- logger.info('SocketIO client shutdown complete | id: %s', this.identifier);
5
+ const browser_helper_1 = require("./browser-helper");
6
+ /**
7
+ * The socket.io client for a server or a CLI: the browser-pure helper, plus a `socket.io-client`
8
+ * found in the app's `node_modules` when no `module` is handed in. A browser bundle imports
9
+ * `@venizia/ignis-helpers/socket-io/client` instead, which has no node dependency.
10
+ */
11
+ class SocketIOClientHelper extends browser_helper_1.SocketIOClientHelper {
12
+ // `socket.io-client` is an optional peer: loaded on connect, so a server that only imports the
13
+ // server helper from this entry never needs it installed.
14
+ resolveModule() {
15
+ return (this.clientModule ??
16
+ module_utility_1.ModuleUtility.loadSync({ module: 'socket.io-client' }));
235
17
  }
236
18
  }
237
19
  exports.SocketIOClientHelper = SocketIOClientHelper;