@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
@@ -1 +1 @@
1
- {"version":3,"file":"files.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/files/resources/files.resource.specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAIL,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,IAAI,EAAE,EAE3B,UAAU,EAEV,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAG/B,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCA+WtC,CAAC"}
1
+ {"version":3,"file":"files.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/files/resources/files.resource.specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAIL,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,IAAI,EAAE,EAE3B,UAAU,EAEV,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAI/B,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAgXtC,CAAC"}
@@ -12,11 +12,13 @@ import { LabelAudience } from '@wildo-ai/presets-components-models';
12
12
  import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, FileDisplayNature, FileStorageAccepted, FileUploaderEntityType, } from '@wildo-ai/zod-decorators';
13
13
  import { CoreResourceOperation as Op, FileSchema, FileStatus, filesResourceConfiguration_InitializationFactory, ResourcePrimaryScope, } from '@wildo-ai/saas-models';
14
14
  import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
15
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
15
16
  export const filesResourceSpecification = resourceSpecification(filesResourceConfiguration_InitializationFactory, FileSchema, ({ schemaShape }) => ({
16
17
  purpose: 'Store file metadata (name, MIME, storage pointers, lifecycle, and scope) for assets managed by the platform file service.',
17
18
  businessRole: 'The shared “file row” truth that links uploaded bytes in object storage to domain resources through `linkedResource*` fields.',
18
19
  lifecycleRole: 'Moves from `PENDING` upload through `UPLOADED`, optional AV / extraction states, linking to business records, and eventual `DELETED` / `ORPHANED` cleanup.',
19
20
  audience: LabelAudience.END_USER,
21
+ subDomain: EngineResourceSubDomain.FILES,
20
22
  codeHandling: {
21
23
  mainSchema: {
22
24
  packageName: '@wildo-ai/saas-models',
@@ -117,7 +119,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
117
119
  semanticRole: 'uri',
118
120
  }),
119
121
  status: schemaShape.status.enumSpec({
120
- meaning: 'Lifecycle state for upload, AV, linkage, and deletion. Text extraction/indexing state is NOT here — it lives on the per-field RAG chunk rows.',
122
+ meaning: 'Lifecycle state for upload, AV, linkage, and deletion. Text extraction/indexing state is NOT here — it lives on the per-field RAG chunk records.',
121
123
  importance: FieldSemanticImportance.PRIMARY,
122
124
  enumDeclaration: {
123
125
  packageName: '@wildo-ai/saas-models',
@@ -126,12 +128,12 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
126
128
  declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
127
129
  },
128
130
  values: {
129
- [FileStatus.PENDING]: { meaning: 'Upload not finished — metadata row exists, bytes not ready yet.' },
131
+ [FileStatus.PENDING]: { meaning: 'Upload not finished — metadata record exists, bytes not ready yet.' },
130
132
  [FileStatus.UPLOADED]: { meaning: 'Bytes are stored and ready for post-processing or linking.' },
131
133
  [FileStatus.LINKED]: { meaning: 'Bound to a parent resource’s `z_file()` field; primary happy path for production assets.' },
132
134
  [FileStatus.DELETED]: { meaning: 'Soft-deleted; bytes may still exist until vacuum jobs run.' },
133
135
  [FileStatus.ORPHANED]: { meaning: 'No live parent link — retained for re-link or background cleanup only.' },
134
- [FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this row.' },
136
+ [FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this record.' },
135
137
  [FileStatus.SCANNING]: { meaning: 'AV pipeline is running before download is allowed in hardened tenants.' },
136
138
  [FileStatus.CLEAN]: { meaning: 'AV says the payload is not malicious.' },
137
139
  [FileStatus.INFECTED]: { meaning: 'Quarantine candidate — do not serve for download.' },
@@ -175,7 +177,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
175
177
  semanticRole: 'code',
176
178
  }),
177
179
  primaryScope: schemaShape.primaryScope.enumSpec({
178
- meaning: 'Which isolation bucket this row participates in: app-wide, org-wide, or user-private (within an org).',
180
+ meaning: 'Which isolation bucket this record participates in: app-wide, org-wide, or user-private (within an org).',
179
181
  whyItMatters: 'Field is optional at rest until an upload binds scope identifiers; `FileSchema` superRefine enforces consistency between `primaryScope` and the id triple.',
180
182
  enumDeclaration: {
181
183
  packageName: '@wildo-ai/saas-models',
@@ -198,11 +200,11 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
198
200
  semanticRole: 'identifier',
199
201
  }),
200
202
  userId: schemaShape.userId.stringSpec({
201
- meaning: 'User id for `USER_SELF` scoped file rows, paired with `organizationId` as required by `validateFileScopeIdentifiers`.',
203
+ meaning: 'User id for `USER_SELF` scoped file records, paired with `organizationId` as required by `validateFileScopeIdentifiers`.',
202
204
  semanticRole: 'identifier',
203
205
  }),
204
206
  uploadedBy: schemaShape.uploadedBy.stringSpec({
205
- meaning: 'Raw uploader id when the uploader is not necessarily a Wildo `users` row (service principal, system job, …).',
207
+ meaning: 'Raw uploader id when the uploader is not necessarily a Wildo `users` record (service principal, system job, …).',
206
208
  semanticRole: 'identifier',
207
209
  }),
208
210
  uploadedByEntityType: schemaShape.uploadedByEntityType.enumSpec({
@@ -241,7 +243,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
241
243
  whenToUse: 'Use in server-side `FilesBackendService` flows — not exposed to anonymous callers for arbitrary ids.',
242
244
  importance: FieldSemanticImportance.PRIMARY,
243
245
  responseStatuses: [
244
- { code: HttpResponseStatusCode.OK_200, meaning: 'The file metadata row for the supplied `fileId` was found and its storage pointers, lifecycle `status`, and `linkedResource*` fields are returned.' },
246
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The file metadata record for the supplied `fileId` was found and its storage pointers, lifecycle `status`, and `linkedResource*` fields are returned.' },
245
247
  ],
246
248
  errorScenarios: [
247
249
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (never created, or already hard-deleted after soft-delete vacuum).' },
@@ -254,7 +256,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
254
256
  outcome: 'Background jobs and admin UIs can page through the storage ledger under org/app isolation.',
255
257
  whenToUse: 'Use in cleanup jobs, quota dashboards, or when syncing CDN metadata for the tenant.',
256
258
  responseStatuses: [
257
- { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of file metadata rows matching the uploader / linkage / scope filters under org/app isolation.' },
259
+ { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of file metadata records matching the uploader / linkage / scope filters under org/app isolation.' },
258
260
  ],
259
261
  errorScenarios: [
260
262
  { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the role required to page the storage ledger for the requested scope.' },
@@ -267,7 +269,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
267
269
  whenToUse: 'Use on upload start or completion events before linking to a parent resource’s `z_file()` slot.',
268
270
  importance: FieldSemanticImportance.PRIMARY,
269
271
  responseStatuses: [
270
- { code: HttpResponseStatusCode.CREATED_201, meaning: 'A file metadata row was materialized with its server-assigned `fileId` and initial `PENDING`/`UPLOADED` status. Internal/service write path — `FilesBackendService` drives this from upload flows, not a public CRUD controller.' },
272
+ { code: HttpResponseStatusCode.CREATED_201, meaning: 'A file metadata record was materialized with its server-assigned `fileId` and initial `PENDING`/`UPLOADED` status. Internal/service write path — `FilesBackendService` drives this from upload flows, not a public CRUD controller.' },
271
273
  ],
272
274
  errorScenarios: [
273
275
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The upload metadata fails validation — a disallowed `mimeType`, a `size` over the configured per-scope upload limit (over-size is surfaced here, not as a transport-level 413), or scope ids inconsistent with `primaryScope` per `validateFileScopeIdentifiers`.', errorCode: 'VALIDATION_FAILED' },
@@ -303,7 +305,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
303
305
  whenToUse: 'Use in workers and trusted services; users never mutate this row ad hoc in consumer APIs.',
304
306
  importance: FieldSemanticImportance.PRIMARY,
305
307
  responseStatuses: [
306
- { code: HttpResponseStatusCode.OK_200, meaning: 'The metadata patch (lifecycle `status`, `linkedResource*`, `size`, storage pointers, or media analytics) was applied and the updated row is returned. Internal/service write path owned by workers and trusted services.' },
308
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The metadata patch (lifecycle `status`, `linkedResource*`, `size`, storage pointers, or media analytics) was applied and the updated record is returned. Internal/service write path owned by workers and trusted services.' },
307
309
  ],
308
310
  errorScenarios: [
309
311
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` to patch.' },
@@ -1 +1 @@
1
- {"version":3,"file":"files.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/files/resources/files.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource: `files` — Wildo SaaS engine specification (backend-only).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/files/files.shared.schemas.ts → `FileSchema`\n * - Factory: engine/saas-models/src/files/files.shared.resources-config.schemas.ts\n * → `filesResourceConfiguration_InitializationFactory`\n * - Custom operations: none\n * - UI presets: none\n */\n\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n FileDisplayNature,\n FileStorageAccepted,\n FileUploaderEntityType,\n} from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n FileSchema,\n FileStatus,\n filesResourceConfiguration_InitializationFactory,\n ResourcePrimaryScope,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\n\nexport const filesResourceSpecification = resourceSpecification(\n filesResourceConfiguration_InitializationFactory,\n FileSchema,\n ({ schemaShape }) => ({\n purpose: 'Store file metadata (name, MIME, storage pointers, lifecycle, and scope) for assets managed by the platform file service.',\n businessRole: 'The shared “file row” truth that links uploaded bytes in object storage to domain resources through `linkedResource*` fields.',\n lifecycleRole: 'Moves from `PENDING` upload through `UPLOADED`, optional AV / extraction states, linking to business records, and eventual `DELETED` / `ORPHANED` cleanup.',\n audience: LabelAudience.END_USER,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'filesResourceConfiguration_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: 'FILES',\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 'Repository-only resource: all operations are `REPOSITORY_ONLY` — `FilesBackendService` is the intended entry point, not public CRUD controllers.',\n 'Per-record `primaryScope` + scope id fields can represent APPLICATION, ORGANIZATIONS, or USER_SELF rows; the resource-level `resourcePrimaryScope` declared here is the registry default for the FILES type, not every row’s dynamic scope.',\n ],\n },\n\n fields: {\n fileId: schemaShape.fileId.stringSpec({\n meaning: 'Stable public identifier for this file metadata document, embedded in storage keys and download URLs. It is a virtual projection of the document’s underlying Mongo `_id` (`fileId === String(_id)`), so the file has a single stored identity and there is no separate persisted `fileId` field.',\n whyItMatters: 'This is the identifier other resources store in `z_file()` fields and that presigned URL flows reference. Because it projects `_id`, the value is allocated by the database at insert time rather than minted before the row exists, so creation is insert-first.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n filename: schemaShape.filename.stringSpec({\n meaning: 'Sanitized filename used in UI and download headers.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'label',\n }),\n\n originalFilename: schemaShape.originalFilename.stringSpec({\n meaning: 'Original client-provided filename before sanitization for audit/support.',\n semanticRole: 'label',\n }),\n\n mimeType: schemaShape.mimeType.stringSpec({\n meaning: 'IANA-style MIME classification for validation, AV routing, and viewer choice.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n size: schemaShape.size.numberSpec({\n meaning: 'Byte length of the stored object after upload completes.',\n unit: 'bytes',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n extension: schemaShape.extension.stringSpec({\n meaning: 'Filename extension snapshot (without dot) for quick filtering when MIME is generic.',\n semanticRole: 'code',\n }),\n\n checksum: schemaShape.checksum.stringSpec({\n meaning: 'Optional content hash for deduplication and integrity checks after upload.',\n semanticRole: 'code',\n }),\n\n storageProvider: schemaShape.storageProvider.enumSpec({\n meaning: 'Which registered storage backend (S3-compatible, local, …) holds the bytes.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileStorageAccepted',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStorageAccepted.WILDO_MANAGED]: { meaning: 'Managed object storage (S3-compatible) selected by the platform default configuration.' },\n [FileStorageAccepted.LOCAL_DIRECTORY]: { meaning: 'Local filesystem directory for development or air-gapped single-node installs.' },\n [FileStorageAccepted.ONEDRIVE]: { meaning: 'Optional Microsoft OneDrive-backed storage when an app enables the connector.' },\n [FileStorageAccepted.GOOGLE_DRIVE]: { meaning: 'Optional Google Drive-backed storage when an app enables the connector.' },\n [FileStorageAccepted.DROPBOX]: { meaning: 'Optional Dropbox-backed storage when an app enables the connector.' },\n },\n }),\n\n storageRef: schemaShape.storageRef.stringSpec({\n meaning: 'Opaque handle the active storage adapter uses to retrieve bytes (bucket/key tuple is adapter-specific).',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'identifier',\n }),\n\n storageKey: schemaShape.storageKey.stringSpec({\n meaning: 'Derived, human-debuggable key encoding the scope path (`app/...`, `org/...`, `user/...`) and `fileId`, used in logs and migrations. Because it depends on the database-assigned `fileId`, it is populated immediately after insert and is optional at rest until then.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n url: schemaShape.url.stringSpec({\n meaning: 'Cached HTTP(S) URL when a long-lived public or CDN URL is available (may be presigned elsewhere).',\n semanticRole: 'uri',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Lifecycle state for upload, AV, linkage, and deletion. Text extraction/indexing state is NOT here — it lives on the per-field RAG chunk rows.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStatus.PENDING]: { meaning: 'Upload not finished — metadata row exists, bytes not ready yet.' },\n [FileStatus.UPLOADED]: { meaning: 'Bytes are stored and ready for post-processing or linking.' },\n [FileStatus.LINKED]: { meaning: 'Bound to a parent resource’s `z_file()` field; primary happy path for production assets.' },\n [FileStatus.DELETED]: { meaning: 'Soft-deleted; bytes may still exist until vacuum jobs run.' },\n [FileStatus.ORPHANED]: { meaning: 'No live parent link — retained for re-link or background cleanup only.' },\n [FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this row.' },\n [FileStatus.SCANNING]: { meaning: 'AV pipeline is running before download is allowed in hardened tenants.' },\n [FileStatus.CLEAN]: { meaning: 'AV says the payload is not malicious.' },\n [FileStatus.INFECTED]: { meaning: 'Quarantine candidate — do not serve for download.' },\n [FileStatus.QUARANTINED]: { meaning: 'Isolated for operator review; download blocked by policy.' },\n },\n }),\n\n nature: schemaShape.nature.enumSpec({\n meaning: 'Resolved high-level file kind (image / video / document) used for template selection, not raw MIME subtypes alone.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileDisplayNature',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileDisplayNature.IMAGE]: { meaning: 'Raster/vector still asset suitable for lightbox and thumbnail UIs.' },\n [FileDisplayNature.VIDEO]: { meaning: 'Time-based media; shows duration and streaming-friendly player chrome.' },\n [FileDisplayNature.AUDIO]: { meaning: 'Sound-only media with duration metadata.' },\n [FileDisplayNature.DOCUMENT]: { meaning: 'Text-first assets such as office/PDF/structured docs.' },\n [FileDisplayNature.GENERIC]: { meaning: 'Fallback bucket when a generic download affordance is enough.' },\n },\n }),\n\n width: schemaShape.width.numberSpec({ meaning: 'Image/video width in pixels when known.' }),\n height: schemaShape.height.numberSpec({ meaning: 'Image/video height in pixels when known.' }),\n duration: schemaShape.duration.numberSpec({ meaning: 'Audio/video length in seconds when analyzers provide it.' }),\n pageCount: schemaShape.pageCount.numberSpec({ meaning: 'Page count for paginated document previews when the analyzer could infer it.' }),\n\n thumbnailUrl: schemaShape.thumbnailUrl.stringSpec({\n meaning: 'Optional derived thumbnail or poster frame URL for list/grid UIs.',\n semanticRole: 'uri',\n }),\n\n linkedResourceType: schemaShape.linkedResourceType.stringSpec({\n meaning: 'When linked, the `CoreResourceType` (string form) of the parent record carrying the `z_file()` field.',\n semanticRole: 'code',\n }),\n\n linkedResourceId: schemaShape.linkedResourceId.stringSpec({\n meaning: 'Primary id of the parent resource using this file, when linked.',\n semanticRole: 'identifier',\n }),\n\n linkedFieldName: schemaShape.linkedFieldName.stringSpec({\n meaning: 'Field name on the parent schema (e.g. `avatarId`) to support multi-file parents.',\n semanticRole: 'code',\n }),\n\n primaryScope: schemaShape.primaryScope.enumSpec({\n meaning: 'Which isolation bucket this row participates in: app-wide, org-wide, or user-private (within an org).',\n whyItMatters:\n 'Field is optional at rest until an upload binds scope identifiers; `FileSchema` superRefine enforces consistency between `primaryScope` and the id triple.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ResourcePrimaryScope',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ResourcePrimaryScope.APPLICATION]: { meaning: 'App-wide marketing/branding or singleton assets (uses `applicationId` only).' },\n [ResourcePrimaryScope.ORGANIZATIONS]: { meaning: 'Shared within a tenant; uses `organizationId` only.' },\n [ResourcePrimaryScope.USER_SELF]: { meaning: 'Private to a user, but still in org context; requires `organizationId` + `userId` per file scope rules.' },\n },\n }),\n\n applicationId: schemaShape.applicationId.stringSpec({\n meaning: 'Parent application id when `primaryScope` is `APPLICATION`.',\n semanticRole: 'identifier',\n }),\n\n organizationId: schemaShape.organizationId.stringSpec({\n meaning: 'Org id for org-scoped files and as local context for user-private files.',\n semanticRole: 'identifier',\n }),\n\n userId: schemaShape.userId.stringSpec({\n meaning: 'User id for `USER_SELF` scoped file rows, paired with `organizationId` as required by `validateFileScopeIdentifiers`.',\n semanticRole: 'identifier',\n }),\n\n uploadedBy: schemaShape.uploadedBy.stringSpec({\n meaning: 'Raw uploader id when the uploader is not necessarily a Wildo `users` row (service principal, system job, …).',\n semanticRole: 'identifier',\n }),\n\n uploadedByEntityType: schemaShape.uploadedByEntityType.enumSpec({\n meaning: 'What kind of principal `uploadedBy` references so hydration code can disambiguate cross-entity uploaders.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileUploaderEntityType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileUploaderEntityType.USER]: { meaning: 'Uploader is a people identity from the `users` table.' },\n [FileUploaderEntityType.ANONYMOUS_USER]: { meaning: 'Uploader is an anonymous marketing-site session before account creation.' },\n [FileUploaderEntityType.ORGANIZATION_MACHINE]: { meaning: 'Uploader is an org-scoped MACHINE principal (M2M automation) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n [FileUploaderEntityType.APPLICATION_MACHINE]: { meaning: 'Uploader is an app-scoped MACHINE principal (integration jobs) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n },\n }),\n\n uploadedAt: schemaShape.uploadedAt.dateSpec({\n meaning: 'When the file bytes finished uploading to storage.',\n temporalRole: 'occurred',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'Last time metadata or link state on this document changed (excluding every storage adapter retry).',\n temporalRole: 'modified',\n }),\n\n deletedAt: schemaShape.deletedAt.dateSpec({\n meaning: 'When the file entered a soft-deleted / tombstone state for background purge.',\n temporalRole: 'occurred',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Resolve a single `File` row, usually when issuing download authorization or parent hydration.',\n outcome: 'Callers can trust storage pointers, status, and linkage fields before streaming bytes to the client.',\n whenToUse: 'Use in server-side `FilesBackendService` flows — not exposed to anonymous callers for arbitrary ids.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The file metadata row for the supplied `fileId` was found and its storage pointers, lifecycle `status`, and `linkedResource*` fields are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (never created, or already hard-deleted after soft-delete vacuum).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized for the row’s scope — download authorization must still re-check the parent `z_file()` ACL; this row alone is not a permission boundary (see `businessConstraints`).' },\n ],\n idempotent: true,\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate file rows filtered by uploader, parent linkage, or scope in repository queries.',\n outcome: 'Background jobs and admin UIs can page through the storage ledger under org/app isolation.',\n whenToUse: 'Use in cleanup jobs, quota dashboards, or when syncing CDN metadata for the tenant.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of file metadata rows matching the uploader / linkage / scope filters under org/app isolation.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the role required to page the storage ledger for the requested scope.' },\n ],\n idempotent: true,\n },\n\n [Op.CREATE]: {\n purpose: 'Materialize a new metadata document for an upload flow; the database assigns the row’s identity (`_id`, projected as `fileId`) at insert, so the row — and its `fileId` — can be created before or after the bytes exist.',\n outcome: 'The system gets a first-class file row that can track upload progress, checksums, and eventual linking.',\n whenToUse: 'Use on upload start or completion events before linking to a parent resource’s `z_file()` slot.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A file metadata row was materialized with its server-assigned `fileId` and initial `PENDING`/`UPLOADED` status. Internal/service write path — `FilesBackendService` drives this from upload flows, not a public CRUD controller.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The upload metadata fails validation — a disallowed `mimeType`, a `size` over the configured per-scope upload limit (over-size is surfaced here, not as a transport-level 413), or scope ids inconsistent with `primaryScope` per `validateFileScopeIdentifiers`.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to upload into the requested scope (org/app/user-self isolation bucket).' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Materialize a file row on upload start',\n request: {\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n organizationId: 'org_01HX2…',\n },\n response: {\n fileId: 'file_01HX2…',\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n status: FileStatus.PENDING,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n rateLimitNote: 'Upload materialization is the hot path for client file submissions; throttle per uploader/scope to bound abusive bulk-upload bursts against object storage.',\n },\n\n [Op.UPDATE]: {\n purpose: 'Patch metadata (status, linkage, size, storage pointers, media analytics) as upload/analyze/link/cleanup events occur.',\n outcome: 'The row stays synchronized with object storage, AV/extraction, and the parent business record that references the file.',\n whenToUse: 'Use in workers and trusted services; users never mutate this row ad hoc in consumer APIs.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The metadata patch (lifecycle `status`, `linkedResource*`, `size`, storage pointers, or media analytics) was applied and the updated row is returned. Internal/service write path owned by workers and trusted services.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` to patch.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patch fails validation (e.g. an illegal `status` transition or a `linkedResource*` triple that breaks scope consistency).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A consumer caller attempts to mutate the row ad hoc — only workers and trusted services patch file metadata.' },\n ],\n idempotent: true,\n },\n\n [Op.DELETE]: {\n purpose: 'Mark or remove file metadata in coordination with object-storage deletion jobs.',\n outcome: 'The platform can enforce retention, GDPR erasure, and org teardown without orphan metadata references.',\n whenToUse: 'Use in compliance purges, org deletion, or when a business record severs a file attachment permanently.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The file metadata was soft-deleted / removed in coordination with object-storage cleanup; no body is returned. Internal/service path used in retention, GDPR erasure, and org teardown.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (or it was already deleted).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to delete files in the row’s scope.' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'FILES declares NO `persistenceAdapter` — it follows the application default, so a file-metadata row and the resource row that owns it share one store and one native transaction (the pin that used to force MongoDB here was removed by the persistence-adapter parity work). This resource is precisely the case that must NOT declare one: it is written inside cross-resource atomic boundaries by design, so it could never make the `persistenceAdapterIsolation` claim that admits a divergent adapter.',\n 'Download authorization must still re-check the parent `z_file()` access policy: this row alone is not a permission boundary; `linkedResource*` fields and scope ids must be evaluated together with resource ACLs.',\n ],\n }),\n // Scope mirrors the registry-derived value: the `APPLICATION → FILES`\n // relationship in `resources-registry.shared.core.definitions.ts` carries\n // `isPrimaryScope: true` (applicationId is propagated to every file record\n // from the execution context), so the factory derives APPLICATION. Per-org /\n // per-user containment is enforced through the `linkedResource*` fields and\n // the parent `z_file()` access policy, not through the primary scope anchor.\n // Was ORGANIZATIONS until the companion alignment guard started pairing\n // engine specs with materialized core configs (2026-07-02) and flagged the\n // drift.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
1
+ {"version":3,"file":"files.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/files/resources/files.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource: `files` — Wildo SaaS engine specification (backend-only).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/files/files.shared.schemas.ts → `FileSchema`\n * - Factory: engine/saas-models/src/files/files.shared.resources-config.schemas.ts\n * → `filesResourceConfiguration_InitializationFactory`\n * - Custom operations: none\n * - UI presets: none\n */\n\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n FileDisplayNature,\n FileStorageAccepted,\n FileUploaderEntityType,\n} from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n FileSchema,\n FileStatus,\n filesResourceConfiguration_InitializationFactory,\n ResourcePrimaryScope,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\nexport const filesResourceSpecification = resourceSpecification(\n filesResourceConfiguration_InitializationFactory,\n FileSchema,\n ({ schemaShape }) => ({\n purpose: 'Store file metadata (name, MIME, storage pointers, lifecycle, and scope) for assets managed by the platform file service.',\n businessRole: 'The shared “file row” truth that links uploaded bytes in object storage to domain resources through `linkedResource*` fields.',\n lifecycleRole: 'Moves from `PENDING` upload through `UPLOADED`, optional AV / extraction states, linking to business records, and eventual `DELETED` / `ORPHANED` cleanup.',\n audience: LabelAudience.END_USER,\n subDomain: EngineResourceSubDomain.FILES,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'filesResourceConfiguration_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: 'FILES',\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 'Repository-only resource: all operations are `REPOSITORY_ONLY` — `FilesBackendService` is the intended entry point, not public CRUD controllers.',\n 'Per-record `primaryScope` + scope id fields can represent APPLICATION, ORGANIZATIONS, or USER_SELF rows; the resource-level `resourcePrimaryScope` declared here is the registry default for the FILES type, not every row’s dynamic scope.',\n ],\n },\n\n fields: {\n fileId: schemaShape.fileId.stringSpec({\n meaning: 'Stable public identifier for this file metadata document, embedded in storage keys and download URLs. It is a virtual projection of the document’s underlying Mongo `_id` (`fileId === String(_id)`), so the file has a single stored identity and there is no separate persisted `fileId` field.',\n whyItMatters: 'This is the identifier other resources store in `z_file()` fields and that presigned URL flows reference. Because it projects `_id`, the value is allocated by the database at insert time rather than minted before the row exists, so creation is insert-first.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n filename: schemaShape.filename.stringSpec({\n meaning: 'Sanitized filename used in UI and download headers.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'label',\n }),\n\n originalFilename: schemaShape.originalFilename.stringSpec({\n meaning: 'Original client-provided filename before sanitization for audit/support.',\n semanticRole: 'label',\n }),\n\n mimeType: schemaShape.mimeType.stringSpec({\n meaning: 'IANA-style MIME classification for validation, AV routing, and viewer choice.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n size: schemaShape.size.numberSpec({\n meaning: 'Byte length of the stored object after upload completes.',\n unit: 'bytes',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n extension: schemaShape.extension.stringSpec({\n meaning: 'Filename extension snapshot (without dot) for quick filtering when MIME is generic.',\n semanticRole: 'code',\n }),\n\n checksum: schemaShape.checksum.stringSpec({\n meaning: 'Optional content hash for deduplication and integrity checks after upload.',\n semanticRole: 'code',\n }),\n\n storageProvider: schemaShape.storageProvider.enumSpec({\n meaning: 'Which registered storage backend (S3-compatible, local, …) holds the bytes.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileStorageAccepted',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStorageAccepted.WILDO_MANAGED]: { meaning: 'Managed object storage (S3-compatible) selected by the platform default configuration.' },\n [FileStorageAccepted.LOCAL_DIRECTORY]: { meaning: 'Local filesystem directory for development or air-gapped single-node installs.' },\n [FileStorageAccepted.ONEDRIVE]: { meaning: 'Optional Microsoft OneDrive-backed storage when an app enables the connector.' },\n [FileStorageAccepted.GOOGLE_DRIVE]: { meaning: 'Optional Google Drive-backed storage when an app enables the connector.' },\n [FileStorageAccepted.DROPBOX]: { meaning: 'Optional Dropbox-backed storage when an app enables the connector.' },\n },\n }),\n\n storageRef: schemaShape.storageRef.stringSpec({\n meaning: 'Opaque handle the active storage adapter uses to retrieve bytes (bucket/key tuple is adapter-specific).',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'identifier',\n }),\n\n storageKey: schemaShape.storageKey.stringSpec({\n meaning: 'Derived, human-debuggable key encoding the scope path (`app/...`, `org/...`, `user/...`) and `fileId`, used in logs and migrations. Because it depends on the database-assigned `fileId`, it is populated immediately after insert and is optional at rest until then.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n url: schemaShape.url.stringSpec({\n meaning: 'Cached HTTP(S) URL when a long-lived public or CDN URL is available (may be presigned elsewhere).',\n semanticRole: 'uri',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Lifecycle state for upload, AV, linkage, and deletion. Text extraction/indexing state is NOT here — it lives on the per-field RAG chunk records.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStatus.PENDING]: { meaning: 'Upload not finished — metadata record exists, bytes not ready yet.' },\n [FileStatus.UPLOADED]: { meaning: 'Bytes are stored and ready for post-processing or linking.' },\n [FileStatus.LINKED]: { meaning: 'Bound to a parent resource’s `z_file()` field; primary happy path for production assets.' },\n [FileStatus.DELETED]: { meaning: 'Soft-deleted; bytes may still exist until vacuum jobs run.' },\n [FileStatus.ORPHANED]: { meaning: 'No live parent link — retained for re-link or background cleanup only.' },\n [FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this record.' },\n [FileStatus.SCANNING]: { meaning: 'AV pipeline is running before download is allowed in hardened tenants.' },\n [FileStatus.CLEAN]: { meaning: 'AV says the payload is not malicious.' },\n [FileStatus.INFECTED]: { meaning: 'Quarantine candidate — do not serve for download.' },\n [FileStatus.QUARANTINED]: { meaning: 'Isolated for operator review; download blocked by policy.' },\n },\n }),\n\n nature: schemaShape.nature.enumSpec({\n meaning: 'Resolved high-level file kind (image / video / document) used for template selection, not raw MIME subtypes alone.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileDisplayNature',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileDisplayNature.IMAGE]: { meaning: 'Raster/vector still asset suitable for lightbox and thumbnail UIs.' },\n [FileDisplayNature.VIDEO]: { meaning: 'Time-based media; shows duration and streaming-friendly player chrome.' },\n [FileDisplayNature.AUDIO]: { meaning: 'Sound-only media with duration metadata.' },\n [FileDisplayNature.DOCUMENT]: { meaning: 'Text-first assets such as office/PDF/structured docs.' },\n [FileDisplayNature.GENERIC]: { meaning: 'Fallback bucket when a generic download affordance is enough.' },\n },\n }),\n\n width: schemaShape.width.numberSpec({ meaning: 'Image/video width in pixels when known.' }),\n height: schemaShape.height.numberSpec({ meaning: 'Image/video height in pixels when known.' }),\n duration: schemaShape.duration.numberSpec({ meaning: 'Audio/video length in seconds when analyzers provide it.' }),\n pageCount: schemaShape.pageCount.numberSpec({ meaning: 'Page count for paginated document previews when the analyzer could infer it.' }),\n\n thumbnailUrl: schemaShape.thumbnailUrl.stringSpec({\n meaning: 'Optional derived thumbnail or poster frame URL for list/grid UIs.',\n semanticRole: 'uri',\n }),\n\n linkedResourceType: schemaShape.linkedResourceType.stringSpec({\n meaning: 'When linked, the `CoreResourceType` (string form) of the parent record carrying the `z_file()` field.',\n semanticRole: 'code',\n }),\n\n linkedResourceId: schemaShape.linkedResourceId.stringSpec({\n meaning: 'Primary id of the parent resource using this file, when linked.',\n semanticRole: 'identifier',\n }),\n\n linkedFieldName: schemaShape.linkedFieldName.stringSpec({\n meaning: 'Field name on the parent schema (e.g. `avatarId`) to support multi-file parents.',\n semanticRole: 'code',\n }),\n\n primaryScope: schemaShape.primaryScope.enumSpec({\n meaning: 'Which isolation bucket this record participates in: app-wide, org-wide, or user-private (within an org).',\n whyItMatters:\n 'Field is optional at rest until an upload binds scope identifiers; `FileSchema` superRefine enforces consistency between `primaryScope` and the id triple.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ResourcePrimaryScope',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ResourcePrimaryScope.APPLICATION]: { meaning: 'App-wide marketing/branding or singleton assets (uses `applicationId` only).' },\n [ResourcePrimaryScope.ORGANIZATIONS]: { meaning: 'Shared within a tenant; uses `organizationId` only.' },\n [ResourcePrimaryScope.USER_SELF]: { meaning: 'Private to a user, but still in org context; requires `organizationId` + `userId` per file scope rules.' },\n },\n }),\n\n applicationId: schemaShape.applicationId.stringSpec({\n meaning: 'Parent application id when `primaryScope` is `APPLICATION`.',\n semanticRole: 'identifier',\n }),\n\n organizationId: schemaShape.organizationId.stringSpec({\n meaning: 'Org id for org-scoped files and as local context for user-private files.',\n semanticRole: 'identifier',\n }),\n\n userId: schemaShape.userId.stringSpec({\n meaning: 'User id for `USER_SELF` scoped file records, paired with `organizationId` as required by `validateFileScopeIdentifiers`.',\n semanticRole: 'identifier',\n }),\n\n uploadedBy: schemaShape.uploadedBy.stringSpec({\n meaning: 'Raw uploader id when the uploader is not necessarily a Wildo `users` record (service principal, system job, …).',\n semanticRole: 'identifier',\n }),\n\n uploadedByEntityType: schemaShape.uploadedByEntityType.enumSpec({\n meaning: 'What kind of principal `uploadedBy` references so hydration code can disambiguate cross-entity uploaders.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileUploaderEntityType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileUploaderEntityType.USER]: { meaning: 'Uploader is a people identity from the `users` table.' },\n [FileUploaderEntityType.ANONYMOUS_USER]: { meaning: 'Uploader is an anonymous marketing-site session before account creation.' },\n [FileUploaderEntityType.ORGANIZATION_MACHINE]: { meaning: 'Uploader is an org-scoped MACHINE principal (M2M automation) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n [FileUploaderEntityType.APPLICATION_MACHINE]: { meaning: 'Uploader is an app-scoped MACHINE principal (integration jobs) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n },\n }),\n\n uploadedAt: schemaShape.uploadedAt.dateSpec({\n meaning: 'When the file bytes finished uploading to storage.',\n temporalRole: 'occurred',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'Last time metadata or link state on this document changed (excluding every storage adapter retry).',\n temporalRole: 'modified',\n }),\n\n deletedAt: schemaShape.deletedAt.dateSpec({\n meaning: 'When the file entered a soft-deleted / tombstone state for background purge.',\n temporalRole: 'occurred',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Resolve a single `File` row, usually when issuing download authorization or parent hydration.',\n outcome: 'Callers can trust storage pointers, status, and linkage fields before streaming bytes to the client.',\n whenToUse: 'Use in server-side `FilesBackendService` flows — not exposed to anonymous callers for arbitrary ids.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The file metadata record for the supplied `fileId` was found and its storage pointers, lifecycle `status`, and `linkedResource*` fields are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (never created, or already hard-deleted after soft-delete vacuum).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized for the row’s scope — download authorization must still re-check the parent `z_file()` ACL; this row alone is not a permission boundary (see `businessConstraints`).' },\n ],\n idempotent: true,\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate file rows filtered by uploader, parent linkage, or scope in repository queries.',\n outcome: 'Background jobs and admin UIs can page through the storage ledger under org/app isolation.',\n whenToUse: 'Use in cleanup jobs, quota dashboards, or when syncing CDN metadata for the tenant.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of file metadata records matching the uploader / linkage / scope filters under org/app isolation.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the role required to page the storage ledger for the requested scope.' },\n ],\n idempotent: true,\n },\n\n [Op.CREATE]: {\n purpose: 'Materialize a new metadata document for an upload flow; the database assigns the row’s identity (`_id`, projected as `fileId`) at insert, so the row — and its `fileId` — can be created before or after the bytes exist.',\n outcome: 'The system gets a first-class file row that can track upload progress, checksums, and eventual linking.',\n whenToUse: 'Use on upload start or completion events before linking to a parent resource’s `z_file()` slot.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A file metadata record was materialized with its server-assigned `fileId` and initial `PENDING`/`UPLOADED` status. Internal/service write path — `FilesBackendService` drives this from upload flows, not a public CRUD controller.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The upload metadata fails validation — a disallowed `mimeType`, a `size` over the configured per-scope upload limit (over-size is surfaced here, not as a transport-level 413), or scope ids inconsistent with `primaryScope` per `validateFileScopeIdentifiers`.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to upload into the requested scope (org/app/user-self isolation bucket).' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Materialize a file row on upload start',\n request: {\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n organizationId: 'org_01HX2…',\n },\n response: {\n fileId: 'file_01HX2…',\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n status: FileStatus.PENDING,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n rateLimitNote: 'Upload materialization is the hot path for client file submissions; throttle per uploader/scope to bound abusive bulk-upload bursts against object storage.',\n },\n\n [Op.UPDATE]: {\n purpose: 'Patch metadata (status, linkage, size, storage pointers, media analytics) as upload/analyze/link/cleanup events occur.',\n outcome: 'The row stays synchronized with object storage, AV/extraction, and the parent business record that references the file.',\n whenToUse: 'Use in workers and trusted services; users never mutate this row ad hoc in consumer APIs.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The metadata patch (lifecycle `status`, `linkedResource*`, `size`, storage pointers, or media analytics) was applied and the updated record is returned. Internal/service write path owned by workers and trusted services.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` to patch.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patch fails validation (e.g. an illegal `status` transition or a `linkedResource*` triple that breaks scope consistency).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A consumer caller attempts to mutate the row ad hoc — only workers and trusted services patch file metadata.' },\n ],\n idempotent: true,\n },\n\n [Op.DELETE]: {\n purpose: 'Mark or remove file metadata in coordination with object-storage deletion jobs.',\n outcome: 'The platform can enforce retention, GDPR erasure, and org teardown without orphan metadata references.',\n whenToUse: 'Use in compliance purges, org deletion, or when a business record severs a file attachment permanently.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The file metadata was soft-deleted / removed in coordination with object-storage cleanup; no body is returned. Internal/service path used in retention, GDPR erasure, and org teardown.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (or it was already deleted).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to delete files in the row’s scope.' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'FILES declares NO `persistenceAdapter` — it follows the application default, so a file-metadata row and the resource row that owns it share one store and one native transaction (the pin that used to force MongoDB here was removed by the persistence-adapter parity work). This resource is precisely the case that must NOT declare one: it is written inside cross-resource atomic boundaries by design, so it could never make the `persistenceAdapterIsolation` claim that admits a divergent adapter.',\n 'Download authorization must still re-check the parent `z_file()` access policy: this row alone is not a permission boundary; `linkedResource*` fields and scope ids must be evaluated together with resource ACLs.',\n ],\n }),\n // Scope mirrors the registry-derived value: the `APPLICATION → FILES`\n // relationship in `resources-registry.shared.core.definitions.ts` carries\n // `isPrimaryScope: true` (applicationId is propagated to every file record\n // from the execution context), so the factory derives APPLICATION. Per-org /\n // per-user containment is enforced through the `linkedResource*` fields and\n // the parent `z_file()` access policy, not through the primary scope anchor.\n // Was ORGANIZATIONS until the companion alignment guard started pairing\n // engine specs with materialized core configs (2026-07-02) and flagged the\n // drift.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
@@ -1,5 +1,5 @@
1
1
  import { A2APushDeliveryStatus, CoreResourceOperation as Op } from '@wildo-ai/saas-models';
2
- export declare const userA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
2
+ export declare const userA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.UPDATE_MANY | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
3
3
  _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
4
4
  deliveryId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
5
5
  taskId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
@@ -20,7 +20,7 @@ export declare const userA2aPushDeliveryLogResourceSpecification: import("../../
20
20
  failedAt: import("zod").ZodOptional<import("zod").ZodDate>;
21
21
  createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodDate>>>;
22
22
  }, import("zod/v4/core").$strip>>;
23
- export declare const organizationA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
23
+ export declare const organizationA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.UPDATE_MANY | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
24
24
  _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
25
25
  deliveryId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
26
26
  taskId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
@@ -41,7 +41,7 @@ export declare const organizationA2aPushDeliveryLogResourceSpecification: import
41
41
  failedAt: import("zod").ZodOptional<import("zod").ZodDate>;
42
42
  createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodDate>>>;
43
43
  }, import("zod/v4/core").$strip>>;
44
- export declare const applicationA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
44
+ export declare const applicationA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.UPDATE_MANY | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
45
45
  _id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
46
46
  deliveryId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
47
47
  taskId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
@@ -1 +1 @@
1
- {"version":3,"file":"a2a-push-delivery-log.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,qBAAqB,EACrB,qBAAqB,IAAI,EAAE,EAI5B,MAAM,uBAAuB,CAAC;AAmgB/B,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;;;;iCAGvD,CAAC;AAEF,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;iCAG/D,CAAC;AAEF,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;iCAG9D,CAAC"}
1
+ {"version":3,"file":"a2a-push-delivery-log.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,qBAAqB,EACrB,qBAAqB,IAAI,EAAE,EAI5B,MAAM,uBAAuB,CAAC;AA+gB/B,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;;;;iCAGvD,CAAC;AAEF,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;iCAG/D,CAAC;AAEF,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;iCAG9D,CAAC"}
@@ -2,6 +2,7 @@ import { LabelAudience } from '@wildo-ai/presets-components-models';
2
2
  import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, } from '@wildo-ai/zod-decorators';
3
3
  import { A2APushDeliveryLogSchema, A2APushDeliveryStatus, CoreResourceOperation as Op, CoreResourceType, ResourcePrimaryScope, a2aPushDeliveryLogPolymorphicFactories, } from '@wildo-ai/saas-models';
4
4
  import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
5
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
5
6
  const a2aPushDeliveryPrimaryScopeByResourceType = {
6
7
  [CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.USER_SELF,
7
8
  [CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.ORGANIZATIONS,
@@ -123,6 +124,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
123
124
  businessRole: 'Operational history for diagnosing A2A push notifications by task, destination, status, attempt count, and HTTP outcome.',
124
125
  lifecycleRole: 'Created before the first delivery attempt, then progresses through pending and in-flight states to delivered or failed; retryable failures return to pending with a next-attempt time.',
125
126
  audience: LabelAudience.DEVELOPER,
127
+ subDomain: EngineResourceSubDomain.FLOWS_ACTORS,
126
128
  codeHandling: {
127
129
  mainSchema: {
128
130
  packageName: '@wildo-ai/saas-models',
@@ -164,12 +166,12 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
164
166
  },
165
167
  fields: {
166
168
  _id: schemaShape._id.stringSpec({
167
- meaning: 'Document id of this delivery row.',
169
+ meaning: 'Document id of this delivery record.',
168
170
  semanticRole: 'identifier',
169
171
  importance: FieldSemanticImportance.PRIMARY,
170
172
  }),
171
173
  deliveryId: schemaShape.deliveryId.stringSpec({
172
- meaning: 'Stable identity of this delivery, generated once when the row is opened and sent with every attempt.',
174
+ meaning: 'Stable identity of this delivery, generated once when the record is opened and sent with every attempt.',
173
175
  whyItMatters: 'It is what makes duplicates RECOGNISABLE to the receiver. §4.3.3 asks clients to process notifications idempotently, which they can only do if a retry is identifiable as the same delivery — hence generated at row creation, never per attempt.',
174
176
  semanticRole: 'identifier',
175
177
  importance: FieldSemanticImportance.PRIMARY,
@@ -181,7 +183,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
181
183
  importance: FieldSemanticImportance.PRIMARY,
182
184
  }),
183
185
  pushNotificationConfigId: schemaShape.pushNotificationConfigId.stringSpec({
184
- meaning: 'Which registered webhook configuration this row delivers to — a task may carry several.',
186
+ meaning: 'Which registered webhook configuration this record delivers to — a task may carry several.',
185
187
  whyItMatters: 'Distinguishes "one of my endpoints is broken" from "notifications are broken", which are different incidents with different owners.',
186
188
  semanticRole: 'identifier',
187
189
  }),
@@ -215,8 +217,8 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
215
217
  declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
216
218
  },
217
219
  values: {
218
- [A2APushDeliveryStatus.PENDING]: { meaning: 'The row is open and either waiting for its first attempt or re-queued for another after a retryable failure.' },
219
- [A2APushDeliveryStatus.IN_FLIGHT]: { meaning: 'A worker has claimed the row (PENDING → IN_FLIGHT compare-and-swap) and is POSTing to the webhook.' },
220
+ [A2APushDeliveryStatus.PENDING]: { meaning: 'The record is open and either waiting for its first attempt or re-queued for another after a retryable failure.' },
221
+ [A2APushDeliveryStatus.IN_FLIGHT]: { meaning: 'A worker has claimed the record (PENDING → IN_FLIGHT compare-and-swap) and is POSTing to the webhook.' },
220
222
  [A2APushDeliveryStatus.DELIVERED]: { meaning: 'The endpoint answered 2xx — terminal success, and the evidence that §4.3.3 delivery obligation was met.' },
221
223
  [A2APushDeliveryStatus.FAILED]: { meaning: 'Terminal failure: a non-retryable response, or the §13.2 attempt budget exhausted.' },
222
224
  },
@@ -256,7 +258,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
256
258
  temporalRole: 'occurred',
257
259
  }),
258
260
  createdAt: schemaShape.createdAt.dateSpec({
259
- meaning: 'When the row was opened, which is BEFORE the first delivery attempt.',
261
+ meaning: 'When the record was opened, which is BEFORE the first delivery attempt.',
260
262
  temporalRole: 'creation',
261
263
  }),
262
264
  },
@@ -364,7 +366,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
364
366
  purpose: 'Open a PENDING row for one (task transition × registered webhook), before any delivery is attempted.',
365
367
  outcome: 'Every delivery obligation is recorded up front, so an unreachable queue leaves a visible row rather than silence.',
366
368
  responseStatuses: [
367
- { code: HttpResponseStatusCode.CREATED_201, meaning: 'The delivery row was opened. REPOSITORY_ONLY — a delivery row is EVIDENCE that a notification was attempted, and a caller able to author one could fabricate that evidence. The dispatcher writes it via `createAsSystem`; there is no HTTP surface at all.' },
369
+ { code: HttpResponseStatusCode.CREATED_201, meaning: 'The delivery record was opened. REPOSITORY_ONLY — a delivery record is EVIDENCE that a notification was attempted, and a caller able to author one could fabricate that evidence. The dispatcher writes it via `createAsSystem`; there is no HTTP surface at all.' },
368
370
  ],
369
371
  errorScenarios: [
370
372
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails schema validation (e.g. a missing `deliveryId` or the injected owner FK).', errorCode: 'VALIDATION_FAILED' },
@@ -375,7 +377,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
375
377
  purpose: 'Advance a delivery through its lifecycle — claim it, then record the outcome.',
376
378
  outcome: 'The row reflects what actually happened to the notification, including scheduled retries.',
377
379
  responseStatuses: [
378
- { code: HttpResponseStatusCode.OK_200, meaning: 'The transition was recorded. REPOSITORY_ONLY, like CREATE: `repository.update` needs a default UPDATE operation to resolve, and exposing it would let a caller mark its own undelivered notifications as DELIVERED. The PENDING → IN_FLIGHT claim carries the prior status in its filter, so two workers racing one queue message cannot both claim the row.' },
380
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The transition was recorded. REPOSITORY_ONLY, like CREATE: `repository.update` needs a default UPDATE operation to resolve, and exposing it would let a caller mark its own undelivered notifications as DELIVERED. The PENDING → IN_FLIGHT claim carries the prior status in its filter, so two workers racing one queue message cannot both claim the record.' },
379
381
  ],
380
382
  errorScenarios: [
381
383
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The row is gone, or another worker already claimed it — the compare-and-swap matched nothing, and the loser stops rather than sending a duplicate POST.' },
@@ -386,18 +388,28 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
386
388
  purpose: 'Remove a delivery row — retention purging, and the cleanup the owning user/org/app deletion cascades to.',
387
389
  outcome: 'Delivery evidence does not outlive the tenant it describes.',
388
390
  responseStatuses: [
389
- { code: HttpResponseStatusCode.OK_200, meaning: 'The row was removed. REPOSITORY_ONLY and deliberately NOT offered to the owner: a trail an owner can selectively erase is not a trail. The same default op powers the composition onParentDelete cascade, which runs at the repository tier below role checks.' },
391
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The record was removed. REPOSITORY_ONLY and deliberately NOT offered to the owner: a trail an owner can selectively erase is not a trail. The same default op powers the composition onParentDelete cascade, which runs at the repository tier below role checks.' },
390
392
  ],
391
393
  errorScenarios: [
392
394
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No such row (already purged, or never existed).' },
393
395
  ],
394
396
  idempotent: true,
395
397
  },
398
+ [Op.UPDATE_MANY]: {
399
+ purpose: 'In-place scrub of retained rows when a data subject is erased.',
400
+ outcome: 'The delivery history survives for operational accounting while the personal data in it does not.',
401
+ responseStatuses: [
402
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were scrubbed. INTERNAL_CALL — it registers no HTTP route, and exists because `retentionPolicy` reaches records through `updateManyAsSystem`.' },
403
+ ],
404
+ errorScenarios: [
405
+ { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },
406
+ ],
407
+ },
396
408
  [Op.DELETE_MANY]: {
397
409
  purpose: 'Bulk removal for retention windows and owner-scope teardown.',
398
410
  outcome: 'Delivery history is bounded without a per-row round trip.',
399
411
  responseStatuses: [
400
- { code: HttpResponseStatusCode.OK_200, meaning: 'The matching rows were removed. REPOSITORY_ONLY, the bulk twin of DELETE and restricted for the same reason.' },
412
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were removed. REPOSITORY_ONLY, the bulk twin of DELETE and restricted for the same reason.' },
401
413
  ],
402
414
  errorScenarios: [
403
415
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },