@venizia/ignis-helpers 0.4.7 → 0.4.8-1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (678) hide show
  1. package/README.md +2 -2
  2. package/dist/esm/common/constants/app.d.ts +15 -0
  3. package/dist/esm/common/constants/app.js +14 -0
  4. package/dist/esm/common/constants/app.js.map +1 -1
  5. package/dist/esm/common/constants/duration.d.ts +2 -0
  6. package/dist/esm/common/constants/duration.js.map +1 -1
  7. package/dist/esm/common/constants/grpc.d.ts +3 -0
  8. package/dist/esm/common/constants/grpc.js +1 -0
  9. package/dist/esm/common/constants/grpc.js.map +1 -1
  10. package/dist/esm/common/constants/http.d.ts +4 -0
  11. package/dist/esm/common/constants/http.js +1 -0
  12. package/dist/esm/common/constants/http.js.map +1 -1
  13. package/dist/esm/common/constants/mime.d.ts +4 -0
  14. package/dist/esm/common/constants/mime.js +1 -0
  15. package/dist/esm/common/constants/mime.js.map +1 -1
  16. package/dist/esm/common/redact.d.ts +2 -0
  17. package/dist/esm/common/redact.js +2 -0
  18. package/dist/esm/common/redact.js.map +1 -1
  19. package/dist/esm/common/resolvers.d.ts +1 -0
  20. package/dist/esm/common/resolvers.js +1 -0
  21. package/dist/esm/common/resolvers.js.map +1 -1
  22. package/dist/esm/common/types/class.d.ts +6 -0
  23. package/dist/esm/common/types/class.js.map +1 -1
  24. package/dist/esm/common/types/const-value.d.ts +3 -0
  25. package/dist/esm/common/types/const-value.js.map +1 -1
  26. package/dist/esm/common/types/field-mapping.d.ts +3 -0
  27. package/dist/esm/common/types/field-mapping.js.map +1 -1
  28. package/dist/esm/common/types/injection.d.ts +2 -0
  29. package/dist/esm/common/types/injection.js.map +1 -1
  30. package/dist/esm/common/types/utility.d.ts +9 -0
  31. package/dist/esm/common/types/utility.js.map +1 -1
  32. package/dist/esm/modules/base.d.ts +1 -0
  33. package/dist/esm/modules/base.js +1 -0
  34. package/dist/esm/modules/base.js.map +1 -1
  35. package/dist/esm/modules/cron/helper.d.ts +7 -0
  36. package/dist/esm/modules/cron/helper.js +1 -0
  37. package/dist/esm/modules/cron/helper.js.map +1 -1
  38. package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts +2 -0
  39. package/dist/esm/modules/crypto/algorithms/aes.algorithm.js.map +1 -1
  40. package/dist/esm/modules/crypto/algorithms/aes.engine.js.map +1 -1
  41. package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts +1 -0
  42. package/dist/esm/modules/crypto/algorithms/base.algorithm.js +1 -0
  43. package/dist/esm/modules/crypto/algorithms/base.algorithm.js.map +1 -1
  44. package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts +12 -4
  45. package/dist/esm/modules/crypto/algorithms/credential.algorithm.js +4 -4
  46. package/dist/esm/modules/crypto/algorithms/credential.algorithm.js.map +1 -1
  47. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts +3 -0
  48. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.js.map +1 -1
  49. package/dist/esm/modules/crypto/algorithms/hash.algorithm.js.map +1 -1
  50. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts +1 -0
  51. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.js.map +1 -1
  52. package/dist/esm/modules/crypto/common/constants.d.ts +12 -1
  53. package/dist/esm/modules/crypto/common/constants.js +9 -1
  54. package/dist/esm/modules/crypto/common/constants.js.map +1 -1
  55. package/dist/esm/modules/crypto/common/types.d.ts +1 -0
  56. package/dist/esm/modules/crypto/common/types.js.map +1 -1
  57. package/dist/esm/modules/env/app-env.d.ts +3 -0
  58. package/dist/esm/modules/env/app-env.js +3 -0
  59. package/dist/esm/modules/env/app-env.js.map +1 -1
  60. package/dist/esm/modules/env/common/types.d.ts +1 -0
  61. package/dist/esm/modules/env/common/types.js.map +1 -1
  62. package/dist/esm/modules/logger/base/base.js.map +1 -1
  63. package/dist/esm/modules/logger/base/console.js.map +1 -1
  64. package/dist/esm/modules/logger/common/constants.d.ts +3 -0
  65. package/dist/esm/modules/logger/common/constants.js +2 -0
  66. package/dist/esm/modules/logger/common/constants.js.map +1 -1
  67. package/dist/esm/modules/logger/common/debug-gate.js.map +1 -1
  68. package/dist/esm/modules/logger/common/types.d.ts +2 -0
  69. package/dist/esm/modules/logger/common/types.js +1 -0
  70. package/dist/esm/modules/logger/common/types.js.map +1 -1
  71. package/dist/esm/modules/logger/factory.js.map +1 -1
  72. package/dist/esm/modules/logger/formatting/deep-splat.d.ts +1 -0
  73. package/dist/esm/modules/logger/formatting/deep-splat.js +1 -0
  74. package/dist/esm/modules/logger/formatting/deep-splat.js.map +1 -1
  75. package/dist/esm/modules/logger/formatting/error-prettier.js.map +1 -1
  76. package/dist/esm/modules/logger/hf/common/types.d.ts +7 -2
  77. package/dist/esm/modules/logger/hf/common/types.js.map +1 -1
  78. package/dist/esm/modules/logger/hf/flusher.js.map +1 -1
  79. package/dist/esm/modules/logger/hf/logger.js.map +1 -1
  80. package/dist/esm/modules/logger/hf/ring.js.map +1 -1
  81. package/dist/esm/modules/logger/pino/backing.js.map +1 -1
  82. package/dist/esm/modules/logger/pino/destination.js.map +1 -1
  83. package/dist/esm/modules/logger/pino/logger.js.map +1 -1
  84. package/dist/esm/modules/logger/winston/common/types.d.ts +31 -3
  85. package/dist/esm/modules/logger/winston/common/types.js.map +1 -1
  86. package/dist/esm/modules/logger/winston/define.d.ts +1 -0
  87. package/dist/esm/modules/logger/winston/define.js +1 -0
  88. package/dist/esm/modules/logger/winston/define.js.map +1 -1
  89. package/dist/esm/modules/logger/winston/formats.js.map +1 -1
  90. package/dist/esm/modules/logger/winston/logger-factory.js.map +1 -1
  91. package/dist/esm/modules/logger/winston/logger.d.ts +1 -0
  92. package/dist/esm/modules/logger/winston/logger.js +1 -0
  93. package/dist/esm/modules/logger/winston/logger.js.map +1 -1
  94. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts +1 -0
  95. package/dist/esm/modules/logger/winston/transports/dgram.transport.js +1 -0
  96. package/dist/esm/modules/logger/winston/transports/dgram.transport.js.map +1 -1
  97. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts +1 -0
  98. package/dist/esm/modules/network/http-request/base-network-request.helper.js +1 -0
  99. package/dist/esm/modules/network/http-request/base-network-request.helper.js.map +1 -1
  100. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts +8 -8
  101. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js +2 -0
  102. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.js.map +1 -1
  103. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts +2 -0
  104. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.js.map +1 -1
  105. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts +5 -1
  106. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js +2 -0
  107. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.js.map +1 -1
  108. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts +11 -0
  109. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js +1 -0
  110. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.js.map +1 -1
  111. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts +3 -0
  112. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js +1 -0
  113. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.js.map +1 -1
  114. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts +1 -0
  115. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js +1 -0
  116. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.js.map +1 -1
  117. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts +1 -0
  118. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js +1 -0
  119. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.js.map +1 -1
  120. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts +1 -0
  121. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js +1 -0
  122. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.js.map +1 -1
  123. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts +1 -0
  124. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js +1 -0
  125. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.js.map +1 -1
  126. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts +4 -0
  127. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js +4 -0
  128. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.js.map +1 -1
  129. package/dist/esm/modules/network/utilities/query-string.d.ts +13 -2
  130. package/dist/esm/modules/network/utilities/query-string.js +2 -1
  131. package/dist/esm/modules/network/utilities/query-string.js.map +1 -1
  132. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts +2 -1
  133. package/dist/esm/modules/network/utilities/url-safety/common/constants.js +1 -1
  134. package/dist/esm/modules/network/utilities/url-safety/common/constants.js.map +1 -1
  135. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts +18 -5
  136. package/dist/esm/modules/network/utilities/url-safety/common/types.js.map +1 -1
  137. package/dist/esm/modules/network/utilities/url-safety/ingest.js.map +1 -1
  138. package/dist/esm/modules/network/utilities/url-safety/policy.js.map +1 -1
  139. package/dist/esm/modules/pool/abstract.js.map +1 -1
  140. package/dist/esm/modules/pool/common/types.d.ts +5 -1
  141. package/dist/esm/modules/pool/common/types.js.map +1 -1
  142. package/dist/esm/modules/queue/bullmq/helper.d.ts +13 -0
  143. package/dist/esm/modules/queue/bullmq/helper.js +4 -0
  144. package/dist/esm/modules/queue/bullmq/helper.js.map +1 -1
  145. package/dist/esm/modules/queue/common/hook.d.ts +1 -0
  146. package/dist/esm/modules/queue/common/hook.js +1 -0
  147. package/dist/esm/modules/queue/common/hook.js.map +1 -1
  148. package/dist/esm/modules/queue/internal/hf/helper.js.map +1 -1
  149. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts +8 -0
  150. package/dist/esm/modules/queue/internal/sequential/common/types.js +1 -0
  151. package/dist/esm/modules/queue/internal/sequential/common/types.js.map +1 -1
  152. package/dist/esm/modules/queue/internal/sequential/helper.d.ts +4 -0
  153. package/dist/esm/modules/queue/internal/sequential/helper.js +4 -0
  154. package/dist/esm/modules/queue/internal/sequential/helper.js.map +1 -1
  155. package/dist/esm/modules/queue/kafka/base.d.ts +5 -0
  156. package/dist/esm/modules/queue/kafka/base.js.map +1 -1
  157. package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts +3 -0
  158. package/dist/esm/modules/queue/kafka/bundler/common/constants.js +3 -0
  159. package/dist/esm/modules/queue/kafka/bundler/common/constants.js.map +1 -1
  160. package/dist/esm/modules/queue/kafka/common/constants.d.ts +8 -0
  161. package/dist/esm/modules/queue/kafka/common/constants.js +5 -0
  162. package/dist/esm/modules/queue/kafka/common/constants.js.map +1 -1
  163. package/dist/esm/modules/queue/kafka/common/types/admin.d.ts +1 -0
  164. package/dist/esm/modules/queue/kafka/common/types/admin.js.map +1 -1
  165. package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts +12 -0
  166. package/dist/esm/modules/queue/kafka/common/types/callbacks.js.map +1 -1
  167. package/dist/esm/modules/queue/kafka/common/types/connection.d.ts +2 -0
  168. package/dist/esm/modules/queue/kafka/common/types/connection.js.map +1 -1
  169. package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts +62 -0
  170. package/dist/esm/modules/queue/kafka/common/types/consumer.js.map +1 -1
  171. package/dist/esm/modules/queue/kafka/common/types/producer.d.ts +1 -0
  172. package/dist/esm/modules/queue/kafka/common/types/producer.js.map +1 -1
  173. package/dist/esm/modules/queue/kafka/consumer.js.map +1 -1
  174. package/dist/esm/modules/queue/mqtt/helper.d.ts +2 -0
  175. package/dist/esm/modules/queue/mqtt/helper.js +1 -0
  176. package/dist/esm/modules/queue/mqtt/helper.js.map +1 -1
  177. package/dist/esm/modules/redis/base/abstract.helper.d.ts +2 -0
  178. package/dist/esm/modules/redis/base/abstract.helper.js +2 -0
  179. package/dist/esm/modules/redis/base/abstract.helper.js.map +1 -1
  180. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts +1 -0
  181. package/dist/esm/modules/redis/cluster/cluster.helper.js +1 -0
  182. package/dist/esm/modules/redis/cluster/cluster.helper.js.map +1 -1
  183. package/dist/esm/modules/redis/common/constants.d.ts +4 -0
  184. package/dist/esm/modules/redis/common/constants.js +2 -0
  185. package/dist/esm/modules/redis/common/constants.js.map +1 -1
  186. package/dist/esm/modules/redis/common/interfaces.d.ts +12 -0
  187. package/dist/esm/modules/redis/common/interfaces.js.map +1 -1
  188. package/dist/esm/modules/redis/common/types.d.ts +21 -1
  189. package/dist/esm/modules/redis/common/types.js.map +1 -1
  190. package/dist/esm/modules/redis/factory.d.ts +2 -0
  191. package/dist/esm/modules/redis/factory.js +1 -0
  192. package/dist/esm/modules/redis/factory.js.map +1 -1
  193. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts +1 -0
  194. package/dist/esm/modules/redis/sentinel/sentinel.helper.js +1 -0
  195. package/dist/esm/modules/redis/sentinel/sentinel.helper.js.map +1 -1
  196. package/dist/esm/modules/redis/single/single.helper.d.ts +1 -0
  197. package/dist/esm/modules/redis/single/single.helper.js +1 -0
  198. package/dist/esm/modules/redis/single/single.helper.js.map +1 -1
  199. package/dist/esm/modules/redis/utility.d.ts +1 -0
  200. package/dist/esm/modules/redis/utility.js +1 -0
  201. package/dist/esm/modules/redis/utility.js.map +1 -1
  202. package/dist/esm/modules/retry/common/constants.d.ts +4 -0
  203. package/dist/esm/modules/retry/common/constants.js +2 -0
  204. package/dist/esm/modules/retry/common/constants.js.map +1 -1
  205. package/dist/esm/modules/retry/common/types.d.ts +19 -5
  206. package/dist/esm/modules/retry/common/types.js.map +1 -1
  207. package/dist/esm/modules/retry/helper.d.ts +4 -4
  208. package/dist/esm/modules/retry/helper.js.map +1 -1
  209. package/dist/esm/modules/secrets/base/abstract.helper.d.ts +1 -0
  210. package/dist/esm/modules/secrets/base/abstract.helper.js +1 -0
  211. package/dist/esm/modules/secrets/base/abstract.helper.js.map +1 -1
  212. package/dist/esm/modules/secrets/common/constants.d.ts +4 -0
  213. package/dist/esm/modules/secrets/common/constants.js +2 -0
  214. package/dist/esm/modules/secrets/common/constants.js.map +1 -1
  215. package/dist/esm/modules/secrets/common/types/helper.d.ts +13 -0
  216. package/dist/esm/modules/secrets/common/types/helper.js.map +1 -1
  217. package/dist/esm/modules/secrets/common/types/lease.d.ts +2 -0
  218. package/dist/esm/modules/secrets/common/types/lease.js.map +1 -1
  219. package/dist/esm/modules/secrets/common/types/registration.d.ts +13 -2
  220. package/dist/esm/modules/secrets/common/types/registration.js.map +1 -1
  221. package/dist/esm/modules/secrets/common/types/timer.d.ts +1 -0
  222. package/dist/esm/modules/secrets/common/types/timer.js.map +1 -1
  223. package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts +8 -0
  224. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js +1 -0
  225. package/dist/esm/modules/secrets/dotenv/dotenv.helper.js.map +1 -1
  226. package/dist/esm/modules/secrets/factory.d.ts +1 -0
  227. package/dist/esm/modules/secrets/factory.js +1 -0
  228. package/dist/esm/modules/secrets/factory.js.map +1 -1
  229. package/dist/esm/modules/secrets/hashicorp/auth.d.ts +2 -0
  230. package/dist/esm/modules/secrets/hashicorp/auth.js +1 -0
  231. package/dist/esm/modules/secrets/hashicorp/auth.js.map +1 -1
  232. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts +2 -0
  233. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js +1 -0
  234. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.js.map +1 -1
  235. package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts +1 -0
  236. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js +1 -0
  237. package/dist/esm/modules/secrets/system-envs/system-envs.helper.js.map +1 -1
  238. package/dist/esm/modules/slug/common/constants.d.ts +1 -0
  239. package/dist/esm/modules/slug/common/constants.js +1 -0
  240. package/dist/esm/modules/slug/common/constants.js.map +1 -1
  241. package/dist/esm/modules/socket/socket-io/client/browser-helper.js.map +1 -1
  242. package/dist/esm/modules/socket/socket-io/common/constants.d.ts +2 -0
  243. package/dist/esm/modules/socket/socket-io/common/constants.js +2 -0
  244. package/dist/esm/modules/socket/socket-io/common/constants.js.map +1 -1
  245. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts +5 -0
  246. package/dist/esm/modules/socket/socket-io/common/types/client.js.map +1 -1
  247. package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts +4 -0
  248. package/dist/esm/modules/socket/socket-io/common/types/hooks.js.map +1 -1
  249. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts +6 -0
  250. package/dist/esm/modules/socket/socket-io/common/types/server.js.map +1 -1
  251. package/dist/esm/modules/socket/socket-io/server/helper.d.ts +1 -0
  252. package/dist/esm/modules/socket/socket-io/server/helper.js +1 -0
  253. package/dist/esm/modules/socket/socket-io/server/helper.js.map +1 -1
  254. package/dist/esm/modules/socket/websocket/common/constants.d.ts +7 -0
  255. package/dist/esm/modules/socket/websocket/common/constants.js +5 -0
  256. package/dist/esm/modules/socket/websocket/common/constants.js.map +1 -1
  257. package/dist/esm/modules/socket/websocket/common/types/client.d.ts +4 -0
  258. package/dist/esm/modules/socket/websocket/common/types/client.js.map +1 -1
  259. package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts +7 -0
  260. package/dist/esm/modules/socket/websocket/common/types/hooks.js.map +1 -1
  261. package/dist/esm/modules/socket/websocket/common/types/server.d.ts +30 -0
  262. package/dist/esm/modules/socket/websocket/common/types/server.js.map +1 -1
  263. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts +1 -0
  264. package/dist/esm/modules/socket/websocket/emitter/helper.js +1 -0
  265. package/dist/esm/modules/socket/websocket/emitter/helper.js.map +1 -1
  266. package/dist/esm/modules/socket/websocket/server/delivery.js.map +1 -1
  267. package/dist/esm/modules/socket/websocket/server/helper.d.ts +1 -0
  268. package/dist/esm/modules/socket/websocket/server/helper.js +1 -0
  269. package/dist/esm/modules/socket/websocket/server/helper.js.map +1 -1
  270. package/dist/esm/modules/storage/base.d.ts +6 -1
  271. package/dist/esm/modules/storage/base.js +1 -0
  272. package/dist/esm/modules/storage/base.js.map +1 -1
  273. package/dist/esm/modules/storage/bun-s3/helper.d.ts +9 -1
  274. package/dist/esm/modules/storage/bun-s3/helper.js +2 -1
  275. package/dist/esm/modules/storage/bun-s3/helper.js.map +1 -1
  276. package/dist/esm/modules/storage/bun-s3/utility.js.map +1 -1
  277. package/dist/esm/modules/storage/common/constants.d.ts +1 -0
  278. package/dist/esm/modules/storage/common/constants.js.map +1 -1
  279. package/dist/esm/modules/storage/common/types.d.ts +17 -1
  280. package/dist/esm/modules/storage/common/types.js.map +1 -1
  281. package/dist/esm/modules/storage/common/utility.d.ts +1 -0
  282. package/dist/esm/modules/storage/common/utility.js +1 -0
  283. package/dist/esm/modules/storage/common/utility.js.map +1 -1
  284. package/dist/esm/modules/storage/disk/helper.d.ts +2 -0
  285. package/dist/esm/modules/storage/disk/helper.js +1 -0
  286. package/dist/esm/modules/storage/disk/helper.js.map +1 -1
  287. package/dist/esm/modules/temporal/abstract.d.ts +5 -0
  288. package/dist/esm/modules/temporal/abstract.js +2 -1
  289. package/dist/esm/modules/temporal/abstract.js.map +1 -1
  290. package/dist/esm/modules/temporal/adapters/dayjs.js.map +1 -1
  291. package/dist/esm/modules/temporal/adapters/intl.js.map +1 -1
  292. package/dist/esm/modules/temporal/adapters/luxon.js.map +1 -1
  293. package/dist/esm/modules/temporal/adapters/native.js.map +1 -1
  294. package/dist/esm/modules/temporal/calendar/calendar.js.map +1 -1
  295. package/dist/esm/modules/temporal/common/constants.d.ts +3 -0
  296. package/dist/esm/modules/temporal/common/constants.js.map +1 -1
  297. package/dist/esm/modules/temporal/common/types.js.map +1 -1
  298. package/dist/esm/modules/temporal/duration/duration.js.map +1 -1
  299. package/dist/esm/modules/temporal/helper.js.map +1 -1
  300. package/dist/esm/modules/temporal/locale/locale.js.map +1 -1
  301. package/dist/esm/modules/temporal/pattern/pattern.js.map +1 -1
  302. package/dist/esm/modules/temporal/pattern/tokens.js.map +1 -1
  303. package/dist/esm/modules/tree/builder.js.map +1 -1
  304. package/dist/esm/modules/tree/common/types.d.ts +6 -0
  305. package/dist/esm/modules/tree/common/types.js.map +1 -1
  306. package/dist/esm/modules/uid/common/constants.d.ts +1 -0
  307. package/dist/esm/modules/uid/common/constants.js.map +1 -1
  308. package/dist/esm/modules/uid/common/types.d.ts +28 -7
  309. package/dist/esm/modules/uid/common/types.js.map +1 -1
  310. package/dist/esm/modules/uid/helper.d.ts +12 -0
  311. package/dist/esm/modules/uid/helper.js.map +1 -1
  312. package/dist/esm/modules/uid/opaque.js.map +1 -1
  313. package/dist/esm/modules/uid/uuid/helper.js.map +1 -1
  314. package/dist/esm/modules/uid/uuid/sha1.js.map +1 -1
  315. package/dist/esm/modules/uid/uuid/v4.d.ts +1 -0
  316. package/dist/esm/modules/uid/uuid/v4.js +1 -0
  317. package/dist/esm/modules/uid/uuid/v4.js.map +1 -1
  318. package/dist/esm/modules/uid/uuid/v5.d.ts +1 -0
  319. package/dist/esm/modules/uid/uuid/v5.js +1 -0
  320. package/dist/esm/modules/uid/uuid/v5.js.map +1 -1
  321. package/dist/esm/modules/uid/uuid/v7.d.ts +1 -0
  322. package/dist/esm/modules/uid/uuid/v7.js +1 -0
  323. package/dist/esm/modules/uid/uuid/v7.js.map +1 -1
  324. package/dist/esm/modules/worker-thread/bus/abstract.d.ts +1 -0
  325. package/dist/esm/modules/worker-thread/bus/abstract.js +1 -0
  326. package/dist/esm/modules/worker-thread/bus/abstract.js.map +1 -1
  327. package/dist/esm/modules/worker-thread/bus/base.d.ts +1 -0
  328. package/dist/esm/modules/worker-thread/bus/base.js +1 -0
  329. package/dist/esm/modules/worker-thread/bus/base.js.map +1 -1
  330. package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts +1 -0
  331. package/dist/esm/modules/worker-thread/bus/handler/abstract.js +1 -0
  332. package/dist/esm/modules/worker-thread/bus/handler/abstract.js.map +1 -1
  333. package/dist/esm/modules/worker-thread/bus/handler/base.d.ts +1 -0
  334. package/dist/esm/modules/worker-thread/bus/handler/base.js +1 -0
  335. package/dist/esm/modules/worker-thread/bus/handler/base.js.map +1 -1
  336. package/dist/esm/modules/worker-thread/common/types.d.ts +4 -0
  337. package/dist/esm/modules/worker-thread/common/types.js.map +1 -1
  338. package/dist/esm/modules/worker-thread/thread/abstract.d.ts +1 -0
  339. package/dist/esm/modules/worker-thread/thread/abstract.js +1 -0
  340. package/dist/esm/modules/worker-thread/thread/abstract.js.map +1 -1
  341. package/dist/esm/modules/worker-thread/thread/base.d.ts +1 -0
  342. package/dist/esm/modules/worker-thread/thread/base.js +1 -0
  343. package/dist/esm/modules/worker-thread/thread/base.js.map +1 -1
  344. package/dist/esm/modules/worker-thread/worker/abstract.d.ts +1 -0
  345. package/dist/esm/modules/worker-thread/worker/abstract.js +1 -0
  346. package/dist/esm/modules/worker-thread/worker/abstract.js.map +1 -1
  347. package/dist/esm/modules/worker-thread/worker/base.d.ts +1 -0
  348. package/dist/esm/modules/worker-thread/worker/base.js +1 -0
  349. package/dist/esm/modules/worker-thread/worker/base.js.map +1 -1
  350. package/dist/esm/modules/worker-thread/worker-pool.d.ts +1 -0
  351. package/dist/esm/modules/worker-thread/worker-pool.js +1 -0
  352. package/dist/esm/modules/worker-thread/worker-pool.js.map +1 -1
  353. package/dist/esm/utilities/error.utility.d.ts +1 -0
  354. package/dist/esm/utilities/error.utility.js +1 -0
  355. package/dist/esm/utilities/error.utility.js.map +1 -1
  356. package/dist/esm/utilities/form-body.utility.d.ts +1 -0
  357. package/dist/esm/utilities/form-body.utility.js +1 -0
  358. package/dist/esm/utilities/form-body.utility.js.map +1 -1
  359. package/dist/esm/utilities/hr-time.utility.d.ts +1 -0
  360. package/dist/esm/utilities/hr-time.utility.js +1 -0
  361. package/dist/esm/utilities/hr-time.utility.js.map +1 -1
  362. package/dist/esm/utilities/module.utility.js.map +1 -1
  363. package/dist/esm/utilities/parse.utility.js.map +1 -1
  364. package/dist/esm/utilities/performance.utility.d.ts +1 -0
  365. package/dist/esm/utilities/performance.utility.js +1 -0
  366. package/dist/esm/utilities/performance.utility.js.map +1 -1
  367. package/dist/esm/utilities/promise.utility.d.ts +1 -0
  368. package/dist/esm/utilities/promise.utility.js.map +1 -1
  369. package/dist/esm/utilities/request.utility.d.ts +2 -0
  370. package/dist/esm/utilities/request.utility.js +1 -0
  371. package/dist/esm/utilities/request.utility.js.map +1 -1
  372. package/package.json +4 -4
  373. package/dist/esm/common/constants/app.d.ts.map +0 -1
  374. package/dist/esm/common/constants/duration.d.ts.map +0 -1
  375. package/dist/esm/common/constants/grpc.d.ts.map +0 -1
  376. package/dist/esm/common/constants/http.d.ts.map +0 -1
  377. package/dist/esm/common/constants/index.d.ts.map +0 -1
  378. package/dist/esm/common/constants/mime.d.ts.map +0 -1
  379. package/dist/esm/common/index.d.ts.map +0 -1
  380. package/dist/esm/common/jsx.d.ts.map +0 -1
  381. package/dist/esm/common/redact.d.ts.map +0 -1
  382. package/dist/esm/common/resolvers.d.ts.map +0 -1
  383. package/dist/esm/common/types/class.d.ts.map +0 -1
  384. package/dist/esm/common/types/const-value.d.ts.map +0 -1
  385. package/dist/esm/common/types/field-mapping.d.ts.map +0 -1
  386. package/dist/esm/common/types/index.d.ts.map +0 -1
  387. package/dist/esm/common/types/injection.d.ts.map +0 -1
  388. package/dist/esm/common/types/resolver.d.ts.map +0 -1
  389. package/dist/esm/common/types/utility.d.ts.map +0 -1
  390. package/dist/esm/core.d.ts.map +0 -1
  391. package/dist/esm/index.d.ts.map +0 -1
  392. package/dist/esm/modules/base.d.ts.map +0 -1
  393. package/dist/esm/modules/cron/helper.d.ts.map +0 -1
  394. package/dist/esm/modules/cron/index.d.ts.map +0 -1
  395. package/dist/esm/modules/crypto/algorithms/abstract.algorithm.d.ts.map +0 -1
  396. package/dist/esm/modules/crypto/algorithms/aes.algorithm.d.ts.map +0 -1
  397. package/dist/esm/modules/crypto/algorithms/aes.constants.d.ts.map +0 -1
  398. package/dist/esm/modules/crypto/algorithms/aes.engine.d.ts.map +0 -1
  399. package/dist/esm/modules/crypto/algorithms/base.algorithm.d.ts.map +0 -1
  400. package/dist/esm/modules/crypto/algorithms/credential.algorithm.d.ts.map +0 -1
  401. package/dist/esm/modules/crypto/algorithms/ecdh.algorithm.d.ts.map +0 -1
  402. package/dist/esm/modules/crypto/algorithms/hash.algorithm.d.ts.map +0 -1
  403. package/dist/esm/modules/crypto/algorithms/index.d.ts.map +0 -1
  404. package/dist/esm/modules/crypto/algorithms/rsa.algorithm.d.ts.map +0 -1
  405. package/dist/esm/modules/crypto/common/constants.d.ts.map +0 -1
  406. package/dist/esm/modules/crypto/common/index.d.ts.map +0 -1
  407. package/dist/esm/modules/crypto/common/types.d.ts.map +0 -1
  408. package/dist/esm/modules/crypto/index.d.ts.map +0 -1
  409. package/dist/esm/modules/env/app-env.d.ts.map +0 -1
  410. package/dist/esm/modules/env/common/index.d.ts.map +0 -1
  411. package/dist/esm/modules/env/common/types.d.ts.map +0 -1
  412. package/dist/esm/modules/env/index.d.ts.map +0 -1
  413. package/dist/esm/modules/env/names.d.ts.map +0 -1
  414. package/dist/esm/modules/error/index.d.ts.map +0 -1
  415. package/dist/esm/modules/index.d.ts.map +0 -1
  416. package/dist/esm/modules/logger/base/abstract.d.ts.map +0 -1
  417. package/dist/esm/modules/logger/base/base.d.ts.map +0 -1
  418. package/dist/esm/modules/logger/base/console.d.ts.map +0 -1
  419. package/dist/esm/modules/logger/base/index.d.ts.map +0 -1
  420. package/dist/esm/modules/logger/common/constants.d.ts.map +0 -1
  421. package/dist/esm/modules/logger/common/debug-gate.d.ts.map +0 -1
  422. package/dist/esm/modules/logger/common/index.d.ts.map +0 -1
  423. package/dist/esm/modules/logger/common/types.d.ts.map +0 -1
  424. package/dist/esm/modules/logger/factory.d.ts.map +0 -1
  425. package/dist/esm/modules/logger/formatting/deep-splat.d.ts.map +0 -1
  426. package/dist/esm/modules/logger/formatting/error-prettier.d.ts.map +0 -1
  427. package/dist/esm/modules/logger/formatting/index.d.ts.map +0 -1
  428. package/dist/esm/modules/logger/hf/common/constants.d.ts.map +0 -1
  429. package/dist/esm/modules/logger/hf/common/index.d.ts.map +0 -1
  430. package/dist/esm/modules/logger/hf/common/types.d.ts.map +0 -1
  431. package/dist/esm/modules/logger/hf/flusher.d.ts.map +0 -1
  432. package/dist/esm/modules/logger/hf/index.d.ts.map +0 -1
  433. package/dist/esm/modules/logger/hf/logger.d.ts.map +0 -1
  434. package/dist/esm/modules/logger/hf/ring.d.ts.map +0 -1
  435. package/dist/esm/modules/logger/index.d.ts.map +0 -1
  436. package/dist/esm/modules/logger/pino/backing.d.ts.map +0 -1
  437. package/dist/esm/modules/logger/pino/common/constants.d.ts.map +0 -1
  438. package/dist/esm/modules/logger/pino/common/index.d.ts.map +0 -1
  439. package/dist/esm/modules/logger/pino/common/types.d.ts.map +0 -1
  440. package/dist/esm/modules/logger/pino/destination.d.ts.map +0 -1
  441. package/dist/esm/modules/logger/pino/index.d.ts.map +0 -1
  442. package/dist/esm/modules/logger/pino/logger.d.ts.map +0 -1
  443. package/dist/esm/modules/logger/winston/common/constants.d.ts.map +0 -1
  444. package/dist/esm/modules/logger/winston/common/index.d.ts.map +0 -1
  445. package/dist/esm/modules/logger/winston/common/types.d.ts.map +0 -1
  446. package/dist/esm/modules/logger/winston/define.d.ts.map +0 -1
  447. package/dist/esm/modules/logger/winston/formats.d.ts.map +0 -1
  448. package/dist/esm/modules/logger/winston/index.d.ts.map +0 -1
  449. package/dist/esm/modules/logger/winston/logger-factory.d.ts.map +0 -1
  450. package/dist/esm/modules/logger/winston/logger.d.ts.map +0 -1
  451. package/dist/esm/modules/logger/winston/transports/dgram.transport.d.ts.map +0 -1
  452. package/dist/esm/modules/logger/winston/transports/index.d.ts.map +0 -1
  453. package/dist/esm/modules/network/http-request/base-network-request.helper.d.ts.map +0 -1
  454. package/dist/esm/modules/network/http-request/common/constants.d.ts.map +0 -1
  455. package/dist/esm/modules/network/http-request/common/index.d.ts.map +0 -1
  456. package/dist/esm/modules/network/http-request/fetcher/axios-fetcher.d.ts.map +0 -1
  457. package/dist/esm/modules/network/http-request/fetcher/base-fetcher.d.ts.map +0 -1
  458. package/dist/esm/modules/network/http-request/fetcher/common/index.d.ts.map +0 -1
  459. package/dist/esm/modules/network/http-request/fetcher/common/types.d.ts.map +0 -1
  460. package/dist/esm/modules/network/http-request/fetcher/index.d.ts.map +0 -1
  461. package/dist/esm/modules/network/http-request/fetcher/node-fetcher.d.ts.map +0 -1
  462. package/dist/esm/modules/network/http-request/index.d.ts.map +0 -1
  463. package/dist/esm/modules/network/index.d.ts.map +0 -1
  464. package/dist/esm/modules/network/tcp-socket/base-tcp-client.helper.d.ts.map +0 -1
  465. package/dist/esm/modules/network/tcp-socket/base-tcp-server.helper.d.ts.map +0 -1
  466. package/dist/esm/modules/network/tcp-socket/index.d.ts.map +0 -1
  467. package/dist/esm/modules/network/tcp-socket/network-tcp-client.helper.d.ts.map +0 -1
  468. package/dist/esm/modules/network/tcp-socket/network-tcp-server.helper.d.ts.map +0 -1
  469. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-client.helper.d.ts.map +0 -1
  470. package/dist/esm/modules/network/tcp-socket/network-tls-tcp-server.helper.d.ts.map +0 -1
  471. package/dist/esm/modules/network/udp-socket/index.d.ts.map +0 -1
  472. package/dist/esm/modules/network/udp-socket/network-udp-client.helper.d.ts.map +0 -1
  473. package/dist/esm/modules/network/utilities/index.d.ts.map +0 -1
  474. package/dist/esm/modules/network/utilities/query-string.d.ts.map +0 -1
  475. package/dist/esm/modules/network/utilities/url-safety/common/constants.d.ts.map +0 -1
  476. package/dist/esm/modules/network/utilities/url-safety/common/errors.d.ts.map +0 -1
  477. package/dist/esm/modules/network/utilities/url-safety/common/index.d.ts.map +0 -1
  478. package/dist/esm/modules/network/utilities/url-safety/common/types.d.ts.map +0 -1
  479. package/dist/esm/modules/network/utilities/url-safety/index.d.ts.map +0 -1
  480. package/dist/esm/modules/network/utilities/url-safety/ingest.d.ts.map +0 -1
  481. package/dist/esm/modules/network/utilities/url-safety/policy.d.ts.map +0 -1
  482. package/dist/esm/modules/pool/abstract.d.ts.map +0 -1
  483. package/dist/esm/modules/pool/base.d.ts.map +0 -1
  484. package/dist/esm/modules/pool/common/index.d.ts.map +0 -1
  485. package/dist/esm/modules/pool/common/types.d.ts.map +0 -1
  486. package/dist/esm/modules/pool/index.d.ts.map +0 -1
  487. package/dist/esm/modules/queue/bullmq/helper.d.ts.map +0 -1
  488. package/dist/esm/modules/queue/bullmq/index.d.ts.map +0 -1
  489. package/dist/esm/modules/queue/common/constants.d.ts.map +0 -1
  490. package/dist/esm/modules/queue/common/hook.d.ts.map +0 -1
  491. package/dist/esm/modules/queue/common/index.d.ts.map +0 -1
  492. package/dist/esm/modules/queue/index.d.ts.map +0 -1
  493. package/dist/esm/modules/queue/internal/hf/common/index.d.ts.map +0 -1
  494. package/dist/esm/modules/queue/internal/hf/common/types.d.ts.map +0 -1
  495. package/dist/esm/modules/queue/internal/hf/helper.d.ts.map +0 -1
  496. package/dist/esm/modules/queue/internal/hf/index.d.ts.map +0 -1
  497. package/dist/esm/modules/queue/internal/index.d.ts.map +0 -1
  498. package/dist/esm/modules/queue/internal/sequential/common/index.d.ts.map +0 -1
  499. package/dist/esm/modules/queue/internal/sequential/common/types.d.ts.map +0 -1
  500. package/dist/esm/modules/queue/internal/sequential/helper.d.ts.map +0 -1
  501. package/dist/esm/modules/queue/internal/sequential/index.d.ts.map +0 -1
  502. package/dist/esm/modules/queue/kafka/admin.d.ts.map +0 -1
  503. package/dist/esm/modules/queue/kafka/base.d.ts.map +0 -1
  504. package/dist/esm/modules/queue/kafka/bundler/common/constants.d.ts.map +0 -1
  505. package/dist/esm/modules/queue/kafka/bundler/common/index.d.ts.map +0 -1
  506. package/dist/esm/modules/queue/kafka/bundler/index.d.ts.map +0 -1
  507. package/dist/esm/modules/queue/kafka/bundler/plugins.d.ts.map +0 -1
  508. package/dist/esm/modules/queue/kafka/common/constants.d.ts.map +0 -1
  509. package/dist/esm/modules/queue/kafka/common/index.d.ts.map +0 -1
  510. package/dist/esm/modules/queue/kafka/common/types/admin.d.ts.map +0 -1
  511. package/dist/esm/modules/queue/kafka/common/types/callbacks.d.ts.map +0 -1
  512. package/dist/esm/modules/queue/kafka/common/types/connection.d.ts.map +0 -1
  513. package/dist/esm/modules/queue/kafka/common/types/consumer.d.ts.map +0 -1
  514. package/dist/esm/modules/queue/kafka/common/types/index.d.ts.map +0 -1
  515. package/dist/esm/modules/queue/kafka/common/types/producer.d.ts.map +0 -1
  516. package/dist/esm/modules/queue/kafka/consumer.d.ts.map +0 -1
  517. package/dist/esm/modules/queue/kafka/index.d.ts.map +0 -1
  518. package/dist/esm/modules/queue/kafka/producer.d.ts.map +0 -1
  519. package/dist/esm/modules/queue/kafka/schema/index.d.ts.map +0 -1
  520. package/dist/esm/modules/queue/kafka/schema/registry.d.ts.map +0 -1
  521. package/dist/esm/modules/queue/mqtt/helper.d.ts.map +0 -1
  522. package/dist/esm/modules/queue/mqtt/index.d.ts.map +0 -1
  523. package/dist/esm/modules/redis/base/abstract.helper.d.ts.map +0 -1
  524. package/dist/esm/modules/redis/base/index.d.ts.map +0 -1
  525. package/dist/esm/modules/redis/cluster/cluster.helper.d.ts.map +0 -1
  526. package/dist/esm/modules/redis/cluster/index.d.ts.map +0 -1
  527. package/dist/esm/modules/redis/common/constants.d.ts.map +0 -1
  528. package/dist/esm/modules/redis/common/index.d.ts.map +0 -1
  529. package/dist/esm/modules/redis/common/interfaces.d.ts.map +0 -1
  530. package/dist/esm/modules/redis/common/types.d.ts.map +0 -1
  531. package/dist/esm/modules/redis/factory.d.ts.map +0 -1
  532. package/dist/esm/modules/redis/index.d.ts.map +0 -1
  533. package/dist/esm/modules/redis/sentinel/index.d.ts.map +0 -1
  534. package/dist/esm/modules/redis/sentinel/sentinel.helper.d.ts.map +0 -1
  535. package/dist/esm/modules/redis/single/index.d.ts.map +0 -1
  536. package/dist/esm/modules/redis/single/single.helper.d.ts.map +0 -1
  537. package/dist/esm/modules/redis/utility.d.ts.map +0 -1
  538. package/dist/esm/modules/retry/common/constants.d.ts.map +0 -1
  539. package/dist/esm/modules/retry/common/index.d.ts.map +0 -1
  540. package/dist/esm/modules/retry/common/types.d.ts.map +0 -1
  541. package/dist/esm/modules/retry/helper.d.ts.map +0 -1
  542. package/dist/esm/modules/retry/index.d.ts.map +0 -1
  543. package/dist/esm/modules/secrets/base/abstract.helper.d.ts.map +0 -1
  544. package/dist/esm/modules/secrets/base/index.d.ts.map +0 -1
  545. package/dist/esm/modules/secrets/common/constants.d.ts.map +0 -1
  546. package/dist/esm/modules/secrets/common/index.d.ts.map +0 -1
  547. package/dist/esm/modules/secrets/common/types/helper.d.ts.map +0 -1
  548. package/dist/esm/modules/secrets/common/types/index.d.ts.map +0 -1
  549. package/dist/esm/modules/secrets/common/types/lease.d.ts.map +0 -1
  550. package/dist/esm/modules/secrets/common/types/registration.d.ts.map +0 -1
  551. package/dist/esm/modules/secrets/common/types/timer.d.ts.map +0 -1
  552. package/dist/esm/modules/secrets/dotenv/dotenv.helper.d.ts.map +0 -1
  553. package/dist/esm/modules/secrets/dotenv/index.d.ts.map +0 -1
  554. package/dist/esm/modules/secrets/factory.d.ts.map +0 -1
  555. package/dist/esm/modules/secrets/hashicorp/auth.d.ts.map +0 -1
  556. package/dist/esm/modules/secrets/hashicorp/hashicorp.helper.d.ts.map +0 -1
  557. package/dist/esm/modules/secrets/hashicorp/index.d.ts.map +0 -1
  558. package/dist/esm/modules/secrets/index.d.ts.map +0 -1
  559. package/dist/esm/modules/secrets/system-envs/index.d.ts.map +0 -1
  560. package/dist/esm/modules/secrets/system-envs/system-envs.helper.d.ts.map +0 -1
  561. package/dist/esm/modules/slug/common/constants.d.ts.map +0 -1
  562. package/dist/esm/modules/slug/common/index.d.ts.map +0 -1
  563. package/dist/esm/modules/slug/helper.d.ts.map +0 -1
  564. package/dist/esm/modules/slug/index.d.ts.map +0 -1
  565. package/dist/esm/modules/socket/index.d.ts.map +0 -1
  566. package/dist/esm/modules/socket/socket-io/browser.d.ts.map +0 -1
  567. package/dist/esm/modules/socket/socket-io/client/browser-helper.d.ts.map +0 -1
  568. package/dist/esm/modules/socket/socket-io/client/helper.d.ts.map +0 -1
  569. package/dist/esm/modules/socket/socket-io/client/index.d.ts.map +0 -1
  570. package/dist/esm/modules/socket/socket-io/common/constants.d.ts.map +0 -1
  571. package/dist/esm/modules/socket/socket-io/common/index.d.ts.map +0 -1
  572. package/dist/esm/modules/socket/socket-io/common/types/client.d.ts.map +0 -1
  573. package/dist/esm/modules/socket/socket-io/common/types/hooks.d.ts.map +0 -1
  574. package/dist/esm/modules/socket/socket-io/common/types/index.d.ts.map +0 -1
  575. package/dist/esm/modules/socket/socket-io/common/types/server.d.ts.map +0 -1
  576. package/dist/esm/modules/socket/socket-io/index.d.ts.map +0 -1
  577. package/dist/esm/modules/socket/socket-io/server/helper.d.ts.map +0 -1
  578. package/dist/esm/modules/socket/socket-io/server/index.d.ts.map +0 -1
  579. package/dist/esm/modules/socket/websocket/common/constants.d.ts.map +0 -1
  580. package/dist/esm/modules/socket/websocket/common/index.d.ts.map +0 -1
  581. package/dist/esm/modules/socket/websocket/common/types/client.d.ts.map +0 -1
  582. package/dist/esm/modules/socket/websocket/common/types/hooks.d.ts.map +0 -1
  583. package/dist/esm/modules/socket/websocket/common/types/index.d.ts.map +0 -1
  584. package/dist/esm/modules/socket/websocket/common/types/message.d.ts.map +0 -1
  585. package/dist/esm/modules/socket/websocket/common/types/server.d.ts.map +0 -1
  586. package/dist/esm/modules/socket/websocket/emitter/helper.d.ts.map +0 -1
  587. package/dist/esm/modules/socket/websocket/emitter/index.d.ts.map +0 -1
  588. package/dist/esm/modules/socket/websocket/index.d.ts.map +0 -1
  589. package/dist/esm/modules/socket/websocket/server/delivery.d.ts.map +0 -1
  590. package/dist/esm/modules/socket/websocket/server/helper.d.ts.map +0 -1
  591. package/dist/esm/modules/socket/websocket/server/index.d.ts.map +0 -1
  592. package/dist/esm/modules/storage/base.d.ts.map +0 -1
  593. package/dist/esm/modules/storage/bun-s3/helper.d.ts.map +0 -1
  594. package/dist/esm/modules/storage/bun-s3/index.d.ts.map +0 -1
  595. package/dist/esm/modules/storage/bun-s3/utility.d.ts.map +0 -1
  596. package/dist/esm/modules/storage/common/constants.d.ts.map +0 -1
  597. package/dist/esm/modules/storage/common/errors.d.ts.map +0 -1
  598. package/dist/esm/modules/storage/common/index.d.ts.map +0 -1
  599. package/dist/esm/modules/storage/common/types.d.ts.map +0 -1
  600. package/dist/esm/modules/storage/common/utility.d.ts.map +0 -1
  601. package/dist/esm/modules/storage/disk/helper.d.ts.map +0 -1
  602. package/dist/esm/modules/storage/disk/index.d.ts.map +0 -1
  603. package/dist/esm/modules/storage/in-memory/helper.d.ts.map +0 -1
  604. package/dist/esm/modules/storage/in-memory/index.d.ts.map +0 -1
  605. package/dist/esm/modules/storage/index.d.ts.map +0 -1
  606. package/dist/esm/modules/temporal/abstract.d.ts.map +0 -1
  607. package/dist/esm/modules/temporal/adapters/dayjs.d.ts.map +0 -1
  608. package/dist/esm/modules/temporal/adapters/index.d.ts.map +0 -1
  609. package/dist/esm/modules/temporal/adapters/intl.d.ts.map +0 -1
  610. package/dist/esm/modules/temporal/adapters/luxon.d.ts.map +0 -1
  611. package/dist/esm/modules/temporal/adapters/native.d.ts.map +0 -1
  612. package/dist/esm/modules/temporal/calendar/calendar.d.ts.map +0 -1
  613. package/dist/esm/modules/temporal/calendar/index.d.ts.map +0 -1
  614. package/dist/esm/modules/temporal/common/constants.d.ts.map +0 -1
  615. package/dist/esm/modules/temporal/common/index.d.ts.map +0 -1
  616. package/dist/esm/modules/temporal/common/types.d.ts.map +0 -1
  617. package/dist/esm/modules/temporal/duration/duration.d.ts.map +0 -1
  618. package/dist/esm/modules/temporal/duration/index.d.ts.map +0 -1
  619. package/dist/esm/modules/temporal/helper.d.ts.map +0 -1
  620. package/dist/esm/modules/temporal/index.d.ts.map +0 -1
  621. package/dist/esm/modules/temporal/locale/index.d.ts.map +0 -1
  622. package/dist/esm/modules/temporal/locale/locale.d.ts.map +0 -1
  623. package/dist/esm/modules/temporal/pattern/common/constants.d.ts.map +0 -1
  624. package/dist/esm/modules/temporal/pattern/common/index.d.ts.map +0 -1
  625. package/dist/esm/modules/temporal/pattern/common/types.d.ts.map +0 -1
  626. package/dist/esm/modules/temporal/pattern/index.d.ts.map +0 -1
  627. package/dist/esm/modules/temporal/pattern/pattern.d.ts.map +0 -1
  628. package/dist/esm/modules/temporal/pattern/tokens.d.ts.map +0 -1
  629. package/dist/esm/modules/tree/builder.d.ts.map +0 -1
  630. package/dist/esm/modules/tree/common/index.d.ts.map +0 -1
  631. package/dist/esm/modules/tree/common/types.d.ts.map +0 -1
  632. package/dist/esm/modules/tree/index.d.ts.map +0 -1
  633. package/dist/esm/modules/tree/walk.d.ts.map +0 -1
  634. package/dist/esm/modules/uid/common/constants.d.ts.map +0 -1
  635. package/dist/esm/modules/uid/common/index.d.ts.map +0 -1
  636. package/dist/esm/modules/uid/common/types.d.ts.map +0 -1
  637. package/dist/esm/modules/uid/helper.d.ts.map +0 -1
  638. package/dist/esm/modules/uid/index.d.ts.map +0 -1
  639. package/dist/esm/modules/uid/opaque.d.ts.map +0 -1
  640. package/dist/esm/modules/uid/request-id.d.ts.map +0 -1
  641. package/dist/esm/modules/uid/uuid/common/constants.d.ts.map +0 -1
  642. package/dist/esm/modules/uid/uuid/common/index.d.ts.map +0 -1
  643. package/dist/esm/modules/uid/uuid/common/types.d.ts.map +0 -1
  644. package/dist/esm/modules/uid/uuid/helper.d.ts.map +0 -1
  645. package/dist/esm/modules/uid/uuid/index.d.ts.map +0 -1
  646. package/dist/esm/modules/uid/uuid/sha1.d.ts.map +0 -1
  647. package/dist/esm/modules/uid/uuid/v4.d.ts.map +0 -1
  648. package/dist/esm/modules/uid/uuid/v5.d.ts.map +0 -1
  649. package/dist/esm/modules/uid/uuid/v7.d.ts.map +0 -1
  650. package/dist/esm/modules/worker-thread/bus/abstract.d.ts.map +0 -1
  651. package/dist/esm/modules/worker-thread/bus/base.d.ts.map +0 -1
  652. package/dist/esm/modules/worker-thread/bus/handler/abstract.d.ts.map +0 -1
  653. package/dist/esm/modules/worker-thread/bus/handler/base.d.ts.map +0 -1
  654. package/dist/esm/modules/worker-thread/bus/handler/index.d.ts.map +0 -1
  655. package/dist/esm/modules/worker-thread/bus/index.d.ts.map +0 -1
  656. package/dist/esm/modules/worker-thread/common/index.d.ts.map +0 -1
  657. package/dist/esm/modules/worker-thread/common/types.d.ts.map +0 -1
  658. package/dist/esm/modules/worker-thread/index.d.ts.map +0 -1
  659. package/dist/esm/modules/worker-thread/thread/abstract.d.ts.map +0 -1
  660. package/dist/esm/modules/worker-thread/thread/base.d.ts.map +0 -1
  661. package/dist/esm/modules/worker-thread/thread/index.d.ts.map +0 -1
  662. package/dist/esm/modules/worker-thread/worker/abstract.d.ts.map +0 -1
  663. package/dist/esm/modules/worker-thread/worker/base.d.ts.map +0 -1
  664. package/dist/esm/modules/worker-thread/worker/index.d.ts.map +0 -1
  665. package/dist/esm/modules/worker-thread/worker-pool.d.ts.map +0 -1
  666. package/dist/esm/temporal.d.ts.map +0 -1
  667. package/dist/esm/utilities/build-info.utility.d.ts.map +0 -1
  668. package/dist/esm/utilities/error.utility.d.ts.map +0 -1
  669. package/dist/esm/utilities/form-body.utility.d.ts.map +0 -1
  670. package/dist/esm/utilities/hr-time.utility.d.ts.map +0 -1
  671. package/dist/esm/utilities/index.d.ts.map +0 -1
  672. package/dist/esm/utilities/module.utility.d.ts.map +0 -1
  673. package/dist/esm/utilities/parse.utility.d.ts.map +0 -1
  674. package/dist/esm/utilities/performance.utility.d.ts.map +0 -1
  675. package/dist/esm/utilities/project-root.utility.d.ts.map +0 -1
  676. package/dist/esm/utilities/promise.utility.d.ts.map +0 -1
  677. package/dist/esm/utilities/request.utility.d.ts.map +0 -1
  678. package/dist/esm/uuid.d.ts.map +0 -1
@@ -8,6 +8,7 @@ interface IRawFetchResult {
8
8
  renewable: boolean;
9
9
  };
10
10
  }
11
+ /** Base for secrets providers: caches bundles for `cacheTtlSeconds`, tracks leases and renews them at `renewBeforeRatio` of their TTL, and notifies rotation handlers. Subclasses implement `fetchRaw`, `renewRaw` and `revokeRaw`. The constructor throws when `renewBeforeRatio` is outside (0, 1]. */
11
12
  export declare abstract class AbstractSecretsHelper extends BaseHelper implements ISecretsHelper {
12
13
  protected readonly clock: IClock;
13
14
  protected readonly timers: ITimerAdapter;
@@ -15,6 +15,7 @@ const MIN_RENEW_DELAY_MS = 1_000;
15
15
  const BACKOFF_BASE_MS = 1_000;
16
16
  // 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.
17
17
  const MAX_BACKOFF_ATTEMPT_EXPONENT = 31;
18
+ /** Base for secrets providers: caches bundles for `cacheTtlSeconds`, tracks leases and renews them at `renewBeforeRatio` of their TTL, and notifies rotation handlers. Subclasses implement `fetchRaw`, `renewRaw` and `revokeRaw`. The constructor throws when `renewBeforeRatio` is outside (0, 1]. */
18
19
  export class AbstractSecretsHelper extends BaseHelper {
19
20
  constructor(opts) {
20
21
  super({ scope: opts.scope, identifier: opts.identifier });
@@ -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\n/** Base for secrets providers: caches bundles for `cacheTtlSeconds`, tracks leases and renews them at `renewBeforeRatio` of their TTL, and notifies rotation handlers. Subclasses implement `fetchRaw`, `renewRaw` and `revokeRaw`. The constructor throws when `renewBeforeRatio` is outside (0, 1]. */\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,4 +1,5 @@
1
1
  import type { TConstValue } from '../../../common/types/index.js';
2
+ /** Secret backends a secrets registration can select. */
2
3
  export declare class SecretProviders {
3
4
  static readonly SYSTEM_ENVS = "system-envs";
4
5
  static readonly HASHICORP_VAULT = "hashicorp-vault";
@@ -6,7 +7,9 @@ export declare class SecretProviders {
6
7
  static readonly SCHEME_SET: Set<string>;
7
8
  static isValid(value: string): value is TSecretProvider;
8
9
  }
10
+ /** Union of the `SecretProviders` values. */
9
11
  export type TSecretProvider = TConstValue<typeof SecretProviders>;
12
+ /** Ways a Vault provider can authenticate. */
10
13
  export declare class VaultAuthMethods {
11
14
  static readonly TOKEN = "token";
12
15
  static readonly APP_ROLE = "app-role";
@@ -14,5 +17,6 @@ export declare class VaultAuthMethods {
14
17
  static readonly SCHEME_SET: Set<string>;
15
18
  static isValid(value: string): value is TVaultAuthMethod;
16
19
  }
20
+ /** Union of the `VaultAuthMethods` values. */
17
21
  export type TVaultAuthMethod = TConstValue<typeof VaultAuthMethods>;
18
22
  //# sourceMappingURL=constants.d.ts.map
@@ -1,3 +1,4 @@
1
+ /** Secret backends a secrets registration can select. */
1
2
  export class SecretProviders {
2
3
  static { this.SYSTEM_ENVS = 'system-envs'; }
3
4
  static { this.HASHICORP_VAULT = 'hashicorp-vault'; }
@@ -7,6 +8,7 @@ export class SecretProviders {
7
8
  return this.SCHEME_SET.has(value);
8
9
  }
9
10
  }
11
+ /** Ways a Vault provider can authenticate. */
10
12
  export class VaultAuthMethods {
11
13
  static { this.TOKEN = 'token'; }
12
14
  static { this.APP_ROLE = 'app-role'; }
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/common/constants.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,eAAe;aACV,gBAAW,GAAG,aAAa,CAAC;aAC5B,oBAAe,GAAG,iBAAiB,CAAC;aACpC,iBAAY,GAAG,cAAc,CAAC;aAE9B,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAElG,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAKH,MAAM,OAAO,gBAAgB;aACX,UAAK,GAAG,OAAO,CAAC;aAChB,aAAQ,GAAG,UAAU,CAAC;aACtB,eAAU,GAAG,YAAY,CAAC;aAE1B,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC","sourcesContent":["import type { TConstValue } from '@/common/types';\n\nexport class SecretProviders {\n static readonly SYSTEM_ENVS = 'system-envs';\n static readonly HASHICORP_VAULT = 'hashicorp-vault';\n static readonly DOTENV_VAULT = 'dotenv-vault';\n\n static readonly SCHEME_SET = new Set([this.SYSTEM_ENVS, this.HASHICORP_VAULT, this.DOTENV_VAULT]);\n\n static isValid(value: string): value is TSecretProvider {\n return this.SCHEME_SET.has(value);\n }\n}\n\nexport type TSecretProvider = TConstValue<typeof SecretProviders>;\n\nexport class VaultAuthMethods {\n static readonly TOKEN = 'token';\n static readonly APP_ROLE = 'app-role';\n static readonly KUBERNETES = 'kubernetes';\n\n static readonly SCHEME_SET = new Set([this.TOKEN, this.APP_ROLE, this.KUBERNETES]);\n\n static isValid(value: string): value is TVaultAuthMethod {\n return this.SCHEME_SET.has(value);\n }\n}\n\nexport type TVaultAuthMethod = TConstValue<typeof VaultAuthMethods>;\n"]}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/common/constants.ts"],"names":[],"mappings":"AAEA,yDAAyD;AACzD,MAAM,OAAO,eAAe;aACV,gBAAW,GAAG,aAAa,CAAC;aAC5B,oBAAe,GAAG,iBAAiB,CAAC;aACpC,iBAAY,GAAG,cAAc,CAAC;aAE9B,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;IAElG,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAMH,8CAA8C;AAC9C,MAAM,OAAO,gBAAgB;aACX,UAAK,GAAG,OAAO,CAAC;aAChB,aAAQ,GAAG,UAAU,CAAC;aACtB,eAAU,GAAG,YAAY,CAAC;aAE1B,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAEnF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC","sourcesContent":["import type { TConstValue } from '@/common/types';\n\n/** Secret backends a secrets registration can select. */\nexport class SecretProviders {\n static readonly SYSTEM_ENVS = 'system-envs';\n static readonly HASHICORP_VAULT = 'hashicorp-vault';\n static readonly DOTENV_VAULT = 'dotenv-vault';\n\n static readonly SCHEME_SET = new Set([this.SYSTEM_ENVS, this.HASHICORP_VAULT, this.DOTENV_VAULT]);\n\n static isValid(value: string): value is TSecretProvider {\n return this.SCHEME_SET.has(value);\n }\n}\n\n/** Union of the `SecretProviders` values. */\nexport type TSecretProvider = TConstValue<typeof SecretProviders>;\n\n/** Ways a Vault provider can authenticate. */\nexport class VaultAuthMethods {\n static readonly TOKEN = 'token';\n static readonly APP_ROLE = 'app-role';\n static readonly KUBERNETES = 'kubernetes';\n\n static readonly SCHEME_SET = new Set([this.TOKEN, this.APP_ROLE, this.KUBERNETES]);\n\n static isValid(value: string): value is TVaultAuthMethod {\n return this.SCHEME_SET.has(value);\n }\n}\n\n/** Union of the `VaultAuthMethods` values. */\nexport type TVaultAuthMethod = TConstValue<typeof VaultAuthMethods>;\n"]}
@@ -1,11 +1,13 @@
1
1
  import type { IConfigurable } from '../../../../common/types/index.js';
2
2
  import type { ISecretLease, ISecretRotatable, TSecretRotationHandler } from './lease.js';
3
3
  import type { IClock, ITimerAdapter } from './timer.js';
4
+ /** Selects a secret: the `path` of a bundle and optionally one `key` in it. `defaultValue` is returned when the key is absent. */
4
5
  export interface IGetSecretOptions<TValue = string> {
5
6
  path: string;
6
7
  key?: string;
7
8
  defaultValue?: TValue;
8
9
  }
10
+ /** Contract of a secrets provider: cached reads, dynamic leases with rotation handlers, and shutdown. */
9
11
  export interface ISecretsHelper extends IConfigurable {
10
12
  get<TValue = string>(opts: IGetSecretOptions<TValue>): Promise<TValue>;
11
13
  getBundle(opts: {
@@ -22,10 +24,21 @@ export interface ISecretsHelper extends IConfigurable {
22
24
  }): void;
23
25
  shutdown(): Promise<void>;
24
26
  }
27
+ /** Constructor options of a secrets provider. `clock` and `timers` can be replaced in tests. */
25
28
  export interface ISecretsHelperOptions {
26
29
  scope: string;
27
30
  identifier?: string;
31
+ /**
32
+ * TTL in seconds of the get/getBundle cache.
33
+ *
34
+ * @default 300
35
+ */
28
36
  cacheTtlSeconds?: number;
37
+ /**
38
+ * Renew a lease at ttl * ratio; must be within (0, 1].
39
+ *
40
+ * @default 0.66
41
+ */
29
42
  renewBeforeRatio?: number;
30
43
  clock?: IClock;
31
44
  timers?: ITimerAdapter;
@@ -1 +1 @@
1
- {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/secrets/common/types/helper.ts"],"names":[],"mappings":"","sourcesContent":["import type { IConfigurable } from '@/common/types';\nimport type { ISecretLease, ISecretRotatable, TSecretRotationHandler } from './lease';\nimport type { IClock, ITimerAdapter } from './timer';\n\nexport interface IGetSecretOptions<TValue = string> {\n path: string;\n key?: string;\n defaultValue?: TValue;\n}\n\nexport interface ISecretsHelper extends IConfigurable {\n get<TValue = string>(opts: IGetSecretOptions<TValue>): Promise<TValue>;\n getBundle(opts: { path: string }): Promise<Record<string, string>>;\n lease(opts: { path: string; key: string }): Promise<ISecretLease>;\n onRotate(handler: TSecretRotationHandler): void;\n registerRotatable(opts: { key: string; target: ISecretRotatable }): void;\n shutdown(): Promise<void>;\n}\n\nexport interface ISecretsHelperOptions {\n scope: string;\n identifier?: string;\n cacheTtlSeconds?: number;\n renewBeforeRatio?: number;\n clock?: IClock;\n timers?: ITimerAdapter;\n}\n"]}
1
+ {"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../../src/modules/secrets/common/types/helper.ts"],"names":[],"mappings":"","sourcesContent":["import type { IConfigurable } from '@/common/types';\nimport type { ISecretLease, ISecretRotatable, TSecretRotationHandler } from './lease';\nimport type { IClock, ITimerAdapter } from './timer';\n\n/** Selects a secret: the `path` of a bundle and optionally one `key` in it. `defaultValue` is returned when the key is absent. */\nexport interface IGetSecretOptions<TValue = string> {\n path: string;\n key?: string;\n defaultValue?: TValue;\n}\n\n/** Contract of a secrets provider: cached reads, dynamic leases with rotation handlers, and shutdown. */\nexport interface ISecretsHelper extends IConfigurable {\n get<TValue = string>(opts: IGetSecretOptions<TValue>): Promise<TValue>;\n getBundle(opts: { path: string }): Promise<Record<string, string>>;\n lease(opts: { path: string; key: string }): Promise<ISecretLease>;\n onRotate(handler: TSecretRotationHandler): void;\n registerRotatable(opts: { key: string; target: ISecretRotatable }): void;\n shutdown(): Promise<void>;\n}\n\n/** Constructor options of a secrets provider. `clock` and `timers` can be replaced in tests. */\nexport interface ISecretsHelperOptions {\n scope: string;\n identifier?: string;\n /**\n * TTL in seconds of the get/getBundle cache.\n *\n * @default 300\n */\n cacheTtlSeconds?: number;\n /**\n * Renew a lease at ttl * ratio; must be within (0, 1].\n *\n * @default 0.66\n */\n renewBeforeRatio?: number;\n clock?: IClock;\n timers?: ITimerAdapter;\n}\n"]}
@@ -6,10 +6,12 @@ export interface ISecretLease {
6
6
  ttlSeconds: number;
7
7
  renewable: boolean;
8
8
  }
9
+ /** Passed to rotation handlers: the `key` that rotated and its new lease. */
9
10
  export interface ISecretRotationEvent {
10
11
  key: string;
11
12
  lease: ISecretLease;
12
13
  }
14
+ /** Callback run when a leased secret is renewed with new values; may be async. */
13
15
  export type TSecretRotationHandler = (event: ISecretRotationEvent) => ValueOrPromise<void>;
14
16
  /** A live consumer (pool holder) that rebuilds gracefully when its secret rotates. */
15
17
  export interface ISecretRotatable {
@@ -1 +1 @@
1
- {"version":3,"file":"lease.js","sourceRoot":"","sources":["../../../../../../src/modules/secrets/common/types/lease.ts"],"names":[],"mappings":"","sourcesContent":["import type { ValueOrPromise } from '@/common/types';\n\n/** A dynamic, lease-bearing secret (e.g. Vault `database/creds/...`). */\nexport interface ISecretLease {\n value: Record<string, string>;\n leaseId: string;\n ttlSeconds: number;\n renewable: boolean;\n}\n\nexport interface ISecretRotationEvent {\n key: string;\n lease: ISecretLease;\n}\n\nexport type TSecretRotationHandler = (event: ISecretRotationEvent) => ValueOrPromise<void>;\n\n/** A live consumer (pool holder) that rebuilds gracefully when its secret rotates. */\nexport interface ISecretRotatable {\n onSecretRotated(opts: { key: string; secret: Record<string, string> }): Promise<void>;\n}\n"]}
1
+ {"version":3,"file":"lease.js","sourceRoot":"","sources":["../../../../../../src/modules/secrets/common/types/lease.ts"],"names":[],"mappings":"","sourcesContent":["import type { ValueOrPromise } from '@/common/types';\n\n/** A dynamic, lease-bearing secret (e.g. Vault `database/creds/...`). */\nexport interface ISecretLease {\n value: Record<string, string>;\n leaseId: string;\n ttlSeconds: number;\n renewable: boolean;\n}\n\n/** Passed to rotation handlers: the `key` that rotated and its new lease. */\nexport interface ISecretRotationEvent {\n key: string;\n lease: ISecretLease;\n}\n\n/** Callback run when a leased secret is renewed with new values; may be async. */\nexport type TSecretRotationHandler = (event: ISecretRotationEvent) => ValueOrPromise<void>;\n\n/** A live consumer (pool holder) that rebuilds gracefully when its secret rotates. */\nexport interface ISecretRotatable {\n onSecretRotated(opts: { key: string; secret: Record<string, string> }): Promise<void>;\n}\n"]}
@@ -1,24 +1,35 @@
1
1
  import type { AnyObject } from '../../../../common/types/index.js';
2
2
  import type { TSecretProvider } from '../constants.js';
3
+ /** A bundle at `path` to copy into environment variables; keys map by `prefix` or by explicit `keys`. */
3
4
  export interface ISecretHydrateEntry {
4
5
  path: string;
5
6
  prefix?: string;
6
7
  /** Explicit vaultKey -> envKey overrides. Takes precedence over `prefix`. */
7
8
  keys?: Record<string, string>;
8
9
  }
10
+ /** A leased secret at `path`, registered under the consumer binding `key`. */
9
11
  export interface ISecretLeaseEntry {
10
12
  /** Logical/binding key of the consuming datasource, e.g. 'datasources.postgres'. */
11
13
  key: string;
12
14
  path: string;
13
15
  }
16
+ /** Declares a secrets provider with the bundles to hydrate and the secrets to lease. */
14
17
  export interface ISecretsRegistration {
15
18
  provider: TSecretProvider;
16
19
  config?: AnyObject;
17
20
  hydrate?: Array<ISecretHydrateEntry>;
18
21
  lease?: Array<ISecretLeaseEntry>;
19
- /** Renew a lease at ttl * ratio. Default 0.66. */
22
+ /**
23
+ * Renew a lease at ttl * ratio.
24
+ *
25
+ * @default 0.66
26
+ */
20
27
  renewBeforeRatio?: number;
21
- /** TTL (seconds) for the static get/getBundle cache. Default 300. */
28
+ /**
29
+ * TTL (seconds) for the static get/getBundle cache.
30
+ *
31
+ * @default 300
32
+ */
22
33
  cacheTtlSeconds?: number;
23
34
  }
24
35
  //# sourceMappingURL=registration.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"registration.js","sourceRoot":"","sources":["../../../../../../src/modules/secrets/common/types/registration.ts"],"names":[],"mappings":"","sourcesContent":["import type { AnyObject } from '@/common/types';\nimport type { TSecretProvider } from '../constants';\n\nexport interface ISecretHydrateEntry {\n path: string;\n prefix?: string;\n /** Explicit vaultKey -> envKey overrides. Takes precedence over `prefix`. */\n keys?: Record<string, string>;\n}\n\nexport interface ISecretLeaseEntry {\n /** Logical/binding key of the consuming datasource, e.g. 'datasources.postgres'. */\n key: string;\n path: string;\n}\n\nexport interface ISecretsRegistration {\n provider: TSecretProvider;\n config?: AnyObject;\n hydrate?: Array<ISecretHydrateEntry>;\n lease?: Array<ISecretLeaseEntry>;\n /** Renew a lease at ttl * ratio. Default 0.66. */\n renewBeforeRatio?: number;\n /** TTL (seconds) for the static get/getBundle cache. Default 300. */\n cacheTtlSeconds?: number;\n}\n"]}
1
+ {"version":3,"file":"registration.js","sourceRoot":"","sources":["../../../../../../src/modules/secrets/common/types/registration.ts"],"names":[],"mappings":"","sourcesContent":["import type { AnyObject } from '@/common/types';\nimport type { TSecretProvider } from '../constants';\n\n/** A bundle at `path` to copy into environment variables; keys map by `prefix` or by explicit `keys`. */\nexport interface ISecretHydrateEntry {\n path: string;\n prefix?: string;\n /** Explicit vaultKey -> envKey overrides. Takes precedence over `prefix`. */\n keys?: Record<string, string>;\n}\n\n/** A leased secret at `path`, registered under the consumer binding `key`. */\nexport interface ISecretLeaseEntry {\n /** Logical/binding key of the consuming datasource, e.g. 'datasources.postgres'. */\n key: string;\n path: string;\n}\n\n/** Declares a secrets provider with the bundles to hydrate and the secrets to lease. */\nexport interface ISecretsRegistration {\n provider: TSecretProvider;\n config?: AnyObject;\n hydrate?: Array<ISecretHydrateEntry>;\n lease?: Array<ISecretLeaseEntry>;\n /**\n * Renew a lease at ttl * ratio.\n *\n * @default 0.66\n */\n renewBeforeRatio?: number;\n /**\n * TTL (seconds) for the static get/getBundle cache.\n *\n * @default 300\n */\n cacheTtlSeconds?: number;\n}\n"]}
@@ -2,6 +2,7 @@
2
2
  export interface IClock {
3
3
  now(): number;
4
4
  }
5
+ /** Opaque handle returned by `ITimerAdapter.set`. */
5
6
  export type TTimerHandle = ReturnType<typeof setTimeout> | number | object;
6
7
  /** Injectable timer seam so tests fire renewals without real waits. */
7
8
  export interface ITimerAdapter {
@@ -1 +1 @@
1
- {"version":3,"file":"timer.js","sourceRoot":"","sources":["../../../../../../src/modules/secrets/common/types/timer.ts"],"names":[],"mappings":"","sourcesContent":["/** Injectable clock so tests advance time deterministically. */\nexport interface IClock {\n now(): number;\n}\n\nexport type TTimerHandle = ReturnType<typeof setTimeout> | number | object;\n\n/** Injectable timer seam so tests fire renewals without real waits. */\nexport interface ITimerAdapter {\n set(handler: () => void, ms: number): TTimerHandle;\n clear(handle: TTimerHandle): void;\n}\n"]}
1
+ {"version":3,"file":"timer.js","sourceRoot":"","sources":["../../../../../../src/modules/secrets/common/types/timer.ts"],"names":[],"mappings":"","sourcesContent":["/** Injectable clock so tests advance time deterministically. */\nexport interface IClock {\n now(): number;\n}\n\n/** Opaque handle returned by `ITimerAdapter.set`. */\nexport type TTimerHandle = ReturnType<typeof setTimeout> | number | object;\n\n/** Injectable timer seam so tests fire renewals without real waits. */\nexport interface ITimerAdapter {\n set(handler: () => void, ms: number): TTimerHandle;\n clear(handle: TTimerHandle): void;\n}\n"]}
@@ -1,9 +1,16 @@
1
1
  import { AbstractSecretsHelper } from '../base/index.js';
2
2
  import type { IClock, ISecretLease, ITimerAdapter } from '../common/index.js';
3
+ /** Options for `DotenvVaultHelper`. `dotenvKey` is the decryption key passed to dotenvx when set. */
3
4
  export interface IDotenvVaultHelperOptions {
5
+ /** @default '.env.vault' */
4
6
  path?: string;
5
7
  dotenvKey?: string;
6
8
  identifier?: string;
9
+ /**
10
+ * TTL in seconds of the get/getBundle cache.
11
+ *
12
+ * @default 300
13
+ */
7
14
  cacheTtlSeconds?: number;
8
15
  clock?: IClock;
9
16
  timers?: ITimerAdapter;
@@ -13,6 +20,7 @@ export interface IDotenvVaultHelperOptions {
13
20
  dotenvKey?: string;
14
21
  }) => Record<string, string>;
15
22
  }
23
+ /** Secrets provider that decrypts a dotenv vault file with `@dotenvx/dotenvx` and serves its entries. Dynamic leases are not supported: `lease()` throws. */
16
24
  export declare class DotenvVaultHelper extends AbstractSecretsHelper {
17
25
  private readonly path;
18
26
  private readonly dotenvKey?;
@@ -1,6 +1,7 @@
1
1
  import { getError } from '../../error/index.js';
2
2
  import { ModuleUtility } from '../../../utilities/module.utility.js';
3
3
  import { AbstractSecretsHelper } from '../base/index.js';
4
+ /** Secrets provider that decrypts a dotenv vault file with `@dotenvx/dotenvx` and serves its entries. Dynamic leases are not supported: `lease()` throws. */
4
5
  export class DotenvVaultHelper extends AbstractSecretsHelper {
5
6
  constructor(opts) {
6
7
  super({
@@ -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;AAqBhD,6JAA6J;AAC7J,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\n/** Options for `DotenvVaultHelper`. `dotenvKey` is the decryption key passed to dotenvx when set. */\nexport interface IDotenvVaultHelperOptions {\n /** @default '.env.vault' */\n path?: string;\n dotenvKey?: string;\n identifier?: string;\n /**\n * TTL in seconds of the get/getBundle cache.\n *\n * @default 300\n */\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\n/** Secrets provider that decrypts a dotenv vault file with `@dotenvx/dotenvx` and serves its entries. Dynamic leases are not supported: `lease()` throws. */\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,4 +1,5 @@
1
1
  import { type ISecretsHelper, type ISecretsRegistration } from './common/index.js';
2
+ /** Builds the `ISecretsHelper` for a registration by its `provider`. Throws when the provider is unknown, or when the provider package is neither installed, registered, nor injected through the config. */
2
3
  export declare class SecretsHelperFactory {
3
4
  static create(opts: ISecretsRegistration & {
4
5
  identifier?: string;
@@ -6,6 +6,7 @@ import { HashiCorpVaultHelper } from './hashicorp/index.js';
6
6
  import { SystemEnvsHelper } from './system-envs/index.js';
7
7
  // 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`.
8
8
  // 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.
9
+ /** Builds the `ISecretsHelper` for a registration by its `provider`. Throws when the provider is unknown, or when the provider package is neither installed, registered, nor injected through the config. */
9
10
  export class SecretsHelperFactory {
10
11
  static async create(opts) {
11
12
  const shared = {
@@ -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,6MAA6M;AAC7M,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.\n/** Builds the `ISecretsHelper` for a registration by its `provider`. Throws when the provider is unknown, or when the provider package is neither installed, registered, nor injected through the config. */\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"]}
@@ -1,4 +1,5 @@
1
1
  import { z } from 'zod';
2
+ /** Validates the Vault login config; `method` selects the token, AppRole or Kubernetes shape. */
2
3
  export declare const vaultAuthSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
3
4
  method: z.ZodLiteral<"token">;
4
5
  token: z.ZodString;
@@ -13,5 +14,6 @@ export declare const vaultAuthSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
13
14
  jwtPath: z.ZodOptional<z.ZodString>;
14
15
  mountPath: z.ZodOptional<z.ZodString>;
15
16
  }, z.core.$strip>], "method">;
17
+ /** A validated Vault login config, discriminated by `method`. */
16
18
  export type TVaultAuth = z.infer<typeof vaultAuthSchema>;
17
19
  //# sourceMappingURL=auth.d.ts.map
@@ -1,5 +1,6 @@
1
1
  import { z } from 'zod';
2
2
  import { VaultAuthMethods } from '../common/index.js';
3
+ /** Validates the Vault login config; `method` selects the token, AppRole or Kubernetes shape. */
3
4
  export const vaultAuthSchema = z.discriminatedUnion('method', [
4
5
  z.object({ method: z.literal(VaultAuthMethods.TOKEN), token: z.string() }),
5
6
  z.object({
@@ -1 +1 @@
1
- {"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/hashicorp/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IAC5D,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC1E,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC;QAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC;QAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { VaultAuthMethods } from '../common';\n\nexport const vaultAuthSchema = z.discriminatedUnion('method', [\n z.object({ method: z.literal(VaultAuthMethods.TOKEN), token: z.string() }),\n z.object({\n method: z.literal(VaultAuthMethods.APP_ROLE),\n roleId: z.string(),\n secretId: z.string(),\n mountPath: z.string().optional(),\n }),\n z.object({\n method: z.literal(VaultAuthMethods.KUBERNETES),\n role: z.string(),\n jwtPath: z.string().optional(),\n mountPath: z.string().optional(),\n }),\n]);\n\nexport type TVaultAuth = z.infer<typeof vaultAuthSchema>;\n"]}
1
+ {"version":3,"file":"auth.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/hashicorp/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,iGAAiG;AACjG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE;IAC5D,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC;IAC1E,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,CAAC;QAC5C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;QAClB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;QACpB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC;IACF,CAAC,CAAC,MAAM,CAAC;QACP,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC;QAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACjC,CAAC;CACH,CAAC,CAAC","sourcesContent":["import { z } from 'zod';\nimport { VaultAuthMethods } from '../common';\n\n/** Validates the Vault login config; `method` selects the token, AppRole or Kubernetes shape. */\nexport const vaultAuthSchema = z.discriminatedUnion('method', [\n z.object({ method: z.literal(VaultAuthMethods.TOKEN), token: z.string() }),\n z.object({\n method: z.literal(VaultAuthMethods.APP_ROLE),\n roleId: z.string(),\n secretId: z.string(),\n mountPath: z.string().optional(),\n }),\n z.object({\n method: z.literal(VaultAuthMethods.KUBERNETES),\n role: z.string(),\n jwtPath: z.string().optional(),\n mountPath: z.string().optional(),\n }),\n]);\n\n/** A validated Vault login config, discriminated by `method`. */\nexport type TVaultAuth = z.infer<typeof vaultAuthSchema>;\n"]}
@@ -11,6 +11,7 @@ interface TVaultClient {
11
11
  tokenRenewSelf(): Promise<AnyType>;
12
12
  tokenLookupSelf(): Promise<AnyType>;
13
13
  }
14
+ /** Options for `HashiCorpVaultHelper`. `auth` is validated on construction; `client` replaces the `node-vault` client the helper would otherwise create. */
14
15
  export interface IHashiCorpVaultHelperOptions {
15
16
  endpoint: string;
16
17
  auth: TVaultAuth;
@@ -22,6 +23,7 @@ export interface IHashiCorpVaultHelperOptions {
22
23
  /** Injection seam for tests; production builds the real node-vault client in configure(). */
23
24
  client?: TVaultClient;
24
25
  }
26
+ /** Secrets provider backed by HashiCorp Vault via `node-vault`. `configure()` must run before use; it logs in and schedules renewal of the Vault token when the token is renewable. */
25
27
  export declare class HashiCorpVaultHelper extends AbstractSecretsHelper {
26
28
  private static readonly TOKEN_RENEWAL_RETRY_BASE_SECONDS;
27
29
  private static readonly TOKEN_RENEWAL_RETRY_CAP_SECONDS;
@@ -4,6 +4,7 @@ import { ModuleUtility } from '../../../utilities/module.utility.js';
4
4
  import { AbstractSecretsHelper } from '../base/index.js';
5
5
  import { VaultAuthMethods } from '../common/index.js';
6
6
  import { vaultAuthSchema } from './auth.js';
7
+ /** Secrets provider backed by HashiCorp Vault via `node-vault`. `configure()` must run before use; it logs in and schedules renewal of the Vault token when the token is renewable. */
7
8
  export class HashiCorpVaultHelper extends AbstractSecretsHelper {
8
9
  static { this.TOKEN_RENEWAL_RETRY_BASE_SECONDS = 1; }
9
10
  static { this.TOKEN_RENEWAL_RETRY_CAP_SECONDS = 60; }
@@ -1 +1 @@
1
- {"version":3,"file":"hashicorp.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/hashicorp/hashicorp.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAsD,MAAM,WAAW,CAAC;AACjG,OAAO,EAAE,eAAe,EAAmB,MAAM,QAAQ,CAAC;AAyB1D,MAAM,OAAO,oBAAqB,SAAQ,qBAAqB;aACrC,qCAAgC,GAAG,CAAC,AAAJ,CAAK;aACrC,oCAA+B,GAAG,EAAE,AAAL,CAAM;IAQ7D,YAAY,IAAkC;QAC5C,KAAK,CAAC;YACJ,KAAK,EAAE,oBAAoB,CAAC,IAAI;YAChC,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;QAVG,2BAAsB,GAAG,CAAC,CAAC;QAWjC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,6DACP,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CACvD,EAAE;aACH,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;IAEQ,KAAK,CAAC,SAAS;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAU,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;YAC3E,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC/B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,EAAE,CAAiB,CAAC;QACvF,CAAC;QACD,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QACrD,IAAI,SAAS,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,iDAAiD,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAClG,CAAC;IAEQ,KAAK,CAAC,QAAQ;QACrB,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACnC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;QACD,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAC;IACzB,CAAC;IAEO,aAAa;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,wDAAwD,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,2HAA2H;IACnH,KAAK,CAAC,KAAK;QACjB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;QAEpC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACzB,KAAK,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC;gBAC3C,OAAO;oBACL,UAAU,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;oBAC3C,SAAS,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC;iBAC7C,CAAC;YACJ,CAAC;YACD,KAAK,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC/B,MAAM,OAAO,GAAc,EAAE,CAAC;gBAC9B,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;gBACtC,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC;gBAC1C,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC;gBAC1D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;gBAC/C,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBACxC,OAAO;oBACL,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;oBACnD,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;iBAC1C,CAAC;YACJ,CAAC;YACD,KAAK,gBAAgB,CAAC,UAAU,CAAC,CAAC,CAAC;gBACjC,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;oBAC5B,MAAM,QAAQ,CAAC;wBACb,OAAO,EAAE,sEAAsE;qBAChF,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,qDAAqD,EAC1E,MAAM,CACP,CAAC;gBACF,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAc,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;gBACzD,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC;gBAC7D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;gBAClD,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;gBACxC,OAAO;oBACL,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;oBACnD,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;iBAC1C,CAAC;YACJ,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,sDAAsD,EAAE,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;IACH,CAAC;IAEO,oBAAoB,CAAC,IAA4B;QACvD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;QAC5E,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxC,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC;qBACnC,KAAK,CAAC,2CAA2C,EAAE,KAAK,CAAC,CAAC;YAC/D,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,OAAO,CAAC,CAAC;IACd,CAAC;IAED,gLAAgL;IACxK,yBAAyB;QAC/B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,sBAAsB,IAAI,CAAC,CAAC;QACjC,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAC7B,oBAAoB,CAAC,+BAA+B,EACpD,oBAAoB,CAAC,gCAAgC;YACnD,CAAC,IAAI,CAAC,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC,CACzC,CAAC;QACF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE;YACrC,IAAI,CAAC,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACxC,IAAI,CAAC,MAAM;qBACR,GAAG,CAAC,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC;qBACxC,KAAK,CAAC,iDAAiD,EAAE,KAAK,CAAC,CAAC;YACrE,CAAC,CAAC,CAAC;QACL,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC,CAAC;IAC5B,CAAC;IAEO,KAAK,CAAC,kBAAkB;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAE7D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,cAAc,EAAE,CAAC;YACxD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;YACpD,IAAI,SAAS,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC;gBAChC,IAAI,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;gBAC1C,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;QACzF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,qDAAqD,EAAE,KAAK,CAAC,CAAC;QAC5E,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACrD,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC;YAChC,IAAI,SAAS,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;gBAChC,IAAI,CAAC,oBAAoB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,sEAAsE,EAAE,KAAK,CAAC,CAAC;YAC5F,IAAI,CAAC,yBAAyB,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAES,KAAK,CAAC,QAAQ,CAAC,IAAsB;QAC7C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;QAC5E,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,YAAY,EAAE,CAAC;YACtC,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACnE,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;QAClC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO;gBACL,KAAK;gBACL,KAAK,EAAE;oBACL,OAAO;oBACP,UAAU,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,CAAC;oBACtC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;iBACrC;aACF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAES,KAAK,CAAC,QAAQ,CAAC,IAA6C;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,OAAO,GAAc,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;YAC1D,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;YACnC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YAC1E,OAAO,EAAE,UAAU,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7E,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,IAAyB;QACjD,MAAM,OAAO,GAAc,EAAE,CAAC;QAC9B,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACnC,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,mBAAmB,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { AnyObject, AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { AbstractSecretsHelper } from '../base';\nimport { VaultAuthMethods, type IClock, type ITimerAdapter, type TTimerHandle } from '../common';\nimport { vaultAuthSchema, type TVaultAuth } from './auth';\n\n// node-vault's wire contract uses snake_case (role_id, secret_id, client_token, lease_duration, ...); built/read via bracket-notation on AnyObject here so the snake_case stays confined to this boundary instead of leaking into our camelCase-only typing convention.\ninterface TVaultClient {\n token: string;\n read(path: string): Promise<AnyType>;\n write(path: string, data: AnyObject): Promise<AnyType>;\n approleLogin(opts: AnyObject): Promise<AnyType>;\n kubernetesLogin?(opts: AnyObject): Promise<AnyType>;\n tokenRenewSelf(): Promise<AnyType>;\n tokenLookupSelf(): Promise<AnyType>;\n}\n\nexport interface IHashiCorpVaultHelperOptions {\n endpoint: string;\n auth: TVaultAuth;\n identifier?: string;\n cacheTtlSeconds?: number;\n renewBeforeRatio?: number;\n clock?: IClock;\n timers?: ITimerAdapter;\n /** Injection seam for tests; production builds the real node-vault client in configure(). */\n client?: TVaultClient;\n}\n\nexport class HashiCorpVaultHelper extends AbstractSecretsHelper {\n private static readonly TOKEN_RENEWAL_RETRY_BASE_SECONDS = 1;\n private static readonly TOKEN_RENEWAL_RETRY_CAP_SECONDS = 60;\n\n private readonly endpoint: string;\n private readonly auth: TVaultAuth;\n private client?: TVaultClient;\n private tokenTimer?: TTimerHandle;\n private tokenRenewalRetryCount = 0;\n\n constructor(opts: IHashiCorpVaultHelperOptions) {\n super({\n scope: HashiCorpVaultHelper.name,\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n renewBeforeRatio: opts.renewBeforeRatio,\n clock: opts.clock,\n timers: opts.timers,\n });\n this.endpoint = opts.endpoint;\n try {\n this.auth = vaultAuthSchema.parse(opts.auth);\n } catch (error) {\n throw getError({\n message: `[HashiCorpVaultHelper] Invalid Vault auth configuration | ${\n error instanceof Error ? error.message : String(error)\n }`,\n });\n }\n this.client = opts.client;\n }\n\n override async configure(): Promise<void> {\n const logger = this.logger.for(this.configure.name);\n if (!this.client) {\n const result = await ModuleUtility.load<AnyType>({ module: 'node-vault' });\n const factory = result.default;\n this.client = factory({ endpoint: this.endpoint, apiVersion: 'v1' }) as TVaultClient;\n }\n const { ttlSeconds, renewable } = await this.login();\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n logger.info('Vault authenticated | endpoint: %s | method: %s', this.endpoint, this.auth.method);\n }\n\n override async shutdown(): Promise<void> {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n this.tokenTimer = undefined;\n }\n await super.shutdown();\n }\n\n private requireClient(): TVaultClient {\n if (!this.client) {\n throw getError({ message: '[HashiCorpVaultHelper] configure() must run before use' });\n }\n return this.client;\n }\n\n /** Authenticates against Vault and returns the resulting token's TTL/renewability so callers can schedule self-renewal. */\n private async login(): Promise<{ ttlSeconds: number; renewable: boolean }> {\n const client = this.requireClient();\n\n switch (this.auth.method) {\n case VaultAuthMethods.TOKEN: {\n client.token = this.auth.token;\n const res = await client.tokenLookupSelf();\n return {\n ttlSeconds: Number(res?.data?.['ttl'] ?? 0),\n renewable: Boolean(res?.data?.['renewable']),\n };\n }\n case VaultAuthMethods.APP_ROLE: {\n const payload: AnyObject = {};\n payload['role_id'] = this.auth.roleId;\n payload['secret_id'] = this.auth.secretId;\n payload['mount_point'] = this.auth.mountPath ?? 'approle';\n const res = await client.approleLogin(payload);\n client.token = res.auth['client_token'];\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n case VaultAuthMethods.KUBERNETES: {\n if (!client.kubernetesLogin) {\n throw getError({\n message: '[HashiCorpVaultHelper.login] node-vault client lacks kubernetesLogin',\n });\n }\n const result = await readFile(\n this.auth.jwtPath ?? '/var/run/secrets/kubernetes.io/serviceaccount/token',\n 'utf8',\n );\n const jwt = result.trimEnd();\n const payload: AnyObject = { role: this.auth.role, jwt };\n payload['mount_point'] = this.auth.mountPath ?? 'kubernetes';\n const res = await client.kubernetesLogin(payload);\n client.token = res.auth['client_token'];\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n default: {\n throw getError({ message: '[HashiCorpVaultHelper.login] Unsupported auth method' });\n }\n }\n }\n\n private scheduleTokenRenewal(opts: { ttlSeconds: number }): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n const delayMs = Math.max(0, opts.ttlSeconds * this.renewBeforeRatio * 1000);\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch((error) => {\n this.logger\n .for(this.scheduleTokenRenewal.name)\n .error('Token renewal handler crashed | error: %s', error);\n });\n }, delayMs);\n }\n\n /** Without a reschedule here, a transient re-auth failure lets the token expire silently with no recovery - retry with the same capped exponential backoff as lease renewal. */\n private scheduleTokenRenewalRetry(): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n this.tokenRenewalRetryCount += 1;\n const backoffSeconds = Math.min(\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_CAP_SECONDS,\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_BASE_SECONDS *\n 2 ** (this.tokenRenewalRetryCount - 1),\n );\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch((error) => {\n this.logger\n .for(this.scheduleTokenRenewalRetry.name)\n .error('Token renewal retry handler crashed | error: %s', error);\n });\n }, backoffSeconds * 1000);\n }\n\n private async handleTokenRenewal(): Promise<void> {\n const logger = this.logger.for(this.handleTokenRenewal.name);\n\n try {\n const res = await this.requireClient().tokenRenewSelf();\n const ttlSeconds = Number(res?.auth?.['lease_duration'] ?? 0);\n const renewable = Boolean(res?.auth?.['renewable']);\n if (renewable && ttlSeconds > 0) {\n this.tokenRenewalRetryCount = 0;\n this.scheduleTokenRenewal({ ttlSeconds });\n return;\n }\n logger.warn('Token renewal returned a non-renewable/expired token; re-authenticating');\n } catch (error) {\n logger.warn('Token renewal failed; re-authenticating | error: %s', error);\n }\n\n try {\n const { ttlSeconds, renewable } = await this.login();\n this.tokenRenewalRetryCount = 0;\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n } catch (error) {\n logger.error('Token re-authentication failed; scheduling bounded retry | error: %s', error);\n this.scheduleTokenRenewalRetry();\n }\n }\n\n protected async fetchRaw(opts: { path: string }) {\n const res = await this.requireClient().read(opts.path);\n const nested = res?.['data']?.['data'];\n const inner = nested && typeof nested === 'object' ? nested : res?.['data'];\n const value: Record<string, string> = {};\n const innerEntries = Object.entries(inner ?? {});\n for (const [key, raw] of innerEntries) {\n value[key] = typeof raw === 'string' ? raw : JSON.stringify(raw);\n }\n const leaseId = res?.['lease_id'];\n if (leaseId) {\n return {\n value,\n lease: {\n leaseId,\n ttlSeconds: res['lease_duration'] ?? 0,\n renewable: Boolean(res['renewable']),\n },\n };\n }\n return { value };\n }\n\n protected async renewRaw(opts: { leaseId: string; ttlSeconds: number }) {\n const logger = this.logger.for(this.renewRaw.name);\n try {\n const payload: AnyObject = { increment: opts.ttlSeconds };\n payload['lease_id'] = opts.leaseId;\n const res = await this.requireClient().write('sys/leases/renew', payload);\n return { ttlSeconds: res['lease_duration'] ?? opts.ttlSeconds };\n } catch (error) {\n logger.warn('Renew rejected | leaseId: %s | error: %s', opts.leaseId, error);\n return null;\n }\n }\n\n protected async revokeRaw(opts: { leaseId: string }) {\n const payload: AnyObject = {};\n payload['lease_id'] = opts.leaseId;\n await this.requireClient().write('sys/leases/revoke', payload);\n }\n}\n"]}
1
+ {"version":3,"file":"hashicorp.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/hashicorp/hashicorp.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport type { AnyObject, AnyType } from '@/common/types';\nimport { getError } from '@/modules/error';\nimport { ModuleUtility } from '@/utilities/module.utility';\nimport { AbstractSecretsHelper } from '../base';\nimport { VaultAuthMethods, type IClock, type ITimerAdapter, type TTimerHandle } from '../common';\nimport { vaultAuthSchema, type TVaultAuth } from './auth';\n\n// node-vault's wire contract uses snake_case (role_id, secret_id, client_token, lease_duration, ...); built/read via bracket-notation on AnyObject here so the snake_case stays confined to this boundary instead of leaking into our camelCase-only typing convention.\ninterface TVaultClient {\n token: string;\n read(path: string): Promise<AnyType>;\n write(path: string, data: AnyObject): Promise<AnyType>;\n approleLogin(opts: AnyObject): Promise<AnyType>;\n kubernetesLogin?(opts: AnyObject): Promise<AnyType>;\n tokenRenewSelf(): Promise<AnyType>;\n tokenLookupSelf(): Promise<AnyType>;\n}\n\n/** Options for `HashiCorpVaultHelper`. `auth` is validated on construction; `client` replaces the `node-vault` client the helper would otherwise create. */\nexport interface IHashiCorpVaultHelperOptions {\n endpoint: string;\n auth: TVaultAuth;\n identifier?: string;\n cacheTtlSeconds?: number;\n renewBeforeRatio?: number;\n clock?: IClock;\n timers?: ITimerAdapter;\n /** Injection seam for tests; production builds the real node-vault client in configure(). */\n client?: TVaultClient;\n}\n\n/** Secrets provider backed by HashiCorp Vault via `node-vault`. `configure()` must run before use; it logs in and schedules renewal of the Vault token when the token is renewable. */\nexport class HashiCorpVaultHelper extends AbstractSecretsHelper {\n private static readonly TOKEN_RENEWAL_RETRY_BASE_SECONDS = 1;\n private static readonly TOKEN_RENEWAL_RETRY_CAP_SECONDS = 60;\n\n private readonly endpoint: string;\n private readonly auth: TVaultAuth;\n private client?: TVaultClient;\n private tokenTimer?: TTimerHandle;\n private tokenRenewalRetryCount = 0;\n\n constructor(opts: IHashiCorpVaultHelperOptions) {\n super({\n scope: HashiCorpVaultHelper.name,\n identifier: opts.identifier,\n cacheTtlSeconds: opts.cacheTtlSeconds,\n renewBeforeRatio: opts.renewBeforeRatio,\n clock: opts.clock,\n timers: opts.timers,\n });\n this.endpoint = opts.endpoint;\n\n try {\n this.auth = vaultAuthSchema.parse(opts.auth);\n } catch (error) {\n throw getError({\n message: `[HashiCorpVaultHelper] Invalid Vault auth configuration | ${\n error instanceof Error ? error.message : String(error)\n }`,\n });\n }\n\n this.client = opts.client;\n }\n\n override async configure(): Promise<void> {\n const logger = this.logger.for(this.configure.name);\n\n if (!this.client) {\n const result = await ModuleUtility.load<AnyType>({ module: 'node-vault' });\n const factory = result.default;\n this.client = factory({ endpoint: this.endpoint, apiVersion: 'v1' }) as TVaultClient;\n }\n\n const { ttlSeconds, renewable } = await this.login();\n\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n\n logger.info('Vault authenticated | endpoint: %s | method: %s', this.endpoint, this.auth.method);\n }\n\n override async shutdown(): Promise<void> {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n this.tokenTimer = undefined;\n }\n\n await super.shutdown();\n }\n\n private requireClient(): TVaultClient {\n if (!this.client) {\n throw getError({ message: '[HashiCorpVaultHelper] configure() must run before use' });\n }\n\n return this.client;\n }\n\n /** Authenticates against Vault and returns the resulting token's TTL/renewability so callers can schedule self-renewal. */\n private async login(): Promise<{ ttlSeconds: number; renewable: boolean }> {\n const client = this.requireClient();\n\n switch (this.auth.method) {\n case VaultAuthMethods.TOKEN: {\n client.token = this.auth.token;\n const res = await client.tokenLookupSelf();\n\n return {\n ttlSeconds: Number(res?.data?.['ttl'] ?? 0),\n renewable: Boolean(res?.data?.['renewable']),\n };\n }\n case VaultAuthMethods.APP_ROLE: {\n const payload: AnyObject = {};\n payload['role_id'] = this.auth.roleId;\n payload['secret_id'] = this.auth.secretId;\n payload['mount_point'] = this.auth.mountPath ?? 'approle';\n const res = await client.approleLogin(payload);\n client.token = res.auth['client_token'];\n\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n case VaultAuthMethods.KUBERNETES: {\n if (!client.kubernetesLogin) {\n throw getError({\n message: '[HashiCorpVaultHelper.login] node-vault client lacks kubernetesLogin',\n });\n }\n\n const result = await readFile(\n this.auth.jwtPath ?? '/var/run/secrets/kubernetes.io/serviceaccount/token',\n 'utf8',\n );\n const jwt = result.trimEnd();\n const payload: AnyObject = { role: this.auth.role, jwt };\n payload['mount_point'] = this.auth.mountPath ?? 'kubernetes';\n const res = await client.kubernetesLogin(payload);\n client.token = res.auth['client_token'];\n\n return {\n ttlSeconds: Number(res.auth['lease_duration'] ?? 0),\n renewable: Boolean(res.auth['renewable']),\n };\n }\n default: {\n throw getError({ message: '[HashiCorpVaultHelper.login] Unsupported auth method' });\n }\n }\n }\n\n private scheduleTokenRenewal(opts: { ttlSeconds: number }): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n\n const delayMs = Math.max(0, opts.ttlSeconds * this.renewBeforeRatio * 1000);\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch((error) => {\n this.logger\n .for(this.scheduleTokenRenewal.name)\n .error('Token renewal handler crashed | error: %s', error);\n });\n }, delayMs);\n }\n\n /** Without a reschedule here, a transient re-auth failure lets the token expire silently with no recovery - retry with the same capped exponential backoff as lease renewal. */\n private scheduleTokenRenewalRetry(): void {\n if (this.tokenTimer) {\n this.timers.clear(this.tokenTimer);\n }\n\n this.tokenRenewalRetryCount += 1;\n const backoffSeconds = Math.min(\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_CAP_SECONDS,\n HashiCorpVaultHelper.TOKEN_RENEWAL_RETRY_BASE_SECONDS *\n 2 ** (this.tokenRenewalRetryCount - 1),\n );\n this.tokenTimer = this.timers.set(() => {\n this.handleTokenRenewal().catch((error) => {\n this.logger\n .for(this.scheduleTokenRenewalRetry.name)\n .error('Token renewal retry handler crashed | error: %s', error);\n });\n }, backoffSeconds * 1000);\n }\n\n private async handleTokenRenewal(): Promise<void> {\n const logger = this.logger.for(this.handleTokenRenewal.name);\n\n try {\n const res = await this.requireClient().tokenRenewSelf();\n const ttlSeconds = Number(res?.auth?.['lease_duration'] ?? 0);\n const renewable = Boolean(res?.auth?.['renewable']);\n\n if (renewable && ttlSeconds > 0) {\n this.tokenRenewalRetryCount = 0;\n this.scheduleTokenRenewal({ ttlSeconds });\n\n return;\n }\n\n logger.warn('Token renewal returned a non-renewable/expired token; re-authenticating');\n } catch (error) {\n logger.warn('Token renewal failed; re-authenticating | error: %s', error);\n }\n\n try {\n const { ttlSeconds, renewable } = await this.login();\n this.tokenRenewalRetryCount = 0;\n\n if (renewable && ttlSeconds > 0) {\n this.scheduleTokenRenewal({ ttlSeconds });\n }\n } catch (error) {\n logger.error('Token re-authentication failed; scheduling bounded retry | error: %s', error);\n this.scheduleTokenRenewalRetry();\n }\n }\n\n protected async fetchRaw(opts: { path: string }) {\n const res = await this.requireClient().read(opts.path);\n const nested = res?.['data']?.['data'];\n const inner = nested && typeof nested === 'object' ? nested : res?.['data'];\n const value: Record<string, string> = {};\n const innerEntries = Object.entries(inner ?? {});\n\n for (const [key, raw] of innerEntries) {\n value[key] = typeof raw === 'string' ? raw : JSON.stringify(raw);\n }\n\n const leaseId = res?.['lease_id'];\n\n if (leaseId) {\n return {\n value,\n lease: {\n leaseId,\n ttlSeconds: res['lease_duration'] ?? 0,\n renewable: Boolean(res['renewable']),\n },\n };\n }\n\n return { value };\n }\n\n protected async renewRaw(opts: { leaseId: string; ttlSeconds: number }) {\n const logger = this.logger.for(this.renewRaw.name);\n\n try {\n const payload: AnyObject = { increment: opts.ttlSeconds };\n payload['lease_id'] = opts.leaseId;\n const res = await this.requireClient().write('sys/leases/renew', payload);\n\n return { ttlSeconds: res['lease_duration'] ?? opts.ttlSeconds };\n } catch (error) {\n logger.warn('Renew rejected | leaseId: %s | error: %s', opts.leaseId, error);\n\n return null;\n }\n }\n\n protected async revokeRaw(opts: { leaseId: string }) {\n const payload: AnyObject = {};\n payload['lease_id'] = opts.leaseId;\n await this.requireClient().write('sys/leases/revoke', payload);\n }\n}\n"]}
@@ -1,5 +1,6 @@
1
1
  import { AbstractSecretsHelper } from '../base/index.js';
2
2
  import type { IClock, ISecretLease, ITimerAdapter } from '../common/index.js';
3
+ /** Secrets provider that serves the current `process.env` entries. Dynamic leases are not supported: `lease()` throws. */
3
4
  export declare class SystemEnvsHelper extends AbstractSecretsHelper {
4
5
  constructor(opts: {
5
6
  identifier?: string;
@@ -1,5 +1,6 @@
1
1
  import { getError } from '../../error/index.js';
2
2
  import { AbstractSecretsHelper } from '../base/index.js';
3
+ /** Secrets provider that serves the current `process.env` entries. Dynamic leases are not supported: `lease()` throws. */
3
4
  export class SystemEnvsHelper extends AbstractSecretsHelper {
4
5
  constructor(opts) {
5
6
  super({
@@ -1 +1 @@
1
- {"version":3,"file":"system-envs.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/system-envs/system-envs.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGhD,MAAM,OAAO,gBAAiB,SAAQ,qBAAqB;IACzD,YAAY,IAAqE;QAC/E,KAAK,CAAC;YACJ,KAAK,EAAE,gBAAgB,CAAC,IAAI;YAC5B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAES,KAAK,CAAC,QAAQ;QACtB,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,iBAAiB,EAAE,CAAC;YAC3C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAES,KAAK,CAAC,QAAQ;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,QAAQ;IACV,CAAC;IAEQ,KAAK,CAAC,KAAK,CAAC,KAAoC;QACvD,MAAM,QAAQ,CAAC;YACb,OAAO,EACL,uFAAuF;SAC1F,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { getError } from '@/modules/error';\nimport { AbstractSecretsHelper } from '../base';\nimport type { IClock, ISecretLease, ITimerAdapter } from '../common';\n\nexport class SystemEnvsHelper extends AbstractSecretsHelper {\n constructor(opts: { identifier?: string; clock?: IClock; timers?: ITimerAdapter }) {\n super({\n scope: SystemEnvsHelper.name,\n identifier: opts.identifier,\n clock: opts.clock,\n timers: opts.timers,\n });\n }\n\n protected async fetchRaw() {\n const value: Record<string, string> = {};\n const processEnvEntries = Object.entries(process.env);\n for (const [key, raw] of processEnvEntries) {\n if (raw !== undefined) {\n value[key] = raw;\n }\n }\n return { value };\n }\n\n protected async renewRaw() {\n return null;\n }\n\n protected async revokeRaw() {\n // no-op\n }\n\n override async lease(_opts: { path: string; key: string }): Promise<ISecretLease> {\n throw getError({\n message:\n '[SystemEnvsHelper.lease] Dynamic leases are not supported by the system-envs provider',\n });\n }\n}\n"]}
1
+ {"version":3,"file":"system-envs.helper.js","sourceRoot":"","sources":["../../../../../src/modules/secrets/system-envs/system-envs.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGhD,0HAA0H;AAC1H,MAAM,OAAO,gBAAiB,SAAQ,qBAAqB;IACzD,YAAY,IAAqE;QAC/E,KAAK,CAAC;YACJ,KAAK,EAAE,gBAAgB,CAAC,IAAI;YAC5B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAES,KAAK,CAAC,QAAQ;QACtB,MAAM,KAAK,GAA2B,EAAE,CAAC;QACzC,MAAM,iBAAiB,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEtD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,iBAAiB,EAAE,CAAC;YAC3C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACtB,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YACnB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAES,KAAK,CAAC,QAAQ;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,QAAQ;IACV,CAAC;IAEQ,KAAK,CAAC,KAAK,CAAC,KAAoC;QACvD,MAAM,QAAQ,CAAC;YACb,OAAO,EACL,uFAAuF;SAC1F,CAAC,CAAC;IACL,CAAC;CACF","sourcesContent":["import { getError } from '@/modules/error';\nimport { AbstractSecretsHelper } from '../base';\nimport type { IClock, ISecretLease, ITimerAdapter } from '../common';\n\n/** Secrets provider that serves the current `process.env` entries. Dynamic leases are not supported: `lease()` throws. */\nexport class SystemEnvsHelper extends AbstractSecretsHelper {\n constructor(opts: { identifier?: string; clock?: IClock; timers?: ITimerAdapter }) {\n super({\n scope: SystemEnvsHelper.name,\n identifier: opts.identifier,\n clock: opts.clock,\n timers: opts.timers,\n });\n }\n\n protected async fetchRaw() {\n const value: Record<string, string> = {};\n const processEnvEntries = Object.entries(process.env);\n\n for (const [key, raw] of processEnvEntries) {\n if (raw !== undefined) {\n value[key] = raw;\n }\n }\n\n return { value };\n }\n\n protected async renewRaw() {\n return null;\n }\n\n protected async revokeRaw() {\n // no-op\n }\n\n override async lease(_opts: { path: string; key: string }): Promise<ISecretLease> {\n throw getError({\n message:\n '[SystemEnvsHelper.lease] Dynamic leases are not supported by the system-envs provider',\n });\n }\n}\n"]}
@@ -5,6 +5,7 @@
5
5
  export declare const COMBINING_MARKS_PATTERN: RegExp;
6
6
  /** Any run of characters outside the slug alphabet collapses to one hyphen. */
7
7
  export declare const NON_SLUG_CHARACTERS_PATTERN: RegExp;
8
+ /** Matches hyphens at the start or end of a string, so replacing it with an empty string trims them. */
8
9
  export declare const LEADING_OR_TRAILING_HYPHENS_PATTERN: RegExp;
9
10
  /**
10
11
  * `đ`/`Đ` carry no combining mark, so NFD leaves them intact - hence this explicit map. `d` is