@wildo-ai/saas-specifications 1.1.1 → 1.1.3

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 (633) hide show
  1. package/dist/esm/_core/brand/brand-asset.schemas.d.ts +4 -6
  2. package/dist/esm/_core/brand/brand-asset.schemas.d.ts.map +1 -1
  3. package/dist/esm/_core/brand/brand-asset.schemas.js +4 -12
  4. package/dist/esm/_core/brand/brand-asset.schemas.js.map +1 -1
  5. package/dist/esm/_core/brand/brand-generation.schemas.d.ts +5 -3
  6. package/dist/esm/_core/brand/brand-generation.schemas.d.ts.map +1 -1
  7. package/dist/esm/_core/brand/brand-generation.schemas.js +5 -2
  8. package/dist/esm/_core/brand/brand-generation.schemas.js.map +1 -1
  9. package/dist/esm/_core/brand/brand-snapshot.schemas.d.ts +10 -3
  10. package/dist/esm/_core/brand/brand-snapshot.schemas.d.ts.map +1 -1
  11. package/dist/esm/_core/brand/brand-snapshot.schemas.js +10 -2
  12. package/dist/esm/_core/brand/brand-snapshot.schemas.js.map +1 -1
  13. package/dist/esm/_core/brand/brand.family-aspects.d.ts +3 -0
  14. package/dist/esm/_core/brand/brand.family-aspects.d.ts.map +1 -0
  15. package/dist/esm/_core/brand/brand.family-aspects.js +51 -0
  16. package/dist/esm/_core/brand/brand.family-aspects.js.map +1 -0
  17. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts.map +1 -1
  18. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.js +15 -5
  19. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.js.map +1 -1
  20. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts +40 -3
  21. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts.map +1 -1
  22. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js +85 -6
  23. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js.map +1 -1
  24. package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts +3 -0
  25. package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts.map +1 -0
  26. package/dist/esm/_core/build-plan/build-plan.family-aspects.js +28 -0
  27. package/dist/esm/_core/build-plan/build-plan.family-aspects.js.map +1 -0
  28. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.d.ts.map +1 -1
  29. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js +10 -4
  30. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js.map +1 -1
  31. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts +15 -0
  32. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts.map +1 -1
  33. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.js.map +1 -1
  34. package/dist/esm/_core/business-model-lite/business-model.family-aspects.d.ts +3 -0
  35. package/dist/esm/_core/business-model-lite/business-model.family-aspects.d.ts.map +1 -0
  36. package/dist/esm/_core/business-model-lite/business-model.family-aspects.js +21 -0
  37. package/dist/esm/_core/business-model-lite/business-model.family-aspects.js.map +1 -0
  38. package/dist/esm/_core/chart-view-specification.schemas.d.ts +11 -0
  39. package/dist/esm/_core/chart-view-specification.schemas.d.ts.map +1 -1
  40. package/dist/esm/_core/chart-view-specification.schemas.js.map +1 -1
  41. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts +85 -0
  42. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts.map +1 -1
  43. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.js +41 -0
  44. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.js.map +1 -1
  45. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts +178 -2
  46. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts.map +1 -1
  47. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js +115 -9
  48. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js.map +1 -1
  49. package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.d.ts +12 -0
  50. package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.d.ts.map +1 -0
  51. package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.js +47 -0
  52. package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.js.map +1 -0
  53. package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.d.ts.map +1 -1
  54. package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.js +8 -3
  55. package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.js.map +1 -1
  56. package/dist/esm/_core/compliance-documents/processor-register.family-aspects.d.ts +21 -0
  57. package/dist/esm/_core/compliance-documents/processor-register.family-aspects.d.ts.map +1 -0
  58. package/dist/esm/_core/compliance-documents/processor-register.family-aspects.js +40 -0
  59. package/dist/esm/_core/compliance-documents/processor-register.family-aspects.js.map +1 -0
  60. package/dist/esm/_core/composite-view-specification.schemas.d.ts +11 -0
  61. package/dist/esm/_core/composite-view-specification.schemas.d.ts.map +1 -1
  62. package/dist/esm/_core/composite-view-specification.schemas.js.map +1 -1
  63. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts +3 -0
  64. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -0
  65. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js +32 -0
  66. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js.map +1 -0
  67. package/dist/esm/_core/execution-view-specification.schemas.d.ts +11 -0
  68. package/dist/esm/_core/execution-view-specification.schemas.d.ts.map +1 -1
  69. package/dist/esm/_core/execution-view-specification.schemas.js.map +1 -1
  70. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts +6 -7
  71. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts.map +1 -1
  72. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js +6 -13
  73. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js.map +1 -1
  74. package/dist/esm/_core/expert-personas/expert-persona-validation.d.ts +0 -11
  75. package/dist/esm/_core/expert-personas/expert-persona-validation.d.ts.map +1 -1
  76. package/dist/esm/_core/expert-personas/expert-persona-validation.js +0 -19
  77. package/dist/esm/_core/expert-personas/expert-persona-validation.js.map +1 -1
  78. package/dist/esm/_core/expert-personas/expert-role-template.schemas.d.ts +1 -2
  79. package/dist/esm/_core/expert-personas/expert-role-template.schemas.d.ts.map +1 -1
  80. package/dist/esm/_core/expert-personas/expert-role-template.schemas.js +1 -2
  81. package/dist/esm/_core/expert-personas/expert-role-template.schemas.js.map +1 -1
  82. package/dist/esm/_core/family-aspects.registry.d.ts +18 -0
  83. package/dist/esm/_core/family-aspects.registry.d.ts.map +1 -0
  84. package/dist/esm/_core/family-aspects.registry.js +60 -0
  85. package/dist/esm/_core/family-aspects.registry.js.map +1 -0
  86. package/dist/esm/_core/family-aspects.schemas.d.ts +122 -0
  87. package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -0
  88. package/dist/esm/_core/family-aspects.schemas.js +15 -0
  89. package/dist/esm/_core/family-aspects.schemas.js.map +1 -0
  90. package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +11 -11
  91. package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.d.ts +3 -0
  92. package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.d.ts.map +1 -0
  93. package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.js +25 -0
  94. package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.js.map +1 -0
  95. package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.d.ts.map +1 -1
  96. package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.js +17 -4
  97. package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.js.map +1 -1
  98. package/dist/esm/_core/flows-actors-view-specification.schemas.d.ts +11 -0
  99. package/dist/esm/_core/flows-actors-view-specification.schemas.d.ts.map +1 -1
  100. package/dist/esm/_core/flows-actors-view-specification.schemas.js.map +1 -1
  101. package/dist/esm/_core/frontend-component-specification.schemas.d.ts.map +1 -1
  102. package/dist/esm/_core/frontend-component-specification.schemas.js +19 -1
  103. package/dist/esm/_core/frontend-component-specification.schemas.js.map +1 -1
  104. package/dist/esm/_core/full-custom-view-specification.schemas.d.ts +11 -0
  105. package/dist/esm/_core/full-custom-view-specification.schemas.d.ts.map +1 -1
  106. package/dist/esm/_core/full-custom-view-specification.schemas.js.map +1 -1
  107. package/dist/esm/_core/guidance-flow-specification.schemas.d.ts +11 -0
  108. package/dist/esm/_core/guidance-flow-specification.schemas.d.ts.map +1 -1
  109. package/dist/esm/_core/guidance-flow-specification.schemas.js +14 -0
  110. package/dist/esm/_core/guidance-flow-specification.schemas.js.map +1 -1
  111. package/dist/esm/_core/index.d.ts +3 -0
  112. package/dist/esm/_core/index.d.ts.map +1 -1
  113. package/dist/esm/_core/index.js +3 -0
  114. package/dist/esm/_core/index.js.map +1 -1
  115. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +22 -22
  116. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts.map +1 -1
  117. package/dist/esm/_core/market/market-snapshot-generation.schemas.js +5 -40
  118. package/dist/esm/_core/market/market-snapshot-generation.schemas.js.map +1 -1
  119. package/dist/esm/_core/market/market-snapshot-validation.d.ts +15 -0
  120. package/dist/esm/_core/market/market-snapshot-validation.d.ts.map +1 -1
  121. package/dist/esm/_core/market/market-snapshot-validation.js.map +1 -1
  122. package/dist/esm/_core/market/market.family-aspects.d.ts +9 -0
  123. package/dist/esm/_core/market/market.family-aspects.d.ts.map +1 -0
  124. package/dist/esm/_core/market/market.family-aspects.js +227 -0
  125. package/dist/esm/_core/market/market.family-aspects.js.map +1 -0
  126. package/dist/esm/_core/onboarding-view-specification.schemas.d.ts +11 -0
  127. package/dist/esm/_core/onboarding-view-specification.schemas.d.ts.map +1 -1
  128. package/dist/esm/_core/onboarding-view-specification.schemas.js +14 -0
  129. package/dist/esm/_core/onboarding-view-specification.schemas.js.map +1 -1
  130. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.d.ts.map +1 -1
  131. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js +11 -5
  132. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js.map +1 -1
  133. package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts +66 -9
  134. package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts.map +1 -1
  135. package/dist/esm/_core/placement-plan/placement-plan-validation.js +62 -20
  136. package/dist/esm/_core/placement-plan/placement-plan-validation.js.map +1 -1
  137. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.d.ts +3 -0
  138. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.d.ts.map +1 -0
  139. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.js +31 -0
  140. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.js.map +1 -0
  141. package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts +4 -1
  142. package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
  143. package/dist/esm/_core/placement-plan/placement-plan.schemas.js +4 -1
  144. package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
  145. package/dist/esm/_core/provider-specification.schemas.d.ts +82 -0
  146. package/dist/esm/_core/provider-specification.schemas.d.ts.map +1 -0
  147. package/dist/esm/_core/provider-specification.schemas.js +144 -0
  148. package/dist/esm/_core/provider-specification.schemas.js.map +1 -0
  149. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.d.ts.map +1 -1
  150. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js +13 -8
  151. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js.map +1 -1
  152. package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts +15 -0
  153. package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts.map +1 -1
  154. package/dist/esm/_core/requirements/requirements-snapshot-validation.js.map +1 -1
  155. package/dist/esm/_core/requirements/requirements.family-aspects.d.ts +9 -0
  156. package/dist/esm/_core/requirements/requirements.family-aspects.d.ts.map +1 -0
  157. package/dist/esm/_core/requirements/requirements.family-aspects.js +40 -0
  158. package/dist/esm/_core/requirements/requirements.family-aspects.js.map +1 -0
  159. package/dist/esm/_core/resource-specification.schemas.d.ts +22 -0
  160. package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
  161. package/dist/esm/_core/resource-specification.schemas.js.map +1 -1
  162. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.d.ts.map +1 -1
  163. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js +7 -2
  164. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js.map +1 -1
  165. package/dist/esm/_core/roadmap/roadmap-snapshot-validation.d.ts +15 -0
  166. package/dist/esm/_core/roadmap/roadmap-snapshot-validation.d.ts.map +1 -1
  167. package/dist/esm/_core/roadmap/roadmap-snapshot-validation.js.map +1 -1
  168. package/dist/esm/_core/roadmap/roadmap.family-aspects.d.ts +3 -0
  169. package/dist/esm/_core/roadmap/roadmap.family-aspects.d.ts.map +1 -0
  170. package/dist/esm/_core/roadmap/roadmap.family-aspects.js +26 -0
  171. package/dist/esm/_core/roadmap/roadmap.family-aspects.js.map +1 -0
  172. package/dist/esm/_core/utils/family-ref-stamping.d.ts +64 -0
  173. package/dist/esm/_core/utils/family-ref-stamping.d.ts.map +1 -0
  174. package/dist/esm/_core/utils/family-ref-stamping.js +73 -0
  175. package/dist/esm/_core/utils/family-ref-stamping.js.map +1 -0
  176. package/dist/esm/_core/vision/vision-snapshot-generation.schemas.d.ts.map +1 -1
  177. package/dist/esm/_core/vision/vision-snapshot-generation.schemas.js +23 -9
  178. package/dist/esm/_core/vision/vision-snapshot-generation.schemas.js.map +1 -1
  179. package/dist/esm/_core/vision/vision.family-aspects.d.ts +11 -0
  180. package/dist/esm/_core/vision/vision.family-aspects.d.ts.map +1 -0
  181. package/dist/esm/_core/vision/vision.family-aspects.js +63 -0
  182. package/dist/esm/_core/vision/vision.family-aspects.js.map +1 -0
  183. package/dist/esm/application-creation/application-coding-tasks.application-creation.schemas.d.ts +0 -4
  184. package/dist/esm/application-creation/application-coding-tasks.application-creation.schemas.d.ts.map +1 -1
  185. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +193 -38
  186. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
  187. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +157 -57
  188. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
  189. package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.d.ts +3 -3
  190. package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js +3 -3
  191. package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js.map +1 -1
  192. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts +38 -4
  193. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts.map +1 -1
  194. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js +37 -3
  195. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js.map +1 -1
  196. package/dist/esm/application-creation/document-facts.family-aspects.d.ts +12 -0
  197. package/dist/esm/application-creation/document-facts.family-aspects.d.ts.map +1 -0
  198. package/dist/esm/application-creation/document-facts.family-aspects.js +37 -0
  199. package/dist/esm/application-creation/document-facts.family-aspects.js.map +1 -0
  200. package/dist/esm/application-creation/document-release-policy.family-aspects.d.ts +3 -0
  201. package/dist/esm/application-creation/document-release-policy.family-aspects.d.ts.map +1 -0
  202. package/dist/esm/application-creation/document-release-policy.family-aspects.js +23 -0
  203. package/dist/esm/application-creation/document-release-policy.family-aspects.js.map +1 -0
  204. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts +18 -6
  205. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
  206. package/dist/esm/application-creation/journey.application-creation.schemas.js +18 -6
  207. package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
  208. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +101 -85
  209. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
  210. package/dist/esm/application-creation/playbooks.application-creation.schemas.js +171 -86
  211. package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
  212. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts +2 -0
  213. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts.map +1 -1
  214. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.js +2 -0
  215. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.js.map +1 -1
  216. package/dist/esm/application-creation.exports.d.ts +11 -0
  217. package/dist/esm/application-creation.exports.d.ts.map +1 -1
  218. package/dist/esm/application-creation.exports.js +11 -0
  219. package/dist/esm/application-creation.exports.js.map +1 -1
  220. package/dist/esm/assurance/application-document-publication.schemas.d.ts +20 -6
  221. package/dist/esm/assurance/application-document-publication.schemas.d.ts.map +1 -1
  222. package/dist/esm/assurance/application-document-publication.schemas.js +26 -10
  223. package/dist/esm/assurance/application-document-publication.schemas.js.map +1 -1
  224. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +999 -2
  225. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
  226. package/dist/esm/assurance/assurance-authority-basis.definitions.js +2127 -61
  227. package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
  228. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +26 -0
  229. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
  230. package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
  231. package/dist/esm/assurance/assurance-document-system.definitions.js +18 -3
  232. package/dist/esm/assurance/assurance-document-system.definitions.js.map +1 -1
  233. package/dist/esm/assurance/assurance-document-system.schemas.d.ts +32 -2
  234. package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
  235. package/dist/esm/assurance/assurance-document-system.schemas.js +32 -2
  236. package/dist/esm/assurance/assurance-document-system.schemas.js.map +1 -1
  237. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts +36 -0
  238. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts.map +1 -0
  239. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js +859 -0
  240. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -0
  241. package/dist/esm/assurance/assurance-external-framework-mapping.d.ts +90 -0
  242. package/dist/esm/assurance/assurance-external-framework-mapping.d.ts.map +1 -0
  243. package/dist/esm/assurance/assurance-external-framework-mapping.js +134 -0
  244. package/dist/esm/assurance/assurance-external-framework-mapping.js.map +1 -0
  245. package/dist/esm/assurance/assurance-foundation.schemas.d.ts +43 -0
  246. package/dist/esm/assurance/assurance-foundation.schemas.d.ts.map +1 -1
  247. package/dist/esm/assurance/assurance-foundation.schemas.js +56 -0
  248. package/dist/esm/assurance/assurance-foundation.schemas.js.map +1 -1
  249. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts +78 -1
  250. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
  251. package/dist/esm/assurance/assurance-objective-catalog.definitions.js +562 -5
  252. package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
  253. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +148 -0
  254. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -0
  255. package/dist/esm/assurance/assurance-program-generation.schemas.js +385 -0
  256. package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -0
  257. package/dist/esm/assurance/assurance-program.family-aspects.d.ts +13 -0
  258. package/dist/esm/assurance/assurance-program.family-aspects.d.ts.map +1 -0
  259. package/dist/esm/assurance/assurance-program.family-aspects.js +16 -0
  260. package/dist/esm/assurance/assurance-program.family-aspects.js.map +1 -0
  261. package/dist/esm/assurance/assurance-program.schemas.d.ts +474 -14
  262. package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
  263. package/dist/esm/assurance/assurance-program.schemas.js +319 -8
  264. package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
  265. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts +1 -0
  266. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
  267. package/dist/esm/assurance/assurance-source-registry.definitions.js +12 -0
  268. package/dist/esm/assurance/assurance-source-registry.definitions.js.map +1 -1
  269. package/dist/esm/assurance/assurance-sources.schemas.d.ts +76 -0
  270. package/dist/esm/assurance/assurance-sources.schemas.d.ts.map +1 -1
  271. package/dist/esm/assurance/assurance-sources.schemas.js +59 -0
  272. package/dist/esm/assurance/assurance-sources.schemas.js.map +1 -1
  273. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts +35 -0
  274. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts.map +1 -0
  275. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js +999 -0
  276. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -0
  277. package/dist/esm/assurance/document-publication.family-aspects.d.ts +29 -0
  278. package/dist/esm/assurance/document-publication.family-aspects.d.ts.map +1 -0
  279. package/dist/esm/assurance/document-publication.family-aspects.js +48 -0
  280. package/dist/esm/assurance/document-publication.family-aspects.js.map +1 -0
  281. package/dist/esm/assurance.exports.d.ts +2 -0
  282. package/dist/esm/assurance.exports.d.ts.map +1 -1
  283. package/dist/esm/assurance.exports.js +2 -0
  284. package/dist/esm/assurance.exports.js.map +1 -1
  285. package/dist/esm/companion-exports.d.ts +26 -8
  286. package/dist/esm/companion-exports.d.ts.map +1 -1
  287. package/dist/esm/companion-exports.js.map +1 -1
  288. package/dist/esm/engine/_bootstrap.js +3 -1
  289. package/dist/esm/engine/_bootstrap.js.map +1 -1
  290. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
  291. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +15 -1
  292. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
  293. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map +1 -1
  294. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +4 -2
  295. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
  296. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts +2 -0
  297. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
  298. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +17 -3
  299. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
  300. package/dist/esm/engine/applications/resources/application-versions.resource.specification.d.ts.map +1 -1
  301. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +12 -10
  302. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
  303. package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts.map +1 -1
  304. package/dist/esm/engine/applications/resources/applications.resource.specification.js +4 -2
  305. package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
  306. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.d.ts +36 -0
  307. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.d.ts.map +1 -0
  308. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js +193 -0
  309. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js.map +1 -0
  310. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts +1 -1
  311. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts.map +1 -1
  312. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +3 -1
  313. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
  314. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
  315. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +15 -1
  316. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
  317. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts +2 -0
  318. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
  319. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +17 -3
  320. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
  321. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts +32 -0
  322. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -0
  323. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js +308 -0
  324. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -0
  325. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts +1 -1
  326. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts.map +1 -1
  327. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +6 -4
  328. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
  329. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts.map +1 -1
  330. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +4 -2
  331. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
  332. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts.map +1 -1
  333. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +8 -6
  334. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
  335. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.d.ts.map +1 -1
  336. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +11 -9
  337. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
  338. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.d.ts.map +1 -1
  339. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js +8 -6
  340. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js.map +1 -1
  341. package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts +9 -25
  342. package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
  343. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +106 -10
  344. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
  345. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts +0 -6
  346. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
  347. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js +2 -0
  348. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js.map +1 -1
  349. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts +32 -0
  350. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts.map +1 -0
  351. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js +297 -0
  352. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js.map +1 -0
  353. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts +2 -2
  354. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
  355. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +6 -3
  356. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
  357. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts +8 -8
  358. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts.map +1 -1
  359. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js +4 -2
  360. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
  361. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts +2 -2
  362. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts.map +1 -1
  363. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +5 -3
  364. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
  365. package/dist/esm/engine/billing/resources/prices.resource.specification.d.ts.map +1 -1
  366. package/dist/esm/engine/billing/resources/prices.resource.specification.js +10 -8
  367. package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
  368. package/dist/esm/engine/billing/resources/products.resource.specification.d.ts.map +1 -1
  369. package/dist/esm/engine/billing/resources/products.resource.specification.js +10 -8
  370. package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
  371. package/dist/esm/engine/billing/resources/promotions.resource.specification.d.ts.map +1 -1
  372. package/dist/esm/engine/billing/resources/promotions.resource.specification.js +16 -12
  373. package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
  374. package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts.map +1 -1
  375. package/dist/esm/engine/billing/resources/referrals.resource.specification.js +10 -8
  376. package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
  377. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts +6 -6
  378. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
  379. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +8 -3
  380. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
  381. package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts +13 -9
  382. package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts.map +1 -1
  383. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +30 -11
  384. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
  385. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts.map +1 -1
  386. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +10 -8
  387. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
  388. package/dist/esm/engine/engine-resource-specifications.registry.d.ts +2 -2
  389. package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
  390. package/dist/esm/engine/engine-resource-specifications.registry.js +11 -2
  391. package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
  392. package/dist/esm/engine/engine-resource-sub-domain.d.ts +83 -0
  393. package/dist/esm/engine/engine-resource-sub-domain.d.ts.map +1 -0
  394. package/dist/esm/engine/engine-resource-sub-domain.js +153 -0
  395. package/dist/esm/engine/engine-resource-sub-domain.js.map +1 -0
  396. package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
  397. package/dist/esm/engine/errors/error-messages.specification.js +44 -1
  398. package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
  399. package/dist/esm/engine/features/audit-logs.feature.specification.js +4 -4
  400. package/dist/esm/engine/features/audit-logs.feature.specification.js.map +1 -1
  401. package/dist/esm/engine/features/core-limits.feature.specifications.js +7 -7
  402. package/dist/esm/engine/features/core-limits.feature.specifications.js.map +1 -1
  403. package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts.map +1 -1
  404. package/dist/esm/engine/features/resources/application-features.resource.specification.js +5 -3
  405. package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
  406. package/dist/esm/engine/features/resources/organization-features.resource.specification.d.ts.map +1 -1
  407. package/dist/esm/engine/features/resources/organization-features.resource.specification.js +5 -3
  408. package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
  409. package/dist/esm/engine/features/resources/user-features.resource.specification.d.ts +1 -1
  410. package/dist/esm/engine/features/resources/user-features.resource.specification.d.ts.map +1 -1
  411. package/dist/esm/engine/features/resources/user-features.resource.specification.js +5 -3
  412. package/dist/esm/engine/features/resources/user-features.resource.specification.js.map +1 -1
  413. package/dist/esm/engine/files/resources/files.resource.specification.d.ts.map +1 -1
  414. package/dist/esm/engine/files/resources/files.resource.specification.js +12 -10
  415. package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
  416. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts +3 -3
  417. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map +1 -1
  418. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js +22 -10
  419. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
  420. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.d.ts +3 -3
  421. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.d.ts.map +1 -1
  422. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +6 -4
  423. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
  424. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts +3 -3
  425. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map +1 -1
  426. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +4 -2
  427. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
  428. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts +3 -3
  429. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
  430. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js +3 -1
  431. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js.map +1 -1
  432. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts +5 -0
  433. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts.map +1 -0
  434. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js +81 -0
  435. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js.map +1 -0
  436. package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.d.ts +4 -0
  437. package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.d.ts.map +1 -0
  438. package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.js +22 -0
  439. package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.js.map +1 -0
  440. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.d.ts.map +1 -1
  441. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.js +8 -3
  442. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.js.map +1 -1
  443. package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.d.ts +0 -4
  444. package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.d.ts.map +0 -1
  445. package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.js +0 -21
  446. package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.js.map +0 -1
  447. package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.d.ts +0 -4
  448. package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.d.ts.map +0 -1
  449. package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.js +0 -21
  450. package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.js.map +0 -1
  451. package/dist/esm/engine/frontend-components/index.d.ts +0 -2
  452. package/dist/esm/engine/frontend-components/index.d.ts.map +1 -1
  453. package/dist/esm/engine/frontend-components/index.js +4 -6
  454. package/dist/esm/engine/frontend-components/index.js.map +1 -1
  455. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.d.ts +1 -1
  456. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.d.ts.map +1 -1
  457. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js +15 -12
  458. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js.map +1 -1
  459. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts +1 -1
  460. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts.map +1 -1
  461. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js +12 -9
  462. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js.map +1 -1
  463. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts +9 -1
  464. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts.map +1 -1
  465. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js +9 -6
  466. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
  467. package/dist/esm/engine/index.d.ts +2 -0
  468. package/dist/esm/engine/index.d.ts.map +1 -1
  469. package/dist/esm/engine/index.js +2 -0
  470. package/dist/esm/engine/index.js.map +1 -1
  471. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.d.ts.map +1 -1
  472. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +19 -17
  473. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
  474. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.d.ts.map +1 -1
  475. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +9 -7
  476. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
  477. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts.map +1 -1
  478. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js +10 -8
  479. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js.map +1 -1
  480. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts +7 -2
  481. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts.map +1 -1
  482. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +12 -5
  483. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
  484. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
  485. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +22 -15
  486. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
  487. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts +1 -1
  488. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts.map +1 -1
  489. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js +14 -10
  490. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js.map +1 -1
  491. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
  492. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +31 -6
  493. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
  494. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts +1 -1
  495. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts.map +1 -1
  496. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +11 -9
  497. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
  498. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.d.ts.map +1 -1
  499. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js +5 -3
  500. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js.map +1 -1
  501. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.d.ts.map +1 -1
  502. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js +6 -4
  503. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js.map +1 -1
  504. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts.map +1 -1
  505. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +4 -2
  506. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
  507. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts.map +1 -1
  508. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +3 -1
  509. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
  510. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.d.ts.map +1 -1
  511. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js +2 -0
  512. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js.map +1 -1
  513. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts.map +1 -1
  514. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +9 -7
  515. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
  516. package/dist/esm/engine/providers/_engine-provider-shared.d.ts +9 -0
  517. package/dist/esm/engine/providers/_engine-provider-shared.d.ts.map +1 -0
  518. package/dist/esm/engine/providers/_engine-provider-shared.js +19 -0
  519. package/dist/esm/engine/providers/_engine-provider-shared.js.map +1 -0
  520. package/dist/esm/engine/providers/anthropic.provider.specification.d.ts +7 -0
  521. package/dist/esm/engine/providers/anthropic.provider.specification.d.ts.map +1 -0
  522. package/dist/esm/engine/providers/anthropic.provider.specification.js +33 -0
  523. package/dist/esm/engine/providers/anthropic.provider.specification.js.map +1 -0
  524. package/dist/esm/engine/providers/apple.provider.specification.d.ts +7 -0
  525. package/dist/esm/engine/providers/apple.provider.specification.d.ts.map +1 -0
  526. package/dist/esm/engine/providers/apple.provider.specification.js +35 -0
  527. package/dist/esm/engine/providers/apple.provider.specification.js.map +1 -0
  528. package/dist/esm/engine/providers/email-preview.provider.specification.d.ts +7 -0
  529. package/dist/esm/engine/providers/email-preview.provider.specification.d.ts.map +1 -0
  530. package/dist/esm/engine/providers/email-preview.provider.specification.js +31 -0
  531. package/dist/esm/engine/providers/email-preview.provider.specification.js.map +1 -0
  532. package/dist/esm/engine/providers/github.provider.specification.d.ts +7 -0
  533. package/dist/esm/engine/providers/github.provider.specification.d.ts.map +1 -0
  534. package/dist/esm/engine/providers/github.provider.specification.js +30 -0
  535. package/dist/esm/engine/providers/github.provider.specification.js.map +1 -0
  536. package/dist/esm/engine/providers/google.provider.specification.d.ts +7 -0
  537. package/dist/esm/engine/providers/google.provider.specification.d.ts.map +1 -0
  538. package/dist/esm/engine/providers/google.provider.specification.js +34 -0
  539. package/dist/esm/engine/providers/google.provider.specification.js.map +1 -0
  540. package/dist/esm/engine/providers/grok.provider.specification.d.ts +7 -0
  541. package/dist/esm/engine/providers/grok.provider.specification.d.ts.map +1 -0
  542. package/dist/esm/engine/providers/grok.provider.specification.js +30 -0
  543. package/dist/esm/engine/providers/grok.provider.specification.js.map +1 -0
  544. package/dist/esm/engine/providers/index.d.ts +23 -0
  545. package/dist/esm/engine/providers/index.d.ts.map +1 -0
  546. package/dist/esm/engine/providers/index.js +37 -0
  547. package/dist/esm/engine/providers/index.js.map +1 -0
  548. package/dist/esm/engine/providers/microsoft.provider.specification.d.ts +7 -0
  549. package/dist/esm/engine/providers/microsoft.provider.specification.d.ts.map +1 -0
  550. package/dist/esm/engine/providers/microsoft.provider.specification.js +30 -0
  551. package/dist/esm/engine/providers/microsoft.provider.specification.js.map +1 -0
  552. package/dist/esm/engine/providers/mistral.provider.specification.d.ts +7 -0
  553. package/dist/esm/engine/providers/mistral.provider.specification.d.ts.map +1 -0
  554. package/dist/esm/engine/providers/mistral.provider.specification.js +33 -0
  555. package/dist/esm/engine/providers/mistral.provider.specification.js.map +1 -0
  556. package/dist/esm/engine/providers/openai.provider.specification.d.ts +7 -0
  557. package/dist/esm/engine/providers/openai.provider.specification.d.ts.map +1 -0
  558. package/dist/esm/engine/providers/openai.provider.specification.js +43 -0
  559. package/dist/esm/engine/providers/openai.provider.specification.js.map +1 -0
  560. package/dist/esm/engine/providers/opencode.provider.specification.d.ts +7 -0
  561. package/dist/esm/engine/providers/opencode.provider.specification.d.ts.map +1 -0
  562. package/dist/esm/engine/providers/opencode.provider.specification.js +50 -0
  563. package/dist/esm/engine/providers/opencode.provider.specification.js.map +1 -0
  564. package/dist/esm/engine/providers/perplexity.provider.specification.d.ts +7 -0
  565. package/dist/esm/engine/providers/perplexity.provider.specification.d.ts.map +1 -0
  566. package/dist/esm/engine/providers/perplexity.provider.specification.js +30 -0
  567. package/dist/esm/engine/providers/perplexity.provider.specification.js.map +1 -0
  568. package/dist/esm/engine/providers/resend.provider.specification.d.ts +7 -0
  569. package/dist/esm/engine/providers/resend.provider.specification.d.ts.map +1 -0
  570. package/dist/esm/engine/providers/resend.provider.specification.js +33 -0
  571. package/dist/esm/engine/providers/resend.provider.specification.js.map +1 -0
  572. package/dist/esm/engine/providers/stripe.provider.specification.d.ts +7 -0
  573. package/dist/esm/engine/providers/stripe.provider.specification.d.ts.map +1 -0
  574. package/dist/esm/engine/providers/stripe.provider.specification.js +35 -0
  575. package/dist/esm/engine/providers/stripe.provider.specification.js.map +1 -0
  576. package/dist/esm/engine/providers/twilio.provider.specification.d.ts +7 -0
  577. package/dist/esm/engine/providers/twilio.provider.specification.d.ts.map +1 -0
  578. package/dist/esm/engine/providers/twilio.provider.specification.js +33 -0
  579. package/dist/esm/engine/providers/twilio.provider.specification.js.map +1 -0
  580. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.d.ts.map +1 -1
  581. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js +9 -7
  582. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
  583. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.d.ts +1 -1
  584. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.d.ts.map +1 -1
  585. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +11 -9
  586. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
  587. package/dist/esm/engine/users/resources/user-credentials.resource.specification.d.ts +1 -1
  588. package/dist/esm/engine/users/resources/user-credentials.resource.specification.d.ts.map +1 -1
  589. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js +4 -2
  590. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
  591. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts +1 -1
  592. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts.map +1 -1
  593. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +10 -8
  594. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
  595. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +5 -5
  596. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts.map +1 -1
  597. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +6 -4
  598. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
  599. package/dist/esm/engine/users/resources/user-profiles.resource.specification.d.ts +1 -1
  600. package/dist/esm/engine/users/resources/user-profiles.resource.specification.d.ts.map +1 -1
  601. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +4 -2
  602. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
  603. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +5 -5
  604. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
  605. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +15 -11
  606. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
  607. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.d.ts +1 -1
  608. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.d.ts.map +1 -1
  609. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js +3 -1
  610. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js.map +1 -1
  611. package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts.map +1 -1
  612. package/dist/esm/engine/users/resources/user-self.resource.specification.js +11 -9
  613. package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
  614. package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
  615. package/dist/esm/engine/users/resources/users.resource.specification.js +95 -0
  616. package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
  617. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts +5 -0
  618. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
  619. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +451 -25
  620. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
  621. package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts +37 -1
  622. package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts.map +1 -1
  623. package/dist/esm/technical-documentation/technical-documentation-units.schemas.js +37 -1
  624. package/dist/esm/technical-documentation/technical-documentation-units.schemas.js.map +1 -1
  625. package/dist/tsconfig.build.tsbuildinfo +1 -0
  626. package/package.json +8 -8
  627. package/dist/esm/.builder.pid +0 -9
  628. package/dist/esm/_core/business-coverage/coverage-findings-validation.d.ts +0 -0
  629. package/dist/esm/_core/business-coverage/coverage-findings-validation.d.ts.map +0 -0
  630. package/dist/esm/_core/business-coverage/coverage-findings-validation.js.map +0 -0
  631. package/dist/esm/_core/business-coverage/coverage-findings.schemas.d.ts +0 -0
  632. package/dist/esm/_core/business-coverage/coverage-findings.schemas.d.ts.map +0 -0
  633. package/dist/esm/_core/business-coverage/coverage-findings.schemas.js.map +0 -0
@@ -0,0 +1,297 @@
1
+ /**
2
+ * Resource: `userProviderCredentials` — Wildo SaaS engine specification
3
+ * (user-self-scoped, backend-managed secret).
4
+ *
5
+ * Inputs:
6
+ * - Schema: engine/saas-models/src/security/connected-accounts/provider-credentials.shared.schemas.ts
7
+ * → `UserProviderCredentialSchema`
8
+ * - Factory: engine/saas-models/src/security/connected-accounts/provider-credentials-user.shared.resources-config.schemas.ts
9
+ * → `userProviderCredentialsResourceConfiguration_InitializationFactory`
10
+ * - Custom operations: none
11
+ * - UI presets: `engine/presets-components/src/config/resources/security.resource-presets.tsx`
12
+ * → `USER_PROVIDER_CREDENTIALS`, reached through the `my-provider-credentials` settings destination.
13
+ */
14
+ import { LabelAudience } from '@wildo-ai/presets-components-models';
15
+ import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, } from '@wildo-ai/zod-decorators';
16
+ import { CoreResourceOperation as Op, ProviderCredentialValidationState, ResourcePrimaryScope, UserProviderCredentialSchema, userProviderCredentialsResourceConfiguration_InitializationFactory, } from '@wildo-ai/saas-models';
17
+ import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
18
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
19
+ const CREDENTIAL_EXAMPLE_ID = 'usrprovcred_01J7K2M4N6P8Q0R2S4T6V8W0XY';
20
+ const CREDENTIAL_EXAMPLE_USER_ID = 'user_01J4M1Z2X3C4V5B6N7M8Q9R0ST';
21
+ /**
22
+ * The record as a client sees it — with the value MASKED.
23
+ *
24
+ * That mask is not decoration in an example: `secretValue` is `.isWriteOnlySecret()`, so the
25
+ * framework redacts it at the client boundary on every read. Showing a plausible token here would
26
+ * teach an integrator that a credential can be read back, which is the one thing this resource
27
+ * guarantees it cannot.
28
+ */
29
+ const CREDENTIAL_RECORD_EXAMPLE = {
30
+ _id: CREDENTIAL_EXAMPLE_ID,
31
+ userId: CREDENTIAL_EXAMPLE_USER_ID,
32
+ providerRef: 'openai',
33
+ secretSlug: 'OPENAI_API_KEY',
34
+ secretValue: '••••••••',
35
+ enabled: true,
36
+ validationState: ProviderCredentialValidationState.VALID,
37
+ lastValidatedAt: '2026-09-02T11:14:00.000Z',
38
+ lastUsedAt: '2026-09-02T11:14:00.000Z',
39
+ secretSetAt: '2026-08-30T09:00:00.000Z',
40
+ description: 'My personal key, so my drafts are billed to me.',
41
+ createdAt: '2026-08-30T09:00:00.000Z',
42
+ updatedAt: '2026-09-02T11:14:00.000Z',
43
+ };
44
+ const CREDENTIAL_PAGE_EXAMPLE = {
45
+ data: [CREDENTIAL_RECORD_EXAMPLE],
46
+ pagination: { page: 1, limit: 20, total: 1, totalPages: 1 },
47
+ };
48
+ export const userProviderCredentialsResourceSpecification = resourceSpecification(userProviderCredentialsResourceConfiguration_InitializationFactory, UserProviderCredentialSchema, ({ schemaShape }) => ({
49
+ purpose: "One PERSON's OWN credential toward a third-party provider — their personal API key, the account they connected themselves.",
50
+ businessRole: "The record that lets an application act as an individual toward a third party rather than as the tenant or as itself. It is what makes a personal integration possible — work attributed to the person at the vendor, billed to their account, and carrying only the permissions they granted.",
51
+ lifecycleRole: 'Created by the holder when they connect a provider, rotated in place when they reissue the credential at the vendor, disabled to stop the application acting as them without discarding the credential, and removed when they disconnect the provider or their own account is erased.',
52
+ audience: LabelAudience.DEVELOPER,
53
+ subDomain: EngineResourceSubDomain.AUTH,
54
+ codeHandling: {
55
+ mainSchema: {
56
+ packageName: '@wildo-ai/saas-models',
57
+ exportName: 'UserProviderCredentialSchema',
58
+ symbolKind: CodeSymbolKind.SCHEMA,
59
+ declarationKind: CodeDeclarationKind.ZOD_SCHEMA,
60
+ },
61
+ resourceFactory: {
62
+ packageName: '@wildo-ai/saas-models',
63
+ exportName: 'userProviderCredentialsResourceConfiguration_InitializationFactory',
64
+ symbolKind: CodeSymbolKind.FACTORY,
65
+ declarationKind: CodeDeclarationKind.FUNCTION,
66
+ },
67
+ resourceType: {
68
+ enumDeclaration: {
69
+ packageName: '@wildo-ai/saas-models',
70
+ exportName: 'CoreResourceType',
71
+ symbolKind: CodeSymbolKind.ENUM,
72
+ declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
73
+ },
74
+ memberName: 'USER_PROVIDER_CREDENTIALS',
75
+ },
76
+ operationVocabulary: {
77
+ coreEnum: {
78
+ packageName: '@wildo-ai/saas-models',
79
+ exportName: 'CoreResourceOperation',
80
+ symbolKind: CodeSymbolKind.ENUM,
81
+ declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
82
+ },
83
+ },
84
+ notes: [
85
+ 'The stored value is SEALED, never the plaintext the holder typed: an AES-256-GCM envelope whose key is derived from the application\'s own `secrets.security.session.encryptionKey`. The USER scope selects a DIFFERENT key domain from the organization-owned sibling, so a person\'s envelope cannot be opened as a tenant\'s even with a matching owner id — and the associated data binds it to (userId, providerRef, secretSlug), so a ciphertext copied into another person\'s row fails to open rather than silently working.',
86
+ 'Every door is APP_USER and there is deliberately NO administrative variant — not an organization administrator\'s, not a platform operator\'s. Consenting to STORE a personal credential is not consenting for somebody else to spend it, and the vendor records the resulting act as the holder\'s, which no later audit event makes reversible.',
87
+ 'There is NO resolution fallback. A person who has connected nothing gets a refusal naming what to connect — never the deployment\'s shared principal and never their organization\'s credential. Substituting either would attribute the act to a party that granted no permission for it.',
88
+ 'A row appears in TWO ways, and only one of them is an HTTP write. A credential you PASTE arrives through `CREATE` below. A credential a vendor MINTS arrives through the authorization exchange: you authorize on the vendor\'s own consent screen, come back through one shared callback, and the application records the grant — you never see or type the token. The second path is why this resource permits a system-tier create at all.',
89
+ 'Set, rotate, use and delete are audited as `USER_PROVIDER_CREDENTIAL_*`, annotated `WILDO.IDENTITY.DELEGATED_AUTHORIZATION`. None of the four payload schemas has a field the value could occupy, and none carries an organization — a person\'s connections must not reach their tenant\'s SIEM stream.',
90
+ ],
91
+ },
92
+ fields: {
93
+ _id: schemaShape._id.stringSpec({
94
+ meaning: 'Identifier for one stored credential.',
95
+ whyItMatters: 'The address for a rotation or a revocation, and the id every audit event carries.',
96
+ semanticRole: 'identifier',
97
+ importance: FieldSemanticImportance.PRIMARY,
98
+ }),
99
+ userId: schemaShape.userId.foreignKeySpec({
100
+ meaning: 'The person who owns this credential.',
101
+ whyItMatters: 'The isolation axis, and here it is also the SUBJECT. Injected by the framework from the authenticated scope rather than read from the payload, it scopes every read, and it is bound into the encryption envelope — so a credential cannot be read, spent or moved outside the person who set it. It is what makes "another user\'s key" unreachable rather than merely filtered.',
102
+ importance: FieldSemanticImportance.PRIMARY,
103
+ }),
104
+ providerRef: schemaShape.providerRef.stringSpec({
105
+ meaning: 'The provider this credential authenticates toward — `openai`, `slack`, a generated provider package\'s ref.',
106
+ whyItMatters: 'Half of the credential\'s identity for its holder, and what tells them which third parties they have granted the application authority toward.',
107
+ semanticRole: 'identifier',
108
+ importance: FieldSemanticImportance.PRIMARY,
109
+ }),
110
+ secretSlug: schemaShape.secretSlug.stringSpec({
111
+ meaning: "The slug in the provider's `secretsContract` that this value satisfies.",
112
+ whyItMatters: 'A provider declaring several secrets (an API key and a signing secret) gets one row per slug, so the holder can rotate one without disturbing the other.',
113
+ semanticRole: 'identifier',
114
+ importance: FieldSemanticImportance.PRIMARY,
115
+ }),
116
+ secretValue: schemaShape.secretValue.stringSpec({
117
+ meaning: 'The credential itself. Supplied in plaintext on write, stored SEALED, and never returned — a read renders a fixed mask.',
118
+ whyItMatters: 'Echoing the mask back on an update means "keep the stored secret", which is how the holder edits a note without retyping the credential. Sending a real value replaces it and is recorded as a rotation.',
119
+ semanticRole: 'identifier',
120
+ importance: FieldSemanticImportance.PRIMARY,
121
+ }),
122
+ enabled: schemaShape.enabled.booleanSpec({
123
+ meaning: 'Whether this credential may be spent.',
124
+ whyItMatters: 'Disabling stops the application acting as this person without discarding the credential. Unlike the tenant-owned sibling, a disabled credential does NOT degrade to a shared principal — the call refuses, which is the intended outcome: somebody switching their own connection off is asking the application to stop acting as them.',
125
+ }),
126
+ validationState: schemaShape.validationState.enumSpec({
127
+ meaning: 'Whether the provider has accepted this credential on its last use.',
128
+ whyItMatters: 'Separates "never tried" from "tried and rejected", which a boolean would merge into the same falsy answer. For a personal credential this badge is the only notice the holder will get that their integration has stopped working — nobody else can rotate it for them.',
129
+ values: {
130
+ [ProviderCredentialValidationState.UNVALIDATED]: {
131
+ meaning: 'Stored, never exercised against the provider. Every credential starts here — storing one proves only that somebody typed it.',
132
+ },
133
+ [ProviderCredentialValidationState.VALID]: {
134
+ meaning: 'The provider accepted it on its last use.',
135
+ },
136
+ [ProviderCredentialValidationState.INVALID]: {
137
+ meaning: 'The provider rejected it on its last use; the integration is down until the holder rotates it.',
138
+ },
139
+ },
140
+ enumDeclaration: {
141
+ packageName: '@wildo-ai/saas-models',
142
+ exportName: 'ProviderCredentialValidationState',
143
+ symbolKind: CodeSymbolKind.ENUM,
144
+ declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
145
+ },
146
+ }),
147
+ validationError: schemaShape.validationError.stringSpec({
148
+ meaning: "The provider's own message about why the last use failed.",
149
+ whyItMatters: 'Turns "it stopped working" into a vendor-attributed reason the holder can act on. Server-owned: it describes the credential\'s status and is never derived from the credential.',
150
+ }),
151
+ lastValidatedAt: schemaShape.lastValidatedAt.dateSpec({
152
+ meaning: 'When the provider last accepted or rejected this credential.',
153
+ whyItMatters: 'How current the validation state is — a `VALID` from three months ago says less than one from this morning.',
154
+ temporalRole: 'modified',
155
+ }),
156
+ lastUsedAt: schemaShape.lastUsedAt.dateSpec({
157
+ meaning: 'When this credential was last resolved for an outbound call.',
158
+ whyItMatters: 'Shows the holder what the application is actually doing as them. A credential nothing has spent in months is the one safest to disconnect, and the one riskiest to leave live.',
159
+ temporalRole: 'modified',
160
+ }),
161
+ secretSetAt: schemaShape.secretSetAt.dateSpec({
162
+ meaning: 'When the stored VALUE last changed.',
163
+ whyItMatters: 'Distinct from `updatedAt`, which any field write moves. This is the one that answers "did I rotate this after the vendor warned me?".',
164
+ temporalRole: 'modified',
165
+ }),
166
+ description: schemaShape.description.stringSpec({
167
+ meaning: "The holder's own note — which account, which environment, why this credential exists.",
168
+ whyItMatters: 'Somebody may hold several credentials for one provider across slugs; the note is what tells them apart in a list.',
169
+ }),
170
+ createdAt: schemaShape.createdAt.dateSpec({
171
+ meaning: 'When the credential was first stored.',
172
+ whyItMatters: 'When this person first granted the application authority toward this provider.',
173
+ temporalRole: 'creation',
174
+ }),
175
+ updatedAt: schemaShape.updatedAt.dateSpec({
176
+ meaning: 'When any field last changed.',
177
+ whyItMatters: 'Ordering for the credential list.',
178
+ temporalRole: 'modified',
179
+ }),
180
+ },
181
+ operations: {
182
+ [Op.READ]: {
183
+ purpose: 'Inspect one of your own stored provider credentials.',
184
+ outcome: 'The holder sees which provider and slug the credential covers, whether it is enabled, and whether the provider last accepted it — with the value masked.',
185
+ importance: FieldSemanticImportance.PRIMARY,
186
+ responseStatuses: [
187
+ { code: HttpResponseStatusCode.OK_200, meaning: "The credential was found in the caller's own scope and returned with `secretValue` masked." },
188
+ ],
189
+ errorScenarios: [
190
+ { code: HttpResponseStatusCode.NOT_FOUND_404, when: "No credential with that id belongs to the caller. Another person's credential is indistinguishable from one that does not exist — there is no variant, for any role, that can address somebody else's." },
191
+ ],
192
+ idempotent: true,
193
+ examples: [{
194
+ title: 'Inspect the personal OpenAI key',
195
+ request: { userProviderCredentialId: CREDENTIAL_EXAMPLE_ID },
196
+ response: CREDENTIAL_RECORD_EXAMPLE,
197
+ forStatus: HttpResponseStatusCode.OK_200,
198
+ }],
199
+ },
200
+ [Op.LIST]: {
201
+ purpose: 'List your own provider credentials — which third parties you have connected.',
202
+ outcome: 'The holder sees every provider they have connected and the health of each.',
203
+ responseStatuses: [
204
+ { code: HttpResponseStatusCode.OK_200, meaning: "A (possibly empty) page of the caller's OWN credentials, values masked." },
205
+ ],
206
+ errorScenarios: [],
207
+ idempotent: true,
208
+ examples: [{
209
+ title: 'List my connected accounts',
210
+ request: { page: 1, limit: 20, sort: 'createdAt:desc' },
211
+ response: CREDENTIAL_PAGE_EXAMPLE,
212
+ forStatus: HttpResponseStatusCode.OK_200,
213
+ }],
214
+ },
215
+ [Op.CREATE]: {
216
+ purpose: 'Store your own credential for a provider, so the application acts as YOU toward that third party.',
217
+ outcome: "Outbound calls this application makes on your behalf to that provider use your own credential, so the vendor attributes the work to your account and applies the permissions you granted.",
218
+ whenToUse: 'When you connect a provider with a credential you obtained yourself — a personal API key, an account you authorized.',
219
+ importance: FieldSemanticImportance.PRIMARY,
220
+ responseStatuses: [
221
+ { code: HttpResponseStatusCode.CREATED_201, meaning: 'The credential was sealed and stored. The response masks the value; it is never readable again.' },
222
+ ],
223
+ errorScenarios: [
224
+ { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails validation, or `secretValue` is empty.', errorCode: 'VALIDATION_FAILED' },
225
+ { code: HttpResponseStatusCode.CONFLICT_409, when: 'You already hold a credential for this provider and slug — rotate that one instead of creating a second.' },
226
+ ],
227
+ idempotent: false,
228
+ examples: [{
229
+ title: 'Connect my own OpenAI account',
230
+ request: {
231
+ providerRef: 'openai',
232
+ secretSlug: 'OPENAI_API_KEY',
233
+ secretValue: 'sk-my-own-personal-key',
234
+ description: 'My personal key, so my drafts are billed to me.',
235
+ },
236
+ response: CREDENTIAL_RECORD_EXAMPLE,
237
+ forStatus: HttpResponseStatusCode.CREATED_201,
238
+ }],
239
+ },
240
+ [Op.UPDATE]: {
241
+ purpose: 'Rotate your stored credential, or edit its note and enabled flag.',
242
+ outcome: 'A new value replaces the old one immediately — there is no overlap window, because the vendor is the authority on which credential is live and only one of them is.',
243
+ whenToUse: 'After reissuing the credential at the vendor, or to stop the application acting as you without disconnecting.',
244
+ importance: FieldSemanticImportance.PRIMARY,
245
+ responseStatuses: [
246
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The credential was updated. A payload carrying a new `secretValue` re-seals it and is recorded as a rotation; one echoing the mask leaves the stored secret untouched.' },
247
+ ],
248
+ errorScenarios: [
249
+ { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails validation.', errorCode: 'VALIDATION_FAILED' },
250
+ { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No credential with that id belongs to the caller.' },
251
+ ],
252
+ idempotent: true,
253
+ examples: [{
254
+ title: 'Rotate the key after reissuing it at the vendor',
255
+ request: { userProviderCredentialId: CREDENTIAL_EXAMPLE_ID, secretValue: 'sk-my-newly-issued-key' },
256
+ response: CREDENTIAL_RECORD_EXAMPLE,
257
+ forStatus: HttpResponseStatusCode.OK_200,
258
+ }],
259
+ },
260
+ [Op.DELETE]: {
261
+ purpose: 'Disconnect your account at a provider.',
262
+ outcome: 'The application stops acting as you toward that provider. Calls that named you as the connection are REFUSED by name — there is no fallback to the deployment\'s or your organization\'s credential, because either would act as a party you did not authorize.',
263
+ whenToUse: 'When you disconnect the provider, or when you believe the credential is compromised and rotation is not enough.',
264
+ importance: FieldSemanticImportance.PRIMARY,
265
+ responseStatuses: [
266
+ { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The credential was removed. No body.' },
267
+ ],
268
+ errorScenarios: [
269
+ { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No credential with that id belongs to the caller, including one already removed.' },
270
+ ],
271
+ idempotent: true,
272
+ examples: [{
273
+ title: 'Disconnect my OpenAI account',
274
+ request: { userProviderCredentialId: CREDENTIAL_EXAMPLE_ID },
275
+ forStatus: HttpResponseStatusCode.NO_CONTENT_204,
276
+ }],
277
+ },
278
+ [Op.UPDATE_MANY]: {
279
+ purpose: 'Route-less retention plumbing.',
280
+ outcome: 'Nothing is scrubbed in practice: this resource declares `RETAIN_ONLY`, because a secret is not pseudonymised — it is destroyed. The operation exists because the retention contract requires READ + LIST + UPDATE_MANY to resolve, and a declared-but-unresolvable operation fails when an erasure actually runs.',
281
+ responseStatuses: [
282
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were processed. INTERNAL_CALL — it registers no HTTP route.' },
283
+ ],
284
+ errorScenarios: [
285
+ { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },
286
+ ],
287
+ },
288
+ },
289
+ businessConstraints: [
290
+ 'The uniqueness grain is `(userId, providerRef, secretSlug)`, enforced by a compound unique index rather than a read-then-write. Saving a rotation twice in the same minute would otherwise leave two rows, and the resolver would pick between them arbitrarily — so half the holder\'s outbound calls would carry the retired credential with nothing to say which half.',
291
+ 'A person\'s credential has NO fallback, in either direction. Their organization\'s credential is not a next-best owner and neither is the deployment\'s: a call that named this person and could not resolve them is REFUSED, because the vendor records the act under whichever identity was actually spent and that record outlives us.',
292
+ 'Nobody but the holder may read, spend, rotate or remove one. There is no administrative variant at any tier — consent to STORE a personal credential is not consent for somebody else to use it.',
293
+ 'A subject erasure DOES reach this resource, and destroying the row is the correct treatment. `retentionPolicy` is RETAIN_ONLY rather than retain-and-impersonalize because a secret cannot be pseudonymised: an impersonalized row would keep key material that still opens against a person who asked to be forgotten. The `USERS` composition cascade removes these rows when the subject is erased.',
294
+ '`exportSubject` is FORBIDDEN, and it matters more here than on the organization-owned sibling. That row is unreachable on the subject-export graph by construction; this one is reachable BY construction, because it hangs off the subject. The refusal is what stands between a subject-access request and a working credential in the response.',
295
+ ],
296
+ }), { resourcePrimaryScope: ResourcePrimaryScope.USER_SELF });
297
+ //# sourceMappingURL=user-provider-credentials.resource.specification.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"user-provider-credentials.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/auth/resources/user-provider-credentials.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource: `userProviderCredentials` — Wildo SaaS engine specification\n * (user-self-scoped, backend-managed secret).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/security/connected-accounts/provider-credentials.shared.schemas.ts\n * → `UserProviderCredentialSchema`\n * - Factory: engine/saas-models/src/security/connected-accounts/provider-credentials-user.shared.resources-config.schemas.ts\n * → `userProviderCredentialsResourceConfiguration_InitializationFactory`\n * - Custom operations: none\n * - UI presets: `engine/presets-components/src/config/resources/security.resource-presets.tsx`\n * → `USER_PROVIDER_CREDENTIALS`, reached through the `my-provider-credentials` settings destination.\n */\n\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n ProviderCredentialValidationState,\n ResourcePrimaryScope,\n UserProviderCredentialSchema,\n userProviderCredentialsResourceConfiguration_InitializationFactory,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\nconst CREDENTIAL_EXAMPLE_ID = 'usrprovcred_01J7K2M4N6P8Q0R2S4T6V8W0XY';\nconst CREDENTIAL_EXAMPLE_USER_ID = 'user_01J4M1Z2X3C4V5B6N7M8Q9R0ST';\n\n/**\n * The record as a client sees it — with the value MASKED.\n *\n * That mask is not decoration in an example: `secretValue` is `.isWriteOnlySecret()`, so the\n * framework redacts it at the client boundary on every read. Showing a plausible token here would\n * teach an integrator that a credential can be read back, which is the one thing this resource\n * guarantees it cannot.\n */\nconst CREDENTIAL_RECORD_EXAMPLE = {\n _id: CREDENTIAL_EXAMPLE_ID,\n userId: CREDENTIAL_EXAMPLE_USER_ID,\n providerRef: 'openai',\n secretSlug: 'OPENAI_API_KEY',\n secretValue: '••••••••',\n enabled: true,\n validationState: ProviderCredentialValidationState.VALID,\n lastValidatedAt: '2026-09-02T11:14:00.000Z',\n lastUsedAt: '2026-09-02T11:14:00.000Z',\n secretSetAt: '2026-08-30T09:00:00.000Z',\n description: 'My personal key, so my drafts are billed to me.',\n createdAt: '2026-08-30T09:00:00.000Z',\n updatedAt: '2026-09-02T11:14:00.000Z',\n} as const;\n\nconst CREDENTIAL_PAGE_EXAMPLE = {\n data: [CREDENTIAL_RECORD_EXAMPLE],\n pagination: { page: 1, limit: 20, total: 1, totalPages: 1 },\n} as const;\n\nexport const userProviderCredentialsResourceSpecification = resourceSpecification(\n userProviderCredentialsResourceConfiguration_InitializationFactory,\n UserProviderCredentialSchema,\n ({ schemaShape }) => ({\n purpose:\n \"One PERSON's OWN credential toward a third-party provider — their personal API key, the account they connected themselves.\",\n businessRole:\n \"The record that lets an application act as an individual toward a third party rather than as the tenant or as itself. It is what makes a personal integration possible — work attributed to the person at the vendor, billed to their account, and carrying only the permissions they granted.\",\n lifecycleRole:\n 'Created by the holder when they connect a provider, rotated in place when they reissue the credential at the vendor, disabled to stop the application acting as them without discarding the credential, and removed when they disconnect the provider or their own account is erased.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.AUTH,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'UserProviderCredentialSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'userProviderCredentialsResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'USER_PROVIDER_CREDENTIALS',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'The stored value is SEALED, never the plaintext the holder typed: an AES-256-GCM envelope whose key is derived from the application\\'s own `secrets.security.session.encryptionKey`. The USER scope selects a DIFFERENT key domain from the organization-owned sibling, so a person\\'s envelope cannot be opened as a tenant\\'s even with a matching owner id — and the associated data binds it to (userId, providerRef, secretSlug), so a ciphertext copied into another person\\'s row fails to open rather than silently working.',\n 'Every door is APP_USER and there is deliberately NO administrative variant — not an organization administrator\\'s, not a platform operator\\'s. Consenting to STORE a personal credential is not consenting for somebody else to spend it, and the vendor records the resulting act as the holder\\'s, which no later audit event makes reversible.',\n 'There is NO resolution fallback. A person who has connected nothing gets a refusal naming what to connect — never the deployment\\'s shared principal and never their organization\\'s credential. Substituting either would attribute the act to a party that granted no permission for it.',\n 'A row appears in TWO ways, and only one of them is an HTTP write. A credential you PASTE arrives through `CREATE` below. A credential a vendor MINTS arrives through the authorization exchange: you authorize on the vendor\\'s own consent screen, come back through one shared callback, and the application records the grant — you never see or type the token. The second path is why this resource permits a system-tier create at all.',\n 'Set, rotate, use and delete are audited as `USER_PROVIDER_CREDENTIAL_*`, annotated `WILDO.IDENTITY.DELEGATED_AUTHORIZATION`. None of the four payload schemas has a field the value could occupy, and none carries an organization — a person\\'s connections must not reach their tenant\\'s SIEM stream.',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Identifier for one stored credential.',\n whyItMatters: 'The address for a rotation or a revocation, and the id every audit event carries.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n userId: schemaShape.userId.foreignKeySpec({\n meaning: 'The person who owns this credential.',\n whyItMatters:\n 'The isolation axis, and here it is also the SUBJECT. Injected by the framework from the authenticated scope rather than read from the payload, it scopes every read, and it is bound into the encryption envelope — so a credential cannot be read, spent or moved outside the person who set it. It is what makes \"another user\\'s key\" unreachable rather than merely filtered.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n providerRef: schemaShape.providerRef.stringSpec({\n meaning: 'The provider this credential authenticates toward — `openai`, `slack`, a generated provider package\\'s ref.',\n whyItMatters: 'Half of the credential\\'s identity for its holder, and what tells them which third parties they have granted the application authority toward.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n secretSlug: schemaShape.secretSlug.stringSpec({\n meaning: \"The slug in the provider's `secretsContract` that this value satisfies.\",\n whyItMatters:\n 'A provider declaring several secrets (an API key and a signing secret) gets one row per slug, so the holder can rotate one without disturbing the other.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n secretValue: schemaShape.secretValue.stringSpec({\n meaning: 'The credential itself. Supplied in plaintext on write, stored SEALED, and never returned — a read renders a fixed mask.',\n whyItMatters:\n 'Echoing the mask back on an update means \"keep the stored secret\", which is how the holder edits a note without retyping the credential. Sending a real value replaces it and is recorded as a rotation.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n enabled: schemaShape.enabled.booleanSpec({\n meaning: 'Whether this credential may be spent.',\n whyItMatters:\n 'Disabling stops the application acting as this person without discarding the credential. Unlike the tenant-owned sibling, a disabled credential does NOT degrade to a shared principal — the call refuses, which is the intended outcome: somebody switching their own connection off is asking the application to stop acting as them.',\n }),\n validationState: schemaShape.validationState.enumSpec({\n meaning: 'Whether the provider has accepted this credential on its last use.',\n whyItMatters:\n 'Separates \"never tried\" from \"tried and rejected\", which a boolean would merge into the same falsy answer. For a personal credential this badge is the only notice the holder will get that their integration has stopped working — nobody else can rotate it for them.',\n values: {\n [ProviderCredentialValidationState.UNVALIDATED]: {\n meaning: 'Stored, never exercised against the provider. Every credential starts here — storing one proves only that somebody typed it.',\n },\n [ProviderCredentialValidationState.VALID]: {\n meaning: 'The provider accepted it on its last use.',\n },\n [ProviderCredentialValidationState.INVALID]: {\n meaning: 'The provider rejected it on its last use; the integration is down until the holder rotates it.',\n },\n },\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ProviderCredentialValidationState',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n }),\n validationError: schemaShape.validationError.stringSpec({\n meaning: \"The provider's own message about why the last use failed.\",\n whyItMatters:\n 'Turns \"it stopped working\" into a vendor-attributed reason the holder can act on. Server-owned: it describes the credential\\'s status and is never derived from the credential.',\n }),\n lastValidatedAt: schemaShape.lastValidatedAt.dateSpec({\n meaning: 'When the provider last accepted or rejected this credential.',\n whyItMatters: 'How current the validation state is — a `VALID` from three months ago says less than one from this morning.',\n temporalRole: 'modified',\n }),\n lastUsedAt: schemaShape.lastUsedAt.dateSpec({\n meaning: 'When this credential was last resolved for an outbound call.',\n whyItMatters:\n 'Shows the holder what the application is actually doing as them. A credential nothing has spent in months is the one safest to disconnect, and the one riskiest to leave live.',\n temporalRole: 'modified',\n }),\n secretSetAt: schemaShape.secretSetAt.dateSpec({\n meaning: 'When the stored VALUE last changed.',\n whyItMatters: 'Distinct from `updatedAt`, which any field write moves. This is the one that answers \"did I rotate this after the vendor warned me?\".',\n temporalRole: 'modified',\n }),\n description: schemaShape.description.stringSpec({\n meaning: \"The holder's own note — which account, which environment, why this credential exists.\",\n whyItMatters: 'Somebody may hold several credentials for one provider across slugs; the note is what tells them apart in a list.',\n }),\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the credential was first stored.',\n whyItMatters: 'When this person first granted the application authority toward this provider.',\n temporalRole: 'creation',\n }),\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'When any field last changed.',\n whyItMatters: 'Ordering for the credential list.',\n temporalRole: 'modified',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Inspect one of your own stored provider credentials.',\n outcome: 'The holder sees which provider and slug the credential covers, whether it is enabled, and whether the provider last accepted it — with the value masked.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: \"The credential was found in the caller's own scope and returned with `secretValue` masked.\" },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: \"No credential with that id belongs to the caller. Another person's credential is indistinguishable from one that does not exist — there is no variant, for any role, that can address somebody else's.\" },\n ],\n idempotent: true,\n examples: [{\n title: 'Inspect the personal OpenAI key',\n request: { userProviderCredentialId: CREDENTIAL_EXAMPLE_ID },\n response: CREDENTIAL_RECORD_EXAMPLE,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [Op.LIST]: {\n purpose: 'List your own provider credentials — which third parties you have connected.',\n outcome: 'The holder sees every provider they have connected and the health of each.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: \"A (possibly empty) page of the caller's OWN credentials, values masked.\" },\n ],\n errorScenarios: [],\n idempotent: true,\n examples: [{\n title: 'List my connected accounts',\n request: { page: 1, limit: 20, sort: 'createdAt:desc' },\n response: CREDENTIAL_PAGE_EXAMPLE,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [Op.CREATE]: {\n purpose: 'Store your own credential for a provider, so the application acts as YOU toward that third party.',\n outcome: \"Outbound calls this application makes on your behalf to that provider use your own credential, so the vendor attributes the work to your account and applies the permissions you granted.\",\n whenToUse: 'When you connect a provider with a credential you obtained yourself — a personal API key, an account you authorized.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The credential was sealed and stored. The response masks the value; it is never readable again.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails validation, or `secretValue` is empty.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'You already hold a credential for this provider and slug — rotate that one instead of creating a second.' },\n ],\n idempotent: false,\n examples: [{\n title: 'Connect my own OpenAI account',\n request: {\n providerRef: 'openai',\n secretSlug: 'OPENAI_API_KEY',\n secretValue: 'sk-my-own-personal-key',\n description: 'My personal key, so my drafts are billed to me.',\n },\n response: CREDENTIAL_RECORD_EXAMPLE,\n forStatus: HttpResponseStatusCode.CREATED_201,\n }],\n },\n [Op.UPDATE]: {\n purpose: 'Rotate your stored credential, or edit its note and enabled flag.',\n outcome: 'A new value replaces the old one immediately — there is no overlap window, because the vendor is the authority on which credential is live and only one of them is.',\n whenToUse: 'After reissuing the credential at the vendor, or to stop the application acting as you without disconnecting.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The credential was updated. A payload carrying a new `secretValue` re-seals it and is recorded as a rotation; one echoing the mask leaves the stored secret untouched.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No credential with that id belongs to the caller.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Rotate the key after reissuing it at the vendor',\n request: { userProviderCredentialId: CREDENTIAL_EXAMPLE_ID, secretValue: 'sk-my-newly-issued-key' },\n response: CREDENTIAL_RECORD_EXAMPLE,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n [Op.DELETE]: {\n purpose: 'Disconnect your account at a provider.',\n outcome:\n 'The application stops acting as you toward that provider. Calls that named you as the connection are REFUSED by name — there is no fallback to the deployment\\'s or your organization\\'s credential, because either would act as a party you did not authorize.',\n whenToUse: 'When you disconnect the provider, or when you believe the credential is compromised and rotation is not enough.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The credential was removed. No body.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No credential with that id belongs to the caller, including one already removed.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Disconnect my OpenAI account',\n request: { userProviderCredentialId: CREDENTIAL_EXAMPLE_ID },\n forStatus: HttpResponseStatusCode.NO_CONTENT_204,\n }],\n },\n [Op.UPDATE_MANY]: {\n purpose: 'Route-less retention plumbing.',\n outcome:\n 'Nothing is scrubbed in practice: this resource declares `RETAIN_ONLY`, because a secret is not pseudonymised — it is destroyed. The operation exists because the retention contract requires READ + LIST + UPDATE_MANY to resolve, and a declared-but-unresolvable operation fails when an erasure actually runs.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were processed. INTERNAL_CALL — it registers no HTTP route.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n },\n },\n\n businessConstraints: [\n 'The uniqueness grain is `(userId, providerRef, secretSlug)`, enforced by a compound unique index rather than a read-then-write. Saving a rotation twice in the same minute would otherwise leave two rows, and the resolver would pick between them arbitrarily — so half the holder\\'s outbound calls would carry the retired credential with nothing to say which half.',\n 'A person\\'s credential has NO fallback, in either direction. Their organization\\'s credential is not a next-best owner and neither is the deployment\\'s: a call that named this person and could not resolve them is REFUSED, because the vendor records the act under whichever identity was actually spent and that record outlives us.',\n 'Nobody but the holder may read, spend, rotate or remove one. There is no administrative variant at any tier — consent to STORE a personal credential is not consent for somebody else to use it.',\n 'A subject erasure DOES reach this resource, and destroying the row is the correct treatment. `retentionPolicy` is RETAIN_ONLY rather than retain-and-impersonalize because a secret cannot be pseudonymised: an impersonalized row would keep key material that still opens against a person who asked to be forgotten. The `USERS` composition cascade removes these rows when the subject is erased.',\n '`exportSubject` is FORBIDDEN, and it matters more here than on the organization-owned sibling. That row is unreachable on the subject-export graph by construction; this one is reachable BY construction, because it hangs off the subject. The refusal is what stands between a subject-access request and a working credential in the response.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.USER_SELF },\n);\n"]}
@@ -1,5 +1,5 @@
1
1
  import { BillingAccount_Operations, CoreResourceOperation as Op } from '@wildo-ai/saas-models';
2
- export declare const organizationBillingAccountsResourceSpecification: import("../../../_core").ResourceSpecificationConfig<typeof BillingAccount_Operations, Op.READ | Op.UPDATE | Op.DELETE | Op.CREATE | Op.LIST, import("zod").ZodObject<{
2
+ export declare const organizationBillingAccountsResourceSpecification: import("../../../_core").ResourceSpecificationConfig<typeof BillingAccount_Operations, Op.READ | Op.UPDATE | Op.UPDATE_MANY | Op.DELETE | Op.CREATE | Op.LIST, import("zod").ZodObject<{
3
3
  _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
4
4
  providerCustomerId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodString>>>;
5
5
  providerRef: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodString>>;
@@ -8,7 +8,7 @@ export declare const organizationBillingAccountsResourceSpecification: import(".
8
8
  createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodDate>>>;
9
9
  updatedAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodDate>>>;
10
10
  }, import("zod/v4/core").$strip>>;
11
- export declare const userBillingAccountsResourceSpecification: import("../../../_core").ResourceSpecificationConfig<typeof BillingAccount_Operations, Op.READ | Op.UPDATE | Op.DELETE | Op.CREATE | Op.LIST, import("zod").ZodObject<{
11
+ export declare const userBillingAccountsResourceSpecification: import("../../../_core").ResourceSpecificationConfig<typeof BillingAccount_Operations, Op.READ | Op.UPDATE | Op.UPDATE_MANY | Op.DELETE | Op.CREATE | Op.LIST, import("zod").ZodObject<{
12
12
  _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
13
13
  providerCustomerId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodString>>>;
14
14
  providerRef: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodOptional<import("zod").ZodString>>;
@@ -1 +1 @@
1
- {"version":3,"file":"billing-accounts.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/billing-accounts.resource.specification.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,yBAAyB,EAEzB,qBAAqB,IAAI,EAAE,EAI5B,MAAM,uBAAuB,CAAC;AAiW/B,eAAO,MAAM,gDAAgD;;;;;;;;iCAG5D,CAAC;AAEF,eAAO,MAAM,wCAAwC;;;;;;;;iCAGpD,CAAC"}
1
+ {"version":3,"file":"billing-accounts.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/billing-accounts.resource.specification.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,yBAAyB,EAEzB,qBAAqB,IAAI,EAAE,EAI5B,MAAM,uBAAuB,CAAC;AAoW/B,eAAO,MAAM,gDAAgD;;;;;;;;iCAG5D,CAAC;AAEF,eAAO,MAAM,wCAAwC;;;;;;;;iCAGpD,CAAC"}
@@ -4,6 +4,7 @@ import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@w
4
4
  import { BillingAccount_Operations, BillingAccountBaseSchema, CoreResourceOperation as Op, CoreResourceType, ResourcePrimaryScope, billingAccountsPolymorphicFactories, } from '@wildo-ai/saas-models';
5
5
  import { HttpResponseStatusCode, mergeResourceFrontendConfigurations, resourceFrontendConfiguration, resourceSpecification, resourceSpecificationFromFrontendConfiguration, } from '../../../_core/index.js';
6
6
  import { BILLING_API_REFERENCE_PAGE_REQUEST, billingApiReferencePage, createBillingApiReferenceScopeExample, } from './billing-api-reference-examples.js';
7
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
7
8
  const billingAccountResourcePrimaryScopeByResourceType = {
8
9
  [CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS]: ResourcePrimaryScope.ORGANIZATIONS,
9
10
  [CoreResourceType.USER_BILLING_ACCOUNTS]: ResourcePrimaryScope.USER_SELF,
@@ -34,6 +35,7 @@ function buildBillingAccountBase(resourceType, resourceTypeMemberName) {
34
35
  businessRole: 'Anchor row for subscriptions, invoices, credit pools, and self-serve `OPEN_CHECKOUT` / `OPEN_PORTAL` flows in user/org billing settings.',
35
36
  lifecycleRole: 'Created automatically the first time billing state is requested, then synchronized from billing-provider events. An inactive account remains readable for billing history but cannot start a new checkout or portal session. There is no client-facing create operation.',
36
37
  audience: LabelAudience.ADMIN,
38
+ subDomain: EngineResourceSubDomain.BILLING,
37
39
  codeHandling: {
38
40
  mainSchema: {
39
41
  packageName: '@wildo-ai/saas-models',
@@ -61,12 +63,12 @@ function buildBillingAccountBase(resourceType, resourceTypeMemberName) {
61
63
  notes: ['Two variants under `BILLING_SCOPE_VARIANTS` — org primary catalog scope is `ORGANIZATIONS`; user row is `USER_SELF`.'],
62
64
  },
63
65
  fields: {
64
- _id: schemaShape._id.stringSpec({ meaning: 'Document id in Mongo for this billing account row.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),
66
+ _id: schemaShape._id.stringSpec({ meaning: 'Document id in Mongo for this billing account record.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),
65
67
  isActive: schemaShape.isActive.booleanSpec({ meaning: 'Whether the account should participate in new purchases and portal sessions.', importance: FieldSemanticImportance.PRIMARY }),
66
68
  providerRef: schemaShape.providerRef.stringSpec({ meaning: 'Which billing adapter integration backs this account (e.g. stripe) — backend-only in typical responses.', whyItMatters: 'Drives which SDK and webhook namespace hydrate the row.' }),
67
69
  providerCustomerId: schemaShape.providerCustomerId.stringSpec({ meaning: 'Provider-side customer id; master link for subscription and invoice fetch.', whyItMatters: 'Without it the row cannot call provider APIs for portal or state.', importance: FieldSemanticImportance.PRIMARY }),
68
70
  metadata: schemaShape.metadata.objectSpec({ meaning: 'Key/value tags mirrored to the provider for analytics or tax hints — not the full address book.' }),
69
- createdAt: schemaShape.createdAt.dateSpec({ meaning: 'When the row was first created.', temporalRole: 'creation' }),
71
+ createdAt: schemaShape.createdAt.dateSpec({ meaning: 'When the record was first created.', temporalRole: 'creation' }),
70
72
  updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Last backend sync with provider or local patch.', temporalRole: 'modified' }),
71
73
  },
72
74
  operations: {
@@ -169,7 +171,7 @@ function buildBillingAccountBase(resourceType, resourceTypeMemberName) {
169
171
  purpose: 'Metadata or activation toggles; heavy provider writes often go through webhooks or custom ops instead.',
170
172
  outcome: 'Patched `metadata` or `isActive` per DTO in factory config.',
171
173
  responseStatuses: [
172
- { code: HttpResponseStatusCode.OK_200, meaning: 'The account’s `metadata` / `isActive` fields were patched and the updated row is returned.' },
174
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The account’s `metadata` / `isActive` fields were patched and the updated record is returned.' },
173
175
  ],
174
176
  errorScenarios: [
175
177
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },
@@ -205,6 +207,7 @@ function buildBillingAccountBase(resourceType, resourceTypeMemberName) {
205
207
  { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller does not own this billing account and may not open checkout for it.' },
206
208
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No billing account exists for the supplied id, or the referenced price is not in the catalog.' },
207
209
  { code: HttpResponseStatusCode.CONFLICT_409, when: 'The account is inactive or has no linked provider customer, so a checkout session cannot be opened.' },
210
+ { code: HttpResponseStatusCode.CONFLICT_409, when: '`productKey` (or the price named by `priceId`) has been RETIRED — the product left the code catalogue and the catalogue sync soft-retired it. It still exists, and existing subscribers keep it, but it may no longer be bought: its entitlements are frozen at whatever the last sync wrote and nobody maintains them.', errorCode: 'BILLING_PRODUCT_RETIRED' },
208
211
  ],
209
212
  idempotent: false,
210
213
  examples: [{