@venizia/ignis-helpers 0.4.7 → 0.4.8-0

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 (401) hide show
  1. package/README.md +2 -2
  2. package/dist/esm/common/constants/mime.js.map +1 -1
  3. package/dist/esm/common/redact.js.map +1 -1
  4. package/dist/esm/common/resolvers.js.map +1 -1
  5. package/dist/esm/modules/base.js.map +1 -1
  6. package/dist/esm/modules/cron/helper.js.map +1 -1
  7. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  8. package/dist/esm/modules/crypto/algorithms/aes.engine.js.map +1 -1
  9. package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
  10. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.js.map +1 -1
  11. package/dist/esm/modules/crypto/algorithms/hash.algorithm.js.map +1 -1
  12. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.js.map +1 -1
  13. package/dist/esm/modules/env/app-env.js.map +1 -1
  14. package/dist/esm/modules/logger/base/base.js.map +1 -1
  15. package/dist/esm/modules/logger/base/console.js.map +1 -1
  16. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  17. package/dist/esm/modules/logger/common/debug-gate.js.map +1 -1
  18. package/dist/esm/modules/logger/factory.js.map +1 -1
  19. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  20. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  21. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  22. package/dist/esm/modules/logger/hf/ring.js.map +1 -1
  23. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  24. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  25. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  26. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  27. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  28. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  29. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  30. package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
  31. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  32. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  33. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  34. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  35. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  36. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  37. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  38. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  39. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  40. package/dist/esm/modules/pool/abstract.js.map +1 -1
  41. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  42. package/dist/esm/modules/queue/internal/hf/helper.js.map +1 -1
  43. package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
  44. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  45. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  46. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  47. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  48. package/dist/esm/modules/redis/utility.js.map +1 -1
  49. package/dist/esm/modules/retry/helper.js.map +1 -1
  50. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  51. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  52. package/dist/esm/modules/secrets/factory.js.map +1 -1
  53. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  54. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js.map +1 -1
  55. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -1
  56. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  57. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  58. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  59. package/dist/esm/modules/storage/base.js.map +1 -1
  60. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  61. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  62. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  63. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  64. package/dist/esm/modules/temporal/adapters/dayjs.js.map +1 -1
  65. package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
  66. package/dist/esm/modules/temporal/adapters/luxon.js.map +1 -1
  67. package/dist/esm/modules/temporal/adapters/native.js.map +1 -1
  68. package/dist/esm/modules/temporal/calendar/calendar.js.map +1 -1
  69. package/dist/esm/modules/temporal/common/types.js.map +1 -1
  70. package/dist/esm/modules/temporal/duration/duration.js.map +1 -1
  71. package/dist/esm/modules/temporal/helper.js.map +1 -1
  72. package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
  73. package/dist/esm/modules/temporal/pattern/pattern.js.map +1 -1
  74. package/dist/esm/modules/temporal/pattern/tokens.js.map +1 -1
  75. package/dist/esm/modules/tree/builder.js.map +1 -1
  76. package/dist/esm/modules/uid/helper.js.map +1 -1
  77. package/dist/esm/modules/uid/opaque.js.map +1 -1
  78. package/dist/esm/modules/uid/uuid/helper.js.map +1 -1
  79. package/dist/esm/modules/uid/uuid/sha1.js.map +1 -1
  80. package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
  81. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  82. package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
  83. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  84. package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
  85. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  86. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  87. package/dist/esm/utilities/error.utility.js.map +1 -1
  88. package/dist/esm/utilities/form-body.utility.js.map +1 -1
  89. package/dist/esm/utilities/hr-time.utility.js.map +1 -1
  90. package/dist/esm/utilities/module.utility.js.map +1 -1
  91. package/dist/esm/utilities/parse.utility.js.map +1 -1
  92. package/dist/esm/utilities/performance.utility.js.map +1 -1
  93. package/dist/esm/utilities/promise.utility.js.map +1 -1
  94. package/dist/esm/utilities/request.utility.js.map +1 -1
  95. package/package.json +4 -4
  96. package/dist/esm/common/constants/app.d.ts.map +0 -1
  97. package/dist/esm/common/constants/duration.d.ts.map +0 -1
  98. package/dist/esm/common/constants/grpc.d.ts.map +0 -1
  99. package/dist/esm/common/constants/http.d.ts.map +0 -1
  100. package/dist/esm/common/constants/index.d.ts.map +0 -1
  101. package/dist/esm/common/constants/mime.d.ts.map +0 -1
  102. package/dist/esm/common/index.d.ts.map +0 -1
  103. package/dist/esm/common/jsx.d.ts.map +0 -1
  104. package/dist/esm/common/redact.d.ts.map +0 -1
  105. package/dist/esm/common/resolvers.d.ts.map +0 -1
  106. package/dist/esm/common/types/class.d.ts.map +0 -1
  107. package/dist/esm/common/types/const-value.d.ts.map +0 -1
  108. package/dist/esm/common/types/field-mapping.d.ts.map +0 -1
  109. package/dist/esm/common/types/index.d.ts.map +0 -1
  110. package/dist/esm/common/types/injection.d.ts.map +0 -1
  111. package/dist/esm/common/types/resolver.d.ts.map +0 -1
  112. package/dist/esm/common/types/utility.d.ts.map +0 -1
  113. package/dist/esm/core.d.ts.map +0 -1
  114. package/dist/esm/index.d.ts.map +0 -1
  115. package/dist/esm/modules/base.d.ts.map +0 -1
  116. package/dist/esm/modules/cron/helper.d.ts.map +0 -1
  117. package/dist/esm/modules/cron/index.d.ts.map +0 -1
  118. package/dist/esm/modules/crypto/algorithms/abstract.algorithm.d.ts.map +0 -1
  119. package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts.map +0 -1
  120. package/dist/esm/modules/crypto/algorithms/aes.constants.d.ts.map +0 -1
  121. package/dist/esm/modules/crypto/algorithms/aes.engine.d.ts.map +0 -1
  122. package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts.map +0 -1
  123. package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts.map +0 -1
  124. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts.map +0 -1
  125. package/dist/esm/modules/crypto/algorithms/hash.algorithm.d.ts.map +0 -1
  126. package/dist/esm/modules/crypto/algorithms/index.d.ts.map +0 -1
  127. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts.map +0 -1
  128. package/dist/esm/modules/crypto/common/constants.d.ts.map +0 -1
  129. package/dist/esm/modules/crypto/common/index.d.ts.map +0 -1
  130. package/dist/esm/modules/crypto/common/types.d.ts.map +0 -1
  131. package/dist/esm/modules/crypto/index.d.ts.map +0 -1
  132. package/dist/esm/modules/env/app-env.d.ts.map +0 -1
  133. package/dist/esm/modules/env/common/index.d.ts.map +0 -1
  134. package/dist/esm/modules/env/common/types.d.ts.map +0 -1
  135. package/dist/esm/modules/env/index.d.ts.map +0 -1
  136. package/dist/esm/modules/env/names.d.ts.map +0 -1
  137. package/dist/esm/modules/error/index.d.ts.map +0 -1
  138. package/dist/esm/modules/index.d.ts.map +0 -1
  139. package/dist/esm/modules/logger/base/abstract.d.ts.map +0 -1
  140. package/dist/esm/modules/logger/base/base.d.ts.map +0 -1
  141. package/dist/esm/modules/logger/base/console.d.ts.map +0 -1
  142. package/dist/esm/modules/logger/base/index.d.ts.map +0 -1
  143. package/dist/esm/modules/logger/common/constants.d.ts.map +0 -1
  144. package/dist/esm/modules/logger/common/debug-gate.d.ts.map +0 -1
  145. package/dist/esm/modules/logger/common/index.d.ts.map +0 -1
  146. package/dist/esm/modules/logger/common/types.d.ts.map +0 -1
  147. package/dist/esm/modules/logger/factory.d.ts.map +0 -1
  148. package/dist/esm/modules/logger/formatting/deep-splat.d.ts.map +0 -1
  149. package/dist/esm/modules/logger/formatting/error-prettier.d.ts.map +0 -1
  150. package/dist/esm/modules/logger/formatting/index.d.ts.map +0 -1
  151. package/dist/esm/modules/logger/hf/common/constants.d.ts.map +0 -1
  152. package/dist/esm/modules/logger/hf/common/index.d.ts.map +0 -1
  153. package/dist/esm/modules/logger/hf/common/types.d.ts.map +0 -1
  154. package/dist/esm/modules/logger/hf/flusher.d.ts.map +0 -1
  155. package/dist/esm/modules/logger/hf/index.d.ts.map +0 -1
  156. package/dist/esm/modules/logger/hf/logger.d.ts.map +0 -1
  157. package/dist/esm/modules/logger/hf/ring.d.ts.map +0 -1
  158. package/dist/esm/modules/logger/index.d.ts.map +0 -1
  159. package/dist/esm/modules/logger/pino/backing.d.ts.map +0 -1
  160. package/dist/esm/modules/logger/pino/common/constants.d.ts.map +0 -1
  161. package/dist/esm/modules/logger/pino/common/index.d.ts.map +0 -1
  162. package/dist/esm/modules/logger/pino/common/types.d.ts.map +0 -1
  163. package/dist/esm/modules/logger/pino/destination.d.ts.map +0 -1
  164. package/dist/esm/modules/logger/pino/index.d.ts.map +0 -1
  165. package/dist/esm/modules/logger/pino/logger.d.ts.map +0 -1
  166. package/dist/esm/modules/logger/winston/common/constants.d.ts.map +0 -1
  167. package/dist/esm/modules/logger/winston/common/index.d.ts.map +0 -1
  168. package/dist/esm/modules/logger/winston/common/types.d.ts.map +0 -1
  169. package/dist/esm/modules/logger/winston/define.d.ts.map +0 -1
  170. package/dist/esm/modules/logger/winston/formats.d.ts.map +0 -1
  171. package/dist/esm/modules/logger/winston/index.d.ts.map +0 -1
  172. package/dist/esm/modules/logger/winston/logger-factory.d.ts.map +0 -1
  173. package/dist/esm/modules/logger/winston/logger.d.ts.map +0 -1
  174. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts.map +0 -1
  175. package/dist/esm/modules/logger/winston/transports/index.d.ts.map +0 -1
  176. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts.map +0 -1
  177. package/dist/esm/modules/network/http-request/common/constants.d.ts.map +0 -1
  178. package/dist/esm/modules/network/http-request/common/index.d.ts.map +0 -1
  179. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts.map +0 -1
  180. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +0 -1
  181. package/dist/esm/modules/network/http-request/fetcher/common/index.d.ts.map +0 -1
  182. package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts.map +0 -1
  183. package/dist/esm/modules/network/http-request/fetcher/index.d.ts.map +0 -1
  184. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +0 -1
  185. package/dist/esm/modules/network/http-request/index.d.ts.map +0 -1
  186. package/dist/esm/modules/network/index.d.ts.map +0 -1
  187. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts.map +0 -1
  188. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +0 -1
  189. package/dist/esm/modules/network/tcp-socket/index.d.ts.map +0 -1
  190. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts.map +0 -1
  191. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts.map +0 -1
  192. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts.map +0 -1
  193. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts.map +0 -1
  194. package/dist/esm/modules/network/udp-socket/index.d.ts.map +0 -1
  195. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts.map +0 -1
  196. package/dist/esm/modules/network/utilities/index.d.ts.map +0 -1
  197. package/dist/esm/modules/network/utilities/query-string.d.ts.map +0 -1
  198. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts.map +0 -1
  199. package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts.map +0 -1
  200. package/dist/esm/modules/network/utilities/url-safety/common/index.d.ts.map +0 -1
  201. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts.map +0 -1
  202. package/dist/esm/modules/network/utilities/url-safety/index.d.ts.map +0 -1
  203. package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts.map +0 -1
  204. package/dist/esm/modules/network/utilities/url-safety/policy.d.ts.map +0 -1
  205. package/dist/esm/modules/pool/abstract.d.ts.map +0 -1
  206. package/dist/esm/modules/pool/base.d.ts.map +0 -1
  207. package/dist/esm/modules/pool/common/index.d.ts.map +0 -1
  208. package/dist/esm/modules/pool/common/types.d.ts.map +0 -1
  209. package/dist/esm/modules/pool/index.d.ts.map +0 -1
  210. package/dist/esm/modules/queue/bullmq/helper.d.ts.map +0 -1
  211. package/dist/esm/modules/queue/bullmq/index.d.ts.map +0 -1
  212. package/dist/esm/modules/queue/common/constants.d.ts.map +0 -1
  213. package/dist/esm/modules/queue/common/hook.d.ts.map +0 -1
  214. package/dist/esm/modules/queue/common/index.d.ts.map +0 -1
  215. package/dist/esm/modules/queue/index.d.ts.map +0 -1
  216. package/dist/esm/modules/queue/internal/hf/common/index.d.ts.map +0 -1
  217. package/dist/esm/modules/queue/internal/hf/common/types.d.ts.map +0 -1
  218. package/dist/esm/modules/queue/internal/hf/helper.d.ts.map +0 -1
  219. package/dist/esm/modules/queue/internal/hf/index.d.ts.map +0 -1
  220. package/dist/esm/modules/queue/internal/index.d.ts.map +0 -1
  221. package/dist/esm/modules/queue/internal/sequential/common/index.d.ts.map +0 -1
  222. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts.map +0 -1
  223. package/dist/esm/modules/queue/internal/sequential/helper.d.ts.map +0 -1
  224. package/dist/esm/modules/queue/internal/sequential/index.d.ts.map +0 -1
  225. package/dist/esm/modules/queue/kafka/admin.d.ts.map +0 -1
  226. package/dist/esm/modules/queue/kafka/base.d.ts.map +0 -1
  227. package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts.map +0 -1
  228. package/dist/esm/modules/queue/kafka/bundler/common/index.d.ts.map +0 -1
  229. package/dist/esm/modules/queue/kafka/bundler/index.d.ts.map +0 -1
  230. package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts.map +0 -1
  231. package/dist/esm/modules/queue/kafka/common/constants.d.ts.map +0 -1
  232. package/dist/esm/modules/queue/kafka/common/index.d.ts.map +0 -1
  233. package/dist/esm/modules/queue/kafka/common/types/admin.d.ts.map +0 -1
  234. package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts.map +0 -1
  235. package/dist/esm/modules/queue/kafka/common/types/connection.d.ts.map +0 -1
  236. package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts.map +0 -1
  237. package/dist/esm/modules/queue/kafka/common/types/index.d.ts.map +0 -1
  238. package/dist/esm/modules/queue/kafka/common/types/producer.d.ts.map +0 -1
  239. package/dist/esm/modules/queue/kafka/consumer.d.ts.map +0 -1
  240. package/dist/esm/modules/queue/kafka/index.d.ts.map +0 -1
  241. package/dist/esm/modules/queue/kafka/producer.d.ts.map +0 -1
  242. package/dist/esm/modules/queue/kafka/schema/index.d.ts.map +0 -1
  243. package/dist/esm/modules/queue/kafka/schema/registry.d.ts.map +0 -1
  244. package/dist/esm/modules/queue/mqtt/helper.d.ts.map +0 -1
  245. package/dist/esm/modules/queue/mqtt/index.d.ts.map +0 -1
  246. package/dist/esm/modules/redis/base/abstract.helper.d.ts.map +0 -1
  247. package/dist/esm/modules/redis/base/index.d.ts.map +0 -1
  248. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts.map +0 -1
  249. package/dist/esm/modules/redis/cluster/index.d.ts.map +0 -1
  250. package/dist/esm/modules/redis/common/constants.d.ts.map +0 -1
  251. package/dist/esm/modules/redis/common/index.d.ts.map +0 -1
  252. package/dist/esm/modules/redis/common/interfaces.d.ts.map +0 -1
  253. package/dist/esm/modules/redis/common/types.d.ts.map +0 -1
  254. package/dist/esm/modules/redis/factory.d.ts.map +0 -1
  255. package/dist/esm/modules/redis/index.d.ts.map +0 -1
  256. package/dist/esm/modules/redis/sentinel/index.d.ts.map +0 -1
  257. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts.map +0 -1
  258. package/dist/esm/modules/redis/single/index.d.ts.map +0 -1
  259. package/dist/esm/modules/redis/single/single.helper.d.ts.map +0 -1
  260. package/dist/esm/modules/redis/utility.d.ts.map +0 -1
  261. package/dist/esm/modules/retry/common/constants.d.ts.map +0 -1
  262. package/dist/esm/modules/retry/common/index.d.ts.map +0 -1
  263. package/dist/esm/modules/retry/common/types.d.ts.map +0 -1
  264. package/dist/esm/modules/retry/helper.d.ts.map +0 -1
  265. package/dist/esm/modules/retry/index.d.ts.map +0 -1
  266. package/dist/esm/modules/secrets/base/abstract.helper.d.ts.map +0 -1
  267. package/dist/esm/modules/secrets/base/index.d.ts.map +0 -1
  268. package/dist/esm/modules/secrets/common/constants.d.ts.map +0 -1
  269. package/dist/esm/modules/secrets/common/index.d.ts.map +0 -1
  270. package/dist/esm/modules/secrets/common/types/helper.d.ts.map +0 -1
  271. package/dist/esm/modules/secrets/common/types/index.d.ts.map +0 -1
  272. package/dist/esm/modules/secrets/common/types/lease.d.ts.map +0 -1
  273. package/dist/esm/modules/secrets/common/types/registration.d.ts.map +0 -1
  274. package/dist/esm/modules/secrets/common/types/timer.d.ts.map +0 -1
  275. package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts.map +0 -1
  276. package/dist/esm/modules/secrets/dotenv/index.d.ts.map +0 -1
  277. package/dist/esm/modules/secrets/factory.d.ts.map +0 -1
  278. package/dist/esm/modules/secrets/hashicorp/auth.d.ts.map +0 -1
  279. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts.map +0 -1
  280. package/dist/esm/modules/secrets/hashicorp/index.d.ts.map +0 -1
  281. package/dist/esm/modules/secrets/index.d.ts.map +0 -1
  282. package/dist/esm/modules/secrets/system-envs/index.d.ts.map +0 -1
  283. package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts.map +0 -1
  284. package/dist/esm/modules/slug/common/constants.d.ts.map +0 -1
  285. package/dist/esm/modules/slug/common/index.d.ts.map +0 -1
  286. package/dist/esm/modules/slug/helper.d.ts.map +0 -1
  287. package/dist/esm/modules/slug/index.d.ts.map +0 -1
  288. package/dist/esm/modules/socket/index.d.ts.map +0 -1
  289. package/dist/esm/modules/socket/socket-io/browser.d.ts.map +0 -1
  290. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +0 -1
  291. package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +0 -1
  292. package/dist/esm/modules/socket/socket-io/client/index.d.ts.map +0 -1
  293. package/dist/esm/modules/socket/socket-io/common/constants.d.ts.map +0 -1
  294. package/dist/esm/modules/socket/socket-io/common/index.d.ts.map +0 -1
  295. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts.map +0 -1
  296. package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts.map +0 -1
  297. package/dist/esm/modules/socket/socket-io/common/types/index.d.ts.map +0 -1
  298. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts.map +0 -1
  299. package/dist/esm/modules/socket/socket-io/index.d.ts.map +0 -1
  300. package/dist/esm/modules/socket/socket-io/server/helper.d.ts.map +0 -1
  301. package/dist/esm/modules/socket/socket-io/server/index.d.ts.map +0 -1
  302. package/dist/esm/modules/socket/websocket/common/constants.d.ts.map +0 -1
  303. package/dist/esm/modules/socket/websocket/common/index.d.ts.map +0 -1
  304. package/dist/esm/modules/socket/websocket/common/types/client.d.ts.map +0 -1
  305. package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts.map +0 -1
  306. package/dist/esm/modules/socket/websocket/common/types/index.d.ts.map +0 -1
  307. package/dist/esm/modules/socket/websocket/common/types/message.d.ts.map +0 -1
  308. package/dist/esm/modules/socket/websocket/common/types/server.d.ts.map +0 -1
  309. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts.map +0 -1
  310. package/dist/esm/modules/socket/websocket/emitter/index.d.ts.map +0 -1
  311. package/dist/esm/modules/socket/websocket/index.d.ts.map +0 -1
  312. package/dist/esm/modules/socket/websocket/server/delivery.d.ts.map +0 -1
  313. package/dist/esm/modules/socket/websocket/server/helper.d.ts.map +0 -1
  314. package/dist/esm/modules/socket/websocket/server/index.d.ts.map +0 -1
  315. package/dist/esm/modules/storage/base.d.ts.map +0 -1
  316. package/dist/esm/modules/storage/bun-s3/helper.d.ts.map +0 -1
  317. package/dist/esm/modules/storage/bun-s3/index.d.ts.map +0 -1
  318. package/dist/esm/modules/storage/bun-s3/utility.d.ts.map +0 -1
  319. package/dist/esm/modules/storage/common/constants.d.ts.map +0 -1
  320. package/dist/esm/modules/storage/common/errors.d.ts.map +0 -1
  321. package/dist/esm/modules/storage/common/index.d.ts.map +0 -1
  322. package/dist/esm/modules/storage/common/types.d.ts.map +0 -1
  323. package/dist/esm/modules/storage/common/utility.d.ts.map +0 -1
  324. package/dist/esm/modules/storage/disk/helper.d.ts.map +0 -1
  325. package/dist/esm/modules/storage/disk/index.d.ts.map +0 -1
  326. package/dist/esm/modules/storage/in-memory/helper.d.ts.map +0 -1
  327. package/dist/esm/modules/storage/in-memory/index.d.ts.map +0 -1
  328. package/dist/esm/modules/storage/index.d.ts.map +0 -1
  329. package/dist/esm/modules/temporal/abstract.d.ts.map +0 -1
  330. package/dist/esm/modules/temporal/adapters/dayjs.d.ts.map +0 -1
  331. package/dist/esm/modules/temporal/adapters/index.d.ts.map +0 -1
  332. package/dist/esm/modules/temporal/adapters/intl.d.ts.map +0 -1
  333. package/dist/esm/modules/temporal/adapters/luxon.d.ts.map +0 -1
  334. package/dist/esm/modules/temporal/adapters/native.d.ts.map +0 -1
  335. package/dist/esm/modules/temporal/calendar/calendar.d.ts.map +0 -1
  336. package/dist/esm/modules/temporal/calendar/index.d.ts.map +0 -1
  337. package/dist/esm/modules/temporal/common/constants.d.ts.map +0 -1
  338. package/dist/esm/modules/temporal/common/index.d.ts.map +0 -1
  339. package/dist/esm/modules/temporal/common/types.d.ts.map +0 -1
  340. package/dist/esm/modules/temporal/duration/duration.d.ts.map +0 -1
  341. package/dist/esm/modules/temporal/duration/index.d.ts.map +0 -1
  342. package/dist/esm/modules/temporal/helper.d.ts.map +0 -1
  343. package/dist/esm/modules/temporal/index.d.ts.map +0 -1
  344. package/dist/esm/modules/temporal/locale/index.d.ts.map +0 -1
  345. package/dist/esm/modules/temporal/locale/locale.d.ts.map +0 -1
  346. package/dist/esm/modules/temporal/pattern/common/constants.d.ts.map +0 -1
  347. package/dist/esm/modules/temporal/pattern/common/index.d.ts.map +0 -1
  348. package/dist/esm/modules/temporal/pattern/common/types.d.ts.map +0 -1
  349. package/dist/esm/modules/temporal/pattern/index.d.ts.map +0 -1
  350. package/dist/esm/modules/temporal/pattern/pattern.d.ts.map +0 -1
  351. package/dist/esm/modules/temporal/pattern/tokens.d.ts.map +0 -1
  352. package/dist/esm/modules/tree/builder.d.ts.map +0 -1
  353. package/dist/esm/modules/tree/common/index.d.ts.map +0 -1
  354. package/dist/esm/modules/tree/common/types.d.ts.map +0 -1
  355. package/dist/esm/modules/tree/index.d.ts.map +0 -1
  356. package/dist/esm/modules/tree/walk.d.ts.map +0 -1
  357. package/dist/esm/modules/uid/common/constants.d.ts.map +0 -1
  358. package/dist/esm/modules/uid/common/index.d.ts.map +0 -1
  359. package/dist/esm/modules/uid/common/types.d.ts.map +0 -1
  360. package/dist/esm/modules/uid/helper.d.ts.map +0 -1
  361. package/dist/esm/modules/uid/index.d.ts.map +0 -1
  362. package/dist/esm/modules/uid/opaque.d.ts.map +0 -1
  363. package/dist/esm/modules/uid/request-id.d.ts.map +0 -1
  364. package/dist/esm/modules/uid/uuid/common/constants.d.ts.map +0 -1
  365. package/dist/esm/modules/uid/uuid/common/index.d.ts.map +0 -1
  366. package/dist/esm/modules/uid/uuid/common/types.d.ts.map +0 -1
  367. package/dist/esm/modules/uid/uuid/helper.d.ts.map +0 -1
  368. package/dist/esm/modules/uid/uuid/index.d.ts.map +0 -1
  369. package/dist/esm/modules/uid/uuid/sha1.d.ts.map +0 -1
  370. package/dist/esm/modules/uid/uuid/v4.d.ts.map +0 -1
  371. package/dist/esm/modules/uid/uuid/v5.d.ts.map +0 -1
  372. package/dist/esm/modules/uid/uuid/v7.d.ts.map +0 -1
  373. package/dist/esm/modules/worker-thread/bus/abstract.d.ts.map +0 -1
  374. package/dist/esm/modules/worker-thread/bus/base.d.ts.map +0 -1
  375. package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts.map +0 -1
  376. package/dist/esm/modules/worker-thread/bus/handler/base.d.ts.map +0 -1
  377. package/dist/esm/modules/worker-thread/bus/handler/index.d.ts.map +0 -1
  378. package/dist/esm/modules/worker-thread/bus/index.d.ts.map +0 -1
  379. package/dist/esm/modules/worker-thread/common/index.d.ts.map +0 -1
  380. package/dist/esm/modules/worker-thread/common/types.d.ts.map +0 -1
  381. package/dist/esm/modules/worker-thread/index.d.ts.map +0 -1
  382. package/dist/esm/modules/worker-thread/thread/abstract.d.ts.map +0 -1
  383. package/dist/esm/modules/worker-thread/thread/base.d.ts.map +0 -1
  384. package/dist/esm/modules/worker-thread/thread/index.d.ts.map +0 -1
  385. package/dist/esm/modules/worker-thread/worker/abstract.d.ts.map +0 -1
  386. package/dist/esm/modules/worker-thread/worker/base.d.ts.map +0 -1
  387. package/dist/esm/modules/worker-thread/worker/index.d.ts.map +0 -1
  388. package/dist/esm/modules/worker-thread/worker-pool.d.ts.map +0 -1
  389. package/dist/esm/temporal.d.ts.map +0 -1
  390. package/dist/esm/utilities/build-info.utility.d.ts.map +0 -1
  391. package/dist/esm/utilities/error.utility.d.ts.map +0 -1
  392. package/dist/esm/utilities/form-body.utility.d.ts.map +0 -1
  393. package/dist/esm/utilities/hr-time.utility.d.ts.map +0 -1
  394. package/dist/esm/utilities/index.d.ts.map +0 -1
  395. package/dist/esm/utilities/module.utility.d.ts.map +0 -1
  396. package/dist/esm/utilities/parse.utility.d.ts.map +0 -1
  397. package/dist/esm/utilities/performance.utility.d.ts.map +0 -1
  398. package/dist/esm/utilities/project-root.utility.d.ts.map +0 -1
  399. package/dist/esm/utilities/promise.utility.d.ts.map +0 -1
  400. package/dist/esm/utilities/request.utility.d.ts.map +0 -1
  401. package/dist/esm/uuid.d.ts.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/queue/mqtt/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { ObjectUtility } from '@venizia/ignis-inversion';\nimport { RedactUtility } from '@/common/redact';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport mqtt from 'mqtt';\nimport { HookUtility } from '../common';\n\nexport interface IMQTTClientOptions {\n identifier: string;\n url: string;\n options: mqtt.IClientOptions;\n onConnect?: () => void;\n onDisconnect?: () => void;\n onError?: (error: Error) => void;\n onClose?: (error?: Error) => void;\n onMessage: (opts: { topic: string; message: Buffer }) => void;\n}\n\nexport class MQTTClientHelper extends BaseHelper {\n private url: string;\n private options: mqtt.IClientOptions;\n private client?: mqtt.MqttClient;\n\n private onConnect?: () => void;\n private onDisconnect?: () => void;\n private onError?: (error: Error) => void;\n private onClose?: (error?: Error) => void;\n private onMessage: (opts: { topic: string; message: Buffer }) => void;\n\n constructor(opts: IMQTTClientOptions) {\n super({ scope: MQTTClientHelper.name, identifier: opts.identifier });\n\n this.url = opts.url;\n this.options = opts.options;\n\n this.onConnect = opts.onConnect;\n this.onClose = opts.onClose;\n this.onError = opts.onError;\n this.onDisconnect = opts.onDisconnect;\n this.onMessage = opts.onMessage;\n\n this.configure();\n }\n\n configure() {\n if (this.client) {\n // Never serialize the client: it holds the resolved IClientOptions, password included.\n this.logger\n .for(this.configure.name)\n .info(\n '[%s] MQTT Client already established | Connected: %s',\n this.identifier,\n this.client.connected,\n );\n return;\n }\n\n if (ObjectUtility.isEmpty({ value: this.url })) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[configure] Invalid url to configure mqtt client!',\n });\n }\n\n this.logger\n .for(this.configure.name)\n .info(\n '[%s] Start configuring mqtt client | Url: %s | Options: %j',\n this.identifier,\n RedactUtility.redactUrlCredentials({ url: this.url }),\n RedactUtility.redactSecrets({ value: this.options }),\n );\n this.client = this.createClient({ url: this.url, options: this.options });\n\n this.client.on('connect', () => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onConnect',\n execution: () => this.onConnect?.(),\n });\n });\n\n this.client.on('disconnect', () => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onDisconnect',\n execution: () => this.onDisconnect?.(),\n });\n });\n\n this.client.on('message', (topic, message) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onMessage',\n execution: () => this.onMessage?.({ topic, message }),\n });\n });\n\n this.client.on('error', (error) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onError',\n execution: () => this.onError?.(error),\n });\n });\n\n this.client.on('close', (error?: Error) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onClose',\n execution: () => this.onClose?.(error),\n });\n });\n }\n\n /** Client factory seam - overridden in tests to run the helper without a broker. */\n protected createClient(opts: { url: string; options: mqtt.IClientOptions }): mqtt.MqttClient {\n return mqtt.connect(opts.url, opts.options);\n }\n\n getClient() {\n return this.client;\n }\n\n /** Tear the client down - without it the mqtt client, and its reconnect timer, outlives the helper forever. Resolves once the driver reports the connection ended; safe to call more than once. */\n close(opts?: { isForce?: boolean }): Promise<void> {\n const client = this.client;\n this.client = undefined;\n\n if (!client) {\n return Promise.resolve();\n }\n\n const isForce = opts?.isForce ?? false;\n\n return new Promise<void>((resolve) => {\n client.end(isForce, undefined, () => {\n this.logger.for(this.close.name).info('[%s] MQTT Client closed!', this.identifier);\n resolve();\n });\n });\n }\n\n subscribe(opts: { topics: Array<string> }) {\n const client = this.client;\n\n return new Promise((resolve, reject) => {\n if (!client?.connected) {\n return reject(\n getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[subscribe][${this.identifier}] MQTT Client is not available to subscribe topic!`,\n }),\n );\n }\n\n const { topics } = opts;\n client.subscribe(topics, (error) => {\n if (error) {\n return reject(error);\n }\n\n resolve(topics);\n });\n });\n }\n\n publish(opts: { topic: string; message: string | Buffer }) {\n const client = this.client;\n\n return new Promise((resolve, reject) => {\n if (!client?.connected) {\n return reject(\n getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[publish][${this.identifier}] MQTT Client is not available to publish message!`,\n }),\n );\n }\n\n const { topic, message } = opts;\n client.publish(topic, message, (error) => {\n if (error) {\n return reject(error);\n }\n\n resolve({ topic, message });\n });\n });\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/queue/mqtt/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { HTTP } from '@/common/constants/http';\nimport { ObjectUtility } from '@venizia/ignis-inversion';\nimport { RedactUtility } from '@/common/redact';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport mqtt from 'mqtt';\nimport { HookUtility } from '../common';\n\nexport interface IMQTTClientOptions {\n identifier: string;\n url: string;\n options: mqtt.IClientOptions;\n onConnect?: () => void;\n onDisconnect?: () => void;\n onError?: (error: Error) => void;\n onClose?: (error?: Error) => void;\n onMessage: (opts: { topic: string; message: Buffer }) => void;\n}\n\nexport class MQTTClientHelper extends BaseHelper {\n private url: string;\n private options: mqtt.IClientOptions;\n private client?: mqtt.MqttClient;\n\n private onConnect?: () => void;\n private onDisconnect?: () => void;\n private onError?: (error: Error) => void;\n private onClose?: (error?: Error) => void;\n private onMessage: (opts: { topic: string; message: Buffer }) => void;\n\n constructor(opts: IMQTTClientOptions) {\n super({ scope: MQTTClientHelper.name, identifier: opts.identifier });\n\n this.url = opts.url;\n this.options = opts.options;\n\n this.onConnect = opts.onConnect;\n this.onClose = opts.onClose;\n this.onError = opts.onError;\n this.onDisconnect = opts.onDisconnect;\n this.onMessage = opts.onMessage;\n\n this.configure();\n }\n\n configure() {\n if (this.client) {\n // Never serialize the client: it holds the resolved IClientOptions, password included.\n this.logger\n .for(this.configure.name)\n .info(\n '[%s] MQTT Client already established | Connected: %s',\n this.identifier,\n this.client.connected,\n );\n\n return;\n }\n\n if (ObjectUtility.isEmpty({ value: this.url })) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: '[configure] Invalid url to configure mqtt client!',\n });\n }\n\n this.logger\n .for(this.configure.name)\n .info(\n '[%s] Start configuring mqtt client | Url: %s | Options: %j',\n this.identifier,\n RedactUtility.redactUrlCredentials({ url: this.url }),\n RedactUtility.redactSecrets({ value: this.options }),\n );\n this.client = this.createClient({ url: this.url, options: this.options });\n\n this.client.on('connect', () => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onConnect',\n execution: () => this.onConnect?.(),\n });\n });\n\n this.client.on('disconnect', () => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onDisconnect',\n execution: () => this.onDisconnect?.(),\n });\n });\n\n this.client.on('message', (topic, message) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onMessage',\n execution: () => this.onMessage?.({ topic, message }),\n });\n });\n\n this.client.on('error', (error) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onError',\n execution: () => this.onError?.(error),\n });\n });\n\n this.client.on('close', (error?: Error) => {\n HookUtility.invoke({\n logger: this.logger,\n scope: 'onClose',\n execution: () => this.onClose?.(error),\n });\n });\n }\n\n /** Client factory seam - overridden in tests to run the helper without a broker. */\n protected createClient(opts: { url: string; options: mqtt.IClientOptions }): mqtt.MqttClient {\n return mqtt.connect(opts.url, opts.options);\n }\n\n getClient() {\n return this.client;\n }\n\n /** Tear the client down - without it the mqtt client, and its reconnect timer, outlives the helper forever. Resolves once the driver reports the connection ended; safe to call more than once. */\n close(opts?: { isForce?: boolean }): Promise<void> {\n const client = this.client;\n this.client = undefined;\n\n if (!client) {\n return Promise.resolve();\n }\n\n const isForce = opts?.isForce ?? false;\n\n return new Promise<void>((resolve) => {\n client.end(isForce, undefined, () => {\n this.logger.for(this.close.name).info('[%s] MQTT Client closed!', this.identifier);\n resolve();\n });\n });\n }\n\n subscribe(opts: { topics: Array<string> }) {\n const client = this.client;\n\n return new Promise((resolve, reject) => {\n if (!client?.connected) {\n return reject(\n getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[subscribe][${this.identifier}] MQTT Client is not available to subscribe topic!`,\n }),\n );\n }\n\n const { topics } = opts;\n client.subscribe(topics, (error) => {\n if (error) {\n return reject(error);\n }\n\n resolve(topics);\n });\n });\n }\n\n publish(opts: { topic: string; message: string | Buffer }) {\n const client = this.client;\n\n return new Promise((resolve, reject) => {\n if (!client?.connected) {\n return reject(\n getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `[publish][${this.identifier}] MQTT Client is not available to publish message!`,\n }),\n );\n }\n\n const { topic, message } = opts;\n client.publish(topic, message, (error) => {\n if (error) {\n return reject(error);\n }\n\n resolve({ topic, message });\n });\n });\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/base/abstract.helper.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;AAE7F,wMAAwM;AACxM,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAgC,EAAE;IAC5E,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,kBAAkB,IAAI,KAAK,CAAC;AACpF,CAAC,CAAC;AAEF,MAAM,OAAO,mBACX,SAAQ,UAAU;kBAIR,kBAAkB;IAK5B,YACE,IAAuF;QAEvF,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QAT5D,6FAA6F;QACpF,QAAoB,GAAG,IAAI,CAAC;QAUnC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAE1B,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC9D,MAAM,OAAO,GAAG,IAAI,CAAC,MAAsB,CAAC;QAE5C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YACzB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,4BAA4B,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACzE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YACnE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE;YACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,oCAAoC,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YACvF,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACtD,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YAC9B,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,sCAAsC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;QAEH,aAAa,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAES,MAAM,CAAC,kBAAkB,CAAC,IAA0B;QAC5D,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAE1B,OAAO,CAAC,cAAsB,EAAE,EAAE;YAChC,IAAI,QAAQ,GAAG,CAAC,CAAC,IAAI,cAAc,GAAG,QAAQ,EAAE,CAAC;gBAC/C,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,cAAc,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;QAC/D,CAAC,CAAC;IACJ,CAAC;IAES,MAAM,CAAC,gBAAgB,CAAC,IAA0B;QAC1D,OAAO;YACL,sBAAsB,EAAE,IAAI;YAC5B,oBAAoB,EAAE,IAAI;YAC1B,aAAa,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;SACnF,CAAC;IACJ,CAAC;IAED,kDAAkD;IAElD,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,eAAe;QACb,iGAAiG;QACjG,MAAM,UAAU,GAAsC,IAAI,CAAC,MAAM,CAAC;QAClE,OAAO,UAAU,CAAC,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,IAAI;QACF,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5B,CAAC;IAED,OAAO;QACL,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,eAAe,GAAkC;gBACrD,OAAO;gBACP,cAAc;gBACd,YAAY;aACb,CAAC;YAEF,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;qBACtB,IAAI,CAAC,qDAAqD,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBAEnF,OAAO,CAAC,KAAK,CAAC,CAAC;gBACf,OAAO;YACT,CAAC;YAED,IAAI,CAAC,MAAM;iBACR,OAAO,EAAE;iBACT,IAAI,CAAC,GAAG,EAAE;gBACT,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;YAC1C,CAAC,CAAC;iBACD,KAAK,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,OAAO,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,MAAM,eAAe,GAAkC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACxE,IAAI,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjD,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;qBACzB,IAAI,CAAC,wDAAwD,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;gBACtF,OAAO,CAAC,KAAK,CAAC,CAAC;gBACf,OAAO;YACT,CAAC;YAED,IAAI,CAAC,MAAM;iBACR,IAAI,EAAE;iBACN,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;gBACX,OAAO,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC;YACvB,CAAC,CAAC;iBACD,KAAK,CAAC,MAAM,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAE/C,MAAM,CAAC,IAA6B;QAClC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAsC;QACjD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO,MAAM,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAA6C;QAC1D,MAAM,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC/D,OAAO,MAAM,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,GAAG,CAAC,IAAqB;QACvB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAqB;QACjC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9C,OAAO,MAAM,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,IAAqB;QACxB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,IAAqB;QACxB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,IAAoC;QACzC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,MAAM,CAAC,IAAoC;QACzC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,qCAAqC;IAErC,KAAK,CAAC,GAAG,CAAI,IAIZ;QACC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAErC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,OAAO,OAAO,EAAE,SAAS,KAAK,QAAQ,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,yBAAyB,EAAE,GAAG,EAAE,UAAU,CAAC,CAAC;IAClF,CAAC;IAED,KAAK,CAAC,GAAG,CAAa,IAGrB;QACC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAEhC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAiB,CAAC;IAC3D,CAAC;IAED,GAAG,CAAC,IAA6B;QAC/B,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,SAAS,CAAC,IAAqB;QAC7B,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,UAAU,CAAC,IAA6B;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,SAAS,CAAI,IAAqB;QAChC,OAAO,IAAI,CAAC,GAAG,CAAI;YACjB,GAAG,IAAI;YACP,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,UAAU,CAAC,IAA6B;QACtC,OAAO,IAAI,CAAC,IAAI,CAAC;YACf,GAAG,IAAI;YACP,SAAS,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI,CAAI,IAGb;QACC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO;QACT,CAAC;QAED,0FAA0F;QAC1F,6FAA6F;QAC7F,gCAAgC;QAChC,MAAM,UAAU,GAA2B,EAAE,CAAC;QAC9C,KAAK,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;YACrC,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEnC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,IAAI,CAAa,IAGtB;QACC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,EAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACzF,CAAC;IAED,IAAI,CAAC,IAAqB;QACxB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,uCAAuC;IAEvC,KAAK,CAAC,IAAI,CAAoC,IAI7C;QACC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAiD,CAAC,CAAC;QAE9F,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC;YAClB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAwD;QACpE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAChC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC;YACzB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,IAAoC;QACvC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,CAAC,IAA4C;QAC/C,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAoC;QAChD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAC5B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO,MAAM,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAqB;QACzB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,IAAqB;QACzB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,CAAC,IAAmD;QACzD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,IAAqB;QACxB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,qCAAqC;IAErC,IAAI,CAAC,IAAsD;QACzD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,IAAsD;QACzD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,QAAQ,CAAC,IAAqB;QAC5B,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAA8C;QAC5D,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QACxD,OAAO,MAAM,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,IAAqB;QACzB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED,uCAAuC;IAEvC,KAAK,CAAC,IAAqD;QACzD,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAqD;QACzD,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACnB,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC,IAAqB;QACxB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,CAAC,IAAqB;QACxB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,IAAkD;QACvD,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAClC,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,IAAqB;QACxB,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAED,iCAAiC;IAEjC,IAAI,CAAI,IAA6C;QACnD,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAgB,UAAU,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,IAAI,CAAI,IAAoC;QAC1C,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAW,UAAU,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,CAAC,IAAoC;QAC1C,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;QACjC,OAAO,IAAI,CAAC,OAAO,CAAS,UAAU,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,iBAAiB,CAAC,IAAkD;QAClE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAgB,gBAAgB,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3E,CAAC;IAED,aAAa,CAAC,IAAkD;QAC9D,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAkB,gBAAgB,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,KAAK,CAAI,IAA6C;QACpD,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAClC,OAAO,IAAI,CAAC,OAAO,CAAkB,gBAAgB,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7F,CAAC;IAED,IAAI,CAAI,IAAmC;QACzC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAW,aAAa,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,sCAAsC;IAEtC,OAAO,CAAI,OAAe,EAAE,UAA4C;QACtE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAe,CAAC;QACjD,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAe,CAAC;IAC7D,CAAC;IAED,iCAAiC;IAEjC,KAAK,CAAC,OAAO,CAAI,IAIhB;QACC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAClD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,KAAK,EAAE,GAAG,IAAI,CAAC;QAEtD,MAAM,WAAW,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACxF,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;YACzB,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;YAC5C,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAEjE,uGAAuG;QACvG,MAAM,cAAc,CAAC,gBAAgB,CAAC;YACpC,KAAK,EAAE,gBAAgB,CAAC,aAAa;YACrC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;SAC5E,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,IAAuB;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC;YACvC,OAAO;QACT,CAAC;QAED,cAAc,CAAC,aAAa,CAAC;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;YAC1B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBACvD,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,KAAK,CAAC,8CAA8C,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;oBAC3E,OAAO;gBACT,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,uDAAuD,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACrF,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,WAAW,CAAC,IAAuB;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAEvB,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;YACtD,MAAM,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YACzC,OAAO;QACT,CAAC;QAED,cAAc,CAAC,aAAa,CAAC;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;YAC5B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;gBACzD,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,CAAC,KAAK,CAAC,kDAAkD,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;oBAC/E,OAAO;gBACT,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport type { AnyType } from '@/common/types';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { BaseHelper } from '@/modules/base';\nimport { type EventEmitter } from 'node:events';\nimport zlib from 'node:zlib';\nimport { RedisConcurrency } from './../common/constants';\nimport { type IRedisHelper } from './../common/interfaces';\nimport { type IRedisHelperCallbacks, type TRedisClient } from './../common/types';\n\nexport const REDIS_HELPER_BRAND = Symbol.for('@venizia/ignis-helpers:abstract-redis-helper');\n\n/** Brand check, never `instanceof`: two installed copies of this package are two distinct classes, so a helper built by one is rejected by the other. `Symbol.for` is realm-keyed and survives that. */\nexport const isRedisHelper = (value: unknown): value is AbstractRedisHelper => {\n return typeof value === 'object' && value !== null && REDIS_HELPER_BRAND in value;\n};\n\nexport class AbstractRedisHelper<ClientType extends TRedisClient = TRedisClient>\n extends BaseHelper\n implements IRedisHelper\n{\n /** Read by {@link isRedisHelper}. On the instance, so every subclass instance carries it. */\n readonly [REDIS_HELPER_BRAND] = true;\n\n client: ClientType;\n readonly name: string;\n\n constructor(\n opts: { scope: string; identifier: string; client: ClientType } & IRedisHelperCallbacks,\n ) {\n super({ scope: opts.scope, identifier: opts.identifier });\n\n this.name = opts.identifier;\n this.client = opts.client;\n\n const { onInitialized, onConnected, onReady, onError } = opts;\n const emitter = this.client as EventEmitter;\n\n emitter.on('connect', () => {\n this.logger.for('connect').info('Redis CONNECTED | Name: %s', this.name);\n onConnected?.({ name: this.name, helper: this });\n });\n\n emitter.on('ready', () => {\n this.logger.for('ready').info('Redis READY | Name: %s', this.name);\n onReady?.({ name: this.name, helper: this });\n });\n\n emitter.on('error', (error: Error) => {\n this.logger.for('error').error('Redis ERROR | Name: %s | Error: %s', this.name, error);\n onError?.({ name: this.name, helper: this, error });\n });\n\n emitter.on('reconnecting', () => {\n this.logger.for('reconnecting').warn('Redis client RECONNECTING | Name: %s', this.name);\n });\n\n onInitialized?.({ name: this.name, helper: this });\n }\n\n protected static buildRetryStrategy(opts: { maxRetry: number }) {\n const { maxRetry } = opts;\n\n return (attemptCounter: number) => {\n if (maxRetry > -1 && attemptCounter > maxRetry) {\n return undefined;\n }\n\n return Math.max(Math.min(attemptCounter * 2000, 5000), 1000);\n };\n }\n\n protected static buildDefaultOpts(opts: { maxRetry: number }) {\n return {\n showFriendlyErrorStack: true,\n maxRetriesPerRequest: null,\n retryStrategy: AbstractRedisHelper.buildRetryStrategy({ maxRetry: opts.maxRetry }),\n };\n }\n\n // --- Connection lifecycle (IRedisConnection) ---\n\n getClient() {\n return this.client;\n }\n\n duplicateClient(): TRedisClient {\n // ioredis 6 types `duplicate` per client; the `Redis | Cluster` union has no callable signature.\n const duplicable: { duplicate: () => TRedisClient } = this.client;\n return duplicable.duplicate();\n }\n\n ping() {\n return this.client.ping();\n }\n\n connect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = [\n 'ready',\n 'reconnecting',\n 'connecting',\n ];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.connect.name)\n .info('status: %s | Invalid redis status to invoke connect', this.client.status);\n\n resolve(false);\n return;\n }\n\n this.client\n .connect()\n .then(() => {\n resolve(this.client.status === 'ready');\n })\n .catch(reject);\n });\n }\n\n disconnect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = ['end', 'close'];\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.disconnect.name)\n .info('status: %s | Invalid redis status to invoke disconnect', this.client.status);\n resolve(false);\n return;\n }\n\n this.client\n .quit()\n .then((rs) => {\n resolve(rs === 'OK');\n })\n .catch(reject);\n });\n }\n\n // --- Key lifecycle + counters (IRedisKey) ---\n\n exists(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n if (!keys.length) {\n return Promise.resolve(0);\n }\n return this.client.exists(...keys);\n }\n\n async expire(opts: { key: string; seconds: number }): Promise<boolean> {\n const { key, seconds } = opts;\n const result = await this.client.expire(key, seconds);\n return result === 1;\n }\n\n async expireAt(opts: { key: string; atEpochSeconds: number }): Promise<boolean> {\n const { key, atEpochSeconds } = opts;\n const result = await this.client.expireat(key, atEpochSeconds);\n return result === 1;\n }\n\n ttl(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.ttl(key);\n }\n\n async persist(opts: { key: string }): Promise<boolean> {\n const { key } = opts;\n const result = await this.client.persist(key);\n return result === 1;\n }\n\n incr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.incr(key);\n }\n\n decr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.decr(key);\n }\n\n incrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n return this.client.incrby(key, value);\n }\n\n decrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n return this.client.decrby(key, value);\n }\n\n // --- Key-value (IRedisKeyValue) ---\n\n async set<T>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean; expiresIn?: number };\n }): Promise<void> {\n const { key, value, options } = opts;\n\n const serialized = JSON.stringify(value);\n if (typeof options?.expiresIn === 'number' && options.expiresIn > 0) {\n await this.client.set(key, serialized, 'PX', options.expiresIn);\n } else {\n await this.client.set(key, serialized);\n }\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.set.name).info('Set key: %s | value: %s', key, serialized);\n }\n\n async get<T = string>(opts: {\n key: string;\n transform?: (input: string) => T;\n }): Promise<T | null> {\n const { key, transform } = opts;\n\n const value = await this.client.get(key);\n if (!value) {\n return null;\n }\n\n return transform ? transform(value) : (value as AnyType);\n }\n\n del(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n if (!keys.length) {\n return Promise.resolve(0);\n }\n return this.client.del(keys);\n }\n\n getString(opts: { key: string }) {\n return this.get(opts);\n }\n\n getStrings(opts: { keys: Array<string> }) {\n return this.mGet(opts);\n }\n\n getObject<T>(opts: { key: string }) {\n return this.get<T>({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n getObjects(opts: { keys: Array<string> }) {\n return this.mGet({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n async mSet<T>(opts: {\n payload: Array<{ key: string; value: T }>;\n options?: { log?: boolean };\n }): Promise<void> {\n const { payload, options } = opts;\n if (!payload.length) {\n return;\n }\n\n // A plain loop, not spread-in-reduce: `{ ...current, [key]: v }` copies every key already\n // accumulated on EVERY element, which is O(n^2). Measured at 10k keys: 2.2s of blocked event\n // loop, against 1.5ms for this.\n const serialized: Record<string, string> = {};\n for (const { key, value } of payload) {\n serialized[key] = JSON.stringify(value);\n }\n await this.client.mset(serialized);\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.mSet.name).info('Payload: %j', serialized);\n }\n\n async mGet<T = string>(opts: {\n keys: Array<string>;\n transform?: (input: string) => T;\n }): Promise<(T | null)[]> {\n const { keys, transform } = opts;\n if (!keys.length) {\n return [];\n }\n\n const values = await this.client.mget(keys);\n if (!values?.length) {\n return [];\n }\n\n return values.map((el) => (el ? (transform ? transform(el) : (el as AnyType)) : null));\n }\n\n keys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.keys(key);\n }\n\n // --- Hash operations (IRedisHash) ---\n\n async hSet<T extends Record<string, unknown>>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean };\n }): Promise<number> {\n const { key, value, options } = opts;\n const result = await this.client.hset(key, value as Record<string, string | number | Buffer>);\n\n if (!options?.log) {\n return result;\n }\n\n this.logger.for(this.hSet.name).info('Result: %j', result);\n return result;\n }\n\n async hGetAll(opts: { key: string; transform?: <T, R>(input: T) => R }) {\n const { key, transform } = opts;\n const value = await this.client.hgetall(key);\n if (!transform || !value) {\n return value;\n }\n\n return transform(value);\n }\n\n hGet(opts: { key: string; field: string }): Promise<string | null> {\n const { key, field } = opts;\n return this.client.hget(key, field);\n }\n\n hDel(opts: { key: string; fields: Array<string> }): Promise<number> {\n const { key, fields } = opts;\n if (!fields.length) {\n return Promise.resolve(0);\n }\n return this.client.hdel(key, ...fields);\n }\n\n async hExists(opts: { key: string; field: string }): Promise<boolean> {\n const { key, field } = opts;\n const result = await this.client.hexists(key, field);\n return result === 1;\n }\n\n hKeys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.hkeys(key);\n }\n\n hVals(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.hvals(key);\n }\n\n hIncrBy(opts: { key: string; field: string; value: number }): Promise<number> {\n const { key, field, value } = opts;\n return this.client.hincrby(key, field, value);\n }\n\n hLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.hlen(key);\n }\n\n // --- Set operations (IRedisSet) ---\n\n sAdd(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n if (!members.length) {\n return Promise.resolve(0);\n }\n return this.client.sadd(key, ...members);\n }\n\n sRem(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n if (!members.length) {\n return Promise.resolve(0);\n }\n return this.client.srem(key, ...members);\n }\n\n sMembers(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n return this.client.smembers(key);\n }\n\n async sIsMember(opts: { key: string; member: string | number }): Promise<boolean> {\n const { key, member } = opts;\n const result = await this.client.sismember(key, member);\n return result === 1;\n }\n\n sCard(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.scard(key);\n }\n\n // --- List operations (IRedisList) ---\n\n lPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n if (!values.length) {\n return Promise.resolve(0);\n }\n return this.client.lpush(key, ...values);\n }\n\n rPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n if (!values.length) {\n return Promise.resolve(0);\n }\n return this.client.rpush(key, ...values);\n }\n\n lPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n return this.client.lpop(key);\n }\n\n rPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n return this.client.rpop(key);\n }\n\n lRange(opts: { key: string; start: number; stop: number }): Promise<string[]> {\n const { key, start, stop } = opts;\n return this.client.lrange(key, start, stop);\n }\n\n lLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n return this.client.llen(key);\n }\n\n // --- RedisJSON (IRedisJson) ---\n\n jSet<T>(opts: { key: string; path: string; value: T }): Promise<string | null> {\n const { key, path, value } = opts;\n return this.execute<string | null>('JSON.SET', [key, path, JSON.stringify(value)]);\n }\n\n jGet<T>(opts: { key: string; path?: string }): Promise<T | null> {\n const { key, path = '$' } = opts;\n return this.execute<T | null>('JSON.GET', [key, path]);\n }\n\n jDelete(opts: { key: string; path?: string }): Promise<number> {\n const { key, path = '$' } = opts;\n return this.execute<number>('JSON.DEL', [key, path]);\n }\n\n jNumberIncreaseBy(opts: { key: string; path: string; value: number }): Promise<string | null> {\n const { key, path, value } = opts;\n return this.execute<string | null>('JSON.NUMINCRBY', [key, path, value]);\n }\n\n jStringAppend(opts: { key: string; path: string; value: string }): Promise<number[] | null> {\n const { key, path, value } = opts;\n return this.execute<number[] | null>('JSON.STRAPPEND', [key, path, value]);\n }\n\n jPush<T>(opts: { key: string; path: string; value: T }): Promise<number[] | null> {\n const { key, path, value } = opts;\n return this.execute<number[] | null>('JSON.ARRAPPEND', [key, path, JSON.stringify(value)]);\n }\n\n jPop<T>(opts: { key: string; path: string }): Promise<T | null> {\n const { key, path } = opts;\n return this.execute<T | null>('JSON.ARRPOP', [key, path]);\n }\n\n // --- Raw command (IRedisCommand) ---\n\n execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R> {\n if (!parameters?.length) {\n return this.client.call(command) as Promise<R>;\n }\n\n return this.client.call(command, parameters) as Promise<R>;\n }\n\n // --- Pub/Sub (IRedisPubSub) ---\n\n async publish<T>(opts: {\n topics: Array<string>;\n payload: T;\n useCompress?: boolean;\n }): Promise<void> {\n const logger = this.logger.for(this.publish.name);\n const { topics, payload, useCompress = false } = opts;\n\n const validTopics = topics?.filter((topic) => !ObjectUtility.isEmpty({ value: topic }));\n if (!validTopics?.length) {\n logger.error('No topic(s) to publish!');\n return;\n }\n\n if (!payload) {\n logger.error('Invalid payload to publish!');\n return;\n }\n\n const message = Buffer.from(JSON.stringify(payload));\n const packet = useCompress ? zlib.deflateSync(message) : message;\n\n // `topics` is caller-supplied, so an unbounded fan-out here is a caller-sized burst on one connection.\n await PromiseUtility.executeWithLimit({\n limit: RedisConcurrency.PUBLISH_LIMIT,\n tasks: validTopics.map((topic) => () => this.client.publish(topic, packet)),\n });\n }\n\n subscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.subscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to subscribe!');\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.subscribe.name,\n execution: this.client.subscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to subscribe to topic: %s | Error: %s', topic, error);\n return;\n }\n\n logger.info('Subscribed to %s channel(s). Listening to channel: %s', count, topic);\n }),\n });\n }\n\n unsubscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.unsubscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to unsubscribe!');\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.unsubscribe.name,\n execution: this.client.unsubscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to unsubscribe from topic: %s | Error: %s', topic, error);\n return;\n }\n\n logger.info('Unsubscribed from %s channel(s).', count);\n }),\n });\n }\n}\n"]}
1
+ {"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/redis/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ObjectUtility } from '@venizia/ignis-inversion';\nimport type { AnyType } from '@/common/types';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { BaseHelper } from '@/modules/base';\nimport { type EventEmitter } from 'node:events';\nimport zlib from 'node:zlib';\nimport { RedisConcurrency } from './../common/constants';\nimport { type IRedisHelper } from './../common/interfaces';\nimport { type IRedisHelperCallbacks, type TRedisClient } from './../common/types';\n\nexport const REDIS_HELPER_BRAND = Symbol.for('@venizia/ignis-helpers:abstract-redis-helper');\n\n/** Brand check, never `instanceof`: two installed copies of this package are two distinct classes, so a helper built by one is rejected by the other. `Symbol.for` is realm-keyed and survives that. */\nexport const isRedisHelper = (value: unknown): value is AbstractRedisHelper => {\n return typeof value === 'object' && value !== null && REDIS_HELPER_BRAND in value;\n};\n\nexport class AbstractRedisHelper<ClientType extends TRedisClient = TRedisClient>\n extends BaseHelper\n implements IRedisHelper\n{\n /** Read by {@link isRedisHelper}. On the instance, so every subclass instance carries it. */\n readonly [REDIS_HELPER_BRAND] = true;\n\n client: ClientType;\n readonly name: string;\n\n constructor(\n opts: { scope: string; identifier: string; client: ClientType } & IRedisHelperCallbacks,\n ) {\n super({ scope: opts.scope, identifier: opts.identifier });\n\n this.name = opts.identifier;\n this.client = opts.client;\n\n const { onInitialized, onConnected, onReady, onError } = opts;\n const emitter = this.client as EventEmitter;\n\n emitter.on('connect', () => {\n this.logger.for('connect').info('Redis CONNECTED | Name: %s', this.name);\n onConnected?.({ name: this.name, helper: this });\n });\n\n emitter.on('ready', () => {\n this.logger.for('ready').info('Redis READY | Name: %s', this.name);\n onReady?.({ name: this.name, helper: this });\n });\n\n emitter.on('error', (error: Error) => {\n this.logger.for('error').error('Redis ERROR | Name: %s | Error: %s', this.name, error);\n onError?.({ name: this.name, helper: this, error });\n });\n\n emitter.on('reconnecting', () => {\n this.logger.for('reconnecting').warn('Redis client RECONNECTING | Name: %s', this.name);\n });\n\n onInitialized?.({ name: this.name, helper: this });\n }\n\n protected static buildRetryStrategy(opts: { maxRetry: number }) {\n const { maxRetry } = opts;\n\n return (attemptCounter: number) => {\n if (maxRetry > -1 && attemptCounter > maxRetry) {\n return undefined;\n }\n\n return Math.max(Math.min(attemptCounter * 2000, 5000), 1000);\n };\n }\n\n protected static buildDefaultOpts(opts: { maxRetry: number }) {\n return {\n showFriendlyErrorStack: true,\n maxRetriesPerRequest: null,\n retryStrategy: AbstractRedisHelper.buildRetryStrategy({ maxRetry: opts.maxRetry }),\n };\n }\n\n // --- Connection lifecycle (IRedisConnection) ---\n\n getClient() {\n return this.client;\n }\n\n duplicateClient(): TRedisClient {\n // ioredis 6 types `duplicate` per client; the `Redis | Cluster` union has no callable signature.\n const duplicable: { duplicate: () => TRedisClient } = this.client;\n\n return duplicable.duplicate();\n }\n\n ping() {\n return this.client.ping();\n }\n\n connect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = [\n 'ready',\n 'reconnecting',\n 'connecting',\n ];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.connect.name)\n .info('status: %s | Invalid redis status to invoke connect', this.client.status);\n\n resolve(false);\n\n return;\n }\n\n this.client\n .connect()\n .then(() => {\n resolve(this.client.status === 'ready');\n })\n .catch(reject);\n });\n }\n\n disconnect() {\n return new Promise<boolean>((resolve, reject) => {\n const invalidStatuses: (typeof this.client.status)[] = ['end', 'close'];\n\n if (invalidStatuses.includes(this.client.status)) {\n this.logger\n .for(this.disconnect.name)\n .info('status: %s | Invalid redis status to invoke disconnect', this.client.status);\n resolve(false);\n\n return;\n }\n\n this.client\n .quit()\n .then((rs) => {\n resolve(rs === 'OK');\n })\n .catch(reject);\n });\n }\n\n // --- Key lifecycle + counters (IRedisKey) ---\n\n exists(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n\n if (!keys.length) {\n return Promise.resolve(0);\n }\n\n return this.client.exists(...keys);\n }\n\n async expire(opts: { key: string; seconds: number }): Promise<boolean> {\n const { key, seconds } = opts;\n const result = await this.client.expire(key, seconds);\n\n return result === 1;\n }\n\n async expireAt(opts: { key: string; atEpochSeconds: number }): Promise<boolean> {\n const { key, atEpochSeconds } = opts;\n const result = await this.client.expireat(key, atEpochSeconds);\n\n return result === 1;\n }\n\n ttl(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.ttl(key);\n }\n\n async persist(opts: { key: string }): Promise<boolean> {\n const { key } = opts;\n const result = await this.client.persist(key);\n\n return result === 1;\n }\n\n incr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.incr(key);\n }\n\n decr(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.decr(key);\n }\n\n incrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n\n return this.client.incrby(key, value);\n }\n\n decrBy(opts: { key: string; value: number }): Promise<number> {\n const { key, value } = opts;\n\n return this.client.decrby(key, value);\n }\n\n // --- Key-value (IRedisKeyValue) ---\n\n async set<T>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean; expiresIn?: number };\n }): Promise<void> {\n const { key, value, options } = opts;\n\n const serialized = JSON.stringify(value);\n\n if (typeof options?.expiresIn === 'number' && options.expiresIn > 0) {\n await this.client.set(key, serialized, 'PX', options.expiresIn);\n } else {\n await this.client.set(key, serialized);\n }\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.set.name).info('Set key: %s | value: %s', key, serialized);\n }\n\n async get<T = string>(opts: {\n key: string;\n transform?: (input: string) => T;\n }): Promise<T | null> {\n const { key, transform } = opts;\n\n const value = await this.client.get(key);\n\n if (!value) {\n return null;\n }\n\n return transform ? transform(value) : (value as AnyType);\n }\n\n del(opts: { keys: Array<string> }): Promise<number> {\n const { keys } = opts;\n\n if (!keys.length) {\n return Promise.resolve(0);\n }\n\n return this.client.del(keys);\n }\n\n getString(opts: { key: string }) {\n return this.get(opts);\n }\n\n getStrings(opts: { keys: Array<string> }) {\n return this.mGet(opts);\n }\n\n getObject<T>(opts: { key: string }) {\n return this.get<T>({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n getObjects(opts: { keys: Array<string> }) {\n return this.mGet({\n ...opts,\n transform: (el: string) => JSON.parse(el),\n });\n }\n\n async mSet<T>(opts: {\n payload: Array<{ key: string; value: T }>;\n options?: { log?: boolean };\n }): Promise<void> {\n const { payload, options } = opts;\n\n if (!payload.length) {\n return;\n }\n\n // A plain loop, not spread-in-reduce: `{ ...current, [key]: v }` copies every key already\n // accumulated on EVERY element, which is O(n^2). Measured at 10k keys: 2.2s of blocked event\n // loop, against 1.5ms for this.\n const serialized: Record<string, string> = {};\n\n for (const { key, value } of payload) {\n serialized[key] = JSON.stringify(value);\n }\n\n await this.client.mset(serialized);\n\n if (!options?.log) {\n return;\n }\n\n this.logger.for(this.mSet.name).info('Payload: %j', serialized);\n }\n\n async mGet<T = string>(opts: {\n keys: Array<string>;\n transform?: (input: string) => T;\n }): Promise<(T | null)[]> {\n const { keys, transform } = opts;\n\n if (!keys.length) {\n return [];\n }\n\n const values = await this.client.mget(keys);\n\n if (!values?.length) {\n return [];\n }\n\n return values.map((el) => (el ? (transform ? transform(el) : (el as AnyType)) : null));\n }\n\n keys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.keys(key);\n }\n\n // --- Hash operations (IRedisHash) ---\n\n async hSet<T extends Record<string, unknown>>(opts: {\n key: string;\n value: T;\n options?: { log?: boolean };\n }): Promise<number> {\n const { key, value, options } = opts;\n const result = await this.client.hset(key, value as Record<string, string | number | Buffer>);\n\n if (!options?.log) {\n return result;\n }\n\n this.logger.for(this.hSet.name).info('Result: %j', result);\n\n return result;\n }\n\n async hGetAll(opts: { key: string; transform?: <T, R>(input: T) => R }) {\n const { key, transform } = opts;\n const value = await this.client.hgetall(key);\n\n if (!transform || !value) {\n return value;\n }\n\n return transform(value);\n }\n\n hGet(opts: { key: string; field: string }): Promise<string | null> {\n const { key, field } = opts;\n\n return this.client.hget(key, field);\n }\n\n hDel(opts: { key: string; fields: Array<string> }): Promise<number> {\n const { key, fields } = opts;\n\n if (!fields.length) {\n return Promise.resolve(0);\n }\n\n return this.client.hdel(key, ...fields);\n }\n\n async hExists(opts: { key: string; field: string }): Promise<boolean> {\n const { key, field } = opts;\n const result = await this.client.hexists(key, field);\n\n return result === 1;\n }\n\n hKeys(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.hkeys(key);\n }\n\n hVals(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.hvals(key);\n }\n\n hIncrBy(opts: { key: string; field: string; value: number }): Promise<number> {\n const { key, field, value } = opts;\n\n return this.client.hincrby(key, field, value);\n }\n\n hLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.hlen(key);\n }\n\n // --- Set operations (IRedisSet) ---\n\n sAdd(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n\n if (!members.length) {\n return Promise.resolve(0);\n }\n\n return this.client.sadd(key, ...members);\n }\n\n sRem(opts: { key: string; members: Array<string | number> }): Promise<number> {\n const { key, members } = opts;\n\n if (!members.length) {\n return Promise.resolve(0);\n }\n\n return this.client.srem(key, ...members);\n }\n\n sMembers(opts: { key: string }): Promise<string[]> {\n const { key } = opts;\n\n return this.client.smembers(key);\n }\n\n async sIsMember(opts: { key: string; member: string | number }): Promise<boolean> {\n const { key, member } = opts;\n const result = await this.client.sismember(key, member);\n\n return result === 1;\n }\n\n sCard(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.scard(key);\n }\n\n // --- List operations (IRedisList) ---\n\n lPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n\n if (!values.length) {\n return Promise.resolve(0);\n }\n\n return this.client.lpush(key, ...values);\n }\n\n rPush(opts: { key: string; values: Array<string | number> }): Promise<number> {\n const { key, values } = opts;\n\n if (!values.length) {\n return Promise.resolve(0);\n }\n\n return this.client.rpush(key, ...values);\n }\n\n lPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n\n return this.client.lpop(key);\n }\n\n rPop(opts: { key: string }): Promise<string | null> {\n const { key } = opts;\n\n return this.client.rpop(key);\n }\n\n lRange(opts: { key: string; start: number; stop: number }): Promise<string[]> {\n const { key, start, stop } = opts;\n\n return this.client.lrange(key, start, stop);\n }\n\n lLen(opts: { key: string }): Promise<number> {\n const { key } = opts;\n\n return this.client.llen(key);\n }\n\n // --- RedisJSON (IRedisJson) ---\n\n jSet<T>(opts: { key: string; path: string; value: T }): Promise<string | null> {\n const { key, path, value } = opts;\n\n return this.execute<string | null>('JSON.SET', [key, path, JSON.stringify(value)]);\n }\n\n jGet<T>(opts: { key: string; path?: string }): Promise<T | null> {\n const { key, path = '$' } = opts;\n\n return this.execute<T | null>('JSON.GET', [key, path]);\n }\n\n jDelete(opts: { key: string; path?: string }): Promise<number> {\n const { key, path = '$' } = opts;\n\n return this.execute<number>('JSON.DEL', [key, path]);\n }\n\n jNumberIncreaseBy(opts: { key: string; path: string; value: number }): Promise<string | null> {\n const { key, path, value } = opts;\n\n return this.execute<string | null>('JSON.NUMINCRBY', [key, path, value]);\n }\n\n jStringAppend(opts: { key: string; path: string; value: string }): Promise<number[] | null> {\n const { key, path, value } = opts;\n\n return this.execute<number[] | null>('JSON.STRAPPEND', [key, path, value]);\n }\n\n jPush<T>(opts: { key: string; path: string; value: T }): Promise<number[] | null> {\n const { key, path, value } = opts;\n\n return this.execute<number[] | null>('JSON.ARRAPPEND', [key, path, JSON.stringify(value)]);\n }\n\n jPop<T>(opts: { key: string; path: string }): Promise<T | null> {\n const { key, path } = opts;\n\n return this.execute<T | null>('JSON.ARRPOP', [key, path]);\n }\n\n // --- Raw command (IRedisCommand) ---\n\n execute<R>(command: string, parameters?: Array<string | number | Buffer>): Promise<R> {\n if (!parameters?.length) {\n return this.client.call(command) as Promise<R>;\n }\n\n return this.client.call(command, parameters) as Promise<R>;\n }\n\n // --- Pub/Sub (IRedisPubSub) ---\n\n async publish<T>(opts: {\n topics: Array<string>;\n payload: T;\n useCompress?: boolean;\n }): Promise<void> {\n const logger = this.logger.for(this.publish.name);\n const { topics, payload, useCompress = false } = opts;\n\n const validTopics = topics?.filter((topic) => !ObjectUtility.isEmpty({ value: topic }));\n\n if (!validTopics?.length) {\n logger.error('No topic(s) to publish!');\n\n return;\n }\n\n if (!payload) {\n logger.error('Invalid payload to publish!');\n\n return;\n }\n\n const message = Buffer.from(JSON.stringify(payload));\n const packet = useCompress ? zlib.deflateSync(message) : message;\n\n // `topics` is caller-supplied, so an unbounded fan-out here is a caller-sized burst on one connection.\n await PromiseUtility.executeWithLimit({\n limit: RedisConcurrency.PUBLISH_LIMIT,\n tasks: validTopics.map((topic) => () => this.client.publish(topic, packet)),\n });\n }\n\n subscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.subscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to subscribe!');\n\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.subscribe.name,\n execution: this.client.subscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to subscribe to topic: %s | Error: %s', topic, error);\n\n return;\n }\n\n logger.info('Subscribed to %s channel(s). Listening to channel: %s', count, topic);\n }),\n });\n }\n\n unsubscribe(opts: { topic: string }) {\n const logger = this.logger.for(this.unsubscribe.name);\n const { topic } = opts;\n\n if (!topic || ObjectUtility.isEmpty({ value: topic })) {\n logger.error('No topic to unsubscribe!');\n\n return;\n }\n\n PromiseUtility.voidExecution({\n logger: this.logger,\n scope: this.unsubscribe.name,\n execution: this.client.unsubscribe(topic, (error, count) => {\n if (error) {\n logger.error('Failed to unsubscribe from topic: %s | Error: %s', topic, error);\n\n return;\n }\n\n logger.info('Unsubscribed from %s channel(s).', count);\n }),\n });\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../src/modules/redis/utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,MAAM,OAAO,YAAY;IACvB,+GAA+G;IAC/G,MAAM,CAAC,YAAY,CAAC,IAAkD;QACpE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,mBAAmB,EAAE,GAAG,IAAI,CAAC;QAEzD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC9B,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,MAAsB,CAAC;YAEvC,kLAAkL;YAClL,MAAM,QAAQ,GAAsB,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE;gBAC/B,MAAM,EAAE,CAAC;gBACT,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC;YAEF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,MAAM,EAAE,CAAC;gBACT,MAAM,CACJ,QAAQ,CAAC;oBACP,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;oBACrD,OAAO,EAAE,4CAA4C,SAAS,eAAe,MAAM,CAAC,MAAM,GAAG;iBAC9F,CAAC,CACH,CAAC;YACJ,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,QAAQ,CAAC,IAAI,CACX,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EACzB,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,EAC9C,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAC/C,CAAC;YAEF,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,wJAAwJ;IACxJ,MAAM,CAAC,gBAAgB,CAAC,IAIvB;QACC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAExC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC7B,SAAS;YACX,CAAC;YAED,cAAc,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;CACF","sourcesContent":["import { HTTP } from '@/common';\nimport { getError } from '@/modules/error';\nimport type { ILogger } from '@/modules/logger';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { type EventEmitter } from 'node:events';\nimport type { TRedisClient } from './common';\n\nconst REDIS_READY_TIMEOUT = 30_000;\n\nexport class RedisUtility {\n /** Resolves once the client reaches `ready`; rejects on the first client error or when `timeoutMs` elapses. */\n static waitForReady(opts: { client: TRedisClient; timeoutMs?: number }): Promise<void> {\n const { client, timeoutMs = REDIS_READY_TIMEOUT } = opts;\n\n return new Promise<void>((resolve, reject) => {\n if (client.status === 'ready') {\n resolve();\n return;\n }\n\n const emitter = client as EventEmitter;\n\n /** Run by every terminal branch: clients are long-lived and re-`configure()`d, so an unbound listener leaks (EventEmitter warns) and could fire on an already-settled promise. */\n const cleanups: Array<() => void> = [];\n const detach = () => {\n for (const cleanup of cleanups) {\n cleanup();\n }\n };\n\n const onReady = () => {\n detach();\n resolve();\n };\n\n const onError = (error: Error) => {\n detach();\n reject(error);\n };\n\n const timer = setTimeout(() => {\n detach();\n reject(\n getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `Redis client did not become ready within ${timeoutMs}ms (status: ${client.status})`,\n }),\n );\n }, timeoutMs);\n\n cleanups.push(\n () => clearTimeout(timer),\n () => emitter.removeListener('ready', onReady),\n () => emitter.removeListener('error', onError),\n );\n\n emitter.once('ready', onReady);\n emitter.once('error', onError);\n });\n }\n\n /** Kicks off connection for clients still parked in `wait` - duplicated clients inherit `lazyConnect` from their parent and never dial on their own. */\n static ensureConnecting(opts: {\n clients: TRedisClient[];\n logger?: ILogger;\n scope: string;\n }): void {\n const { clients, logger, scope } = opts;\n\n for (const client of clients) {\n if (client.status !== 'wait') {\n continue;\n }\n\n PromiseUtility.voidExecution({ logger, scope, execution: client.connect() });\n }\n }\n}\n"]}
1
+ {"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../src/modules/redis/utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAI7D,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAEnC,MAAM,OAAO,YAAY;IACvB,+GAA+G;IAC/G,MAAM,CAAC,YAAY,CAAC,IAAkD;QACpE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,mBAAmB,EAAE,GAAG,IAAI,CAAC;QAEzD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC3C,IAAI,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;gBAC9B,OAAO,EAAE,CAAC;gBAEV,OAAO;YACT,CAAC;YAED,MAAM,OAAO,GAAG,MAAsB,CAAC;YAEvC,kLAAkL;YAClL,MAAM,QAAQ,GAAsB,EAAE,CAAC;YAEvC,MAAM,MAAM,GAAG,GAAG,EAAE;gBAClB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;oBAC/B,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,MAAM,EAAE,CAAC;gBACT,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE;gBAC/B,MAAM,EAAE,CAAC;gBACT,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC;YAEF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,MAAM,EAAE,CAAC;gBACT,MAAM,CACJ,QAAQ,CAAC;oBACP,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,mBAAmB;oBACrD,OAAO,EAAE,4CAA4C,SAAS,eAAe,MAAM,CAAC,MAAM,GAAG;iBAC9F,CAAC,CACH,CAAC;YACJ,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,QAAQ,CAAC,IAAI,CACX,GAAG,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,EACzB,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,EAC9C,GAAG,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,CAC/C,CAAC;YAEF,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,wJAAwJ;IACxJ,MAAM,CAAC,gBAAgB,CAAC,IAIvB;QACC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAExC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;gBAC7B,SAAS;YACX,CAAC;YAED,cAAc,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;CACF","sourcesContent":["import { HTTP } from '@/common';\nimport { getError } from '@/modules/error';\nimport type { ILogger } from '@/modules/logger';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { type EventEmitter } from 'node:events';\nimport type { TRedisClient } from './common';\n\nconst REDIS_READY_TIMEOUT = 30_000;\n\nexport class RedisUtility {\n /** Resolves once the client reaches `ready`; rejects on the first client error or when `timeoutMs` elapses. */\n static waitForReady(opts: { client: TRedisClient; timeoutMs?: number }): Promise<void> {\n const { client, timeoutMs = REDIS_READY_TIMEOUT } = opts;\n\n return new Promise<void>((resolve, reject) => {\n if (client.status === 'ready') {\n resolve();\n\n return;\n }\n\n const emitter = client as EventEmitter;\n\n /** Run by every terminal branch: clients are long-lived and re-`configure()`d, so an unbound listener leaks (EventEmitter warns) and could fire on an already-settled promise. */\n const cleanups: Array<() => void> = [];\n\n const detach = () => {\n for (const cleanup of cleanups) {\n cleanup();\n }\n };\n\n const onReady = () => {\n detach();\n resolve();\n };\n\n const onError = (error: Error) => {\n detach();\n reject(error);\n };\n\n const timer = setTimeout(() => {\n detach();\n reject(\n getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `Redis client did not become ready within ${timeoutMs}ms (status: ${client.status})`,\n }),\n );\n }, timeoutMs);\n\n cleanups.push(\n () => clearTimeout(timer),\n () => emitter.removeListener('ready', onReady),\n () => emitter.removeListener('error', onError),\n );\n\n emitter.once('ready', onReady);\n emitter.once('error', onError);\n });\n }\n\n /** Kicks off connection for clients still parked in `wait` - duplicated clients inherit `lazyConnect` from their parent and never dial on their own. */\n static ensureConnecting(opts: {\n clients: TRedisClient[];\n logger?: ILogger;\n scope: string;\n }): void {\n const { clients, logger, scope } = opts;\n\n for (const client of clients) {\n if (client.status !== 'wait') {\n continue;\n }\n\n PromiseUtility.voidExecution({ logger, scope, execution: client.connect() });\n }\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../src/modules/retry/helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ValueOrPromise } from '@/common';\nimport { getError } from '@/modules/error';\nimport type { ILogger } from '@/modules/logger';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { RetryBackoffStrategies, RetryJitterModes } from './common/constants';\nimport type { IRetryBackoffOptions, IRetryContext } from './common/types';\nimport { BaseHelper } from '@/modules/base';\n\ntype TRetryAttemptOutcome<T> =\n | { isResolved: true; value: T }\n | { isResolved: false; error: unknown; isRetryAllowed: boolean };\n\n/**\n * Static members call each other through the class name (`RetryHelper.xxx`), never `this` - a\n * detached static method loses its `this` binding.\n */\nexport class RetryHelper extends BaseHelper {\n private static readonly RETRY_TIMEOUT_MARKER = Symbol.for('@venizia/ignis-helpers:retry-timeout');\n\n /** True when `error` is a per-attempt timeout raised by `runWithTimeout`/`executeWithRetry`. */\n static isRetryTimeoutError(error: unknown): boolean {\n return typeof error === 'object' && error !== null && RetryHelper.RETRY_TIMEOUT_MARKER in error;\n }\n\n private static buildTimeoutError(opts: { operation: string; timeoutMs: number }) {\n const error = getError({\n message: `[runWithTimeout][${opts.operation}] Timed out after ${opts.timeoutMs}ms`,\n });\n Object.defineProperty(error, RetryHelper.RETRY_TIMEOUT_MARKER, { value: true });\n return error;\n }\n\n private static throwIfAborted(opts: { operation: string; signal?: AbortSignal }) {\n if (opts.signal?.aborted) {\n throw getError({\n message: `[executeWithRetry][${opts.operation}] Aborted | Reason: ${String(opts.signal.reason ?? 'unknown')}`,\n });\n }\n }\n\n /** `sleep` that wakes up early (and rejects) when `signal` aborts mid-wait. */\n private static async sleepWithSignal(opts: {\n ms: number;\n operation: string;\n signal?: AbortSignal;\n }) {\n const { ms, operation, signal } = opts;\n\n if (!signal) {\n await PromiseUtility.sleep({ ms });\n return;\n }\n\n RetryHelper.throwIfAborted({ operation, signal });\n\n // The listener is removed in `finally` rather than by the timer callback - the two would otherwise have to reference each other, and a leaked listener on a long-lived signal accumulates across retries.\n let removeAbortListener = () => {};\n\n try {\n await new Promise<void>((resolve, reject) => {\n const timer = setTimeout(resolve, ms);\n\n const onAbort = () => {\n clearTimeout(timer);\n reject(\n getError({\n message: `[executeWithRetry][${operation}] Aborted during backoff | Reason: ${String(signal.reason ?? 'unknown')}`,\n }),\n );\n };\n\n removeAbortListener = () => signal.removeEventListener('abort', onAbort);\n signal.addEventListener('abort', onAbort, { once: true });\n });\n } finally {\n removeAbortListener();\n }\n }\n\n /** Races `execution` against `timeoutMs` (`<= 0`/omitted = no timeout). The losing execution keeps running - JS promises cannot be cancelled - so pass `signal` through for cooperative cancellation. */\n static async runWithTimeout<T>(opts: {\n operation: string;\n timeoutMs?: number;\n execution: () => ValueOrPromise<T>;\n }): Promise<T> {\n const { operation, timeoutMs, execution } = opts;\n\n if (!timeoutMs || timeoutMs <= 0) {\n return execution();\n }\n\n let timer: ReturnType<typeof setTimeout> | undefined;\n const timeoutPromise = new Promise<never>((_resolve, reject) => {\n timer = setTimeout(() => {\n reject(RetryHelper.buildTimeoutError({ operation, timeoutMs }));\n }, timeoutMs);\n });\n\n try {\n const result = await Promise.race([Promise.resolve().then(execution), timeoutPromise]);\n return result;\n } finally {\n clearTimeout(timer);\n }\n }\n\n /** The pre-jitter delay for `attempt` (1-based, i.e. the delay AFTER attempt N failed). */\n static computeBackoffDelayMs(opts: { attempt: number; backoff?: IRetryBackoffOptions }): number {\n const { attempt } = opts;\n const {\n strategy = RetryBackoffStrategies.EXPONENTIAL,\n initialDelayMs = 250,\n multiplier = 2,\n maxDelayMs = 30_000,\n scheduleMs,\n jitter = RetryJitterModes.FULL,\n } = opts.backoff ?? {};\n\n let delayMs: number;\n switch (strategy) {\n case RetryBackoffStrategies.FIXED: {\n delayMs = initialDelayMs;\n break;\n }\n case RetryBackoffStrategies.LINEAR: {\n delayMs = initialDelayMs * attempt;\n break;\n }\n case RetryBackoffStrategies.EXPONENTIAL: {\n delayMs = initialDelayMs * Math.pow(multiplier, attempt - 1);\n break;\n }\n case RetryBackoffStrategies.SCHEDULE: {\n if (!scheduleMs?.length) {\n throw getError({\n message:\n '[computeBackoffDelayMs] strategy SCHEDULE requires a non-empty backoff.scheduleMs',\n });\n }\n delayMs = scheduleMs[Math.min(attempt - 1, scheduleMs.length - 1)];\n break;\n }\n default: {\n throw getError({\n message: `[computeBackoffDelayMs] Unknown backoff strategy '${strategy}' | Expected one of: ${[...RetryBackoffStrategies.SCHEME_SET].join(', ')}`,\n });\n }\n }\n\n delayMs = Math.min(delayMs, maxDelayMs);\n\n if (delayMs <= 0) {\n return 0;\n }\n\n switch (jitter) {\n case RetryJitterModes.NONE: {\n return delayMs;\n }\n case RetryJitterModes.FULL: {\n return Math.floor(Math.random() * delayMs);\n }\n case RetryJitterModes.EQUAL: {\n const half = delayMs / 2;\n return Math.floor(half + Math.random() * half);\n }\n default: {\n throw getError({\n message: `[computeBackoffDelayMs] Unknown jitter mode '${jitter}' | Expected one of: ${[...RetryJitterModes.SCHEME_SET].join(', ')}`,\n });\n }\n }\n }\n\n /** One `executeWithRetry` attempt and everything that follows a failure: `shouldRetry` refusing rethrows, otherwise the bounds are checked and - when another attempt is allowed - the retry is logged, `onRetry` awaited and the backoff slept, all before returning. */\n private static async runRetryAttempt<T>(opts: {\n attempt: number;\n attemptTimeoutMs?: number;\n startedAt: number;\n deadline?: number;\n maxAttempts: number;\n operation: string;\n signal?: AbortSignal;\n logger?: ILogger;\n backoff?: IRetryBackoffOptions;\n execution: (context: { attempt: number; signal?: AbortSignal }) => ValueOrPromise<T>;\n shouldRetry?: (context: IRetryContext) => boolean;\n onRetry?: (context: IRetryContext & { nextDelayMs: number }) => ValueOrPromise<void>;\n }): Promise<TRetryAttemptOutcome<T>> {\n const {\n attempt,\n attemptTimeoutMs,\n startedAt,\n deadline,\n maxAttempts,\n operation,\n signal,\n logger,\n backoff,\n execution,\n shouldRetry,\n onRetry,\n } = opts;\n\n try {\n const value = await RetryHelper.runWithTimeout({\n operation,\n timeoutMs: attemptTimeoutMs,\n execution: () => execution({ attempt, signal }),\n });\n return { isResolved: true, value };\n } catch (error) {\n const elapsedMs = Date.now() - startedAt;\n\n if (shouldRetry && !shouldRetry({ attempt, error, elapsedMs })) {\n throw error;\n }\n\n if (attempt >= maxAttempts) {\n return { isResolved: false, error, isRetryAllowed: false };\n }\n\n const nextDelayMs = RetryHelper.computeBackoffDelayMs({ attempt, backoff });\n if (deadline && Date.now() + nextDelayMs >= deadline) {\n return { isResolved: false, error, isRetryAllowed: false };\n }\n\n logger\n ?.for('executeWithRetry')\n .debug(\n '[%s] Attempt %d/%d failed - retrying in %dms | Error: %s',\n operation,\n attempt,\n maxAttempts,\n nextDelayMs,\n error,\n );\n\n await onRetry?.({ attempt, error, elapsedMs, nextDelayMs });\n\n if (nextDelayMs > 0) {\n await RetryHelper.sleepWithSignal({ ms: nextDelayMs, operation, signal });\n }\n\n return { isResolved: false, error, isRetryAllowed: true };\n }\n }\n\n /** Retries `execution` with backoff, bounded by `maxAttempts`/`maxTotalMs`. JS cannot cancel a running promise - `signal` only stops between attempts/sleeps, so a timed-out execution keeps running unless it honors the signal itself. */\n static async executeWithRetry<T>(opts: {\n signal?: AbortSignal;\n logger?: ILogger;\n operation: string;\n\n /** Default 3. */\n maxAttempts?: number;\n\n /** Total budget across attempts AND sleeps. Default: unlimited. */\n maxTotalMs?: number;\n\n /** Per-attempt race. Default: no per-attempt timeout. */\n perAttemptTimeoutMs?: number;\n\n backoff?: IRetryBackoffOptions;\n\n execution: (context: { attempt: number; signal?: AbortSignal }) => ValueOrPromise<T>;\n\n /** Return `false` to stop retrying and rethrow `context.error` immediately. */\n shouldRetry?: (context: IRetryContext) => boolean;\n\n /** Observability hook, awaited before the backoff sleep. */\n onRetry?: (context: IRetryContext & { nextDelayMs: number }) => ValueOrPromise<void>;\n }): Promise<T> {\n const {\n operation,\n execution,\n maxAttempts = 3,\n maxTotalMs,\n perAttemptTimeoutMs,\n backoff,\n shouldRetry,\n onRetry,\n signal,\n logger,\n } = opts;\n\n if (maxAttempts < 1) {\n throw getError({\n message: `[executeWithRetry][${operation}] maxAttempts must be >= 1 | Got: ${maxAttempts}`,\n });\n }\n\n const startedAt = Date.now();\n // `!== undefined`, never truthiness: a budget of 0 - or a negative one, which is what `deadline - Date.now()` yields under load - means NO time left, not unlimited time.\n const deadline = maxTotalMs !== undefined ? startedAt + maxTotalMs : undefined;\n let lastError: unknown;\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n RetryHelper.throwIfAborted({ operation, signal });\n\n const remainingMs = deadline ? deadline - Date.now() : undefined;\n if (remainingMs !== undefined && remainingMs <= 0) {\n break;\n }\n\n let attemptTimeoutMs = perAttemptTimeoutMs;\n if (remainingMs !== undefined) {\n attemptTimeoutMs = attemptTimeoutMs ? Math.min(attemptTimeoutMs, remainingMs) : remainingMs;\n }\n\n const outcome = await RetryHelper.runRetryAttempt({\n attempt,\n attemptTimeoutMs,\n startedAt,\n deadline,\n maxAttempts,\n operation,\n signal,\n logger,\n backoff,\n execution,\n shouldRetry,\n onRetry,\n });\n\n if (outcome.isResolved) {\n return outcome.value;\n }\n\n lastError = outcome.error;\n if (!outcome.isRetryAllowed) {\n break;\n }\n }\n\n const elapsedMs = Date.now() - startedAt;\n\n // The budget can run out BEFORE the first attempt (an expired `maxTotalMs`), leaving no error to rethrow; `throw undefined` would detonate inside the caller's own handler on `error.message`.\n if (lastError === undefined) {\n throw getError({\n message: `[executeWithRetry][${operation}] Time budget exhausted before any attempt ran | maxTotalMs: ${maxTotalMs}`,\n });\n }\n\n logger\n ?.for('executeWithRetry')\n .warn('[%s] Exhausted retries | Elapsed: %dms | Error: %s', operation, elapsedMs, lastError);\n\n throw lastError;\n }\n\n /** Retries `execution` while `until(result)` returns false - for read-after-write staleness behind a replicated pool. Never worse than a single un-retried call: on exhaustion the LAST result is returned rather than an error, and a thrown error propagates immediately instead of being retried. Only wrap idempotent operations. */\n static async executeWithRetryUntil<T>(opts: {\n signal?: AbortSignal;\n logger?: ILogger;\n operation: string;\n\n /** Default 3. */\n maxAttempts?: number;\n\n /** Bounds when a NEW attempt may start; it never interrupts an attempt already in flight, so the first execution always runs to completion - a budget of 0 just means \"no retries\". */\n maxTotalMs?: number;\n\n backoff?: IRetryBackoffOptions;\n\n execution: (context: { attempt: number; signal?: AbortSignal }) => ValueOrPromise<T>;\n\n /** Retry while this returns false. */\n until: (result: T) => boolean;\n }): Promise<T> {\n const {\n signal,\n logger,\n operation,\n maxAttempts = 3,\n maxTotalMs,\n backoff,\n execution,\n until,\n } = opts;\n\n if (maxAttempts < 1) {\n throw getError({\n message: `[executeWithRetryUntil][${operation}] maxAttempts must be >= 1 | Got: ${maxAttempts}`,\n });\n }\n\n // Surfaced before the first execution - a misconfigured backoff discovered mid-loop would discard an already-fetched result.\n RetryHelper.computeBackoffDelayMs({ attempt: 1, backoff });\n\n const startedAt = Date.now();\n let lastResult: T | undefined;\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n RetryHelper.throwIfAborted({ operation, signal });\n\n const result2 = await execution({ attempt, signal });\n lastResult = result2;\n if (until(lastResult)) {\n return lastResult;\n }\n\n const elapsedMs = Date.now() - startedAt;\n if (attempt >= maxAttempts || (maxTotalMs !== undefined && elapsedMs >= maxTotalMs)) {\n break;\n }\n\n logger\n ?.for('executeWithRetryUntil')\n .debug('[%s] until condition not met | Attempt: %d', operation, attempt);\n\n const nextDelayMs = RetryHelper.computeBackoffDelayMs({ attempt, backoff });\n if (nextDelayMs > 0) {\n await RetryHelper.sleepWithSignal({ ms: nextDelayMs, operation, signal });\n }\n }\n\n logger\n ?.for('executeWithRetryUntil')\n .warn('[%s] Exhausted retries - returning last (stale) result', operation);\n return lastResult as T;\n }\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../src/modules/retry/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE9E,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAM5C;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,UAAU;aACjB,yBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;IAElG,gGAAgG;IAChG,MAAM,CAAC,mBAAmB,CAAC,KAAc;QACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,WAAW,CAAC,oBAAoB,IAAI,KAAK,CAAC;IAClG,CAAC;IAEO,MAAM,CAAC,iBAAiB,CAAC,IAA8C;QAC7E,MAAM,KAAK,GAAG,QAAQ,CAAC;YACrB,OAAO,EAAE,oBAAoB,IAAI,CAAC,SAAS,qBAAqB,IAAI,CAAC,SAAS,IAAI;SACnF,CAAC,CAAC;QACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhF,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,MAAM,CAAC,cAAc,CAAC,IAAiD;QAC7E,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YACzB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,sBAAsB,IAAI,CAAC,SAAS,uBAAuB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE;aAC9G,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,+EAA+E;IACvE,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,IAIpC;QACC,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAEnC,OAAO;QACT,CAAC;QAED,WAAW,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAElD,0MAA0M;QAC1M,IAAI,mBAAmB,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QAEnC,IAAI,CAAC;YACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAEtC,MAAM,OAAO,GAAG,GAAG,EAAE;oBACnB,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,CACJ,QAAQ,CAAC;wBACP,OAAO,EAAE,sBAAsB,SAAS,sCAAsC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE;qBACnH,CAAC,CACH,CAAC;gBACJ,CAAC,CAAC;gBAEF,mBAAmB,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACzE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5D,CAAC,CAAC,CAAC;QACL,CAAC;gBAAS,CAAC;YACT,mBAAmB,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,yMAAyM;IACzM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAI,IAI9B;QACC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAEjD,IAAI,CAAC,SAAS,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;YACjC,OAAO,SAAS,EAAE,CAAC;QACrB,CAAC;QAED,IAAI,KAAgD,CAAC;QACrD,MAAM,cAAc,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;YAC7D,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBACtB,MAAM,CAAC,WAAW,CAAC,iBAAiB,CAAC,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;YAClE,CAAC,EAAE,SAAS,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;YAEvF,OAAO,MAAM,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,2FAA2F;IAC3F,MAAM,CAAC,qBAAqB,CAAC,IAAyD;QACpF,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACzB,MAAM,EACJ,QAAQ,GAAG,sBAAsB,CAAC,WAAW,EAC7C,cAAc,GAAG,GAAG,EACpB,UAAU,GAAG,CAAC,EACd,UAAU,GAAG,MAAM,EACnB,UAAU,EACV,MAAM,GAAG,gBAAgB,CAAC,IAAI,GAC/B,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;QAEvB,IAAI,OAAe,CAAC;QAEpB,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,sBAAsB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAClC,OAAO,GAAG,cAAc,CAAC;gBACzB,MAAM;YACR,CAAC;YACD,KAAK,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;gBACnC,OAAO,GAAG,cAAc,GAAG,OAAO,CAAC;gBACnC,MAAM;YACR,CAAC;YACD,KAAK,sBAAsB,CAAC,WAAW,CAAC,CAAC,CAAC;gBACxC,OAAO,GAAG,cAAc,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;gBAC7D,MAAM;YACR,CAAC;YACD,KAAK,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACrC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;oBACxB,MAAM,QAAQ,CAAC;wBACb,OAAO,EACL,mFAAmF;qBACtF,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;gBACnE,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE,qDAAqD,QAAQ,wBAAwB,CAAC,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAClJ,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAExC,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;YACjB,OAAO,CAAC,CAAC;QACX,CAAC;QAED,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC3B,OAAO,OAAO,CAAC;YACjB,CAAC;YACD,KAAK,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC;YAC7C,CAAC;YACD,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC5B,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,CAAC;gBAEzB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC;YACjD,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE,gDAAgD,MAAM,wBAAwB,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACrI,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,0QAA0Q;IAClQ,MAAM,CAAC,KAAK,CAAC,eAAe,CAAI,IAavC;QACC,MAAM,EACJ,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,WAAW,EACX,SAAS,EACT,MAAM,EACN,MAAM,EACN,OAAO,EACP,SAAS,EACT,WAAW,EACX,OAAO,GACR,GAAG,IAAI,CAAC;QAET,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,cAAc,CAAC;gBAC7C,SAAS;gBACT,SAAS,EAAE,gBAAgB;gBAC3B,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;aAChD,CAAC,CAAC;YAEH,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAEzC,IAAI,WAAW,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;gBAC/D,MAAM,KAAK,CAAC;YACd,CAAC;YAED,IAAI,OAAO,IAAI,WAAW,EAAE,CAAC;gBAC3B,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;YAC7D,CAAC;YAED,MAAM,WAAW,GAAG,WAAW,CAAC,qBAAqB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAE5E,IAAI,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,IAAI,QAAQ,EAAE,CAAC;gBACrD,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;YAC7D,CAAC;YAED,MAAM;gBACJ,EAAE,GAAG,CAAC,kBAAkB,CAAC;iBACxB,KAAK,CACJ,0DAA0D,EAC1D,SAAS,EACT,OAAO,EACP,WAAW,EACX,WAAW,EACX,KAAK,CACN,CAAC;YAEJ,MAAM,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;YAE5D,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,WAAW,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5E,CAAC;YAED,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,4OAA4O;IAC5O,MAAM,CAAC,KAAK,CAAC,gBAAgB,CAAI,IAuBhC;QACC,MAAM,EACJ,SAAS,EACT,SAAS,EACT,WAAW,GAAG,CAAC,EACf,UAAU,EACV,mBAAmB,EACnB,OAAO,EACP,WAAW,EACX,OAAO,EACP,MAAM,EACN,MAAM,GACP,GAAG,IAAI,CAAC;QAET,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,sBAAsB,SAAS,qCAAqC,WAAW,EAAE;aAC3F,CAAC,CAAC;QACL,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,0KAA0K;QAC1K,MAAM,QAAQ,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/E,IAAI,SAAkB,CAAC;QAEvB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,WAAW,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YAElD,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;YAEjE,IAAI,WAAW,KAAK,SAAS,IAAI,WAAW,IAAI,CAAC,EAAE,CAAC;gBAClD,MAAM;YACR,CAAC;YAED,IAAI,gBAAgB,GAAG,mBAAmB,CAAC;YAE3C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;YAC9F,CAAC;YAED,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,eAAe,CAAC;gBAChD,OAAO;gBACP,gBAAgB;gBAChB,SAAS;gBACT,QAAQ;gBACR,WAAW;gBACX,SAAS;gBACT,MAAM;gBACN,MAAM;gBACN,OAAO;gBACP,SAAS;gBACT,WAAW;gBACX,OAAO;aACR,CAAC,CAAC;YAEH,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;gBACvB,OAAO,OAAO,CAAC,KAAK,CAAC;YACvB,CAAC;YAED,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;YAE1B,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;gBAC5B,MAAM;YACR,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAEzC,+LAA+L;QAC/L,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,sBAAsB,SAAS,gEAAgE,UAAU,EAAE;aACrH,CAAC,CAAC;QACL,CAAC;QAED,MAAM;YACJ,EAAE,GAAG,CAAC,kBAAkB,CAAC;aACxB,IAAI,CAAC,oDAAoD,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAE/F,MAAM,SAAS,CAAC;IAClB,CAAC;IAED,yUAAyU;IACzU,MAAM,CAAC,KAAK,CAAC,qBAAqB,CAAI,IAiBrC;QACC,MAAM,EACJ,MAAM,EACN,MAAM,EACN,SAAS,EACT,WAAW,GAAG,CAAC,EACf,UAAU,EACV,OAAO,EACP,SAAS,EACT,KAAK,GACN,GAAG,IAAI,CAAC;QAET,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,2BAA2B,SAAS,qCAAqC,WAAW,EAAE;aAChG,CAAC,CAAC;QACL,CAAC;QAED,6HAA6H;QAC7H,WAAW,CAAC,qBAAqB,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAE3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,UAAyB,CAAC;QAE9B,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,WAAW,CAAC,cAAc,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YAElD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YACrD,UAAU,GAAG,OAAO,CAAC;YAErB,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;gBACtB,OAAO,UAAU,CAAC;YACpB,CAAC;YAED,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAEzC,IAAI,OAAO,IAAI,WAAW,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,SAAS,IAAI,UAAU,CAAC,EAAE,CAAC;gBACpF,MAAM;YACR,CAAC;YAED,MAAM;gBACJ,EAAE,GAAG,CAAC,uBAAuB,CAAC;iBAC7B,KAAK,CAAC,4CAA4C,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YAE3E,MAAM,WAAW,GAAG,WAAW,CAAC,qBAAqB,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAE5E,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,WAAW,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QAED,MAAM;YACJ,EAAE,GAAG,CAAC,uBAAuB,CAAC;aAC7B,IAAI,CAAC,wDAAwD,EAAE,SAAS,CAAC,CAAC;QAE7E,OAAO,UAAe,CAAC;IACzB,CAAC","sourcesContent":["import type { ValueOrPromise } from '@/common';\nimport { getError } from '@/modules/error';\nimport type { ILogger } from '@/modules/logger';\nimport { PromiseUtility } from '@/utilities/promise.utility';\nimport { RetryBackoffStrategies, RetryJitterModes } from './common/constants';\nimport type { IRetryBackoffOptions, IRetryContext } from './common/types';\nimport { BaseHelper } from '@/modules/base';\n\ntype TRetryAttemptOutcome<T> =\n | { isResolved: true; value: T }\n | { isResolved: false; error: unknown; isRetryAllowed: boolean };\n\n/**\n * Static members call each other through the class name (`RetryHelper.xxx`), never `this` - a\n * detached static method loses its `this` binding.\n */\nexport class RetryHelper extends BaseHelper {\n private static readonly RETRY_TIMEOUT_MARKER = Symbol.for('@venizia/ignis-helpers:retry-timeout');\n\n /** True when `error` is a per-attempt timeout raised by `runWithTimeout`/`executeWithRetry`. */\n static isRetryTimeoutError(error: unknown): boolean {\n return typeof error === 'object' && error !== null && RetryHelper.RETRY_TIMEOUT_MARKER in error;\n }\n\n private static buildTimeoutError(opts: { operation: string; timeoutMs: number }) {\n const error = getError({\n message: `[runWithTimeout][${opts.operation}] Timed out after ${opts.timeoutMs}ms`,\n });\n Object.defineProperty(error, RetryHelper.RETRY_TIMEOUT_MARKER, { value: true });\n\n return error;\n }\n\n private static throwIfAborted(opts: { operation: string; signal?: AbortSignal }) {\n if (opts.signal?.aborted) {\n throw getError({\n message: `[executeWithRetry][${opts.operation}] Aborted | Reason: ${String(opts.signal.reason ?? 'unknown')}`,\n });\n }\n }\n\n /** `sleep` that wakes up early (and rejects) when `signal` aborts mid-wait. */\n private static async sleepWithSignal(opts: {\n ms: number;\n operation: string;\n signal?: AbortSignal;\n }) {\n const { ms, operation, signal } = opts;\n\n if (!signal) {\n await PromiseUtility.sleep({ ms });\n\n return;\n }\n\n RetryHelper.throwIfAborted({ operation, signal });\n\n // The listener is removed in `finally` rather than by the timer callback - the two would otherwise have to reference each other, and a leaked listener on a long-lived signal accumulates across retries.\n let removeAbortListener = () => {};\n\n try {\n await new Promise<void>((resolve, reject) => {\n const timer = setTimeout(resolve, ms);\n\n const onAbort = () => {\n clearTimeout(timer);\n reject(\n getError({\n message: `[executeWithRetry][${operation}] Aborted during backoff | Reason: ${String(signal.reason ?? 'unknown')}`,\n }),\n );\n };\n\n removeAbortListener = () => signal.removeEventListener('abort', onAbort);\n signal.addEventListener('abort', onAbort, { once: true });\n });\n } finally {\n removeAbortListener();\n }\n }\n\n /** Races `execution` against `timeoutMs` (`<= 0`/omitted = no timeout). The losing execution keeps running - JS promises cannot be cancelled - so pass `signal` through for cooperative cancellation. */\n static async runWithTimeout<T>(opts: {\n operation: string;\n timeoutMs?: number;\n execution: () => ValueOrPromise<T>;\n }): Promise<T> {\n const { operation, timeoutMs, execution } = opts;\n\n if (!timeoutMs || timeoutMs <= 0) {\n return execution();\n }\n\n let timer: ReturnType<typeof setTimeout> | undefined;\n const timeoutPromise = new Promise<never>((_resolve, reject) => {\n timer = setTimeout(() => {\n reject(RetryHelper.buildTimeoutError({ operation, timeoutMs }));\n }, timeoutMs);\n });\n\n try {\n const result = await Promise.race([Promise.resolve().then(execution), timeoutPromise]);\n\n return result;\n } finally {\n clearTimeout(timer);\n }\n }\n\n /** The pre-jitter delay for `attempt` (1-based, i.e. the delay AFTER attempt N failed). */\n static computeBackoffDelayMs(opts: { attempt: number; backoff?: IRetryBackoffOptions }): number {\n const { attempt } = opts;\n const {\n strategy = RetryBackoffStrategies.EXPONENTIAL,\n initialDelayMs = 250,\n multiplier = 2,\n maxDelayMs = 30_000,\n scheduleMs,\n jitter = RetryJitterModes.FULL,\n } = opts.backoff ?? {};\n\n let delayMs: number;\n\n switch (strategy) {\n case RetryBackoffStrategies.FIXED: {\n delayMs = initialDelayMs;\n break;\n }\n case RetryBackoffStrategies.LINEAR: {\n delayMs = initialDelayMs * attempt;\n break;\n }\n case RetryBackoffStrategies.EXPONENTIAL: {\n delayMs = initialDelayMs * Math.pow(multiplier, attempt - 1);\n break;\n }\n case RetryBackoffStrategies.SCHEDULE: {\n if (!scheduleMs?.length) {\n throw getError({\n message:\n '[computeBackoffDelayMs] strategy SCHEDULE requires a non-empty backoff.scheduleMs',\n });\n }\n\n delayMs = scheduleMs[Math.min(attempt - 1, scheduleMs.length - 1)];\n break;\n }\n default: {\n throw getError({\n message: `[computeBackoffDelayMs] Unknown backoff strategy '${strategy}' | Expected one of: ${[...RetryBackoffStrategies.SCHEME_SET].join(', ')}`,\n });\n }\n }\n\n delayMs = Math.min(delayMs, maxDelayMs);\n\n if (delayMs <= 0) {\n return 0;\n }\n\n switch (jitter) {\n case RetryJitterModes.NONE: {\n return delayMs;\n }\n case RetryJitterModes.FULL: {\n return Math.floor(Math.random() * delayMs);\n }\n case RetryJitterModes.EQUAL: {\n const half = delayMs / 2;\n\n return Math.floor(half + Math.random() * half);\n }\n default: {\n throw getError({\n message: `[computeBackoffDelayMs] Unknown jitter mode '${jitter}' | Expected one of: ${[...RetryJitterModes.SCHEME_SET].join(', ')}`,\n });\n }\n }\n }\n\n /** One `executeWithRetry` attempt and everything that follows a failure: `shouldRetry` refusing rethrows, otherwise the bounds are checked and - when another attempt is allowed - the retry is logged, `onRetry` awaited and the backoff slept, all before returning. */\n private static async runRetryAttempt<T>(opts: {\n attempt: number;\n attemptTimeoutMs?: number;\n startedAt: number;\n deadline?: number;\n maxAttempts: number;\n operation: string;\n signal?: AbortSignal;\n logger?: ILogger;\n backoff?: IRetryBackoffOptions;\n execution: (context: { attempt: number; signal?: AbortSignal }) => ValueOrPromise<T>;\n shouldRetry?: (context: IRetryContext) => boolean;\n onRetry?: (context: IRetryContext & { nextDelayMs: number }) => ValueOrPromise<void>;\n }): Promise<TRetryAttemptOutcome<T>> {\n const {\n attempt,\n attemptTimeoutMs,\n startedAt,\n deadline,\n maxAttempts,\n operation,\n signal,\n logger,\n backoff,\n execution,\n shouldRetry,\n onRetry,\n } = opts;\n\n try {\n const value = await RetryHelper.runWithTimeout({\n operation,\n timeoutMs: attemptTimeoutMs,\n execution: () => execution({ attempt, signal }),\n });\n\n return { isResolved: true, value };\n } catch (error) {\n const elapsedMs = Date.now() - startedAt;\n\n if (shouldRetry && !shouldRetry({ attempt, error, elapsedMs })) {\n throw error;\n }\n\n if (attempt >= maxAttempts) {\n return { isResolved: false, error, isRetryAllowed: false };\n }\n\n const nextDelayMs = RetryHelper.computeBackoffDelayMs({ attempt, backoff });\n\n if (deadline && Date.now() + nextDelayMs >= deadline) {\n return { isResolved: false, error, isRetryAllowed: false };\n }\n\n logger\n ?.for('executeWithRetry')\n .debug(\n '[%s] Attempt %d/%d failed - retrying in %dms | Error: %s',\n operation,\n attempt,\n maxAttempts,\n nextDelayMs,\n error,\n );\n\n await onRetry?.({ attempt, error, elapsedMs, nextDelayMs });\n\n if (nextDelayMs > 0) {\n await RetryHelper.sleepWithSignal({ ms: nextDelayMs, operation, signal });\n }\n\n return { isResolved: false, error, isRetryAllowed: true };\n }\n }\n\n /** Retries `execution` with backoff, bounded by `maxAttempts`/`maxTotalMs`. JS cannot cancel a running promise - `signal` only stops between attempts/sleeps, so a timed-out execution keeps running unless it honors the signal itself. */\n static async executeWithRetry<T>(opts: {\n signal?: AbortSignal;\n logger?: ILogger;\n operation: string;\n\n /** Default 3. */\n maxAttempts?: number;\n\n /** Total budget across attempts AND sleeps. Default: unlimited. */\n maxTotalMs?: number;\n\n /** Per-attempt race. Default: no per-attempt timeout. */\n perAttemptTimeoutMs?: number;\n\n backoff?: IRetryBackoffOptions;\n\n execution: (context: { attempt: number; signal?: AbortSignal }) => ValueOrPromise<T>;\n\n /** Return `false` to stop retrying and rethrow `context.error` immediately. */\n shouldRetry?: (context: IRetryContext) => boolean;\n\n /** Observability hook, awaited before the backoff sleep. */\n onRetry?: (context: IRetryContext & { nextDelayMs: number }) => ValueOrPromise<void>;\n }): Promise<T> {\n const {\n operation,\n execution,\n maxAttempts = 3,\n maxTotalMs,\n perAttemptTimeoutMs,\n backoff,\n shouldRetry,\n onRetry,\n signal,\n logger,\n } = opts;\n\n if (maxAttempts < 1) {\n throw getError({\n message: `[executeWithRetry][${operation}] maxAttempts must be >= 1 | Got: ${maxAttempts}`,\n });\n }\n\n const startedAt = Date.now();\n // `!== undefined`, never truthiness: a budget of 0 - or a negative one, which is what `deadline - Date.now()` yields under load - means NO time left, not unlimited time.\n const deadline = maxTotalMs !== undefined ? startedAt + maxTotalMs : undefined;\n let lastError: unknown;\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n RetryHelper.throwIfAborted({ operation, signal });\n\n const remainingMs = deadline ? deadline - Date.now() : undefined;\n\n if (remainingMs !== undefined && remainingMs <= 0) {\n break;\n }\n\n let attemptTimeoutMs = perAttemptTimeoutMs;\n\n if (remainingMs !== undefined) {\n attemptTimeoutMs = attemptTimeoutMs ? Math.min(attemptTimeoutMs, remainingMs) : remainingMs;\n }\n\n const outcome = await RetryHelper.runRetryAttempt({\n attempt,\n attemptTimeoutMs,\n startedAt,\n deadline,\n maxAttempts,\n operation,\n signal,\n logger,\n backoff,\n execution,\n shouldRetry,\n onRetry,\n });\n\n if (outcome.isResolved) {\n return outcome.value;\n }\n\n lastError = outcome.error;\n\n if (!outcome.isRetryAllowed) {\n break;\n }\n }\n\n const elapsedMs = Date.now() - startedAt;\n\n // The budget can run out BEFORE the first attempt (an expired `maxTotalMs`), leaving no error to rethrow; `throw undefined` would detonate inside the caller's own handler on `error.message`.\n if (lastError === undefined) {\n throw getError({\n message: `[executeWithRetry][${operation}] Time budget exhausted before any attempt ran | maxTotalMs: ${maxTotalMs}`,\n });\n }\n\n logger\n ?.for('executeWithRetry')\n .warn('[%s] Exhausted retries | Elapsed: %dms | Error: %s', operation, elapsedMs, lastError);\n\n throw lastError;\n }\n\n /** Retries `execution` while `until(result)` returns false - for read-after-write staleness behind a replicated pool. Never worse than a single un-retried call: on exhaustion the LAST result is returned rather than an error, and a thrown error propagates immediately instead of being retried. Only wrap idempotent operations. */\n static async executeWithRetryUntil<T>(opts: {\n signal?: AbortSignal;\n logger?: ILogger;\n operation: string;\n\n /** Default 3. */\n maxAttempts?: number;\n\n /** Bounds when a NEW attempt may start; it never interrupts an attempt already in flight, so the first execution always runs to completion - a budget of 0 just means \"no retries\". */\n maxTotalMs?: number;\n\n backoff?: IRetryBackoffOptions;\n\n execution: (context: { attempt: number; signal?: AbortSignal }) => ValueOrPromise<T>;\n\n /** Retry while this returns false. */\n until: (result: T) => boolean;\n }): Promise<T> {\n const {\n signal,\n logger,\n operation,\n maxAttempts = 3,\n maxTotalMs,\n backoff,\n execution,\n until,\n } = opts;\n\n if (maxAttempts < 1) {\n throw getError({\n message: `[executeWithRetryUntil][${operation}] maxAttempts must be >= 1 | Got: ${maxAttempts}`,\n });\n }\n\n // Surfaced before the first execution - a misconfigured backoff discovered mid-loop would discard an already-fetched result.\n RetryHelper.computeBackoffDelayMs({ attempt: 1, backoff });\n\n const startedAt = Date.now();\n let lastResult: T | undefined;\n\n for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n RetryHelper.throwIfAborted({ operation, signal });\n\n const result2 = await execution({ attempt, signal });\n lastResult = result2;\n\n if (until(lastResult)) {\n return lastResult;\n }\n\n const elapsedMs = Date.now() - startedAt;\n\n if (attempt >= maxAttempts || (maxTotalMs !== undefined && elapsedMs >= maxTotalMs)) {\n break;\n }\n\n logger\n ?.for('executeWithRetryUntil')\n .debug('[%s] until condition not met | Attempt: %d', operation, attempt);\n\n const nextDelayMs = RetryHelper.computeBackoffDelayMs({ attempt, backoff });\n\n if (nextDelayMs > 0) {\n await RetryHelper.sleepWithSignal({ ms: nextDelayMs, operation, signal });\n }\n }\n\n logger\n ?.for('executeWithRetryUntil')\n .warn('[%s] Exhausted retries - returning last (stale) result', operation);\n\n return lastResult as T;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport type {\n IClock,\n IGetSecretOptions,\n ISecretLease,\n ISecretRotatable,\n ISecretRotationEvent,\n ISecretsHelper,\n ISecretsHelperOptions,\n ITimerAdapter,\n TSecretRotationHandler,\n TTimerHandle,\n} from '../common';\n\ninterface ICacheEntry {\n value: Record<string, string>;\n expiresAt: number;\n}\n\ninterface IRawFetchResult {\n value: Record<string, string>;\n lease?: { leaseId: string; ttlSeconds: number; renewable: boolean };\n}\n\nconst DEFAULT_CLOCK: IClock = { now: () => Date.now() };\nconst DEFAULT_TIMERS: ITimerAdapter = {\n set: (handler, ms) => setTimeout(handler, ms),\n clear: (handle) => clearTimeout(handle as AnyType),\n};\n\nconst DEFAULT_CACHE_TTL_SECONDS = 300;\nconst DEFAULT_RENEW_BEFORE_RATIO = 0.66;\n\n// setTimeout coerces any delay above this to 1ms, triggering an immediate renewal storm.\nconst TIMEOUT_MAX_MS = 2_147_483_647;\n// Floor so an invalid/tiny ttl never becomes a 0ms busy-loop.\nconst MIN_RENEW_DELAY_MS = 1_000;\n// Bounded exponential backoff for the renewal retry loop when Vault is unreachable.\nconst BACKOFF_BASE_MS = 1_000;\n// Capped at 31 to keep 2 ** (attempt - 1) inside double range: past ~1024 it overflows to Infinity and clampDelayMs's non-finite branch returns the FLOOR, collapsing a long backoff into a 1/sec retry storm.\nconst MAX_BACKOFF_ATTEMPT_EXPONENT = 31;\n\nexport abstract class AbstractSecretsHelper extends BaseHelper implements ISecretsHelper {\n protected readonly clock: IClock;\n protected readonly timers: ITimerAdapter;\n protected readonly cacheTtlSeconds: number;\n protected readonly renewBeforeRatio: number;\n\n private readonly cache = new Map<string, ICacheEntry>();\n private readonly leases = new Map<string, ISecretLease>();\n private readonly leasePaths = new Map<string, string>();\n private readonly timerHandles = new Map<string, TTimerHandle>();\n private readonly rotatables = new Map<string, ISecretRotatable[]>();\n private readonly rotateHandlers: TSecretRotationHandler[] = [];\n private readonly backoffAttempts = new Map<string, number>();\n private closed = false;\n\n constructor(opts: ISecretsHelperOptions) {\n super({ scope: opts.scope, identifier: opts.identifier });\n this.clock = opts.clock ?? DEFAULT_CLOCK;\n this.timers = opts.timers ?? DEFAULT_TIMERS;\n this.cacheTtlSeconds = opts.cacheTtlSeconds ?? DEFAULT_CACHE_TTL_SECONDS;\n\n const ratio = opts.renewBeforeRatio ?? DEFAULT_RENEW_BEFORE_RATIO;\n if (!Number.isFinite(ratio) || ratio <= 0 || ratio > 1) {\n throw getError({\n message: `[constructor] renewBeforeRatio must be within (0, 1] | received: ${ratio}`,\n });\n }\n this.renewBeforeRatio = ratio;\n }\n\n protected abstract fetchRaw(opts: { path: string }): Promise<IRawFetchResult>;\n protected abstract renewRaw(opts: {\n leaseId: string;\n ttlSeconds: number;\n }): Promise<{ ttlSeconds: number } | null>;\n protected abstract revokeRaw(opts: { leaseId: string }): Promise<void>;\n\n // Concrete providers override to authenticate; default is a no-op.\n async configure(): Promise<void> {\n return;\n }\n\n async getBundle(opts: { path: string }): Promise<Record<string, string>> {\n this.evictExpiredCache();\n const cached = this.cache.get(opts.path);\n if (cached && cached.expiresAt > this.clock.now()) {\n return cached.value;\n }\n const fresh = await this.fetchRaw({ path: opts.path });\n // A shutdown that ran while fetchRaw was in flight already cleared `cache` - honor that and hand back the fetched value uncached rather than resurrecting a map shutdown just emptied.\n if (this.closed) {\n return fresh.value;\n }\n this.writeCache({ path: opts.path, value: fresh.value });\n return fresh.value;\n }\n\n async get(opts: IGetSecretOptions<string>): Promise<string>;\n async get<TValue>(opts: IGetSecretOptions<TValue>): Promise<TValue>;\n async get<TValue = string>(opts: IGetSecretOptions<TValue>): Promise<TValue> {\n const bundle = await this.getBundle({ path: opts.path });\n const raw = opts.key\n ? Object.hasOwn(bundle, opts.key)\n ? bundle[opts.key]\n : undefined\n : (bundle as AnyType);\n return (raw ?? opts.defaultValue) as TValue;\n }\n\n async lease(opts: { path: string; key: string }): Promise<ISecretLease> {\n const fresh = await this.fetchRaw({ path: opts.path });\n // A shutdown that ran while fetchRaw was in flight already revoked/cleared every lease - committing this one now would resurrect leases/leasePaths with a lease no live provider will ever renew or revoke, so surface the shutdown instead of silently leaking it back in.\n if (this.closed) {\n throw getError({\n message: `[lease] Provider is shut down | path: ${opts.path} | key: ${opts.key}`,\n });\n }\n if (!fresh.lease) {\n throw getError({\n message: `[lease] Path returned no lease | path: ${opts.path} | key: ${opts.key}`,\n });\n }\n const lease: ISecretLease = { value: fresh.value, ...fresh.lease };\n this.leases.set(opts.key, lease);\n this.leasePaths.set(opts.key, opts.path);\n this.scheduleRenewal({ key: opts.key, lease });\n return lease;\n }\n\n onRotate(handler: TSecretRotationHandler): void {\n this.rotateHandlers.push(handler);\n }\n\n registerRotatable(opts: { key: string; target: ISecretRotatable }): void {\n const list = this.rotatables.get(opts.key) ?? [];\n list.push(opts.target);\n this.rotatables.set(opts.key, list);\n }\n\n async shutdown(): Promise<void> {\n const logger = this.logger.for(this.shutdown.name);\n this.closed = true;\n\n const timerHandlesValues = this.timerHandles.values();\n for (const handle of timerHandlesValues) {\n this.timers.clear(handle);\n }\n this.timerHandles.clear();\n this.backoffAttempts.clear();\n\n for (const [key, lease] of this.leases) {\n try {\n await this.revokeRaw({ leaseId: lease.leaseId });\n } catch (error) {\n logger.error(\n 'Revoke failed | key: %s | leaseId: %s | error: %s',\n key,\n lease.leaseId,\n error,\n );\n }\n }\n this.leases.clear();\n this.leasePaths.clear();\n this.cache.clear();\n }\n\n private writeCache(opts: { path: string; value: Record<string, string> }): void {\n this.cache.set(opts.path, {\n value: opts.value,\n expiresAt: this.clock.now() + this.cacheTtlSeconds * 1000,\n });\n }\n\n private evictExpiredCache(): void {\n const now = this.clock.now();\n for (const [path, entry] of this.cache) {\n if (entry.expiresAt <= now) {\n this.cache.delete(path);\n }\n }\n }\n\n private clampDelayMs(opts: { delayMs: number }): number {\n if (!Number.isFinite(opts.delayMs) || opts.delayMs <= 0) {\n return MIN_RENEW_DELAY_MS;\n }\n return Math.min(Math.max(opts.delayMs, MIN_RENEW_DELAY_MS), TIMEOUT_MAX_MS);\n }\n\n private armTimer(opts: { key: string; delayMs: number }): void {\n const existing = this.timerHandles.get(opts.key);\n if (existing) {\n this.timers.clear(existing);\n }\n const handle = this.timers.set(() => {\n this.handleRenewal({ key: opts.key }).catch((error) => {\n this.logger\n .for(this.armTimer.name)\n .error('Renewal handler crashed | key: %s | error: %s', opts.key, error);\n });\n }, opts.delayMs);\n this.timerHandles.set(opts.key, handle);\n }\n\n private scheduleRenewal(opts: { key: string; lease: ISecretLease }): void {\n if (this.closed) {\n return;\n }\n this.backoffAttempts.delete(opts.key);\n const delayMs = this.clampDelayMs({\n delayMs: opts.lease.ttlSeconds * this.renewBeforeRatio * 1000,\n });\n this.armTimer({ key: opts.key, delayMs });\n }\n\n // A transient Vault failure must not kill the loop; retry with bounded exponential backoff.\n private scheduleBackoffRetry(opts: { key: string }): void {\n if (this.closed) {\n return;\n }\n const attempt = (this.backoffAttempts.get(opts.key) ?? 0) + 1;\n this.backoffAttempts.set(opts.key, attempt);\n const cappedAttempt = Math.min(attempt, MAX_BACKOFF_ATTEMPT_EXPONENT);\n const delayMs = this.clampDelayMs({ delayMs: BACKOFF_BASE_MS * 2 ** (cappedAttempt - 1) });\n this.armTimer({ key: opts.key, delayMs });\n }\n\n private async handleRenewal(opts: { key: string }): Promise<void> {\n if (this.closed) {\n return;\n }\n const logger = this.logger.for(this.handleRenewal.name);\n const lease = this.leases.get(opts.key);\n if (!lease) {\n logger.debug('No lease to renew | key: %s', opts.key);\n return;\n }\n try {\n if (!lease.renewable) {\n await this.rotate({ key: opts.key });\n return;\n }\n\n const renewed = await this.renewRaw({\n leaseId: lease.leaseId,\n ttlSeconds: lease.ttlSeconds,\n });\n if (this.closed) {\n return;\n }\n\n if (!renewed) {\n await this.rotate({ key: opts.key });\n return;\n }\n\n const next: ISecretLease = { ...lease, ttlSeconds: renewed.ttlSeconds };\n this.leases.set(opts.key, next);\n this.scheduleRenewal({ key: opts.key, lease: next });\n } catch (error) {\n if (this.closed) {\n return;\n }\n logger.error(\n 'Renewal cycle failed; scheduling backoff retry | key: %s | error: %s',\n opts.key,\n error,\n );\n this.scheduleBackoffRetry({ key: opts.key });\n }\n }\n\n private async rotate(opts: { key: string }): Promise<void> {\n const path = this.leasePaths.get(opts.key);\n if (!path) {\n throw getError({ message: `[rotate] No lease path registered | key: ${opts.key}` });\n }\n const fresh = await this.fetchRaw({ path });\n if (this.closed) {\n return;\n }\n if (!fresh.lease) {\n throw getError({ message: `[rotate] Path returned no lease on rotation | key: ${opts.key}` });\n }\n const lease: ISecretLease = { value: fresh.value, ...fresh.lease };\n this.leases.set(opts.key, lease);\n this.writeCache({ path, value: fresh.value });\n // Arm the next renewal BEFORE dispatching: a wedged consumer must not stall the loop.\n this.scheduleRenewal({ key: opts.key, lease });\n await this.dispatchRotation({ key: opts.key, lease });\n }\n\n private async dispatchRotation(event: ISecretRotationEvent): Promise<void> {\n const logger = this.logger.for(this.dispatchRotation.name);\n for (const handler of this.rotateHandlers) {\n try {\n await handler(event);\n } catch (error) {\n logger.error('onRotate handler failed | key: %s | error: %s', event.key, error);\n }\n }\n const targets = this.rotatables.get(event.key) ?? [];\n for (const target of targets) {\n try {\n await target.onSecretRotated({ key: event.key, secret: event.lease.value });\n } catch (error) {\n logger.error('Rotatable failed | key: %s | error: %s', event.key, error);\n }\n }\n }\n}\n"]}
1
+ {"version":3,"file":"abstract.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/base/abstract.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { BaseHelper } from '@/modules/base';\nimport { getError } from '@/modules/error';\nimport type {\n IClock,\n IGetSecretOptions,\n ISecretLease,\n ISecretRotatable,\n ISecretRotationEvent,\n ISecretsHelper,\n ISecretsHelperOptions,\n ITimerAdapter,\n TSecretRotationHandler,\n TTimerHandle,\n} from '../common';\n\ninterface ICacheEntry {\n value: Record<string, string>;\n expiresAt: number;\n}\n\ninterface IRawFetchResult {\n value: Record<string, string>;\n lease?: { leaseId: string; ttlSeconds: number; renewable: boolean };\n}\n\nconst DEFAULT_CLOCK: IClock = { now: () => Date.now() };\nconst DEFAULT_TIMERS: ITimerAdapter = {\n set: (handler, ms) => setTimeout(handler, ms),\n clear: (handle) => clearTimeout(handle as AnyType),\n};\n\nconst DEFAULT_CACHE_TTL_SECONDS = 300;\nconst DEFAULT_RENEW_BEFORE_RATIO = 0.66;\n\n// setTimeout coerces any delay above this to 1ms, triggering an immediate renewal storm.\nconst TIMEOUT_MAX_MS = 2_147_483_647;\n// Floor so an invalid/tiny ttl never becomes a 0ms busy-loop.\nconst MIN_RENEW_DELAY_MS = 1_000;\n// Bounded exponential backoff for the renewal retry loop when Vault is unreachable.\nconst BACKOFF_BASE_MS = 1_000;\n// Capped at 31 to keep 2 ** (attempt - 1) inside double range: past ~1024 it overflows to Infinity and clampDelayMs's non-finite branch returns the FLOOR, collapsing a long backoff into a 1/sec retry storm.\nconst MAX_BACKOFF_ATTEMPT_EXPONENT = 31;\n\nexport abstract class AbstractSecretsHelper extends BaseHelper implements ISecretsHelper {\n protected readonly clock: IClock;\n protected readonly timers: ITimerAdapter;\n protected readonly cacheTtlSeconds: number;\n protected readonly renewBeforeRatio: number;\n\n private readonly cache = new Map<string, ICacheEntry>();\n private readonly leases = new Map<string, ISecretLease>();\n private readonly leasePaths = new Map<string, string>();\n private readonly timerHandles = new Map<string, TTimerHandle>();\n private readonly rotatables = new Map<string, ISecretRotatable[]>();\n private readonly rotateHandlers: TSecretRotationHandler[] = [];\n private readonly backoffAttempts = new Map<string, number>();\n private closed = false;\n\n constructor(opts: ISecretsHelperOptions) {\n super({ scope: opts.scope, identifier: opts.identifier });\n this.clock = opts.clock ?? DEFAULT_CLOCK;\n this.timers = opts.timers ?? DEFAULT_TIMERS;\n this.cacheTtlSeconds = opts.cacheTtlSeconds ?? DEFAULT_CACHE_TTL_SECONDS;\n\n const ratio = opts.renewBeforeRatio ?? DEFAULT_RENEW_BEFORE_RATIO;\n\n if (!Number.isFinite(ratio) || ratio <= 0 || ratio > 1) {\n throw getError({\n message: `[constructor] renewBeforeRatio must be within (0, 1] | received: ${ratio}`,\n });\n }\n\n this.renewBeforeRatio = ratio;\n }\n\n protected abstract fetchRaw(opts: { path: string }): Promise<IRawFetchResult>;\n protected abstract renewRaw(opts: {\n leaseId: string;\n ttlSeconds: number;\n }): Promise<{ ttlSeconds: number } | null>;\n protected abstract revokeRaw(opts: { leaseId: string }): Promise<void>;\n\n // Concrete providers override to authenticate; default is a no-op.\n async configure(): Promise<void> {\n return;\n }\n\n async getBundle(opts: { path: string }): Promise<Record<string, string>> {\n this.evictExpiredCache();\n const cached = this.cache.get(opts.path);\n\n if (cached && cached.expiresAt > this.clock.now()) {\n return cached.value;\n }\n\n const fresh = await this.fetchRaw({ path: opts.path });\n\n // A shutdown that ran while fetchRaw was in flight already cleared `cache` - honor that and hand back the fetched value uncached rather than resurrecting a map shutdown just emptied.\n if (this.closed) {\n return fresh.value;\n }\n\n this.writeCache({ path: opts.path, value: fresh.value });\n\n return fresh.value;\n }\n\n async get(opts: IGetSecretOptions<string>): Promise<string>;\n async get<TValue>(opts: IGetSecretOptions<TValue>): Promise<TValue>;\n async get<TValue = string>(opts: IGetSecretOptions<TValue>): Promise<TValue> {\n const bundle = await this.getBundle({ path: opts.path });\n const raw = opts.key\n ? Object.hasOwn(bundle, opts.key)\n ? bundle[opts.key]\n : undefined\n : (bundle as AnyType);\n\n return (raw ?? opts.defaultValue) as TValue;\n }\n\n async lease(opts: { path: string; key: string }): Promise<ISecretLease> {\n const fresh = await this.fetchRaw({ path: opts.path });\n\n // A shutdown that ran while fetchRaw was in flight already revoked/cleared every lease - committing this one now would resurrect leases/leasePaths with a lease no live provider will ever renew or revoke, so surface the shutdown instead of silently leaking it back in.\n if (this.closed) {\n throw getError({\n message: `[lease] Provider is shut down | path: ${opts.path} | key: ${opts.key}`,\n });\n }\n\n if (!fresh.lease) {\n throw getError({\n message: `[lease] Path returned no lease | path: ${opts.path} | key: ${opts.key}`,\n });\n }\n\n const lease: ISecretLease = { value: fresh.value, ...fresh.lease };\n this.leases.set(opts.key, lease);\n this.leasePaths.set(opts.key, opts.path);\n this.scheduleRenewal({ key: opts.key, lease });\n\n return lease;\n }\n\n onRotate(handler: TSecretRotationHandler): void {\n this.rotateHandlers.push(handler);\n }\n\n registerRotatable(opts: { key: string; target: ISecretRotatable }): void {\n const list = this.rotatables.get(opts.key) ?? [];\n list.push(opts.target);\n this.rotatables.set(opts.key, list);\n }\n\n async shutdown(): Promise<void> {\n const logger = this.logger.for(this.shutdown.name);\n this.closed = true;\n\n const timerHandlesValues = this.timerHandles.values();\n\n for (const handle of timerHandlesValues) {\n this.timers.clear(handle);\n }\n\n this.timerHandles.clear();\n this.backoffAttempts.clear();\n\n for (const [key, lease] of this.leases) {\n try {\n await this.revokeRaw({ leaseId: lease.leaseId });\n } catch (error) {\n logger.error(\n 'Revoke failed | key: %s | leaseId: %s | error: %s',\n key,\n lease.leaseId,\n error,\n );\n }\n }\n\n this.leases.clear();\n this.leasePaths.clear();\n this.cache.clear();\n }\n\n private writeCache(opts: { path: string; value: Record<string, string> }): void {\n this.cache.set(opts.path, {\n value: opts.value,\n expiresAt: this.clock.now() + this.cacheTtlSeconds * 1000,\n });\n }\n\n private evictExpiredCache(): void {\n const now = this.clock.now();\n\n for (const [path, entry] of this.cache) {\n if (entry.expiresAt <= now) {\n this.cache.delete(path);\n }\n }\n }\n\n private clampDelayMs(opts: { delayMs: number }): number {\n if (!Number.isFinite(opts.delayMs) || opts.delayMs <= 0) {\n return MIN_RENEW_DELAY_MS;\n }\n\n return Math.min(Math.max(opts.delayMs, MIN_RENEW_DELAY_MS), TIMEOUT_MAX_MS);\n }\n\n private armTimer(opts: { key: string; delayMs: number }): void {\n const existing = this.timerHandles.get(opts.key);\n\n if (existing) {\n this.timers.clear(existing);\n }\n\n const handle = this.timers.set(() => {\n this.handleRenewal({ key: opts.key }).catch((error) => {\n this.logger\n .for(this.armTimer.name)\n .error('Renewal handler crashed | key: %s | error: %s', opts.key, error);\n });\n }, opts.delayMs);\n this.timerHandles.set(opts.key, handle);\n }\n\n private scheduleRenewal(opts: { key: string; lease: ISecretLease }): void {\n if (this.closed) {\n return;\n }\n\n this.backoffAttempts.delete(opts.key);\n const delayMs = this.clampDelayMs({\n delayMs: opts.lease.ttlSeconds * this.renewBeforeRatio * 1000,\n });\n this.armTimer({ key: opts.key, delayMs });\n }\n\n // A transient Vault failure must not kill the loop; retry with bounded exponential backoff.\n private scheduleBackoffRetry(opts: { key: string }): void {\n if (this.closed) {\n return;\n }\n\n const attempt = (this.backoffAttempts.get(opts.key) ?? 0) + 1;\n this.backoffAttempts.set(opts.key, attempt);\n const cappedAttempt = Math.min(attempt, MAX_BACKOFF_ATTEMPT_EXPONENT);\n const delayMs = this.clampDelayMs({ delayMs: BACKOFF_BASE_MS * 2 ** (cappedAttempt - 1) });\n this.armTimer({ key: opts.key, delayMs });\n }\n\n private async handleRenewal(opts: { key: string }): Promise<void> {\n if (this.closed) {\n return;\n }\n\n const logger = this.logger.for(this.handleRenewal.name);\n const lease = this.leases.get(opts.key);\n\n if (!lease) {\n logger.debug('No lease to renew | key: %s', opts.key);\n\n return;\n }\n\n try {\n if (!lease.renewable) {\n await this.rotate({ key: opts.key });\n\n return;\n }\n\n const renewed = await this.renewRaw({\n leaseId: lease.leaseId,\n ttlSeconds: lease.ttlSeconds,\n });\n\n if (this.closed) {\n return;\n }\n\n if (!renewed) {\n await this.rotate({ key: opts.key });\n\n return;\n }\n\n const next: ISecretLease = { ...lease, ttlSeconds: renewed.ttlSeconds };\n this.leases.set(opts.key, next);\n this.scheduleRenewal({ key: opts.key, lease: next });\n } catch (error) {\n if (this.closed) {\n return;\n }\n\n logger.error(\n 'Renewal cycle failed; scheduling backoff retry | key: %s | error: %s',\n opts.key,\n error,\n );\n this.scheduleBackoffRetry({ key: opts.key });\n }\n }\n\n private async rotate(opts: { key: string }): Promise<void> {\n const path = this.leasePaths.get(opts.key);\n\n if (!path) {\n throw getError({ message: `[rotate] No lease path registered | key: ${opts.key}` });\n }\n\n const fresh = await this.fetchRaw({ path });\n\n if (this.closed) {\n return;\n }\n\n if (!fresh.lease) {\n throw getError({ message: `[rotate] Path returned no lease on rotation | key: ${opts.key}` });\n }\n\n const lease: ISecretLease = { value: fresh.value, ...fresh.lease };\n this.leases.set(opts.key, lease);\n this.writeCache({ path, value: fresh.value });\n // Arm the next renewal BEFORE dispatching: a wedged consumer must not stall the loop.\n this.scheduleRenewal({ key: opts.key, lease });\n await this.dispatchRotation({ key: opts.key, lease });\n }\n\n private async dispatchRotation(event: ISecretRotationEvent): Promise<void> {\n const logger = this.logger.for(this.dispatchRotation.name);\n\n for (const handler of this.rotateHandlers) {\n try {\n await handler(event);\n } catch (error) {\n logger.error('onRotate handler failed | key: %s | error: %s', event.key, error);\n }\n }\n\n const targets = this.rotatables.get(event.key) ?? [];\n\n for (const target of targets) {\n try {\n await target.onSecretRotated({ key: event.key, secret: event.lease.value });\n } catch (error) {\n logger.error('Rotatable failed | key: %s | error: %s', event.key, error);\n }\n }\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"dotenv.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/dotenv/dotenv.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAchD,MAAM,OAAO,iBAAkB,SAAQ,qBAAqB;IAK1D,YAAY,IAA+B;QACzC,KAAK,CAAC;YACJ,KAAK,EAAE,iBAAiB,CAAC,IAAI;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;IAES,KAAK,CAAC,QAAQ;QACtB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAClF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAA2B,CAAC;QAChE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;IAES,KAAK,CAAC,QAAQ;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,OAAO;IACT,CAAC;IAEQ,KAAK,CAAC,KAAK,CAAC,KAAoC;QACvD,MAAM,QAAQ,CAAC;YACb,OAAO,EACL,yFAAyF;SAC5F,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { AbstractSecretsHelper } from '../base';\nimport type { IClock, ISecretLease, ITimerAdapter } from '../common';\n\nexport interface IDotenvVaultHelperOptions {\n path?: string;\n dotenvKey?: string;\n identifier?: string;\n cacheTtlSeconds?: number;\n clock?: IClock;\n timers?: ITimerAdapter;\n /** Injection seam for tests; production decrypts via @dotenvx/dotenvx. */\n decode?: (opts: { path: string; dotenvKey?: string }) => Record<string, string>;\n}\n\nexport class DotenvVaultHelper extends AbstractSecretsHelper {\n private readonly path: string;\n private readonly dotenvKey?: string;\n private readonly decode?: IDotenvVaultHelperOptions['decode'];\n\n constructor(opts: IDotenvVaultHelperOptions) {\n super({\n scope: DotenvVaultHelper.name,\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n clock: opts.clock,\n timers: opts.timers,\n });\n this.path = opts.path ?? '.env.vault';\n this.dotenvKey = opts.dotenvKey;\n this.decode = opts.decode;\n }\n\n protected async fetchRaw() {\n if (this.decode) {\n return { value: this.decode({ path: this.path, dotenvKey: this.dotenvKey }) };\n }\n const dotenvx = await ModuleUtility.load<AnyType>({ module: '@dotenvx/dotenvx' });\n const result = dotenvx.config({\n path: this.path,\n ...(this.dotenvKey ? { DOTENV_KEY: this.dotenvKey } : {}),\n overload: true,\n });\n const parsed = (result?.parsed ?? {}) as Record<string, string>;\n return { value: parsed };\n }\n\n protected async renewRaw() {\n return null;\n }\n\n protected async revokeRaw() {\n return;\n }\n\n override async lease(_opts: { path: string; key: string }): Promise<ISecretLease> {\n throw getError({\n message:\n '[DotenvVaultHelper.lease] Dynamic leases are not supported by the dotenv-vault provider',\n });\n }\n}\n"]}
1
+ {"version":3,"file":"dotenv.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/dotenv/dotenv.helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAchD,MAAM,OAAO,iBAAkB,SAAQ,qBAAqB;IAK1D,YAAY,IAA+B;QACzC,KAAK,CAAC;YACJ,KAAK,EAAE,iBAAiB,CAAC,IAAI;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,YAAY,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;IAES,KAAK,CAAC,QAAQ;QACtB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,IAAI,CAAU,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAClF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAC5B,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzD,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAA2B,CAAC;QAEhE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3B,CAAC;IAES,KAAK,CAAC,QAAQ;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,OAAO;IACT,CAAC;IAEQ,KAAK,CAAC,KAAK,CAAC,KAAoC;QACvD,MAAM,QAAQ,CAAC;YACb,OAAO,EACL,yFAAyF;SAC5F,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { AbstractSecretsHelper } from '../base';\nimport type { IClock, ISecretLease, ITimerAdapter } from '../common';\n\nexport interface IDotenvVaultHelperOptions {\n path?: string;\n dotenvKey?: string;\n identifier?: string;\n cacheTtlSeconds?: number;\n clock?: IClock;\n timers?: ITimerAdapter;\n /** Injection seam for tests; production decrypts via @dotenvx/dotenvx. */\n decode?: (opts: { path: string; dotenvKey?: string }) => Record<string, string>;\n}\n\nexport class DotenvVaultHelper extends AbstractSecretsHelper {\n private readonly path: string;\n private readonly dotenvKey?: string;\n private readonly decode?: IDotenvVaultHelperOptions['decode'];\n\n constructor(opts: IDotenvVaultHelperOptions) {\n super({\n scope: DotenvVaultHelper.name,\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n clock: opts.clock,\n timers: opts.timers,\n });\n this.path = opts.path ?? '.env.vault';\n this.dotenvKey = opts.dotenvKey;\n this.decode = opts.decode;\n }\n\n protected async fetchRaw() {\n if (this.decode) {\n return { value: this.decode({ path: this.path, dotenvKey: this.dotenvKey }) };\n }\n\n const dotenvx = await ModuleUtility.load<AnyType>({ module: '@dotenvx/dotenvx' });\n const result = dotenvx.config({\n path: this.path,\n ...(this.dotenvKey ? { DOTENV_KEY: this.dotenvKey } : {}),\n overload: true,\n });\n const parsed = (result?.parsed ?? {}) as Record<string, string>;\n\n return { value: parsed };\n }\n\n protected async renewRaw() {\n return null;\n }\n\n protected async revokeRaw() {\n return;\n }\n\n override async lease(_opts: { path: string; key: string }): Promise<ISecretLease> {\n throw getError({\n message:\n '[DotenvVaultHelper.lease] Dynamic leases are not supported by the dotenv-vault provider',\n });\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/secrets/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAkD,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,0RAA0R;AAC1R,qNAAqN;AACrN,MAAM,OAAO,oBAAoB;IAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,IAAoD;QAEpD,MAAM,MAAM,GAAG;YACb,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAiB,CAAC;QAEtC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,KAAK,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;gBACjC,OAAO,IAAI,gBAAgB,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,KAAK,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC;gBACrC,wHAAwH;gBACxH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBACpB,aAAa,CAAC,eAAe,CAAC;wBAC5B,KAAK,EAAE,sBAAsB;wBAC7B,OAAO,EAAE,CAAC,YAAY,CAAC;wBACvB,eAAe,EAAE,IAAI;qBACtB,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,IAAI,oBAAoB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,KAAK,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;gBAClC,sEAAsE;gBACtE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBACpB,aAAa,CAAC,eAAe,CAAC;wBAC5B,KAAK,EAAE,mBAAmB;wBAC1B,OAAO,EAAE,CAAC,kBAAkB,CAAC;wBAC7B,eAAe,EAAE,IAAI;qBACtB,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE,sDAAsD,IAAI,CAAC,QAAQ,EAAE;iBAC/E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { SecretProviders, type ISecretsHelper, type ISecretsRegistration } from './common';\nimport { DotenvVaultHelper } from './dotenv';\nimport { HashiCorpVaultHelper } from './hashicorp';\nimport { SystemEnvsHelper } from './system-envs';\n\n// node-vault / @dotenvx/dotenvx are optional peers reached only via `ModuleUtility.load`: never eagerly loaded, invisible to bundlers. Compiled apps that use a provider must ship the peer in node_modules, inject the client via options, or register it with `ModuleUtility.register`.\n// The providers are imported statically on purpose: a dynamic `import('./x')` of our own module makes bun wrap every module it reaches in a lazy initializer, and the root barrel then exports `undefined` for them.\nexport class SecretsHelperFactory {\n static async create(\n opts: ISecretsRegistration & { identifier?: string },\n ): Promise<ISecretsHelper> {\n const shared = {\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n renewBeforeRatio: opts.renewBeforeRatio,\n };\n\n const config = opts.config as AnyType;\n\n switch (opts.provider) {\n case SecretProviders.SYSTEM_ENVS: {\n return new SystemEnvsHelper({ identifier: opts.identifier });\n }\n case SecretProviders.HASHICORP_VAULT: {\n // `client` is the injected escape: the helper never reaches for the peer, so demanding it here would defeat the escape.\n if (!config?.client) {\n ModuleUtility.assertInstalled({\n scope: 'HashiCorpVaultHelper',\n modules: ['node-vault'],\n allowRegistered: true,\n });\n }\n return new HashiCorpVaultHelper({ ...config, ...shared });\n }\n case SecretProviders.DOTENV_VAULT: {\n // `decode` is the injected escape - same reasoning as `client` above.\n if (!config?.decode) {\n ModuleUtility.assertInstalled({\n scope: 'DotenvVaultHelper',\n modules: ['@dotenvx/dotenvx'],\n allowRegistered: true,\n });\n }\n return new DotenvVaultHelper({ ...config, ...shared });\n }\n default: {\n throw getError({\n message: `[createSecretsHelper] Unsupported secret provider: ${opts.provider}`,\n });\n }\n }\n }\n}\n"]}
1
+ {"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/modules/secrets/factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAkD,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,0RAA0R;AAC1R,qNAAqN;AACrN,MAAM,OAAO,oBAAoB;IAC/B,MAAM,CAAC,KAAK,CAAC,MAAM,CACjB,IAAoD;QAEpD,MAAM,MAAM,GAAG;YACb,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;SACxC,CAAC;QAEF,MAAM,MAAM,GAAG,IAAI,CAAC,MAAiB,CAAC;QAEtC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;YACtB,KAAK,eAAe,CAAC,WAAW,CAAC,CAAC,CAAC;gBACjC,OAAO,IAAI,gBAAgB,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,KAAK,eAAe,CAAC,eAAe,CAAC,CAAC,CAAC;gBACrC,wHAAwH;gBACxH,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBACpB,aAAa,CAAC,eAAe,CAAC;wBAC5B,KAAK,EAAE,sBAAsB;wBAC7B,OAAO,EAAE,CAAC,YAAY,CAAC;wBACvB,eAAe,EAAE,IAAI;qBACtB,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,IAAI,oBAAoB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YAC5D,CAAC;YACD,KAAK,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;gBAClC,sEAAsE;gBACtE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;oBACpB,aAAa,CAAC,eAAe,CAAC;wBAC5B,KAAK,EAAE,mBAAmB;wBAC1B,OAAO,EAAE,CAAC,kBAAkB,CAAC;wBAC7B,eAAe,EAAE,IAAI;qBACtB,CAAC,CAAC;gBACL,CAAC;gBAED,OAAO,IAAI,iBAAiB,CAAC,EAAE,GAAG,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;YACzD,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,QAAQ,CAAC;oBACb,OAAO,EAAE,sDAAsD,IAAI,CAAC,QAAQ,EAAE;iBAC/E,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import type { AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { SecretProviders, type ISecretsHelper, type ISecretsRegistration } from './common';\nimport { DotenvVaultHelper } from './dotenv';\nimport { HashiCorpVaultHelper } from './hashicorp';\nimport { SystemEnvsHelper } from './system-envs';\n\n// node-vault / @dotenvx/dotenvx are optional peers reached only via `ModuleUtility.load`: never eagerly loaded, invisible to bundlers. Compiled apps that use a provider must ship the peer in node_modules, inject the client via options, or register it with `ModuleUtility.register`.\n// The providers are imported statically on purpose: a dynamic `import('./x')` of our own module makes bun wrap every module it reaches in a lazy initializer, and the root barrel then exports `undefined` for them.\nexport class SecretsHelperFactory {\n static async create(\n opts: ISecretsRegistration & { identifier?: string },\n ): Promise<ISecretsHelper> {\n const shared = {\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n renewBeforeRatio: opts.renewBeforeRatio,\n };\n\n const config = opts.config as AnyType;\n\n switch (opts.provider) {\n case SecretProviders.SYSTEM_ENVS: {\n return new SystemEnvsHelper({ identifier: opts.identifier });\n }\n case SecretProviders.HASHICORP_VAULT: {\n // `client` is the injected escape: the helper never reaches for the peer, so demanding it here would defeat the escape.\n if (!config?.client) {\n ModuleUtility.assertInstalled({\n scope: 'HashiCorpVaultHelper',\n modules: ['node-vault'],\n allowRegistered: true,\n });\n }\n\n return new HashiCorpVaultHelper({ ...config, ...shared });\n }\n case SecretProviders.DOTENV_VAULT: {\n // `decode` is the injected escape - same reasoning as `client` above.\n if (!config?.decode) {\n ModuleUtility.assertInstalled({\n scope: 'DotenvVaultHelper',\n modules: ['@dotenvx/dotenvx'],\n allowRegistered: true,\n });\n }\n\n return new DotenvVaultHelper({ ...config, ...shared });\n }\n default: {\n throw getError({\n message: `[createSecretsHelper] Unsupported secret provider: ${opts.provider}`,\n });\n }\n }\n }\n}\n"]}