@venizia/ignis-helpers 0.4.6 → 0.4.7-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 (300) hide show
  1. package/LICENSE.md +1 -3
  2. package/README.md +4 -5
  3. package/dist/esm/common/redact.d.ts +25 -17
  4. package/dist/esm/common/redact.d.ts.map +1 -1
  5. package/dist/esm/common/redact.js +50 -46
  6. package/dist/esm/common/redact.js.map +1 -1
  7. package/dist/esm/common/resolvers.d.ts +7 -5
  8. package/dist/esm/common/resolvers.d.ts.map +1 -1
  9. package/dist/esm/common/resolvers.js +11 -9
  10. package/dist/esm/common/resolvers.js.map +1 -1
  11. package/dist/esm/core.d.ts +6 -3
  12. package/dist/esm/core.d.ts.map +1 -1
  13. package/dist/esm/core.js +6 -3
  14. package/dist/esm/core.js.map +1 -1
  15. package/dist/esm/modules/base.js +4 -4
  16. package/dist/esm/modules/base.js.map +1 -1
  17. package/dist/esm/modules/cron/helper.js +4 -4
  18. package/dist/esm/modules/cron/helper.js.map +1 -1
  19. package/dist/esm/modules/crypto/algorithms/aes-legacy.algorithm.js +3 -3
  20. package/dist/esm/modules/crypto/algorithms/aes-legacy.algorithm.js.map +1 -1
  21. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js +5 -5
  22. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  23. package/dist/esm/modules/crypto/algorithms/base.algorithm.js +3 -3
  24. package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
  25. package/dist/esm/modules/env/app-env.d.ts.map +1 -1
  26. package/dist/esm/modules/env/app-env.js +2 -2
  27. package/dist/esm/modules/env/app-env.js.map +1 -1
  28. package/dist/esm/modules/logger/common/constants.d.ts +23 -21
  29. package/dist/esm/modules/logger/common/constants.d.ts.map +1 -1
  30. package/dist/esm/modules/logger/common/constants.js +45 -42
  31. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  32. package/dist/esm/modules/logger/factory.d.ts +5 -3
  33. package/dist/esm/modules/logger/factory.d.ts.map +1 -1
  34. package/dist/esm/modules/logger/factory.js +5 -3
  35. package/dist/esm/modules/logger/factory.js.map +1 -1
  36. package/dist/esm/modules/logger/formatting/deep-splat.d.ts +10 -6
  37. package/dist/esm/modules/logger/formatting/deep-splat.d.ts.map +1 -1
  38. package/dist/esm/modules/logger/formatting/deep-splat.js +73 -62
  39. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  40. package/dist/esm/modules/logger/formatting/error-prettier.d.ts.map +1 -1
  41. package/dist/esm/modules/logger/formatting/error-prettier.js +8 -6
  42. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  43. package/dist/esm/modules/logger/hf/logger.d.ts.map +1 -1
  44. package/dist/esm/modules/logger/hf/logger.js +2 -2
  45. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  46. package/dist/esm/modules/logger/pino/backing.d.ts +0 -9
  47. package/dist/esm/modules/logger/pino/backing.d.ts.map +1 -1
  48. package/dist/esm/modules/logger/pino/backing.js +3 -8
  49. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  50. package/dist/esm/modules/logger/pino/destination.d.ts +6 -9
  51. package/dist/esm/modules/logger/pino/destination.d.ts.map +1 -1
  52. package/dist/esm/modules/logger/pino/destination.js +12 -13
  53. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  54. package/dist/esm/modules/logger/pino/logger.js +2 -2
  55. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  56. package/dist/esm/modules/logger/resolver.js +2 -2
  57. package/dist/esm/modules/logger/resolver.js.map +1 -1
  58. package/dist/esm/modules/logger/slot.d.ts +39 -18
  59. package/dist/esm/modules/logger/slot.d.ts.map +1 -1
  60. package/dist/esm/modules/logger/slot.js +117 -110
  61. package/dist/esm/modules/logger/slot.js.map +1 -1
  62. package/dist/esm/modules/logger/winston/common/constants.d.ts.map +1 -1
  63. package/dist/esm/modules/logger/winston/common/constants.js +7 -6
  64. package/dist/esm/modules/logger/winston/common/constants.js.map +1 -1
  65. package/dist/esm/modules/logger/winston/define.d.ts +0 -7
  66. package/dist/esm/modules/logger/winston/define.d.ts.map +1 -1
  67. package/dist/esm/modules/logger/winston/define.js +0 -5
  68. package/dist/esm/modules/logger/winston/define.js.map +1 -1
  69. package/dist/esm/modules/logger/winston/formats.d.ts +2 -0
  70. package/dist/esm/modules/logger/winston/formats.d.ts.map +1 -1
  71. package/dist/esm/modules/logger/winston/formats.js +17 -4
  72. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  73. package/dist/esm/modules/logger/winston/index.d.ts +3 -2
  74. package/dist/esm/modules/logger/winston/index.d.ts.map +1 -1
  75. package/dist/esm/modules/logger/winston/index.js +3 -2
  76. package/dist/esm/modules/logger/winston/index.js.map +1 -1
  77. package/dist/esm/modules/logger/winston/logger-factory.js +4 -4
  78. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  79. package/dist/esm/modules/network/http-request/base-network-request.helper.js +2 -2
  80. package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
  81. package/dist/esm/modules/network/http-request/common/index.d.ts +0 -1
  82. package/dist/esm/modules/network/http-request/common/index.d.ts.map +1 -1
  83. package/dist/esm/modules/network/http-request/common/index.js +0 -1
  84. package/dist/esm/modules/network/http-request/common/index.js.map +1 -1
  85. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts.map +1 -1
  86. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +4 -2
  87. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  88. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +1 -1
  89. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +6 -4
  90. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  91. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +4 -4
  92. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  93. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +4 -4
  94. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  95. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +2 -2
  96. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  97. package/dist/esm/modules/network/utilities/query-string.d.ts +22 -20
  98. package/dist/esm/modules/network/utilities/query-string.d.ts.map +1 -1
  99. package/dist/esm/modules/network/utilities/query-string.js +48 -46
  100. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  101. package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts +0 -10
  102. package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts.map +1 -1
  103. package/dist/esm/modules/network/utilities/url-safety/common/errors.js +0 -11
  104. package/dist/esm/modules/network/utilities/url-safety/common/errors.js.map +1 -1
  105. package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts.map +1 -1
  106. package/dist/esm/modules/network/utilities/url-safety/ingest.js +2 -1
  107. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  108. package/dist/esm/modules/network/utilities/url-safety/policy.d.ts +10 -0
  109. package/dist/esm/modules/network/utilities/url-safety/policy.d.ts.map +1 -1
  110. package/dist/esm/modules/network/utilities/url-safety/policy.js +11 -0
  111. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  112. package/dist/esm/modules/pool/abstract.d.ts.map +1 -1
  113. package/dist/esm/modules/pool/abstract.js +4 -2
  114. package/dist/esm/modules/pool/abstract.js.map +1 -1
  115. package/dist/esm/modules/queue/bullmq/helper.d.ts.map +1 -1
  116. package/dist/esm/modules/queue/bullmq/helper.js +6 -6
  117. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  118. package/dist/esm/modules/queue/common/hook.d.ts +14 -12
  119. package/dist/esm/modules/queue/common/hook.d.ts.map +1 -1
  120. package/dist/esm/modules/queue/common/hook.js +21 -19
  121. package/dist/esm/modules/queue/common/hook.js.map +1 -1
  122. package/dist/esm/modules/queue/common/index.d.ts +0 -1
  123. package/dist/esm/modules/queue/common/index.d.ts.map +1 -1
  124. package/dist/esm/modules/queue/common/index.js +0 -1
  125. package/dist/esm/modules/queue/common/index.js.map +1 -1
  126. package/dist/esm/modules/queue/internal/sequential/helper.js +8 -8
  127. package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
  128. package/dist/esm/modules/queue/kafka/base.js +3 -3
  129. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  130. package/dist/esm/modules/queue/kafka/bundler/index.d.ts +0 -2
  131. package/dist/esm/modules/queue/kafka/bundler/index.d.ts.map +1 -1
  132. package/dist/esm/modules/queue/kafka/bundler/index.js +0 -2
  133. package/dist/esm/modules/queue/kafka/bundler/index.js.map +1 -1
  134. package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts +8 -2
  135. package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts.map +1 -1
  136. package/dist/esm/modules/queue/kafka/bundler/plugins.js +64 -7
  137. package/dist/esm/modules/queue/kafka/bundler/plugins.js.map +1 -1
  138. package/dist/esm/modules/queue/kafka/consumer.d.ts.map +1 -1
  139. package/dist/esm/modules/queue/kafka/consumer.js +26 -24
  140. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  141. package/dist/esm/modules/queue/mqtt/helper.js +10 -10
  142. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  143. package/dist/esm/modules/redis/base/abstract.helper.js +8 -8
  144. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  145. package/dist/esm/modules/redis/cluster/cluster.helper.js +2 -2
  146. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  147. package/dist/esm/modules/redis/factory.d.ts +13 -9
  148. package/dist/esm/modules/redis/factory.d.ts.map +1 -1
  149. package/dist/esm/modules/redis/factory.js +15 -13
  150. package/dist/esm/modules/redis/factory.js.map +1 -1
  151. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +2 -2
  152. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  153. package/dist/esm/modules/redis/single/single.helper.js +2 -2
  154. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  155. package/dist/esm/modules/redis/utility.d.ts +13 -11
  156. package/dist/esm/modules/redis/utility.d.ts.map +1 -1
  157. package/dist/esm/modules/redis/utility.js +46 -44
  158. package/dist/esm/modules/redis/utility.js.map +1 -1
  159. package/dist/esm/modules/retry/helper.d.ts.map +1 -1
  160. package/dist/esm/modules/retry/helper.js +6 -4
  161. package/dist/esm/modules/retry/helper.js.map +1 -1
  162. package/dist/esm/modules/secrets/factory.d.ts +5 -3
  163. package/dist/esm/modules/secrets/factory.d.ts.map +1 -1
  164. package/dist/esm/modules/secrets/factory.js +36 -34
  165. package/dist/esm/modules/secrets/factory.js.map +1 -1
  166. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts.map +1 -1
  167. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +4 -2
  168. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  169. package/dist/esm/modules/socket/socket-io/server/helper.d.ts.map +1 -1
  170. package/dist/esm/modules/socket/socket-io/server/helper.js +11 -11
  171. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  172. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts.map +1 -1
  173. package/dist/esm/modules/socket/websocket/emitter/helper.js +3 -3
  174. package/dist/esm/modules/socket/websocket/emitter/helper.js.map +1 -1
  175. package/dist/esm/modules/socket/websocket/server/delivery.d.ts.map +1 -1
  176. package/dist/esm/modules/socket/websocket/server/delivery.js +5 -6
  177. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  178. package/dist/esm/modules/socket/websocket/server/helper.d.ts.map +1 -1
  179. package/dist/esm/modules/socket/websocket/server/helper.js +7 -7
  180. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  181. package/dist/esm/modules/storage/base.d.ts.map +1 -1
  182. package/dist/esm/modules/storage/base.js +9 -8
  183. package/dist/esm/modules/storage/base.js.map +1 -1
  184. package/dist/esm/modules/storage/bun-s3/helper.d.ts.map +1 -1
  185. package/dist/esm/modules/storage/bun-s3/helper.js +25 -18
  186. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  187. package/dist/esm/modules/storage/bun-s3/utility.d.ts +95 -77
  188. package/dist/esm/modules/storage/bun-s3/utility.d.ts.map +1 -1
  189. package/dist/esm/modules/storage/bun-s3/utility.js +261 -244
  190. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  191. package/dist/esm/modules/storage/common/errors.d.ts +0 -4
  192. package/dist/esm/modules/storage/common/errors.d.ts.map +1 -1
  193. package/dist/esm/modules/storage/common/errors.js +0 -10
  194. package/dist/esm/modules/storage/common/errors.js.map +1 -1
  195. package/dist/esm/modules/storage/common/utility.d.ts +11 -5
  196. package/dist/esm/modules/storage/common/utility.d.ts.map +1 -1
  197. package/dist/esm/modules/storage/common/utility.js +30 -17
  198. package/dist/esm/modules/storage/common/utility.js.map +1 -1
  199. package/dist/esm/modules/storage/disk/helper.d.ts.map +1 -1
  200. package/dist/esm/modules/storage/disk/helper.js +18 -9
  201. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  202. package/dist/esm/modules/tree/builder.d.ts.map +1 -1
  203. package/dist/esm/modules/tree/builder.js +2 -1
  204. package/dist/esm/modules/tree/builder.js.map +1 -1
  205. package/dist/esm/modules/uid/opaque.d.ts.map +1 -1
  206. package/dist/esm/modules/uid/opaque.js +4 -2
  207. package/dist/esm/modules/uid/opaque.js.map +1 -1
  208. package/dist/esm/modules/uid/uuid/helper.d.ts +1 -1
  209. package/dist/esm/modules/uid/uuid/helper.d.ts.map +1 -1
  210. package/dist/esm/modules/uid/uuid/helper.js +7 -7
  211. package/dist/esm/modules/uid/uuid/helper.js.map +1 -1
  212. package/dist/esm/modules/uid/uuid/v4.d.ts +11 -8
  213. package/dist/esm/modules/uid/uuid/v4.d.ts.map +1 -1
  214. package/dist/esm/modules/uid/uuid/v4.js +51 -46
  215. package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
  216. package/dist/esm/modules/uid/uuid/v5.d.ts +17 -14
  217. package/dist/esm/modules/uid/uuid/v5.d.ts.map +1 -1
  218. package/dist/esm/modules/uid/uuid/v5.js +83 -78
  219. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  220. package/dist/esm/modules/uid/uuid/v7.d.ts +15 -10
  221. package/dist/esm/modules/uid/uuid/v7.d.ts.map +1 -1
  222. package/dist/esm/modules/uid/uuid/v7.js +88 -79
  223. package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
  224. package/dist/esm/modules/worker-thread/bus/base.js +2 -2
  225. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  226. package/dist/esm/modules/worker-thread/worker/base.d.ts.map +1 -1
  227. package/dist/esm/modules/worker-thread/worker/base.js +4 -3
  228. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  229. package/dist/esm/utilities/error.utility.d.ts +7 -0
  230. package/dist/esm/utilities/error.utility.d.ts.map +1 -0
  231. package/dist/esm/utilities/error.utility.js +9 -0
  232. package/dist/esm/utilities/error.utility.js.map +1 -0
  233. package/dist/esm/utilities/form-body.utility.d.ts +12 -10
  234. package/dist/esm/utilities/form-body.utility.d.ts.map +1 -1
  235. package/dist/esm/utilities/form-body.utility.js +19 -16
  236. package/dist/esm/utilities/form-body.utility.js.map +1 -1
  237. package/dist/esm/utilities/hr-time.utility.d.ts +7 -5
  238. package/dist/esm/utilities/hr-time.utility.d.ts.map +1 -1
  239. package/dist/esm/utilities/hr-time.utility.js +11 -9
  240. package/dist/esm/utilities/hr-time.utility.js.map +1 -1
  241. package/dist/esm/utilities/index.d.ts +2 -2
  242. package/dist/esm/utilities/index.d.ts.map +1 -1
  243. package/dist/esm/utilities/index.js +2 -2
  244. package/dist/esm/utilities/index.js.map +1 -1
  245. package/dist/esm/utilities/module.utility.d.ts.map +1 -1
  246. package/dist/esm/utilities/module.utility.js +4 -2
  247. package/dist/esm/utilities/module.utility.js.map +1 -1
  248. package/dist/esm/utilities/parse.utility.d.ts +89 -43
  249. package/dist/esm/utilities/parse.utility.d.ts.map +1 -1
  250. package/dist/esm/utilities/parse.utility.js +173 -141
  251. package/dist/esm/utilities/parse.utility.js.map +1 -1
  252. package/dist/esm/utilities/performance.utility.d.ts +15 -13
  253. package/dist/esm/utilities/performance.utility.d.ts.map +1 -1
  254. package/dist/esm/utilities/performance.utility.js +34 -29
  255. package/dist/esm/utilities/performance.utility.js.map +1 -1
  256. package/dist/esm/utilities/promise.utility.d.ts +20 -18
  257. package/dist/esm/utilities/promise.utility.d.ts.map +1 -1
  258. package/dist/esm/utilities/promise.utility.js +41 -51
  259. package/dist/esm/utilities/promise.utility.js.map +1 -1
  260. package/dist/esm/utilities/request.utility.d.ts +35 -29
  261. package/dist/esm/utilities/request.utility.d.ts.map +1 -1
  262. package/dist/esm/utilities/request.utility.js +117 -115
  263. package/dist/esm/utilities/request.utility.js.map +1 -1
  264. package/package.json +4 -15
  265. package/dist/esm/modules/logger/winston/formatters/deep-splat.d.ts +0 -4
  266. package/dist/esm/modules/logger/winston/formatters/deep-splat.d.ts.map +0 -1
  267. package/dist/esm/modules/logger/winston/formatters/deep-splat.js +0 -14
  268. package/dist/esm/modules/logger/winston/formatters/deep-splat.js.map +0 -1
  269. package/dist/esm/modules/logger/winston/formatters/index.d.ts +0 -2
  270. package/dist/esm/modules/logger/winston/formatters/index.d.ts.map +0 -1
  271. package/dist/esm/modules/logger/winston/formatters/index.js +0 -2
  272. package/dist/esm/modules/logger/winston/formatters/index.js.map +0 -1
  273. package/dist/esm/modules/network/http-request/common/types.d.ts +0 -2
  274. package/dist/esm/modules/network/http-request/common/types.d.ts.map +0 -1
  275. package/dist/esm/modules/network/http-request/common/types.js +0 -2
  276. package/dist/esm/modules/network/http-request/common/types.js.map +0 -1
  277. package/dist/esm/modules/queue/common/types.d.ts +0 -2
  278. package/dist/esm/modules/queue/common/types.d.ts.map +0 -1
  279. package/dist/esm/modules/queue/common/types.js +0 -2
  280. package/dist/esm/modules/queue/common/types.js.map +0 -1
  281. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.d.ts +0 -4
  282. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.d.ts.map +0 -1
  283. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js +0 -28
  284. package/dist/esm/modules/queue/kafka/bundler/platformatic-require.plugin.js.map +0 -1
  285. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.d.ts +0 -4
  286. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.d.ts.map +0 -1
  287. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js +0 -26
  288. package/dist/esm/modules/queue/kafka/bundler/platformatic-wasm.plugin.js.map +0 -1
  289. package/dist/esm/modules/storage/minio/helper.d.ts +0 -55
  290. package/dist/esm/modules/storage/minio/helper.d.ts.map +0 -1
  291. package/dist/esm/modules/storage/minio/helper.js +0 -176
  292. package/dist/esm/modules/storage/minio/helper.js.map +0 -1
  293. package/dist/esm/modules/storage/minio/index.d.ts +0 -2
  294. package/dist/esm/modules/storage/minio/index.d.ts.map +0 -1
  295. package/dist/esm/modules/storage/minio/index.js +0 -2
  296. package/dist/esm/modules/storage/minio/index.js.map +0 -1
  297. package/dist/esm/utilities/sleep.utility.d.ts +0 -2
  298. package/dist/esm/utilities/sleep.utility.d.ts.map +0 -1
  299. package/dist/esm/utilities/sleep.utility.js +0 -4
  300. package/dist/esm/utilities/sleep.utility.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/secrets/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAkD,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,0RAA0R;AAC1R,qNAAqN;AACrN,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAoD;IAEpD,MAAM,MAAM,GAAG;QACb,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;KACxC,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAiB,CAAC;IAEtC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACtB,KAAK,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;YACjC,OAAO,IAAI,gBAAgB,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,KAAK,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC;YACrC,wHAAwH;YACxH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBACpB,aAAa,CAAC,eAAe,CAAC;oBAC5B,KAAK,EAAE,sBAAsB;oBAC7B,OAAO,EAAE,CAAC,YAAY,CAAC;oBACvB,eAAe,EAAE,IAAI;iBACtB,CAAC,CAAC;YACL,CAAC;YACD,OAAO,IAAI,oBAAoB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,KAAK,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;YAClC,sEAAsE;YACtE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;gBACpB,aAAa,CAAC,eAAe,CAAC;oBAC5B,KAAK,EAAE,mBAAmB;oBAC1B,OAAO,EAAE,CAAC,kBAAkB,CAAC;oBAC7B,eAAe,EAAE,IAAI;iBACtB,CAAC,CAAC;YACL,CAAC;YACD,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,sDAAsD,IAAI,CAAC,QAAQ,EAAE;aAC/E,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { SecretProviders, type ISecretsHelper, type ISecretsRegistration } from './common';\nimport { DotenvVaultHelper } from './dotenv';\nimport { HashiCorpVaultHelper } from './hashicorp';\nimport { SystemEnvsHelper } from './system-envs';\n\n// node-vault / @dotenvx/dotenvx are optional peers reached only via `ModuleUtility.load`: never eagerly loaded, invisible to bundlers. Compiled apps that use a provider must ship the peer in node_modules, inject the client via options, or register it with `ModuleUtility.register`.\n// The providers are imported statically on purpose: a dynamic `import('./x')` of our own module makes bun wrap every module it reaches in a lazy initializer, and the root barrel then exports `undefined` for them.\nexport async function createSecretsHelper(\n opts: ISecretsRegistration & { identifier?: string },\n): Promise<ISecretsHelper> {\n const shared = {\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n renewBeforeRatio: opts.renewBeforeRatio,\n };\n\n const config = opts.config as AnyType;\n\n switch (opts.provider) {\n case SecretProviders.SYSTEM_ENVS: {\n return new SystemEnvsHelper({ identifier: opts.identifier });\n }\n case SecretProviders.HASHICORP_VAULT: {\n // `client` is the injected escape: the helper never reaches for the peer, so demanding it here would defeat the escape.\n if (!config?.client) {\n ModuleUtility.assertInstalled({\n scope: 'HashiCorpVaultHelper',\n modules: ['node-vault'],\n allowRegistered: true,\n });\n }\n return new HashiCorpVaultHelper({ ...config, ...shared });\n }\n case SecretProviders.DOTENV_VAULT: {\n // `decode` is the injected escape - same reasoning as `client` above.\n if (!config?.decode) {\n ModuleUtility.assertInstalled({\n scope: 'DotenvVaultHelper',\n modules: ['@dotenvx/dotenvx'],\n allowRegistered: true,\n });\n }\n return new DotenvVaultHelper({ ...config, ...shared });\n }\n default: {\n throw getError({\n message: `[createSecretsHelper] Unsupported secret provider: ${opts.provider}`,\n });\n }\n }\n}\n"]}
1
+ {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/secrets/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAkD,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,0RAA0R;AAC1R,qNAAqN;AACrN,MAAM,OAAO,oBAAoB;IAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,IAAoD;QAEpD,MAAM,MAAM,GAAG;YACb,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAiB,CAAC;QAEtC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,KAAK,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;gBACjC,OAAO,IAAI,gBAAgB,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,KAAK,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC;gBACrC,wHAAwH;gBACxH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBACpB,aAAa,CAAC,eAAe,CAAC;wBAC5B,KAAK,EAAE,sBAAsB;wBAC7B,OAAO,EAAE,CAAC,YAAY,CAAC;wBACvB,eAAe,EAAE,IAAI;qBACtB,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,IAAI,oBAAoB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,KAAK,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;gBAClC,sEAAsE;gBACtE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBACpB,aAAa,CAAC,eAAe,CAAC;wBAC5B,KAAK,EAAE,mBAAmB;wBAC1B,OAAO,EAAE,CAAC,kBAAkB,CAAC;wBAC7B,eAAe,EAAE,IAAI;qBACtB,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE,sDAAsD,IAAI,CAAC,QAAQ,EAAE;iBAC/E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { SecretProviders, type ISecretsHelper, type ISecretsRegistration } from './common';\nimport { DotenvVaultHelper } from './dotenv';\nimport { HashiCorpVaultHelper } from './hashicorp';\nimport { SystemEnvsHelper } from './system-envs';\n\n// node-vault / @dotenvx/dotenvx are optional peers reached only via `ModuleUtility.load`: never eagerly loaded, invisible to bundlers. Compiled apps that use a provider must ship the peer in node_modules, inject the client via options, or register it with `ModuleUtility.register`.\n// The providers are imported statically on purpose: a dynamic `import('./x')` of our own module makes bun wrap every module it reaches in a lazy initializer, and the root barrel then exports `undefined` for them.\nexport class SecretsHelperFactory {\n static async create(\n opts: ISecretsRegistration & { identifier?: string },\n ): Promise<ISecretsHelper> {\n const shared = {\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n renewBeforeRatio: opts.renewBeforeRatio,\n };\n\n const config = opts.config as AnyType;\n\n switch (opts.provider) {\n case SecretProviders.SYSTEM_ENVS: {\n return new SystemEnvsHelper({ identifier: opts.identifier });\n }\n case SecretProviders.HASHICORP_VAULT: {\n // `client` is the injected escape: the helper never reaches for the peer, so demanding it here would defeat the escape.\n if (!config?.client) {\n ModuleUtility.assertInstalled({\n scope: 'HashiCorpVaultHelper',\n modules: ['node-vault'],\n allowRegistered: true,\n });\n }\n return new HashiCorpVaultHelper({ ...config, ...shared });\n }\n case SecretProviders.DOTENV_VAULT: {\n // `decode` is the injected escape - same reasoning as `client` above.\n if (!config?.decode) {\n ModuleUtility.assertInstalled({\n scope: 'DotenvVaultHelper',\n modules: ['@dotenvx/dotenvx'],\n allowRegistered: true,\n });\n }\n return new DotenvVaultHelper({ ...config, ...shared });\n }\n default: {\n throw getError({\n message: `[createSecretsHelper] Unsupported secret provider: ${opts.provider}`,\n });\n }\n }\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"hashicorp.helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/secrets/hashicorp/hashicorp.helper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAoB,KAAK,MAAM,EAAE,KAAK,aAAa,EAAqB,MAAM,WAAW,CAAC;AACjG,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAG1D,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,eAAe,CAAC,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,qBAAa,oBAAqB,SAAQ,qBAAqB;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gCAAgC,CAAK;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,+BAA+B,CAAM;IAE7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,MAAM,CAAC,CAAe;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAe;IAClC,OAAO,CAAC,sBAAsB,CAAK;gBAEvB,IAAI,EAAE,4BAA4B;IAsB/B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAa1B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxC,OAAO,CAAC,aAAa;IAOrB,2HAA2H;YAC7G,KAAK;IAmDnB,OAAO,CAAC,oBAAoB;IAc5B,gLAAgL;IAChL,OAAO,CAAC,yBAAyB;YAmBnB,kBAAkB;cA6BhB,QAAQ,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;cAuB/B,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;;;cAatD,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;CAKpD"}
1
+ {"version":3,"file":"hashicorp.helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/secrets/hashicorp/hashicorp.helper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAoB,KAAK,MAAM,EAAE,KAAK,aAAa,EAAqB,MAAM,WAAW,CAAC;AACjG,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAG1D,UAAU,YAAY;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,eAAe,CAAC,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACrC;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,qBAAa,oBAAqB,SAAQ,qBAAqB;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gCAAgC,CAAK;IAC7D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,+BAA+B,CAAM;IAE7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,MAAM,CAAC,CAAe;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAe;IAClC,OAAO,CAAC,sBAAsB,CAAK;gBAEvB,IAAI,EAAE,4BAA4B;IAsB/B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAc1B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQxC,OAAO,CAAC,aAAa;IAOrB,2HAA2H;YAC7G,KAAK;IAkDnB,OAAO,CAAC,oBAAoB;IAc5B,gLAAgL;IAChL,OAAO,CAAC,yBAAyB;YAmBnB,kBAAkB;cA6BhB,QAAQ,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;cAuB/B,QAAQ,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;;;cAatD,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE;CAKpD"}
@@ -31,7 +31,8 @@ export class HashiCorpVaultHelper extends AbstractSecretsHelper {
31
31
  async configure() {
32
32
  const logger = this.logger.for(this.configure.name);
33
33
  if (!this.client) {
34
- const factory = (await ModuleUtility.load({ module: 'node-vault' })).default;
34
+ const result = await ModuleUtility.load({ module: 'node-vault' });
35
+ const factory = result.default;
35
36
  this.client = factory({ endpoint: this.endpoint, apiVersion: 'v1' });
36
37
  }
37
38
  const { ttlSeconds, renewable } = await this.login();
@@ -83,7 +84,8 @@ export class HashiCorpVaultHelper extends AbstractSecretsHelper {
83
84
  message: '[HashiCorpVaultHelper.login] node-vault client lacks kubernetesLogin',
84
85
  });
85
86
  }
86
- const jwt = (await readFile(this.auth.jwtPath ?? '/var/run/secrets/kubernetes.io/serviceaccount/token', 'utf8')).trimEnd();
87
+ const result = await readFile(this.auth.jwtPath ?? '/var/run/secrets/kubernetes.io/serviceaccount/token', 'utf8');
88
+ const jwt = result.trimEnd();
87
89
  const payload = { role: this.auth.role, jwt };
88
90
  payload['mount_point'] = this.auth.mountPath ?? 'kubernetes';
89
91
  const res = await client.kubernetesLogin(payload);
@@ -1 +1 @@
1
- {"version":3,"file":"hashicorp.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/hashicorp/hashicorp.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { AnyObject, AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { AbstractSecretsHelper } from '../base';\nimport { VaultAuthMethods, type IClock, type ITimerAdapter, type TTimerHandle } from '../common';\nimport { vaultAuthSchema, type TVaultAuth } from './auth';\n\n// node-vault's wire contract uses snake_case (role_id, secret_id, client_token, lease_duration, ...); built/read via bracket-notation on AnyObject here so the snake_case stays confined to this boundary instead of leaking into our camelCase-only typing convention.\ninterface TVaultClient {\n token: string;\n read(path: string): Promise<AnyType>;\n write(path: string, data: AnyObject): Promise<AnyType>;\n approleLogin(opts: AnyObject): Promise<AnyType>;\n kubernetesLogin?(opts: AnyObject): Promise<AnyType>;\n tokenRenewSelf(): Promise<AnyType>;\n tokenLookupSelf(): Promise<AnyType>;\n}\n\nexport interface IHashiCorpVaultHelperOptions {\n endpoint: string;\n auth: TVaultAuth;\n identifier?: string;\n cacheTtlSeconds?: number;\n renewBeforeRatio?: number;\n clock?: IClock;\n timers?: ITimerAdapter;\n /** Injection seam for tests; production builds the real node-vault client in configure(). */\n client?: TVaultClient;\n}\n\nexport class HashiCorpVaultHelper extends AbstractSecretsHelper {\n private static readonly TOKEN_RENEWAL_RETRY_BASE_SECONDS = 1;\n private static readonly TOKEN_RENEWAL_RETRY_CAP_SECONDS = 60;\n\n private readonly endpoint: string;\n private readonly auth: TVaultAuth;\n private client?: TVaultClient;\n private tokenTimer?: TTimerHandle;\n private tokenRenewalRetryCount = 0;\n\n constructor(opts: IHashiCorpVaultHelperOptions) {\n super({\n scope: HashiCorpVaultHelper.name,\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n renewBeforeRatio: opts.renewBeforeRatio,\n clock: opts.clock,\n timers: opts.timers,\n });\n this.endpoint = opts.endpoint;\n try {\n this.auth = vaultAuthSchema.parse(opts.auth);\n } catch (error) {\n throw getError({\n message: `[HashiCorpVaultHelper] Invalid Vault auth configuration | ${\n error instanceof Error ? error.message : String(error)\n }`,\n });\n }\n this.client = opts.client;\n }\n\n override async configure(): Promise<void> {\n const logger = this.logger.for(this.configure.name);\n if (!this.client) {\n const factory = (await ModuleUtility.load<AnyType>({ module: 'node-vault' })).default;\n this.client = factory({ endpoint: this.endpoint, apiVersion: 'v1' }) as TVaultClient;\n }\n const { ttlSeconds, renewable } = await this.login();\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n logger.info('Vault authenticated | endpoint: %s | method: %s', this.endpoint, this.auth.method);\n }\n\n override async shutdown(): Promise<void> {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n this.tokenTimer = undefined;\n }\n await super.shutdown();\n }\n\n private requireClient(): TVaultClient {\n if (!this.client) {\n throw getError({ message: '[HashiCorpVaultHelper] configure() must run before use' });\n }\n return this.client;\n }\n\n /** Authenticates against Vault and returns the resulting token's TTL/renewability so callers can schedule self-renewal. */\n private async login(): Promise<{ ttlSeconds: number; renewable: boolean }> {\n const client = this.requireClient();\n\n switch (this.auth.method) {\n case VaultAuthMethods.TOKEN: {\n client.token = this.auth.token;\n const res = await client.tokenLookupSelf();\n return {\n ttlSeconds: Number(res?.data?.['ttl'] ?? 0),\n renewable: Boolean(res?.data?.['renewable']),\n };\n }\n case VaultAuthMethods.APP_ROLE: {\n const payload: AnyObject = {};\n payload['role_id'] = this.auth.roleId;\n payload['secret_id'] = this.auth.secretId;\n payload['mount_point'] = this.auth.mountPath ?? 'approle';\n const res = await client.approleLogin(payload);\n client.token = res.auth['client_token'];\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n case VaultAuthMethods.KUBERNETES: {\n if (!client.kubernetesLogin) {\n throw getError({\n message: '[HashiCorpVaultHelper.login] node-vault client lacks kubernetesLogin',\n });\n }\n const jwt = (\n await readFile(\n this.auth.jwtPath ?? '/var/run/secrets/kubernetes.io/serviceaccount/token',\n 'utf8',\n )\n ).trimEnd();\n const payload: AnyObject = { role: this.auth.role, jwt };\n payload['mount_point'] = this.auth.mountPath ?? 'kubernetes';\n const res = await client.kubernetesLogin(payload);\n client.token = res.auth['client_token'];\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n default: {\n throw getError({ message: '[HashiCorpVaultHelper.login] Unsupported auth method' });\n }\n }\n }\n\n private scheduleTokenRenewal(opts: { ttlSeconds: number }): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n const delayMs = Math.max(0, opts.ttlSeconds * this.renewBeforeRatio * 1000);\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch((error) => {\n this.logger\n .for(this.scheduleTokenRenewal.name)\n .error('Token renewal handler crashed | error: %s', error);\n });\n }, delayMs);\n }\n\n /** Without a reschedule here, a transient re-auth failure lets the token expire silently with no recovery - retry with the same capped exponential backoff as lease renewal. */\n private scheduleTokenRenewalRetry(): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n this.tokenRenewalRetryCount += 1;\n const backoffSeconds = Math.min(\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_CAP_SECONDS,\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_BASE_SECONDS *\n 2 ** (this.tokenRenewalRetryCount - 1),\n );\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch((error) => {\n this.logger\n .for(this.scheduleTokenRenewalRetry.name)\n .error('Token renewal retry handler crashed | error: %s', error);\n });\n }, backoffSeconds * 1000);\n }\n\n private async handleTokenRenewal(): Promise<void> {\n const logger = this.logger.for(this.handleTokenRenewal.name);\n\n try {\n const res = await this.requireClient().tokenRenewSelf();\n const ttlSeconds = Number(res?.auth?.['lease_duration'] ?? 0);\n const renewable = Boolean(res?.auth?.['renewable']);\n if (renewable && ttlSeconds > 0) {\n this.tokenRenewalRetryCount = 0;\n this.scheduleTokenRenewal({ ttlSeconds });\n return;\n }\n logger.warn('Token renewal returned a non-renewable/expired token; re-authenticating');\n } catch (error) {\n logger.warn('Token renewal failed; re-authenticating | error: %s', error);\n }\n\n try {\n const { ttlSeconds, renewable } = await this.login();\n this.tokenRenewalRetryCount = 0;\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n } catch (error) {\n logger.error('Token re-authentication failed; scheduling bounded retry | error: %s', error);\n this.scheduleTokenRenewalRetry();\n }\n }\n\n protected async fetchRaw(opts: { path: string }) {\n const res = await this.requireClient().read(opts.path);\n const nested = res?.['data']?.['data'];\n const inner = nested && typeof nested === 'object' ? nested : res?.['data'];\n const value: Record<string, string> = {};\n const innerEntries = Object.entries(inner ?? {});\n for (const [key, raw] of innerEntries) {\n value[key] = typeof raw === 'string' ? raw : JSON.stringify(raw);\n }\n const leaseId = res?.['lease_id'];\n if (leaseId) {\n return {\n value,\n lease: {\n leaseId,\n ttlSeconds: res['lease_duration'] ?? 0,\n renewable: Boolean(res['renewable']),\n },\n };\n }\n return { value };\n }\n\n protected async renewRaw(opts: { leaseId: string; ttlSeconds: number }) {\n const logger = this.logger.for(this.renewRaw.name);\n try {\n const payload: AnyObject = { increment: opts.ttlSeconds };\n payload['lease_id'] = opts.leaseId;\n const res = await this.requireClient().write('sys/leases/renew', payload);\n return { ttlSeconds: res['lease_duration'] ?? opts.ttlSeconds };\n } catch (error) {\n logger.warn('Renew rejected | leaseId: %s | error: %s', opts.leaseId, error);\n return null;\n }\n }\n\n protected async revokeRaw(opts: { leaseId: string }) {\n const payload: AnyObject = {};\n payload['lease_id'] = opts.leaseId;\n await this.requireClient().write('sys/leases/revoke', payload);\n }\n}\n"]}
1
+ {"version":3,"file":"hashicorp.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/hashicorp/hashicorp.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { AnyObject, AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { AbstractSecretsHelper } from '../base';\nimport { VaultAuthMethods, type IClock, type ITimerAdapter, type TTimerHandle } from '../common';\nimport { vaultAuthSchema, type TVaultAuth } from './auth';\n\n// node-vault's wire contract uses snake_case (role_id, secret_id, client_token, lease_duration, ...); built/read via bracket-notation on AnyObject here so the snake_case stays confined to this boundary instead of leaking into our camelCase-only typing convention.\ninterface TVaultClient {\n token: string;\n read(path: string): Promise<AnyType>;\n write(path: string, data: AnyObject): Promise<AnyType>;\n approleLogin(opts: AnyObject): Promise<AnyType>;\n kubernetesLogin?(opts: AnyObject): Promise<AnyType>;\n tokenRenewSelf(): Promise<AnyType>;\n tokenLookupSelf(): Promise<AnyType>;\n}\n\nexport interface IHashiCorpVaultHelperOptions {\n endpoint: string;\n auth: TVaultAuth;\n identifier?: string;\n cacheTtlSeconds?: number;\n renewBeforeRatio?: number;\n clock?: IClock;\n timers?: ITimerAdapter;\n /** Injection seam for tests; production builds the real node-vault client in configure(). */\n client?: TVaultClient;\n}\n\nexport class HashiCorpVaultHelper extends AbstractSecretsHelper {\n private static readonly TOKEN_RENEWAL_RETRY_BASE_SECONDS = 1;\n private static readonly TOKEN_RENEWAL_RETRY_CAP_SECONDS = 60;\n\n private readonly endpoint: string;\n private readonly auth: TVaultAuth;\n private client?: TVaultClient;\n private tokenTimer?: TTimerHandle;\n private tokenRenewalRetryCount = 0;\n\n constructor(opts: IHashiCorpVaultHelperOptions) {\n super({\n scope: HashiCorpVaultHelper.name,\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n renewBeforeRatio: opts.renewBeforeRatio,\n clock: opts.clock,\n timers: opts.timers,\n });\n this.endpoint = opts.endpoint;\n try {\n this.auth = vaultAuthSchema.parse(opts.auth);\n } catch (error) {\n throw getError({\n message: `[HashiCorpVaultHelper] Invalid Vault auth configuration | ${\n error instanceof Error ? error.message : String(error)\n }`,\n });\n }\n this.client = opts.client;\n }\n\n override async configure(): Promise<void> {\n const logger = this.logger.for(this.configure.name);\n if (!this.client) {\n const result = await ModuleUtility.load<AnyType>({ module: 'node-vault' });\n const factory = result.default;\n this.client = factory({ endpoint: this.endpoint, apiVersion: 'v1' }) as TVaultClient;\n }\n const { ttlSeconds, renewable } = await this.login();\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n logger.info('Vault authenticated | endpoint: %s | method: %s', this.endpoint, this.auth.method);\n }\n\n override async shutdown(): Promise<void> {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n this.tokenTimer = undefined;\n }\n await super.shutdown();\n }\n\n private requireClient(): TVaultClient {\n if (!this.client) {\n throw getError({ message: '[HashiCorpVaultHelper] configure() must run before use' });\n }\n return this.client;\n }\n\n /** Authenticates against Vault and returns the resulting token's TTL/renewability so callers can schedule self-renewal. */\n private async login(): Promise<{ ttlSeconds: number; renewable: boolean }> {\n const client = this.requireClient();\n\n switch (this.auth.method) {\n case VaultAuthMethods.TOKEN: {\n client.token = this.auth.token;\n const res = await client.tokenLookupSelf();\n return {\n ttlSeconds: Number(res?.data?.['ttl'] ?? 0),\n renewable: Boolean(res?.data?.['renewable']),\n };\n }\n case VaultAuthMethods.APP_ROLE: {\n const payload: AnyObject = {};\n payload['role_id'] = this.auth.roleId;\n payload['secret_id'] = this.auth.secretId;\n payload['mount_point'] = this.auth.mountPath ?? 'approle';\n const res = await client.approleLogin(payload);\n client.token = res.auth['client_token'];\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n case VaultAuthMethods.KUBERNETES: {\n if (!client.kubernetesLogin) {\n throw getError({\n message: '[HashiCorpVaultHelper.login] node-vault client lacks kubernetesLogin',\n });\n }\n const result = await readFile(\n this.auth.jwtPath ?? '/var/run/secrets/kubernetes.io/serviceaccount/token',\n 'utf8',\n );\n const jwt = result.trimEnd();\n const payload: AnyObject = { role: this.auth.role, jwt };\n payload['mount_point'] = this.auth.mountPath ?? 'kubernetes';\n const res = await client.kubernetesLogin(payload);\n client.token = res.auth['client_token'];\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n default: {\n throw getError({ message: '[HashiCorpVaultHelper.login] Unsupported auth method' });\n }\n }\n }\n\n private scheduleTokenRenewal(opts: { ttlSeconds: number }): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n const delayMs = Math.max(0, opts.ttlSeconds * this.renewBeforeRatio * 1000);\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch((error) => {\n this.logger\n .for(this.scheduleTokenRenewal.name)\n .error('Token renewal handler crashed | error: %s', error);\n });\n }, delayMs);\n }\n\n /** Without a reschedule here, a transient re-auth failure lets the token expire silently with no recovery - retry with the same capped exponential backoff as lease renewal. */\n private scheduleTokenRenewalRetry(): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n this.tokenRenewalRetryCount += 1;\n const backoffSeconds = Math.min(\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_CAP_SECONDS,\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_BASE_SECONDS *\n 2 ** (this.tokenRenewalRetryCount - 1),\n );\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch((error) => {\n this.logger\n .for(this.scheduleTokenRenewalRetry.name)\n .error('Token renewal retry handler crashed | error: %s', error);\n });\n }, backoffSeconds * 1000);\n }\n\n private async handleTokenRenewal(): Promise<void> {\n const logger = this.logger.for(this.handleTokenRenewal.name);\n\n try {\n const res = await this.requireClient().tokenRenewSelf();\n const ttlSeconds = Number(res?.auth?.['lease_duration'] ?? 0);\n const renewable = Boolean(res?.auth?.['renewable']);\n if (renewable && ttlSeconds > 0) {\n this.tokenRenewalRetryCount = 0;\n this.scheduleTokenRenewal({ ttlSeconds });\n return;\n }\n logger.warn('Token renewal returned a non-renewable/expired token; re-authenticating');\n } catch (error) {\n logger.warn('Token renewal failed; re-authenticating | error: %s', error);\n }\n\n try {\n const { ttlSeconds, renewable } = await this.login();\n this.tokenRenewalRetryCount = 0;\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n } catch (error) {\n logger.error('Token re-authentication failed; scheduling bounded retry | error: %s', error);\n this.scheduleTokenRenewalRetry();\n }\n }\n\n protected async fetchRaw(opts: { path: string }) {\n const res = await this.requireClient().read(opts.path);\n const nested = res?.['data']?.['data'];\n const inner = nested && typeof nested === 'object' ? nested : res?.['data'];\n const value: Record<string, string> = {};\n const innerEntries = Object.entries(inner ?? {});\n for (const [key, raw] of innerEntries) {\n value[key] = typeof raw === 'string' ? raw : JSON.stringify(raw);\n }\n const leaseId = res?.['lease_id'];\n if (leaseId) {\n return {\n value,\n lease: {\n leaseId,\n ttlSeconds: res['lease_duration'] ?? 0,\n renewable: Boolean(res['renewable']),\n },\n };\n }\n return { value };\n }\n\n protected async renewRaw(opts: { leaseId: string; ttlSeconds: number }) {\n const logger = this.logger.for(this.renewRaw.name);\n try {\n const payload: AnyObject = { increment: opts.ttlSeconds };\n payload['lease_id'] = opts.leaseId;\n const res = await this.requireClient().write('sys/leases/renew', payload);\n return { ttlSeconds: res['lease_duration'] ?? opts.ttlSeconds };\n } catch (error) {\n logger.warn('Renew rejected | leaseId: %s | error: %s', opts.leaseId, error);\n return null;\n }\n }\n\n protected async revokeRaw(opts: { leaseId: string }) {\n const payload: AnyObject = {};\n payload['lease_id'] = opts.leaseId;\n await this.requireClient().write('sys/leases/revoke', payload);\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/server/helper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAW5C,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,KAAK,MAAM,IAAI,QAAQ,EAAsB,MAAM,WAAW,CAAC;AAC5F,OAAO,EAEL,KAAK,eAAe,EAKpB,KAAK,sBAAsB,EAE5B,MAAM,WAAW,CAAC;AAKnB,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAC,CAAM;IACxB,OAAO,CAAC,aAAa,CAA8B;IAEnD,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAA2C;IAE1D,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,YAAY,CAAe;IAEnC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,cAAc,CAAC,CAA0B;IACjD,OAAO,CAAC,iBAAiB,CAAC,CAA6B;IAEvD,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAW;gBAEnB,IAAI,EAAE,sBAAsB;IAsBxC,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,gBAAgB;IAaxB,WAAW,IAAI,QAAQ;IAIvB,6LAA6L;IAC7L,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;KAAE;IAUnF,SAAS;IAIT,UAAU,CAAC,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS;IAQ9F,EAAE,CAAC,eAAe,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,gBAAgB,GAAG,IAAI,EAAE,IAAI,EAAE;QAC/E,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,eAAe,KAAK,cAAc,CAAC,gBAAgB,CAAC,CAAC;KACzE;IAiBK,SAAS;IAgDf,OAAO,CAAC,YAAY;IAsBpB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAA;KAAE;IAsC1C,OAAO,CAAC,mBAAmB;IAgE3B,OAAO,CAAC,YAAY;IAUpB,qBAAqB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAA;KAAE;IAsEhD;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAOzB,OAAO,CAAC,oBAAoB;IAiF5B,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE;IAwBtD,UAAU,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAA;KAAE;IA2BrC,IAAI,CAAC,IAAI,EAAE;QACT,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,GAAG,CAAA;SAAE,CAAC;QACtC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;KACvB;IA2CD,OAAO,CAAC,KAAK;IAwBP,QAAQ;CA0Bf"}
1
+ {"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/server/helper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAO5C,OAAO,EAAE,MAAM,IAAI,QAAQ,EAAE,KAAK,MAAM,IAAI,QAAQ,EAAsB,MAAM,WAAW,CAAC;AAC5F,OAAO,EAEL,KAAK,eAAe,EAKpB,KAAK,sBAAsB,EAE5B,MAAM,WAAW,CAAC;AAKnB,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,SAAS,CAAC,CAAM;IACxB,OAAO,CAAC,aAAa,CAA8B;IAEnD,OAAO,CAAC,EAAE,CAAW;IACrB,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,OAAO,CAA2C;IAE1D,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,YAAY,CAAe;IAEnC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,cAAc,CAAC,CAA0B;IACjD,OAAO,CAAC,iBAAiB,CAAC,CAA6B;IAEvD,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAW;gBAEnB,IAAI,EAAE,sBAAsB;IAsBxC,OAAO,CAAC,UAAU;IAsBlB,OAAO,CAAC,gBAAgB;IAaxB,WAAW,IAAI,QAAQ;IAIvB,6LAA6L;IAC7L,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,CAAA;KAAE;IAUnF,SAAS;IAIT,UAAU,CAAC,IAAI,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,eAAe,GAAG,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,SAAS;IAQ9F,EAAE,CAAC,eAAe,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EAAE,gBAAgB,GAAG,IAAI,EAAE,IAAI,EAAE;QAC/E,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,eAAe,KAAK,cAAc,CAAC,gBAAgB,CAAC,CAAC;KACzE;IAiBK,SAAS;IAgDf,OAAO,CAAC,YAAY;IAsBpB,eAAe,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAA;KAAE;IAsC1C,OAAO,CAAC,mBAAmB;IAgE3B,OAAO,CAAC,YAAY;IAUpB,qBAAqB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAA;KAAE;IAsEhD;;;;;;;;OAQG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAOzB,OAAO,CAAC,oBAAoB;IAiF5B,IAAI,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAC;QAAC,YAAY,EAAE,OAAO,CAAA;KAAE;IAwBtD,UAAU,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,QAAQ,CAAA;KAAE;IA2BrC,IAAI,CAAC,IAAI,EAAE;QACT,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,GAAG,CAAA;SAAE,CAAC;QACtC,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;KACvB;IA2CD,OAAO,CAAC,KAAK;IAwBP,QAAQ;CA0Bf"}
@@ -1,10 +1,10 @@
1
- import { isEmpty } from '@venizia/ignis-inversion';
1
+ import { ObjectUtility } from '@venizia/ignis-inversion';
2
2
  import { HTTP } from '../../../../common/index.js';
3
3
  import { RuntimeModules } from '../../../../common/constants/index.js';
4
4
  import { BaseHelper } from '../../../base.js';
5
5
  import { getError } from '../../../error/index.js';
6
- import { ensureRedisClientsConnecting, waitForRedisReady, } from '../../../redis/index.js';
7
- import { voidExecution } from '../../../../utilities/promise.utility.js';
6
+ import { RedisUtility } from '../../../redis/index.js';
7
+ import { PromiseUtility } from '../../../../utilities/promise.utility.js';
8
8
  import { createAdapter } from '@socket.io/redis-adapter';
9
9
  import { Emitter } from '@socket.io/redis-emitter';
10
10
  import { Server as IOServer } from 'socket.io';
@@ -69,7 +69,7 @@ export class SocketIOServerHelper extends BaseHelper {
69
69
  invokeHook(opts) {
70
70
  const { scope, execution } = opts;
71
71
  try {
72
- voidExecution({ logger: this.logger, scope, execution: execution() });
72
+ PromiseUtility.voidExecution({ logger: this.logger, scope, execution: execution() });
73
73
  }
74
74
  catch (error) {
75
75
  this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);
@@ -110,15 +110,15 @@ export class SocketIOServerHelper extends BaseHelper {
110
110
  this.redisEmitter.on('error', (error) => {
111
111
  logger.error('Redis emitter error | error: %s', error);
112
112
  });
113
- ensureRedisClientsConnecting({
113
+ RedisUtility.ensureConnecting({
114
114
  clients: [this.redisPub, this.redisSub, this.redisEmitter],
115
115
  logger: this.logger,
116
116
  scope: this.configure.name,
117
117
  });
118
118
  await Promise.all([
119
- waitForRedisReady({ client: this.redisPub }),
120
- waitForRedisReady({ client: this.redisSub }),
121
- waitForRedisReady({ client: this.redisEmitter }),
119
+ RedisUtility.waitForReady({ client: this.redisPub }),
120
+ RedisUtility.waitForReady({ client: this.redisSub }),
121
+ RedisUtility.waitForReady({ client: this.redisEmitter }),
122
122
  ]);
123
123
  logger.info('All Redis connections ready');
124
124
  this.initIOServer();
@@ -325,7 +325,7 @@ export class SocketIOServerHelper extends BaseHelper {
325
325
  }
326
326
  joinLogger.info('Joining rooms | id: %s | rooms: %j', id, allowedRooms);
327
327
  for (const room of allowedRooms) {
328
- voidExecution({
328
+ PromiseUtility.voidExecution({
329
329
  logger: this.logger,
330
330
  scope: SocketIOConstants.EVENT_JOIN,
331
331
  execution: socket.join(room),
@@ -410,7 +410,7 @@ export class SocketIOServerHelper extends BaseHelper {
410
410
  return;
411
411
  }
412
412
  const sender = this.emitter.compress(true);
413
- if (destination && !isEmpty({ value: destination })) {
413
+ if (destination && !ObjectUtility.isEmpty({ value: destination })) {
414
414
  sender.to(destination).emit(topic, data);
415
415
  }
416
416
  else {
@@ -431,7 +431,7 @@ export class SocketIOServerHelper extends BaseHelper {
431
431
  resolve();
432
432
  return;
433
433
  }
434
- voidExecution({
434
+ PromiseUtility.voidExecution({
435
435
  logger: this.logger,
436
436
  scope: 'close',
437
437
  execution: this.io.close((error) => {
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/server/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { isEmpty } from '@venizia/ignis-inversion';\nimport { HTTP } from '@/common';\nimport { RuntimeModules, type TRuntimeModule } from '@/common/constants';\nimport { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport {\n ensureRedisClientsConnecting,\n type TRedisClient,\n waitForRedisReady,\n} from '@/modules/redis';\nimport { voidExecution } from '@/utilities/promise.utility';\nimport { createAdapter } from '@socket.io/redis-adapter';\nimport { Emitter } from '@socket.io/redis-emitter';\nimport { type EventEmitter } from 'node:events';\nimport { Server as IOServer, type Socket as IOSocket, type ServerOptions } from 'socket.io';\nimport {\n type IHandshake,\n type ISocketIOClient,\n SocketIOClientStates,\n SocketIOConstants,\n type TSocketIOAuthenticateFn,\n type TSocketIOClientConnectedFn,\n type TSocketIOServerOptions,\n type TSocketIOValidateRoomFn,\n} from '../common';\n\nconst CLIENT_AUTHENTICATE_TIMEOUT = 10_000;\nconst CLIENT_PING_INTERVAL = 30_000;\n\nexport class SocketIOServerHelper extends BaseHelper {\n private runtime: TRuntimeModule;\n private 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 this.bunEngine = opts.engine;\n break;\n }\n default: {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[SocketIOServerHelper] Unsupported runtime!',\n });\n }\n }\n }\n\n private initRedisClients(redisConnection: TSocketIOServerOptions['redisConnection']) {\n if (!redisConnection) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: 'Invalid redis connection to config socket.io adapter!',\n });\n }\n\n this.redisPub = redisConnection.duplicateClient();\n this.redisSub = redisConnection.duplicateClient();\n this.redisEmitter = redisConnection.duplicateClient();\n }\n\n getIOServer(): IOServer {\n return this.io;\n }\n\n /** Handlers run inside socket.io event listeners - a sync throw there kills the process; voidExecution only catches promise rejections since its argument evaluates before the try/catch. */\n protected invokeHook(opts: { scope: string; execution: () => ValueOrPromise<void> }) {\n const { scope, execution } = opts;\n\n try {\n voidExecution({ logger: this.logger, scope, execution: execution() });\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n getEngine() {\n return this.bunEngine;\n }\n\n getClients(opts?: { id?: string }): ISocketIOClient | Map<string, ISocketIOClient> | undefined {\n const { id } = opts ?? {};\n if (id) {\n return this.clients.get(id);\n }\n return this.clients;\n }\n\n on<HandlerArgsType extends unknown[] = unknown[], HanderReturnType = void>(opts: {\n topic: string;\n handler: (...args: HandlerArgsType) => ValueOrPromise<HanderReturnType>;\n }) {\n const { topic, handler } = opts;\n if (!topic) {\n throw getError({ message: '[on] Invalid topic to start binding handler' });\n }\n\n if (!handler) {\n throw getError({ message: `[on] Invalid event handler | topic: ${topic}` });\n }\n\n if (!this.io) {\n throw getError({ message: '[on] IOServer is not initialized yet!' });\n }\n\n this.io.on(topic, handler);\n }\n\n async configure() {\n const logger = this.logger.for(this.configure.name);\n logger.info('Configuring IO Server | id: %s | runtime: %s', this.identifier, this.runtime);\n\n (this.redisPub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis adapter pub error | error: %s', error);\n });\n\n (this.redisSub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis adapter sub error | error: %s', error);\n });\n\n (this.redisEmitter as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis emitter error | error: %s', error);\n });\n\n ensureRedisClientsConnecting({\n clients: [this.redisPub, this.redisSub, this.redisEmitter],\n logger: this.logger,\n scope: this.configure.name,\n });\n\n await Promise.all([\n waitForRedisReady({ client: this.redisPub }),\n waitForRedisReady({ client: this.redisSub }),\n waitForRedisReady({ client: this.redisEmitter }),\n ]);\n logger.info('All Redis connections ready');\n\n this.initIOServer();\n\n this.io.adapter(createAdapter(this.redisPub, this.redisSub));\n logger.info('SocketIO Server initialized Redis Adapter');\n\n this.emitter = new Emitter(this.redisEmitter);\n logger.info('SocketIO Server initialized Redis Emitter');\n\n this.io.on(SocketIOConstants.EVENT_CONNECT, (socket: IOSocket) => {\n this.onClientConnect({ socket });\n });\n\n logger.info(\n 'SocketIO Server READY | path: %s | runtime: %s',\n this.serverOptions?.path ?? '',\n this.runtime,\n );\n }\n\n private initIOServer() {\n switch (this.runtime) {\n case RuntimeModules.BUN: {\n if (!this.bunEngine) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[DANGER] Invalid @socket.io/bun-engine instance to init Socket.io server!',\n });\n }\n this.io = new IOServer();\n this.io.bind(this.bunEngine);\n break;\n }\n default: {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[configure] Unsupported runtime: ${this.runtime}`,\n });\n }\n }\n }\n\n onClientConnect(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.onClientConnect.name);\n const { socket } = opts;\n\n if (!socket) {\n logger.info('Invalid new socket connection!');\n return;\n }\n\n const { id, handshake } = socket;\n if (this.clients.has(id)) {\n logger.info('Socket client already existed | id: %s', id);\n return;\n }\n\n logger.info('New connection request | id: %s', id);\n\n const client: ISocketIOClient = {\n id,\n socket,\n state: SocketIOClientStates.UNAUTHORIZED,\n authenticateTimeout: setTimeout(() => {\n const currentClient = this.clients.get(id);\n if (currentClient?.state === SocketIOClientStates.AUTHENTICATED) {\n return;\n }\n this.disconnect({ socket });\n }, this.authenticateTimeout),\n };\n this.clients.set(id, client);\n\n socket.on(SocketIOConstants.EVENT_DISCONNECT, () => {\n this.disconnect({ socket });\n });\n\n this.registerAuthHandler({ socket, handshake, clientId: id });\n }\n\n private registerAuthHandler(opts: { socket: IOSocket; handshake: IHandshake; clientId: string }) {\n const { socket, handshake, clientId: id } = opts;\n const authLogger = this.logger.for('onClientAuthenticate');\n\n socket.on(SocketIOConstants.EVENT_AUTHENTICATE, () => {\n const currentClient = this.clients.get(id);\n if (!currentClient) {\n authLogger.warn('Client no longer exists during auth | id: %s', id);\n return;\n }\n\n if (currentClient.state !== SocketIOClientStates.UNAUTHORIZED) {\n authLogger.warn(\n 'Client attempted auth in invalid state | id: %s | currentState: %s',\n id,\n currentClient.state,\n );\n return;\n }\n\n currentClient.state = SocketIOClientStates.AUTHENTICATING;\n\n Promise.resolve()\n .then(() => this.authenticateFn(handshake))\n .then((rs: boolean) => {\n if (!this.clients.has(id)) {\n authLogger.info('Client disconnected during authentication | id: %s', id);\n return;\n }\n\n authLogger.info('Authentication completed | id: %s | result: %s', id, rs);\n\n if (rs) {\n this.onClientAuthenticated({ socket });\n return;\n }\n\n const failedClient = this.clients.get(id);\n if (failedClient) {\n failedClient.state = SocketIOClientStates.UNAUTHORIZED;\n }\n\n this.rejectClient({\n socket,\n message: 'Invalid token to authenticate! Please login again!',\n });\n })\n .catch((error: Error) => {\n const errorClient = this.clients.get(id);\n if (errorClient) {\n errorClient.state = SocketIOClientStates.UNAUTHORIZED;\n }\n\n authLogger.error('Failed to authenticate | id: %s | error: %s', id, error);\n\n this.rejectClient({\n socket,\n message: 'Failed to authenticate connection! Please login again!',\n });\n });\n });\n }\n\n // The socket is connected to this process, so the notice goes out on it directly: routed through the Redis emitter it arrives after the disconnect and is dropped.\n private rejectClient(opts: { socket: IOSocket; message: string }) {\n const { socket, message } = opts;\n\n socket.emit(SocketIOConstants.EVENT_UNAUTHENTICATE, {\n message,\n time: new Date().toISOString(),\n });\n this.disconnect({ socket });\n }\n\n onClientAuthenticated(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.onClientAuthenticated.name);\n const { socket } = opts;\n\n if (!socket) {\n logger.info('Invalid new socket connection!');\n return;\n }\n\n const { id } = socket;\n const client = this.clients.get(id);\n if (!client) {\n logger.info('Unknown client | id: %s', id);\n this.disconnect({ socket });\n return;\n }\n\n client.state = SocketIOClientStates.AUTHENTICATED;\n\n // The authenticate deadline is over: leaving it armed keeps a timer per client alive\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n client.authenticateTimeout = undefined;\n }\n\n this.ping({ socket, doIgnoreAuth: true });\n\n logger.info(\n 'Client connected | id: %s | identifier: %s | time: %s',\n id,\n this.identifier,\n new Date().toISOString(),\n );\n\n Promise.all(this.defaultRooms.map((room: string) => Promise.resolve(socket.join(room))))\n .then(() => {\n logger.info('Joined default rooms | id: %s | rooms: %s', id, this.defaultRooms);\n })\n .catch((error) => {\n logger.error(\n 'Failed to join default rooms | id: %s | rooms: %s | error: %s',\n id,\n this.defaultRooms,\n error,\n );\n });\n\n this.registerRoomHandlers({ socket, clientId: id });\n\n client.interval = setInterval(() => {\n this.ping({ socket, doIgnoreAuth: true });\n }, this.pingInterval);\n\n this.send({\n destination: socket.id,\n payload: {\n topic: SocketIOConstants.EVENT_AUTHENTICATED,\n data: {\n id: socket.id,\n time: new Date().toISOString(),\n },\n },\n });\n\n this.invokeHook({\n scope: 'clientConnectedFn',\n execution: () => this.onClientConnected?.({ socket }),\n });\n }\n\n /**\n * Narrows an untrusted room payload to the strings it actually contains.\n *\n * The listeners below run on data any authenticated client sends. Destructuring `{ rooms = [] }`\n * out of an `any` and testing `rooms?.length` accepts a STRING - `{\"rooms\":\"lobby\"}` has a\n * length of 5 - and the next line calls `rooms.map`, which a string does not have. socket.io\n * dispatches on `process.nextTick` with no try/catch around the handler, so that TypeError\n * escapes as an uncaught exception and takes the process with it.\n */\n private static toRoomList(payload: unknown): string[] {\n const rooms = (payload as { rooms?: unknown } | null | undefined)?.rooms;\n return Array.isArray(rooms)\n ? rooms.filter((room): room is string => typeof room === 'string')\n : [];\n }\n\n private registerRoomHandlers(opts: { socket: IOSocket; clientId: string }) {\n const { socket, clientId: id } = opts;\n\n const joinLogger = this.logger.for(SocketIOConstants.EVENT_JOIN);\n socket.on(SocketIOConstants.EVENT_JOIN, (payload: any) => {\n const rooms = SocketIOServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n const validateRoomFn = this.validateRoomFn;\n if (!validateRoomFn) {\n joinLogger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no validateRoomFn configured',\n id,\n rooms,\n );\n return;\n }\n\n Promise.resolve()\n .then(() => validateRoomFn({ socket, rooms }))\n .then((allowedRooms: string[]) => {\n if (!allowedRooms?.length) {\n joinLogger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no rooms allowed',\n id,\n rooms,\n );\n return;\n }\n\n joinLogger.info('Joining rooms | id: %s | rooms: %j', id, allowedRooms);\n\n for (const room of allowedRooms) {\n voidExecution({\n logger: this.logger,\n scope: SocketIOConstants.EVENT_JOIN,\n execution: socket.join(room),\n });\n }\n\n joinLogger.info('Joined rooms | id: %s | rooms: %s', id, allowedRooms);\n })\n .catch((error) => {\n joinLogger.error(\n 'Failed to join rooms | id: %s | rooms: %s | error: %s',\n id,\n rooms,\n error,\n );\n });\n });\n\n const leaveLogger = this.logger.for(SocketIOConstants.EVENT_LEAVE);\n socket.on(SocketIOConstants.EVENT_LEAVE, (payload: any) => {\n const rooms = SocketIOServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n leaveLogger.info('Leaving rooms | id: %s | rooms: %j', id, rooms);\n\n // `Promise.resolve` per room: socket.io declares `leave(room): Promise<void> | void` - the\n // default adapter is synchronous, a clustered one is not - and `Promise.all` over a mixed\n // iterable is what the previous `any`-typed payload was hiding.\n Promise.all(rooms.map((room) => Promise.resolve(socket.leave(room))))\n .then(() => {\n leaveLogger.info('Left rooms | id: %s | rooms: %s', id, rooms);\n })\n .catch((error) => {\n leaveLogger.error(\n 'Failed to leave rooms | id: %s | rooms: %s | error: %s',\n id,\n rooms,\n error,\n );\n });\n });\n }\n\n ping(opts: { socket: IOSocket; doIgnoreAuth: boolean }) {\n const logger = this.logger.for(this.ping.name);\n const { socket, doIgnoreAuth } = opts;\n\n if (!socket) {\n logger.info('Socket is undefined to PING!');\n return;\n }\n\n const client = this.clients.get(socket.id);\n if (!client) {\n logger.info('Client not found | socketId: %s', socket.id);\n return;\n }\n\n if (!doIgnoreAuth && client.state !== SocketIOClientStates.AUTHENTICATED) {\n logger.info('Socket client is not authenticated | state: %s', client.state);\n this.disconnect({ socket });\n return;\n }\n\n socket.emit(SocketIOConstants.EVENT_PING, { time: new Date().toISOString() });\n }\n\n disconnect(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.disconnect.name);\n const { socket } = opts;\n if (!socket) {\n return;\n }\n\n const { id } = socket;\n\n if (this.clients.has(id)) {\n const client = this.clients.get(id)!;\n\n if (client.interval) {\n clearInterval(client.interval);\n }\n\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n }\n\n this.clients.delete(id);\n }\n\n logger.info('Client disconnected | id: %s | time: %s', id, new Date().toISOString());\n socket.disconnect();\n }\n\n send(opts: {\n destination?: string;\n payload: { topic: string; data: any };\n doLog?: boolean;\n callback?: () => void;\n }) {\n const logger = this.logger.for(this.send.name);\n const { destination, payload, doLog, callback } = opts;\n\n if (!payload) {\n return;\n }\n\n const { topic, data } = payload;\n if (!topic || !data) {\n return;\n }\n\n if (!this.emitter) {\n logger.error(\n 'Cannot emit | Redis emitter is not initialized | call configure() first | topic: %s',\n topic,\n );\n return;\n }\n\n const sender = this.emitter.compress(true);\n\n if (destination && !isEmpty({ value: destination })) {\n sender.to(destination).emit(topic, data);\n } else {\n sender.emit(topic, data);\n }\n\n if (callback) {\n setImmediate(callback);\n }\n\n if (doLog) {\n logger.info(\n 'Message emitted | destination: %s | topic: %s | data: %j',\n destination ?? 'all',\n topic,\n data,\n );\n }\n }\n\n private close() {\n return new Promise<void>((resolve, reject) => {\n // configure() may never have run (or may have failed): there is nothing to close, but the redis clients still have to be released by the caller\n if (!this.io) {\n this.logger.for('close').info('SKIP close | IOServer was never initialized');\n resolve();\n return;\n }\n\n voidExecution({\n logger: this.logger,\n scope: 'close',\n execution: this.io.close((error) => {\n if (error) {\n reject(error);\n return;\n }\n\n resolve();\n }),\n });\n });\n }\n\n async shutdown() {\n const logger = this.logger.for(this.shutdown.name);\n logger.info('Shutting down SocketIO server...');\n\n for (const [, client] of this.clients) {\n if (client.interval) {\n clearInterval(client.interval);\n }\n\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n }\n\n client.socket.disconnect();\n }\n this.clients.clear();\n\n try {\n await this.close();\n } finally {\n // close() rejects when io.close() reports a lingering handle. Skipping the quits there leaves three live Redis sockets holding the event loop open, and a SIGTERM handler never returns.\n await Promise.all([this.redisPub?.quit(), this.redisSub?.quit(), this.redisEmitter?.quit()]);\n }\n\n logger.info('SocketIO server shutdown complete');\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/socket-io/server/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { 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\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 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 if (id) {\n return this.clients.get(id);\n }\n return this.clients;\n }\n\n on<HandlerArgsType extends unknown[] = unknown[], HanderReturnType = void>(opts: {\n topic: string;\n handler: (...args: HandlerArgsType) => ValueOrPromise<HanderReturnType>;\n }) {\n const { topic, handler } = opts;\n if (!topic) {\n throw getError({ message: '[on] Invalid topic to start binding handler' });\n }\n\n if (!handler) {\n throw getError({ message: `[on] Invalid event handler | topic: ${topic}` });\n }\n\n if (!this.io) {\n throw getError({ message: '[on] IOServer is not initialized yet!' });\n }\n\n this.io.on(topic, handler);\n }\n\n async configure() {\n const logger = this.logger.for(this.configure.name);\n logger.info('Configuring IO Server | id: %s | runtime: %s', this.identifier, this.runtime);\n\n (this.redisPub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis adapter pub error | error: %s', error);\n });\n\n (this.redisSub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis adapter sub error | error: %s', error);\n });\n\n (this.redisEmitter as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis emitter error | error: %s', error);\n });\n\n 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 this.io = new IOServer();\n this.io.bind(this.bunEngine);\n break;\n }\n default: {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[configure] Unsupported runtime: ${this.runtime}`,\n });\n }\n }\n }\n\n onClientConnect(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.onClientConnect.name);\n const { socket } = opts;\n\n if (!socket) {\n logger.info('Invalid new socket connection!');\n return;\n }\n\n const { id, handshake } = socket;\n if (this.clients.has(id)) {\n logger.info('Socket client already existed | id: %s', id);\n return;\n }\n\n logger.info('New connection request | id: %s', id);\n\n const client: ISocketIOClient = {\n id,\n socket,\n state: SocketIOClientStates.UNAUTHORIZED,\n authenticateTimeout: setTimeout(() => {\n const currentClient = this.clients.get(id);\n if (currentClient?.state === SocketIOClientStates.AUTHENTICATED) {\n return;\n }\n this.disconnect({ socket });\n }, this.authenticateTimeout),\n };\n this.clients.set(id, client);\n\n socket.on(SocketIOConstants.EVENT_DISCONNECT, () => {\n this.disconnect({ socket });\n });\n\n this.registerAuthHandler({ socket, handshake, clientId: id });\n }\n\n private registerAuthHandler(opts: { socket: IOSocket; handshake: IHandshake; clientId: string }) {\n const { socket, handshake, clientId: id } = opts;\n const authLogger = this.logger.for('onClientAuthenticate');\n\n socket.on(SocketIOConstants.EVENT_AUTHENTICATE, () => {\n const currentClient = this.clients.get(id);\n if (!currentClient) {\n authLogger.warn('Client no longer exists during auth | id: %s', id);\n return;\n }\n\n if (currentClient.state !== SocketIOClientStates.UNAUTHORIZED) {\n authLogger.warn(\n 'Client attempted auth in invalid state | id: %s | currentState: %s',\n id,\n currentClient.state,\n );\n return;\n }\n\n currentClient.state = SocketIOClientStates.AUTHENTICATING;\n\n Promise.resolve()\n .then(() => this.authenticateFn(handshake))\n .then((rs: boolean) => {\n if (!this.clients.has(id)) {\n authLogger.info('Client disconnected during authentication | id: %s', id);\n return;\n }\n\n authLogger.info('Authentication completed | id: %s | result: %s', id, rs);\n\n if (rs) {\n this.onClientAuthenticated({ socket });\n return;\n }\n\n const failedClient = this.clients.get(id);\n if (failedClient) {\n failedClient.state = SocketIOClientStates.UNAUTHORIZED;\n }\n\n this.rejectClient({\n socket,\n message: 'Invalid token to authenticate! Please login again!',\n });\n })\n .catch((error: Error) => {\n const errorClient = this.clients.get(id);\n if (errorClient) {\n errorClient.state = SocketIOClientStates.UNAUTHORIZED;\n }\n\n authLogger.error('Failed to authenticate | id: %s | error: %s', id, error);\n\n this.rejectClient({\n socket,\n message: 'Failed to authenticate connection! Please login again!',\n });\n });\n });\n }\n\n // The socket is connected to this process, so the notice goes out on it directly: routed through the Redis emitter it arrives after the disconnect and is dropped.\n private rejectClient(opts: { socket: IOSocket; message: string }) {\n const { socket, message } = opts;\n\n socket.emit(SocketIOConstants.EVENT_UNAUTHENTICATE, {\n message,\n time: new Date().toISOString(),\n });\n this.disconnect({ socket });\n }\n\n onClientAuthenticated(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.onClientAuthenticated.name);\n const { socket } = opts;\n\n if (!socket) {\n logger.info('Invalid new socket connection!');\n return;\n }\n\n const { id } = socket;\n const client = this.clients.get(id);\n if (!client) {\n logger.info('Unknown client | id: %s', id);\n this.disconnect({ socket });\n return;\n }\n\n client.state = SocketIOClientStates.AUTHENTICATED;\n\n // The authenticate deadline is over: leaving it armed keeps a timer per client alive\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n client.authenticateTimeout = undefined;\n }\n\n this.ping({ socket, doIgnoreAuth: true });\n\n logger.info(\n 'Client connected | id: %s | identifier: %s | time: %s',\n id,\n this.identifier,\n new Date().toISOString(),\n );\n\n Promise.all(this.defaultRooms.map((room: string) => Promise.resolve(socket.join(room))))\n .then(() => {\n logger.info('Joined default rooms | id: %s | rooms: %s', id, this.defaultRooms);\n })\n .catch((error) => {\n logger.error(\n 'Failed to join default rooms | id: %s | rooms: %s | error: %s',\n id,\n this.defaultRooms,\n error,\n );\n });\n\n this.registerRoomHandlers({ socket, clientId: id });\n\n client.interval = setInterval(() => {\n this.ping({ socket, doIgnoreAuth: true });\n }, this.pingInterval);\n\n this.send({\n destination: socket.id,\n payload: {\n topic: SocketIOConstants.EVENT_AUTHENTICATED,\n data: {\n id: socket.id,\n time: new Date().toISOString(),\n },\n },\n });\n\n this.invokeHook({\n scope: 'clientConnectedFn',\n execution: () => this.onClientConnected?.({ socket }),\n });\n }\n\n /**\n * Narrows an untrusted room payload to the strings it actually contains.\n *\n * The listeners below run on data any authenticated client sends. Destructuring `{ rooms = [] }`\n * out of an `any` and testing `rooms?.length` accepts a STRING - `{\"rooms\":\"lobby\"}` has a\n * length of 5 - and the next line calls `rooms.map`, which a string does not have. socket.io\n * dispatches on `process.nextTick` with no try/catch around the handler, so that TypeError\n * escapes as an uncaught exception and takes the process with it.\n */\n private static toRoomList(payload: unknown): string[] {\n const rooms = (payload as { rooms?: unknown } | null | undefined)?.rooms;\n return Array.isArray(rooms)\n ? rooms.filter((room): room is string => typeof room === 'string')\n : [];\n }\n\n private registerRoomHandlers(opts: { socket: IOSocket; clientId: string }) {\n const { socket, clientId: id } = opts;\n\n const joinLogger = this.logger.for(SocketIOConstants.EVENT_JOIN);\n socket.on(SocketIOConstants.EVENT_JOIN, (payload: any) => {\n const rooms = SocketIOServerHelper.toRoomList(payload);\n if (!rooms.length) {\n return;\n }\n\n const validateRoomFn = this.validateRoomFn;\n if (!validateRoomFn) {\n joinLogger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no validateRoomFn configured',\n id,\n rooms,\n );\n return;\n }\n\n Promise.resolve()\n .then(() => validateRoomFn({ socket, rooms }))\n .then((allowedRooms: string[]) => {\n if (!allowedRooms?.length) {\n joinLogger.warn(\n 'Join rejected | id: %s | rooms: %j | reason: no rooms allowed',\n id,\n rooms,\n );\n return;\n }\n\n joinLogger.info('Joining rooms | id: %s | rooms: %j', id, allowedRooms);\n\n for (const room of allowedRooms) {\n 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 if (!rooms.length) {\n return;\n }\n\n leaveLogger.info('Leaving rooms | id: %s | rooms: %j', id, rooms);\n\n // `Promise.resolve` per room: socket.io declares `leave(room): Promise<void> | void` - the\n // default adapter is synchronous, a clustered one is not - and `Promise.all` over a mixed\n // iterable is what the previous `any`-typed payload was hiding.\n Promise.all(rooms.map((room) => Promise.resolve(socket.leave(room))))\n .then(() => {\n leaveLogger.info('Left rooms | id: %s | rooms: %s', id, rooms);\n })\n .catch((error) => {\n leaveLogger.error(\n 'Failed to leave rooms | id: %s | rooms: %s | error: %s',\n id,\n rooms,\n error,\n );\n });\n });\n }\n\n ping(opts: { socket: IOSocket; doIgnoreAuth: boolean }) {\n const logger = this.logger.for(this.ping.name);\n const { socket, doIgnoreAuth } = opts;\n\n if (!socket) {\n logger.info('Socket is undefined to PING!');\n return;\n }\n\n const client = this.clients.get(socket.id);\n if (!client) {\n logger.info('Client not found | socketId: %s', socket.id);\n return;\n }\n\n if (!doIgnoreAuth && client.state !== SocketIOClientStates.AUTHENTICATED) {\n logger.info('Socket client is not authenticated | state: %s', client.state);\n this.disconnect({ socket });\n return;\n }\n\n socket.emit(SocketIOConstants.EVENT_PING, { time: new Date().toISOString() });\n }\n\n disconnect(opts: { socket: IOSocket }) {\n const logger = this.logger.for(this.disconnect.name);\n const { socket } = opts;\n if (!socket) {\n return;\n }\n\n const { id } = socket;\n\n if (this.clients.has(id)) {\n const client = this.clients.get(id)!;\n\n if (client.interval) {\n clearInterval(client.interval);\n }\n\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n }\n\n this.clients.delete(id);\n }\n\n logger.info('Client disconnected | id: %s | time: %s', id, new Date().toISOString());\n socket.disconnect();\n }\n\n send(opts: {\n destination?: string;\n payload: { topic: string; data: any };\n doLog?: boolean;\n callback?: () => void;\n }) {\n const logger = this.logger.for(this.send.name);\n const { destination, payload, doLog, callback } = opts;\n\n if (!payload) {\n return;\n }\n\n const { topic, data } = payload;\n if (!topic || !data) {\n return;\n }\n\n if (!this.emitter) {\n logger.error(\n 'Cannot emit | Redis emitter is not initialized | call configure() first | topic: %s',\n topic,\n );\n return;\n }\n\n const sender = this.emitter.compress(true);\n\n if (destination && !ObjectUtility.isEmpty({ value: destination })) {\n sender.to(destination).emit(topic, data);\n } else {\n sender.emit(topic, data);\n }\n\n if (callback) {\n setImmediate(callback);\n }\n\n if (doLog) {\n logger.info(\n 'Message emitted | destination: %s | topic: %s | data: %j',\n destination ?? 'all',\n topic,\n data,\n );\n }\n }\n\n private close() {\n return new Promise<void>((resolve, reject) => {\n // configure() may never have run (or may have failed): there is nothing to close, but the redis clients still have to be released by the caller\n if (!this.io) {\n this.logger.for('close').info('SKIP close | IOServer was never initialized');\n resolve();\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: 'close',\n execution: this.io.close((error) => {\n if (error) {\n reject(error);\n return;\n }\n\n resolve();\n }),\n });\n });\n }\n\n async shutdown() {\n const logger = this.logger.for(this.shutdown.name);\n logger.info('Shutting down SocketIO server...');\n\n for (const [, client] of this.clients) {\n if (client.interval) {\n clearInterval(client.interval);\n }\n\n if (client.authenticateTimeout) {\n clearTimeout(client.authenticateTimeout);\n }\n\n client.socket.disconnect();\n }\n this.clients.clear();\n\n try {\n await this.close();\n } finally {\n // close() rejects when io.close() reports a lingering handle. Skipping the quits there leaves three live Redis sockets holding the event loop open, and a SIGTERM handler never returns.\n await Promise.all([this.redisPub?.quit(), this.redisSub?.quit(), this.redisEmitter?.quit()]);\n }\n\n logger.info('SocketIO server shutdown complete');\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/emitter/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAQ5C,OAAO,EAEL,KAAK,wBAAwB,EAG9B,MAAM,WAAW,CAAC;AAInB,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,QAAQ,CAAe;gBAEnB,IAAI,EAAE,wBAAwB;IAO1C,OAAO,CAAC,eAAe;IAWjB,SAAS;YAkBD,OAAO;IAsBf,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAWjE,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAW7D,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAY/E,SAAS,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAUhD,QAAQ;CAQf"}
1
+ {"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/emitter/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI5C,OAAO,EAEL,KAAK,wBAAwB,EAG9B,MAAM,WAAW,CAAC;AAInB,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,OAAO,CAAC,QAAQ,CAAe;gBAEnB,IAAI,EAAE,wBAAwB;IAO1C,OAAO,CAAC,eAAe;IAWjB,SAAS;YAkBD,OAAO;IAsBf,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAWjE,MAAM,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAW7D,MAAM,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAY/E,SAAS,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAUhD,QAAQ;CAQf"}
@@ -1,7 +1,7 @@
1
1
  import { HTTP } from '../../../../common/index.js';
2
2
  import { BaseHelper } from '../../../base.js';
3
3
  import { getError } from '../../../error/index.js';
4
- import { ensureRedisClientsConnecting, waitForRedisReady, } from '../../../redis/index.js';
4
+ import { RedisUtility } from '../../../redis/index.js';
5
5
  import { WebSocketChannels, WebSocketMessageTypes, } from '../common/index.js';
6
6
  const EMITTER_SERVER_ID = 'emitter';
7
7
  export class WebSocketEmitter extends BaseHelper {
@@ -25,12 +25,12 @@ export class WebSocketEmitter extends BaseHelper {
25
25
  this.redisPub.on('error', (error) => {
26
26
  logger.error('Redis pub error | error: %s', error);
27
27
  });
28
- ensureRedisClientsConnecting({
28
+ RedisUtility.ensureConnecting({
29
29
  clients: [this.redisPub],
30
30
  logger: this.logger,
31
31
  scope: this.configure.name,
32
32
  });
33
- await waitForRedisReady({ client: this.redisPub });
33
+ await RedisUtility.waitForReady({ client: this.redisPub });
34
34
  logger.info('WebSocket Emitter READY');
35
35
  }
36
36
  async publish(opts) {
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/emitter/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport {\n ensureRedisClientsConnecting,\n type TRedisClient,\n waitForRedisReady,\n} from '@/modules/redis';\nimport { type EventEmitter } from 'node:events';\nimport {\n type IRedisSocketMessage,\n type IWebSocketEmitterOptions,\n WebSocketChannels,\n WebSocketMessageTypes,\n} from '../common';\n\nconst EMITTER_SERVER_ID = 'emitter';\n\nexport class WebSocketEmitter extends BaseHelper {\n private redisPub: TRedisClient;\n\n constructor(opts: IWebSocketEmitterOptions) {\n super({ scope: opts.identifier ?? WebSocketEmitter.name });\n\n this.identifier = opts.identifier ?? WebSocketEmitter.name;\n this.initRedisClient(opts.redisConnection);\n }\n\n private initRedisClient(redisConnection: IWebSocketEmitterOptions['redisConnection']) {\n if (!redisConnection) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[WebSocketEmitter] Invalid redis connection!',\n });\n }\n\n this.redisPub = redisConnection.duplicateClient();\n }\n\n async configure() {\n const logger = this.logger.for(this.configure.name);\n logger.info('Configuring WebSocket Emitter | id: %s', this.identifier);\n\n (this.redisPub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis pub error | error: %s', error);\n });\n\n ensureRedisClientsConnecting({\n clients: [this.redisPub],\n logger: this.logger,\n scope: this.configure.name,\n });\n\n await waitForRedisReady({ client: this.redisPub });\n logger.info('WebSocket Emitter READY');\n }\n\n private async publish(opts: {\n channel: string;\n type: IRedisSocketMessage['type'];\n target?: string;\n event: string;\n data: unknown;\n exclude?: string[];\n }) {\n const { channel, type, target, event, data, exclude } = opts;\n\n const message: IRedisSocketMessage = {\n serverId: EMITTER_SERVER_ID,\n type,\n target,\n event,\n data,\n exclude,\n };\n\n await this.redisPub.publish(channel, JSON.stringify(message));\n }\n\n async toClient(opts: { clientId: string; event: string; data: unknown }) {\n const { clientId, event, data } = opts;\n await this.publish({\n channel: WebSocketChannels.forClient({ clientId }),\n type: WebSocketMessageTypes.CLIENT,\n target: clientId,\n event,\n data,\n });\n }\n\n async toUser(opts: { userId: string; event: string; data: unknown }) {\n const { userId, event, data } = opts;\n await this.publish({\n channel: WebSocketChannels.forUser({ userId }),\n type: WebSocketMessageTypes.USER,\n target: userId,\n event,\n data,\n });\n }\n\n async toRoom(opts: { room: string; event: string; data: unknown; exclude?: string[] }) {\n const { room, event, data, exclude } = opts;\n await this.publish({\n channel: WebSocketChannels.forRoom({ room }),\n type: WebSocketMessageTypes.ROOM,\n target: room,\n event,\n data,\n exclude,\n });\n }\n\n async broadcast(opts: { event: string; data: unknown }) {\n const { event, data } = opts;\n await this.publish({\n channel: WebSocketChannels.BROADCAST,\n type: WebSocketMessageTypes.BROADCAST,\n event,\n data,\n });\n }\n\n async shutdown() {\n const logger = this.logger.for(this.shutdown.name);\n logger.info('Shutting down WebSocket Emitter...');\n\n await this.redisPub?.quit();\n\n logger.info('WebSocket Emitter shutdown complete');\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/emitter/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { RedisUtility, type TRedisClient } from '@/modules/redis';\nimport { type EventEmitter } from 'node:events';\nimport {\n type IRedisSocketMessage,\n type IWebSocketEmitterOptions,\n WebSocketChannels,\n WebSocketMessageTypes,\n} from '../common';\n\nconst EMITTER_SERVER_ID = 'emitter';\n\nexport class WebSocketEmitter extends BaseHelper {\n private redisPub: TRedisClient;\n\n constructor(opts: IWebSocketEmitterOptions) {\n super({ scope: opts.identifier ?? WebSocketEmitter.name });\n\n this.identifier = opts.identifier ?? WebSocketEmitter.name;\n this.initRedisClient(opts.redisConnection);\n }\n\n private initRedisClient(redisConnection: IWebSocketEmitterOptions['redisConnection']) {\n if (!redisConnection) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[WebSocketEmitter] Invalid redis connection!',\n });\n }\n\n this.redisPub = redisConnection.duplicateClient();\n }\n\n async configure() {\n const logger = this.logger.for(this.configure.name);\n logger.info('Configuring WebSocket Emitter | id: %s', this.identifier);\n\n (this.redisPub as EventEmitter).on('error', (error: Error) => {\n logger.error('Redis pub error | error: %s', error);\n });\n\n RedisUtility.ensureConnecting({\n clients: [this.redisPub],\n logger: this.logger,\n scope: this.configure.name,\n });\n\n await RedisUtility.waitForReady({ client: this.redisPub });\n logger.info('WebSocket Emitter READY');\n }\n\n private async publish(opts: {\n channel: string;\n type: IRedisSocketMessage['type'];\n target?: string;\n event: string;\n data: unknown;\n exclude?: string[];\n }) {\n const { channel, type, target, event, data, exclude } = opts;\n\n const message: IRedisSocketMessage = {\n serverId: EMITTER_SERVER_ID,\n type,\n target,\n event,\n data,\n exclude,\n };\n\n await this.redisPub.publish(channel, JSON.stringify(message));\n }\n\n async toClient(opts: { clientId: string; event: string; data: unknown }) {\n const { clientId, event, data } = opts;\n await this.publish({\n channel: WebSocketChannels.forClient({ clientId }),\n type: WebSocketMessageTypes.CLIENT,\n target: clientId,\n event,\n data,\n });\n }\n\n async toUser(opts: { userId: string; event: string; data: unknown }) {\n const { userId, event, data } = opts;\n await this.publish({\n channel: WebSocketChannels.forUser({ userId }),\n type: WebSocketMessageTypes.USER,\n target: userId,\n event,\n data,\n });\n }\n\n async toRoom(opts: { room: string; event: string; data: unknown; exclude?: string[] }) {\n const { room, event, data, exclude } = opts;\n await this.publish({\n channel: WebSocketChannels.forRoom({ room }),\n type: WebSocketMessageTypes.ROOM,\n target: room,\n event,\n data,\n exclude,\n });\n }\n\n async broadcast(opts: { event: string; data: unknown }) {\n const { event, data } = opts;\n await this.publish({\n channel: WebSocketChannels.BROADCAST,\n type: WebSocketMessageTypes.BROADCAST,\n event,\n data,\n });\n }\n\n async shutdown() {\n const logger = this.logger.for(this.shutdown.name);\n logger.info('Shutting down WebSocket Emitter...');\n\n await this.redisPub?.quit();\n\n logger.info('WebSocket Emitter shutdown complete');\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EAErB,KAAK,6BAA6B,EAGnC,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,+BAA+B,CAC9C,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEtE,MAAM,EAAE,UAAU,CAAC;IACnB,2GAA2G;IAC3G,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;IACrD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChC,mBAAmB,CAAC,EAAE,6BAA6B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC3E,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,6GAA6G;AAC7G,qBAAa,uBAAuB,CAClC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACtE,SAAQ,UAAU;IAClB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,mBAAmB,CAAC,CAAuD;IACnF,OAAO,CAAC,mBAAmB,CAAS;gBAExB,IAAI,EAAE,+BAA+B,CAAC,YAAY,CAAC;IAW/D,YAAY,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;YAiCxE,iBAAiB;IAuB/B,OAAO,CAAC,eAAe;IA8BvB,UAAU,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAYjE,OAAO,CAAC,mBAAmB;IA2C3B,UAAU,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAoCnF,OAAO,CAAC,kBAAkB;IAiB1B,SAAS,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAiCrE"}
1
+ {"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EACL,KAAK,UAAU,EACf,KAAK,gBAAgB,EAErB,KAAK,6BAA6B,EAGnC,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,+BAA+B,CAC9C,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEtE,MAAM,EAAE,UAAU,CAAC;IACnB,2GAA2G;IAC3G,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;IACrD,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAChC,mBAAmB,CAAC,EAAE,6BAA6B,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAC3E,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,6GAA6G;AAC7G,qBAAa,uBAAuB,CAClC,YAAY,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CACtE,SAAQ,UAAU;IAClB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,OAAO,CAA8C;IAC7D,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,mBAAmB,CAAC,CAAuD;IACnF,OAAO,CAAC,mBAAmB,CAAS;gBAExB,IAAI,EAAE,+BAA+B,CAAC,YAAY,CAAC;IAW/D,YAAY,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;YAiCxE,iBAAiB;IAuB/B,OAAO,CAAC,eAAe;IA8BvB,UAAU,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE;IAYjE,OAAO,CAAC,mBAAmB;IA2C3B,UAAU,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAoCnF,OAAO,CAAC,kBAAkB;IAiB1B,SAAS,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAiCrE"}
@@ -1,6 +1,5 @@
1
1
  import { BaseHelper } from '../../../base.js';
2
- import { executePromiseWithLimit } from '../../../../utilities/index.js';
3
- import { voidExecution } from '../../../../utilities/promise.utility.js';
2
+ import { PromiseUtility } from '../../../../utilities/index.js';
4
3
  import { WebSocketClientStates, WebSocketDefaults, } from '../common/index.js';
5
4
  /** Local delivery and fan-out for the WebSocket server: single client, per-user, per-room, and broadcast. */
6
5
  export class WebSocketDeliveryHelper extends BaseHelper {
@@ -148,10 +147,10 @@ export class WebSocketDeliveryHelper extends BaseHelper {
148
147
  tasks.push(() => this.sendToClientAsync({ clientId, event, data }));
149
148
  }
150
149
  if (tasks.length) {
151
- voidExecution({
150
+ PromiseUtility.voidExecution({
152
151
  logger: this.logger,
153
152
  scope: this.sendToRoom.name,
154
- execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),
153
+ execution: PromiseUtility.executeWithLimit({ tasks, limit: this.encryptedBatchLimit }),
155
154
  });
156
155
  }
157
156
  }
@@ -191,10 +190,10 @@ export class WebSocketDeliveryHelper extends BaseHelper {
191
190
  tasks.push(() => this.sendToClientAsync({ clientId, event, data }));
192
191
  }
193
192
  if (tasks.length) {
194
- voidExecution({
193
+ PromiseUtility.voidExecution({
195
194
  logger: this.logger,
196
195
  scope: this.broadcast.name,
197
- execution: executePromiseWithLimit({ tasks, limit: this.encryptedBatchLimit }),
196
+ execution: PromiseUtility.executeWithLimit({ tasks, limit: this.encryptedBatchLimit }),
198
197
  });
199
198
  }
200
199
  }