@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 +1 @@
1
- {"version":3,"file":"base-tcp-server.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/tcp-socket/base-tcp-server.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TConstValue } from '@/common/types';\nimport { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { ParseUtility } from '@/utilities/parse.utility';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport {\n type ListenOptions,\n type ServerOpts,\n type Socket as SocketClient,\n type Server as SocketServer,\n} from 'node:net';\n\n/** Where a TCP client is in the authentication handshake. */\nexport class TcpClientStates {\n static readonly UNAUTHORIZED = 'unauthorized';\n static readonly AUTHENTICATING = 'authenticating';\n static readonly AUTHENTICATED = 'authenticated';\n\n static readonly SCHEME_SET = new Set<string>([\n this.UNAUTHORIZED,\n this.AUTHENTICATING,\n this.AUTHENTICATED,\n ]);\n\n static isValid(value: string): boolean {\n return this.SCHEME_SET.has(value);\n }\n}\n\n/** Valid TCP client state values. */\nexport type TTcpClientState = TConstValue<typeof TcpClientStates>;\n\nexport interface ITcpSocketClient<SocketClientType> {\n id: string;\n socket: SocketClientType;\n state: TTcpClientState;\n subscriptions: Set<string>;\n storage: {\n connectedAt: Date;\n authenticatedAt: Date | null;\n authenticateTimeout?: ReturnType<typeof setTimeout> | null;\n [additionField: symbol | string]: any;\n };\n}\n\nexport interface ITcpSocketServerOptions<\n SocketServerOptions extends ServerOpts = ServerOpts,\n SocketServerType extends SocketServer = SocketServer,\n SocketClientType extends SocketClient = SocketClient,\n> {\n scope?: string;\n identifier: string;\n\n serverOptions: Partial<SocketServerOptions>;\n listenOptions: Partial<ListenOptions>;\n authenticateOptions: { required: boolean; duration?: number };\n\n extraEvents?: Record<\n string,\n (opts: { id: string; socket: SocketClientType; args: any }) => ValueOrPromise<void>\n >;\n\n createServerFn: (\n options: Partial<SocketServerOptions>,\n connectionListener: (socket: SocketClientType) => void,\n ) => SocketServerType;\n\n onServerReady?: (opts: { server: SocketServerType }) => void;\n onClientConnected?: (opts: { id: string; socket: SocketClientType }) => void;\n onClientData?: (opts: { id: string; socket: SocketClientType; data: Buffer | string }) => void;\n onClientClose?: (opts: { id: string; socket: SocketClientType }) => void;\n onClientError?: (opts: { id: string; socket: SocketClientType; error: Error }) => void;\n onServerError?: (opts: { server: SocketServerType; error: Error }) => void;\n}\n\nexport class BaseNetworkTcpServer<\n SocketServerOptions extends ServerOpts = ServerOpts,\n SocketServerType extends SocketServer = SocketServer,\n SocketClientType extends SocketClient = SocketClient,\n> extends BaseHelper {\n protected serverOptions: Partial<SocketServerOptions> = {};\n protected listenOptions: Partial<ListenOptions> = {};\n protected authenticateOptions: { required: boolean; duration?: number };\n\n protected clients: Record<string, ITcpSocketClient<SocketClientType>>;\n protected server: SocketServerType;\n\n protected extraEvents: Record<\n string,\n (opts: { id: string; socket: SocketClientType; args: any }) => ValueOrPromise<void>\n >;\n\n protected createServerFn: (\n options: Partial<SocketServerOptions>,\n connectionListener: (socket: SocketClientType) => void,\n ) => SocketServerType;\n\n protected onServerReady?: (opts: { server: SocketServerType }) => void;\n protected onClientConnected?: (opts: { id: string; socket: SocketClientType }) => void;\n protected onClientData?: (opts: {\n id: string;\n socket: SocketClientType;\n data: Buffer | string;\n }) => void;\n protected onClientClose?: (opts: { id: string; socket: SocketClientType }) => void;\n protected onClientError?: (opts: { id: string; socket: SocketClientType; error: Error }) => void;\n protected onServerError?: (opts: { server: SocketServerType; error: Error }) => void;\n\n constructor(\n opts: ITcpSocketServerOptions<SocketServerOptions, SocketServerType, SocketClientType>,\n ) {\n super({\n scope: opts.scope ?? opts.identifier ?? BaseNetworkTcpServer.name,\n identifier: opts.identifier,\n });\n\n // No prototype: `getClient({ id: 'constructor' })` must find nothing, not `Object`.\n this.clients = Object.create(null);\n\n this.serverOptions = opts.serverOptions;\n this.listenOptions = opts.listenOptions;\n this.authenticateOptions = opts.authenticateOptions;\n\n if (\n this.authenticateOptions.required &&\n (!this.authenticateOptions.duration || this.authenticateOptions.duration < 0)\n ) {\n throw getError({\n message:\n 'TCP Server | Invalid authenticate duration | Required duration for authenticateOptions',\n });\n }\n\n this.extraEvents = opts.extraEvents ?? {};\n\n this.createServerFn = opts.createServerFn;\n\n this.onServerReady = opts.onServerReady;\n this.onClientConnected = opts.onClientConnected;\n this.onClientData = opts.onClientData;\n this.onClientClose = opts.onClientClose;\n this.onClientError = opts.onClientError;\n this.onServerError = opts.onServerError;\n\n this.configure();\n }\n\n // Hooks run inside socket event listeners: a synchronous throw there is an uncaught exception that kills the process and skips the client-registry cleanup that follows it.\n protected invokeHook(opts: { scope: string; execution: () => void }) {\n const { scope, execution } = opts;\n\n try {\n execution();\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n configure() {\n this.server = this.createServerFn(this.serverOptions, (socket) => {\n this.onNewConnection({ socket });\n });\n\n // Without this listener a failed listen - a port already in use is the commonest boot failure there is - emits an unhandled 'error' event, which takes the whole process down with it.\n this.server.on('error', (error: Error) => {\n this.logger\n .for(this.configure.name)\n .error('TCP Socket Server error | Options: %j | Error: %s', this.listenOptions, error);\n\n this.invokeHook({\n scope: this.configure.name,\n execution: () => {\n this.onServerError?.({ server: this.server, error });\n },\n });\n });\n\n this.server.listen(this.listenOptions, () => {\n this.logger\n .for(this.configure.name)\n .info('TCP Socket Server is now listening | Options: %j', this.listenOptions);\n\n this.invokeHook({\n scope: this.configure.name,\n execution: () => {\n this.onServerReady?.({ server: this.server });\n },\n });\n });\n }\n\n onNewConnection(opts: { socket: SocketClientType }) {\n const { socket } = opts;\n\n const id = ParseUtility.getUID();\n\n socket.on('data', (data: Buffer | string) => {\n this.invokeHook({\n scope: 'onClientData',\n execution: () => {\n this.onClientData?.({ id, socket, data });\n },\n });\n });\n\n socket.on('error', (error: Error) => {\n this.logger.for('onClientConnect').error('Socket Error | ID: %s | Error: %s', id, error);\n\n this.invokeHook({\n scope: 'onClientError',\n execution: () => {\n this.onClientError?.({ id, socket, error });\n },\n });\n\n socket.end();\n });\n\n socket.on('close', (hasError: boolean) => {\n this.logger\n .for('onClientConnect')\n .info('Socket Closed | ID: %s | hasError: %s', id, hasError);\n\n this.invokeHook({\n scope: 'onClientClose',\n execution: () => {\n this.onClientClose?.({ id, socket });\n },\n });\n\n const authenticateTimeout = this.getClient({ id })?.storage?.authenticateTimeout;\n if (authenticateTimeout) {\n clearTimeout(authenticateTimeout);\n }\n\n // `delete`, not `omit`: omit rebuilds the WHOLE registry per disconnect, so a disconnect\n // storm is O(n^2) - measured at 5000 clients, 2.3s of drain with a 2.2s worst-case stall.\n delete this.clients[id];\n });\n\n for (const extraEvent in this.extraEvents) {\n socket.on(extraEvent, (args) => {\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: 'onClientConnect',\n // The async wrapper turns a SYNCHRONOUS throw from the handler into a rejection; calling it bare would throw out of this listener as an uncaught exception.\n execution: (async () => this.extraEvents[extraEvent]({ id, socket, args }))(),\n });\n });\n }\n\n this.clients[id] = {\n id,\n socket,\n state: this.authenticateOptions.required\n ? TcpClientStates.UNAUTHORIZED\n : TcpClientStates.AUTHENTICATED,\n subscriptions: new Set([]),\n storage: {\n connectedAt: new Date(),\n authenticatedAt: this.authenticateOptions.required ? null : new Date(),\n },\n };\n\n this.logger\n .for('onClientConnect')\n .info(\n 'New TCP SocketClient | Client: %s | authenticateOptions: %s %s',\n `${id} - ${socket.remoteAddress} - ${socket.remotePort} - ${socket.remoteFamily}`,\n this.authenticateOptions.required,\n this.authenticateOptions.duration,\n );\n\n this.invokeHook({\n scope: 'onClientConnected',\n execution: () => {\n this.onClientConnected?.({ id, socket });\n },\n });\n\n if (\n this.authenticateOptions.required &&\n this.authenticateOptions.duration &&\n this.authenticateOptions.duration > 0\n ) {\n const authenticateTimeout = setTimeout(() => {\n const client = this.getClient({ id });\n if (!client) {\n return;\n }\n\n client.storage.authenticateTimeout = null;\n\n if (client.state === TcpClientStates.AUTHENTICATED) {\n return;\n }\n\n this.emit({ clientId: id, payload: 'Unauthorized Client' });\n client.socket.end();\n }, this.authenticateOptions.duration);\n\n const client = this.getClient({ id });\n if (!client) {\n clearTimeout(authenticateTimeout);\n return;\n }\n\n client.storage.authenticateTimeout = authenticateTimeout;\n }\n }\n\n getClients() {\n return this.clients;\n }\n\n getClient(opts: { id: string }) {\n return this.clients?.[opts.id];\n }\n\n getServer() {\n return this.server;\n }\n\n /** Clears timers and destroys all client sockets before closing the listener - `server.close()` alone never settles while a socket stays attached. Idempotent; safe if never listened. */\n async shutdown(): Promise<void> {\n const clientsValues = Object.values(this.clients);\n for (const client of clientsValues) {\n const { authenticateTimeout } = client.storage;\n if (authenticateTimeout) {\n clearTimeout(authenticateTimeout);\n client.storage.authenticateTimeout = null;\n }\n\n client.socket.destroy();\n }\n\n this.clients = Object.create(null);\n\n const server = this.server;\n if (!server) {\n return;\n }\n\n // Not guarded on `listening`: listen() is async (DNS lookup), so a shutdown() racing startup could skip close() and leave the server bound forever; close() on a never-listened server just logs ERR_SERVER_NOT_RUNNING below.\n\n await new Promise<void>((resolve) => {\n server.close((error) => {\n if (error) {\n this.logger.for(this.shutdown.name).error('Failed to close server | Error: %s', error);\n }\n\n resolve();\n });\n });\n\n this.logger.for(this.shutdown.name).info('Server closed | Identifier: %s', this.identifier);\n }\n\n doAuthenticate(opts: { id: string; state: TTcpClientState }) {\n const { id, state } = opts;\n\n const client = this.getClient({ id });\n if (!client) {\n this.logger.for('authenticateClient').error('Client NOT FOUND | ID: %s', id);\n return;\n }\n\n client.state = state;\n\n switch (state) {\n case TcpClientStates.UNAUTHORIZED:\n case TcpClientStates.AUTHENTICATING: {\n client.storage.authenticatedAt = null;\n break;\n }\n case TcpClientStates.AUTHENTICATED: {\n client.storage.authenticatedAt = new Date();\n\n if (client.storage.authenticateTimeout) {\n clearTimeout(client.storage.authenticateTimeout);\n client.storage.authenticateTimeout = null;\n }\n break;\n }\n default: {\n break;\n }\n }\n }\n\n emit(opts: { clientId: string; payload: Buffer | string }) {\n const { clientId, payload } = opts;\n const client = this.getClient({ id: clientId });\n\n if (!client) {\n this.logger.for(this.emit.name).error('Client NOT FOUND | ID: %s', clientId);\n return;\n }\n\n const { socket } = client;\n if (!socket.writable) {\n this.logger.for(this.emit.name).error('Client NOT WRITABLE | ID: %s', clientId);\n return;\n }\n\n if (!payload?.length) {\n this.logger\n .for(this.emit.name)\n .info(\n '[%s] Client %s | Invalid payload to write to TCP Socket!',\n this.identifier,\n clientId,\n );\n return;\n }\n\n socket.write(payload);\n }\n}\n"]}
1
+ {"version":3,"file":"base-tcp-server.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/tcp-socket/base-tcp-server.helper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAQ7D,6DAA6D;AAC7D,MAAM,OAAO,eAAe;aACV,iBAAY,GAAG,cAAc,CAAC;aAC9B,mBAAc,GAAG,gBAAgB,CAAC;aAClC,kBAAa,GAAG,eAAe,CAAC;aAEhC,eAAU,GAAG,IAAI,GAAG,CAAS;QAC3C,IAAI,CAAC,YAAY;QACjB,IAAI,CAAC,cAAc;QACnB,IAAI,CAAC,aAAa;KACnB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAmDH,iLAAiL;AACjL,MAAM,OAAO,oBAIX,SAAQ,UAAU;IA8BlB,YACE,IAAsF;QAEtF,KAAK,CAAC;YACJ,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,IAAI,oBAAoB,CAAC,IAAI;YACjE,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;QAnCK,kBAAa,GAAiC,EAAE,CAAC;QACjD,kBAAa,GAA2B,EAAE,CAAC;QAoCnD,oFAAoF;QACpF,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEnC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,mBAAmB,CAAC;QAEpD,IACE,IAAI,CAAC,mBAAmB,CAAC,QAAQ;YACjC,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,IAAI,IAAI,CAAC,mBAAmB,CAAC,QAAQ,GAAG,CAAC,CAAC,EAC7E,CAAC;YACD,MAAM,QAAQ,CAAC;gBACb,OAAO,EACL,wFAAwF;aAC3F,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC;QAE1C,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;QAE1C,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;QAExC,IAAI,CAAC,SAAS,EAAE,CAAC;IACnB,CAAC;IAED,4KAA4K;IAClK,UAAU,CAAC,IAA8C;QACjE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAElC,IAAI,CAAC;YACH,SAAS,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,SAAS;QACP,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE;YAC/D,IAAI,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,uLAAuL;QACvL,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YACvC,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;iBACxB,KAAK,CAAC,mDAAmD,EAAE,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;YAEzF,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;gBAC1B,SAAS,EAAE,GAAG,EAAE;oBACd,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBACvD,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE;YAC1C,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;iBACxB,IAAI,CAAC,kDAAkD,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;YAEhF,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;gBAC1B,SAAS,EAAE,GAAG,EAAE;oBACd,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;gBAChD,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,eAAe,CAAC,IAAkC;QAChD,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAExB,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC;QAEjC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAqB,EAAE,EAAE;YAC1C,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,cAAc;gBACrB,SAAS,EAAE,GAAG,EAAE;oBACd,IAAI,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC5C,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC;YAEzF,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,eAAe;gBACtB,SAAS,EAAE,GAAG,EAAE;oBACd,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC9C,CAAC;aACF,CAAC,CAAC;YAEH,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,QAAiB,EAAE,EAAE;YACvC,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,iBAAiB,CAAC;iBACtB,IAAI,CAAC,uCAAuC,EAAE,EAAE,EAAE,QAAQ,CAAC,CAAC;YAE/D,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,eAAe;gBACtB,SAAS,EAAE,GAAG,EAAE;oBACd,IAAI,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvC,CAAC;aACF,CAAC,CAAC;YAEH,MAAM,mBAAmB,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,mBAAmB,CAAC;YAEjF,IAAI,mBAAmB,EAAE,CAAC;gBACxB,YAAY,CAAC,mBAAmB,CAAC,CAAC;YACpC,CAAC;YAED,yFAAyF;YACzF,0FAA0F;YAC1F,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC1C,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE;gBAC7B,cAAc,CAAC,aAAa,CAAC;oBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,KAAK,EAAE,iBAAiB;oBACxB,4JAA4J;oBAC5J,SAAS,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE;iBAC9E,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG;YACjB,EAAE;YACF,MAAM;YACN,KAAK,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ;gBACtC,CAAC,CAAC,eAAe,CAAC,YAAY;gBAC9B,CAAC,CAAC,eAAe,CAAC,aAAa;YACjC,aAAa,EAAE,IAAI,GAAG,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE;gBACP,WAAW,EAAE,IAAI,IAAI,EAAE;gBACvB,eAAe,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE;aACvE;SACF,CAAC;QAEF,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,iBAAiB,CAAC;aACtB,IAAI,CACH,gEAAgE,EAChE,GAAG,EAAE,MAAM,MAAM,CAAC,aAAa,MAAM,MAAM,CAAC,UAAU,MAAM,MAAM,CAAC,YAAY,EAAE,EACjF,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EACjC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAClC,CAAC;QAEJ,IAAI,CAAC,UAAU,CAAC;YACd,KAAK,EAAE,mBAAmB;YAC1B,SAAS,EAAE,GAAG,EAAE;gBACd,IAAI,CAAC,iBAAiB,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC3C,CAAC;SACF,CAAC,CAAC;QAEH,IACE,IAAI,CAAC,mBAAmB,CAAC,QAAQ;YACjC,IAAI,CAAC,mBAAmB,CAAC,QAAQ;YACjC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,GAAG,CAAC,EACrC,CAAC;YACD,MAAM,mBAAmB,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;gBAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBAED,MAAM,CAAC,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;gBAE1C,IAAI,MAAM,CAAC,KAAK,KAAK,eAAe,CAAC,aAAa,EAAE,CAAC;oBACnD,OAAO;gBACT,CAAC;gBAED,IAAI,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAC,CAAC;gBAC5D,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;YACtB,CAAC,EAAE,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,CAAC;YAEtC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,YAAY,CAAC,mBAAmB,CAAC,CAAC;gBAElC,OAAO;YACT,CAAC;YAED,MAAM,CAAC,OAAO,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,SAAS,CAAC,IAAoB;QAC5B,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,0LAA0L;IAC1L,KAAK,CAAC,QAAQ;QACZ,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAElD,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;YACnC,MAAM,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC;YAE/C,IAAI,mBAAmB,EAAE,CAAC;gBACxB,YAAY,CAAC,mBAAmB,CAAC,CAAC;gBAClC,MAAM,CAAC,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;YAC5C,CAAC;YAED,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,+NAA+N;QAE/N,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAClC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACrB,IAAI,KAAK,EAAE,CAAC;oBACV,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;gBACzF,CAAC;gBAED,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,gCAAgC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC9F,CAAC;IAED,cAAc,CAAC,IAA4C;QACzD,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAE3B,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,KAAK,CAAC,2BAA2B,EAAE,EAAE,CAAC,CAAC;YAE7E,OAAO;QACT,CAAC;QAED,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;QAErB,QAAQ,KAAK,EAAE,CAAC;YACd,KAAK,eAAe,CAAC,YAAY,CAAC;YAClC,KAAK,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC;gBACpC,MAAM,CAAC,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;gBACtC,MAAM;YACR,CAAC;YACD,KAAK,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC;gBACnC,MAAM,CAAC,OAAO,CAAC,eAAe,GAAG,IAAI,IAAI,EAAE,CAAC;gBAE5C,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,EAAE,CAAC;oBACvC,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;oBACjD,MAAM,CAAC,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;gBAC5C,CAAC;gBAED,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAoD;QACvD,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACnC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEhD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;YAE7E,OAAO;QACT,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAE1B,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,8BAA8B,EAAE,QAAQ,CAAC,CAAC;YAEhF,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;iBACnB,IAAI,CACH,0DAA0D,EAC1D,IAAI,CAAC,UAAU,EACf,QAAQ,CACT,CAAC;YAEJ,OAAO;QACT,CAAC;QAED,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;CACF","sourcesContent":["import type { TConstValue } from '@/common/types';\nimport { type ValueOrPromise } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport { ParseUtility } from '@/utilities/parse.utility';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport {\n type ListenOptions,\n type ServerOpts,\n type Socket as SocketClient,\n type Server as SocketServer,\n} from 'node:net';\n\n/** Where a TCP client is in the authentication handshake. */\nexport class TcpClientStates {\n static readonly UNAUTHORIZED = 'unauthorized';\n static readonly AUTHENTICATING = 'authenticating';\n static readonly AUTHENTICATED = 'authenticated';\n\n static readonly SCHEME_SET = new Set<string>([\n this.UNAUTHORIZED,\n this.AUTHENTICATING,\n this.AUTHENTICATED,\n ]);\n\n static isValid(value: string): boolean {\n return this.SCHEME_SET.has(value);\n }\n}\n\n/** Valid TCP client state values. */\nexport type TTcpClientState = TConstValue<typeof TcpClientStates>;\n\n/** A client connected to `BaseNetworkTcpServer`: its `id`, `socket`, authentication `state`, `subscriptions` and `storage` (connect and authenticate times, the pending authenticate timer). */\nexport interface ITcpSocketClient<SocketClientType> {\n id: string;\n socket: SocketClientType;\n state: TTcpClientState;\n subscriptions: Set<string>;\n storage: {\n connectedAt: Date;\n authenticatedAt: Date | null;\n authenticateTimeout?: ReturnType<typeof setTimeout> | null;\n [additionField: symbol | string]: any;\n };\n}\n\n/** Options of `BaseNetworkTcpServer`. With `authenticateOptions.required`, `duration` (milliseconds, greater than 0) is how long a client has to authenticate before its socket is ended; the constructor throws without it. `createServerFn` builds the server, so one class serves plain and TLS. */\nexport interface ITcpSocketServerOptions<\n SocketServerOptions extends ServerOpts = ServerOpts,\n SocketServerType extends SocketServer = SocketServer,\n SocketClientType extends SocketClient = SocketClient,\n> {\n scope?: string;\n identifier: string;\n\n serverOptions: Partial<SocketServerOptions>;\n listenOptions: Partial<ListenOptions>;\n authenticateOptions: { required: boolean; duration?: number };\n\n extraEvents?: Record<\n string,\n (opts: { id: string; socket: SocketClientType; args: any }) => ValueOrPromise<void>\n >;\n\n createServerFn: (\n options: Partial<SocketServerOptions>,\n connectionListener: (socket: SocketClientType) => void,\n ) => SocketServerType;\n\n onServerReady?: (opts: { server: SocketServerType }) => void;\n onClientConnected?: (opts: { id: string; socket: SocketClientType }) => void;\n onClientData?: (opts: { id: string; socket: SocketClientType; data: Buffer | string }) => void;\n onClientClose?: (opts: { id: string; socket: SocketClientType }) => void;\n onClientError?: (opts: { id: string; socket: SocketClientType; error: Error }) => void;\n onServerError?: (opts: { server: SocketServerType; error: Error }) => void;\n}\n\n/** TCP or TLS server that tracks connected clients by id, with an optional authentication window, and reports connection events to the `onClient*` and `onServer*` callbacks. */\nexport class BaseNetworkTcpServer<\n SocketServerOptions extends ServerOpts = ServerOpts,\n SocketServerType extends SocketServer = SocketServer,\n SocketClientType extends SocketClient = SocketClient,\n> extends BaseHelper {\n protected serverOptions: Partial<SocketServerOptions> = {};\n protected listenOptions: Partial<ListenOptions> = {};\n protected authenticateOptions: { required: boolean; duration?: number };\n\n protected clients: Record<string, ITcpSocketClient<SocketClientType>>;\n protected server: SocketServerType;\n\n protected extraEvents: Record<\n string,\n (opts: { id: string; socket: SocketClientType; args: any }) => ValueOrPromise<void>\n >;\n\n protected createServerFn: (\n options: Partial<SocketServerOptions>,\n connectionListener: (socket: SocketClientType) => void,\n ) => SocketServerType;\n\n protected onServerReady?: (opts: { server: SocketServerType }) => void;\n protected onClientConnected?: (opts: { id: string; socket: SocketClientType }) => void;\n protected onClientData?: (opts: {\n id: string;\n socket: SocketClientType;\n data: Buffer | string;\n }) => void;\n\n protected onClientClose?: (opts: { id: string; socket: SocketClientType }) => void;\n protected onClientError?: (opts: { id: string; socket: SocketClientType; error: Error }) => void;\n protected onServerError?: (opts: { server: SocketServerType; error: Error }) => void;\n\n constructor(\n opts: ITcpSocketServerOptions<SocketServerOptions, SocketServerType, SocketClientType>,\n ) {\n super({\n scope: opts.scope ?? opts.identifier ?? BaseNetworkTcpServer.name,\n identifier: opts.identifier,\n });\n\n // No prototype: `getClient({ id: 'constructor' })` must find nothing, not `Object`.\n this.clients = Object.create(null);\n\n this.serverOptions = opts.serverOptions;\n this.listenOptions = opts.listenOptions;\n this.authenticateOptions = opts.authenticateOptions;\n\n if (\n this.authenticateOptions.required &&\n (!this.authenticateOptions.duration || this.authenticateOptions.duration < 0)\n ) {\n throw getError({\n message:\n 'TCP Server | Invalid authenticate duration | Required duration for authenticateOptions',\n });\n }\n\n this.extraEvents = opts.extraEvents ?? {};\n\n this.createServerFn = opts.createServerFn;\n\n this.onServerReady = opts.onServerReady;\n this.onClientConnected = opts.onClientConnected;\n this.onClientData = opts.onClientData;\n this.onClientClose = opts.onClientClose;\n this.onClientError = opts.onClientError;\n this.onServerError = opts.onServerError;\n\n this.configure();\n }\n\n // Hooks run inside socket event listeners: a synchronous throw there is an uncaught exception that kills the process and skips the client-registry cleanup that follows it.\n protected invokeHook(opts: { scope: string; execution: () => void }) {\n const { scope, execution } = opts;\n\n try {\n execution();\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n configure() {\n this.server = this.createServerFn(this.serverOptions, (socket) => {\n this.onNewConnection({ socket });\n });\n\n // Without this listener a failed listen - a port already in use is the commonest boot failure there is - emits an unhandled 'error' event, which takes the whole process down with it.\n this.server.on('error', (error: Error) => {\n this.logger\n .for(this.configure.name)\n .error('TCP Socket Server error | Options: %j | Error: %s', this.listenOptions, error);\n\n this.invokeHook({\n scope: this.configure.name,\n execution: () => {\n this.onServerError?.({ server: this.server, error });\n },\n });\n });\n\n this.server.listen(this.listenOptions, () => {\n this.logger\n .for(this.configure.name)\n .info('TCP Socket Server is now listening | Options: %j', this.listenOptions);\n\n this.invokeHook({\n scope: this.configure.name,\n execution: () => {\n this.onServerReady?.({ server: this.server });\n },\n });\n });\n }\n\n onNewConnection(opts: { socket: SocketClientType }) {\n const { socket } = opts;\n\n const id = ParseUtility.getUID();\n\n socket.on('data', (data: Buffer | string) => {\n this.invokeHook({\n scope: 'onClientData',\n execution: () => {\n this.onClientData?.({ id, socket, data });\n },\n });\n });\n\n socket.on('error', (error: Error) => {\n this.logger.for('onClientConnect').error('Socket Error | ID: %s | Error: %s', id, error);\n\n this.invokeHook({\n scope: 'onClientError',\n execution: () => {\n this.onClientError?.({ id, socket, error });\n },\n });\n\n socket.end();\n });\n\n socket.on('close', (hasError: boolean) => {\n this.logger\n .for('onClientConnect')\n .info('Socket Closed | ID: %s | hasError: %s', id, hasError);\n\n this.invokeHook({\n scope: 'onClientClose',\n execution: () => {\n this.onClientClose?.({ id, socket });\n },\n });\n\n const authenticateTimeout = this.getClient({ id })?.storage?.authenticateTimeout;\n\n if (authenticateTimeout) {\n clearTimeout(authenticateTimeout);\n }\n\n // `delete`, not `omit`: omit rebuilds the WHOLE registry per disconnect, so a disconnect\n // storm is O(n^2) - measured at 5000 clients, 2.3s of drain with a 2.2s worst-case stall.\n delete this.clients[id];\n });\n\n for (const extraEvent in this.extraEvents) {\n socket.on(extraEvent, (args) => {\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: 'onClientConnect',\n // The async wrapper turns a SYNCHRONOUS throw from the handler into a rejection; calling it bare would throw out of this listener as an uncaught exception.\n execution: (async () => this.extraEvents[extraEvent]({ id, socket, args }))(),\n });\n });\n }\n\n this.clients[id] = {\n id,\n socket,\n state: this.authenticateOptions.required\n ? TcpClientStates.UNAUTHORIZED\n : TcpClientStates.AUTHENTICATED,\n subscriptions: new Set([]),\n storage: {\n connectedAt: new Date(),\n authenticatedAt: this.authenticateOptions.required ? null : new Date(),\n },\n };\n\n this.logger\n .for('onClientConnect')\n .info(\n 'New TCP SocketClient | Client: %s | authenticateOptions: %s %s',\n `${id} - ${socket.remoteAddress} - ${socket.remotePort} - ${socket.remoteFamily}`,\n this.authenticateOptions.required,\n this.authenticateOptions.duration,\n );\n\n this.invokeHook({\n scope: 'onClientConnected',\n execution: () => {\n this.onClientConnected?.({ id, socket });\n },\n });\n\n if (\n this.authenticateOptions.required &&\n this.authenticateOptions.duration &&\n this.authenticateOptions.duration > 0\n ) {\n const authenticateTimeout = setTimeout(() => {\n const client = this.getClient({ id });\n\n if (!client) {\n return;\n }\n\n client.storage.authenticateTimeout = null;\n\n if (client.state === TcpClientStates.AUTHENTICATED) {\n return;\n }\n\n this.emit({ clientId: id, payload: 'Unauthorized Client' });\n client.socket.end();\n }, this.authenticateOptions.duration);\n\n const client = this.getClient({ id });\n\n if (!client) {\n clearTimeout(authenticateTimeout);\n\n return;\n }\n\n client.storage.authenticateTimeout = authenticateTimeout;\n }\n }\n\n getClients() {\n return this.clients;\n }\n\n getClient(opts: { id: string }) {\n return this.clients?.[opts.id];\n }\n\n getServer() {\n return this.server;\n }\n\n /** Clears timers and destroys all client sockets before closing the listener - `server.close()` alone never settles while a socket stays attached. Idempotent; safe if never listened. */\n async shutdown(): Promise<void> {\n const clientsValues = Object.values(this.clients);\n\n for (const client of clientsValues) {\n const { authenticateTimeout } = client.storage;\n\n if (authenticateTimeout) {\n clearTimeout(authenticateTimeout);\n client.storage.authenticateTimeout = null;\n }\n\n client.socket.destroy();\n }\n\n this.clients = Object.create(null);\n\n const server = this.server;\n\n if (!server) {\n return;\n }\n\n // Not guarded on `listening`: listen() is async (DNS lookup), so a shutdown() racing startup could skip close() and leave the server bound forever; close() on a never-listened server just logs ERR_SERVER_NOT_RUNNING below.\n\n await new Promise<void>((resolve) => {\n server.close((error) => {\n if (error) {\n this.logger.for(this.shutdown.name).error('Failed to close server | Error: %s', error);\n }\n\n resolve();\n });\n });\n\n this.logger.for(this.shutdown.name).info('Server closed | Identifier: %s', this.identifier);\n }\n\n doAuthenticate(opts: { id: string; state: TTcpClientState }) {\n const { id, state } = opts;\n\n const client = this.getClient({ id });\n\n if (!client) {\n this.logger.for('authenticateClient').error('Client NOT FOUND | ID: %s', id);\n\n return;\n }\n\n client.state = state;\n\n switch (state) {\n case TcpClientStates.UNAUTHORIZED:\n case TcpClientStates.AUTHENTICATING: {\n client.storage.authenticatedAt = null;\n break;\n }\n case TcpClientStates.AUTHENTICATED: {\n client.storage.authenticatedAt = new Date();\n\n if (client.storage.authenticateTimeout) {\n clearTimeout(client.storage.authenticateTimeout);\n client.storage.authenticateTimeout = null;\n }\n\n break;\n }\n default: {\n break;\n }\n }\n }\n\n emit(opts: { clientId: string; payload: Buffer | string }) {\n const { clientId, payload } = opts;\n const client = this.getClient({ id: clientId });\n\n if (!client) {\n this.logger.for(this.emit.name).error('Client NOT FOUND | ID: %s', clientId);\n\n return;\n }\n\n const { socket } = client;\n\n if (!socket.writable) {\n this.logger.for(this.emit.name).error('Client NOT WRITABLE | ID: %s', clientId);\n\n return;\n }\n\n if (!payload?.length) {\n this.logger\n .for(this.emit.name)\n .info(\n '[%s] Client %s | Invalid payload to write to TCP Socket!',\n this.identifier,\n clientId,\n );\n\n return;\n }\n\n socket.write(payload);\n }\n}\n"]}
@@ -1,5 +1,6 @@
1
1
  import { type Socket, type TcpSocketConnectOpts } from 'node:net';
2
2
  import { BaseNetworkTcpClient, type INetworkTcpClientProps } from './base-tcp-client.helper.js';
3
+ /** `BaseNetworkTcpClient` over a plain `node:net` socket. */
3
4
  export declare class NetworkTcpClient extends BaseNetworkTcpClient<TcpSocketConnectOpts, Socket> {
4
5
  constructor(opts: Omit<INetworkTcpClientProps<TcpSocketConnectOpts, Socket>, 'createClientFn'>);
5
6
  static newInstance(opts: Omit<INetworkTcpClientProps<TcpSocketConnectOpts, Socket>, 'createClientFn'>): NetworkTcpClient;
@@ -1,5 +1,6 @@
1
1
  import { connect } from 'node:net';
2
2
  import { BaseNetworkTcpClient } from './base-tcp-client.helper.js';
3
+ /** `BaseNetworkTcpClient` over a plain `node:net` socket. */
3
4
  export class NetworkTcpClient extends BaseNetworkTcpClient {
4
5
  constructor(opts) {
5
6
  super({
@@ -1 +1 @@
1
- {"version":3,"file":"network-tcp-client.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/tcp-socket/network-tcp-client.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA0C,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAA+B,MAAM,0BAA0B,CAAC;AAE7F,MAAM,OAAO,gBAAiB,SAAQ,oBAAkD;IACtF,YAAY,IAAkF;QAC5F,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,gBAAgB,CAAC,IAAI;YAC5B,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,WAAW,CAChB,IAAkF;QAElF,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF","sourcesContent":["import { connect, type Socket, type TcpSocketConnectOpts } from 'node:net';\nimport { BaseNetworkTcpClient, type INetworkTcpClientProps } from './base-tcp-client.helper';\n\nexport class NetworkTcpClient extends BaseNetworkTcpClient<TcpSocketConnectOpts, Socket> {\n constructor(opts: Omit<INetworkTcpClientProps<TcpSocketConnectOpts, Socket>, 'createClientFn'>) {\n super({\n ...opts,\n scope: NetworkTcpClient.name,\n createClientFn: connect,\n });\n this.options = opts.options;\n }\n\n static newInstance(\n opts: Omit<INetworkTcpClientProps<TcpSocketConnectOpts, Socket>, 'createClientFn'>,\n ) {\n return new NetworkTcpClient(opts);\n }\n}\n"]}
1
+ {"version":3,"file":"network-tcp-client.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/tcp-socket/network-tcp-client.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA0C,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAA+B,MAAM,0BAA0B,CAAC;AAE7F,6DAA6D;AAC7D,MAAM,OAAO,gBAAiB,SAAQ,oBAAkD;IACtF,YAAY,IAAkF;QAC5F,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,gBAAgB,CAAC,IAAI;YAC5B,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,WAAW,CAChB,IAAkF;QAElF,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF","sourcesContent":["import { connect, type Socket, type TcpSocketConnectOpts } from 'node:net';\nimport { BaseNetworkTcpClient, type INetworkTcpClientProps } from './base-tcp-client.helper';\n\n/** `BaseNetworkTcpClient` over a plain `node:net` socket. */\nexport class NetworkTcpClient extends BaseNetworkTcpClient<TcpSocketConnectOpts, Socket> {\n constructor(opts: Omit<INetworkTcpClientProps<TcpSocketConnectOpts, Socket>, 'createClientFn'>) {\n super({\n ...opts,\n scope: NetworkTcpClient.name,\n createClientFn: connect,\n });\n this.options = opts.options;\n }\n\n static newInstance(\n opts: Omit<INetworkTcpClientProps<TcpSocketConnectOpts, Socket>, 'createClientFn'>,\n ) {\n return new NetworkTcpClient(opts);\n }\n}\n"]}
@@ -1,5 +1,6 @@
1
1
  import { type ServerOpts, type Socket as SocketClient, type Server as SocketServer } from 'node:net';
2
2
  import { BaseNetworkTcpServer, type ITcpSocketServerOptions } from './base-tcp-server.helper.js';
3
+ /** Plain TCP server (`node:net`) on top of the shared base server; adds no behavior of its own. */
3
4
  export declare class NetworkTcpServer extends BaseNetworkTcpServer<ServerOpts, SocketServer, SocketClient> {
4
5
  constructor(opts: Omit<ITcpSocketServerOptions, 'createServerFn'>);
5
6
  static newInstance(opts: Omit<ITcpSocketServerOptions, 'createServerFn'>): NetworkTcpServer;
@@ -1,5 +1,6 @@
1
1
  import { createServer, } from 'node:net';
2
2
  import { BaseNetworkTcpServer } from './base-tcp-server.helper.js';
3
+ /** Plain TCP server (`node:net`) on top of the shared base server; adds no behavior of its own. */
3
4
  export class NetworkTcpServer extends BaseNetworkTcpServer {
4
5
  constructor(opts) {
5
6
  super({
@@ -1 +1 @@
1
- {"version":3,"file":"network-tcp-server.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/tcp-socket/network-tcp-server.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,GAIb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAgC,MAAM,0BAA0B,CAAC;AAE9F,MAAM,OAAO,gBAAiB,SAAQ,oBAA4D;IAChG,YAAY,IAAqD;QAC/D,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,gBAAgB,CAAC,IAAI;YAC5B,cAAc,EAAE,YAAY;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAqD;QACtE,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF","sourcesContent":["import {\n createServer,\n type ServerOpts,\n type Socket as SocketClient,\n type Server as SocketServer,\n} from 'node:net';\nimport { BaseNetworkTcpServer, type ITcpSocketServerOptions } from './base-tcp-server.helper';\n\nexport class NetworkTcpServer extends BaseNetworkTcpServer<ServerOpts, SocketServer, SocketClient> {\n constructor(opts: Omit<ITcpSocketServerOptions, 'createServerFn'>) {\n super({\n ...opts,\n scope: NetworkTcpServer.name,\n createServerFn: createServer,\n });\n }\n\n static newInstance(opts: Omit<ITcpSocketServerOptions, 'createServerFn'>) {\n return new NetworkTcpServer(opts);\n }\n}\n"]}
1
+ {"version":3,"file":"network-tcp-server.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/tcp-socket/network-tcp-server.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,GAIb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAgC,MAAM,0BAA0B,CAAC;AAE9F,mGAAmG;AACnG,MAAM,OAAO,gBAAiB,SAAQ,oBAA4D;IAChG,YAAY,IAAqD;QAC/D,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,gBAAgB,CAAC,IAAI;YAC5B,cAAc,EAAE,YAAY;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAAqD;QACtE,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF","sourcesContent":["import {\n createServer,\n type ServerOpts,\n type Socket as SocketClient,\n type Server as SocketServer,\n} from 'node:net';\nimport { BaseNetworkTcpServer, type ITcpSocketServerOptions } from './base-tcp-server.helper';\n\n/** Plain TCP server (`node:net`) on top of the shared base server; adds no behavior of its own. */\nexport class NetworkTcpServer extends BaseNetworkTcpServer<ServerOpts, SocketServer, SocketClient> {\n constructor(opts: Omit<ITcpSocketServerOptions, 'createServerFn'>) {\n super({\n ...opts,\n scope: NetworkTcpServer.name,\n createServerFn: createServer,\n });\n }\n\n static newInstance(opts: Omit<ITcpSocketServerOptions, 'createServerFn'>) {\n return new NetworkTcpServer(opts);\n }\n}\n"]}
@@ -1,5 +1,6 @@
1
1
  import { type ConnectionOptions, type TLSSocket } from 'node:tls';
2
2
  import { BaseNetworkTcpClient, type INetworkTcpClientProps } from './base-tcp-client.helper.js';
3
+ /** TLS TCP client (`node:tls` `connect`) on top of the shared base client; `options` are `tls.ConnectionOptions`. */
3
4
  export declare class NetworkTlsTcpClient extends BaseNetworkTcpClient<ConnectionOptions, TLSSocket> {
4
5
  constructor(opts: Omit<INetworkTcpClientProps<ConnectionOptions, TLSSocket>, 'createClientFn'>);
5
6
  static newInstance(opts: Omit<INetworkTcpClientProps<ConnectionOptions, TLSSocket>, 'createClientFn'>): NetworkTlsTcpClient;
@@ -1,5 +1,6 @@
1
1
  import { connect } from 'node:tls';
2
2
  import { BaseNetworkTcpClient } from './base-tcp-client.helper.js';
3
+ /** TLS TCP client (`node:tls` `connect`) on top of the shared base client; `options` are `tls.ConnectionOptions`. */
3
4
  export class NetworkTlsTcpClient extends BaseNetworkTcpClient {
4
5
  constructor(opts) {
5
6
  super({
@@ -1 +1 @@
1
- {"version":3,"file":"network-tls-tcp-client.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/tcp-socket/network-tls-tcp-client.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA0C,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAA+B,MAAM,0BAA0B,CAAC;AAE7F,MAAM,OAAO,mBAAoB,SAAQ,oBAAkD;IACzF,YAAY,IAAkF;QAC5F,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,mBAAmB,CAAC,IAAI;YAC/B,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,WAAW,CAChB,IAAkF;QAElF,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF","sourcesContent":["import { connect, type ConnectionOptions, type TLSSocket } from 'node:tls';\nimport { BaseNetworkTcpClient, type INetworkTcpClientProps } from './base-tcp-client.helper';\n\nexport class NetworkTlsTcpClient extends BaseNetworkTcpClient<ConnectionOptions, TLSSocket> {\n constructor(opts: Omit<INetworkTcpClientProps<ConnectionOptions, TLSSocket>, 'createClientFn'>) {\n super({\n ...opts,\n scope: NetworkTlsTcpClient.name,\n createClientFn: connect,\n });\n this.options = opts.options;\n }\n\n static newInstance(\n opts: Omit<INetworkTcpClientProps<ConnectionOptions, TLSSocket>, 'createClientFn'>,\n ) {\n return new NetworkTlsTcpClient(opts);\n }\n}\n"]}
1
+ {"version":3,"file":"network-tls-tcp-client.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/tcp-socket/network-tls-tcp-client.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA0C,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAA+B,MAAM,0BAA0B,CAAC;AAE7F,qHAAqH;AACrH,MAAM,OAAO,mBAAoB,SAAQ,oBAAkD;IACzF,YAAY,IAAkF;QAC5F,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,mBAAmB,CAAC,IAAI;YAC/B,cAAc,EAAE,OAAO;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,WAAW,CAChB,IAAkF;QAElF,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF","sourcesContent":["import { connect, type ConnectionOptions, type TLSSocket } from 'node:tls';\nimport { BaseNetworkTcpClient, type INetworkTcpClientProps } from './base-tcp-client.helper';\n\n/** TLS TCP client (`node:tls` `connect`) on top of the shared base client; `options` are `tls.ConnectionOptions`. */\nexport class NetworkTlsTcpClient extends BaseNetworkTcpClient<ConnectionOptions, TLSSocket> {\n constructor(opts: Omit<INetworkTcpClientProps<ConnectionOptions, TLSSocket>, 'createClientFn'>) {\n super({\n ...opts,\n scope: NetworkTlsTcpClient.name,\n createClientFn: connect,\n });\n this.options = opts.options;\n }\n\n static newInstance(\n opts: Omit<INetworkTcpClientProps<ConnectionOptions, TLSSocket>, 'createClientFn'>,\n ) {\n return new NetworkTlsTcpClient(opts);\n }\n}\n"]}
@@ -1,6 +1,7 @@
1
1
  import { type Server, type TLSSocket as SocketClient, type TlsOptions } from 'node:tls';
2
2
  import { BaseNetworkTcpServer, type ITcpSocketServerOptions } from './base-tcp-server.helper.js';
3
3
  type TTlsTcpServerOptions = Omit<ITcpSocketServerOptions<TlsOptions, Server, SocketClient>, 'createServerFn'>;
4
+ /** TLS TCP server (`node:tls`) on top of the shared base server; `serverOptions` are `tls.TlsOptions`. */
4
5
  export declare class NetworkTlsTcpServer extends BaseNetworkTcpServer<TlsOptions, Server, SocketClient> {
5
6
  constructor(opts: TTlsTcpServerOptions);
6
7
  static newInstance(opts: TTlsTcpServerOptions): NetworkTlsTcpServer;
@@ -1,5 +1,6 @@
1
1
  import { createServer, } from 'node:tls';
2
2
  import { BaseNetworkTcpServer } from './base-tcp-server.helper.js';
3
+ /** TLS TCP server (`node:tls`) on top of the shared base server; `serverOptions` are `tls.TlsOptions`. */
3
4
  export class NetworkTlsTcpServer extends BaseNetworkTcpServer {
4
5
  constructor(opts) {
5
6
  super({
@@ -1 +1 @@
1
- {"version":3,"file":"network-tls-tcp-server.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/tcp-socket/network-tls-tcp-server.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,GAIb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAgC,MAAM,0BAA0B,CAAC;AAO9F,MAAM,OAAO,mBAAoB,SAAQ,oBAAsD;IAC7F,YAAY,IAA0B;QACpC,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,mBAAmB,CAAC,IAAI;YAC/B,cAAc,EAAE,YAAY;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAA0B;QAC3C,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF","sourcesContent":["import {\n createServer,\n type Server,\n type TLSSocket as SocketClient,\n type TlsOptions,\n} from 'node:tls';\nimport { BaseNetworkTcpServer, type ITcpSocketServerOptions } from './base-tcp-server.helper';\n\ntype TTlsTcpServerOptions = Omit<\n ITcpSocketServerOptions<TlsOptions, Server, SocketClient>,\n 'createServerFn'\n>;\n\nexport class NetworkTlsTcpServer extends BaseNetworkTcpServer<TlsOptions, Server, SocketClient> {\n constructor(opts: TTlsTcpServerOptions) {\n super({\n ...opts,\n scope: NetworkTlsTcpServer.name,\n createServerFn: createServer,\n });\n }\n\n static newInstance(opts: TTlsTcpServerOptions) {\n return new NetworkTlsTcpServer(opts);\n }\n}\n"]}
1
+ {"version":3,"file":"network-tls-tcp-server.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/tcp-socket/network-tls-tcp-server.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,GAIb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,oBAAoB,EAAgC,MAAM,0BAA0B,CAAC;AAO9F,0GAA0G;AAC1G,MAAM,OAAO,mBAAoB,SAAQ,oBAAsD;IAC7F,YAAY,IAA0B;QACpC,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,mBAAmB,CAAC,IAAI;YAC/B,cAAc,EAAE,YAAY;SAC7B,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAA0B;QAC3C,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;CACF","sourcesContent":["import {\n createServer,\n type Server,\n type TLSSocket as SocketClient,\n type TlsOptions,\n} from 'node:tls';\nimport { BaseNetworkTcpServer, type ITcpSocketServerOptions } from './base-tcp-server.helper';\n\ntype TTlsTcpServerOptions = Omit<\n ITcpSocketServerOptions<TlsOptions, Server, SocketClient>,\n 'createServerFn'\n>;\n\n/** TLS TCP server (`node:tls`) on top of the shared base server; `serverOptions` are `tls.TlsOptions`. */\nexport class NetworkTlsTcpServer extends BaseNetworkTcpServer<TlsOptions, Server, SocketClient> {\n constructor(opts: TTlsTcpServerOptions) {\n super({\n ...opts,\n scope: NetworkTlsTcpServer.name,\n createServerFn: createServer,\n });\n }\n\n static newInstance(opts: TTlsTcpServerOptions) {\n return new NetworkTlsTcpServer(opts);\n }\n}\n"]}
@@ -43,6 +43,10 @@ interface INetworkUdpClientProps {
43
43
  };
44
44
  }) => ValueOrPromise<void>;
45
45
  }
46
+ /**
47
+ * UDP (`udp4`) socket that binds to `host`/`port` and optionally joins multicast groups.
48
+ * Port `0` asks the OS for a port; a negative or non-integer port is logged and ignored. Without `onConnected`/`onData`/`onClosed`/`onError`, the built-in handlers log.
49
+ */
46
50
  export declare class NetworkUdpClient extends BaseHelper {
47
51
  private host?;
48
52
  private port;
@@ -1,6 +1,10 @@
1
1
  import { BaseHelper } from '../../base.js';
2
2
  import { PromiseUtility } from '../../../utilities/promise.utility.js';
3
3
  import dgram from 'node:dgram';
4
+ /**
5
+ * UDP (`udp4`) socket that binds to `host`/`port` and optionally joins multicast groups.
6
+ * Port `0` asks the OS for a port; a negative or non-integer port is logged and ignored. Without `onConnected`/`onData`/`onClosed`/`onError`, the built-in handlers log.
7
+ */
4
8
  export class NetworkUdpClient extends BaseHelper {
5
9
  constructor(opts) {
6
10
  super({ scope: NetworkUdpClient.name, identifier: opts.identifier });
@@ -1 +1 @@
1
- {"version":3,"file":"network-udp-client.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/udp-socket/network-udp-client.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,KAAK,MAAM,YAAY,CAAC;AAgC/B,MAAM,OAAO,gBAAiB,SAAQ,UAAU;IAkC9C,YAAY,IAA4B;QACtC,KAAK,CAAC,EAAE,KAAK,EAAE,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAErE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QAE9C,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,IAAI,CAAC,eAAe,CAAC;QAC7D,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC;QAC9C,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC,YAAY,CAAC;QACpD,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC;QACjD,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,IAA4B;QAC7C,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,eAAe;QACb,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC;aAC9B,IAAI,CAAC,iDAAiD,EAAE,IAAI,CAAC,UAAU,EAAE;YACxE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC,CAAC;IACP,CAAC;IAED,UAAU,CAAC,IAAoF;QAC7F,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;aACzB,IAAI,CAAC,0BAA0B,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;YACvE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC,CAAC;IACP,CAAC;IAED,YAAY;QACV,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;aAC3B,IAAI,CAAC,iDAAiD,EAAE,IAAI,CAAC,UAAU,EAAE;YACxE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC,CAAC;IACP,CAAC;IAED,WAAW,CAAC,IAA0C;QACpD,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,KAAK,CAC1C,iDAAiD,EACjD,IAAI,CAAC,UAAU,EACf;YACE,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,EACD,IAAI,CAAC,KAAK,CACX,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;iBACtB,IAAI,CAAC,wCAAwC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,iGAAiG;QACjG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;iBACtB,IAAI,CACH,0DAA0D,EAC1D,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,IAAI,CACV,CAAC;YACJ,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM;aACR,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;aACtB,IAAI,CACH,0EAA0E,EAC1E,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,gBAAgB,CACtB,CAAC;QAEJ,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YAC3B,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI;gBAC7B,SAAS,EAAE,GAAG,EAAE;oBACd,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACrF,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAChC,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;gBAC5B,SAAS,EAAE,GAAG,EAAE;oBACd,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;gBAC3F,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;YAC/B,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI;gBAChC,SAAS,EAAE,GAAG,EAAE;oBACd,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBACxF,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,OAAwB,EAAE,UAA4B,EAAE,EAAE;YACnF,IAAI,CAAC,UAAU,CAAC;gBACd,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;gBAC3B,SAAS,EAAE,GAAG,EAAE;oBACd,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC,CAAC;gBACtE,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,GAAG,EAAE;YAC7D,cAAc,CAAC,aAAa,CAAC;gBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,MAAM;gBACb,sKAAsK;gBACtK,SAAS,EAAE,CAAC,KAAK,IAAI,EAAE,CACrB,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,MAAM,EAAE,IAAI,CAAC,MAAO;oBACpB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;iBACxC,CAAC,CAAC,EAAE;aACR,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,8FAA8F;IACtF,UAAU,CAAC,IAA8C;QAC/D,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAElC,IAAI,CAAC;YACH,SAAS,EAAE,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,UAAU;QACR,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;iBACzB,IAAI,CAAC,wCAAwC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QAErB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,kCAAkC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAClG,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF","sourcesContent":["import { type ValueOrPromise } from '@/common';\nimport { BaseHelper } from '@/modules/base';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport dgram from 'node:dgram';\n\ninterface INetworkUdpClientProps {\n identifier: string;\n\n host?: string;\n port: number;\n reuseAddr?: boolean;\n\n multicastAddress?: {\n groups?: Array<string>;\n interface?: string;\n };\n\n onConnected?: (opts: { identifier: string; host?: string; port: number }) => void;\n onData?: (opts: {\n identifier: string;\n message: string | Buffer;\n remoteInfo: dgram.RemoteInfo;\n }) => void;\n onClosed?: (opts: { identifier: string; host?: string; port: number }) => void;\n onError?: (opts: { identifier: string; host?: string; port: number; error: Error }) => void;\n onBind?: (opts: {\n identifier: string;\n socket: dgram.Socket;\n host?: string;\n port: number;\n reuseAddr?: boolean;\n multicastAddress?: { groups?: Array<string>; interface?: string };\n }) => ValueOrPromise<void>;\n}\n\nexport class NetworkUdpClient extends BaseHelper {\n private host?: string;\n private port: number;\n private reuseAddr?: boolean;\n\n private multicastAddress?: {\n groups?: Array<string>;\n interface?: string;\n };\n\n private onConnected: (opts: { identifier: string; host?: string; port: number }) => void;\n private onData: (opts: {\n identifier: string;\n message: string | Buffer;\n remoteInfo: dgram.RemoteInfo;\n }) => void;\n private onClosed?: (opts: { identifier: string; host?: string; port: number }) => void;\n private onError?: (opts: {\n identifier: string;\n host?: string;\n port: number;\n error: Error;\n }) => void;\n private onBind?: (opts: {\n identifier: string;\n socket: dgram.Socket;\n host?: string;\n port: number;\n reuseAddr?: boolean;\n multicastAddress?: { groups?: Array<string>; interface?: string };\n }) => ValueOrPromise<void>;\n\n private client?: dgram.Socket | null;\n\n constructor(opts: INetworkUdpClientProps) {\n super({ scope: NetworkUdpClient.name, identifier: opts.identifier });\n\n this.host = opts.host;\n this.port = opts.port;\n this.reuseAddr = opts.reuseAddr;\n this.multicastAddress = opts.multicastAddress;\n\n this.onConnected = opts?.onConnected ?? this.handleConnected;\n this.onData = opts?.onData ?? this.handleData;\n this.onClosed = opts?.onClosed ?? this.handleClosed;\n this.onError = opts?.onError ?? this.handleError;\n this.onBind = opts?.onBind;\n }\n\n static newInstance(opts: INetworkUdpClientProps) {\n return new NetworkUdpClient(opts);\n }\n\n getClient() {\n return this.client;\n }\n\n handleConnected() {\n this.logger\n .for(this.handleConnected.name)\n .info('[%s] Successfully bind connection | Options: %j', this.identifier, {\n host: this.host,\n port: this.port,\n multicastAddress: this.multicastAddress,\n });\n }\n\n handleData(opts: { identifier: string; message: string | Buffer; remoteInfo: dgram.RemoteInfo }) {\n this.logger\n .for(this.handleData.name)\n .info('[%s][%s:%d][<==] Raw: %s', this.identifier, this.host, this.port, {\n message: opts.message,\n remoteInfo: opts.remoteInfo,\n });\n }\n\n handleClosed() {\n this.logger\n .for(this.handleClosed.name)\n .info('[%s] Closed connection UDP Server | Options: %j', this.identifier, {\n host: this.host,\n port: this.port,\n multicastAddress: this.multicastAddress,\n });\n }\n\n handleError(opts: { identifier: string; error: Error }) {\n this.logger.for(this.handleError.name).error(\n '[%s] Connection error | Options: %j | Error: %s',\n this.identifier,\n {\n host: this.host,\n port: this.port,\n },\n opts.error,\n );\n }\n\n connect() {\n if (this.client) {\n this.logger\n .for(this.connect.name)\n .info('[%s] UdpClient is already initialized!', this.identifier);\n return;\n }\n\n // Port 0 is a VALID request for an OS assigned port - only a missing / negative port is invalid.\n if (!Number.isInteger(this.port) || this.port < 0) {\n this.logger\n .for(this.connect.name)\n .info(\n '[%s] Cannot init UDP Client with invalid port | Port: %s',\n this.identifier,\n this.port,\n );\n return;\n }\n\n this.logger\n .for(this.connect.name)\n .info(\n '[%s] New network udp client | Host: %s | Port: %s | multicastAddress: %j',\n this.identifier,\n this.host,\n this.port,\n this.multicastAddress,\n );\n\n this.client = dgram.createSocket({ type: 'udp4', reuseAddr: this.reuseAddr });\n this.client.on('close', () => {\n this.invokeHook({\n scope: this.handleClosed.name,\n execution: () => {\n this.onClosed?.({ identifier: this.identifier, host: this.host, port: this.port });\n },\n });\n });\n\n this.client.on('error', (error) => {\n this.invokeHook({\n scope: this.handleError.name,\n execution: () => {\n this.onError?.({ identifier: this.identifier, host: this.host, port: this.port, error });\n },\n });\n });\n\n this.client.on('listening', () => {\n this.invokeHook({\n scope: this.handleConnected.name,\n execution: () => {\n this.onConnected?.({ identifier: this.identifier, host: this.host, port: this.port });\n },\n });\n });\n\n this.client.on('message', (message: string | Buffer, remoteInfo: dgram.RemoteInfo) => {\n this.invokeHook({\n scope: this.handleData.name,\n execution: () => {\n this.onData?.({ identifier: this.identifier, message, remoteInfo });\n },\n });\n });\n\n this.client.bind({ port: this.port, address: this.host }, () => {\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: 'bind',\n // The async wrapper turns a SYNCHRONOUS throw from onBind into a rejection; calling it bare would throw out of the dgram listening listener as an uncaught exception.\n execution: (async () =>\n this.onBind?.({\n identifier: this.identifier,\n socket: this.client!,\n host: this.host,\n port: this.port,\n reuseAddr: this.reuseAddr,\n multicastAddress: this.multicastAddress,\n }))(),\n });\n });\n }\n\n // Hooks run inside dgram event listeners: a synchronous throw there is an uncaught exception.\n private invokeHook(opts: { scope: string; execution: () => void }) {\n const { scope, execution } = opts;\n\n try {\n execution();\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n disconnect() {\n if (!this.client) {\n this.logger\n .for(this.disconnect.name)\n .info('[%s] UdpClient is not initialized yet!', this.identifier);\n return;\n }\n\n this.client?.close();\n\n this.client = null;\n this.logger.for(this.disconnect.name).info('UdpClient is destroyed! | ID: %s', this.identifier);\n }\n\n isConnected() {\n return this.client;\n }\n}\n"]}
1
+ {"version":3,"file":"network-udp-client.helper.js","sourceRoot":"","sources":["../../../../../src/modules/network/udp-socket/network-udp-client.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { type ValueOrPromise } from '@/common';\nimport { BaseHelper } from '@/modules/base';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport dgram from 'node:dgram';\n\ninterface INetworkUdpClientProps {\n identifier: string;\n\n host?: string;\n port: number;\n reuseAddr?: boolean;\n\n multicastAddress?: {\n groups?: Array<string>;\n interface?: string;\n };\n\n onConnected?: (opts: { identifier: string; host?: string; port: number }) => void;\n onData?: (opts: {\n identifier: string;\n message: string | Buffer;\n remoteInfo: dgram.RemoteInfo;\n }) => void;\n onClosed?: (opts: { identifier: string; host?: string; port: number }) => void;\n onError?: (opts: { identifier: string; host?: string; port: number; error: Error }) => void;\n onBind?: (opts: {\n identifier: string;\n socket: dgram.Socket;\n host?: string;\n port: number;\n reuseAddr?: boolean;\n multicastAddress?: { groups?: Array<string>; interface?: string };\n }) => ValueOrPromise<void>;\n}\n\n/**\n * UDP (`udp4`) socket that binds to `host`/`port` and optionally joins multicast groups.\n * Port `0` asks the OS for a port; a negative or non-integer port is logged and ignored. Without `onConnected`/`onData`/`onClosed`/`onError`, the built-in handlers log.\n */\nexport class NetworkUdpClient extends BaseHelper {\n private host?: string;\n private port: number;\n private reuseAddr?: boolean;\n\n private multicastAddress?: {\n groups?: Array<string>;\n interface?: string;\n };\n\n private onConnected: (opts: { identifier: string; host?: string; port: number }) => void;\n private onData: (opts: {\n identifier: string;\n message: string | Buffer;\n remoteInfo: dgram.RemoteInfo;\n }) => void;\n\n private onClosed?: (opts: { identifier: string; host?: string; port: number }) => void;\n private onError?: (opts: {\n identifier: string;\n host?: string;\n port: number;\n error: Error;\n }) => void;\n\n private onBind?: (opts: {\n identifier: string;\n socket: dgram.Socket;\n host?: string;\n port: number;\n reuseAddr?: boolean;\n multicastAddress?: { groups?: Array<string>; interface?: string };\n }) => ValueOrPromise<void>;\n\n private client?: dgram.Socket | null;\n\n constructor(opts: INetworkUdpClientProps) {\n super({ scope: NetworkUdpClient.name, identifier: opts.identifier });\n\n this.host = opts.host;\n this.port = opts.port;\n this.reuseAddr = opts.reuseAddr;\n this.multicastAddress = opts.multicastAddress;\n\n this.onConnected = opts?.onConnected ?? this.handleConnected;\n this.onData = opts?.onData ?? this.handleData;\n this.onClosed = opts?.onClosed ?? this.handleClosed;\n this.onError = opts?.onError ?? this.handleError;\n this.onBind = opts?.onBind;\n }\n\n static newInstance(opts: INetworkUdpClientProps) {\n return new NetworkUdpClient(opts);\n }\n\n getClient() {\n return this.client;\n }\n\n handleConnected() {\n this.logger\n .for(this.handleConnected.name)\n .info('[%s] Successfully bind connection | Options: %j', this.identifier, {\n host: this.host,\n port: this.port,\n multicastAddress: this.multicastAddress,\n });\n }\n\n handleData(opts: { identifier: string; message: string | Buffer; remoteInfo: dgram.RemoteInfo }) {\n this.logger\n .for(this.handleData.name)\n .info('[%s][%s:%d][<==] Raw: %s', this.identifier, this.host, this.port, {\n message: opts.message,\n remoteInfo: opts.remoteInfo,\n });\n }\n\n handleClosed() {\n this.logger\n .for(this.handleClosed.name)\n .info('[%s] Closed connection UDP Server | Options: %j', this.identifier, {\n host: this.host,\n port: this.port,\n multicastAddress: this.multicastAddress,\n });\n }\n\n handleError(opts: { identifier: string; error: Error }) {\n this.logger.for(this.handleError.name).error(\n '[%s] Connection error | Options: %j | Error: %s',\n this.identifier,\n {\n host: this.host,\n port: this.port,\n },\n opts.error,\n );\n }\n\n connect() {\n if (this.client) {\n this.logger\n .for(this.connect.name)\n .info('[%s] UdpClient is already initialized!', this.identifier);\n\n return;\n }\n\n // Port 0 is a VALID request for an OS assigned port - only a missing / negative port is invalid.\n if (!Number.isInteger(this.port) || this.port < 0) {\n this.logger\n .for(this.connect.name)\n .info(\n '[%s] Cannot init UDP Client with invalid port | Port: %s',\n this.identifier,\n this.port,\n );\n\n return;\n }\n\n this.logger\n .for(this.connect.name)\n .info(\n '[%s] New network udp client | Host: %s | Port: %s | multicastAddress: %j',\n this.identifier,\n this.host,\n this.port,\n this.multicastAddress,\n );\n\n this.client = dgram.createSocket({ type: 'udp4', reuseAddr: this.reuseAddr });\n this.client.on('close', () => {\n this.invokeHook({\n scope: this.handleClosed.name,\n execution: () => {\n this.onClosed?.({ identifier: this.identifier, host: this.host, port: this.port });\n },\n });\n });\n\n this.client.on('error', (error) => {\n this.invokeHook({\n scope: this.handleError.name,\n execution: () => {\n this.onError?.({ identifier: this.identifier, host: this.host, port: this.port, error });\n },\n });\n });\n\n this.client.on('listening', () => {\n this.invokeHook({\n scope: this.handleConnected.name,\n execution: () => {\n this.onConnected?.({ identifier: this.identifier, host: this.host, port: this.port });\n },\n });\n });\n\n this.client.on('message', (message: string | Buffer, remoteInfo: dgram.RemoteInfo) => {\n this.invokeHook({\n scope: this.handleData.name,\n execution: () => {\n this.onData?.({ identifier: this.identifier, message, remoteInfo });\n },\n });\n });\n\n this.client.bind({ port: this.port, address: this.host }, () => {\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: 'bind',\n // The async wrapper turns a SYNCHRONOUS throw from onBind into a rejection; calling it bare would throw out of the dgram listening listener as an uncaught exception.\n execution: (async () =>\n this.onBind?.({\n identifier: this.identifier,\n socket: this.client!,\n host: this.host,\n port: this.port,\n reuseAddr: this.reuseAddr,\n multicastAddress: this.multicastAddress,\n }))(),\n });\n });\n }\n\n // Hooks run inside dgram event listeners: a synchronous throw there is an uncaught exception.\n private invokeHook(opts: { scope: string; execution: () => void }) {\n const { scope, execution } = opts;\n\n try {\n execution();\n } catch (error) {\n this.logger.for(scope).error('Hook execution FAILED | Error: %s', error);\n }\n }\n\n disconnect() {\n if (!this.client) {\n this.logger\n .for(this.disconnect.name)\n .info('[%s] UdpClient is not initialized yet!', this.identifier);\n\n return;\n }\n\n this.client?.close();\n\n this.client = null;\n this.logger.for(this.disconnect.name).info('UdpClient is destroyed! | ID: %s', this.identifier);\n }\n\n isConnected() {\n return this.client;\n }\n}\n"]}
@@ -15,6 +15,7 @@ export declare class QueryStringNullishModes {
15
15
  /** The pair is left out. */
16
16
  static readonly SKIP = "skip";
17
17
  }
18
+ /** What {@link QueryStringNullishModes} selects: `empty` or `skip`. */
18
19
  export type TQueryStringNullishMode = TConstValue<typeof QueryStringNullishModes>;
19
20
  /** What an object or an array value becomes. */
20
21
  export declare class QueryStringNestedModes {
@@ -23,12 +24,22 @@ export declare class QueryStringNestedModes {
23
24
  /** One JSON-encoded parameter (`ids=[1,2]`, `filter={"where":{}}`), the shape a JSON filter travels in. */
24
25
  static readonly JSON = "json";
25
26
  }
27
+ /** What {@link QueryStringNestedModes} selects: `drop` or `json`. */
26
28
  export type TQueryStringNestedMode = TConstValue<typeof QueryStringNestedModes>;
27
- /** How {@link QueryStringUtility.toQueryString} treats the values `node:querystring` has no answer for. Both default to its behavior. */
29
+ /** How {@link QueryStringUtility.toQueryString} treats the values `node:querystring` has no answer for. */
28
30
  export interface IQueryStringOptions {
31
+ /**
32
+ * What a `null` or `undefined` value becomes.
33
+ * @default QueryStringNullishModes.EMPTY
34
+ */
29
35
  nullish?: TQueryStringNullishMode;
36
+ /**
37
+ * What an object or an array value becomes.
38
+ * @default QueryStringNestedModes.DROP
39
+ */
30
40
  nested?: TQueryStringNestedMode;
31
41
  }
42
+ /** Builds a query string without a node builtin, so the network layer stays browser-safe. */
32
43
  export declare class QueryStringUtility {
33
44
  /**
34
45
  * `node:querystring`'s `stringify`, written out so nothing on the HTTP path carries a node builtin -
@@ -44,7 +55,7 @@ export declare class QueryStringUtility {
44
55
  *
45
56
  * `nullish: 'skip'` leaves a null or undefined pair out. `nested: 'json'` sends an object or an
46
57
  * array as ONE JSON parameter instead (an array does not repeat its key), so a filter object survives
47
- * the trip. The defaults keep the behavior above.
58
+ * the trip. Without them the behavior is the one above.
48
59
  */
49
60
  static toQueryString(opts: {
50
61
  params: AnyObject;
@@ -21,6 +21,7 @@ export class QueryStringNestedModes {
21
21
  /** One JSON-encoded parameter (`ids=[1,2]`, `filter={"where":{}}`), the shape a JSON filter travels in. */
22
22
  static { this.JSON = 'json'; }
23
23
  }
24
+ /** Builds a query string without a node builtin, so the network layer stays browser-safe. */
24
25
  export class QueryStringUtility {
25
26
  /**
26
27
  * `node:querystring`'s `stringify`, written out so nothing on the HTTP path carries a node builtin -
@@ -36,7 +37,7 @@ export class QueryStringUtility {
36
37
  *
37
38
  * `nullish: 'skip'` leaves a null or undefined pair out. `nested: 'json'` sends an object or an
38
39
  * array as ONE JSON parameter instead (an array does not repeat its key), so a filter object survives
39
- * the trip. The defaults keep the behavior above.
40
+ * the trip. Without them the behavior is the one above.
40
41
  */
41
42
  static toQueryString(opts) {
42
43
  const { params, nullish = QueryStringNullishModes.EMPTY, nested = QueryStringNestedModes.DROP, } = opts;
@@ -1 +1 @@
1
- {"version":3,"file":"query-string.js","sourceRoot":"","sources":["../../../../../src/modules/network/utilities/query-string.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,MAAM,OAAO,qBAAqB;IAChC,2CAA2C;aAC3B,UAAK,GAAG,GAAG,CAAC;IAC5B,yBAAyB;aACT,SAAI,GAAG,GAAG,CAAC;IAC3B,oCAAoC;aACpB,WAAM,GAAG,GAAG,CAAC;;AAG/B,kDAAkD;AAClD,MAAM,OAAO,uBAAuB;IAClC,2DAA2D;aAC3C,UAAK,GAAG,OAAO,CAAC;IAChC,4BAA4B;aACZ,SAAI,GAAG,MAAM,CAAC;;AAIhC,gDAAgD;AAChD,MAAM,OAAO,sBAAsB;IACjC,uFAAuF;aACvE,SAAI,GAAG,MAAM,CAAC;IAC9B,2GAA2G;aAC3F,SAAI,GAAG,MAAM,CAAC;;AAUhC,MAAM,OAAO,kBAAkB;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,aAAa,CAAC,IAAiD;QACpE,MAAM,EACJ,MAAM,EACN,OAAO,GAAG,uBAAuB,CAAC,KAAK,EACvC,MAAM,GAAG,sBAAsB,CAAC,IAAI,GACrC,GAAG,IAAI,CAAC;QACT,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE,CACnC,OAAO,KAAK,uBAAuB,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,MAAM,KAAK,sBAAsB,CAAC,IAAI,CAAC;QAEtD,kGAAkG;QAClG,iGAAiG;QACjG,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE,CAChC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ;YAChE,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAExC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAErC,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,IAAI,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1D,KAAK,CAAC,IAAI,CACR,GAAG,IAAI,GAAG,qBAAqB,CAAC,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CACrF,CAAC;gBACF,SAAS;YACX,CAAC;YAED,2EAA2E;YAC3E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;oBAC1B,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;wBACrB,SAAS;oBACX,CAAC;oBAED,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,qBAAqB,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACvE,CAAC;gBAED,SAAS;YACX,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,qBAAqB,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;CACF","sourcesContent":["import { type AnyObject, type TConstValue } from '@/common/types';\n\n/** The punctuation of a query string, named so a reader sees the role rather than the character. */\nexport class QueryStringSeparators {\n /** Between the path and the first pair. */\n static readonly START = '?';\n /** Between two pairs. */\n static readonly PAIR = '&';\n /** Between a name and its value. */\n static readonly ASSIGN = '=';\n}\n\n/** What a `null` or `undefined` value becomes. */\nexport class QueryStringNullishModes {\n /** An empty value (`a=`): what `node:querystring` does. */\n static readonly EMPTY = 'empty';\n /** The pair is left out. */\n static readonly SKIP = 'skip';\n}\nexport type TQueryStringNullishMode = TConstValue<typeof QueryStringNullishModes>;\n\n/** What an object or an array value becomes. */\nexport class QueryStringNestedModes {\n /** An empty value (an array repeats its key instead): what `node:querystring` does. */\n static readonly DROP = 'drop';\n /** One JSON-encoded parameter (`ids=[1,2]`, `filter={\"where\":{}}`), the shape a JSON filter travels in. */\n static readonly JSON = 'json';\n}\nexport type TQueryStringNestedMode = TConstValue<typeof QueryStringNestedModes>;\n\n/** How {@link QueryStringUtility.toQueryString} treats the values `node:querystring` has no answer for. Both default to its behavior. */\nexport interface IQueryStringOptions {\n nullish?: TQueryStringNullishMode;\n nested?: TQueryStringNestedMode;\n}\n\nexport class QueryStringUtility {\n /**\n * `node:querystring`'s `stringify`, written out so nothing on the HTTP path carries a node builtin -\n * that one import is what kept the whole network layer out of a browser bundle.\n *\n * Not `new URLSearchParams(params).toString()`, which differs on four counts measured against the\n * original: an array becomes `a=1%2C2` instead of `a=1&a=2`, `undefined` and `null` become the\n * STRINGS \"undefined\" and \"null\" instead of an empty value, and a space encodes as `+` rather than\n * `%20`. The first changes what a server parses; the second is the same coercion that sends a header\n * reading \"undefined\".\n *\n * Diffed against `node:querystring` across 22 shapes with zero mismatches.\n *\n * `nullish: 'skip'` leaves a null or undefined pair out. `nested: 'json'` sends an object or an\n * array as ONE JSON parameter instead (an array does not repeat its key), so a filter object survives\n * the trip. The defaults keep the behavior above.\n */\n static toQueryString(opts: { params: AnyObject } & IQueryStringOptions): string {\n const {\n params,\n nullish = QueryStringNullishModes.EMPTY,\n nested = QueryStringNestedModes.DROP,\n } = opts;\n const parts: string[] = [];\n const isSkipped = (value: unknown) =>\n nullish === QueryStringNullishModes.SKIP && (value === null || value === undefined);\n const isJson = nested === QueryStringNestedModes.JSON;\n\n // A primitive only. `querystring` drops an object or a nested array to an empty value rather than\n // stringifying it, and a caller that passed one meant something this format cannot carry anyway.\n const encode = (value: unknown) =>\n value === null || value === undefined || typeof value === 'object'\n ? ''\n : encodeURIComponent(String(value));\n\n const entries = Object.entries(params);\n for (const [key, value] of entries) {\n const name = encodeURIComponent(key);\n\n if (isSkipped(value)) {\n continue;\n }\n\n if (isJson && typeof value === 'object' && value !== null) {\n parts.push(\n `${name}${QueryStringSeparators.ASSIGN}${encodeURIComponent(JSON.stringify(value))}`,\n );\n continue;\n }\n\n // An array repeats the key, which is what a server reading a list expects.\n if (Array.isArray(value)) {\n for (const entry of value) {\n if (isSkipped(entry)) {\n continue;\n }\n\n parts.push(`${name}${QueryStringSeparators.ASSIGN}${encode(entry)}`);\n }\n\n continue;\n }\n\n parts.push(`${name}${QueryStringSeparators.ASSIGN}${encode(value)}`);\n }\n\n return parts.join(QueryStringSeparators.PAIR);\n }\n}\n"]}
1
+ {"version":3,"file":"query-string.js","sourceRoot":"","sources":["../../../../../src/modules/network/utilities/query-string.ts"],"names":[],"mappings":"AAEA,oGAAoG;AACpG,MAAM,OAAO,qBAAqB;IAChC,2CAA2C;aAC3B,UAAK,GAAG,GAAG,CAAC;IAC5B,yBAAyB;aACT,SAAI,GAAG,GAAG,CAAC;IAC3B,oCAAoC;aACpB,WAAM,GAAG,GAAG,CAAC;;AAG/B,kDAAkD;AAClD,MAAM,OAAO,uBAAuB;IAClC,2DAA2D;aAC3C,UAAK,GAAG,OAAO,CAAC;IAChC,4BAA4B;aACZ,SAAI,GAAG,MAAM,CAAC;;AAKhC,gDAAgD;AAChD,MAAM,OAAO,sBAAsB;IACjC,uFAAuF;aACvE,SAAI,GAAG,MAAM,CAAC;IAC9B,2GAA2G;aAC3F,SAAI,GAAG,MAAM,CAAC;;AAmBhC,6FAA6F;AAC7F,MAAM,OAAO,kBAAkB;IAC7B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,aAAa,CAAC,IAAiD;QACpE,MAAM,EACJ,MAAM,EACN,OAAO,GAAG,uBAAuB,CAAC,KAAK,EACvC,MAAM,GAAG,sBAAsB,CAAC,IAAI,GACrC,GAAG,IAAI,CAAC;QACT,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,CAAC,KAAc,EAAE,EAAE,CACnC,OAAO,KAAK,uBAAuB,CAAC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC;QACtF,MAAM,MAAM,GAAG,MAAM,KAAK,sBAAsB,CAAC,IAAI,CAAC;QAEtD,kGAAkG;QAClG,iGAAiG;QACjG,MAAM,MAAM,GAAG,CAAC,KAAc,EAAE,EAAE,CAChC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ;YAChE,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAExC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,OAAO,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAErC,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBACrB,SAAS;YACX,CAAC;YAED,IAAI,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAC1D,KAAK,CAAC,IAAI,CACR,GAAG,IAAI,GAAG,qBAAqB,CAAC,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CACrF,CAAC;gBACF,SAAS;YACX,CAAC;YAED,2EAA2E;YAC3E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;oBAC1B,IAAI,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;wBACrB,SAAS;oBACX,CAAC;oBAED,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,qBAAqB,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACvE,CAAC;gBAED,SAAS;YACX,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,qBAAqB,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACvE,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;CACF","sourcesContent":["import { type AnyObject, type TConstValue } from '@/common/types';\n\n/** The punctuation of a query string, named so a reader sees the role rather than the character. */\nexport class QueryStringSeparators {\n /** Between the path and the first pair. */\n static readonly START = '?';\n /** Between two pairs. */\n static readonly PAIR = '&';\n /** Between a name and its value. */\n static readonly ASSIGN = '=';\n}\n\n/** What a `null` or `undefined` value becomes. */\nexport class QueryStringNullishModes {\n /** An empty value (`a=`): what `node:querystring` does. */\n static readonly EMPTY = 'empty';\n /** The pair is left out. */\n static readonly SKIP = 'skip';\n}\n/** What {@link QueryStringNullishModes} selects: `empty` or `skip`. */\nexport type TQueryStringNullishMode = TConstValue<typeof QueryStringNullishModes>;\n\n/** What an object or an array value becomes. */\nexport class QueryStringNestedModes {\n /** An empty value (an array repeats its key instead): what `node:querystring` does. */\n static readonly DROP = 'drop';\n /** One JSON-encoded parameter (`ids=[1,2]`, `filter={\"where\":{}}`), the shape a JSON filter travels in. */\n static readonly JSON = 'json';\n}\n/** What {@link QueryStringNestedModes} selects: `drop` or `json`. */\nexport type TQueryStringNestedMode = TConstValue<typeof QueryStringNestedModes>;\n\n/** How {@link QueryStringUtility.toQueryString} treats the values `node:querystring` has no answer for. */\nexport interface IQueryStringOptions {\n /**\n * What a `null` or `undefined` value becomes.\n * @default QueryStringNullishModes.EMPTY\n */\n nullish?: TQueryStringNullishMode;\n /**\n * What an object or an array value becomes.\n * @default QueryStringNestedModes.DROP\n */\n nested?: TQueryStringNestedMode;\n}\n\n/** Builds a query string without a node builtin, so the network layer stays browser-safe. */\nexport class QueryStringUtility {\n /**\n * `node:querystring`'s `stringify`, written out so nothing on the HTTP path carries a node builtin -\n * that one import is what kept the whole network layer out of a browser bundle.\n *\n * Not `new URLSearchParams(params).toString()`, which differs on four counts measured against the\n * original: an array becomes `a=1%2C2` instead of `a=1&a=2`, `undefined` and `null` become the\n * STRINGS \"undefined\" and \"null\" instead of an empty value, and a space encodes as `+` rather than\n * `%20`. The first changes what a server parses; the second is the same coercion that sends a header\n * reading \"undefined\".\n *\n * Diffed against `node:querystring` across 22 shapes with zero mismatches.\n *\n * `nullish: 'skip'` leaves a null or undefined pair out. `nested: 'json'` sends an object or an\n * array as ONE JSON parameter instead (an array does not repeat its key), so a filter object survives\n * the trip. Without them the behavior is the one above.\n */\n static toQueryString(opts: { params: AnyObject } & IQueryStringOptions): string {\n const {\n params,\n nullish = QueryStringNullishModes.EMPTY,\n nested = QueryStringNestedModes.DROP,\n } = opts;\n const parts: string[] = [];\n const isSkipped = (value: unknown) =>\n nullish === QueryStringNullishModes.SKIP && (value === null || value === undefined);\n const isJson = nested === QueryStringNestedModes.JSON;\n\n // A primitive only. `querystring` drops an object or a nested array to an empty value rather than\n // stringifying it, and a caller that passed one meant something this format cannot carry anyway.\n const encode = (value: unknown) =>\n value === null || value === undefined || typeof value === 'object'\n ? ''\n : encodeURIComponent(String(value));\n\n const entries = Object.entries(params);\n\n for (const [key, value] of entries) {\n const name = encodeURIComponent(key);\n\n if (isSkipped(value)) {\n continue;\n }\n\n if (isJson && typeof value === 'object' && value !== null) {\n parts.push(\n `${name}${QueryStringSeparators.ASSIGN}${encodeURIComponent(JSON.stringify(value))}`,\n );\n continue;\n }\n\n // An array repeats the key, which is what a server reading a list expects.\n if (Array.isArray(value)) {\n for (const entry of value) {\n if (isSkipped(entry)) {\n continue;\n }\n\n parts.push(`${name}${QueryStringSeparators.ASSIGN}${encode(entry)}`);\n }\n\n continue;\n }\n\n parts.push(`${name}${QueryStringSeparators.ASSIGN}${encode(value)}`);\n }\n\n return parts.join(QueryStringSeparators.PAIR);\n }\n}\n"]}
@@ -6,8 +6,9 @@ export declare class UrlSchemes {
6
6
  static readonly SCHEME_SET: Set<string>;
7
7
  static isValid(value: string): boolean;
8
8
  }
9
+ /** A scheme a guarded fetch accepts: `http:` or `https:`. */
9
10
  export type TUrlScheme = TConstValue<typeof UrlSchemes>;
10
- /** Safe by default: https only, no private address, three hops, ten seconds. */
11
+ /** The values `IUrlSafetyPolicy` uses for a field the caller leaves unset; each is the safe choice. */
11
12
  export declare class UrlSafetyDefaults {
12
13
  static readonly ALLOWED_SCHEMES: string[];
13
14
  static readonly ALLOW_PRIVATE_ADDRESS = false;
@@ -7,7 +7,7 @@ export class UrlSchemes {
7
7
  return this.SCHEME_SET.has(value);
8
8
  }
9
9
  }
10
- /** Safe by default: https only, no private address, three hops, ten seconds. */
10
+ /** The values `IUrlSafetyPolicy` uses for a field the caller leaves unset; each is the safe choice. */
11
11
  export class UrlSafetyDefaults {
12
12
  static { this.ALLOWED_SCHEMES = [UrlSchemes.HTTPS]; }
13
13
  static { this.ALLOW_PRIVATE_ADDRESS = false; }
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../../src/modules/network/utilities/url-safety/common/constants.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,MAAM,OAAO,UAAU;aACL,SAAI,GAAG,OAAO,CAAC;aACf,UAAK,GAAG,QAAQ,CAAC;aAEjB,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtE,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAIH,gFAAgF;AAChF,MAAM,OAAO,iBAAiB;aACZ,oBAAe,GAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;aAC/C,0BAAqB,GAAG,KAAK,CAAC;aAC9B,kBAAa,GAAG,CAAC,CAAC;aAClB,yBAAoB,GAAG,MAAM,CAAC;aAC9B,cAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC","sourcesContent":["import { type TConstValue } from '@/common/types';\n\n/** The only schemes a guarded fetch will speak. `file:` and `gopher:` are the classic SSRF pivots. */\nexport class UrlSchemes {\n static readonly HTTP = 'http:';\n static readonly HTTPS = 'https:';\n\n static readonly SCHEME_SET = new Set<string>([this.HTTP, this.HTTPS]);\n\n static isValid(value: string): boolean {\n return this.SCHEME_SET.has(value);\n }\n}\nexport type TUrlScheme = TConstValue<typeof UrlSchemes>;\n\n/** Safe by default: https only, no private address, three hops, ten seconds. */\nexport class UrlSafetyDefaults {\n static readonly ALLOWED_SCHEMES: string[] = [UrlSchemes.HTTPS];\n static readonly ALLOW_PRIVATE_ADDRESS = false;\n static readonly MAX_REDIRECTS = 3;\n static readonly TIMEOUT_MILLISECONDS = 10_000;\n static readonly MAX_BYTES = 10 * 1024 * 1024;\n}\n"]}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../../src/modules/network/utilities/url-safety/common/constants.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,MAAM,OAAO,UAAU;aACL,SAAI,GAAG,OAAO,CAAC;aACf,UAAK,GAAG,QAAQ,CAAC;aAEjB,eAAU,GAAG,IAAI,GAAG,CAAS,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAEtE,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAKH,uGAAuG;AACvG,MAAM,OAAO,iBAAiB;aACZ,oBAAe,GAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;aAC/C,0BAAqB,GAAG,KAAK,CAAC;aAC9B,kBAAa,GAAG,CAAC,CAAC;aAClB,yBAAoB,GAAG,MAAM,CAAC;aAC9B,cAAS,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC","sourcesContent":["import { type TConstValue } from '@/common/types';\n\n/** The only schemes a guarded fetch will speak. `file:` and `gopher:` are the classic SSRF pivots. */\nexport class UrlSchemes {\n static readonly HTTP = 'http:';\n static readonly HTTPS = 'https:';\n\n static readonly SCHEME_SET = new Set<string>([this.HTTP, this.HTTPS]);\n\n static isValid(value: string): boolean {\n return this.SCHEME_SET.has(value);\n }\n}\n/** A scheme a guarded fetch accepts: `http:` or `https:`. */\nexport type TUrlScheme = TConstValue<typeof UrlSchemes>;\n\n/** The values `IUrlSafetyPolicy` uses for a field the caller leaves unset; each is the safe choice. */\nexport class UrlSafetyDefaults {\n static readonly ALLOWED_SCHEMES: string[] = [UrlSchemes.HTTPS];\n static readonly ALLOW_PRIVATE_ADDRESS = false;\n static readonly MAX_REDIRECTS = 3;\n static readonly TIMEOUT_MILLISECONDS = 10_000;\n static readonly MAX_BYTES = 10 * 1024 * 1024;\n}\n"]}
@@ -4,21 +4,34 @@ import type { IDuration } from '../../../../../common/constants/duration.js';
4
4
  * plain `http` says so at the call site rather than weakening a build-time constant for everyone.
5
5
  */
6
6
  export interface IUrlSafetyPolicy {
7
- /** Defaults to `['https:']`. */
7
+ /**
8
+ * The schemes a url may use.
9
+ * @default ['https:']
10
+ */
8
11
  allowedSchemes?: string[];
9
12
  /**
10
- * Defaults to `false`. Turning it on in a path that takes urls from user input re-opens the
13
+ * Whether a url may resolve to a private address. Turning it on in a path that takes urls from user input re-opens the
11
14
  * server-side request forgery this guard exists to close - a request can then be steered at
12
15
  * `169.254.169.254` and the cloud credentials behind it.
16
+ * @default false
13
17
  */
14
18
  allowPrivateAddress?: boolean;
15
19
  /** When set, nothing outside the list passes, whatever it resolves to. */
16
20
  allowedHosts?: string[];
17
- /** Defaults to 3. Each hop is re-checked, so a public host cannot bounce into a private one. */
21
+ /**
22
+ * Redirects followed. Each hop is re-checked, so a public host cannot bounce into a private one.
23
+ * @default 3
24
+ */
18
25
  maxRedirects?: number;
19
- /** Defaults to 10 seconds. A slow host holds a worker slot for exactly this long. */
26
+ /**
27
+ * How long a request may take. A slow host holds a worker slot for exactly this long.
28
+ * @default UrlSafetyDefaults.TIMEOUT_MILLISECONDS
29
+ */
20
30
  timeout?: IDuration;
21
- /** Defaults to 10 MB. The read stops and cancels the moment the body crosses it. */
31
+ /**
32
+ * Largest body, in bytes. The read stops and cancels the moment the body crosses it.
33
+ * @default UrlSafetyDefaults.MAX_BYTES
34
+ */
22
35
  maxBytes?: number;
23
36
  }
24
37
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/modules/network/utilities/url-safety/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { IDuration } from '@/common/constants/duration';\n\n/**\n * What a caller will accept from an untrusted url. Every field is per call: an app that must reach\n * plain `http` says so at the call site rather than weakening a build-time constant for everyone.\n */\nexport interface IUrlSafetyPolicy {\n /** Defaults to `['https:']`. */\n allowedSchemes?: string[];\n\n /**\n * Defaults to `false`. Turning it on in a path that takes urls from user input re-opens the\n * server-side request forgery this guard exists to close - a request can then be steered at\n * `169.254.169.254` and the cloud credentials behind it.\n */\n allowPrivateAddress?: boolean;\n\n /** When set, nothing outside the list passes, whatever it resolves to. */\n allowedHosts?: string[];\n\n /** Defaults to 3. Each hop is re-checked, so a public host cannot bounce into a private one. */\n maxRedirects?: number;\n\n /** Defaults to 10 seconds. A slow host holds a worker slot for exactly this long. */\n timeout?: IDuration;\n\n /** Defaults to 10 MB. The read stops and cancels the moment the body crosses it. */\n maxBytes?: number;\n}\n"]}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../../../src/modules/network/utilities/url-safety/common/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { IDuration } from '@/common/constants/duration';\n\n/**\n * What a caller will accept from an untrusted url. Every field is per call: an app that must reach\n * plain `http` says so at the call site rather than weakening a build-time constant for everyone.\n */\nexport interface IUrlSafetyPolicy {\n /**\n * The schemes a url may use.\n * @default ['https:']\n */\n allowedSchemes?: string[];\n\n /**\n * Whether a url may resolve to a private address. Turning it on in a path that takes urls from user input re-opens the\n * server-side request forgery this guard exists to close - a request can then be steered at\n * `169.254.169.254` and the cloud credentials behind it.\n * @default false\n */\n allowPrivateAddress?: boolean;\n\n /** When set, nothing outside the list passes, whatever it resolves to. */\n allowedHosts?: string[];\n\n /**\n * Redirects followed. Each hop is re-checked, so a public host cannot bounce into a private one.\n * @default 3\n */\n maxRedirects?: number;\n\n /**\n * How long a request may take. A slow host holds a worker slot for exactly this long.\n * @default UrlSafetyDefaults.TIMEOUT_MILLISECONDS\n */\n timeout?: IDuration;\n\n /**\n * Largest body, in bytes. The read stops and cancels the moment the body crosses it.\n * @default UrlSafetyDefaults.MAX_BYTES\n */\n maxBytes?: number;\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../../../../src/modules/network/utilities/url-safety/ingest.ts"],"names":[],"mappings":"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","sourcesContent":["// The half `policy.ts` cannot do: resolving a hostname needs `node:dns`, so nothing here may be\n// re-exported from the `./core` subpath.\n\nimport { DurationMultipliers } from '@/common/constants/duration';\nimport { getError } from '@/modules/error';\nimport { lookup } from 'node:dns/promises';\nimport { UrlSafetyDefaults } from './common/constants';\nimport { UrlSafetyErrors } from './common/errors';\nimport type { IUrlSafetyPolicy } from './common/types';\nimport { UrlPolicy } from './policy';\n\n/** Fetching an untrusted url without letting it reach inside the network. */\nexport class UrlIngest {\n /**\n * Rejects when ANY resolved address is non-public. Checking only the first walks straight into a\n * host that publishes one public A record beside an internal one.\n *\n * A rebinding window remains: the address can change between this check and the connect. Closing\n * it means connecting to the resolved address and setting `Host` by hand, which no fetch API\n * exposes.\n */\n static async assertPublicHost(opts: {\n hostname: string;\n policy?: IUrlSafetyPolicy;\n }): Promise<void> {\n const { hostname, policy } = opts;\n\n if (policy?.allowPrivateAddress ?? UrlSafetyDefaults.ALLOW_PRIVATE_ADDRESS) {\n return;\n }\n\n // `URL.hostname` keeps the brackets on an IPv6 literal; `lookup` does not accept them, and the\n // ENOTFOUND that follows reads as a transient DNS failure rather than the refusal it should be.\n const address = UrlPolicy.readHostAddress({ hostname });\n const addresses = await lookup(address, { all: true });\n\n if (!addresses.length) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertPublicHost] Host resolves to nothing | host: ${hostname}`,\n });\n }\n\n const offender = addresses.find((entry) =>\n UrlPolicy.isNonPublicAddress({ address: entry.address }),\n );\n\n if (offender) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertPublicHost] Host resolves to a non-public address | host: ${hostname} | address: ${offender.address}`,\n });\n }\n }\n\n /** Both halves, in the order they must run: shape first, then the network. */\n static async assertReachableUrl(opts: { url: string; policy?: IUrlSafetyPolicy }): Promise<URL> {\n const parsed = UrlPolicy.assertSafeUrl(opts);\n await UrlIngest.assertPublicHost({ hostname: parsed.hostname, policy: opts.policy });\n return parsed;\n }\n\n private static readTimeoutMilliseconds(opts: { policy?: IUrlSafetyPolicy }): number {\n const { timeout } = opts.policy ?? {};\n const milliseconds = timeout ? DurationMultipliers.toMilliseconds(timeout) : null;\n return milliseconds ?? UrlSafetyDefaults.TIMEOUT_MILLISECONDS;\n }\n\n /**\n * A GET that an untrusted url cannot steer inside the network. Redirects are followed by hand so\n * every hop is re-checked - `redirect: 'follow'` would land on an internal host with no second\n * look.\n *\n * The body is returned unread: the caller decides whether to stream it onward or cap it with\n * {@link UrlIngest.readCappedBody}. Nothing is buffered here.\n */\n static async fetchGuarded(opts: {\n url: string;\n policy?: IUrlSafetyPolicy;\n headers?: Record<string, string>;\n }): Promise<Response> {\n const { url, policy, headers } = opts;\n const maxRedirects = policy?.maxRedirects ?? UrlSafetyDefaults.MAX_REDIRECTS;\n const timeoutMilliseconds = UrlIngest.readTimeoutMilliseconds({ policy });\n\n let target = await UrlIngest.assertReachableUrl({ url, policy });\n\n for (let hop = 0; hop <= maxRedirects; hop += 1) {\n const response = await fetch(target, {\n redirect: 'manual',\n signal: AbortSignal.timeout(timeoutMilliseconds),\n ...(headers ? { headers } : {}),\n });\n\n if (response.status < 300 || response.status > 399) {\n if (!response.ok) {\n // Cancelled, or the socket stays open on every 4xx and 5xx.\n await response.body?.cancel();\n throw getError({\n message: `[fetchGuarded] Request failed | status: ${response.status} | url: ${url}`,\n });\n }\n\n return response;\n }\n\n const location = response.headers.get('location');\n await response.body?.cancel();\n\n if (!location) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetchGuarded] Redirect carried no location | url: ${url}`,\n });\n }\n\n const result = await UrlIngest.assertReachableUrl({\n url: new URL(location, target).toString(),\n policy,\n });\n target = result;\n }\n\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetchGuarded] Too many redirects | max: ${maxRedirects} | url: ${url}`,\n });\n }\n\n /**\n * Enforces `maxBytes` on a stream nothing reads into this process - the shape a caller wants when\n * the body is piped onward rather than held. Without it a `maxBytes` policy is inert on that path.\n */\n static capStream(opts: {\n source: ReadableStream<Uint8Array>;\n policy?: IUrlSafetyPolicy;\n }): ReadableStream<Uint8Array> {\n const { source } = opts;\n const maxBytes = opts.policy?.maxBytes ?? UrlSafetyDefaults.MAX_BYTES;\n let received = 0;\n\n return source.pipeThrough(\n new TransformStream<Uint8Array, Uint8Array>({\n transform(chunk, controller) {\n received += chunk.byteLength;\n\n if (received > maxBytes) {\n controller.error(\n getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[capStream] Body exceeds the cap | received: ${received} | max: ${maxBytes}`,\n }),\n );\n return;\n }\n\n controller.enqueue(chunk);\n },\n }),\n );\n }\n\n /**\n * Reads a body that must not exceed `maxBytes`, cancelling the moment it does. `content-length` is\n * checked first because it is free, and counted anyway because it may be absent or lie.\n */\n static async readCappedBody(opts: {\n response: Response;\n policy?: IUrlSafetyPolicy;\n }): Promise<Buffer> {\n const { response, policy } = opts;\n const maxBytes = policy?.maxBytes ?? UrlSafetyDefaults.MAX_BYTES;\n\n const declaredLength = Number(response.headers.get('content-length') ?? 0);\n if (declaredLength > maxBytes) {\n await response.body?.cancel();\n // The same fact as the streaming branch below, so the same verdict: a caller must not retry an\n // oversized body when the server sends `content-length` and drop it when the server omits one.\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[readCappedBody] Body exceeds the cap | declared: ${declaredLength} | max: ${maxBytes}`,\n });\n }\n\n const reader = response.body?.getReader();\n if (!reader) {\n throw getError({ message: '[readCappedBody] Response carried no body' });\n }\n\n const chunks: Uint8Array[] = [];\n let received = 0;\n\n for (;;) {\n const { done, value } = await reader.read();\n if (done) {\n break;\n }\n\n received += value.length;\n if (received > maxBytes) {\n await reader.cancel();\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[readCappedBody] Body exceeds the cap | received: ${received} | max: ${maxBytes}`,\n });\n }\n\n chunks.push(value);\n }\n\n return Buffer.concat(chunks);\n }\n}\n"]}
1
+ {"version":3,"file":"ingest.js","sourceRoot":"","sources":["../../../../../../src/modules/network/utilities/url-safety/ingest.ts"],"names":[],"mappings":"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","sourcesContent":["// The half `policy.ts` cannot do: resolving a hostname needs `node:dns`, so nothing here may be\n// re-exported from the `./core` subpath.\n\nimport { DurationMultipliers } from '@/common/constants/duration';\nimport { getError } from '@/modules/error';\nimport { lookup } from 'node:dns/promises';\nimport { UrlSafetyDefaults } from './common/constants';\nimport { UrlSafetyErrors } from './common/errors';\nimport type { IUrlSafetyPolicy } from './common/types';\nimport { UrlPolicy } from './policy';\n\n/** Fetching an untrusted url without letting it reach inside the network. */\nexport class UrlIngest {\n /**\n * Rejects when ANY resolved address is non-public. Checking only the first walks straight into a\n * host that publishes one public A record beside an internal one.\n *\n * A rebinding window remains: the address can change between this check and the connect. Closing\n * it means connecting to the resolved address and setting `Host` by hand, which no fetch API\n * exposes.\n */\n static async assertPublicHost(opts: {\n hostname: string;\n policy?: IUrlSafetyPolicy;\n }): Promise<void> {\n const { hostname, policy } = opts;\n\n if (policy?.allowPrivateAddress ?? UrlSafetyDefaults.ALLOW_PRIVATE_ADDRESS) {\n return;\n }\n\n // `URL.hostname` keeps the brackets on an IPv6 literal; `lookup` does not accept them, and the\n // ENOTFOUND that follows reads as a transient DNS failure rather than the refusal it should be.\n const address = UrlPolicy.readHostAddress({ hostname });\n const addresses = await lookup(address, { all: true });\n\n if (!addresses.length) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertPublicHost] Host resolves to nothing | host: ${hostname}`,\n });\n }\n\n const offender = addresses.find((entry) =>\n UrlPolicy.isNonPublicAddress({ address: entry.address }),\n );\n\n if (offender) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[assertPublicHost] Host resolves to a non-public address | host: ${hostname} | address: ${offender.address}`,\n });\n }\n }\n\n /** Both halves, in the order they must run: shape first, then the network. */\n static async assertReachableUrl(opts: { url: string; policy?: IUrlSafetyPolicy }): Promise<URL> {\n const parsed = UrlPolicy.assertSafeUrl(opts);\n await UrlIngest.assertPublicHost({ hostname: parsed.hostname, policy: opts.policy });\n\n return parsed;\n }\n\n private static readTimeoutMilliseconds(opts: { policy?: IUrlSafetyPolicy }): number {\n const { timeout } = opts.policy ?? {};\n const milliseconds = timeout ? DurationMultipliers.toMilliseconds(timeout) : null;\n\n return milliseconds ?? UrlSafetyDefaults.TIMEOUT_MILLISECONDS;\n }\n\n /**\n * A GET that an untrusted url cannot steer inside the network. Redirects are followed by hand so\n * every hop is re-checked - `redirect: 'follow'` would land on an internal host with no second\n * look.\n *\n * The body is returned unread: the caller decides whether to stream it onward or cap it with\n * {@link UrlIngest.readCappedBody}. Nothing is buffered here.\n */\n static async fetchGuarded(opts: {\n url: string;\n policy?: IUrlSafetyPolicy;\n headers?: Record<string, string>;\n }): Promise<Response> {\n const { url, policy, headers } = opts;\n const maxRedirects = policy?.maxRedirects ?? UrlSafetyDefaults.MAX_REDIRECTS;\n const timeoutMilliseconds = UrlIngest.readTimeoutMilliseconds({ policy });\n\n let target = await UrlIngest.assertReachableUrl({ url, policy });\n\n for (let hop = 0; hop <= maxRedirects; hop += 1) {\n const response = await fetch(target, {\n redirect: 'manual',\n signal: AbortSignal.timeout(timeoutMilliseconds),\n ...(headers ? { headers } : {}),\n });\n\n if (response.status < 300 || response.status > 399) {\n if (!response.ok) {\n // Cancelled, or the socket stays open on every 4xx and 5xx.\n await response.body?.cancel();\n throw getError({\n message: `[fetchGuarded] Request failed | status: ${response.status} | url: ${url}`,\n });\n }\n\n return response;\n }\n\n const location = response.headers.get('location');\n await response.body?.cancel();\n\n if (!location) {\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetchGuarded] Redirect carried no location | url: ${url}`,\n });\n }\n\n const result = await UrlIngest.assertReachableUrl({\n url: new URL(location, target).toString(),\n policy,\n });\n target = result;\n }\n\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[fetchGuarded] Too many redirects | max: ${maxRedirects} | url: ${url}`,\n });\n }\n\n /**\n * Enforces `maxBytes` on a stream nothing reads into this process - the shape a caller wants when\n * the body is piped onward rather than held. Without it a `maxBytes` policy is inert on that path.\n */\n static capStream(opts: {\n source: ReadableStream<Uint8Array>;\n policy?: IUrlSafetyPolicy;\n }): ReadableStream<Uint8Array> {\n const { source } = opts;\n const maxBytes = opts.policy?.maxBytes ?? UrlSafetyDefaults.MAX_BYTES;\n let received = 0;\n\n return source.pipeThrough(\n new TransformStream<Uint8Array, Uint8Array>({\n transform(chunk, controller) {\n received += chunk.byteLength;\n\n if (received > maxBytes) {\n controller.error(\n getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[capStream] Body exceeds the cap | received: ${received} | max: ${maxBytes}`,\n }),\n );\n\n return;\n }\n\n controller.enqueue(chunk);\n },\n }),\n );\n }\n\n /**\n * Reads a body that must not exceed `maxBytes`, cancelling the moment it does. `content-length` is\n * checked first because it is free, and counted anyway because it may be absent or lie.\n */\n static async readCappedBody(opts: {\n response: Response;\n policy?: IUrlSafetyPolicy;\n }): Promise<Buffer> {\n const { response, policy } = opts;\n const maxBytes = policy?.maxBytes ?? UrlSafetyDefaults.MAX_BYTES;\n\n const declaredLength = Number(response.headers.get('content-length') ?? 0);\n\n if (declaredLength > maxBytes) {\n await response.body?.cancel();\n // The same fact as the streaming branch below, so the same verdict: a caller must not retry an\n // oversized body when the server sends `content-length` and drop it when the server omits one.\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[readCappedBody] Body exceeds the cap | declared: ${declaredLength} | max: ${maxBytes}`,\n });\n }\n\n const reader = response.body?.getReader();\n\n if (!reader) {\n throw getError({ message: '[readCappedBody] Response carried no body' });\n }\n\n const chunks: Uint8Array[] = [];\n let received = 0;\n\n for (;;) {\n const { done, value } = await reader.read();\n\n if (done) {\n break;\n }\n\n received += value.length;\n\n if (received > maxBytes) {\n await reader.cancel();\n throw getError({\n error: UrlSafetyErrors.URL_REFUSED,\n message: `[readCappedBody] Body exceeds the cap | received: ${received} | max: ${maxBytes}`,\n });\n }\n\n chunks.push(value);\n }\n\n return Buffer.concat(chunks);\n }\n}\n"]}