@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
@@ -3,6 +3,7 @@ import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, } from '@
3
3
  import { DataSeedMode, DataSeedRunSchema, DataSeedRunStatus, DataSeedRunVariantKey, DataSeedScopeKind, DataSeedTriggerOrigin, dataSeedRunResourceConfiguration_InitializationFactory as dataSeedRunFactory, } from '@wildo-ai/saas-backend-lib/data-seeding-models';
4
4
  import { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';
5
5
  import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
6
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
6
7
  /**
7
8
  * Framework-owned specification for the internal `dataSeedRuns` resource — the
8
9
  * persistence ledger the data-seeding dispatcher writes one row to per pass.
@@ -61,6 +62,7 @@ export const dataSeedRunsResourceSpecification = resourceSpecification(dataSeedR
61
62
  businessRole: 'Operational control-plane ledger used to make seeding idempotent across restarts, and to troubleshoot what a seeding pass inserted, upgraded, skipped, or failed on.',
62
63
  lifecycleRole: 'Opens as a running pass when the dispatcher starts, then settles once into completed, partial, or failed. Deleting a settled row is the supported gesture for making the next pass treat that scope as un-run.',
63
64
  audience: LabelAudience.DEVELOPER,
65
+ subDomain: EngineResourceSubDomain.INFRASTRUCTURE,
64
66
  codeHandling: {
65
67
  mainSchema: {
66
68
  packageName: '@wildo-ai/saas-backend-lib',
@@ -120,14 +122,14 @@ export const dataSeedRunsResourceSpecification = resourceSpecification(dataSeedR
120
122
  },
121
123
  values: {
122
124
  [DataSeedMode.LAZY]: { meaning: 'Create the entry the first time the scope is accessed if it is missing. Always safe to repeat.' },
123
- [DataSeedMode.ADDITIVE]: { meaning: 'Insert entries that are absent and re-apply the declared payload to entries that are present. Never removes anything and never walks rows outside the declared set.' },
125
+ [DataSeedMode.ADDITIVE]: { meaning: 'Insert entries that are absent and re-apply the declared payload to entries that are present. Never removes anything and never walks records outside the declared set.' },
124
126
  [DataSeedMode.UPGRADE]: { meaning: 'Insert entries that are absent and migrate entries whose recorded version is behind the declared one.' },
125
- [DataSeedMode.SYNC]: { meaning: 'Treat the declared entries as the full truth: insert what is missing, update what changed, and handle rows that are no longer declared according to the seed orphan policy.' },
127
+ [DataSeedMode.SYNC]: { meaning: 'Treat the declared entries as the full truth: insert what is missing, update what changed, and handle records that are no longer declared according to the seed orphan policy.' },
126
128
  },
127
129
  importance: FieldSemanticImportance.PRIMARY,
128
130
  }),
129
131
  scopeKind: schemaShape.scopeKind.enumSpec({
130
- meaning: 'The unit this pass seeded — the whole database, one application, one organization, one user, or one row of some other resource type.',
132
+ meaning: 'The unit this pass seeded — the whole database, one application, one organization, one user, or one record of some other resource type.',
131
133
  whyItMatters: 'Seeding is idempotent per scope, so the scope is half of the answer to "has this already run?".',
132
134
  enumDeclaration: {
133
135
  packageName: '@wildo-ai/saas-backend-lib',
@@ -136,20 +138,20 @@ export const dataSeedRunsResourceSpecification = resourceSpecification(dataSeedR
136
138
  declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
137
139
  },
138
140
  values: {
139
- [DataSeedScopeKind.GLOBAL]: { meaning: 'Applied once for the whole database. There is no anchor row.' },
141
+ [DataSeedScopeKind.GLOBAL]: { meaning: 'Applied once for the whole database. There is no anchor record.' },
140
142
  [DataSeedScopeKind.APPLICATION]: { meaning: 'Applied once per application.' },
141
143
  [DataSeedScopeKind.ORGANIZATION]: { meaning: 'Applied once per organization.' },
142
144
  [DataSeedScopeKind.USER]: { meaning: 'Applied once per user.' },
143
- [DataSeedScopeKind.CUSTOM]: { meaning: 'Applied once per row of some other resource type, which is named separately on the pass.' },
145
+ [DataSeedScopeKind.CUSTOM]: { meaning: 'Applied once per record of some other resource type, which is named separately on the pass.' },
144
146
  },
145
147
  importance: FieldSemanticImportance.PRIMARY,
146
148
  }),
147
149
  relatedResourceType: schemaShape.relatedResourceType.stringSpec({
148
- meaning: 'The resource type whose row anchors a custom-scope pass. Empty for the built-in scopes, whose resource is implied by the scope itself.',
150
+ meaning: 'The resource type whose record anchors a custom-scope pass. Empty for the built-in scopes, whose resource is implied by the scope itself.',
149
151
  whyItMatters: 'Two custom-scope seeds can legitimately anchor on the same row identifier under different resource types, so this is what keeps their histories apart.',
150
152
  }),
151
153
  relatedId: schemaShape.relatedId.stringSpec({
152
- meaning: 'Identifier of the row that anchors this scope. Empty only for a database-wide pass, which has no anchor.',
154
+ meaning: 'Identifier of the record that anchors this scope. Empty only for a database-wide pass, which has no anchor.',
153
155
  whyItMatters: 'It is what narrows the ledger from "every run of this seed" to "the run for this particular organization, user, or row".',
154
156
  semanticRole: 'identifier',
155
157
  }),
@@ -207,30 +209,30 @@ export const dataSeedRunsResourceSpecification = resourceSpecification(dataSeedR
207
209
  importance: FieldSemanticImportance.PRIMARY,
208
210
  }),
209
211
  entriesInserted: schemaShape.entriesInserted.numberSpec({
210
- meaning: 'How many declared entries were written because no matching row existed.',
212
+ meaning: 'How many declared entries were written because no matching record existed.',
211
213
  }),
212
214
  entriesUpdated: schemaShape.entriesUpdated.numberSpec({
213
- meaning: 'How many already-present rows had the declared payload re-applied to them.',
215
+ meaning: 'How many already-present records had the declared payload re-applied to them.',
214
216
  whyItMatters: 'This is the additive-mode counter. A version migration is counted separately, so a non-zero value here means the payload was re-stamped, not migrated.',
215
217
  }),
216
218
  entriesUpgraded: schemaShape.entriesUpgraded.numberSpec({
217
- meaning: 'How many present rows were behind the declared version and were migrated forward.',
219
+ meaning: 'How many present records were behind the declared version and were migrated forward.',
218
220
  }),
219
221
  entriesRenamed: schemaShape.entriesRenamed.numberSpec({
220
- meaning: 'How many rows were relocated from a previous identity because the declaration renamed them.',
222
+ meaning: 'How many records were relocated from a previous identity because the declaration renamed them.',
221
223
  }),
222
224
  entriesSkipped: schemaShape.entriesSkipped.numberSpec({
223
225
  meaning: 'How many declared entries the pass deliberately left untouched — already current, or protected from being moved backwards.',
224
226
  whyItMatters: 'Skipping is a normal outcome, not a failure; the reason for each skip is reported separately.',
225
227
  }),
226
228
  entriesDeleted: schemaShape.entriesDeleted.numberSpec({
227
- meaning: 'How many rows outside the declared set were removed. Only a full-reconciliation pass configured to delete can produce this.',
229
+ meaning: 'How many records outside the declared set were removed. Only a full-reconciliation pass configured to delete can produce this.',
228
230
  }),
229
231
  entriesDeprecated: schemaShape.entriesDeprecated.numberSpec({
230
- meaning: 'How many rows outside the declared set were marked deprecated instead of removed.',
232
+ meaning: 'How many records outside the declared set were marked deprecated instead of removed.',
231
233
  }),
232
234
  entriesReportedOrphans: schemaShape.entriesReportedOrphans.numberSpec({
233
- meaning: 'How many rows outside the declared set were only reported, leaving the rows themselves untouched.',
235
+ meaning: 'How many records outside the declared set were only reported, leaving the records themselves untouched.',
234
236
  }),
235
237
  entriesFailed: schemaShape.entriesFailed.numberSpec({
236
238
  meaning: 'How many entries could not be written. The pass continues and settles as partial.',
@@ -238,7 +240,7 @@ export const dataSeedRunsResourceSpecification = resourceSpecification(dataSeedR
238
240
  importance: FieldSemanticImportance.PRIMARY,
239
241
  }),
240
242
  failureReport: schemaShape.failureReport.objectSpec({
241
- meaning: 'Detailed breakdown of everything non-trivial the pass encountered: which entries failed and why, which rows fell outside the declared set, and any error that stopped the pass as a whole. Empty when everything succeeded.',
243
+ meaning: 'Detailed breakdown of everything non-trivial the pass encountered: which entries failed and why, which records fell outside the declared set, and any error that stopped the pass as a whole. Empty when everything succeeded.',
242
244
  whyItMatters: 'It is what lets an operator diagnose a partial or failed pass without going to application logs.',
243
245
  importance: FieldSemanticImportance.PRIMARY,
244
246
  }),
@@ -267,7 +269,7 @@ export const dataSeedRunsResourceSpecification = resourceSpecification(dataSeedR
267
269
  purpose: 'Open the ledger row for a seeding pass that is about to start.',
268
270
  outcome: 'The pass becomes visible as running before it touches any data, so a crash mid-pass leaves a trace rather than nothing.',
269
271
  responseStatuses: [
270
- { code: HttpResponseStatusCode.CREATED_201, meaning: 'The pass was recorded as running and the row is returned.' },
272
+ { code: HttpResponseStatusCode.CREATED_201, meaning: 'The pass was recorded as running and the record is returned.' },
271
273
  ],
272
274
  errorScenarios: [
273
275
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The pass description fails schema validation.', errorCode: 'VALIDATION_FAILED' },
@@ -304,7 +306,7 @@ export const dataSeedRunsResourceSpecification = resourceSpecification(dataSeedR
304
306
  outcome: 'The ledger stops saying the pass is in flight and starts being the answer to whether the seed already applied.',
305
307
  importance: FieldSemanticImportance.PRIMARY,
306
308
  responseStatuses: [
307
- { code: HttpResponseStatusCode.OK_200, meaning: 'The pass recorded its outcome, timing, counters and failure report, and the settled row is returned.' },
309
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The pass recorded its outcome, timing, counters and failure report, and the settled record is returned.' },
308
310
  ],
309
311
  errorScenarios: [
310
312
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier to settle.' },
@@ -1 +1 @@
1
- {"version":3,"file":"data-seed-runs.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/data-seed-runs.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n DataSeedMode,\n DataSeedRunSchema,\n DataSeedRunStatus,\n DataSeedRunVariantKey,\n DataSeedScopeKind,\n DataSeedTriggerOrigin,\n dataSeedRunResourceConfiguration_InitializationFactory as dataSeedRunFactory,\n} from '@wildo-ai/saas-backend-lib/data-seeding-models';\nimport { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { type AnyResourceSpecificationConfig, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\n\n/**\n * Framework-owned specification for the internal `dataSeedRuns` resource — the\n * persistence ledger the data-seeding dispatcher writes one row to per pass.\n *\n * Like `jobExecutions`, this is a platform/infrastructure truth source rather\n * than an end-user surface: its useful semantic layer is the operational model\n * (did this seed already run for this scope at this version, and what did the\n * pass do?), not UI narration. Its only human-facing surface is the back-office\n * ADMIN read/search path and the `DELETE` re-run gesture.\n *\n * Authored 2026-08-21 because the label generator was producing this resource's\n * ~1000 keys with NO spec context at all — the companion logged\n * `No resource specification found for \"dataSeedRuns\"` on every run and invented\n * terminology from bare field names. The counters in particular (`entriesUpdated`\n * vs `entriesUpgraded` vs `entriesSkipped`) are indistinguishable without the\n * per-mode contract stated below.\n *\n * NOTE ON THE REGISTRY KEY: `dataSeedRuns` is a `BackendResourceType`, not a\n * `CoreResourceType`, so its schema and factory live in `@wildo-ai/saas-backend-lib`\n * rather than `@wildo-ai/saas-models`, and its entry in\n * `engineResourceSpecificationsByType` is keyed by the literal resource-type\n * string. The registry is typed `Record<string, …>`, and the runtime-scope\n * alignment guard intersects specs with the CORE registry, so this resource is\n * correctly outside that guard's population rather than silently breaking it.\n *\n * WHY THIS ONE SPEC CARRIES AN EXPLICIT TYPE ANNOTATION (the other 58 do not).\n *\n * `resourceSpecification` returns `ResourceSpecificationConfig<TCustomOp, TCoreOp, TSchema>`,\n * so an unannotated spec exports a type whose arguments are named from wherever its schema\n * and factory live. For every other engine spec that is `@wildo-ai/saas-models`, which this\n * package depends on directly and can always name. This resource is the sole exception — its\n * schema and factory come from `@wildo-ai/saas-backend-lib/data-seeding-models`, because\n * `dataSeedRuns` is a `BackendResourceType` (see the registry note above). That made the\n * inferred type unnameable except through a non-portable nested path\n * (`node_modules/@wildo-ai/saas-frontend-lib/node_modules/@wildo-ai/saas-models/src`), which\n * `isolatedDeclarations`-style declaration emit rejects with TS2742.\n *\n * The annotation is NOT merely a workaround for that. The same declaration also tripped TS7056\n * (`inferred type ... exceeds the maximum length the compiler will serialize`) — this resource\n * authors on the order of a thousand field-spec keys — and TS7056 has no remedy other than an\n * explicit annotation. No amount of dependency or entrypoint surgery removes it, so an\n * annotation is required here regardless of how the package boundary is drawn.\n *\n * `AnyResourceSpecificationConfig` loses nothing at the only consumption point. The sole\n * consumer is `engineResourceSpecificationsByType`, declared `ResourceSpecification`\n * (= `Record<string, AnyResourceSpecificationConfig>`), so the precise generic instantiation\n * was already erased there. Authoring-time checking of the callback body is unaffected: the\n * `resourceSpecification(...)` call still infers `TSchema` from `DataSeedRunSchema` and\n * type-checks the config against it before the annotation widens the exported binding.\n *\n * If a future spec also sources its schema from a package other than `saas-models`, it will hit\n * the same wall and should follow this pattern rather than re-deriving it.\n */\nexport const dataSeedRunsResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n dataSeedRunFactory,\n DataSeedRunSchema,\n ({ schemaShape }) => ({\n purpose: 'Record one pass of the data-seeding dispatcher so the platform knows whether a seed has already been applied to a given scope at a given version.',\n businessRole: 'Operational control-plane ledger used to make seeding idempotent across restarts, and to troubleshoot what a seeding pass inserted, upgraded, skipped, or failed on.',\n lifecycleRole: 'Opens as a running pass when the dispatcher starts, then settles once into completed, partial, or failed. Deleting a settled row is the supported gesture for making the next pass treat that scope as un-run.',\n audience: LabelAudience.DEVELOPER,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedRunSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'dataSeedRunResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'BackendResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'DATA_SEED_RUN',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Stable identifier of one recorded seeding pass.',\n whyItMatters: 'It is what an operator addresses when deleting a settled pass to force the next dispatcher run to re-apply that seed.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n seedKey: schemaShape.seedKey.stringSpec({\n meaning: 'Stable name of the seed declaration this pass executed.',\n whyItMatters: 'It is the primary way an operator groups the history of one seed across every scope and version it has been applied to.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n seedVersion: schemaShape.seedVersion.numberSpec({\n meaning: 'The version the seed declaration carried when this pass ran.',\n whyItMatters: 'Raising the declared version is how a developer asks for a re-run; the dispatcher decides by comparing the declared version against the highest version already recorded as completed for the same scope.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n mode: schemaShape.mode.enumSpec({\n meaning: 'The reconciliation strategy the pass applied to the declared entries.',\n whyItMatters: 'It determines which counters below can be non-zero and whether rows outside the declared set were touched at all, so it is the first thing to read when a pass did something unexpected.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedMode',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedMode.LAZY]: { meaning: 'Create the entry the first time the scope is accessed if it is missing. Always safe to repeat.' },\n [DataSeedMode.ADDITIVE]: { meaning: 'Insert entries that are absent and re-apply the declared payload to entries that are present. Never removes anything and never walks rows outside the declared set.' },\n [DataSeedMode.UPGRADE]: { meaning: 'Insert entries that are absent and migrate entries whose recorded version is behind the declared one.' },\n [DataSeedMode.SYNC]: { meaning: 'Treat the declared entries as the full truth: insert what is missing, update what changed, and handle rows that are no longer declared according to the seed orphan policy.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n scopeKind: schemaShape.scopeKind.enumSpec({\n meaning: 'The unit this pass seeded — the whole database, one application, one organization, one user, or one row of some other resource type.',\n whyItMatters: 'Seeding is idempotent per scope, so the scope is half of the answer to \"has this already run?\".',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedScopeKind',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedScopeKind.GLOBAL]: { meaning: 'Applied once for the whole database. There is no anchor row.' },\n [DataSeedScopeKind.APPLICATION]: { meaning: 'Applied once per application.' },\n [DataSeedScopeKind.ORGANIZATION]: { meaning: 'Applied once per organization.' },\n [DataSeedScopeKind.USER]: { meaning: 'Applied once per user.' },\n [DataSeedScopeKind.CUSTOM]: { meaning: 'Applied once per row of some other resource type, which is named separately on the pass.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n relatedResourceType: schemaShape.relatedResourceType.stringSpec({\n meaning: 'The resource type whose row anchors a custom-scope pass. Empty for the built-in scopes, whose resource is implied by the scope itself.',\n whyItMatters: 'Two custom-scope seeds can legitimately anchor on the same row identifier under different resource types, so this is what keeps their histories apart.',\n }),\n\n relatedId: schemaShape.relatedId.stringSpec({\n meaning: 'Identifier of the row that anchors this scope. Empty only for a database-wide pass, which has no anchor.',\n whyItMatters: 'It is what narrows the ledger from \"every run of this seed\" to \"the run for this particular organization, user, or row\".',\n semanticRole: 'identifier',\n }),\n\n triggerOrigin: schemaShape.triggerOrigin.enumSpec({\n meaning: 'Coarse classification of what caused the dispatcher to fire.',\n whyItMatters: 'It is the filterable form of the trigger, so history can be narrowed to one pathway without reading the trigger declaration on every row.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedTriggerOrigin',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedTriggerOrigin.APP_INIT]: { meaning: 'Fired while the application was starting up.' },\n [DataSeedTriggerOrigin.APP_VERSION_UPGRADE]: { meaning: 'Fired because the application moved to a new version.' },\n [DataSeedTriggerOrigin.RESOURCE_LIFECYCLE]: { meaning: 'Fired by a write to the resource that anchors the scope, such as a new organization being created.' },\n [DataSeedTriggerOrigin.LAZY_ACCESS]: { meaning: 'Fired the first time something read the scope and the seeded data was not there yet.' },\n [DataSeedTriggerOrigin.CRON]: { meaning: 'Reserved for a cron primitive that fires outside a declared seed schedule. No current caller.' },\n [DataSeedTriggerOrigin.ADMIN_MANUAL]: { meaning: 'Fired by an administrator asking for the seed to be run.' },\n [DataSeedTriggerOrigin.SCHEDULED_RERUN]: { meaning: 'Fired by the platform because the seed declaration\\'s own schedule matched the current tick.' },\n },\n }),\n\n triggeredByUserId: schemaShape.triggeredByUserId.stringSpec({\n meaning: 'The user whose action caused the dispatcher to fire. Empty for passes the platform started on its own.',\n whyItMatters: 'It is attribution only, never authority: the seed itself always runs with internal system permissions regardless of who triggered it.',\n semanticRole: 'identifier',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Outcome of the pass.',\n whyItMatters: 'It is the signal the dispatcher itself reads to decide whether a scope still needs seeding, and the first thing an operator filters on.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedRunStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedRunStatus.RUNNING]: { meaning: 'The pass started and has not settled. A pass left in this state by a crash is superseded by the next pass rather than timing out.' },\n [DataSeedRunStatus.COMPLETED]: { meaning: 'Every declared entry succeeded.' },\n [DataSeedRunStatus.PARTIAL]: { meaning: 'At least one entry failed but the pass carried on and reported the rest.' },\n [DataSeedRunStatus.FAILED]: { meaning: 'The pass itself stopped before finishing.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n startedAt: schemaShape.startedAt.dateSpec({\n meaning: 'When the pass began.',\n }),\n\n finishedAt: schemaShape.finishedAt.dateSpec({\n meaning: 'When the pass settled. Empty while it is still running.',\n whyItMatters: 'The gap between this and the start time is the only duration signal for a seeding pass.',\n }),\n\n entriesAttempted: schemaShape.entriesAttempted.numberSpec({\n meaning: 'How many declared entries the pass walked. Counted before each entry is tried, so it matches the declared set whatever the outcome.',\n whyItMatters: 'When it does not match the number of entries in the declaration, the declaration and the deployed code have drifted apart.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n entriesInserted: schemaShape.entriesInserted.numberSpec({\n meaning: 'How many declared entries were written because no matching row existed.',\n }),\n\n entriesUpdated: schemaShape.entriesUpdated.numberSpec({\n meaning: 'How many already-present rows had the declared payload re-applied to them.',\n whyItMatters: 'This is the additive-mode counter. A version migration is counted separately, so a non-zero value here means the payload was re-stamped, not migrated.',\n }),\n\n entriesUpgraded: schemaShape.entriesUpgraded.numberSpec({\n meaning: 'How many present rows were behind the declared version and were migrated forward.',\n }),\n\n entriesRenamed: schemaShape.entriesRenamed.numberSpec({\n meaning: 'How many rows were relocated from a previous identity because the declaration renamed them.',\n }),\n\n entriesSkipped: schemaShape.entriesSkipped.numberSpec({\n meaning: 'How many declared entries the pass deliberately left untouched — already current, or protected from being moved backwards.',\n whyItMatters: 'Skipping is a normal outcome, not a failure; the reason for each skip is reported separately.',\n }),\n\n entriesDeleted: schemaShape.entriesDeleted.numberSpec({\n meaning: 'How many rows outside the declared set were removed. Only a full-reconciliation pass configured to delete can produce this.',\n }),\n\n entriesDeprecated: schemaShape.entriesDeprecated.numberSpec({\n meaning: 'How many rows outside the declared set were marked deprecated instead of removed.',\n }),\n\n entriesReportedOrphans: schemaShape.entriesReportedOrphans.numberSpec({\n meaning: 'How many rows outside the declared set were only reported, leaving the rows themselves untouched.',\n }),\n\n entriesFailed: schemaShape.entriesFailed.numberSpec({\n meaning: 'How many entries could not be written. The pass continues and settles as partial.',\n whyItMatters: 'It is the count behind a partial outcome; the per-entry detail lives in the report below.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n failureReport: schemaShape.failureReport.objectSpec({\n meaning: 'Detailed breakdown of everything non-trivial the pass encountered: which entries failed and why, which rows fell outside the declared set, and any error that stopped the pass as a whole. Empty when everything succeeded.',\n whyItMatters: 'It is what lets an operator diagnose a partial or failed pass without going to application logs.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n },\n\n /**\n * `trigger` is documented here rather than in `fields` because it is a\n * DISCRIMINATED UNION, and the spec decorators are declared on `ZodObject`\n * / `ZodUnion` but not on `ZodDiscriminatedUnion` — `schemaShape.trigger.objectSpec(...)`\n * does not type-check. Without an entry of some kind the field would reach the\n * label generator as a bare name and the generator would invent terminology for\n * it (the same failure mode `RETENTION_MARKER_FIELD_SPECS` documents), so the\n * meaning is declared through the escape hatch instead of dropped.\n */\n additionalFieldSpecs: [\n {\n fieldName: 'trigger',\n specDecorator: 'objectSpec',\n params: {\n meaning: 'The full trigger declaration that caused this pass, copied verbatim from the seed definition.',\n whyItMatters: 'Its shape varies by what fired the pass, so it carries the detail — the lifecycle event, the schedule, the access path — that the coarse trigger origin deliberately flattens away.',\n },\n },\n ],\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Open the ledger row for a seeding pass that is about to start.',\n outcome: 'The pass becomes visible as running before it touches any data, so a crash mid-pass leaves a trace rather than nothing.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The pass was recorded as running and the row is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The pass description fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher open its own ledger row. There is no externally reachable way to create one.',\n },\n },\n },\n\n [Op.READ]: {\n purpose: 'Read one recorded seeding pass.',\n outcome: 'The caller can inspect exactly what one pass did to one scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The recorded pass was found and is returned with its counters and report.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier — never recorded, or already removed by an administrator or by history cleanup.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator. This ledger is never exposed to ordinary tenant callers.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher recover a previous attempt before writing the outcome of the current one.',\n },\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator inspect one pass from the back office.',\n },\n },\n },\n\n [Op.UPDATE]: {\n purpose: 'Settle a running pass with its outcome and counters.',\n outcome: 'The ledger stops saying the pass is in flight and starts being the answer to whether the seed already applied.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The pass recorded its outcome, timing, counters and failure report, and the settled row is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier to settle.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The outcome fails schema validation, for example an unrecognized status.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A caller outside the dispatcher attempts to rewrite a pass outcome.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher write the terminal outcome of the pass it opened.',\n whenToUse: 'Use when a pass has finished walking its entries, whether it succeeded, partially succeeded, or stopped.',\n },\n },\n },\n\n [Op.DELETE]: {\n purpose: 'Remove a recorded pass so the next dispatcher run treats that scope as never seeded.',\n outcome: 'The seed is re-applied to that scope on the next run, without editing or re-deploying the seed declaration.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The recorded pass was removed and the scope is eligible for seeding again.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Give a platform administrator the supported re-run gesture.',\n whenToUse: 'Use when a seed must be applied again to one scope and raising the declared version would wrongly re-run it everywhere. The dispatcher never deletes its own history.',\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate recorded seeding passes.',\n outcome: 'The caller sees seeding history as a set rather than one pass at a time.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A page of recorded passes, possibly empty, narrowed by the requested seed, scope, status, or trigger filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator authorized to enumerate seeding history.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher enumerate prior passes while deciding whether a scope still needs seeding.',\n },\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator browse seeding history from the back office.',\n },\n },\n },\n\n [Op.COUNT]: {\n purpose: 'Count recorded passes matching a set of conditions.',\n outcome: 'The dispatcher can answer \"has any completed pass already covered this scope?\" without loading the rows.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The number of recorded passes matching the conditions.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Back the dispatcher\\'s already-seeded check, which needs only a yes or no and never the rows themselves.',\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Search seeding history by seed name or anchor row.',\n outcome: 'An administrator can narrow history to the passes relevant to one seed or one affected row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A page of recorded passes, possibly empty, matching the search term and any filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator authorized to query seeding history.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator find passes by seed name or by the row a pass was anchored to.',\n whenToUse: 'Use when troubleshooting starts from \"which seed touched this row\" rather than from a known pass identifier.',\n },\n },\n },\n },\n\n businessConstraints: [\n 'This ledger records what a seeding pass did. It is never the source of truth for the data the seed produced — that lives on the seeded rows themselves.',\n 'A pass is identified by its seed, its scope, and its declared version together. That identity is what makes seeding safe to repeat, so it must not be widened or narrowed casually.',\n 'Who triggered a pass is recorded for attribution only. Seeding always runs with internal system permissions, so the recorded user never confers authority.',\n 'Removing a recorded pass is a deliberate administrative re-run gesture. The dispatcher itself never deletes its own history, because the history is what makes the next decision correct.',\n ],\n }),\n // DATA_SEED_RUN is a STANDALONE infrastructure ledger reached only through\n // internal repository services and a platform-administrator back-office path.\n // The `APPLICATION → DATA_SEED_RUN` relationship is routing-side only (the row\n // carries no application identifier of its own), which is why the scope is\n // declared here rather than derived from a scope-owning parent.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
1
+ {"version":3,"file":"data-seed-runs.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/data-seed-runs.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n DataSeedMode,\n DataSeedRunSchema,\n DataSeedRunStatus,\n DataSeedRunVariantKey,\n DataSeedScopeKind,\n DataSeedTriggerOrigin,\n dataSeedRunResourceConfiguration_InitializationFactory as dataSeedRunFactory,\n} from '@wildo-ai/saas-backend-lib/data-seeding-models';\nimport { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { type AnyResourceSpecificationConfig, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for the internal `dataSeedRuns` resource — the\n * persistence ledger the data-seeding dispatcher writes one row to per pass.\n *\n * Like `jobExecutions`, this is a platform/infrastructure truth source rather\n * than an end-user surface: its useful semantic layer is the operational model\n * (did this seed already run for this scope at this version, and what did the\n * pass do?), not UI narration. Its only human-facing surface is the back-office\n * ADMIN read/search path and the `DELETE` re-run gesture.\n *\n * Authored 2026-08-21 because the label generator was producing this resource's\n * ~1000 keys with NO spec context at all — the companion logged\n * `No resource specification found for \"dataSeedRuns\"` on every run and invented\n * terminology from bare field names. The counters in particular (`entriesUpdated`\n * vs `entriesUpgraded` vs `entriesSkipped`) are indistinguishable without the\n * per-mode contract stated below.\n *\n * NOTE ON THE REGISTRY KEY: `dataSeedRuns` is a `BackendResourceType`, not a\n * `CoreResourceType`, so its schema and factory live in `@wildo-ai/saas-backend-lib`\n * rather than `@wildo-ai/saas-models`, and its entry in\n * `engineResourceSpecificationsByType` is keyed by the literal resource-type\n * string. The registry is typed `Record<string, …>`, and the runtime-scope\n * alignment guard intersects specs with the CORE registry, so this resource is\n * correctly outside that guard's population rather than silently breaking it.\n *\n * WHY THIS ONE SPEC CARRIES AN EXPLICIT TYPE ANNOTATION (the other 58 do not).\n *\n * `resourceSpecification` returns `ResourceSpecificationConfig<TCustomOp, TCoreOp, TSchema>`,\n * so an unannotated spec exports a type whose arguments are named from wherever its schema\n * and factory live. For every other engine spec that is `@wildo-ai/saas-models`, which this\n * package depends on directly and can always name. This resource is the sole exception — its\n * schema and factory come from `@wildo-ai/saas-backend-lib/data-seeding-models`, because\n * `dataSeedRuns` is a `BackendResourceType` (see the registry note above). That made the\n * inferred type unnameable except through a non-portable nested path\n * (`node_modules/@wildo-ai/saas-frontend-lib/node_modules/@wildo-ai/saas-models/src`), which\n * `isolatedDeclarations`-style declaration emit rejects with TS2742.\n *\n * The annotation is NOT merely a workaround for that. The same declaration also tripped TS7056\n * (`inferred type ... exceeds the maximum length the compiler will serialize`) — this resource\n * authors on the order of a thousand field-spec keys — and TS7056 has no remedy other than an\n * explicit annotation. No amount of dependency or entrypoint surgery removes it, so an\n * annotation is required here regardless of how the package boundary is drawn.\n *\n * `AnyResourceSpecificationConfig` loses nothing at the only consumption point. The sole\n * consumer is `engineResourceSpecificationsByType`, declared `ResourceSpecification`\n * (= `Record<string, AnyResourceSpecificationConfig>`), so the precise generic instantiation\n * was already erased there. Authoring-time checking of the callback body is unaffected: the\n * `resourceSpecification(...)` call still infers `TSchema` from `DataSeedRunSchema` and\n * type-checks the config against it before the annotation widens the exported binding.\n *\n * If a future spec also sources its schema from a package other than `saas-models`, it will hit\n * the same wall and should follow this pattern rather than re-deriving it.\n */\nexport const dataSeedRunsResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n dataSeedRunFactory,\n DataSeedRunSchema,\n ({ schemaShape }) => ({\n purpose: 'Record one pass of the data-seeding dispatcher so the platform knows whether a seed has already been applied to a given scope at a given version.',\n businessRole: 'Operational control-plane ledger used to make seeding idempotent across restarts, and to troubleshoot what a seeding pass inserted, upgraded, skipped, or failed on.',\n lifecycleRole: 'Opens as a running pass when the dispatcher starts, then settles once into completed, partial, or failed. Deleting a settled row is the supported gesture for making the next pass treat that scope as un-run.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.INFRASTRUCTURE,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedRunSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'dataSeedRunResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'BackendResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'DATA_SEED_RUN',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Stable identifier of one recorded seeding pass.',\n whyItMatters: 'It is what an operator addresses when deleting a settled pass to force the next dispatcher run to re-apply that seed.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n seedKey: schemaShape.seedKey.stringSpec({\n meaning: 'Stable name of the seed declaration this pass executed.',\n whyItMatters: 'It is the primary way an operator groups the history of one seed across every scope and version it has been applied to.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n seedVersion: schemaShape.seedVersion.numberSpec({\n meaning: 'The version the seed declaration carried when this pass ran.',\n whyItMatters: 'Raising the declared version is how a developer asks for a re-run; the dispatcher decides by comparing the declared version against the highest version already recorded as completed for the same scope.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n mode: schemaShape.mode.enumSpec({\n meaning: 'The reconciliation strategy the pass applied to the declared entries.',\n whyItMatters: 'It determines which counters below can be non-zero and whether rows outside the declared set were touched at all, so it is the first thing to read when a pass did something unexpected.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedMode',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedMode.LAZY]: { meaning: 'Create the entry the first time the scope is accessed if it is missing. Always safe to repeat.' },\n [DataSeedMode.ADDITIVE]: { meaning: 'Insert entries that are absent and re-apply the declared payload to entries that are present. Never removes anything and never walks records outside the declared set.' },\n [DataSeedMode.UPGRADE]: { meaning: 'Insert entries that are absent and migrate entries whose recorded version is behind the declared one.' },\n [DataSeedMode.SYNC]: { meaning: 'Treat the declared entries as the full truth: insert what is missing, update what changed, and handle records that are no longer declared according to the seed orphan policy.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n scopeKind: schemaShape.scopeKind.enumSpec({\n meaning: 'The unit this pass seeded — the whole database, one application, one organization, one user, or one record of some other resource type.',\n whyItMatters: 'Seeding is idempotent per scope, so the scope is half of the answer to \"has this already run?\".',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedScopeKind',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedScopeKind.GLOBAL]: { meaning: 'Applied once for the whole database. There is no anchor record.' },\n [DataSeedScopeKind.APPLICATION]: { meaning: 'Applied once per application.' },\n [DataSeedScopeKind.ORGANIZATION]: { meaning: 'Applied once per organization.' },\n [DataSeedScopeKind.USER]: { meaning: 'Applied once per user.' },\n [DataSeedScopeKind.CUSTOM]: { meaning: 'Applied once per record of some other resource type, which is named separately on the pass.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n relatedResourceType: schemaShape.relatedResourceType.stringSpec({\n meaning: 'The resource type whose record anchors a custom-scope pass. Empty for the built-in scopes, whose resource is implied by the scope itself.',\n whyItMatters: 'Two custom-scope seeds can legitimately anchor on the same row identifier under different resource types, so this is what keeps their histories apart.',\n }),\n\n relatedId: schemaShape.relatedId.stringSpec({\n meaning: 'Identifier of the record that anchors this scope. Empty only for a database-wide pass, which has no anchor.',\n whyItMatters: 'It is what narrows the ledger from \"every run of this seed\" to \"the run for this particular organization, user, or row\".',\n semanticRole: 'identifier',\n }),\n\n triggerOrigin: schemaShape.triggerOrigin.enumSpec({\n meaning: 'Coarse classification of what caused the dispatcher to fire.',\n whyItMatters: 'It is the filterable form of the trigger, so history can be narrowed to one pathway without reading the trigger declaration on every row.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedTriggerOrigin',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedTriggerOrigin.APP_INIT]: { meaning: 'Fired while the application was starting up.' },\n [DataSeedTriggerOrigin.APP_VERSION_UPGRADE]: { meaning: 'Fired because the application moved to a new version.' },\n [DataSeedTriggerOrigin.RESOURCE_LIFECYCLE]: { meaning: 'Fired by a write to the resource that anchors the scope, such as a new organization being created.' },\n [DataSeedTriggerOrigin.LAZY_ACCESS]: { meaning: 'Fired the first time something read the scope and the seeded data was not there yet.' },\n [DataSeedTriggerOrigin.CRON]: { meaning: 'Reserved for a cron primitive that fires outside a declared seed schedule. No current caller.' },\n [DataSeedTriggerOrigin.ADMIN_MANUAL]: { meaning: 'Fired by an administrator asking for the seed to be run.' },\n [DataSeedTriggerOrigin.SCHEDULED_RERUN]: { meaning: 'Fired by the platform because the seed declaration\\'s own schedule matched the current tick.' },\n },\n }),\n\n triggeredByUserId: schemaShape.triggeredByUserId.stringSpec({\n meaning: 'The user whose action caused the dispatcher to fire. Empty for passes the platform started on its own.',\n whyItMatters: 'It is attribution only, never authority: the seed itself always runs with internal system permissions regardless of who triggered it.',\n semanticRole: 'identifier',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Outcome of the pass.',\n whyItMatters: 'It is the signal the dispatcher itself reads to decide whether a scope still needs seeding, and the first thing an operator filters on.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedRunStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedRunStatus.RUNNING]: { meaning: 'The pass started and has not settled. A pass left in this state by a crash is superseded by the next pass rather than timing out.' },\n [DataSeedRunStatus.COMPLETED]: { meaning: 'Every declared entry succeeded.' },\n [DataSeedRunStatus.PARTIAL]: { meaning: 'At least one entry failed but the pass carried on and reported the rest.' },\n [DataSeedRunStatus.FAILED]: { meaning: 'The pass itself stopped before finishing.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n startedAt: schemaShape.startedAt.dateSpec({\n meaning: 'When the pass began.',\n }),\n\n finishedAt: schemaShape.finishedAt.dateSpec({\n meaning: 'When the pass settled. Empty while it is still running.',\n whyItMatters: 'The gap between this and the start time is the only duration signal for a seeding pass.',\n }),\n\n entriesAttempted: schemaShape.entriesAttempted.numberSpec({\n meaning: 'How many declared entries the pass walked. Counted before each entry is tried, so it matches the declared set whatever the outcome.',\n whyItMatters: 'When it does not match the number of entries in the declaration, the declaration and the deployed code have drifted apart.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n entriesInserted: schemaShape.entriesInserted.numberSpec({\n meaning: 'How many declared entries were written because no matching record existed.',\n }),\n\n entriesUpdated: schemaShape.entriesUpdated.numberSpec({\n meaning: 'How many already-present records had the declared payload re-applied to them.',\n whyItMatters: 'This is the additive-mode counter. A version migration is counted separately, so a non-zero value here means the payload was re-stamped, not migrated.',\n }),\n\n entriesUpgraded: schemaShape.entriesUpgraded.numberSpec({\n meaning: 'How many present records were behind the declared version and were migrated forward.',\n }),\n\n entriesRenamed: schemaShape.entriesRenamed.numberSpec({\n meaning: 'How many records were relocated from a previous identity because the declaration renamed them.',\n }),\n\n entriesSkipped: schemaShape.entriesSkipped.numberSpec({\n meaning: 'How many declared entries the pass deliberately left untouched — already current, or protected from being moved backwards.',\n whyItMatters: 'Skipping is a normal outcome, not a failure; the reason for each skip is reported separately.',\n }),\n\n entriesDeleted: schemaShape.entriesDeleted.numberSpec({\n meaning: 'How many records outside the declared set were removed. Only a full-reconciliation pass configured to delete can produce this.',\n }),\n\n entriesDeprecated: schemaShape.entriesDeprecated.numberSpec({\n meaning: 'How many records outside the declared set were marked deprecated instead of removed.',\n }),\n\n entriesReportedOrphans: schemaShape.entriesReportedOrphans.numberSpec({\n meaning: 'How many records outside the declared set were only reported, leaving the records themselves untouched.',\n }),\n\n entriesFailed: schemaShape.entriesFailed.numberSpec({\n meaning: 'How many entries could not be written. The pass continues and settles as partial.',\n whyItMatters: 'It is the count behind a partial outcome; the per-entry detail lives in the report below.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n failureReport: schemaShape.failureReport.objectSpec({\n meaning: 'Detailed breakdown of everything non-trivial the pass encountered: which entries failed and why, which records fell outside the declared set, and any error that stopped the pass as a whole. Empty when everything succeeded.',\n whyItMatters: 'It is what lets an operator diagnose a partial or failed pass without going to application logs.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n },\n\n /**\n * `trigger` is documented here rather than in `fields` because it is a\n * DISCRIMINATED UNION, and the spec decorators are declared on `ZodObject`\n * / `ZodUnion` but not on `ZodDiscriminatedUnion` — `schemaShape.trigger.objectSpec(...)`\n * does not type-check. Without an entry of some kind the field would reach the\n * label generator as a bare name and the generator would invent terminology for\n * it (the same failure mode `RETENTION_MARKER_FIELD_SPECS` documents), so the\n * meaning is declared through the escape hatch instead of dropped.\n */\n additionalFieldSpecs: [\n {\n fieldName: 'trigger',\n specDecorator: 'objectSpec',\n params: {\n meaning: 'The full trigger declaration that caused this pass, copied verbatim from the seed definition.',\n whyItMatters: 'Its shape varies by what fired the pass, so it carries the detail — the lifecycle event, the schedule, the access path — that the coarse trigger origin deliberately flattens away.',\n },\n },\n ],\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Open the ledger row for a seeding pass that is about to start.',\n outcome: 'The pass becomes visible as running before it touches any data, so a crash mid-pass leaves a trace rather than nothing.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The pass was recorded as running and the record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The pass description fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher open its own ledger row. There is no externally reachable way to create one.',\n },\n },\n },\n\n [Op.READ]: {\n purpose: 'Read one recorded seeding pass.',\n outcome: 'The caller can inspect exactly what one pass did to one scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The recorded pass was found and is returned with its counters and report.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier — never recorded, or already removed by an administrator or by history cleanup.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator. This ledger is never exposed to ordinary tenant callers.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher recover a previous attempt before writing the outcome of the current one.',\n },\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator inspect one pass from the back office.',\n },\n },\n },\n\n [Op.UPDATE]: {\n purpose: 'Settle a running pass with its outcome and counters.',\n outcome: 'The ledger stops saying the pass is in flight and starts being the answer to whether the seed already applied.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The pass recorded its outcome, timing, counters and failure report, and the settled record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier to settle.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The outcome fails schema validation, for example an unrecognized status.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A caller outside the dispatcher attempts to rewrite a pass outcome.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher write the terminal outcome of the pass it opened.',\n whenToUse: 'Use when a pass has finished walking its entries, whether it succeeded, partially succeeded, or stopped.',\n },\n },\n },\n\n [Op.DELETE]: {\n purpose: 'Remove a recorded pass so the next dispatcher run treats that scope as never seeded.',\n outcome: 'The seed is re-applied to that scope on the next run, without editing or re-deploying the seed declaration.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The recorded pass was removed and the scope is eligible for seeding again.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Give a platform administrator the supported re-run gesture.',\n whenToUse: 'Use when a seed must be applied again to one scope and raising the declared version would wrongly re-run it everywhere. The dispatcher never deletes its own history.',\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate recorded seeding passes.',\n outcome: 'The caller sees seeding history as a set rather than one pass at a time.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A page of recorded passes, possibly empty, narrowed by the requested seed, scope, status, or trigger filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator authorized to enumerate seeding history.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher enumerate prior passes while deciding whether a scope still needs seeding.',\n },\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator browse seeding history from the back office.',\n },\n },\n },\n\n [Op.COUNT]: {\n purpose: 'Count recorded passes matching a set of conditions.',\n outcome: 'The dispatcher can answer \"has any completed pass already covered this scope?\" without loading the rows.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The number of recorded passes matching the conditions.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Back the dispatcher\\'s already-seeded check, which needs only a yes or no and never the rows themselves.',\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Search seeding history by seed name or anchor row.',\n outcome: 'An administrator can narrow history to the passes relevant to one seed or one affected row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A page of recorded passes, possibly empty, matching the search term and any filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator authorized to query seeding history.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator find passes by seed name or by the row a pass was anchored to.',\n whenToUse: 'Use when troubleshooting starts from \"which seed touched this row\" rather than from a known pass identifier.',\n },\n },\n },\n },\n\n businessConstraints: [\n 'This ledger records what a seeding pass did. It is never the source of truth for the data the seed produced — that lives on the seeded rows themselves.',\n 'A pass is identified by its seed, its scope, and its declared version together. That identity is what makes seeding safe to repeat, so it must not be widened or narrowed casually.',\n 'Who triggered a pass is recorded for attribution only. Seeding always runs with internal system permissions, so the recorded user never confers authority.',\n 'Removing a recorded pass is a deliberate administrative re-run gesture. The dispatcher itself never deletes its own history, because the history is what makes the next decision correct.',\n ],\n }),\n // DATA_SEED_RUN is a STANDALONE infrastructure ledger reached only through\n // internal repository services and a platform-administrator back-office path.\n // The `APPLICATION → DATA_SEED_RUN` relationship is routing-side only (the row\n // carries no application identifier of its own), which is why the scope is\n // declared here rather than derived from a scope-owning parent.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"external-data-pipeline-states.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,8BAA8B,EAAiD,MAAM,6BAA6B,CAAC;AAEjI;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,+CAA+C,EAAE,8BA2J7D,CAAC"}
1
+ {"version":3,"file":"external-data-pipeline-states.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,KAAK,8BAA8B,EAAiD,MAAM,6BAA6B,CAAC;AAGjI;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,+CAA+C,EAAE,8BA4J7D,CAAC"}
@@ -3,6 +3,7 @@ import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, } from '@
3
3
  import { ExternalDataPipelineStateSchema, ExternalDataPipelineStateVariantKey, externalDataPipelineStateResourceConfiguration_InitializationFactory as etlPipelineStateFactory, } from '@wildo-ai/saas-backend-lib/external-data-models';
4
4
  import { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';
5
5
  import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
6
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
6
7
  /**
7
8
  * Framework-owned specification for the internal `etlPipelineStates` resource — one bookkeeping
8
9
  * row per declared ETL pipeline (a local resource's `externalDataPipeline`), holding the persisted
@@ -24,6 +25,7 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
24
25
  businessRole: 'Operational control-plane row that lets a pipeline whose remote population exceeds one run\'s budget continue across runs and process restarts instead of re-reading the same first pages forever.',
25
26
  lifecycleRole: 'Created on the pipeline\'s first run and updated at the end of every run; the cursor fills while a pass is in flight across runs and clears when a pass completes.',
26
27
  audience: LabelAudience.DEVELOPER,
28
+ subDomain: EngineResourceSubDomain.INFRASTRUCTURE,
27
29
  codeHandling: {
28
30
  mainSchema: {
29
31
  packageName: '@wildo-ai/saas-backend-lib',
@@ -57,12 +59,12 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
57
59
  },
58
60
  fields: {
59
61
  _id: schemaShape._id.stringSpec({
60
- meaning: 'Stable identifier of this pipeline\'s bookkeeping row.',
62
+ meaning: 'Stable identifier of this pipeline\'s bookkeeping record.',
61
63
  semanticRole: 'identifier',
62
64
  importance: FieldSemanticImportance.PRIMARY,
63
65
  }),
64
66
  pipelineResourceType: schemaShape.pipelineResourceType.stringSpec({
65
- meaning: 'The destination resource whose declared pipeline this row tracks. One pipeline, one row.',
67
+ meaning: 'The destination resource whose declared pipeline this record tracks. One pipeline, one record.',
66
68
  whyItMatters: 'It is the row\'s identity: every run of the same pipeline reads and updates this same row.',
67
69
  importance: FieldSemanticImportance.PRIMARY,
68
70
  }),
@@ -78,7 +80,7 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
78
80
  meaning: 'When the most recent run started, whatever its outcome. Empty until the pipeline first runs.',
79
81
  }),
80
82
  lastRunSummary: schemaShape.lastRunSummary.objectSpec({
81
- meaning: 'What the most recent run did on the extraction side: whether it completed a full pass, how many remote rows it read, how many rows the transform rejected, how long it took, and which seeding-pass ledger row carries the per-entry load outcome.',
83
+ meaning: 'What the most recent run did on the extraction side: whether it completed a full pass, how many remote records it read, how many records the transform rejected, how long it took, and which seeding-pass ledger record carries the per-entry load outcome.',
82
84
  whyItMatters: 'The per-entry load detail deliberately lives on the seeding ledger; this summary carries the numbers only the extraction and transform stages can know.',
83
85
  importance: FieldSemanticImportance.PRIMARY,
84
86
  }),
@@ -88,7 +90,7 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
88
90
  purpose: 'Open the bookkeeping row the first time a pipeline runs.',
89
91
  outcome: 'The pipeline has a durable place to persist its cursor and run summaries.',
90
92
  responseStatuses: [
91
- { code: HttpResponseStatusCode.CREATED_201, meaning: 'The row was created and is returned.' },
93
+ { code: HttpResponseStatusCode.CREATED_201, meaning: 'The record was created and is returned.' },
92
94
  ],
93
95
  errorScenarios: [
94
96
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The row fails schema validation.', errorCode: 'VALIDATION_FAILED' },
@@ -104,7 +106,7 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
104
106
  purpose: 'Read one pipeline\'s bookkeeping row.',
105
107
  outcome: 'The run service learns whether a pass is in flight and where to resume it.',
106
108
  responseStatuses: [
107
- { code: HttpResponseStatusCode.OK_200, meaning: 'The row was found and is returned.' },
109
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The record was found and is returned.' },
108
110
  ],
109
111
  errorScenarios: [
110
112
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No row exists for the pipeline — it has never run.' },
@@ -120,7 +122,7 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
120
122
  purpose: 'Persist the run\'s outcome: the advanced or cleared cursor and the fresh summary.',
121
123
  outcome: 'The next run continues exactly where this one stopped, or starts a fresh pass.',
122
124
  responseStatuses: [
123
- { code: HttpResponseStatusCode.OK_200, meaning: 'The row was updated and is returned.' },
125
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The record was updated and is returned.' },
124
126
  ],
125
127
  errorScenarios: [
126
128
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No row exists for the supplied identifier.' },
@@ -137,7 +139,7 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
137
139
  purpose: 'Enumerate every pipeline\'s bookkeeping row.',
138
140
  outcome: 'The scheduled batch and future operator surfaces see all pipelines\' standing at once.',
139
141
  responseStatuses: [
140
- { code: HttpResponseStatusCode.OK_200, meaning: 'A page of bookkeeping rows, possibly empty.' },
142
+ { code: HttpResponseStatusCode.OK_200, meaning: 'A page of bookkeeping records, possibly empty.' },
141
143
  ],
142
144
  errorScenarios: [
143
145
  { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator. This row set is never exposed to ordinary tenant callers.' },
@@ -1 +1 @@
1
- {"version":3,"file":"external-data-pipeline-states.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n ExternalDataPipelineStateSchema,\n ExternalDataPipelineStateVariantKey,\n externalDataPipelineStateResourceConfiguration_InitializationFactory as etlPipelineStateFactory,\n} from '@wildo-ai/saas-backend-lib/external-data-models';\nimport { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { type AnyResourceSpecificationConfig, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\n\n/**\n * Framework-owned specification for the internal `etlPipelineStates` resource — one bookkeeping\n * row per declared ETL pipeline (a local resource's `externalDataPipeline`), holding the persisted\n * extraction cursor and the last run's summary.\n *\n * Like `dataSeedRuns`, this is infrastructure truth rather than an end-user surface: its\n * semantic layer is operational (where is the in-flight pass, what did the last run do), and its\n * only writer is the ETL run service. There is no human-facing surface yet — the operator read\n * surface is the recorded PR-28 follow-up.\n *\n * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` (a\n * `BackendResourceType` sourced from `@wildo-ai/saas-backend-lib`, outside the CORE-registry\n * alignment guard's population; the explicit `AnyResourceSpecificationConfig` annotation avoids\n * the non-portable-path TS2742) — see that spec's header for the full reasoning rather than a\n * re-derivation here.\n */\nexport const externalDataPipelineStatesResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n etlPipelineStateFactory,\n ExternalDataPipelineStateSchema,\n ({ schemaShape }) => ({\n purpose: 'Track one declared ETL pipeline between runs: where the current extraction pass stands, and what the most recent run did.',\n businessRole: 'Operational control-plane row that lets a pipeline whose remote population exceeds one run\\'s budget continue across runs and process restarts instead of re-reading the same first pages forever.',\n lifecycleRole: 'Created on the pipeline\\'s first run and updated at the end of every run; the cursor fills while a pass is in flight across runs and clears when a pass completes.',\n audience: LabelAudience.DEVELOPER,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'ExternalDataPipelineStateSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'externalDataPipelineStateResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'BackendResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'EXTERNAL_DATA_PIPELINE_STATE',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Stable identifier of this pipeline\\'s bookkeeping row.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n pipelineResourceType: schemaShape.pipelineResourceType.stringSpec({\n meaning: 'The destination resource whose declared pipeline this row tracks. One pipeline, one row.',\n whyItMatters: 'It is the row\\'s identity: every run of the same pipeline reads and updates this same row.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n cursor: schemaShape.cursor.stringSpec({\n meaning: 'Opaque continuation of an extraction pass that is still in flight. Empty when no pass is underway.',\n whyItMatters: 'It is what lets a pass larger than one run\\'s row budget continue across runs and restarts — and its presence is exactly the condition under which a run must not treat missing remote rows as deleted.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n passStartedAt: schemaShape.passStartedAt.dateSpec({\n meaning: 'When the in-flight extraction pass began. Empty when no pass is underway.',\n }),\n\n lastRunAt: schemaShape.lastRunAt.dateSpec({\n meaning: 'When the most recent run started, whatever its outcome. Empty until the pipeline first runs.',\n }),\n\n lastRunSummary: schemaShape.lastRunSummary.objectSpec({\n meaning: 'What the most recent run did on the extraction side: whether it completed a full pass, how many remote rows it read, how many rows the transform rejected, how long it took, and which seeding-pass ledger row carries the per-entry load outcome.',\n whyItMatters: 'The per-entry load detail deliberately lives on the seeding ledger; this summary carries the numbers only the extraction and transform stages can know.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n },\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Open the bookkeeping row the first time a pipeline runs.',\n outcome: 'The pipeline has a durable place to persist its cursor and run summaries.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The row was created and is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The row fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n variants: {\n [ExternalDataPipelineStateVariantKey.INTERNAL]: {\n purpose: 'Let the ETL run service open its own bookkeeping row. There is no externally reachable way to create one.',\n },\n },\n },\n\n [Op.READ]: {\n purpose: 'Read one pipeline\\'s bookkeeping row.',\n outcome: 'The run service learns whether a pass is in flight and where to resume it.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The row was found and is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No row exists for the pipeline — it has never run.' },\n ],\n idempotent: true,\n variants: {\n [ExternalDataPipelineStateVariantKey.INTERNAL]: {\n purpose: 'Let the run service recover the cursor at the start of every run.',\n },\n },\n },\n\n [Op.UPDATE]: {\n purpose: 'Persist the run\\'s outcome: the advanced or cleared cursor and the fresh summary.',\n outcome: 'The next run continues exactly where this one stopped, or starts a fresh pass.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The row was updated and is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No row exists for the supplied identifier.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patch fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: true,\n variants: {\n [ExternalDataPipelineStateVariantKey.INTERNAL]: {\n purpose: 'Let the run service settle each run\\'s cursor and summary.',\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate every pipeline\\'s bookkeeping row.',\n outcome: 'The scheduled batch and future operator surfaces see all pipelines\\' standing at once.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A page of bookkeeping rows, possibly empty.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator. This row set is never exposed to ordinary tenant callers.' },\n ],\n idempotent: true,\n variants: {\n [ExternalDataPipelineStateVariantKey.INTERNAL]: {\n purpose: 'Let engine machinery enumerate pipeline standing without an external surface.',\n },\n },\n },\n },\n\n businessConstraints: [\n 'This row is bookkeeping about a pipeline, never the pipeline\\'s data: deleting it costs a restarted extraction pass, not any synced content.',\n 'A non-empty cursor means an extraction pass is still in flight, and a run resuming from it must not treat rows absent from a partial extraction as deleted remotely.',\n 'The per-entry load outcome lives on the seeding-pass ledger this summary points at; the two records deliberately do not duplicate each other.',\n ],\n }),\n // Same posture as DATA_SEED_RUN: a STANDALONE infrastructure row reached only through internal\n // repository services; the APPLICATION relationship is routing-side only, so the scope is\n // declared here rather than derived from a scope-owning parent.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
1
+ {"version":3,"file":"external-data-pipeline-states.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n ExternalDataPipelineStateSchema,\n ExternalDataPipelineStateVariantKey,\n externalDataPipelineStateResourceConfiguration_InitializationFactory as etlPipelineStateFactory,\n} from '@wildo-ai/saas-backend-lib/external-data-models';\nimport { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { type AnyResourceSpecificationConfig, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for the internal `etlPipelineStates` resource — one bookkeeping\n * row per declared ETL pipeline (a local resource's `externalDataPipeline`), holding the persisted\n * extraction cursor and the last run's summary.\n *\n * Like `dataSeedRuns`, this is infrastructure truth rather than an end-user surface: its\n * semantic layer is operational (where is the in-flight pass, what did the last run do), and its\n * only writer is the ETL run service. There is no human-facing surface yet — the operator read\n * surface is the recorded PR-28 follow-up.\n *\n * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` (a\n * `BackendResourceType` sourced from `@wildo-ai/saas-backend-lib`, outside the CORE-registry\n * alignment guard's population; the explicit `AnyResourceSpecificationConfig` annotation avoids\n * the non-portable-path TS2742) — see that spec's header for the full reasoning rather than a\n * re-derivation here.\n */\nexport const externalDataPipelineStatesResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n etlPipelineStateFactory,\n ExternalDataPipelineStateSchema,\n ({ schemaShape }) => ({\n purpose: 'Track one declared ETL pipeline between runs: where the current extraction pass stands, and what the most recent run did.',\n businessRole: 'Operational control-plane row that lets a pipeline whose remote population exceeds one run\\'s budget continue across runs and process restarts instead of re-reading the same first pages forever.',\n lifecycleRole: 'Created on the pipeline\\'s first run and updated at the end of every run; the cursor fills while a pass is in flight across runs and clears when a pass completes.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.INFRASTRUCTURE,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'ExternalDataPipelineStateSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'externalDataPipelineStateResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'BackendResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'EXTERNAL_DATA_PIPELINE_STATE',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Stable identifier of this pipeline\\'s bookkeeping record.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n pipelineResourceType: schemaShape.pipelineResourceType.stringSpec({\n meaning: 'The destination resource whose declared pipeline this record tracks. One pipeline, one record.',\n whyItMatters: 'It is the row\\'s identity: every run of the same pipeline reads and updates this same row.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n cursor: schemaShape.cursor.stringSpec({\n meaning: 'Opaque continuation of an extraction pass that is still in flight. Empty when no pass is underway.',\n whyItMatters: 'It is what lets a pass larger than one run\\'s row budget continue across runs and restarts — and its presence is exactly the condition under which a run must not treat missing remote rows as deleted.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n passStartedAt: schemaShape.passStartedAt.dateSpec({\n meaning: 'When the in-flight extraction pass began. Empty when no pass is underway.',\n }),\n\n lastRunAt: schemaShape.lastRunAt.dateSpec({\n meaning: 'When the most recent run started, whatever its outcome. Empty until the pipeline first runs.',\n }),\n\n lastRunSummary: schemaShape.lastRunSummary.objectSpec({\n meaning: 'What the most recent run did on the extraction side: whether it completed a full pass, how many remote records it read, how many records the transform rejected, how long it took, and which seeding-pass ledger record carries the per-entry load outcome.',\n whyItMatters: 'The per-entry load detail deliberately lives on the seeding ledger; this summary carries the numbers only the extraction and transform stages can know.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n },\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Open the bookkeeping row the first time a pipeline runs.',\n outcome: 'The pipeline has a durable place to persist its cursor and run summaries.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The record was created and is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The row fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n variants: {\n [ExternalDataPipelineStateVariantKey.INTERNAL]: {\n purpose: 'Let the ETL run service open its own bookkeeping row. There is no externally reachable way to create one.',\n },\n },\n },\n\n [Op.READ]: {\n purpose: 'Read one pipeline\\'s bookkeeping row.',\n outcome: 'The run service learns whether a pass is in flight and where to resume it.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The record was found and is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No row exists for the pipeline — it has never run.' },\n ],\n idempotent: true,\n variants: {\n [ExternalDataPipelineStateVariantKey.INTERNAL]: {\n purpose: 'Let the run service recover the cursor at the start of every run.',\n },\n },\n },\n\n [Op.UPDATE]: {\n purpose: 'Persist the run\\'s outcome: the advanced or cleared cursor and the fresh summary.',\n outcome: 'The next run continues exactly where this one stopped, or starts a fresh pass.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The record was updated and is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No row exists for the supplied identifier.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patch fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: true,\n variants: {\n [ExternalDataPipelineStateVariantKey.INTERNAL]: {\n purpose: 'Let the run service settle each run\\'s cursor and summary.',\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate every pipeline\\'s bookkeeping row.',\n outcome: 'The scheduled batch and future operator surfaces see all pipelines\\' standing at once.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A page of bookkeeping records, possibly empty.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator. This row set is never exposed to ordinary tenant callers.' },\n ],\n idempotent: true,\n variants: {\n [ExternalDataPipelineStateVariantKey.INTERNAL]: {\n purpose: 'Let engine machinery enumerate pipeline standing without an external surface.',\n },\n },\n },\n },\n\n businessConstraints: [\n 'This row is bookkeeping about a pipeline, never the pipeline\\'s data: deleting it costs a restarted extraction pass, not any synced content.',\n 'A non-empty cursor means an extraction pass is still in flight, and a run resuming from it must not treat rows absent from a partial extraction as deleted remotely.',\n 'The per-entry load outcome lives on the seeding-pass ledger this summary points at; the two records deliberately do not duplicate each other.',\n ],\n }),\n // Same posture as DATA_SEED_RUN: a STANDALONE infrastructure row reached only through internal\n // repository services; the APPLICATION relationship is routing-side only, so the scope is\n // declared here rather than derived from a scope-owning parent.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"job-executions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/job-executions.resource.specification.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAS5B,MAAM,uBAAuB,CAAC;AAG/B;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAgR9C,CAAC"}
1
+ {"version":3,"file":"job-executions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/job-executions.resource.specification.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAS5B,MAAM,uBAAuB,CAAC;AAI/B;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAiR9C,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 { CoreResourceOperation as Op, JobExecutionSchema, JobExecutionStatus, JobExecutionVariantKey, JobInitiator, JobPriority, JobType, ResourcePrimaryScope, jobExecution_ResourceConfiguration_InitializationFactory as jobExecutionFactory, } 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
  /**
6
7
  * Framework-owned base specification for the internal `jobExecutions` resource.
7
8
  *
@@ -14,6 +15,7 @@ export const jobExecutionsResourceSpecification = resourceSpecification(jobExecu
14
15
  businessRole: 'Operational control-plane record used to observe, troubleshoot, and audit asynchronous work.',
15
16
  lifecycleRole: 'Moves through queue intake, execution, retry, completion, failure, or cancellation states under infrastructure control.',
16
17
  audience: LabelAudience.DEVELOPER,
18
+ subDomain: EngineResourceSubDomain.INFRASTRUCTURE,
17
19
  codeHandling: {
18
20
  mainSchema: {
19
21
  packageName: '@wildo-ai/saas-models',
@@ -131,19 +133,19 @@ export const jobExecutionsResourceSpecification = resourceSpecification(jobExecu
131
133
  semanticRole: 'identifier',
132
134
  }),
133
135
  organizationId: schemaShape.organizationId.foreignKeySpec({
134
- meaning: 'The `organizations` row that owns the tenant context this execution ran under, captured from the initiating execution context.',
136
+ meaning: 'The `organizations` record that owns the tenant context this execution ran under, captured from the initiating execution context.',
135
137
  whyItMatters: 'It lets operators filter and isolate the execution ledger per tenant when triaging or reporting on background work.',
136
138
  }),
137
139
  userId: schemaShape.userId.foreignKeySpec({
138
- meaning: 'The `users` row that initiated the work, when a human principal (rather than a system process) caused the execution.',
140
+ meaning: 'The `users` record that initiated the work, when a human principal (rather than a system process) caused the execution.',
139
141
  whyItMatters: 'It attributes background work to the initiating user for accountability and per-actor investigation; absent for system-initiated jobs.',
140
142
  }),
141
143
  inputPayloadStorageId: schemaShape.inputPayloadStorageId.foreignKeySpec({
142
- meaning: 'The `jobPayloadStorage` row holding the serialized INPUT arguments when the payload was spilled out of the queue envelope for size.',
144
+ meaning: 'The `jobPayloadStorage` record holding the serialized INPUT arguments when the payload was spilled out of the queue envelope for size.',
143
145
  whyItMatters: 'It lets the worker rehydrate the exact input arguments this execution ran with, for processing, replay, and troubleshooting.',
144
146
  }),
145
147
  outputPayloadStorageId: schemaShape.outputPayloadStorageId.foreignKeySpec({
146
- meaning: 'The `jobPayloadStorage` row holding the serialized OUTPUT/result of the execution when the result was spilled to storage rather than kept inline.',
148
+ meaning: 'The `jobPayloadStorage` record holding the serialized OUTPUT/result of the execution when the result was spilled to storage rather than kept inline.',
147
149
  whyItMatters: 'It lets downstream consumers and operators retrieve the produced result of a completed execution without overloading the queue envelope.',
148
150
  }),
149
151
  },
@@ -152,7 +154,7 @@ export const jobExecutionsResourceSpecification = resourceSpecification(jobExecu
152
154
  purpose: 'Create a new job execution record.',
153
155
  outcome: 'The platform begins tracking one asynchronous work item as a first-class execution row.',
154
156
  responseStatuses: [
155
- { code: HttpResponseStatusCode.CREATED_201, meaning: 'A job execution ledger row was registered and returned with its server-assigned `jobId`. This is an internal/service write path (the `INTERNAL` variant is `REPOSITORY_ONLY`), not a self-serve API create.' },
157
+ { code: HttpResponseStatusCode.CREATED_201, meaning: 'A job execution ledger record was registered and returned with its server-assigned `jobId`. This is an internal/service write path (the `INTERNAL` variant is `REPOSITORY_ONLY`), not a self-serve API create.' },
156
158
  ],
157
159
  errorScenarios: [
158
160
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The execution payload fails schema validation (e.g. an unknown `jobType`, missing `status`, or malformed correlation fields).', errorCode: 'VALIDATION_FAILED' },
@@ -170,7 +172,7 @@ export const jobExecutionsResourceSpecification = resourceSpecification(jobExecu
170
172
  purpose: 'Read one job execution record.',
171
173
  outcome: 'The caller can inspect the current tracked state of a specific asynchronous execution.',
172
174
  responseStatuses: [
173
- { code: HttpResponseStatusCode.OK_200, meaning: 'The job execution row for the supplied `jobId` was found and its tracked lifecycle state is returned.' },
175
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The job execution record for the supplied `jobId` was found and its tracked lifecycle state is returned.' },
174
176
  ],
175
177
  errorScenarios: [
176
178
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No job execution row exists for the supplied `jobId` (never created, or already purged by retention).' },
@@ -188,7 +190,7 @@ export const jobExecutionsResourceSpecification = resourceSpecification(jobExecu
188
190
  outcome: 'The platform’s operational truth about the execution stays synchronized with the actual runtime lifecycle.',
189
191
  importance: FieldSemanticImportance.PRIMARY,
190
192
  responseStatuses: [
191
- { code: HttpResponseStatusCode.OK_200, meaning: 'The execution row recorded the new lifecycle state (status, timing, retry count, payload ref, or error) and the updated row is returned. Internal/service write path — the worker/runtime layer owns these transitions.' },
193
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The execution record recorded the new lifecycle state (status, timing, retry count, payload ref, or error) and the updated record is returned. Internal/service write path — the worker/runtime layer owns these transitions.' },
192
194
  ],
193
195
  errorScenarios: [
194
196
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No job execution row exists for the supplied `jobId` to advance.' },
@@ -208,7 +210,7 @@ export const jobExecutionsResourceSpecification = resourceSpecification(jobExecu
208
210
  purpose: 'Enumerate job execution records.',
209
211
  outcome: 'The caller can inspect a set of executions instead of one isolated row.',
210
212
  responseStatuses: [
211
- { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of job execution rows in the requested scope.' },
213
+ { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of job execution records in the requested scope.' },
212
214
  ],
213
215
  errorScenarios: [
214
216
  { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an operator/infrastructure principal authorized to enumerate the execution ledger.' },