@venizia/ignis-helpers 0.4.7 → 0.4.8-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 (678) hide show
  1. package/README.md +2 -2
  2. package/dist/esm/common/constants/app.d.ts +15 -0
  3. package/dist/esm/common/constants/app.js +14 -0
  4. package/dist/esm/common/constants/app.js.map +1 -1
  5. package/dist/esm/common/constants/duration.d.ts +2 -0
  6. package/dist/esm/common/constants/duration.js.map +1 -1
  7. package/dist/esm/common/constants/grpc.d.ts +3 -0
  8. package/dist/esm/common/constants/grpc.js +1 -0
  9. package/dist/esm/common/constants/grpc.js.map +1 -1
  10. package/dist/esm/common/constants/http.d.ts +4 -0
  11. package/dist/esm/common/constants/http.js +1 -0
  12. package/dist/esm/common/constants/http.js.map +1 -1
  13. package/dist/esm/common/constants/mime.d.ts +4 -0
  14. package/dist/esm/common/constants/mime.js +1 -0
  15. package/dist/esm/common/constants/mime.js.map +1 -1
  16. package/dist/esm/common/redact.d.ts +2 -0
  17. package/dist/esm/common/redact.js +2 -0
  18. package/dist/esm/common/redact.js.map +1 -1
  19. package/dist/esm/common/resolvers.d.ts +1 -0
  20. package/dist/esm/common/resolvers.js +1 -0
  21. package/dist/esm/common/resolvers.js.map +1 -1
  22. package/dist/esm/common/types/class.d.ts +6 -0
  23. package/dist/esm/common/types/class.js.map +1 -1
  24. package/dist/esm/common/types/const-value.d.ts +3 -0
  25. package/dist/esm/common/types/const-value.js.map +1 -1
  26. package/dist/esm/common/types/field-mapping.d.ts +3 -0
  27. package/dist/esm/common/types/field-mapping.js.map +1 -1
  28. package/dist/esm/common/types/injection.d.ts +2 -0
  29. package/dist/esm/common/types/injection.js.map +1 -1
  30. package/dist/esm/common/types/utility.d.ts +9 -0
  31. package/dist/esm/common/types/utility.js.map +1 -1
  32. package/dist/esm/modules/base.d.ts +1 -0
  33. package/dist/esm/modules/base.js +1 -0
  34. package/dist/esm/modules/base.js.map +1 -1
  35. package/dist/esm/modules/cron/helper.d.ts +7 -0
  36. package/dist/esm/modules/cron/helper.js +1 -0
  37. package/dist/esm/modules/cron/helper.js.map +1 -1
  38. package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts +2 -0
  39. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  40. package/dist/esm/modules/crypto/algorithms/aes.engine.js.map +1 -1
  41. package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts +1 -0
  42. package/dist/esm/modules/crypto/algorithms/base.algorithm.js +1 -0
  43. package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
  44. package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts +12 -4
  45. package/dist/esm/modules/crypto/algorithms/credential.algorithm.js +4 -4
  46. package/dist/esm/modules/crypto/algorithms/credential.algorithm.js.map +1 -1
  47. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts +3 -0
  48. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.js.map +1 -1
  49. package/dist/esm/modules/crypto/algorithms/hash.algorithm.js.map +1 -1
  50. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts +1 -0
  51. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.js.map +1 -1
  52. package/dist/esm/modules/crypto/common/constants.d.ts +12 -1
  53. package/dist/esm/modules/crypto/common/constants.js +9 -1
  54. package/dist/esm/modules/crypto/common/constants.js.map +1 -1
  55. package/dist/esm/modules/crypto/common/types.d.ts +1 -0
  56. package/dist/esm/modules/crypto/common/types.js.map +1 -1
  57. package/dist/esm/modules/env/app-env.d.ts +3 -0
  58. package/dist/esm/modules/env/app-env.js +3 -0
  59. package/dist/esm/modules/env/app-env.js.map +1 -1
  60. package/dist/esm/modules/env/common/types.d.ts +1 -0
  61. package/dist/esm/modules/env/common/types.js.map +1 -1
  62. package/dist/esm/modules/logger/base/base.js.map +1 -1
  63. package/dist/esm/modules/logger/base/console.js.map +1 -1
  64. package/dist/esm/modules/logger/common/constants.d.ts +3 -0
  65. package/dist/esm/modules/logger/common/constants.js +2 -0
  66. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  67. package/dist/esm/modules/logger/common/debug-gate.js.map +1 -1
  68. package/dist/esm/modules/logger/common/types.d.ts +2 -0
  69. package/dist/esm/modules/logger/common/types.js +1 -0
  70. package/dist/esm/modules/logger/common/types.js.map +1 -1
  71. package/dist/esm/modules/logger/factory.js.map +1 -1
  72. package/dist/esm/modules/logger/formatting/deep-splat.d.ts +1 -0
  73. package/dist/esm/modules/logger/formatting/deep-splat.js +1 -0
  74. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  75. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  76. package/dist/esm/modules/logger/hf/common/types.d.ts +7 -2
  77. package/dist/esm/modules/logger/hf/common/types.js.map +1 -1
  78. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  79. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  80. package/dist/esm/modules/logger/hf/ring.js.map +1 -1
  81. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  82. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  83. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  84. package/dist/esm/modules/logger/winston/common/types.d.ts +31 -3
  85. package/dist/esm/modules/logger/winston/common/types.js.map +1 -1
  86. package/dist/esm/modules/logger/winston/define.d.ts +1 -0
  87. package/dist/esm/modules/logger/winston/define.js +1 -0
  88. package/dist/esm/modules/logger/winston/define.js.map +1 -1
  89. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  90. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  91. package/dist/esm/modules/logger/winston/logger.d.ts +1 -0
  92. package/dist/esm/modules/logger/winston/logger.js +1 -0
  93. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  94. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -0
  95. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -0
  96. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  97. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts +1 -0
  98. package/dist/esm/modules/network/http-request/base-network-request.helper.js +1 -0
  99. package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
  100. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +8 -8
  101. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +2 -0
  102. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  103. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +2 -0
  104. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  105. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +5 -1
  106. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +2 -0
  107. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  108. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts +11 -0
  109. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -0
  110. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  111. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts +3 -0
  112. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +1 -0
  113. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  114. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts +1 -0
  115. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js +1 -0
  116. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js.map +1 -1
  117. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts +1 -0
  118. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js +1 -0
  119. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js.map +1 -1
  120. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts +1 -0
  121. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js +1 -0
  122. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js.map +1 -1
  123. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts +1 -0
  124. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js +1 -0
  125. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js.map +1 -1
  126. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts +4 -0
  127. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +4 -0
  128. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  129. package/dist/esm/modules/network/utilities/query-string.d.ts +13 -2
  130. package/dist/esm/modules/network/utilities/query-string.js +2 -1
  131. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  132. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +2 -1
  133. package/dist/esm/modules/network/utilities/url-safety/common/constants.js +1 -1
  134. package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
  135. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts +18 -5
  136. package/dist/esm/modules/network/utilities/url-safety/common/types.js.map +1 -1
  137. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  138. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  139. package/dist/esm/modules/pool/abstract.js.map +1 -1
  140. package/dist/esm/modules/pool/common/types.d.ts +5 -1
  141. package/dist/esm/modules/pool/common/types.js.map +1 -1
  142. package/dist/esm/modules/queue/bullmq/helper.d.ts +13 -0
  143. package/dist/esm/modules/queue/bullmq/helper.js +4 -0
  144. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  145. package/dist/esm/modules/queue/common/hook.d.ts +1 -0
  146. package/dist/esm/modules/queue/common/hook.js +1 -0
  147. package/dist/esm/modules/queue/common/hook.js.map +1 -1
  148. package/dist/esm/modules/queue/internal/hf/helper.js.map +1 -1
  149. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts +8 -0
  150. package/dist/esm/modules/queue/internal/sequential/common/types.js +1 -0
  151. package/dist/esm/modules/queue/internal/sequential/common/types.js.map +1 -1
  152. package/dist/esm/modules/queue/internal/sequential/helper.d.ts +4 -0
  153. package/dist/esm/modules/queue/internal/sequential/helper.js +4 -0
  154. package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
  155. package/dist/esm/modules/queue/kafka/base.d.ts +5 -0
  156. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  157. package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts +3 -0
  158. package/dist/esm/modules/queue/kafka/bundler/common/constants.js +3 -0
  159. package/dist/esm/modules/queue/kafka/bundler/common/constants.js.map +1 -1
  160. package/dist/esm/modules/queue/kafka/common/constants.d.ts +8 -0
  161. package/dist/esm/modules/queue/kafka/common/constants.js +5 -0
  162. package/dist/esm/modules/queue/kafka/common/constants.js.map +1 -1
  163. package/dist/esm/modules/queue/kafka/common/types/admin.d.ts +1 -0
  164. package/dist/esm/modules/queue/kafka/common/types/admin.js.map +1 -1
  165. package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts +12 -0
  166. package/dist/esm/modules/queue/kafka/common/types/callbacks.js.map +1 -1
  167. package/dist/esm/modules/queue/kafka/common/types/connection.d.ts +2 -0
  168. package/dist/esm/modules/queue/kafka/common/types/connection.js.map +1 -1
  169. package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts +62 -0
  170. package/dist/esm/modules/queue/kafka/common/types/consumer.js.map +1 -1
  171. package/dist/esm/modules/queue/kafka/common/types/producer.d.ts +1 -0
  172. package/dist/esm/modules/queue/kafka/common/types/producer.js.map +1 -1
  173. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  174. package/dist/esm/modules/queue/mqtt/helper.d.ts +2 -0
  175. package/dist/esm/modules/queue/mqtt/helper.js +1 -0
  176. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  177. package/dist/esm/modules/redis/base/abstract.helper.d.ts +2 -0
  178. package/dist/esm/modules/redis/base/abstract.helper.js +2 -0
  179. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  180. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -0
  181. package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -0
  182. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  183. package/dist/esm/modules/redis/common/constants.d.ts +4 -0
  184. package/dist/esm/modules/redis/common/constants.js +2 -0
  185. package/dist/esm/modules/redis/common/constants.js.map +1 -1
  186. package/dist/esm/modules/redis/common/interfaces.d.ts +12 -0
  187. package/dist/esm/modules/redis/common/interfaces.js.map +1 -1
  188. package/dist/esm/modules/redis/common/types.d.ts +21 -1
  189. package/dist/esm/modules/redis/common/types.js.map +1 -1
  190. package/dist/esm/modules/redis/factory.d.ts +2 -0
  191. package/dist/esm/modules/redis/factory.js +1 -0
  192. package/dist/esm/modules/redis/factory.js.map +1 -1
  193. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -0
  194. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -0
  195. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  196. package/dist/esm/modules/redis/single/single.helper.d.ts +1 -0
  197. package/dist/esm/modules/redis/single/single.helper.js +1 -0
  198. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  199. package/dist/esm/modules/redis/utility.d.ts +1 -0
  200. package/dist/esm/modules/redis/utility.js +1 -0
  201. package/dist/esm/modules/redis/utility.js.map +1 -1
  202. package/dist/esm/modules/retry/common/constants.d.ts +4 -0
  203. package/dist/esm/modules/retry/common/constants.js +2 -0
  204. package/dist/esm/modules/retry/common/constants.js.map +1 -1
  205. package/dist/esm/modules/retry/common/types.d.ts +19 -5
  206. package/dist/esm/modules/retry/common/types.js.map +1 -1
  207. package/dist/esm/modules/retry/helper.d.ts +4 -4
  208. package/dist/esm/modules/retry/helper.js.map +1 -1
  209. package/dist/esm/modules/secrets/base/abstract.helper.d.ts +1 -0
  210. package/dist/esm/modules/secrets/base/abstract.helper.js +1 -0
  211. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  212. package/dist/esm/modules/secrets/common/constants.d.ts +4 -0
  213. package/dist/esm/modules/secrets/common/constants.js +2 -0
  214. package/dist/esm/modules/secrets/common/constants.js.map +1 -1
  215. package/dist/esm/modules/secrets/common/types/helper.d.ts +13 -0
  216. package/dist/esm/modules/secrets/common/types/helper.js.map +1 -1
  217. package/dist/esm/modules/secrets/common/types/lease.d.ts +2 -0
  218. package/dist/esm/modules/secrets/common/types/lease.js.map +1 -1
  219. package/dist/esm/modules/secrets/common/types/registration.d.ts +13 -2
  220. package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
  221. package/dist/esm/modules/secrets/common/types/timer.d.ts +1 -0
  222. package/dist/esm/modules/secrets/common/types/timer.js.map +1 -1
  223. package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts +8 -0
  224. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -0
  225. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  226. package/dist/esm/modules/secrets/factory.d.ts +1 -0
  227. package/dist/esm/modules/secrets/factory.js +1 -0
  228. package/dist/esm/modules/secrets/factory.js.map +1 -1
  229. package/dist/esm/modules/secrets/hashicorp/auth.d.ts +2 -0
  230. package/dist/esm/modules/secrets/hashicorp/auth.js +1 -0
  231. package/dist/esm/modules/secrets/hashicorp/auth.js.map +1 -1
  232. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +2 -0
  233. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +1 -0
  234. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  235. package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts +1 -0
  236. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js +1 -0
  237. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js.map +1 -1
  238. package/dist/esm/modules/slug/common/constants.d.ts +1 -0
  239. package/dist/esm/modules/slug/common/constants.js +1 -0
  240. package/dist/esm/modules/slug/common/constants.js.map +1 -1
  241. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -1
  242. package/dist/esm/modules/socket/socket-io/common/constants.d.ts +2 -0
  243. package/dist/esm/modules/socket/socket-io/common/constants.js +2 -0
  244. package/dist/esm/modules/socket/socket-io/common/constants.js.map +1 -1
  245. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts +5 -0
  246. package/dist/esm/modules/socket/socket-io/common/types/client.js.map +1 -1
  247. package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts +4 -0
  248. package/dist/esm/modules/socket/socket-io/common/types/hooks.js.map +1 -1
  249. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts +6 -0
  250. package/dist/esm/modules/socket/socket-io/common/types/server.js.map +1 -1
  251. package/dist/esm/modules/socket/socket-io/server/helper.d.ts +1 -0
  252. package/dist/esm/modules/socket/socket-io/server/helper.js +1 -0
  253. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  254. package/dist/esm/modules/socket/websocket/common/constants.d.ts +7 -0
  255. package/dist/esm/modules/socket/websocket/common/constants.js +5 -0
  256. package/dist/esm/modules/socket/websocket/common/constants.js.map +1 -1
  257. package/dist/esm/modules/socket/websocket/common/types/client.d.ts +4 -0
  258. package/dist/esm/modules/socket/websocket/common/types/client.js.map +1 -1
  259. package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts +7 -0
  260. package/dist/esm/modules/socket/websocket/common/types/hooks.js.map +1 -1
  261. package/dist/esm/modules/socket/websocket/common/types/server.d.ts +30 -0
  262. package/dist/esm/modules/socket/websocket/common/types/server.js.map +1 -1
  263. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts +1 -0
  264. package/dist/esm/modules/socket/websocket/emitter/helper.js +1 -0
  265. package/dist/esm/modules/socket/websocket/emitter/helper.js.map +1 -1
  266. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  267. package/dist/esm/modules/socket/websocket/server/helper.d.ts +1 -0
  268. package/dist/esm/modules/socket/websocket/server/helper.js +1 -0
  269. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  270. package/dist/esm/modules/storage/base.d.ts +6 -1
  271. package/dist/esm/modules/storage/base.js +1 -0
  272. package/dist/esm/modules/storage/base.js.map +1 -1
  273. package/dist/esm/modules/storage/bun-s3/helper.d.ts +9 -1
  274. package/dist/esm/modules/storage/bun-s3/helper.js +2 -1
  275. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  276. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  277. package/dist/esm/modules/storage/common/constants.d.ts +1 -0
  278. package/dist/esm/modules/storage/common/constants.js.map +1 -1
  279. package/dist/esm/modules/storage/common/types.d.ts +17 -1
  280. package/dist/esm/modules/storage/common/types.js.map +1 -1
  281. package/dist/esm/modules/storage/common/utility.d.ts +1 -0
  282. package/dist/esm/modules/storage/common/utility.js +1 -0
  283. package/dist/esm/modules/storage/common/utility.js.map +1 -1
  284. package/dist/esm/modules/storage/disk/helper.d.ts +2 -0
  285. package/dist/esm/modules/storage/disk/helper.js +1 -0
  286. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  287. package/dist/esm/modules/temporal/abstract.d.ts +5 -0
  288. package/dist/esm/modules/temporal/abstract.js +2 -1
  289. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  290. package/dist/esm/modules/temporal/adapters/dayjs.js.map +1 -1
  291. package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
  292. package/dist/esm/modules/temporal/adapters/luxon.js.map +1 -1
  293. package/dist/esm/modules/temporal/adapters/native.js.map +1 -1
  294. package/dist/esm/modules/temporal/calendar/calendar.js.map +1 -1
  295. package/dist/esm/modules/temporal/common/constants.d.ts +3 -0
  296. package/dist/esm/modules/temporal/common/constants.js.map +1 -1
  297. package/dist/esm/modules/temporal/common/types.js.map +1 -1
  298. package/dist/esm/modules/temporal/duration/duration.js.map +1 -1
  299. package/dist/esm/modules/temporal/helper.js.map +1 -1
  300. package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
  301. package/dist/esm/modules/temporal/pattern/pattern.js.map +1 -1
  302. package/dist/esm/modules/temporal/pattern/tokens.js.map +1 -1
  303. package/dist/esm/modules/tree/builder.js.map +1 -1
  304. package/dist/esm/modules/tree/common/types.d.ts +6 -0
  305. package/dist/esm/modules/tree/common/types.js.map +1 -1
  306. package/dist/esm/modules/uid/common/constants.d.ts +1 -0
  307. package/dist/esm/modules/uid/common/constants.js.map +1 -1
  308. package/dist/esm/modules/uid/common/types.d.ts +28 -7
  309. package/dist/esm/modules/uid/common/types.js.map +1 -1
  310. package/dist/esm/modules/uid/helper.d.ts +12 -0
  311. package/dist/esm/modules/uid/helper.js.map +1 -1
  312. package/dist/esm/modules/uid/opaque.js.map +1 -1
  313. package/dist/esm/modules/uid/uuid/helper.js.map +1 -1
  314. package/dist/esm/modules/uid/uuid/sha1.js.map +1 -1
  315. package/dist/esm/modules/uid/uuid/v4.d.ts +1 -0
  316. package/dist/esm/modules/uid/uuid/v4.js +1 -0
  317. package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
  318. package/dist/esm/modules/uid/uuid/v5.d.ts +1 -0
  319. package/dist/esm/modules/uid/uuid/v5.js +1 -0
  320. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  321. package/dist/esm/modules/uid/uuid/v7.d.ts +1 -0
  322. package/dist/esm/modules/uid/uuid/v7.js +1 -0
  323. package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
  324. package/dist/esm/modules/worker-thread/bus/abstract.d.ts +1 -0
  325. package/dist/esm/modules/worker-thread/bus/abstract.js +1 -0
  326. package/dist/esm/modules/worker-thread/bus/abstract.js.map +1 -1
  327. package/dist/esm/modules/worker-thread/bus/base.d.ts +1 -0
  328. package/dist/esm/modules/worker-thread/bus/base.js +1 -0
  329. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  330. package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts +1 -0
  331. package/dist/esm/modules/worker-thread/bus/handler/abstract.js +1 -0
  332. package/dist/esm/modules/worker-thread/bus/handler/abstract.js.map +1 -1
  333. package/dist/esm/modules/worker-thread/bus/handler/base.d.ts +1 -0
  334. package/dist/esm/modules/worker-thread/bus/handler/base.js +1 -0
  335. package/dist/esm/modules/worker-thread/bus/handler/base.js.map +1 -1
  336. package/dist/esm/modules/worker-thread/common/types.d.ts +4 -0
  337. package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
  338. package/dist/esm/modules/worker-thread/thread/abstract.d.ts +1 -0
  339. package/dist/esm/modules/worker-thread/thread/abstract.js +1 -0
  340. package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
  341. package/dist/esm/modules/worker-thread/thread/base.d.ts +1 -0
  342. package/dist/esm/modules/worker-thread/thread/base.js +1 -0
  343. package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
  344. package/dist/esm/modules/worker-thread/worker/abstract.d.ts +1 -0
  345. package/dist/esm/modules/worker-thread/worker/abstract.js +1 -0
  346. package/dist/esm/modules/worker-thread/worker/abstract.js.map +1 -1
  347. package/dist/esm/modules/worker-thread/worker/base.d.ts +1 -0
  348. package/dist/esm/modules/worker-thread/worker/base.js +1 -0
  349. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  350. package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -0
  351. package/dist/esm/modules/worker-thread/worker-pool.js +1 -0
  352. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  353. package/dist/esm/utilities/error.utility.d.ts +1 -0
  354. package/dist/esm/utilities/error.utility.js +1 -0
  355. package/dist/esm/utilities/error.utility.js.map +1 -1
  356. package/dist/esm/utilities/form-body.utility.d.ts +1 -0
  357. package/dist/esm/utilities/form-body.utility.js +1 -0
  358. package/dist/esm/utilities/form-body.utility.js.map +1 -1
  359. package/dist/esm/utilities/hr-time.utility.d.ts +1 -0
  360. package/dist/esm/utilities/hr-time.utility.js +1 -0
  361. package/dist/esm/utilities/hr-time.utility.js.map +1 -1
  362. package/dist/esm/utilities/module.utility.js.map +1 -1
  363. package/dist/esm/utilities/parse.utility.js.map +1 -1
  364. package/dist/esm/utilities/performance.utility.d.ts +1 -0
  365. package/dist/esm/utilities/performance.utility.js +1 -0
  366. package/dist/esm/utilities/performance.utility.js.map +1 -1
  367. package/dist/esm/utilities/promise.utility.d.ts +1 -0
  368. package/dist/esm/utilities/promise.utility.js.map +1 -1
  369. package/dist/esm/utilities/request.utility.d.ts +2 -0
  370. package/dist/esm/utilities/request.utility.js +1 -0
  371. package/dist/esm/utilities/request.utility.js.map +1 -1
  372. package/package.json +4 -4
  373. package/dist/esm/common/constants/app.d.ts.map +0 -1
  374. package/dist/esm/common/constants/duration.d.ts.map +0 -1
  375. package/dist/esm/common/constants/grpc.d.ts.map +0 -1
  376. package/dist/esm/common/constants/http.d.ts.map +0 -1
  377. package/dist/esm/common/constants/index.d.ts.map +0 -1
  378. package/dist/esm/common/constants/mime.d.ts.map +0 -1
  379. package/dist/esm/common/index.d.ts.map +0 -1
  380. package/dist/esm/common/jsx.d.ts.map +0 -1
  381. package/dist/esm/common/redact.d.ts.map +0 -1
  382. package/dist/esm/common/resolvers.d.ts.map +0 -1
  383. package/dist/esm/common/types/class.d.ts.map +0 -1
  384. package/dist/esm/common/types/const-value.d.ts.map +0 -1
  385. package/dist/esm/common/types/field-mapping.d.ts.map +0 -1
  386. package/dist/esm/common/types/index.d.ts.map +0 -1
  387. package/dist/esm/common/types/injection.d.ts.map +0 -1
  388. package/dist/esm/common/types/resolver.d.ts.map +0 -1
  389. package/dist/esm/common/types/utility.d.ts.map +0 -1
  390. package/dist/esm/core.d.ts.map +0 -1
  391. package/dist/esm/index.d.ts.map +0 -1
  392. package/dist/esm/modules/base.d.ts.map +0 -1
  393. package/dist/esm/modules/cron/helper.d.ts.map +0 -1
  394. package/dist/esm/modules/cron/index.d.ts.map +0 -1
  395. package/dist/esm/modules/crypto/algorithms/abstract.algorithm.d.ts.map +0 -1
  396. package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts.map +0 -1
  397. package/dist/esm/modules/crypto/algorithms/aes.constants.d.ts.map +0 -1
  398. package/dist/esm/modules/crypto/algorithms/aes.engine.d.ts.map +0 -1
  399. package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts.map +0 -1
  400. package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts.map +0 -1
  401. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts.map +0 -1
  402. package/dist/esm/modules/crypto/algorithms/hash.algorithm.d.ts.map +0 -1
  403. package/dist/esm/modules/crypto/algorithms/index.d.ts.map +0 -1
  404. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts.map +0 -1
  405. package/dist/esm/modules/crypto/common/constants.d.ts.map +0 -1
  406. package/dist/esm/modules/crypto/common/index.d.ts.map +0 -1
  407. package/dist/esm/modules/crypto/common/types.d.ts.map +0 -1
  408. package/dist/esm/modules/crypto/index.d.ts.map +0 -1
  409. package/dist/esm/modules/env/app-env.d.ts.map +0 -1
  410. package/dist/esm/modules/env/common/index.d.ts.map +0 -1
  411. package/dist/esm/modules/env/common/types.d.ts.map +0 -1
  412. package/dist/esm/modules/env/index.d.ts.map +0 -1
  413. package/dist/esm/modules/env/names.d.ts.map +0 -1
  414. package/dist/esm/modules/error/index.d.ts.map +0 -1
  415. package/dist/esm/modules/index.d.ts.map +0 -1
  416. package/dist/esm/modules/logger/base/abstract.d.ts.map +0 -1
  417. package/dist/esm/modules/logger/base/base.d.ts.map +0 -1
  418. package/dist/esm/modules/logger/base/console.d.ts.map +0 -1
  419. package/dist/esm/modules/logger/base/index.d.ts.map +0 -1
  420. package/dist/esm/modules/logger/common/constants.d.ts.map +0 -1
  421. package/dist/esm/modules/logger/common/debug-gate.d.ts.map +0 -1
  422. package/dist/esm/modules/logger/common/index.d.ts.map +0 -1
  423. package/dist/esm/modules/logger/common/types.d.ts.map +0 -1
  424. package/dist/esm/modules/logger/factory.d.ts.map +0 -1
  425. package/dist/esm/modules/logger/formatting/deep-splat.d.ts.map +0 -1
  426. package/dist/esm/modules/logger/formatting/error-prettier.d.ts.map +0 -1
  427. package/dist/esm/modules/logger/formatting/index.d.ts.map +0 -1
  428. package/dist/esm/modules/logger/hf/common/constants.d.ts.map +0 -1
  429. package/dist/esm/modules/logger/hf/common/index.d.ts.map +0 -1
  430. package/dist/esm/modules/logger/hf/common/types.d.ts.map +0 -1
  431. package/dist/esm/modules/logger/hf/flusher.d.ts.map +0 -1
  432. package/dist/esm/modules/logger/hf/index.d.ts.map +0 -1
  433. package/dist/esm/modules/logger/hf/logger.d.ts.map +0 -1
  434. package/dist/esm/modules/logger/hf/ring.d.ts.map +0 -1
  435. package/dist/esm/modules/logger/index.d.ts.map +0 -1
  436. package/dist/esm/modules/logger/pino/backing.d.ts.map +0 -1
  437. package/dist/esm/modules/logger/pino/common/constants.d.ts.map +0 -1
  438. package/dist/esm/modules/logger/pino/common/index.d.ts.map +0 -1
  439. package/dist/esm/modules/logger/pino/common/types.d.ts.map +0 -1
  440. package/dist/esm/modules/logger/pino/destination.d.ts.map +0 -1
  441. package/dist/esm/modules/logger/pino/index.d.ts.map +0 -1
  442. package/dist/esm/modules/logger/pino/logger.d.ts.map +0 -1
  443. package/dist/esm/modules/logger/winston/common/constants.d.ts.map +0 -1
  444. package/dist/esm/modules/logger/winston/common/index.d.ts.map +0 -1
  445. package/dist/esm/modules/logger/winston/common/types.d.ts.map +0 -1
  446. package/dist/esm/modules/logger/winston/define.d.ts.map +0 -1
  447. package/dist/esm/modules/logger/winston/formats.d.ts.map +0 -1
  448. package/dist/esm/modules/logger/winston/index.d.ts.map +0 -1
  449. package/dist/esm/modules/logger/winston/logger-factory.d.ts.map +0 -1
  450. package/dist/esm/modules/logger/winston/logger.d.ts.map +0 -1
  451. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts.map +0 -1
  452. package/dist/esm/modules/logger/winston/transports/index.d.ts.map +0 -1
  453. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts.map +0 -1
  454. package/dist/esm/modules/network/http-request/common/constants.d.ts.map +0 -1
  455. package/dist/esm/modules/network/http-request/common/index.d.ts.map +0 -1
  456. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts.map +0 -1
  457. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +0 -1
  458. package/dist/esm/modules/network/http-request/fetcher/common/index.d.ts.map +0 -1
  459. package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts.map +0 -1
  460. package/dist/esm/modules/network/http-request/fetcher/index.d.ts.map +0 -1
  461. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +0 -1
  462. package/dist/esm/modules/network/http-request/index.d.ts.map +0 -1
  463. package/dist/esm/modules/network/index.d.ts.map +0 -1
  464. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts.map +0 -1
  465. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +0 -1
  466. package/dist/esm/modules/network/tcp-socket/index.d.ts.map +0 -1
  467. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts.map +0 -1
  468. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts.map +0 -1
  469. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts.map +0 -1
  470. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts.map +0 -1
  471. package/dist/esm/modules/network/udp-socket/index.d.ts.map +0 -1
  472. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts.map +0 -1
  473. package/dist/esm/modules/network/utilities/index.d.ts.map +0 -1
  474. package/dist/esm/modules/network/utilities/query-string.d.ts.map +0 -1
  475. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts.map +0 -1
  476. package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts.map +0 -1
  477. package/dist/esm/modules/network/utilities/url-safety/common/index.d.ts.map +0 -1
  478. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts.map +0 -1
  479. package/dist/esm/modules/network/utilities/url-safety/index.d.ts.map +0 -1
  480. package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts.map +0 -1
  481. package/dist/esm/modules/network/utilities/url-safety/policy.d.ts.map +0 -1
  482. package/dist/esm/modules/pool/abstract.d.ts.map +0 -1
  483. package/dist/esm/modules/pool/base.d.ts.map +0 -1
  484. package/dist/esm/modules/pool/common/index.d.ts.map +0 -1
  485. package/dist/esm/modules/pool/common/types.d.ts.map +0 -1
  486. package/dist/esm/modules/pool/index.d.ts.map +0 -1
  487. package/dist/esm/modules/queue/bullmq/helper.d.ts.map +0 -1
  488. package/dist/esm/modules/queue/bullmq/index.d.ts.map +0 -1
  489. package/dist/esm/modules/queue/common/constants.d.ts.map +0 -1
  490. package/dist/esm/modules/queue/common/hook.d.ts.map +0 -1
  491. package/dist/esm/modules/queue/common/index.d.ts.map +0 -1
  492. package/dist/esm/modules/queue/index.d.ts.map +0 -1
  493. package/dist/esm/modules/queue/internal/hf/common/index.d.ts.map +0 -1
  494. package/dist/esm/modules/queue/internal/hf/common/types.d.ts.map +0 -1
  495. package/dist/esm/modules/queue/internal/hf/helper.d.ts.map +0 -1
  496. package/dist/esm/modules/queue/internal/hf/index.d.ts.map +0 -1
  497. package/dist/esm/modules/queue/internal/index.d.ts.map +0 -1
  498. package/dist/esm/modules/queue/internal/sequential/common/index.d.ts.map +0 -1
  499. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts.map +0 -1
  500. package/dist/esm/modules/queue/internal/sequential/helper.d.ts.map +0 -1
  501. package/dist/esm/modules/queue/internal/sequential/index.d.ts.map +0 -1
  502. package/dist/esm/modules/queue/kafka/admin.d.ts.map +0 -1
  503. package/dist/esm/modules/queue/kafka/base.d.ts.map +0 -1
  504. package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts.map +0 -1
  505. package/dist/esm/modules/queue/kafka/bundler/common/index.d.ts.map +0 -1
  506. package/dist/esm/modules/queue/kafka/bundler/index.d.ts.map +0 -1
  507. package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts.map +0 -1
  508. package/dist/esm/modules/queue/kafka/common/constants.d.ts.map +0 -1
  509. package/dist/esm/modules/queue/kafka/common/index.d.ts.map +0 -1
  510. package/dist/esm/modules/queue/kafka/common/types/admin.d.ts.map +0 -1
  511. package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts.map +0 -1
  512. package/dist/esm/modules/queue/kafka/common/types/connection.d.ts.map +0 -1
  513. package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts.map +0 -1
  514. package/dist/esm/modules/queue/kafka/common/types/index.d.ts.map +0 -1
  515. package/dist/esm/modules/queue/kafka/common/types/producer.d.ts.map +0 -1
  516. package/dist/esm/modules/queue/kafka/consumer.d.ts.map +0 -1
  517. package/dist/esm/modules/queue/kafka/index.d.ts.map +0 -1
  518. package/dist/esm/modules/queue/kafka/producer.d.ts.map +0 -1
  519. package/dist/esm/modules/queue/kafka/schema/index.d.ts.map +0 -1
  520. package/dist/esm/modules/queue/kafka/schema/registry.d.ts.map +0 -1
  521. package/dist/esm/modules/queue/mqtt/helper.d.ts.map +0 -1
  522. package/dist/esm/modules/queue/mqtt/index.d.ts.map +0 -1
  523. package/dist/esm/modules/redis/base/abstract.helper.d.ts.map +0 -1
  524. package/dist/esm/modules/redis/base/index.d.ts.map +0 -1
  525. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts.map +0 -1
  526. package/dist/esm/modules/redis/cluster/index.d.ts.map +0 -1
  527. package/dist/esm/modules/redis/common/constants.d.ts.map +0 -1
  528. package/dist/esm/modules/redis/common/index.d.ts.map +0 -1
  529. package/dist/esm/modules/redis/common/interfaces.d.ts.map +0 -1
  530. package/dist/esm/modules/redis/common/types.d.ts.map +0 -1
  531. package/dist/esm/modules/redis/factory.d.ts.map +0 -1
  532. package/dist/esm/modules/redis/index.d.ts.map +0 -1
  533. package/dist/esm/modules/redis/sentinel/index.d.ts.map +0 -1
  534. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts.map +0 -1
  535. package/dist/esm/modules/redis/single/index.d.ts.map +0 -1
  536. package/dist/esm/modules/redis/single/single.helper.d.ts.map +0 -1
  537. package/dist/esm/modules/redis/utility.d.ts.map +0 -1
  538. package/dist/esm/modules/retry/common/constants.d.ts.map +0 -1
  539. package/dist/esm/modules/retry/common/index.d.ts.map +0 -1
  540. package/dist/esm/modules/retry/common/types.d.ts.map +0 -1
  541. package/dist/esm/modules/retry/helper.d.ts.map +0 -1
  542. package/dist/esm/modules/retry/index.d.ts.map +0 -1
  543. package/dist/esm/modules/secrets/base/abstract.helper.d.ts.map +0 -1
  544. package/dist/esm/modules/secrets/base/index.d.ts.map +0 -1
  545. package/dist/esm/modules/secrets/common/constants.d.ts.map +0 -1
  546. package/dist/esm/modules/secrets/common/index.d.ts.map +0 -1
  547. package/dist/esm/modules/secrets/common/types/helper.d.ts.map +0 -1
  548. package/dist/esm/modules/secrets/common/types/index.d.ts.map +0 -1
  549. package/dist/esm/modules/secrets/common/types/lease.d.ts.map +0 -1
  550. package/dist/esm/modules/secrets/common/types/registration.d.ts.map +0 -1
  551. package/dist/esm/modules/secrets/common/types/timer.d.ts.map +0 -1
  552. package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts.map +0 -1
  553. package/dist/esm/modules/secrets/dotenv/index.d.ts.map +0 -1
  554. package/dist/esm/modules/secrets/factory.d.ts.map +0 -1
  555. package/dist/esm/modules/secrets/hashicorp/auth.d.ts.map +0 -1
  556. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts.map +0 -1
  557. package/dist/esm/modules/secrets/hashicorp/index.d.ts.map +0 -1
  558. package/dist/esm/modules/secrets/index.d.ts.map +0 -1
  559. package/dist/esm/modules/secrets/system-envs/index.d.ts.map +0 -1
  560. package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts.map +0 -1
  561. package/dist/esm/modules/slug/common/constants.d.ts.map +0 -1
  562. package/dist/esm/modules/slug/common/index.d.ts.map +0 -1
  563. package/dist/esm/modules/slug/helper.d.ts.map +0 -1
  564. package/dist/esm/modules/slug/index.d.ts.map +0 -1
  565. package/dist/esm/modules/socket/index.d.ts.map +0 -1
  566. package/dist/esm/modules/socket/socket-io/browser.d.ts.map +0 -1
  567. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +0 -1
  568. package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +0 -1
  569. package/dist/esm/modules/socket/socket-io/client/index.d.ts.map +0 -1
  570. package/dist/esm/modules/socket/socket-io/common/constants.d.ts.map +0 -1
  571. package/dist/esm/modules/socket/socket-io/common/index.d.ts.map +0 -1
  572. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts.map +0 -1
  573. package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts.map +0 -1
  574. package/dist/esm/modules/socket/socket-io/common/types/index.d.ts.map +0 -1
  575. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts.map +0 -1
  576. package/dist/esm/modules/socket/socket-io/index.d.ts.map +0 -1
  577. package/dist/esm/modules/socket/socket-io/server/helper.d.ts.map +0 -1
  578. package/dist/esm/modules/socket/socket-io/server/index.d.ts.map +0 -1
  579. package/dist/esm/modules/socket/websocket/common/constants.d.ts.map +0 -1
  580. package/dist/esm/modules/socket/websocket/common/index.d.ts.map +0 -1
  581. package/dist/esm/modules/socket/websocket/common/types/client.d.ts.map +0 -1
  582. package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts.map +0 -1
  583. package/dist/esm/modules/socket/websocket/common/types/index.d.ts.map +0 -1
  584. package/dist/esm/modules/socket/websocket/common/types/message.d.ts.map +0 -1
  585. package/dist/esm/modules/socket/websocket/common/types/server.d.ts.map +0 -1
  586. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts.map +0 -1
  587. package/dist/esm/modules/socket/websocket/emitter/index.d.ts.map +0 -1
  588. package/dist/esm/modules/socket/websocket/index.d.ts.map +0 -1
  589. package/dist/esm/modules/socket/websocket/server/delivery.d.ts.map +0 -1
  590. package/dist/esm/modules/socket/websocket/server/helper.d.ts.map +0 -1
  591. package/dist/esm/modules/socket/websocket/server/index.d.ts.map +0 -1
  592. package/dist/esm/modules/storage/base.d.ts.map +0 -1
  593. package/dist/esm/modules/storage/bun-s3/helper.d.ts.map +0 -1
  594. package/dist/esm/modules/storage/bun-s3/index.d.ts.map +0 -1
  595. package/dist/esm/modules/storage/bun-s3/utility.d.ts.map +0 -1
  596. package/dist/esm/modules/storage/common/constants.d.ts.map +0 -1
  597. package/dist/esm/modules/storage/common/errors.d.ts.map +0 -1
  598. package/dist/esm/modules/storage/common/index.d.ts.map +0 -1
  599. package/dist/esm/modules/storage/common/types.d.ts.map +0 -1
  600. package/dist/esm/modules/storage/common/utility.d.ts.map +0 -1
  601. package/dist/esm/modules/storage/disk/helper.d.ts.map +0 -1
  602. package/dist/esm/modules/storage/disk/index.d.ts.map +0 -1
  603. package/dist/esm/modules/storage/in-memory/helper.d.ts.map +0 -1
  604. package/dist/esm/modules/storage/in-memory/index.d.ts.map +0 -1
  605. package/dist/esm/modules/storage/index.d.ts.map +0 -1
  606. package/dist/esm/modules/temporal/abstract.d.ts.map +0 -1
  607. package/dist/esm/modules/temporal/adapters/dayjs.d.ts.map +0 -1
  608. package/dist/esm/modules/temporal/adapters/index.d.ts.map +0 -1
  609. package/dist/esm/modules/temporal/adapters/intl.d.ts.map +0 -1
  610. package/dist/esm/modules/temporal/adapters/luxon.d.ts.map +0 -1
  611. package/dist/esm/modules/temporal/adapters/native.d.ts.map +0 -1
  612. package/dist/esm/modules/temporal/calendar/calendar.d.ts.map +0 -1
  613. package/dist/esm/modules/temporal/calendar/index.d.ts.map +0 -1
  614. package/dist/esm/modules/temporal/common/constants.d.ts.map +0 -1
  615. package/dist/esm/modules/temporal/common/index.d.ts.map +0 -1
  616. package/dist/esm/modules/temporal/common/types.d.ts.map +0 -1
  617. package/dist/esm/modules/temporal/duration/duration.d.ts.map +0 -1
  618. package/dist/esm/modules/temporal/duration/index.d.ts.map +0 -1
  619. package/dist/esm/modules/temporal/helper.d.ts.map +0 -1
  620. package/dist/esm/modules/temporal/index.d.ts.map +0 -1
  621. package/dist/esm/modules/temporal/locale/index.d.ts.map +0 -1
  622. package/dist/esm/modules/temporal/locale/locale.d.ts.map +0 -1
  623. package/dist/esm/modules/temporal/pattern/common/constants.d.ts.map +0 -1
  624. package/dist/esm/modules/temporal/pattern/common/index.d.ts.map +0 -1
  625. package/dist/esm/modules/temporal/pattern/common/types.d.ts.map +0 -1
  626. package/dist/esm/modules/temporal/pattern/index.d.ts.map +0 -1
  627. package/dist/esm/modules/temporal/pattern/pattern.d.ts.map +0 -1
  628. package/dist/esm/modules/temporal/pattern/tokens.d.ts.map +0 -1
  629. package/dist/esm/modules/tree/builder.d.ts.map +0 -1
  630. package/dist/esm/modules/tree/common/index.d.ts.map +0 -1
  631. package/dist/esm/modules/tree/common/types.d.ts.map +0 -1
  632. package/dist/esm/modules/tree/index.d.ts.map +0 -1
  633. package/dist/esm/modules/tree/walk.d.ts.map +0 -1
  634. package/dist/esm/modules/uid/common/constants.d.ts.map +0 -1
  635. package/dist/esm/modules/uid/common/index.d.ts.map +0 -1
  636. package/dist/esm/modules/uid/common/types.d.ts.map +0 -1
  637. package/dist/esm/modules/uid/helper.d.ts.map +0 -1
  638. package/dist/esm/modules/uid/index.d.ts.map +0 -1
  639. package/dist/esm/modules/uid/opaque.d.ts.map +0 -1
  640. package/dist/esm/modules/uid/request-id.d.ts.map +0 -1
  641. package/dist/esm/modules/uid/uuid/common/constants.d.ts.map +0 -1
  642. package/dist/esm/modules/uid/uuid/common/index.d.ts.map +0 -1
  643. package/dist/esm/modules/uid/uuid/common/types.d.ts.map +0 -1
  644. package/dist/esm/modules/uid/uuid/helper.d.ts.map +0 -1
  645. package/dist/esm/modules/uid/uuid/index.d.ts.map +0 -1
  646. package/dist/esm/modules/uid/uuid/sha1.d.ts.map +0 -1
  647. package/dist/esm/modules/uid/uuid/v4.d.ts.map +0 -1
  648. package/dist/esm/modules/uid/uuid/v5.d.ts.map +0 -1
  649. package/dist/esm/modules/uid/uuid/v7.d.ts.map +0 -1
  650. package/dist/esm/modules/worker-thread/bus/abstract.d.ts.map +0 -1
  651. package/dist/esm/modules/worker-thread/bus/base.d.ts.map +0 -1
  652. package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts.map +0 -1
  653. package/dist/esm/modules/worker-thread/bus/handler/base.d.ts.map +0 -1
  654. package/dist/esm/modules/worker-thread/bus/handler/index.d.ts.map +0 -1
  655. package/dist/esm/modules/worker-thread/bus/index.d.ts.map +0 -1
  656. package/dist/esm/modules/worker-thread/common/index.d.ts.map +0 -1
  657. package/dist/esm/modules/worker-thread/common/types.d.ts.map +0 -1
  658. package/dist/esm/modules/worker-thread/index.d.ts.map +0 -1
  659. package/dist/esm/modules/worker-thread/thread/abstract.d.ts.map +0 -1
  660. package/dist/esm/modules/worker-thread/thread/base.d.ts.map +0 -1
  661. package/dist/esm/modules/worker-thread/thread/index.d.ts.map +0 -1
  662. package/dist/esm/modules/worker-thread/worker/abstract.d.ts.map +0 -1
  663. package/dist/esm/modules/worker-thread/worker/base.d.ts.map +0 -1
  664. package/dist/esm/modules/worker-thread/worker/index.d.ts.map +0 -1
  665. package/dist/esm/modules/worker-thread/worker-pool.d.ts.map +0 -1
  666. package/dist/esm/temporal.d.ts.map +0 -1
  667. package/dist/esm/utilities/build-info.utility.d.ts.map +0 -1
  668. package/dist/esm/utilities/error.utility.d.ts.map +0 -1
  669. package/dist/esm/utilities/form-body.utility.d.ts.map +0 -1
  670. package/dist/esm/utilities/hr-time.utility.d.ts.map +0 -1
  671. package/dist/esm/utilities/index.d.ts.map +0 -1
  672. package/dist/esm/utilities/module.utility.d.ts.map +0 -1
  673. package/dist/esm/utilities/parse.utility.d.ts.map +0 -1
  674. package/dist/esm/utilities/performance.utility.d.ts.map +0 -1
  675. package/dist/esm/utilities/project-root.utility.d.ts.map +0 -1
  676. package/dist/esm/utilities/promise.utility.d.ts.map +0 -1
  677. package/dist/esm/utilities/request.utility.d.ts.map +0 -1
  678. package/dist/esm/uuid.d.ts.map +0 -1
@@ -1,5 +1,6 @@
1
1
  import { type TConstValue } from '../../../../../common/types/index.js';
2
2
  import { type WebSocketClientStates } from '../constants.js';
3
+ /** The subset of a Bun server WebSocket the helpers use; `data` holds the per-connection data attached at upgrade. */
3
4
  export interface IWebSocket<T = unknown> {
4
5
  readonly data: T;
5
6
  readonly remoteAddress: string;
@@ -11,7 +12,9 @@ export interface IWebSocket<T = unknown> {
11
12
  close(code?: number, reason?: string): void;
12
13
  cork(callback: (ws: IWebSocket<T>) => void): void;
13
14
  }
15
+ /** One of the `WebSocketClientStates` values. */
14
16
  export type TWebSocketClientState = TConstValue<typeof WebSocketClientStates>;
17
+ /** A connected WebSocket client as tracked by the server helper. `connectedAt` and `lastActivity` are timestamps; `backpressured` is set while the socket cannot accept more data. */
15
18
  export interface IWebSocketClient<MetadataType extends Record<string, unknown> = Record<string, unknown>> {
16
19
  id: string;
17
20
  userId?: string;
@@ -27,6 +30,7 @@ export interface IWebSocketClient<MetadataType extends Record<string, unknown> =
27
30
  salt?: string;
28
31
  authTimer?: ReturnType<typeof setTimeout>;
29
32
  }
33
+ /** Per-connection data attached to a socket when it is upgraded, linking it back to its client record. */
30
34
  export interface IWebSocketData<MetadataType extends Record<string, unknown> = Record<string, unknown>> {
31
35
  clientId: string;
32
36
  userId?: string;
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/client.ts"],"names":[],"mappings":"","sourcesContent":["import { type TConstValue } from '@/common/types';\nimport { type WebSocketClientStates } from '../constants';\n\nexport interface IWebSocket<T = unknown> {\n readonly data: T;\n readonly remoteAddress: string;\n readonly readyState: number;\n\n // Bun accepts TypedArray | DataView | ArrayBuffer | SharedArrayBuffer | string; a bare ArrayBufferView is wider than that.\n send(\n data: string | ArrayBuffer | SharedArrayBuffer | Uint8Array | DataView,\n compress?: boolean,\n ): number;\n subscribe(topic: string): void;\n unsubscribe(topic: string): void;\n isSubscribed(topic: string): boolean;\n close(code?: number, reason?: string): void;\n cork(callback: (ws: IWebSocket<T>) => void): void;\n}\n\nexport type TWebSocketClientState = TConstValue<typeof WebSocketClientStates>;\n\nexport interface IWebSocketClient<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n id: string;\n userId?: string;\n socket: IWebSocket;\n state: TWebSocketClientState;\n rooms: Set<string>;\n backpressured: boolean;\n encrypted: boolean;\n connectedAt: number;\n lastActivity: number;\n metadata?: MetadataType;\n serverPublicKey?: string;\n salt?: string;\n authTimer?: ReturnType<typeof setTimeout>;\n}\n\nexport interface IWebSocketData<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n clientId: string;\n userId?: string;\n metadata?: MetadataType;\n}\n"]}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/client.ts"],"names":[],"mappings":"","sourcesContent":["import { type TConstValue } from '@/common/types';\nimport { type WebSocketClientStates } from '../constants';\n\n/** The subset of a Bun server WebSocket the helpers use; `data` holds the per-connection data attached at upgrade. */\nexport interface IWebSocket<T = unknown> {\n readonly data: T;\n readonly remoteAddress: string;\n readonly readyState: number;\n\n // Bun accepts TypedArray | DataView | ArrayBuffer | SharedArrayBuffer | string; a bare ArrayBufferView is wider than that.\n send(\n data: string | ArrayBuffer | SharedArrayBuffer | Uint8Array | DataView,\n compress?: boolean,\n ): number;\n subscribe(topic: string): void;\n unsubscribe(topic: string): void;\n isSubscribed(topic: string): boolean;\n close(code?: number, reason?: string): void;\n cork(callback: (ws: IWebSocket<T>) => void): void;\n}\n\n/** One of the `WebSocketClientStates` values. */\nexport type TWebSocketClientState = TConstValue<typeof WebSocketClientStates>;\n\n/** A connected WebSocket client as tracked by the server helper. `connectedAt` and `lastActivity` are timestamps; `backpressured` is set while the socket cannot accept more data. */\nexport interface IWebSocketClient<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n id: string;\n userId?: string;\n socket: IWebSocket;\n state: TWebSocketClientState;\n rooms: Set<string>;\n backpressured: boolean;\n encrypted: boolean;\n connectedAt: number;\n lastActivity: number;\n metadata?: MetadataType;\n serverPublicKey?: string;\n salt?: string;\n authTimer?: ReturnType<typeof setTimeout>;\n}\n\n/** Per-connection data attached to a socket when it is upgraded, linking it back to its client record. */\nexport interface IWebSocketData<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n clientId: string;\n userId?: string;\n metadata?: MetadataType;\n}\n"]}
@@ -2,10 +2,12 @@ import { type ValueOrPromise } from '../../../../../common/types/index.js';
2
2
  import { type TNullable } from '@venizia/ignis-inversion';
3
3
  import { type IWebSocketClient } from './client.js';
4
4
  import { type IWebSocketMessage } from './message.js';
5
+ /** Verifies the data a client sends to authenticate. Resolves `{ userId, metadata }` to accept, or `null` or `false` to reject. */
5
6
  export type TWebSocketAuthenticateFn<AuthDataType extends Record<string, unknown> = Record<string, unknown>, MetadataType extends Record<string, unknown> = Record<string, unknown>> = (opts: AuthDataType) => ValueOrPromise<{
6
7
  userId?: string;
7
8
  metadata?: MetadataType;
8
9
  } | null | false>;
10
+ /** Produces the server public key and salt for an encrypted session during authentication. Resolves `null` or `false` to refuse the handshake. */
9
11
  export type TWebSocketHandshakeFn<AuthDataType extends Record<string, unknown> = Record<string, unknown>> = (opts: {
10
12
  clientId: string;
11
13
  userId?: string;
@@ -14,25 +16,30 @@ export type TWebSocketHandshakeFn<AuthDataType extends Record<string, unknown> =
14
16
  serverPublicKey: string;
15
17
  salt: string;
16
18
  } | null | false>;
19
+ /** Returns the subset of the requested `rooms` the client may join; when none is allowed, the join is rejected. */
17
20
  export type TWebSocketValidateRoomFn = (opts: {
18
21
  clientId: string;
19
22
  userId?: string;
20
23
  rooms: string[];
21
24
  }) => ValueOrPromise<string[]>;
25
+ /** Called after a client has authenticated. */
22
26
  export type TWebSocketClientConnectedFn<MetadataType extends Record<string, unknown> = Record<string, unknown>> = (opts: {
23
27
  clientId: string;
24
28
  userId?: string;
25
29
  metadata?: MetadataType;
26
30
  }) => ValueOrPromise<void>;
31
+ /** Called after a client has disconnected. */
27
32
  export type TWebSocketClientDisconnectedFn = (opts: {
28
33
  clientId: string;
29
34
  userId?: string;
30
35
  }) => ValueOrPromise<void>;
36
+ /** Handles a message received from an authenticated client. */
31
37
  export type TWebSocketMessageHandler = (opts: {
32
38
  clientId: string;
33
39
  userId?: string;
34
40
  message: IWebSocketMessage;
35
41
  }) => ValueOrPromise<void>;
42
+ /** Rewrites an outbound event before it is sent to an encrypted client. Resolving `null` or `undefined` sends the original event and data. */
36
43
  export type TWebSocketOutboundTransformer<DataType = unknown, MetadataType extends Record<string, unknown> = Record<string, unknown>> = (opts: {
37
44
  client: IWebSocketClient<MetadataType>;
38
45
  event: string;
@@ -1 +1 @@
1
- {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/hooks.ts"],"names":[],"mappings":"","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport { type TNullable } from '@venizia/ignis-inversion';\nimport { type IWebSocketClient } from './client';\nimport { type IWebSocketMessage } from './message';\n\nexport type TWebSocketAuthenticateFn<\n AuthDataType extends Record<string, unknown> = Record<string, unknown>,\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> = (\n opts: AuthDataType,\n) => ValueOrPromise<{ userId?: string; metadata?: MetadataType } | null | false>;\n\nexport type TWebSocketHandshakeFn<\n AuthDataType extends Record<string, unknown> = Record<string, unknown>,\n> = (opts: {\n clientId: string;\n userId?: string;\n data: AuthDataType;\n}) => ValueOrPromise<{ serverPublicKey: string; salt: string } | null | false>;\n\nexport type TWebSocketValidateRoomFn = (opts: {\n clientId: string;\n userId?: string;\n rooms: string[];\n}) => ValueOrPromise<string[]>;\n\nexport type TWebSocketClientConnectedFn<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> = (opts: { clientId: string; userId?: string; metadata?: MetadataType }) => ValueOrPromise<void>;\n\nexport type TWebSocketClientDisconnectedFn = (opts: {\n clientId: string;\n userId?: string;\n}) => ValueOrPromise<void>;\n\nexport type TWebSocketMessageHandler = (opts: {\n clientId: string;\n userId?: string;\n message: IWebSocketMessage;\n}) => ValueOrPromise<void>;\n\nexport type TWebSocketOutboundTransformer<\n DataType = unknown,\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> = (opts: {\n client: IWebSocketClient<MetadataType>;\n event: string;\n data: DataType;\n}) => ValueOrPromise<TNullable<{ event: string; data: DataType }>>;\n"]}
1
+ {"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/hooks.ts"],"names":[],"mappings":"","sourcesContent":["import { type ValueOrPromise } from '@/common/types';\nimport { type TNullable } from '@venizia/ignis-inversion';\nimport { type IWebSocketClient } from './client';\nimport { type IWebSocketMessage } from './message';\n\n/** Verifies the data a client sends to authenticate. Resolves `{ userId, metadata }` to accept, or `null` or `false` to reject. */\nexport type TWebSocketAuthenticateFn<\n AuthDataType extends Record<string, unknown> = Record<string, unknown>,\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> = (\n opts: AuthDataType,\n) => ValueOrPromise<{ userId?: string; metadata?: MetadataType } | null | false>;\n\n/** Produces the server public key and salt for an encrypted session during authentication. Resolves `null` or `false` to refuse the handshake. */\nexport type TWebSocketHandshakeFn<\n AuthDataType extends Record<string, unknown> = Record<string, unknown>,\n> = (opts: {\n clientId: string;\n userId?: string;\n data: AuthDataType;\n}) => ValueOrPromise<{ serverPublicKey: string; salt: string } | null | false>;\n\n/** Returns the subset of the requested `rooms` the client may join; when none is allowed, the join is rejected. */\nexport type TWebSocketValidateRoomFn = (opts: {\n clientId: string;\n userId?: string;\n rooms: string[];\n}) => ValueOrPromise<string[]>;\n\n/** Called after a client has authenticated. */\nexport type TWebSocketClientConnectedFn<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> = (opts: { clientId: string; userId?: string; metadata?: MetadataType }) => ValueOrPromise<void>;\n\n/** Called after a client has disconnected. */\nexport type TWebSocketClientDisconnectedFn = (opts: {\n clientId: string;\n userId?: string;\n}) => ValueOrPromise<void>;\n\n/** Handles a message received from an authenticated client. */\nexport type TWebSocketMessageHandler = (opts: {\n clientId: string;\n userId?: string;\n message: IWebSocketMessage;\n}) => ValueOrPromise<void>;\n\n/** Rewrites an outbound event before it is sent to an encrypted client. Resolving `null` or `undefined` sends the original event and data. */\nexport type TWebSocketOutboundTransformer<\n DataType = unknown,\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> = (opts: {\n client: IWebSocketClient<MetadataType>;\n event: string;\n data: DataType;\n}) => ValueOrPromise<TNullable<{ event: string; data: DataType }>>;\n"]}
@@ -1,6 +1,7 @@
1
1
  import { type IRedisHelper } from '../../../../redis/index.js';
2
2
  import { type IWebSocket } from './client.js';
3
3
  import { type TWebSocketAuthenticateFn, type TWebSocketClientConnectedFn, type TWebSocketClientDisconnectedFn, type TWebSocketHandshakeFn, type TWebSocketMessageHandler, type TWebSocketOutboundTransformer, type TWebSocketValidateRoomFn } from './hooks.js';
4
+ /** The subset of a Bun server the WebSocket helper uses to publish to topics. */
4
5
  export interface IBunServer {
5
6
  readonly pendingWebSockets: number;
6
7
  publish(topic: string, data: string | ArrayBuffer | SharedArrayBuffer | Uint8Array | DataView, compress?: boolean): number;
@@ -22,17 +23,45 @@ export interface IBunWebSocketHandler extends IBunWebSocketConfig {
22
23
  close: (socket: IWebSocket, code: number, reason: string) => void;
23
24
  drain: (socket: IWebSocket) => void;
24
25
  }
26
+ /** Options for `WebSocketServerHelper`. Timeouts and intervals are milliseconds. `handshakeFn` is required when `requireEncryption` is true. */
25
27
  export interface IWebSocketServerOptions<AuthDataType extends Record<string, unknown> = Record<string, unknown>, MetadataType extends Record<string, unknown> = Record<string, unknown>> {
26
28
  identifier: string;
29
+ /** @default '/ws' */
27
30
  path?: string;
28
31
  redisConnection: IRedisHelper;
29
32
  server: IBunServer;
33
+ /** @default [WebSocketDefaults.ROOM, WebSocketDefaults.NOTIFICATION_ROOM] */
30
34
  defaultRooms?: string[];
31
35
  serverOptions?: IBunWebSocketConfig;
36
+ /**
37
+ * Time a client has to authenticate before it is disconnected.
38
+ *
39
+ * @default 5_000
40
+ */
32
41
  authTimeout?: number;
42
+ /**
43
+ * Time between heartbeats.
44
+ *
45
+ * @default 30_000
46
+ */
33
47
  heartbeatInterval?: number;
48
+ /**
49
+ * Time without a heartbeat before the client is disconnected (3 missed heartbeats at the default interval).
50
+ *
51
+ * @default 90_000
52
+ */
34
53
  heartbeatTimeout?: number;
54
+ /**
55
+ * Maximum concurrent encryption operations.
56
+ *
57
+ * @default 10
58
+ */
35
59
  encryptedBatchLimit?: number;
60
+ /**
61
+ * When true, clients must complete the handshake during authentication or are rejected (4004).
62
+ *
63
+ * @default false
64
+ */
36
65
  requireEncryption?: boolean;
37
66
  authenticateFn: TWebSocketAuthenticateFn<AuthDataType, MetadataType>;
38
67
  validateRoomFn?: TWebSocketValidateRoomFn;
@@ -42,6 +71,7 @@ export interface IWebSocketServerOptions<AuthDataType extends Record<string, unk
42
71
  outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;
43
72
  handshakeFn?: TWebSocketHandshakeFn<AuthDataType>;
44
73
  }
74
+ /** Options for `WebSocketEmitter`. */
45
75
  export interface IWebSocketEmitterOptions {
46
76
  identifier?: string;
47
77
  redisConnection: IRedisHelper;
@@ -1 +1 @@
1
- {"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/server.ts"],"names":[],"mappings":"","sourcesContent":["import { type IRedisHelper } from '@/modules/redis';\nimport { type IWebSocket } from './client';\nimport {\n type TWebSocketAuthenticateFn,\n type TWebSocketClientConnectedFn,\n type TWebSocketClientDisconnectedFn,\n type TWebSocketHandshakeFn,\n type TWebSocketMessageHandler,\n type TWebSocketOutboundTransformer,\n type TWebSocketValidateRoomFn,\n} from './hooks';\n\nexport interface IBunServer {\n readonly pendingWebSockets: number;\n publish(\n topic: string,\n data: string | ArrayBuffer | SharedArrayBuffer | Uint8Array | DataView,\n compress?: boolean,\n ): number;\n}\n\n/** Bun WebSocket native configuration options */\nexport interface IBunWebSocketConfig {\n perMessageDeflate?: boolean;\n maxPayloadLength?: number;\n idleTimeout?: number;\n backpressureLimit?: number;\n closeOnBackpressureLimit?: boolean;\n sendPings?: boolean;\n publishToSelf?: boolean;\n}\n\n/** Return type for getBunWebSocketHandler - handlers + config spread for server.reload() */\nexport interface IBunWebSocketHandler extends IBunWebSocketConfig {\n open: (socket: IWebSocket) => void;\n message: (socket: IWebSocket, message: string | Buffer) => void;\n close: (socket: IWebSocket, code: number, reason: string) => void;\n drain: (socket: IWebSocket) => void;\n}\n\nexport interface IWebSocketServerOptions<\n AuthDataType extends Record<string, unknown> = Record<string, unknown>,\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n identifier: string;\n path?: string; // Default: '/ws'\n redisConnection: IRedisHelper;\n server: IBunServer;\n defaultRooms?: string[];\n serverOptions?: IBunWebSocketConfig;\n authTimeout?: number; // Default: 5_000 (5s to authenticate or disconnect)\n heartbeatInterval?: number; // Default: 30_000 (30s between heartbeats)\n heartbeatTimeout?: number; // Default: 90_000 (3x interval — disconnect after 3 missed heartbeats)\n encryptedBatchLimit?: number; // Default: 10 (max concurrent encryption operations)\n requireEncryption?: boolean; // Default: false — when true, clients must complete handshake during auth or get rejected (4004)\n\n authenticateFn: TWebSocketAuthenticateFn<AuthDataType, MetadataType>;\n validateRoomFn?: TWebSocketValidateRoomFn;\n clientConnectedFn?: TWebSocketClientConnectedFn<MetadataType>;\n clientDisconnectedFn?: TWebSocketClientDisconnectedFn;\n messageHandler?: TWebSocketMessageHandler;\n outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n handshakeFn?: TWebSocketHandshakeFn<AuthDataType>; // Required when requireEncryption is true\n}\n\nexport interface IWebSocketEmitterOptions {\n identifier?: string;\n redisConnection: IRedisHelper;\n}\n"]}
1
+ {"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../../../src/modules/socket/websocket/common/types/server.ts"],"names":[],"mappings":"","sourcesContent":["import { type IRedisHelper } from '@/modules/redis';\nimport { type IWebSocket } from './client';\nimport {\n type TWebSocketAuthenticateFn,\n type TWebSocketClientConnectedFn,\n type TWebSocketClientDisconnectedFn,\n type TWebSocketHandshakeFn,\n type TWebSocketMessageHandler,\n type TWebSocketOutboundTransformer,\n type TWebSocketValidateRoomFn,\n} from './hooks';\n\n/** The subset of a Bun server the WebSocket helper uses to publish to topics. */\nexport interface IBunServer {\n readonly pendingWebSockets: number;\n publish(\n topic: string,\n data: string | ArrayBuffer | SharedArrayBuffer | Uint8Array | DataView,\n compress?: boolean,\n ): number;\n}\n\n/** Bun WebSocket native configuration options */\nexport interface IBunWebSocketConfig {\n perMessageDeflate?: boolean;\n maxPayloadLength?: number;\n idleTimeout?: number;\n backpressureLimit?: number;\n closeOnBackpressureLimit?: boolean;\n sendPings?: boolean;\n publishToSelf?: boolean;\n}\n\n/** Return type for getBunWebSocketHandler - handlers + config spread for server.reload() */\nexport interface IBunWebSocketHandler extends IBunWebSocketConfig {\n open: (socket: IWebSocket) => void;\n message: (socket: IWebSocket, message: string | Buffer) => void;\n close: (socket: IWebSocket, code: number, reason: string) => void;\n drain: (socket: IWebSocket) => void;\n}\n\n/** Options for `WebSocketServerHelper`. Timeouts and intervals are milliseconds. `handshakeFn` is required when `requireEncryption` is true. */\nexport interface IWebSocketServerOptions<\n AuthDataType extends Record<string, unknown> = Record<string, unknown>,\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n identifier: string;\n /** @default '/ws' */\n path?: string;\n redisConnection: IRedisHelper;\n server: IBunServer;\n /** @default [WebSocketDefaults.ROOM, WebSocketDefaults.NOTIFICATION_ROOM] */\n defaultRooms?: string[];\n serverOptions?: IBunWebSocketConfig;\n /**\n * Time a client has to authenticate before it is disconnected.\n *\n * @default 5_000\n */\n authTimeout?: number;\n /**\n * Time between heartbeats.\n *\n * @default 30_000\n */\n heartbeatInterval?: number;\n /**\n * Time without a heartbeat before the client is disconnected (3 missed heartbeats at the default interval).\n *\n * @default 90_000\n */\n heartbeatTimeout?: number;\n /**\n * Maximum concurrent encryption operations.\n *\n * @default 10\n */\n encryptedBatchLimit?: number;\n /**\n * When true, clients must complete the handshake during authentication or are rejected (4004).\n *\n * @default false\n */\n requireEncryption?: boolean;\n\n authenticateFn: TWebSocketAuthenticateFn<AuthDataType, MetadataType>;\n validateRoomFn?: TWebSocketValidateRoomFn;\n clientConnectedFn?: TWebSocketClientConnectedFn<MetadataType>;\n clientDisconnectedFn?: TWebSocketClientDisconnectedFn;\n messageHandler?: TWebSocketMessageHandler;\n outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n handshakeFn?: TWebSocketHandshakeFn<AuthDataType>; // Required when requireEncryption is true\n}\n\n/** Options for `WebSocketEmitter`. */\nexport interface IWebSocketEmitterOptions {\n identifier?: string;\n redisConnection: IRedisHelper;\n}\n"]}
@@ -1,5 +1,6 @@
1
1
  import { BaseHelper } from '../../../base.js';
2
2
  import { type IWebSocketEmitterOptions } from '../common/index.js';
3
+ /** Publishes WebSocket messages to clients on any server instance through Redis, without holding connections itself. `configure()` must run first. */
3
4
  export declare class WebSocketEmitter extends BaseHelper {
4
5
  private redisPub;
5
6
  constructor(opts: IWebSocketEmitterOptions);
@@ -4,6 +4,7 @@ import { getError } from '../../../error/index.js';
4
4
  import { RedisUtility } from '../../../redis/index.js';
5
5
  import { WebSocketChannels, WebSocketMessageTypes, } from '../common/index.js';
6
6
  const EMITTER_SERVER_ID = 'emitter';
7
+ /** Publishes WebSocket messages to clients on any server instance through Redis, without holding connections itself. `configure()` must run first. */
7
8
  export class WebSocketEmitter extends BaseHelper {
8
9
  constructor(opts) {
9
10
  super({ scope: opts.identifier ?? WebSocketEmitter.name });
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/emitter/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAqB,MAAM,iBAAiB,CAAC;AAElE,OAAO,EAGL,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,WAAW,CAAC;AAEnB,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAEpC,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAG9C,YAAY,IAA8B;QACxC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC;QAE3D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,gBAAgB,CAAC,IAAI,CAAC;QAC3D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7C,CAAC;IAEO,eAAe,CAAC,eAA4D;QAClF,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,MAAM,QAAQ,CAAC;gBACb,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;gBACrD,OAAO,EAAE,8CAA8C;aACxD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,eAAe,CAAC,eAAe,EAAE,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAEtE,IAAI,CAAC,QAAyB,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YAC3D,MAAM,CAAC,KAAK,CAAC,6BAA6B,EAAE,KAAK,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,YAAY,CAAC,gBAAgB,CAAC;YAC5B,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;YACxB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;SAC3B,CAAC,CAAC;QAEH,MAAM,YAAY,CAAC,YAAY,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,OAAO,CAAC,IAOrB;QACC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAE7D,MAAM,OAAO,GAAwB;YACnC,QAAQ,EAAE,iBAAiB;YAC3B,IAAI;YACJ,MAAM;YACN,KAAK;YACL,IAAI;YACJ,OAAO;SACR,CAAC;QAEF,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAwD;QACrE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACvC,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;YAClD,IAAI,EAAE,qBAAqB,CAAC,MAAM;YAClC,MAAM,EAAE,QAAQ;YAChB,KAAK;YACL,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAsD;QACjE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACrC,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;YAC9C,IAAI,EAAE,qBAAqB,CAAC,IAAI;YAChC,MAAM,EAAE,MAAM;YACd,KAAK;YACL,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAwE;QACnF,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC5C,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;YAC5C,IAAI,EAAE,qBAAqB,CAAC,IAAI;YAChC,MAAM,EAAE,IAAI;YACZ,KAAK;YACL,IAAI;YACJ,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAsC;QACpD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAC7B,MAAM,IAAI,CAAC,OAAO,CAAC;YACjB,OAAO,EAAE,iBAAiB,CAAC,SAAS;YACpC,IAAI,EAAE,qBAAqB,CAAC,SAAS;YACrC,KAAK;YACL,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;QAElD,MAAM,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;QAE5B,MAAM,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IACrD,CAAC;CACF","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
+ {"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\n/** Publishes WebSocket messages to clients on any server instance through Redis, without holding connections itself. `configure()` must run first. */\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.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/delivery.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { PromiseUtility } from '@/utilities';\nimport {\n type IBunServer,\n type IWebSocketClient,\n type IWebSocketMessage,\n type TWebSocketOutboundTransformer,\n WebSocketClientStates,\n WebSocketDefaults,\n} from '../common';\n\nexport interface IWebSocketDeliveryHelperOptions<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n server: IBunServer;\n /** Shared by reference with WebSocketServerHelper - never copy, both sides must see the same live maps. */\n clients: Map<string, IWebSocketClient<MetadataType>>;\n users: Map<string, Set<string>>;\n rooms: Map<string, Set<string>>;\n outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n encryptedBatchLimit: number;\n}\n\n/** Local delivery and fan-out for the WebSocket server: single client, per-user, per-room, and broadcast. */\nexport class WebSocketDeliveryHelper<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> extends BaseHelper {\n private server: IBunServer;\n private clients: Map<string, IWebSocketClient<MetadataType>>;\n private users: Map<string, Set<string>>;\n private rooms: Map<string, Set<string>>;\n private outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n private encryptedBatchLimit: number;\n\n constructor(opts: IWebSocketDeliveryHelperOptions<MetadataType>) {\n super({ scope: WebSocketDeliveryHelper.name });\n\n this.server = opts.server;\n this.clients = opts.clients;\n this.users = opts.users;\n this.rooms = opts.rooms;\n this.outboundTransformer = opts.outboundTransformer;\n this.encryptedBatchLimit = opts.encryptedBatchLimit;\n }\n\n sendToClient(opts: { clientId: string; event: string; data: unknown; doLog?: boolean }) {\n const logger = this.logger.for(this.sendToClient.name);\n const { clientId, event, data, doLog } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return;\n }\n\n // Async path - transformer intercepts before socket.send()\n const outboundTransformer = this.outboundTransformer;\n if (outboundTransformer && client.encrypted) {\n Promise.resolve()\n .then(() => outboundTransformer({ client, event, data }))\n .then((transformed) => {\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({\n client,\n payload: JSON.stringify(outboundMessage),\n doLog,\n event,\n data,\n });\n })\n .catch((error) => {\n logger.error('Outbound transformer error | id: %s | error: %s', clientId, error);\n });\n return;\n }\n\n // Sync path (unchanged, zero overhead when no transformer)\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), doLog, event, data });\n }\n\n private async sendToClientAsync(opts: { clientId: string; event: string; data: unknown }) {\n const { clientId, event, data } = opts;\n const client = this.clients.get(clientId);\n if (!client) {\n return Promise.resolve();\n }\n\n if (!this.outboundTransformer || !client.encrypted) {\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), event, data });\n return Promise.resolve();\n }\n\n try {\n const transformed = await Promise.resolve(this.outboundTransformer({ client, event, data }));\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({ client, payload: JSON.stringify(outboundMessage), event, data });\n } catch (error) {\n this.logger\n .for(this.sendToClientAsync.name)\n .error('Outbound transformer error | id: %s | error: %s', clientId, error);\n }\n }\n\n private deliverToSocket(opts: {\n client: IWebSocketClient<MetadataType>;\n payload: string;\n doLog?: boolean;\n event?: string;\n data?: unknown;\n }) {\n const logger = this.logger.for(this.deliverToSocket.name);\n const { client, payload, doLog, event, data } = opts;\n\n try {\n const result = client.socket.send(payload);\n\n if (result === 0) {\n logger.warn('Message dropped (socket closed) | id: %s', client.id);\n }\n\n if (result === -1) {\n client.backpressured = true;\n logger.warn('Backpressure detected | id: %s', client.id);\n }\n } catch (error) {\n logger.error('Failed to send | id: %s | error: %s', client.id, error);\n }\n\n if (doLog) {\n logger.info('Message sent | id: %s | event: %s | data: %j', client.id, event, data);\n }\n }\n\n sendToUser(opts: { userId: string; event: string; data: unknown }) {\n const { userId, event, data } = opts;\n const clientIds = this.users.get(userId);\n if (!clientIds) {\n return;\n }\n\n for (const clientId of clientIds) {\n this.sendToClient({ clientId, event, data });\n }\n }\n\n private sendToRoomExcluding(opts: {\n room: string;\n event: string;\n data: unknown;\n exclude: string[];\n }) {\n const { room, event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n const roomClientIds = this.rooms.get(room);\n if (!roomClientIds) {\n return;\n }\n\n // Serialised ONCE when there is no transformer, because the payload is then identical for every\n // recipient - `sendToClient` would otherwise run `JSON.stringify` per client on a message that\n // never differs. With a transformer each client's payload really is different, so that path\n // still goes through `sendToClient`. The non-excluding fan-out already works this way.\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data });\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n\n const client = this.clients.get(clientId);\n if (client) {\n this.deliverToSocket({ client, payload, event, data });\n }\n }\n\n return;\n }\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n this.sendToClient({ clientId, event, data });\n }\n }\n\n sendToRoom(opts: { room: string; event: string; data: unknown; exclude?: string[] }) {\n const { room, event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.sendToRoomExcluding({ room, event, data, exclude });\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(room, payload);\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const roomClientIds = this.rooms.get(room);\n if (!roomClientIds) {\n return;\n }\n\n const tasks: Array<() => Promise<void>> = [];\n for (const clientId of roomClientIds) {\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.sendToRoom.name,\n execution: PromiseUtility.executeWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n\n private broadcastExcluding(opts: { event: string; data: unknown; exclude: string[] }) {\n const { event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n for (const [clientId, client] of this.clients) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n // Only broadcast to authenticated clients (consistent with non-exclude path which uses BROADCAST_TOPIC)\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n\n this.sendToClient({ clientId, event, data });\n }\n }\n\n broadcast(opts: { event: string; data: unknown; exclude?: string[] }) {\n const { event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.broadcastExcluding({ event, data, exclude });\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(WebSocketDefaults.BROADCAST_TOPIC, payload);\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const tasks: Array<() => Promise<void>> = [];\n for (const [clientId, client] of this.clients) {\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.broadcast.name,\n execution: PromiseUtility.executeWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n}\n"]}
1
+ {"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../../../../../src/modules/socket/websocket/server/delivery.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseHelper } from '@/modules/base';\nimport { PromiseUtility } from '@/utilities';\nimport {\n type IBunServer,\n type IWebSocketClient,\n type IWebSocketMessage,\n type TWebSocketOutboundTransformer,\n WebSocketClientStates,\n WebSocketDefaults,\n} from '../common';\n\nexport interface IWebSocketDeliveryHelperOptions<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> {\n server: IBunServer;\n /** Shared by reference with WebSocketServerHelper - never copy, both sides must see the same live maps. */\n clients: Map<string, IWebSocketClient<MetadataType>>;\n users: Map<string, Set<string>>;\n rooms: Map<string, Set<string>>;\n outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n encryptedBatchLimit: number;\n}\n\n/** Local delivery and fan-out for the WebSocket server: single client, per-user, per-room, and broadcast. */\nexport class WebSocketDeliveryHelper<\n MetadataType extends Record<string, unknown> = Record<string, unknown>,\n> extends BaseHelper {\n private server: IBunServer;\n private clients: Map<string, IWebSocketClient<MetadataType>>;\n private users: Map<string, Set<string>>;\n private rooms: Map<string, Set<string>>;\n private outboundTransformer?: TWebSocketOutboundTransformer<unknown, MetadataType>;\n private encryptedBatchLimit: number;\n\n constructor(opts: IWebSocketDeliveryHelperOptions<MetadataType>) {\n super({ scope: WebSocketDeliveryHelper.name });\n\n this.server = opts.server;\n this.clients = opts.clients;\n this.users = opts.users;\n this.rooms = opts.rooms;\n this.outboundTransformer = opts.outboundTransformer;\n this.encryptedBatchLimit = opts.encryptedBatchLimit;\n }\n\n sendToClient(opts: { clientId: string; event: string; data: unknown; doLog?: boolean }) {\n const logger = this.logger.for(this.sendToClient.name);\n const { clientId, event, data, doLog } = opts;\n const client = this.clients.get(clientId);\n\n if (!client) {\n return;\n }\n\n // Async path - transformer intercepts before socket.send()\n const outboundTransformer = this.outboundTransformer;\n\n if (outboundTransformer && client.encrypted) {\n Promise.resolve()\n .then(() => outboundTransformer({ client, event, data }))\n .then((transformed) => {\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({\n client,\n payload: JSON.stringify(outboundMessage),\n doLog,\n event,\n data,\n });\n })\n .catch((error) => {\n logger.error('Outbound transformer error | id: %s | error: %s', clientId, error);\n });\n\n return;\n }\n\n // Sync path (unchanged, zero overhead when no transformer)\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), doLog, event, data });\n }\n\n private async sendToClientAsync(opts: { clientId: string; event: string; data: unknown }) {\n const { clientId, event, data } = opts;\n const client = this.clients.get(clientId);\n\n if (!client) {\n return Promise.resolve();\n }\n\n if (!this.outboundTransformer || !client.encrypted) {\n this.deliverToSocket({ client, payload: JSON.stringify({ event, data }), event, data });\n\n return Promise.resolve();\n }\n\n try {\n const transformed = await Promise.resolve(this.outboundTransformer({ client, event, data }));\n const outboundMessage = transformed ?? { event, data };\n this.deliverToSocket({ client, payload: JSON.stringify(outboundMessage), event, data });\n } catch (error) {\n this.logger\n .for(this.sendToClientAsync.name)\n .error('Outbound transformer error | id: %s | error: %s', clientId, error);\n }\n }\n\n private deliverToSocket(opts: {\n client: IWebSocketClient<MetadataType>;\n payload: string;\n doLog?: boolean;\n event?: string;\n data?: unknown;\n }) {\n const logger = this.logger.for(this.deliverToSocket.name);\n const { client, payload, doLog, event, data } = opts;\n\n try {\n const result = client.socket.send(payload);\n\n if (result === 0) {\n logger.warn('Message dropped (socket closed) | id: %s', client.id);\n }\n\n if (result === -1) {\n client.backpressured = true;\n logger.warn('Backpressure detected | id: %s', client.id);\n }\n } catch (error) {\n logger.error('Failed to send | id: %s | error: %s', client.id, error);\n }\n\n if (doLog) {\n logger.info('Message sent | id: %s | event: %s | data: %j', client.id, event, data);\n }\n }\n\n sendToUser(opts: { userId: string; event: string; data: unknown }) {\n const { userId, event, data } = opts;\n const clientIds = this.users.get(userId);\n\n if (!clientIds) {\n return;\n }\n\n for (const clientId of clientIds) {\n this.sendToClient({ clientId, event, data });\n }\n }\n\n private sendToRoomExcluding(opts: {\n room: string;\n event: string;\n data: unknown;\n exclude: string[];\n }) {\n const { room, event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n const roomClientIds = this.rooms.get(room);\n\n if (!roomClientIds) {\n return;\n }\n\n // Serialised ONCE when there is no transformer, because the payload is then identical for every\n // recipient - `sendToClient` would otherwise run `JSON.stringify` per client on a message that\n // never differs. With a transformer each client's payload really is different, so that path\n // still goes through `sendToClient`. The non-excluding fan-out already works this way.\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data });\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n\n const client = this.clients.get(clientId);\n\n if (client) {\n this.deliverToSocket({ client, payload, event, data });\n }\n }\n\n return;\n }\n\n for (const clientId of roomClientIds) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n\n this.sendToClient({ clientId, event, data });\n }\n }\n\n sendToRoom(opts: { room: string; event: string; data: unknown; exclude?: string[] }) {\n const { room, event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.sendToRoomExcluding({ room, event, data, exclude });\n\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(room, payload);\n\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const roomClientIds = this.rooms.get(room);\n\n if (!roomClientIds) {\n return;\n }\n\n const tasks: Array<() => Promise<void>> = [];\n\n for (const clientId of roomClientIds) {\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.sendToRoom.name,\n execution: PromiseUtility.executeWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n\n private broadcastExcluding(opts: { event: string; data: unknown; exclude: string[] }) {\n const { event, data, exclude } = opts;\n\n const excludeSet = new Set(exclude);\n\n for (const [clientId, client] of this.clients) {\n if (excludeSet.has(clientId)) {\n continue;\n }\n\n // Only broadcast to authenticated clients (consistent with non-exclude path which uses BROADCAST_TOPIC)\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n\n this.sendToClient({ clientId, event, data });\n }\n }\n\n broadcast(opts: { event: string; data: unknown; exclude?: string[] }) {\n const { event, data, exclude } = opts;\n\n // When exclude is present, must iterate - can't exclude from Bun native pub/sub\n if (exclude?.length) {\n this.broadcastExcluding({ event, data, exclude });\n\n return;\n }\n\n // No encryption - Bun native pub/sub O(1) C++ fan-out\n if (!this.outboundTransformer) {\n const payload = JSON.stringify({ event, data } satisfies IWebSocketMessage);\n this.server.publish(WebSocketDefaults.BROADCAST_TOPIC, payload);\n\n return;\n }\n\n // Encryption enabled - iterate all clients individually with concurrency limit\n const tasks: Array<() => Promise<void>> = [];\n\n for (const [clientId, client] of this.clients) {\n if (client.state !== WebSocketClientStates.AUTHENTICATED) {\n continue;\n }\n\n tasks.push(() => this.sendToClientAsync({ clientId, event, data }));\n }\n\n if (tasks.length) {\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.broadcast.name,\n execution: PromiseUtility.executeWithLimit({ tasks, limit: this.encryptedBatchLimit }),\n });\n }\n }\n}\n"]}
@@ -1,6 +1,7 @@
1
1
  import { type ValueOrPromise } from '../../../../common/types/index.js';
2
2
  import { BaseHelper } from '../../../base.js';
3
3
  import { type IBunWebSocketHandler, type IWebSocket, type IWebSocketClient, type IWebSocketServerOptions } from '../common/index.js';
4
+ /** WebSocket server for Bun with authentication, rooms, heartbeats, optional encrypted sessions, and Redis fan-out across instances. Clients must authenticate through `authenticateFn` within `authTimeout`. */
4
5
  export declare class WebSocketServerHelper<AuthDataType extends Record<string, unknown> = Record<string, unknown>, MetadataType extends Record<string, unknown> = Record<string, unknown>> extends BaseHelper {
5
6
  /**
6
7
  * Narrows an untrusted room payload to the strings it actually contains.
@@ -6,6 +6,7 @@ import { UuidHelper } from '../../../uid/index.js';
6
6
  import { PromiseUtility } from '../../../../utilities/promise.utility.js';
7
7
  import { WebSocketChannels, WebSocketClientStates, WebSocketDefaults, WebSocketEvents, WebSocketMessageTypes, } from '../common/index.js';
8
8
  import { WebSocketDeliveryHelper } from './delivery.js';
9
+ /** WebSocket server for Bun with authentication, rooms, heartbeats, optional encrypted sessions, and Redis fan-out across instances. Clients must authenticate through `authenticateFn` within `authTimeout`. */
9
10
  export class WebSocketServerHelper extends BaseHelper {
10
11
  /**
11
12
  * Narrows an untrusted room payload to the strings it actually contains.