@wildo-ai/saas-specifications 1.1.9 → 1.1.11

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 (928) hide show
  1. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts +5 -4
  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 +5 -4
  4. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.js.map +1 -1
  5. package/dist/esm/_catalogs/schema-org/index.js +1 -1
  6. package/dist/esm/_core/application-maturity/application-maturity.schemas.js +1 -1
  7. package/dist/esm/_core/application-maturity/application-maturity.schemas.js.map +1 -1
  8. package/dist/esm/_core/application-specification-family-identity.schemas.d.ts +11 -0
  9. package/dist/esm/_core/application-specification-family-identity.schemas.d.ts.map +1 -1
  10. package/dist/esm/_core/application-specification-family-identity.schemas.js +11 -0
  11. package/dist/esm/_core/application-specification-family-identity.schemas.js.map +1 -1
  12. package/dist/esm/_core/brand/brand-name-choice.d.ts +72 -10
  13. package/dist/esm/_core/brand/brand-name-choice.d.ts.map +1 -1
  14. package/dist/esm/_core/brand/brand-name-choice.js +144 -24
  15. package/dist/esm/_core/brand/brand-name-choice.js.map +1 -1
  16. package/dist/esm/_core/brand/brand-name-screening-generation.schemas.d.ts +41 -1
  17. package/dist/esm/_core/brand/brand-name-screening-generation.schemas.d.ts.map +1 -1
  18. package/dist/esm/_core/brand/brand-name-screening-generation.schemas.js +19 -3
  19. package/dist/esm/_core/brand/brand-name-screening-generation.schemas.js.map +1 -1
  20. package/dist/esm/_core/brand/brand-name-screening-validation.d.ts +7 -1
  21. package/dist/esm/_core/brand/brand-name-screening-validation.d.ts.map +1 -1
  22. package/dist/esm/_core/brand/brand-name-screening-validation.js +24 -3
  23. package/dist/esm/_core/brand/brand-name-screening-validation.js.map +1 -1
  24. package/dist/esm/_core/brand/brand-name-screening-view.d.ts +61 -9
  25. package/dist/esm/_core/brand/brand-name-screening-view.d.ts.map +1 -1
  26. package/dist/esm/_core/brand/brand-name-screening-view.js +42 -1
  27. package/dist/esm/_core/brand/brand-name-screening-view.js.map +1 -1
  28. package/dist/esm/_core/brand/brand-name-screening.schemas.d.ts +130 -2
  29. package/dist/esm/_core/brand/brand-name-screening.schemas.d.ts.map +1 -1
  30. package/dist/esm/_core/brand/brand-name-screening.schemas.js +165 -3
  31. package/dist/esm/_core/brand/brand-name-screening.schemas.js.map +1 -1
  32. package/dist/esm/_core/brand/brand-visual-tone.schemas.d.ts +25 -7
  33. package/dist/esm/_core/brand/brand-visual-tone.schemas.d.ts.map +1 -1
  34. package/dist/esm/_core/brand/brand-visual-tone.schemas.js +26 -8
  35. package/dist/esm/_core/brand/brand-visual-tone.schemas.js.map +1 -1
  36. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts +76 -0
  37. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts.map +1 -1
  38. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts +7 -2
  39. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts.map +1 -1
  40. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js +21 -3
  41. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js.map +1 -1
  42. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts +411 -13
  43. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts.map +1 -1
  44. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.js +281 -8
  45. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.js.map +1 -1
  46. package/dist/esm/_core/build-plan/build-plan.family-aspects.js +1 -1
  47. package/dist/esm/_core/build-plan/build-plan.family-aspects.js.map +1 -1
  48. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.d.ts +4 -0
  49. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.d.ts.map +1 -1
  50. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js +3 -0
  51. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js.map +1 -1
  52. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts +6 -0
  53. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts.map +1 -1
  54. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.js +20 -0
  55. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.js.map +1 -1
  56. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot.schemas.d.ts +1 -0
  57. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot.schemas.d.ts.map +1 -1
  58. package/dist/esm/_core/business-model-lite/pricing-plan.schemas.d.ts +1 -0
  59. package/dist/esm/_core/business-model-lite/pricing-plan.schemas.d.ts.map +1 -1
  60. package/dist/esm/_core/business-model-lite/pricing-plan.schemas.js +7 -0
  61. package/dist/esm/_core/business-model-lite/pricing-plan.schemas.js.map +1 -1
  62. package/dist/esm/_core/capability-composition/capability-composition.schemas.d.ts +4 -3
  63. package/dist/esm/_core/capability-composition/capability-composition.schemas.d.ts.map +1 -1
  64. package/dist/esm/_core/capability-composition/capability-composition.schemas.js +4 -3
  65. package/dist/esm/_core/capability-composition/capability-composition.schemas.js.map +1 -1
  66. package/dist/esm/_core/compliance-documents/ai-document-facts.schemas.d.ts +265 -0
  67. package/dist/esm/_core/compliance-documents/ai-document-facts.schemas.d.ts.map +1 -0
  68. package/dist/esm/_core/compliance-documents/ai-document-facts.schemas.js +371 -0
  69. package/dist/esm/_core/compliance-documents/ai-document-facts.schemas.js.map +1 -0
  70. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.d.ts +55 -5
  71. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.d.ts.map +1 -1
  72. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.js +66 -2
  73. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.js.map +1 -1
  74. package/dist/esm/_core/compliance-documents/launch-blockers.schemas.d.ts +42 -2
  75. package/dist/esm/_core/compliance-documents/launch-blockers.schemas.d.ts.map +1 -1
  76. package/dist/esm/_core/compliance-documents/launch-blockers.schemas.js +174 -1
  77. package/dist/esm/_core/compliance-documents/launch-blockers.schemas.js.map +1 -1
  78. package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts +4 -1
  79. package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts.map +1 -1
  80. package/dist/esm/_core/compliance-documents/processor-register.schemas.js +10 -1
  81. package/dist/esm/_core/compliance-documents/processor-register.schemas.js.map +1 -1
  82. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.d.ts +102 -10
  83. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.d.ts.map +1 -1
  84. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.js +128 -25
  85. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.js.map +1 -1
  86. package/dist/esm/_core/compliance-documents/recipient-population.schemas.d.ts +28 -0
  87. package/dist/esm/_core/compliance-documents/recipient-population.schemas.d.ts.map +1 -1
  88. package/dist/esm/_core/compliance-documents/recipient-population.schemas.js +36 -1
  89. package/dist/esm/_core/compliance-documents/recipient-population.schemas.js.map +1 -1
  90. package/dist/esm/_core/compliance-documents/required-document-set.schemas.d.ts +15 -0
  91. package/dist/esm/_core/compliance-documents/required-document-set.schemas.d.ts.map +1 -1
  92. package/dist/esm/_core/compliance-documents/required-document-set.schemas.js +15 -0
  93. package/dist/esm/_core/compliance-documents/required-document-set.schemas.js.map +1 -1
  94. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.d.ts +21 -10
  95. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.d.ts.map +1 -1
  96. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.js +130 -14
  97. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.js.map +1 -1
  98. package/dist/esm/_core/data-seed-specification.schemas.d.ts.map +1 -1
  99. package/dist/esm/_core/data-seed-specification.schemas.js +5 -1
  100. package/dist/esm/_core/data-seed-specification.schemas.js.map +1 -1
  101. package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.d.ts +32 -1
  102. package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.d.ts.map +1 -1
  103. package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.js +41 -1
  104. package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.js.map +1 -1
  105. package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.d.ts +33 -1
  106. package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.d.ts.map +1 -1
  107. package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.js +134 -9
  108. package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.js.map +1 -1
  109. package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.d.ts +117 -0
  110. package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.d.ts.map +1 -1
  111. package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.js +118 -0
  112. package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.js.map +1 -1
  113. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts +1 -0
  114. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -1
  115. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js +22 -1
  116. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js.map +1 -1
  117. package/dist/esm/_core/experience-plan/experience-plan-generation.schemas.d.ts +17 -1
  118. package/dist/esm/_core/experience-plan/experience-plan-generation.schemas.d.ts.map +1 -1
  119. package/dist/esm/_core/experience-plan/experience-plan-generation.schemas.js +21 -5
  120. package/dist/esm/_core/experience-plan/experience-plan-generation.schemas.js.map +1 -1
  121. package/dist/esm/_core/experience-plan/experience-plan-validation.d.ts +7 -1
  122. package/dist/esm/_core/experience-plan/experience-plan-validation.d.ts.map +1 -1
  123. package/dist/esm/_core/experience-plan/experience-plan-validation.js +39 -1
  124. package/dist/esm/_core/experience-plan/experience-plan-validation.js.map +1 -1
  125. package/dist/esm/_core/experience-plan/experience-plan.family-aspects.d.ts.map +1 -1
  126. package/dist/esm/_core/experience-plan/experience-plan.family-aspects.js +31 -5
  127. package/dist/esm/_core/experience-plan/experience-plan.family-aspects.js.map +1 -1
  128. package/dist/esm/_core/experience-plan/experience-plan.schemas.d.ts +81 -9
  129. package/dist/esm/_core/experience-plan/experience-plan.schemas.d.ts.map +1 -1
  130. package/dist/esm/_core/experience-plan/experience-plan.schemas.js +88 -7
  131. package/dist/esm/_core/experience-plan/experience-plan.schemas.js.map +1 -1
  132. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts +13 -6
  133. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts.map +1 -1
  134. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js +13 -6
  135. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js.map +1 -1
  136. package/dist/esm/_core/family-aspects.registry.d.ts.map +1 -1
  137. package/dist/esm/_core/family-aspects.registry.js +2 -0
  138. package/dist/esm/_core/family-aspects.registry.js.map +1 -1
  139. package/dist/esm/_core/family-aspects.schemas.d.ts +24 -0
  140. package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -1
  141. package/dist/esm/_core/family-aspects.schemas.js +20 -0
  142. package/dist/esm/_core/family-aspects.schemas.js.map +1 -1
  143. package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +6 -6
  144. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.js +2 -2
  145. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.js.map +1 -1
  146. package/dist/esm/_core/index.d.ts +6 -0
  147. package/dist/esm/_core/index.d.ts.map +1 -1
  148. package/dist/esm/_core/index.js +6 -0
  149. package/dist/esm/_core/index.js.map +1 -1
  150. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.d.ts +1 -0
  151. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.d.ts.map +1 -1
  152. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.d.ts.map +1 -1
  153. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.js +2 -1
  154. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.js.map +1 -1
  155. package/dist/esm/_core/integration-plan/integration-plan.schemas.d.ts +26 -2
  156. package/dist/esm/_core/integration-plan/integration-plan.schemas.d.ts.map +1 -1
  157. package/dist/esm/_core/integration-plan/integration-plan.schemas.js +21 -1
  158. package/dist/esm/_core/integration-plan/integration-plan.schemas.js.map +1 -1
  159. package/dist/esm/_core/market/market-references.schemas.d.ts +7 -0
  160. package/dist/esm/_core/market/market-references.schemas.d.ts.map +1 -1
  161. package/dist/esm/_core/market/market-references.schemas.js +13 -1
  162. package/dist/esm/_core/market/market-references.schemas.js.map +1 -1
  163. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +18 -12
  164. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts.map +1 -1
  165. package/dist/esm/_core/market/market-snapshot-generation.schemas.js +46 -17
  166. package/dist/esm/_core/market/market-snapshot-generation.schemas.js.map +1 -1
  167. package/dist/esm/_core/market/market.family-aspects.d.ts.map +1 -1
  168. package/dist/esm/_core/market/market.family-aspects.js +4 -1
  169. package/dist/esm/_core/market/market.family-aspects.js.map +1 -1
  170. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.d.ts +15 -3
  171. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.d.ts.map +1 -1
  172. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js +6 -3
  173. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js.map +1 -1
  174. package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts +12 -1
  175. package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts.map +1 -1
  176. package/dist/esm/_core/placement-plan/placement-plan-validation.js +56 -3
  177. package/dist/esm/_core/placement-plan/placement-plan-validation.js.map +1 -1
  178. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.d.ts.map +1 -1
  179. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.js +9 -0
  180. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.js.map +1 -1
  181. package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts +83 -0
  182. package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
  183. package/dist/esm/_core/placement-plan/placement-plan.schemas.js +102 -2
  184. package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
  185. package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts +3 -2
  186. package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts.map +1 -1
  187. package/dist/esm/_core/requirements/functional-requirement.schemas.js +8 -2
  188. package/dist/esm/_core/requirements/functional-requirement.schemas.js.map +1 -1
  189. package/dist/esm/_core/requirements/non-functional-requirement.schemas.d.ts +1 -0
  190. package/dist/esm/_core/requirements/non-functional-requirement.schemas.d.ts.map +1 -1
  191. package/dist/esm/_core/requirements/non-functional-requirement.schemas.js +2 -0
  192. package/dist/esm/_core/requirements/non-functional-requirement.schemas.js.map +1 -1
  193. package/dist/esm/_core/requirements/requirements-pain-coverage.d.ts +41 -0
  194. package/dist/esm/_core/requirements/requirements-pain-coverage.d.ts.map +1 -0
  195. package/dist/esm/_core/requirements/requirements-pain-coverage.js +63 -0
  196. package/dist/esm/_core/requirements/requirements-pain-coverage.js.map +1 -0
  197. package/dist/esm/_core/requirements/requirements-references.schemas.d.ts +1 -1
  198. package/dist/esm/_core/requirements/requirements-references.schemas.js +1 -1
  199. package/dist/esm/_core/requirements/requirements-references.schemas.js.map +1 -1
  200. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.d.ts +16 -0
  201. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.d.ts.map +1 -1
  202. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js +12 -1
  203. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js.map +1 -1
  204. package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts +13 -2
  205. package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts.map +1 -1
  206. package/dist/esm/_core/requirements/requirements-snapshot-validation.js +32 -1
  207. package/dist/esm/_core/requirements/requirements-snapshot-validation.js.map +1 -1
  208. package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts +65 -1
  209. package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts.map +1 -1
  210. package/dist/esm/_core/requirements/requirements-snapshot.schemas.js +53 -1
  211. package/dist/esm/_core/requirements/requirements-snapshot.schemas.js.map +1 -1
  212. package/dist/esm/_core/requirements/requirements.family-aspects.d.ts.map +1 -1
  213. package/dist/esm/_core/requirements/requirements.family-aspects.js +2 -0
  214. package/dist/esm/_core/requirements/requirements.family-aspects.js.map +1 -1
  215. package/dist/esm/_core/resource-specification.schemas.d.ts +56 -15
  216. package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
  217. package/dist/esm/_core/resource-specification.schemas.js +73 -13
  218. package/dist/esm/_core/resource-specification.schemas.js.map +1 -1
  219. package/dist/esm/_core/roadmap/roadmap-phase.schemas.d.ts +1 -16
  220. package/dist/esm/_core/roadmap/roadmap-phase.schemas.d.ts.map +1 -1
  221. package/dist/esm/_core/roadmap/roadmap-phase.schemas.js +3 -17
  222. package/dist/esm/_core/roadmap/roadmap-phase.schemas.js.map +1 -1
  223. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.d.ts +2 -1
  224. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.d.ts.map +1 -1
  225. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js +2 -1
  226. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js.map +1 -1
  227. package/dist/esm/_core/roadmap/roadmap-snapshot.schemas.d.ts +1 -1
  228. package/dist/esm/_core/service-method/service-method-derivation.d.ts +155 -0
  229. package/dist/esm/_core/service-method/service-method-derivation.d.ts.map +1 -0
  230. package/dist/esm/_core/service-method/service-method-derivation.js +410 -0
  231. package/dist/esm/_core/service-method/service-method-derivation.js.map +1 -0
  232. package/dist/esm/_core/service-method/service-method-generation.schemas.d.ts +86 -0
  233. package/dist/esm/_core/service-method/service-method-generation.schemas.d.ts.map +1 -0
  234. package/dist/esm/_core/service-method/service-method-generation.schemas.js +28 -0
  235. package/dist/esm/_core/service-method/service-method-generation.schemas.js.map +1 -0
  236. package/dist/esm/_core/service-method/service-method-validation.d.ts +35 -0
  237. package/dist/esm/_core/service-method/service-method-validation.d.ts.map +1 -0
  238. package/dist/esm/_core/service-method/service-method-validation.js +75 -0
  239. package/dist/esm/_core/service-method/service-method-validation.js.map +1 -0
  240. package/dist/esm/_core/service-method/service-method.family-aspects.d.ts +3 -0
  241. package/dist/esm/_core/service-method/service-method.family-aspects.d.ts.map +1 -0
  242. package/dist/esm/_core/service-method/service-method.family-aspects.js +59 -0
  243. package/dist/esm/_core/service-method/service-method.family-aspects.js.map +1 -0
  244. package/dist/esm/_core/service-method/service-method.schemas.d.ts +385 -0
  245. package/dist/esm/_core/service-method/service-method.schemas.d.ts.map +1 -0
  246. package/dist/esm/_core/service-method/service-method.schemas.js +372 -0
  247. package/dist/esm/_core/service-method/service-method.schemas.js.map +1 -0
  248. package/dist/esm/_core/website-plan/website-plan-generation.schemas.d.ts +37 -5
  249. package/dist/esm/_core/website-plan/website-plan-generation.schemas.d.ts.map +1 -1
  250. package/dist/esm/_core/website-plan/website-plan-generation.schemas.js +34 -6
  251. package/dist/esm/_core/website-plan/website-plan-generation.schemas.js.map +1 -1
  252. package/dist/esm/_core/website-plan/website-plan-validation.d.ts +29 -3
  253. package/dist/esm/_core/website-plan/website-plan-validation.d.ts.map +1 -1
  254. package/dist/esm/_core/website-plan/website-plan-validation.js +97 -5
  255. package/dist/esm/_core/website-plan/website-plan-validation.js.map +1 -1
  256. package/dist/esm/_core/website-plan/website-plan.family-aspects.d.ts.map +1 -1
  257. package/dist/esm/_core/website-plan/website-plan.family-aspects.js +6 -1
  258. package/dist/esm/_core/website-plan/website-plan.family-aspects.js.map +1 -1
  259. package/dist/esm/_core/website-plan/website-plan.schemas.d.ts +521 -15
  260. package/dist/esm/_core/website-plan/website-plan.schemas.d.ts.map +1 -1
  261. package/dist/esm/_core/website-plan/website-plan.schemas.js +703 -23
  262. package/dist/esm/_core/website-plan/website-plan.schemas.js.map +1 -1
  263. package/dist/esm/application-creation/accepted-change-attribution.application-creation.schemas.d.ts +78 -0
  264. package/dist/esm/application-creation/accepted-change-attribution.application-creation.schemas.d.ts.map +1 -0
  265. package/dist/esm/application-creation/accepted-change-attribution.application-creation.schemas.js +92 -0
  266. package/dist/esm/application-creation/accepted-change-attribution.application-creation.schemas.js.map +1 -0
  267. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.d.ts +26 -0
  268. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.d.ts.map +1 -1
  269. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.js +14 -0
  270. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.js.map +1 -1
  271. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +21 -5
  272. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
  273. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +22 -4
  274. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
  275. package/dist/esm/application-creation/application-line.application-creation.schemas.d.ts +119 -10
  276. package/dist/esm/application-creation/application-line.application-creation.schemas.d.ts.map +1 -1
  277. package/dist/esm/application-creation/application-line.application-creation.schemas.js +140 -7
  278. package/dist/esm/application-creation/application-line.application-creation.schemas.js.map +1 -1
  279. package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.d.ts +7 -1
  280. package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.d.ts.map +1 -1
  281. package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.js +7 -1
  282. package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.js.map +1 -1
  283. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts +4 -2
  284. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
  285. package/dist/esm/application-creation/journey.application-creation.schemas.js +4 -2
  286. package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
  287. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +103 -15
  288. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
  289. package/dist/esm/application-creation/playbooks.application-creation.schemas.js +151 -21
  290. package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
  291. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts +1 -0
  292. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts.map +1 -1
  293. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.js +1 -0
  294. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.js.map +1 -1
  295. package/dist/esm/application-creation.exports.d.ts +7 -0
  296. package/dist/esm/application-creation.exports.d.ts.map +1 -1
  297. package/dist/esm/application-creation.exports.js +7 -0
  298. package/dist/esm/application-creation.exports.js.map +1 -1
  299. package/dist/esm/assurance/application-risk-signals.derivations.d.ts +36 -2
  300. package/dist/esm/assurance/application-risk-signals.derivations.d.ts.map +1 -1
  301. package/dist/esm/assurance/application-risk-signals.derivations.js +52 -4
  302. package/dist/esm/assurance/application-risk-signals.derivations.js.map +1 -1
  303. package/dist/esm/assurance/assurance-assessment-twins.d.ts +38 -0
  304. package/dist/esm/assurance/assurance-assessment-twins.d.ts.map +1 -0
  305. package/dist/esm/assurance/assurance-assessment-twins.js +36 -0
  306. package/dist/esm/assurance/assurance-assessment-twins.js.map +1 -0
  307. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +608 -9
  308. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
  309. package/dist/esm/assurance/assurance-authority-basis.definitions.js +2962 -1078
  310. package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
  311. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +15 -0
  312. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
  313. package/dist/esm/assurance/assurance-authority-basis.schemas.js +1 -0
  314. package/dist/esm/assurance/assurance-authority-basis.schemas.js.map +1 -1
  315. package/dist/esm/assurance/assurance-document-system.definitions.d.ts +2 -0
  316. package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
  317. package/dist/esm/assurance/assurance-document-system.definitions.js +138 -19
  318. package/dist/esm/assurance/assurance-document-system.definitions.js.map +1 -1
  319. package/dist/esm/assurance/assurance-document-system.schemas.d.ts +65 -0
  320. package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
  321. package/dist/esm/assurance/assurance-document-system.schemas.js +13 -0
  322. package/dist/esm/assurance/assurance-document-system.schemas.js.map +1 -1
  323. package/dist/esm/assurance/assurance-evidence-judgement.schemas.d.ts +81 -6
  324. package/dist/esm/assurance/assurance-evidence-judgement.schemas.d.ts.map +1 -1
  325. package/dist/esm/assurance/assurance-evidence-judgement.schemas.js +68 -7
  326. package/dist/esm/assurance/assurance-evidence-judgement.schemas.js.map +1 -1
  327. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts.map +1 -1
  328. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js +1631 -70
  329. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -1
  330. package/dist/esm/assurance/assurance-host-implementation-artifacts.d.ts +77 -0
  331. package/dist/esm/assurance/assurance-host-implementation-artifacts.d.ts.map +1 -0
  332. package/dist/esm/assurance/assurance-host-implementation-artifacts.js +51 -0
  333. package/dist/esm/assurance/assurance-host-implementation-artifacts.js.map +1 -0
  334. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts +3 -2
  335. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
  336. package/dist/esm/assurance/assurance-objective-catalog.definitions.js +327 -3
  337. package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
  338. package/dist/esm/assurance/assurance-open-compliance-answer-cell.d.ts +12 -0
  339. package/dist/esm/assurance/assurance-open-compliance-answer-cell.d.ts.map +1 -0
  340. package/dist/esm/assurance/assurance-open-compliance-answer-cell.js +19 -0
  341. package/dist/esm/assurance/assurance-open-compliance-answer-cell.js.map +1 -0
  342. package/dist/esm/assurance/assurance-open-compliance-coverage-pack.d.ts +403 -0
  343. package/dist/esm/assurance/assurance-open-compliance-coverage-pack.d.ts.map +1 -0
  344. package/dist/esm/assurance/assurance-open-compliance-coverage-pack.js +825 -0
  345. package/dist/esm/assurance/assurance-open-compliance-coverage-pack.js.map +1 -0
  346. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +83 -8
  347. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -1
  348. package/dist/esm/assurance/assurance-program-generation.schemas.js +167 -20
  349. package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -1
  350. package/dist/esm/assurance/assurance-program.schemas.d.ts +234 -35
  351. package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
  352. package/dist/esm/assurance/assurance-program.schemas.js +255 -14
  353. package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
  354. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts +2 -1
  355. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
  356. package/dist/esm/assurance/assurance-source-registry.definitions.js +259 -18
  357. package/dist/esm/assurance/assurance-source-registry.definitions.js.map +1 -1
  358. package/dist/esm/assurance/assurance-source-requirement-inventory.definitions.d.ts +17 -0
  359. package/dist/esm/assurance/assurance-source-requirement-inventory.definitions.d.ts.map +1 -0
  360. package/dist/esm/assurance/assurance-source-requirement-inventory.definitions.js +216 -0
  361. package/dist/esm/assurance/assurance-source-requirement-inventory.definitions.js.map +1 -0
  362. package/dist/esm/assurance/assurance-sources.schemas.d.ts +110 -0
  363. package/dist/esm/assurance/assurance-sources.schemas.d.ts.map +1 -1
  364. package/dist/esm/assurance/assurance-sources.schemas.js +111 -1
  365. package/dist/esm/assurance/assurance-sources.schemas.js.map +1 -1
  366. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts.map +1 -1
  367. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js +356 -5
  368. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -1
  369. package/dist/esm/assurance/governed-document-audience.derivations.d.ts +83 -0
  370. package/dist/esm/assurance/governed-document-audience.derivations.d.ts.map +1 -0
  371. package/dist/esm/assurance/governed-document-audience.derivations.js +97 -0
  372. package/dist/esm/assurance/governed-document-audience.derivations.js.map +1 -0
  373. package/dist/esm/assurance/governed-document-release.d.ts +15 -1
  374. package/dist/esm/assurance/governed-document-release.d.ts.map +1 -1
  375. package/dist/esm/assurance/governed-document-release.js +3 -1
  376. package/dist/esm/assurance/governed-document-release.js.map +1 -1
  377. package/dist/esm/assurance.exports.d.ts +4 -0
  378. package/dist/esm/assurance.exports.d.ts.map +1 -1
  379. package/dist/esm/assurance.exports.js +4 -0
  380. package/dist/esm/assurance.exports.js.map +1 -1
  381. package/dist/esm/companion-exports.d.ts +9 -1
  382. package/dist/esm/companion-exports.d.ts.map +1 -1
  383. package/dist/esm/companion-exports.js.map +1 -1
  384. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts +1 -1
  385. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
  386. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +33 -5
  387. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
  388. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map +1 -1
  389. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +9 -12
  390. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
  391. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts +1 -1
  392. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
  393. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +60 -6
  394. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
  395. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +4 -4
  396. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
  397. package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts +1 -0
  398. package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts.map +1 -1
  399. package/dist/esm/engine/applications/resources/applications.resource.specification.js +2 -2
  400. package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
  401. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts +12 -4
  402. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts.map +1 -1
  403. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js +46 -10
  404. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js.map +1 -1
  405. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts +3 -2
  406. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts.map +1 -1
  407. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +15 -4
  408. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
  409. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts +1 -1
  410. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
  411. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +40 -11
  412. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
  413. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts +1 -1
  414. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
  415. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +44 -3
  416. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
  417. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts +7 -3
  418. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -1
  419. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js +40 -8
  420. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -1
  421. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts +14 -8
  422. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts.map +1 -1
  423. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +72 -19
  424. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
  425. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts +2 -2
  426. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts.map +1 -1
  427. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +6 -6
  428. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
  429. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts +1 -0
  430. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts.map +1 -1
  431. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +14 -13
  432. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
  433. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.d.ts.map +1 -1
  434. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +2 -2
  435. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
  436. package/dist/esm/engine/auth/resources/siem-delivery-outbox.resource.specification.d.ts.map +1 -1
  437. package/dist/esm/engine/auth/resources/siem-delivery-outbox.resource.specification.js.map +1 -1
  438. package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
  439. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +68 -12
  440. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
  441. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
  442. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js +75 -19
  443. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js.map +1 -1
  444. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts +3 -1
  445. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts.map +1 -1
  446. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js +11 -7
  447. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js.map +1 -1
  448. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts +2 -0
  449. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
  450. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +2 -1
  451. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
  452. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts +4 -2
  453. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts.map +1 -1
  454. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +8 -7
  455. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
  456. package/dist/esm/engine/billing/resources/prices.resource.specification.js +1 -1
  457. package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
  458. package/dist/esm/engine/billing/resources/products.resource.specification.js +1 -1
  459. package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
  460. package/dist/esm/engine/billing/resources/promotions.resource.specification.js +1 -1
  461. package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
  462. package/dist/esm/engine/billing/resources/referrals.resource.specification.js +6 -6
  463. package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
  464. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts +2 -2
  465. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +1 -1
  466. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
  467. package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts +4 -0
  468. package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts.map +1 -1
  469. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +4 -1
  470. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
  471. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts +9 -5
  472. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts.map +1 -1
  473. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js +16 -8
  474. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js.map +1 -1
  475. package/dist/esm/engine/compliance/resources/approval-seals.resource.specification.d.ts +73 -0
  476. package/dist/esm/engine/compliance/resources/approval-seals.resource.specification.d.ts.map +1 -0
  477. package/dist/esm/engine/compliance/resources/approval-seals.resource.specification.js +192 -0
  478. package/dist/esm/engine/compliance/resources/approval-seals.resource.specification.js.map +1 -0
  479. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts +5 -3
  480. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts.map +1 -1
  481. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +19 -13
  482. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
  483. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.d.ts +11 -6
  484. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.d.ts.map +1 -1
  485. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.js +14 -3
  486. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.js.map +1 -1
  487. package/dist/esm/engine/compliance/resources/published-verification-keys.resource.specification.d.ts +37 -0
  488. package/dist/esm/engine/compliance/resources/published-verification-keys.resource.specification.d.ts.map +1 -0
  489. package/dist/esm/engine/compliance/resources/published-verification-keys.resource.specification.js +161 -0
  490. package/dist/esm/engine/compliance/resources/published-verification-keys.resource.specification.js.map +1 -0
  491. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.js +1 -1
  492. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.js.map +1 -1
  493. package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
  494. package/dist/esm/engine/engine-resource-specifications.registry.js +55 -11
  495. package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
  496. package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
  497. package/dist/esm/engine/errors/error-messages.specification.js +300 -5
  498. package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
  499. package/dist/esm/engine/features/core-limits.feature.specifications.d.ts +10 -4
  500. package/dist/esm/engine/features/core-limits.feature.specifications.d.ts.map +1 -1
  501. package/dist/esm/engine/features/core-limits.feature.specifications.js +100 -5
  502. package/dist/esm/engine/features/core-limits.feature.specifications.js.map +1 -1
  503. package/dist/esm/engine/features/custom-branding.feature.specification.d.ts.map +1 -1
  504. package/dist/esm/engine/features/custom-branding.feature.specification.js +7 -3
  505. package/dist/esm/engine/features/custom-branding.feature.specification.js.map +1 -1
  506. package/dist/esm/engine/features/index.d.ts +4 -2
  507. package/dist/esm/engine/features/index.d.ts.map +1 -1
  508. package/dist/esm/engine/features/index.js +6 -4
  509. package/dist/esm/engine/features/index.js.map +1 -1
  510. package/dist/esm/engine/features/resources/application-features.resource.specification.js +2 -2
  511. package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
  512. package/dist/esm/engine/features/resources/organization-features.resource.specification.d.ts.map +1 -1
  513. package/dist/esm/engine/features/resources/organization-features.resource.specification.js +34 -15
  514. package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
  515. package/dist/esm/engine/files/resources/files.resource.specification.d.ts +4 -1
  516. package/dist/esm/engine/files/resources/files.resource.specification.d.ts.map +1 -1
  517. package/dist/esm/engine/files/resources/files.resource.specification.js +24 -3
  518. package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
  519. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map +1 -1
  520. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js +31 -3
  521. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
  522. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +6 -6
  523. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
  524. package/dist/esm/engine/flows-actors/resources/actor-system-executions.resource.specification.d.ts +30 -0
  525. package/dist/esm/engine/flows-actors/resources/actor-system-executions.resource.specification.d.ts.map +1 -0
  526. package/dist/esm/engine/flows-actors/resources/actor-system-executions.resource.specification.js +181 -0
  527. package/dist/esm/engine/flows-actors/resources/actor-system-executions.resource.specification.js.map +1 -0
  528. package/dist/esm/engine/flows-actors/resources/actor-tasks.resource.specification.d.ts +3 -0
  529. package/dist/esm/engine/flows-actors/resources/actor-tasks.resource.specification.d.ts.map +1 -0
  530. package/dist/esm/engine/flows-actors/resources/actor-tasks.resource.specification.js +110 -0
  531. package/dist/esm/engine/flows-actors/resources/actor-tasks.resource.specification.js.map +1 -0
  532. package/dist/esm/engine/flows-actors/resources/agent-behavior-reports.resource.specification.d.ts +3 -0
  533. package/dist/esm/engine/flows-actors/resources/agent-behavior-reports.resource.specification.d.ts.map +1 -0
  534. package/dist/esm/engine/flows-actors/resources/agent-behavior-reports.resource.specification.js +286 -0
  535. package/dist/esm/engine/flows-actors/resources/agent-behavior-reports.resource.specification.js.map +1 -0
  536. package/dist/esm/engine/flows-actors/resources/agent-operation-records.resource.specification.d.ts +3 -0
  537. package/dist/esm/engine/flows-actors/resources/agent-operation-records.resource.specification.d.ts.map +1 -0
  538. package/dist/esm/engine/flows-actors/resources/agent-operation-records.resource.specification.js +147 -0
  539. package/dist/esm/engine/flows-actors/resources/agent-operation-records.resource.specification.js.map +1 -0
  540. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.d.ts.map +1 -1
  541. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.js +71 -26
  542. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.js.map +1 -1
  543. package/dist/esm/engine/flows-actors/resources/application-agent-policies.resource.specification.d.ts +3 -0
  544. package/dist/esm/engine/flows-actors/resources/application-agent-policies.resource.specification.d.ts.map +1 -0
  545. package/dist/esm/engine/flows-actors/resources/application-agent-policies.resource.specification.js +92 -0
  546. package/dist/esm/engine/flows-actors/resources/application-agent-policies.resource.specification.js.map +1 -0
  547. package/dist/esm/engine/flows-actors/resources/chat-conversations.resource.specification.d.ts +46 -0
  548. package/dist/esm/engine/flows-actors/resources/chat-conversations.resource.specification.d.ts.map +1 -0
  549. package/dist/esm/engine/flows-actors/resources/chat-conversations.resource.specification.js +196 -0
  550. package/dist/esm/engine/flows-actors/resources/chat-conversations.resource.specification.js.map +1 -0
  551. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts +73 -31
  552. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map +1 -1
  553. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +118 -18
  554. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
  555. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts +3 -0
  556. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
  557. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js +9 -4
  558. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js.map +1 -1
  559. package/dist/esm/engine/flows-actors/resources/human-decision-notice-stays.resource.specification.d.ts +3 -0
  560. package/dist/esm/engine/flows-actors/resources/human-decision-notice-stays.resource.specification.d.ts.map +1 -0
  561. package/dist/esm/engine/flows-actors/resources/human-decision-notice-stays.resource.specification.js +184 -0
  562. package/dist/esm/engine/flows-actors/resources/human-decision-notice-stays.resource.specification.js.map +1 -0
  563. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.d.ts.map +1 -1
  564. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.js +17 -5
  565. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.js.map +1 -1
  566. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.d.ts.map +1 -1
  567. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.js +47 -7
  568. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.js.map +1 -1
  569. package/dist/esm/engine/flows-actors/resources/model-usage-ceiling-state.resource.specification.d.ts +3 -0
  570. package/dist/esm/engine/flows-actors/resources/model-usage-ceiling-state.resource.specification.d.ts.map +1 -0
  571. package/dist/esm/engine/flows-actors/resources/model-usage-ceiling-state.resource.specification.js +118 -0
  572. package/dist/esm/engine/flows-actors/resources/model-usage-ceiling-state.resource.specification.js.map +1 -0
  573. package/dist/esm/engine/flows-actors/resources/operation-approval-requests.resource.specification.d.ts +3 -0
  574. package/dist/esm/engine/flows-actors/resources/operation-approval-requests.resource.specification.d.ts.map +1 -0
  575. package/dist/esm/engine/flows-actors/resources/operation-approval-requests.resource.specification.js +230 -0
  576. package/dist/esm/engine/flows-actors/resources/operation-approval-requests.resource.specification.js.map +1 -0
  577. package/dist/esm/engine/flows-actors/resources/organization-agent-policies.resource.specification.d.ts +3 -0
  578. package/dist/esm/engine/flows-actors/resources/organization-agent-policies.resource.specification.d.ts.map +1 -0
  579. package/dist/esm/engine/flows-actors/resources/organization-agent-policies.resource.specification.js +151 -0
  580. package/dist/esm/engine/flows-actors/resources/organization-agent-policies.resource.specification.js.map +1 -0
  581. package/dist/esm/engine/flows-actors/resources/organization-chat-settings.resource.specification.d.ts +23 -0
  582. package/dist/esm/engine/flows-actors/resources/organization-chat-settings.resource.specification.d.ts.map +1 -0
  583. package/dist/esm/engine/flows-actors/resources/organization-chat-settings.resource.specification.js +124 -0
  584. package/dist/esm/engine/flows-actors/resources/organization-chat-settings.resource.specification.js.map +1 -0
  585. package/dist/esm/engine/flows-actors/resources/person-token-ceiling-state.resource.specification.d.ts +3 -0
  586. package/dist/esm/engine/flows-actors/resources/person-token-ceiling-state.resource.specification.d.ts.map +1 -0
  587. package/dist/esm/engine/flows-actors/resources/person-token-ceiling-state.resource.specification.js +114 -0
  588. package/dist/esm/engine/flows-actors/resources/person-token-ceiling-state.resource.specification.js.map +1 -0
  589. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.d.ts.map +1 -1
  590. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.js +45 -3
  591. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.js.map +1 -1
  592. package/dist/esm/engine/frontend-components/actions/action-bar.frontend-component.specification.d.ts.map +1 -1
  593. package/dist/esm/engine/frontend-components/actions/action-bar.frontend-component.specification.js +6 -0
  594. package/dist/esm/engine/frontend-components/actions/action-bar.frontend-component.specification.js.map +1 -1
  595. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation-thread.frontend-component.specification.d.ts +4 -0
  596. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation-thread.frontend-component.specification.d.ts.map +1 -0
  597. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation-thread.frontend-component.specification.js +78 -0
  598. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation-thread.frontend-component.specification.js.map +1 -0
  599. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-prompt-input.frontend-component.specification.d.ts.map +1 -1
  600. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-prompt-input.frontend-component.specification.js +4 -4
  601. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-prompt-input.frontend-component.specification.js.map +1 -1
  602. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.js +3 -3
  603. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.js.map +1 -1
  604. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-canvas.frontend-component.specification.d.ts.map +1 -1
  605. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-canvas.frontend-component.specification.js +4 -4
  606. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-canvas.frontend-component.specification.js.map +1 -1
  607. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-node.frontend-component.specification.d.ts.map +1 -1
  608. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-node.frontend-component.specification.js +3 -3
  609. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-node.frontend-component.specification.js.map +1 -1
  610. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-evaluation-export-settings.frontend-component.specification.d.ts +5 -0
  611. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-evaluation-export-settings.frontend-component.specification.d.ts.map +1 -0
  612. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-evaluation-export-settings.frontend-component.specification.js +79 -0
  613. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-evaluation-export-settings.frontend-component.specification.js.map +1 -0
  614. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.js +2 -2
  615. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.js.map +1 -1
  616. package/dist/esm/engine/frontend-components/app/app-layout-autonomous-agents-settings.frontend-component.specification.d.ts +5 -0
  617. package/dist/esm/engine/frontend-components/app/app-layout-autonomous-agents-settings.frontend-component.specification.d.ts.map +1 -0
  618. package/dist/esm/engine/frontend-components/app/app-layout-autonomous-agents-settings.frontend-component.specification.js +79 -0
  619. package/dist/esm/engine/frontend-components/app/app-layout-autonomous-agents-settings.frontend-component.specification.js.map +1 -0
  620. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts.map +1 -1
  621. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js +3 -2
  622. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js.map +1 -1
  623. package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.js +3 -3
  624. package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.js.map +1 -1
  625. package/dist/esm/engine/frontend-components/app/app-layout-model-cost-breakdown-settings.frontend-component.specification.d.ts +5 -0
  626. package/dist/esm/engine/frontend-components/app/app-layout-model-cost-breakdown-settings.frontend-component.specification.d.ts.map +1 -0
  627. package/dist/esm/engine/frontend-components/app/app-layout-model-cost-breakdown-settings.frontend-component.specification.js +79 -0
  628. package/dist/esm/engine/frontend-components/app/app-layout-model-cost-breakdown-settings.frontend-component.specification.js.map +1 -0
  629. package/dist/esm/engine/frontend-components/app/app-layout-representative-activity-settings.frontend-component.specification.d.ts +5 -0
  630. package/dist/esm/engine/frontend-components/app/app-layout-representative-activity-settings.frontend-component.specification.d.ts.map +1 -0
  631. package/dist/esm/engine/frontend-components/app/app-layout-representative-activity-settings.frontend-component.specification.js +79 -0
  632. package/dist/esm/engine/frontend-components/app/app-layout-representative-activity-settings.frontend-component.specification.js.map +1 -0
  633. package/dist/esm/engine/frontend-components/app/app-layout-settings-hub.frontend-component.specification.js +3 -3
  634. package/dist/esm/engine/frontend-components/app/app-layout-settings-hub.frontend-component.specification.js.map +1 -1
  635. package/dist/esm/engine/frontend-components/app/public-layout-legal-notice.frontend-component.specification.d.ts +4 -0
  636. package/dist/esm/engine/frontend-components/app/public-layout-legal-notice.frontend-component.specification.d.ts.map +1 -0
  637. package/dist/esm/engine/frontend-components/app/public-layout-legal-notice.frontend-component.specification.js +22 -0
  638. package/dist/esm/engine/frontend-components/app/public-layout-legal-notice.frontend-component.specification.js.map +1 -0
  639. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.d.ts.map +1 -1
  640. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.js +2 -1
  641. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.js.map +1 -1
  642. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.d.ts.map +1 -1
  643. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.js +3 -2
  644. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.js.map +1 -1
  645. package/dist/esm/engine/frontend-components/auth/public-layout-chat-identity-link.frontend-component.specification.d.ts +4 -0
  646. package/dist/esm/engine/frontend-components/auth/public-layout-chat-identity-link.frontend-component.specification.d.ts.map +1 -0
  647. package/dist/esm/engine/frontend-components/auth/public-layout-chat-identity-link.frontend-component.specification.js +22 -0
  648. package/dist/esm/engine/frontend-components/auth/public-layout-chat-identity-link.frontend-component.specification.js.map +1 -0
  649. package/dist/esm/engine/frontend-components/auth/public-layout-user-auth.frontend-component.specification.js +2 -2
  650. package/dist/esm/engine/frontend-components/auth/public-layout-user-auth.frontend-component.specification.js.map +1 -1
  651. package/dist/esm/engine/frontend-components/auth/public-layout-user-invitation.frontend-component.specification.js +1 -1
  652. package/dist/esm/engine/frontend-components/auth/public-layout-user-invitation.frontend-component.specification.js.map +1 -1
  653. package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.js +1 -1
  654. package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.js.map +1 -1
  655. package/dist/esm/engine/frontend-components/data-display/badge.frontend-component.specification.d.ts.map +1 -1
  656. package/dist/esm/engine/frontend-components/data-display/badge.frontend-component.specification.js +7 -0
  657. package/dist/esm/engine/frontend-components/data-display/badge.frontend-component.specification.js.map +1 -1
  658. package/dist/esm/engine/frontend-components/feedback/features/feature-limit-indicator.frontend-component.specification.js +1 -1
  659. package/dist/esm/engine/frontend-components/feedback/features/feature-limit-indicator.frontend-component.specification.js.map +1 -1
  660. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js +1 -1
  661. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js.map +1 -1
  662. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.js +6 -6
  663. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.js.map +1 -1
  664. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-usage.frontend-component.specification.d.ts +4 -0
  665. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-usage.frontend-component.specification.d.ts.map +1 -0
  666. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-usage.frontend-component.specification.js +24 -0
  667. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-usage.frontend-component.specification.js.map +1 -0
  668. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-flow-node.frontend-component.specification.js +6 -6
  669. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-flow-node.frontend-component.specification.js.map +1 -1
  670. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-graph-viewer.frontend-component.specification.d.ts +4 -0
  671. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-graph-viewer.frontend-component.specification.d.ts.map +1 -0
  672. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-graph-viewer.frontend-component.specification.js +128 -0
  673. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-graph-viewer.frontend-component.specification.js.map +1 -0
  674. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-system-catalog.frontend-component.specification.js +1 -1
  675. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-system-catalog.frontend-component.specification.js.map +1 -1
  676. package/dist/esm/engine/frontend-components/form/controls/boolean/toggle.frontend-component.specification.js +1 -1
  677. package/dist/esm/engine/frontend-components/form/controls/boolean/toggle.frontend-component.specification.js.map +1 -1
  678. package/dist/esm/engine/frontend-components/form/controls/date-time/date-range-picker.frontend-component.specification.js +1 -1
  679. package/dist/esm/engine/frontend-components/form/controls/date-time/date-range-picker.frontend-component.specification.js.map +1 -1
  680. package/dist/esm/engine/frontend-components/form/controls/date-time/datepicker.frontend-component.specification.js +1 -1
  681. package/dist/esm/engine/frontend-components/form/controls/date-time/datepicker.frontend-component.specification.js.map +1 -1
  682. package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-picker.frontend-component.specification.js +1 -1
  683. package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-picker.frontend-component.specification.js.map +1 -1
  684. package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-range-picker.frontend-component.specification.js +1 -1
  685. package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-range-picker.frontend-component.specification.js.map +1 -1
  686. package/dist/esm/engine/frontend-components/form/controls/date-time/time-range-picker.frontend-component.specification.js +1 -1
  687. package/dist/esm/engine/frontend-components/form/controls/date-time/time-range-picker.frontend-component.specification.js.map +1 -1
  688. package/dist/esm/engine/frontend-components/form/controls/enum/toggle-group.frontend-component.specification.js +4 -4
  689. package/dist/esm/engine/frontend-components/form/controls/enum/toggle-group.frontend-component.specification.js.map +1 -1
  690. package/dist/esm/engine/frontend-components/form/controls/string/chips-input.frontend-component.specification.d.ts +5 -0
  691. package/dist/esm/engine/frontend-components/form/controls/string/chips-input.frontend-component.specification.d.ts.map +1 -0
  692. package/dist/esm/engine/frontend-components/form/controls/string/chips-input.frontend-component.specification.js +139 -0
  693. package/dist/esm/engine/frontend-components/form/controls/string/chips-input.frontend-component.specification.js.map +1 -0
  694. package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.js +1 -1
  695. package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.js.map +1 -1
  696. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-flows-actors.frontend-component.specification.d.ts.map +1 -1
  697. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-flows-actors.frontend-component.specification.js +5 -1
  698. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-flows-actors.frontend-component.specification.js.map +1 -1
  699. package/dist/esm/engine/frontend-components/index.d.ts +7 -0
  700. package/dist/esm/engine/frontend-components/index.d.ts.map +1 -1
  701. package/dist/esm/engine/frontend-components/index.js +29 -0
  702. package/dist/esm/engine/frontend-components/index.js.map +1 -1
  703. package/dist/esm/engine/frontend-components/navigation/app-level/sidebar.frontend-component.specification.js +1 -1
  704. package/dist/esm/engine/frontend-components/navigation/app-level/sidebar.frontend-component.specification.js.map +1 -1
  705. package/dist/esm/engine/frontend-components/navigation/app-level/user-dropdown.frontend-component.specification.d.ts.map +1 -1
  706. package/dist/esm/engine/frontend-components/navigation/app-level/user-dropdown.frontend-component.specification.js +3 -1
  707. package/dist/esm/engine/frontend-components/navigation/app-level/user-dropdown.frontend-component.specification.js.map +1 -1
  708. package/dist/esm/engine/frontend-components/navigation/app-level/utility-panel.frontend-component.specification.js +4 -4
  709. package/dist/esm/engine/frontend-components/navigation/app-level/utility-panel.frontend-component.specification.js.map +1 -1
  710. package/dist/esm/engine/frontend-components/resources/resource-layout-header.frontend-component.specification.js +2 -2
  711. package/dist/esm/engine/frontend-components/resources/resource-layout-header.frontend-component.specification.js.map +1 -1
  712. package/dist/esm/engine/frontend-components/resources/resource-layout-list.frontend-component.specification.js +2 -2
  713. package/dist/esm/engine/frontend-components/resources/resource-layout-list.frontend-component.specification.js.map +1 -1
  714. package/dist/esm/engine/frontend-components/resources/resource-layout-record-sharing.frontend-component.specification.d.ts +4 -0
  715. package/dist/esm/engine/frontend-components/resources/resource-layout-record-sharing.frontend-component.specification.d.ts.map +1 -0
  716. package/dist/esm/engine/frontend-components/resources/resource-layout-record-sharing.frontend-component.specification.js +27 -0
  717. package/dist/esm/engine/frontend-components/resources/resource-layout-record-sharing.frontend-component.specification.js.map +1 -0
  718. package/dist/esm/engine/frontend-components/typography/text.frontend-component.specification.d.ts.map +1 -1
  719. package/dist/esm/engine/frontend-components/typography/text.frontend-component.specification.js +3 -1
  720. package/dist/esm/engine/frontend-components/typography/text.frontend-component.specification.js.map +1 -1
  721. package/dist/esm/engine/infrastructure/resources/application-data-keys.resource.specification.d.ts +24 -0
  722. package/dist/esm/engine/infrastructure/resources/application-data-keys.resource.specification.d.ts.map +1 -0
  723. package/dist/esm/engine/infrastructure/resources/application-data-keys.resource.specification.js +136 -0
  724. package/dist/esm/engine/infrastructure/resources/application-data-keys.resource.specification.js.map +1 -0
  725. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.d.ts.map +1 -1
  726. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +6 -1
  727. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
  728. package/dist/esm/engine/infrastructure/resources/document-sequence-counters.resource.specification.d.ts +9 -0
  729. package/dist/esm/engine/infrastructure/resources/document-sequence-counters.resource.specification.d.ts.map +1 -0
  730. package/dist/esm/engine/infrastructure/resources/document-sequence-counters.resource.specification.js +110 -0
  731. package/dist/esm/engine/infrastructure/resources/document-sequence-counters.resource.specification.js.map +1 -0
  732. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.d.ts.map +1 -1
  733. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.js +10 -4
  734. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.js.map +1 -1
  735. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.d.ts.map +1 -1
  736. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.js +20 -2
  737. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.js.map +1 -1
  738. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.js +6 -6
  739. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.js.map +1 -1
  740. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.d.ts +1 -1
  741. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.js +5 -5
  742. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.js.map +1 -1
  743. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-requested-keys.resource.specification.d.ts +10 -0
  744. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-requested-keys.resource.specification.d.ts.map +1 -0
  745. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-requested-keys.resource.specification.js +118 -0
  746. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-requested-keys.resource.specification.js.map +1 -0
  747. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.d.ts.map +1 -1
  748. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.js +54 -8
  749. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.js.map +1 -1
  750. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.d.ts.map +1 -1
  751. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +9 -0
  752. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
  753. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.d.ts.map +1 -1
  754. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.js +33 -5
  755. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.js.map +1 -1
  756. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts +21 -4
  757. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts.map +1 -1
  758. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts +3 -3
  759. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +1 -1
  760. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
  761. package/dist/esm/engine/infrastructure/resources/post-commit-effect-outbox.resource.specification.d.ts +10 -0
  762. package/dist/esm/engine/infrastructure/resources/post-commit-effect-outbox.resource.specification.d.ts.map +1 -0
  763. package/dist/esm/engine/infrastructure/resources/post-commit-effect-outbox.resource.specification.js +159 -0
  764. package/dist/esm/engine/infrastructure/resources/post-commit-effect-outbox.resource.specification.js.map +1 -0
  765. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.d.ts +5 -5
  766. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.d.ts.map +1 -1
  767. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.js +38 -10
  768. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.js.map +1 -1
  769. package/dist/esm/engine/infrastructure/resources/transactional-commit-receipts.resource.specification.d.ts +9 -0
  770. package/dist/esm/engine/infrastructure/resources/transactional-commit-receipts.resource.specification.d.ts.map +1 -0
  771. package/dist/esm/engine/infrastructure/resources/transactional-commit-receipts.resource.specification.js +100 -0
  772. package/dist/esm/engine/infrastructure/resources/transactional-commit-receipts.resource.specification.js.map +1 -0
  773. package/dist/esm/engine/notifications/resources/chat-identity-links.resource.specification.d.ts +37 -0
  774. package/dist/esm/engine/notifications/resources/chat-identity-links.resource.specification.d.ts.map +1 -0
  775. package/dist/esm/engine/notifications/resources/chat-identity-links.resource.specification.js +181 -0
  776. package/dist/esm/engine/notifications/resources/chat-identity-links.resource.specification.js.map +1 -0
  777. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.d.ts +3 -3
  778. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.js +7 -7
  779. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.js.map +1 -1
  780. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.d.ts +31 -1
  781. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.d.ts.map +1 -1
  782. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.js +33 -7
  783. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.js.map +1 -1
  784. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.d.ts +16 -14
  785. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.d.ts.map +1 -1
  786. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.js +56 -53
  787. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.js.map +1 -1
  788. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts +6 -2
  789. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
  790. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +22 -4
  791. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
  792. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts +2 -2
  793. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts +2 -0
  794. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
  795. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +3 -3
  796. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
  797. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.d.ts +1 -0
  798. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.d.ts.map +1 -1
  799. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.js +43 -2
  800. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.js.map +1 -1
  801. package/dist/esm/engine/notifications/system-emails/index.d.ts +0 -1
  802. package/dist/esm/engine/notifications/system-emails/index.d.ts.map +1 -1
  803. package/dist/esm/engine/notifications/system-emails/index.js +1 -3
  804. package/dist/esm/engine/notifications/system-emails/index.js.map +1 -1
  805. package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.d.ts +1 -1
  806. package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.d.ts.map +1 -1
  807. package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.js +25 -15
  808. package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.js.map +1 -1
  809. package/dist/esm/engine/notifications/system-emails/security.system-emails.specification.js +13 -13
  810. package/dist/esm/engine/notifications/system-emails/security.system-emails.specification.js.map +1 -1
  811. package/dist/esm/engine/organizations/resources/index.d.ts +1 -2
  812. package/dist/esm/engine/organizations/resources/index.d.ts.map +1 -1
  813. package/dist/esm/engine/organizations/resources/index.js +1 -2
  814. package/dist/esm/engine/organizations/resources/index.js.map +1 -1
  815. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts +5 -4
  816. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts.map +1 -1
  817. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +114 -51
  818. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
  819. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts +11 -10
  820. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts.map +1 -1
  821. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +10 -7
  822. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
  823. package/dist/esm/engine/organizations/resources/{service-provider-relationships.resource.specification.d.ts → organization-relationships.resource.specification.d.ts} +73 -56
  824. package/dist/esm/engine/organizations/resources/organization-relationships.resource.specification.d.ts.map +1 -0
  825. package/dist/esm/engine/organizations/resources/organization-relationships.resource.specification.js +643 -0
  826. package/dist/esm/engine/organizations/resources/organization-relationships.resource.specification.js.map +1 -0
  827. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts +1 -1
  828. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts.map +1 -1
  829. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +6 -4
  830. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
  831. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js +2 -2
  832. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js.map +1 -1
  833. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts +4 -4
  834. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts.map +1 -1
  835. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +93 -43
  836. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
  837. package/dist/esm/engine/organizations/resources/professional-qualifications.resource.specification.d.ts +39 -0
  838. package/dist/esm/engine/organizations/resources/professional-qualifications.resource.specification.d.ts.map +1 -0
  839. package/dist/esm/engine/organizations/resources/professional-qualifications.resource.specification.js +140 -0
  840. package/dist/esm/engine/organizations/resources/professional-qualifications.resource.specification.js.map +1 -0
  841. package/dist/esm/engine/providers/github.provider.specification.d.ts.map +1 -1
  842. package/dist/esm/engine/providers/github.provider.specification.js +8 -5
  843. package/dist/esm/engine/providers/github.provider.specification.js.map +1 -1
  844. package/dist/esm/engine/providers/google-drive.provider.specification.d.ts +6 -0
  845. package/dist/esm/engine/providers/google-drive.provider.specification.d.ts.map +1 -0
  846. package/dist/esm/engine/providers/google-drive.provider.specification.js +39 -0
  847. package/dist/esm/engine/providers/google-drive.provider.specification.js.map +1 -0
  848. package/dist/esm/engine/providers/index.d.ts +2 -0
  849. package/dist/esm/engine/providers/index.d.ts.map +1 -1
  850. package/dist/esm/engine/providers/index.js +5 -1
  851. package/dist/esm/engine/providers/index.js.map +1 -1
  852. package/dist/esm/engine/providers/microsoft-onedrive.provider.specification.d.ts +6 -0
  853. package/dist/esm/engine/providers/microsoft-onedrive.provider.specification.d.ts.map +1 -0
  854. package/dist/esm/engine/providers/microsoft-onedrive.provider.specification.js +39 -0
  855. package/dist/esm/engine/providers/microsoft-onedrive.provider.specification.js.map +1 -0
  856. package/dist/esm/engine/providers/mistral.provider.specification.js +2 -2
  857. package/dist/esm/engine/providers/mistral.provider.specification.js.map +1 -1
  858. package/dist/esm/engine/providers/resend.provider.specification.d.ts.map +1 -1
  859. package/dist/esm/engine/providers/resend.provider.specification.js +8 -6
  860. package/dist/esm/engine/providers/resend.provider.specification.js.map +1 -1
  861. package/dist/esm/engine/roles/app-audit-evidence-reader.role.specification.js +1 -1
  862. package/dist/esm/engine/roles/app-audit-evidence-reader.role.specification.js.map +1 -1
  863. package/dist/esm/engine/roles/index.d.ts +2 -2
  864. package/dist/esm/engine/roles/index.d.ts.map +1 -1
  865. package/dist/esm/engine/roles/index.js +5 -5
  866. package/dist/esm/engine/roles/index.js.map +1 -1
  867. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.d.ts +1 -1
  868. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.d.ts.map +1 -1
  869. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.js +24 -24
  870. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.js.map +1 -1
  871. package/dist/esm/engine/roles/org-representative.role.specification.d.ts +2 -0
  872. package/dist/esm/engine/roles/org-representative.role.specification.d.ts.map +1 -0
  873. package/dist/esm/engine/roles/org-representative.role.specification.js +22 -0
  874. package/dist/esm/engine/roles/org-representative.role.specification.js.map +1 -0
  875. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.d.ts +1 -0
  876. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.d.ts.map +1 -1
  877. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js +7 -5
  878. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
  879. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.d.ts +3 -3
  880. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +3 -3
  881. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
  882. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js +3 -3
  883. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
  884. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts +1 -1
  885. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts.map +1 -1
  886. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +13 -1
  887. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
  888. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts +1 -0
  889. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts.map +1 -1
  890. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.js +2 -0
  891. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.js.map +1 -1
  892. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +4 -0
  893. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts.map +1 -1
  894. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +3 -3
  895. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
  896. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +1 -1
  897. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
  898. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +4 -0
  899. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
  900. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +6 -2
  901. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
  902. package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts +1 -0
  903. package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts.map +1 -1
  904. package/dist/esm/engine/users/resources/user-self.resource.specification.js +33 -0
  905. package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
  906. package/dist/esm/engine/users/resources/users.resource.specification.d.ts +2 -1
  907. package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
  908. package/dist/esm/engine/users/resources/users.resource.specification.js +10 -4
  909. package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
  910. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
  911. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +17 -15
  912. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
  913. package/package.json +8 -8
  914. package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.d.ts +0 -6
  915. package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.d.ts.map +0 -1
  916. package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.js +0 -146
  917. package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.js.map +0 -1
  918. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.d.ts +0 -38
  919. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.d.ts.map +0 -1
  920. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.js +0 -152
  921. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.js.map +0 -1
  922. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.d.ts.map +0 -1
  923. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.js +0 -417
  924. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.js.map +0 -1
  925. package/dist/esm/engine/roles/org-service-provider.role.specification.d.ts +0 -2
  926. package/dist/esm/engine/roles/org-service-provider.role.specification.d.ts.map +0 -1
  927. package/dist/esm/engine/roles/org-service-provider.role.specification.js +0 -22
  928. package/dist/esm/engine/roles/org-service-provider.role.specification.js.map +0 -1
@@ -1,6 +1,6 @@
1
1
  import { LabelAudience } from '@wildo-ai/presets-components-models';
2
2
  import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';
3
- import { ExternalDataPipelineRunFailureKind, ExternalDataPipelineRunRecordOutcome, ExternalDataSourceUnreachableCause, } from '@wildo-ai/saas-backend-lib';
3
+ import { ExternalDataContinuationRestartReason, ExternalDataPipelineRunFailureKind, ExternalDataPipelineRunRecordOutcome, ExternalDataSourceUnreachableCause, } from '@wildo-ai/saas-backend-lib';
4
4
  import { ExternalDataPipelineRunRecordSchema, ExternalDataPipelineRunRecordVariantKey, externalDataPipelineRunRecordResourceConfiguration_InitializationFactory as runRecordFactory, } from '@wildo-ai/saas-backend-lib/external-data-models';
5
5
  import { CoreResourceOperation as Op, ExternalDataPipelinePassMode, ResourcePrimaryScope } from '@wildo-ai/saas-models';
6
6
  import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
@@ -49,7 +49,7 @@ export const externalDataPipelineRunRecordsResourceSpecification = resourceSpeci
49
49
  }),
50
50
  systemOfRecord: schemaShape.systemOfRecord.stringSpec({ meaning: 'The system-of-record instance the pipeline reads from — or, for an OUTBOUND pipeline, sends to.' }),
51
51
  triggerOrigin: schemaShape.triggerOrigin.enumSpec({
52
- meaning: 'What started the run: the pipeline\'s own schedule, or an administrator asking for a run.',
52
+ meaning: 'What started the run: the pipeline\'s own schedule, an administrator asking for a run, or an inbound delivery naming records that changed at the system of record (a keyed run).',
53
53
  enumDeclaration: backendEnum('DataSeedTriggerOrigin'),
54
54
  }),
55
55
  passMode: schemaShape.passMode.enumSpec({
@@ -60,6 +60,7 @@ export const externalDataPipelineRunRecordsResourceSpecification = resourceSpeci
60
60
  [ExternalDataPipelinePassMode.FULL]: { meaning: 'The run advanced a full pass over the source.' },
61
61
  [ExternalDataPipelinePassMode.INCREMENTAL]: { meaning: 'The run read only what changed since the incremental track\'s watermark.' },
62
62
  [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.' },
63
+ [ExternalDataPipelinePassMode.KEYED]: { meaning: 'A keyed run: it re-read only the records inbound deliveries named as changed, and advanced neither pass. Never counted as a pass in the pipeline\'s health.' },
63
64
  },
64
65
  }),
65
66
  outcome: schemaShape.outcome.enumSpec({
@@ -84,6 +85,10 @@ export const externalDataPipelineRunRecordsResourceSpecification = resourceSpeci
84
85
  }),
85
86
  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' }),
86
87
  startedAt: schemaShape.startedAt.dateSpec({ meaning: 'When the run started.', importance: FieldSemanticImportance.PRIMARY }),
88
+ leaseGeneration: schemaShape.leaseGeneration.numberSpec({
89
+ meaning: 'The turn the run took on the pipeline: it increases every time a run takes the pipeline\'s lease. Empty for a run that ended before taking it, which loaded nothing.',
90
+ whyItMatters: 'It is the order in which runs held the pipeline, which the date a copy is current as of is read in. The order rows were written in can differ: a run that lost its lease writes its row after the run that took over.',
91
+ }),
87
92
  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.' }),
88
93
  extractedRows: schemaShape.extractedRows.numberSpec({ meaning: 'How many source rows the run read.' }),
89
94
  rejectedRows: schemaShape.rejectedRows.numberSpec({
@@ -110,6 +115,15 @@ export const externalDataPipelineRunRecordsResourceSpecification = resourceSpeci
110
115
  symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
111
116
  },
112
117
  }),
118
+ continuationRestart: schemaShape.continuationRestart.enumSpec({
119
+ meaning: 'Why the run could not continue from where its pass stood and read again from the start of the pass — or, for a change feed, fell back to a full read. Empty when it continued.',
120
+ whyItMatters: 'Nothing is lost by one restart, but a second in the same pass fails the run: a pass that keeps restarting never finishes, and so never notices a deleted record.',
121
+ enumDeclaration: backendEnum('ExternalDataContinuationRestartReason'),
122
+ values: {
123
+ [ExternalDataContinuationRestartReason.EXPIRED]: { meaning: 'The source had forgotten where the pass stood — it keeps that position for less time than the pass took.' },
124
+ [ExternalDataContinuationRestartReason.ORIGIN_MOVED]: { meaning: 'The system of record now lives at another address, and the saved position pointed at the old one.' },
125
+ },
126
+ }),
113
127
  removedRows: schemaShape.removedRows.numberSpec({
114
128
  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 '
115
129
  + 'the rows the policy changed; zero on every run that does not read a change feed.',
@@ -135,7 +149,7 @@ export const externalDataPipelineRunRecordsResourceSpecification = resourceSpeci
135
149
  [ExternalDataSourceUnreachableCause.TOKEN_ENDPOINT_UNREACHABLE]: { meaning: 'The source\'s token endpoint could not be reached, so no request could be authorized.' },
136
150
  },
137
151
  }),
138
- 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.' }),
152
+ failureMessage: schemaShape.failureMessage.stringSpec({ meaning: 'The failure\'s message, with what a driver documents as quoting row data removed (a URL\'s query and userinfo, a duplicate-key or check-violation detail, a refused input value) and cut to a bounded length — the same line the log carries. Empty when the run produced a report.' }),
139
153
  rejections: schemaShape.rejections.arraySpec({
140
154
  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.',
141
155
  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.',
@@ -143,11 +157,14 @@ export const externalDataPipelineRunRecordsResourceSpecification = resourceSpeci
143
157
  importance: FieldSemanticImportance.PRIMARY,
144
158
  }),
145
159
  outbound: schemaShape.outbound.objectSpec({
146
- 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), '
147
- + 'refused, of unknown outcome, waiting for an operator, or dropped. Every change read lands in exactly one count. Empty on an inbound run, '
148
- + 'and on an outbound run that failed before its pass produced a report.',
160
+ meaning: 'What the run SENT: an OUTBOUND run, or the sending half of a BIDIRECTIONAL run. For each change it read: created, updated, settled '
161
+ + 'from an earlier send, kept for a later pass (and why), refused, of unknown outcome, waiting for an operator, or dropped. Every change '
162
+ + 'read lands in exactly one count. On a BIDIRECTIONAL run whose sending half failed after its inbound half finished, it also carries that '
163
+ + 'failure (its kind and a redacted message), and the counts are what the half had done before failing; the run keeps its inbound '
164
+ + 'outcome. Empty on an inbound-only run, and on an outbound run that failed before its pass produced a report.',
149
165
  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 '
150
- + 'sent again on their own, because a second create could duplicate the record.',
166
+ + 'sent again on their own, because a second create could duplicate the record. A sending failure on run after run says nothing is '
167
+ + 'being sent, while the run itself reads as completed.',
151
168
  }),
152
169
  conflicts: schemaShape.conflicts.objectSpec({
153
170
  meaning: 'What a BIDIRECTIONAL run did with rows changed on both sides since they last agreed: how many it resolved for the system of '
@@ -156,6 +173,35 @@ export const externalDataPipelineRunRecordsResourceSpecification = resourceSpeci
156
173
  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, '
157
174
  + 'until someone does. It is listed again on every run that reads it.',
158
175
  }),
176
+ inboundDeliveryId: schemaShape.inboundDeliveryId.stringSpec({
177
+ meaning: 'The inbound delivery that started this run — set exactly on a keyed run a delivery asked for; empty on every other run.',
178
+ }),
179
+ drainedRequestedKeys: schemaShape.drainedRequestedKeys.numberSpec({
180
+ meaning: 'How many records inbound deliveries named that this run re-read from the source before its own pass — a keyed run\'s whole work, and what any other run of the pipeline drained first.',
181
+ }),
182
+ missingRequestedKeys: schemaShape.missingRequestedKeys.numberSpec({
183
+ meaning: 'Of the records this run was asked to re-read, how many the source no longer serves — deleted there, or outside the pipeline\'s filter. Their requests are dropped; no local row is removed.',
184
+ whyItMatters: 'Only a full pass removes a local row; a record missing here is removed, if at all, by the next one.',
185
+ }),
186
+ requestedKeyDeliveryIds: schemaShape.requestedKeyDeliveryIds.arraySpec({
187
+ meaning: 'The inbound deliveries whose named records this run re-read — loaded, kept for a later run on a two-way pipeline, or found missing — at most twenty, including one that arrived while another run held the pipeline, whose records a later run loaded.',
188
+ elementMeaning: 'One inbound delivery id.',
189
+ whyItMatters: 'It is the only row that follows such a delivery to the run that acted on it.',
190
+ }),
191
+ undecodableRequestedKeys: schemaShape.undecodableRequestedKeys.numberSpec({
192
+ meaning: 'How many waiting requests this run dropped because their key no longer decodes under the pipeline\'s key fields — the fields changed while they waited.',
193
+ whyItMatters: 'Those records are not re-read until the next full pass, which reads every record.',
194
+ }),
195
+ keptRequestedKeys: schemaShape.keptRequestedKeys.numberSpec({
196
+ meaning: 'How many waiting requests this run re-read and kept for a later run: a two-way pipeline held the record again, because a create '
197
+ + 'of unknown outcome could have made it, or did not write it, because its row was edited locally while the run loaded it.',
198
+ whyItMatters: 'They load at the first run after that create is answered, or are decided by the next run with the edit in view. A number '
199
+ + 'that stays up run after run is a create nobody has answered, or a row edited on every run.',
200
+ }),
201
+ requestedKeysDrainFailure: schemaShape.requestedKeysDrainFailure.stringSpec({
202
+ meaning: 'Why this run could not re-read the records deliveries asked for, when its pass went on anyway: what the source answered, with what a driver documents as quoting row data removed (a URL\'s query and userinfo, a duplicate-key or check-violation detail, a refused input value). Empty when the re-read completed or there was none.',
203
+ whyItMatters: 'The requests stay waiting. The same failure run after run is a request the source keeps refusing, and resetting the pipeline clears it.',
204
+ }),
159
205
  rejectionsTruncated: schemaShape.rejectionsTruncated.booleanSpec({ meaning: 'True when the run refused more rows than are kept, so the stored list is shorter than the count.' }),
160
206
  createdAt: schemaShape.createdAt.dateSpec({ meaning: 'When the row was written; the retention clock starts here.' }),
161
207
  },
@@ -193,7 +239,7 @@ export const externalDataPipelineRunRecordsResourceSpecification = resourceSpeci
193
239
  businessConstraints: [
194
240
  'Written once per run and never updated: a row states how that run ended.',
195
241
  'A run refused because the pipeline was already running leaves no row — it was not a run.',
196
- '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.',
242
+ '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 what a driver documents as quoting row data removed (a URL\'s query and userinfo, a duplicate-key or check-violation detail, a refused input value); a vendor\'s own error text beyond those forms is not controlled.',
197
243
  'Kept for the application\'s declared operational-logs period and swept by the retention-class sweep.',
198
244
  ],
199
245
  }), { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION });
@@ -1 +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":"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","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
+ {"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":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n ExternalDataContinuationRestartReason,\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, an administrator asking for a run, or an inbound delivery naming records that changed at the system of record (a keyed 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 [ExternalDataPipelinePassMode.KEYED]: { meaning: 'A keyed run: it re-read only the records inbound deliveries named as changed, and advanced neither pass. Never counted as a pass in the pipeline\\'s health.' },\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 leaseGeneration: schemaShape.leaseGeneration.numberSpec({\n meaning: 'The turn the run took on the pipeline: it increases every time a run takes the pipeline\\'s lease. Empty for a run that ended before taking it, which loaded nothing.',\n whyItMatters: 'It is the order in which runs held the pipeline, which the date a copy is current as of is read in. The order rows were written in can differ: a run that lost its lease writes its row after the run that took over.',\n }),\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 continuationRestart: schemaShape.continuationRestart.enumSpec({\n meaning: 'Why the run could not continue from where its pass stood and read again from the start of the pass — or, for a change feed, fell back to a full read. Empty when it continued.',\n whyItMatters: 'Nothing is lost by one restart, but a second in the same pass fails the run: a pass that keeps restarting never finishes, and so never notices a deleted record.',\n enumDeclaration: backendEnum('ExternalDataContinuationRestartReason'),\n values: {\n [ExternalDataContinuationRestartReason.EXPIRED]: { meaning: 'The source had forgotten where the pass stood — it keeps that position for less time than the pass took.' },\n [ExternalDataContinuationRestartReason.ORIGIN_MOVED]: { meaning: 'The system of record now lives at another address, and the saved position pointed at the old one.' },\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 what a driver documents as quoting row data removed (a URL\\'s query and userinfo, a duplicate-key or check-violation detail, a refused input value) 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 the run SENT: an OUTBOUND run, or the sending half of a BIDIRECTIONAL run. For each change it read: created, updated, settled '\n + 'from an earlier send, kept for a later pass (and why), refused, of unknown outcome, waiting for an operator, or dropped. Every change '\n + 'read lands in exactly one count. On a BIDIRECTIONAL run whose sending half failed after its inbound half finished, it also carries that '\n + 'failure (its kind and a redacted message), and the counts are what the half had done before failing; the run keeps its inbound '\n + 'outcome. Empty on an inbound-only run, 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. A sending failure on run after run says nothing is '\n + 'being sent, while the run itself reads as completed.',\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 inboundDeliveryId: schemaShape.inboundDeliveryId.stringSpec({\n meaning: 'The inbound delivery that started this run — set exactly on a keyed run a delivery asked for; empty on every other run.',\n }),\n drainedRequestedKeys: schemaShape.drainedRequestedKeys.numberSpec({\n meaning: 'How many records inbound deliveries named that this run re-read from the source before its own pass — a keyed run\\'s whole work, and what any other run of the pipeline drained first.',\n }),\n missingRequestedKeys: schemaShape.missingRequestedKeys.numberSpec({\n meaning: 'Of the records this run was asked to re-read, how many the source no longer serves — deleted there, or outside the pipeline\\'s filter. Their requests are dropped; no local row is removed.',\n whyItMatters: 'Only a full pass removes a local row; a record missing here is removed, if at all, by the next one.',\n }),\n requestedKeyDeliveryIds: schemaShape.requestedKeyDeliveryIds.arraySpec({\n meaning: 'The inbound deliveries whose named records this run re-read — loaded, kept for a later run on a two-way pipeline, or found missing — at most twenty, including one that arrived while another run held the pipeline, whose records a later run loaded.',\n elementMeaning: 'One inbound delivery id.',\n whyItMatters: 'It is the only row that follows such a delivery to the run that acted on it.',\n }),\n undecodableRequestedKeys: schemaShape.undecodableRequestedKeys.numberSpec({\n meaning: 'How many waiting requests this run dropped because their key no longer decodes under the pipeline\\'s key fields — the fields changed while they waited.',\n whyItMatters: 'Those records are not re-read until the next full pass, which reads every record.',\n }),\n keptRequestedKeys: schemaShape.keptRequestedKeys.numberSpec({\n meaning: 'How many waiting requests this run re-read and kept for a later run: a two-way pipeline held the record again, because a create '\n + 'of unknown outcome could have made it, or did not write it, because its row was edited locally while the run loaded it.',\n whyItMatters: 'They load at the first run after that create is answered, or are decided by the next run with the edit in view. A number '\n + 'that stays up run after run is a create nobody has answered, or a row edited on every run.',\n }),\n requestedKeysDrainFailure: schemaShape.requestedKeysDrainFailure.stringSpec({\n meaning: 'Why this run could not re-read the records deliveries asked for, when its pass went on anyway: what the source answered, with what a driver documents as quoting row data removed (a URL\\'s query and userinfo, a duplicate-key or check-violation detail, a refused input value). Empty when the re-read completed or there was none.',\n whyItMatters: 'The requests stay waiting. The same failure run after run is a request the source keeps refusing, and resetting the pipeline clears 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 what a driver documents as quoting row data removed (a URL\\'s query and userinfo, a duplicate-key or check-violation detail, a refused input value); a vendor\\'s own error text beyond those forms 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,8BA6K7D,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,8BAwL7D,CAAC"}
@@ -88,6 +88,15 @@ export const externalDataPipelineStatesResourceSpecification = resourceSpecifica
88
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
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
90
  }),
91
+ suppressionIdentity: schemaShape.suppressionIdentity.stringSpec({
92
+ meaning: 'The source identity — system of record, remote entity and key shape — the pipeline last matched erasure suppressions under. Written by the first run that passes the suppression check under a new identity, or by the reconcile door. Empty until the pipeline first runs.',
93
+ whyItMatters: 'Erasure suppressions belong to the remote entity, and any pipeline reading it may have recorded them. When the declaration moves the pipeline to another identity, this is what finds the suppressions it still owes, including ones another pipeline recorded, so the run refuses instead of copying erased people back in.',
94
+ }),
95
+ suppressionIdentityDecisions: schemaShape.suppressionIdentityDecisions.arraySpec({
96
+ meaning: 'This pipeline\'s decisions about the source identities it no longer has: for each one, whether it keeps matching the suppressions filed under it (carry-over) or stopped matching them (release), and when. Made through the audited reconcile door.',
97
+ elementMeaning: 'One decision: the stale identity it is about, carry-over or release, and when the operator made it.',
98
+ whyItMatters: 'The decision belongs to this pipeline alone; nothing is moved or re-keyed, so another pipeline on the same entity keeps its own suppressions and must decide for itself. A carried-over identity is loaded beside the current one on every run. Matching an identity again voids the decision about it, so a later move asks again. A decision is final otherwise: a release cannot be undone, only the erasure run again.',
99
+ }),
91
100
  lastRunAt: schemaShape.lastRunAt.dateSpec({
92
101
  meaning: 'When the most recent run started, whatever its outcome. Empty until the pipeline first runs.',
93
102
  }),
@@ -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 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"]}
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 suppressionIdentity: schemaShape.suppressionIdentity.stringSpec({\n meaning: 'The source identity — system of record, remote entity and key shape — the pipeline last matched erasure suppressions under. Written by the first run that passes the suppression check under a new identity, or by the reconcile door. Empty until the pipeline first runs.',\n whyItMatters: 'Erasure suppressions belong to the remote entity, and any pipeline reading it may have recorded them. When the declaration moves the pipeline to another identity, this is what finds the suppressions it still owes, including ones another pipeline recorded, so the run refuses instead of copying erased people back in.',\n }),\n\n suppressionIdentityDecisions: schemaShape.suppressionIdentityDecisions.arraySpec({\n meaning: 'This pipeline\\'s decisions about the source identities it no longer has: for each one, whether it keeps matching the suppressions filed under it (carry-over) or stopped matching them (release), and when. Made through the audited reconcile door.',\n elementMeaning: 'One decision: the stale identity it is about, carry-over or release, and when the operator made it.',\n whyItMatters: 'The decision belongs to this pipeline alone; nothing is moved or re-keyed, so another pipeline on the same entity keeps its own suppressions and must decide for itself. A carried-over identity is loaded beside the current one on every run. Matching an identity again voids the decision about it, so a later move asks again. A decision is final otherwise: a release cannot be undone, only the erasure run again.',\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"]}
@@ -1 +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"}
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,8BAuH7D,CAAC"}
@@ -11,9 +11,11 @@ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
11
11
  * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.
12
12
  */
13
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.',
14
+ purpose: 'Remember, per remote record of a two-way pipeline, the version at which the system of record and the application last agreed, and a '
15
+ + 'fingerprint of the shared values agreed with it, so a record changed on both sides since is recognised as a conflict.',
15
16
  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
+ lifecycleRole: 'Written when a pass loads a record\'s values (at the version and with the shared values it loaded) and when a pass sends a row '
18
+ + '(at the version and shared values the record has after the write); left alone when a conflict is refused, because the two sides do not agree.',
17
19
  audience: LabelAudience.DEVELOPER,
18
20
  subDomain: EngineResourceSubDomain.INFRASTRUCTURE,
19
21
  codeHandling: {
@@ -44,11 +46,37 @@ export const externalDataRemoteVersionsResourceSpecification = resourceSpecifica
44
46
  resourceType: schemaShape.resourceType.stringSpec({ meaning: 'The two-way pipeline\'s destination resource.' }),
45
47
  remoteKey: schemaShape.remoteKey.stringSpec({ meaning: 'The remote record\'s key, as the destination\'s remote-key field holds it.' }),
46
48
  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.',
49
+ meaning: 'The system of record\'s own row version (a last-modified stamp, an entity tag) when the two sides last agreed. Empty on a row '
50
+ + 'that only records a write of the application\'s that landed on a record the two sides never agreed on.',
48
51
  whyItMatters: 'A record whose current version differs was changed over there since; with a local change pending too, it is a conflict.',
49
52
  importance: FieldSemanticImportance.PRIMARY,
50
53
  }),
51
- reconciledAt: schemaShape.reconciledAt.dateSpec({ meaning: 'When the two sides last agreed.' }),
54
+ sharedValuesFingerprint: schemaShape.sharedValuesFingerprint.stringSpec({
55
+ meaning: 'A hash of the record\'s shared (both-owned) values as the system of record served them when the two sides last agreed — never the '
56
+ + 'values themselves. Empty on an agreement recorded before fingerprints were kept, until its next agreement.',
57
+ whyItMatters: 'Some systems serve their version only to the second (Odoo\'s last-modified stamp), so an edit made over there in the same second '
58
+ + 'as the agreed version leaves the version unchanged. The same version with other shared values is a change too, so that edit is never '
59
+ + 'overwritten.',
60
+ importance: FieldSemanticImportance.CONTEXTUAL,
61
+ }),
62
+ sharedFieldFingerprints: schemaShape.sharedFieldFingerprints.objectSpec({
63
+ meaning: 'A hash of EACH shared field\'s value as the system of record served it when the two sides last agreed, by local field — never the '
64
+ + 'values themselves. Empty on an agreement recorded before it, until its next agreement.',
65
+ whyItMatters: 'It says which shared fields the record changed since, so a conflict is decided per field: a field only the record changed '
66
+ + 'loads, one only the application changed is sent, and only one both changed is decided by the policy.',
67
+ importance: FieldSemanticImportance.CONTEXTUAL,
68
+ }),
69
+ reconciledAt: schemaShape.reconciledAt.dateSpec({ meaning: 'When the two sides last agreed. Empty while they never have.' }),
70
+ ownWriteLandedUnagreedAt: schemaShape.ownWriteLandedUnagreedAt.dateSpec({
71
+ meaning: 'When a write the application sent landed without the version it left being agreed: the sending pass stopped between the '
72
+ + 'write and its agreement, the version could not be read after it, the record did not hold what was written just after it, or an '
73
+ + 'operator answered a write of unknown outcome as applied. '
74
+ + 'Cleared by the next agreement.',
75
+ whyItMatters: 'The record\'s change since the agreement may be that write alone, so it cannot be told from an edit made over there. Until '
76
+ + 'the next agreement, a conflict on the record is refused to an operator even when the policy lets the system of record win, so the '
77
+ + 'application\'s own older values do not overwrite a newer local edit.',
78
+ importance: FieldSemanticImportance.CONTEXTUAL,
79
+ }),
52
80
  },
53
81
  operations: {
54
82
  [Op.CREATE]: {
@@ -91,7 +119,7 @@ export const externalDataRemoteVersionsResourceSpecification = resourceSpecifica
91
119
  businessConstraints: [
92
120
  'Only the system of record\'s own row version is kept: a clock the application keeps cannot see a change made over there.',
93
121
  '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.',
122
+ 'Holds no record content: a remote identity, a version stamp, and a hash of the shared values — never the values themselves.',
95
123
  ],
96
124
  }), { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION });
97
125
  //# sourceMappingURL=external-data-remote-versions.resource.specification.js.map
@@ -1 +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"]}
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, and a '\n + 'fingerprint of the shared values agreed with it, 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 and with the shared values it loaded) and when a pass sends a row '\n + '(at the version and shared values 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. Empty on a row '\n + 'that only records a write of the application\\'s that landed on a record the two sides never agreed on.',\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 sharedValuesFingerprint: schemaShape.sharedValuesFingerprint.stringSpec({\n meaning: 'A hash of the record\\'s shared (both-owned) values as the system of record served them when the two sides last agreed — never the '\n + 'values themselves. Empty on an agreement recorded before fingerprints were kept, until its next agreement.',\n whyItMatters: 'Some systems serve their version only to the second (Odoo\\'s last-modified stamp), so an edit made over there in the same second '\n + 'as the agreed version leaves the version unchanged. The same version with other shared values is a change too, so that edit is never '\n + 'overwritten.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n sharedFieldFingerprints: schemaShape.sharedFieldFingerprints.objectSpec({\n meaning: 'A hash of EACH shared field\\'s value as the system of record served it when the two sides last agreed, by local field — never the '\n + 'values themselves. Empty on an agreement recorded before it, until its next agreement.',\n whyItMatters: 'It says which shared fields the record changed since, so a conflict is decided per field: a field only the record changed '\n + 'loads, one only the application changed is sent, and only one both changed is decided by the policy.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\n reconciledAt: schemaShape.reconciledAt.dateSpec({ meaning: 'When the two sides last agreed. Empty while they never have.' }),\n ownWriteLandedUnagreedAt: schemaShape.ownWriteLandedUnagreedAt.dateSpec({\n meaning: 'When a write the application sent landed without the version it left being agreed: the sending pass stopped between the '\n + 'write and its agreement, the version could not be read after it, the record did not hold what was written just after it, or an '\n + 'operator answered a write of unknown outcome as applied. '\n + 'Cleared by the next agreement.',\n whyItMatters: 'The record\\'s change since the agreement may be that write alone, so it cannot be told from an edit made over there. Until '\n + 'the next agreement, a conflict on the record is refused to an operator even when the policy lets the system of record win, so the '\n + 'application\\'s own older values do not overwrite a newer local edit.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n }),\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: a remote identity, a version stamp, and a hash of the shared values — never the values themselves.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}