@wildo-ai/platform-config-lib 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (414) hide show
  1. package/LICENSE +34 -0
  2. package/dist/esm/.builder.pid +9 -0
  3. package/dist/esm/_unimplemented/index.d.ts +3 -0
  4. package/dist/esm/_unimplemented/index.d.ts.map +1 -0
  5. package/dist/esm/_unimplemented/index.js +3 -0
  6. package/dist/esm/_unimplemented/index.js.map +1 -0
  7. package/dist/esm/_unimplemented/soft-warn.d.ts +124 -0
  8. package/dist/esm/_unimplemented/soft-warn.d.ts.map +1 -0
  9. package/dist/esm/_unimplemented/soft-warn.js +170 -0
  10. package/dist/esm/_unimplemented/soft-warn.js.map +1 -0
  11. package/dist/esm/_unimplemented/unimplemented-field-warning.d.ts +137 -0
  12. package/dist/esm/_unimplemented/unimplemented-field-warning.d.ts.map +1 -0
  13. package/dist/esm/_unimplemented/unimplemented-field-warning.js +153 -0
  14. package/dist/esm/_unimplemented/unimplemented-field-warning.js.map +1 -0
  15. package/dist/esm/bootstrap/application-backend-env.contracts.d.ts.map +1 -1
  16. package/dist/esm/bootstrap/application-backend-env.contracts.js +1 -1
  17. package/dist/esm/bootstrap/application-backend-env.contracts.js.map +1 -1
  18. package/dist/esm/bootstrap/application-creation-verification-env.contracts.d.ts +13 -0
  19. package/dist/esm/bootstrap/application-creation-verification-env.contracts.d.ts.map +1 -0
  20. package/dist/esm/bootstrap/application-creation-verification-env.contracts.js +14 -0
  21. package/dist/esm/bootstrap/application-creation-verification-env.contracts.js.map +1 -0
  22. package/dist/esm/bootstrap/bootstrap-planner.d.ts +1 -1
  23. package/dist/esm/bootstrap/bootstrap-planner.d.ts.map +1 -1
  24. package/dist/esm/bootstrap/bootstrap-planner.js +1 -1
  25. package/dist/esm/bootstrap/bootstrap-planner.js.map +1 -1
  26. package/dist/esm/bootstrap/bootstrap.contracts.d.ts +141 -37
  27. package/dist/esm/bootstrap/bootstrap.contracts.d.ts.map +1 -1
  28. package/dist/esm/bootstrap/bootstrap.contracts.js +104 -18
  29. package/dist/esm/bootstrap/bootstrap.contracts.js.map +1 -1
  30. package/dist/esm/bootstrap/bootstrap.schemas.d.ts +430 -421
  31. package/dist/esm/bootstrap/bootstrap.schemas.d.ts.map +1 -1
  32. package/dist/esm/bootstrap/bootstrap.schemas.js +383 -21
  33. package/dist/esm/bootstrap/bootstrap.schemas.js.map +1 -1
  34. package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts +213 -8
  35. package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts.map +1 -1
  36. package/dist/esm/bootstrap/platform-runtime-env.contracts.js +230 -5
  37. package/dist/esm/bootstrap/platform-runtime-env.contracts.js.map +1 -1
  38. package/dist/esm/bootstrap/runtime-backing-service-access.d.ts +79 -0
  39. package/dist/esm/bootstrap/runtime-backing-service-access.d.ts.map +1 -0
  40. package/dist/esm/bootstrap/runtime-backing-service-access.js +83 -0
  41. package/dist/esm/bootstrap/runtime-backing-service-access.js.map +1 -0
  42. package/dist/esm/bootstrap/runtime-network-policy.d.ts +63 -0
  43. package/dist/esm/bootstrap/runtime-network-policy.d.ts.map +1 -0
  44. package/dist/esm/bootstrap/runtime-network-policy.js +104 -0
  45. package/dist/esm/bootstrap/runtime-network-policy.js.map +1 -0
  46. package/dist/esm/bootstrap/runtime-network-topology.d.ts +78 -0
  47. package/dist/esm/bootstrap/runtime-network-topology.d.ts.map +1 -0
  48. package/dist/esm/bootstrap/runtime-network-topology.js +134 -0
  49. package/dist/esm/bootstrap/runtime-network-topology.js.map +1 -0
  50. package/dist/esm/bootstrap/runtime-platform-access.d.ts +67 -0
  51. package/dist/esm/bootstrap/runtime-platform-access.d.ts.map +1 -0
  52. package/dist/esm/bootstrap/runtime-platform-access.js +57 -0
  53. package/dist/esm/bootstrap/runtime-platform-access.js.map +1 -0
  54. package/dist/esm/bootstrap/runtime-principal.contracts.d.ts +173 -0
  55. package/dist/esm/bootstrap/runtime-principal.contracts.d.ts.map +1 -0
  56. package/dist/esm/bootstrap/runtime-principal.contracts.js +218 -0
  57. package/dist/esm/bootstrap/runtime-principal.contracts.js.map +1 -0
  58. package/dist/esm/bootstrap/runtime-topology.contracts.d.ts +112 -1
  59. package/dist/esm/bootstrap/runtime-topology.contracts.d.ts.map +1 -1
  60. package/dist/esm/bootstrap/runtime-topology.contracts.js +141 -8
  61. package/dist/esm/bootstrap/runtime-topology.contracts.js.map +1 -1
  62. package/dist/esm/config-authoring.entry.d.ts +3 -0
  63. package/dist/esm/config-authoring.entry.d.ts.map +1 -0
  64. package/dist/esm/config-authoring.entry.js +5 -0
  65. package/dist/esm/config-authoring.entry.js.map +1 -0
  66. package/dist/esm/credentials/credential-generator.service.d.ts.map +1 -1
  67. package/dist/esm/credentials/credential-generator.service.js +1 -1
  68. package/dist/esm/credentials/credential-generator.service.js.map +1 -1
  69. package/dist/esm/index.d.ts +30 -15
  70. package/dist/esm/index.d.ts.map +1 -1
  71. package/dist/esm/index.js +16 -1
  72. package/dist/esm/index.js.map +1 -1
  73. package/dist/esm/lockfile/canonical-json.d.ts +41 -0
  74. package/dist/esm/lockfile/canonical-json.d.ts.map +1 -0
  75. package/dist/esm/lockfile/canonical-json.js +56 -0
  76. package/dist/esm/lockfile/canonical-json.js.map +1 -0
  77. package/dist/esm/lockfile/lockfile-io.d.ts +231 -0
  78. package/dist/esm/lockfile/lockfile-io.d.ts.map +1 -0
  79. package/dist/esm/lockfile/lockfile-io.js +303 -0
  80. package/dist/esm/lockfile/lockfile-io.js.map +1 -0
  81. package/dist/esm/lockfile/materialize-infra-section.d.ts +99 -0
  82. package/dist/esm/lockfile/materialize-infra-section.d.ts.map +1 -0
  83. package/dist/esm/lockfile/materialize-infra-section.js +153 -0
  84. package/dist/esm/lockfile/materialize-infra-section.js.map +1 -0
  85. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts +522 -0
  86. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts.map +1 -0
  87. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js +116 -0
  88. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js.map +1 -0
  89. package/dist/esm/project-config/define-framework-config.d.ts +36 -10
  90. package/dist/esm/project-config/define-framework-config.d.ts.map +1 -1
  91. package/dist/esm/project-config/define-framework-config.js +67 -3
  92. package/dist/esm/project-config/define-framework-config.js.map +1 -1
  93. package/dist/esm/project-config/define-infra-env-config.d.ts +570 -0
  94. package/dist/esm/project-config/define-infra-env-config.d.ts.map +1 -0
  95. package/dist/esm/project-config/define-infra-env-config.js +726 -0
  96. package/dist/esm/project-config/define-infra-env-config.js.map +1 -0
  97. package/dist/esm/project-config/define-minion-config.d.ts +221 -23
  98. package/dist/esm/project-config/define-minion-config.d.ts.map +1 -1
  99. package/dist/esm/project-config/define-minion-config.js +228 -11
  100. package/dist/esm/project-config/define-minion-config.js.map +1 -1
  101. package/dist/esm/project-config/define-saas-config.d.ts +427 -218
  102. package/dist/esm/project-config/define-saas-config.d.ts.map +1 -1
  103. package/dist/esm/project-config/define-saas-config.js +704 -75
  104. package/dist/esm/project-config/define-saas-config.js.map +1 -1
  105. package/dist/esm/project-config/define-worker-config.d.ts +106 -10
  106. package/dist/esm/project-config/define-worker-config.d.ts.map +1 -1
  107. package/dist/esm/project-config/define-worker-config.js +99 -9
  108. package/dist/esm/project-config/define-worker-config.js.map +1 -1
  109. package/dist/esm/project-config/index.d.ts +28 -21
  110. package/dist/esm/project-config/index.d.ts.map +1 -1
  111. package/dist/esm/project-config/index.js +14 -7
  112. package/dist/esm/project-config/index.js.map +1 -1
  113. package/dist/esm/project-config/loader.d.ts +120 -10
  114. package/dist/esm/project-config/loader.d.ts.map +1 -1
  115. package/dist/esm/project-config/loader.js +290 -38
  116. package/dist/esm/project-config/loader.js.map +1 -1
  117. package/dist/esm/project-config/minion-local-provider-registration.d.ts +69 -0
  118. package/dist/esm/project-config/minion-local-provider-registration.d.ts.map +1 -0
  119. package/dist/esm/project-config/minion-local-provider-registration.js +72 -0
  120. package/dist/esm/project-config/minion-local-provider-registration.js.map +1 -0
  121. package/dist/esm/project-config/provider-catalog-types.d.ts +12 -0
  122. package/dist/esm/project-config/provider-catalog-types.d.ts.map +1 -0
  123. package/dist/esm/project-config/provider-catalog-types.js +49 -0
  124. package/dist/esm/project-config/provider-catalog-types.js.map +1 -0
  125. package/dist/esm/project-config/provider-companion-discovery.d.ts +24 -0
  126. package/dist/esm/project-config/provider-companion-discovery.d.ts.map +1 -0
  127. package/dist/esm/project-config/provider-companion-discovery.js +244 -0
  128. package/dist/esm/project-config/provider-companion-discovery.js.map +1 -0
  129. package/dist/esm/project-config/provider-runtime-artifacts.d.ts +297 -0
  130. package/dist/esm/project-config/provider-runtime-artifacts.d.ts.map +1 -0
  131. package/dist/esm/project-config/provider-runtime-artifacts.js +860 -0
  132. package/dist/esm/project-config/provider-runtime-artifacts.js.map +1 -0
  133. package/dist/esm/project-config/shared/application-creation-verification.schemas.d.ts +18 -0
  134. package/dist/esm/project-config/shared/application-creation-verification.schemas.d.ts.map +1 -0
  135. package/dist/esm/project-config/shared/application-creation-verification.schemas.js +25 -0
  136. package/dist/esm/project-config/shared/application-creation-verification.schemas.js.map +1 -0
  137. package/dist/esm/project-config/shared/application-modules.schemas.d.ts +10 -2
  138. package/dist/esm/project-config/shared/application-modules.schemas.d.ts.map +1 -1
  139. package/dist/esm/project-config/shared/application-modules.schemas.js +12 -1
  140. package/dist/esm/project-config/shared/application-modules.schemas.js.map +1 -1
  141. package/dist/esm/project-config/shared/application-modules.utils.d.ts +2 -1
  142. package/dist/esm/project-config/shared/application-modules.utils.d.ts.map +1 -1
  143. package/dist/esm/project-config/shared/application-modules.utils.js +6 -1
  144. package/dist/esm/project-config/shared/application-modules.utils.js.map +1 -1
  145. package/dist/esm/project-config/shared/auth.schemas.d.ts +102 -0
  146. package/dist/esm/project-config/shared/auth.schemas.d.ts.map +1 -0
  147. package/dist/esm/project-config/shared/auth.schemas.js +100 -0
  148. package/dist/esm/project-config/shared/auth.schemas.js.map +1 -0
  149. package/dist/esm/project-config/shared/backing-services.schemas.d.ts +316 -39
  150. package/dist/esm/project-config/shared/backing-services.schemas.d.ts.map +1 -1
  151. package/dist/esm/project-config/shared/backing-services.schemas.js +359 -24
  152. package/dist/esm/project-config/shared/backing-services.schemas.js.map +1 -1
  153. package/dist/esm/project-config/shared/cdn.example.d.ts +14 -0
  154. package/dist/esm/project-config/shared/cdn.example.d.ts.map +1 -0
  155. package/dist/esm/project-config/shared/cdn.example.js +38 -0
  156. package/dist/esm/project-config/shared/cdn.example.js.map +1 -0
  157. package/dist/esm/project-config/shared/cdn.schemas.d.ts +182 -0
  158. package/dist/esm/project-config/shared/cdn.schemas.d.ts.map +1 -0
  159. package/dist/esm/project-config/shared/cdn.schemas.js +151 -0
  160. package/dist/esm/project-config/shared/cdn.schemas.js.map +1 -0
  161. package/dist/esm/project-config/shared/csp-defaults.d.ts +92 -0
  162. package/dist/esm/project-config/shared/csp-defaults.d.ts.map +1 -0
  163. package/dist/esm/project-config/shared/csp-defaults.js +195 -0
  164. package/dist/esm/project-config/shared/csp-defaults.js.map +1 -0
  165. package/dist/esm/project-config/shared/csp-emit.d.ts +106 -0
  166. package/dist/esm/project-config/shared/csp-emit.d.ts.map +1 -0
  167. package/dist/esm/project-config/shared/csp-emit.js +305 -0
  168. package/dist/esm/project-config/shared/csp-emit.js.map +1 -0
  169. package/dist/esm/project-config/shared/csp.schemas.d.ts +266 -0
  170. package/dist/esm/project-config/shared/csp.schemas.d.ts.map +1 -0
  171. package/dist/esm/project-config/shared/csp.schemas.js +281 -0
  172. package/dist/esm/project-config/shared/csp.schemas.js.map +1 -0
  173. package/dist/esm/project-config/shared/data-services.schemas.d.ts +45 -9
  174. package/dist/esm/project-config/shared/data-services.schemas.d.ts.map +1 -1
  175. package/dist/esm/project-config/shared/data-services.schemas.js +45 -9
  176. package/dist/esm/project-config/shared/data-services.schemas.js.map +1 -1
  177. package/dist/esm/project-config/shared/env-example-defaults.d.ts +0 -1
  178. package/dist/esm/project-config/shared/env-example-defaults.d.ts.map +1 -1
  179. package/dist/esm/project-config/shared/env-example-defaults.js +1 -2
  180. package/dist/esm/project-config/shared/env-example-defaults.js.map +1 -1
  181. package/dist/esm/project-config/shared/environment.schemas.d.ts +134 -8
  182. package/dist/esm/project-config/shared/environment.schemas.d.ts.map +1 -1
  183. package/dist/esm/project-config/shared/environment.schemas.js +185 -2
  184. package/dist/esm/project-config/shared/environment.schemas.js.map +1 -1
  185. package/dist/esm/project-config/shared/infra-providers.schemas.d.ts +779 -0
  186. package/dist/esm/project-config/shared/infra-providers.schemas.d.ts.map +1 -0
  187. package/dist/esm/project-config/shared/infra-providers.schemas.js +210 -0
  188. package/dist/esm/project-config/shared/infra-providers.schemas.js.map +1 -0
  189. package/dist/esm/project-config/shared/infra-service.schemas.d.ts +18 -0
  190. package/dist/esm/project-config/shared/infra-service.schemas.d.ts.map +1 -0
  191. package/dist/esm/project-config/shared/infra-service.schemas.js +16 -0
  192. package/dist/esm/project-config/shared/infra-service.schemas.js.map +1 -0
  193. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts +83 -1
  194. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts.map +1 -1
  195. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js +99 -2
  196. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js.map +1 -1
  197. package/dist/esm/project-config/shared/k8s-utils.d.ts +51 -7
  198. package/dist/esm/project-config/shared/k8s-utils.d.ts.map +1 -1
  199. package/dist/esm/project-config/shared/k8s-utils.js +59 -12
  200. package/dist/esm/project-config/shared/k8s-utils.js.map +1 -1
  201. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.d.ts +31 -0
  202. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.d.ts.map +1 -0
  203. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js +32 -0
  204. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js.map +1 -0
  205. package/dist/esm/project-config/shared/minion-resource-access.validation.d.ts +142 -0
  206. package/dist/esm/project-config/shared/minion-resource-access.validation.d.ts.map +1 -0
  207. package/dist/esm/project-config/shared/minion-resource-access.validation.js +159 -0
  208. package/dist/esm/project-config/shared/minion-resource-access.validation.js.map +1 -0
  209. package/dist/esm/project-config/shared/object-storage-session-policy.d.ts +100 -0
  210. package/dist/esm/project-config/shared/object-storage-session-policy.d.ts.map +1 -0
  211. package/dist/esm/project-config/shared/object-storage-session-policy.js +130 -0
  212. package/dist/esm/project-config/shared/object-storage-session-policy.js.map +1 -0
  213. package/dist/esm/project-config/shared/platform-services.schemas.d.ts +9 -14
  214. package/dist/esm/project-config/shared/platform-services.schemas.d.ts.map +1 -1
  215. package/dist/esm/project-config/shared/platform-services.schemas.js +13 -9
  216. package/dist/esm/project-config/shared/platform-services.schemas.js.map +1 -1
  217. package/dist/esm/project-config/shared/schema-version.schemas.d.ts +15 -0
  218. package/dist/esm/project-config/shared/schema-version.schemas.d.ts.map +1 -0
  219. package/dist/esm/project-config/shared/schema-version.schemas.js +40 -0
  220. package/dist/esm/project-config/shared/schema-version.schemas.js.map +1 -0
  221. package/dist/esm/project-config/shared/service-definitions.schemas.d.ts +283 -8
  222. package/dist/esm/project-config/shared/service-definitions.schemas.d.ts.map +1 -1
  223. package/dist/esm/project-config/shared/service-definitions.schemas.js +325 -8
  224. package/dist/esm/project-config/shared/service-definitions.schemas.js.map +1 -1
  225. package/dist/esm/registry/artifact-domain.schemas.d.ts +54 -0
  226. package/dist/esm/registry/artifact-domain.schemas.d.ts.map +1 -0
  227. package/dist/esm/registry/artifact-domain.schemas.js +40 -0
  228. package/dist/esm/registry/artifact-domain.schemas.js.map +1 -0
  229. package/dist/esm/registry/companion-api.schemas.d.ts +176 -0
  230. package/dist/esm/registry/companion-api.schemas.d.ts.map +1 -0
  231. package/dist/esm/registry/companion-api.schemas.js +165 -0
  232. package/dist/esm/registry/companion-api.schemas.js.map +1 -0
  233. package/dist/esm/registry/digest.schemas.d.ts +20 -0
  234. package/dist/esm/registry/digest.schemas.d.ts.map +1 -0
  235. package/dist/esm/registry/digest.schemas.js +21 -0
  236. package/dist/esm/registry/digest.schemas.js.map +1 -0
  237. package/dist/esm/registry/index.d.ts +33 -0
  238. package/dist/esm/registry/index.d.ts.map +1 -0
  239. package/dist/esm/registry/index.js +33 -0
  240. package/dist/esm/registry/index.js.map +1 -0
  241. package/dist/esm/registry/lockfile-modules-section.schemas.d.ts +107 -0
  242. package/dist/esm/registry/lockfile-modules-section.schemas.d.ts.map +1 -0
  243. package/dist/esm/registry/lockfile-modules-section.schemas.js +67 -0
  244. package/dist/esm/registry/lockfile-modules-section.schemas.js.map +1 -0
  245. package/dist/esm/registry/module-artifact.schemas.d.ts +94 -0
  246. package/dist/esm/registry/module-artifact.schemas.d.ts.map +1 -0
  247. package/dist/esm/registry/module-artifact.schemas.js +69 -0
  248. package/dist/esm/registry/module-artifact.schemas.js.map +1 -0
  249. package/dist/esm/registry/module-manifest.schemas.d.ts +134 -0
  250. package/dist/esm/registry/module-manifest.schemas.d.ts.map +1 -0
  251. package/dist/esm/registry/module-manifest.schemas.js +155 -0
  252. package/dist/esm/registry/module-manifest.schemas.js.map +1 -0
  253. package/dist/esm/registry/registry-config.schemas.d.ts +31 -0
  254. package/dist/esm/registry/registry-config.schemas.d.ts.map +1 -0
  255. package/dist/esm/registry/registry-config.schemas.js +24 -0
  256. package/dist/esm/registry/registry-config.schemas.js.map +1 -0
  257. package/dist/esm/registry/registry-defaults.constants.d.ts +37 -0
  258. package/dist/esm/registry/registry-defaults.constants.d.ts.map +1 -0
  259. package/dist/esm/registry/registry-defaults.constants.js +37 -0
  260. package/dist/esm/registry/registry-defaults.constants.js.map +1 -0
  261. package/dist/esm/registry/registry-errors.d.ts +109 -0
  262. package/dist/esm/registry/registry-errors.d.ts.map +1 -0
  263. package/dist/esm/registry/registry-errors.js +185 -0
  264. package/dist/esm/registry/registry-errors.js.map +1 -0
  265. package/dist/esm/registry/registry-section-schemas.constants.d.ts +39 -0
  266. package/dist/esm/registry/registry-section-schemas.constants.d.ts.map +1 -0
  267. package/dist/esm/registry/registry-section-schemas.constants.js +22 -0
  268. package/dist/esm/registry/registry-section-schemas.constants.js.map +1 -0
  269. package/dist/esm/release/framework-release.constants.d.ts +26 -1
  270. package/dist/esm/release/framework-release.constants.d.ts.map +1 -1
  271. package/dist/esm/release/framework-release.constants.js +27 -2
  272. package/dist/esm/release/framework-release.constants.js.map +1 -1
  273. package/dist/esm/schemas/framework-info.schemas.d.ts +1 -1
  274. package/dist/esm/schemas/framework-info.schemas.d.ts.map +1 -1
  275. package/dist/esm/schemas/framework-info.schemas.js +1 -1
  276. package/dist/esm/schemas/framework-info.schemas.js.map +1 -1
  277. package/dist/esm/schemas/framework-secrets.schemas.d.ts +5 -5
  278. package/dist/esm/schemas/framework-secrets.schemas.d.ts.map +1 -1
  279. package/dist/esm/schemas/framework-secrets.schemas.js +1 -1
  280. package/dist/esm/schemas/framework-secrets.schemas.js.map +1 -1
  281. package/dist/esm/schemas/platform-application-config.schemas.d.ts +1 -1
  282. package/dist/esm/schemas/platform-application-config.schemas.d.ts.map +1 -1
  283. package/dist/esm/schemas/platform-application-config.schemas.js +11 -2
  284. package/dist/esm/schemas/platform-application-config.schemas.js.map +1 -1
  285. package/dist/esm/schemas/platform-application-secrets.schemas.d.ts +7 -7
  286. package/dist/esm/schemas/platform-application-secrets.schemas.d.ts.map +1 -1
  287. package/dist/esm/schemas/platform-application-secrets.schemas.js +17 -2
  288. package/dist/esm/schemas/platform-application-secrets.schemas.js.map +1 -1
  289. package/dist/esm/schemas/platform-config.schemas.d.ts +12 -13
  290. package/dist/esm/schemas/platform-config.schemas.d.ts.map +1 -1
  291. package/dist/esm/schemas/platform-config.schemas.js +15 -3
  292. package/dist/esm/schemas/platform-config.schemas.js.map +1 -1
  293. package/dist/esm/workspace-scope/application-subject-manifest.d.ts +26 -0
  294. package/dist/esm/workspace-scope/application-subject-manifest.d.ts.map +1 -0
  295. package/dist/esm/workspace-scope/application-subject-manifest.js +43 -0
  296. package/dist/esm/workspace-scope/application-subject-manifest.js.map +1 -0
  297. package/dist/esm/workspace-scope/index.d.ts +5 -2
  298. package/dist/esm/workspace-scope/index.d.ts.map +1 -1
  299. package/dist/esm/workspace-scope/index.js +4 -1
  300. package/dist/esm/workspace-scope/index.js.map +1 -1
  301. package/dist/esm/workspace-scope/resolve-homes.d.ts +20 -0
  302. package/dist/esm/workspace-scope/resolve-homes.d.ts.map +1 -0
  303. package/dist/esm/workspace-scope/resolve-homes.js +62 -0
  304. package/dist/esm/workspace-scope/resolve-homes.js.map +1 -0
  305. package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts +211 -0
  306. package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts.map +1 -0
  307. package/dist/esm/workspace-scope/workspace-homes.schemas.js +113 -0
  308. package/dist/esm/workspace-scope/workspace-homes.schemas.js.map +1 -0
  309. package/dist/esm/workspace-scope/workspace-scope-detector.d.ts +10 -5
  310. package/dist/esm/workspace-scope/workspace-scope-detector.d.ts.map +1 -1
  311. package/dist/esm/workspace-scope/workspace-scope-detector.js +22 -36
  312. package/dist/esm/workspace-scope/workspace-scope-detector.js.map +1 -1
  313. package/dist/esm/workspace-scope/workspace-scope.schemas.d.ts +147 -58
  314. package/dist/esm/workspace-scope/workspace-scope.schemas.d.ts.map +1 -1
  315. package/dist/esm/workspace-scope/workspace-scope.schemas.js +174 -78
  316. package/dist/esm/workspace-scope/workspace-scope.schemas.js.map +1 -1
  317. package/dist/tsconfig.build.tsbuildinfo +1 -1
  318. package/package.json +31 -17
  319. package/dist/esm/credentials/credentials-provisioner.service.d.ts +0 -190
  320. package/dist/esm/credentials/credentials-provisioner.service.d.ts.map +0 -1
  321. package/dist/esm/credentials/credentials-provisioner.service.js +0 -278
  322. package/dist/esm/credentials/credentials-provisioner.service.js.map +0 -1
  323. package/dist/esm/infra-managers/infra-manager.models.d.ts +0 -146
  324. package/dist/esm/infra-managers/infra-manager.models.d.ts.map +0 -1
  325. package/dist/esm/infra-managers/infra-manager.models.js +0 -2
  326. package/dist/esm/infra-managers/infra-manager.models.js.map +0 -1
  327. package/dist/esm/infra-managers/mongo-atlas-manager.service.d.ts +0 -64
  328. package/dist/esm/infra-managers/mongo-atlas-manager.service.d.ts.map +0 -1
  329. package/dist/esm/infra-managers/mongo-atlas-manager.service.js +0 -307
  330. package/dist/esm/infra-managers/mongo-atlas-manager.service.js.map +0 -1
  331. package/dist/esm/infra-managers/postgresql-manager.service.d.ts +0 -115
  332. package/dist/esm/infra-managers/postgresql-manager.service.d.ts.map +0 -1
  333. package/dist/esm/infra-managers/postgresql-manager.service.js +0 -403
  334. package/dist/esm/infra-managers/postgresql-manager.service.js.map +0 -1
  335. package/dist/esm/infra-managers/rabbitmq-manager.service.d.ts +0 -64
  336. package/dist/esm/infra-managers/rabbitmq-manager.service.d.ts.map +0 -1
  337. package/dist/esm/infra-managers/rabbitmq-manager.service.js +0 -288
  338. package/dist/esm/infra-managers/rabbitmq-manager.service.js.map +0 -1
  339. package/dist/esm/infra-managers/redis-manager.service.d.ts +0 -78
  340. package/dist/esm/infra-managers/redis-manager.service.d.ts.map +0 -1
  341. package/dist/esm/infra-managers/redis-manager.service.js +0 -326
  342. package/dist/esm/infra-managers/redis-manager.service.js.map +0 -1
  343. package/dist/esm/project-config/define-infra-config.d.ts +0 -128
  344. package/dist/esm/project-config/define-infra-config.d.ts.map +0 -1
  345. package/dist/esm/project-config/define-infra-config.js +0 -87
  346. package/dist/esm/project-config/define-infra-config.js.map +0 -1
  347. package/dist/esm/project-config/define-platform-config.d.ts +0 -65
  348. package/dist/esm/project-config/define-platform-config.d.ts.map +0 -1
  349. package/dist/esm/project-config/define-platform-config.js +0 -22
  350. package/dist/esm/project-config/define-platform-config.js.map +0 -1
  351. package/dist/esm/project-config/define-platform-env-config.d.ts +0 -41
  352. package/dist/esm/project-config/define-platform-env-config.d.ts.map +0 -1
  353. package/dist/esm/project-config/define-platform-env-config.js +0 -45
  354. package/dist/esm/project-config/define-platform-env-config.js.map +0 -1
  355. package/dist/esm/project-config/define-project-config.d.ts +0 -38
  356. package/dist/esm/project-config/define-project-config.d.ts.map +0 -1
  357. package/dist/esm/project-config/define-project-config.js +0 -57
  358. package/dist/esm/project-config/define-project-config.js.map +0 -1
  359. package/dist/esm/project-config/define-sharing-policy.d.ts +0 -35
  360. package/dist/esm/project-config/define-sharing-policy.d.ts.map +0 -1
  361. package/dist/esm/project-config/define-sharing-policy.js +0 -30
  362. package/dist/esm/project-config/define-sharing-policy.js.map +0 -1
  363. package/dist/esm/project-config/sharing-policy-validation.d.ts +0 -40
  364. package/dist/esm/project-config/sharing-policy-validation.d.ts.map +0 -1
  365. package/dist/esm/project-config/sharing-policy-validation.js +0 -143
  366. package/dist/esm/project-config/sharing-policy-validation.js.map +0 -1
  367. package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.d.ts +0 -23
  368. package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.d.ts.map +0 -1
  369. package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.js +0 -13
  370. package/dist/esm/runtime-bridge/platform-runtime-bridge.contracts.js.map +0 -1
  371. package/src/bootstrap/application-backend-env.contracts.ts +0 -17
  372. package/src/bootstrap/bootstrap-planner.ts +0 -46
  373. package/src/bootstrap/bootstrap.contracts.ts +0 -251
  374. package/src/bootstrap/bootstrap.schemas.ts +0 -164
  375. package/src/bootstrap/platform-runtime-env.contracts.ts +0 -99
  376. package/src/bootstrap/runtime-topology.contracts.ts +0 -102
  377. package/src/credentials/credential-generator.service.ts +0 -39
  378. package/src/index.ts +0 -16
  379. package/src/project-config/__tests__/application-modules.utils.test.ts +0 -53
  380. package/src/project-config/__tests__/define-framework-config.test.ts +0 -43
  381. package/src/project-config/__tests__/define-saas-config.test.ts +0 -210
  382. package/src/project-config/__tests__/loader.test.ts +0 -100
  383. package/src/project-config/define-framework-config.ts +0 -44
  384. package/src/project-config/define-infra-config.ts +0 -168
  385. package/src/project-config/define-minion-config.ts +0 -27
  386. package/src/project-config/define-platform-config.ts +0 -28
  387. package/src/project-config/define-platform-env-config.ts +0 -59
  388. package/src/project-config/define-project-config.ts +0 -63
  389. package/src/project-config/define-saas-config.ts +0 -171
  390. package/src/project-config/define-sharing-policy.ts +0 -36
  391. package/src/project-config/define-worker-config.ts +0 -27
  392. package/src/project-config/index.ts +0 -23
  393. package/src/project-config/loader.ts +0 -220
  394. package/src/project-config/shared/application-modules.schemas.ts +0 -12
  395. package/src/project-config/shared/application-modules.utils.ts +0 -65
  396. package/src/project-config/shared/backing-services.schemas.ts +0 -59
  397. package/src/project-config/shared/data-services.schemas.ts +0 -58
  398. package/src/project-config/shared/env-example-defaults.ts +0 -50
  399. package/src/project-config/shared/environment.schemas.ts +0 -136
  400. package/src/project-config/shared/infrastructure-defaults.schemas.ts +0 -47
  401. package/src/project-config/shared/k8s-utils.ts +0 -56
  402. package/src/project-config/shared/platform-services.schemas.ts +0 -33
  403. package/src/project-config/shared/service-definitions.schemas.ts +0 -38
  404. package/src/project-config/sharing-policy-validation.ts +0 -159
  405. package/src/release/framework-release.constants.ts +0 -2
  406. package/src/schemas/__tests__/platform-config.schemas.test.ts +0 -90
  407. package/src/schemas/framework-info.schemas.ts +0 -13
  408. package/src/schemas/framework-secrets.schemas.ts +0 -19
  409. package/src/schemas/platform-application-config.schemas.ts +0 -25
  410. package/src/schemas/platform-application-secrets.schemas.ts +0 -78
  411. package/src/schemas/platform-config.schemas.ts +0 -45
  412. package/src/workspace-scope/index.ts +0 -2
  413. package/src/workspace-scope/workspace-scope-detector.ts +0 -98
  414. package/src/workspace-scope/workspace-scope.schemas.ts +0 -224
@@ -16,8 +16,8 @@ export declare enum PlatformProcessEnvKey {
16
16
  }
17
17
  export declare enum PlatformServiceUrlEnvKey {
18
18
  PLATFORM_APPS_MANAGER_URL = "PLATFORM_APPS_MANAGER_URL",
19
- PLATFORM_FILE_GENERATOR_URL = "PLATFORM_FILE_GENERATOR_URL",
20
- PLATFORM_CRONTABS_BATCHES_MANAGER_URL = "PLATFORM_CRONTABS_BATCHES_MANAGER_URL"
19
+ PLATFORM_CRONTABS_BATCHES_MANAGER_URL = "PLATFORM_CRONTABS_BATCHES_MANAGER_URL",
20
+ PLATFORM_MODULE_REGISTRY_URL = "PLATFORM_MODULE_REGISTRY_URL"
21
21
  }
22
22
  export declare enum PlatformInfrastructureEnvKey {
23
23
  MONGO_CONNECT_URL = "MONGO_CONNECT_URL",
@@ -25,14 +25,33 @@ export declare enum PlatformInfrastructureEnvKey {
25
25
  BASE_MONGO_SERVER_URL = "BASE_MONGO_SERVER_URL",
26
26
  REDIS_HOST = "REDIS_HOST",
27
27
  REDIS_PORT = "REDIS_PORT",
28
+ /**
29
+ * Optional Redis logical database index (0–15). Emitted only when the
30
+ * author sets `backingServices.redis.database` in `wildo.infra.<env>.config.ts`.
31
+ * Consumers default to DB 0 when this var is missing.
32
+ */
33
+ REDIS_DATABASE = "REDIS_DATABASE",
28
34
  REDIS_ADMIN_USER = "REDIS_ADMIN_USER",
29
35
  REDIS_ADMIN_PASSWORD = "REDIS_ADMIN_PASSWORD",
30
36
  RABBITMQ_HOST = "RABBITMQ_HOST",
31
37
  RABBITMQ_PORT = "RABBITMQ_PORT",
32
38
  RABBITMQ_MANAGEMENT_PORT = "RABBITMQ_MANAGEMENT_PORT",
39
+ /**
40
+ * Optional RabbitMQ virtual host. Emitted only when the author sets
41
+ * `backingServices.rabbitmq.vhost` in `wildo.infra.<env>.config.ts`.
42
+ * Consumers default to `/` (the RabbitMQ root vhost) when missing.
43
+ */
44
+ RABBITMQ_VHOST = "RABBITMQ_VHOST",
33
45
  RABBITMQ_ADMIN_USERNAME = "RABBITMQ_ADMIN_USERNAME",
34
46
  RABBITMQ_ADMIN_PASSWORD = "RABBITMQ_ADMIN_PASSWORD",
35
47
  STORAGE_PROVIDER = "STORAGE_PROVIDER",
48
+ /**
49
+ * S3-compatible endpoint **hostname** (NOT a URL); see the matching
50
+ * JSDoc on `ApplicationBackendDataEnvKey.STORAGE_ENDPOINT` for the
51
+ * full contract (Slice 3.2 audit L-4). Kept here for the
52
+ * platform-runtime side (apps-manager) — same
53
+ * host:port-only invariant.
54
+ */
36
55
  STORAGE_ENDPOINT = "STORAGE_ENDPOINT",
37
56
  STORAGE_PORT = "STORAGE_PORT",
38
57
  STORAGE_USE_SSL = "STORAGE_USE_SSL",
@@ -44,12 +63,45 @@ export declare enum PlatformInfrastructureEnvKey {
44
63
  PG_PORT = "PG_PORT",
45
64
  PG_ADMIN_USER = "PG_ADMIN_USER",
46
65
  PG_ADMIN_PASSWORD = "PG_ADMIN_PASSWORD",
66
+ /**
67
+ * The MAINTENANCE database the admin pool connects to in order to provision others — NOT the
68
+ * application's database and NOT the container's initdb database (that is
69
+ * `POSTGRES_ADMIN_DATABASE`, a different key on a different transport). Emitted from
70
+ * `PLATFORM_POSTGRES_MAINTENANCE_DATABASE`, whose JSDoc carries the three-way distinction and
71
+ * the silent outage that conflating the first two produced.
72
+ */
47
73
  PG_ADMIN_DATABASE = "PG_ADMIN_DATABASE",
48
- PG_SSL_MODE = "PG_SSL_MODE"
74
+ PG_SSL_MODE = "PG_SSL_MODE",
75
+ /**
76
+ * The platform's OWN PostgreSQL database — a full connection URL, the exact mirror of
77
+ * `MONGO_CONNECT_URL` for a PostgreSQL-engined platform (D7 of the incremental-migrations plan).
78
+ *
79
+ * Distinct from the `PG_ADMIN_*` family above, which is PROVISIONING material (the admin
80
+ * connection apps-manager uses to create per-application databases/roles). This key is the
81
+ * database apps-manager's own resources live in. One URL rather than an address/credential
82
+ * split on purpose: the platform pre-connects from env BEFORE any config document can be read
83
+ * (the same chicken-and-egg `MONGO_CONNECT_URL` solves — the config documents live in the very
84
+ * database this key addresses), so the whole answer must arrive in one env-delivered value.
85
+ *
86
+ * Emitted by the CLI's platform env builder only when the environment's
87
+ * `database.engine === POSTGRESQL`. Absent on a Mongo-engined platform.
88
+ */
89
+ PG_CONNECT_URL = "PG_CONNECT_URL"
49
90
  }
50
91
  export declare enum PlatformSecurityEnvKey {
51
92
  PLATFORM_APPS_MANAGER_PRIVATE_KEY = "PLATFORM_APPS_MANAGER_PRIVATE_KEY",
52
93
  PLATFORM_APPS_MANAGER_PUBLIC_KEY = "PLATFORM_APPS_MANAGER_PUBLIC_KEY",
94
+ /**
95
+ * The crontabs-batches-manager's dedicated P2P signing keypair. The design is
96
+ * per-service (mirrors apps-manager): the crontabs scheduler signs each SCHEDULED_CRON /
97
+ * MINION_TICK job token with the PRIVATE half, and every app + minion verifies it against
98
+ * the PUBLIC half (distributed to each app's `PLATFORM_CRONTABS_BATCHES_MANAGER` verify
99
+ * slot by apps-manager). These were previously absent from the whole minting/emission
100
+ * chain — so crontabs silently fell back to another key and apps handed out an EMPTY verify
101
+ * key, dead-lettering every scheduled tick. Minted by `buildCredentials`, emitted here.
102
+ */
103
+ PLATFORM_CRONTABS_BATCHES_MANAGER_PRIVATE_KEY = "PLATFORM_CRONTABS_BATCHES_MANAGER_PRIVATE_KEY",
104
+ PLATFORM_CRONTABS_BATCHES_MANAGER_PUBLIC_KEY = "PLATFORM_CRONTABS_BATCHES_MANAGER_PUBLIC_KEY",
53
105
  PLATFORM_APPLICATION_PRIMARY_SECRET = "PLATFORM_APPLICATION_PRIMARY_SECRET",
54
106
  PLATFORM_ADMIN_SECRET = "PLATFORM_ADMIN_SECRET"
55
107
  }
@@ -60,19 +112,172 @@ export declare enum PlatformAdminEnvKey {
60
112
  ADMIN_LAST_NAME = "ADMIN_LAST_NAME",
61
113
  GITHUB_WILDO_APPS_DEFAULT_ORG_URL = "GITHUB_WILDO_APPS_DEFAULT_ORG_URL",
62
114
  GITHUB_WILDO_APPS_ADMIN_USER = "GITHUB_WILDO_APPS_ADMIN_USER",
63
- GITHUB_WILDO_APPS_ADMIN_TOKEN = "GITHUB_WILDO_APPS_ADMIN_TOKEN",
64
- GITHUB_WILDO_APPS_ADMIN_SSH_SK = "GITHUB_WILDO_APPS_ADMIN_SSH_SK"
115
+ GITHUB_WILDO_APPS_ADMIN_TOKEN = "GITHUB_WILDO_APPS_ADMIN_TOKEN"
65
116
  }
66
117
  export declare enum PlatformKubernetesEnvKey {
67
- K8S_NAMESPACE = "K8S_NAMESPACE",
68
- K8S_EXTERNAL_BASE_DOMAIN = "K8S_EXTERNAL_BASE_DOMAIN",
69
- K8S_IMAGE_REGISTRY = "K8S_IMAGE_REGISTRY"
118
+ K8S_NAMESPACE = "K8S_NAMESPACE"
70
119
  }
120
+ /**
121
+ * Ingress / reverse-proxy env keys.
122
+ *
123
+ * `WILDO_PUBLIC_DOMAIN` is the runtime-agnostic public hostname that
124
+ * apps-manager uses to compose ingress URLs and that backend services
125
+ * use to derive cookie `Domain` and CORS allowlist entries. It applies
126
+ * to BOTH Kubernetes and Docker Compose deployments — naming it
127
+ * `K8S_*` (as in the previous `K8S_EXTERNAL_BASE_DOMAIN`) was a
128
+ * conflation; see `external-public-domain-rename.md`.
129
+ */
130
+ export declare enum PlatformIngressEnvKey {
131
+ WILDO_PUBLIC_DOMAIN = "WILDO_PUBLIC_DOMAIN",
132
+ /**
133
+ * JSON-serialized `WildoInfraEnvConfig.serviceHosts` map (`<serviceKey> →
134
+ * subdomain chain`, `''` = apex). Projected by `env-vars-builder` so
135
+ * apps-manager can resolve each customer-app service's public host via
136
+ * `buildServicePublicHost` (serviceHosts-driven ingress, no fan-out). Absent
137
+ * / empty ⇒ every key falls back to `<serviceKey>.<publicDomain>`.
138
+ */
139
+ WILDO_SERVICE_HOSTS = "WILDO_SERVICE_HOSTS"
140
+ }
141
+ /**
142
+ * Logging env-var contract (Slice 3.5).
143
+ *
144
+ * Both keys are projected from `WildoInfraEnvConfig.logging.*` by
145
+ * `env-vars-builder` for every long-running platform/application
146
+ * process, and consumed by `LoggerService.loadConfiguration` in
147
+ * `saas-backend-lib`. Missing values fall back to the LoggerService
148
+ * defaults (level `debug`, pino-pretty auto-detect by environment),
149
+ * matching the optional shape on `WildoLoggingConfigSchema`.
150
+ *
151
+ * `LOG_LEVEL` accepts the lowercase pino levels
152
+ * (`debug | info | warn | error`); the `WildoLoggingConfigSchema` enum
153
+ * is the authoritative validation surface upstream so an invalid
154
+ * value can never reach `process.env`.
155
+ *
156
+ * `LOG_FORMATTED_CONSOLE_ERRORS` is a stringified boolean
157
+ * (`'true' | 'false'`) that overrides the LoggerService's
158
+ * environment-derived pino-pretty / JSON branch. When unset,
159
+ * LoggerService keeps its existing auto-detect behavior (pino-pretty
160
+ * iff `APPLICATION_ENV === 'development'`).
161
+ */
162
+ export declare enum PlatformLoggingEnvKey {
163
+ LOG_LEVEL = "LOG_LEVEL",
164
+ LOG_FORMATTED_CONSOLE_ERRORS = "LOG_FORMATTED_CONSOLE_ERRORS"
165
+ }
166
+ /**
167
+ * OTLP telemetry env-var contract (Slice 2 Phase 5).
168
+ *
169
+ * Projected from `WildoInfraEnvConfig.observability.*` + the selected
170
+ * `OBSERVABILITY_TELEMETRY` provider by `env-vars-builder`, and read by the
171
+ * `otel-preload.ts` OTel SDK in `saas-backend-lib` BEFORE app code. These are the
172
+ * STANDARD OpenTelemetry env vars — the preload + OTLP exporters consume them
173
+ * directly, so the engine stays provider-agnostic.
174
+ *
175
+ * `OTEL_ENABLED` is the master gate (`'true'`). `OTEL_EXPORTER_OTLP_ENDPOINT` is the
176
+ * OTLP/HTTP collector/ingest URL. `OTEL_EXPORTER_OTLP_HEADERS` carries the provider auth
177
+ * (e.g. `Authorization=Bearer <source-token>`) — SENSITIVE, routed to the K8s Secret.
178
+ * `OTEL_SERVICE_NAME` + `OTEL_RESOURCE_ATTRIBUTES` carry the resource identity
179
+ * (`service.name`, `service.version`, `deployment.environment`).
180
+ */
181
+ export declare enum PlatformObservabilityEnvKey {
182
+ OTEL_ENABLED = "OTEL_ENABLED",
183
+ OTEL_EXPORTER_OTLP_ENDPOINT = "OTEL_EXPORTER_OTLP_ENDPOINT",
184
+ OTEL_EXPORTER_OTLP_HEADERS = "OTEL_EXPORTER_OTLP_HEADERS",
185
+ OTEL_SERVICE_NAME = "OTEL_SERVICE_NAME",
186
+ OTEL_RESOURCE_ATTRIBUTES = "OTEL_RESOURCE_ATTRIBUTES",
187
+ /**
188
+ * LLM-call observability (a SEPARATE signal from OTLP telemetry — PostHog
189
+ * `$ai_generation` via the engine's `AgentCallTraceSink`): opt-in forwarding
190
+ * of prompt + completion content (`$ai_input` / `$ai_output_choices`). PII
191
+ * shipped to a third party, hence opt-in per environment. Read by the
192
+ * engine's lazy LLM-obs sink resolution, NOT the OTLP preload.
193
+ */
194
+ WILDO_LLM_OBS_CAPTURE_CONTENT = "WILDO_LLM_OBS_CAPTURE_CONTENT",
195
+ /** LLM-call observability sampling fraction (0..1); omitted = capture all. */
196
+ WILDO_LLM_OBS_SAMPLE_RATE = "WILDO_LLM_OBS_SAMPLE_RATE"
197
+ }
198
+ /**
199
+ * Per-environment external-provider SELECTION override env-var contract
200
+ * (2026-07-10).
201
+ *
202
+ * Projected from `WildoInfraEnvConfig.providerSelection` by `env-vars-builder`
203
+ * as a single serialized JSON payload (mirrors how `APPLICATION_RUNTIME_ENDPOINTS`
204
+ * carries a structured payload in one var). Read by
205
+ * `ExternalProvidersRegistryBackendService` at capability-resolution time to
206
+ * override the app-wide `providers.scopes.backend.selection[capability]`
207
+ * primary/fallbacks for THIS environment only. Absent => the SaaS-config
208
+ * selection applies unchanged.
209
+ *
210
+ * Shape: `{ "<EngineCapability>": { "primary": "<ref>", "fallbacks"?: ["<ref>"] } }`.
211
+ */
212
+ export declare enum PlatformProviderSelectionEnvKey {
213
+ WILDO_PROVIDER_SELECTION_OVERRIDES = "WILDO_PROVIDER_SELECTION_OVERRIDES"
214
+ }
215
+ /**
216
+ * Documentation-site BUILD env-var contract.
217
+ *
218
+ * Projected from `WildoInfraEnvConfig.documentationSite` by `env-vars-builder`. Unlike the
219
+ * other families here these are consumed by a BUILD rather than a running service: a
220
+ * Docusaurus bundle compiles its origins in, so the values must be present when the site is
221
+ * built, and a bundle built with the wrong ones silently points every reader at the wrong
222
+ * host instead of failing.
223
+ *
224
+ * The application's `docusaurus.config.ts` refuses to complete a production build when they
225
+ * are unset, and falls back to local defaults otherwise. Before this contract existed the
226
+ * only way to satisfy that guard was to remember three variables on a build command line,
227
+ * so they appeared in no environment definition anywhere.
228
+ *
229
+ * Emitted individually rather than as one serialized payload (the `providerSelection`
230
+ * shape): each is a single scalar read directly by the config, and a JSON blob would force
231
+ * the docs config to parse a payload to recover three strings.
232
+ */
233
+ export declare enum PlatformDocumentationSiteEnvKey {
234
+ WILDO_DOCS_API_BASE_URL = "WILDO_DOCS_API_BASE_URL",
235
+ WILDO_DOCS_APP_URL = "WILDO_DOCS_APP_URL",
236
+ WILDO_DOCS_FRONTEND_SERVICE_NAME = "WILDO_DOCS_FRONTEND_SERVICE_NAME"
237
+ }
238
+ export declare const PlatformDocumentationSiteEnvKeys: typeof PlatformDocumentationSiteEnvKey;
71
239
  export declare const PlatformProcessEnvKeys: typeof PlatformProcessEnvKey;
72
240
  export declare const PlatformServiceUrlEnvKeys: typeof PlatformServiceUrlEnvKey;
73
241
  export declare const PlatformInfrastructureEnvKeys: typeof PlatformInfrastructureEnvKey;
74
242
  export declare const PlatformSecurityEnvKeys: typeof PlatformSecurityEnvKey;
75
243
  export declare const PlatformAdminEnvKeys: typeof PlatformAdminEnvKey;
76
244
  export declare const PlatformKubernetesEnvKeys: typeof PlatformKubernetesEnvKey;
245
+ export declare const PlatformIngressEnvKeys: typeof PlatformIngressEnvKey;
246
+ export declare const PlatformLoggingEnvKeys: typeof PlatformLoggingEnvKey;
247
+ export declare const PlatformObservabilityEnvKeys: typeof PlatformObservabilityEnvKey;
248
+ export declare const PlatformProviderSelectionEnvKeys: typeof PlatformProviderSelectionEnvKey;
249
+ /**
250
+ * Resolve a required environment variable value or throw a clear,
251
+ * actionable error.
252
+ *
253
+ * This is the canonical fail-closed reader for platform runtime env vars.
254
+ * It exists to replace silent string-fallback patterns like
255
+ * `process.env.X || 'localhost'` / `process.env.Y || 'local'` /
256
+ * `process.env.Z || 'http://localhost:NNNN'` in apps-manager and any
257
+ * other platform service. Those patterns let production processes start
258
+ * silently mis-wired (e.g. talking to `localhost` instead of the real
259
+ * cluster service) and surface as opaque downstream errors much later.
260
+ *
261
+ * Contract:
262
+ * - Empty strings are treated as missing (a `KEY=` line in `.env` is a
263
+ * misconfiguration, not an "intentional empty value").
264
+ * - The thrown error names both the env var and the consuming context
265
+ * (e.g. `"Missing required env var REDIS_HOST (consumer:
266
+ * PlatformInfrastructureManagerService.provisionAllPlatformConfigs)"`).
267
+ * - This helper does NOT decide whether a key is sensitive — that lives
268
+ * in `PLATFORM_RUNTIME_SENSITIVE_ENV_KEYS`. Callers are responsible
269
+ * for not logging the resolved value when sensitive.
270
+ *
271
+ * Usage:
272
+ * const host = requireEnv(
273
+ * PlatformInfrastructureEnvKey.REDIS_HOST,
274
+ * 'PlatformInfrastructureManagerService.provisionAllPlatformConfigs',
275
+ * );
276
+ *
277
+ * Local-development defaults must live in `secrets.json` /
278
+ * `infrastructure/<env>/secrets/` and be loaded into `process.env` by
279
+ * the CLI / K8s wiring, NOT in production code paths.
280
+ */
281
+ export declare function requireEnv(envName: string, consumerContext: string): string;
77
282
  export declare const PLATFORM_RUNTIME_SENSITIVE_ENV_KEYS: Set<string>;
78
283
  //# sourceMappingURL=platform-runtime-env.contracts.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"platform-runtime-env.contracts.d.ts","sourceRoot":"","sources":["../../../src/bootstrap/platform-runtime-env.contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,oBAAY,qBAAqB;IAC/B,IAAI,SAAS;IACb,IAAI,SAAS;IACb,YAAY,iBAAiB;IAC7B,uBAAuB,4BAA4B;IACnD,eAAe,oBAAoB;IACnC,iBAAiB,sBAAsB;CACxC;AAED,oBAAY,wBAAwB;IAClC,yBAAyB,8BAA8B;IACvD,2BAA2B,gCAAgC;IAC3D,qCAAqC,0CAA0C;CAChF;AAED,oBAAY,4BAA4B;IACtC,iBAAiB,sBAAsB;IACvC,kBAAkB,uBAAuB;IACzC,qBAAqB,0BAA0B;IAC/C,UAAU,eAAe;IACzB,UAAU,eAAe;IACzB,gBAAgB,qBAAqB;IACrC,oBAAoB,yBAAyB;IAC7C,aAAa,kBAAkB;IAC/B,aAAa,kBAAkB;IAC/B,wBAAwB,6BAA6B;IACrD,uBAAuB,4BAA4B;IACnD,uBAAuB,4BAA4B;IACnD,gBAAgB,qBAAqB;IACrC,gBAAgB,qBAAqB;IACrC,YAAY,iBAAiB;IAC7B,eAAe,oBAAoB;IACnC,cAAc,mBAAmB;IACjC,kBAAkB,uBAAuB;IACzC,kBAAkB,uBAAuB;IACzC,aAAa,kBAAkB;IAC/B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,aAAa,kBAAkB;IAC/B,iBAAiB,sBAAsB;IACvC,iBAAiB,sBAAsB;IACvC,WAAW,gBAAgB;CAC5B;AAED,oBAAY,sBAAsB;IAChC,iCAAiC,sCAAsC;IACvE,gCAAgC,qCAAqC;IACrE,mCAAmC,wCAAwC;IAC3E,qBAAqB,0BAA0B;CAChD;AAED,oBAAY,mBAAmB;IAC7B,WAAW,gBAAgB;IAC3B,cAAc,mBAAmB;IACjC,gBAAgB,qBAAqB;IACrC,eAAe,oBAAoB;IACnC,iCAAiC,sCAAsC;IACvE,4BAA4B,iCAAiC;IAC7D,6BAA6B,kCAAkC;IAC/D,8BAA8B,mCAAmC;CAClE;AAED,oBAAY,wBAAwB;IAClC,aAAa,kBAAkB;IAC/B,wBAAwB,6BAA6B;IACrD,kBAAkB,uBAAuB;CAC1C;AAED,eAAO,MAAM,sBAAsB,8BAAwB,CAAC;AAC5D,eAAO,MAAM,yBAAyB,iCAA2B,CAAC;AAClE,eAAO,MAAM,6BAA6B,qCAA+B,CAAC;AAC1E,eAAO,MAAM,uBAAuB,+BAAyB,CAAC;AAC9D,eAAO,MAAM,oBAAoB,4BAAsB,CAAC;AACxD,eAAO,MAAM,yBAAyB,iCAA2B,CAAC;AAElE,eAAO,MAAM,mCAAmC,aAc9C,CAAC"}
1
+ {"version":3,"file":"platform-runtime-env.contracts.d.ts","sourceRoot":"","sources":["../../../../src/bootstrap/platform-runtime-env.contracts.ts"],"names":[],"mappings":"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"}
@@ -18,8 +18,8 @@ export var PlatformProcessEnvKey;
18
18
  export var PlatformServiceUrlEnvKey;
19
19
  (function (PlatformServiceUrlEnvKey) {
20
20
  PlatformServiceUrlEnvKey["PLATFORM_APPS_MANAGER_URL"] = "PLATFORM_APPS_MANAGER_URL";
21
- PlatformServiceUrlEnvKey["PLATFORM_FILE_GENERATOR_URL"] = "PLATFORM_FILE_GENERATOR_URL";
22
21
  PlatformServiceUrlEnvKey["PLATFORM_CRONTABS_BATCHES_MANAGER_URL"] = "PLATFORM_CRONTABS_BATCHES_MANAGER_URL";
22
+ PlatformServiceUrlEnvKey["PLATFORM_MODULE_REGISTRY_URL"] = "PLATFORM_MODULE_REGISTRY_URL";
23
23
  })(PlatformServiceUrlEnvKey || (PlatformServiceUrlEnvKey = {}));
24
24
  export var PlatformInfrastructureEnvKey;
25
25
  (function (PlatformInfrastructureEnvKey) {
@@ -28,14 +28,33 @@ export var PlatformInfrastructureEnvKey;
28
28
  PlatformInfrastructureEnvKey["BASE_MONGO_SERVER_URL"] = "BASE_MONGO_SERVER_URL";
29
29
  PlatformInfrastructureEnvKey["REDIS_HOST"] = "REDIS_HOST";
30
30
  PlatformInfrastructureEnvKey["REDIS_PORT"] = "REDIS_PORT";
31
+ /**
32
+ * Optional Redis logical database index (0–15). Emitted only when the
33
+ * author sets `backingServices.redis.database` in `wildo.infra.<env>.config.ts`.
34
+ * Consumers default to DB 0 when this var is missing.
35
+ */
36
+ PlatformInfrastructureEnvKey["REDIS_DATABASE"] = "REDIS_DATABASE";
31
37
  PlatformInfrastructureEnvKey["REDIS_ADMIN_USER"] = "REDIS_ADMIN_USER";
32
38
  PlatformInfrastructureEnvKey["REDIS_ADMIN_PASSWORD"] = "REDIS_ADMIN_PASSWORD";
33
39
  PlatformInfrastructureEnvKey["RABBITMQ_HOST"] = "RABBITMQ_HOST";
34
40
  PlatformInfrastructureEnvKey["RABBITMQ_PORT"] = "RABBITMQ_PORT";
35
41
  PlatformInfrastructureEnvKey["RABBITMQ_MANAGEMENT_PORT"] = "RABBITMQ_MANAGEMENT_PORT";
42
+ /**
43
+ * Optional RabbitMQ virtual host. Emitted only when the author sets
44
+ * `backingServices.rabbitmq.vhost` in `wildo.infra.<env>.config.ts`.
45
+ * Consumers default to `/` (the RabbitMQ root vhost) when missing.
46
+ */
47
+ PlatformInfrastructureEnvKey["RABBITMQ_VHOST"] = "RABBITMQ_VHOST";
36
48
  PlatformInfrastructureEnvKey["RABBITMQ_ADMIN_USERNAME"] = "RABBITMQ_ADMIN_USERNAME";
37
49
  PlatformInfrastructureEnvKey["RABBITMQ_ADMIN_PASSWORD"] = "RABBITMQ_ADMIN_PASSWORD";
38
50
  PlatformInfrastructureEnvKey["STORAGE_PROVIDER"] = "STORAGE_PROVIDER";
51
+ /**
52
+ * S3-compatible endpoint **hostname** (NOT a URL); see the matching
53
+ * JSDoc on `ApplicationBackendDataEnvKey.STORAGE_ENDPOINT` for the
54
+ * full contract (Slice 3.2 audit L-4). Kept here for the
55
+ * platform-runtime side (apps-manager) — same
56
+ * host:port-only invariant.
57
+ */
39
58
  PlatformInfrastructureEnvKey["STORAGE_ENDPOINT"] = "STORAGE_ENDPOINT";
40
59
  PlatformInfrastructureEnvKey["STORAGE_PORT"] = "STORAGE_PORT";
41
60
  PlatformInfrastructureEnvKey["STORAGE_USE_SSL"] = "STORAGE_USE_SSL";
@@ -47,13 +66,46 @@ export var PlatformInfrastructureEnvKey;
47
66
  PlatformInfrastructureEnvKey["PG_PORT"] = "PG_PORT";
48
67
  PlatformInfrastructureEnvKey["PG_ADMIN_USER"] = "PG_ADMIN_USER";
49
68
  PlatformInfrastructureEnvKey["PG_ADMIN_PASSWORD"] = "PG_ADMIN_PASSWORD";
69
+ /**
70
+ * The MAINTENANCE database the admin pool connects to in order to provision others — NOT the
71
+ * application's database and NOT the container's initdb database (that is
72
+ * `POSTGRES_ADMIN_DATABASE`, a different key on a different transport). Emitted from
73
+ * `PLATFORM_POSTGRES_MAINTENANCE_DATABASE`, whose JSDoc carries the three-way distinction and
74
+ * the silent outage that conflating the first two produced.
75
+ */
50
76
  PlatformInfrastructureEnvKey["PG_ADMIN_DATABASE"] = "PG_ADMIN_DATABASE";
51
77
  PlatformInfrastructureEnvKey["PG_SSL_MODE"] = "PG_SSL_MODE";
78
+ /**
79
+ * The platform's OWN PostgreSQL database — a full connection URL, the exact mirror of
80
+ * `MONGO_CONNECT_URL` for a PostgreSQL-engined platform (D7 of the incremental-migrations plan).
81
+ *
82
+ * Distinct from the `PG_ADMIN_*` family above, which is PROVISIONING material (the admin
83
+ * connection apps-manager uses to create per-application databases/roles). This key is the
84
+ * database apps-manager's own resources live in. One URL rather than an address/credential
85
+ * split on purpose: the platform pre-connects from env BEFORE any config document can be read
86
+ * (the same chicken-and-egg `MONGO_CONNECT_URL` solves — the config documents live in the very
87
+ * database this key addresses), so the whole answer must arrive in one env-delivered value.
88
+ *
89
+ * Emitted by the CLI's platform env builder only when the environment's
90
+ * `database.engine === POSTGRESQL`. Absent on a Mongo-engined platform.
91
+ */
92
+ PlatformInfrastructureEnvKey["PG_CONNECT_URL"] = "PG_CONNECT_URL";
52
93
  })(PlatformInfrastructureEnvKey || (PlatformInfrastructureEnvKey = {}));
53
94
  export var PlatformSecurityEnvKey;
54
95
  (function (PlatformSecurityEnvKey) {
55
96
  PlatformSecurityEnvKey["PLATFORM_APPS_MANAGER_PRIVATE_KEY"] = "PLATFORM_APPS_MANAGER_PRIVATE_KEY";
56
97
  PlatformSecurityEnvKey["PLATFORM_APPS_MANAGER_PUBLIC_KEY"] = "PLATFORM_APPS_MANAGER_PUBLIC_KEY";
98
+ /**
99
+ * The crontabs-batches-manager's dedicated P2P signing keypair. The design is
100
+ * per-service (mirrors apps-manager): the crontabs scheduler signs each SCHEDULED_CRON /
101
+ * MINION_TICK job token with the PRIVATE half, and every app + minion verifies it against
102
+ * the PUBLIC half (distributed to each app's `PLATFORM_CRONTABS_BATCHES_MANAGER` verify
103
+ * slot by apps-manager). These were previously absent from the whole minting/emission
104
+ * chain — so crontabs silently fell back to another key and apps handed out an EMPTY verify
105
+ * key, dead-lettering every scheduled tick. Minted by `buildCredentials`, emitted here.
106
+ */
107
+ PlatformSecurityEnvKey["PLATFORM_CRONTABS_BATCHES_MANAGER_PRIVATE_KEY"] = "PLATFORM_CRONTABS_BATCHES_MANAGER_PRIVATE_KEY";
108
+ PlatformSecurityEnvKey["PLATFORM_CRONTABS_BATCHES_MANAGER_PUBLIC_KEY"] = "PLATFORM_CRONTABS_BATCHES_MANAGER_PUBLIC_KEY";
57
109
  PlatformSecurityEnvKey["PLATFORM_APPLICATION_PRIMARY_SECRET"] = "PLATFORM_APPLICATION_PRIMARY_SECRET";
58
110
  PlatformSecurityEnvKey["PLATFORM_ADMIN_SECRET"] = "PLATFORM_ADMIN_SECRET";
59
111
  })(PlatformSecurityEnvKey || (PlatformSecurityEnvKey = {}));
@@ -66,20 +118,186 @@ export var PlatformAdminEnvKey;
66
118
  PlatformAdminEnvKey["GITHUB_WILDO_APPS_DEFAULT_ORG_URL"] = "GITHUB_WILDO_APPS_DEFAULT_ORG_URL";
67
119
  PlatformAdminEnvKey["GITHUB_WILDO_APPS_ADMIN_USER"] = "GITHUB_WILDO_APPS_ADMIN_USER";
68
120
  PlatformAdminEnvKey["GITHUB_WILDO_APPS_ADMIN_TOKEN"] = "GITHUB_WILDO_APPS_ADMIN_TOKEN";
69
- PlatformAdminEnvKey["GITHUB_WILDO_APPS_ADMIN_SSH_SK"] = "GITHUB_WILDO_APPS_ADMIN_SSH_SK";
70
121
  })(PlatformAdminEnvKey || (PlatformAdminEnvKey = {}));
71
122
  export var PlatformKubernetesEnvKey;
72
123
  (function (PlatformKubernetesEnvKey) {
73
124
  PlatformKubernetesEnvKey["K8S_NAMESPACE"] = "K8S_NAMESPACE";
74
- PlatformKubernetesEnvKey["K8S_EXTERNAL_BASE_DOMAIN"] = "K8S_EXTERNAL_BASE_DOMAIN";
75
- PlatformKubernetesEnvKey["K8S_IMAGE_REGISTRY"] = "K8S_IMAGE_REGISTRY";
76
125
  })(PlatformKubernetesEnvKey || (PlatformKubernetesEnvKey = {}));
126
+ /**
127
+ * Ingress / reverse-proxy env keys.
128
+ *
129
+ * `WILDO_PUBLIC_DOMAIN` is the runtime-agnostic public hostname that
130
+ * apps-manager uses to compose ingress URLs and that backend services
131
+ * use to derive cookie `Domain` and CORS allowlist entries. It applies
132
+ * to BOTH Kubernetes and Docker Compose deployments — naming it
133
+ * `K8S_*` (as in the previous `K8S_EXTERNAL_BASE_DOMAIN`) was a
134
+ * conflation; see `external-public-domain-rename.md`.
135
+ */
136
+ export var PlatformIngressEnvKey;
137
+ (function (PlatformIngressEnvKey) {
138
+ PlatformIngressEnvKey["WILDO_PUBLIC_DOMAIN"] = "WILDO_PUBLIC_DOMAIN";
139
+ /**
140
+ * JSON-serialized `WildoInfraEnvConfig.serviceHosts` map (`<serviceKey> →
141
+ * subdomain chain`, `''` = apex). Projected by `env-vars-builder` so
142
+ * apps-manager can resolve each customer-app service's public host via
143
+ * `buildServicePublicHost` (serviceHosts-driven ingress, no fan-out). Absent
144
+ * / empty ⇒ every key falls back to `<serviceKey>.<publicDomain>`.
145
+ */
146
+ PlatformIngressEnvKey["WILDO_SERVICE_HOSTS"] = "WILDO_SERVICE_HOSTS";
147
+ })(PlatformIngressEnvKey || (PlatformIngressEnvKey = {}));
148
+ /**
149
+ * Logging env-var contract (Slice 3.5).
150
+ *
151
+ * Both keys are projected from `WildoInfraEnvConfig.logging.*` by
152
+ * `env-vars-builder` for every long-running platform/application
153
+ * process, and consumed by `LoggerService.loadConfiguration` in
154
+ * `saas-backend-lib`. Missing values fall back to the LoggerService
155
+ * defaults (level `debug`, pino-pretty auto-detect by environment),
156
+ * matching the optional shape on `WildoLoggingConfigSchema`.
157
+ *
158
+ * `LOG_LEVEL` accepts the lowercase pino levels
159
+ * (`debug | info | warn | error`); the `WildoLoggingConfigSchema` enum
160
+ * is the authoritative validation surface upstream so an invalid
161
+ * value can never reach `process.env`.
162
+ *
163
+ * `LOG_FORMATTED_CONSOLE_ERRORS` is a stringified boolean
164
+ * (`'true' | 'false'`) that overrides the LoggerService's
165
+ * environment-derived pino-pretty / JSON branch. When unset,
166
+ * LoggerService keeps its existing auto-detect behavior (pino-pretty
167
+ * iff `APPLICATION_ENV === 'development'`).
168
+ */
169
+ export var PlatformLoggingEnvKey;
170
+ (function (PlatformLoggingEnvKey) {
171
+ PlatformLoggingEnvKey["LOG_LEVEL"] = "LOG_LEVEL";
172
+ PlatformLoggingEnvKey["LOG_FORMATTED_CONSOLE_ERRORS"] = "LOG_FORMATTED_CONSOLE_ERRORS";
173
+ })(PlatformLoggingEnvKey || (PlatformLoggingEnvKey = {}));
174
+ /**
175
+ * OTLP telemetry env-var contract (Slice 2 Phase 5).
176
+ *
177
+ * Projected from `WildoInfraEnvConfig.observability.*` + the selected
178
+ * `OBSERVABILITY_TELEMETRY` provider by `env-vars-builder`, and read by the
179
+ * `otel-preload.ts` OTel SDK in `saas-backend-lib` BEFORE app code. These are the
180
+ * STANDARD OpenTelemetry env vars — the preload + OTLP exporters consume them
181
+ * directly, so the engine stays provider-agnostic.
182
+ *
183
+ * `OTEL_ENABLED` is the master gate (`'true'`). `OTEL_EXPORTER_OTLP_ENDPOINT` is the
184
+ * OTLP/HTTP collector/ingest URL. `OTEL_EXPORTER_OTLP_HEADERS` carries the provider auth
185
+ * (e.g. `Authorization=Bearer <source-token>`) — SENSITIVE, routed to the K8s Secret.
186
+ * `OTEL_SERVICE_NAME` + `OTEL_RESOURCE_ATTRIBUTES` carry the resource identity
187
+ * (`service.name`, `service.version`, `deployment.environment`).
188
+ */
189
+ export var PlatformObservabilityEnvKey;
190
+ (function (PlatformObservabilityEnvKey) {
191
+ PlatformObservabilityEnvKey["OTEL_ENABLED"] = "OTEL_ENABLED";
192
+ PlatformObservabilityEnvKey["OTEL_EXPORTER_OTLP_ENDPOINT"] = "OTEL_EXPORTER_OTLP_ENDPOINT";
193
+ PlatformObservabilityEnvKey["OTEL_EXPORTER_OTLP_HEADERS"] = "OTEL_EXPORTER_OTLP_HEADERS";
194
+ PlatformObservabilityEnvKey["OTEL_SERVICE_NAME"] = "OTEL_SERVICE_NAME";
195
+ PlatformObservabilityEnvKey["OTEL_RESOURCE_ATTRIBUTES"] = "OTEL_RESOURCE_ATTRIBUTES";
196
+ /**
197
+ * LLM-call observability (a SEPARATE signal from OTLP telemetry — PostHog
198
+ * `$ai_generation` via the engine's `AgentCallTraceSink`): opt-in forwarding
199
+ * of prompt + completion content (`$ai_input` / `$ai_output_choices`). PII
200
+ * shipped to a third party, hence opt-in per environment. Read by the
201
+ * engine's lazy LLM-obs sink resolution, NOT the OTLP preload.
202
+ */
203
+ PlatformObservabilityEnvKey["WILDO_LLM_OBS_CAPTURE_CONTENT"] = "WILDO_LLM_OBS_CAPTURE_CONTENT";
204
+ /** LLM-call observability sampling fraction (0..1); omitted = capture all. */
205
+ PlatformObservabilityEnvKey["WILDO_LLM_OBS_SAMPLE_RATE"] = "WILDO_LLM_OBS_SAMPLE_RATE";
206
+ })(PlatformObservabilityEnvKey || (PlatformObservabilityEnvKey = {}));
207
+ /**
208
+ * Per-environment external-provider SELECTION override env-var contract
209
+ * (2026-07-10).
210
+ *
211
+ * Projected from `WildoInfraEnvConfig.providerSelection` by `env-vars-builder`
212
+ * as a single serialized JSON payload (mirrors how `APPLICATION_RUNTIME_ENDPOINTS`
213
+ * carries a structured payload in one var). Read by
214
+ * `ExternalProvidersRegistryBackendService` at capability-resolution time to
215
+ * override the app-wide `providers.scopes.backend.selection[capability]`
216
+ * primary/fallbacks for THIS environment only. Absent => the SaaS-config
217
+ * selection applies unchanged.
218
+ *
219
+ * Shape: `{ "<EngineCapability>": { "primary": "<ref>", "fallbacks"?: ["<ref>"] } }`.
220
+ */
221
+ export var PlatformProviderSelectionEnvKey;
222
+ (function (PlatformProviderSelectionEnvKey) {
223
+ PlatformProviderSelectionEnvKey["WILDO_PROVIDER_SELECTION_OVERRIDES"] = "WILDO_PROVIDER_SELECTION_OVERRIDES";
224
+ })(PlatformProviderSelectionEnvKey || (PlatformProviderSelectionEnvKey = {}));
225
+ /**
226
+ * Documentation-site BUILD env-var contract.
227
+ *
228
+ * Projected from `WildoInfraEnvConfig.documentationSite` by `env-vars-builder`. Unlike the
229
+ * other families here these are consumed by a BUILD rather than a running service: a
230
+ * Docusaurus bundle compiles its origins in, so the values must be present when the site is
231
+ * built, and a bundle built with the wrong ones silently points every reader at the wrong
232
+ * host instead of failing.
233
+ *
234
+ * The application's `docusaurus.config.ts` refuses to complete a production build when they
235
+ * are unset, and falls back to local defaults otherwise. Before this contract existed the
236
+ * only way to satisfy that guard was to remember three variables on a build command line,
237
+ * so they appeared in no environment definition anywhere.
238
+ *
239
+ * Emitted individually rather than as one serialized payload (the `providerSelection`
240
+ * shape): each is a single scalar read directly by the config, and a JSON blob would force
241
+ * the docs config to parse a payload to recover three strings.
242
+ */
243
+ export var PlatformDocumentationSiteEnvKey;
244
+ (function (PlatformDocumentationSiteEnvKey) {
245
+ PlatformDocumentationSiteEnvKey["WILDO_DOCS_API_BASE_URL"] = "WILDO_DOCS_API_BASE_URL";
246
+ PlatformDocumentationSiteEnvKey["WILDO_DOCS_APP_URL"] = "WILDO_DOCS_APP_URL";
247
+ PlatformDocumentationSiteEnvKey["WILDO_DOCS_FRONTEND_SERVICE_NAME"] = "WILDO_DOCS_FRONTEND_SERVICE_NAME";
248
+ })(PlatformDocumentationSiteEnvKey || (PlatformDocumentationSiteEnvKey = {}));
249
+ export const PlatformDocumentationSiteEnvKeys = PlatformDocumentationSiteEnvKey;
77
250
  export const PlatformProcessEnvKeys = PlatformProcessEnvKey;
78
251
  export const PlatformServiceUrlEnvKeys = PlatformServiceUrlEnvKey;
79
252
  export const PlatformInfrastructureEnvKeys = PlatformInfrastructureEnvKey;
80
253
  export const PlatformSecurityEnvKeys = PlatformSecurityEnvKey;
81
254
  export const PlatformAdminEnvKeys = PlatformAdminEnvKey;
82
255
  export const PlatformKubernetesEnvKeys = PlatformKubernetesEnvKey;
256
+ export const PlatformIngressEnvKeys = PlatformIngressEnvKey;
257
+ export const PlatformLoggingEnvKeys = PlatformLoggingEnvKey;
258
+ export const PlatformObservabilityEnvKeys = PlatformObservabilityEnvKey;
259
+ export const PlatformProviderSelectionEnvKeys = PlatformProviderSelectionEnvKey;
260
+ /**
261
+ * Resolve a required environment variable value or throw a clear,
262
+ * actionable error.
263
+ *
264
+ * This is the canonical fail-closed reader for platform runtime env vars.
265
+ * It exists to replace silent string-fallback patterns like
266
+ * `process.env.X || 'localhost'` / `process.env.Y || 'local'` /
267
+ * `process.env.Z || 'http://localhost:NNNN'` in apps-manager and any
268
+ * other platform service. Those patterns let production processes start
269
+ * silently mis-wired (e.g. talking to `localhost` instead of the real
270
+ * cluster service) and surface as opaque downstream errors much later.
271
+ *
272
+ * Contract:
273
+ * - Empty strings are treated as missing (a `KEY=` line in `.env` is a
274
+ * misconfiguration, not an "intentional empty value").
275
+ * - The thrown error names both the env var and the consuming context
276
+ * (e.g. `"Missing required env var REDIS_HOST (consumer:
277
+ * PlatformInfrastructureManagerService.provisionAllPlatformConfigs)"`).
278
+ * - This helper does NOT decide whether a key is sensitive — that lives
279
+ * in `PLATFORM_RUNTIME_SENSITIVE_ENV_KEYS`. Callers are responsible
280
+ * for not logging the resolved value when sensitive.
281
+ *
282
+ * Usage:
283
+ * const host = requireEnv(
284
+ * PlatformInfrastructureEnvKey.REDIS_HOST,
285
+ * 'PlatformInfrastructureManagerService.provisionAllPlatformConfigs',
286
+ * );
287
+ *
288
+ * Local-development defaults must live in `secrets.json` /
289
+ * `infrastructure/<env>/secrets/` and be loaded into `process.env` by
290
+ * the CLI / K8s wiring, NOT in production code paths.
291
+ */
292
+ export function requireEnv(envName, consumerContext) {
293
+ const raw = process.env[envName];
294
+ if (raw === undefined || raw === '') {
295
+ throw new Error(`Missing required environment variable ${envName} (consumer: ${consumerContext}). ` +
296
+ `Local development defaults belong in secrets.json / infrastructure/<env>/secrets/, ` +
297
+ `not in production code fallbacks.`);
298
+ }
299
+ return raw;
300
+ }
83
301
  export const PLATFORM_RUNTIME_SENSITIVE_ENV_KEYS = new Set([
84
302
  PlatformInfrastructureEnvKey.MONGO_CONNECT_URL,
85
303
  PlatformInfrastructureEnvKey.MONGO_PLATFORM_URL,
@@ -88,11 +306,18 @@ export const PLATFORM_RUNTIME_SENSITIVE_ENV_KEYS = new Set([
88
306
  PlatformInfrastructureEnvKey.STORAGE_ACCESS_KEY,
89
307
  PlatformInfrastructureEnvKey.STORAGE_SECRET_KEY,
90
308
  PlatformInfrastructureEnvKey.PG_ADMIN_PASSWORD,
309
+ PlatformInfrastructureEnvKey.PG_CONNECT_URL,
91
310
  PlatformSecurityEnvKey.PLATFORM_APPS_MANAGER_PRIVATE_KEY,
92
311
  PlatformSecurityEnvKey.PLATFORM_APPS_MANAGER_PUBLIC_KEY,
312
+ PlatformSecurityEnvKey.PLATFORM_CRONTABS_BATCHES_MANAGER_PRIVATE_KEY,
313
+ PlatformSecurityEnvKey.PLATFORM_CRONTABS_BATCHES_MANAGER_PUBLIC_KEY,
93
314
  PlatformSecurityEnvKey.PLATFORM_APPLICATION_PRIMARY_SECRET,
94
315
  PlatformSecurityEnvKey.PLATFORM_ADMIN_SECRET,
95
316
  PlatformAdminEnvKey.ADMIN_PASSWORD,
96
317
  PlatformAdminEnvKey.GITHUB_WILDO_APPS_ADMIN_TOKEN,
318
+ // OTLP auth header carries the provider source token (e.g. a BetterStack Bearer token) →
319
+ // secret (K8s Secret, docker env_file). The sibling OTEL_ENABLED / OTEL_EXPORTER_OTLP_ENDPOINT /
320
+ // OTEL_SERVICE_NAME / OTEL_RESOURCE_ATTRIBUTES are non-secret config and deliberately stay out.
321
+ PlatformObservabilityEnvKey.OTEL_EXPORTER_OTLP_HEADERS,
97
322
  ]);
98
- //# sourceMappingURL=platform-runtime-env.contracts.js.map
323
+ //# sourceMappingURL=platform-runtime-env.contracts.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"platform-runtime-env.contracts.js","sourceRoot":"","sources":["../../../src/bootstrap/platform-runtime-env.contracts.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"platform-runtime-env.contracts.js","sourceRoot":"","sources":["../../../../src/bootstrap/platform-runtime-env.contracts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAN,IAAY,qBAOX;AAPD,WAAY,qBAAqB;IAC/B,sCAAa,CAAA;IACb,sCAAa,CAAA;IACb,sDAA6B,CAAA;IAC7B,4EAAmD,CAAA;IACnD,4DAAmC,CAAA;IACnC,gEAAuC,CAAA;AACzC,CAAC,EAPW,qBAAqB,KAArB,qBAAqB,QAOhC;AAED,MAAM,CAAN,IAAY,wBAIX;AAJD,WAAY,wBAAwB;IAClC,mFAAuD,CAAA;IACvD,2GAA+E,CAAA;IAC/E,yFAA6D,CAAA;AAC/D,CAAC,EAJW,wBAAwB,KAAxB,wBAAwB,QAInC;AAED,MAAM,CAAN,IAAY,4BAoEX;AApED,WAAY,4BAA4B;IACtC,uEAAuC,CAAA;IACvC,yEAAyC,CAAA;IACzC,+EAA+C,CAAA;IAC/C,yDAAyB,CAAA;IACzB,yDAAyB,CAAA;IACzB;;;;OAIG;IACH,iEAAiC,CAAA;IACjC,qEAAqC,CAAA;IACrC,6EAA6C,CAAA;IAC7C,+DAA+B,CAAA;IAC/B,+DAA+B,CAAA;IAC/B,qFAAqD,CAAA;IACrD;;;;OAIG;IACH,iEAAiC,CAAA;IACjC,mFAAmD,CAAA;IACnD,mFAAmD,CAAA;IACnD,qEAAqC,CAAA;IACrC;;;;;;OAMG;IACH,qEAAqC,CAAA;IACrC,6DAA6B,CAAA;IAC7B,mEAAmC,CAAA;IACnC,iEAAiC,CAAA;IACjC,yEAAyC,CAAA;IACzC,yEAAyC,CAAA;IACzC,+DAA+B,CAAA;IAC/B,mDAAmB,CAAA;IACnB,mDAAmB,CAAA;IACnB,+DAA+B,CAAA;IAC/B,uEAAuC,CAAA;IACvC;;;;;;OAMG;IACH,uEAAuC,CAAA;IACvC,2DAA2B,CAAA;IAC3B;;;;;;;;;;;;;OAaG;IACH,iEAAiC,CAAA;AACnC,CAAC,EApEW,4BAA4B,KAA5B,4BAA4B,QAoEvC;AAED,MAAM,CAAN,IAAY,sBAgBX;AAhBD,WAAY,sBAAsB;IAChC,iGAAuE,CAAA;IACvE,+FAAqE,CAAA;IACrE;;;;;;;;OAQG;IACH,yHAA+F,CAAA;IAC/F,uHAA6F,CAAA;IAC7F,qGAA2E,CAAA;IAC3E,yEAA+C,CAAA;AACjD,CAAC,EAhBW,sBAAsB,KAAtB,sBAAsB,QAgBjC;AAED,MAAM,CAAN,IAAY,mBAQX;AARD,WAAY,mBAAmB;IAC7B,kDAA2B,CAAA;IAC3B,wDAAiC,CAAA;IACjC,4DAAqC,CAAA;IACrC,0DAAmC,CAAA;IACnC,8FAAuE,CAAA;IACvE,oFAA6D,CAAA;IAC7D,sFAA+D,CAAA;AACjE,CAAC,EARW,mBAAmB,KAAnB,mBAAmB,QAQ9B;AAED,MAAM,CAAN,IAAY,wBAEX;AAFD,WAAY,wBAAwB;IAClC,2DAA+B,CAAA;AACjC,CAAC,EAFW,wBAAwB,KAAxB,wBAAwB,QAEnC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAN,IAAY,qBAUX;AAVD,WAAY,qBAAqB;IAC/B,oEAA2C,CAAA;IAC3C;;;;;;OAMG;IACH,oEAA2C,CAAA;AAC7C,CAAC,EAVW,qBAAqB,KAArB,qBAAqB,QAUhC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAN,IAAY,qBAGX;AAHD,WAAY,qBAAqB;IAC/B,gDAAuB,CAAA;IACvB,sFAA6D,CAAA;AAC/D,CAAC,EAHW,qBAAqB,KAArB,qBAAqB,QAGhC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAN,IAAY,2BAgBX;AAhBD,WAAY,2BAA2B;IACrC,4DAA6B,CAAA;IAC7B,0FAA2D,CAAA;IAC3D,wFAAyD,CAAA;IACzD,sEAAuC,CAAA;IACvC,oFAAqD,CAAA;IACrD;;;;;;OAMG;IACH,8FAA+D,CAAA;IAC/D,8EAA8E;IAC9E,sFAAuD,CAAA;AACzD,CAAC,EAhBW,2BAA2B,KAA3B,2BAA2B,QAgBtC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAN,IAAY,+BAEX;AAFD,WAAY,+BAA+B;IACzC,4GAAyE,CAAA;AAC3E,CAAC,EAFW,+BAA+B,KAA/B,+BAA+B,QAE1C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAN,IAAY,+BAIX;AAJD,WAAY,+BAA+B;IACzC,sFAAmD,CAAA;IACnD,4EAAyC,CAAA;IACzC,wGAAqE,CAAA;AACvE,CAAC,EAJW,+BAA+B,KAA/B,+BAA+B,QAI1C;AAED,MAAM,CAAC,MAAM,gCAAgC,GAAG,+BAA+B,CAAC;AAChF,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAC5D,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAClE,MAAM,CAAC,MAAM,6BAA6B,GAAG,4BAA4B,CAAC;AAC1E,MAAM,CAAC,MAAM,uBAAuB,GAAG,sBAAsB,CAAC;AAC9D,MAAM,CAAC,MAAM,oBAAoB,GAAG,mBAAmB,CAAC;AACxD,MAAM,CAAC,MAAM,yBAAyB,GAAG,wBAAwB,CAAC;AAClE,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAC;AAC5D,MAAM,CAAC,MAAM,4BAA4B,GAAG,2BAA2B,CAAC;AACxE,MAAM,CAAC,MAAM,gCAAgC,GAAG,+BAA+B,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,eAAuB;IACjE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACjC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,yCAAyC,OAAO,eAAe,eAAe,KAAK;YACnF,qFAAqF;YACrF,mCAAmC,CACpC,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,mCAAmC,GAAG,IAAI,GAAG,CAAS;IACjE,4BAA4B,CAAC,iBAAiB;IAC9C,4BAA4B,CAAC,kBAAkB;IAC/C,4BAA4B,CAAC,oBAAoB;IACjD,4BAA4B,CAAC,uBAAuB;IACpD,4BAA4B,CAAC,kBAAkB;IAC/C,4BAA4B,CAAC,kBAAkB;IAC/C,4BAA4B,CAAC,iBAAiB;IAC9C,4BAA4B,CAAC,cAAc;IAC3C,sBAAsB,CAAC,iCAAiC;IACxD,sBAAsB,CAAC,gCAAgC;IACvD,sBAAsB,CAAC,6CAA6C;IACpE,sBAAsB,CAAC,4CAA4C;IACnE,sBAAsB,CAAC,mCAAmC;IAC1D,sBAAsB,CAAC,qBAAqB;IAC5C,mBAAmB,CAAC,cAAc;IAClC,mBAAmB,CAAC,6BAA6B;IACjD,yFAAyF;IACzF,iGAAiG;IACjG,gGAAgG;IAChG,2BAA2B,CAAC,0BAA0B;CACvD,CAAC,CAAC","sourcesContent":["/**\n * Shared environment contract for platform runtime processes.\n *\n * This captures the canonical env-var vocabulary used by CLI-generated platform\n * `.env` material and by platform services such as apps-manager at runtime.\n * Keep these keys declarative and cross-executor: the contract owns names and\n * sensitivity classification, while writers/readers own behavior.\n */\n\nexport enum PlatformProcessEnvKey {\n HOST = 'HOST',\n PORT = 'PORT',\n SERVICE_NAME = 'SERVICE_NAME',\n PLATFORM_ENVIRONMENT_ID = 'PLATFORM_ENVIRONMENT_ID',\n APPLICATION_ENV = 'APPLICATION_ENV',\n APPS_MANAGER_MODE = 'APPS_MANAGER_MODE',\n}\n\nexport enum PlatformServiceUrlEnvKey {\n PLATFORM_APPS_MANAGER_URL = 'PLATFORM_APPS_MANAGER_URL',\n PLATFORM_CRONTABS_BATCHES_MANAGER_URL = 'PLATFORM_CRONTABS_BATCHES_MANAGER_URL',\n PLATFORM_MODULE_REGISTRY_URL = 'PLATFORM_MODULE_REGISTRY_URL',\n}\n\nexport enum PlatformInfrastructureEnvKey {\n MONGO_CONNECT_URL = 'MONGO_CONNECT_URL',\n MONGO_PLATFORM_URL = 'MONGO_PLATFORM_URL',\n BASE_MONGO_SERVER_URL = 'BASE_MONGO_SERVER_URL',\n REDIS_HOST = 'REDIS_HOST',\n REDIS_PORT = 'REDIS_PORT',\n /**\n * Optional Redis logical database index (0–15). Emitted only when the\n * author sets `backingServices.redis.database` in `wildo.infra.<env>.config.ts`.\n * Consumers default to DB 0 when this var is missing.\n */\n REDIS_DATABASE = 'REDIS_DATABASE',\n REDIS_ADMIN_USER = 'REDIS_ADMIN_USER',\n REDIS_ADMIN_PASSWORD = 'REDIS_ADMIN_PASSWORD',\n RABBITMQ_HOST = 'RABBITMQ_HOST',\n RABBITMQ_PORT = 'RABBITMQ_PORT',\n RABBITMQ_MANAGEMENT_PORT = 'RABBITMQ_MANAGEMENT_PORT',\n /**\n * Optional RabbitMQ virtual host. Emitted only when the author sets\n * `backingServices.rabbitmq.vhost` in `wildo.infra.<env>.config.ts`.\n * Consumers default to `/` (the RabbitMQ root vhost) when missing.\n */\n RABBITMQ_VHOST = 'RABBITMQ_VHOST',\n RABBITMQ_ADMIN_USERNAME = 'RABBITMQ_ADMIN_USERNAME',\n RABBITMQ_ADMIN_PASSWORD = 'RABBITMQ_ADMIN_PASSWORD',\n STORAGE_PROVIDER = 'STORAGE_PROVIDER',\n /**\n * S3-compatible endpoint **hostname** (NOT a URL); see the matching\n * JSDoc on `ApplicationBackendDataEnvKey.STORAGE_ENDPOINT` for the\n * full contract (Slice 3.2 audit L-4). Kept here for the\n * platform-runtime side (apps-manager) — same\n * host:port-only invariant.\n */\n STORAGE_ENDPOINT = 'STORAGE_ENDPOINT',\n STORAGE_PORT = 'STORAGE_PORT',\n STORAGE_USE_SSL = 'STORAGE_USE_SSL',\n STORAGE_BUCKET = 'STORAGE_BUCKET',\n STORAGE_ACCESS_KEY = 'STORAGE_ACCESS_KEY',\n STORAGE_SECRET_KEY = 'STORAGE_SECRET_KEY',\n GOTENBERG_URL = 'GOTENBERG_URL',\n PG_HOST = 'PG_HOST',\n PG_PORT = 'PG_PORT',\n PG_ADMIN_USER = 'PG_ADMIN_USER',\n PG_ADMIN_PASSWORD = 'PG_ADMIN_PASSWORD',\n /**\n * The MAINTENANCE database the admin pool connects to in order to provision others — NOT the\n * application's database and NOT the container's initdb database (that is\n * `POSTGRES_ADMIN_DATABASE`, a different key on a different transport). Emitted from\n * `PLATFORM_POSTGRES_MAINTENANCE_DATABASE`, whose JSDoc carries the three-way distinction and\n * the silent outage that conflating the first two produced.\n */\n PG_ADMIN_DATABASE = 'PG_ADMIN_DATABASE',\n PG_SSL_MODE = 'PG_SSL_MODE',\n /**\n * The platform's OWN PostgreSQL database — a full connection URL, the exact mirror of\n * `MONGO_CONNECT_URL` for a PostgreSQL-engined platform (D7 of the incremental-migrations plan).\n *\n * Distinct from the `PG_ADMIN_*` family above, which is PROVISIONING material (the admin\n * connection apps-manager uses to create per-application databases/roles). This key is the\n * database apps-manager's own resources live in. One URL rather than an address/credential\n * split on purpose: the platform pre-connects from env BEFORE any config document can be read\n * (the same chicken-and-egg `MONGO_CONNECT_URL` solves — the config documents live in the very\n * database this key addresses), so the whole answer must arrive in one env-delivered value.\n *\n * Emitted by the CLI's platform env builder only when the environment's\n * `database.engine === POSTGRESQL`. Absent on a Mongo-engined platform.\n */\n PG_CONNECT_URL = 'PG_CONNECT_URL',\n}\n\nexport enum PlatformSecurityEnvKey {\n PLATFORM_APPS_MANAGER_PRIVATE_KEY = 'PLATFORM_APPS_MANAGER_PRIVATE_KEY',\n PLATFORM_APPS_MANAGER_PUBLIC_KEY = 'PLATFORM_APPS_MANAGER_PUBLIC_KEY',\n /**\n * The crontabs-batches-manager's dedicated P2P signing keypair. The design is\n * per-service (mirrors apps-manager): the crontabs scheduler signs each SCHEDULED_CRON /\n * MINION_TICK job token with the PRIVATE half, and every app + minion verifies it against\n * the PUBLIC half (distributed to each app's `PLATFORM_CRONTABS_BATCHES_MANAGER` verify\n * slot by apps-manager). These were previously absent from the whole minting/emission\n * chain — so crontabs silently fell back to another key and apps handed out an EMPTY verify\n * key, dead-lettering every scheduled tick. Minted by `buildCredentials`, emitted here.\n */\n PLATFORM_CRONTABS_BATCHES_MANAGER_PRIVATE_KEY = 'PLATFORM_CRONTABS_BATCHES_MANAGER_PRIVATE_KEY',\n PLATFORM_CRONTABS_BATCHES_MANAGER_PUBLIC_KEY = 'PLATFORM_CRONTABS_BATCHES_MANAGER_PUBLIC_KEY',\n PLATFORM_APPLICATION_PRIMARY_SECRET = 'PLATFORM_APPLICATION_PRIMARY_SECRET',\n PLATFORM_ADMIN_SECRET = 'PLATFORM_ADMIN_SECRET',\n}\n\nexport enum PlatformAdminEnvKey {\n ADMIN_EMAIL = 'ADMIN_EMAIL',\n ADMIN_PASSWORD = 'ADMIN_PASSWORD',\n ADMIN_FIRST_NAME = 'ADMIN_FIRST_NAME',\n ADMIN_LAST_NAME = 'ADMIN_LAST_NAME',\n GITHUB_WILDO_APPS_DEFAULT_ORG_URL = 'GITHUB_WILDO_APPS_DEFAULT_ORG_URL',\n GITHUB_WILDO_APPS_ADMIN_USER = 'GITHUB_WILDO_APPS_ADMIN_USER',\n GITHUB_WILDO_APPS_ADMIN_TOKEN = 'GITHUB_WILDO_APPS_ADMIN_TOKEN',\n}\n\nexport enum PlatformKubernetesEnvKey {\n K8S_NAMESPACE = 'K8S_NAMESPACE',\n}\n\n/**\n * Ingress / reverse-proxy env keys.\n *\n * `WILDO_PUBLIC_DOMAIN` is the runtime-agnostic public hostname that\n * apps-manager uses to compose ingress URLs and that backend services\n * use to derive cookie `Domain` and CORS allowlist entries. It applies\n * to BOTH Kubernetes and Docker Compose deployments — naming it\n * `K8S_*` (as in the previous `K8S_EXTERNAL_BASE_DOMAIN`) was a\n * conflation; see `external-public-domain-rename.md`.\n */\nexport enum PlatformIngressEnvKey {\n WILDO_PUBLIC_DOMAIN = 'WILDO_PUBLIC_DOMAIN',\n /**\n * JSON-serialized `WildoInfraEnvConfig.serviceHosts` map (`<serviceKey> →\n * subdomain chain`, `''` = apex). Projected by `env-vars-builder` so\n * apps-manager can resolve each customer-app service's public host via\n * `buildServicePublicHost` (serviceHosts-driven ingress, no fan-out). Absent\n * / empty ⇒ every key falls back to `<serviceKey>.<publicDomain>`.\n */\n WILDO_SERVICE_HOSTS = 'WILDO_SERVICE_HOSTS',\n}\n\n/**\n * Logging env-var contract (Slice 3.5).\n *\n * Both keys are projected from `WildoInfraEnvConfig.logging.*` by\n * `env-vars-builder` for every long-running platform/application\n * process, and consumed by `LoggerService.loadConfiguration` in\n * `saas-backend-lib`. Missing values fall back to the LoggerService\n * defaults (level `debug`, pino-pretty auto-detect by environment),\n * matching the optional shape on `WildoLoggingConfigSchema`.\n *\n * `LOG_LEVEL` accepts the lowercase pino levels\n * (`debug | info | warn | error`); the `WildoLoggingConfigSchema` enum\n * is the authoritative validation surface upstream so an invalid\n * value can never reach `process.env`.\n *\n * `LOG_FORMATTED_CONSOLE_ERRORS` is a stringified boolean\n * (`'true' | 'false'`) that overrides the LoggerService's\n * environment-derived pino-pretty / JSON branch. When unset,\n * LoggerService keeps its existing auto-detect behavior (pino-pretty\n * iff `APPLICATION_ENV === 'development'`).\n */\nexport enum PlatformLoggingEnvKey {\n LOG_LEVEL = 'LOG_LEVEL',\n LOG_FORMATTED_CONSOLE_ERRORS = 'LOG_FORMATTED_CONSOLE_ERRORS',\n}\n\n/**\n * OTLP telemetry env-var contract (Slice 2 Phase 5).\n *\n * Projected from `WildoInfraEnvConfig.observability.*` + the selected\n * `OBSERVABILITY_TELEMETRY` provider by `env-vars-builder`, and read by the\n * `otel-preload.ts` OTel SDK in `saas-backend-lib` BEFORE app code. These are the\n * STANDARD OpenTelemetry env vars — the preload + OTLP exporters consume them\n * directly, so the engine stays provider-agnostic.\n *\n * `OTEL_ENABLED` is the master gate (`'true'`). `OTEL_EXPORTER_OTLP_ENDPOINT` is the\n * OTLP/HTTP collector/ingest URL. `OTEL_EXPORTER_OTLP_HEADERS` carries the provider auth\n * (e.g. `Authorization=Bearer <source-token>`) — SENSITIVE, routed to the K8s Secret.\n * `OTEL_SERVICE_NAME` + `OTEL_RESOURCE_ATTRIBUTES` carry the resource identity\n * (`service.name`, `service.version`, `deployment.environment`).\n */\nexport enum PlatformObservabilityEnvKey {\n OTEL_ENABLED = 'OTEL_ENABLED',\n OTEL_EXPORTER_OTLP_ENDPOINT = 'OTEL_EXPORTER_OTLP_ENDPOINT',\n OTEL_EXPORTER_OTLP_HEADERS = 'OTEL_EXPORTER_OTLP_HEADERS',\n OTEL_SERVICE_NAME = 'OTEL_SERVICE_NAME',\n OTEL_RESOURCE_ATTRIBUTES = 'OTEL_RESOURCE_ATTRIBUTES',\n /**\n * LLM-call observability (a SEPARATE signal from OTLP telemetry — PostHog\n * `$ai_generation` via the engine's `AgentCallTraceSink`): opt-in forwarding\n * of prompt + completion content (`$ai_input` / `$ai_output_choices`). PII\n * shipped to a third party, hence opt-in per environment. Read by the\n * engine's lazy LLM-obs sink resolution, NOT the OTLP preload.\n */\n WILDO_LLM_OBS_CAPTURE_CONTENT = 'WILDO_LLM_OBS_CAPTURE_CONTENT',\n /** LLM-call observability sampling fraction (0..1); omitted = capture all. */\n WILDO_LLM_OBS_SAMPLE_RATE = 'WILDO_LLM_OBS_SAMPLE_RATE',\n}\n\n/**\n * Per-environment external-provider SELECTION override env-var contract\n * (2026-07-10).\n *\n * Projected from `WildoInfraEnvConfig.providerSelection` by `env-vars-builder`\n * as a single serialized JSON payload (mirrors how `APPLICATION_RUNTIME_ENDPOINTS`\n * carries a structured payload in one var). Read by\n * `ExternalProvidersRegistryBackendService` at capability-resolution time to\n * override the app-wide `providers.scopes.backend.selection[capability]`\n * primary/fallbacks for THIS environment only. Absent => the SaaS-config\n * selection applies unchanged.\n *\n * Shape: `{ \"<EngineCapability>\": { \"primary\": \"<ref>\", \"fallbacks\"?: [\"<ref>\"] } }`.\n */\nexport enum PlatformProviderSelectionEnvKey {\n WILDO_PROVIDER_SELECTION_OVERRIDES = 'WILDO_PROVIDER_SELECTION_OVERRIDES',\n}\n\n/**\n * Documentation-site BUILD env-var contract.\n *\n * Projected from `WildoInfraEnvConfig.documentationSite` by `env-vars-builder`. Unlike the\n * other families here these are consumed by a BUILD rather than a running service: a\n * Docusaurus bundle compiles its origins in, so the values must be present when the site is\n * built, and a bundle built with the wrong ones silently points every reader at the wrong\n * host instead of failing.\n *\n * The application's `docusaurus.config.ts` refuses to complete a production build when they\n * are unset, and falls back to local defaults otherwise. Before this contract existed the\n * only way to satisfy that guard was to remember three variables on a build command line,\n * so they appeared in no environment definition anywhere.\n *\n * Emitted individually rather than as one serialized payload (the `providerSelection`\n * shape): each is a single scalar read directly by the config, and a JSON blob would force\n * the docs config to parse a payload to recover three strings.\n */\nexport enum PlatformDocumentationSiteEnvKey {\n WILDO_DOCS_API_BASE_URL = 'WILDO_DOCS_API_BASE_URL',\n WILDO_DOCS_APP_URL = 'WILDO_DOCS_APP_URL',\n WILDO_DOCS_FRONTEND_SERVICE_NAME = 'WILDO_DOCS_FRONTEND_SERVICE_NAME',\n}\n\nexport const PlatformDocumentationSiteEnvKeys = PlatformDocumentationSiteEnvKey;\nexport const PlatformProcessEnvKeys = PlatformProcessEnvKey;\nexport const PlatformServiceUrlEnvKeys = PlatformServiceUrlEnvKey;\nexport const PlatformInfrastructureEnvKeys = PlatformInfrastructureEnvKey;\nexport const PlatformSecurityEnvKeys = PlatformSecurityEnvKey;\nexport const PlatformAdminEnvKeys = PlatformAdminEnvKey;\nexport const PlatformKubernetesEnvKeys = PlatformKubernetesEnvKey;\nexport const PlatformIngressEnvKeys = PlatformIngressEnvKey;\nexport const PlatformLoggingEnvKeys = PlatformLoggingEnvKey;\nexport const PlatformObservabilityEnvKeys = PlatformObservabilityEnvKey;\nexport const PlatformProviderSelectionEnvKeys = PlatformProviderSelectionEnvKey;\n\n/**\n * Resolve a required environment variable value or throw a clear,\n * actionable error.\n *\n * This is the canonical fail-closed reader for platform runtime env vars.\n * It exists to replace silent string-fallback patterns like\n * `process.env.X || 'localhost'` / `process.env.Y || 'local'` /\n * `process.env.Z || 'http://localhost:NNNN'` in apps-manager and any\n * other platform service. Those patterns let production processes start\n * silently mis-wired (e.g. talking to `localhost` instead of the real\n * cluster service) and surface as opaque downstream errors much later.\n *\n * Contract:\n * - Empty strings are treated as missing (a `KEY=` line in `.env` is a\n * misconfiguration, not an \"intentional empty value\").\n * - The thrown error names both the env var and the consuming context\n * (e.g. `\"Missing required env var REDIS_HOST (consumer:\n * PlatformInfrastructureManagerService.provisionAllPlatformConfigs)\"`).\n * - This helper does NOT decide whether a key is sensitive — that lives\n * in `PLATFORM_RUNTIME_SENSITIVE_ENV_KEYS`. Callers are responsible\n * for not logging the resolved value when sensitive.\n *\n * Usage:\n * const host = requireEnv(\n * PlatformInfrastructureEnvKey.REDIS_HOST,\n * 'PlatformInfrastructureManagerService.provisionAllPlatformConfigs',\n * );\n *\n * Local-development defaults must live in `secrets.json` /\n * `infrastructure/<env>/secrets/` and be loaded into `process.env` by\n * the CLI / K8s wiring, NOT in production code paths.\n */\nexport function requireEnv(envName: string, consumerContext: string): string {\n const raw = process.env[envName];\n if (raw === undefined || raw === '') {\n throw new Error(\n `Missing required environment variable ${envName} (consumer: ${consumerContext}). ` +\n `Local development defaults belong in secrets.json / infrastructure/<env>/secrets/, ` +\n `not in production code fallbacks.`,\n );\n }\n return raw;\n}\n\nexport const PLATFORM_RUNTIME_SENSITIVE_ENV_KEYS = new Set<string>([\n PlatformInfrastructureEnvKey.MONGO_CONNECT_URL,\n PlatformInfrastructureEnvKey.MONGO_PLATFORM_URL,\n PlatformInfrastructureEnvKey.REDIS_ADMIN_PASSWORD,\n PlatformInfrastructureEnvKey.RABBITMQ_ADMIN_PASSWORD,\n PlatformInfrastructureEnvKey.STORAGE_ACCESS_KEY,\n PlatformInfrastructureEnvKey.STORAGE_SECRET_KEY,\n PlatformInfrastructureEnvKey.PG_ADMIN_PASSWORD,\n PlatformInfrastructureEnvKey.PG_CONNECT_URL,\n PlatformSecurityEnvKey.PLATFORM_APPS_MANAGER_PRIVATE_KEY,\n PlatformSecurityEnvKey.PLATFORM_APPS_MANAGER_PUBLIC_KEY,\n PlatformSecurityEnvKey.PLATFORM_CRONTABS_BATCHES_MANAGER_PRIVATE_KEY,\n PlatformSecurityEnvKey.PLATFORM_CRONTABS_BATCHES_MANAGER_PUBLIC_KEY,\n PlatformSecurityEnvKey.PLATFORM_APPLICATION_PRIMARY_SECRET,\n PlatformSecurityEnvKey.PLATFORM_ADMIN_SECRET,\n PlatformAdminEnvKey.ADMIN_PASSWORD,\n PlatformAdminEnvKey.GITHUB_WILDO_APPS_ADMIN_TOKEN,\n // OTLP auth header carries the provider source token (e.g. a BetterStack Bearer token) →\n // secret (K8s Secret, docker env_file). The sibling OTEL_ENABLED / OTEL_EXPORTER_OTLP_ENDPOINT /\n // OTEL_SERVICE_NAME / OTEL_RESOURCE_ATTRIBUTES are non-secret config and deliberately stay out.\n PlatformObservabilityEnvKey.OTEL_EXPORTER_OTLP_HEADERS,\n]);\n"]}