@wildo-ai/saas-specifications 1.1.5 → 1.1.7

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 (677) hide show
  1. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts +10 -8
  2. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts.map +1 -1
  3. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.js +14 -13
  4. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.js.map +1 -1
  5. package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.d.ts +3 -2
  6. package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.d.ts.map +1 -1
  7. package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.js +4 -3
  8. package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.js.map +1 -1
  9. package/dist/esm/_catalogs/schema-org/index.d.ts +31 -15
  10. package/dist/esm/_catalogs/schema-org/index.d.ts.map +1 -1
  11. package/dist/esm/_catalogs/schema-org/index.js +34 -13
  12. package/dist/esm/_catalogs/schema-org/index.js.map +1 -1
  13. package/dist/esm/_catalogs/schema-org/product.catalog-spec.d.ts +2 -2
  14. package/dist/esm/_catalogs/schema-org/product.catalog-spec.js +4 -4
  15. package/dist/esm/_catalogs/schema-org/product.catalog-spec.js.map +1 -1
  16. package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.d.ts +45 -0
  17. package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.d.ts.map +1 -0
  18. package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.js +58 -0
  19. package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.js.map +1 -0
  20. package/dist/esm/_core/application-specification-family-identity.schemas.d.ts +3 -2
  21. package/dist/esm/_core/application-specification-family-identity.schemas.d.ts.map +1 -1
  22. package/dist/esm/_core/application-specification-family-identity.schemas.js +3 -2
  23. package/dist/esm/_core/application-specification-family-identity.schemas.js.map +1 -1
  24. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts +18 -0
  25. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts.map +1 -1
  26. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts +39 -13
  27. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts.map +1 -1
  28. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js +43 -13
  29. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js.map +1 -1
  30. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts +90 -2
  31. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts.map +1 -1
  32. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.js +70 -6
  33. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.js.map +1 -1
  34. package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts.map +1 -1
  35. package/dist/esm/_core/build-plan/build-plan.family-aspects.js +26 -4
  36. package/dist/esm/_core/build-plan/build-plan.family-aspects.js.map +1 -1
  37. package/dist/esm/_core/business-semantics.specifications.schemas.d.ts +14 -0
  38. package/dist/esm/_core/business-semantics.specifications.schemas.d.ts.map +1 -1
  39. package/dist/esm/_core/business-semantics.specifications.schemas.js.map +1 -1
  40. package/dist/esm/_core/capability-composition/capability-composition-validation.d.ts.map +1 -1
  41. package/dist/esm/_core/capability-composition/capability-composition-validation.js +1 -0
  42. package/dist/esm/_core/capability-composition/capability-composition-validation.js.map +1 -1
  43. package/dist/esm/_core/capability-composition/capability-composition.schemas.d.ts +21 -2
  44. package/dist/esm/_core/capability-composition/capability-composition.schemas.d.ts.map +1 -1
  45. package/dist/esm/_core/capability-composition/capability-composition.schemas.js +20 -1
  46. package/dist/esm/_core/capability-composition/capability-composition.schemas.js.map +1 -1
  47. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts +11 -32
  48. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts.map +1 -1
  49. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js +70 -3
  50. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js.map +1 -1
  51. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.d.ts +142 -17
  52. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.d.ts.map +1 -1
  53. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.js +285 -30
  54. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.js.map +1 -1
  55. package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts +183 -18
  56. package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts.map +1 -1
  57. package/dist/esm/_core/compliance-documents/processor-register.schemas.js +165 -18
  58. package/dist/esm/_core/compliance-documents/processor-register.schemas.js.map +1 -1
  59. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.d.ts +139 -0
  60. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.d.ts.map +1 -0
  61. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.js +172 -0
  62. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.js.map +1 -0
  63. package/dist/esm/_core/compliance-documents/recipient-population.schemas.d.ts +306 -0
  64. package/dist/esm/_core/compliance-documents/recipient-population.schemas.d.ts.map +1 -0
  65. package/dist/esm/_core/compliance-documents/recipient-population.schemas.js +502 -0
  66. package/dist/esm/_core/compliance-documents/recipient-population.schemas.js.map +1 -0
  67. package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.d.ts +107 -0
  68. package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.d.ts.map +1 -0
  69. package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.js +118 -0
  70. package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.js.map +1 -0
  71. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.d.ts +56 -0
  72. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.d.ts.map +1 -0
  73. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.js +100 -0
  74. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.js.map +1 -0
  75. package/dist/esm/_core/composite-view-specification.schemas.js +8 -1
  76. package/dist/esm/_core/composite-view-specification.schemas.js.map +1 -1
  77. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts +3 -2
  78. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -1
  79. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js +3 -2
  80. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js.map +1 -1
  81. package/dist/esm/_core/experience-plan/experience-plan.schemas.d.ts +16 -3
  82. package/dist/esm/_core/experience-plan/experience-plan.schemas.d.ts.map +1 -1
  83. package/dist/esm/_core/experience-plan/experience-plan.schemas.js +70 -5
  84. package/dist/esm/_core/experience-plan/experience-plan.schemas.js.map +1 -1
  85. package/dist/esm/_core/family-aspects.schemas.d.ts +10 -0
  86. package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -1
  87. package/dist/esm/_core/family-aspects.schemas.js.map +1 -1
  88. package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +2 -2
  89. package/dist/esm/_core/feature-drafts/capability-map-output-set.schemas.d.ts +1 -0
  90. package/dist/esm/_core/feature-drafts/capability-map-output-set.schemas.d.ts.map +1 -1
  91. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.d.ts +16 -0
  92. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.d.ts.map +1 -1
  93. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.js +8 -0
  94. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.js.map +1 -1
  95. package/dist/esm/_core/index.d.ts +3 -0
  96. package/dist/esm/_core/index.d.ts.map +1 -1
  97. package/dist/esm/_core/index.js +3 -0
  98. package/dist/esm/_core/index.js.map +1 -1
  99. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.d.ts +5 -0
  100. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.d.ts.map +1 -1
  101. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.js +3 -1
  102. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.js.map +1 -1
  103. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.d.ts.map +1 -1
  104. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.js +12 -2
  105. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.js.map +1 -1
  106. package/dist/esm/_core/integration-plan/integration-plan.schemas.d.ts +30 -2
  107. package/dist/esm/_core/integration-plan/integration-plan.schemas.d.ts.map +1 -1
  108. package/dist/esm/_core/integration-plan/integration-plan.schemas.js +32 -2
  109. package/dist/esm/_core/integration-plan/integration-plan.schemas.js.map +1 -1
  110. package/dist/esm/_core/market/feature-benefit.schemas.js +2 -2
  111. package/dist/esm/_core/market/feature-benefit.schemas.js.map +1 -1
  112. package/dist/esm/_core/market/market-alternative.schemas.js +2 -2
  113. package/dist/esm/_core/market/market-alternative.schemas.js.map +1 -1
  114. package/dist/esm/_core/market/market-buying-journey.schemas.js +2 -2
  115. package/dist/esm/_core/market/market-buying-journey.schemas.js.map +1 -1
  116. package/dist/esm/_core/market/market-category.schemas.js +2 -2
  117. package/dist/esm/_core/market/market-category.schemas.js.map +1 -1
  118. package/dist/esm/_core/market/market-channel.schemas.js +2 -2
  119. package/dist/esm/_core/market/market-channel.schemas.js.map +1 -1
  120. package/dist/esm/_core/market/market-gain.schemas.js +2 -2
  121. package/dist/esm/_core/market/market-gain.schemas.js.map +1 -1
  122. package/dist/esm/_core/market/market-icp.schemas.d.ts.map +1 -1
  123. package/dist/esm/_core/market/market-icp.schemas.js +2 -2
  124. package/dist/esm/_core/market/market-icp.schemas.js.map +1 -1
  125. package/dist/esm/_core/market/market-job.schemas.js +2 -2
  126. package/dist/esm/_core/market/market-job.schemas.js.map +1 -1
  127. package/dist/esm/_core/market/market-message-template.schemas.js +2 -2
  128. package/dist/esm/_core/market/market-message-template.schemas.js.map +1 -1
  129. package/dist/esm/_core/market/market-objection.schemas.js +2 -2
  130. package/dist/esm/_core/market/market-objection.schemas.js.map +1 -1
  131. package/dist/esm/_core/market/market-pain.schemas.js +2 -2
  132. package/dist/esm/_core/market/market-pain.schemas.js.map +1 -1
  133. package/dist/esm/_core/market/market-persona.schemas.d.ts.map +1 -1
  134. package/dist/esm/_core/market/market-persona.schemas.js +2 -2
  135. package/dist/esm/_core/market/market-persona.schemas.js.map +1 -1
  136. package/dist/esm/_core/market/market-positioning.schemas.js +2 -2
  137. package/dist/esm/_core/market/market-positioning.schemas.js.map +1 -1
  138. package/dist/esm/_core/market/market-proof.schemas.js +2 -2
  139. package/dist/esm/_core/market/market-proof.schemas.js.map +1 -1
  140. package/dist/esm/_core/market/market-references.schemas.d.ts +6 -0
  141. package/dist/esm/_core/market/market-references.schemas.d.ts.map +1 -1
  142. package/dist/esm/_core/market/market-references.schemas.js +6 -0
  143. package/dist/esm/_core/market/market-references.schemas.js.map +1 -1
  144. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +4 -4
  145. package/dist/esm/_core/market/market-tone-of-voice.schemas.js +2 -2
  146. package/dist/esm/_core/market/market-tone-of-voice.schemas.js.map +1 -1
  147. package/dist/esm/_core/market/market-trigger.schemas.js +2 -2
  148. package/dist/esm/_core/market/market-trigger.schemas.js.map +1 -1
  149. package/dist/esm/_core/market/market.family-aspects.js +1 -1
  150. package/dist/esm/_core/market/market.family-aspects.js.map +1 -1
  151. package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
  152. package/dist/esm/_core/placement-plan/placement-plan.schemas.js +6 -1
  153. package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
  154. package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts +1 -0
  155. package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts.map +1 -1
  156. package/dist/esm/_core/requirements/functional-requirement.schemas.js +8 -0
  157. package/dist/esm/_core/requirements/functional-requirement.schemas.js.map +1 -1
  158. package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts +1 -0
  159. package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts.map +1 -1
  160. package/dist/esm/_core/resource-specification.schemas.d.ts +86 -28
  161. package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
  162. package/dist/esm/_core/resource-specification.schemas.js +110 -24
  163. package/dist/esm/_core/resource-specification.schemas.js.map +1 -1
  164. package/dist/esm/_core/utils/retention-clock-field-specs.d.ts +13 -0
  165. package/dist/esm/_core/utils/retention-clock-field-specs.d.ts.map +1 -0
  166. package/dist/esm/_core/utils/retention-clock-field-specs.js +26 -0
  167. package/dist/esm/_core/utils/retention-clock-field-specs.js.map +1 -0
  168. package/dist/esm/_core/website-plan/website-plan.schemas.d.ts +31 -6
  169. package/dist/esm/_core/website-plan/website-plan.schemas.d.ts.map +1 -1
  170. package/dist/esm/_core/website-plan/website-plan.schemas.js +35 -6
  171. package/dist/esm/_core/website-plan/website-plan.schemas.js.map +1 -1
  172. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.d.ts +142 -3
  173. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.d.ts.map +1 -1
  174. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.js +148 -14
  175. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.js.map +1 -1
  176. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +70 -10
  177. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
  178. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +98 -11
  179. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
  180. package/dist/esm/application-creation/application-line.application-creation.schemas.d.ts +215 -0
  181. package/dist/esm/application-creation/application-line.application-creation.schemas.d.ts.map +1 -0
  182. package/dist/esm/application-creation/application-line.application-creation.schemas.js +253 -0
  183. package/dist/esm/application-creation/application-line.application-creation.schemas.js.map +1 -0
  184. package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.d.ts +39 -0
  185. package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.d.ts.map +1 -0
  186. package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.js +37 -0
  187. package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.js.map +1 -0
  188. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts +5 -49
  189. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
  190. package/dist/esm/application-creation/journey.application-creation.schemas.js +25 -60
  191. package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
  192. package/dist/esm/application-creation/playbook-instance.application-creation.schemas.d.ts +28 -0
  193. package/dist/esm/application-creation/playbook-instance.application-creation.schemas.d.ts.map +1 -0
  194. package/dist/esm/application-creation/playbook-instance.application-creation.schemas.js +32 -0
  195. package/dist/esm/application-creation/playbook-instance.application-creation.schemas.js.map +1 -0
  196. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +26 -6
  197. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
  198. package/dist/esm/application-creation/playbooks.application-creation.schemas.js +28 -1
  199. package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
  200. package/dist/esm/application-creation.exports.d.ts +7 -0
  201. package/dist/esm/application-creation.exports.d.ts.map +1 -1
  202. package/dist/esm/application-creation.exports.js +7 -0
  203. package/dist/esm/application-creation.exports.js.map +1 -1
  204. package/dist/esm/assurance/__tests__/authority-evaluation-instant.fixture.d.ts +1 -1
  205. package/dist/esm/assurance/__tests__/authority-evaluation-instant.fixture.js +1 -1
  206. package/dist/esm/assurance/__tests__/authority-evaluation-instant.fixture.js.map +1 -1
  207. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +24 -1
  208. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
  209. package/dist/esm/assurance/assurance-authority-basis.definitions.js +75 -5
  210. package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
  211. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +6 -0
  212. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
  213. package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts +11 -0
  214. package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts.map +1 -1
  215. package/dist/esm/assurance/assurance-document-blueprint-selection.js +22 -3
  216. package/dist/esm/assurance/assurance-document-blueprint-selection.js.map +1 -1
  217. package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
  218. package/dist/esm/assurance/assurance-document-system.definitions.js +39 -6
  219. package/dist/esm/assurance/assurance-document-system.definitions.js.map +1 -1
  220. package/dist/esm/assurance/assurance-document-system.schemas.d.ts +11 -0
  221. package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
  222. package/dist/esm/assurance/assurance-document-system.schemas.js +19 -0
  223. package/dist/esm/assurance/assurance-document-system.schemas.js.map +1 -1
  224. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts.map +1 -1
  225. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js +295 -31
  226. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -1
  227. package/dist/esm/assurance/assurance-foundation.schemas.d.ts +7 -0
  228. package/dist/esm/assurance/assurance-foundation.schemas.d.ts.map +1 -1
  229. package/dist/esm/assurance/assurance-foundation.schemas.js +7 -0
  230. package/dist/esm/assurance/assurance-foundation.schemas.js.map +1 -1
  231. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
  232. package/dist/esm/assurance/assurance-objective-catalog.definitions.js +17 -0
  233. package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
  234. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +5 -1
  235. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -1
  236. package/dist/esm/assurance/assurance-program-generation.schemas.js +6 -3
  237. package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -1
  238. package/dist/esm/assurance/assurance-program.family-aspects.js +1 -1
  239. package/dist/esm/assurance/assurance-program.family-aspects.js.map +1 -1
  240. package/dist/esm/assurance/assurance-program.schemas.d.ts +232 -3
  241. package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
  242. package/dist/esm/assurance/assurance-program.schemas.js +107 -14
  243. package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
  244. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
  245. package/dist/esm/assurance/assurance-source-registry.definitions.js +77 -1
  246. package/dist/esm/assurance/assurance-source-registry.definitions.js.map +1 -1
  247. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts.map +1 -1
  248. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js +23 -1
  249. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -1
  250. package/dist/esm/assurance/governed-document-release.d.ts +7 -0
  251. package/dist/esm/assurance/governed-document-release.d.ts.map +1 -1
  252. package/dist/esm/assurance/governed-document-release.js +11 -2
  253. package/dist/esm/assurance/governed-document-release.js.map +1 -1
  254. package/dist/esm/companion-exports.d.ts +6 -5
  255. package/dist/esm/companion-exports.d.ts.map +1 -1
  256. package/dist/esm/companion-exports.js.map +1 -1
  257. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts +1 -0
  258. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
  259. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +35 -33
  260. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
  261. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map +1 -1
  262. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +6 -2
  263. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
  264. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
  265. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +13 -12
  266. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
  267. package/dist/esm/engine/applications/resources/application-versions.resource.specification.d.ts.map +1 -1
  268. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +26 -2
  269. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
  270. package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts.map +1 -1
  271. package/dist/esm/engine/applications/resources/applications.resource.specification.js +4 -4
  272. package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
  273. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts.map +1 -1
  274. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js +11 -9
  275. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js.map +1 -1
  276. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +2 -2
  277. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
  278. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts +1 -0
  279. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
  280. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +45 -32
  281. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
  282. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts +1 -23
  283. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
  284. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +185 -31
  285. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
  286. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts +2 -1
  287. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -1
  288. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js +29 -7
  289. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -1
  290. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts.map +1 -1
  291. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +7 -1
  292. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
  293. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts.map +1 -1
  294. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +9 -6
  295. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
  296. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts +1 -0
  297. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts.map +1 -1
  298. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +11 -7
  299. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
  300. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.d.ts.map +1 -1
  301. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +18 -16
  302. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
  303. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.d.ts.map +1 -1
  304. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js +9 -11
  305. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js.map +1 -1
  306. package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
  307. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +238 -219
  308. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
  309. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts +0 -24
  310. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
  311. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js +76 -16
  312. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js.map +1 -1
  313. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts +2 -1
  314. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts.map +1 -1
  315. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js +28 -6
  316. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js.map +1 -1
  317. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
  318. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +29 -11
  319. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
  320. package/dist/esm/engine/billing/resources/billing-provider-event-settlements.resource.specification.js +1 -1
  321. package/dist/esm/engine/billing/resources/billing-provider-event-settlements.resource.specification.js.map +1 -1
  322. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts +2 -0
  323. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts.map +1 -1
  324. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js +13 -12
  325. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
  326. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +5 -5
  327. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
  328. package/dist/esm/engine/billing/resources/prices.resource.specification.d.ts.map +1 -1
  329. package/dist/esm/engine/billing/resources/prices.resource.specification.js +12 -9
  330. package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
  331. package/dist/esm/engine/billing/resources/products.resource.specification.d.ts +7 -4
  332. package/dist/esm/engine/billing/resources/products.resource.specification.d.ts.map +1 -1
  333. package/dist/esm/engine/billing/resources/products.resource.specification.js +36 -16
  334. package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
  335. package/dist/esm/engine/billing/resources/promotions.resource.specification.d.ts.map +1 -1
  336. package/dist/esm/engine/billing/resources/promotions.resource.specification.js +13 -10
  337. package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
  338. package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts +13 -8
  339. package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts.map +1 -1
  340. package/dist/esm/engine/billing/resources/referrals.resource.specification.js +54 -20
  341. package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
  342. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts +30 -4
  343. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
  344. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +85 -25
  345. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
  346. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +2 -2
  347. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
  348. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts +15 -2
  349. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts.map +1 -1
  350. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js +45 -10
  351. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js.map +1 -1
  352. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts +15 -2
  353. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts.map +1 -1
  354. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +52 -12
  355. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
  356. package/dist/esm/engine/compliance/resources/index.d.ts +1 -0
  357. package/dist/esm/engine/compliance/resources/index.d.ts.map +1 -1
  358. package/dist/esm/engine/compliance/resources/index.js +1 -0
  359. package/dist/esm/engine/compliance/resources/index.js.map +1 -1
  360. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.d.ts +39 -0
  361. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.d.ts.map +1 -0
  362. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.js +325 -0
  363. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.js.map +1 -0
  364. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.d.ts +23 -0
  365. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.d.ts.map +1 -0
  366. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.js +197 -0
  367. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.js.map +1 -0
  368. package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
  369. package/dist/esm/engine/engine-resource-specifications.registry.js +59 -0
  370. package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
  371. package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
  372. package/dist/esm/engine/errors/error-messages.specification.js +69 -0
  373. package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
  374. package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts +5 -5
  375. package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts.map +1 -1
  376. package/dist/esm/engine/features/resources/application-features.resource.specification.js +9 -10
  377. package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
  378. package/dist/esm/engine/features/resources/organization-features.resource.specification.d.ts +5 -5
  379. package/dist/esm/engine/features/resources/organization-features.resource.specification.js +11 -11
  380. package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
  381. package/dist/esm/engine/features/resources/user-features.resource.specification.d.ts +5 -5
  382. package/dist/esm/engine/features/resources/user-features.resource.specification.js +3 -3
  383. package/dist/esm/engine/features/resources/user-features.resource.specification.js.map +1 -1
  384. package/dist/esm/engine/files/resources/files.resource.specification.d.ts.map +1 -1
  385. package/dist/esm/engine/files/resources/files.resource.specification.js +7 -8
  386. package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
  387. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map +1 -1
  388. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js +16 -4
  389. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
  390. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +1 -1
  391. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
  392. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.d.ts +11 -0
  393. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.d.ts.map +1 -0
  394. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.js +382 -0
  395. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.js.map +1 -0
  396. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts +139 -1
  397. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map +1 -1
  398. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +150 -4
  399. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
  400. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
  401. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js +9 -1
  402. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js.map +1 -1
  403. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.d.ts +3 -0
  404. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.d.ts.map +1 -0
  405. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.js +162 -0
  406. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.js.map +1 -0
  407. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.d.ts +3 -0
  408. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.d.ts.map +1 -0
  409. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.js +158 -0
  410. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.js.map +1 -0
  411. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.d.ts +2 -1
  412. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.d.ts.map +1 -1
  413. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.js +16 -9
  414. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.js.map +1 -1
  415. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.js +1 -1
  416. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.js.map +1 -1
  417. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-request.frontend-component.specification.js +1 -1
  418. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-request.frontend-component.specification.js.map +1 -1
  419. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.d.ts +5 -0
  420. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.d.ts.map +1 -0
  421. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.js +79 -0
  422. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.js.map +1 -0
  423. package/dist/esm/engine/frontend-components/app/app-layout-appearance-settings.frontend-component.specification.js +1 -1
  424. package/dist/esm/engine/frontend-components/app/app-layout-appearance-settings.frontend-component.specification.js.map +1 -1
  425. package/dist/esm/engine/frontend-components/app/app-layout-billing-settings.frontend-component.specification.d.ts.map +1 -1
  426. package/dist/esm/engine/frontend-components/app/app-layout-billing-settings.frontend-component.specification.js +3 -1
  427. package/dist/esm/engine/frontend-components/app/app-layout-billing-settings.frontend-component.specification.js.map +1 -1
  428. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts.map +1 -1
  429. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js +5 -4
  430. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js.map +1 -1
  431. package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.js +1 -1
  432. package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.js.map +1 -1
  433. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.js +1 -1
  434. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.js.map +1 -1
  435. package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.js +2 -2
  436. package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.js.map +1 -1
  437. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-number.frontend-component.specification.js +1 -1
  438. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-number.frontend-component.specification.js.map +1 -1
  439. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-string.frontend-component.specification.js +2 -2
  440. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-string.frontend-component.specification.js.map +1 -1
  441. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js +1 -1
  442. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js.map +1 -1
  443. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.js +1 -1
  444. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.js.map +1 -1
  445. package/dist/esm/engine/frontend-components/form/fields/form-field-address.frontend-component.specification.d.ts.map +1 -1
  446. package/dist/esm/engine/frontend-components/form/fields/form-field-address.frontend-component.specification.js +1 -1
  447. package/dist/esm/engine/frontend-components/form/fields/form-field-address.frontend-component.specification.js.map +1 -1
  448. package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.js +2 -2
  449. package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.js.map +1 -1
  450. package/dist/esm/engine/frontend-components/index.d.ts +1 -0
  451. package/dist/esm/engine/frontend-components/index.d.ts.map +1 -1
  452. package/dist/esm/engine/frontend-components/index.js +3 -0
  453. package/dist/esm/engine/frontend-components/index.js.map +1 -1
  454. package/dist/esm/engine/frontend-components/resources/resource-layout-empty-state.frontend-component.specification.js +1 -1
  455. package/dist/esm/engine/frontend-components/resources/resource-layout-empty-state.frontend-component.specification.js.map +1 -1
  456. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-display.frontend-component.specification.js +1 -1
  457. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-display.frontend-component.specification.js.map +1 -1
  458. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit.frontend-component.specification.js +1 -1
  459. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit.frontend-component.specification.js.map +1 -1
  460. package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.d.ts.map +1 -1
  461. package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.js +9 -4
  462. package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.js.map +1 -1
  463. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js +4 -4
  464. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js.map +1 -1
  465. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts.map +1 -1
  466. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js +34 -0
  467. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js.map +1 -1
  468. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts.map +1 -1
  469. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js +26 -0
  470. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
  471. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +2 -2
  472. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
  473. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.d.ts +9 -0
  474. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.d.ts.map +1 -0
  475. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.js +122 -0
  476. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.js.map +1 -0
  477. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.d.ts +9 -0
  478. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.d.ts.map +1 -0
  479. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.js +152 -0
  480. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.js.map +1 -0
  481. package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.d.ts +10 -0
  482. package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.d.ts.map +1 -0
  483. package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.js +94 -0
  484. package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.js.map +1 -0
  485. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.d.ts +10 -0
  486. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.d.ts.map +1 -0
  487. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.js +64 -0
  488. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.js.map +1 -0
  489. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.d.ts +4 -1
  490. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.d.ts.map +1 -1
  491. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.js +20 -16
  492. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.js.map +1 -1
  493. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.d.ts +9 -0
  494. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.d.ts.map +1 -0
  495. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.js +200 -0
  496. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.js.map +1 -0
  497. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.d.ts.map +1 -1
  498. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +19 -6
  499. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
  500. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.d.ts +9 -0
  501. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.d.ts.map +1 -0
  502. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.js +97 -0
  503. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.js.map +1 -0
  504. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts +8 -0
  505. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts.map +1 -1
  506. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js +2 -2
  507. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js.map +1 -1
  508. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts +2 -2
  509. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +1 -1
  510. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
  511. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.js +4 -4
  512. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.js.map +1 -1
  513. package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.d.ts +9 -0
  514. package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.d.ts.map +1 -0
  515. package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.js +153 -0
  516. package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.js.map +1 -0
  517. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.d.ts +81 -0
  518. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.d.ts.map +1 -0
  519. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.js +437 -0
  520. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.js.map +1 -0
  521. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.d.ts +112 -0
  522. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.d.ts.map +1 -0
  523. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.js +287 -0
  524. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.js.map +1 -0
  525. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.d.ts +131 -0
  526. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.d.ts.map +1 -0
  527. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.js +594 -0
  528. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.js.map +1 -0
  529. package/dist/esm/engine/notifications/resources/index.d.ts +1 -0
  530. package/dist/esm/engine/notifications/resources/index.d.ts.map +1 -1
  531. package/dist/esm/engine/notifications/resources/index.js +1 -0
  532. package/dist/esm/engine/notifications/resources/index.js.map +1 -1
  533. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts +6 -3
  534. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
  535. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +20 -5
  536. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
  537. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts.map +1 -1
  538. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js +12 -2
  539. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js.map +1 -1
  540. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts +6 -6
  541. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
  542. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +8 -11
  543. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
  544. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.d.ts +4 -0
  545. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.d.ts.map +1 -0
  546. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.js +62 -0
  547. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.js.map +1 -0
  548. package/dist/esm/engine/notifications/system-emails/index.d.ts +2 -1
  549. package/dist/esm/engine/notifications/system-emails/index.d.ts.map +1 -1
  550. package/dist/esm/engine/notifications/system-emails/index.js +4 -2
  551. package/dist/esm/engine/notifications/system-emails/index.js.map +1 -1
  552. package/dist/esm/engine/organizations/resources/index.d.ts +2 -0
  553. package/dist/esm/engine/organizations/resources/index.d.ts.map +1 -1
  554. package/dist/esm/engine/organizations/resources/index.js +2 -0
  555. package/dist/esm/engine/organizations/resources/index.js.map +1 -1
  556. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts +3 -0
  557. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts.map +1 -1
  558. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +40 -12
  559. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
  560. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js +2 -2
  561. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js.map +1 -1
  562. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js +2 -2
  563. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js.map +1 -1
  564. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts +0 -1
  565. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts.map +1 -1
  566. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +4 -6
  567. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
  568. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts.map +1 -1
  569. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +7 -3
  570. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
  571. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.d.ts.map +1 -1
  572. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js +15 -8
  573. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js.map +1 -1
  574. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts +3 -1
  575. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts.map +1 -1
  576. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +36 -21
  577. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
  578. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.d.ts +38 -0
  579. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.d.ts.map +1 -0
  580. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.js +152 -0
  581. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.js.map +1 -0
  582. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.d.ts +106 -0
  583. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.d.ts.map +1 -0
  584. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.js +417 -0
  585. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.js.map +1 -0
  586. package/dist/esm/engine/providers/apple.provider.specification.js +1 -1
  587. package/dist/esm/engine/providers/apple.provider.specification.js.map +1 -1
  588. package/dist/esm/engine/providers/github.provider.specification.js +1 -1
  589. package/dist/esm/engine/providers/github.provider.specification.js.map +1 -1
  590. package/dist/esm/engine/providers/google-places.provider.specification.d.ts +6 -0
  591. package/dist/esm/engine/providers/google-places.provider.specification.d.ts.map +1 -0
  592. package/dist/esm/engine/providers/google-places.provider.specification.js +44 -0
  593. package/dist/esm/engine/providers/google-places.provider.specification.js.map +1 -0
  594. package/dist/esm/engine/providers/google.provider.specification.js +1 -1
  595. package/dist/esm/engine/providers/google.provider.specification.js.map +1 -1
  596. package/dist/esm/engine/providers/index.d.ts +2 -0
  597. package/dist/esm/engine/providers/index.d.ts.map +1 -1
  598. package/dist/esm/engine/providers/index.js +5 -1
  599. package/dist/esm/engine/providers/index.js.map +1 -1
  600. package/dist/esm/engine/providers/microsoft.provider.specification.d.ts.map +1 -1
  601. package/dist/esm/engine/providers/microsoft.provider.specification.js +10 -6
  602. package/dist/esm/engine/providers/microsoft.provider.specification.js.map +1 -1
  603. package/dist/esm/engine/providers/recaptcha.provider.specification.d.ts +6 -0
  604. package/dist/esm/engine/providers/recaptcha.provider.specification.d.ts.map +1 -0
  605. package/dist/esm/engine/providers/recaptcha.provider.specification.js +38 -0
  606. package/dist/esm/engine/providers/recaptcha.provider.specification.js.map +1 -0
  607. package/dist/esm/engine/providers/resend.provider.specification.d.ts.map +1 -1
  608. package/dist/esm/engine/providers/resend.provider.specification.js +3 -1
  609. package/dist/esm/engine/providers/resend.provider.specification.js.map +1 -1
  610. package/dist/esm/engine/providers/stripe.provider.specification.d.ts.map +1 -1
  611. package/dist/esm/engine/providers/stripe.provider.specification.js +3 -2
  612. package/dist/esm/engine/providers/stripe.provider.specification.js.map +1 -1
  613. package/dist/esm/engine/roles/app-billing-provider-events.role.specification.d.ts +2 -0
  614. package/dist/esm/engine/roles/app-billing-provider-events.role.specification.d.ts.map +1 -0
  615. package/dist/esm/engine/roles/app-billing-provider-events.role.specification.js +21 -0
  616. package/dist/esm/engine/roles/app-billing-provider-events.role.specification.js.map +1 -0
  617. package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.d.ts +2 -0
  618. package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.d.ts.map +1 -0
  619. package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.js +21 -0
  620. package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.js.map +1 -0
  621. package/dist/esm/engine/roles/index.d.ts +13 -5
  622. package/dist/esm/engine/roles/index.d.ts.map +1 -1
  623. package/dist/esm/engine/roles/index.js +19 -6
  624. package/dist/esm/engine/roles/index.js.map +1 -1
  625. package/dist/esm/engine/roles/org-billing-provider-events.role.specification.d.ts +2 -0
  626. package/dist/esm/engine/roles/org-billing-provider-events.role.specification.d.ts.map +1 -0
  627. package/dist/esm/engine/roles/org-billing-provider-events.role.specification.js +21 -0
  628. package/dist/esm/engine/roles/org-billing-provider-events.role.specification.js.map +1 -0
  629. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.d.ts +7 -0
  630. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.d.ts.map +1 -0
  631. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.js +72 -0
  632. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.js.map +1 -0
  633. package/dist/esm/engine/roles/org-service-provider.role.specification.d.ts +2 -0
  634. package/dist/esm/engine/roles/org-service-provider.role.specification.d.ts.map +1 -0
  635. package/dist/esm/engine/roles/org-service-provider.role.specification.js +22 -0
  636. package/dist/esm/engine/roles/org-service-provider.role.specification.js.map +1 -0
  637. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js +2 -2
  638. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
  639. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +3 -3
  640. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
  641. package/dist/esm/engine/users/resources/self-service-user-notifications.shared.d.ts +1 -1
  642. package/dist/esm/engine/users/resources/self-service-user-notifications.shared.d.ts.map +1 -1
  643. package/dist/esm/engine/users/resources/self-service-user-notifications.shared.js +3 -6
  644. package/dist/esm/engine/users/resources/self-service-user-notifications.shared.js.map +1 -1
  645. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js +2 -2
  646. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
  647. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +2 -2
  648. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
  649. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts +0 -4
  650. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts.map +1 -1
  651. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.js +0 -3
  652. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.js.map +1 -1
  653. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +0 -3
  654. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts.map +1 -1
  655. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +7 -7
  656. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
  657. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +5 -5
  658. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
  659. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +0 -3
  660. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
  661. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +11 -18
  662. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
  663. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js +6 -6
  664. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js.map +1 -1
  665. package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts.map +1 -1
  666. package/dist/esm/engine/users/resources/user-self.resource.specification.js +5 -1
  667. package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
  668. package/dist/esm/engine/users/resources/users.resource.specification.d.ts +8 -5
  669. package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
  670. package/dist/esm/engine/users/resources/users.resource.specification.js +49 -16
  671. package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
  672. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
  673. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +29 -10
  674. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
  675. package/dist/tsconfig.build.tsbuildinfo +1 -1
  676. package/package.json +8 -8
  677. package/dist/assurance/external-framework-mapping.json +0 -1228
@@ -0,0 +1 @@
1
+ {"version":3,"file":"external-data-pipeline-run-records.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxG,OAAO,EACL,kCAAkC,EAClC,oCAAoC,EACpC,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,mCAAmC,EACnC,uCAAuC,EACvC,wEAAwE,IAAI,gBAAgB,GAC7F,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAE,qBAAqB,IAAI,EAAE,EAAE,4BAA4B,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AACxH,OAAO,EAAuC,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACjI,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,MAAM,WAAW,GAAG,CAAC,UAAkB,EAAE,EAAE,CAAC,CAAC;IAC3C,WAAW,EAAE,4BAA4B,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,CAAC,eAAe;CAC7I,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mDAAmD,GAAmC,qBAAqB,CACtH,gBAAgB,EAChB,mCAAmC,EACnC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IACpB,OAAO,EAAE,2OAA2O;IACpP,YAAY,EAAE,0KAA0K;IACxL,aAAa,EAAE,sUAAsU;IACrV,QAAQ,EAAE,aAAa,CAAC,SAAS;IACjC,SAAS,EAAE,uBAAuB,CAAC,cAAc;IACjD,YAAY,EAAE;QACZ,UAAU,EAAE;YACV,WAAW,EAAE,4BAA4B,EAAE,UAAU,EAAE,iDAAiD;YACxG,UAAU,EAAE,qCAAqC,EAAE,UAAU,EAAE,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,mBAAmB,CAAC,UAAU;SACtI;QACD,eAAe,EAAE;YACf,WAAW,EAAE,4BAA4B,EAAE,UAAU,EAAE,iDAAiD;YACxG,UAAU,EAAE,0EAA0E,EAAE,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,mBAAmB,CAAC,QAAQ;SAC1K;QACD,YAAY,EAAE;YACZ,eAAe,EAAE,EAAE,WAAW,EAAE,4BAA4B,EAAE,UAAU,EAAE,qBAAqB;gBAC7F,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,CAAC,eAAe,EAAE;YACzF,UAAU,EAAE,oCAAoC;SACjD;QACD,mBAAmB,EAAE;YACnB,QAAQ,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,UAAU,EAAE,uBAAuB;gBACnF,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,CAAC,eAAe,EAAE;SAC1F;KACF;IAED,MAAM,EAAE;QACN,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,iDAAiD,EAAE,CAAC;QAC/F,oBAAoB,EAAE,WAAW,CAAC,oBAAoB,CAAC,UAAU,CAAC;YAChE,OAAO,EAAE,8CAA8C;YACvD,YAAY,EAAE,kGAAkG;YAChH,YAAY,EAAE,YAAY;YAC1B,UAAU,EAAE,uBAAuB,CAAC,OAAO;SAC5C,CAAC;QACF,cAAc,EAAE,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,iGAAiG,EAAE,CAAC;QACrK,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,QAAQ,CAAC;YAChD,OAAO,EAAE,2FAA2F;YACpG,eAAe,EAAE,WAAW,CAAC,uBAAuB,CAAC;SACtD,CAAC;QACF,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACtC,OAAO,EAAE,+LAA+L;YACxM,YAAY,EAAE,mIAAmI;YACjJ,eAAe,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,UAAU,EAAE,8BAA8B,EAAE,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,CAAC,eAAe,EAAE;YAC5L,MAAM,EAAE;gBACN,CAAC,4BAA4B,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,+CAA+C,EAAE;gBACjG,CAAC,4BAA4B,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,0EAA0E,EAAE;gBACnI,CAAC,4BAA4B,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,wHAAwH,EAAE;aAC3K;SACF,CAAC;QACF,OAAO,EAAE,WAAW,CAAC,OAAO,CAAC,QAAQ,CAAC;YACpC,OAAO,EAAE,oBAAoB;YAC7B,YAAY,EAAE,gHAAgH;YAC9H,eAAe,EAAE,WAAW,CAAC,sCAAsC,CAAC;YACpE,MAAM,EAAE;gBACN,CAAC,oCAAoC,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,oDAAoD,EAAE;gBACxH,CAAC,oCAAoC,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,mHAAmH,EAAE;gBACrL,CAAC,oCAAoC,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,kFAAkF,EAAE;aAC/I;YACD,UAAU,EAAE,uBAAuB,CAAC,OAAO;SAC5C,CAAC;QACF,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,mHAAmH,EAAE,CAAC;QACvK,oBAAoB,EAAE,WAAW,CAAC,oBAAoB,CAAC,QAAQ,CAAC;YAC9D,OAAO,EAAE,0FAA0F;YACnG,eAAe,EAAE,WAAW,CAAC,0CAA0C,CAAC;SACzE,CAAC;QACF,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1C,OAAO,EAAE,0GAA0G;YACnH,eAAe,EAAE,WAAW,CAAC,mBAAmB,CAAC;SAClD,CAAC;QACF,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,iHAAiH,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;QACvM,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,uBAAuB,CAAC,OAAO,EAAE,CAAC;QAC5H,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,YAAY,EAAE,6FAA6F,EAAE,CAAC;QAClN,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;QACtG,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC;YAChD,OAAO,EAAE,4GAA4G;YACrH,UAAU,EAAE,uBAAuB,CAAC,OAAO;SAC5C,CAAC;QACF,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;QACnH,cAAc,EAAE,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,qFAAqF,EAAE,CAAC;QACzJ,iBAAiB,EAAE,WAAW,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,8FAA8F,EAAE,CAAC;QACxK,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC;YACpD,OAAO,EAAE,2FAA2F;YACpG,eAAe,EAAE,WAAW,CAAC,mCAAmC,CAAC;SAClE,CAAC;QACF,qBAAqB,EAAE,WAAW,CAAC,qBAAqB,CAAC,QAAQ,CAAC;YAChE,OAAO,EAAE,2IAA2I;kBAChJ,+EAA+E;YACnF,eAAe,EAAE,WAAW,CAAC,yCAAyC,CAAC;SACxE,CAAC;QACF,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC;YACpD,OAAO,EAAE,qIAAqI;YAC9I,YAAY,EAAE,8GAA8G;YAC5H,eAAe,EAAE;gBACf,WAAW,EAAE,uBAAuB,EAAE,UAAU,EAAE,qCAAqC,EAAE,UAAU,EAAE,uCAAuC;gBAC5I,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACtF;SACF,CAAC;QACF,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC;YAC9C,OAAO,EAAE,uIAAuI;kBAC5I,kFAAkF;SACvF,CAAC;QACF,WAAW,EAAE,WAAW,CAAC,WAAW,CAAC,QAAQ,CAAC;YAC5C,OAAO,EAAE,sDAAsD;YAC/D,YAAY,EAAE,gJAAgJ;YAC9J,eAAe,EAAE,WAAW,CAAC,oCAAoC,CAAC;YAClE,MAAM,EAAE;gBACN,CAAC,kCAAkC,CAAC,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,wFAAwF,EAAE;gBAC9J,CAAC,kCAAkC,CAAC,yBAAyB,CAAC,EAAE,EAAE,OAAO,EAAE,6GAA6G,EAAE;gBAC1L,CAAC,kCAAkC,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,mFAAmF,EAAE;gBACrJ,CAAC,kCAAkC,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,8IAA8I,EAAE;aACxM;SACF,CAAC;QACF,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAAC,QAAQ,CAAC;YACtD,OAAO,EAAE,8EAA8E;YACvF,eAAe,EAAE,WAAW,CAAC,oCAAoC,CAAC;YAClE,MAAM,EAAE;gBACN,CAAC,kCAAkC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE;gBAC/F,CAAC,kCAAkC,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,4DAA4D,EAAE;gBACvH,CAAC,kCAAkC,CAAC,kBAAkB,CAAC,EAAE,EAAE,OAAO,EAAE,yDAAyD,EAAE;gBAC/H,CAAC,kCAAkC,CAAC,0BAA0B,CAAC,EAAE,EAAE,OAAO,EAAE,uFAAuF,EAAE;aACtK;SACF,CAAC;QACF,cAAc,EAAE,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,2JAA2J,EAAE,CAAC;QAC/N,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC;YAC3C,OAAO,EAAE,uKAAuK;YAChL,cAAc,EAAE,wNAAwN;YACxO,YAAY,EAAE,6DAA6D;YAC3E,UAAU,EAAE,uBAAuB,CAAC,OAAO;SAC5C,CAAC;QACF,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;YACxC,OAAO,EAAE,sIAAsI;kBAC3I,2IAA2I;kBAC3I,uEAAuE;YAC3E,YAAY,EAAE,+HAA+H;kBACzI,8EAA8E;SACnF,CAAC;QACF,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC;YAC1C,OAAO,EAAE,8HAA8H;kBACnI,oIAAoI;kBACpI,6EAA6E;YACjF,YAAY,EAAE,8HAA8H;kBACxI,oEAAoE;SACzE,CAAC;QACF,mBAAmB,EAAE,WAAW,CAAC,mBAAmB,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,kGAAkG,EAAE,CAAC;QACjL,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,4DAA4D,EAAE,CAAC;KACrH;IAED,UAAU,EAAE;QACV,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACX,OAAO,EAAE,oCAAoC;YAC7C,OAAO,EAAE,wCAAwC;YACjD,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,sBAAsB,CAAC,WAAW,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;YAClG,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE,EAAE,CAAC,uCAAuC,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE,EAAE;SACnH;QACD,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;YACT,OAAO,EAAE,+BAA+B;YACxC,OAAO,EAAE,6GAA6G;YACtH,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,sBAAsB,EAAE,CAAC;YAC5F,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,EAAE,CAAC,uCAAuC,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,2BAA2B,EAAE,EAAE;SAC3G;QACD,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;YACT,OAAO,EAAE,+CAA+C;YACxD,OAAO,EAAE,mFAAmF;YAC5F,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,wBAAwB,EAAE,CAAC;YAC9F,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,EAAE,CAAC,uCAAuC,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,6BAA6B,EAAE,EAAE;SAC7G;QACD,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE;YAChB,OAAO,EAAE,8GAA8G;YACvH,OAAO,EAAE,gGAAgG;YACzG,SAAS,EAAE,iBAAiB;YAC5B,gBAAgB,EAAE,CAAC,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,uEAAuE,EAAE,CAAC;YAC7I,UAAU,EAAE,IAAI;SACjB;KACF;IAED,mBAAmB,EAAE;QACnB,0EAA0E;QAC1E,0FAA0F;QAC1F,8RAA8R;QAC9R,sGAAsG;KACvG;CACF,CAAC,EACF,EAAE,oBAAoB,EAAE,oBAAoB,CAAC,WAAW,EAAE,CAC3D,CAAC","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n ExternalDataPipelineRunFailureKind,\n ExternalDataPipelineRunRecordOutcome,\n ExternalDataSourceUnreachableCause,\n} from '@wildo-ai/saas-backend-lib';\nimport {\n ExternalDataPipelineRunRecordSchema,\n ExternalDataPipelineRunRecordVariantKey,\n externalDataPipelineRunRecordResourceConfiguration_InitializationFactory as runRecordFactory,\n} from '@wildo-ai/saas-backend-lib/external-data-models';\nimport { CoreResourceOperation as Op, ExternalDataPipelinePassMode, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { type AnyResourceSpecificationConfig, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\nconst backendEnum = (exportName: string) => ({\n packageName: '@wildo-ai/saas-backend-lib', exportName, symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n});\n\n/**\n * Framework-owned specification for the internal `externalDataPipelineRunRecords` resource (#1740) — one row per\n * external-data pipeline run, the history the single overwritten run summary on the pipeline's state row could not be.\n *\n * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.\n */\nexport const externalDataPipelineRunRecordsResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n runRecordFactory,\n ExternalDataPipelineRunRecordSchema,\n ({ schemaShape }) => ({\n purpose: 'Keep one row per run of an external-data pipeline — when it started, what started it, how long it took, what it read, rejected and loaded, and how it ended — so an operator can see a pipeline\\'s history rather than only its last run.',\n businessRole: 'Answers the questions a synced copy of someone else\\'s data raises first: is it current, since when has it been failing, and which source records did it refuse and why.',\n lifecycleRole: 'Written once by every pipeline run that produced a report or failed — including one refused before it could start, for want of an owner organization; never updated; read by the external-data admin listing and the history route; deleted by the retention-class sweep once the application\\'s operational-logs period has passed.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.INFRASTRUCTURE,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',\n exportName: 'ExternalDataPipelineRunRecordSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',\n exportName: 'externalDataPipelineRunRecordResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: { packageName: '@wildo-ai/saas-backend-lib', exportName: 'BackendResourceType',\n symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n memberName: 'EXTERNAL_DATA_PIPELINE_RUN_RECORDS',\n },\n operationVocabulary: {\n coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n },\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Identity of the run row, assigned by the store.' }),\n pipelineResourceType: schemaShape.pipelineResourceType.stringSpec({\n meaning: 'The destination resource whose pipeline ran.',\n whyItMatters: 'Every history read filters by it; it is how one pipeline\\'s runs are told apart from another\\'s.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n systemOfRecord: schemaShape.systemOfRecord.stringSpec({ meaning: 'The system-of-record instance the pipeline reads from — or, for an OUTBOUND pipeline, sends to.' }),\n triggerOrigin: schemaShape.triggerOrigin.enumSpec({\n meaning: 'What started the run: the pipeline\\'s own schedule, or an administrator asking for a run.',\n enumDeclaration: backendEnum('DataSeedTriggerOrigin'),\n }),\n passMode: schemaShape.passMode.enumSpec({\n meaning: 'Which track the run advanced: a full read of the source, a read of what changed since the last run, or — for an OUTBOUND pipeline — a send of the local changes owed to the system of record.',\n whyItMatters: 'Only a full pass can notice that a source record disappeared, so the last completed full pass is how fresh deletion detection is.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ExternalDataPipelinePassMode', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [ExternalDataPipelinePassMode.FULL]: { meaning: 'The run advanced a full pass over the source.' },\n [ExternalDataPipelinePassMode.INCREMENTAL]: { meaning: 'The run read only what changed since the incremental track\\'s watermark.' },\n [ExternalDataPipelinePassMode.SEND]: { meaning: 'An OUTBOUND pipeline\\'s run: it sent the destination\\'s changed rows to the system of record and read nothing from it.' },\n },\n }),\n outcome: schemaShape.outcome.enumSpec({\n meaning: 'How the run ended.',\n whyItMatters: 'It is the first thing an operator filters on, and a run of failures in a row is what says a pipeline is stuck.',\n enumDeclaration: backendEnum('ExternalDataPipelineRunRecordOutcome'),\n values: {\n [ExternalDataPipelineRunRecordOutcome.COMPLETED_PASS]: { meaning: 'The run completed its pass and its load completed.' },\n [ExternalDataPipelineRunRecordOutcome.PARTIAL_PASS]: { meaning: 'The run stopped part-way through its pass, or its load did not complete; the next run continues where it stopped.' },\n [ExternalDataPipelineRunRecordOutcome.FAILED]: { meaning: 'The run stopped with an error and produced no report; the failure kind says why.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n passId: schemaShape.passId.stringSpec({ meaning: 'The full pass this run advanced. Empty for an incremental run and for a run that failed before reaching its pass.' }),\n reconciliationStatus: schemaShape.reconciliationStatus.enumSpec({\n meaning: 'Whether the run reconciled which source records had disappeared. Empty for a failed run.',\n enumDeclaration: backendEnum('ExternalDataPipelineReconciliationStatus'),\n }),\n loadStatus: schemaShape.loadStatus.enumSpec({\n meaning: 'How the run\\'s load into the local copy ended. Empty for a failed run and for a run that loaded nothing.',\n enumDeclaration: backendEnum('DataSeedRunStatus'),\n }),\n seedRunId: schemaShape.seedRunId.stringSpec({ meaning: 'The seeding ledger row of the run\\'s load, which carries its per-row outcomes. Empty when the load did not run.', semanticRole: 'identifier' }),\n startedAt: schemaShape.startedAt.dateSpec({ meaning: 'When the run started.', importance: FieldSemanticImportance.PRIMARY }),\n durationMs: schemaShape.durationMs.numberSpec({ meaning: 'How long the run took, in milliseconds.', whyItMatters: 'A pass that grows slower run after run is the early sign of a source outgrowing its pacing.' }),\n extractedRows: schemaShape.extractedRows.numberSpec({ meaning: 'How many source rows the run read.' }),\n rejectedRows: schemaShape.rejectedRows.numberSpec({\n meaning: 'How many source rows the run refused to load. Exact, even when the stored list of rejections is cut short.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n submittedEntries: schemaShape.submittedEntries.numberSpec({ meaning: 'How many rows the run handed to its load.' }),\n suppressedRows: schemaShape.suppressedRows.numberSpec({ meaning: 'How many source rows the run skipped because they belong to an erased data subject.' }),\n pendingReferences: schemaShape.pendingReferences.numberSpec({ meaning: 'How many references to other records were still waiting for their target when the run ended.' }),\n fullPassRestart: schemaShape.fullPassRestart.enumSpec({\n meaning: 'Why the run abandoned a full pass in flight and started a new one. Empty when it did not.',\n enumDeclaration: backendEnum('ExternalDataFullPassRestartReason'),\n }),\n incrementalTrackReset: schemaShape.incrementalTrackReset.enumSpec({\n meaning: 'Why the run started the incremental track over from no watermark. Empty when it did not. On a full-pass run it is set only when that run '\n + 'stood in for an incremental one whose position the source no longer honoured.',\n enumDeclaration: backendEnum('ExternalDataIncrementalTrackResetReason'),\n }),\n incrementalMode: schemaShape.incrementalMode.enumSpec({\n meaning: 'How an incremental run read what changed: by the source\\'s modification stamp, or by its own change feed. Empty on a full-pass run.',\n whyItMatters: 'Only the change feed reports deletions, so it is what says whether an incremental run could remove anything.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models', importPath: '@wildo-ai/saas-models/external-data', exportName: 'ExternalDataIncrementalExtractionMode',\n symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n }),\n removedRows: schemaShape.removedRows.numberSpec({\n meaning: 'How many deletions the source reported that the run passed to the pipeline\\'s orphan policy. A count of what the source said, not of '\n + 'the rows the policy changed; zero on every run that does not read a change feed.',\n }),\n failureKind: schemaShape.failureKind.enumSpec({\n meaning: 'Why the run failed. Empty when it produced a report.',\n whyItMatters: 'Each kind is acted on differently: an unreachable source is waited out, a missing owner organization is created, a lost lease resolves itself.',\n enumDeclaration: backendEnum('ExternalDataPipelineRunFailureKind'),\n values: {\n [ExternalDataPipelineRunFailureKind.SOURCE_UNREACHABLE]: { meaning: 'The system of record could not be reached. Later runs back off until it answers again.' },\n [ExternalDataPipelineRunFailureKind.OWNER_ORGANIZATION_ABSENT]: { meaning: 'The application has no owner organization yet, so nothing was loaded: every row would have been unreadable.' },\n [ExternalDataPipelineRunFailureKind.OWNERSHIP_LOST]: { meaning: 'The run lost its hold on the pipeline part-way through; another run may continue.' },\n [ExternalDataPipelineRunFailureKind.OTHER]: { meaning: 'Any other failure — a stored state the run refused, a source that broke its contract, a store error. The failure message carries the detail.' },\n },\n }),\n unreachableCause: schemaShape.unreachableCause.enumSpec({\n meaning: 'For an unreachable source: which kind of transport failure. Empty otherwise.',\n enumDeclaration: backendEnum('ExternalDataSourceUnreachableCause'),\n values: {\n [ExternalDataSourceUnreachableCause.TIMEOUT]: { meaning: 'The source did not answer in time.' },\n [ExternalDataSourceUnreachableCause.NETWORK]: { meaning: 'The connection to the source could not be made or was cut.' },\n [ExternalDataSourceUnreachableCause.UNAVAILABLE_STATUS]: { meaning: 'The source answered that it is temporarily unavailable.' },\n [ExternalDataSourceUnreachableCause.TOKEN_ENDPOINT_UNREACHABLE]: { meaning: 'The source\\'s token endpoint could not be reached, so no request could be authorized.' },\n },\n }),\n failureMessage: schemaShape.failureMessage.stringSpec({ meaning: 'The failure\\'s message, with URL query strings removed and cut to a bounded length — the same line the log carries. Empty when the run produced a report.' }),\n rejections: schemaShape.rejections.arraySpec({\n meaning: 'The source rows the run refused, each with its remote key, its position among the rows the run extracted and what was wrong with it — up to a bounded number per run.',\n elementMeaning: 'One refused source row: its remote key (empty when the row could not be identified), its position among the rows the run extracted, and the field and problem that made it unloadable — never a value the row carried.',\n whyItMatters: 'It is what an operator needs to fix the data at the source.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n outbound: schemaShape.outbound.objectSpec({\n meaning: 'What an OUTBOUND run did with each change it read: created, updated, settled from an earlier send, kept for a later pass (and why), '\n + 'refused, of unknown outcome, waiting for an operator, or dropped. Every change read lands in exactly one count. Empty on an inbound run, '\n + 'and on an outbound run that failed before its pass produced a report.',\n whyItMatters: 'A rising count of creates waiting for an operator is what says someone must look in the system of record: those rows are not '\n + 'sent again on their own, because a second create could duplicate the record.',\n }),\n conflicts: schemaShape.conflicts.objectSpec({\n meaning: 'What a BIDIRECTIONAL run did with rows changed on both sides since they last agreed: how many it resolved for the system of '\n + 'record, how many for the application, and the rows it refused, by remote key and local row, with the fields that differ. Empty on '\n + 'every other pipeline, and on a run that failed before it produced a report.',\n whyItMatters: 'A refused row waits for an operator to choose a side: neither side\\'s shared fields move, and its local change is not sent, '\n + 'until someone does. It is listed again on every run that reads it.',\n }),\n rejectionsTruncated: schemaShape.rejectionsTruncated.booleanSpec({ meaning: 'True when the run refused more rows than are kept, so the stored list is shorter than the count.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'When the row was written; the retention clock starts here.' }),\n },\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Record how one pipeline run ended.',\n outcome: 'The run joins the pipeline\\'s history.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The run was recorded.' }],\n idempotent: false,\n variants: { [ExternalDataPipelineRunRecordVariantKey.INTERNAL]: { purpose: 'Let a pipeline run record itself.' } },\n },\n [Op.READ]: {\n purpose: 'Read one run by its identity.',\n outcome: 'The run is returned for internal inspection; operators read history through the external-data admin routes.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The run is returned.' }],\n idempotent: true,\n variants: { [ExternalDataPipelineRunRecordVariantKey.INTERNAL]: { purpose: 'Internal inspection only.' } },\n },\n [Op.LIST]: {\n purpose: 'Read a pipeline\\'s recent runs, newest first.',\n outcome: 'The history route and the pipeline listing\\'s health summary are built from them.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The runs are returned.' }],\n idempotent: true,\n variants: { [ExternalDataPipelineRunRecordVariantKey.INTERNAL]: { purpose: 'Internal history read only.' } },\n },\n [Op.DELETE_MANY]: {\n purpose: 'SWEEP ONLY — dispose of run rows once the application\\'s operational-logs period has passed. No client door.',\n outcome: 'Expired runs are deleted by the retention-class sweep. INTERNAL_CALL, so it has no HTTP route.',\n whenToUse: 'Never directly.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The expired runs were removed by the sweep. Not observable over HTTP.' }],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'Written once per run and never updated: a row states how that run ended.',\n 'A run refused because the pipeline was already running leaves no row — it was not a run.',\n 'A rejection reason names the field and the problem — never a value the row carried — and quotes at most the row\\'s own malformed key, which is its identity. The failure message is the failure\\'s log line, with URL query strings removed; a vendor\\'s error text in it is not controlled.',\n 'Kept for the application\\'s declared operational-logs period and swept by the retention-class sweep.',\n ],\n }),\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;AAGjI;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,+CAA+C,EAAE,8BA8J7D,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,8BA6K7D,CAAC"}
@@ -21,7 +21,7 @@ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
21
21
  * re-derivation here.
22
22
  */
23
23
  export const externalDataPipelineStatesResourceSpecification = resourceSpecification(etlPipelineStateFactory, ExternalDataPipelineStateSchema, ({ schemaShape }) => ({
24
- purpose: 'Track one declared ETL pipeline between runs: where the current extraction pass stands, and what the most recent run did.',
24
+ purpose: 'Track one declared ETL pipeline between runs: where the current full extraction pass stands, where its incremental track stands when it reads only what changed, and what the most recent run did.',
25
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.',
26
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.',
27
27
  audience: LabelAudience.DEVELOPER,
@@ -73,16 +73,27 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
73
73
  whyItMatters: 'It advances with the accepted source-membership head only after a successful load, allowing restart without losing earlier source identities.',
74
74
  importance: FieldSemanticImportance.PRIMARY,
75
75
  }),
76
- passCheckpoint: schemaShape.passCheckpoint.objectSpec({ meaning: 'Unique active pass and accepted immutable source-membership head, checkpointed together with the extraction cursor.' }),
76
+ passCheckpoint: schemaShape.passCheckpoint.objectSpec({
77
+ meaning: 'Unique active pass and accepted immutable source-membership head, checkpointed together with the extraction cursor, and the fingerprint of the declaration the pass started under.',
78
+ whyItMatters: 'A run under a different declaration fingerprint abandons the pass and starts a new one, so one pass never mixes two declarations: a changed key would otherwise orphan every row read before it, and a narrower filter would leave the rows it now excludes in place.',
79
+ }),
77
80
  passStartedAt: schemaShape.passStartedAt.dateSpec({
78
81
  meaning: 'When the in-flight extraction pass began. Empty when no pass is underway.',
79
82
  }),
83
+ incrementalTrack: schemaShape.incrementalTrack.objectSpec({
84
+ meaning: 'The incremental track of a pipeline that reads only what changed: which change-tracking mode it uses, the fingerprint of what it extracts, the largest remote position it has loaded (its watermark), and where an in-flight incremental pass continues. Empty for a pipeline that runs full passes only.',
85
+ whyItMatters: 'It is independent of the full pass\'s cursor, so a long full pass and frequent incremental passes never block each other; a changed fingerprint drops the watermark, so a declaration change reaches rows that did not change remotely.',
86
+ }),
87
+ sourceUnreachable: schemaShape.sourceUnreachable.objectSpec({
88
+ meaning: 'The current streak of failures to reach the pipeline\'s system of record: when the first failure happened, how many consecutive attempts failed, how many scheduled runs were skipped while backing off, why the last attempt failed (a timeout, a network failure, an unavailable status, an unreachable token endpoint) and when the next scheduled attempt is due. Empty while the system of record is reachable.',
89
+ whyItMatters: 'It lets scheduled runs back off from a source that is down instead of failing identically on every tick, across restarts, and it is what an operator reads to tell an address pointed at nothing from an outage in progress. The first run that reaches the source clears it; a run started by an operator never waits for it.',
90
+ }),
80
91
  lastRunAt: schemaShape.lastRunAt.dateSpec({
81
92
  meaning: 'When the most recent run started, whatever its outcome. Empty until the pipeline first runs.',
82
93
  }),
83
94
  lastRunSummary: schemaShape.lastRunSummary.objectSpec({
84
- 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.',
85
- 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.',
95
+ meaning: 'What the most recent run did on the extraction side: which track it advanced (a full pass or an incremental one), whether it started the incremental track over, whether it abandoned an in-flight full pass because the declaration changed under it, whether it completed its pass and reconciled absence, how many remote records it read, how many records the transform rejected, the load verdict, how long it took, which seeding-pass ledger record carries the per-entry load outcome, the remote partitions it did not load because no operator has assigned them to an organization unit (per partition key, with a row count), how many archived source records it left out of the load, and what pacing against the source\'s rate budget cost it: the time spent waiting for budget or for a throttling source, how many waits, and whether it stopped at its run deadline.',
96
+ 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. The unassigned partitions are persisted because the operator who must assign them is rarely the one who triggered the run, and a pipeline silently not loading a subsidiary\'s rows must not list as healthy. The pacing numbers tell an operator whether a pass is progressing slower than its cadence because its rate-budget ceiling is low or its source is throttling it, rather than because it failed.',
86
97
  importance: FieldSemanticImportance.PRIMARY,
87
98
  }),
88
99
  },
@@ -94,7 +105,7 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
94
105
  { code: HttpResponseStatusCode.CREATED_201, meaning: 'The record was created and is returned.' },
95
106
  ],
96
107
  errorScenarios: [
97
- { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The row fails schema validation.', errorCode: 'VALIDATION_FAILED' },
108
+ { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The row fails schema validation.' },
98
109
  ],
99
110
  idempotent: false,
100
111
  variants: {
@@ -127,7 +138,7 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
127
138
  ],
128
139
  errorScenarios: [
129
140
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No row exists for the supplied identifier.' },
130
- { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patch fails schema validation.', errorCode: 'VALIDATION_FAILED' },
141
+ { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patch fails schema validation.' },
131
142
  ],
132
143
  idempotent: true,
133
144
  variants: {
@@ -156,7 +167,9 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
156
167
  businessConstraints: [
157
168
  'This row is bookkeeping about a pipeline, never the pipeline\'s data: deleting it costs a restarted extraction pass, not any synced content.',
158
169
  '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.',
170
+ 'Only a full pass may conclude a remote row was deleted. An incremental pass reads what changed, and a deletion is not a change, so it never reconciles absence; while a full pass is in flight, the keys an incremental pass reads join that full pass\'s membership so they are not mistaken for deletions when it completes.',
159
171
  'The per-entry load outcome lives on the seeding-pass ledger this summary points at; the two records deliberately do not duplicate each other.',
172
+ 'Only a failure to reach the system of record starts or extends an unreachable streak; a refusal, a malformed answer or a run stopped at its deadline never does, and a failed attempt leaves the last-run summary untouched.',
160
173
  ],
161
174
  }),
162
175
  // Same posture as DATA_SEED_RUN: a STANDALONE infrastructure row reached only through internal
@@ -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';\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: 'Last accepted source continuation. Empty at the beginning, including a retry of a failed first batch.',\n whyItMatters: 'It advances with the accepted source-membership head only after a successful load, allowing restart without losing earlier source identities.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n passCheckpoint: schemaShape.passCheckpoint.objectSpec({ meaning: 'Unique active pass and accepted immutable source-membership head, checkpointed together with the extraction cursor.' }),\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
+ {"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 full extraction pass stands, where its incremental track stands when it reads only what changed, 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: 'Last accepted source continuation. Empty at the beginning, including a retry of a failed first batch.',\n whyItMatters: 'It advances with the accepted source-membership head only after a successful load, allowing restart without losing earlier source identities.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n passCheckpoint: schemaShape.passCheckpoint.objectSpec({\n meaning: 'Unique active pass and accepted immutable source-membership head, checkpointed together with the extraction cursor, and the fingerprint of the declaration the pass started under.',\n whyItMatters: 'A run under a different declaration fingerprint abandons the pass and starts a new one, so one pass never mixes two declarations: a changed key would otherwise orphan every row read before it, and a narrower filter would leave the rows it now excludes in place.',\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 incrementalTrack: schemaShape.incrementalTrack.objectSpec({\n meaning: 'The incremental track of a pipeline that reads only what changed: which change-tracking mode it uses, the fingerprint of what it extracts, the largest remote position it has loaded (its watermark), and where an in-flight incremental pass continues. Empty for a pipeline that runs full passes only.',\n whyItMatters: 'It is independent of the full pass\\'s cursor, so a long full pass and frequent incremental passes never block each other; a changed fingerprint drops the watermark, so a declaration change reaches rows that did not change remotely.',\n }),\n\n sourceUnreachable: schemaShape.sourceUnreachable.objectSpec({\n meaning: 'The current streak of failures to reach the pipeline\\'s system of record: when the first failure happened, how many consecutive attempts failed, how many scheduled runs were skipped while backing off, why the last attempt failed (a timeout, a network failure, an unavailable status, an unreachable token endpoint) and when the next scheduled attempt is due. Empty while the system of record is reachable.',\n whyItMatters: 'It lets scheduled runs back off from a source that is down instead of failing identically on every tick, across restarts, and it is what an operator reads to tell an address pointed at nothing from an outage in progress. The first run that reaches the source clears it; a run started by an operator never waits for it.',\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: which track it advanced (a full pass or an incremental one), whether it started the incremental track over, whether it abandoned an in-flight full pass because the declaration changed under it, whether it completed its pass and reconciled absence, how many remote records it read, how many records the transform rejected, the load verdict, how long it took, which seeding-pass ledger record carries the per-entry load outcome, the remote partitions it did not load because no operator has assigned them to an organization unit (per partition key, with a row count), how many archived source records it left out of the load, and what pacing against the source\\'s rate budget cost it: the time spent waiting for budget or for a throttling source, how many waits, and whether it stopped at its run deadline.',\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. The unassigned partitions are persisted because the operator who must assign them is rarely the one who triggered the run, and a pipeline silently not loading a subsidiary\\'s rows must not list as healthy. The pacing numbers tell an operator whether a pass is progressing slower than its cadence because its rate-budget ceiling is low or its source is throttling it, rather than because it failed.',\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.' },\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.' },\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 'Only a full pass may conclude a remote row was deleted. An incremental pass reads what changed, and a deletion is not a change, so it never reconciles absence; while a full pass is in flight, the keys an incremental pass reads join that full pass\\'s membership so they are not mistaken for deletions when it completes.',\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 'Only a failure to reach the system of record starts or extends an unreachable streak; a refusal, a malformed answer or a run stopped at its deadline never does, and a failed attempt leaves the last-run summary untouched.',\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"]}
@@ -0,0 +1,9 @@
1
+ import { type AnyResourceSpecificationConfig } from '../../../_core';
2
+ /**
3
+ * Framework-owned specification for the internal `externalDataRemoteVersions` resource (#1723) — the system of record's
4
+ * row version at which each remote record of a BIDIRECTIONAL destination and its local copy last agreed.
5
+ *
6
+ * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.
7
+ */
8
+ export declare const externalDataRemoteVersionsResourceSpecification: AnyResourceSpecificationConfig;
9
+ //# sourceMappingURL=external-data-remote-versions.resource.specification.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"external-data-remote-versions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-remote-versions.resource.specification.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,8BAA8B,EAAiD,MAAM,6BAA6B,CAAC;AAGjI;;;;;GAKG;AACH,eAAO,MAAM,+CAA+C,EAAE,8BA2F7D,CAAC"}
@@ -0,0 +1,97 @@
1
+ import { LabelAudience } from '@wildo-ai/presets-components-models';
2
+ import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';
3
+ import { ExternalDataRemoteVersionSchema, ExternalDataRemoteVersionVariantKey, externalDataRemoteVersionResourceConfiguration_InitializationFactory as remoteVersionFactory, } from '@wildo-ai/saas-backend-lib/external-data-models';
4
+ import { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';
5
+ import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
6
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
7
+ /**
8
+ * Framework-owned specification for the internal `externalDataRemoteVersions` resource (#1723) — the system of record's
9
+ * row version at which each remote record of a BIDIRECTIONAL destination and its local copy last agreed.
10
+ *
11
+ * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.
12
+ */
13
+ export const externalDataRemoteVersionsResourceSpecification = resourceSpecification(remoteVersionFactory, ExternalDataRemoteVersionSchema, ({ schemaShape }) => ({
14
+ purpose: 'Remember, per remote record of a two-way pipeline, the version at which the system of record and the application last agreed, so a record changed on both sides since is recognised as a conflict.',
15
+ businessRole: 'Lets an application and a business system both edit the same records — a partner\'s phone in the CRM and in the ERP — without either side silently overwriting the other.',
16
+ lifecycleRole: 'Written when a pass loads a record\'s values (at the version it loaded them) and when a pass sends a row (at the version the record has after the write); left alone when a conflict is refused, because the two sides do not agree.',
17
+ audience: LabelAudience.DEVELOPER,
18
+ subDomain: EngineResourceSubDomain.INFRASTRUCTURE,
19
+ codeHandling: {
20
+ mainSchema: {
21
+ packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',
22
+ exportName: 'ExternalDataRemoteVersionSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA,
23
+ },
24
+ resourceFactory: {
25
+ packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',
26
+ exportName: 'externalDataRemoteVersionResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION,
27
+ },
28
+ resourceType: {
29
+ enumDeclaration: { packageName: '@wildo-ai/saas-backend-lib', exportName: 'BackendResourceType',
30
+ symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
31
+ memberName: 'EXTERNAL_DATA_REMOTE_VERSIONS',
32
+ },
33
+ operationVocabulary: {
34
+ coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation',
35
+ symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
36
+ },
37
+ },
38
+ fields: {
39
+ _id: schemaShape._id.stringSpec({
40
+ meaning: 'The row\'s identity, derived from the destination and the remote key, so every pass addresses the same row for one record.',
41
+ semanticRole: 'identifier',
42
+ importance: FieldSemanticImportance.PRIMARY,
43
+ }),
44
+ resourceType: schemaShape.resourceType.stringSpec({ meaning: 'The two-way pipeline\'s destination resource.' }),
45
+ remoteKey: schemaShape.remoteKey.stringSpec({ meaning: 'The remote record\'s key, as the destination\'s remote-key field holds it.' }),
46
+ remoteVersion: schemaShape.remoteVersion.stringSpec({
47
+ meaning: 'The system of record\'s own row version (a last-modified stamp, an entity tag) when the two sides last agreed.',
48
+ whyItMatters: 'A record whose current version differs was changed over there since; with a local change pending too, it is a conflict.',
49
+ importance: FieldSemanticImportance.PRIMARY,
50
+ }),
51
+ reconciledAt: schemaShape.reconciledAt.dateSpec({ meaning: 'When the two sides last agreed.' }),
52
+ },
53
+ operations: {
54
+ [Op.CREATE]: {
55
+ purpose: 'Record the first agreement on a remote record.',
56
+ outcome: 'Later passes can tell whether the record changed over there since.',
57
+ importance: FieldSemanticImportance.PRIMARY,
58
+ responseStatuses: [{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The version was recorded.' }],
59
+ idempotent: false,
60
+ variants: { [ExternalDataRemoteVersionVariantKey.INTERNAL]: { purpose: 'Let a pass record an agreement.' } },
61
+ },
62
+ [Op.UPDATE]: {
63
+ purpose: 'Record a newer agreement on a remote record.',
64
+ outcome: 'The row names the version both sides now hold.',
65
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The version was updated.' }],
66
+ idempotent: true,
67
+ variants: { [ExternalDataRemoteVersionVariantKey.INTERNAL]: { purpose: 'Internal bookkeeping by the passes.' } },
68
+ },
69
+ [Op.READ]: {
70
+ purpose: 'Read one record\'s agreed version.',
71
+ outcome: 'The version is returned for internal comparison.',
72
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The version is returned.' }],
73
+ idempotent: true,
74
+ variants: { [ExternalDataRemoteVersionVariantKey.INTERNAL]: { purpose: 'Internal comparison only.' } },
75
+ },
76
+ [Op.LIST]: {
77
+ purpose: 'Read the agreed versions of the records one page of a pass carries.',
78
+ outcome: 'Each record is compared with the version it has now.',
79
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The versions are returned.' }],
80
+ idempotent: true,
81
+ variants: { [ExternalDataRemoteVersionVariantKey.INTERNAL]: { purpose: 'Internal pass read only.' } },
82
+ },
83
+ [Op.DELETE]: {
84
+ purpose: 'Remove a record\'s agreed version.',
85
+ outcome: 'The record is next met as never agreed on, which a pass treats as changed over there.',
86
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The version was removed.' }],
87
+ idempotent: true,
88
+ variants: { [ExternalDataRemoteVersionVariantKey.INTERNAL]: { purpose: 'Internal cleanup only.' } },
89
+ },
90
+ },
91
+ businessConstraints: [
92
+ 'Only the system of record\'s own row version is kept: a clock the application keeps cannot see a change made over there.',
93
+ 'Never written for a refused conflict — the two sides do not agree until someone chooses which one wins.',
94
+ 'Holds no record content, only a remote identity and a version stamp.',
95
+ ],
96
+ }), { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION });
97
+ //# sourceMappingURL=external-data-remote-versions.resource.specification.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"external-data-remote-versions.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-remote-versions.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n ExternalDataRemoteVersionSchema,\n ExternalDataRemoteVersionVariantKey,\n externalDataRemoteVersionResourceConfiguration_InitializationFactory as remoteVersionFactory,\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 `externalDataRemoteVersions` resource (#1723) — the system of record's\n * row version at which each remote record of a BIDIRECTIONAL destination and its local copy last agreed.\n *\n * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.\n */\nexport const externalDataRemoteVersionsResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n remoteVersionFactory,\n ExternalDataRemoteVersionSchema,\n ({ schemaShape }) => ({\n purpose: 'Remember, per remote record of a two-way pipeline, the version at which the system of record and the application last agreed, so a record changed on both sides since is recognised as a conflict.',\n businessRole: 'Lets an application and a business system both edit the same records — a partner\\'s phone in the CRM and in the ERP — without either side silently overwriting the other.',\n lifecycleRole: 'Written when a pass loads a record\\'s values (at the version it loaded them) and when a pass sends a row (at the version the record has after the write); left alone when a conflict is refused, because the two sides do not agree.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.INFRASTRUCTURE,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',\n exportName: 'ExternalDataRemoteVersionSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',\n exportName: 'externalDataRemoteVersionResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: { packageName: '@wildo-ai/saas-backend-lib', exportName: 'BackendResourceType',\n symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n memberName: 'EXTERNAL_DATA_REMOTE_VERSIONS',\n },\n operationVocabulary: {\n coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n },\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'The row\\'s identity, derived from the destination and the remote key, so every pass addresses the same row for one record.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n resourceType: schemaShape.resourceType.stringSpec({ meaning: 'The two-way pipeline\\'s destination resource.' }),\n remoteKey: schemaShape.remoteKey.stringSpec({ meaning: 'The remote record\\'s key, as the destination\\'s remote-key field holds it.' }),\n remoteVersion: schemaShape.remoteVersion.stringSpec({\n meaning: 'The system of record\\'s own row version (a last-modified stamp, an entity tag) when the two sides last agreed.',\n whyItMatters: 'A record whose current version differs was changed over there since; with a local change pending too, it is a conflict.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n reconciledAt: schemaShape.reconciledAt.dateSpec({ meaning: 'When the two sides last agreed.' }),\n },\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Record the first agreement on a remote record.',\n outcome: 'Later passes can tell whether the record changed over there since.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The version was recorded.' }],\n idempotent: false,\n variants: { [ExternalDataRemoteVersionVariantKey.INTERNAL]: { purpose: 'Let a pass record an agreement.' } },\n },\n [Op.UPDATE]: {\n purpose: 'Record a newer agreement on a remote record.',\n outcome: 'The row names the version both sides now hold.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The version was updated.' }],\n idempotent: true,\n variants: { [ExternalDataRemoteVersionVariantKey.INTERNAL]: { purpose: 'Internal bookkeeping by the passes.' } },\n },\n [Op.READ]: {\n purpose: 'Read one record\\'s agreed version.',\n outcome: 'The version is returned for internal comparison.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The version is returned.' }],\n idempotent: true,\n variants: { [ExternalDataRemoteVersionVariantKey.INTERNAL]: { purpose: 'Internal comparison only.' } },\n },\n [Op.LIST]: {\n purpose: 'Read the agreed versions of the records one page of a pass carries.',\n outcome: 'Each record is compared with the version it has now.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The versions are returned.' }],\n idempotent: true,\n variants: { [ExternalDataRemoteVersionVariantKey.INTERNAL]: { purpose: 'Internal pass read only.' } },\n },\n [Op.DELETE]: {\n purpose: 'Remove a record\\'s agreed version.',\n outcome: 'The record is next met as never agreed on, which a pass treats as changed over there.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The version was removed.' }],\n idempotent: true,\n variants: { [ExternalDataRemoteVersionVariantKey.INTERNAL]: { purpose: 'Internal cleanup only.' } },\n },\n },\n\n businessConstraints: [\n 'Only the system of record\\'s own row version is kept: a clock the application keeps cannot see a change made over there.',\n 'Never written for a refused conflict — the two sides do not agree until someone chooses which one wins.',\n 'Holds no record content, only a remote identity and a version stamp.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
@@ -144,12 +144,20 @@ export declare const jobExecutionsResourceSpecification: import("../../../_core"
144
144
  consumableTokenId: import("zod").ZodOptional<import("zod").ZodString>;
145
145
  webhookProviderId: import("zod").ZodOptional<import("zod").ZodString>;
146
146
  anonymousUserId: import("zod").ZodOptional<import("zod").ZodString>;
147
+ inboundDeliveryId: import("zod").ZodOptional<import("zod").ZodString>;
148
+ inboundHandlerRef: import("zod").ZodOptional<import("zod").ZodString>;
149
+ inboundScopeUserId: import("zod").ZodOptional<import("zod").ZodString>;
150
+ inboundSender: import("zod").ZodOptional<import("zod").ZodObject<{
151
+ channel: import("zod").ZodEnum<typeof import("@wildo-ai/saas-models").InboundChannelKind>;
152
+ assurance: import("zod").ZodEnum<typeof import("@wildo-ai/saas-models").InboundSenderAssurance>;
153
+ }, import("zod/v4/core").$strict>>;
147
154
  }, import("zod/v4/core").$strip>>>;
148
155
  executionType: import("zod").ZodOptional<import("zod").ZodEnum<typeof import("@wildo-ai/saas-models").ExecutionContext_ExecutionType>>;
149
156
  userGuidance: import("zod").ZodOptional<import("zod").ZodObject<{
150
157
  guidanceKey: import("zod").ZodOptional<import("zod").ZodString>;
151
158
  explanation: import("zod").ZodOptional<import("zod").ZodString>;
152
159
  resolution: import("zod").ZodOptional<import("zod").ZodString>;
160
+ params: import("zod").ZodOptional<import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnion<readonly [import("zod").ZodString, import("zod").ZodNumber]>>>;
153
161
  completedSteps: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
154
162
  nextAction: import("zod").ZodOptional<import("zod").ZodObject<{
155
163
  label: import("zod").ZodString;
@@ -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,EAE3B,kBAAkB,EAIlB,OAAO,EAGR,MAAM,uBAAuB,CAAC;AAI/B;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAyR9C,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,EAE3B,kBAAkB,EAIlB,OAAO,EAGR,MAAM,uBAAuB,CAAC;AAI/B;;;;;;GAMG;AACH,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAyR9C,CAAC"}
@@ -165,7 +165,7 @@ export const jobExecutionsResourceSpecification = resourceSpecification(jobExecu
165
165
  { 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.' },
166
166
  ],
167
167
  errorScenarios: [
168
- { 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' },
168
+ { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The execution payload fails schema validation (e.g. an unknown `jobType`, missing `status`, or malformed correlation fields).' },
169
169
  { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-infrastructure caller attempts to register a job — execution rows are created only by the queue/runtime layer through the internal repository service.' },
170
170
  ],
171
171
  idempotent: false,
@@ -202,7 +202,7 @@ export const jobExecutionsResourceSpecification = resourceSpecification(jobExecu
202
202
  ],
203
203
  errorScenarios: [
204
204
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No job execution row exists for the supplied `jobId` to advance.' },
205
- { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The lifecycle patch fails schema validation (e.g. an unrecognized `status` value).', errorCode: 'VALIDATION_FAILED' },
205
+ { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The lifecycle patch fails schema validation (e.g. an unrecognized `status` value).' },
206
206
  { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-infrastructure caller attempts to mutate execution state.' },
207
207
  { code: HttpResponseStatusCode.CONFLICT_409, when: 'The requested transition is illegal for the row’s current state (e.g. moving a `COMPLETED`/`CANCELLED` terminal row back to `PROCESSING`).' },
208
208
  ],
@@ -1 +1 @@
1
- {"version":3,"file":"job-executions.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/job-executions.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 CoreResourceOperation as Op,\n JobExecutionSchema,\n JobExecutionStatus,\n JobExecutionVariantKey,\n JobInitiator,\n JobPriority,\n JobType,\n ResourcePrimaryScope,\n jobExecution_ResourceConfiguration_InitializationFactory as jobExecutionFactory,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned base specification for the internal `jobExecutions` resource.\n *\n * This resource is intentionally authored from the shared resource factory only:\n * it is a platform/infrastructure truth source, and its first useful semantic\n * layer is the base operational model rather than end-user UI narration.\n */\nexport const jobExecutionsResourceSpecification = resourceSpecification(\n jobExecutionFactory,\n JobExecutionSchema,\n ({ schemaShape }) => ({\n purpose: 'Track the lifecycle of background jobs executed by the platform queue system.',\n businessRole: 'Operational control-plane record used to observe, troubleshoot, and audit asynchronous work.',\n lifecycleRole: 'Moves through queue intake, execution, retry, completion, failure, or cancellation states under infrastructure control.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.INFRASTRUCTURE,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'JobExecutionSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'jobExecution_ResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'JOB_EXECUTIONS',\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 expiresAt: schemaShape.expiresAt.dateSpec({ meaning: 'Cleanup deadline. Ordinary queue history expires after 30 days; unresolved scheduled claims have no deadline and cannot disappear while their effects remain uncertain.' }),\n scheduledState: schemaShape.scheduledState.objectSpec({ meaning: 'Durable scheduled occurrence ownership, captured recovery contract, bounded attempt history and attributed operator resolutions. Its revision arbitrates all execution and recovery transitions.' }),\n minionName: schemaShape.minionName.stringSpec({ meaning: 'Exact local minion target for a scheduled tick. Application and queue ownership are verified before receipt is persisted.' }),\n jobId: schemaShape.jobId.stringSpec({\n meaning: 'Stable operational identifier for one job execution.',\n whyItMatters: 'It is the main anchor used by operators and infrastructure services to correlate one execution across logs, retries, and storage.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n jobType: schemaShape.jobType.enumSpec({\n meaning: 'Classifies which family of background capability this execution belongs to.',\n whyItMatters: 'It distinguishes what kind of business or platform work is being performed so operators can reason about volume, ownership, and failure posture.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'JobType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [JobType.RESOURCE_OPERATION]: { meaning: 'Asynchronous execution of a resource operation or workflow step.' },\n [JobType.CUSTOM_BATCH]: { meaning: 'Batch-style work defined outside the default CRUD operation families.' },\n [JobType.SCHEDULED_CRON]: { meaning: 'Platform-scheduled recurring work triggered by a cron definition.' },\n [JobType.MINION_TICK]: { meaning: 'Cron-driven minion tick published to its dedicated minion queue when a minion’s cron schedule fires; consumed by the minion runtime that owns the matching `minionName`.' },\n },\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Current execution state of the queued job.',\n whyItMatters: 'It is the primary operational signal for knowing whether work is still pending, progressing, completed, or needs intervention.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'JobExecutionStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [JobExecutionStatus.PENDING]: { meaning: 'Accepted but not yet queued for processing.' },\n [JobExecutionStatus.QUEUED]: { meaning: 'Waiting in the queue for worker pickup.' },\n [JobExecutionStatus.PROCESSING]: { meaning: 'Actively executing on a worker.' },\n [JobExecutionStatus.COMPLETED]: { meaning: 'Finished successfully.' },\n [JobExecutionStatus.FAILED]: { meaning: 'Execution finished unsuccessfully and currently stands in a failed state.' },\n [JobExecutionStatus.RETRYING]: { meaning: 'A previous attempt failed and the platform is scheduling or running another attempt.' },\n [JobExecutionStatus.DEAD_LETTER]: { meaning: 'The job exhausted its recovery path and has been isolated for operator attention.' },\n [JobExecutionStatus.CANCELLED]: { meaning: 'Execution was intentionally stopped before successful completion.' },\n },\n }),\n\n initiatedBy: schemaShape.initiatedBy.enumSpec({\n meaning: 'Who or what caused this job execution to exist.',\n whyItMatters: 'It helps operators separate human-triggered work from system-initiated automation when investigating behavior.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'JobInitiator',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [JobInitiator.API]: { meaning: 'Created from an API-triggered action.' },\n [JobInitiator.CRONTAB]: { meaning: 'Created by scheduled recurring automation.' },\n [JobInitiator.INTERNAL]: { meaning: 'Created internally by platform/service orchestration.' },\n },\n }),\n\n priority: schemaShape.priority.enumSpec({\n meaning: 'Operational urgency level for queue scheduling.',\n whyItMatters: 'It influences how infrastructure should treat this work relative to other queued executions.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'JobPriority',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [JobPriority.LOW]: { meaning: 'Background work that can wait.' },\n [JobPriority.NORMAL]: { meaning: 'Standard priority for ordinary asynchronous tasks.' },\n [JobPriority.HIGH]: { meaning: 'Important work that should be processed sooner than normal tasks.' },\n [JobPriority.CRITICAL]: { meaning: 'Top-priority work whose delay could materially harm platform behavior.' },\n },\n }),\n\n operationPathKey: schemaShape.operationPathKey.stringSpec({\n meaning: 'Links the execution to the underlying resource operation path that spawned it.',\n whyItMatters: 'It ties low-level job processing back to the higher-level product or platform action that caused the asynchronous work.',\n semanticRole: 'code',\n }),\n\n batchRef: schemaShape.batchRef.stringSpec({\n meaning: 'Reference of the registered custom batch implementation.',\n whyItMatters: 'It identifies the handler that owns this occurrence; distinct scheduled occurrences have distinct job IDs.',\n semanticRole: 'identifier',\n }),\n\n organizationId: schemaShape.organizationId.foreignKeySpec({\n meaning: 'The `organizations` record that owns the tenant context this execution ran under, captured from the initiating execution context.',\n whyItMatters: 'It lets operators filter and isolate the execution ledger per tenant when triaging or reporting on background work.',\n }),\n\n userId: schemaShape.userId.foreignKeySpec({\n meaning: 'The `users` record that initiated the work, when a human principal (rather than a system process) caused the execution.',\n whyItMatters: 'It attributes background work to the initiating user for accountability and per-actor investigation; absent for system-initiated jobs.',\n }),\n\n inputPayloadStorageId: schemaShape.inputPayloadStorageId.foreignKeySpec({\n meaning: 'The `jobPayloadStorage` record holding the serialized INPUT arguments when the payload was spilled out of the queue envelope for size.',\n whyItMatters: 'It lets the worker rehydrate the exact input arguments this execution ran with, for processing, replay, and troubleshooting.',\n }),\n\n outputPayloadStorageId: schemaShape.outputPayloadStorageId.foreignKeySpec({\n meaning: 'The `jobPayloadStorage` record holding the serialized OUTPUT/result of the execution when the result was spilled to storage rather than kept inline.',\n whyItMatters: 'It lets downstream consumers and operators retrieve the produced result of a completed execution without overloading the queue envelope.',\n }),\n },\n\n operations: {\n [Op.DELETE_MANY]: {\n purpose: 'Internal bounded retention cleanup of expired rows; no public deletion route.',\n outcome: 'The scheduled retention sweep can delete its selected expired batch through the declared repository operation.',\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Create a new job execution record.',\n outcome: 'The platform begins tracking one asynchronous work item as a first-class execution row.',\n responseStatuses: [\n { 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.' },\n ],\n errorScenarios: [\n { 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' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-infrastructure caller attempts to register a job — execution rows are created only by the queue/runtime layer through the internal repository service.' },\n ],\n idempotent: false,\n variants: {\n [JobExecutionVariantKey.INTERNAL]: {\n purpose: 'Allow internal infrastructure services to register a job before queue processing begins.',\n whenToUse: 'Use when the queue/runtime layer needs to persist a new execution as part of internal orchestration.',\n },\n },\n },\n\n [Op.READ]: {\n purpose: 'Read one job execution record.',\n outcome: 'The caller can inspect the current tracked state of a specific asynchronous execution.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The job execution record for the supplied `jobId` was found and its tracked lifecycle state is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No job execution row exists for the supplied `jobId` (never created, or already purged by retention).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an operator/infrastructure principal — this ledger is internal-only and not exposed to ordinary tenant callers.' },\n ],\n idempotent: true,\n variants: {\n [JobExecutionVariantKey.INTERNAL]: {\n purpose: 'Allow internal infrastructure services to resolve one execution during queue handling or observability flows.',\n },\n },\n },\n\n [Op.UPDATE]: {\n purpose: 'Advance or correct the tracked state of a job execution.',\n outcome: 'The platform’s operational truth about the execution stays synchronized with the actual runtime lifecycle.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { 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.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No job execution row exists for the supplied `jobId` to advance.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The lifecycle patch fails schema validation (e.g. an unrecognized `status` value).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-infrastructure caller attempts to mutate execution state.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The requested transition is illegal for the row’s current state (e.g. moving a `COMPLETED`/`CANCELLED` terminal row back to `PROCESSING`).' },\n ],\n idempotent: true,\n variants: {\n [JobExecutionVariantKey.INTERNAL]: {\n purpose: 'Allow infrastructure services to record status changes, timing, retries, payload references, and errors.',\n whenToUse: 'Use whenever the worker/runtime layer needs to persist a lifecycle transition for a running or finished job.',\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate job execution records.',\n outcome: 'The caller can inspect a set of executions instead of one isolated row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of job execution records in the requested scope.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an operator/infrastructure principal authorized to enumerate the execution ledger.' },\n ],\n idempotent: true,\n variants: {\n [JobExecutionVariantKey.INTERNAL]: {\n purpose: 'Allow internal operational tooling or services to inspect batches of executions.',\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Filter and search job execution history.',\n outcome: 'Operators or infrastructure flows can narrow execution history to the subset relevant for troubleshooting or reporting.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of executions matching the status / type / initiator / correlation filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the operator/infrastructure role required to query the execution ledger.' },\n ],\n idempotent: true,\n variants: {\n [JobExecutionVariantKey.INTERNAL]: {\n purpose: 'Allow internal operational search across status, type, initiator, queue, and correlation fields.',\n whenToUse: 'Use when observability, support, or queue-control workflows need targeted execution lookup rather than raw enumeration.',\n },\n },\n },\n },\n\n businessConstraints: [\n 'This resource is an infrastructure execution ledger, not the source of truth for the business entity that caused the job.',\n 'Job execution rows should remain focused on runtime lifecycle, correlation, and troubleshooting semantics rather than becoming a generic dumping ground for arbitrary payload data.',\n 'The dominant consumer posture is operational and internal, even if later tooling surfaces selected projections to administrators.',\n ],\n }),\n // Phase 4.5 Step 2 (F-1): explicit scope declaration. JOB_EXECUTIONS is\n // a STANDALONE infrastructure ledger (the `APPLICATION → JOB_EXECUTIONS`\n // relationship in `resources-registry.shared.core.definitions.ts` uses\n // `accessScopeStrategy: STANDALONE`, intentionally bypassing scope-based\n // access control because access is internal-only via repository services\n // with INTERNAL variants). There is no m2m channel × scope surface to\n // protect because the resource carries no m2m blocks (verified —\n // operational/internal spec), so the declaration's only live consumer is\n // the spec ↔ registry alignment guard. The registry factory has NO silent\n // scope fallback (it throws without a derivation signal — see\n // `primary-scope-no-fallback.test.ts`); it derives APPLICATION from the\n // `isPrimaryScope: true` flag on the `APPLICATION → JOB_EXECUTIONS` rel.\n // An earlier revision declared ORGANIZATIONS on the (incorrect) assumption\n // of an ORGANIZATIONS fallback for STANDALONE resources; corrected\n // 2026-07-02 when the companion alignment guard started pairing engine\n // specs with materialized core configs and flagged the drift.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
1
+ {"version":3,"file":"job-executions.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/job-executions.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 CoreResourceOperation as Op,\n JobExecutionSchema,\n JobExecutionStatus,\n JobExecutionVariantKey,\n JobInitiator,\n JobPriority,\n JobType,\n ResourcePrimaryScope,\n jobExecution_ResourceConfiguration_InitializationFactory as jobExecutionFactory,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned base specification for the internal `jobExecutions` resource.\n *\n * This resource is intentionally authored from the shared resource factory only:\n * it is a platform/infrastructure truth source, and its first useful semantic\n * layer is the base operational model rather than end-user UI narration.\n */\nexport const jobExecutionsResourceSpecification = resourceSpecification(\n jobExecutionFactory,\n JobExecutionSchema,\n ({ schemaShape }) => ({\n purpose: 'Track the lifecycle of background jobs executed by the platform queue system.',\n businessRole: 'Operational control-plane record used to observe, troubleshoot, and audit asynchronous work.',\n lifecycleRole: 'Moves through queue intake, execution, retry, completion, failure, or cancellation states under infrastructure control.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.INFRASTRUCTURE,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'JobExecutionSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'jobExecution_ResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'JOB_EXECUTIONS',\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 expiresAt: schemaShape.expiresAt.dateSpec({ meaning: 'Cleanup deadline. Ordinary queue history expires after 30 days; unresolved scheduled claims have no deadline and cannot disappear while their effects remain uncertain.' }),\n scheduledState: schemaShape.scheduledState.objectSpec({ meaning: 'Durable scheduled occurrence ownership, captured recovery contract, bounded attempt history and attributed operator resolutions. Its revision arbitrates all execution and recovery transitions.' }),\n minionName: schemaShape.minionName.stringSpec({ meaning: 'Exact local minion target for a scheduled tick. Application and queue ownership are verified before receipt is persisted.' }),\n jobId: schemaShape.jobId.stringSpec({\n meaning: 'Stable operational identifier for one job execution.',\n whyItMatters: 'It is the main anchor used by operators and infrastructure services to correlate one execution across logs, retries, and storage.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n jobType: schemaShape.jobType.enumSpec({\n meaning: 'Classifies which family of background capability this execution belongs to.',\n whyItMatters: 'It distinguishes what kind of business or platform work is being performed so operators can reason about volume, ownership, and failure posture.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'JobType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [JobType.RESOURCE_OPERATION]: { meaning: 'Asynchronous execution of a resource operation or workflow step.' },\n [JobType.CUSTOM_BATCH]: { meaning: 'Batch-style work defined outside the default CRUD operation families.' },\n [JobType.SCHEDULED_CRON]: { meaning: 'Platform-scheduled recurring work triggered by a cron definition.' },\n [JobType.MINION_TICK]: { meaning: 'Cron-driven minion tick published to its dedicated minion queue when a minion’s cron schedule fires; consumed by the minion runtime that owns the matching `minionName`.' },\n },\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Current execution state of the queued job.',\n whyItMatters: 'It is the primary operational signal for knowing whether work is still pending, progressing, completed, or needs intervention.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'JobExecutionStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [JobExecutionStatus.PENDING]: { meaning: 'Accepted but not yet queued for processing.' },\n [JobExecutionStatus.QUEUED]: { meaning: 'Waiting in the queue for worker pickup.' },\n [JobExecutionStatus.PROCESSING]: { meaning: 'Actively executing on a worker.' },\n [JobExecutionStatus.COMPLETED]: { meaning: 'Finished successfully.' },\n [JobExecutionStatus.FAILED]: { meaning: 'Execution finished unsuccessfully and currently stands in a failed state.' },\n [JobExecutionStatus.RETRYING]: { meaning: 'A previous attempt failed and the platform is scheduling or running another attempt.' },\n [JobExecutionStatus.DEAD_LETTER]: { meaning: 'The job exhausted its recovery path and has been isolated for operator attention.' },\n [JobExecutionStatus.CANCELLED]: { meaning: 'Execution was intentionally stopped before successful completion.' },\n },\n }),\n\n initiatedBy: schemaShape.initiatedBy.enumSpec({\n meaning: 'Who or what caused this job execution to exist.',\n whyItMatters: 'It helps operators separate human-triggered work from system-initiated automation when investigating behavior.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'JobInitiator',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [JobInitiator.API]: { meaning: 'Created from an API-triggered action.' },\n [JobInitiator.CRONTAB]: { meaning: 'Created by scheduled recurring automation.' },\n [JobInitiator.INTERNAL]: { meaning: 'Created internally by platform/service orchestration.' },\n },\n }),\n\n priority: schemaShape.priority.enumSpec({\n meaning: 'Operational urgency level for queue scheduling.',\n whyItMatters: 'It influences how infrastructure should treat this work relative to other queued executions.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'JobPriority',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [JobPriority.LOW]: { meaning: 'Background work that can wait.' },\n [JobPriority.NORMAL]: { meaning: 'Standard priority for ordinary asynchronous tasks.' },\n [JobPriority.HIGH]: { meaning: 'Important work that should be processed sooner than normal tasks.' },\n [JobPriority.CRITICAL]: { meaning: 'Top-priority work whose delay could materially harm platform behavior.' },\n },\n }),\n\n operationPathKey: schemaShape.operationPathKey.stringSpec({\n meaning: 'Links the execution to the underlying resource operation path that spawned it.',\n whyItMatters: 'It ties low-level job processing back to the higher-level product or platform action that caused the asynchronous work.',\n semanticRole: 'code',\n }),\n\n batchRef: schemaShape.batchRef.stringSpec({\n meaning: 'Reference of the registered custom batch implementation.',\n whyItMatters: 'It identifies the handler that owns this occurrence; distinct scheduled occurrences have distinct job IDs.',\n semanticRole: 'identifier',\n }),\n\n organizationId: schemaShape.organizationId.foreignKeySpec({\n meaning: 'The `organizations` record that owns the tenant context this execution ran under, captured from the initiating execution context.',\n whyItMatters: 'It lets operators filter and isolate the execution ledger per tenant when triaging or reporting on background work.',\n }),\n\n userId: schemaShape.userId.foreignKeySpec({\n meaning: 'The `users` record that initiated the work, when a human principal (rather than a system process) caused the execution.',\n whyItMatters: 'It attributes background work to the initiating user for accountability and per-actor investigation; absent for system-initiated jobs.',\n }),\n\n inputPayloadStorageId: schemaShape.inputPayloadStorageId.foreignKeySpec({\n meaning: 'The `jobPayloadStorage` record holding the serialized INPUT arguments when the payload was spilled out of the queue envelope for size.',\n whyItMatters: 'It lets the worker rehydrate the exact input arguments this execution ran with, for processing, replay, and troubleshooting.',\n }),\n\n outputPayloadStorageId: schemaShape.outputPayloadStorageId.foreignKeySpec({\n meaning: 'The `jobPayloadStorage` record holding the serialized OUTPUT/result of the execution when the result was spilled to storage rather than kept inline.',\n whyItMatters: 'It lets downstream consumers and operators retrieve the produced result of a completed execution without overloading the queue envelope.',\n }),\n },\n\n operations: {\n [Op.DELETE_MANY]: {\n purpose: 'Internal bounded retention cleanup of expired rows; no public deletion route.',\n outcome: 'The scheduled retention sweep can delete its selected expired batch through the declared repository operation.',\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Create a new job execution record.',\n outcome: 'The platform begins tracking one asynchronous work item as a first-class execution row.',\n responseStatuses: [\n { 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.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The execution payload fails schema validation (e.g. an unknown `jobType`, missing `status`, or malformed correlation fields).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-infrastructure caller attempts to register a job — execution rows are created only by the queue/runtime layer through the internal repository service.' },\n ],\n idempotent: false,\n variants: {\n [JobExecutionVariantKey.INTERNAL]: {\n purpose: 'Allow internal infrastructure services to register a job before queue processing begins.',\n whenToUse: 'Use when the queue/runtime layer needs to persist a new execution as part of internal orchestration.',\n },\n },\n },\n\n [Op.READ]: {\n purpose: 'Read one job execution record.',\n outcome: 'The caller can inspect the current tracked state of a specific asynchronous execution.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The job execution record for the supplied `jobId` was found and its tracked lifecycle state is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No job execution row exists for the supplied `jobId` (never created, or already purged by retention).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an operator/infrastructure principal — this ledger is internal-only and not exposed to ordinary tenant callers.' },\n ],\n idempotent: true,\n variants: {\n [JobExecutionVariantKey.INTERNAL]: {\n purpose: 'Allow internal infrastructure services to resolve one execution during queue handling or observability flows.',\n },\n },\n },\n\n [Op.UPDATE]: {\n purpose: 'Advance or correct the tracked state of a job execution.',\n outcome: 'The platform’s operational truth about the execution stays synchronized with the actual runtime lifecycle.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { 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.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No job execution row exists for the supplied `jobId` to advance.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The lifecycle patch fails schema validation (e.g. an unrecognized `status` value).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-infrastructure caller attempts to mutate execution state.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The requested transition is illegal for the row’s current state (e.g. moving a `COMPLETED`/`CANCELLED` terminal row back to `PROCESSING`).' },\n ],\n idempotent: true,\n variants: {\n [JobExecutionVariantKey.INTERNAL]: {\n purpose: 'Allow infrastructure services to record status changes, timing, retries, payload references, and errors.',\n whenToUse: 'Use whenever the worker/runtime layer needs to persist a lifecycle transition for a running or finished job.',\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate job execution records.',\n outcome: 'The caller can inspect a set of executions instead of one isolated row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of job execution records in the requested scope.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not an operator/infrastructure principal authorized to enumerate the execution ledger.' },\n ],\n idempotent: true,\n variants: {\n [JobExecutionVariantKey.INTERNAL]: {\n purpose: 'Allow internal operational tooling or services to inspect batches of executions.',\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Filter and search job execution history.',\n outcome: 'Operators or infrastructure flows can narrow execution history to the subset relevant for troubleshooting or reporting.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of executions matching the status / type / initiator / correlation filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the operator/infrastructure role required to query the execution ledger.' },\n ],\n idempotent: true,\n variants: {\n [JobExecutionVariantKey.INTERNAL]: {\n purpose: 'Allow internal operational search across status, type, initiator, queue, and correlation fields.',\n whenToUse: 'Use when observability, support, or queue-control workflows need targeted execution lookup rather than raw enumeration.',\n },\n },\n },\n },\n\n businessConstraints: [\n 'This resource is an infrastructure execution ledger, not the source of truth for the business entity that caused the job.',\n 'Job execution rows should remain focused on runtime lifecycle, correlation, and troubleshooting semantics rather than becoming a generic dumping ground for arbitrary payload data.',\n 'The dominant consumer posture is operational and internal, even if later tooling surfaces selected projections to administrators.',\n ],\n }),\n // Phase 4.5 Step 2 (F-1): explicit scope declaration. JOB_EXECUTIONS is\n // a STANDALONE infrastructure ledger (the `APPLICATION → JOB_EXECUTIONS`\n // relationship in `resources-registry.shared.core.definitions.ts` uses\n // `accessScopeStrategy: STANDALONE`, intentionally bypassing scope-based\n // access control because access is internal-only via repository services\n // with INTERNAL variants). There is no m2m channel × scope surface to\n // protect because the resource carries no m2m blocks (verified —\n // operational/internal spec), so the declaration's only live consumer is\n // the spec ↔ registry alignment guard. The registry factory has NO silent\n // scope fallback (it throws without a derivation signal — see\n // `primary-scope-no-fallback.test.ts`); it derives APPLICATION from the\n // `isPrimaryScope: true` flag on the `APPLICATION → JOB_EXECUTIONS` rel.\n // An earlier revision declared ORGANIZATIONS on the (incorrect) assumption\n // of an ORGANIZATIONS fallback for STANDALONE resources; corrected\n // 2026-07-02 when the companion alignment guard started pairing engine\n // specs with materialized core configs and flagged the drift.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
@@ -14,8 +14,9 @@ export declare const jobPayloadStorageResourceSpecification: import("../../../_c
14
14
  applicationId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
15
15
  payloadJson: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>;
16
16
  scheduledEvidence: import("zod").ZodOptional<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodObject<{
17
- operationPathKey: import("zod").ZodOptional<import("zod").ZodString>;
17
+ expiresAt: import("zod").ZodDate;
18
18
  applicationId: import("zod").ZodString;
19
+ operationPathKey: import("zod").ZodOptional<import("zod").ZodString>;
19
20
  jobId: import("zod").ZodUUID;
20
21
  queueName: import("zod").ZodString;
21
22
  jobType: import("zod").ZodEnum<typeof import("@wildo-ai/saas-models").JobType>;
@@ -25,7 +26,6 @@ export declare const jobPayloadStorageResourceSpecification: import("../../../_c
25
26
  publishedAt: import("zod").ZodDate;
26
27
  startedAt: import("zod").ZodOptional<import("zod").ZodDate>;
27
28
  completedAt: import("zod").ZodDate;
28
- expiresAt: import("zod").ZodDate;
29
29
  invocationStatus: import("zod").ZodEnum<typeof import("@wildo-ai/saas-models").JobExecutionStatus>;
30
30
  source: import("zod").ZodEnum<typeof import("@wildo-ai/saas-models").ScheduledEvidenceSource>;
31
31
  attemptCount: import("zod").ZodNumber;
@@ -99,7 +99,7 @@ export const jobPayloadStorageResourceSpecification = resourceSpecification(jobP
99
99
  { code: HttpResponseStatusCode.CREATED_201, meaning: 'The payload blob was persisted and a `storageId` pointer is returned for embedding in the queue message. Internal/service write path — the `INTERNAL` variant is `REPOSITORY_ONLY`, never a public tenant create.' },
100
100
  ],
101
101
  errorScenarios: [
102
- { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload envelope fails schema validation (e.g. missing `applicationId` or an unserializable body).', errorCode: 'VALIDATION_FAILED' },
102
+ { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload envelope fails schema validation (e.g. missing `applicationId` or an unserializable body).' },
103
103
  { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A non-service caller attempts to write a payload blob — only the worker/spill-over service role may store payloads.' },
104
104
  ],
105
105
  idempotent: false,