@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,36 @@
1
+ import { type AnyResourceSpecificationConfig } from '../../../_core';
2
+ /**
3
+ * Framework-owned specification for `consumableTokens` — the one bearer secret the engine mints on a
4
+ * user's behalf, and, until this file existed, the ONLY registered engine resource with no
5
+ * specification at all.
6
+ *
7
+ * ## Why it was the last one, and how that surfaced
8
+ *
9
+ * `backend-resource-registry.exports.ts` had already written the prediction down: *"`CONSUMABLE_TOKENS`
10
+ * has the identical shape [to `dataSeedRuns`] and was orphan-free only because nobody had authored its
11
+ * spec yet."* What made the omission visible rather than merely known was the domain-model graph
12
+ * grouping the engine by `subDomain` — 84 of 85 resources fell into a named box and this one landed in
13
+ * a box called `unclassified`, which is exactly what that box exists to make impossible to miss.
14
+ *
15
+ * ## Audience is DEVELOPER, and that is a decision
16
+ *
17
+ * A token row is never rendered to the person it authenticates: they receive a link or a code, and the
18
+ * row behind it is read by an operator diagnosing why a reset link was refused. `END_USER` would make
19
+ * the label generator write consumer copy for a table whose only reader is debugging an auth flow.
20
+ *
21
+ * ## What this spec does NOT say
22
+ *
23
+ * Nothing here describes how a token is minted, exchanged or revoked — that is
24
+ * `ConsumableTokenBackendService`'s contract, and this resource's own CRUD surface is not how any flow
25
+ * uses it. The field prose below explains what a persisted row MEANS, which is the question an operator
26
+ * reading one actually has.
27
+ *
28
+ * WHY THE EXPLICIT TYPE ANNOTATION: the same reason `data-seed-runs.resource.specification.ts` records
29
+ * at length. This resource's schema and factory come from `@wildo-ai/saas-backend-lib`, not
30
+ * `@wildo-ai/saas-models`, so the inferred type is nameable only through a non-portable nested path and
31
+ * declaration emit rejects it with TS2742. `AnyResourceSpecificationConfig` loses nothing at the only
32
+ * consumption point — `engineResourceSpecificationsByType` is `Record<string, AnyResourceSpecificationConfig>`,
33
+ * so the precise instantiation was already erased there.
34
+ */
35
+ export declare const consumableTokensResourceSpecification: AnyResourceSpecificationConfig;
36
+ //# sourceMappingURL=consumable-tokens.resource.specification.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consumable-tokens.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/auth/resources/consumable-tokens.resource.specification.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,KAAK,8BAA8B,EAAyB,MAAM,6BAA6B,CAAC;AAGzG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,eAAO,MAAM,qCAAqC,EAAE,8BA4KnD,CAAC"}
@@ -0,0 +1,193 @@
1
+ import { LabelAudience } from '@wildo-ai/presets-components-models';
2
+ import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, } from '@wildo-ai/zod-decorators';
3
+ import { ConsumableTokenSchemaBase, consumableTokens_ResourceConfiguration_InitializationFactory as consumableTokensFactory, } from '@wildo-ai/saas-backend-lib/consumable-token-models';
4
+ import { ConsumableToken_ConsumptionMode, ResourcePrimaryScope } from '@wildo-ai/saas-models';
5
+ import { resourceSpecification } from '../../../_core/index.js';
6
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
7
+ /**
8
+ * Framework-owned specification for `consumableTokens` — the one bearer secret the engine mints on a
9
+ * user's behalf, and, until this file existed, the ONLY registered engine resource with no
10
+ * specification at all.
11
+ *
12
+ * ## Why it was the last one, and how that surfaced
13
+ *
14
+ * `backend-resource-registry.exports.ts` had already written the prediction down: *"`CONSUMABLE_TOKENS`
15
+ * has the identical shape [to `dataSeedRuns`] and was orphan-free only because nobody had authored its
16
+ * spec yet."* What made the omission visible rather than merely known was the domain-model graph
17
+ * grouping the engine by `subDomain` — 84 of 85 resources fell into a named box and this one landed in
18
+ * a box called `unclassified`, which is exactly what that box exists to make impossible to miss.
19
+ *
20
+ * ## Audience is DEVELOPER, and that is a decision
21
+ *
22
+ * A token row is never rendered to the person it authenticates: they receive a link or a code, and the
23
+ * row behind it is read by an operator diagnosing why a reset link was refused. `END_USER` would make
24
+ * the label generator write consumer copy for a table whose only reader is debugging an auth flow.
25
+ *
26
+ * ## What this spec does NOT say
27
+ *
28
+ * Nothing here describes how a token is minted, exchanged or revoked — that is
29
+ * `ConsumableTokenBackendService`'s contract, and this resource's own CRUD surface is not how any flow
30
+ * uses it. The field prose below explains what a persisted row MEANS, which is the question an operator
31
+ * reading one actually has.
32
+ *
33
+ * WHY THE EXPLICIT TYPE ANNOTATION: the same reason `data-seed-runs.resource.specification.ts` records
34
+ * at length. This resource's schema and factory come from `@wildo-ai/saas-backend-lib`, not
35
+ * `@wildo-ai/saas-models`, so the inferred type is nameable only through a non-portable nested path and
36
+ * declaration emit rejects it with TS2742. `AnyResourceSpecificationConfig` loses nothing at the only
37
+ * consumption point — `engineResourceSpecificationsByType` is `Record<string, AnyResourceSpecificationConfig>`,
38
+ * so the precise instantiation was already erased there.
39
+ */
40
+ export const consumableTokensResourceSpecification = resourceSpecification(consumableTokensFactory,
41
+ /*
42
+ * The BASE, not the discriminated union. `ConsumableTokenSchema` is the union over the three
43
+ * consumption modes, and a union has no `shape` for the callback to hand back — which is also why
44
+ * the resource configuration itself is built from the base. `maxUses` therefore has no field spec
45
+ * here: it exists only on the BOUNDED_REUSE variant, and its meaning is carried by the
46
+ * `consumptionMode` enum spec that decides whether it is present at all.
47
+ */
48
+ ConsumableTokenSchemaBase, ({ schemaShape }) => ({
49
+ purpose: 'Hold one bearer secret the engine issued on a principal’s behalf — a password-reset link, an email verification, an invitation acceptance, an OTP — together with the conditions under which presenting it is still allowed to do anything.',
50
+ businessRole: 'The engine’s single answer to "is this link or code still good, who does it act for, and what may it authorize once?" — so every flow that mints a secret shares one expiry, revocation and consumption contract instead of inventing its own.',
51
+ lifecycleRole: 'Minted with an expiry and a consumption mode, then ends exactly once: consumed (single-use), exhausted (bounded reuse), revoked, or expired. A settled row is kept as evidence rather than deleted, so an operator can tell "never issued" from "issued and already used".',
52
+ audience: LabelAudience.DEVELOPER,
53
+ subDomain: EngineResourceSubDomain.AUTH,
54
+ codeHandling: {
55
+ mainSchema: {
56
+ packageName: '@wildo-ai/saas-backend-lib',
57
+ exportName: 'ConsumableTokenSchema',
58
+ symbolKind: CodeSymbolKind.SCHEMA,
59
+ declarationKind: CodeDeclarationKind.ZOD_SCHEMA,
60
+ },
61
+ resourceFactory: {
62
+ packageName: '@wildo-ai/saas-backend-lib',
63
+ exportName: 'consumableTokens_ResourceConfiguration_InitializationFactory',
64
+ symbolKind: CodeSymbolKind.FACTORY,
65
+ declarationKind: CodeDeclarationKind.FUNCTION,
66
+ },
67
+ resourceType: {
68
+ enumDeclaration: {
69
+ packageName: '@wildo-ai/saas-backend-lib',
70
+ exportName: 'BackendResourceType',
71
+ symbolKind: CodeSymbolKind.ENUM,
72
+ declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
73
+ },
74
+ memberName: 'CONSUMABLE_TOKENS',
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
+ },
85
+ fields: {
86
+ _id: schemaShape._id.stringSpec({
87
+ meaning: 'Stable identifier of one issued token record.',
88
+ whyItMatters: 'It is what an operator addresses when revoking a specific issuance, and what a delivery record refers back to.',
89
+ semanticRole: 'identifier',
90
+ importance: FieldSemanticImportance.PRIMARY,
91
+ }),
92
+ token: schemaShape.token.stringSpec({
93
+ meaning: 'The secret itself — the value carried in the link or entered by the person.',
94
+ whyItMatters: 'This field IS the credential, which is why it is declared as personal data of the credentials category and why the row is globally unique on it. Anything that can read this column can act as the principal the row names.',
95
+ importance: FieldSemanticImportance.PRIMARY,
96
+ }),
97
+ tokenType: schemaShape.tokenType.stringSpec({
98
+ meaning: 'Which flow issued this token — password reset, email verification, invitation, OTP, a file upload grant, and so on.',
99
+ whyItMatters: 'It is the discriminator every consuming flow filters on, so a token minted for one purpose can never be redeemed by another.',
100
+ importance: FieldSemanticImportance.PRIMARY,
101
+ }),
102
+ consumptionMode: schemaShape.consumptionMode.enumSpec({
103
+ meaning: 'How many times presenting this token is allowed to succeed.',
104
+ whyItMatters: 'It decides when the row settles, and it is the discriminator of the schema family: only BOUNDED_REUSE carries a maximum, so reading a use count without reading this first says nothing.',
105
+ enumDeclaration: {
106
+ packageName: '@wildo-ai/saas-models',
107
+ exportName: 'ConsumableToken_ConsumptionMode',
108
+ symbolKind: CodeSymbolKind.ENUM,
109
+ declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
110
+ },
111
+ values: {
112
+ [ConsumableToken_ConsumptionMode.SINGLE_USE]: { meaning: 'One successful presentation settles the token. The shape of a reset link or an invitation.' },
113
+ [ConsumableToken_ConsumptionMode.BOUNDED_REUSE]: { meaning: 'Succeeds up to a declared maximum, then settles. The shape of an OTP a person may mistype.' },
114
+ [ConsumableToken_ConsumptionMode.EPHEMERAL_STATE]: { meaning: 'Carries state across a redirect rather than authorizing an action; it expires rather than being consumed.' },
115
+ },
116
+ importance: FieldSemanticImportance.PRIMARY,
117
+ }),
118
+ userId: schemaShape.userId.stringSpec({
119
+ meaning: 'The user this token acts on behalf of, when it acts for one.',
120
+ whyItMatters: 'Optional because some flows mint before an identity exists — a phone verification keyed on the number, an invitation keyed on the membership.',
121
+ importance: FieldSemanticImportance.PRIMARY,
122
+ }),
123
+ organizationId: schemaShape.organizationId.stringSpec({
124
+ meaning: 'The tenant the token was issued within, when it was issued within one.',
125
+ whyItMatters: 'It is what keeps a token minted in one tenant from being redeemed against another.',
126
+ importance: FieldSemanticImportance.CONTEXTUAL,
127
+ }),
128
+ relatedId: schemaShape.relatedId.stringSpec({
129
+ meaning: 'Whatever the issuing flow keys on: a membership id, a user id, or a phone number.',
130
+ whyItMatters: 'Deliberately NOT a foreign key — the value set has no single target resource and its members are not all ids. Reading it as a reference is how phone-keyed tokens were made to fail on one database adapter and not the other.',
131
+ importance: FieldSemanticImportance.CONTEXTUAL,
132
+ }),
133
+ resourceIdentifier: schemaShape.resourceIdentifier.stringSpec({
134
+ meaning: 'Names what `relatedId` points at, when what it points at is a resource record.',
135
+ whyItMatters: 'Without it a correlator holding an id says which id but not of what.',
136
+ importance: FieldSemanticImportance.CONTEXTUAL,
137
+ }),
138
+ expiresAt: schemaShape.expiresAt.dateSpec({
139
+ meaning: 'The moment after which presenting this token can no longer succeed.',
140
+ whyItMatters: 'Every flow sets its own window, and this is the only field that ends a token nobody ever presents — so it is the first thing to read when a link "stopped working" with no consumption recorded.',
141
+ importance: FieldSemanticImportance.PRIMARY,
142
+ }),
143
+ isConsumed: schemaShape.isConsumed.booleanSpec({
144
+ meaning: 'Whether this token has settled and can no longer succeed.',
145
+ whyItMatters: 'It is the difference between a link that was never used and one that already did its work — the distinction an operator is almost always trying to make.',
146
+ importance: FieldSemanticImportance.PRIMARY,
147
+ }),
148
+ usesCount: schemaShape.usesCount.numberSpec({
149
+ meaning: 'How many times this token has been successfully presented.',
150
+ whyItMatters: 'Only meaningful against the consumption mode: under BOUNDED_REUSE it is read against the declared maximum, and under the other two a value above zero means the token is already settled.',
151
+ importance: FieldSemanticImportance.CONTEXTUAL,
152
+ }),
153
+ revokedAt: schemaShape.revokedAt.dateSpec({
154
+ meaning: 'When this token was withdrawn before it was used or expired.',
155
+ whyItMatters: 'A revoked token and an expired one both refuse, and only this field says which happened — which is the difference between "someone cancelled it" and "it timed out".',
156
+ importance: FieldSemanticImportance.CONTEXTUAL,
157
+ }),
158
+ activeGenerationKey: schemaShape.activeGenerationKey.stringSpec({
159
+ meaning: 'A sparse unique slot held by the currently live issuance of a replace-existing token.',
160
+ whyItMatters: 'It makes two concurrent "resend" attempts contend at the database boundary instead of minting two simultaneously valid links; consuming or revoking releases the slot.',
161
+ importance: FieldSemanticImportance.CONTEXTUAL,
162
+ }),
163
+ createsOneOffSession: schemaShape.createsOneOffSession.booleanSpec({
164
+ meaning: 'Whether redeeming this token establishes a short session rather than only authorizing one action.',
165
+ whyItMatters: 'It is the token’s most powerful property and is deliberately unwritable through the resource CREATE and UPDATE pipelines — only the minting service sets it, which is what keeps the session-lifetime ceiling unbypassable.',
166
+ importance: FieldSemanticImportance.PRIMARY,
167
+ }),
168
+ metadata: schemaShape.metadata.objectSpec({
169
+ meaning: 'Free-form payload the issuing flow needs back when the token is redeemed.',
170
+ whyItMatters: 'It is flow-defined and unvalidated by this resource, so its contents mean whatever the flow named in `tokenType` says they mean.',
171
+ importance: FieldSemanticImportance.CONTEXTUAL,
172
+ }),
173
+ createdAt: schemaShape.createdAt.dateSpec({
174
+ meaning: 'When the token was issued.',
175
+ whyItMatters: 'Read against `expiresAt` it gives the window the issuing flow chose, which is how an unexpectedly short-lived link is diagnosed.',
176
+ importance: FieldSemanticImportance.CONTEXTUAL,
177
+ }),
178
+ updatedAt: schemaShape.updatedAt.dateSpec({
179
+ meaning: 'When the record last changed.',
180
+ whyItMatters: 'For a settled token this is when it settled.',
181
+ importance: FieldSemanticImportance.CONTEXTUAL,
182
+ }),
183
+ },
184
+ }),
185
+ /*
186
+ * APPLICATION, from the relationship that declares it: `APPLICATION → CONSUMABLE_TOKENS` carries
187
+ * `isPrimaryScope: true`, while the `ORGANIZATIONS` relationship beside it is OPTIONAL and
188
+ * STANDALONE — a token may be issued inside a tenant and may equally be issued before one exists
189
+ * (a signup verification, a phone check). Declaring the tenant as the scope would make the second
190
+ * shape unrepresentable.
191
+ */
192
+ { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION });
193
+ //# sourceMappingURL=consumable-tokens.resource.specification.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"consumable-tokens.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/auth/resources/consumable-tokens.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n ConsumableTokenSchemaBase,\n consumableTokens_ResourceConfiguration_InitializationFactory as consumableTokensFactory,\n} from '@wildo-ai/saas-backend-lib/consumable-token-models';\nimport { ConsumableToken_ConsumptionMode, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { type AnyResourceSpecificationConfig, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for `consumableTokens` — the one bearer secret the engine mints on a\n * user's behalf, and, until this file existed, the ONLY registered engine resource with no\n * specification at all.\n *\n * ## Why it was the last one, and how that surfaced\n *\n * `backend-resource-registry.exports.ts` had already written the prediction down: *\"`CONSUMABLE_TOKENS`\n * has the identical shape [to `dataSeedRuns`] and was orphan-free only because nobody had authored its\n * spec yet.\"* What made the omission visible rather than merely known was the domain-model graph\n * grouping the engine by `subDomain` — 84 of 85 resources fell into a named box and this one landed in\n * a box called `unclassified`, which is exactly what that box exists to make impossible to miss.\n *\n * ## Audience is DEVELOPER, and that is a decision\n *\n * A token row is never rendered to the person it authenticates: they receive a link or a code, and the\n * row behind it is read by an operator diagnosing why a reset link was refused. `END_USER` would make\n * the label generator write consumer copy for a table whose only reader is debugging an auth flow.\n *\n * ## What this spec does NOT say\n *\n * Nothing here describes how a token is minted, exchanged or revoked — that is\n * `ConsumableTokenBackendService`'s contract, and this resource's own CRUD surface is not how any flow\n * uses it. The field prose below explains what a persisted row MEANS, which is the question an operator\n * reading one actually has.\n *\n * WHY THE EXPLICIT TYPE ANNOTATION: the same reason `data-seed-runs.resource.specification.ts` records\n * at length. This resource's schema and factory come from `@wildo-ai/saas-backend-lib`, not\n * `@wildo-ai/saas-models`, so the inferred type is nameable only through a non-portable nested path and\n * declaration emit rejects it with TS2742. `AnyResourceSpecificationConfig` loses nothing at the only\n * consumption point — `engineResourceSpecificationsByType` is `Record<string, AnyResourceSpecificationConfig>`,\n * so the precise instantiation was already erased there.\n */\nexport const consumableTokensResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n consumableTokensFactory,\n /*\n * The BASE, not the discriminated union. `ConsumableTokenSchema` is the union over the three\n * consumption modes, and a union has no `shape` for the callback to hand back — which is also why\n * the resource configuration itself is built from the base. `maxUses` therefore has no field spec\n * here: it exists only on the BOUNDED_REUSE variant, and its meaning is carried by the\n * `consumptionMode` enum spec that decides whether it is present at all.\n */\n ConsumableTokenSchemaBase,\n ({ schemaShape }) => ({\n purpose: 'Hold one bearer secret the engine issued on a principal’s behalf — a password-reset link, an email verification, an invitation acceptance, an OTP — together with the conditions under which presenting it is still allowed to do anything.',\n businessRole: 'The engine’s single answer to \"is this link or code still good, who does it act for, and what may it authorize once?\" — so every flow that mints a secret shares one expiry, revocation and consumption contract instead of inventing its own.',\n lifecycleRole: 'Minted with an expiry and a consumption mode, then ends exactly once: consumed (single-use), exhausted (bounded reuse), revoked, or expired. A settled row is kept as evidence rather than deleted, so an operator can tell \"never issued\" from \"issued and already used\".',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.AUTH,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'ConsumableTokenSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'consumableTokens_ResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'BackendResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'CONSUMABLE_TOKENS',\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 },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Stable identifier of one issued token record.',\n whyItMatters: 'It is what an operator addresses when revoking a specific issuance, and what a delivery record refers back to.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n token: schemaShape.token.stringSpec({\n meaning: 'The secret itself — the value carried in the link or entered by the person.',\n whyItMatters: 'This field IS the credential, which is why it is declared as personal data of the credentials category and why the row is globally unique on it. Anything that can read this column can act as the principal the row names.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n tokenType: schemaShape.tokenType.stringSpec({\n meaning: 'Which flow issued this token — password reset, email verification, invitation, OTP, a file upload grant, and so on.',\n whyItMatters: 'It is the discriminator every consuming flow filters on, so a token minted for one purpose can never be redeemed by another.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n consumptionMode: schemaShape.consumptionMode.enumSpec({\n meaning: 'How many times presenting this token is allowed to succeed.',\n whyItMatters: 'It decides when the row settles, and it is the discriminator of the schema family: only BOUNDED_REUSE carries a maximum, so reading a use count without reading this first says nothing.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ConsumableToken_ConsumptionMode',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ConsumableToken_ConsumptionMode.SINGLE_USE]: { meaning: 'One successful presentation settles the token. The shape of a reset link or an invitation.' },\n [ConsumableToken_ConsumptionMode.BOUNDED_REUSE]: { meaning: 'Succeeds up to a declared maximum, then settles. The shape of an OTP a person may mistype.' },\n [ConsumableToken_ConsumptionMode.EPHEMERAL_STATE]: { meaning: 'Carries state across a redirect rather than authorizing an action; it expires rather than being consumed.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n userId: schemaShape.userId.stringSpec({\n meaning: 'The user this token acts on behalf of, when it acts for one.',\n whyItMatters: 'Optional because some flows mint before an identity exists — a phone verification keyed on the number, an invitation keyed on the membership.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n organizationId: schemaShape.organizationId.stringSpec({\n meaning: 'The tenant the token was issued within, when it was issued within one.',\n whyItMatters: 'It is what keeps a token minted in one tenant from being redeemed against another.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n\n relatedId: schemaShape.relatedId.stringSpec({\n meaning: 'Whatever the issuing flow keys on: a membership id, a user id, or a phone number.',\n whyItMatters: 'Deliberately NOT a foreign key — the value set has no single target resource and its members are not all ids. Reading it as a reference is how phone-keyed tokens were made to fail on one database adapter and not the other.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n\n resourceIdentifier: schemaShape.resourceIdentifier.stringSpec({\n meaning: 'Names what `relatedId` points at, when what it points at is a resource record.',\n whyItMatters: 'Without it a correlator holding an id says which id but not of what.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n\n expiresAt: schemaShape.expiresAt.dateSpec({\n meaning: 'The moment after which presenting this token can no longer succeed.',\n whyItMatters: 'Every flow sets its own window, and this is the only field that ends a token nobody ever presents — so it is the first thing to read when a link \"stopped working\" with no consumption recorded.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n isConsumed: schemaShape.isConsumed.booleanSpec({\n meaning: 'Whether this token has settled and can no longer succeed.',\n whyItMatters: 'It is the difference between a link that was never used and one that already did its work — the distinction an operator is almost always trying to make.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n usesCount: schemaShape.usesCount.numberSpec({\n meaning: 'How many times this token has been successfully presented.',\n whyItMatters: 'Only meaningful against the consumption mode: under BOUNDED_REUSE it is read against the declared maximum, and under the other two a value above zero means the token is already settled.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n\n revokedAt: schemaShape.revokedAt.dateSpec({\n meaning: 'When this token was withdrawn before it was used or expired.',\n whyItMatters: 'A revoked token and an expired one both refuse, and only this field says which happened — which is the difference between \"someone cancelled it\" and \"it timed out\".',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n\n activeGenerationKey: schemaShape.activeGenerationKey.stringSpec({\n meaning: 'A sparse unique slot held by the currently live issuance of a replace-existing token.',\n whyItMatters: 'It makes two concurrent \"resend\" attempts contend at the database boundary instead of minting two simultaneously valid links; consuming or revoking releases the slot.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n\n createsOneOffSession: schemaShape.createsOneOffSession.booleanSpec({\n meaning: 'Whether redeeming this token establishes a short session rather than only authorizing one action.',\n whyItMatters: 'It is the token’s most powerful property and is deliberately unwritable through the resource CREATE and UPDATE pipelines — only the minting service sets it, which is what keeps the session-lifetime ceiling unbypassable.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n metadata: schemaShape.metadata.objectSpec({\n meaning: 'Free-form payload the issuing flow needs back when the token is redeemed.',\n whyItMatters: 'It is flow-defined and unvalidated by this resource, so its contents mean whatever the flow named in `tokenType` says they mean.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the token was issued.',\n whyItMatters: 'Read against `expiresAt` it gives the window the issuing flow chose, which is how an unexpectedly short-lived link is diagnosed.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'When the record last changed.',\n whyItMatters: 'For a settled token this is when it settled.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n },\n }),\n /*\n * APPLICATION, from the relationship that declares it: `APPLICATION → CONSUMABLE_TOKENS` carries\n * `isPrimaryScope: true`, while the `ORGANIZATIONS` relationship beside it is OPTIONAL and\n * STANDALONE — a token may be issued inside a tenant and may equally be issued before one exists\n * (a signup verification, a phone check). Declaring the tenant as the scope would make the second\n * shape unrepresentable.\n */\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
@@ -10,7 +10,7 @@
10
10
  * "authorized apps" settings surface consume the owner READ/LIST/DELETE API).
11
11
  */
12
12
  import { CoreResourceOperation as Op } from '@wildo-ai/saas-models';
13
- export declare const oauthConsentGrantsResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.DELETE | Op.CREATE | Op.LIST, import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodObject<{
13
+ export declare const oauthConsentGrantsResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.UPDATE_MANY | Op.DELETE | Op.CREATE | Op.LIST, import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodObject<{
14
14
  _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
15
15
  userId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>>>;
16
16
  clientId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
@@ -1 +1 @@
1
- {"version":3,"file":"oauth-consent-grants.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/auth/resources/oauth-consent-grants.resource.specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,EACL,qBAAqB,IAAI,EAAE,EAI5B,MAAM,uBAAuB,CAAC;AA2D/B,eAAO,MAAM,uCAAuC;;;;;;;;;kCAmOnD,CAAC"}
1
+ {"version":3,"file":"oauth-consent-grants.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/auth/resources/oauth-consent-grants.resource.specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAQH,OAAO,EACL,qBAAqB,IAAI,EAAE,EAI5B,MAAM,uBAAuB,CAAC;AA4D/B,eAAO,MAAM,uCAAuC;;;;;;;;;kCAoOnD,CAAC"}
@@ -13,6 +13,7 @@ import { LabelAudience } from '@wildo-ai/presets-components-models';
13
13
  import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, } from '@wildo-ai/zod-decorators';
14
14
  import { CoreResourceOperation as Op, OAuthConsentGrantSchema, ResourcePrimaryScope, oauthConsentGrantsResourceConfiguration_InitializationFactory, } from '@wildo-ai/saas-models';
15
15
  import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
16
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
16
17
  const OAUTH_CONSENT_GRANT_EXAMPLE_ID = 'oauth_consent_grant_01J4M2N8K3PX7Q9R5T6V0W1Y2Z';
17
18
  const OAUTH_CONSENT_GRANT_OIDC_EXAMPLE_ID = 'oauth_consent_grant_01J4M2S1F8C6H7K9P0Q3R5T6V8';
18
19
  const OAUTH_CONSENT_GRANT_EXAMPLE_USER_ID = 'user_01J4M1Z2X3C4V5B6N7M8Q9R0ST';
@@ -67,6 +68,7 @@ export const oauthConsentGrantsResourceSpecification = resourceSpecification(oau
67
68
  businessRole: 'The user-facing "authorized apps" inventory: each grant identifies one registered OAuth client, the identity scopes the user approved and, when present, the RFC 8707 resource that delegation targets.',
68
69
  lifecycleRole: 'Created when the user approves an interactive consent request and chooses to remember the application, widened only after a later explicit approval, and retained until it expires or the user revokes it.',
69
70
  audience: LabelAudience.END_USER,
71
+ subDomain: EngineResourceSubDomain.AUTH,
70
72
  codeHandling: {
71
73
  mainSchema: {
72
74
  packageName: '@wildo-ai/saas-models',
@@ -104,7 +106,7 @@ export const oauthConsentGrantsResourceSpecification = resourceSpecification(oau
104
106
  },
105
107
  fields: {
106
108
  _id: schemaShape._id.stringSpec({
107
- meaning: 'Identifier for one persistent consent grant row.',
109
+ meaning: 'Identifier for one persistent consent grant record.',
108
110
  whyItMatters: 'The revoke target when a user removes an authorized app.',
109
111
  semanticRole: 'identifier',
110
112
  importance: FieldSemanticImportance.PRIMARY,
@@ -1 +1 @@
1
- {"version":3,"file":"oauth-consent-grants.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/auth/resources/oauth-consent-grants.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource: `oauthConsentGrants` — Wildo SaaS engine specification (backend-managed, user-scoped).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/security/oauth-clients/oauth-consent-grants.shared.schemas.ts → `OAuthConsentGrantSchema`\n * - Factory: engine/saas-models/src/security/oauth-clients/oauth-consent-grants.shared.resources-config.schemas.ts\n * → `oauthConsentGrantsResourceConfiguration_InitializationFactory`\n * - Custom operations: none\n * - UI presets: none (no engine `resourceUIBehavior` preset; the OIDC consent flow + a future\n * \"authorized apps\" settings surface consume the owner READ/LIST/DELETE API).\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 OAuthConsentGrantSchema,\n ResourcePrimaryScope,\n oauthConsentGrantsResourceConfiguration_InitializationFactory,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\n\nconst OAUTH_CONSENT_GRANT_EXAMPLE_ID = 'oauth_consent_grant_01J4M2N8K3PX7Q9R5T6V0W1Y2Z';\nconst OAUTH_CONSENT_GRANT_OIDC_EXAMPLE_ID = 'oauth_consent_grant_01J4M2S1F8C6H7K9P0Q3R5T6V8';\nconst OAUTH_CONSENT_GRANT_EXAMPLE_USER_ID = 'user_01J4M1Z2X3C4V5B6N7M8Q9R0ST';\n\nconst oauthConsentGrantDelegationExample = {\n _id: OAUTH_CONSENT_GRANT_EXAMPLE_ID,\n userId: OAUTH_CONSENT_GRANT_EXAMPLE_USER_ID,\n clientId: 'oc_01J4M24B7N8Q9R0ST1V2W3X4YZ',\n resource: 'https://api.example.com/agents/procurement',\n scopes: ['openid', 'profile', 'email'],\n createdAt: '2026-08-18T09:30:00.000Z',\n updatedAt: '2026-08-18T09:30:00.000Z',\n};\n\nconst oauthConsentGrantOidcExample = {\n _id: OAUTH_CONSENT_GRANT_OIDC_EXAMPLE_ID,\n userId: OAUTH_CONSENT_GRANT_EXAMPLE_USER_ID,\n clientId: 'oc_01J4M28D2F3G4H5J6K7P8Q9R0S',\n scopes: ['openid', 'profile'],\n createdAt: '2026-08-17T14:05:00.000Z',\n updatedAt: '2026-08-17T14:05:00.000Z',\n};\n\nconst oauthConsentGrantDelegationSummaryExample = {\n _id: oauthConsentGrantDelegationExample._id,\n userId: oauthConsentGrantDelegationExample.userId,\n clientId: oauthConsentGrantDelegationExample.clientId,\n resource: oauthConsentGrantDelegationExample.resource,\n createdAt: oauthConsentGrantDelegationExample.createdAt,\n};\n\nconst oauthConsentGrantOidcSummaryExample = {\n _id: oauthConsentGrantOidcExample._id,\n userId: oauthConsentGrantOidcExample.userId,\n clientId: oauthConsentGrantOidcExample.clientId,\n createdAt: oauthConsentGrantOidcExample.createdAt,\n};\n\nconst OAUTH_CONSENT_GRANT_PAGE_REQUEST = {\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n};\n\nfunction oauthConsentGrantPage<T>(data: readonly T[]) {\n return {\n data,\n pagination: {\n page: 1,\n limit: 20,\n total: data.length,\n totalPages: data.length === 0 ? 0 : 1,\n },\n };\n}\n\nexport const oauthConsentGrantsResourceSpecification = resourceSpecification(\n oauthConsentGrantsResourceConfiguration_InitializationFactory,\n OAuthConsentGrantSchema,\n ({ schemaShape }) => ({\n purpose: 'Record the third-party applications a signed-in user chose to remember after granting OIDC consent, so the application can avoid repeating an unchanged consent prompt.',\n businessRole: 'The user-facing \"authorized apps\" inventory: each grant identifies one registered OAuth client, the identity scopes the user approved and, when present, the RFC 8707 resource that delegation targets.',\n lifecycleRole: 'Created when the user approves an interactive consent request and chooses to remember the application, widened only after a later explicit approval, and retained until it expires or the user revokes it.',\n audience: LabelAudience.END_USER,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'OAuthConsentGrantSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'oauthConsentGrantsResourceConfiguration_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: 'OAUTH_CONSENT_GRANTS',\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 'READ/LIST/DELETE are owner-facing (API_CALL + APP_USER): the USER_SELF primary-scope filter restricts every result to the authenticated user\\'s own grants. CREATE/UPDATE are INTERNAL_CALL — the OIDC consent-decision endpoint is the sole writer via createAsSystem/updateAsSystem.',\n 'No `userNotifications` / `m2mNotifications` — granting or revoking consent is not an email/alert event.',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Identifier for one persistent consent grant row.',\n whyItMatters: 'The revoke target when a user removes an authorized app.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n userId: schemaShape.userId.foreignKeySpec({\n meaning: 'The Wildo user who granted consent — the USER_SELF scope owner.',\n whyItMatters: 'Scopes every read/list/delete to this user\\'s own grants and drives the cascade delete when the user is removed.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n clientId: schemaShape.clientId.stringSpec({\n meaning: 'The registered OAuth client the user authorized (its `_id`).',\n whyItMatters: 'Half of the grant identity — a grant authorizes exactly one client.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n resource: schemaShape.resource.stringSpec({\n meaning: 'The RFC 8707 resource (target A2A/MCP agent endpoint) this grant covers; absent for an OIDC-only login.',\n whyItMatters: 'Part of the grant grain — consent to act at one agent endpoint does not extend to another; a different resource requires fresh consent.',\n semanticRole: 'uri',\n }),\n scopes: schemaShape.scopes.arraySpec({\n meaning: 'The identity scopes (e.g. openid, profile, email) the user granted this client.',\n whyItMatters: 'A later authorize whose requested scopes are a SUBSET of these skips the prompt; a request for a scope not in the grant re-prompts (no silent scope expansion).',\n elementMeaning: 'One granted OIDC identity scope string.',\n }),\n expiresAt: schemaShape.expiresAt.dateSpec({\n meaning: 'Optional expiry after which the grant is ignored (fail-closed to a fresh prompt). Unset in v1 — grants persist until revoked.',\n whyItMatters: 'Future-proofs an operator consent-TTL policy without a schema change.',\n temporalRole: 'expiration',\n }),\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the grant was first stored.',\n whyItMatters: 'Ordering for the \"authorized apps\" list.',\n temporalRole: 'creation',\n }),\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'When the approved scope set was last changed.',\n whyItMatters: 'Lets a user or support workflow distinguish the original approval from a later explicit scope expansion.',\n temporalRole: 'modified',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Fetch one of the caller\\'s own consent grants.',\n outcome: 'The caller receives the authorized client, approved identity scopes, optional target resource and grant timestamps.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The caller\\'s own grant was found and returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The authenticated caller does not have the application-user authority required for this self-service API.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No grant with the supplied id is visible in the caller\\'s user-self scope; nonexistent and other users\\' grants are indistinguishable.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Inspect a remembered agent delegation',\n request: { oauthConsentGrantId: OAUTH_CONSENT_GRANT_EXAMPLE_ID },\n response: oauthConsentGrantDelegationExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: 'Inspect the grant with available relationship context',\n request: { oauthConsentGrantId: OAUTH_CONSENT_GRANT_EXAMPLE_ID },\n response: oauthConsentGrantDelegationExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: 'Inspect the compact grant summary',\n request: { oauthConsentGrantId: OAUTH_CONSENT_GRANT_EXAMPLE_ID },\n response: oauthConsentGrantDelegationSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n [Op.LIST]: {\n purpose: 'List the caller\\'s own consent grants — the \"authorized apps\" surface.',\n outcome: 'The user sees every client they have authorized and can choose which to revoke.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) set of the caller\\'s own consent grants.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks APP_USER; a user may only list their own grants (never another user\\'s).' },\n ],\n idempotent: true,\n examples: [{\n title: 'List remembered applications and delegations',\n request: OAUTH_CONSENT_GRANT_PAGE_REQUEST,\n response: oauthConsentGrantPage([\n oauthConsentGrantDelegationExample,\n oauthConsentGrantOidcExample,\n ]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: 'List grants with available relationship context',\n request: OAUTH_CONSENT_GRANT_PAGE_REQUEST,\n response: oauthConsentGrantPage([\n oauthConsentGrantDelegationExample,\n oauthConsentGrantOidcExample,\n ]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: 'List compact grant summaries',\n request: OAUTH_CONSENT_GRANT_PAGE_REQUEST,\n response: oauthConsentGrantPage([\n oauthConsentGrantDelegationSummaryExample,\n oauthConsentGrantOidcSummaryExample,\n ]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n [Op.CREATE]: {\n purpose: 'Store a new grant when the user approves consent and opts to remember the app (system write from the consent-decision endpoint).',\n outcome: 'Subsequent authorize requests the grant covers skip the consent prompt.',\n whenToUse: 'Only from the OIDC consent-decision endpoint via createAsSystem — never a public create.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A new consent grant is stored for the user + client + resource.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The grant payload fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-system caller attempts a create (this resource has no public CREATE surface).' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A grant already exists for this (user, client, resource) — a re-consent UPDATES the scopes instead.' },\n ],\n idempotent: false,\n },\n [Op.UPDATE]: {\n purpose: 'Widen a grant\\'s scopes when the user re-consents to the same client + resource with additional scopes (system write).',\n outcome: 'The stored grant reflects the newly approved scope set.',\n whenToUse: 'Only from the consent-decision endpoint via updateAsSystem.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The grant\\'s scopes were updated.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The updated scopes fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-system caller attempts an update.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No grant exists for the supplied id.' },\n ],\n idempotent: true,\n },\n [Op.DELETE]: {\n purpose: 'Revoke one of the caller\\'s remembered application grants.',\n outcome: 'The client is re-prompted for consent on its next authorize request.',\n whenToUse: 'When the signed-in user no longer trusts the client or wants to review its requested scopes again on the next authorization.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The grant was revoked; the client must obtain fresh consent next time. No body.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The authenticated caller does not have the application-user authority required for this self-service API.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No grant with the supplied id is visible in the caller\\'s user-self scope; this includes grants that were already revoked.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Revoke a remembered agent delegation',\n request: { oauthConsentGrantId: OAUTH_CONSENT_GRANT_EXAMPLE_ID },\n forStatus: HttpResponseStatusCode.NO_CONTENT_204,\n }],\n },\n },\n\n businessConstraints: [\n 'The uniqueness grain is `(userId, clientId, resource)` — one grant per client per resource; a re-consent updates that row rather than inserting a duplicate.',\n 'Consent-skip matching is scope-SUBSET: a stored grant lets `/oauth/authorize` skip the prompt only when the requested scopes are all already granted; a request for any new scope re-prompts (silent scope expansion is forbidden).',\n 'Scopes are identity-only and carry no authorization weight (authorization is roles-only); a consent grant records what the user agreed to disclose, not what the client may do.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.USER_SELF },\n);\n"]}
1
+ {"version":3,"file":"oauth-consent-grants.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/auth/resources/oauth-consent-grants.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource: `oauthConsentGrants` — Wildo SaaS engine specification (backend-managed, user-scoped).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/security/oauth-clients/oauth-consent-grants.shared.schemas.ts → `OAuthConsentGrantSchema`\n * - Factory: engine/saas-models/src/security/oauth-clients/oauth-consent-grants.shared.resources-config.schemas.ts\n * → `oauthConsentGrantsResourceConfiguration_InitializationFactory`\n * - Custom operations: none\n * - UI presets: none (no engine `resourceUIBehavior` preset; the OIDC consent flow + a future\n * \"authorized apps\" settings surface consume the owner READ/LIST/DELETE API).\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 OAuthConsentGrantSchema,\n ResourcePrimaryScope,\n oauthConsentGrantsResourceConfiguration_InitializationFactory,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\nconst OAUTH_CONSENT_GRANT_EXAMPLE_ID = 'oauth_consent_grant_01J4M2N8K3PX7Q9R5T6V0W1Y2Z';\nconst OAUTH_CONSENT_GRANT_OIDC_EXAMPLE_ID = 'oauth_consent_grant_01J4M2S1F8C6H7K9P0Q3R5T6V8';\nconst OAUTH_CONSENT_GRANT_EXAMPLE_USER_ID = 'user_01J4M1Z2X3C4V5B6N7M8Q9R0ST';\n\nconst oauthConsentGrantDelegationExample = {\n _id: OAUTH_CONSENT_GRANT_EXAMPLE_ID,\n userId: OAUTH_CONSENT_GRANT_EXAMPLE_USER_ID,\n clientId: 'oc_01J4M24B7N8Q9R0ST1V2W3X4YZ',\n resource: 'https://api.example.com/agents/procurement',\n scopes: ['openid', 'profile', 'email'],\n createdAt: '2026-08-18T09:30:00.000Z',\n updatedAt: '2026-08-18T09:30:00.000Z',\n};\n\nconst oauthConsentGrantOidcExample = {\n _id: OAUTH_CONSENT_GRANT_OIDC_EXAMPLE_ID,\n userId: OAUTH_CONSENT_GRANT_EXAMPLE_USER_ID,\n clientId: 'oc_01J4M28D2F3G4H5J6K7P8Q9R0S',\n scopes: ['openid', 'profile'],\n createdAt: '2026-08-17T14:05:00.000Z',\n updatedAt: '2026-08-17T14:05:00.000Z',\n};\n\nconst oauthConsentGrantDelegationSummaryExample = {\n _id: oauthConsentGrantDelegationExample._id,\n userId: oauthConsentGrantDelegationExample.userId,\n clientId: oauthConsentGrantDelegationExample.clientId,\n resource: oauthConsentGrantDelegationExample.resource,\n createdAt: oauthConsentGrantDelegationExample.createdAt,\n};\n\nconst oauthConsentGrantOidcSummaryExample = {\n _id: oauthConsentGrantOidcExample._id,\n userId: oauthConsentGrantOidcExample.userId,\n clientId: oauthConsentGrantOidcExample.clientId,\n createdAt: oauthConsentGrantOidcExample.createdAt,\n};\n\nconst OAUTH_CONSENT_GRANT_PAGE_REQUEST = {\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n};\n\nfunction oauthConsentGrantPage<T>(data: readonly T[]) {\n return {\n data,\n pagination: {\n page: 1,\n limit: 20,\n total: data.length,\n totalPages: data.length === 0 ? 0 : 1,\n },\n };\n}\n\nexport const oauthConsentGrantsResourceSpecification = resourceSpecification(\n oauthConsentGrantsResourceConfiguration_InitializationFactory,\n OAuthConsentGrantSchema,\n ({ schemaShape }) => ({\n purpose: 'Record the third-party applications a signed-in user chose to remember after granting OIDC consent, so the application can avoid repeating an unchanged consent prompt.',\n businessRole: 'The user-facing \"authorized apps\" inventory: each grant identifies one registered OAuth client, the identity scopes the user approved and, when present, the RFC 8707 resource that delegation targets.',\n lifecycleRole: 'Created when the user approves an interactive consent request and chooses to remember the application, widened only after a later explicit approval, and retained until it expires or the user revokes it.',\n audience: LabelAudience.END_USER,\n subDomain: EngineResourceSubDomain.AUTH,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'OAuthConsentGrantSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'oauthConsentGrantsResourceConfiguration_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: 'OAUTH_CONSENT_GRANTS',\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 'READ/LIST/DELETE are owner-facing (API_CALL + APP_USER): the USER_SELF primary-scope filter restricts every result to the authenticated user\\'s own grants. CREATE/UPDATE are INTERNAL_CALL — the OIDC consent-decision endpoint is the sole writer via createAsSystem/updateAsSystem.',\n 'No `userNotifications` / `m2mNotifications` — granting or revoking consent is not an email/alert event.',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Identifier for one persistent consent grant record.',\n whyItMatters: 'The revoke target when a user removes an authorized app.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n userId: schemaShape.userId.foreignKeySpec({\n meaning: 'The Wildo user who granted consent — the USER_SELF scope owner.',\n whyItMatters: 'Scopes every read/list/delete to this user\\'s own grants and drives the cascade delete when the user is removed.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n clientId: schemaShape.clientId.stringSpec({\n meaning: 'The registered OAuth client the user authorized (its `_id`).',\n whyItMatters: 'Half of the grant identity — a grant authorizes exactly one client.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n resource: schemaShape.resource.stringSpec({\n meaning: 'The RFC 8707 resource (target A2A/MCP agent endpoint) this grant covers; absent for an OIDC-only login.',\n whyItMatters: 'Part of the grant grain — consent to act at one agent endpoint does not extend to another; a different resource requires fresh consent.',\n semanticRole: 'uri',\n }),\n scopes: schemaShape.scopes.arraySpec({\n meaning: 'The identity scopes (e.g. openid, profile, email) the user granted this client.',\n whyItMatters: 'A later authorize whose requested scopes are a SUBSET of these skips the prompt; a request for a scope not in the grant re-prompts (no silent scope expansion).',\n elementMeaning: 'One granted OIDC identity scope string.',\n }),\n expiresAt: schemaShape.expiresAt.dateSpec({\n meaning: 'Optional expiry after which the grant is ignored (fail-closed to a fresh prompt). Unset in v1 — grants persist until revoked.',\n whyItMatters: 'Future-proofs an operator consent-TTL policy without a schema change.',\n temporalRole: 'expiration',\n }),\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the grant was first stored.',\n whyItMatters: 'Ordering for the \"authorized apps\" list.',\n temporalRole: 'creation',\n }),\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'When the approved scope set was last changed.',\n whyItMatters: 'Lets a user or support workflow distinguish the original approval from a later explicit scope expansion.',\n temporalRole: 'modified',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Fetch one of the caller\\'s own consent grants.',\n outcome: 'The caller receives the authorized client, approved identity scopes, optional target resource and grant timestamps.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The caller\\'s own grant was found and returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The authenticated caller does not have the application-user authority required for this self-service API.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No grant with the supplied id is visible in the caller\\'s user-self scope; nonexistent and other users\\' grants are indistinguishable.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Inspect a remembered agent delegation',\n request: { oauthConsentGrantId: OAUTH_CONSENT_GRANT_EXAMPLE_ID },\n response: oauthConsentGrantDelegationExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: 'Inspect the grant with available relationship context',\n request: { oauthConsentGrantId: OAUTH_CONSENT_GRANT_EXAMPLE_ID },\n response: oauthConsentGrantDelegationExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: 'Inspect the compact grant summary',\n request: { oauthConsentGrantId: OAUTH_CONSENT_GRANT_EXAMPLE_ID },\n response: oauthConsentGrantDelegationSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n [Op.LIST]: {\n purpose: 'List the caller\\'s own consent grants — the \"authorized apps\" surface.',\n outcome: 'The user sees every client they have authorized and can choose which to revoke.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) set of the caller\\'s own consent grants.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks APP_USER; a user may only list their own grants (never another user\\'s).' },\n ],\n idempotent: true,\n examples: [{\n title: 'List remembered applications and delegations',\n request: OAUTH_CONSENT_GRANT_PAGE_REQUEST,\n response: oauthConsentGrantPage([\n oauthConsentGrantDelegationExample,\n oauthConsentGrantOidcExample,\n ]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: 'List grants with available relationship context',\n request: OAUTH_CONSENT_GRANT_PAGE_REQUEST,\n response: oauthConsentGrantPage([\n oauthConsentGrantDelegationExample,\n oauthConsentGrantOidcExample,\n ]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: 'List compact grant summaries',\n request: OAUTH_CONSENT_GRANT_PAGE_REQUEST,\n response: oauthConsentGrantPage([\n oauthConsentGrantDelegationSummaryExample,\n oauthConsentGrantOidcSummaryExample,\n ]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n [Op.CREATE]: {\n purpose: 'Store a new grant when the user approves consent and opts to remember the app (system write from the consent-decision endpoint).',\n outcome: 'Subsequent authorize requests the grant covers skip the consent prompt.',\n whenToUse: 'Only from the OIDC consent-decision endpoint via createAsSystem — never a public create.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A new consent grant is stored for the user + client + resource.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The grant payload fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-system caller attempts a create (this resource has no public CREATE surface).' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A grant already exists for this (user, client, resource) — a re-consent UPDATES the scopes instead.' },\n ],\n idempotent: false,\n },\n [Op.UPDATE]: {\n purpose: 'Widen a grant\\'s scopes when the user re-consents to the same client + resource with additional scopes (system write).',\n outcome: 'The stored grant reflects the newly approved scope set.',\n whenToUse: 'Only from the consent-decision endpoint via updateAsSystem.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The grant\\'s scopes were updated.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The updated scopes fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-system caller attempts an update.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No grant exists for the supplied id.' },\n ],\n idempotent: true,\n },\n [Op.DELETE]: {\n purpose: 'Revoke one of the caller\\'s remembered application grants.',\n outcome: 'The client is re-prompted for consent on its next authorize request.',\n whenToUse: 'When the signed-in user no longer trusts the client or wants to review its requested scopes again on the next authorization.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The grant was revoked; the client must obtain fresh consent next time. No body.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The authenticated caller does not have the application-user authority required for this self-service API.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No grant with the supplied id is visible in the caller\\'s user-self scope; this includes grants that were already revoked.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Revoke a remembered agent delegation',\n request: { oauthConsentGrantId: OAUTH_CONSENT_GRANT_EXAMPLE_ID },\n forStatus: HttpResponseStatusCode.NO_CONTENT_204,\n }],\n },\n },\n\n businessConstraints: [\n 'The uniqueness grain is `(userId, clientId, resource)` — one grant per client per resource; a re-consent updates that row rather than inserting a duplicate.',\n 'Consent-skip matching is scope-SUBSET: a stored grant lets `/oauth/authorize` skip the prompt only when the requested scopes are all already granted; a request for any new scope re-prompts (silent scope expansion is forbidden).',\n 'Scopes are identity-only and carry no authorization weight (authorization is roles-only); a consent grant records what the user agreed to disclose, not what the client may do.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.USER_SELF },\n);\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"organization-api-keys.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/auth/resources/organization-api-keys.resource.specification.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,IAAI,EAAE,EAC3B,qBAAqB,EAGtB,MAAM,uBAAuB,CAAC;AA2C/B,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;iCAkfpD,CAAC"}
1
+ {"version":3,"file":"organization-api-keys.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/auth/resources/organization-api-keys.resource.specification.ts"],"names":[],"mappings":"AAWA,OAAO,EAEL,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,IAAI,EAAE,EAC3B,qBAAqB,EAGtB,MAAM,uBAAuB,CAAC;AA4C/B,eAAO,MAAM,wCAAwC;;;;;;;;;;;;;;;;;iCA+fpD,CAAC"}
@@ -3,6 +3,7 @@ import { LabelAudience } from '@wildo-ai/presets-components-models';
3
3
  import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, } from '@wildo-ai/zod-decorators';
4
4
  import { ApiKeyOrganizationSchema, ApiKeyScope, ApiKeyStatus, CORE_ORG_ROLES, CoreResourceOperation as Op, OrgApiKeys_Operations, ResourcePrimaryScope, orgApiKeysResourceConfiguration_InitializationFactory as orgApiKeysFactory, } from '@wildo-ai/saas-models';
5
5
  import { HttpResponseStatusCode, mergeResourceFrontendConfigurations, resourceFrontendConfiguration, resourceSpecification, resourceSpecificationFromFrontendConfiguration, } from '../../../_core/index.js';
6
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
6
7
  const orgApiKeysMainUIBehavior = orgApiKeysMainSource;
7
8
  const orgApiKeysAdminUIBehavior = orgApiKeysAdminSource;
8
9
  /**
@@ -34,6 +35,7 @@ export const organizationApiKeysResourceSpecification = resourceSpecificationFro
34
35
  businessRole: 'First-class auth credential for automation and partner integrations, distinct from end-user sessions.',
35
36
  lifecycleRole: 'Created with optional expiry, then rotated, deactivated or deleted by organization administrators. Per-key request analytics are not currently recorded.',
36
37
  audience: LabelAudience.DEVELOPER,
38
+ subDomain: EngineResourceSubDomain.AUTH,
37
39
  codeHandling: {
38
40
  mainSchema: {
39
41
  packageName: '@wildo-ai/saas-models',
@@ -104,7 +106,7 @@ export const organizationApiKeysResourceSpecification = resourceSpecificationFro
104
106
  },
105
107
  }),
106
108
  keyPrefix: schemaShape.keyPrefix.stringSpec({
107
- meaning: 'Short public prefix of the key material for list rows and support correlation.',
109
+ meaning: 'Short public prefix of the key material for list records and support correlation.',
108
110
  }),
109
111
  roles: schemaShape.roles.arraySpec({
110
112
  meaning: 'Roles embedded on the key; every request authenticated with it inherits exactly these roles, bounding what the integration or automation user may do (least-privilege).',
@@ -301,6 +303,18 @@ export const organizationApiKeysResourceSpecification = resourceSpecificationFro
301
303
  forStatus: HttpResponseStatusCode.OK_200,
302
304
  }],
303
305
  },
306
+ /**
307
+ * INTERNAL_CALL, so this entry documents SEMANTICS and deliberately carries no HTTP
308
+ * response statuses, error scenarios or examples: there is no route to call and no
309
+ * response a consumer receives. Authoring a `200 OK` example here would document a door
310
+ * that does not exist, which is worse than the silence.
311
+ */
312
+ [OrgApiKeys_Operations.EXPIRE]: {
313
+ operationId: OrgApiKeys_Operations.EXPIRE,
314
+ purpose: 'Record that a key’s validity window has elapsed, so a listing shows it as expired rather than active.',
315
+ outcome: 'Status becomes expired. Nothing about authentication changes — the key already stopped working the instant its expiry passed.',
316
+ whenToUse: 'Never called directly. The nightly credential-expiry sweep dispatches it; an administrator who wants a key gone sooner deactivates it, and one who wants it to last longer extends its expiry.',
317
+ },
304
318
  [OrgApiKeys_Operations.DEACTIVATE]: {
305
319
  operationId: OrgApiKeys_Operations.DEACTIVATE,
306
320
  purpose: 'Turn off authentication for an active key without deleting its metadata.',