@dyanet/nestjs-config-aws 1.0.1 → 1.2.0-beta.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 (391) hide show
  1. package/README.md +208 -1013
  2. package/dist/cjs/config-aws/src/config-manager.js +366 -0
  3. package/dist/cjs/config-aws/src/errors/index.js +77 -0
  4. package/dist/cjs/config-aws/src/index.js +37 -0
  5. package/dist/cjs/config-aws/src/interfaces/config-loader.interface.js +3 -0
  6. package/dist/cjs/config-aws/src/interfaces/config-manager.interface.js +3 -0
  7. package/dist/cjs/config-aws/src/interfaces/env-file-loader.interface.js +3 -0
  8. package/dist/cjs/config-aws/src/interfaces/environment-loader.interface.js +3 -0
  9. package/dist/cjs/config-aws/src/interfaces/s3-loader.interface.js +3 -0
  10. package/dist/cjs/config-aws/src/interfaces/secrets-manager-loader.interface.js +3 -0
  11. package/dist/cjs/config-aws/src/interfaces/ssm-parameter-store-loader.interface.js +3 -0
  12. package/dist/cjs/config-aws/src/loaders/env-file.loader.js +169 -0
  13. package/dist/cjs/config-aws/src/loaders/environment.loader.js +85 -0
  14. package/dist/cjs/config-aws/src/loaders/s3.loader.js +145 -0
  15. package/dist/cjs/config-aws/src/loaders/secrets-manager.loader.js +162 -0
  16. package/dist/cjs/config-aws/src/loaders/ssm-parameter-store.loader.js +199 -0
  17. package/dist/cjs/config-aws/src/utils/env-file-parser.util.js +98 -0
  18. package/dist/cjs/config-aws/src/utils/validation.util.js +116 -0
  19. package/dist/cjs/nestjs-config-aws/src/config.module.js +175 -0
  20. package/dist/cjs/nestjs-config-aws/src/index.js +61 -0
  21. package/dist/cjs/{integration → nestjs-config-aws/src/integration}/index.js +1 -1
  22. package/dist/cjs/nestjs-config-aws/src/integration/interfaces/configuration-factory.interface.js +3 -0
  23. package/dist/cjs/nestjs-config-aws/src/integration/interfaces/configuration-source.interface.js +3 -0
  24. package/dist/cjs/{integration → nestjs-config-aws/src/integration}/interfaces/index.js +1 -1
  25. package/dist/cjs/nestjs-config-aws/src/integration/interfaces/integration-options.interface.js +3 -0
  26. package/dist/cjs/nestjs-config-aws/src/integration/interfaces/integration-state.interface.js +3 -0
  27. package/dist/cjs/nestjs-config-aws/src/integration/interfaces/nestjs-config-compatibility.interface.js +73 -0
  28. package/dist/cjs/nestjs-config-aws/src/integration/interfaces/nestjs-config-integration.interface.js +3 -0
  29. package/dist/cjs/nestjs-config-aws/src/integration/interfaces/typed-configuration.interface.js +4 -0
  30. package/dist/cjs/nestjs-config-aws/src/integration/interfaces/utility-types.interface.js +52 -0
  31. package/dist/cjs/nestjs-config-aws/src/integration/nestjs-config-integration.module.js +124 -0
  32. package/dist/cjs/nestjs-config-aws/src/integration/providers/aws-configuration-loader.service.js +592 -0
  33. package/dist/cjs/nestjs-config-aws/src/integration/providers/configuration-factory.provider.js +385 -0
  34. package/dist/cjs/{integration → nestjs-config-aws/src/integration}/providers/index.js +1 -1
  35. package/dist/cjs/nestjs-config-aws/src/integration/services/async-config-helper.service.js +358 -0
  36. package/dist/cjs/nestjs-config-aws/src/integration/services/error-handler.service.js +267 -0
  37. package/dist/cjs/nestjs-config-aws/src/integration/services/factory-registration.service.js +517 -0
  38. package/dist/cjs/{integration → nestjs-config-aws/src/integration}/services/index.js +1 -1
  39. package/dist/cjs/nestjs-config-aws/src/integration/services/integration-state.service.js +81 -0
  40. package/dist/cjs/nestjs-config-aws/src/integration/services/namespace-handler.service.js +465 -0
  41. package/dist/cjs/nestjs-config-aws/src/integration/services/nestjs-config-integration.service.js +318 -0
  42. package/dist/cjs/nestjs-config-aws/src/integration/services/precedence-handler.service.js +292 -0
  43. package/dist/cjs/nestjs-config-aws/src/integration/services/validation-integration.service.js +592 -0
  44. package/dist/cjs/nestjs-config-aws/src/integration/utils/config-integration.util.js +283 -0
  45. package/dist/cjs/{integration → nestjs-config-aws/src/integration}/utils/index.js +1 -1
  46. package/dist/cjs/nestjs-config-aws/src/interfaces/config-service.interface.js +11 -0
  47. package/dist/cjs/nestjs-config-aws/src/interfaces/default-schema.interface.js +63 -0
  48. package/dist/cjs/nestjs-config-aws/src/interfaces/index.js +30 -0
  49. package/dist/cjs/nestjs-config-aws/src/interfaces/module-options.interface.js +3 -0
  50. package/dist/cjs/nestjs-config-aws/src/services/config.service.js +142 -0
  51. package/dist/esm/config-aws/src/config-manager.js +362 -0
  52. package/dist/esm/config-aws/src/errors/index.js +69 -0
  53. package/dist/esm/config-aws/src/index.js +21 -0
  54. package/dist/esm/config-aws/src/interfaces/config-loader.interface.js +2 -0
  55. package/dist/esm/config-aws/src/interfaces/config-manager.interface.js +2 -0
  56. package/dist/esm/config-aws/src/interfaces/env-file-loader.interface.js +2 -0
  57. package/dist/esm/config-aws/src/interfaces/environment-loader.interface.js +2 -0
  58. package/dist/esm/config-aws/src/interfaces/s3-loader.interface.js +2 -0
  59. package/dist/esm/config-aws/src/interfaces/secrets-manager-loader.interface.js +2 -0
  60. package/dist/esm/config-aws/src/interfaces/ssm-parameter-store-loader.interface.js +2 -0
  61. package/dist/esm/config-aws/src/loaders/env-file.loader.js +132 -0
  62. package/dist/esm/config-aws/src/loaders/environment.loader.js +81 -0
  63. package/dist/esm/config-aws/src/loaders/s3.loader.js +141 -0
  64. package/dist/esm/config-aws/src/loaders/secrets-manager.loader.js +158 -0
  65. package/dist/esm/config-aws/src/loaders/ssm-parameter-store.loader.js +195 -0
  66. package/dist/esm/config-aws/src/utils/env-file-parser.util.js +94 -0
  67. package/dist/esm/config-aws/src/utils/validation.util.js +112 -0
  68. package/dist/esm/nestjs-config-aws/src/config.module.js +172 -0
  69. package/dist/esm/nestjs-config-aws/src/index.js +23 -0
  70. package/dist/esm/nestjs-config-aws/src/integration/index.js +7 -0
  71. package/dist/esm/nestjs-config-aws/src/integration/interfaces/configuration-factory.interface.js +2 -0
  72. package/dist/esm/nestjs-config-aws/src/integration/interfaces/configuration-source.interface.js +2 -0
  73. package/dist/esm/nestjs-config-aws/src/integration/interfaces/index.js +10 -0
  74. package/dist/esm/nestjs-config-aws/src/integration/interfaces/integration-options.interface.js +2 -0
  75. package/dist/esm/nestjs-config-aws/src/integration/interfaces/integration-state.interface.js +2 -0
  76. package/dist/esm/nestjs-config-aws/src/integration/interfaces/nestjs-config-compatibility.interface.js +64 -0
  77. package/dist/esm/nestjs-config-aws/src/integration/interfaces/nestjs-config-integration.interface.js +2 -0
  78. package/dist/esm/nestjs-config-aws/src/integration/interfaces/typed-configuration.interface.js +3 -0
  79. package/dist/esm/nestjs-config-aws/src/integration/interfaces/utility-types.interface.js +44 -0
  80. package/dist/esm/nestjs-config-aws/src/integration/nestjs-config-integration.module.js +121 -0
  81. package/dist/esm/nestjs-config-aws/src/integration/providers/aws-configuration-loader.service.js +589 -0
  82. package/dist/esm/nestjs-config-aws/src/integration/providers/configuration-factory.provider.js +382 -0
  83. package/dist/esm/nestjs-config-aws/src/integration/providers/index.js +4 -0
  84. package/dist/esm/nestjs-config-aws/src/integration/services/async-config-helper.service.js +355 -0
  85. package/dist/esm/nestjs-config-aws/src/integration/services/error-handler.service.js +264 -0
  86. package/dist/esm/nestjs-config-aws/src/integration/services/factory-registration.service.js +514 -0
  87. package/dist/esm/nestjs-config-aws/src/integration/services/index.js +10 -0
  88. package/dist/esm/nestjs-config-aws/src/integration/services/integration-state.service.js +78 -0
  89. package/dist/esm/nestjs-config-aws/src/integration/services/namespace-handler.service.js +462 -0
  90. package/dist/esm/nestjs-config-aws/src/integration/services/nestjs-config-integration.service.js +315 -0
  91. package/dist/esm/nestjs-config-aws/src/integration/services/precedence-handler.service.js +289 -0
  92. package/dist/esm/nestjs-config-aws/src/integration/services/validation-integration.service.js +586 -0
  93. package/dist/esm/nestjs-config-aws/src/integration/utils/config-integration.util.js +240 -0
  94. package/dist/esm/nestjs-config-aws/src/integration/utils/index.js +3 -0
  95. package/dist/esm/nestjs-config-aws/src/interfaces/config-service.interface.js +7 -0
  96. package/dist/esm/nestjs-config-aws/src/interfaces/default-schema.interface.js +59 -0
  97. package/dist/esm/nestjs-config-aws/src/interfaces/index.js +8 -0
  98. package/dist/esm/nestjs-config-aws/src/interfaces/module-options.interface.js +2 -0
  99. package/dist/esm/nestjs-config-aws/src/services/config.service.js +139 -0
  100. package/dist/types/config-aws/src/config-manager.d.ts +119 -0
  101. package/dist/types/config-aws/src/config-manager.d.ts.map +1 -0
  102. package/dist/types/config-aws/src/errors/index.d.ts +43 -0
  103. package/dist/types/config-aws/src/errors/index.d.ts.map +1 -0
  104. package/dist/types/config-aws/src/index.d.ts +24 -0
  105. package/dist/types/config-aws/src/index.d.ts.map +1 -0
  106. package/dist/types/config-aws/src/interfaces/config-loader.interface.d.ts +33 -0
  107. package/dist/types/config-aws/src/interfaces/config-loader.interface.d.ts.map +1 -0
  108. package/dist/types/config-aws/src/interfaces/config-manager.interface.d.ts +86 -0
  109. package/dist/types/config-aws/src/interfaces/config-manager.interface.d.ts.map +1 -0
  110. package/dist/types/config-aws/src/interfaces/env-file-loader.interface.d.ts +12 -0
  111. package/dist/types/config-aws/src/interfaces/env-file-loader.interface.d.ts.map +1 -0
  112. package/dist/types/config-aws/src/interfaces/environment-loader.interface.d.ts +10 -0
  113. package/dist/types/config-aws/src/interfaces/environment-loader.interface.d.ts.map +1 -0
  114. package/dist/types/config-aws/src/interfaces/s3-loader.interface.d.ts +14 -0
  115. package/dist/types/config-aws/src/interfaces/s3-loader.interface.d.ts.map +1 -0
  116. package/dist/types/config-aws/src/interfaces/secrets-manager-loader.interface.d.ts +12 -0
  117. package/dist/types/config-aws/src/interfaces/secrets-manager-loader.interface.d.ts.map +1 -0
  118. package/dist/types/config-aws/src/interfaces/ssm-parameter-store-loader.interface.d.ts +14 -0
  119. package/dist/types/config-aws/src/interfaces/ssm-parameter-store-loader.interface.d.ts.map +1 -0
  120. package/dist/types/config-aws/src/loaders/env-file.loader.d.ts +69 -0
  121. package/dist/types/config-aws/src/loaders/env-file.loader.d.ts.map +1 -0
  122. package/dist/types/config-aws/src/loaders/environment.loader.d.ts +46 -0
  123. package/dist/types/config-aws/src/loaders/environment.loader.d.ts.map +1 -0
  124. package/dist/types/config-aws/src/loaders/s3.loader.d.ts +62 -0
  125. package/dist/types/config-aws/src/loaders/s3.loader.d.ts.map +1 -0
  126. package/dist/types/config-aws/src/loaders/secrets-manager.loader.d.ts +68 -0
  127. package/dist/types/config-aws/src/loaders/secrets-manager.loader.d.ts.map +1 -0
  128. package/dist/types/config-aws/src/loaders/ssm-parameter-store.loader.d.ts +78 -0
  129. package/dist/types/config-aws/src/loaders/ssm-parameter-store.loader.d.ts.map +1 -0
  130. package/dist/types/config-aws/src/utils/env-file-parser.util.d.ts +45 -0
  131. package/dist/types/config-aws/src/utils/env-file-parser.util.d.ts.map +1 -0
  132. package/dist/types/{utils → config-aws/src/utils}/validation.util.d.ts +10 -10
  133. package/dist/types/config-aws/src/utils/validation.util.d.ts.map +1 -0
  134. package/dist/types/{config.module.d.ts → nestjs-config-aws/src/config.module.d.ts} +1 -0
  135. package/dist/types/nestjs-config-aws/src/config.module.d.ts.map +1 -0
  136. package/dist/types/{index.d.ts → nestjs-config-aws/src/index.d.ts} +2 -4
  137. package/dist/types/nestjs-config-aws/src/index.d.ts.map +1 -0
  138. package/dist/types/nestjs-config-aws/src/integration/index.d.ts.map +1 -0
  139. package/dist/types/nestjs-config-aws/src/integration/interfaces/configuration-factory.interface.d.ts.map +1 -0
  140. package/dist/types/nestjs-config-aws/src/integration/interfaces/configuration-source.interface.d.ts.map +1 -0
  141. package/dist/types/nestjs-config-aws/src/integration/interfaces/index.d.ts.map +1 -0
  142. package/dist/types/nestjs-config-aws/src/integration/interfaces/integration-options.interface.d.ts.map +1 -0
  143. package/dist/types/nestjs-config-aws/src/integration/interfaces/integration-state.interface.d.ts.map +1 -0
  144. package/dist/types/nestjs-config-aws/src/integration/interfaces/nestjs-config-compatibility.interface.d.ts.map +1 -0
  145. package/dist/types/nestjs-config-aws/src/integration/interfaces/nestjs-config-integration.interface.d.ts.map +1 -0
  146. package/dist/types/nestjs-config-aws/src/integration/interfaces/typed-configuration.interface.d.ts.map +1 -0
  147. package/dist/types/nestjs-config-aws/src/integration/interfaces/utility-types.interface.d.ts.map +1 -0
  148. package/dist/types/nestjs-config-aws/src/integration/nestjs-config-integration.module.d.ts.map +1 -0
  149. package/dist/types/nestjs-config-aws/src/integration/providers/aws-configuration-loader.service.d.ts.map +1 -0
  150. package/dist/types/nestjs-config-aws/src/integration/providers/configuration-factory.provider.d.ts.map +1 -0
  151. package/dist/types/nestjs-config-aws/src/integration/providers/index.d.ts.map +1 -0
  152. package/dist/types/nestjs-config-aws/src/integration/services/async-config-helper.service.d.ts.map +1 -0
  153. package/dist/types/nestjs-config-aws/src/integration/services/error-handler.service.d.ts.map +1 -0
  154. package/dist/types/nestjs-config-aws/src/integration/services/factory-registration.service.d.ts.map +1 -0
  155. package/dist/types/nestjs-config-aws/src/integration/services/index.d.ts.map +1 -0
  156. package/dist/types/nestjs-config-aws/src/integration/services/integration-state.service.d.ts.map +1 -0
  157. package/dist/types/nestjs-config-aws/src/integration/services/namespace-handler.service.d.ts.map +1 -0
  158. package/dist/types/nestjs-config-aws/src/integration/services/nestjs-config-integration.service.d.ts.map +1 -0
  159. package/dist/types/nestjs-config-aws/src/integration/services/precedence-handler.service.d.ts.map +1 -0
  160. package/dist/types/nestjs-config-aws/src/integration/services/validation-integration.service.d.ts.map +1 -0
  161. package/dist/types/nestjs-config-aws/src/integration/utils/config-integration.util.d.ts.map +1 -0
  162. package/dist/types/nestjs-config-aws/src/integration/utils/index.d.ts.map +1 -0
  163. package/dist/types/nestjs-config-aws/src/interfaces/config-service.interface.d.ts.map +1 -0
  164. package/dist/types/{interfaces → nestjs-config-aws/src/interfaces}/default-schema.interface.d.ts +28 -28
  165. package/dist/types/nestjs-config-aws/src/interfaces/default-schema.interface.d.ts.map +1 -0
  166. package/dist/types/nestjs-config-aws/src/interfaces/index.d.ts +5 -0
  167. package/dist/types/nestjs-config-aws/src/interfaces/index.d.ts.map +1 -0
  168. package/dist/types/nestjs-config-aws/src/interfaces/module-options.interface.d.ts.map +1 -0
  169. package/dist/types/nestjs-config-aws/src/services/config.service.d.ts +88 -0
  170. package/dist/types/nestjs-config-aws/src/services/config.service.d.ts.map +1 -0
  171. package/package.json +17 -24
  172. package/LICENSE +0 -21
  173. package/dist/cjs/config.module.js +0 -178
  174. package/dist/cjs/config.module.js.map +0 -1
  175. package/dist/cjs/index.js +0 -47
  176. package/dist/cjs/index.js.map +0 -1
  177. package/dist/cjs/integration/index.js.map +0 -1
  178. package/dist/cjs/integration/interfaces/configuration-factory.interface.js +0 -3
  179. package/dist/cjs/integration/interfaces/configuration-factory.interface.js.map +0 -1
  180. package/dist/cjs/integration/interfaces/configuration-source.interface.js +0 -3
  181. package/dist/cjs/integration/interfaces/configuration-source.interface.js.map +0 -1
  182. package/dist/cjs/integration/interfaces/index.js.map +0 -1
  183. package/dist/cjs/integration/interfaces/integration-options.interface.js +0 -3
  184. package/dist/cjs/integration/interfaces/integration-options.interface.js.map +0 -1
  185. package/dist/cjs/integration/interfaces/integration-state.interface.js +0 -3
  186. package/dist/cjs/integration/interfaces/integration-state.interface.js.map +0 -1
  187. package/dist/cjs/integration/interfaces/nestjs-config-compatibility.interface.js +0 -73
  188. package/dist/cjs/integration/interfaces/nestjs-config-compatibility.interface.js.map +0 -1
  189. package/dist/cjs/integration/interfaces/nestjs-config-integration.interface.js +0 -3
  190. package/dist/cjs/integration/interfaces/nestjs-config-integration.interface.js.map +0 -1
  191. package/dist/cjs/integration/interfaces/typed-configuration.interface.js +0 -4
  192. package/dist/cjs/integration/interfaces/typed-configuration.interface.js.map +0 -1
  193. package/dist/cjs/integration/interfaces/utility-types.interface.js +0 -52
  194. package/dist/cjs/integration/interfaces/utility-types.interface.js.map +0 -1
  195. package/dist/cjs/integration/nestjs-config-integration.module.js +0 -124
  196. package/dist/cjs/integration/nestjs-config-integration.module.js.map +0 -1
  197. package/dist/cjs/integration/providers/aws-configuration-loader.service.js +0 -591
  198. package/dist/cjs/integration/providers/aws-configuration-loader.service.js.map +0 -1
  199. package/dist/cjs/integration/providers/configuration-factory.provider.js +0 -383
  200. package/dist/cjs/integration/providers/configuration-factory.provider.js.map +0 -1
  201. package/dist/cjs/integration/providers/index.js.map +0 -1
  202. package/dist/cjs/integration/services/async-config-helper.service.js +0 -356
  203. package/dist/cjs/integration/services/async-config-helper.service.js.map +0 -1
  204. package/dist/cjs/integration/services/error-handler.service.js +0 -265
  205. package/dist/cjs/integration/services/error-handler.service.js.map +0 -1
  206. package/dist/cjs/integration/services/factory-registration.service.js +0 -512
  207. package/dist/cjs/integration/services/factory-registration.service.js.map +0 -1
  208. package/dist/cjs/integration/services/index.js.map +0 -1
  209. package/dist/cjs/integration/services/integration-state.service.js +0 -83
  210. package/dist/cjs/integration/services/integration-state.service.js.map +0 -1
  211. package/dist/cjs/integration/services/namespace-handler.service.js +0 -467
  212. package/dist/cjs/integration/services/namespace-handler.service.js.map +0 -1
  213. package/dist/cjs/integration/services/nestjs-config-integration.service.js +0 -316
  214. package/dist/cjs/integration/services/nestjs-config-integration.service.js.map +0 -1
  215. package/dist/cjs/integration/services/precedence-handler.service.js +0 -294
  216. package/dist/cjs/integration/services/precedence-handler.service.js.map +0 -1
  217. package/dist/cjs/integration/services/validation-integration.service.js +0 -591
  218. package/dist/cjs/integration/services/validation-integration.service.js.map +0 -1
  219. package/dist/cjs/integration/utils/config-integration.util.js +0 -283
  220. package/dist/cjs/integration/utils/config-integration.util.js.map +0 -1
  221. package/dist/cjs/integration/utils/index.js.map +0 -1
  222. package/dist/cjs/interfaces/config-loader.interface.js +0 -3
  223. package/dist/cjs/interfaces/config-loader.interface.js.map +0 -1
  224. package/dist/cjs/interfaces/config-service.interface.js +0 -11
  225. package/dist/cjs/interfaces/config-service.interface.js.map +0 -1
  226. package/dist/cjs/interfaces/default-schema.interface.js +0 -63
  227. package/dist/cjs/interfaces/default-schema.interface.js.map +0 -1
  228. package/dist/cjs/interfaces/errors.interface.js +0 -77
  229. package/dist/cjs/interfaces/errors.interface.js.map +0 -1
  230. package/dist/cjs/interfaces/index.js +0 -25
  231. package/dist/cjs/interfaces/index.js.map +0 -1
  232. package/dist/cjs/interfaces/module-options.interface.js +0 -3
  233. package/dist/cjs/interfaces/module-options.interface.js.map +0 -1
  234. package/dist/cjs/loaders/environment.loader.js +0 -59
  235. package/dist/cjs/loaders/environment.loader.js.map +0 -1
  236. package/dist/cjs/loaders/secrets-manager.loader.js +0 -122
  237. package/dist/cjs/loaders/secrets-manager.loader.js.map +0 -1
  238. package/dist/cjs/loaders/ssm-parameter-store.loader.js +0 -146
  239. package/dist/cjs/loaders/ssm-parameter-store.loader.js.map +0 -1
  240. package/dist/cjs/services/config.service.js +0 -297
  241. package/dist/cjs/services/config.service.js.map +0 -1
  242. package/dist/cjs/utils/validation.util.js +0 -114
  243. package/dist/cjs/utils/validation.util.js.map +0 -1
  244. package/dist/esm/config.module.js +0 -175
  245. package/dist/esm/config.module.js.map +0 -1
  246. package/dist/esm/index.js +0 -18
  247. package/dist/esm/index.js.map +0 -1
  248. package/dist/esm/integration/index.js +0 -7
  249. package/dist/esm/integration/index.js.map +0 -1
  250. package/dist/esm/integration/interfaces/configuration-factory.interface.js +0 -2
  251. package/dist/esm/integration/interfaces/configuration-factory.interface.js.map +0 -1
  252. package/dist/esm/integration/interfaces/configuration-source.interface.js +0 -2
  253. package/dist/esm/integration/interfaces/configuration-source.interface.js.map +0 -1
  254. package/dist/esm/integration/interfaces/index.js +0 -10
  255. package/dist/esm/integration/interfaces/index.js.map +0 -1
  256. package/dist/esm/integration/interfaces/integration-options.interface.js +0 -2
  257. package/dist/esm/integration/interfaces/integration-options.interface.js.map +0 -1
  258. package/dist/esm/integration/interfaces/integration-state.interface.js +0 -2
  259. package/dist/esm/integration/interfaces/integration-state.interface.js.map +0 -1
  260. package/dist/esm/integration/interfaces/nestjs-config-compatibility.interface.js +0 -64
  261. package/dist/esm/integration/interfaces/nestjs-config-compatibility.interface.js.map +0 -1
  262. package/dist/esm/integration/interfaces/nestjs-config-integration.interface.js +0 -2
  263. package/dist/esm/integration/interfaces/nestjs-config-integration.interface.js.map +0 -1
  264. package/dist/esm/integration/interfaces/typed-configuration.interface.js +0 -3
  265. package/dist/esm/integration/interfaces/typed-configuration.interface.js.map +0 -1
  266. package/dist/esm/integration/interfaces/utility-types.interface.js +0 -44
  267. package/dist/esm/integration/interfaces/utility-types.interface.js.map +0 -1
  268. package/dist/esm/integration/nestjs-config-integration.module.js +0 -121
  269. package/dist/esm/integration/nestjs-config-integration.module.js.map +0 -1
  270. package/dist/esm/integration/providers/aws-configuration-loader.service.js +0 -588
  271. package/dist/esm/integration/providers/aws-configuration-loader.service.js.map +0 -1
  272. package/dist/esm/integration/providers/configuration-factory.provider.js +0 -380
  273. package/dist/esm/integration/providers/configuration-factory.provider.js.map +0 -1
  274. package/dist/esm/integration/providers/index.js +0 -4
  275. package/dist/esm/integration/providers/index.js.map +0 -1
  276. package/dist/esm/integration/services/async-config-helper.service.js +0 -353
  277. package/dist/esm/integration/services/async-config-helper.service.js.map +0 -1
  278. package/dist/esm/integration/services/error-handler.service.js +0 -262
  279. package/dist/esm/integration/services/error-handler.service.js.map +0 -1
  280. package/dist/esm/integration/services/factory-registration.service.js +0 -509
  281. package/dist/esm/integration/services/factory-registration.service.js.map +0 -1
  282. package/dist/esm/integration/services/index.js +0 -10
  283. package/dist/esm/integration/services/index.js.map +0 -1
  284. package/dist/esm/integration/services/integration-state.service.js +0 -80
  285. package/dist/esm/integration/services/integration-state.service.js.map +0 -1
  286. package/dist/esm/integration/services/namespace-handler.service.js +0 -464
  287. package/dist/esm/integration/services/namespace-handler.service.js.map +0 -1
  288. package/dist/esm/integration/services/nestjs-config-integration.service.js +0 -313
  289. package/dist/esm/integration/services/nestjs-config-integration.service.js.map +0 -1
  290. package/dist/esm/integration/services/precedence-handler.service.js +0 -291
  291. package/dist/esm/integration/services/precedence-handler.service.js.map +0 -1
  292. package/dist/esm/integration/services/validation-integration.service.js +0 -585
  293. package/dist/esm/integration/services/validation-integration.service.js.map +0 -1
  294. package/dist/esm/integration/utils/config-integration.util.js +0 -240
  295. package/dist/esm/integration/utils/config-integration.util.js.map +0 -1
  296. package/dist/esm/integration/utils/index.js +0 -3
  297. package/dist/esm/integration/utils/index.js.map +0 -1
  298. package/dist/esm/interfaces/config-loader.interface.js +0 -2
  299. package/dist/esm/interfaces/config-loader.interface.js.map +0 -1
  300. package/dist/esm/interfaces/config-service.interface.js +0 -7
  301. package/dist/esm/interfaces/config-service.interface.js.map +0 -1
  302. package/dist/esm/interfaces/default-schema.interface.js +0 -59
  303. package/dist/esm/interfaces/default-schema.interface.js.map +0 -1
  304. package/dist/esm/interfaces/errors.interface.js +0 -69
  305. package/dist/esm/interfaces/errors.interface.js.map +0 -1
  306. package/dist/esm/interfaces/index.js +0 -9
  307. package/dist/esm/interfaces/index.js.map +0 -1
  308. package/dist/esm/interfaces/module-options.interface.js +0 -2
  309. package/dist/esm/interfaces/module-options.interface.js.map +0 -1
  310. package/dist/esm/loaders/environment.loader.js +0 -55
  311. package/dist/esm/loaders/environment.loader.js.map +0 -1
  312. package/dist/esm/loaders/secrets-manager.loader.js +0 -118
  313. package/dist/esm/loaders/secrets-manager.loader.js.map +0 -1
  314. package/dist/esm/loaders/ssm-parameter-store.loader.js +0 -142
  315. package/dist/esm/loaders/ssm-parameter-store.loader.js.map +0 -1
  316. package/dist/esm/services/config.service.js +0 -261
  317. package/dist/esm/services/config.service.js.map +0 -1
  318. package/dist/esm/utils/validation.util.js +0 -110
  319. package/dist/esm/utils/validation.util.js.map +0 -1
  320. package/dist/types/config.module.d.ts.map +0 -1
  321. package/dist/types/index.d.ts.map +0 -1
  322. package/dist/types/integration/index.d.ts.map +0 -1
  323. package/dist/types/integration/interfaces/configuration-factory.interface.d.ts.map +0 -1
  324. package/dist/types/integration/interfaces/configuration-source.interface.d.ts.map +0 -1
  325. package/dist/types/integration/interfaces/index.d.ts.map +0 -1
  326. package/dist/types/integration/interfaces/integration-options.interface.d.ts.map +0 -1
  327. package/dist/types/integration/interfaces/integration-state.interface.d.ts.map +0 -1
  328. package/dist/types/integration/interfaces/nestjs-config-compatibility.interface.d.ts.map +0 -1
  329. package/dist/types/integration/interfaces/nestjs-config-integration.interface.d.ts.map +0 -1
  330. package/dist/types/integration/interfaces/typed-configuration.interface.d.ts.map +0 -1
  331. package/dist/types/integration/interfaces/utility-types.interface.d.ts.map +0 -1
  332. package/dist/types/integration/nestjs-config-integration.module.d.ts.map +0 -1
  333. package/dist/types/integration/providers/aws-configuration-loader.service.d.ts.map +0 -1
  334. package/dist/types/integration/providers/configuration-factory.provider.d.ts.map +0 -1
  335. package/dist/types/integration/providers/index.d.ts.map +0 -1
  336. package/dist/types/integration/services/async-config-helper.service.d.ts.map +0 -1
  337. package/dist/types/integration/services/error-handler.service.d.ts.map +0 -1
  338. package/dist/types/integration/services/factory-registration.service.d.ts.map +0 -1
  339. package/dist/types/integration/services/index.d.ts.map +0 -1
  340. package/dist/types/integration/services/integration-state.service.d.ts.map +0 -1
  341. package/dist/types/integration/services/namespace-handler.service.d.ts.map +0 -1
  342. package/dist/types/integration/services/nestjs-config-integration.service.d.ts.map +0 -1
  343. package/dist/types/integration/services/precedence-handler.service.d.ts.map +0 -1
  344. package/dist/types/integration/services/validation-integration.service.d.ts.map +0 -1
  345. package/dist/types/integration/utils/config-integration.util.d.ts.map +0 -1
  346. package/dist/types/integration/utils/index.d.ts.map +0 -1
  347. package/dist/types/interfaces/config-loader.interface.d.ts +0 -22
  348. package/dist/types/interfaces/config-loader.interface.d.ts.map +0 -1
  349. package/dist/types/interfaces/config-service.interface.d.ts.map +0 -1
  350. package/dist/types/interfaces/default-schema.interface.d.ts.map +0 -1
  351. package/dist/types/interfaces/errors.interface.d.ts +0 -38
  352. package/dist/types/interfaces/errors.interface.d.ts.map +0 -1
  353. package/dist/types/interfaces/index.d.ts +0 -6
  354. package/dist/types/interfaces/index.d.ts.map +0 -1
  355. package/dist/types/interfaces/module-options.interface.d.ts.map +0 -1
  356. package/dist/types/loaders/environment.loader.d.ts +0 -26
  357. package/dist/types/loaders/environment.loader.d.ts.map +0 -1
  358. package/dist/types/loaders/secrets-manager.loader.d.ts +0 -52
  359. package/dist/types/loaders/secrets-manager.loader.d.ts.map +0 -1
  360. package/dist/types/loaders/ssm-parameter-store.loader.d.ts +0 -68
  361. package/dist/types/loaders/ssm-parameter-store.loader.d.ts.map +0 -1
  362. package/dist/types/services/config.service.d.ts +0 -94
  363. package/dist/types/services/config.service.d.ts.map +0 -1
  364. package/dist/types/utils/validation.util.d.ts.map +0 -1
  365. /package/dist/types/{integration → nestjs-config-aws/src/integration}/index.d.ts +0 -0
  366. /package/dist/types/{integration → nestjs-config-aws/src/integration}/interfaces/configuration-factory.interface.d.ts +0 -0
  367. /package/dist/types/{integration → nestjs-config-aws/src/integration}/interfaces/configuration-source.interface.d.ts +0 -0
  368. /package/dist/types/{integration → nestjs-config-aws/src/integration}/interfaces/index.d.ts +0 -0
  369. /package/dist/types/{integration → nestjs-config-aws/src/integration}/interfaces/integration-options.interface.d.ts +0 -0
  370. /package/dist/types/{integration → nestjs-config-aws/src/integration}/interfaces/integration-state.interface.d.ts +0 -0
  371. /package/dist/types/{integration → nestjs-config-aws/src/integration}/interfaces/nestjs-config-compatibility.interface.d.ts +0 -0
  372. /package/dist/types/{integration → nestjs-config-aws/src/integration}/interfaces/nestjs-config-integration.interface.d.ts +0 -0
  373. /package/dist/types/{integration → nestjs-config-aws/src/integration}/interfaces/typed-configuration.interface.d.ts +0 -0
  374. /package/dist/types/{integration → nestjs-config-aws/src/integration}/interfaces/utility-types.interface.d.ts +0 -0
  375. /package/dist/types/{integration → nestjs-config-aws/src/integration}/nestjs-config-integration.module.d.ts +0 -0
  376. /package/dist/types/{integration → nestjs-config-aws/src/integration}/providers/aws-configuration-loader.service.d.ts +0 -0
  377. /package/dist/types/{integration → nestjs-config-aws/src/integration}/providers/configuration-factory.provider.d.ts +0 -0
  378. /package/dist/types/{integration → nestjs-config-aws/src/integration}/providers/index.d.ts +0 -0
  379. /package/dist/types/{integration → nestjs-config-aws/src/integration}/services/async-config-helper.service.d.ts +0 -0
  380. /package/dist/types/{integration → nestjs-config-aws/src/integration}/services/error-handler.service.d.ts +0 -0
  381. /package/dist/types/{integration → nestjs-config-aws/src/integration}/services/factory-registration.service.d.ts +0 -0
  382. /package/dist/types/{integration → nestjs-config-aws/src/integration}/services/index.d.ts +0 -0
  383. /package/dist/types/{integration → nestjs-config-aws/src/integration}/services/integration-state.service.d.ts +0 -0
  384. /package/dist/types/{integration → nestjs-config-aws/src/integration}/services/namespace-handler.service.d.ts +0 -0
  385. /package/dist/types/{integration → nestjs-config-aws/src/integration}/services/nestjs-config-integration.service.d.ts +0 -0
  386. /package/dist/types/{integration → nestjs-config-aws/src/integration}/services/precedence-handler.service.d.ts +0 -0
  387. /package/dist/types/{integration → nestjs-config-aws/src/integration}/services/validation-integration.service.d.ts +0 -0
  388. /package/dist/types/{integration → nestjs-config-aws/src/integration}/utils/config-integration.util.d.ts +0 -0
  389. /package/dist/types/{integration → nestjs-config-aws/src/integration}/utils/index.d.ts +0 -0
  390. /package/dist/types/{interfaces → nestjs-config-aws/src/interfaces}/config-service.interface.d.ts +0 -0
  391. /package/dist/types/{interfaces → nestjs-config-aws/src/interfaces}/module-options.interface.d.ts +0 -0
@@ -0,0 +1,158 @@
1
+ import { GetSecretValueCommand, SecretsManagerClient } from '@aws-sdk/client-secrets-manager';
2
+ import { fromNodeProviderChain } from '@aws-sdk/credential-providers';
3
+ import { AWSServiceError, ConfigurationLoadError } from '../errors';
4
+ /**
5
+ * Loader that reads configuration from AWS Secrets Manager.
6
+ * Supports environment-aware path construction.
7
+ *
8
+ * @example
9
+ * ```typescript
10
+ * // Basic usage
11
+ * const loader = new SecretsManagerLoader({
12
+ * secretName: '/my-app/config',
13
+ * region: 'us-east-1'
14
+ * });
15
+ *
16
+ * // With environment mapping
17
+ * const loader = new SecretsManagerLoader({
18
+ * secretName: '/my-app/config',
19
+ * environmentMapping: {
20
+ * development: 'dev',
21
+ * staging: 'stg',
22
+ * production: 'prod'
23
+ * }
24
+ * });
25
+ * ```
26
+ */
27
+ export class SecretsManagerLoader {
28
+ /** @internal */
29
+ _client;
30
+ /** @internal */
31
+ _config;
32
+ /** @internal */
33
+ _appEnv;
34
+ constructor(config = {}) {
35
+ this._appEnv = process.env['APP_ENV'] || process.env['NODE_ENV'] || 'local';
36
+ // Set default configuration
37
+ this._config = {
38
+ secretName: config.secretName || '/nestjs-config-aws',
39
+ region: config.region || process.env['AWS_REGION'] || 'us-east-1',
40
+ environmentMapping: config.environmentMapping || {
41
+ development: 'dev',
42
+ test: 'test',
43
+ production: 'production',
44
+ },
45
+ };
46
+ // Initialize AWS Secrets Manager client
47
+ this._client = new SecretsManagerClient({
48
+ credentials: fromNodeProviderChain(),
49
+ region: this._config.region,
50
+ });
51
+ }
52
+ /**
53
+ * Get the name of this loader for logging and debugging.
54
+ * @returns The loader name with secret path
55
+ */
56
+ getName() {
57
+ const secretName = this.buildSecretName();
58
+ return `SecretsManagerLoader(${secretName})`;
59
+ }
60
+ /**
61
+ * Check if this loader is available in the current environment.
62
+ * @returns Promise resolving to true if not in local environment and AWS credentials are available
63
+ */
64
+ async isAvailable() {
65
+ // Skip in local environment
66
+ if (this._appEnv === 'local') {
67
+ return false;
68
+ }
69
+ try {
70
+ // Test AWS credentials by attempting to get caller identity
71
+ await this._client.config.credentials();
72
+ return true;
73
+ }
74
+ catch {
75
+ return false;
76
+ }
77
+ }
78
+ /**
79
+ * Load configuration from AWS Secrets Manager.
80
+ * @returns Promise resolving to configuration key-value pairs from the secret
81
+ * @throws AWSServiceError if AWS operation fails
82
+ * @throws ConfigurationLoadError if secret cannot be parsed
83
+ */
84
+ async load() {
85
+ // Skip loading in local environment
86
+ if (this._appEnv === 'local') {
87
+ return {};
88
+ }
89
+ const secretName = this.buildSecretName();
90
+ try {
91
+ const command = new GetSecretValueCommand({ SecretId: secretName });
92
+ const response = await this._client.send(command);
93
+ if (!response.SecretString) {
94
+ return {};
95
+ }
96
+ // Try to parse as JSON, fallback to string value
97
+ try {
98
+ const parsed = JSON.parse(response.SecretString);
99
+ // Ensure we return an object for configuration merging
100
+ if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
101
+ return parsed;
102
+ }
103
+ else {
104
+ // If it's not an object, wrap it in a configuration object
105
+ return { SECRET_VALUE: parsed };
106
+ }
107
+ }
108
+ catch {
109
+ // If JSON parsing fails, treat as a single string value
110
+ return { SECRET_VALUE: response.SecretString };
111
+ }
112
+ }
113
+ catch (error) {
114
+ // Handle specific AWS errors
115
+ if (error instanceof Error) {
116
+ if (error.name === 'ResourceNotFoundException') {
117
+ // Secret doesn't exist - this is not necessarily an error in all environments
118
+ return {};
119
+ }
120
+ if (error.name === 'AccessDeniedException') {
121
+ throw new AWSServiceError(`Access denied when retrieving secret '${secretName}'. Check AWS credentials and permissions.`, 'SecretsManager', 'GetSecretValue', error);
122
+ }
123
+ if (error.name === 'InvalidRequestException') {
124
+ throw new AWSServiceError(`Invalid request when retrieving secret '${secretName}'. Check secret name format.`, 'SecretsManager', 'GetSecretValue', error);
125
+ }
126
+ }
127
+ // For other errors, wrap in AWSServiceError
128
+ throw new AWSServiceError(`Failed to retrieve secret '${secretName}' from AWS Secrets Manager: ${error instanceof Error ? error.message : String(error)}`, 'SecretsManager', 'GetSecretValue', error instanceof Error ? error : undefined);
129
+ }
130
+ }
131
+ /**
132
+ * Build the environment-aware secret name/path.
133
+ * @returns The full secret name with environment prefix
134
+ */
135
+ buildSecretName() {
136
+ const envPrefix = this._config.environmentMapping[this._appEnv];
137
+ if (!envPrefix) {
138
+ throw new ConfigurationLoadError(`No environment mapping found for APP_ENV '${this._appEnv}'. ` +
139
+ `Available environments: ${Object.keys(this._config.environmentMapping).join(', ')}`, this.getName());
140
+ }
141
+ return `/${envPrefix}${this._config.secretName}`;
142
+ }
143
+ /**
144
+ * Get the current app environment.
145
+ * @returns The current APP_ENV or NODE_ENV value
146
+ */
147
+ getAppEnv() {
148
+ return this._appEnv;
149
+ }
150
+ /**
151
+ * Get the environment mapping configuration.
152
+ * @returns The environment mapping record
153
+ */
154
+ getEnvironmentMapping() {
155
+ return { ...this._config.environmentMapping };
156
+ }
157
+ }
158
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VjcmV0cy1tYW5hZ2VyLmxvYWRlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL2NvbmZpZy1hd3Mvc3JjL2xvYWRlcnMvc2VjcmV0cy1tYW5hZ2VyLmxvYWRlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUscUJBQXFCLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxpQ0FBaUMsQ0FBQztBQUM5RixPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUl0RSxPQUFPLEVBQUUsZUFBZSxFQUFFLHNCQUFzQixFQUFFLE1BQU0sV0FBVyxDQUFDO0FBRXBFOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBc0JHO0FBQ0gsTUFBTSxPQUFPLG9CQUFvQjtJQUMvQixnQkFBZ0I7SUFDRyxPQUFPLENBQXVCO0lBQ2pELGdCQUFnQjtJQUNHLE9BQU8sQ0FBdUM7SUFDakUsZ0JBQWdCO0lBQ0csT0FBTyxDQUFTO0lBRW5DLFlBQVksU0FBcUMsRUFBRTtRQUNqRCxJQUFJLENBQUMsT0FBTyxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUMsU0FBUyxDQUFDLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxVQUFVLENBQUMsSUFBSSxPQUFPLENBQUM7UUFFNUUsNEJBQTRCO1FBQzVCLElBQUksQ0FBQyxPQUFPLEdBQUc7WUFDYixVQUFVLEVBQUUsTUFBTSxDQUFDLFVBQVUsSUFBSSxvQkFBb0I7WUFDckQsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsSUFBSSxXQUFXO1lBQ2pFLGtCQUFrQixFQUFFLE1BQU0sQ0FBQyxrQkFBa0IsSUFBSTtnQkFDL0MsV0FBVyxFQUFFLEtBQUs7Z0JBQ2xCLElBQUksRUFBRSxNQUFNO2dCQUNaLFVBQVUsRUFBRSxZQUFZO2FBQ3pCO1NBQ0YsQ0FBQztRQUVGLHdDQUF3QztRQUN4QyxJQUFJLENBQUMsT0FB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ZUNvbW1hbmQsIFNlY3JldHNNYW5hZ2VyQ2xpZW50IH0gZnJvbSAnQGF3cy1zZGsvY2xpZW50LXNlY3JldHMtbWFuYWdlcic7XHJcbmltcG9ydCB7IGZyb21Ob2RlUHJvdmlkZXJDaGFpbiB9IGZyb20gJ0Bhd3Mtc2RrL2NyZWRlbnRpYWwtcHJvdmlkZXJzJztcclxuXHJcbmltcG9ydCB0eXBlIHsgQ29uZmlnTG9hZGVyIH0gZnJvbSAnLi4vaW50ZXJmYWNlcy9jb25maWctbG9hZGVyLmludGVyZmFjZSc7XHJcbmltcG9ydCB0eXBlIHsgU2VjcmV0c01hbmFnZXJMb2FkZXJDb25maWcgfSBmcm9tICcuLi9pbnRlcmZhY2VzL3NlY3JldHMtbWFuYWdlci1sb2FkZXIuaW50ZXJmYWNlJztcclxuaW1wb3J0IHsgQVdTU2VydmljZUVycm9yLCBDb25maWd1cmF0aW9uTG9hZEVycm9yIH0gZnJvbSAnLi4vZXJyb3JzJztcclxuXHJcbi8qKlxyXG4gKiBMb2FkZXIgdGhhdCByZWFkcyBjb25maWd1cmF0aW9uIGZyb20gQVdTIFNlY3JldHMgTWFuYWdlci5cclxuICogU3VwcG9ydHMgZW52aXJvbm1lbnQtYXdhcmUgcGF0aCBjb25zdHJ1Y3Rpb24uXHJcbiAqXHJcbiAqIEBleGFtcGxlXHJcbiAqIGBgYHR5cGVzY3JpcHRcclxuICogLy8gQmFzaWMgdXNhZ2VcclxuICogY29uc3QgbG9hZGVyID0gbmV3IFNlY3JldHNNYW5hZ2VyTG9hZGVyKHtcclxuICogICBzZWNyZXROYW1lOiAnL215LWFwcC9jb25maWcnLFxyXG4gKiAgIHJlZ2lvbjogJ3VzLWVhc3QtMSdcclxuICogfSk7XHJcbiAqXHJcbiAqIC8vIFdpdGggZW52aXJvbm1lbnQgbWFwcGluZ1xyXG4gKiBjb25zdCBsb2FkZXIgPSBuZXcgU2VjcmV0c01hbmFnZXJMb2FkZXIoe1xyXG4gKiAgIHNlY3JldE5hbWU6ICcvbXktYXBwL2NvbmZpZycsXHJcbiAqICAgZW52aXJvbm1lbnRNYXBwaW5nOiB7XHJcbiAqICAgICBkZXZlbG9wbWVudDogJ2RldicsXHJcbiAqICAgICBzdGFnaW5nOiAnc3RnJyxcclxuICogICAgIHByb2R1Y3Rpb246ICdwcm9kJ1xyXG4gKiAgIH1cclxuICogfSk7XHJcbiAqIGBgYFxyXG4gKi9cclxuZXhwb3J0IGNsYXNzIFNlY3JldHNNYW5hZ2VyTG9hZGVyIGltcGxlbWVudHMgQ29uZmlnTG9hZGVyIHtcclxuICAvKiogQGludGVybmFsICovXHJcbiAgcHJvdGVjdGVkIHJlYWRvbmx5IF9jbGllbnQ6IFNlY3JldHNNYW5hZ2VyQ2xpZW50O1xyXG4gIC8qKiBAaW50ZXJuYWwgKi9cclxuICBwcm90ZWN0ZWQgcmVhZG9ubHkgX2NvbmZpZzogUmVxdWlyZWQ8U2VjcmV0c01hbmFnZXJMb2FkZXJDb25maWc+O1xyXG4gIC8qKiBAaW50ZXJuYWwgKi9cclxuICBwcm90ZWN0ZWQgcmVhZG9ubHkgX2FwcEVudjogc3RyaW5nO1xyXG5cclxuICBjb25zdHJ1Y3Rvcihjb25maWc6IFNlY3JldHNNYW5hZ2VyTG9hZGVyQ29uZmlnID0ge30pIHtcclxuICAgIHRoaXMuX2FwcEVudiA9IHByb2Nlc3MuZW52WydBUFBfRU5WJ10gfHwgcHJvY2Vzcy5lbnZbJ05PREVfRU5WJ10gfHwgJ2xvY2FsJztcclxuXHJcbiAgICAvLyBTZXQgZGVmYXVsdCBjb25maWd1cmF0aW9uXHJcbiAgICB0aGlzLl9jb25maWcgPSB7XHJcbiAgICAgIHNlY3JldE5hbWU6IGNvbmZpZy5zZWNyZXROYW1lIHx8ICcvbmVzdGpzLWNvbmZpZy1hd3MnLFxyXG4gICAgICByZWdpb246IGNvbmZpZy5yZWdpb24gfHwgcHJvY2Vzcy5lbnZbJ0FXU19SRUdJT04nXSB8fCAndXMtZWFzdC0xJyxcclxuICAgICAgZW52aXJvbm1lbnRNYXBwaW5nOiBjb25maWcuZW52aXJvbm1lbnRNYXBwaW5nIHx8IHtcclxuICAgICAgICBkZXZlbG9wbWVudDogJ2RldicsXHJcbiAgICAgICAgdGVzdDogJ3Rlc3QnLFxyXG4gICAgICAgIHByb2R1Y3Rpb246ICdwcm9kdWN0aW9uJyxcclxuICAgICAgfSxcclxuICAgIH07XHJcblxyXG4gICAgLy8gSW5pdGlhbGl6ZSBBV1MgU2VjcmV0cyBNYW5hZ2VyIGNsaWVudFxyXG4gICAgdGhpcy5fY2xpZW50ID0gbmV3IFNlY3JldHNNYW5hZ2VyQ2xpZW50KHtcclxuICAgICAgY3JlZGVudGlhbHM6IGZyb21Ob2RlUHJvdmlkZXJDaGFpbigpLFxyXG4gICAgICByZWdpb246IHRoaXMuX2NvbmZpZy5yZWdpb24sXHJcbiAgICB9KTtcclxuICB9XHJcblxyXG5cclxuICAvKipcclxuICAgKiBHZXQgdGhlIG5hbWUgb2YgdGhpcyBsb2FkZXIgZm9yIGxvZ2dpbmcgYW5kIGRlYnVnZ2luZy5cclxuICAgKiBAcmV0dXJucyBUaGUgbG9hZGVyIG5hbWUgd2l0aCBzZWNyZXQgcGF0aFxyXG4gICAqL1xyXG4gIGdldE5hbWUoKTogc3RyaW5nIHtcclxuICAgIGNvbnN0IHNlY3JldE5hbWUgPSB0aGlzLmJ1aWxkU2VjcmV0TmFtZSgpO1xyXG4gICAgcmV0dXJuIGBTZWNyZXRzTWFuYWdlckxvYWRlcigke3NlY3JldE5hbWV9KWA7XHJcbiAgfVxyXG5cclxuICAvKipcclxuICAgKiBDaGVjayBpZiB0aGlzIGxvYWRlciBpcyBhdmFpbGFibGUgaW4gdGhlIGN1cnJlbnQgZW52aXJvbm1lbnQuXHJcbiAgICogQHJldHVybnMgUHJvbWlzZSByZXNvbHZpbmcgdG8gdHJ1ZSBpZiBub3QgaW4gbG9jYWwgZW52aXJvbm1lbnQgYW5kIEFXUyBjcmVkZW50aWFscyBhcmUgYXZhaWxhYmxlXHJcbiAgICovXHJcbiAgYXN5bmMgaXNBdmFpbGFibGUoKTogUHJvbWlzZTxib29sZWFuPiB7XHJcbiAgICAvLyBTa2lwIGluIGxvY2FsIGVudmlyb25tZW50XHJcbiAgICBpZiAodGhpcy5fYXBwRW52ID09PSAnbG9jYWwnKSB7XHJcbiAgICAgIHJldHVybiBmYWxzZTtcclxuICAgIH1cclxuXHJcbiAgICB0cnkge1xyXG4gICAgICAvLyBUZXN0IEFXUyBjcmVkZW50aWFscyBieSBhdHRlbXB0aW5nIHRvIGdldCBjYWxsZXIgaWRlbnRpdHlcclxuICAgICAgYXdhaXQgdGhpcy5fY2xpZW50LmNvbmZpZy5jcmVkZW50aWFscygpO1xyXG4gICAgICByZXR1cm4gdHJ1ZTtcclxuICAgIH0gY2F0Y2gge1xyXG4gICAgICByZXR1cm4gZmFsc2U7XHJcbiAgICB9XHJcbiAgfVxyXG5cclxuICAvKipcclxuICAgKiBMb2FkIGNvbmZpZ3VyYXRpb24gZnJvbSBBV1MgU2VjcmV0cyBNYW5hZ2VyLlxyXG4gICAqIEByZXR1cm5zIFByb21pc2UgcmVzb2x2aW5nIHRvIGNvbmZpZ3VyYXRpb24ga2V5LXZhbHVlIHBhaXJzIGZyb20gdGhlIHNlY3JldFxyXG4gICAqIEB0aHJvd3MgQVdTU2VydmljZUVycm9yIGlmIEFXUyBvcGVyYXRpb24gZmFpbHNcclxuICAgKiBAdGhyb3dzIENvbmZpZ3VyYXRpb25Mb2FkRXJyb3IgaWYgc2VjcmV0IGNhbm5vdCBiZSBwYXJzZWRcclxuICAgKi9cclxuICBhc3luYyBsb2FkKCk6IFByb21pc2U8UmVjb3JkPHN0cmluZywgdW5rbm93bj4+IHtcclxuICAgIC8vIFNraXAgbG9hZGluZyBpbiBsb2NhbCBlbnZpcm9ubWVudFxyXG4gICAgaWYgKHRoaXMuX2FwcEVudiA9PT0gJ2xvY2FsJykge1xyXG4gICAgICByZXR1cm4ge307XHJcbiAgICB9XHJcblxyXG4gICAgY29uc3Qgc2VjcmV0TmFtZSA9IHRoaXMuYnVpbGRTZWNyZXROYW1lKCk7XHJcblxyXG4gICAgdHJ5IHtcclxuICAgICAgY29uc3QgY29tbWFuZCA9IG5ldyBHZXRTZWNyZXRWYWx1ZUNvbW1hbmQoeyBTZWNyZXRJZDogc2VjcmV0TmFtZSB9KTtcclxuICAgICAgY29uc3QgcmVzcG9uc2UgPSBhd2FpdCB0aGlzLl9jbGllbnQuc2VuZChjb21tYW5kKTtcclxuXHJcbiAgICAgIGlmICghcmVzcG9uc2UuU2VjcmV0U3RyaW5nKSB7XHJcbiAgICAgICAgcmV0dXJuIHt9O1xyXG4gICAgICB9XHJcblxyXG4gICAgICAvLyBUcnkgdG8gcGFyc2UgYXMgSlNPTiwgZmFsbGJhY2sgdG8gc3RyaW5nIHZhbHVlXHJcbiAgICAgIHRyeSB7XHJcbiAgICAgICAgY29uc3QgcGFyc2VkID0gSlNPTi5wYXJzZShyZXNwb25zZS5TZWNyZXRTdHJpbmcpO1xyXG5cclxuICAgICAgICAvLyBFbnN1cmUgd2UgcmV0dXJuIGFuIG9iamVjdCBmb3IgY29uZmlndXJhdGlvbiBtZXJnaW5nXHJcbiAgICAgICAgaWYgKHR5cGVvZiBwYXJzZWQgPT09ICdvYmplY3QnICYmIHBhcnNlZCAhPT0gbnVsbCAmJiAhQXJyYXkuaXNBcnJheShwYXJzZWQpKSB7XHJcbiAgICAgICAgICByZXR1cm4gcGFyc2VkO1xyXG4gICAgICAgIH0gZWxzZSB7XHJcbiAgICAgICAgICAvLyBJZiBpdCdzIG5vdCBhbiBvYmplY3QsIHdyYXAgaXQgaW4gYSBjb25maWd1cmF0aW9uIG9iamVjdFxyXG4gICAgICAgICAgcmV0dXJuIHsgU0VDUkVUX1ZBTFVFOiBwYXJzZWQgfTtcclxuICAgICAgICB9XHJcbiAgICAgIH0gY2F0Y2gge1xyXG4gICAgICAgIC8vIElmIEpTT04gcGFyc2luZyBmYWlscywgdHJlYXQgYXMgYSBzaW5nbGUgc3RyaW5nIHZhbHVlXHJcbiAgICAgICAgcmV0dXJuIHsgU0VDUkVUX1ZBTFVFOiByZXNwb25zZS5TZWNyZXRTdHJpbmcgfTtcclxuICAgICAgfVxyXG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcclxuICAgICAgLy8gSGFuZGxlIHNwZWNpZmljIEFXUyBlcnJvcnNcclxuICAgICAgaWYgKGVycm9yIGluc3RhbmNlb2YgRXJyb3IpIHtcclxuICAgICAgICBpZiAoZXJyb3IubmFtZSA9PT0gJ1Jlc291cmNlTm90Rm91bmRFeGNlcHRpb24nKSB7XHJcbiAgICAgICAgICAvLyBTZWNyZXQgZG9lc24ndCBleGlzdCAtIHRoaXMgaXMgbm90IG5lY2Vzc2FyaWx5IGFuIGVycm9yIGluIGFsbCBlbnZpcm9ubWVudHNcclxuICAgICAgICAgIHJldHVybiB7fTtcclxuICAgICAgICB9XHJcblxyXG4gICAgICAgIGlmIChlcnJvci5uYW1lID09PSAnQWNjZXNzRGVuaWVkRXhjZXB0aW9uJykge1xyXG4gICAgICAgICAgdGhyb3cgbmV3IEFXU1NlcnZpY2VFcnJvcihcclxuICAgICAgICAgICAgYEFjY2VzcyBkZW5pZWQgd2hlbiByZXRyaWV2aW5nIHNlY3JldCAnJHtzZWNyZXROYW1lfScuIENoZWNrIEFXUyBjcmVkZW50aWFscyBhbmQgcGVybWlzc2lvbnMuYCxcclxuICAgICAgICAgICAgJ1NlY3JldHNNYW5hZ2VyJyxcclxuICAgICAgICAgICAgJ0dldFNlY3JldFZhbHVlJyxcclxuICAgICAgICAgICAgZXJyb3IsXHJcbiAgICAgICAgICApO1xyXG4gICAgICAgIH1cclxuXHJcbiAgICAgICAgaWYgKGVycm9yLm5hbWUgPT09ICdJbnZhbGlkUmVxdWVzdEV4Y2VwdGlvbicpIHtcclxuICAgICAgICAgIHRocm93IG5ldyBBV1NTZXJ2aWNlRXJyb3IoXHJcbiAgICAgICAgICAgIGBJbnZhbGlkIHJlcXVlc3Qgd2hlbiByZXRyaWV2aW5nIHNlY3JldCAnJHtzZWNyZXROYW1lfScuIENoZWNrIHNlY3JldCBuYW1lIGZvcm1hdC5gLFxyXG4gICAgICAgICAgICAnU2VjcmV0c01hbmFnZXInLFxyXG4gICAgICAgICAgICAnR2V0U2VjcmV0VmFsdWUnLFxyXG4gICAgICAgICAgICBlcnJvcixcclxuICAgICAgICAgICk7XHJcbiAgICAgICAgfVxyXG4gICAgICB9XHJcblxyXG4gICAgICAvLyBGb3Igb3RoZXIgZXJyb3JzLCB3cmFwIGluIEFXU1NlcnZpY2VFcnJvclxyXG4gICAgICB0aHJvdyBuZXcgQVdTU2VydmljZUVycm9yKFxyXG4gICAgICAgIGBGYWlsZWQgdG8gcmV0cmlldmUgc2VjcmV0ICcke3NlY3JldE5hbWV9JyBmcm9tIEFXUyBTZWNyZXRzIE1hbmFnZXI6ICR7ZXJyb3IgaW5zdGFuY2VvZiBFcnJvciA/IGVycm9yLm1lc3NhZ2UgOiBTdHJpbmcoZXJyb3IpfWAsXHJcbiAgICAgICAgJ1NlY3JldHNNYW5hZ2VyJyxcclxuICAgICAgICAnR2V0U2VjcmV0VmFsdWUnLFxyXG4gICAgICAgIGVycm9yIGluc3RhbmNlb2YgRXJyb3IgPyBlcnJvciA6IHVuZGVmaW5lZCxcclxuICAgICAgKTtcclxuICAgIH1cclxuICB9XHJcblxyXG4gIC8qKlxyXG4gICAqIEJ1aWxkIHRoZSBlbnZpcm9ubWVudC1hd2FyZSBzZWNyZXQgbmFtZS9wYXRoLlxyXG4gICAqIEByZXR1cm5zIFRoZSBmdWxsIHNlY3JldCBuYW1lIHdpdGggZW52aXJvbm1lbnQgcHJlZml4XHJcbiAgICovXHJcbiAgYnVpbGRTZWNyZXROYW1lKCk6IHN0cmluZyB7XHJcbiAgICBjb25zdCBlbnZQcmVmaXggPSB0aGlzLl9jb25maWcuZW52aXJvbm1lbnRNYXBwaW5nW3RoaXMuX2FwcEVudl07XHJcblxyXG4gICAgaWYgKCFlbnZQcmVmaXgpIHtcclxuICAgICAgdGhyb3cgbmV3IENvbmZpZ3VyYXRpb25Mb2FkRXJyb3IoXHJcbiAgICAgICAgYE5vIGVudmlyb25tZW50IG1hcHBpbmcgZm91bmQgZm9yIEFQUF9FTlYgJyR7dGhpcy5fYXBwRW52fScuIGAgK1xyXG4gICAgICAgICAgYEF2YWlsYWJsZSBlbnZpcm9ubWVudHM6ICR7T2JqZWN0LmtleXModGhpcy5fY29uZmlnLmVudmlyb25tZW50TWFwcGluZykuam9pbignLCAnKX1gLFxyXG4gICAgICAgIHRoaXMuZ2V0TmFtZSgpLFxyXG4gICAgICApO1xyXG4gICAgfVxyXG5cclxuICAgIHJldHVybiBgLyR7ZW52UHJlZml4fSR7dGhpcy5fY29uZmlnLnNlY3JldE5hbWV9YDtcclxuICB9XHJcblxyXG4gIC8qKlxyXG4gICAqIEdldCB0aGUgY3VycmVudCBhcHAgZW52aXJvbm1lbnQuXHJcbiAgICogQHJldHVybnMgVGhlIGN1cnJlbnQgQVBQX0VOViBvciBOT0RFX0VOViB2YWx1ZVxyXG4gICAqL1xyXG4gIGdldEFwcEVudigpOiBzdHJpbmcge1xyXG4gICAgcmV0dXJuIHRoaXMuX2FwcEVudjtcclxuICB9XHJcblxyXG4gIC8qKlxyXG4gICAqIEdldCB0aGUgZW52aXJvbm1lbnQgbWFwcGluZyBjb25maWd1cmF0aW9uLlxyXG4gICAqIEByZXR1cm5zIFRoZSBlbnZpcm9ubWVudCBtYXBwaW5nIHJlY29yZFxyXG4gICAqL1xyXG4gIGdldEVudmlyb25tZW50TWFwcGluZygpOiBSZWNvcmQ8c3RyaW5nLCBzdHJpbmc+IHtcclxuICAgIHJldHVybiB7IC4uLnRoaXMuX2NvbmZpZy5lbnZpcm9ubWVudE1hcHBpbmcgfTtcclxuICB9XHJcbn1cclxuIl19
@@ -0,0 +1,195 @@
1
+ import { GetParametersByPathCommand, SSMClient } from '@aws-sdk/client-ssm';
2
+ import { fromNodeProviderChain } from '@aws-sdk/credential-providers';
3
+ import { AWSServiceError, ConfigurationLoadError } from '../errors';
4
+ /**
5
+ * Loader that reads configuration from AWS SSM Parameter Store.
6
+ * Supports environment-aware path construction, pagination, and decryption options.
7
+ *
8
+ * @example
9
+ * ```typescript
10
+ * // Basic usage
11
+ * const loader = new SSMParameterStoreLoader({
12
+ * parameterPath: '/my-app/config',
13
+ * region: 'us-east-1'
14
+ * });
15
+ *
16
+ * // With environment mapping
17
+ * const loader = new SSMParameterStoreLoader({
18
+ * parameterPath: '/my-app/config',
19
+ * environmentMapping: {
20
+ * development: 'dev',
21
+ * staging: 'stg',
22
+ * production: 'prod'
23
+ * }
24
+ * });
25
+ * ```
26
+ */
27
+ export class SSMParameterStoreLoader {
28
+ /** @internal */
29
+ _client;
30
+ /** @internal */
31
+ _config;
32
+ /** @internal */
33
+ _appEnv;
34
+ constructor(config = {}) {
35
+ this._appEnv = process.env['APP_ENV'] || process.env['NODE_ENV'] || 'local';
36
+ // Set default configuration
37
+ this._config = {
38
+ parameterPath: config.parameterPath || '/config-aws',
39
+ region: config.region || process.env['AWS_REGION'] || 'us-east-1',
40
+ environmentMapping: config.environmentMapping || {
41
+ development: 'dev',
42
+ test: 'test',
43
+ production: 'production',
44
+ },
45
+ withDecryption: config.withDecryption ?? true,
46
+ };
47
+ // Initialize AWS SSM client
48
+ this._client = new SSMClient({
49
+ credentials: fromNodeProviderChain(),
50
+ region: this._config.region,
51
+ });
52
+ }
53
+ /**
54
+ * Get the name of this loader for logging and debugging.
55
+ * @returns The loader name with parameter path
56
+ */
57
+ getName() {
58
+ try {
59
+ const parameterPath = this.buildParameterPath();
60
+ return `SSMParameterStoreLoader(${parameterPath})`;
61
+ }
62
+ catch {
63
+ // Fallback if path construction fails (e.g., missing env mapping)
64
+ return `SSMParameterStoreLoader(${this._config.parameterPath})`;
65
+ }
66
+ }
67
+ /**
68
+ * Check if this loader is available in the current environment.
69
+ * @returns Promise resolving to true if not in local environment and AWS credentials are available
70
+ */
71
+ async isAvailable() {
72
+ // Skip in local environment
73
+ if (this._appEnv === 'local') {
74
+ return false;
75
+ }
76
+ try {
77
+ // Test AWS credentials by attempting to get caller identity
78
+ await this._client.config.credentials();
79
+ return true;
80
+ }
81
+ catch {
82
+ return false;
83
+ }
84
+ }
85
+ /**
86
+ * Load configuration from AWS SSM Parameter Store.
87
+ * Implements recursive parameter fetching with NextToken handling for pagination.
88
+ * @returns Promise resolving to configuration key-value pairs from parameters
89
+ * @throws AWSServiceError if AWS operation fails
90
+ * @throws ConfigurationLoadError if parameter path cannot be constructed
91
+ */
92
+ async load() {
93
+ // Skip loading in local environment
94
+ if (this._appEnv === 'local') {
95
+ return {};
96
+ }
97
+ const parameterPath = this.buildParameterPath();
98
+ const result = {};
99
+ let nextToken;
100
+ try {
101
+ do {
102
+ const command = new GetParametersByPathCommand({
103
+ Path: parameterPath,
104
+ Recursive: true,
105
+ WithDecryption: this._config.withDecryption,
106
+ NextToken: nextToken,
107
+ });
108
+ const response = await this._client.send(command);
109
+ if (!response.Parameters) {
110
+ // No parameters found - this is not necessarily an error
111
+ break;
112
+ }
113
+ // Process each parameter
114
+ for (const param of response.Parameters) {
115
+ const key = this.transformParameterName(param.Name, parameterPath);
116
+ if (key && param.Value !== undefined) {
117
+ result[key] = param.Value;
118
+ }
119
+ }
120
+ nextToken = response.NextToken;
121
+ } while (nextToken);
122
+ return result;
123
+ }
124
+ catch (error) {
125
+ // Handle specific AWS errors
126
+ if (error instanceof Error) {
127
+ if (error.name === 'ResourceNotFoundException' || error.name === 'ParameterNotFound') {
128
+ // No parameters found at path - this is not necessarily an error
129
+ return {};
130
+ }
131
+ if (error.name === 'AccessDeniedException') {
132
+ throw new AWSServiceError(`Access denied when retrieving parameters from path '${parameterPath}'. Check AWS credentials and permissions.`, 'SSM', 'GetParametersByPath', error);
133
+ }
134
+ if (error.name === 'InvalidFilterKey' || error.name === 'InvalidFilterValue') {
135
+ throw new AWSServiceError(`Invalid parameter path '${parameterPath}'. Check path format.`, 'SSM', 'GetParametersByPath', error);
136
+ }
137
+ }
138
+ // For other errors, wrap in AWSServiceError
139
+ throw new AWSServiceError(`Failed to retrieve parameters from path '${parameterPath}' in AWS SSM Parameter Store: ${error instanceof Error ? error.message : String(error)}`, 'SSM', 'GetParametersByPath', error instanceof Error ? error : undefined);
140
+ }
141
+ }
142
+ /**
143
+ * Build the environment-aware parameter path.
144
+ * @returns The full parameter path with environment prefix
145
+ * @throws ConfigurationLoadError if no environment mapping found
146
+ */
147
+ buildParameterPath() {
148
+ const envPrefix = this._config.environmentMapping[this._appEnv];
149
+ if (!envPrefix) {
150
+ throw new ConfigurationLoadError(`No environment mapping found for APP_ENV '${this._appEnv}'. ` +
151
+ `Available environments: ${Object.keys(this._config.environmentMapping).join(', ')}`, this.getName());
152
+ }
153
+ return `/${envPrefix}${this._config.parameterPath}`;
154
+ }
155
+ /**
156
+ * Transform parameter name by removing the prefix and converting to uppercase.
157
+ * Example: '/dev/config-aws/database/host' -> 'DATABASE_HOST'
158
+ * @param parameterName The full parameter name from AWS
159
+ * @param pathPrefix The path prefix to remove
160
+ * @returns The transformed parameter name or null if invalid
161
+ */
162
+ transformParameterName(parameterName, pathPrefix) {
163
+ if (!parameterName) {
164
+ return null;
165
+ }
166
+ // Remove the path prefix
167
+ let key = parameterName;
168
+ if (key.startsWith(pathPrefix)) {
169
+ key = key.substring(pathPrefix.length);
170
+ }
171
+ // Remove leading slash if present
172
+ if (key.startsWith('/')) {
173
+ key = key.substring(1);
174
+ }
175
+ // Convert slashes to underscores and uppercase
176
+ key = key.replace(/\//g, '_').toUpperCase();
177
+ // Return null for empty keys
178
+ return key || null;
179
+ }
180
+ /**
181
+ * Get the current app environment.
182
+ * @returns The current APP_ENV or NODE_ENV value
183
+ */
184
+ getAppEnv() {
185
+ return this._appEnv;
186
+ }
187
+ /**
188
+ * Get the environment mapping configuration.
189
+ * @returns The environment mapping record
190
+ */
191
+ getEnvironmentMapping() {
192
+ return { ...this._config.environmentMapping };
193
+ }
194
+ }
195
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3NtLXBhcmFtZXRlci1zdG9yZS5sb2FkZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9jb25maWctYXdzL3NyYy9sb2FkZXJzL3NzbS1wYXJhbWV0ZXItc3RvcmUubG9hZGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSwwQkFBMEIsRUFBRSxTQUFTLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUM1RSxPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUl0RSxPQUFPLEVBQUUsZUFBZSxFQUFFLHNCQUFzQixFQUFFLE1BQU0sV0FBVyxDQUFDO0FBRXBFOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBc0JHO0FBQ0gsTUFBTSxPQUFPLHVCQUF1QjtJQUNsQyxnQkFBZ0I7SUFDRyxPQUFPLENBQVk7SUFDdEMsZ0JBQWdCO0lBQ0csT0FBTyxDQUEwQztJQUNwRSxnQkFBZ0I7SUFDRyxPQUFPLENBQVM7SUFFbkMsWUFBWSxTQUF3QyxFQUFFO1FBQ3BELElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyxTQUFTLENBQUMsSUFBSSxPQUFPLENBQUMsR0FBRyxDQUFDLFVBQVUsQ0FBQyxJQUFJLE9BQU8sQ0FBQztRQUU1RSw0QkFBNEI7UUFDNUIsSUFBSSxDQUFDLE9BQU8sR0FBRztZQUNiLGFBQWEsRUFBRSxNQUFNLENBQUMsYUFBYSxJQUFJLGFBQWE7WUFDcEQsTUFBTSxFQUFFLE1BQU0sQ0FBQyxNQUFNLElBQUksT0FBTyxDQUFDLEdBQUcsQ0FBQyxZQUFZLENBQUMsSUFBSSxXQUFXO1lBQ2pFLGtCQUFrQixFQUFFLE1BQU0sQ0FBQyxrQkFBa0IsSUFBSTtnQkFDL0MsV0FBVyxFQUFFLEtBQUs7Z0JBQ2xCLElBQUksRUFBRSxNQUFNO2dCQUNaLFVBQVUsRUFBRSxZQUFZO2FBQ3pCO1lBQ0QsY0FBYyxFQUFFLE1BQU0sQ0FBQyxjQUFjLElBQUksSUFB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QUFFLEVBQ3RGLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FDZixDQUFDO1FBQ0osQ0FBQztRQUVELE9BQU8sSUFBSSxTQUFTLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxhQUFhLEVBQUUsQ0FBQztJQUN0RCxDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ0ssc0JBQXNCLENBQUMsYUFBaUMsRUFBRSxVQUFrQjtRQUNsRixJQUFJLENBQUMsYUFBYSxFQUFFLENBQUM7WUFDbkIsT0FBTyxJQUFJLENBQUM7UUFDZCxDQUFDO1FBRUQseUJBQXlCO1FBQ3pCLElBQUksR0FBRyxHQUFHLGFBQWEsQ0FBQztRQUN4QixJQUFJLEdBQUcsQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDLEVBQUUsQ0FBQztZQUMvQixHQUFHLEdBQUcsR0FBRyxDQUFDLFNBQVMsQ0FBQyxVQUFVLENBQUMsTUFBTSxDQUFDLENBQUM7UUFDekMsQ0FBQztRQUVELGtDQUFrQztRQUNsQyxJQUFJLEdBQUcsQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUN4QixHQUFHLEdBQUcsR0FBRyxDQUFDLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQztRQUN6QixDQUFDO1FBRUQsK0NBQStDO1FBQy9DLEdBQUcsR0FBRyxHQUFHLENBQUMsT0FBTyxDQUFDLEtBQUssRUFBRSxHQUFHLENBQUMsQ0FBQyxXQUFXLEVBQUUsQ0FBQztRQUU1Qyw2QkFBNkI7UUFDN0IsT0FBTyxHQUFHLElBQUksSUFBSSxDQUFDO0lBQ3JCLENBQUM7SUFFRDs7O09BR0c7SUFDSCxTQUFTO1FBQ1AsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDO0lBQ3RCLENBQUM7SUFFRDs7O09BR0c7SUFDSCxxQkFBcUI7UUFDbkIsT0FBTyxFQUFFLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyxrQkFBa0IsRUFBRSxDQUFDO0lBQ2hELENBQUM7Q0FDRiIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IEdldFBhcmFtZXRlcnNCeVBhdGhDb21tYW5kLCBTU01DbGllbnQgfSBmcm9tICdAYXdzLXNkay9jbGllbnQtc3NtJztcclxuaW1wb3J0IHsgZnJvbU5vZGVQcm92aWRlckNoYWluIH0gZnJvbSAnQGF3cy1zZGsvY3JlZGVudGlhbC1wcm92aWRlcnMnO1xyXG5cclxuaW1wb3J0IHR5cGUgeyBDb25maWdMb2FkZXIgfSBmcm9tICcuLi9pbnRlcmZhY2VzL2NvbmZpZy1sb2FkZXIuaW50ZXJmYWNlJztcclxuaW1wb3J0IHR5cGUgeyBTU01QYXJhbWV0ZXJTdG9yZUxvYWRlckNvbmZpZyB9IGZyb20gJy4uL2ludGVyZmFjZXMvc3NtLXBhcmFtZXRlci1zdG9yZS1sb2FkZXIuaW50ZXJmYWNlJztcclxuaW1wb3J0IHsgQVdTU2VydmljZUVycm9yLCBDb25maWd1cmF0aW9uTG9hZEVycm9yIH0gZnJvbSAnLi4vZXJyb3JzJztcclxuXHJcbi8qKlxyXG4gKiBMb2FkZXIgdGhhdCByZWFkcyBjb25maWd1cmF0aW9uIGZyb20gQVdTIFNTTSBQYXJhbWV0ZXIgU3RvcmUuXHJcbiAqIFN1cHBvcnRzIGVudmlyb25tZW50LWF3YXJlIHBhdGggY29uc3RydWN0aW9uLCBwYWdpbmF0aW9uLCBhbmQgZGVjcnlwdGlvbiBvcHRpb25zLlxyXG4gKlxyXG4gKiBAZXhhbXBsZVxyXG4gKiBgYGB0eXBlc2NyaXB0XHJcbiAqIC8vIEJhc2ljIHVzYWdlXHJcbiAqIGNvbnN0IGxvYWRlciA9IG5ldyBTU01QYXJhbWV0ZXJTdG9yZUxvYWRlcih7XHJcbiAqICAgcGFyYW1ldGVyUGF0aDogJy9teS1hcHAvY29uZmlnJyxcclxuICogICByZWdpb246ICd1cy1lYXN0LTEnXHJcbiAqIH0pO1xyXG4gKlxyXG4gKiAvLyBXaXRoIGVudmlyb25tZW50IG1hcHBpbmdcclxuICogY29uc3QgbG9hZGVyID0gbmV3IFNTTVBhcmFtZXRlclN0b3JlTG9hZGVyKHtcclxuICogICBwYXJhbWV0ZXJQYXRoOiAnL215LWFwcC9jb25maWcnLFxyXG4gKiAgIGVudmlyb25tZW50TWFwcGluZzoge1xyXG4gKiAgICAgZGV2ZWxvcG1lbnQ6ICdkZXYnLFxyXG4gKiAgICAgc3RhZ2luZzogJ3N0ZycsXHJcbiAqICAgICBwcm9kdWN0aW9uOiAncHJvZCdcclxuICogICB9XHJcbiAqIH0pO1xyXG4gKiBgYGBcclxuICovXHJcbmV4cG9ydCBjbGFzcyBTU01QYXJhbWV0ZXJTdG9yZUxvYWRlciBpbXBsZW1lbnRzIENvbmZpZ0xvYWRlciB7XHJcbiAgLyoqIEBpbnRlcm5hbCAqL1xyXG4gIHByb3RlY3RlZCByZWFkb25seSBfY2xpZW50OiBTU01DbGllbnQ7XHJcbiAgLyoqIEBpbnRlcm5hbCAqL1xyXG4gIHByb3RlY3RlZCByZWFkb25seSBfY29uZmlnOiBSZXF1aXJlZDxTU01QYXJhbWV0ZXJTdG9yZUxvYWRlckNvbmZpZz47XHJcbiAgLyoqIEBpbnRlcm5hbCAqL1xyXG4gIHByb3RlY3RlZCByZWFkb25seSBfYXBwRW52OiBzdHJpbmc7XHJcblxyXG4gIGNvbnN0cnVjdG9yKGNvbmZpZzogU1NNUGFyYW1ldGVyU3RvcmVMb2FkZXJDb25maWcgPSB7fSkge1xyXG4gICAgdGhpcy5fYXBwRW52ID0gcHJvY2Vzcy5lbnZbJ0FQUF9FTlYnXSB8fCBwcm9jZXNzLmVudlsnTk9ERV9FTlYnXSB8fCAnbG9jYWwnO1xyXG5cclxuICAgIC8vIFNldCBkZWZhdWx0IGNvbmZpZ3VyYXRpb25cclxuICAgIHRoaXMuX2NvbmZpZyA9IHtcclxuICAgICAgcGFyYW1ldGVyUGF0aDogY29uZmlnLnBhcmFtZXRlclBhdGggfHwgJy9jb25maWctYXdzJyxcclxuICAgICAgcmVnaW9uOiBjb25maWcucmVnaW9uIHx8IHByb2Nlc3MuZW52WydBV1NfUkVHSU9OJ10gfHwgJ3VzLWVhc3QtMScsXHJcbiAgICAgIGVudmlyb25tZW50TWFwcGluZzogY29uZmlnLmVudmlyb25tZW50TWFwcGluZyB8fCB7XHJcbiAgICAgICAgZGV2ZWxvcG1lbnQ6ICdkZXYnLFxyXG4gICAgICAgIHRlc3Q6ICd0ZXN0JyxcclxuICAgICAgICBwcm9kdWN0aW9uOiAncHJvZHVjdGlvbicsXHJcbiAgICAgIH0sXHJcbiAgICAgIHdpdGhEZWNyeXB0aW9uOiBjb25maWcud2l0aERlY3J5cHRpb24gPz8gdHJ1ZSxcclxuICAgIH07XHJcblxyXG4gICAgLy8gSW5pdGlhbGl6ZSBBV1MgU1NNIGNsaWVudFxyXG4gICAgdGhpcy5fY2xpZW50ID0gbmV3IFNTTUNsaWVudCh7XHJcbiAgICAgIGNyZWRlbnRpYWxzOiBmcm9tTm9kZVByb3ZpZGVyQ2hhaW4oKSxcclxuICAgICAgcmVnaW9uOiB0aGlzLl9jb25maWcucmVnaW9uLFxyXG4gICAgfSk7XHJcbiAgfVxyXG5cclxuXHJcbiAgLyoqXHJcbiAgICogR2V0IHRoZSBuYW1lIG9mIHRoaXMgbG9hZGVyIGZvciBsb2dnaW5nIGFuZCBkZWJ1Z2dpbmcuXHJcbiAgICogQHJldHVybnMgVGhlIGxvYWRlciBuYW1lIHdpdGggcGFyYW1ldGVyIHBhdGhcclxuICAgKi9cclxuICBnZXROYW1lKCk6IHN0cmluZyB7XHJcbiAgICB0cnkge1xyXG4gICAgICBjb25zdCBwYXJhbWV0ZXJQYXRoID0gdGhpcy5idWlsZFBhcmFtZXRlclBhdGgoKTtcclxuICAgICAgcmV0dXJuIGBTU01QYXJhbWV0ZXJTdG9yZUxvYWRlcigke3BhcmFtZXRlclBhdGh9KWA7XHJcbiAgICB9IGNhdGNoIHtcclxuICAgICAgLy8gRmFsbGJhY2sgaWYgcGF0aCBjb25zdHJ1Y3Rpb24gZmFpbHMgKGUuZy4sIG1pc3NpbmcgZW52IG1hcHBpbmcpXHJcbiAgICAgIHJldHVybiBgU1NNUGFyYW1ldGVyU3RvcmVMb2FkZXIoJHt0aGlzLl9jb25maWcucGFyYW1ldGVyUGF0aH0pYDtcclxuICAgIH1cclxuICB9XHJcblxyXG4gIC8qKlxyXG4gICAqIENoZWNrIGlmIHRoaXMgbG9hZGVyIGlzIGF2YWlsYWJsZSBpbiB0aGUgY3VycmVudCBlbnZpcm9ubWVudC5cclxuICAgKiBAcmV0dXJucyBQcm9taXNlIHJlc29sdmluZyB0byB0cnVlIGlmIG5vdCBpbiBsb2NhbCBlbnZpcm9ubWVudCBhbmQgQVdTIGNyZWRlbnRpYWxzIGFyZSBhdmFpbGFibGVcclxuICAgKi9cclxuICBhc3luYyBpc0F2YWlsYWJsZSgpOiBQcm9taXNlPGJvb2xlYW4+IHtcclxuICAgIC8vIFNraXAgaW4gbG9jYWwgZW52aXJvbm1lbnRcclxuICAgIGlmICh0aGlzLl9hcHBFbnYgPT09ICdsb2NhbCcpIHtcclxuICAgICAgcmV0dXJuIGZhbHNlO1xyXG4gICAgfVxyXG5cclxuICAgIHRyeSB7XHJcbiAgICAgIC8vIFRlc3QgQVdTIGNyZWRlbnRpYWxzIGJ5IGF0dGVtcHRpbmcgdG8gZ2V0IGNhbGxlciBpZGVudGl0eVxyXG4gICAgICBhd2FpdCB0aGlzLl9jbGllbnQuY29uZmlnLmNyZWRlbnRpYWxzKCk7XHJcbiAgICAgIHJldHVybiB0cnVlO1xyXG4gICAgfSBjYXRjaCB7XHJcbiAgICAgIHJldHVybiBmYWxzZTtcclxuICAgIH1cclxuICB9XHJcblxyXG4gIC8qKlxyXG4gICAqIExvYWQgY29uZmlndXJhdGlvbiBmcm9tIEFXUyBTU00gUGFyYW1ldGVyIFN0b3JlLlxyXG4gICAqIEltcGxlbWVudHMgcmVjdXJzaXZlIHBhcmFtZXRlciBmZXRjaGluZyB3aXRoIE5leHRUb2tlbiBoYW5kbGluZyBmb3IgcGFnaW5hdGlvbi5cclxuICAgKiBAcmV0dXJucyBQcm9taXNlIHJlc29sdmluZyB0byBjb25maWd1cmF0aW9uIGtleS12YWx1ZSBwYWlycyBmcm9tIHBhcmFtZXRlcnNcclxuICAgKiBAdGhyb3dzIEFXU1NlcnZpY2VFcnJvciBpZiBBV1Mgb3BlcmF0aW9uIGZhaWxzXHJcbiAgICogQHRocm93cyBDb25maWd1cmF0aW9uTG9hZEVycm9yIGlmIHBhcmFtZXRlciBwYXRoIGNhbm5vdCBiZSBjb25zdHJ1Y3RlZFxyXG4gICAqL1xyXG4gIGFzeW5jIGxvYWQoKTogUHJvbWlzZTxSZWNvcmQ8c3RyaW5nLCB1bmtub3duPj4ge1xyXG4gICAgLy8gU2tpcCBsb2FkaW5nIGluIGxvY2FsIGVudmlyb25tZW50XHJcbiAgICBpZiAodGhpcy5fYXBwRW52ID09PSAnbG9jYWwnKSB7XHJcbiAgICAgIHJldHVybiB7fTtcclxuICAgIH1cclxuXHJcbiAgICBjb25zdCBwYXJhbWV0ZXJQYXRoID0gdGhpcy5idWlsZFBhcmFtZXRlclBhdGgoKTtcclxuICAgIGNvbnN0IHJlc3VsdDogUmVjb3JkPHN0cmluZywgc3RyaW5nPiA9IHt9O1xyXG4gICAgbGV0IG5leHRUb2tlbjogc3RyaW5nIHwgdW5kZWZpbmVkO1xyXG5cclxuICAgIHRyeSB7XHJcbiAgICAgIGRvIHtcclxuICAgICAgICBjb25zdCBjb21tYW5kID0gbmV3IEdldFBhcmFtZXRlcnNCeVBhdGhDb21tYW5kKHtcclxuICAgICAgICAgIFBhdGg6IHBhcmFtZXRlclBhdGgsXHJcbiAgICAgICAgICBSZWN1cnNpdmU6IHRydWUsXHJcbiAgICAgICAgICBXaXRoRGVjcnlwdGlvbjogdGhpcy5fY29uZmlnLndpdGhEZWNyeXB0aW9uLFxyXG4gICAgICAgICAgTmV4dFRva2VuOiBuZXh0VG9rZW4sXHJcbiAgICAgICAgfSk7XHJcblxyXG4gICAgICAgIGNvbnN0IHJlc3BvbnNlID0gYXdhaXQgdGhpcy5fY2xpZW50LnNlbmQoY29tbWFuZCk7XHJcblxyXG4gICAgICAgIGlmICghcmVzcG9uc2UuUGFyYW1ldGVycykge1xyXG4gICAgICAgICAgLy8gTm8gcGFyYW1ldGVycyBmb3VuZCAtIHRoaXMgaXMgbm90IG5lY2Vzc2FyaWx5IGFuIGVycm9yXHJcbiAgICAgICAgICBicmVhaztcclxuICAgICAgICB9XHJcblxyXG4gICAgICAgIC8vIFByb2Nlc3MgZWFjaCBwYXJhbWV0ZXJcclxuICAgICAgICBmb3IgKGNvbnN0IHBhcmFtIG9mIHJlc3BvbnNlLlBhcmFtZXRlcnMpIHtcclxuICAgICAgICAgIGNvbnN0IGtleSA9IHRoaXMudHJhbnNmb3JtUGFyYW1ldGVyTmFtZShwYXJhbS5OYW1lLCBwYXJhbWV0ZXJQYXRoKTtcclxuXHJcbiAgICAgICAgICBpZiAoa2V5ICYmIHBhcmFtLlZhbHVlICE9PSB1bmRlZmluZWQpIHtcclxuICAgICAgICAgICAgcmVzdWx0W2tleV0gPSBwYXJhbS5WYWx1ZTtcclxuICAgICAgICAgIH1cclxuICAgICAgICB9XHJcblxyXG4gICAgICAgIG5leHRUb2tlbiA9IHJlc3BvbnNlLk5leHRUb2tlbjtcclxuICAgICAgfSB3aGlsZSAobmV4dFRva2VuKTtcclxuXHJcbiAgICAgIHJldHVybiByZXN1bHQ7XHJcbiAgICB9IGNhdGNoIChlcnJvcikge1xyXG4gICAgICAvLyBIYW5kbGUgc3BlY2lmaWMgQVdTIGVycm9yc1xyXG4gICAgICBpZiAoZXJyb3IgaW5zdGFuY2VvZiBFcnJvcikge1xyXG4gICAgICAgIGlmIChlcnJvci5uYW1lID09PSAnUmVzb3VyY2VOb3RGb3VuZEV4Y2VwdGlvbicgfHwgZXJyb3IubmFtZSA9PT0gJ1BhcmFtZXRlck5vdEZvdW5kJykge1xyXG4gICAgICAgICAgLy8gTm8gcGFyYW1ldGVycyBmb3VuZCBhdCBwYXRoIC0gdGhpcyBpcyBub3QgbmVjZXNzYXJpbHkgYW4gZXJyb3JcclxuICAgICAgICAgIHJldHVybiB7fTtcclxuICAgICAgICB9XHJcblxyXG4gICAgICAgIGlmIChlcnJvci5uYW1lID09PSAnQWNjZXNzRGVuaWVkRXhjZXB0aW9uJykge1xyXG4gICAgICAgICAgdGhyb3cgbmV3IEFXU1NlcnZpY2VFcnJvcihcclxuICAgICAgICAgICAgYEFjY2VzcyBkZW5pZWQgd2hlbiByZXRyaWV2aW5nIHBhcmFtZXRlcnMgZnJvbSBwYXRoICcke3BhcmFtZXRlclBhdGh9Jy4gQ2hlY2sgQVdTIGNyZWRlbnRpYWxzIGFuZCBwZXJtaXNzaW9ucy5gLFxyXG4gICAgICAgICAgICAnU1NNJyxcclxuICAgICAgICAgICAgJ0dldFBhcmFtZXRlcnNCeVBhdGgnLFxyXG4gICAgICAgICAgICBlcnJvcixcclxuICAgICAgICAgICk7XHJcbiAgICAgICAgfVxyXG5cclxuICAgICAgICBpZiAoZXJyb3IubmFtZSA9PT0gJ0ludmFsaWRGaWx0ZXJLZXknIHx8IGVycm9yLm5hbWUgPT09ICdJbnZhbGlkRmlsdGVyVmFsdWUnKSB7XHJcbiAgICAgICAgICB0aHJvdyBuZXcgQVdTU2VydmljZUVycm9yKFxyXG4gICAgICAgICAgICBgSW52YWxpZCBwYXJhbWV0ZXIgcGF0aCAnJHtwYXJhbWV0ZXJQYXRofScuIENoZWNrIHBhdGggZm9ybWF0LmAsXHJcbiAgICAgICAgICAgICdTU00nLFxyXG4gICAgICAgICAgICAnR2V0UGFyYW1ldGVyc0J5UGF0aCcsXHJcbiAgICAgICAgICAgIGVycm9yLFxyXG4gICAgICAgICAgKTtcclxuICAgICAgICB9XHJcbiAgICAgIH1cclxuXHJcbiAgICAgIC8vIEZvciBvdGhlciBlcnJvcnMsIHdyYXAgaW4gQVdTU2VydmljZUVycm9yXHJcbiAgICAgIHRocm93IG5ldyBBV1NTZXJ2aWNlRXJyb3IoXHJcbiAgICAgICAgYEZhaWxlZCB0byByZXRyaWV2ZSBwYXJhbWV0ZXJzIGZyb20gcGF0aCAnJHtwYXJhbWV0ZXJQYXRofScgaW4gQVdTIFNTTSBQYXJhbWV0ZXIgU3RvcmU6ICR7ZXJyb3IgaW5zdGFuY2VvZiBFcnJvciA/IGVycm9yLm1lc3NhZ2UgOiBTdHJpbmcoZXJyb3IpfWAsXHJcbiAgICAgICAgJ1NTTScsXHJcbiAgICAgICAgJ0dldFBhcmFtZXRlcnNCeVBhdGgnLFxyXG4gICAgICAgIGVycm9yIGluc3RhbmNlb2YgRXJyb3IgPyBlcnJvciA6IHVuZGVmaW5lZCxcclxuICAgICAgKTtcclxuICAgIH1cclxuICB9XHJcblxyXG5cclxuICAvKipcclxuICAgKiBCdWlsZCB0aGUgZW52aXJvbm1lbnQtYXdhcmUgcGFyYW1ldGVyIHBhdGguXHJcbiAgICogQHJldHVybnMgVGhlIGZ1bGwgcGFyYW1ldGVyIHBhdGggd2l0aCBlbnZpcm9ubWVudCBwcmVmaXhcclxuICAgKiBAdGhyb3dzIENvbmZpZ3VyYXRpb25Mb2FkRXJyb3IgaWYgbm8gZW52aXJvbm1lbnQgbWFwcGluZyBmb3VuZFxyXG4gICAqL1xyXG4gIGJ1aWxkUGFyYW1ldGVyUGF0aCgpOiBzdHJpbmcge1xyXG4gICAgY29uc3QgZW52UHJlZml4ID0gdGhpcy5fY29uZmlnLmVudmlyb25tZW50TWFwcGluZ1t0aGlzLl9hcHBFbnZdO1xyXG5cclxuICAgIGlmICghZW52UHJlZml4KSB7XHJcbiAgICAgIHRocm93IG5ldyBDb25maWd1cmF0aW9uTG9hZEVycm9yKFxyXG4gICAgICAgIGBObyBlbnZpcm9ubWVudCBtYXBwaW5nIGZvdW5kIGZvciBBUFBfRU5WICcke3RoaXMuX2FwcEVudn0nLiBgICtcclxuICAgICAgICAgIGBBdmFpbGFibGUgZW52aXJvbm1lbnRzOiAke09iamVjdC5rZXlzKHRoaXMuX2NvbmZpZy5lbnZpcm9ubWVudE1hcHBpbmcpLmpvaW4oJywgJyl9YCxcclxuICAgICAgICB0aGlzLmdldE5hbWUoKSxcclxuICAgICAgKTtcclxuICAgIH1cclxuXHJcbiAgICByZXR1cm4gYC8ke2VudlByZWZpeH0ke3RoaXMuX2NvbmZpZy5wYXJhbWV0ZXJQYXRofWA7XHJcbiAgfVxyXG5cclxuICAvKipcclxuICAgKiBUcmFuc2Zvcm0gcGFyYW1ldGVyIG5hbWUgYnkgcmVtb3ZpbmcgdGhlIHByZWZpeCBhbmQgY29udmVydGluZyB0byB1cHBlcmNhc2UuXHJcbiAgICogRXhhbXBsZTogJy9kZXYvY29uZmlnLWF3cy9kYXRhYmFzZS9ob3N0JyAtPiAnREFUQUJBU0VfSE9TVCdcclxuICAgKiBAcGFyYW0gcGFyYW1ldGVyTmFtZSBUaGUgZnVsbCBwYXJhbWV0ZXIgbmFtZSBmcm9tIEFXU1xyXG4gICAqIEBwYXJhbSBwYXRoUHJlZml4IFRoZSBwYXRoIHByZWZpeCB0byByZW1vdmVcclxuICAgKiBAcmV0dXJucyBUaGUgdHJhbnNmb3JtZWQgcGFyYW1ldGVyIG5hbWUgb3IgbnVsbCBpZiBpbnZhbGlkXHJcbiAgICovXHJcbiAgcHJpdmF0ZSB0cmFuc2Zvcm1QYXJhbWV0ZXJOYW1lKHBhcmFtZXRlck5hbWU6IHN0cmluZyB8IHVuZGVmaW5lZCwgcGF0aFByZWZpeDogc3RyaW5nKTogc3RyaW5nIHwgbnVsbCB7XHJcbiAgICBpZiAoIXBhcmFtZXRlck5hbWUpIHtcclxuICAgICAgcmV0dXJuIG51bGw7XHJcbiAgICB9XHJcblxyXG4gICAgLy8gUmVtb3ZlIHRoZSBwYXRoIHByZWZpeFxyXG4gICAgbGV0IGtleSA9IHBhcmFtZXRlck5hbWU7XHJcbiAgICBpZiAoa2V5LnN0YXJ0c1dpdGgocGF0aFByZWZpeCkpIHtcclxuICAgICAga2V5ID0ga2V5LnN1YnN0cmluZyhwYXRoUHJlZml4Lmxlbmd0aCk7XHJcbiAgICB9XHJcblxyXG4gICAgLy8gUmVtb3ZlIGxlYWRpbmcgc2xhc2ggaWYgcHJlc2VudFxyXG4gICAgaWYgKGtleS5zdGFydHNXaXRoKCcvJykpIHtcclxuICAgICAga2V5ID0ga2V5LnN1YnN0cmluZygxKTtcclxuICAgIH1cclxuXHJcbiAgICAvLyBDb252ZXJ0IHNsYXNoZXMgdG8gdW5kZXJzY29yZXMgYW5kIHVwcGVyY2FzZVxyXG4gICAga2V5ID0ga2V5LnJlcGxhY2UoL1xcLy9nLCAnXycpLnRvVXBwZXJDYXNlKCk7XHJcblxyXG4gICAgLy8gUmV0dXJuIG51bGwgZm9yIGVtcHR5IGtleXNcclxuICAgIHJldHVybiBrZXkgfHwgbnVsbDtcclxuICB9XHJcblxyXG4gIC8qKlxyXG4gICAqIEdldCB0aGUgY3VycmVudCBhcHAgZW52aXJvbm1lbnQuXHJcbiAgICogQHJldHVybnMgVGhlIGN1cnJlbnQgQVBQX0VOViBvciBOT0RFX0VOViB2YWx1ZVxyXG4gICAqL1xyXG4gIGdldEFwcEVudigpOiBzdHJpbmcge1xyXG4gICAgcmV0dXJuIHRoaXMuX2FwcEVudjtcclxuICB9XHJcblxyXG4gIC8qKlxyXG4gICAqIEdldCB0aGUgZW52aXJvbm1lbnQgbWFwcGluZyBjb25maWd1cmF0aW9uLlxyXG4gICAqIEByZXR1cm5zIFRoZSBlbnZpcm9ubWVudCBtYXBwaW5nIHJlY29yZFxyXG4gICAqL1xyXG4gIGdldEVudmlyb25tZW50TWFwcGluZygpOiBSZWNvcmQ8c3RyaW5nLCBzdHJpbmc+IHtcclxuICAgIHJldHVybiB7IC4uLnRoaXMuX2NvbmZpZy5lbnZpcm9ubWVudE1hcHBpbmcgfTtcclxuICB9XHJcbn1cclxuIl19
@@ -0,0 +1,94 @@
1
+ /**
2
+ * Parser for AWS ECS-compatible environment files.
3
+ *
4
+ * Format rules (per AWS ECS documentation):
5
+ * - Lines beginning with # are comments and ignored
6
+ * - Blank lines are ignored
7
+ * - Format: VARIABLE=VALUE (no spaces around =)
8
+ * - Variable names must match /^[a-zA-Z_][a-zA-Z0-9_]*$/
9
+ * - Values are literal (no quote processing, no interpolation)
10
+ * - One variable per line
11
+ * - Lines without = are ignored
12
+ * - Maximum line length: 32KB
13
+ *
14
+ * @see https://docs.aws.amazon.com/AmazonECS/latest/developerguide/use-environment-file.html
15
+ */
16
+ export class EnvFileParser {
17
+ /** Maximum line length per AWS ECS specification */
18
+ static MAX_LINE_LENGTH = 32 * 1024; // 32KB
19
+ /** Valid variable name pattern: alphanumeric + underscore, cannot start with digit */
20
+ static VARIABLE_NAME_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
21
+ /**
22
+ * Parse environment file content into key-value pairs.
23
+ * @param content The raw content of the environment file
24
+ * @returns Record of environment variable names to values
25
+ */
26
+ static parse(content) {
27
+ const result = {};
28
+ // Handle empty content
29
+ if (!content) {
30
+ return result;
31
+ }
32
+ const lines = content.split(/\r?\n/);
33
+ for (const line of lines) {
34
+ // Skip lines exceeding max length
35
+ if (line.length > this.MAX_LINE_LENGTH) {
36
+ continue;
37
+ }
38
+ // Skip blank lines
39
+ if (line.trim() === '') {
40
+ continue;
41
+ }
42
+ // Skip comment lines (lines starting with # after optional whitespace)
43
+ if (line.trimStart().startsWith('#')) {
44
+ continue;
45
+ }
46
+ // Find the first = sign
47
+ const equalsIndex = line.indexOf('=');
48
+ if (equalsIndex === -1) {
49
+ // Lines without = are ignored
50
+ continue;
51
+ }
52
+ const key = line.substring(0, equalsIndex);
53
+ const value = line.substring(equalsIndex + 1);
54
+ // Validate variable name (must not be empty and must match pattern)
55
+ if (key.length === 0 || !this.VARIABLE_NAME_PATTERN.test(key)) {
56
+ continue;
57
+ }
58
+ result[key] = value;
59
+ }
60
+ return result;
61
+ }
62
+ /**
63
+ * Check if a variable name is valid per AWS ECS format.
64
+ * Variable names must:
65
+ * - Start with a letter (a-z, A-Z) or underscore (_)
66
+ * - Contain only alphanumeric characters and underscores
67
+ * - Not be empty
68
+ *
69
+ * @param name The variable name to check
70
+ * @returns true if the name is valid
71
+ */
72
+ static isValidVariableName(name) {
73
+ if (!name || name.length === 0) {
74
+ return false;
75
+ }
76
+ return this.VARIABLE_NAME_PATTERN.test(name);
77
+ }
78
+ /**
79
+ * Serialize a configuration object to AWS ECS-compatible env file format.
80
+ * @param config The configuration object to serialize
81
+ * @returns The serialized env file content
82
+ */
83
+ static serialize(config) {
84
+ const lines = [];
85
+ for (const [key, value] of Object.entries(config)) {
86
+ // Only include valid variable names
87
+ if (this.isValidVariableName(key)) {
88
+ lines.push(`${key}=${value}`);
89
+ }
90
+ }
91
+ return lines.join('\n');
92
+ }
93
+ }
94
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW52LWZpbGUtcGFyc2VyLnV0aWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi8uLi9jb25maWctYXdzL3NyYy91dGlscy9lbnYtZmlsZS1wYXJzZXIudXRpbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUNILE1BQU0sT0FBTyxhQUFhO0lBQ3hCLG9EQUFvRDtJQUM1QyxNQUFNLENBQVUsZUFBZSxHQUFHLEVBQUUsR0FBRyxJQUFJLENBQUMsQ0FBQyxPQUFPO0lBRTVELHNGQUFzRjtJQUM5RSxNQUFNLENBQVUscUJBQXFCLEdBQUcsMEJBQTBCLENBQUM7SUFFM0U7Ozs7T0FJRztJQUNILE1BQU0sQ0FBQyxLQUFLLENBQUMsT0FBZTtRQUMxQixNQUFNLE1BQU0sR0FBMkIsRUFBRSxDQUFDO1FBRTFDLHVCQUF1QjtRQUN2QixJQUFJLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDYixPQUFPLE1BQU0sQ0FBQztRQUNoQixDQUFDO1FBRUQsTUFBTSxLQUFLLEdBQUcsT0FBTyxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUVyQyxLQUFLLE1BQU0sSUFBSSxJQUFJLEtBQUssRUFBRSxDQUFDO1lBQ3pCLGtDQUFrQztZQUNsQyxJQUFJLElBQUksQ0FBQyxNQUFNLEdBQUcsSUFBSSxDQUFDLGVBQWUsRUFBRSxDQUFDO2dCQUN2QyxTQUFTO1lBQ1gsQ0FBQztZQUVELG1CQUFtQjtZQUNuQixJQUFJLElBQUksQ0FBQyxJQUFJLEVBQUUsS0FBSyxFQUFFLEVBQUUsQ0FBQztnQkFDdkIsU0FBUztZQUNYLENBQUM7WUFFRCx1RUFBdUU7WUFDdkUsSUFBSSxJQUFJLENBQUMsU0FBUyxFQUFFLENBQUMsVUFBVSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7Z0JBQ3JDLFNBQVM7WUFDWCxDQUFDO1lBRUQsd0JBQXdCO1lBQ3hCLE1BQU0sV0FBVyxHQUFHLElBQUksQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLENBQUM7WUFDdEMsSUFBSSxXQUFXLEtBQUssQ0FBQyxDQUFDLEVBQUUsQ0FBQztnQkFDdkIsOEJBQThCO2dCQUM5QixTQUFTO1lBQ1gsQ0FBQztZQUVELE1BQU0sR0FBRyxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxFQUFFLFdBQVcsQ0FBQyxDQUFDO1lBQzNDLE1BQU0sS0FBSyxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsV0FBVyxHQUFHLENBQUMsQ0FBQyxDQUFDO1lBRTlDLG9FQUFvRTtZQUNwRSxJQUFJLEdBQUcsQ0FBQyxNQUFNLEtBQUssQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLHFCQUFxQixDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO2dCQUM5RCxTQUFTO1lBQ1gsQ0FBQztZQUVELE1BQU0sQ0FBQyxHQUFHLENBQUMsR0FBRyxLQUFLLENBQUM7UUFDdEIsQ0FBQztRQUVELE9BQU8sTUFBTSxDQUFDO0lBQ2hCLENBQUM7SUFFRDs7Ozs7Ozs7O09BU0c7SUFDSCxNQUFNLENBQUMsbUJBQW1CLENBQUMsSUFBWTtRQUNyQyxJQUFJLENBQUMsSUFBSSxJQUFJLElBQUksQ0FBQyxNQUFNLEtBQUssQ0FBQyxFQUFFLENBQUM7WUFDL0IsT0FBTyxLQUFLLENBQUM7UUFDZixDQUFDO1FBQ0QsT0FBTyxJQUFJLENBQUMscUJBQXFCLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQy9DLENBQUM7SUFFRDs7OztPQUlHO0lBQ0gsTUFBTSxDQUFDLFNBQVMsQ0FBQyxNQUE4QjtRQUM3QyxNQUFNLEtBQUssR0FBYSxFQUFFLENBQUM7UUFFM0IsS0FBSyxNQUFNLENBQUMsR0FBRyxFQUFFLEtBQUssQ0FBQyxJQUFJLE1BQU0sQ0FBQyxPQUFPLENBQUMsTUFBTSxDQUFDLEVBQUUsQ0FBQztZQUNsRCxvQ0FBb0M7WUFDcEMsSUFBSSxJQUFJLENBQUMsbUJBQW1CLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQztnQkFDbEMsS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFHLEdBQUcsSUFBSSxLQUFLLEVBQUUsQ0FBQyxDQUFDO1lBQ2hDLENBQUM7UUFDSCxDQUFDO1FBRUQsT0FBTyxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQzFCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcclxuICogUGFyc2VyIGZvciBBV1MgRUNTLWNvbXBhdGlibGUgZW52aXJvbm1lbnQgZmlsZXMuXHJcbiAqXHJcbiAqIEZvcm1hdCBydWxlcyAocGVyIEFXUyBFQ1MgZG9jdW1lbnRhdGlvbik6XHJcbiAqIC0gTGluZXMgYmVnaW5uaW5nIHdpdGggIyBhcmUgY29tbWVudHMgYW5kIGlnbm9yZWRcclxuICogLSBCbGFuayBsaW5lcyBhcmUgaWdub3JlZFxyXG4gKiAtIEZvcm1hdDogVkFSSUFCTEU9VkFMVUUgKG5vIHNwYWNlcyBhcm91bmQgPSlcclxuICogLSBWYXJpYWJsZSBuYW1lcyBtdXN0IG1hdGNoIC9eW2EtekEtWl9dW2EtekEtWjAtOV9dKiQvXHJcbiAqIC0gVmFsdWVzIGFyZSBsaXRlcmFsIChubyBxdW90ZSBwcm9jZXNzaW5nLCBubyBpbnRlcnBvbGF0aW9uKVxyXG4gKiAtIE9uZSB2YXJpYWJsZSBwZXIgbGluZVxyXG4gKiAtIExpbmVzIHdpdGhvdXQgPSBhcmUgaWdub3JlZFxyXG4gKiAtIE1heGltdW0gbGluZSBsZW5ndGg6IDMyS0JcclxuICpcclxuICogQHNlZSBodHRwczovL2RvY3MuYXdzLmFtYXpvbi5jb20vQW1hem9uRUNTL2xhdGVzdC9kZXZlbG9wZXJndWlkZS91c2UtZW52aXJvbm1lbnQtZmlsZS5odG1sXHJcbiAqL1xyXG5leHBvcnQgY2xhc3MgRW52RmlsZVBhcnNlciB7XHJcbiAgLyoqIE1heGltdW0gbGluZSBsZW5ndGggcGVyIEFXUyBFQ1Mgc3BlY2lmaWNhdGlvbiAqL1xyXG4gIHByaXZhdGUgc3RhdGljIHJlYWRvbmx5IE1BWF9MSU5FX0xFTkdUSCA9IDMyICogMTAyNDsgLy8gMzJLQlxyXG5cclxuICAvKiogVmFsaWQgdmFyaWFibGUgbmFtZSBwYXR0ZXJuOiBhbHBoYW51bWVyaWMgKyB1bmRlcnNjb3JlLCBjYW5ub3Qgc3RhcnQgd2l0aCBkaWdpdCAqL1xyXG4gIHByaXZhdGUgc3RhdGljIHJlYWRvbmx5IFZBUklBQkxFX05BTUVfUEFUVEVSTiA9IC9eW2EtekEtWl9dW2EtekEtWjAtOV9dKiQvO1xyXG5cclxuICAvKipcclxuICAgKiBQYXJzZSBlbnZpcm9ubWVudCBmaWxlIGNvbnRlbnQgaW50byBrZXktdmFsdWUgcGFpcnMuXHJcbiAgICogQHBhcmFtIGNvbnRlbnQgVGhlIHJhdyBjb250ZW50IG9mIHRoZSBlbnZpcm9ubWVudCBmaWxlXHJcbiAgICogQHJldHVybnMgUmVjb3JkIG9mIGVudmlyb25tZW50IHZhcmlhYmxlIG5hbWVzIHRvIHZhbHVlc1xyXG4gICAqL1xyXG4gIHN0YXRpYyBwYXJzZShjb250ZW50OiBzdHJpbmcpOiBSZWNvcmQ8c3RyaW5nLCBzdHJpbmc+IHtcclxuICAgIGNvbnN0IHJlc3VsdDogUmVjb3JkPHN0cmluZywgc3RyaW5nPiA9IHt9O1xyXG5cclxuICAgIC8vIEhhbmRsZSBlbXB0eSBjb250ZW50XHJcbiAgICBpZiAoIWNvbnRlbnQpIHtcclxuICAgICAgcmV0dXJuIHJlc3VsdDtcclxuICAgIH1cclxuXHJcbiAgICBjb25zdCBsaW5lcyA9IGNvbnRlbnQuc3BsaXQoL1xccj9cXG4vKTtcclxuXHJcbiAgICBmb3IgKGNvbnN0IGxpbmUgb2YgbGluZXMpIHtcclxuICAgICAgLy8gU2tpcCBsaW5lcyBleGNlZWRpbmcgbWF4IGxlbmd0aFxyXG4gICAgICBpZiAobGluZS5sZW5ndGggPiB0aGlzLk1BWF9MSU5FX0xFTkdUSCkge1xyXG4gICAgICAgIGNvbnRpbnVlO1xyXG4gICAgICB9XHJcblxyXG4gICAgICAvLyBTa2lwIGJsYW5rIGxpbmVzXHJcbiAgICAgIGlmIChsaW5lLnRyaW0oKSA9PT0gJycpIHtcclxuICAgICAgICBjb250aW51ZTtcclxuICAgICAgfVxyXG5cclxuICAgICAgLy8gU2tpcCBjb21tZW50IGxpbmVzIChsaW5lcyBzdGFydGluZyB3aXRoICMgYWZ0ZXIgb3B0aW9uYWwgd2hpdGVzcGFjZSlcclxuICAgICAgaWYgKGxpbmUudHJpbVN0YXJ0KCkuc3RhcnRzV2l0aCgnIycpKSB7XHJcbiAgICAgICAgY29udGludWU7XHJcbiAgICAgIH1cclxuXHJcbiAgICAgIC8vIEZpbmQgdGhlIGZpcnN0ID0gc2lnblxyXG4gICAgICBjb25zdCBlcXVhbHNJbmRleCA9IGxpbmUuaW5kZXhPZignPScpO1xyXG4gICAgICBpZiAoZXF1YWxzSW5kZXggPT09IC0xKSB7XHJcbiAgICAgICAgLy8gTGluZXMgd2l0aG91dCA9IGFyZSBpZ25vcmVkXHJcbiAgICAgICAgY29udGludWU7XHJcbiAgICAgIH1cclxuXHJcbiAgICAgIGNvbnN0IGtleSA9IGxpbmUuc3Vic3RyaW5nKDAsIGVxdWFsc0luZGV4KTtcclxuICAgICAgY29uc3QgdmFsdWUgPSBsaW5lLnN1YnN0cmluZyhlcXVhbHNJbmRleCArIDEpO1xyXG5cclxuICAgICAgLy8gVmFsaWRhdGUgdmFyaWFibGUgbmFtZSAobXVzdCBub3QgYmUgZW1wdHkgYW5kIG11c3QgbWF0Y2ggcGF0dGVybilcclxuICAgICAgaWYgKGtleS5sZW5ndGggPT09IDAgfHwgIXRoaXMuVkFSSUFCTEVfTkFNRV9QQVRURVJOLnRlc3Qoa2V5KSkge1xyXG4gICAgICAgIGNvbnRpbnVlO1xyXG4gICAgICB9XHJcblxyXG4gICAgICByZXN1bHRba2V5XSA9IHZhbHVlO1xyXG4gICAgfVxyXG5cclxuICAgIHJldHVybiByZXN1bHQ7XHJcbiAgfVxyXG5cclxuICAvKipcclxuICAgKiBDaGVjayBpZiBhIHZhcmlhYmxlIG5hbWUgaXMgdmFsaWQgcGVyIEFXUyBFQ1MgZm9ybWF0LlxyXG4gICAqIFZhcmlhYmxlIG5hbWVzIG11c3Q6XHJcbiAgICogLSBTdGFydCB3aXRoIGEgbGV0dGVyIChhLXosIEEtWikgb3IgdW5kZXJzY29yZSAoXylcclxuICAgKiAtIENvbnRhaW4gb25seSBhbHBoYW51bWVyaWMgY2hhcmFjdGVycyBhbmQgdW5kZXJzY29yZXNcclxuICAgKiAtIE5vdCBiZSBlbXB0eVxyXG4gICAqXHJcbiAgICogQHBhcmFtIG5hbWUgVGhlIHZhcmlhYmxlIG5hbWUgdG8gY2hlY2tcclxuICAgKiBAcmV0dXJucyB0cnVlIGlmIHRoZSBuYW1lIGlzIHZhbGlkXHJcbiAgICovXHJcbiAgc3RhdGljIGlzVmFsaWRWYXJpYWJsZU5hbWUobmFtZTogc3RyaW5nKTogYm9vbGVhbiB7XHJcbiAgICBpZiAoIW5hbWUgfHwgbmFtZS5sZW5ndGggPT09IDApIHtcclxuICAgICAgcmV0dXJuIGZhbHNlO1xyXG4gICAgfVxyXG4gICAgcmV0dXJuIHRoaXMuVkFSSUFCTEVfTkFNRV9QQVRURVJOLnRlc3QobmFtZSk7XHJcbiAgfVxyXG5cclxuICAvKipcclxuICAgKiBTZXJpYWxpemUgYSBjb25maWd1cmF0aW9uIG9iamVjdCB0byBBV1MgRUNTLWNvbXBhdGlibGUgZW52IGZpbGUgZm9ybWF0LlxyXG4gICAqIEBwYXJhbSBjb25maWcgVGhlIGNvbmZpZ3VyYXRpb24gb2JqZWN0IHRvIHNlcmlhbGl6ZVxyXG4gICAqIEByZXR1cm5zIFRoZSBzZXJpYWxpemVkIGVudiBmaWxlIGNvbnRlbnRcclxuICAgKi9cclxuICBzdGF0aWMgc2VyaWFsaXplKGNvbmZpZzogUmVjb3JkPHN0cmluZywgc3RyaW5nPik6IHN0cmluZyB7XHJcbiAgICBjb25zdCBsaW5lczogc3RyaW5nW10gPSBbXTtcclxuXHJcbiAgICBmb3IgKGNvbnN0IFtrZXksIHZhbHVlXSBvZiBPYmplY3QuZW50cmllcyhjb25maWcpKSB7XHJcbiAgICAgIC8vIE9ubHkgaW5jbHVkZSB2YWxpZCB2YXJpYWJsZSBuYW1lc1xyXG4gICAgICBpZiAodGhpcy5pc1ZhbGlkVmFyaWFibGVOYW1lKGtleSkpIHtcclxuICAgICAgICBsaW5lcy5wdXNoKGAke2tleX09JHt2YWx1ZX1gKTtcclxuICAgICAgfVxyXG4gICAgfVxyXG5cclxuICAgIHJldHVybiBsaW5lcy5qb2luKCdcXG4nKTtcclxuICB9XHJcbn1cclxuIl19
@@ -0,0 +1,112 @@
1
+ import { ValidationError } from '../errors';
2
+ /**
3
+ * Framework-agnostic validation utility for configuration values.
4
+ * Provides methods for validating configuration objects against Zod schemas.
5
+ */
6
+ export class ConfigValidationUtil {
7
+ /**
8
+ * Validates a value against a Zod schema.
9
+ * @param schema The Zod schema to validate against
10
+ * @param value The value to validate
11
+ * @param context Optional context for error messages
12
+ * @returns The validated and transformed value
13
+ * @throws ValidationError if validation fails
14
+ */
15
+ static validate(schema, value, context) {
16
+ const result = schema.safeParse(value);
17
+ if (result.success) {
18
+ return result.data;
19
+ }
20
+ const errors = this.formatValidationErrors(result.error);
21
+ const contextMessage = context
22
+ ? `Configuration validation failed for ${context}`
23
+ : 'Configuration validation failed';
24
+ throw new ValidationError(contextMessage, errors);
25
+ }
26
+ /**
27
+ * Safely validates a value against a Zod schema without throwing.
28
+ * @param schema The Zod schema to validate against
29
+ * @param value The value to validate
30
+ * @returns Object with success flag and either data or error
31
+ */
32
+ static safeValidate(schema, value) {
33
+ const result = schema.safeParse(value);
34
+ if (result.success) {
35
+ return { success: true, data: result.data };
36
+ }
37
+ const errors = this.formatValidationErrors(result.error);
38
+ const validationError = new ValidationError('Configuration validation failed', errors);
39
+ return { success: false, error: validationError };
40
+ }
41
+ /**
42
+ * Formats Zod validation errors into a structured format.
43
+ * @param error The ZodError to format
44
+ * @returns Formatted error object or string
45
+ */
46
+ static formatValidationErrors(error) {
47
+ // If there's only one error at the root level, return just the message
48
+ if (error.issues.length === 1) {
49
+ const issue = error.issues[0];
50
+ if (issue && Array.isArray(issue.path) && issue.path.length === 0) {
51
+ return issue.message;
52
+ }
53
+ }
54
+ // For multiple errors or nested paths, create a structured object
55
+ return error.issues.reduce((errors, issue) => {
56
+ const path = issue.path.join('.');
57
+ const key = path || 'root';
58
+ if (!errors[key]) {
59
+ errors[key] = [];
60
+ }
61
+ errors[key].push({
62
+ message: issue.message,
63
+ code: issue.code,
64
+ path: issue.path,
65
+ });
66
+ return errors;
67
+ }, {});
68
+ }
69
+ /**
70
+ * Creates a detailed error message for configuration validation failures.
71
+ * @param error The ZodError to create a message for
72
+ * @param context Optional context for the error
73
+ * @returns Detailed error message string
74
+ */
75
+ static createDetailedErrorMessage(error, context) {
76
+ const contextPrefix = context ? `${context}: ` : '';
77
+ if (error.issues.length === 1) {
78
+ const issue = error.issues[0];
79
+ if (issue) {
80
+ const pathStr = issue.path.length > 0 ? ` at '${issue.path.join('.')}'` : '';
81
+ return `${contextPrefix}${issue.message}${pathStr}`;
82
+ }
83
+ }
84
+ const errorMessages = error.issues.map((issue) => {
85
+ const pathStr = issue.path.length > 0 ? ` at '${issue.path.join('.')}'` : '';
86
+ return ` - ${issue.message}${pathStr}`;
87
+ });
88
+ return `${contextPrefix}Multiple validation errors:\n${errorMessages.join('\n')}`;
89
+ }
90
+ /**
91
+ * Validates configuration with enhanced error context.
92
+ * @param schema The Zod schema to validate against
93
+ * @param value The configuration object to validate
94
+ * @param source The source of the configuration (e.g., 'environment', 'secrets-manager')
95
+ * @returns The validated configuration
96
+ * @throws ValidationError with enhanced context
97
+ */
98
+ static validateConfiguration(schema, value, source) {
99
+ try {
100
+ return this.validate(schema, value, `${source} configuration`);
101
+ }
102
+ catch (error) {
103
+ if (error instanceof ValidationError) {
104
+ // Enhance the error with source information
105
+ const enhancedMessage = `Configuration validation failed for source '${source}': ${error.message}`;
106
+ throw new ValidationError(enhancedMessage, error.validationErrors);
107
+ }
108
+ throw error;
109
+ }
110
+ }
111
+ }
112
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGlvbi51dGlsLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vLi4vY29uZmlnLWF3cy9zcmMvdXRpbHMvdmFsaWRhdGlvbi51dGlsLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUNBLE9BQU8sRUFBRSxlQUFlLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFFNUM7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLG9CQUFvQjtJQUMvQjs7Ozs7OztPQU9HO0lBQ0gsTUFBTSxDQUFDLFFBQVEsQ0FDYixNQUFTLEVBQ1QsS0FBYyxFQUNkLE9BQWdCO1FBRWhCLE1BQU0sTUFBTSxHQUFHLE1BQU0sQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLENBQUM7UUFFdkMsSUFBSSxNQUFNLENBQUMsT0FBTyxFQUFFLENBQUM7WUFDbkIsT0FBTyxNQUFNLENBQUMsSUFBSSxDQUFDO1FBQ3JCLENBQUM7UUFFRCxNQUFNLE1BQU0sR0FBRyxJQUFJLENBQUMsc0JBQXNCLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQ3pELE1BQU0sY0FBYyxHQUFHLE9BQU87WUFDNUIsQ0FBQyxDQUFDLHVDQUF1QyxPQUFPLEVBQUU7WUFDbEQsQ0FBQyxDQUFDLGlDQUFpQyxDQUFDO1FBRXRDLE1BQU0sSUFBSSxlQUFlLENBQUMsY0FBYyxFQUFFLE1BQU0sQ0FBQyxDQUFDO0lBQ3BELENBQUM7SUFFRDs7Ozs7T0FLRztJQUNILE1BQU0sQ0FBQyxZQUFZLENBQ2pCLE1BQVMsRUFDVCxLQUFjO1FBRWQsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUV2QyxJQUFJLE1BQU0sQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNuQixPQUFPLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsTUFBTSxDQUFDLElBQUksRUFBRSxDQUFDO1FBQzlDLENBQUM7UUFFRCxNQUFNLE1BQU0sR0FBRyxJQUFJLENB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LENBQUM7UUFFSCxPQUFPLEdBQUcsYUFBYSxnQ0FBZ0MsYUFBYSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDO0lBQ3BGLENBQUM7SUFFRDs7Ozs7OztPQU9HO0lBQ0gsTUFBTSxDQUFDLHFCQUFxQixDQUMxQixNQUFTLEVBQ1QsS0FBYyxFQUNkLE1BQWM7UUFFZCxJQUFJLENBQUM7WUFDSCxPQUFPLElBQUksQ0FBQyxRQUFRLENBQUMsTUFBTSxFQUFFLEtBQUssRUFBRSxHQUFHLE1BQU0sZ0JBQWdCLENBQUMsQ0FBQztRQUNqRSxDQUFDO1FBQUMsT0FBTyxLQUFLLEVBQUUsQ0FBQztZQUNmLElBQUksS0FBSyxZQUFZLGVBQWUsRUFBRSxDQUFDO2dCQUNyQyw0Q0FBNEM7Z0JBQzVDLE1BQU0sZUFBZSxHQUFHLCtDQUErQyxNQUFNLE1BQU0sS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDO2dCQUNuRyxNQUFNLElBQUksZUFBZSxDQUFDLGVBQWUsRUFBRSxLQUFLLENBQUMsZ0JBQWdCLENBQUMsQ0FBQztZQUNyRSxDQUFDO1lBQ0QsTUFBTSxLQUFLLENBQUM7UUFDZCxDQUFDO0lBQ0gsQ0FBQztDQUNGIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHR5cGUgeyBab2RUeXBlLCBab2RFcnJvciwgVHlwZU9mIH0gZnJvbSAnem9kJztcclxuaW1wb3J0IHsgVmFsaWRhdGlvbkVycm9yIH0gZnJvbSAnLi4vZXJyb3JzJztcclxuXHJcbi8qKlxyXG4gKiBGcmFtZXdvcmstYWdub3N0aWMgdmFsaWRhdGlvbiB1dGlsaXR5IGZvciBjb25maWd1cmF0aW9uIHZhbHVlcy5cclxuICogUHJvdmlkZXMgbWV0aG9kcyBmb3IgdmFsaWRhdGluZyBjb25maWd1cmF0aW9uIG9iamVjdHMgYWdhaW5zdCBab2Qgc2NoZW1hcy5cclxuICovXHJcbmV4cG9ydCBjbGFzcyBDb25maWdWYWxpZGF0aW9uVXRpbCB7XHJcbiAgLyoqXHJcbiAgICogVmFsaWRhdGVzIGEgdmFsdWUgYWdhaW5zdCBhIFpvZCBzY2hlbWEuXHJcbiAgICogQHBhcmFtIHNjaGVtYSBUaGUgWm9kIHNjaGVtYSB0byB2YWxpZGF0ZSBhZ2FpbnN0XHJcbiAgICogQHBhcmFtIHZhbHVlIFRoZSB2YWx1ZSB0byB2YWxpZGF0ZVxyXG4gICAqIEBwYXJhbSBjb250ZXh0IE9wdGlvbmFsIGNvbnRleHQgZm9yIGVycm9yIG1lc3NhZ2VzXHJcbiAgICogQHJldHVybnMgVGhlIHZhbGlkYXRlZCBhbmQgdHJhbnNmb3JtZWQgdmFsdWVcclxuICAgKiBAdGhyb3dzIFZhbGlkYXRpb25FcnJvciBpZiB2YWxpZGF0aW9uIGZhaWxzXHJcbiAgICovXHJcbiAgc3RhdGljIHZhbGlkYXRlPFQgZXh0ZW5kcyBab2RUeXBlPihcclxuICAgIHNjaGVtYTogVCxcclxuICAgIHZhbHVlOiB1bmtub3duLFxyXG4gICAgY29udGV4dD86IHN0cmluZyxcclxuICApOiBUeXBlT2Y8VD4ge1xyXG4gICAgY29uc3QgcmVzdWx0ID0gc2NoZW1hLnNhZmVQYXJzZSh2YWx1ZSk7XHJcblxyXG4gICAgaWYgKHJlc3VsdC5zdWNjZXNzKSB7XHJcbiAgICAgIHJldHVybiByZXN1bHQuZGF0YTtcclxuICAgIH1cclxuXHJcbiAgICBjb25zdCBlcnJvcnMgPSB0aGlzLmZvcm1hdFZhbGlkYXRpb25FcnJvcnMocmVzdWx0LmVycm9yKTtcclxuICAgIGNvbnN0IGNvbnRleHRNZXNzYWdlID0gY29udGV4dFxyXG4gICAgICA/IGBDb25maWd1cmF0aW9uIHZhbGlkYXRpb24gZmFpbGVkIGZvciAke2NvbnRleHR9YFxyXG4gICAgICA6ICdDb25maWd1cmF0aW9uIHZhbGlkYXRpb24gZmFpbGVkJztcclxuXHJcbiAgICB0aHJvdyBuZXcgVmFsaWRhdGlvbkVycm9yKGNvbnRleHRNZXNzYWdlLCBlcnJvcnMpO1xyXG4gIH1cclxuXHJcbiAgLyoqXHJcbiAgICogU2FmZWx5IHZhbGlkYXRlcyBhIHZhbHVlIGFnYWluc3QgYSBab2Qgc2NoZW1hIHdpdGhvdXQgdGhyb3dpbmcuXHJcbiAgICogQHBhcmFtIHNjaGVtYSBUaGUgWm9kIHNjaGVtYSB0byB2YWxpZGF0ZSBhZ2FpbnN0XHJcbiAgICogQHBhcmFtIHZhbHVlIFRoZSB2YWx1ZSB0byB2YWxpZGF0ZVxyXG4gICAqIEByZXR1cm5zIE9iamVjdCB3aXRoIHN1Y2Nlc3MgZmxhZyBhbmQgZWl0aGVyIGRhdGEgb3IgZXJyb3JcclxuICAgKi9cclxuICBzdGF0aWMgc2FmZVZhbGlkYXRlPFQgZXh0ZW5kcyBab2RUeXBlPihcclxuICAgIHNjaGVtYTogVCxcclxuICAgIHZhbHVlOiB1bmtub3duLFxyXG4gICk6IHsgc3VjY2VzczogdHJ1ZTsgZGF0YTogVHlwZU9mPFQ+IH0gfCB7IHN1Y2Nlc3M6IGZhbHNlOyBlcnJvcjogVmFsaWRhdGlvbkVycm9yIH0ge1xyXG4gICAgY29uc3QgcmVzdWx0ID0gc2NoZW1hLnNhZmVQYXJzZSh2YWx1ZSk7XHJcblxyXG4gICAgaWYgKHJlc3VsdC5zdWNjZXNzKSB7XHJcbiAgICAgIHJldHVybiB7IHN1Y2Nlc3M6IHRydWUsIGRhdGE6IHJlc3VsdC5kYXRhIH07XHJcbiAgICB9XHJcblxyXG4gICAgY29uc3QgZXJyb3JzID0gdGhpcy5mb3JtYXRWYWxpZGF0aW9uRXJyb3JzKHJlc3VsdC5lcnJvcik7XHJcbiAgICBjb25zdCB2YWxpZGF0aW9uRXJyb3IgPSBuZXcgVmFsaWRhdGlvbkVycm9yKCdDb25maWd1cmF0aW9uIHZhbGlkYXRpb24gZmFpbGVkJywgZXJyb3JzKTtcclxuXHJcbiAgICByZXR1cm4geyBzdWNjZXNzOiBmYWxzZSwgZXJyb3I6IHZhbGlkYXRpb25FcnJvciB9O1xyXG4gIH1cclxuXHJcbiAgLyoqXHJcbiAgICogRm9ybWF0cyBab2QgdmFsaWRhdGlvbiBlcnJvcnMgaW50byBhIHN0cnVjdHVyZWQgZm9ybWF0LlxyXG4gICAqIEBwYXJhbSBlcnJvciBUaGUgWm9kRXJyb3IgdG8gZm9ybWF0XHJcbiAgICogQHJldHVybnMgRm9ybWF0dGVkIGVycm9yIG9iamVjdCBvciBzdHJpbmdcclxuICAgKi9cclxuICBzdGF0aWMgZm9ybWF0VmFsaWRhdGlvbkVycm9ycyhlcnJvcjogWm9kRXJyb3IpOiB1bmtub3duIHtcclxuICAgIC8vIElmIHRoZXJlJ3Mgb25seSBvbmUgZXJyb3IgYXQgdGhlIHJvb3QgbGV2ZWwsIHJldHVybiBqdXN0IHRoZSBtZXNzYWdlXHJcbiAgICBpZiAoZXJyb3IuaXNzdWVzLmxlbmd0aCA9PT0gMSkge1xyXG4gICAgICBjb25zdCBpc3N1ZSA9IGVycm9yLmlzc3Vlc1swXTtcclxuICAgICAgaWYgKGlzc3VlICYmIEFycmF5LmlzQXJyYXkoaXNzdWUucGF0aCkgJiYgaXNzdWUucGF0aC5sZW5ndGggPT09IDApIHtcclxuICAgICAgICByZXR1cm4gaXNzdWUubWVzc2FnZTtcclxuICAgICAgfVxyXG4gICAgfVxyXG5cclxuICAgIC8vIEZvciBtdWx0aXBsZSBlcnJvcnMgb3IgbmVzdGVkIHBhdGhzLCBjcmVhdGUgYSBzdHJ1Y3R1cmVkIG9iamVjdFxyXG4gICAgcmV0dXJuIGVycm9yLmlzc3Vlcy5yZWR1Y2UoXHJcbiAgICAgIChlcnJvcnMsIGlzc3VlKSA9PiB7XHJcbiAgICAgICAgY29uc3QgcGF0aCA9IGlzc3VlLnBhdGguam9pbignLicpO1xyXG4gICAgICAgIGNvbnN0IGtleSA9IHBhdGggfHwgJ3Jvb3QnO1xyXG5cclxuICAgICAgICBpZiAoIWVycm9yc1trZXldKSB7XHJcbiAgICAgICAgICBlcnJvcnNba2V5XSA9IFtdO1xyXG4gICAgICAgIH1cclxuXHJcbiAgICAgICAgZXJyb3JzW2tleV0ucHVzaCh7XHJcbiAgICAgICAgICBtZXNzYWdlOiBpc3N1ZS5tZXNzYWdlLFxyXG4gICAgICAgICAgY29kZTogaXNzdWUuY29kZSxcclxuICAgICAgICAgIHBhdGg6IGlzc3VlLnBhdGgsXHJcbiAgICAgICAgfSk7XHJcblxyXG4gICAgICAgIHJldHVybiBlcnJvcnM7XHJcbiAgICAgIH0sXHJcbiAgICAgIHt9IGFzIFJlY29yZDxzdHJpbmcsIEFycmF5PHsgbWVzc2FnZTogc3RyaW5nOyBjb2RlOiBzdHJpbmc7IHBhdGg6IChzdHJpbmcgfCBudW1iZXIpW10gfT4+LFxyXG4gICAgKTtcclxuICB9XHJcblxyXG4gIC8qKlxyXG4gICAqIENyZWF0ZXMgYSBkZXRhaWxlZCBlcnJvciBtZXNzYWdlIGZvciBjb25maWd1cmF0aW9uIHZhbGlkYXRpb24gZmFpbHVyZXMuXHJcbiAgICogQHBhcmFtIGVycm9yIFRoZSBab2RFcnJvciB0byBjcmVhdGUgYSBtZXNzYWdlIGZvclxyXG4gICAqIEBwYXJhbSBjb250ZXh0IE9wdGlvbmFsIGNvbnRleHQgZm9yIHRoZSBlcnJvclxyXG4gICAqIEByZXR1cm5zIERldGFpbGVkIGVycm9yIG1lc3NhZ2Ugc3RyaW5nXHJcbiAgICovXHJcbiAgc3RhdGljIGNyZWF0ZURldGFpbGVkRXJyb3JNZXNzYWdlKGVycm9yOiBab2RFcnJvciwgY29udGV4dD86IHN0cmluZyk6IHN0cmluZyB7XHJcbiAgICBjb25zdCBjb250ZXh0UHJlZml4ID0gY29udGV4dCA/IGAke2NvbnRleHR9OiBgIDogJyc7XHJcblxyXG4gICAgaWYgKGVycm9yLmlzc3Vlcy5sZW5ndGggPT09IDEpIHtcclxuICAgICAgY29uc3QgaXNzdWUgPSBlcnJvci5pc3N1ZXNbMF07XHJcbiAgICAgIGlmIChpc3N1ZSkge1xyXG4gICAgICAgIGNvbnN0IHBhdGhTdHIgPSBpc3N1ZS5wYXRoLmxlbmd0aCA+IDAgPyBgIGF0ICcke2lzc3VlLnBhdGguam9pbignLicpfSdgIDogJyc7XHJcbiAgICAgICAgcmV0dXJuIGAke2NvbnRleHRQcmVmaXh9JHtpc3N1ZS5tZXNzYWdlfSR7cGF0aFN0cn1gO1xyXG4gICAgICB9XHJcbiAgICB9XHJcblxyXG4gICAgY29uc3QgZXJyb3JNZXNzYWdlcyA9IGVycm9yLmlzc3Vlcy5tYXAoKGlzc3VlKSA9PiB7XHJcbiAgICAgIGNvbnN0IHBhdGhTdHIgPSBpc3N1ZS5wYXRoLmxlbmd0aCA+IDAgPyBgIGF0ICcke2lzc3VlLnBhdGguam9pbignLicpfSdgIDogJyc7XHJcbiAgICAgIHJldHVybiBgICAtICR7aXNzdWUubWVzc2FnZX0ke3BhdGhTdHJ9YDtcclxuICAgIH0pO1xyXG5cclxuICAgIHJldHVybiBgJHtjb250ZXh0UHJlZml4fU11bHRpcGxlIHZhbGlkYXRpb24gZXJyb3JzOlxcbiR7ZXJyb3JNZXNzYWdlcy5qb2luKCdcXG4nKX1gO1xyXG4gIH1cclxuXHJcbiAgLyoqXHJcbiAgICogVmFsaWRhdGVzIGNvbmZpZ3VyYXRpb24gd2l0aCBlbmhhbmNlZCBlcnJvciBjb250ZXh0LlxyXG4gICAqIEBwYXJhbSBzY2hlbWEgVGhlIFpvZCBzY2hlbWEgdG8gdmFsaWRhdGUgYWdhaW5zdFxyXG4gICAqIEBwYXJhbSB2YWx1ZSBUaGUgY29uZmlndXJhdGlvbiBvYmplY3QgdG8gdmFsaWRhdGVcclxuICAgKiBAcGFyYW0gc291cmNlIFRoZSBzb3VyY2Ugb2YgdGhlIGNvbmZpZ3VyYXRpb24gKGUuZy4sICdlbnZpcm9ubWVudCcsICdzZWNyZXRzLW1hbmFnZXInKVxyXG4gICAqIEByZXR1cm5zIFRoZSB2YWxpZGF0ZWQgY29uZmlndXJhdGlvblxyXG4gICAqIEB0aHJvd3MgVmFsaWRhdGlvbkVycm9yIHdpdGggZW5oYW5jZWQgY29udGV4dFxyXG4gICAqL1xyXG4gIHN0YXRpYyB2YWxpZGF0ZUNvbmZpZ3VyYXRpb248VCBleHRlbmRzIFpvZFR5cGU+KFxyXG4gICAgc2NoZW1hOiBULFxyXG4gICAgdmFsdWU6IHVua25vd24sXHJcbiAgICBzb3VyY2U6IHN0cmluZyxcclxuICApOiBUeXBlT2Y8VD4ge1xyXG4gICAgdHJ5IHtcclxuICAgICAgcmV0dXJuIHRoaXMudmFsaWRhdGUoc2NoZW1hLCB2YWx1ZSwgYCR7c291cmNlfSBjb25maWd1cmF0aW9uYCk7XHJcbiAgICB9IGNhdGNoIChlcnJvcikge1xyXG4gICAgICBpZiAoZXJyb3IgaW5zdGFuY2VvZiBWYWxpZGF0aW9uRXJyb3IpIHtcclxuICAgICAgICAvLyBFbmhhbmNlIHRoZSBlcnJvciB3aXRoIHNvdXJjZSBpbmZvcm1hdGlvblxyXG4gICAgICAgIGNvbnN0IGVuaGFuY2VkTWVzc2FnZSA9IGBDb25maWd1cmF0aW9uIHZhbGlkYXRpb24gZmFpbGVkIGZvciBzb3VyY2UgJyR7c291cmNlfSc6ICR7ZXJyb3IubWVzc2FnZX1gO1xyXG4gICAgICAgIHRocm93IG5ldyBWYWxpZGF0aW9uRXJyb3IoZW5oYW5jZWRNZXNzYWdlLCBlcnJvci52YWxpZGF0aW9uRXJyb3JzKTtcclxuICAgICAgfVxyXG4gICAgICB0aHJvdyBlcnJvcjtcclxuICAgIH1cclxuICB9XHJcbn1cclxuIl19