@wildo-ai/saas-specifications 1.1.5 → 1.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (677) hide show
  1. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts +10 -8
  2. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts.map +1 -1
  3. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.js +14 -13
  4. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.js.map +1 -1
  5. package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.d.ts +3 -2
  6. package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.d.ts.map +1 -1
  7. package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.js +4 -3
  8. package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.js.map +1 -1
  9. package/dist/esm/_catalogs/schema-org/index.d.ts +31 -15
  10. package/dist/esm/_catalogs/schema-org/index.d.ts.map +1 -1
  11. package/dist/esm/_catalogs/schema-org/index.js +34 -13
  12. package/dist/esm/_catalogs/schema-org/index.js.map +1 -1
  13. package/dist/esm/_catalogs/schema-org/product.catalog-spec.d.ts +2 -2
  14. package/dist/esm/_catalogs/schema-org/product.catalog-spec.js +4 -4
  15. package/dist/esm/_catalogs/schema-org/product.catalog-spec.js.map +1 -1
  16. package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.d.ts +45 -0
  17. package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.d.ts.map +1 -0
  18. package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.js +58 -0
  19. package/dist/esm/_catalogs/schema-org/software-application.catalog-spec.js.map +1 -0
  20. package/dist/esm/_core/application-specification-family-identity.schemas.d.ts +3 -2
  21. package/dist/esm/_core/application-specification-family-identity.schemas.d.ts.map +1 -1
  22. package/dist/esm/_core/application-specification-family-identity.schemas.js +3 -2
  23. package/dist/esm/_core/application-specification-family-identity.schemas.js.map +1 -1
  24. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts +18 -0
  25. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts.map +1 -1
  26. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts +39 -13
  27. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts.map +1 -1
  28. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js +43 -13
  29. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js.map +1 -1
  30. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts +90 -2
  31. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts.map +1 -1
  32. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.js +70 -6
  33. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.js.map +1 -1
  34. package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts.map +1 -1
  35. package/dist/esm/_core/build-plan/build-plan.family-aspects.js +26 -4
  36. package/dist/esm/_core/build-plan/build-plan.family-aspects.js.map +1 -1
  37. package/dist/esm/_core/business-semantics.specifications.schemas.d.ts +14 -0
  38. package/dist/esm/_core/business-semantics.specifications.schemas.d.ts.map +1 -1
  39. package/dist/esm/_core/business-semantics.specifications.schemas.js.map +1 -1
  40. package/dist/esm/_core/capability-composition/capability-composition-validation.d.ts.map +1 -1
  41. package/dist/esm/_core/capability-composition/capability-composition-validation.js +1 -0
  42. package/dist/esm/_core/capability-composition/capability-composition-validation.js.map +1 -1
  43. package/dist/esm/_core/capability-composition/capability-composition.schemas.d.ts +21 -2
  44. package/dist/esm/_core/capability-composition/capability-composition.schemas.d.ts.map +1 -1
  45. package/dist/esm/_core/capability-composition/capability-composition.schemas.js +20 -1
  46. package/dist/esm/_core/capability-composition/capability-composition.schemas.js.map +1 -1
  47. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts +11 -32
  48. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts.map +1 -1
  49. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js +70 -3
  50. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js.map +1 -1
  51. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.d.ts +142 -17
  52. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.d.ts.map +1 -1
  53. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.js +285 -30
  54. package/dist/esm/_core/compliance-documents/computed-document-facts.schemas.js.map +1 -1
  55. package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts +183 -18
  56. package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts.map +1 -1
  57. package/dist/esm/_core/compliance-documents/processor-register.schemas.js +165 -18
  58. package/dist/esm/_core/compliance-documents/processor-register.schemas.js.map +1 -1
  59. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.d.ts +139 -0
  60. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.d.ts.map +1 -0
  61. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.js +172 -0
  62. package/dist/esm/_core/compliance-documents/recipient-disclosures.schemas.js.map +1 -0
  63. package/dist/esm/_core/compliance-documents/recipient-population.schemas.d.ts +306 -0
  64. package/dist/esm/_core/compliance-documents/recipient-population.schemas.d.ts.map +1 -0
  65. package/dist/esm/_core/compliance-documents/recipient-population.schemas.js +502 -0
  66. package/dist/esm/_core/compliance-documents/recipient-population.schemas.js.map +1 -0
  67. package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.d.ts +107 -0
  68. package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.d.ts.map +1 -0
  69. package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.js +118 -0
  70. package/dist/esm/_core/compliance-documents/retention-enforcement-facts.schemas.js.map +1 -0
  71. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.d.ts +56 -0
  72. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.d.ts.map +1 -0
  73. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.js +100 -0
  74. package/dist/esm/_core/compliance-documents/subject-data-recipients.schemas.js.map +1 -0
  75. package/dist/esm/_core/composite-view-specification.schemas.js +8 -1
  76. package/dist/esm/_core/composite-view-specification.schemas.js.map +1 -1
  77. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts +3 -2
  78. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -1
  79. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js +3 -2
  80. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js.map +1 -1
  81. package/dist/esm/_core/experience-plan/experience-plan.schemas.d.ts +16 -3
  82. package/dist/esm/_core/experience-plan/experience-plan.schemas.d.ts.map +1 -1
  83. package/dist/esm/_core/experience-plan/experience-plan.schemas.js +70 -5
  84. package/dist/esm/_core/experience-plan/experience-plan.schemas.js.map +1 -1
  85. package/dist/esm/_core/family-aspects.schemas.d.ts +10 -0
  86. package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -1
  87. package/dist/esm/_core/family-aspects.schemas.js.map +1 -1
  88. package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +2 -2
  89. package/dist/esm/_core/feature-drafts/capability-map-output-set.schemas.d.ts +1 -0
  90. package/dist/esm/_core/feature-drafts/capability-map-output-set.schemas.d.ts.map +1 -1
  91. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.d.ts +16 -0
  92. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.d.ts.map +1 -1
  93. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.js +8 -0
  94. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.js.map +1 -1
  95. package/dist/esm/_core/index.d.ts +3 -0
  96. package/dist/esm/_core/index.d.ts.map +1 -1
  97. package/dist/esm/_core/index.js +3 -0
  98. package/dist/esm/_core/index.js.map +1 -1
  99. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.d.ts +5 -0
  100. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.d.ts.map +1 -1
  101. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.js +3 -1
  102. package/dist/esm/_core/integration-plan/integration-plan-generation.schemas.js.map +1 -1
  103. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.d.ts.map +1 -1
  104. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.js +12 -2
  105. package/dist/esm/_core/integration-plan/integration-plan.family-aspects.js.map +1 -1
  106. package/dist/esm/_core/integration-plan/integration-plan.schemas.d.ts +30 -2
  107. package/dist/esm/_core/integration-plan/integration-plan.schemas.d.ts.map +1 -1
  108. package/dist/esm/_core/integration-plan/integration-plan.schemas.js +32 -2
  109. package/dist/esm/_core/integration-plan/integration-plan.schemas.js.map +1 -1
  110. package/dist/esm/_core/market/feature-benefit.schemas.js +2 -2
  111. package/dist/esm/_core/market/feature-benefit.schemas.js.map +1 -1
  112. package/dist/esm/_core/market/market-alternative.schemas.js +2 -2
  113. package/dist/esm/_core/market/market-alternative.schemas.js.map +1 -1
  114. package/dist/esm/_core/market/market-buying-journey.schemas.js +2 -2
  115. package/dist/esm/_core/market/market-buying-journey.schemas.js.map +1 -1
  116. package/dist/esm/_core/market/market-category.schemas.js +2 -2
  117. package/dist/esm/_core/market/market-category.schemas.js.map +1 -1
  118. package/dist/esm/_core/market/market-channel.schemas.js +2 -2
  119. package/dist/esm/_core/market/market-channel.schemas.js.map +1 -1
  120. package/dist/esm/_core/market/market-gain.schemas.js +2 -2
  121. package/dist/esm/_core/market/market-gain.schemas.js.map +1 -1
  122. package/dist/esm/_core/market/market-icp.schemas.d.ts.map +1 -1
  123. package/dist/esm/_core/market/market-icp.schemas.js +2 -2
  124. package/dist/esm/_core/market/market-icp.schemas.js.map +1 -1
  125. package/dist/esm/_core/market/market-job.schemas.js +2 -2
  126. package/dist/esm/_core/market/market-job.schemas.js.map +1 -1
  127. package/dist/esm/_core/market/market-message-template.schemas.js +2 -2
  128. package/dist/esm/_core/market/market-message-template.schemas.js.map +1 -1
  129. package/dist/esm/_core/market/market-objection.schemas.js +2 -2
  130. package/dist/esm/_core/market/market-objection.schemas.js.map +1 -1
  131. package/dist/esm/_core/market/market-pain.schemas.js +2 -2
  132. package/dist/esm/_core/market/market-pain.schemas.js.map +1 -1
  133. package/dist/esm/_core/market/market-persona.schemas.d.ts.map +1 -1
  134. package/dist/esm/_core/market/market-persona.schemas.js +2 -2
  135. package/dist/esm/_core/market/market-persona.schemas.js.map +1 -1
  136. package/dist/esm/_core/market/market-positioning.schemas.js +2 -2
  137. package/dist/esm/_core/market/market-positioning.schemas.js.map +1 -1
  138. package/dist/esm/_core/market/market-proof.schemas.js +2 -2
  139. package/dist/esm/_core/market/market-proof.schemas.js.map +1 -1
  140. package/dist/esm/_core/market/market-references.schemas.d.ts +6 -0
  141. package/dist/esm/_core/market/market-references.schemas.d.ts.map +1 -1
  142. package/dist/esm/_core/market/market-references.schemas.js +6 -0
  143. package/dist/esm/_core/market/market-references.schemas.js.map +1 -1
  144. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +4 -4
  145. package/dist/esm/_core/market/market-tone-of-voice.schemas.js +2 -2
  146. package/dist/esm/_core/market/market-tone-of-voice.schemas.js.map +1 -1
  147. package/dist/esm/_core/market/market-trigger.schemas.js +2 -2
  148. package/dist/esm/_core/market/market-trigger.schemas.js.map +1 -1
  149. package/dist/esm/_core/market/market.family-aspects.js +1 -1
  150. package/dist/esm/_core/market/market.family-aspects.js.map +1 -1
  151. package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
  152. package/dist/esm/_core/placement-plan/placement-plan.schemas.js +6 -1
  153. package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
  154. package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts +1 -0
  155. package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts.map +1 -1
  156. package/dist/esm/_core/requirements/functional-requirement.schemas.js +8 -0
  157. package/dist/esm/_core/requirements/functional-requirement.schemas.js.map +1 -1
  158. package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts +1 -0
  159. package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts.map +1 -1
  160. package/dist/esm/_core/resource-specification.schemas.d.ts +86 -28
  161. package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
  162. package/dist/esm/_core/resource-specification.schemas.js +110 -24
  163. package/dist/esm/_core/resource-specification.schemas.js.map +1 -1
  164. package/dist/esm/_core/utils/retention-clock-field-specs.d.ts +13 -0
  165. package/dist/esm/_core/utils/retention-clock-field-specs.d.ts.map +1 -0
  166. package/dist/esm/_core/utils/retention-clock-field-specs.js +26 -0
  167. package/dist/esm/_core/utils/retention-clock-field-specs.js.map +1 -0
  168. package/dist/esm/_core/website-plan/website-plan.schemas.d.ts +31 -6
  169. package/dist/esm/_core/website-plan/website-plan.schemas.d.ts.map +1 -1
  170. package/dist/esm/_core/website-plan/website-plan.schemas.js +35 -6
  171. package/dist/esm/_core/website-plan/website-plan.schemas.js.map +1 -1
  172. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.d.ts +142 -3
  173. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.d.ts.map +1 -1
  174. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.js +148 -14
  175. package/dist/esm/application-creation/application-creator-inputs.application-creation.schemas.js.map +1 -1
  176. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +70 -10
  177. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
  178. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +98 -11
  179. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
  180. package/dist/esm/application-creation/application-line.application-creation.schemas.d.ts +215 -0
  181. package/dist/esm/application-creation/application-line.application-creation.schemas.d.ts.map +1 -0
  182. package/dist/esm/application-creation/application-line.application-creation.schemas.js +253 -0
  183. package/dist/esm/application-creation/application-line.application-creation.schemas.js.map +1 -0
  184. package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.d.ts +39 -0
  185. package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.d.ts.map +1 -0
  186. package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.js +37 -0
  187. package/dist/esm/application-creation/application-specification-family-decisions.application-creation.schemas.js.map +1 -0
  188. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts +5 -49
  189. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
  190. package/dist/esm/application-creation/journey.application-creation.schemas.js +25 -60
  191. package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
  192. package/dist/esm/application-creation/playbook-instance.application-creation.schemas.d.ts +28 -0
  193. package/dist/esm/application-creation/playbook-instance.application-creation.schemas.d.ts.map +1 -0
  194. package/dist/esm/application-creation/playbook-instance.application-creation.schemas.js +32 -0
  195. package/dist/esm/application-creation/playbook-instance.application-creation.schemas.js.map +1 -0
  196. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +26 -6
  197. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
  198. package/dist/esm/application-creation/playbooks.application-creation.schemas.js +28 -1
  199. package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
  200. package/dist/esm/application-creation.exports.d.ts +7 -0
  201. package/dist/esm/application-creation.exports.d.ts.map +1 -1
  202. package/dist/esm/application-creation.exports.js +7 -0
  203. package/dist/esm/application-creation.exports.js.map +1 -1
  204. package/dist/esm/assurance/__tests__/authority-evaluation-instant.fixture.d.ts +1 -1
  205. package/dist/esm/assurance/__tests__/authority-evaluation-instant.fixture.js +1 -1
  206. package/dist/esm/assurance/__tests__/authority-evaluation-instant.fixture.js.map +1 -1
  207. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +24 -1
  208. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
  209. package/dist/esm/assurance/assurance-authority-basis.definitions.js +75 -5
  210. package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
  211. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +6 -0
  212. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
  213. package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts +11 -0
  214. package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts.map +1 -1
  215. package/dist/esm/assurance/assurance-document-blueprint-selection.js +22 -3
  216. package/dist/esm/assurance/assurance-document-blueprint-selection.js.map +1 -1
  217. package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
  218. package/dist/esm/assurance/assurance-document-system.definitions.js +39 -6
  219. package/dist/esm/assurance/assurance-document-system.definitions.js.map +1 -1
  220. package/dist/esm/assurance/assurance-document-system.schemas.d.ts +11 -0
  221. package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
  222. package/dist/esm/assurance/assurance-document-system.schemas.js +19 -0
  223. package/dist/esm/assurance/assurance-document-system.schemas.js.map +1 -1
  224. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts.map +1 -1
  225. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js +295 -31
  226. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -1
  227. package/dist/esm/assurance/assurance-foundation.schemas.d.ts +7 -0
  228. package/dist/esm/assurance/assurance-foundation.schemas.d.ts.map +1 -1
  229. package/dist/esm/assurance/assurance-foundation.schemas.js +7 -0
  230. package/dist/esm/assurance/assurance-foundation.schemas.js.map +1 -1
  231. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
  232. package/dist/esm/assurance/assurance-objective-catalog.definitions.js +17 -0
  233. package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
  234. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +5 -1
  235. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -1
  236. package/dist/esm/assurance/assurance-program-generation.schemas.js +6 -3
  237. package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -1
  238. package/dist/esm/assurance/assurance-program.family-aspects.js +1 -1
  239. package/dist/esm/assurance/assurance-program.family-aspects.js.map +1 -1
  240. package/dist/esm/assurance/assurance-program.schemas.d.ts +232 -3
  241. package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
  242. package/dist/esm/assurance/assurance-program.schemas.js +107 -14
  243. package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
  244. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
  245. package/dist/esm/assurance/assurance-source-registry.definitions.js +77 -1
  246. package/dist/esm/assurance/assurance-source-registry.definitions.js.map +1 -1
  247. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts.map +1 -1
  248. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js +23 -1
  249. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -1
  250. package/dist/esm/assurance/governed-document-release.d.ts +7 -0
  251. package/dist/esm/assurance/governed-document-release.d.ts.map +1 -1
  252. package/dist/esm/assurance/governed-document-release.js +11 -2
  253. package/dist/esm/assurance/governed-document-release.js.map +1 -1
  254. package/dist/esm/companion-exports.d.ts +6 -5
  255. package/dist/esm/companion-exports.d.ts.map +1 -1
  256. package/dist/esm/companion-exports.js.map +1 -1
  257. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts +1 -0
  258. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
  259. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +35 -33
  260. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
  261. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map +1 -1
  262. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +6 -2
  263. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
  264. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
  265. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +13 -12
  266. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
  267. package/dist/esm/engine/applications/resources/application-versions.resource.specification.d.ts.map +1 -1
  268. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +26 -2
  269. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
  270. package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts.map +1 -1
  271. package/dist/esm/engine/applications/resources/applications.resource.specification.js +4 -4
  272. package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
  273. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts.map +1 -1
  274. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js +11 -9
  275. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js.map +1 -1
  276. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +2 -2
  277. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
  278. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts +1 -0
  279. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
  280. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +45 -32
  281. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
  282. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts +1 -23
  283. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
  284. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +185 -31
  285. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
  286. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts +2 -1
  287. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -1
  288. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js +29 -7
  289. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -1
  290. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts.map +1 -1
  291. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +7 -1
  292. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
  293. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts.map +1 -1
  294. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +9 -6
  295. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
  296. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts +1 -0
  297. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts.map +1 -1
  298. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +11 -7
  299. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
  300. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.d.ts.map +1 -1
  301. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +18 -16
  302. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
  303. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.d.ts.map +1 -1
  304. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js +9 -11
  305. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js.map +1 -1
  306. package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
  307. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +238 -219
  308. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
  309. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts +0 -24
  310. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
  311. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js +76 -16
  312. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js.map +1 -1
  313. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts +2 -1
  314. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts.map +1 -1
  315. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js +28 -6
  316. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js.map +1 -1
  317. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
  318. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +29 -11
  319. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
  320. package/dist/esm/engine/billing/resources/billing-provider-event-settlements.resource.specification.js +1 -1
  321. package/dist/esm/engine/billing/resources/billing-provider-event-settlements.resource.specification.js.map +1 -1
  322. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts +2 -0
  323. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts.map +1 -1
  324. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js +13 -12
  325. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
  326. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +5 -5
  327. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
  328. package/dist/esm/engine/billing/resources/prices.resource.specification.d.ts.map +1 -1
  329. package/dist/esm/engine/billing/resources/prices.resource.specification.js +12 -9
  330. package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
  331. package/dist/esm/engine/billing/resources/products.resource.specification.d.ts +7 -4
  332. package/dist/esm/engine/billing/resources/products.resource.specification.d.ts.map +1 -1
  333. package/dist/esm/engine/billing/resources/products.resource.specification.js +36 -16
  334. package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
  335. package/dist/esm/engine/billing/resources/promotions.resource.specification.d.ts.map +1 -1
  336. package/dist/esm/engine/billing/resources/promotions.resource.specification.js +13 -10
  337. package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
  338. package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts +13 -8
  339. package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts.map +1 -1
  340. package/dist/esm/engine/billing/resources/referrals.resource.specification.js +54 -20
  341. package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
  342. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts +30 -4
  343. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
  344. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +85 -25
  345. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
  346. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +2 -2
  347. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
  348. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts +15 -2
  349. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts.map +1 -1
  350. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js +45 -10
  351. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js.map +1 -1
  352. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts +15 -2
  353. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts.map +1 -1
  354. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +52 -12
  355. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
  356. package/dist/esm/engine/compliance/resources/index.d.ts +1 -0
  357. package/dist/esm/engine/compliance/resources/index.d.ts.map +1 -1
  358. package/dist/esm/engine/compliance/resources/index.js +1 -0
  359. package/dist/esm/engine/compliance/resources/index.js.map +1 -1
  360. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.d.ts +39 -0
  361. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.d.ts.map +1 -0
  362. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.js +325 -0
  363. package/dist/esm/engine/compliance/resources/legal-holds.resource.specification.js.map +1 -0
  364. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.d.ts +23 -0
  365. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.d.ts.map +1 -0
  366. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.js +197 -0
  367. package/dist/esm/engine/compliance/resources/retention-enforcement-records.resource.specification.js.map +1 -0
  368. package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
  369. package/dist/esm/engine/engine-resource-specifications.registry.js +59 -0
  370. package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
  371. package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
  372. package/dist/esm/engine/errors/error-messages.specification.js +69 -0
  373. package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
  374. package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts +5 -5
  375. package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts.map +1 -1
  376. package/dist/esm/engine/features/resources/application-features.resource.specification.js +9 -10
  377. package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
  378. package/dist/esm/engine/features/resources/organization-features.resource.specification.d.ts +5 -5
  379. package/dist/esm/engine/features/resources/organization-features.resource.specification.js +11 -11
  380. package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
  381. package/dist/esm/engine/features/resources/user-features.resource.specification.d.ts +5 -5
  382. package/dist/esm/engine/features/resources/user-features.resource.specification.js +3 -3
  383. package/dist/esm/engine/features/resources/user-features.resource.specification.js.map +1 -1
  384. package/dist/esm/engine/files/resources/files.resource.specification.d.ts.map +1 -1
  385. package/dist/esm/engine/files/resources/files.resource.specification.js +7 -8
  386. package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
  387. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map +1 -1
  388. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js +16 -4
  389. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
  390. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +1 -1
  391. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
  392. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.d.ts +11 -0
  393. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.d.ts.map +1 -0
  394. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.js +382 -0
  395. package/dist/esm/engine/flows-actors/resources/agent-work-decisions.resource.specification.js.map +1 -0
  396. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts +139 -1
  397. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map +1 -1
  398. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +150 -4
  399. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
  400. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
  401. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js +9 -1
  402. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js.map +1 -1
  403. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.d.ts +3 -0
  404. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.d.ts.map +1 -0
  405. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.js +162 -0
  406. package/dist/esm/engine/flows-actors/resources/model-call-attributions.resource.specification.js.map +1 -0
  407. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.d.ts +3 -0
  408. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.d.ts.map +1 -0
  409. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.js +158 -0
  410. package/dist/esm/engine/flows-actors/resources/model-cost-period-aggregates.resource.specification.js.map +1 -0
  411. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.d.ts +2 -1
  412. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.d.ts.map +1 -1
  413. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.js +16 -9
  414. package/dist/esm/engine/flows-actors/resources/provider-call-records.resource.specification.js.map +1 -1
  415. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.js +1 -1
  416. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.js.map +1 -1
  417. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-request.frontend-component.specification.js +1 -1
  418. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-request.frontend-component.specification.js.map +1 -1
  419. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.d.ts +5 -0
  420. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.d.ts.map +1 -0
  421. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.js +79 -0
  422. package/dist/esm/engine/frontend-components/app/app-layout-agent-work-override-rate-settings.frontend-component.specification.js.map +1 -0
  423. package/dist/esm/engine/frontend-components/app/app-layout-appearance-settings.frontend-component.specification.js +1 -1
  424. package/dist/esm/engine/frontend-components/app/app-layout-appearance-settings.frontend-component.specification.js.map +1 -1
  425. package/dist/esm/engine/frontend-components/app/app-layout-billing-settings.frontend-component.specification.d.ts.map +1 -1
  426. package/dist/esm/engine/frontend-components/app/app-layout-billing-settings.frontend-component.specification.js +3 -1
  427. package/dist/esm/engine/frontend-components/app/app-layout-billing-settings.frontend-component.specification.js.map +1 -1
  428. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts.map +1 -1
  429. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js +5 -4
  430. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js.map +1 -1
  431. package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.js +1 -1
  432. package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.js.map +1 -1
  433. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.js +1 -1
  434. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.js.map +1 -1
  435. package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.js +2 -2
  436. package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.js.map +1 -1
  437. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-number.frontend-component.specification.js +1 -1
  438. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-number.frontend-component.specification.js.map +1 -1
  439. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-string.frontend-component.specification.js +2 -2
  440. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-string.frontend-component.specification.js.map +1 -1
  441. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js +1 -1
  442. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js.map +1 -1
  443. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.js +1 -1
  444. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.js.map +1 -1
  445. package/dist/esm/engine/frontend-components/form/fields/form-field-address.frontend-component.specification.d.ts.map +1 -1
  446. package/dist/esm/engine/frontend-components/form/fields/form-field-address.frontend-component.specification.js +1 -1
  447. package/dist/esm/engine/frontend-components/form/fields/form-field-address.frontend-component.specification.js.map +1 -1
  448. package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.js +2 -2
  449. package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.js.map +1 -1
  450. package/dist/esm/engine/frontend-components/index.d.ts +1 -0
  451. package/dist/esm/engine/frontend-components/index.d.ts.map +1 -1
  452. package/dist/esm/engine/frontend-components/index.js +3 -0
  453. package/dist/esm/engine/frontend-components/index.js.map +1 -1
  454. package/dist/esm/engine/frontend-components/resources/resource-layout-empty-state.frontend-component.specification.js +1 -1
  455. package/dist/esm/engine/frontend-components/resources/resource-layout-empty-state.frontend-component.specification.js.map +1 -1
  456. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-display.frontend-component.specification.js +1 -1
  457. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-display.frontend-component.specification.js.map +1 -1
  458. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit.frontend-component.specification.js +1 -1
  459. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit.frontend-component.specification.js.map +1 -1
  460. package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.d.ts.map +1 -1
  461. package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.js +9 -4
  462. package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.js.map +1 -1
  463. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js +4 -4
  464. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js.map +1 -1
  465. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts.map +1 -1
  466. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js +34 -0
  467. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js.map +1 -1
  468. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts.map +1 -1
  469. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js +26 -0
  470. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
  471. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +2 -2
  472. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
  473. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.d.ts +9 -0
  474. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.d.ts.map +1 -0
  475. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.js +122 -0
  476. package/dist/esm/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.js.map +1 -0
  477. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.d.ts +9 -0
  478. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.d.ts.map +1 -0
  479. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.js +152 -0
  480. package/dist/esm/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.js.map +1 -0
  481. package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.d.ts +10 -0
  482. package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.d.ts.map +1 -0
  483. package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.js +94 -0
  484. package/dist/esm/engine/infrastructure/resources/external-data-pending-references.resource.specification.js.map +1 -0
  485. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.d.ts +10 -0
  486. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.d.ts.map +1 -0
  487. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.js +64 -0
  488. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership-keys.resource.specification.js.map +1 -0
  489. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.d.ts +4 -1
  490. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.d.ts.map +1 -1
  491. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.js +20 -16
  492. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-membership.resource.specification.js.map +1 -1
  493. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.d.ts +9 -0
  494. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.d.ts.map +1 -0
  495. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.js +200 -0
  496. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-run-records.resource.specification.js.map +1 -0
  497. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.d.ts.map +1 -1
  498. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +19 -6
  499. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
  500. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.d.ts +9 -0
  501. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.d.ts.map +1 -0
  502. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.js +97 -0
  503. package/dist/esm/engine/infrastructure/resources/external-data-remote-versions.resource.specification.js.map +1 -0
  504. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts +8 -0
  505. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts.map +1 -1
  506. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js +2 -2
  507. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js.map +1 -1
  508. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts +8 -8
  509. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +1 -1
  510. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
  511. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.js +4 -4
  512. package/dist/esm/engine/infrastructure/resources/system-of-record-partition-assignments.resource.specification.js.map +1 -1
  513. package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.d.ts +9 -0
  514. package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.d.ts.map +1 -0
  515. package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.js +153 -0
  516. package/dist/esm/engine/infrastructure/resources/system-of-record-write-admissions.resource.specification.js.map +1 -0
  517. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.d.ts +81 -0
  518. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.d.ts.map +1 -0
  519. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.js +437 -0
  520. package/dist/esm/engine/notifications/resources/conversation-threads.resource.specification.js.map +1 -0
  521. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.d.ts +112 -0
  522. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.d.ts.map +1 -0
  523. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.js +287 -0
  524. package/dist/esm/engine/notifications/resources/inbound-deliveries.resource.specification.js.map +1 -0
  525. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.d.ts +131 -0
  526. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.d.ts.map +1 -0
  527. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.js +594 -0
  528. package/dist/esm/engine/notifications/resources/inbound-email.resource.specification.js.map +1 -0
  529. package/dist/esm/engine/notifications/resources/index.d.ts +1 -0
  530. package/dist/esm/engine/notifications/resources/index.d.ts.map +1 -1
  531. package/dist/esm/engine/notifications/resources/index.js +1 -0
  532. package/dist/esm/engine/notifications/resources/index.js.map +1 -1
  533. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts +6 -3
  534. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
  535. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +20 -5
  536. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
  537. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts.map +1 -1
  538. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js +12 -2
  539. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js.map +1 -1
  540. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts +6 -6
  541. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
  542. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +8 -11
  543. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
  544. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.d.ts +4 -0
  545. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.d.ts.map +1 -0
  546. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.js +62 -0
  547. package/dist/esm/engine/notifications/system-emails/human-decision.system-emails.specification.js.map +1 -0
  548. package/dist/esm/engine/notifications/system-emails/index.d.ts +2 -1
  549. package/dist/esm/engine/notifications/system-emails/index.d.ts.map +1 -1
  550. package/dist/esm/engine/notifications/system-emails/index.js +4 -2
  551. package/dist/esm/engine/notifications/system-emails/index.js.map +1 -1
  552. package/dist/esm/engine/organizations/resources/index.d.ts +2 -0
  553. package/dist/esm/engine/organizations/resources/index.d.ts.map +1 -1
  554. package/dist/esm/engine/organizations/resources/index.js +2 -0
  555. package/dist/esm/engine/organizations/resources/index.js.map +1 -1
  556. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts +3 -0
  557. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts.map +1 -1
  558. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +40 -12
  559. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
  560. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js +2 -2
  561. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js.map +1 -1
  562. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js +2 -2
  563. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js.map +1 -1
  564. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts +0 -1
  565. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts.map +1 -1
  566. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +4 -6
  567. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
  568. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts.map +1 -1
  569. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +7 -3
  570. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
  571. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.d.ts.map +1 -1
  572. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js +15 -8
  573. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js.map +1 -1
  574. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts +3 -1
  575. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts.map +1 -1
  576. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +36 -21
  577. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
  578. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.d.ts +38 -0
  579. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.d.ts.map +1 -0
  580. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.js +152 -0
  581. package/dist/esm/engine/organizations/resources/service-provider-activity-feed.resource.specification.js.map +1 -0
  582. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.d.ts +106 -0
  583. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.d.ts.map +1 -0
  584. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.js +417 -0
  585. package/dist/esm/engine/organizations/resources/service-provider-relationships.resource.specification.js.map +1 -0
  586. package/dist/esm/engine/providers/apple.provider.specification.js +1 -1
  587. package/dist/esm/engine/providers/apple.provider.specification.js.map +1 -1
  588. package/dist/esm/engine/providers/github.provider.specification.js +1 -1
  589. package/dist/esm/engine/providers/github.provider.specification.js.map +1 -1
  590. package/dist/esm/engine/providers/google-places.provider.specification.d.ts +6 -0
  591. package/dist/esm/engine/providers/google-places.provider.specification.d.ts.map +1 -0
  592. package/dist/esm/engine/providers/google-places.provider.specification.js +44 -0
  593. package/dist/esm/engine/providers/google-places.provider.specification.js.map +1 -0
  594. package/dist/esm/engine/providers/google.provider.specification.js +1 -1
  595. package/dist/esm/engine/providers/google.provider.specification.js.map +1 -1
  596. package/dist/esm/engine/providers/index.d.ts +2 -0
  597. package/dist/esm/engine/providers/index.d.ts.map +1 -1
  598. package/dist/esm/engine/providers/index.js +5 -1
  599. package/dist/esm/engine/providers/index.js.map +1 -1
  600. package/dist/esm/engine/providers/microsoft.provider.specification.d.ts.map +1 -1
  601. package/dist/esm/engine/providers/microsoft.provider.specification.js +10 -6
  602. package/dist/esm/engine/providers/microsoft.provider.specification.js.map +1 -1
  603. package/dist/esm/engine/providers/recaptcha.provider.specification.d.ts +6 -0
  604. package/dist/esm/engine/providers/recaptcha.provider.specification.d.ts.map +1 -0
  605. package/dist/esm/engine/providers/recaptcha.provider.specification.js +38 -0
  606. package/dist/esm/engine/providers/recaptcha.provider.specification.js.map +1 -0
  607. package/dist/esm/engine/providers/resend.provider.specification.d.ts.map +1 -1
  608. package/dist/esm/engine/providers/resend.provider.specification.js +3 -1
  609. package/dist/esm/engine/providers/resend.provider.specification.js.map +1 -1
  610. package/dist/esm/engine/providers/stripe.provider.specification.d.ts.map +1 -1
  611. package/dist/esm/engine/providers/stripe.provider.specification.js +3 -2
  612. package/dist/esm/engine/providers/stripe.provider.specification.js.map +1 -1
  613. package/dist/esm/engine/roles/app-billing-provider-events.role.specification.d.ts +2 -0
  614. package/dist/esm/engine/roles/app-billing-provider-events.role.specification.d.ts.map +1 -0
  615. package/dist/esm/engine/roles/app-billing-provider-events.role.specification.js +21 -0
  616. package/dist/esm/engine/roles/app-billing-provider-events.role.specification.js.map +1 -0
  617. package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.d.ts +2 -0
  618. package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.d.ts.map +1 -0
  619. package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.js +21 -0
  620. package/dist/esm/engine/roles/app-email-inbound-intake.role.specification.js.map +1 -0
  621. package/dist/esm/engine/roles/index.d.ts +13 -5
  622. package/dist/esm/engine/roles/index.d.ts.map +1 -1
  623. package/dist/esm/engine/roles/index.js +19 -6
  624. package/dist/esm/engine/roles/index.js.map +1 -1
  625. package/dist/esm/engine/roles/org-billing-provider-events.role.specification.d.ts +2 -0
  626. package/dist/esm/engine/roles/org-billing-provider-events.role.specification.d.ts.map +1 -0
  627. package/dist/esm/engine/roles/org-billing-provider-events.role.specification.js +21 -0
  628. package/dist/esm/engine/roles/org-billing-provider-events.role.specification.js.map +1 -0
  629. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.d.ts +7 -0
  630. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.d.ts.map +1 -0
  631. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.js +72 -0
  632. package/dist/esm/engine/roles/org-delegated-capabilities.role.specification.js.map +1 -0
  633. package/dist/esm/engine/roles/org-service-provider.role.specification.d.ts +2 -0
  634. package/dist/esm/engine/roles/org-service-provider.role.specification.d.ts.map +1 -0
  635. package/dist/esm/engine/roles/org-service-provider.role.specification.js +22 -0
  636. package/dist/esm/engine/roles/org-service-provider.role.specification.js.map +1 -0
  637. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js +2 -2
  638. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
  639. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +3 -3
  640. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
  641. package/dist/esm/engine/users/resources/self-service-user-notifications.shared.d.ts +1 -1
  642. package/dist/esm/engine/users/resources/self-service-user-notifications.shared.d.ts.map +1 -1
  643. package/dist/esm/engine/users/resources/self-service-user-notifications.shared.js +3 -6
  644. package/dist/esm/engine/users/resources/self-service-user-notifications.shared.js.map +1 -1
  645. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js +2 -2
  646. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
  647. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +2 -2
  648. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
  649. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts +0 -4
  650. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts.map +1 -1
  651. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.js +0 -3
  652. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.js.map +1 -1
  653. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +0 -3
  654. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts.map +1 -1
  655. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +7 -7
  656. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
  657. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +5 -5
  658. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
  659. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +0 -3
  660. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
  661. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +11 -18
  662. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
  663. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js +6 -6
  664. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js.map +1 -1
  665. package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts.map +1 -1
  666. package/dist/esm/engine/users/resources/user-self.resource.specification.js +5 -1
  667. package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
  668. package/dist/esm/engine/users/resources/users.resource.specification.d.ts +8 -5
  669. package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
  670. package/dist/esm/engine/users/resources/users.resource.specification.js +49 -16
  671. package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
  672. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
  673. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +29 -10
  674. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
  675. package/dist/tsconfig.build.tsbuildinfo +1 -1
  676. package/package.json +8 -8
  677. package/dist/assurance/external-framework-mapping.json +0 -1228
@@ -1 +1 @@
1
- {"version":3,"file":"data-seed-runs.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/data-seed-runs.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n DataSeedMode,\n DataSeedRunSchema,\n DataSeedRunStatus,\n DataSeedRunVariantKey,\n DataSeedScopeKind,\n DataSeedTriggerOrigin,\n dataSeedRunResourceConfiguration_InitializationFactory as dataSeedRunFactory,\n} from '@wildo-ai/saas-backend-lib/data-seeding-models';\nimport { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { type AnyResourceSpecificationConfig, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for the internal `dataSeedRuns` resource — the\n * persistence ledger the data-seeding dispatcher writes one row to per pass.\n *\n * Like `jobExecutions`, this is a platform/infrastructure truth source rather\n * than an end-user surface: its useful semantic layer is the operational model\n * (did this seed already run for this scope at this version, and what did the\n * pass do?), not UI narration. Its only human-facing surface is the back-office\n * ADMIN read/search path and the `DELETE` re-run gesture.\n *\n * Authored 2026-08-21 because the label generator was producing this resource's\n * ~1000 keys with NO spec context at all — the companion logged\n * `No resource specification found for \"dataSeedRuns\"` on every run and invented\n * terminology from bare field names. The counters in particular (`entriesUpdated`\n * vs `entriesUpgraded` vs `entriesSkipped`) are indistinguishable without the\n * per-mode contract stated below.\n *\n * NOTE ON THE REGISTRY KEY: `dataSeedRuns` is a `BackendResourceType`, not a\n * `CoreResourceType`, so its schema and factory live in `@wildo-ai/saas-backend-lib`\n * rather than `@wildo-ai/saas-models`, and its entry in\n * `engineResourceSpecificationsByType` is keyed by the literal resource-type\n * string. The registry is typed `Record<string, …>`, and the runtime-scope\n * alignment guard intersects specs with the CORE registry, so this resource is\n * correctly outside that guard's population rather than silently breaking it.\n *\n * WHY THIS ONE SPEC CARRIES AN EXPLICIT TYPE ANNOTATION (the other 58 do not).\n *\n * `resourceSpecification` returns `ResourceSpecificationConfig<TCustomOp, TCoreOp, TSchema>`,\n * so an unannotated spec exports a type whose arguments are named from wherever its schema\n * and factory live. For every other engine spec that is `@wildo-ai/saas-models`, which this\n * package depends on directly and can always name. This resource is the sole exception — its\n * schema and factory come from `@wildo-ai/saas-backend-lib/data-seeding-models`, because\n * `dataSeedRuns` is a `BackendResourceType` (see the registry note above). That made the\n * inferred type unnameable except through a non-portable nested path\n * (`node_modules/@wildo-ai/saas-frontend-lib/node_modules/@wildo-ai/saas-models/src`), which\n * `isolatedDeclarations`-style declaration emit rejects with TS2742.\n *\n * The annotation is NOT merely a workaround for that. The same declaration also tripped TS7056\n * (`inferred type ... exceeds the maximum length the compiler will serialize`) — this resource\n * authors on the order of a thousand field-spec keys — and TS7056 has no remedy other than an\n * explicit annotation. No amount of dependency or entrypoint surgery removes it, so an\n * annotation is required here regardless of how the package boundary is drawn.\n *\n * `AnyResourceSpecificationConfig` loses nothing at the only consumption point. The sole\n * consumer is `engineResourceSpecificationsByType`, declared `ResourceSpecification`\n * (= `Record<string, AnyResourceSpecificationConfig>`), so the precise generic instantiation\n * was already erased there. Authoring-time checking of the callback body is unaffected: the\n * `resourceSpecification(...)` call still infers `TSchema` from `DataSeedRunSchema` and\n * type-checks the config against it before the annotation widens the exported binding.\n *\n * If a future spec also sources its schema from a package other than `saas-models`, it will hit\n * the same wall and should follow this pattern rather than re-deriving it.\n */\nexport const dataSeedRunsResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n dataSeedRunFactory,\n DataSeedRunSchema,\n ({ schemaShape }) => ({\n purpose: 'Record one pass of the data-seeding dispatcher so the platform knows whether a seed has already been applied to a given scope at a given version.',\n businessRole: 'Operational control-plane ledger used to make seeding idempotent across restarts, and to troubleshoot what a seeding pass inserted, upgraded, skipped, or failed on.',\n lifecycleRole: 'Opens as a running pass when the dispatcher starts, then settles once into completed, partial, or failed. Deleting a settled row is the supported gesture for making the next pass treat that scope as un-run.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.INFRASTRUCTURE,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedRunSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'dataSeedRunResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'BackendResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'DATA_SEED_RUN',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Stable identifier of one recorded seeding pass.',\n whyItMatters: 'It is what an operator addresses when deleting a settled pass to force the next dispatcher run to re-apply that seed.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n seedKey: schemaShape.seedKey.stringSpec({\n meaning: 'Stable name of the seed declaration this pass executed.',\n whyItMatters: 'It is the primary way an operator groups the history of one seed across every scope and version it has been applied to.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n seedVersion: schemaShape.seedVersion.numberSpec({\n meaning: 'The version the seed declaration carried when this pass ran.',\n whyItMatters: 'Raising the declared version is how a developer asks for a re-run; the dispatcher decides by comparing the declared version against the highest version already recorded as completed for the same scope.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n mode: schemaShape.mode.enumSpec({\n meaning: 'The reconciliation strategy the pass applied to the declared entries.',\n whyItMatters: 'It determines which counters below can be non-zero and whether rows outside the declared set were touched at all, so it is the first thing to read when a pass did something unexpected.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedMode',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedMode.LAZY]: { meaning: 'Create the entry the first time the scope is accessed if it is missing. Always safe to repeat.' },\n [DataSeedMode.ADDITIVE]: { meaning: 'Insert entries that are absent and re-apply the declared payload to entries that are present. Never removes anything and never walks records outside the declared set.' },\n [DataSeedMode.UPGRADE]: { meaning: 'Insert entries that are absent and migrate entries whose recorded version is behind the declared one.' },\n [DataSeedMode.SYNC]: { meaning: 'Treat the declared entries as the full truth: insert what is missing, update what changed, and handle records that are no longer declared according to the seed orphan policy.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n scopeKind: schemaShape.scopeKind.enumSpec({\n meaning: 'The unit this pass seeded — the whole database, one application, one organization, one user, or one record of some other resource type.',\n whyItMatters: 'Seeding is idempotent per scope, so the scope is half of the answer to \"has this already run?\".',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedScopeKind',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedScopeKind.GLOBAL]: { meaning: 'Applied once for the whole database. There is no anchor record.' },\n [DataSeedScopeKind.APPLICATION]: { meaning: 'Applied once per application.' },\n [DataSeedScopeKind.ORGANIZATION]: { meaning: 'Applied once per organization.' },\n [DataSeedScopeKind.USER]: { meaning: 'Applied once per user.' },\n [DataSeedScopeKind.CUSTOM]: { meaning: 'Applied once per record of some other resource type, which is named separately on the pass.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n relatedResourceType: schemaShape.relatedResourceType.stringSpec({\n meaning: 'The resource type whose record anchors a custom-scope pass. Empty for the built-in scopes, whose resource is implied by the scope itself.',\n whyItMatters: 'Two custom-scope seeds can legitimately anchor on the same row identifier under different resource types, so this is what keeps their histories apart.',\n }),\n\n relatedId: schemaShape.relatedId.stringSpec({\n meaning: 'Identifier of the record that anchors this scope. Empty only for a database-wide pass, which has no anchor.',\n whyItMatters: 'It is what narrows the ledger from \"every run of this seed\" to \"the run for this particular organization, user, or row\".',\n semanticRole: 'identifier',\n }),\n\n triggerOrigin: schemaShape.triggerOrigin.enumSpec({\n meaning: 'Coarse classification of what caused the dispatcher to fire.',\n whyItMatters: 'It is the filterable form of the trigger, so history can be narrowed to one pathway without reading the trigger declaration on every row.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedTriggerOrigin',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedTriggerOrigin.APP_INIT]: { meaning: 'Fired while the application was starting up.' },\n [DataSeedTriggerOrigin.APP_VERSION_UPGRADE]: { meaning: 'Fired because the application moved to a new version.' },\n [DataSeedTriggerOrigin.RESOURCE_LIFECYCLE]: { meaning: 'Fired by a write to the resource that anchors the scope, such as a new organization being created.' },\n [DataSeedTriggerOrigin.LAZY_ACCESS]: { meaning: 'Fired the first time something read the scope and the seeded data was not there yet.' },\n [DataSeedTriggerOrigin.CRON]: { meaning: 'Reserved for a cron primitive that fires outside a declared seed schedule. No current caller.' },\n [DataSeedTriggerOrigin.ADMIN_MANUAL]: { meaning: 'Fired by an administrator asking for the seed to be run.' },\n [DataSeedTriggerOrigin.SCHEDULED_RERUN]: { meaning: 'Fired by the platform because the seed declaration\\'s own schedule matched the current tick.' },\n },\n }),\n\n triggeredByUserId: schemaShape.triggeredByUserId.stringSpec({\n meaning: 'The user whose action caused the dispatcher to fire. Empty for passes the platform started on its own.',\n whyItMatters: 'It is attribution only, never authority: the seed itself always runs with internal system permissions regardless of who triggered it.',\n semanticRole: 'identifier',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Outcome of the pass.',\n whyItMatters: 'It is the signal the dispatcher itself reads to decide whether a scope still needs seeding, and the first thing an operator filters on.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedRunStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedRunStatus.RUNNING]: { meaning: 'The pass started and has not settled. A pass left in this state by a crash is superseded by the next pass rather than timing out.' },\n [DataSeedRunStatus.COMPLETED]: { meaning: 'Every declared entry succeeded.' },\n [DataSeedRunStatus.PARTIAL]: { meaning: 'At least one entry failed but the pass carried on and reported the rest.' },\n [DataSeedRunStatus.FAILED]: { meaning: 'The pass itself stopped before finishing.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n startedAt: schemaShape.startedAt.dateSpec({\n meaning: 'When the pass began.',\n }),\n\n finishedAt: schemaShape.finishedAt.dateSpec({\n meaning: 'When the pass settled. Empty while it is still running.',\n whyItMatters: 'The gap between this and the start time is the only duration signal for a seeding pass.',\n }),\n\n entriesAttempted: schemaShape.entriesAttempted.numberSpec({\n meaning: 'How many declared entries the pass walked. Counted before each entry is tried, so it matches the declared set whatever the outcome.',\n whyItMatters: 'When it does not match the number of entries in the declaration, the declaration and the deployed code have drifted apart.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n entriesInserted: schemaShape.entriesInserted.numberSpec({\n meaning: 'How many declared entries were written because no matching record existed.',\n }),\n\n entriesUpdated: schemaShape.entriesUpdated.numberSpec({\n meaning: 'How many already-present records had the declared payload re-applied to them.',\n whyItMatters: 'This is the additive-mode counter. A version migration is counted separately, so a non-zero value here means the payload was re-stamped, not migrated.',\n }),\n\n entriesUpgraded: schemaShape.entriesUpgraded.numberSpec({\n meaning: 'How many present records were behind the declared version and were migrated forward.',\n }),\n\n entriesRenamed: schemaShape.entriesRenamed.numberSpec({\n meaning: 'How many records were relocated from a previous identity because the declaration renamed them.',\n }),\n\n entriesSkipped: schemaShape.entriesSkipped.numberSpec({\n meaning: 'How many declared entries the pass deliberately left untouched — already current, or protected from being moved backwards.',\n whyItMatters: 'Skipping is a normal outcome, not a failure; the reason for each skip is reported separately.',\n }),\n\n entriesDeleted: schemaShape.entriesDeleted.numberSpec({\n meaning: 'How many records outside the declared set were removed. Only a full-reconciliation pass configured to delete can produce this.',\n }),\n\n entriesDeprecated: schemaShape.entriesDeprecated.numberSpec({\n meaning: 'How many records outside the declared set were marked deprecated instead of removed.',\n }),\n\n entriesReportedOrphans: schemaShape.entriesReportedOrphans.numberSpec({\n meaning: 'How many records outside the declared set were only reported, leaving the records themselves untouched.',\n }),\n\n entriesFailed: schemaShape.entriesFailed.numberSpec({\n meaning: 'How many entries could not be written. The pass continues and settles as partial.',\n whyItMatters: 'It is the count behind a partial outcome; the per-entry detail lives in the report below.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n failureReport: schemaShape.failureReport.objectSpec({\n meaning: 'Detailed breakdown of everything non-trivial the pass encountered: which entries failed and why, which records fell outside the declared set, and any error that stopped the pass as a whole. Empty when everything succeeded.',\n whyItMatters: 'It is what lets an operator diagnose a partial or failed pass without going to application logs.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n },\n\n /**\n * `trigger` is documented here rather than in `fields` because it is a\n * DISCRIMINATED UNION, and the spec decorators are declared on `ZodObject`\n * / `ZodUnion` but not on `ZodDiscriminatedUnion` — `schemaShape.trigger.objectSpec(...)`\n * does not type-check. Without an entry of some kind the field would reach the\n * label generator as a bare name and the generator would invent terminology for\n * it (the same failure mode `RETENTION_MARKER_FIELD_SPECS` documents), so the\n * meaning is declared through the escape hatch instead of dropped.\n */\n additionalFieldSpecs: [\n {\n fieldName: 'trigger',\n specDecorator: 'objectSpec',\n params: {\n meaning: 'The full trigger declaration that caused this pass, copied verbatim from the seed definition.',\n whyItMatters: 'Its shape varies by what fired the pass, so it carries the detail — the lifecycle event, the schedule, the access path — that the coarse trigger origin deliberately flattens away.',\n },\n },\n ],\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Open the ledger row for a seeding pass that is about to start.',\n outcome: 'The pass becomes visible as running before it touches any data, so a crash mid-pass leaves a trace rather than nothing.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The pass was recorded as running and the record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The pass description fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher open its own ledger row. There is no externally reachable way to create one.',\n },\n },\n },\n\n [Op.READ]: {\n purpose: 'Read one recorded seeding pass.',\n outcome: 'The caller can inspect exactly what one pass did to one scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The recorded pass was found and is returned with its counters and report.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier — never recorded, or already removed by an administrator or by history cleanup.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator. This ledger is never exposed to ordinary tenant callers.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher recover a previous attempt before writing the outcome of the current one.',\n },\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator inspect one pass from the back office.',\n },\n },\n },\n\n [Op.UPDATE]: {\n purpose: 'Settle a running pass with its outcome and counters.',\n outcome: 'The ledger stops saying the pass is in flight and starts being the answer to whether the seed already applied.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The pass recorded its outcome, timing, counters and failure report, and the settled record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier to settle.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The outcome fails schema validation, for example an unrecognized status.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A caller outside the dispatcher attempts to rewrite a pass outcome.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher write the terminal outcome of the pass it opened.',\n whenToUse: 'Use when a pass has finished walking its entries, whether it succeeded, partially succeeded, or stopped.',\n },\n },\n },\n\n [Op.DELETE]: {\n purpose: 'Remove a recorded pass so the next dispatcher run treats that scope as never seeded.',\n outcome: 'The seed is re-applied to that scope on the next run, without editing or re-deploying the seed declaration.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The recorded pass was removed and the scope is eligible for seeding again.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Give a platform administrator the supported re-run gesture.',\n whenToUse: 'Use when a seed must be applied again to one scope and raising the declared version would wrongly re-run it everywhere. The dispatcher never deletes its own history.',\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate recorded seeding passes.',\n outcome: 'The caller sees seeding history as a set rather than one pass at a time.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A page of recorded passes, possibly empty, narrowed by the requested seed, scope, status, or trigger filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator authorized to enumerate seeding history.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher enumerate prior passes while deciding whether a scope still needs seeding.',\n },\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator browse seeding history from the back office.',\n },\n },\n },\n\n [Op.COUNT]: {\n purpose: 'Count recorded passes matching a set of conditions.',\n outcome: 'The dispatcher can answer \"has any completed pass already covered this scope?\" without loading the rows.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The number of recorded passes matching the conditions.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Back the dispatcher\\'s already-seeded check, which needs only a yes or no and never the rows themselves.',\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Search seeding history by seed name or anchor row.',\n outcome: 'An administrator can narrow history to the passes relevant to one seed or one affected row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A page of recorded passes, possibly empty, matching the search term and any filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator authorized to query seeding history.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator find passes by seed name or by the row a pass was anchored to.',\n whenToUse: 'Use when troubleshooting starts from \"which seed touched this row\" rather than from a known pass identifier.',\n },\n },\n },\n },\n\n businessConstraints: [\n 'This ledger records what a seeding pass did. It is never the source of truth for the data the seed produced — that lives on the seeded rows themselves.',\n 'A pass is identified by its seed, its scope, and its declared version together. That identity is what makes seeding safe to repeat, so it must not be widened or narrowed casually.',\n 'Who triggered a pass is recorded for attribution only. Seeding always runs with internal system permissions, so the recorded user never confers authority.',\n 'Removing a recorded pass is a deliberate administrative re-run gesture. The dispatcher itself never deletes its own history, because the history is what makes the next decision correct.',\n ],\n }),\n // DATA_SEED_RUN is a STANDALONE infrastructure ledger reached only through\n // internal repository services and a platform-administrator back-office path.\n // The `APPLICATION → DATA_SEED_RUN` relationship is routing-side only (the row\n // carries no application identifier of its own), which is why the scope is\n // declared here rather than derived from a scope-owning parent.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
1
+ {"version":3,"file":"data-seed-runs.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/data-seed-runs.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n DataSeedMode,\n DataSeedRunSchema,\n DataSeedRunStatus,\n DataSeedRunVariantKey,\n DataSeedScopeKind,\n DataSeedTriggerOrigin,\n dataSeedRunResourceConfiguration_InitializationFactory as dataSeedRunFactory,\n} from '@wildo-ai/saas-backend-lib/data-seeding-models';\nimport { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { type AnyResourceSpecificationConfig, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for the internal `dataSeedRuns` resource — the\n * persistence ledger the data-seeding dispatcher writes one row to per pass.\n *\n * Like `jobExecutions`, this is a platform/infrastructure truth source rather\n * than an end-user surface: its useful semantic layer is the operational model\n * (did this seed already run for this scope at this version, and what did the\n * pass do?), not UI narration. Its only human-facing surface is the back-office\n * ADMIN read/search path and the `DELETE` re-run gesture.\n *\n * Authored 2026-08-21 because the label generator was producing this resource's\n * ~1000 keys with NO spec context at all — the companion logged\n * `No resource specification found for \"dataSeedRuns\"` on every run and invented\n * terminology from bare field names. The counters in particular (`entriesUpdated`\n * vs `entriesUpgraded` vs `entriesSkipped`) are indistinguishable without the\n * per-mode contract stated below.\n *\n * NOTE ON THE REGISTRY KEY: `dataSeedRuns` is a `BackendResourceType`, not a\n * `CoreResourceType`, so its schema and factory live in `@wildo-ai/saas-backend-lib`\n * rather than `@wildo-ai/saas-models`, and its entry in\n * `engineResourceSpecificationsByType` is keyed by the literal resource-type\n * string. The registry is typed `Record<string, …>`, and the runtime-scope\n * alignment guard intersects specs with the CORE registry, so this resource is\n * correctly outside that guard's population rather than silently breaking it.\n *\n * WHY THIS ONE SPEC CARRIES AN EXPLICIT TYPE ANNOTATION (the other 58 do not).\n *\n * `resourceSpecification` returns `ResourceSpecificationConfig<TCustomOp, TCoreOp, TSchema>`,\n * so an unannotated spec exports a type whose arguments are named from wherever its schema\n * and factory live. For every other engine spec that is `@wildo-ai/saas-models`, which this\n * package depends on directly and can always name. This resource is the sole exception — its\n * schema and factory come from `@wildo-ai/saas-backend-lib/data-seeding-models`, because\n * `dataSeedRuns` is a `BackendResourceType` (see the registry note above). That made the\n * inferred type unnameable except through a non-portable nested path\n * (`node_modules/@wildo-ai/saas-frontend-lib/node_modules/@wildo-ai/saas-models/src`), which\n * `isolatedDeclarations`-style declaration emit rejects with TS2742.\n *\n * The annotation is NOT merely a workaround for that. The same declaration also tripped TS7056\n * (`inferred type ... exceeds the maximum length the compiler will serialize`) — this resource\n * authors on the order of a thousand field-spec keys — and TS7056 has no remedy other than an\n * explicit annotation. No amount of dependency or entrypoint surgery removes it, so an\n * annotation is required here regardless of how the package boundary is drawn.\n *\n * `AnyResourceSpecificationConfig` loses nothing at the only consumption point. The sole\n * consumer is `engineResourceSpecificationsByType`, declared `ResourceSpecification`\n * (= `Record<string, AnyResourceSpecificationConfig>`), so the precise generic instantiation\n * was already erased there. Authoring-time checking of the callback body is unaffected: the\n * `resourceSpecification(...)` call still infers `TSchema` from `DataSeedRunSchema` and\n * type-checks the config against it before the annotation widens the exported binding.\n *\n * If a future spec also sources its schema from a package other than `saas-models`, it will hit\n * the same wall and should follow this pattern rather than re-deriving it.\n */\nexport const dataSeedRunsResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n dataSeedRunFactory,\n DataSeedRunSchema,\n ({ schemaShape }) => ({\n purpose: 'Record one pass of the data-seeding dispatcher so the platform knows whether a seed has already been applied to a given scope at a given version.',\n businessRole: 'Operational control-plane ledger used to make seeding idempotent across restarts, and to troubleshoot what a seeding pass inserted, upgraded, skipped, or failed on.',\n lifecycleRole: 'Opens as a running pass when the dispatcher starts, then settles once into completed, partial, or failed. Deleting a settled row is the supported gesture for making the next pass treat that scope as un-run.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.INFRASTRUCTURE,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedRunSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'dataSeedRunResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'BackendResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'DATA_SEED_RUN',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Stable identifier of one recorded seeding pass.',\n whyItMatters: 'It is what an operator addresses when deleting a settled pass to force the next dispatcher run to re-apply that seed.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n seedKey: schemaShape.seedKey.stringSpec({\n meaning: 'Stable name of the seed declaration this pass executed.',\n whyItMatters: 'It is the primary way an operator groups the history of one seed across every scope and version it has been applied to.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n seedVersion: schemaShape.seedVersion.numberSpec({\n meaning: 'The version the seed declaration carried when this pass ran.',\n whyItMatters: 'Raising the declared version is how a developer asks for a re-run; the dispatcher decides by comparing the declared version against the highest version already recorded as completed for the same scope.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n mode: schemaShape.mode.enumSpec({\n meaning: 'The reconciliation strategy the pass applied to the declared entries.',\n whyItMatters: 'It determines which counters below can be non-zero and whether rows outside the declared set were touched at all, so it is the first thing to read when a pass did something unexpected.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedMode',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedMode.LAZY]: { meaning: 'Create the entry the first time the scope is accessed if it is missing. Always safe to repeat.' },\n [DataSeedMode.ADDITIVE]: { meaning: 'Insert entries that are absent and re-apply the declared payload to entries that are present. Never removes anything and never walks records outside the declared set.' },\n [DataSeedMode.UPGRADE]: { meaning: 'Insert entries that are absent and migrate entries whose recorded version is behind the declared one.' },\n [DataSeedMode.SYNC]: { meaning: 'Treat the declared entries as the full truth: insert what is missing, update what changed, and handle records that are no longer declared according to the seed orphan policy.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n scopeKind: schemaShape.scopeKind.enumSpec({\n meaning: 'The unit this pass seeded — the whole database, one application, one organization, one user, or one record of some other resource type.',\n whyItMatters: 'Seeding is idempotent per scope, so the scope is half of the answer to \"has this already run?\".',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedScopeKind',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedScopeKind.GLOBAL]: { meaning: 'Applied once for the whole database. There is no anchor record.' },\n [DataSeedScopeKind.APPLICATION]: { meaning: 'Applied once per application.' },\n [DataSeedScopeKind.ORGANIZATION]: { meaning: 'Applied once per organization.' },\n [DataSeedScopeKind.USER]: { meaning: 'Applied once per user.' },\n [DataSeedScopeKind.CUSTOM]: { meaning: 'Applied once per record of some other resource type, which is named separately on the pass.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n relatedResourceType: schemaShape.relatedResourceType.stringSpec({\n meaning: 'The resource type whose record anchors a custom-scope pass. Empty for the built-in scopes, whose resource is implied by the scope itself.',\n whyItMatters: 'Two custom-scope seeds can legitimately anchor on the same row identifier under different resource types, so this is what keeps their histories apart.',\n }),\n\n relatedId: schemaShape.relatedId.stringSpec({\n meaning: 'Identifier of the record that anchors this scope. Empty only for a database-wide pass, which has no anchor.',\n whyItMatters: 'It is what narrows the ledger from \"every run of this seed\" to \"the run for this particular organization, user, or row\".',\n semanticRole: 'identifier',\n }),\n\n triggerOrigin: schemaShape.triggerOrigin.enumSpec({\n meaning: 'Coarse classification of what caused the dispatcher to fire.',\n whyItMatters: 'It is the filterable form of the trigger, so history can be narrowed to one pathway without reading the trigger declaration on every row.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedTriggerOrigin',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedTriggerOrigin.APP_INIT]: { meaning: 'Fired while the application was starting up.' },\n [DataSeedTriggerOrigin.APP_VERSION_UPGRADE]: { meaning: 'Fired because the application moved to a new version.' },\n [DataSeedTriggerOrigin.RESOURCE_LIFECYCLE]: { meaning: 'Fired by a write to the resource that anchors the scope, such as a new organization being created.' },\n [DataSeedTriggerOrigin.LAZY_ACCESS]: { meaning: 'Fired the first time something read the scope and the seeded data was not there yet.' },\n [DataSeedTriggerOrigin.CRON]: { meaning: 'Reserved for a cron primitive that fires outside a declared seed schedule. No current caller.' },\n [DataSeedTriggerOrigin.ADMIN_MANUAL]: { meaning: 'Fired by an administrator asking for the seed to be run.' },\n [DataSeedTriggerOrigin.SCHEDULED_RERUN]: { meaning: 'Fired by the platform because the seed declaration\\'s own schedule matched the current tick.' },\n },\n }),\n\n triggeredByUserId: schemaShape.triggeredByUserId.stringSpec({\n meaning: 'The user whose action caused the dispatcher to fire. Empty for passes the platform started on its own.',\n whyItMatters: 'It is attribution only, never authority: the seed itself always runs with internal system permissions regardless of who triggered it.',\n semanticRole: 'identifier',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Outcome of the pass.',\n whyItMatters: 'It is the signal the dispatcher itself reads to decide whether a scope still needs seeding, and the first thing an operator filters on.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'DataSeedRunStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [DataSeedRunStatus.RUNNING]: { meaning: 'The pass started and has not settled. A pass left in this state by a crash is superseded by the next pass rather than timing out.' },\n [DataSeedRunStatus.COMPLETED]: { meaning: 'Every declared entry succeeded.' },\n [DataSeedRunStatus.PARTIAL]: { meaning: 'At least one entry failed but the pass carried on and reported the rest.' },\n [DataSeedRunStatus.FAILED]: { meaning: 'The pass itself stopped before finishing.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n startedAt: schemaShape.startedAt.dateSpec({\n meaning: 'When the pass began.',\n }),\n\n finishedAt: schemaShape.finishedAt.dateSpec({\n meaning: 'When the pass settled. Empty while it is still running.',\n whyItMatters: 'The gap between this and the start time is the only duration signal for a seeding pass.',\n }),\n\n entriesAttempted: schemaShape.entriesAttempted.numberSpec({\n meaning: 'How many declared entries the pass walked. Counted before each entry is tried, so it matches the declared set whatever the outcome.',\n whyItMatters: 'When it does not match the number of entries in the declaration, the declaration and the deployed code have drifted apart.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n entriesInserted: schemaShape.entriesInserted.numberSpec({\n meaning: 'How many declared entries were written because no matching record existed.',\n }),\n\n entriesUpdated: schemaShape.entriesUpdated.numberSpec({\n meaning: 'How many already-present records had the declared payload re-applied to them.',\n whyItMatters: 'This is the additive-mode counter. A version migration is counted separately, so a non-zero value here means the payload was re-stamped, not migrated.',\n }),\n\n entriesUpgraded: schemaShape.entriesUpgraded.numberSpec({\n meaning: 'How many present records were behind the declared version and were migrated forward.',\n }),\n\n entriesRenamed: schemaShape.entriesRenamed.numberSpec({\n meaning: 'How many records were relocated from a previous identity because the declaration renamed them.',\n }),\n\n entriesSkipped: schemaShape.entriesSkipped.numberSpec({\n meaning: 'How many declared entries the pass deliberately left untouched — already current, or protected from being moved backwards.',\n whyItMatters: 'Skipping is a normal outcome, not a failure; the reason for each skip is reported separately.',\n }),\n\n entriesDeleted: schemaShape.entriesDeleted.numberSpec({\n meaning: 'How many records outside the declared set were removed. Only a full-reconciliation pass configured to delete can produce this.',\n }),\n\n entriesDeprecated: schemaShape.entriesDeprecated.numberSpec({\n meaning: 'How many records outside the declared set were marked deprecated instead of removed.',\n }),\n\n entriesReportedOrphans: schemaShape.entriesReportedOrphans.numberSpec({\n meaning: 'How many records outside the declared set were only reported, leaving the records themselves untouched.',\n }),\n\n entriesFailed: schemaShape.entriesFailed.numberSpec({\n meaning: 'How many entries could not be written. The pass continues and settles as partial.',\n whyItMatters: 'It is the count behind a partial outcome; the per-entry detail lives in the report below.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n failureReport: schemaShape.failureReport.objectSpec({\n meaning: 'Detailed breakdown of everything non-trivial the pass encountered: which entries failed and why, which records fell outside the declared set, and any error that stopped the pass as a whole. Empty when everything succeeded.',\n whyItMatters: 'It is what lets an operator diagnose a partial or failed pass without going to application logs.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n },\n\n /**\n * `trigger` is documented here rather than in `fields` because it is a\n * DISCRIMINATED UNION, and the spec decorators are declared on `ZodObject`\n * / `ZodUnion` but not on `ZodDiscriminatedUnion` — `schemaShape.trigger.objectSpec(...)`\n * does not type-check. Without an entry of some kind the field would reach the\n * label generator as a bare name and the generator would invent terminology for\n * it (the same failure mode `RETENTION_MARKER_FIELD_SPECS` documents), so the\n * meaning is declared through the escape hatch instead of dropped.\n */\n additionalFieldSpecs: [\n {\n fieldName: 'trigger',\n specDecorator: 'objectSpec',\n params: {\n meaning: 'The full trigger declaration that caused this pass, copied verbatim from the seed definition.',\n whyItMatters: 'Its shape varies by what fired the pass, so it carries the detail — the lifecycle event, the schedule, the access path — that the coarse trigger origin deliberately flattens away.',\n },\n },\n ],\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Open the ledger row for a seeding pass that is about to start.',\n outcome: 'The pass becomes visible as running before it touches any data, so a crash mid-pass leaves a trace rather than nothing.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The pass was recorded as running and the record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The pass description fails schema validation.' },\n ],\n idempotent: false,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher open its own ledger row. There is no externally reachable way to create one.',\n },\n },\n },\n\n [Op.READ]: {\n purpose: 'Read one recorded seeding pass.',\n outcome: 'The caller can inspect exactly what one pass did to one scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The recorded pass was found and is returned with its counters and report.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier — never recorded, or already removed by an administrator or by history cleanup.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator. This ledger is never exposed to ordinary tenant callers.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher recover a previous attempt before writing the outcome of the current one.',\n },\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator inspect one pass from the back office.',\n },\n },\n },\n\n [Op.UPDATE]: {\n purpose: 'Settle a running pass with its outcome and counters.',\n outcome: 'The ledger stops saying the pass is in flight and starts being the answer to whether the seed already applied.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The pass recorded its outcome, timing, counters and failure report, and the settled record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier to settle.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The outcome fails schema validation, for example an unrecognized status.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A caller outside the dispatcher attempts to rewrite a pass outcome.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher write the terminal outcome of the pass it opened.',\n whenToUse: 'Use when a pass has finished walking its entries, whether it succeeded, partially succeeded, or stopped.',\n },\n },\n },\n\n [Op.DELETE]: {\n purpose: 'Remove a recorded pass so the next dispatcher run treats that scope as never seeded.',\n outcome: 'The seed is re-applied to that scope on the next run, without editing or re-deploying the seed declaration.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The recorded pass was removed and the scope is eligible for seeding again.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No pass exists for the supplied identifier.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Give a platform administrator the supported re-run gesture.',\n whenToUse: 'Use when a seed must be applied again to one scope and raising the declared version would wrongly re-run it everywhere. The dispatcher never deletes its own history.',\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate recorded seeding passes.',\n outcome: 'The caller sees seeding history as a set rather than one pass at a time.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A page of recorded passes, possibly empty, narrowed by the requested seed, scope, status, or trigger filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator authorized to enumerate seeding history.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Let the dispatcher enumerate prior passes while deciding whether a scope still needs seeding.',\n },\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator browse seeding history from the back office.',\n },\n },\n },\n\n [Op.COUNT]: {\n purpose: 'Count recorded passes matching a set of conditions.',\n outcome: 'The dispatcher can answer \"has any completed pass already covered this scope?\" without loading the rows.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The number of recorded passes matching the conditions.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.INTERNAL]: {\n purpose: 'Back the dispatcher\\'s already-seeded check, which needs only a yes or no and never the rows themselves.',\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Search seeding history by seed name or anchor row.',\n outcome: 'An administrator can narrow history to the passes relevant to one seed or one affected row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A page of recorded passes, possibly empty, matching the search term and any filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a platform administrator authorized to query seeding history.' },\n ],\n idempotent: true,\n variants: {\n [DataSeedRunVariantKey.ADMIN]: {\n purpose: 'Let a platform administrator find passes by seed name or by the row a pass was anchored to.',\n whenToUse: 'Use when troubleshooting starts from \"which seed touched this row\" rather than from a known pass identifier.',\n },\n },\n },\n },\n\n businessConstraints: [\n 'This ledger records what a seeding pass did. It is never the source of truth for the data the seed produced — that lives on the seeded rows themselves.',\n 'A pass is identified by its seed, its scope, and its declared version together. That identity is what makes seeding safe to repeat, so it must not be widened or narrowed casually.',\n 'Who triggered a pass is recorded for attribution only. Seeding always runs with internal system permissions, so the recorded user never confers authority.',\n 'Removing a recorded pass is a deliberate administrative re-run gesture. The dispatcher itself never deletes its own history, because the history is what makes the next decision correct.',\n ],\n }),\n // DATA_SEED_RUN is a STANDALONE infrastructure ledger reached only through\n // internal repository services and a platform-administrator back-office path.\n // The `APPLICATION → DATA_SEED_RUN` relationship is routing-side only (the row\n // carries no application identifier of its own), which is why the scope is\n // declared here rather than derived from a scope-owning parent.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
@@ -0,0 +1,9 @@
1
+ import { type AnyResourceSpecificationConfig } from '../../../_core';
2
+ /**
3
+ * Framework-owned specification for the internal `externalDataErasureSuppressions` resource (#1746) — the list that
4
+ * stops a pipeline from copying an erased person back in from a system of record.
5
+ *
6
+ * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.
7
+ */
8
+ export declare const externalDataErasureSuppressionsResourceSpecification: AnyResourceSpecificationConfig;
9
+ //# sourceMappingURL=external-data-erasure-suppressions.resource.specification.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"external-data-erasure-suppressions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-erasure-suppressions.resource.specification.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,8BAA8B,EAAiD,MAAM,6BAA6B,CAAC;AAGjI;;;;;GAKG;AACH,eAAO,MAAM,oDAAoD,EAAE,8BAoHlE,CAAC"}
@@ -0,0 +1,122 @@
1
+ import { LabelAudience } from '@wildo-ai/presets-components-models';
2
+ import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';
3
+ import { ExternalDataErasureSuppressionReleaseReason, ExternalDataErasureSuppressionSchema, ExternalDataErasureSuppressionVariantKey, externalDataErasureSuppressionResourceConfiguration_InitializationFactory as suppressionFactory, } from '@wildo-ai/saas-backend-lib/external-data-models';
4
+ import { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';
5
+ import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
6
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
7
+ /**
8
+ * Framework-owned specification for the internal `externalDataErasureSuppressions` resource (#1746) — the list that
9
+ * stops a pipeline from copying an erased person back in from a system of record.
10
+ *
11
+ * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.
12
+ */
13
+ export const externalDataErasureSuppressionsResourceSpecification = resourceSpecification(suppressionFactory, ExternalDataErasureSuppressionSchema, ({ schemaShape }) => ({
14
+ purpose: 'Remember which remote records a subject erasure removed locally, so no external-data pipeline copies them back in from the system of record.',
15
+ businessRole: 'Makes an erasure of pipeline-copied personal data survive the next pass: without it the source still holds the record, and the next scheduled run writes it back while the erasure receipt says complete.',
16
+ lifecycleRole: 'Written by the erasure (the scrub chokepoint and the erasure cascade\'s delete), read by every full and incremental pass, released by a completed full pass over the whole entity that no longer sees the record, and deleted by the retention sweep at the end of the AUDIT_LOGS period counted from that release.',
17
+ audience: LabelAudience.DEVELOPER,
18
+ subDomain: EngineResourceSubDomain.INFRASTRUCTURE,
19
+ codeHandling: {
20
+ mainSchema: {
21
+ packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',
22
+ exportName: 'ExternalDataErasureSuppressionSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA,
23
+ },
24
+ resourceFactory: {
25
+ packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',
26
+ exportName: 'externalDataErasureSuppressionResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION,
27
+ },
28
+ resourceType: {
29
+ enumDeclaration: { packageName: '@wildo-ai/saas-backend-lib', exportName: 'BackendResourceType',
30
+ symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
31
+ memberName: 'EXTERNAL_DATA_ERASURE_SUPPRESSIONS',
32
+ },
33
+ operationVocabulary: {
34
+ coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation',
35
+ symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
36
+ },
37
+ },
38
+ fields: {
39
+ _id: schemaShape._id.stringSpec({ meaning: 'Identity of the suppression row, assigned by the store.' }),
40
+ remoteRecordDigest: schemaShape.remoteRecordDigest.stringSpec({
41
+ meaning: 'A keyed hash (HMAC-SHA-256) of the system-of-record instance, the remote entity, the key shape and the remote key — never the key itself. Unique: one remote record, one suppression.',
42
+ whyItMatters: 'The suppression must not keep the personal identifier it exists to suppress. A remote key is often a small integer, so an unkeyed hash would be reversed by enumeration; the key, derived from the application\'s own secret, is what makes the digest unlinkable. Uniqueness makes a second erasure of the same record find the first suppression.',
43
+ semanticRole: 'identifier',
44
+ importance: FieldSemanticImportance.PRIMARY,
45
+ }),
46
+ system: schemaShape.system.stringSpec({ meaning: 'The system-of-record instance whose record is suppressed. Names a system, not a person.' }),
47
+ remoteEntityRef: schemaShape.remoteEntityRef.stringSpec({ meaning: 'The remote entity (Odoo model, OData entity set) whose record is suppressed. Names a table, not a person.' }),
48
+ remoteKeyShape: schemaShape.remoteKeyShape.stringSpec({
49
+ meaning: 'The shape of the remote key the digest covers: each key field\'s remote name and codec. Names columns, not a person.',
50
+ whyItMatters: 'Two pipelines on one entity can key it differently. Scoping by shape means a pipeline only matches, and only releases, suppressions computed over its own key shape — otherwise one pipeline\'s full pass would read the other\'s suppressions as absent and release them.',
51
+ }),
52
+ keyFingerprint: schemaShape.keyFingerprint.stringSpec({
53
+ meaning: 'A short digest of the hashing key that produced the identifier.',
54
+ whyItMatters: 'A digest cannot be re-keyed. A run that finds an active suppression under another fingerprint refuses to load, because it can no longer match it and would copy the person back.',
55
+ }),
56
+ erasedFromResourceType: schemaShape.erasedFromResourceType.stringSpec({ meaning: 'The destination resource the erased row lived in when the suppression was written — for an operator, never used for matching.' }),
57
+ suppressedAt: schemaShape.suppressedAt.dateSpec({ meaning: 'When the erasure wrote (or re-activated) the suppression.' }),
58
+ releasedAt: schemaShape.releasedAt.dateSpec({
59
+ meaning: 'When a completed full pass over the whole remote entity no longer saw the record; empty while the suppression is active.',
60
+ whyItMatters: 'It is the retention clock: an active suppression never expires, because a period that ran out while the source still held the record would silently undo the erasure.',
61
+ }),
62
+ releaseReason: schemaShape.releaseReason.enumSpec({
63
+ meaning: 'Why the suppression stopped suppressing.',
64
+ enumDeclaration: {
65
+ packageName: '@wildo-ai/saas-backend-lib',
66
+ exportName: 'ExternalDataErasureSuppressionReleaseReason',
67
+ symbolKind: CodeSymbolKind.ENUM,
68
+ declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
69
+ },
70
+ values: {
71
+ [ExternalDataErasureSuppressionReleaseReason.REMOTE_RECORD_ABSENT]: {
72
+ meaning: 'A completed full pass that read the whole entity did not see the record: the source no longer holds it, so nothing is left to re-import.',
73
+ },
74
+ },
75
+ }),
76
+ },
77
+ operations: {
78
+ [Op.CREATE]: {
79
+ purpose: 'Record that an erasure removed a pipeline-copied row.',
80
+ outcome: 'Every pipeline reading that remote entity skips the record from its next pass on.',
81
+ importance: FieldSemanticImportance.PRIMARY,
82
+ responseStatuses: [{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The suppression was recorded.' }],
83
+ idempotent: false,
84
+ variants: { [ExternalDataErasureSuppressionVariantKey.INTERNAL]: { purpose: 'Let the erasure path suppress a record inside the erasure\'s own transaction.' } },
85
+ },
86
+ [Op.READ]: {
87
+ purpose: 'Read one suppression row by its identity.',
88
+ outcome: 'The row is returned for internal inspection; matching and idempotency go through the digest listing.',
89
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The suppression is returned.' }],
90
+ idempotent: true,
91
+ variants: { [ExternalDataErasureSuppressionVariantKey.INTERNAL]: { purpose: 'Internal idempotency read only.' } },
92
+ },
93
+ [Op.LIST]: {
94
+ purpose: 'Load the active suppressions of one remote entity for a pipeline run, or find a record\'s suppression by its digest before recording it again.',
95
+ outcome: 'The run loads no extracted row that is suppressed, and a second erasure of the same record leaves the active suppression as it is.',
96
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The active suppressions are returned.' }],
97
+ idempotent: true,
98
+ variants: { [ExternalDataErasureSuppressionVariantKey.INTERNAL]: { purpose: 'Internal pipeline read only.' } },
99
+ },
100
+ [Op.UPDATE]: {
101
+ purpose: 'Release a suppression whose record is gone at the source, or re-activate one whose record was copied in and erased again.',
102
+ outcome: 'A released suppression stops suppressing and starts its AUDIT_LOGS retention period.',
103
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The suppression was released or re-activated.' }],
104
+ idempotent: true,
105
+ variants: { [ExternalDataErasureSuppressionVariantKey.INTERNAL]: { purpose: 'Internal release by a completed full pass, or re-activation by an erasure.' } },
106
+ },
107
+ [Op.DELETE]: {
108
+ purpose: 'SWEEP ONLY — dispose of a released suppression once its AUDIT_LOGS period has passed. No client door.',
109
+ outcome: 'The released suppression is deleted by the retention-class sweep. INTERNAL_CALL, so it has no HTTP route; an active suppression is never deleted.',
110
+ whenToUse: 'Never directly.',
111
+ responseStatuses: [{ code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The released suppression was removed by the sweep. Not observable over HTTP.' }],
112
+ idempotent: true,
113
+ },
114
+ },
115
+ businessConstraints: [
116
+ 'Never stores the remote key: the identifier is a keyed hash, and the instance and entity names are the only clear text.',
117
+ 'Both pipeline tracks skip a suppressed key and count the skip on the run report, the stored summary and the run\'s audit row; the key stays observed, so the orphan walk never reaches a retained row.',
118
+ 'Only a completed full pass whose load completed, with no unidentified source row, over a pipeline with no sourceFilter may release a suppression.',
119
+ 'A run that finds an active suppression hashed under another key refuses to load rather than re-importing it.',
120
+ ],
121
+ }), { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION });
122
+ //# sourceMappingURL=external-data-erasure-suppressions.resource.specification.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"external-data-erasure-suppressions.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-erasure-suppressions.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 ExternalDataErasureSuppressionReleaseReason,\n ExternalDataErasureSuppressionSchema,\n ExternalDataErasureSuppressionVariantKey,\n externalDataErasureSuppressionResourceConfiguration_InitializationFactory as suppressionFactory,\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 `externalDataErasureSuppressions` resource (#1746) — the list that\n * stops a pipeline from copying an erased person back in from a system of record.\n *\n * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.\n */\nexport const externalDataErasureSuppressionsResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n suppressionFactory,\n ExternalDataErasureSuppressionSchema,\n ({ schemaShape }) => ({\n purpose: 'Remember which remote records a subject erasure removed locally, so no external-data pipeline copies them back in from the system of record.',\n businessRole: 'Makes an erasure of pipeline-copied personal data survive the next pass: without it the source still holds the record, and the next scheduled run writes it back while the erasure receipt says complete.',\n lifecycleRole: 'Written by the erasure (the scrub chokepoint and the erasure cascade\\'s delete), read by every full and incremental pass, released by a completed full pass over the whole entity that no longer sees the record, and deleted by the retention sweep at the end of the AUDIT_LOGS period counted from that release.',\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: 'ExternalDataErasureSuppressionSchema', 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: 'externalDataErasureSuppressionResourceConfiguration_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_ERASURE_SUPPRESSIONS',\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 suppression row, assigned by the store.' }),\n remoteRecordDigest: schemaShape.remoteRecordDigest.stringSpec({\n meaning: 'A keyed hash (HMAC-SHA-256) of the system-of-record instance, the remote entity, the key shape and the remote key — never the key itself. Unique: one remote record, one suppression.',\n whyItMatters: 'The suppression must not keep the personal identifier it exists to suppress. A remote key is often a small integer, so an unkeyed hash would be reversed by enumeration; the key, derived from the application\\'s own secret, is what makes the digest unlinkable. Uniqueness makes a second erasure of the same record find the first suppression.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n system: schemaShape.system.stringSpec({ meaning: 'The system-of-record instance whose record is suppressed. Names a system, not a person.' }),\n remoteEntityRef: schemaShape.remoteEntityRef.stringSpec({ meaning: 'The remote entity (Odoo model, OData entity set) whose record is suppressed. Names a table, not a person.' }),\n remoteKeyShape: schemaShape.remoteKeyShape.stringSpec({\n meaning: 'The shape of the remote key the digest covers: each key field\\'s remote name and codec. Names columns, not a person.',\n whyItMatters: 'Two pipelines on one entity can key it differently. Scoping by shape means a pipeline only matches, and only releases, suppressions computed over its own key shape — otherwise one pipeline\\'s full pass would read the other\\'s suppressions as absent and release them.',\n }),\n keyFingerprint: schemaShape.keyFingerprint.stringSpec({\n meaning: 'A short digest of the hashing key that produced the identifier.',\n whyItMatters: 'A digest cannot be re-keyed. A run that finds an active suppression under another fingerprint refuses to load, because it can no longer match it and would copy the person back.',\n }),\n erasedFromResourceType: schemaShape.erasedFromResourceType.stringSpec({ meaning: 'The destination resource the erased row lived in when the suppression was written — for an operator, never used for matching.' }),\n suppressedAt: schemaShape.suppressedAt.dateSpec({ meaning: 'When the erasure wrote (or re-activated) the suppression.' }),\n releasedAt: schemaShape.releasedAt.dateSpec({\n meaning: 'When a completed full pass over the whole remote entity no longer saw the record; empty while the suppression is active.',\n whyItMatters: 'It is the retention clock: an active suppression never expires, because a period that ran out while the source still held the record would silently undo the erasure.',\n }),\n releaseReason: schemaShape.releaseReason.enumSpec({\n meaning: 'Why the suppression stopped suppressing.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib',\n exportName: 'ExternalDataErasureSuppressionReleaseReason',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ExternalDataErasureSuppressionReleaseReason.REMOTE_RECORD_ABSENT]: {\n meaning: 'A completed full pass that read the whole entity did not see the record: the source no longer holds it, so nothing is left to re-import.',\n },\n },\n }),\n },\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Record that an erasure removed a pipeline-copied row.',\n outcome: 'Every pipeline reading that remote entity skips the record from its next pass on.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The suppression was recorded.' }],\n idempotent: false,\n variants: { [ExternalDataErasureSuppressionVariantKey.INTERNAL]: { purpose: 'Let the erasure path suppress a record inside the erasure\\'s own transaction.' } },\n },\n [Op.READ]: {\n purpose: 'Read one suppression row by its identity.',\n outcome: 'The row is returned for internal inspection; matching and idempotency go through the digest listing.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The suppression is returned.' }],\n idempotent: true,\n variants: { [ExternalDataErasureSuppressionVariantKey.INTERNAL]: { purpose: 'Internal idempotency read only.' } },\n },\n [Op.LIST]: {\n purpose: 'Load the active suppressions of one remote entity for a pipeline run, or find a record\\'s suppression by its digest before recording it again.',\n outcome: 'The run loads no extracted row that is suppressed, and a second erasure of the same record leaves the active suppression as it is.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The active suppressions are returned.' }],\n idempotent: true,\n variants: { [ExternalDataErasureSuppressionVariantKey.INTERNAL]: { purpose: 'Internal pipeline read only.' } },\n },\n [Op.UPDATE]: {\n purpose: 'Release a suppression whose record is gone at the source, or re-activate one whose record was copied in and erased again.',\n outcome: 'A released suppression stops suppressing and starts its AUDIT_LOGS retention period.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The suppression was released or re-activated.' }],\n idempotent: true,\n variants: { [ExternalDataErasureSuppressionVariantKey.INTERNAL]: { purpose: 'Internal release by a completed full pass, or re-activation by an erasure.' } },\n },\n [Op.DELETE]: {\n purpose: 'SWEEP ONLY — dispose of a released suppression once its AUDIT_LOGS period has passed. No client door.',\n outcome: 'The released suppression is deleted by the retention-class sweep. INTERNAL_CALL, so it has no HTTP route; an active suppression is never deleted.',\n whenToUse: 'Never directly.',\n responseStatuses: [{ code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The released suppression was removed by the sweep. Not observable over HTTP.' }],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'Never stores the remote key: the identifier is a keyed hash, and the instance and entity names are the only clear text.',\n 'Both pipeline tracks skip a suppressed key and count the skip on the run report, the stored summary and the run\\'s audit row; the key stays observed, so the orphan walk never reaches a retained row.',\n 'Only a completed full pass whose load completed, with no unidentified source row, over a pipeline with no sourceFilter may release a suppression.',\n 'A run that finds an active suppression hashed under another key refuses to load rather than re-importing it.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
@@ -0,0 +1,9 @@
1
+ import { type AnyResourceSpecificationConfig } from '../../../_core';
2
+ /**
3
+ * Framework-owned specification for the internal `externalDataOutboundChanges` resource (#1690) — one marker per row of
4
+ * an OUTBOUND pipeline's destination whose local change its system of record has not acknowledged yet.
5
+ *
6
+ * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.
7
+ */
8
+ export declare const externalDataOutboundChangesResourceSpecification: AnyResourceSpecificationConfig;
9
+ //# sourceMappingURL=external-data-outbound-changes.resource.specification.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"external-data-outbound-changes.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-outbound-changes.resource.specification.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,8BAA8B,EAAiD,MAAM,6BAA6B,CAAC;AAGjI;;;;;GAKG;AACH,eAAO,MAAM,gDAAgD,EAAE,8BAiJ9D,CAAC"}
@@ -0,0 +1,152 @@
1
+ import { LabelAudience } from '@wildo-ai/presets-components-models';
2
+ import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';
3
+ import { ExternalDataOutboundChangeSchema, ExternalDataOutboundChangeState, ExternalDataOutboundChangeVariantKey, externalDataOutboundChangeResourceConfiguration_InitializationFactory as outboundChangeFactory, } from '@wildo-ai/saas-backend-lib/external-data-models';
4
+ import { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';
5
+ import { HttpApiWriteVerb } from '@wildo-ai/saas-models/external-data';
6
+ import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
7
+ import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
8
+ /**
9
+ * Framework-owned specification for the internal `externalDataOutboundChanges` resource (#1690) — one marker per row of
10
+ * an OUTBOUND pipeline's destination whose local change its system of record has not acknowledged yet.
11
+ *
12
+ * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.
13
+ */
14
+ export const externalDataOutboundChangesResourceSpecification = resourceSpecification(outboundChangeFactory, ExternalDataOutboundChangeSchema, ({ schemaShape }) => ({
15
+ purpose: 'Remember which rows of an outbound pipeline\'s destination changed locally and have not reached the system of record yet, so the next pass sends exactly those.',
16
+ businessRole: 'Lets an application send the records its members create or edit to the business system that keeps them — a lead to the company\'s CRM, a contact to its ERP — without comparing timestamps and without sending back what the engine itself wrote.',
17
+ lifecycleRole: 'Recorded by a member\'s create or update of a destination row, in the same transaction; read by the next outbound pass, which sends the row\'s current state; deleted when the system of record acknowledges that write, or when the row is gone or belongs to another organization. A send of unknown outcome keeps it until an operator resolves it.',
18
+ audience: LabelAudience.DEVELOPER,
19
+ subDomain: EngineResourceSubDomain.INFRASTRUCTURE,
20
+ codeHandling: {
21
+ mainSchema: {
22
+ packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',
23
+ exportName: 'ExternalDataOutboundChangeSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA,
24
+ },
25
+ resourceFactory: {
26
+ packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',
27
+ exportName: 'externalDataOutboundChangeResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION,
28
+ },
29
+ resourceType: {
30
+ enumDeclaration: { packageName: '@wildo-ai/saas-backend-lib', exportName: 'BackendResourceType',
31
+ symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
32
+ memberName: 'EXTERNAL_DATA_OUTBOUND_CHANGES',
33
+ },
34
+ operationVocabulary: {
35
+ coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation',
36
+ symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
37
+ },
38
+ },
39
+ fields: {
40
+ _id: schemaShape._id.stringSpec({
41
+ meaning: 'The marker\'s identity, derived from the destination and the local row, so a second change of the row finds the first one\'s marker.',
42
+ whyItMatters: 'Two concurrent first changes of one row collide on it instead of leaving two markers that would send the row twice.',
43
+ semanticRole: 'identifier',
44
+ importance: FieldSemanticImportance.PRIMARY,
45
+ }),
46
+ resourceType: schemaShape.resourceType.stringSpec({ meaning: 'The outbound pipeline\'s destination resource; each pass reads only its own destination\'s markers.' }),
47
+ localResourceId: schemaShape.localResourceId.stringSpec({ meaning: 'The destination row whose change is owed to the system of record.' }),
48
+ cycle: schemaShape.cycle.stringSpec({
49
+ meaning: 'A fresh id drawn when this marker was created — part of every send\'s idempotency key.',
50
+ whyItMatters: 'A marker is removed when its change is acknowledged and the row\'s next change starts a new one at generation 1; without the cycle, that next send would reuse the key of the write already applied and be refused.',
51
+ }),
52
+ generation: schemaShape.generation.numberSpec({
53
+ meaning: 'How many local changes of the row this marker has recorded.',
54
+ whyItMatters: 'A send carries one generation, and only that generation\'s acknowledgement removes the marker — a change made during the send keeps it, so the newer state is sent next.',
55
+ importance: FieldSemanticImportance.PRIMARY,
56
+ }),
57
+ state: schemaShape.state.enumSpec({
58
+ meaning: 'Where the send of the owed change stands.',
59
+ enumDeclaration: {
60
+ packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',
61
+ exportName: 'ExternalDataOutboundChangeState', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
62
+ },
63
+ values: {
64
+ [ExternalDataOutboundChangeState.PENDING]: { meaning: 'Not sent yet, or the last attempt was definitely refused (or had to wait) and is retried once due again.' },
65
+ [ExternalDataOutboundChangeState.DISPATCHING]: { meaning: 'A pass is sending it. A process stopped here leaves it; the write ledger decides what happened.' },
66
+ [ExternalDataOutboundChangeState.OUTCOME_UNKNOWN]: { meaning: 'The send left and whether it landed is unknown. Never re-sent for the same change; a create waits for an operator, because sending it again could create the record twice.' },
67
+ [ExternalDataOutboundChangeState.CONFLICT]: { meaning: 'A two-way pipeline\'s row changed on both sides in fields both own, which its policy refused to decide: neither loaded over nor sent until an operator chooses which side wins.' },
68
+ },
69
+ importance: FieldSemanticImportance.PRIMARY,
70
+ }),
71
+ attempt: schemaShape.attempt.numberSpec({ meaning: 'How many times the current change was definitely refused — part of the send\'s idempotency key, so a retry after a refusal is a new request and a retry after an unknown outcome is not.' }),
72
+ changedAt: schemaShape.changedAt.dateSpec({ meaning: 'When the latest local change was recorded.' }),
73
+ dueAt: schemaShape.dueAt.dateSpec({
74
+ meaning: 'The earliest time a pass may take this change. A new local change makes it due at once; a pass that could not send it — a refusal, a wait for a reference or a partition, an unknown outcome — moves it out by a backoff.',
75
+ whyItMatters: 'Passes read changes oldest-due first and only once due, so a change the system of record keeps refusing never stands in front of a new one, and is retried once per backoff rather than on every pass.',
76
+ }),
77
+ retryLevel: schemaShape.retryLevel.numberSpec({ meaning: 'How many passes in a row took this change and could not send it: the backoff doubles from one minute with each, up to a day. A new local change or an operator\'s answer resets it.' }),
78
+ changedByUserId: schemaShape.changedByUserId.stringSpec({ meaning: 'The member whose change is owed — the person the write-through audit row names, because the system of record sees one shared service identity.' }),
79
+ changedByExecutionType: schemaShape.changedByExecutionType.stringSpec({ meaning: 'The execution type that made the latest change.' }),
80
+ dispatchedGeneration: schemaShape.dispatchedGeneration.numberSpec({ meaning: 'The generation the current or last send carried.' }),
81
+ dispatchedVerb: schemaShape.dispatchedVerb.enumSpec({
82
+ meaning: 'Whether the current or last send was a create or an update — what an unknown outcome was trying to do.',
83
+ enumDeclaration: {
84
+ packageName: '@wildo-ai/saas-models', importPath: '@wildo-ai/saas-models/external-data',
85
+ exportName: 'HttpApiWriteVerb', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
86
+ },
87
+ values: {
88
+ [HttpApiWriteVerb.CREATE]: { meaning: 'The row had no remote key, so the system of record was asked to create it.' },
89
+ [HttpApiWriteVerb.UPDATE]: { meaning: 'The row had a remote key, so the record it names was updated.' },
90
+ [HttpApiWriteVerb.DELETE]: { meaning: 'Never used: a local delete is not sent.' },
91
+ },
92
+ }),
93
+ localBothChanged: schemaShape.localBothChanged.booleanSpec({
94
+ meaning: 'Two-way pipelines: whether a local change since the last send touched a field both sides own — the only kind of change that can conflict with one made in the system of record.',
95
+ }),
96
+ conflictResolution: schemaShape.conflictResolution.enumSpec({
97
+ meaning: 'An operator\'s choice for a refused conflict: which side wins this row, applied by the next inbound pass and then cleared.',
98
+ enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ExternalDataConflictPolicy', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
99
+ }),
100
+ dispatchedFieldNames: schemaShape.dispatchedFieldNames.arraySpec({
101
+ meaning: 'The local fields the current or last send carried, recorded when it was sent.',
102
+ elementMeaning: 'One local field name the send carried.',
103
+ whyItMatters: 'An audit row written later about that send — a replay, an unknown outcome — names these, not the fields the row would send now, so the trail says what the write actually carried.',
104
+ }),
105
+ lastAttemptAt: schemaShape.lastAttemptAt.dateSpec({ meaning: 'When the last send attempt began.' }),
106
+ lastOutcomeCode: schemaShape.lastOutcomeCode.stringSpec({ meaning: 'Why the last attempt did not apply: a refusal code, or why the row waits (a referenced record the system of record has not received yet).' }),
107
+ },
108
+ operations: {
109
+ [Op.CREATE]: {
110
+ purpose: 'Record the first unsent change of a destination row.',
111
+ outcome: 'The next outbound pass sends the row.',
112
+ importance: FieldSemanticImportance.PRIMARY,
113
+ responseStatuses: [{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The marker was recorded.' }],
114
+ idempotent: false,
115
+ variants: { [ExternalDataOutboundChangeVariantKey.INTERNAL]: { purpose: 'Let the write path record an owed change.' } },
116
+ },
117
+ [Op.UPDATE]: {
118
+ purpose: 'Record a newer change, or move a send through its states.',
119
+ outcome: 'The marker names the latest generation and where its send stands.',
120
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The marker was updated.' }],
121
+ idempotent: false,
122
+ variants: { [ExternalDataOutboundChangeVariantKey.INTERNAL]: { purpose: 'Internal bookkeeping by the write path and the outbound pass.' } },
123
+ },
124
+ [Op.READ]: {
125
+ purpose: 'Read one marker by its identity.',
126
+ outcome: 'The marker is returned for internal inspection.',
127
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The marker is returned.' }],
128
+ idempotent: true,
129
+ variants: { [ExternalDataOutboundChangeVariantKey.INTERNAL]: { purpose: 'Internal inspection only.' } },
130
+ },
131
+ [Op.LIST]: {
132
+ purpose: 'Load one destination\'s owed changes at the start of a pass.',
133
+ outcome: 'Each is sent, deferred, or dropped.',
134
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The destination\'s markers are returned.' }],
135
+ idempotent: true,
136
+ variants: { [ExternalDataOutboundChangeVariantKey.INTERNAL]: { purpose: 'Internal pass read only.' } },
137
+ },
138
+ [Op.DELETE]: {
139
+ purpose: 'Remove a marker whose change was acknowledged, or whose row is gone or belongs to another organization.',
140
+ outcome: 'Nothing is owed for that row any more.',
141
+ responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The marker was removed.' }],
142
+ idempotent: true,
143
+ variants: { [ExternalDataOutboundChangeVariantKey.INTERNAL]: { purpose: 'Internal cleanup by the outbound pass.' } },
144
+ },
145
+ },
146
+ businessConstraints: [
147
+ 'Recorded only by a caller\'s service-tier create or update, never by the engine\'s own repository writes — so nothing a pipeline load or the pass itself writes is ever sent back.',
148
+ 'Holds no row content: the pass reads the row\'s current state when it sends, so a marker never carries a stale copy.',
149
+ 'Removed only when the acknowledged send carried the marker\'s current generation; a change made during a send keeps it.',
150
+ ],
151
+ }), { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION });
152
+ //# sourceMappingURL=external-data-outbound-changes.resource.specification.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"external-data-outbound-changes.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-outbound-changes.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 ExternalDataOutboundChangeSchema,\n ExternalDataOutboundChangeState,\n ExternalDataOutboundChangeVariantKey,\n externalDataOutboundChangeResourceConfiguration_InitializationFactory as outboundChangeFactory,\n} from '@wildo-ai/saas-backend-lib/external-data-models';\nimport { CoreResourceOperation as Op, ResourcePrimaryScope } from '@wildo-ai/saas-models';\nimport { HttpApiWriteVerb } from '@wildo-ai/saas-models/external-data';\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 `externalDataOutboundChanges` resource (#1690) — one marker per row of\n * an OUTBOUND pipeline's destination whose local change its system of record has not acknowledged yet.\n *\n * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.\n */\nexport const externalDataOutboundChangesResourceSpecification: AnyResourceSpecificationConfig = resourceSpecification(\n outboundChangeFactory,\n ExternalDataOutboundChangeSchema,\n ({ schemaShape }) => ({\n purpose: 'Remember which rows of an outbound pipeline\\'s destination changed locally and have not reached the system of record yet, so the next pass sends exactly those.',\n businessRole: 'Lets an application send the records its members create or edit to the business system that keeps them — a lead to the company\\'s CRM, a contact to its ERP — without comparing timestamps and without sending back what the engine itself wrote.',\n lifecycleRole: 'Recorded by a member\\'s create or update of a destination row, in the same transaction; read by the next outbound pass, which sends the row\\'s current state; deleted when the system of record acknowledges that write, or when the row is gone or belongs to another organization. A send of unknown outcome keeps it until an operator resolves it.',\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: 'ExternalDataOutboundChangeSchema', 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: 'externalDataOutboundChangeResourceConfiguration_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_OUTBOUND_CHANGES',\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 marker\\'s identity, derived from the destination and the local row, so a second change of the row finds the first one\\'s marker.',\n whyItMatters: 'Two concurrent first changes of one row collide on it instead of leaving two markers that would send the row twice.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n resourceType: schemaShape.resourceType.stringSpec({ meaning: 'The outbound pipeline\\'s destination resource; each pass reads only its own destination\\'s markers.' }),\n localResourceId: schemaShape.localResourceId.stringSpec({ meaning: 'The destination row whose change is owed to the system of record.' }),\n cycle: schemaShape.cycle.stringSpec({\n meaning: 'A fresh id drawn when this marker was created — part of every send\\'s idempotency key.',\n whyItMatters: 'A marker is removed when its change is acknowledged and the row\\'s next change starts a new one at generation 1; without the cycle, that next send would reuse the key of the write already applied and be refused.',\n }),\n generation: schemaShape.generation.numberSpec({\n meaning: 'How many local changes of the row this marker has recorded.',\n whyItMatters: 'A send carries one generation, and only that generation\\'s acknowledgement removes the marker — a change made during the send keeps it, so the newer state is sent next.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n state: schemaShape.state.enumSpec({\n meaning: 'Where the send of the owed change stands.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-backend-lib', importPath: '@wildo-ai/saas-backend-lib/external-data-models',\n exportName: 'ExternalDataOutboundChangeState', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ExternalDataOutboundChangeState.PENDING]: { meaning: 'Not sent yet, or the last attempt was definitely refused (or had to wait) and is retried once due again.' },\n [ExternalDataOutboundChangeState.DISPATCHING]: { meaning: 'A pass is sending it. A process stopped here leaves it; the write ledger decides what happened.' },\n [ExternalDataOutboundChangeState.OUTCOME_UNKNOWN]: { meaning: 'The send left and whether it landed is unknown. Never re-sent for the same change; a create waits for an operator, because sending it again could create the record twice.' },\n [ExternalDataOutboundChangeState.CONFLICT]: { meaning: 'A two-way pipeline\\'s row changed on both sides in fields both own, which its policy refused to decide: neither loaded over nor sent until an operator chooses which side wins.' },\n },\n importance: FieldSemanticImportance.PRIMARY,\n }),\n attempt: schemaShape.attempt.numberSpec({ meaning: 'How many times the current change was definitely refused — part of the send\\'s idempotency key, so a retry after a refusal is a new request and a retry after an unknown outcome is not.' }),\n changedAt: schemaShape.changedAt.dateSpec({ meaning: 'When the latest local change was recorded.' }),\n dueAt: schemaShape.dueAt.dateSpec({\n meaning: 'The earliest time a pass may take this change. A new local change makes it due at once; a pass that could not send it — a refusal, a wait for a reference or a partition, an unknown outcome — moves it out by a backoff.',\n whyItMatters: 'Passes read changes oldest-due first and only once due, so a change the system of record keeps refusing never stands in front of a new one, and is retried once per backoff rather than on every pass.',\n }),\n retryLevel: schemaShape.retryLevel.numberSpec({ meaning: 'How many passes in a row took this change and could not send it: the backoff doubles from one minute with each, up to a day. A new local change or an operator\\'s answer resets it.' }),\n changedByUserId: schemaShape.changedByUserId.stringSpec({ meaning: 'The member whose change is owed — the person the write-through audit row names, because the system of record sees one shared service identity.' }),\n changedByExecutionType: schemaShape.changedByExecutionType.stringSpec({ meaning: 'The execution type that made the latest change.' }),\n dispatchedGeneration: schemaShape.dispatchedGeneration.numberSpec({ meaning: 'The generation the current or last send carried.' }),\n dispatchedVerb: schemaShape.dispatchedVerb.enumSpec({\n meaning: 'Whether the current or last send was a create or an update — what an unknown outcome was trying to do.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models', importPath: '@wildo-ai/saas-models/external-data',\n exportName: 'HttpApiWriteVerb', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [HttpApiWriteVerb.CREATE]: { meaning: 'The row had no remote key, so the system of record was asked to create it.' },\n [HttpApiWriteVerb.UPDATE]: { meaning: 'The row had a remote key, so the record it names was updated.' },\n [HttpApiWriteVerb.DELETE]: { meaning: 'Never used: a local delete is not sent.' },\n },\n }),\n localBothChanged: schemaShape.localBothChanged.booleanSpec({\n meaning: 'Two-way pipelines: whether a local change since the last send touched a field both sides own — the only kind of change that can conflict with one made in the system of record.',\n }),\n conflictResolution: schemaShape.conflictResolution.enumSpec({\n meaning: 'An operator\\'s choice for a refused conflict: which side wins this row, applied by the next inbound pass and then cleared.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ExternalDataConflictPolicy', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n }),\n dispatchedFieldNames: schemaShape.dispatchedFieldNames.arraySpec({\n meaning: 'The local fields the current or last send carried, recorded when it was sent.',\n elementMeaning: 'One local field name the send carried.',\n whyItMatters: 'An audit row written later about that send — a replay, an unknown outcome — names these, not the fields the row would send now, so the trail says what the write actually carried.',\n }),\n lastAttemptAt: schemaShape.lastAttemptAt.dateSpec({ meaning: 'When the last send attempt began.' }),\n lastOutcomeCode: schemaShape.lastOutcomeCode.stringSpec({ meaning: 'Why the last attempt did not apply: a refusal code, or why the row waits (a referenced record the system of record has not received yet).' }),\n },\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Record the first unsent change of a destination row.',\n outcome: 'The next outbound pass sends the row.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The marker was recorded.' }],\n idempotent: false,\n variants: { [ExternalDataOutboundChangeVariantKey.INTERNAL]: { purpose: 'Let the write path record an owed change.' } },\n },\n [Op.UPDATE]: {\n purpose: 'Record a newer change, or move a send through its states.',\n outcome: 'The marker names the latest generation and where its send stands.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The marker was updated.' }],\n idempotent: false,\n variants: { [ExternalDataOutboundChangeVariantKey.INTERNAL]: { purpose: 'Internal bookkeeping by the write path and the outbound pass.' } },\n },\n [Op.READ]: {\n purpose: 'Read one marker by its identity.',\n outcome: 'The marker is returned for internal inspection.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The marker is returned.' }],\n idempotent: true,\n variants: { [ExternalDataOutboundChangeVariantKey.INTERNAL]: { purpose: 'Internal inspection only.' } },\n },\n [Op.LIST]: {\n purpose: 'Load one destination\\'s owed changes at the start of a pass.',\n outcome: 'Each is sent, deferred, or dropped.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The destination\\'s markers are returned.' }],\n idempotent: true,\n variants: { [ExternalDataOutboundChangeVariantKey.INTERNAL]: { purpose: 'Internal pass read only.' } },\n },\n [Op.DELETE]: {\n purpose: 'Remove a marker whose change was acknowledged, or whose row is gone or belongs to another organization.',\n outcome: 'Nothing is owed for that row any more.',\n responseStatuses: [{ code: HttpResponseStatusCode.OK_200, meaning: 'The marker was removed.' }],\n idempotent: true,\n variants: { [ExternalDataOutboundChangeVariantKey.INTERNAL]: { purpose: 'Internal cleanup by the outbound pass.' } },\n },\n },\n\n businessConstraints: [\n 'Recorded only by a caller\\'s service-tier create or update, never by the engine\\'s own repository writes — so nothing a pipeline load or the pass itself writes is ever sent back.',\n 'Holds no row content: the pass reads the row\\'s current state when it sends, so a marker never carries a stale copy.',\n 'Removed only when the acknowledged send carried the marker\\'s current generation; a change made during a send keeps it.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
@@ -0,0 +1,10 @@
1
+ import { type AnyResourceSpecificationConfig } from '../../../_core';
2
+ /**
3
+ * Framework-owned specification for the internal `externalDataPendingReferences` resource (#1684) — the references a
4
+ * pipeline could not resolve yet, retried at the end of every run so a row that never changes again still gets its
5
+ * foreign key once its target arrives.
6
+ *
7
+ * Registry-key and type-annotation notes: identical situation to `dataSeedRuns` — see that spec's header.
8
+ */
9
+ export declare const externalDataPendingReferencesResourceSpecification: AnyResourceSpecificationConfig;
10
+ //# sourceMappingURL=external-data-pending-references.resource.specification.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"external-data-pending-references.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/infrastructure/resources/external-data-pending-references.resource.specification.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,8BAA8B,EAAiD,MAAM,6BAA6B,CAAC;AAGjI;;;;;;GAMG;AACH,eAAO,MAAM,kDAAkD,EAAE,8BAuFhE,CAAC"}