@wildo-ai/platform-config-lib 1.1.4 → 1.1.5

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 (167) hide show
  1. package/dist/esm/bootstrap/application-backend-env.contracts.d.ts.map +1 -1
  2. package/dist/esm/bootstrap/bootstrap-planner.d.ts.map +1 -1
  3. package/dist/esm/bootstrap/bootstrap.contracts.d.ts +23 -1
  4. package/dist/esm/bootstrap/bootstrap.contracts.d.ts.map +1 -1
  5. package/dist/esm/bootstrap/bootstrap.contracts.js +24 -0
  6. package/dist/esm/bootstrap/bootstrap.contracts.js.map +1 -1
  7. package/dist/esm/bootstrap/bootstrap.schemas.d.ts +70 -1
  8. package/dist/esm/bootstrap/bootstrap.schemas.d.ts.map +1 -1
  9. package/dist/esm/bootstrap/bootstrap.schemas.js +55 -4
  10. package/dist/esm/bootstrap/bootstrap.schemas.js.map +1 -1
  11. package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts +12 -0
  12. package/dist/esm/bootstrap/platform-runtime-env.contracts.d.ts.map +1 -1
  13. package/dist/esm/bootstrap/platform-runtime-env.contracts.js +12 -0
  14. package/dist/esm/bootstrap/platform-runtime-env.contracts.js.map +1 -1
  15. package/dist/esm/bootstrap/runtime-backing-service-access.d.ts.map +1 -1
  16. package/dist/esm/bootstrap/runtime-network-policy.d.ts.map +1 -1
  17. package/dist/esm/bootstrap/runtime-network-topology.d.ts.map +1 -1
  18. package/dist/esm/bootstrap/runtime-network-topology.js.map +1 -1
  19. package/dist/esm/bootstrap/runtime-platform-access.d.ts.map +1 -1
  20. package/dist/esm/bootstrap/runtime-principal.contracts.d.ts.map +1 -1
  21. package/dist/esm/bootstrap/runtime-topology.contracts.d.ts.map +1 -1
  22. package/dist/esm/bootstrap/wildo-owner-organization.contracts.d.ts +29 -0
  23. package/dist/esm/bootstrap/wildo-owner-organization.contracts.d.ts.map +1 -1
  24. package/dist/esm/bootstrap/wildo-owner-organization.contracts.js +39 -0
  25. package/dist/esm/bootstrap/wildo-owner-organization.contracts.js.map +1 -1
  26. package/dist/esm/config-authoring.entry.d.ts.map +1 -1
  27. package/dist/esm/config-authoring.entry.js.map +1 -1
  28. package/dist/esm/index.d.ts +1 -0
  29. package/dist/esm/index.d.ts.map +1 -1
  30. package/dist/esm/index.js +1 -0
  31. package/dist/esm/index.js.map +1 -1
  32. package/dist/esm/lockfile/build-parallelism.d.ts +40 -0
  33. package/dist/esm/lockfile/build-parallelism.d.ts.map +1 -0
  34. package/dist/esm/lockfile/build-parallelism.js +64 -0
  35. package/dist/esm/lockfile/build-parallelism.js.map +1 -0
  36. package/dist/esm/lockfile/lockfile-io.d.ts.map +1 -1
  37. package/dist/esm/lockfile/materialize-infra-section.d.ts +1 -1
  38. package/dist/esm/lockfile/materialize-infra-section.d.ts.map +1 -1
  39. package/dist/esm/lockfile/materialize-infra-section.js +1 -1
  40. package/dist/esm/lockfile/materialize-infra-section.js.map +1 -1
  41. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.d.ts.map +1 -1
  42. package/dist/esm/lockfile/wildo-saas-lock.shared.schemas.js.map +1 -1
  43. package/dist/esm/project-config/define-framework-config.d.ts.map +1 -1
  44. package/dist/esm/project-config/define-infra-env-config.d.ts +899 -15
  45. package/dist/esm/project-config/define-infra-env-config.d.ts.map +1 -1
  46. package/dist/esm/project-config/define-infra-env-config.js +397 -16
  47. package/dist/esm/project-config/define-infra-env-config.js.map +1 -1
  48. package/dist/esm/project-config/define-minion-config.d.ts.map +1 -1
  49. package/dist/esm/project-config/define-minion-config.js +1 -2
  50. package/dist/esm/project-config/define-minion-config.js.map +1 -1
  51. package/dist/esm/project-config/define-saas-config.d.ts +90 -25
  52. package/dist/esm/project-config/define-saas-config.d.ts.map +1 -1
  53. package/dist/esm/project-config/define-saas-config.js +165 -12
  54. package/dist/esm/project-config/define-saas-config.js.map +1 -1
  55. package/dist/esm/project-config/define-worker-config.d.ts.map +1 -1
  56. package/dist/esm/project-config/hosted-infra-env-config.d.ts +59 -0
  57. package/dist/esm/project-config/hosted-infra-env-config.d.ts.map +1 -0
  58. package/dist/esm/project-config/hosted-infra-env-config.js +187 -0
  59. package/dist/esm/project-config/hosted-infra-env-config.js.map +1 -0
  60. package/dist/esm/project-config/index.d.ts +3 -0
  61. package/dist/esm/project-config/index.d.ts.map +1 -1
  62. package/dist/esm/project-config/index.js +3 -0
  63. package/dist/esm/project-config/index.js.map +1 -1
  64. package/dist/esm/project-config/loader.d.ts +24 -0
  65. package/dist/esm/project-config/loader.d.ts.map +1 -1
  66. package/dist/esm/project-config/loader.js +114 -1
  67. package/dist/esm/project-config/loader.js.map +1 -1
  68. package/dist/esm/project-config/provider-catalog-types.d.ts.map +1 -1
  69. package/dist/esm/project-config/provider-companion-discovery.d.ts +32 -0
  70. package/dist/esm/project-config/provider-companion-discovery.d.ts.map +1 -1
  71. package/dist/esm/project-config/provider-companion-discovery.js +82 -12
  72. package/dist/esm/project-config/provider-companion-discovery.js.map +1 -1
  73. package/dist/esm/project-config/provider-runtime-artifacts.d.ts +71 -22
  74. package/dist/esm/project-config/provider-runtime-artifacts.d.ts.map +1 -1
  75. package/dist/esm/project-config/provider-runtime-artifacts.js +135 -13
  76. package/dist/esm/project-config/provider-runtime-artifacts.js.map +1 -1
  77. package/dist/esm/project-config/shared/application-creation-verification.schemas.d.ts.map +1 -1
  78. package/dist/esm/project-config/shared/application-modules.schemas.d.ts.map +1 -1
  79. package/dist/esm/project-config/shared/application-modules.utils.d.ts.map +1 -1
  80. package/dist/esm/project-config/shared/auth.schemas.d.ts +14 -35
  81. package/dist/esm/project-config/shared/auth.schemas.d.ts.map +1 -1
  82. package/dist/esm/project-config/shared/auth.schemas.js +14 -35
  83. package/dist/esm/project-config/shared/auth.schemas.js.map +1 -1
  84. package/dist/esm/project-config/shared/backing-services.schemas.d.ts +17 -12
  85. package/dist/esm/project-config/shared/backing-services.schemas.d.ts.map +1 -1
  86. package/dist/esm/project-config/shared/backing-services.schemas.js +17 -12
  87. package/dist/esm/project-config/shared/backing-services.schemas.js.map +1 -1
  88. package/dist/esm/project-config/shared/cdn.example.d.ts.map +1 -1
  89. package/dist/esm/project-config/shared/cdn.schemas.d.ts.map +1 -1
  90. package/dist/esm/project-config/shared/csp-defaults.d.ts.map +1 -1
  91. package/dist/esm/project-config/shared/csp-emit.d.ts.map +1 -1
  92. package/dist/esm/project-config/shared/csp-emit.js.map +1 -1
  93. package/dist/esm/project-config/shared/csp.schemas.d.ts +11 -12
  94. package/dist/esm/project-config/shared/csp.schemas.d.ts.map +1 -1
  95. package/dist/esm/project-config/shared/csp.schemas.js +11 -12
  96. package/dist/esm/project-config/shared/csp.schemas.js.map +1 -1
  97. package/dist/esm/project-config/shared/data-services.schemas.d.ts.map +1 -1
  98. package/dist/esm/project-config/shared/env-example-defaults.d.ts.map +1 -1
  99. package/dist/esm/project-config/shared/environment.schemas.d.ts +152 -12
  100. package/dist/esm/project-config/shared/environment.schemas.d.ts.map +1 -1
  101. package/dist/esm/project-config/shared/environment.schemas.js +186 -9
  102. package/dist/esm/project-config/shared/environment.schemas.js.map +1 -1
  103. package/dist/esm/project-config/shared/infra-providers.schemas.d.ts +5 -6
  104. package/dist/esm/project-config/shared/infra-providers.schemas.d.ts.map +1 -1
  105. package/dist/esm/project-config/shared/infra-providers.schemas.js +0 -3
  106. package/dist/esm/project-config/shared/infra-providers.schemas.js.map +1 -1
  107. package/dist/esm/project-config/shared/infra-service.schemas.d.ts.map +1 -1
  108. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.d.ts.map +1 -1
  109. package/dist/esm/project-config/shared/infrastructure-defaults.schemas.js.map +1 -1
  110. package/dist/esm/project-config/shared/k8s-utils.d.ts.map +1 -1
  111. package/dist/esm/project-config/shared/k8s-utils.js.map +1 -1
  112. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.d.ts.map +1 -1
  113. package/dist/esm/project-config/shared/minion-platform-access.vocabulary.js.map +1 -1
  114. package/dist/esm/project-config/shared/minion-resource-access.validation.d.ts +77 -47
  115. package/dist/esm/project-config/shared/minion-resource-access.validation.d.ts.map +1 -1
  116. package/dist/esm/project-config/shared/minion-resource-access.validation.js +114 -52
  117. package/dist/esm/project-config/shared/minion-resource-access.validation.js.map +1 -1
  118. package/dist/esm/project-config/shared/platform-services.schemas.d.ts +50 -0
  119. package/dist/esm/project-config/shared/platform-services.schemas.d.ts.map +1 -1
  120. package/dist/esm/project-config/shared/platform-services.schemas.js +57 -0
  121. package/dist/esm/project-config/shared/platform-services.schemas.js.map +1 -1
  122. package/dist/esm/project-config/shared/platform-storage.schemas.d.ts +35 -0
  123. package/dist/esm/project-config/shared/platform-storage.schemas.d.ts.map +1 -0
  124. package/dist/esm/project-config/shared/platform-storage.schemas.js +37 -0
  125. package/dist/esm/project-config/shared/platform-storage.schemas.js.map +1 -0
  126. package/dist/esm/project-config/shared/schema-version.schemas.d.ts.map +1 -1
  127. package/dist/esm/project-config/shared/service-definitions.schemas.d.ts.map +1 -1
  128. package/dist/esm/project-config/shared/systems-of-record-env.schemas.d.ts +81 -0
  129. package/dist/esm/project-config/shared/systems-of-record-env.schemas.d.ts.map +1 -0
  130. package/dist/esm/project-config/shared/systems-of-record-env.schemas.js +74 -0
  131. package/dist/esm/project-config/shared/systems-of-record-env.schemas.js.map +1 -0
  132. package/dist/esm/registry/artifact-domain.schemas.d.ts +1 -1
  133. package/dist/esm/registry/artifact-domain.schemas.d.ts.map +1 -1
  134. package/dist/esm/registry/companion-api.schemas.d.ts.map +1 -1
  135. package/dist/esm/registry/digest.schemas.d.ts.map +1 -1
  136. package/dist/esm/registry/index.d.ts.map +1 -1
  137. package/dist/esm/registry/lockfile-modules-section.schemas.d.ts.map +1 -1
  138. package/dist/esm/registry/module-artifact.schemas.d.ts.map +1 -1
  139. package/dist/esm/registry/module-manifest.schemas.d.ts +10 -16
  140. package/dist/esm/registry/module-manifest.schemas.d.ts.map +1 -1
  141. package/dist/esm/registry/module-manifest.schemas.js +14 -20
  142. package/dist/esm/registry/module-manifest.schemas.js.map +1 -1
  143. package/dist/esm/registry/registry-config.schemas.d.ts.map +1 -1
  144. package/dist/esm/registry/registry-section-schemas.constants.d.ts.map +1 -1
  145. package/dist/esm/release/framework-release.constants.d.ts.map +1 -1
  146. package/dist/esm/release/framework-release.constants.js.map +1 -1
  147. package/dist/esm/schemas/framework-info.schemas.d.ts.map +1 -1
  148. package/dist/esm/schemas/framework-secrets.schemas.d.ts +12 -1
  149. package/dist/esm/schemas/framework-secrets.schemas.d.ts.map +1 -1
  150. package/dist/esm/schemas/framework-secrets.schemas.js +14 -1
  151. package/dist/esm/schemas/framework-secrets.schemas.js.map +1 -1
  152. package/dist/esm/schemas/platform-application-config.schemas.d.ts.map +1 -1
  153. package/dist/esm/schemas/platform-application-secrets.schemas.d.ts.map +1 -1
  154. package/dist/esm/schemas/platform-config.schemas.d.ts.map +1 -1
  155. package/dist/esm/workspace-scope/application-subject-manifest.d.ts.map +1 -1
  156. package/dist/esm/workspace-scope/index.d.ts.map +1 -1
  157. package/dist/esm/workspace-scope/resolve-homes.d.ts.map +1 -1
  158. package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts +4 -3
  159. package/dist/esm/workspace-scope/workspace-homes.schemas.d.ts.map +1 -1
  160. package/dist/esm/workspace-scope/workspace-homes.schemas.js +6 -5
  161. package/dist/esm/workspace-scope/workspace-homes.schemas.js.map +1 -1
  162. package/dist/esm/workspace-scope/workspace-scope.schemas.d.ts +15 -6
  163. package/dist/esm/workspace-scope/workspace-scope.schemas.d.ts.map +1 -1
  164. package/dist/esm/workspace-scope/workspace-scope.schemas.js +23 -9
  165. package/dist/esm/workspace-scope/workspace-scope.schemas.js.map +1 -1
  166. package/dist/tsconfig.build.tsbuildinfo +1 -1
  167. package/package.json +7 -7
@@ -1 +1 @@
1
- {"version":3,"file":"csp.schemas.d.ts","sourceRoot":"","sources":["../../../../src/project-config/shared/csp.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,+MAetB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,oBAAY,gBAAgB;IAC1B,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;CACtC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,8RAOvC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;OAIG;;IAEH;;;;;;;;;;;OAWG;;IAEH;;;;OAIG;;IAIH;;;OAGG;;IAEH;;;;;;;OAOG;;kBAEH,CAAC;AACH,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;;OAKG;;IAEH;;;;;;;;;;;;;;;;;;;;;;;OAuBG;;IAEH;;;;;;OAMG;;IAEH;;;OAGG;;kBAEH,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
1
+ {"version":3,"file":"csp.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/project-config/shared/csp.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,mBAAmB,+MAetB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE;;;;;;;;;;;;;GAaG;AACH,oBAAY,gBAAgB;IAC1B,eAAe,oBAAoB;IACnC,gBAAgB,qBAAqB;CACtC;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,8RAOvC,CAAC;AACF,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;;OAKG;;IAEH;;;;;;;;;;;OAWG;;IAEH;;;;OAIG;;IAIH;;;OAGG;;IAEH;;;;;;;OAOG;;kBAEH,CAAC;AACH,iEAAiE;AACjE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;;OAKG;;IAEH;;;;;;;;;;;;;;;;;;;;;;;OAuBG;;IAEH;;;;;;OAMG;;IAEH;;;OAGG;;kBAEH,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}
@@ -166,11 +166,11 @@ export const CspDirectivesOverrideSchema = z.strictObject(Object.fromEntries(CSP
166
166
  *
167
167
  * Declaring a Content-Security-Policy for one of the application's frontends.
168
168
  *
169
- * ⚠️ **It is OPT-IN, and omitting the block emits NO policy on either channel.** `enabled: false` and
170
- * an absent block are the same thing: no header, no protection. That default is deliberate — a
171
- * frontend that has not audited its third-party script and fetch surface should not ship a half-baked
172
- * policy that breaks features without protecting anything — but it does mean an application acquires
173
- * no CSP by existing.
169
+ * ⚠️ **Every browser surface ships a policy; what differs is what happens when you author none.** On
170
+ * the application (`services.<key>.csp`) an omitted block resolves at sync to `enabled: true,
171
+ * reportOnly: true` — a policy that reports violations and blocks nothing. A website or technical-doc
172
+ * config with no block is refused at sync, naming the file. A policy that resolves DISABLED is refused
173
+ * on every surface, so `enabled: false` cannot switch the header off.
174
174
  *
175
175
  * ## The generated file is the only one read
176
176
  *
@@ -195,10 +195,8 @@ export const CspDirectivesOverrideSchema = z.strictObject(Object.fromEntries(CSP
195
195
  * `wildo.website.config.ts.csp?`, and `services.<key>.csp` on the
196
196
  * `SAAS_APP` service definition.
197
197
  *
198
- * Opt-in by default: `enabled: false` (or omitting the block entirely)
199
- * emits NO policy on either channel. Frontends that have not audited
200
- * their third-party JS / fetch surface should not ship a half-baked
201
- * CSP that breaks features without protecting anything.
198
+ * An AUTHORED block that omits `enabled` parses as `enabled: false`, which the resolver turns into no
199
+ * policy and the sync then refuses — so author `enabled: true` explicitly whenever you write a block.
202
200
  *
203
201
  * `z.strictObject` (Zod 4) is intentional — typos like `enable: true`
204
202
  * (no `d`) or `directive: { … }` (no plural) MUST surface as parse
@@ -208,9 +206,10 @@ export const CspDirectivesOverrideSchema = z.strictObject(Object.fromEntries(CSP
208
206
  */
209
207
  export const WildoCspConfigSchema = z.strictObject({
210
208
  /**
211
- * Opt-in switch. `false` (default) => no policy emitted; the
212
- * resolver returns `null`. `true` => baseline (+ overrides) emitted
213
- * on both channels per `reportOnly`.
209
+ * `true` => baseline (+ overrides) emitted on both channels per `reportOnly`.
210
+ * `false` — also the parse default for an authored block — makes the resolver return `null`, and
211
+ * `wildo dev sync-csp` refuses that for every CSP-capable surface. It is not a way to turn the
212
+ * header off.
214
213
  */
215
214
  enabled: z.boolean().default(false),
216
215
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"csp.schemas.js","sourceRoot":"","sources":["../../../../src/project-config/shared/csp.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,aAAa;IACb,YAAY;IACZ,WAAW;IACX,SAAS;IACT,aAAa;IACb,UAAU;IACV,WAAW;IACX,iBAAiB;IACjB,YAAY;IACZ,aAAa;IACb,UAAU;IACV,cAAc;IACd,WAAW;IACX,YAAY;CACJ,CAAC;AAIX;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAN,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,uDAAmC,CAAA;IACnC,yDAAqC,CAAA;AACvC,CAAC,EAHW,gBAAgB,KAAhB,gBAAgB,QAG3B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,YAAY,CACvD,MAAM,CAAC,WAAW,CAChB,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAChC,IAAI;IACJ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CACiE,CACtE,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC;IACjD;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC;;;;;;;;;;;OAWG;IACH,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACtC;;;;OAIG;IACH,aAAa,EAAE,CAAC;SACb,IAAI,CAAC,gBAAgB,CAAC;SACtB,OAAO,CAAC,gBAAgB,CAAC,eAAe,CAAC;IAC5C;;;OAGG;IACH,UAAU,EAAE,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAKH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC;IACjD;;;;;OAKG;IACH,eAAe,EAAE,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;IACxD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC;;;OAGG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC","sourcesContent":["/**\n * Content-Security-Policy authoring schema for per-frontend opt-in.\n *\n * # Where this fits in the layered CSP cake\n *\n * 1. Platform default — `./csp-defaults.ts` ships per-`AppFrontendType`\n * baselines (`SAAS_APP`, `STATIC_WEBSITE`, `TECH_DOC`). The baseline\n * is opinionated but conservative: `default-src 'self'` plus the\n * narrowest set of relaxations each frontend kind genuinely needs\n * to render (e.g., Docusaurus 3.x's `'unsafe-inline'` script /\n * style requirement for `TECH_DOC`).\n * 2. App-static — this `WildoCspConfigSchema`, authored on each\n * service-definition's `csp?` field. `SAAS_APP` authors this on\n * `wildo.saas.config.ts > services.<key>.csp`; `STATIC_WEBSITE` authors\n * it on `wildo.website.config.ts`; `TECH_DOC` authors it on\n * `wildo.tech-doc.config.ts`.\n * 3. Env-specific — `EnvCspOverrideSchema` below, authored under\n * `wildo.infra.<env>.config.ts.csp?[serviceKey]`. `WildoInfraEnvConfigSchema`\n * declares that field, so the layer is live. Its build-time consumer is\n * `wildo dev sync-csp`, which reads `parsed.csp[serviceKey]` when emitting\n * generated frontend CSP artifacts.\n * 4. Declared providers — NOT authored here at all (#332). Each frontend\n * provider declares the origins it needs to reach on its own module, that\n * footprint travels as data into the materialized frontend-services\n * artifact, and `resolveCspPolicy` merges the footprints of the providers\n * declared FOR THIS SERVICE. Layers 1–3 say what the application decided;\n * layer 4 says what the things it declared actually need in order to work,\n * which is why it is additive even under `replace-baseline`.\n *\n * # Resolution semantics (consumed by `platform-config-lib/src/project-config/shared/csp-emit.ts`)\n *\n * - `enabled: false` (default) => no policy emitted; the resolver\n * returns `null` and both nginx + meta channels stay silent. The\n * opt-in shape (vs opt-out) is deliberate — frontends that have not\n * audited their third-party surface should not ship a half-baked\n * CSP that breaks features without protecting anything.\n * - `enabled: true` with no `directives` override => baseline emitted\n * verbatim (see `./csp-defaults.ts`).\n * - `enabled: true` with `directives` AND `mergeStrategy: 'extend-baseline'`\n * (default) => per-directive ADDITIVE merge: each authored source\n * list is concatenated to the baseline's source list for that\n * directive (de-duplicated, baseline order preserved, app sources\n * appended in author order). Directives the baseline doesn't ship\n * are added wholesale.\n * - `enabled: true` with `mergeStrategy: 'replace-baseline'` =>\n * authored `directives` map REPLACES the baseline entirely; missing\n * directives are simply absent from the policy. Use only when the\n * baseline is fundamentally wrong for the surface (e.g., a\n * `STATIC_WEBSITE` that actually serves an embedded SaaS app and\n * wants the tighter `SAAS_APP`-style policy from scratch). The\n * escape hatch exists; the merge default exists for the common\n * case (additive tightening / loosening).\n * - `reportOnly: true` => header name flips to\n * `Content-Security-Policy-Report-Only` AND the `<meta http-equiv>`\n * channel goes silent (browsers reject the report-only header via\n * meta — W3C CSP3 §4.2.1). `reportOnly: false` (default once the\n * pilot triages clean) emits the enforcing header AND the meta\n * tag (with header-only directives stripped from the meta tag —\n * see `META_INVALID_DIRECTIVES` in `csp-emit.ts`).\n * - `reportUri` => header-only directive value (the meta tag would\n * ignore it). The resolver feeds it to the nginx channel only.\n *\n * # Why the `directives` keys are an explicit closed set vs a free-form `Record<string, ...>`\n *\n * CSP grew organically over a decade and a half. The closed set below\n * (`default-src` / `script-src` / `style-src` / `img-src` / `connect-src`\n * / `font-src` / `frame-src` / `frame-ancestors` / `object-src` /\n * `form-action` / `base-uri` / `manifest-src` / `media-src` / `worker-src`)\n * covers every directive the platform's three frontend kinds genuinely\n * use today. Forcing authors to spell directive names through the schema\n * surface (vs `Record<string, string[]>`) catches typos at parse time\n * (`script-source` !== `script-src`) and gives IDE autocompletion. Adding\n * a new directive is a one-line schema edit when a real consumer asks\n * for it; meanwhile the default-deny stance prevents authors from\n * accidentally shipping a directive name the browser silently ignores.\n *\n * # Author-friendly source lists\n *\n * Each directive's value is `string[]`. The resolver does NOT validate\n * the contents of the source list (that would require importing a CSP\n * grammar — out of scope for this commit). Common shapes:\n *\n * - `\"'self'\"` — single-quoted keyword, MUST keep the quotes.\n * - `'data:'`, `'blob:'` — scheme sources.\n * - `'https://api.example.com'` — origin source.\n * - `\"'unsafe-inline'\"`, `\"'unsafe-eval'\"` — single-quoted keywords.\n * - `\"'nonce-<base64>'\"` — nonce keyword (rendered per-request).\n * - `\"'sha256-<hash>'\"` — hash keyword.\n *\n * The `csp-emit.ts` serializer joins source lists with single spaces\n * and separates directives with `; ` (no leading/trailing semicolon —\n * matches Mozilla / OWASP recommended whitespace).\n */\n\nimport { z } from 'zod';\n\n/**\n * Closed set of directive names we accept on the `csp.directives`\n * authoring map. Adding a new directive name requires:\n *\n * 1. Adding the literal here.\n * 2. Updating any per-`AppFrontendType` baseline that should ship the\n * directive by default in `./csp-defaults.ts`.\n * 3. Verifying the `csp-emit.ts` serializer handles the directive\n * (it does — the serializer is generic over directive names — so\n * step 3 is usually a no-op).\n *\n * The `META_INVALID_DIRECTIVES` set in `csp-emit.ts` lists the\n * directives the browser ignores when emitted via `<meta http-equiv>`\n * (`frame-ancestors`, `report-uri`, `report-to`, `sandbox`); they're\n * stripped from the meta-channel output but remain on the nginx\n * channel. Keep that set in sync if a new header-only directive lands\n * here.\n */\nexport const CSP_DIRECTIVE_NAMES = [\n 'default-src',\n 'script-src',\n 'style-src',\n 'img-src',\n 'connect-src',\n 'font-src',\n 'frame-src',\n 'frame-ancestors',\n 'object-src',\n 'form-action',\n 'base-uri',\n 'manifest-src',\n 'media-src',\n 'worker-src',\n] as const;\n\nexport type CspDirectiveName = (typeof CSP_DIRECTIVE_NAMES)[number];\n\n/**\n * Author-side merge strategy for the app-static layer over the baseline.\n *\n * - `'extend-baseline'` (default) — per-directive ADDITIVE merge:\n * each authored source list is APPENDED to the baseline source\n * list for that directive. Directives the baseline doesn't ship\n * are added wholesale. Common case: an app needs to add ONE extra\n * `connect-src` origin without re-authoring the rest of the policy.\n * - `'replace-baseline'` — authored `directives` map REPLACES the\n * baseline entirely. Use when the baseline is fundamentally wrong\n * for the surface (e.g., a tighter or fundamentally different\n * posture). Escape hatch — the merge default is the right answer\n * in 95% of cases.\n */\nexport enum CspMergeStrategy {\n EXTEND_BASELINE = 'extend-baseline',\n REPLACE_BASELINE = 'replace-baseline',\n}\n\n/**\n * Author-side directive overrides — partial map keyed by the closed\n * directive-name set above. Each value is a source list of strings\n * (joined with single spaces by the serializer).\n *\n * Authoring `directives: { 'connect-src': ['https://api.example.com'] }`\n * with the default `'extend-baseline'` strategy APPENDS that origin to\n * the baseline `connect-src` source list (which already contains\n * `'self'` for every baseline) — it does NOT replace the baseline's\n * `connect-src`. Use `mergeStrategy: 'replace-baseline'` to opt out of\n * additive merging.\n */\nexport const CspDirectivesOverrideSchema = z.strictObject(\n Object.fromEntries(\n CSP_DIRECTIVE_NAMES.map((name) => [\n name,\n z.array(z.string().min(1)).optional(),\n ]),\n ) as Record<CspDirectiveName, z.ZodOptional<z.ZodArray<z.ZodString>>>,\n);\nexport type CspDirectivesOverride = z.infer<typeof CspDirectivesOverrideSchema>;\n\n/**\n * @wildo_source:part:start saas.config.content-security-policy facet:layer:shared facet:audience:app-developer\n *\n * Declaring a Content-Security-Policy for one of the application's frontends.\n *\n * ⚠️ **It is OPT-IN, and omitting the block emits NO policy on either channel.** `enabled: false` and\n * an absent block are the same thing: no header, no protection. That default is deliberate — a\n * frontend that has not audited its third-party script and fetch surface should not ship a half-baked\n * policy that breaks features without protecting anything — but it does mean an application acquires\n * no CSP by existing.\n *\n * ## The generated file is the only one read\n *\n * Author the static posture here, add per-environment entries under `csp.<serviceKey>` in that\n * environment's infrastructure configuration, then run `wildo dev sync-csp --env <env>` (starting\n * development runs it for you). Each surface reads ONLY the generated artifact — hand-editing a\n * surface's own policy file changes nothing and is overwritten on the next sync.\n *\n * ## `reportOnly` is a posture, not a formality\n *\n * `reportOnly: true` emits the report-only header: the browser reports violations and BLOCKS\n * NOTHING. Flipping it is one field. Note also that a `report-uri` is supported by the schema and the\n * emitter and no baseline ships a collector, so with nothing authored there the reports a browser\n * generates have nowhere to go — report-only plus no collector is a policy that neither blocks nor\n * tells you anything.\n *\n * Nonces and hashes are not generated per request or at build time. A source list may name one by\n * hand, but there is no generation, which is why a baseline that must admit inline script still does.\n *\n * Per-frontend CSP block. Authored on each service-definition's `csp?`\n * field. All three surfaces carry it: `wildo.tech-doc.config.ts.csp?`,\n * `wildo.website.config.ts.csp?`, and `services.<key>.csp` on the\n * `SAAS_APP` service definition.\n *\n * Opt-in by default: `enabled: false` (or omitting the block entirely)\n * emits NO policy on either channel. Frontends that have not audited\n * their third-party JS / fetch surface should not ship a half-baked\n * CSP that breaks features without protecting anything.\n *\n * `z.strictObject` (Zod 4) is intentional — typos like `enable: true`\n * (no `d`) or `directive: { … }` (no plural) MUST surface as parse\n * errors, not silently strip to `enabled: false` (i.e. CSP off, the\n * worst possible default). Same framework-mindset enforcement as\n * `WildoAuthConfigSchema`.\n */\nexport const WildoCspConfigSchema = z.strictObject({\n /**\n * Opt-in switch. `false` (default) => no policy emitted; the\n * resolver returns `null`. `true` => baseline (+ overrides) emitted\n * on both channels per `reportOnly`.\n */\n enabled: z.boolean().default(false),\n /**\n * `true` => header name flips to `Content-Security-Policy-Report-Only`\n * AND the `<meta http-equiv>` channel goes silent (browsers reject the\n * report-only header via meta — W3C CSP3 §4.2.1). Use during the\n * pilot to triage console-surfaced violations without breaking real\n * traffic. Flip to `false` once the directive overrides settle.\n *\n * Default: `false` (enforcing). Authors opting into CSP for the first\n * time SHOULD set `reportOnly: true` for the first PR; the schema\n * default is intentionally enforcing so the steady state (post-pilot)\n * doesn't require a per-app authored `reportOnly: false`.\n */\n reportOnly: z.boolean().default(false),\n /**\n * Merge strategy for authored `directives` over the baseline. Default:\n * `'extend-baseline'` (per-directive additive merge — see\n * `CspMergeStrategy`).\n */\n mergeStrategy: z\n .enum(CspMergeStrategy)\n .default(CspMergeStrategy.EXTEND_BASELINE),\n /**\n * Per-directive overrides, keyed by directive name. Default: empty\n * map (baseline emitted verbatim).\n */\n directives: CspDirectivesOverrideSchema.default({}),\n /**\n * Optional `report-uri` directive value (header-only — meta tag\n * ignores it; the resolver feeds it to the nginx channel only).\n * No `report-to` field today — `report-to` requires the parallel\n * Reporting API endpoint config which the platform doesn't ship; add\n * when the violation-collector lands (`auth-hardening.md` \"Cheap\n * Bonuses — CSP violation monitoring endpoint\").\n */\n reportUri: z.string().min(1).optional(),\n});\n/** @wildo_source:part:end saas.config.content-security-policy */\nexport type WildoCspConfig = z.infer<typeof WildoCspConfigSchema>;\nexport type WildoCspConfigInput = z.input<typeof WildoCspConfigSchema>;\n\n/**\n * Env-specific overrides — authored under\n * `wildo.infra.<env>.config.ts.csp?[serviceKey]`. The loader merges\n * these on top of the app-static layer (which itself is on top of the\n * baseline).\n *\n * `WildoInfraEnvConfigSchema` declares `csp` as a record of these,\n * keyed by service key, and the resolver in `csp-emit.ts` consumes it.\n *\n * `extraDirectives` is ADDITIVE only — env-layer entries are APPENDED\n * to whatever the app-static layer produced for that directive. There\n * is no `'replace-baseline'`-equivalent at the env layer because env\n * config exists to LOOSEN policies for specific deployments (Sentry\n * origin in staging, dev hot-reload `'unsafe-eval'`), not to replace\n * an app's chosen posture. If an env genuinely needs a different\n * posture the right answer is to fix the app-static layer.\n */\nexport const EnvCspOverrideSchema = z.strictObject({\n /**\n * Per-directive ADDITIVE merge. Each entry's source list is\n * APPENDED to the app-static layer's source list for that directive\n * (de-duplicated, app order preserved, env sources appended in\n * author order). No replace semantics at this layer.\n */\n extraDirectives: CspDirectivesOverrideSchema.default({}),\n /**\n * Vite dev-mode CSP loosening: adds BOTH `'unsafe-inline'` and\n * `'unsafe-eval'` to `script-src`. Vite's dev server injects an\n * inline `<script>` for the HMR client bootstrap AND uses `eval()`\n * for lazy module / sourcemap transforms — both block under a strict\n * `script-src 'self'` policy and produce ~120+ CSP violations per\n * page load. Production Vite builds emit `<script type=\"module\">`\n * only and use no `eval()`, so this loosening is dev-only by design.\n *\n * AUTO-DEFAULT: `true` when the resolved env id is `'local'` AND the\n * frontend type is `SAAS_APP` (the only Vite-bundled frontend kind in\n * the framework). The framework applies the loosening automatically so\n * every Wildo app gets a clean dev console without per-app\n * configuration; opting in app-by-app would scatter the same\n * framework-shipped Vite knowledge across N infrastructure files.\n *\n * EXPLICIT OPT-OUT: set to `false` to keep tight `script-src` in\n * local dev. Useful only when actively debugging a real CSP issue\n * and willing to accept Vite-induced noise. Production envs ignore\n * this flag's auto-default and require explicit opt-in (extremely\n * unusual — a production app that needs `'unsafe-inline'` /\n * `'unsafe-eval'` is almost always a sign of a misconfigured asset\n * pipeline).\n */\n viteDevLoosening: z.boolean().optional(),\n /**\n * Env-layer override of the app-static `reportOnly` flag. When\n * present (not `undefined`), takes precedence over the app-static\n * value. Common shape: app-static ships `reportOnly: false`\n * (enforcing in prod), env-layer flips to `reportOnly: true` for\n * staging while the violation collector ramps up.\n */\n reportOnly: z.boolean().optional(),\n /**\n * Env-layer override of the app-static `reportUri` (e.g., per-env\n * collector endpoint).\n */\n reportUri: z.string().min(1).optional(),\n});\nexport type EnvCspOverride = z.infer<typeof EnvCspOverrideSchema>;\nexport type EnvCspOverrideInput = z.input<typeof EnvCspOverrideSchema>;\n"]}
1
+ {"version":3,"file":"csp.schemas.js","sourceRoot":"","sources":["../../../../../src/project-config/shared/csp.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4FG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,aAAa;IACb,YAAY;IACZ,WAAW;IACX,SAAS;IACT,aAAa;IACb,UAAU;IACV,WAAW;IACX,iBAAiB;IACjB,YAAY;IACZ,aAAa;IACb,UAAU;IACV,cAAc;IACd,WAAW;IACX,YAAY;CACJ,CAAC;AAIX;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAN,IAAY,gBAGX;AAHD,WAAY,gBAAgB;IAC1B,uDAAmC,CAAA;IACnC,yDAAqC,CAAA;AACvC,CAAC,EAHW,gBAAgB,KAAhB,gBAAgB,QAG3B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,YAAY,CACvD,MAAM,CAAC,WAAW,CAChB,mBAAmB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;IAChC,IAAI;IACJ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CACiE,CACtE,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC;IACjD;;;;;OAKG;IACH,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACnC;;;;;;;;;;;OAWG;IACH,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACtC;;;;OAIG;IACH,aAAa,EAAE,CAAC;SACb,IAAI,CAAC,gBAAgB,CAAC;SACtB,OAAO,CAAC,gBAAgB,CAAC,eAAe,CAAC;IAC5C;;;OAGG;IACH,UAAU,EAAE,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;IACnD;;;;;;;OAOG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAKH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,YAAY,CAAC;IACjD;;;;;OAKG;IACH,eAAe,EAAE,2BAA2B,CAAC,OAAO,CAAC,EAAE,CAAC;IACxD;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC;;;;;;OAMG;IACH,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC;;;OAGG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC","sourcesContent":["/**\n * Content-Security-Policy authoring schema for per-frontend opt-in.\n *\n * # Where this fits in the layered CSP cake\n *\n * 1. Platform default — `./csp-defaults.ts` ships per-`AppFrontendType`\n * baselines (`SAAS_APP`, `STATIC_WEBSITE`, `TECH_DOC`). The baseline\n * is opinionated but conservative: `default-src 'self'` plus the\n * narrowest set of relaxations each frontend kind genuinely needs\n * to render (e.g., Docusaurus 3.x's `'unsafe-inline'` script /\n * style requirement for `TECH_DOC`).\n * 2. App-static — this `WildoCspConfigSchema`, authored on each\n * service-definition's `csp?` field. `SAAS_APP` authors this on\n * `wildo.saas.config.ts > services.<key>.csp`; `STATIC_WEBSITE` authors\n * it on `wildo.website.config.ts`; `TECH_DOC` authors it on\n * `wildo.tech-doc.config.ts`.\n * 3. Env-specific — `EnvCspOverrideSchema` below, authored under\n * `wildo.infra.<env>.config.ts.csp?[serviceKey]`. `WildoInfraEnvConfigSchema`\n * declares that field, so the layer is live. Its build-time consumer is\n * `wildo dev sync-csp`, which reads `parsed.csp[serviceKey]` when emitting\n * generated frontend CSP artifacts.\n * 4. Declared providers — NOT authored here at all (#332). Each frontend\n * provider declares the origins it needs to reach on its own module, that\n * footprint travels as data into the materialized frontend-services\n * artifact, and `resolveCspPolicy` merges the footprints of the providers\n * declared FOR THIS SERVICE. Layers 1–3 say what the application decided;\n * layer 4 says what the things it declared actually need in order to work,\n * which is why it is additive even under `replace-baseline`.\n *\n * # Resolution semantics (consumed by `platform-config-lib/src/project-config/shared/csp-emit.ts`)\n *\n * - `enabled: false` (default) => no policy emitted; the resolver\n * returns `null` and both nginx + meta channels stay silent. The\n * opt-in shape (vs opt-out) is deliberate — frontends that have not\n * audited their third-party surface should not ship a half-baked\n * CSP that breaks features without protecting anything.\n * - `enabled: true` with no `directives` override => baseline emitted\n * verbatim (see `./csp-defaults.ts`).\n * - `enabled: true` with `directives` AND `mergeStrategy: 'extend-baseline'`\n * (default) => per-directive ADDITIVE merge: each authored source\n * list is concatenated to the baseline's source list for that\n * directive (de-duplicated, baseline order preserved, app sources\n * appended in author order). Directives the baseline doesn't ship\n * are added wholesale.\n * - `enabled: true` with `mergeStrategy: 'replace-baseline'` =>\n * authored `directives` map REPLACES the baseline entirely; missing\n * directives are simply absent from the policy. Use only when the\n * baseline is fundamentally wrong for the surface (e.g., a\n * `STATIC_WEBSITE` that actually serves an embedded SaaS app and\n * wants the tighter `SAAS_APP`-style policy from scratch). The\n * escape hatch exists; the merge default exists for the common\n * case (additive tightening / loosening).\n * - `reportOnly: true` => header name flips to\n * `Content-Security-Policy-Report-Only` AND the `<meta http-equiv>`\n * channel goes silent (browsers reject the report-only header via\n * meta — W3C CSP3 §4.2.1). `reportOnly: false` (default once the\n * pilot triages clean) emits the enforcing header AND the meta\n * tag (with header-only directives stripped from the meta tag —\n * see `META_INVALID_DIRECTIVES` in `csp-emit.ts`).\n * - `reportUri` => header-only directive value (the meta tag would\n * ignore it). The resolver feeds it to the nginx channel only.\n *\n * # Why the `directives` keys are an explicit closed set vs a free-form `Record<string, ...>`\n *\n * CSP grew organically over a decade and a half. The closed set below\n * (`default-src` / `script-src` / `style-src` / `img-src` / `connect-src`\n * / `font-src` / `frame-src` / `frame-ancestors` / `object-src` /\n * `form-action` / `base-uri` / `manifest-src` / `media-src` / `worker-src`)\n * covers every directive the platform's three frontend kinds genuinely\n * use today. Forcing authors to spell directive names through the schema\n * surface (vs `Record<string, string[]>`) catches typos at parse time\n * (`script-source` !== `script-src`) and gives IDE autocompletion. Adding\n * a new directive is a one-line schema edit when a real consumer asks\n * for it; meanwhile the default-deny stance prevents authors from\n * accidentally shipping a directive name the browser silently ignores.\n *\n * # Author-friendly source lists\n *\n * Each directive's value is `string[]`. The resolver does NOT validate\n * the contents of the source list (that would require importing a CSP\n * grammar — out of scope for this commit). Common shapes:\n *\n * - `\"'self'\"` — single-quoted keyword, MUST keep the quotes.\n * - `'data:'`, `'blob:'` — scheme sources.\n * - `'https://api.example.com'` — origin source.\n * - `\"'unsafe-inline'\"`, `\"'unsafe-eval'\"` — single-quoted keywords.\n * - `\"'nonce-<base64>'\"` — nonce keyword (rendered per-request).\n * - `\"'sha256-<hash>'\"` — hash keyword.\n *\n * The `csp-emit.ts` serializer joins source lists with single spaces\n * and separates directives with `; ` (no leading/trailing semicolon —\n * matches Mozilla / OWASP recommended whitespace).\n */\n\nimport { z } from 'zod';\n\n/**\n * Closed set of directive names we accept on the `csp.directives`\n * authoring map. Adding a new directive name requires:\n *\n * 1. Adding the literal here.\n * 2. Updating any per-`AppFrontendType` baseline that should ship the\n * directive by default in `./csp-defaults.ts`.\n * 3. Verifying the `csp-emit.ts` serializer handles the directive\n * (it does — the serializer is generic over directive names — so\n * step 3 is usually a no-op).\n *\n * The `META_INVALID_DIRECTIVES` set in `csp-emit.ts` lists the\n * directives the browser ignores when emitted via `<meta http-equiv>`\n * (`frame-ancestors`, `report-uri`, `report-to`, `sandbox`); they're\n * stripped from the meta-channel output but remain on the nginx\n * channel. Keep that set in sync if a new header-only directive lands\n * here.\n */\nexport const CSP_DIRECTIVE_NAMES = [\n 'default-src',\n 'script-src',\n 'style-src',\n 'img-src',\n 'connect-src',\n 'font-src',\n 'frame-src',\n 'frame-ancestors',\n 'object-src',\n 'form-action',\n 'base-uri',\n 'manifest-src',\n 'media-src',\n 'worker-src',\n] as const;\n\nexport type CspDirectiveName = (typeof CSP_DIRECTIVE_NAMES)[number];\n\n/**\n * Author-side merge strategy for the app-static layer over the baseline.\n *\n * - `'extend-baseline'` (default) — per-directive ADDITIVE merge:\n * each authored source list is APPENDED to the baseline source\n * list for that directive. Directives the baseline doesn't ship\n * are added wholesale. Common case: an app needs to add ONE extra\n * `connect-src` origin without re-authoring the rest of the policy.\n * - `'replace-baseline'` — authored `directives` map REPLACES the\n * baseline entirely. Use when the baseline is fundamentally wrong\n * for the surface (e.g., a tighter or fundamentally different\n * posture). Escape hatch — the merge default is the right answer\n * in 95% of cases.\n */\nexport enum CspMergeStrategy {\n EXTEND_BASELINE = 'extend-baseline',\n REPLACE_BASELINE = 'replace-baseline',\n}\n\n/**\n * Author-side directive overrides — partial map keyed by the closed\n * directive-name set above. Each value is a source list of strings\n * (joined with single spaces by the serializer).\n *\n * Authoring `directives: { 'connect-src': ['https://api.example.com'] }`\n * with the default `'extend-baseline'` strategy APPENDS that origin to\n * the baseline `connect-src` source list (which already contains\n * `'self'` for every baseline) — it does NOT replace the baseline's\n * `connect-src`. Use `mergeStrategy: 'replace-baseline'` to opt out of\n * additive merging.\n */\nexport const CspDirectivesOverrideSchema = z.strictObject(\n Object.fromEntries(\n CSP_DIRECTIVE_NAMES.map((name) => [\n name,\n z.array(z.string().min(1)).optional(),\n ]),\n ) as Record<CspDirectiveName, z.ZodOptional<z.ZodArray<z.ZodString>>>,\n);\nexport type CspDirectivesOverride = z.infer<typeof CspDirectivesOverrideSchema>;\n\n/**\n * @wildo_source:part:start saas.config.content-security-policy facet:layer:shared facet:audience:app-developer\n *\n * Declaring a Content-Security-Policy for one of the application's frontends.\n *\n * ⚠️ **Every browser surface ships a policy; what differs is what happens when you author none.** On\n * the application (`services.<key>.csp`) an omitted block resolves at sync to `enabled: true,\n * reportOnly: true` — a policy that reports violations and blocks nothing. A website or technical-doc\n * config with no block is refused at sync, naming the file. A policy that resolves DISABLED is refused\n * on every surface, so `enabled: false` cannot switch the header off.\n *\n * ## The generated file is the only one read\n *\n * Author the static posture here, add per-environment entries under `csp.<serviceKey>` in that\n * environment's infrastructure configuration, then run `wildo dev sync-csp --env <env>` (starting\n * development runs it for you). Each surface reads ONLY the generated artifact — hand-editing a\n * surface's own policy file changes nothing and is overwritten on the next sync.\n *\n * ## `reportOnly` is a posture, not a formality\n *\n * `reportOnly: true` emits the report-only header: the browser reports violations and BLOCKS\n * NOTHING. Flipping it is one field. Note also that a `report-uri` is supported by the schema and the\n * emitter and no baseline ships a collector, so with nothing authored there the reports a browser\n * generates have nowhere to go — report-only plus no collector is a policy that neither blocks nor\n * tells you anything.\n *\n * Nonces and hashes are not generated per request or at build time. A source list may name one by\n * hand, but there is no generation, which is why a baseline that must admit inline script still does.\n *\n * Per-frontend CSP block. Authored on each service-definition's `csp?`\n * field. All three surfaces carry it: `wildo.tech-doc.config.ts.csp?`,\n * `wildo.website.config.ts.csp?`, and `services.<key>.csp` on the\n * `SAAS_APP` service definition.\n *\n * An AUTHORED block that omits `enabled` parses as `enabled: false`, which the resolver turns into no\n * policy and the sync then refuses — so author `enabled: true` explicitly whenever you write a block.\n *\n * `z.strictObject` (Zod 4) is intentional — typos like `enable: true`\n * (no `d`) or `directive: { … }` (no plural) MUST surface as parse\n * errors, not silently strip to `enabled: false` (i.e. CSP off, the\n * worst possible default). Same framework-mindset enforcement as\n * `WildoAuthConfigSchema`.\n */\nexport const WildoCspConfigSchema = z.strictObject({\n /**\n * `true` => baseline (+ overrides) emitted on both channels per `reportOnly`.\n * `false` — also the parse default for an authored block — makes the resolver return `null`, and\n * `wildo dev sync-csp` refuses that for every CSP-capable surface. It is not a way to turn the\n * header off.\n */\n enabled: z.boolean().default(false),\n /**\n * `true` => header name flips to `Content-Security-Policy-Report-Only`\n * AND the `<meta http-equiv>` channel goes silent (browsers reject the\n * report-only header via meta — W3C CSP3 §4.2.1). Use during the\n * pilot to triage console-surfaced violations without breaking real\n * traffic. Flip to `false` once the directive overrides settle.\n *\n * Default: `false` (enforcing). Authors opting into CSP for the first\n * time SHOULD set `reportOnly: true` for the first PR; the schema\n * default is intentionally enforcing so the steady state (post-pilot)\n * doesn't require a per-app authored `reportOnly: false`.\n */\n reportOnly: z.boolean().default(false),\n /**\n * Merge strategy for authored `directives` over the baseline. Default:\n * `'extend-baseline'` (per-directive additive merge — see\n * `CspMergeStrategy`).\n */\n mergeStrategy: z\n .enum(CspMergeStrategy)\n .default(CspMergeStrategy.EXTEND_BASELINE),\n /**\n * Per-directive overrides, keyed by directive name. Default: empty\n * map (baseline emitted verbatim).\n */\n directives: CspDirectivesOverrideSchema.default({}),\n /**\n * Optional `report-uri` directive value (header-only — meta tag\n * ignores it; the resolver feeds it to the nginx channel only).\n * No `report-to` field today — `report-to` requires the parallel\n * Reporting API endpoint config which the platform doesn't ship; add\n * when the violation-collector lands (`auth-hardening.md` \"Cheap\n * Bonuses — CSP violation monitoring endpoint\").\n */\n reportUri: z.string().min(1).optional(),\n});\n/** @wildo_source:part:end saas.config.content-security-policy */\nexport type WildoCspConfig = z.infer<typeof WildoCspConfigSchema>;\nexport type WildoCspConfigInput = z.input<typeof WildoCspConfigSchema>;\n\n/**\n * Env-specific overrides — authored under\n * `wildo.infra.<env>.config.ts.csp?[serviceKey]`. The loader merges\n * these on top of the app-static layer (which itself is on top of the\n * baseline).\n *\n * `WildoInfraEnvConfigSchema` declares `csp` as a record of these,\n * keyed by service key, and the resolver in `csp-emit.ts` consumes it.\n *\n * `extraDirectives` is ADDITIVE only — env-layer entries are APPENDED\n * to whatever the app-static layer produced for that directive. There\n * is no `'replace-baseline'`-equivalent at the env layer because env\n * config exists to LOOSEN policies for specific deployments (Sentry\n * origin in staging, dev hot-reload `'unsafe-eval'`), not to replace\n * an app's chosen posture. If an env genuinely needs a different\n * posture the right answer is to fix the app-static layer.\n */\nexport const EnvCspOverrideSchema = z.strictObject({\n /**\n * Per-directive ADDITIVE merge. Each entry's source list is\n * APPENDED to the app-static layer's source list for that directive\n * (de-duplicated, app order preserved, env sources appended in\n * author order). No replace semantics at this layer.\n */\n extraDirectives: CspDirectivesOverrideSchema.default({}),\n /**\n * Vite dev-mode CSP loosening: adds BOTH `'unsafe-inline'` and\n * `'unsafe-eval'` to `script-src`. Vite's dev server injects an\n * inline `<script>` for the HMR client bootstrap AND uses `eval()`\n * for lazy module / sourcemap transforms — both block under a strict\n * `script-src 'self'` policy and produce ~120+ CSP violations per\n * page load. Production Vite builds emit `<script type=\"module\">`\n * only and use no `eval()`, so this loosening is dev-only by design.\n *\n * AUTO-DEFAULT: `true` when the resolved env id is `'local'` AND the\n * frontend type is `SAAS_APP` (the only Vite-bundled frontend kind in\n * the framework). The framework applies the loosening automatically so\n * every Wildo app gets a clean dev console without per-app\n * configuration; opting in app-by-app would scatter the same\n * framework-shipped Vite knowledge across N infrastructure files.\n *\n * EXPLICIT OPT-OUT: set to `false` to keep tight `script-src` in\n * local dev. Useful only when actively debugging a real CSP issue\n * and willing to accept Vite-induced noise. Production envs ignore\n * this flag's auto-default and require explicit opt-in (extremely\n * unusual — a production app that needs `'unsafe-inline'` /\n * `'unsafe-eval'` is almost always a sign of a misconfigured asset\n * pipeline).\n */\n viteDevLoosening: z.boolean().optional(),\n /**\n * Env-layer override of the app-static `reportOnly` flag. When\n * present (not `undefined`), takes precedence over the app-static\n * value. Common shape: app-static ships `reportOnly: false`\n * (enforcing in prod), env-layer flips to `reportOnly: true` for\n * staging while the violation collector ramps up.\n */\n reportOnly: z.boolean().optional(),\n /**\n * Env-layer override of the app-static `reportUri` (e.g., per-env\n * collector endpoint).\n */\n reportUri: z.string().min(1).optional(),\n});\nexport type EnvCspOverride = z.infer<typeof EnvCspOverrideSchema>;\nexport type EnvCspOverrideInput = z.input<typeof EnvCspOverrideSchema>;\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"data-services.schemas.d.ts","sourceRoot":"","sources":["../../../../src/project-config/shared/data-services.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,qBAAqB;;;;IAEhC;;;;;;;OAOG;;;;;;;;;;kBAQH,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,eAAe,GAAG,SAAS,GACxC,MAAM,GAAG,SAAS,CAsBpB"}
1
+ {"version":3,"file":"data-services.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/project-config/shared/data-services.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,qBAAqB;;;;IAEhC;;;;;;;OAOG;;;;;;;;;;kBAQH,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,eAAe,GAAG,SAAS,GACxC,MAAM,GAAG,SAAS,CAsBpB"}
@@ -1 +1 @@
1
- {"version":3,"file":"env-example-defaults.d.ts","sourceRoot":"","sources":["../../../../src/project-config/shared/env-example-defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,2BAA2B;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,mCAAmC,EAAE,MAAM,CAAC;IAC5C,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC,EAAE,MAAM,CAAC;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAC/C,2BAA2B,CAiB7B"}
1
+ {"version":3,"file":"env-example-defaults.d.ts","sourceRoot":"","sources":["../../../../../src/project-config/shared/env-example-defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,2BAA2B;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,mCAAmC,EAAE,MAAM,CAAC;IAC5C,yBAAyB,EAAE,MAAM,CAAC;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC,EAAE,MAAM,CAAC;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAC/C,SAAS,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,GAC/C,2BAA2B,CAiB7B"}
@@ -31,10 +31,75 @@ export declare enum WildoLocationType {
31
31
  REMOTE = "remote"
32
32
  }
33
33
  export declare function isLocalEnvironmentId(environmentId: string): boolean;
34
+ /**
35
+ * Where a docker-compose backing service keeps its DATA.
36
+ *
37
+ * The two members are not a performance knob with a fast and a slow setting — they answer a
38
+ * question about ownership, and the cost follows from the answer:
39
+ *
40
+ * - `HOST_PATH` — the data lives at an explicit path on the host
41
+ * (`<saas-root>/.wildo-saas/local_data/<service>/`), bind-mounted into the container. The
42
+ * operator chooses the disk, backups target a known directory, and the tree is the same one the
43
+ * Kind k8s lane hostPath-mounts at `/mnt/local-data/<service>/`. That control is why it is the
44
+ * REMOTE default: a production operator who has provisioned a dedicated data volume must be able
45
+ * to put the database on it, and a named volume would silently land it under
46
+ * `/var/lib/docker/volumes/` on the root disk.
47
+ * - `DOCKER_VOLUME` — the data lives in a Docker named volume, inside the container runtime's own
48
+ * storage. Nobody outside Docker addresses it, which is exactly what makes it right for a
49
+ * disposable development stack.
50
+ *
51
+ * ## Why LOCAL defaults to `DOCKER_VOLUME`
52
+ *
53
+ * On Linux a bind mount is a native path and costs nothing. On macOS and Windows the container
54
+ * runtime is a VM, and a host bind mount crosses a filesystem bridge — VirtioFS on macOS, 9p/
55
+ * VirtioFS through WSL2 on Windows. Databases do small fsync'd random writes, so every one of them
56
+ * becomes a round trip out of the VM.
57
+ *
58
+ * Measured on macOS (Apple Virtualization, 6 vCPU) on 2026-09-22 with the eight self-hosted backing
59
+ * services bind-mounted: the VM process held **13,786 host file descriptors** open across 14,168
60
+ * files and burned **383% CPU** in Docker Desktop's file-sharing process — sustained, a 321%
61
+ * average over 2 days 5 hours — while the containers themselves used 0.7 of a core and container
62
+ * block-IO accounting stayed flat, because none of that traffic reaches the VM's own block device.
63
+ * Roughly four cores of pure filesystem translation for 0.7 of a core of database work.
64
+ *
65
+ * The default is uniform across all three development operating systems rather than "volumes on
66
+ * macOS and Windows, host paths on Linux", so every developer and CI run exercise the same stack
67
+ * and a bug reproduces the same way everywhere. It costs a Linux developer nothing: a named volume
68
+ * is a native directory there too.
69
+ *
70
+ * Both members are authorable per environment (`localDataStorage`), so a remote operator who wants
71
+ * volumes and a local developer who wants to read the files from their file manager each say so.
72
+ *
73
+ * NOTE this governs DATA directories only. The two small secret FILES compose mounts read-only —
74
+ * immudb's state-signing key and mongot's sync-source password — are materialized from
75
+ * `secrets.json` onto the host and stay host mounts under every mode. They are read once at
76
+ * startup, so they carry none of the cost above, and they have nowhere else to come from.
77
+ */
78
+ export declare enum WildoLocalDataStorage {
79
+ DOCKER_VOLUME = "docker-volume",
80
+ HOST_PATH = "host-path"
81
+ }
82
+ /**
83
+ * The `localDataStorage` an environment gets when it authors none.
84
+ *
85
+ * Total over {@link WildoLocationType} rather than a conditional on one member, so a location type
86
+ * added to the vocabulary tomorrow is a compile error here instead of silently inheriting whichever
87
+ * branch happened to be the `else`.
88
+ */
89
+ export declare function resolveDefaultLocalDataStorage(locationType: WildoLocationType): WildoLocalDataStorage;
90
+ /**
91
+ * Ingress controller installed by Wildo's local and remote Kubernetes workflows.
92
+ * Import from `@wildo-ai/platform-config-lib`. Traefik owns both application
93
+ * routing and HTTP-01 challenge routing; selecting another controller is not
94
+ * supported by the generated installation contract.
95
+ */
96
+ export declare enum WildoKubernetesIngressClass {
97
+ TRAEFIK = "traefik"
98
+ }
34
99
  /**
35
100
  * K8s-internal cluster topology. Holds ONLY values that are genuinely
36
- * specific to a Kubernetes deployment (the namespace and the optional
37
- * ingress class).
101
+ * specific to a Kubernetes deployment: namespace, ingress class and
102
+ * per-service workload replica counts.
38
103
  *
39
104
  * The external/public hostname (where browsers and reverse proxies hit
40
105
  * us) is NOT here — it lives at the top level of `WildoInfraEnvConfig`
@@ -45,7 +110,10 @@ export declare function isLocalEnvironmentId(environmentId: string): boolean;
45
110
  */
46
111
  export declare const WildoKubernetesConfigSchema: z.ZodObject<{
47
112
  namespace: z.ZodString;
48
- ingressClass: z.ZodOptional<z.ZodString>;
113
+ services: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
114
+ replicas: z.ZodOptional<z.ZodNumber>;
115
+ }, z.core.$strict>>>;
116
+ ingressClass: z.ZodOptional<z.ZodLiteral<"traefik">>;
49
117
  }, z.core.$strip>;
50
118
  export type WildoKubernetesConfig = z.infer<typeof WildoKubernetesConfigSchema>;
51
119
  /**
@@ -148,10 +216,79 @@ export declare const WildoProviderSelectionOverridesSchema: z.ZodRecord<z.ZodEnu
148
216
  whenUnavailable: z.ZodOptional<z.ZodArray<z.ZodString>>;
149
217
  }, z.core.$strict>>;
150
218
  export type WildoProviderSelectionOverrides = z.infer<typeof WildoProviderSelectionOverridesSchema>;
219
+ /**
220
+ * Per-environment provider CONFIGURATION values — the half of `providerConfigurations` that exists once per
221
+ * DEPLOYMENT rather than once per application.
222
+ *
223
+ * `wildo.saas.config.ts > providerConfigurations` is authored once and reaches every environment. That is right for
224
+ * application POLICY a provider reads (an agent execution profile, which environments it may run in). It is wrong
225
+ * for an IDENTITY the vendor issued against one deployment: an OAuth client ID registered with the authorized
226
+ * redirect URIs of one environment, a frontend SDK DSN or site key, a picker `appId`. Authored in the SaaS config, the
227
+ * local development Google client — whose only redirect URI is `localhost` — would be the client staging and
228
+ * production send users to.
229
+ *
230
+ * This block carries those values for ONE environment, in exactly the SaaS block's
231
+ * `providerRef → protocolKind → key` shape, and {@link overlayEnvironmentProviderConfigurations} lays it over the
232
+ * SaaS block KEY BY KEY. An environment therefore states only what differs and inherits the rest, so the policy half
233
+ * is never restated per environment.
234
+ *
235
+ * It reaches both places a provider configuration is read, because the CLI applies the overlay where it knows the
236
+ * environment: the managed declaration each environment's apps-manager stores (backend readers — the OAuth2
237
+ * connection resolver, email/SMS senders, the provider registry) and the provider runtime artifacts a build bakes in
238
+ * (frontend `publicConfig`, the backend's generated provider module).
239
+ *
240
+ * NOT for secrets. This file is committed; a client secret, API key or signing secret stays in
241
+ * `secrets.json → providerEnv`. The CLI refuses a key named like one of the provider's declared secrets.
242
+ */
243
+ export declare const WildoEnvironmentProviderConfigurationsSchema: z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
244
+ export type WildoEnvironmentProviderConfigurations = z.infer<typeof WildoEnvironmentProviderConfigurationsSchema>;
245
+ /**
246
+ * The provider configuration ONE environment runs with: the application-level `providerConfigurations`, with the
247
+ * environment's {@link WildoEnvironmentProviderConfigurationsSchema} values laid over it key by key.
248
+ *
249
+ * Precedence is per key inside one `providerRef → protocolKind` bag, and the environment wins — the more specific
250
+ * layer, as `secrets.json → providerEnv` wins over `observability.llmObservability.providerEnv`. A bag the
251
+ * environment does not mention is carried unchanged; a bag only the environment declares is added. Neither input is
252
+ * mutated.
253
+ *
254
+ * Rejected: replacing a whole provider or protocol bag. That would force an environment to restate every
255
+ * environment-invariant key it shares with the application (an agent execution profile beside a client ID), and a
256
+ * restated copy is one that drifts from the original.
257
+ *
258
+ * Throws when the application layer holds a non-object at a protocol key the environment overlays: there is no key
259
+ * to lay a value over, and silently replacing it would discard the application's value without saying so.
260
+ */
261
+ export declare function overlayEnvironmentProviderConfigurations(applicationProviderConfigurations: Readonly<Record<string, Readonly<Record<string, unknown>> | undefined>> | undefined, environmentProviderConfigurations: WildoEnvironmentProviderConfigurations | undefined): Record<string, Record<string, unknown> | undefined>;
151
262
  export declare enum DatabaseEngine {
152
263
  MONGODB = "mongodb",
153
264
  POSTGRESQL = "postgresql"
154
265
  }
266
+ /**
267
+ * The store an APPLICATION persists to when its environment authors no `applicationDatabase`.
268
+ *
269
+ * PostgreSQL — decided by Paul on 2026-09-24 (#1571), reversing 75cd1934f ("absence means MongoDB")
270
+ * and restoring the rule of 2e0194c41. This is the ONLY place the answer is written. Every reader of
271
+ * an application's engine goes through {@link resolveApplicationDatabaseEngine}, because the
272
+ * 2026-09-15 incident was two readers answering silence differently: provisioning chose PostgreSQL,
273
+ * the runtime chose MongoDB, Mongo provisioning was skipped, registration reported success, and the
274
+ * application died at boot with `Command update requires authentication`.
275
+ *
276
+ * Distinct from the PLATFORM's own store (`database` in the infra config) and from the engine's
277
+ * `DEFAULT_PERSISTENCE_ADAPTER` / `DATABASE_DEFAULT_ADAPTER` env default, which also governs
278
+ * platform services and is not what this decides. The application never falls through to that env
279
+ * default: the CLI writes the resolved adapter explicitly.
280
+ */
281
+ export declare const DEFAULT_APPLICATION_DATABASE_ENGINE: DatabaseEngine;
282
+ /**
283
+ * The engine an application persists to: its authored `applicationDatabase.engine`, or
284
+ * {@link DEFAULT_APPLICATION_DATABASE_ENGINE} when the environment authors none.
285
+ *
286
+ * Takes the declaration rather than a whole config so every carrier of it — the parsed infra config,
287
+ * `config.json`, a bootstrap request — answers through the same function.
288
+ */
289
+ export declare function resolveApplicationDatabaseEngine(applicationDatabase: {
290
+ readonly engine?: DatabaseEngine;
291
+ } | undefined): DatabaseEngine;
155
292
  export declare enum WildoImageTagStrategy {
156
293
  COMMIT_SHA = "commit-sha",
157
294
  BRANCH_NAME = "branch-name",
@@ -164,33 +301,36 @@ export declare const DockerComposeDeploymentSchema: z.ZodObject<{
164
301
  branch: z.ZodString;
165
302
  runtime: z.ZodLiteral<WildoDeploymentRuntime.DOCKER_COMPOSE>;
166
303
  imageTagStrategy: z.ZodDefault<z.ZodEnum<typeof WildoImageTagStrategy>>;
167
- }, z.core.$strip>;
304
+ }, z.core.$strict>;
168
305
  /**
169
- * Kubernetes deployment — includes registry, namespace, and scaling support.
306
+ * Kubernetes deployment — branch, namespace and tagging.
307
+ *
308
+ * No `registry`: an environment's images live at `remoteProvider.registryEndpoint`, the registry every deploy
309
+ * manifest pulls from and the deploy workflow pushes to. A separate field here could only repeat that value or
310
+ * contradict it — and it did contradict it, sending CI pushes to GHCR while the cluster pulled from the endpoint
311
+ * (#1165). Both deployment shapes are strict, so a leftover `registry` is refused rather than silently ignored.
170
312
  */
171
313
  export declare const KubernetesDeploymentSchema: z.ZodObject<{
172
314
  branch: z.ZodString;
173
315
  runtime: z.ZodLiteral<WildoDeploymentRuntime.KUBERNETES>;
174
- registry: z.ZodOptional<z.ZodString>;
175
316
  namespace: z.ZodOptional<z.ZodString>;
176
317
  imageTagStrategy: z.ZodDefault<z.ZodEnum<typeof WildoImageTagStrategy>>;
177
- }, z.core.$strip>;
318
+ }, z.core.$strict>;
178
319
  /**
179
320
  * Deployment configuration for CI/CD pipeline integration.
180
- * Discriminated on `runtime`: K8s-specific fields (`registry`, `namespace`)
181
- * are only available when `runtime` is `KUBERNETES`.
321
+ * Discriminated on `runtime`: the K8s-specific field (`namespace`)
322
+ * is only available when `runtime` is `KUBERNETES`.
182
323
  */
183
324
  export declare const WildoDeploymentConfigSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
184
325
  branch: z.ZodString;
185
326
  runtime: z.ZodLiteral<WildoDeploymentRuntime.DOCKER_COMPOSE>;
186
327
  imageTagStrategy: z.ZodDefault<z.ZodEnum<typeof WildoImageTagStrategy>>;
187
- }, z.core.$strip>, z.ZodObject<{
328
+ }, z.core.$strict>, z.ZodObject<{
188
329
  branch: z.ZodString;
189
330
  runtime: z.ZodLiteral<WildoDeploymentRuntime.KUBERNETES>;
190
- registry: z.ZodOptional<z.ZodString>;
191
331
  namespace: z.ZodOptional<z.ZodString>;
192
332
  imageTagStrategy: z.ZodDefault<z.ZodEnum<typeof WildoImageTagStrategy>>;
193
- }, z.core.$strip>], "runtime">;
333
+ }, z.core.$strict>], "runtime">;
194
334
  export type WildoDeploymentConfig = z.infer<typeof WildoDeploymentConfigSchema>;
195
335
  /** @wildo_source:part:end platform.config.environment.deployment */
196
336
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"environment.schemas.d.ts","sourceRoot":"","sources":["../../../../src/project-config/shared/environment.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;;;;GAQG;AACH,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED,eAAO,MAAM,wBAAwB,aAMlC,CAAC;AACJ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,oBAAY,sBAAsB;IAChC,cAAc,mBAAmB;IACjC,UAAU,eAAe;CAC1B;AAED,oBAAY,iBAAiB;IAC3B,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,cAAc;IACxB,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;CAC5C;AAED,eAAO,MAAM,yBAAyB;;;;;;iBAgBpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,wBAAwB;;;;;;;;iBAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;iBAiDzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,yCAAyC;;;kBAGpD,CAAC;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;AAE5G,eAAO,MAAM,qCAAqC;;;mBAGjD,CAAC;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED,oBAAY,qBAAqB;IAC/B,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;iBAIxC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;;iBAMrC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;8BAGtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,oEAAoE;AAEpE;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,MAAM,CAYR;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,kCAAkC;;;;iBAgB7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC"}
1
+ {"version":3,"file":"environment.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/project-config/shared/environment.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD;;;;;;;;GAQG;AACH,oBAAY,gBAAgB;IAC1B,KAAK,UAAU;IACf,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED,eAAO,MAAM,wBAAwB,aAMlC,CAAC;AACJ,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;GAKG;AACH,oBAAY,sBAAsB;IAChC,cAAc,mBAAmB;IACjC,UAAU,eAAe;CAC1B;AAED,oBAAY,iBAAiB;IAC3B,KAAK,UAAU;IACf,MAAM,WAAW;CAClB;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,oBAAY,qBAAqB;IAC/B,aAAa,kBAAkB;IAC/B,SAAS,cAAc;CACxB;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAAC,YAAY,EAAE,iBAAiB,GAAG,qBAAqB,CAOrG;AAED;;;;;GAKG;AACH,oBAAY,2BAA2B;IACrC,OAAO,YAAY;CACpB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B;;;;;;iBAetC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF;;;;;;;;;;;;;;;GAeG;AACH,oBAAY,cAAc;IACxB,gBAAgB,qBAAqB;IACrC,mBAAmB,wBAAwB;CAC5C;AAED,eAAO,MAAM,yBAAyB;;;;;;iBAgBpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,wBAAwB;;;;;;;;iBAGnC,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;iBAiDzC,CAAC;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,eAAO,MAAM,yCAAyC;;;kBAGpD,CAAC;AACH,MAAM,MAAM,mCAAmC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yCAAyC,CAAC,CAAC;AAE5G,eAAO,MAAM,qCAAqC;;;mBAGjD,CAAC;AACF,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qCAAqC,CAAC,CAAC;AAEpG;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,4CAA4C,4FAGxD,CAAC;AACF,MAAM,MAAM,sCAAsC,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4CAA4C,CAAC,CAAC;AAElH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,wCAAwC,CACtD,iCAAiC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,GAAG,SAAS,EACtH,iCAAiC,EAAE,sCAAsC,GAAG,SAAS,GACpF,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC,CAoBrD;AAED,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,UAAU,eAAe;CAC1B;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mCAAmC,EAAE,cAA0C,CAAC;AAE7F;;;;;;GAMG;AACH,wBAAgB,gCAAgC,CAAC,mBAAmB,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAA;CAAE,GAAG,SAAS,GAAG,cAAc,CAEtI;AAED,oBAAY,qBAAqB;IAC/B,UAAU,eAAe;IACzB,WAAW,gBAAgB;IAC3B,MAAM,WAAW;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,6BAA6B;;;;kBAIxC,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B;;;;;kBAKrC,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;+BAGtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAChF,oEAAoE;AAEpE;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,MAAM,CAYR;AAED,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,MAAM,GACpB,MAAM,CAER;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,kCAAkC;;;;iBAgB7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC"}