@wildo-ai/saas-specifications 1.1.2 → 1.1.4

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 (1007) hide show
  1. package/dist/esm/_catalogs/index.d.ts.map +1 -1
  2. package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts.map +1 -1
  3. package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.d.ts.map +1 -1
  4. package/dist/esm/_catalogs/schema-org/aggregate-rating.catalog-spec.d.ts.map +1 -1
  5. package/dist/esm/_catalogs/schema-org/article.catalog-spec.d.ts.map +1 -1
  6. package/dist/esm/_catalogs/schema-org/blog-posting.catalog-spec.d.ts.map +1 -1
  7. package/dist/esm/_catalogs/schema-org/breadcrumb-list.catalog-spec.d.ts.map +1 -1
  8. package/dist/esm/_catalogs/schema-org/faq-page.catalog-spec.d.ts.map +1 -1
  9. package/dist/esm/_catalogs/schema-org/index.d.ts.map +1 -1
  10. package/dist/esm/_catalogs/schema-org/offer.catalog-spec.d.ts.map +1 -1
  11. package/dist/esm/_catalogs/schema-org/organization.catalog-spec.d.ts.map +1 -1
  12. package/dist/esm/_catalogs/schema-org/product.catalog-spec.d.ts.map +1 -1
  13. package/dist/esm/_catalogs/schema-org/review.catalog-spec.d.ts.map +1 -1
  14. package/dist/esm/_catalogs/schema-org/website.catalog-spec.d.ts.map +1 -1
  15. package/dist/esm/_core/assertions/assertion-authored-metadata.schemas.d.ts.map +1 -1
  16. package/dist/esm/_core/assertions/assertion-behaviors.schemas.d.ts.map +1 -1
  17. package/dist/esm/_core/assertions/assertion-references.schemas.d.ts.map +1 -1
  18. package/dist/esm/_core/assertions/assertion-snapshot-validation.d.ts.map +1 -1
  19. package/dist/esm/_core/assertions/assertion-specification.schemas.d.ts.map +1 -1
  20. package/dist/esm/_core/brand/brand-asset.schemas.d.ts +4 -6
  21. package/dist/esm/_core/brand/brand-asset.schemas.d.ts.map +1 -1
  22. package/dist/esm/_core/brand/brand-asset.schemas.js +4 -12
  23. package/dist/esm/_core/brand/brand-asset.schemas.js.map +1 -1
  24. package/dist/esm/_core/brand/brand-authored-metadata.schemas.d.ts.map +1 -1
  25. package/dist/esm/_core/brand/brand-generation.schemas.d.ts +5 -3
  26. package/dist/esm/_core/brand/brand-generation.schemas.d.ts.map +1 -1
  27. package/dist/esm/_core/brand/brand-generation.schemas.js +5 -2
  28. package/dist/esm/_core/brand/brand-generation.schemas.js.map +1 -1
  29. package/dist/esm/_core/brand/brand-logo-direction.schemas.d.ts.map +1 -1
  30. package/dist/esm/_core/brand/brand-name.schemas.d.ts.map +1 -1
  31. package/dist/esm/_core/brand/brand-snapshot-validation.d.ts.map +1 -1
  32. package/dist/esm/_core/brand/brand-snapshot.schemas.d.ts +10 -3
  33. package/dist/esm/_core/brand/brand-snapshot.schemas.d.ts.map +1 -1
  34. package/dist/esm/_core/brand/brand-snapshot.schemas.js +10 -2
  35. package/dist/esm/_core/brand/brand-snapshot.schemas.js.map +1 -1
  36. package/dist/esm/_core/brand/brand-visual-tone.schemas.d.ts.map +1 -1
  37. package/dist/esm/_core/brand/brand.family-aspects.d.ts.map +1 -1
  38. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts.map +1 -1
  39. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.js +15 -5
  40. package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.js.map +1 -1
  41. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts +40 -3
  42. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts.map +1 -1
  43. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js +85 -6
  44. package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js.map +1 -1
  45. package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts.map +1 -1
  46. package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts.map +1 -1
  47. package/dist/esm/_core/business-model-lite/business-model-authored-metadata.schemas.d.ts.map +1 -1
  48. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.d.ts.map +1 -1
  49. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js +10 -4
  50. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js.map +1 -1
  51. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts +15 -0
  52. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts.map +1 -1
  53. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.js.map +1 -1
  54. package/dist/esm/_core/business-model-lite/business-model-lite-snapshot.schemas.d.ts.map +1 -1
  55. package/dist/esm/_core/business-model-lite/business-model-references.schemas.d.ts.map +1 -1
  56. package/dist/esm/_core/business-model-lite/business-model.family-aspects.d.ts.map +1 -1
  57. package/dist/esm/_core/business-model-lite/pricing-plan.schemas.d.ts.map +1 -1
  58. package/dist/esm/_core/business-semantics.specifications.schemas.d.ts.map +1 -1
  59. package/dist/esm/_core/chart-view-specification.schemas.d.ts.map +1 -1
  60. package/dist/esm/_core/compliance-documents/compliance-completeness-statement.schemas.d.ts.map +1 -1
  61. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts +118 -0
  62. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts.map +1 -1
  63. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.js +65 -3
  64. package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.js.map +1 -1
  65. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts +508 -7
  66. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts.map +1 -1
  67. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js +489 -19
  68. package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js.map +1 -1
  69. package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.d.ts.map +1 -1
  70. package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.d.ts.map +1 -1
  71. package/dist/esm/_core/compliance-documents/processor-register.family-aspects.d.ts.map +1 -1
  72. package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts +2 -0
  73. package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts.map +1 -1
  74. package/dist/esm/_core/compliance-documents/processor-register.schemas.js +2 -0
  75. package/dist/esm/_core/compliance-documents/processor-register.schemas.js.map +1 -1
  76. package/dist/esm/_core/compliance-documents/required-document-set.schemas.d.ts.map +1 -1
  77. package/dist/esm/_core/composite-view-specification.schemas.d.ts.map +1 -1
  78. package/dist/esm/_core/cross-registry-assertions.d.ts.map +1 -1
  79. package/dist/esm/_core/data-seed-specification.schemas.d.ts.map +1 -1
  80. package/dist/esm/_core/definition-specification-validators.d.ts.map +1 -1
  81. package/dist/esm/_core/definition-specification.schemas.d.ts.map +1 -1
  82. package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.d.ts.map +1 -1
  83. package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.d.ts.map +1 -1
  84. package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.d.ts.map +1 -1
  85. package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -1
  86. package/dist/esm/_core/error-message-specification.schemas.d.ts.map +1 -1
  87. package/dist/esm/_core/execution-view-specification.schemas.d.ts.map +1 -1
  88. package/dist/esm/_core/expert-personas/expert-persona-authored-metadata.schemas.d.ts.map +1 -1
  89. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts +6 -7
  90. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts.map +1 -1
  91. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js +6 -13
  92. package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js.map +1 -1
  93. package/dist/esm/_core/expert-personas/expert-persona-validation.d.ts +0 -11
  94. package/dist/esm/_core/expert-personas/expert-persona-validation.d.ts.map +1 -1
  95. package/dist/esm/_core/expert-personas/expert-persona-validation.js +0 -19
  96. package/dist/esm/_core/expert-personas/expert-persona-validation.js.map +1 -1
  97. package/dist/esm/_core/expert-personas/expert-role-template.schemas.d.ts +1 -2
  98. package/dist/esm/_core/expert-personas/expert-role-template.schemas.d.ts.map +1 -1
  99. package/dist/esm/_core/expert-personas/expert-role-template.schemas.js +1 -2
  100. package/dist/esm/_core/expert-personas/expert-role-template.schemas.js.map +1 -1
  101. package/dist/esm/_core/family-aspects.registry.d.ts.map +1 -1
  102. package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -1
  103. package/dist/esm/_core/family-aspects.schemas.js.map +1 -1
  104. package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +9 -9
  105. package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts.map +1 -1
  106. package/dist/esm/_core/feature-drafts/capability-map-output-set-validation.d.ts.map +1 -1
  107. package/dist/esm/_core/feature-drafts/capability-map-output-set.schemas.d.ts.map +1 -1
  108. package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.d.ts.map +1 -1
  109. package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.js.map +1 -1
  110. package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.d.ts.map +1 -1
  111. package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.js +17 -4
  112. package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.js.map +1 -1
  113. package/dist/esm/_core/feature-drafts/feature-specification-drafts-validation.d.ts.map +1 -1
  114. package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.d.ts.map +1 -1
  115. package/dist/esm/_core/feature-specification.schemas.d.ts.map +1 -1
  116. package/dist/esm/_core/flows-actors-view-specification.schemas.d.ts.map +1 -1
  117. package/dist/esm/_core/frontend-component-specification.schemas.d.ts.map +1 -1
  118. package/dist/esm/_core/full-custom-view-specification.schemas.d.ts.map +1 -1
  119. package/dist/esm/_core/guidance-flow-specification.schemas.d.ts.map +1 -1
  120. package/dist/esm/_core/index.d.ts +1 -0
  121. package/dist/esm/_core/index.d.ts.map +1 -1
  122. package/dist/esm/_core/index.js +1 -0
  123. package/dist/esm/_core/index.js.map +1 -1
  124. package/dist/esm/_core/market/feature-benefit.schemas.d.ts.map +1 -1
  125. package/dist/esm/_core/market/inherit-from.d.ts.map +1 -1
  126. package/dist/esm/_core/market/is-benefit-available.d.ts.map +1 -1
  127. package/dist/esm/_core/market/market-alternative.schemas.d.ts.map +1 -1
  128. package/dist/esm/_core/market/market-authored-metadata.schemas.d.ts.map +1 -1
  129. package/dist/esm/_core/market/market-buying-journey.schemas.d.ts.map +1 -1
  130. package/dist/esm/_core/market/market-category.schemas.d.ts.map +1 -1
  131. package/dist/esm/_core/market/market-channel.schemas.d.ts.map +1 -1
  132. package/dist/esm/_core/market/market-context-block.schemas.d.ts.map +1 -1
  133. package/dist/esm/_core/market/market-gain.schemas.d.ts.map +1 -1
  134. package/dist/esm/_core/market/market-generation.schemas.d.ts.map +1 -1
  135. package/dist/esm/_core/market/market-icp.schemas.d.ts.map +1 -1
  136. package/dist/esm/_core/market/market-job.schemas.d.ts.map +1 -1
  137. package/dist/esm/_core/market/market-message-template.schemas.d.ts.map +1 -1
  138. package/dist/esm/_core/market/market-objection.schemas.d.ts.map +1 -1
  139. package/dist/esm/_core/market/market-pain.schemas.d.ts.map +1 -1
  140. package/dist/esm/_core/market/market-persona.schemas.d.ts.map +1 -1
  141. package/dist/esm/_core/market/market-positioning.schemas.d.ts.map +1 -1
  142. package/dist/esm/_core/market/market-proof.schemas.d.ts.map +1 -1
  143. package/dist/esm/_core/market/market-references.schemas.d.ts.map +1 -1
  144. package/dist/esm/_core/market/market-scoring.d.ts.map +1 -1
  145. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +18 -18
  146. package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts.map +1 -1
  147. package/dist/esm/_core/market/market-snapshot-generation.schemas.js +5 -40
  148. package/dist/esm/_core/market/market-snapshot-generation.schemas.js.map +1 -1
  149. package/dist/esm/_core/market/market-snapshot-validation.d.ts +15 -0
  150. package/dist/esm/_core/market/market-snapshot-validation.d.ts.map +1 -1
  151. package/dist/esm/_core/market/market-snapshot-validation.js.map +1 -1
  152. package/dist/esm/_core/market/market-snapshot.schemas.d.ts.map +1 -1
  153. package/dist/esm/_core/market/market-tone-of-voice.schemas.d.ts.map +1 -1
  154. package/dist/esm/_core/market/market-trigger.schemas.d.ts.map +1 -1
  155. package/dist/esm/_core/market/market.family-aspects.d.ts.map +1 -1
  156. package/dist/esm/_core/milestone-specification.schemas.d.ts.map +1 -1
  157. package/dist/esm/_core/onboarding-view-specification.schemas.d.ts.map +1 -1
  158. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.d.ts.map +1 -1
  159. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js +11 -5
  160. package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js.map +1 -1
  161. package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts +72 -9
  162. package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts.map +1 -1
  163. package/dist/esm/_core/placement-plan/placement-plan-validation.js +68 -20
  164. package/dist/esm/_core/placement-plan/placement-plan-validation.js.map +1 -1
  165. package/dist/esm/_core/placement-plan/placement-plan.family-aspects.d.ts.map +1 -1
  166. package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts +12 -5
  167. package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
  168. package/dist/esm/_core/placement-plan/placement-plan.schemas.js +12 -5
  169. package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
  170. package/dist/esm/_core/product-specification.schemas.d.ts.map +1 -1
  171. package/dist/esm/_core/provider-specification.schemas.d.ts +98 -0
  172. package/dist/esm/_core/provider-specification.schemas.d.ts.map +1 -0
  173. package/dist/esm/_core/provider-specification.schemas.js +124 -0
  174. package/dist/esm/_core/provider-specification.schemas.js.map +1 -0
  175. package/dist/esm/_core/required-features-specification.schemas.d.ts.map +1 -1
  176. package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts.map +1 -1
  177. package/dist/esm/_core/requirements/non-functional-requirement.schemas.d.ts.map +1 -1
  178. package/dist/esm/_core/requirements/requirements-authored-metadata.schemas.d.ts.map +1 -1
  179. package/dist/esm/_core/requirements/requirements-references.schemas.d.ts.map +1 -1
  180. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.d.ts.map +1 -1
  181. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js +13 -8
  182. package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js.map +1 -1
  183. package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts +15 -0
  184. package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts.map +1 -1
  185. package/dist/esm/_core/requirements/requirements-snapshot-validation.js.map +1 -1
  186. package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts.map +1 -1
  187. package/dist/esm/_core/requirements/requirements.family-aspects.d.ts.map +1 -1
  188. package/dist/esm/_core/resource-specification-registry-alignment.d.ts.map +1 -1
  189. package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
  190. package/dist/esm/_core/resource-type-member-name.types.d.ts.map +1 -1
  191. package/dist/esm/_core/roadmap/roadmap-authored-metadata.schemas.d.ts.map +1 -1
  192. package/dist/esm/_core/roadmap/roadmap-phase.schemas.d.ts.map +1 -1
  193. package/dist/esm/_core/roadmap/roadmap-references.schemas.d.ts.map +1 -1
  194. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.d.ts.map +1 -1
  195. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js +7 -2
  196. package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js.map +1 -1
  197. package/dist/esm/_core/roadmap/roadmap-snapshot-validation.d.ts +15 -0
  198. package/dist/esm/_core/roadmap/roadmap-snapshot-validation.d.ts.map +1 -1
  199. package/dist/esm/_core/roadmap/roadmap-snapshot-validation.js.map +1 -1
  200. package/dist/esm/_core/roadmap/roadmap-snapshot.schemas.d.ts.map +1 -1
  201. package/dist/esm/_core/roadmap/roadmap.family-aspects.d.ts.map +1 -1
  202. package/dist/esm/_core/role-specification.schemas.d.ts.map +1 -1
  203. package/dist/esm/_core/sidebar-section-specification.schemas.d.ts.map +1 -1
  204. package/dist/esm/_core/system-email-template-specification.schemas.d.ts.map +1 -1
  205. package/dist/esm/_core/translation-slot-specification.schemas.d.ts.map +1 -1
  206. package/dist/esm/_core/utils/extract-field-specs.d.ts.map +1 -1
  207. package/dist/esm/_core/utils/family-ref-stamping.d.ts +64 -0
  208. package/dist/esm/_core/utils/family-ref-stamping.d.ts.map +1 -0
  209. package/dist/esm/_core/utils/family-ref-stamping.js +73 -0
  210. package/dist/esm/_core/utils/family-ref-stamping.js.map +1 -0
  211. package/dist/esm/_core/utils/retention-marker-field-specs.d.ts.map +1 -1
  212. package/dist/esm/_core/utils/validate-field-shapes.d.ts.map +1 -1
  213. package/dist/esm/_core/vision/vision-authored-metadata.schemas.d.ts.map +1 -1
  214. package/dist/esm/_core/vision/vision-constraint.schemas.d.ts.map +1 -1
  215. package/dist/esm/_core/vision/vision-idea.schemas.d.ts.map +1 -1
  216. package/dist/esm/_core/vision/vision-mission.schemas.d.ts.map +1 -1
  217. package/dist/esm/_core/vision/vision-problem.schemas.d.ts.map +1 -1
  218. package/dist/esm/_core/vision/vision-references.schemas.d.ts.map +1 -1
  219. package/dist/esm/_core/vision/vision-snapshot-generation.schemas.d.ts.map +1 -1
  220. package/dist/esm/_core/vision/vision-snapshot-generation.schemas.js +23 -9
  221. package/dist/esm/_core/vision/vision-snapshot-generation.schemas.js.map +1 -1
  222. package/dist/esm/_core/vision/vision-snapshot-validation.d.ts.map +1 -1
  223. package/dist/esm/_core/vision/vision-snapshot.schemas.d.ts.map +1 -1
  224. package/dist/esm/_core/vision/vision-success-criterion.schemas.d.ts.map +1 -1
  225. package/dist/esm/_core/vision/vision.family-aspects.d.ts.map +1 -1
  226. package/dist/esm/application-creation/application-coding-tasks.application-creation.schemas.d.ts +0 -4
  227. package/dist/esm/application-creation/application-coding-tasks.application-creation.schemas.d.ts.map +1 -1
  228. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +7 -7
  229. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
  230. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +6 -7
  231. package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
  232. package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.d.ts +3 -3
  233. package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.d.ts.map +1 -1
  234. package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js +3 -3
  235. package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js.map +1 -1
  236. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts +2 -2
  237. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts.map +1 -1
  238. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js +2 -2
  239. package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js.map +1 -1
  240. package/dist/esm/application-creation/document-facts.family-aspects.d.ts.map +1 -1
  241. package/dist/esm/application-creation/document-release-policy.family-aspects.d.ts.map +1 -1
  242. package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.d.ts.map +1 -1
  243. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts +18 -6
  244. package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
  245. package/dist/esm/application-creation/journey.application-creation.schemas.js +18 -6
  246. package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
  247. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +16 -23
  248. package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
  249. package/dist/esm/application-creation/playbooks.application-creation.schemas.js +65 -27
  250. package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
  251. package/dist/esm/application-creation/specification-content-validation-state.application-creation.schemas.d.ts.map +1 -1
  252. package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts.map +1 -1
  253. package/dist/esm/application-creation-playbook-runtime.exports.d.ts.map +1 -1
  254. package/dist/esm/application-creation.exports.d.ts.map +1 -1
  255. package/dist/esm/assurance/application-document-publication.schemas.d.ts +20 -6
  256. package/dist/esm/assurance/application-document-publication.schemas.d.ts.map +1 -1
  257. package/dist/esm/assurance/application-document-publication.schemas.js +26 -10
  258. package/dist/esm/assurance/application-document-publication.schemas.js.map +1 -1
  259. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +83 -49
  260. package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
  261. package/dist/esm/assurance/assurance-authority-basis.definitions.js +194 -60
  262. package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
  263. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +25 -0
  264. package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
  265. package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts +30 -0
  266. package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts.map +1 -1
  267. package/dist/esm/assurance/assurance-document-blueprint-selection.js +40 -0
  268. package/dist/esm/assurance/assurance-document-blueprint-selection.js.map +1 -1
  269. package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
  270. package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
  271. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts +49 -0
  272. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts.map +1 -0
  273. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js +2832 -0
  274. package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -0
  275. package/dist/esm/assurance/assurance-external-framework-mapping.d.ts.map +1 -1
  276. package/dist/esm/assurance/assurance-foundation.schemas.d.ts +43 -0
  277. package/dist/esm/assurance/assurance-foundation.schemas.d.ts.map +1 -1
  278. package/dist/esm/assurance/assurance-foundation.schemas.js +56 -0
  279. package/dist/esm/assurance/assurance-foundation.schemas.js.map +1 -1
  280. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts +44 -7
  281. package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
  282. package/dist/esm/assurance/assurance-objective-catalog.definitions.js +64 -7
  283. package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
  284. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +8 -1
  285. package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -1
  286. package/dist/esm/assurance/assurance-program-generation.schemas.js +10 -2
  287. package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -1
  288. package/dist/esm/assurance/assurance-program.family-aspects.d.ts.map +1 -1
  289. package/dist/esm/assurance/assurance-program.schemas.d.ts +463 -11
  290. package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
  291. package/dist/esm/assurance/assurance-program.schemas.js +301 -5
  292. package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
  293. package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
  294. package/dist/esm/assurance/assurance-sources.schemas.d.ts.map +1 -1
  295. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts +35 -0
  296. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts.map +1 -0
  297. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js +1028 -0
  298. package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -0
  299. package/dist/esm/assurance/document-publication.family-aspects.d.ts.map +1 -1
  300. package/dist/esm/assurance.exports.d.ts.map +1 -1
  301. package/dist/esm/companion-exports.d.ts +7 -6
  302. package/dist/esm/companion-exports.d.ts.map +1 -1
  303. package/dist/esm/companion-exports.js.map +1 -1
  304. package/dist/esm/engine/_bootstrap.d.ts.map +1 -1
  305. package/dist/esm/engine/_bootstrap.js +3 -1
  306. package/dist/esm/engine/_bootstrap.js.map +1 -1
  307. package/dist/esm/engine/applications/index.d.ts.map +1 -1
  308. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
  309. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +13 -1
  310. package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
  311. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map +1 -1
  312. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +1 -1
  313. package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
  314. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts +2 -0
  315. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
  316. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +14 -2
  317. package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
  318. package/dist/esm/engine/applications/resources/application-versions.resource.specification.d.ts.map +1 -1
  319. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +9 -9
  320. package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
  321. package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts.map +1 -1
  322. package/dist/esm/engine/applications/resources/applications.resource.specification.js +1 -1
  323. package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
  324. package/dist/esm/engine/applications/resources/index.d.ts.map +1 -1
  325. package/dist/esm/engine/auth/index.d.ts.map +1 -1
  326. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts +47 -0
  327. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts.map +1 -0
  328. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js +355 -0
  329. package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js.map +1 -0
  330. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.d.ts.map +1 -1
  331. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js +3 -3
  332. package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js.map +1 -1
  333. package/dist/esm/engine/auth/resources/index.d.ts +1 -0
  334. package/dist/esm/engine/auth/resources/index.d.ts.map +1 -1
  335. package/dist/esm/engine/auth/resources/index.js +1 -0
  336. package/dist/esm/engine/auth/resources/index.js.map +1 -1
  337. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts.map +1 -1
  338. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +1 -1
  339. package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
  340. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
  341. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +13 -1
  342. package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
  343. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts +2 -0
  344. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
  345. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +14 -2
  346. package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
  347. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts +32 -0
  348. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -0
  349. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js +308 -0
  350. package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -0
  351. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts.map +1 -1
  352. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +4 -4
  353. package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
  354. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts.map +1 -1
  355. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +2 -2
  356. package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
  357. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts.map +1 -1
  358. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +6 -6
  359. package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
  360. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.d.ts.map +1 -1
  361. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +9 -9
  362. package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
  363. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.d.ts.map +1 -1
  364. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js +2 -2
  365. package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js.map +1 -1
  366. package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts +9 -25
  367. package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
  368. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +112 -10
  369. package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
  370. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts +2 -6
  371. package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
  372. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts +32 -0
  373. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts.map +1 -0
  374. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js +297 -0
  375. package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js.map +1 -0
  376. package/dist/esm/engine/billing/index.d.ts.map +1 -1
  377. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
  378. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +4 -3
  379. package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
  380. package/dist/esm/engine/billing/resources/billing-api-reference-examples.d.ts.map +1 -1
  381. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts.map +1 -1
  382. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js +2 -2
  383. package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
  384. package/dist/esm/engine/billing/resources/index.d.ts.map +1 -1
  385. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts.map +1 -1
  386. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +3 -3
  387. package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
  388. package/dist/esm/engine/billing/resources/prices.resource.specification.d.ts.map +1 -1
  389. package/dist/esm/engine/billing/resources/prices.resource.specification.js +7 -7
  390. package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
  391. package/dist/esm/engine/billing/resources/products.resource.specification.d.ts.map +1 -1
  392. package/dist/esm/engine/billing/resources/products.resource.specification.js +7 -7
  393. package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
  394. package/dist/esm/engine/billing/resources/promotions.resource.specification.d.ts.map +1 -1
  395. package/dist/esm/engine/billing/resources/promotions.resource.specification.js +14 -12
  396. package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
  397. package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts.map +1 -1
  398. package/dist/esm/engine/billing/resources/referrals.resource.specification.js +7 -7
  399. package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
  400. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
  401. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +6 -3
  402. package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
  403. package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts +7 -3
  404. package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts.map +1 -1
  405. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +28 -11
  406. package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
  407. package/dist/esm/engine/compliance/index.d.ts.map +1 -1
  408. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts +69 -0
  409. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts.map +1 -0
  410. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js +316 -0
  411. package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js.map +1 -0
  412. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts.map +1 -1
  413. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +8 -8
  414. package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
  415. package/dist/esm/engine/compliance/resources/index.d.ts +1 -0
  416. package/dist/esm/engine/compliance/resources/index.d.ts.map +1 -1
  417. package/dist/esm/engine/compliance/resources/index.js +1 -0
  418. package/dist/esm/engine/compliance/resources/index.js.map +1 -1
  419. package/dist/esm/engine/engine-resource-specifications.registry.d.ts +2 -2
  420. package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
  421. package/dist/esm/engine/engine-resource-specifications.registry.js +10 -2
  422. package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
  423. package/dist/esm/engine/engine-resource-sub-domain.d.ts +20 -0
  424. package/dist/esm/engine/engine-resource-sub-domain.d.ts.map +1 -1
  425. package/dist/esm/engine/engine-resource-sub-domain.js +66 -0
  426. package/dist/esm/engine/engine-resource-sub-domain.js.map +1 -1
  427. package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
  428. package/dist/esm/engine/errors/error-messages.specification.js +33 -0
  429. package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
  430. package/dist/esm/engine/errors/index.d.ts.map +1 -1
  431. package/dist/esm/engine/features/_engine-feature-shared.d.ts.map +1 -1
  432. package/dist/esm/engine/features/advanced-analytics.feature.specification.d.ts.map +1 -1
  433. package/dist/esm/engine/features/audit-logs.feature.specification.d.ts.map +1 -1
  434. package/dist/esm/engine/features/audit-logs.feature.specification.js +4 -4
  435. package/dist/esm/engine/features/audit-logs.feature.specification.js.map +1 -1
  436. package/dist/esm/engine/features/core-limits.feature.specifications.d.ts.map +1 -1
  437. package/dist/esm/engine/features/core-limits.feature.specifications.js +7 -7
  438. package/dist/esm/engine/features/core-limits.feature.specifications.js.map +1 -1
  439. package/dist/esm/engine/features/custom-branding.feature.specification.d.ts.map +1 -1
  440. package/dist/esm/engine/features/directory-provisioning.feature.specification.d.ts.map +1 -1
  441. package/dist/esm/engine/features/index.d.ts.map +1 -1
  442. package/dist/esm/engine/features/m2m-webhook-delivery.feature.specification.d.ts.map +1 -1
  443. package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts.map +1 -1
  444. package/dist/esm/engine/features/resources/application-features.resource.specification.js +3 -3
  445. package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
  446. package/dist/esm/engine/features/resources/index.d.ts.map +1 -1
  447. package/dist/esm/engine/features/resources/organization-features.resource.specification.d.ts.map +1 -1
  448. package/dist/esm/engine/features/resources/organization-features.resource.specification.js +3 -3
  449. package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
  450. package/dist/esm/engine/features/resources/user-features.resource.specification.d.ts.map +1 -1
  451. package/dist/esm/engine/features/resources/user-features.resource.specification.js +3 -3
  452. package/dist/esm/engine/features/resources/user-features.resource.specification.js.map +1 -1
  453. package/dist/esm/engine/features/security-event-export.feature.specification.d.ts.map +1 -1
  454. package/dist/esm/engine/features/single-sign-on.feature.specification.d.ts.map +1 -1
  455. package/dist/esm/engine/files/index.d.ts.map +1 -1
  456. package/dist/esm/engine/files/resources/files.resource.specification.d.ts.map +1 -1
  457. package/dist/esm/engine/files/resources/files.resource.specification.js +11 -11
  458. package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
  459. package/dist/esm/engine/files/resources/index.d.ts.map +1 -1
  460. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map +1 -1
  461. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js +11 -11
  462. package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
  463. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.d.ts.map +1 -1
  464. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +4 -4
  465. package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
  466. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map +1 -1
  467. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +2 -2
  468. package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
  469. package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
  470. package/dist/esm/engine/frontend-components/actions/action-bar.frontend-component.specification.d.ts.map +1 -1
  471. package/dist/esm/engine/frontend-components/actions/action-button.frontend-component.specification.d.ts.map +1 -1
  472. package/dist/esm/engine/frontend-components/actions/button-group-separator.frontend-component.specification.d.ts.map +1 -1
  473. package/dist/esm/engine/frontend-components/actions/button-group-text.frontend-component.specification.d.ts.map +1 -1
  474. package/dist/esm/engine/frontend-components/actions/button-group.frontend-component.specification.d.ts.map +1 -1
  475. package/dist/esm/engine/frontend-components/actions/button.frontend-component.specification.d.ts.map +1 -1
  476. package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-artifact-list.frontend-component.specification.d.ts.map +1 -1
  477. package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-artifact.frontend-component.specification.d.ts.map +1 -1
  478. package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-code-block.frontend-component.specification.d.ts.map +1 -1
  479. package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-image.frontend-component.specification.d.ts.map +1 -1
  480. package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-web-preview.frontend-component.specification.d.ts.map +1 -1
  481. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation.frontend-component.specification.d.ts.map +1 -1
  482. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-message.frontend-component.specification.d.ts.map +1 -1
  483. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-prompt-input.frontend-component.specification.d.ts.map +1 -1
  484. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-sources.frontend-component.specification.d.ts.map +1 -1
  485. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-suggestion.frontend-component.specification.d.ts.map +1 -1
  486. package/dist/esm/engine/frontend-components/ai-elements/chat/ai-suggestions.frontend-component.specification.d.ts.map +1 -1
  487. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.d.ts.map +1 -1
  488. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-request.frontend-component.specification.d.ts.map +1 -1
  489. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-decision-request.frontend-component.specification.d.ts.map +1 -1
  490. package/dist/esm/engine/frontend-components/ai-elements/decision/ai-human-input-request.frontend-component.specification.d.ts.map +1 -1
  491. package/dist/esm/engine/frontend-components/ai-elements/execution/ai-confirmation.frontend-component.specification.d.ts.map +1 -1
  492. package/dist/esm/engine/frontend-components/ai-elements/execution/ai-queue.frontend-component.specification.d.ts.map +1 -1
  493. package/dist/esm/engine/frontend-components/ai-elements/execution/ai-task.frontend-component.specification.d.ts.map +1 -1
  494. package/dist/esm/engine/frontend-components/ai-elements/execution/ai-tool.frontend-component.specification.d.ts.map +1 -1
  495. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-canvas.frontend-component.specification.d.ts.map +1 -1
  496. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-connection.frontend-component.specification.d.ts.map +1 -1
  497. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-controls.frontend-component.specification.d.ts.map +1 -1
  498. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-edge.frontend-component.specification.d.ts.map +1 -1
  499. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-node.frontend-component.specification.d.ts.map +1 -1
  500. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-panel.frontend-component.specification.d.ts.map +1 -1
  501. package/dist/esm/engine/frontend-components/ai-elements/graph/ai-toolbar.frontend-component.specification.d.ts.map +1 -1
  502. package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-capabilities.frontend-component.specification.d.ts.map +1 -1
  503. package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-card.frontend-component.specification.d.ts.map +1 -1
  504. package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-list.frontend-component.specification.d.ts.map +1 -1
  505. package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-prompt-spec.frontend-component.specification.d.ts.map +1 -1
  506. package/dist/esm/engine/frontend-components/ai-elements/meta/ai-context.frontend-component.specification.d.ts.map +1 -1
  507. package/dist/esm/engine/frontend-components/ai-elements/meta/ai-model-selector.frontend-component.specification.d.ts.map +1 -1
  508. package/dist/esm/engine/frontend-components/ai-elements/meta/ai-open-in-chat.frontend-component.specification.d.ts.map +1 -1
  509. package/dist/esm/engine/frontend-components/ai-elements/shared/ai-loader.frontend-component.specification.d.ts.map +1 -1
  510. package/dist/esm/engine/frontend-components/ai-elements/shared/ai-shimmer.frontend-component.specification.d.ts.map +1 -1
  511. package/dist/esm/engine/frontend-components/ai-elements/trace/ai-chain-of-thought.frontend-component.specification.d.ts.map +1 -1
  512. package/dist/esm/engine/frontend-components/ai-elements/trace/ai-checkpoint.frontend-component.specification.d.ts.map +1 -1
  513. package/dist/esm/engine/frontend-components/ai-elements/trace/ai-inline-citation.frontend-component.specification.d.ts.map +1 -1
  514. package/dist/esm/engine/frontend-components/ai-elements/trace/ai-plan.frontend-component.specification.d.ts.map +1 -1
  515. package/dist/esm/engine/frontend-components/ai-elements/trace/ai-reasoning.frontend-component.specification.d.ts.map +1 -1
  516. package/dist/esm/engine/frontend-components/app/app-layout-appearance-settings.frontend-component.specification.d.ts.map +1 -1
  517. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts +5 -0
  518. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts.map +1 -0
  519. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js +81 -0
  520. package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js.map +1 -0
  521. package/dist/esm/engine/frontend-components/app/app-layout-error-boundary.frontend-component.specification.d.ts.map +1 -1
  522. package/dist/esm/engine/frontend-components/app/app-layout-home.frontend-component.specification.d.ts.map +1 -1
  523. package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.d.ts.map +1 -1
  524. package/dist/esm/engine/frontend-components/app/app-layout-main-container.frontend-component.specification.d.ts.map +1 -1
  525. package/dist/esm/engine/frontend-components/app/app-layout-router-error-boundary.frontend-component.specification.d.ts.map +1 -1
  526. package/dist/esm/engine/frontend-components/app/app-layout-settings-hub.frontend-component.specification.d.ts.map +1 -1
  527. package/dist/esm/engine/frontend-components/app/app-layouts-test-component.frontend-component.specification.d.ts.map +1 -1
  528. package/dist/esm/engine/frontend-components/app/lifecycle-home-activation-progress.frontend-component.specification.d.ts.map +1 -1
  529. package/dist/esm/engine/frontend-components/app/lifecycle-home-dashboard.frontend-component.specification.d.ts.map +1 -1
  530. package/dist/esm/engine/frontend-components/app/lifecycle-home-welcome-back.frontend-component.specification.d.ts.map +1 -1
  531. package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.d.ts +4 -0
  532. package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.d.ts.map +1 -0
  533. package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.js +22 -0
  534. package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.js.map +1 -0
  535. package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.d.ts.map +1 -1
  536. package/dist/esm/engine/frontend-components/app/public-layout-static-content-container.frontend-component.specification.d.ts.map +1 -1
  537. package/dist/esm/engine/frontend-components/app/public-layout-terms.frontend-component.specification.d.ts.map +1 -1
  538. package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.d.ts.map +1 -1
  539. package/dist/esm/engine/frontend-components/auth/public-layout-auth-callback.frontend-component.specification.d.ts.map +1 -1
  540. package/dist/esm/engine/frontend-components/auth/public-layout-enrollment-required.frontend-component.specification.d.ts.map +1 -1
  541. package/dist/esm/engine/frontend-components/auth/public-layout-magic-link-verify.frontend-component.specification.d.ts.map +1 -1
  542. package/dist/esm/engine/frontend-components/auth/public-layout-mfa-challenge.frontend-component.specification.d.ts.map +1 -1
  543. package/dist/esm/engine/frontend-components/auth/public-layout-oauth-consent.frontend-component.specification.d.ts.map +1 -1
  544. package/dist/esm/engine/frontend-components/auth/public-layout-oauth-logged-out.frontend-component.specification.d.ts.map +1 -1
  545. package/dist/esm/engine/frontend-components/auth/public-layout-oauth-logout-confirm.frontend-component.specification.d.ts.map +1 -1
  546. package/dist/esm/engine/frontend-components/auth/public-layout-one-off-session.frontend-component.specification.d.ts.map +1 -1
  547. package/dist/esm/engine/frontend-components/auth/public-layout-user-auth.frontend-component.specification.d.ts.map +1 -1
  548. package/dist/esm/engine/frontend-components/auth/public-layout-user-confirm-email.frontend-component.specification.d.ts.map +1 -1
  549. package/dist/esm/engine/frontend-components/auth/public-layout-user-invitation.frontend-component.specification.d.ts.map +1 -1
  550. package/dist/esm/engine/frontend-components/auth/public-layout-user-password-lost.frontend-component.specification.d.ts.map +1 -1
  551. package/dist/esm/engine/frontend-components/auth/public-layout-user-register.frontend-component.specification.d.ts.map +1 -1
  552. package/dist/esm/engine/frontend-components/billing/billing-invoice-history.frontend-component.specification.d.ts.map +1 -1
  553. package/dist/esm/engine/frontend-components/billing/billing-portal-link.frontend-component.specification.d.ts.map +1 -1
  554. package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.d.ts.map +1 -1
  555. package/dist/esm/engine/frontend-components/billing/billing-subscription-status.frontend-component.specification.d.ts.map +1 -1
  556. package/dist/esm/engine/frontend-components/billing/billing-usage-dashboard.frontend-component.specification.d.ts.map +1 -1
  557. package/dist/esm/engine/frontend-components/data-display/avatar.frontend-component.specification.d.ts.map +1 -1
  558. package/dist/esm/engine/frontend-components/data-display/badge.frontend-component.specification.d.ts.map +1 -1
  559. package/dist/esm/engine/frontend-components/data-display/description-details.frontend-component.specification.d.ts.map +1 -1
  560. package/dist/esm/engine/frontend-components/data-display/description-list.frontend-component.specification.d.ts.map +1 -1
  561. package/dist/esm/engine/frontend-components/data-display/description-term.frontend-component.specification.d.ts.map +1 -1
  562. package/dist/esm/engine/frontend-components/data-display/formatters/_display-field-spec.factory.d.ts.map +1 -1
  563. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-bigdecimal.frontend-component.specification.d.ts.map +1 -1
  564. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-boolean.frontend-component.specification.d.ts.map +1 -1
  565. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-code.frontend-component.specification.d.ts.map +1 -1
  566. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-date.frontend-component.specification.d.ts.map +1 -1
  567. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-datetime.frontend-component.specification.d.ts.map +1 -1
  568. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-duration.frontend-component.specification.d.ts.map +1 -1
  569. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-enum.frontend-component.specification.d.ts.map +1 -1
  570. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-audio.frontend-component.specification.d.ts.map +1 -1
  571. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-document.frontend-component.specification.d.ts.map +1 -1
  572. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-gallery.frontend-component.specification.d.ts.map +1 -1
  573. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-image.frontend-component.specification.d.ts.map +1 -1
  574. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-video.frontend-component.specification.d.ts.map +1 -1
  575. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file.frontend-component.specification.d.ts.map +1 -1
  576. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-foreign-key.frontend-component.specification.d.ts.map +1 -1
  577. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-money.extra-props.d.ts.map +1 -1
  578. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-money.frontend-component.specification.d.ts.map +1 -1
  579. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-number.frontend-component.specification.d.ts.map +1 -1
  580. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-phone.frontend-component.specification.d.ts.map +1 -1
  581. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-bigdecimal.frontend-component.specification.d.ts.map +1 -1
  582. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-date.frontend-component.specification.d.ts.map +1 -1
  583. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-datetime.frontend-component.specification.d.ts.map +1 -1
  584. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-money.frontend-component.specification.d.ts.map +1 -1
  585. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-number.frontend-component.specification.d.ts.map +1 -1
  586. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-time.frontend-component.specification.d.ts.map +1 -1
  587. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-string.frontend-component.specification.d.ts.map +1 -1
  588. package/dist/esm/engine/frontend-components/data-display/formatters/display-field-time.frontend-component.specification.d.ts.map +1 -1
  589. package/dist/esm/engine/frontend-components/data-display/notification-indicator.frontend-component.specification.d.ts.map +1 -1
  590. package/dist/esm/engine/frontend-components/feedback/celebration-overlay.frontend-component.specification.d.ts.map +1 -1
  591. package/dist/esm/engine/frontend-components/feedback/danger-zone.frontend-component.specification.d.ts.map +1 -1
  592. package/dist/esm/engine/frontend-components/feedback/empty-state.frontend-component.specification.d.ts.map +1 -1
  593. package/dist/esm/engine/frontend-components/feedback/error-display.frontend-component.specification.d.ts.map +1 -1
  594. package/dist/esm/engine/frontend-components/feedback/features/feature-limit-indicator.frontend-component.specification.d.ts.map +1 -1
  595. package/dist/esm/engine/frontend-components/feedback/features/feature-lock-badge.frontend-component.specification.d.ts.map +1 -1
  596. package/dist/esm/engine/frontend-components/feedback/features/feature-unavailable-dialog.frontend-component.specification.d.ts.map +1 -1
  597. package/dist/esm/engine/frontend-components/feedback/features/feature-unavailable-prompt.frontend-component.specification.d.ts.map +1 -1
  598. package/dist/esm/engine/frontend-components/feedback/loading-overlay.frontend-component.specification.d.ts.map +1 -1
  599. package/dist/esm/engine/frontend-components/feedback/loading-spinner.frontend-component.specification.d.ts.map +1 -1
  600. package/dist/esm/engine/frontend-components/feedback/operations-confirm-critical.frontend-component.specification.d.ts.map +1 -1
  601. package/dist/esm/engine/frontend-components/feedback/progress.frontend-component.specification.d.ts.map +1 -1
  602. package/dist/esm/engine/frontend-components/feedback/skeleton.frontend-component.specification.d.ts.map +1 -1
  603. package/dist/esm/engine/frontend-components/feedback/toast.frontend-component.specification.d.ts.map +1 -1
  604. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-actor.frontend-component.specification.d.ts.map +1 -1
  605. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-agent-config.frontend-component.specification.d.ts.map +1 -1
  606. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.d.ts.map +1 -1
  607. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js +1 -1
  608. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js.map +1 -1
  609. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-artifact-browser.frontend-component.specification.d.ts.map +1 -1
  610. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.d.ts.map +1 -1
  611. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-plan.frontend-component.specification.d.ts.map +1 -1
  612. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-stream.frontend-component.specification.d.ts.map +1 -1
  613. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-flow-execution.frontend-component.specification.d.ts.map +1 -1
  614. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-flow-node.frontend-component.specification.d.ts.map +1 -1
  615. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-system-catalog.frontend-component.specification.d.ts.map +1 -1
  616. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-task-detail.frontend-component.specification.d.ts.map +1 -1
  617. package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-task-memory.frontend-component.specification.d.ts.map +1 -1
  618. package/dist/esm/engine/frontend-components/form/_framework-layout-form-field-spec.factory.d.ts.map +1 -1
  619. package/dist/esm/engine/frontend-components/form/_low-level-preset-wrapper-spec.factory.d.ts.map +1 -1
  620. package/dist/esm/engine/frontend-components/form/autosave-indicator.frontend-component.specification.d.ts.map +1 -1
  621. package/dist/esm/engine/frontend-components/form/chromes/field-content.frontend-component.specification.d.ts.map +1 -1
  622. package/dist/esm/engine/frontend-components/form/chromes/field-description.frontend-component.specification.d.ts.map +1 -1
  623. package/dist/esm/engine/frontend-components/form/chromes/field-error.frontend-component.specification.d.ts.map +1 -1
  624. package/dist/esm/engine/frontend-components/form/chromes/field-label.frontend-component.specification.d.ts.map +1 -1
  625. package/dist/esm/engine/frontend-components/form/chromes/field-separator.frontend-component.specification.d.ts.map +1 -1
  626. package/dist/esm/engine/frontend-components/form/chromes/field-title.frontend-component.specification.d.ts.map +1 -1
  627. package/dist/esm/engine/frontend-components/form/chromes/field.frontend-component.specification.d.ts.map +1 -1
  628. package/dist/esm/engine/frontend-components/form/chromes/form-control.frontend-component.specification.d.ts.map +1 -1
  629. package/dist/esm/engine/frontend-components/form/chromes/form-description.frontend-component.specification.d.ts.map +1 -1
  630. package/dist/esm/engine/frontend-components/form/chromes/form-field.frontend-component.specification.d.ts.map +1 -1
  631. package/dist/esm/engine/frontend-components/form/chromes/form-item.frontend-component.specification.d.ts.map +1 -1
  632. package/dist/esm/engine/frontend-components/form/chromes/form-label.frontend-component.specification.d.ts.map +1 -1
  633. package/dist/esm/engine/frontend-components/form/chromes/form-message.frontend-component.specification.d.ts.map +1 -1
  634. package/dist/esm/engine/frontend-components/form/chromes/form-root.frontend-component.specification.d.ts.map +1 -1
  635. package/dist/esm/engine/frontend-components/form/combobox-multiple.frontend-component.specification.d.ts.map +1 -1
  636. package/dist/esm/engine/frontend-components/form/combobox.frontend-component.specification.d.ts.map +1 -1
  637. package/dist/esm/engine/frontend-components/form/controls/boolean/checkbox.frontend-component.specification.d.ts.map +1 -1
  638. package/dist/esm/engine/frontend-components/form/controls/boolean/switch.frontend-component.specification.d.ts.map +1 -1
  639. package/dist/esm/engine/frontend-components/form/controls/boolean/toggle-group-boolean.frontend-component.specification.d.ts.map +1 -1
  640. package/dist/esm/engine/frontend-components/form/controls/boolean/toggle.frontend-component.specification.d.ts.map +1 -1
  641. package/dist/esm/engine/frontend-components/form/controls/date-time/calendar-day-button.frontend-component.specification.d.ts.map +1 -1
  642. package/dist/esm/engine/frontend-components/form/controls/date-time/calendar.frontend-component.specification.d.ts.map +1 -1
  643. package/dist/esm/engine/frontend-components/form/controls/date-time/date-range-picker.frontend-component.specification.d.ts.map +1 -1
  644. package/dist/esm/engine/frontend-components/form/controls/date-time/datepicker.frontend-component.specification.d.ts.map +1 -1
  645. package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-picker.frontend-component.specification.d.ts.map +1 -1
  646. package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-range-picker.frontend-component.specification.d.ts.map +1 -1
  647. package/dist/esm/engine/frontend-components/form/controls/date-time/time-picker.frontend-component.specification.d.ts.map +1 -1
  648. package/dist/esm/engine/frontend-components/form/controls/date-time/time-range-picker.frontend-component.specification.d.ts.map +1 -1
  649. package/dist/esm/engine/frontend-components/form/controls/enum/radio-group.frontend-component.specification.d.ts.map +1 -1
  650. package/dist/esm/engine/frontend-components/form/controls/enum/radio-item.frontend-component.specification.d.ts.map +1 -1
  651. package/dist/esm/engine/frontend-components/form/controls/enum/select-multiple.frontend-component.specification.d.ts.map +1 -1
  652. package/dist/esm/engine/frontend-components/form/controls/enum/select.frontend-component.specification.d.ts.map +1 -1
  653. package/dist/esm/engine/frontend-components/form/controls/enum/toggle-group.frontend-component.specification.d.ts.map +1 -1
  654. package/dist/esm/engine/frontend-components/form/controls/file/file-upload.frontend-component.specification.d.ts.map +1 -1
  655. package/dist/esm/engine/frontend-components/form/controls/file/image-crop.frontend-component.specification.d.ts.map +1 -1
  656. package/dist/esm/engine/frontend-components/form/controls/input-group-addon.frontend-component.specification.d.ts.map +1 -1
  657. package/dist/esm/engine/frontend-components/form/controls/input-group-button.frontend-component.specification.d.ts.map +1 -1
  658. package/dist/esm/engine/frontend-components/form/controls/input-group-input.frontend-component.specification.d.ts.map +1 -1
  659. package/dist/esm/engine/frontend-components/form/controls/input-group-text.frontend-component.specification.d.ts.map +1 -1
  660. package/dist/esm/engine/frontend-components/form/controls/input-group-textarea.frontend-component.specification.d.ts.map +1 -1
  661. package/dist/esm/engine/frontend-components/form/controls/input-group.frontend-component.specification.d.ts.map +1 -1
  662. package/dist/esm/engine/frontend-components/form/controls/input.frontend-component.specification.d.ts.map +1 -1
  663. package/dist/esm/engine/frontend-components/form/controls/number/range-slider.frontend-component.specification.d.ts.map +1 -1
  664. package/dist/esm/engine/frontend-components/form/controls/number/slider.frontend-component.specification.d.ts.map +1 -1
  665. package/dist/esm/engine/frontend-components/form/controls/string/color-input.frontend-component.specification.d.ts.map +1 -1
  666. package/dist/esm/engine/frontend-components/form/controls/string/input-otp.frontend-component.specification.d.ts.map +1 -1
  667. package/dist/esm/engine/frontend-components/form/controls/string/markdown-editor.frontend-component.specification.d.ts.map +1 -1
  668. package/dist/esm/engine/frontend-components/form/controls/string/password-input.frontend-component.specification.d.ts.map +1 -1
  669. package/dist/esm/engine/frontend-components/form/controls/string/textarea.frontend-component.specification.d.ts.map +1 -1
  670. package/dist/esm/engine/frontend-components/form/fields/form-field-bigdecimal.frontend-component.specification.d.ts.map +1 -1
  671. package/dist/esm/engine/frontend-components/form/fields/form-field-boolean.frontend-component.specification.d.ts.map +1 -1
  672. package/dist/esm/engine/frontend-components/form/fields/form-field-code.frontend-component.specification.d.ts.map +1 -1
  673. package/dist/esm/engine/frontend-components/form/fields/form-field-date.frontend-component.specification.d.ts.map +1 -1
  674. package/dist/esm/engine/frontend-components/form/fields/form-field-datetime.frontend-component.specification.d.ts.map +1 -1
  675. package/dist/esm/engine/frontend-components/form/fields/form-field-duration.frontend-component.specification.d.ts.map +1 -1
  676. package/dist/esm/engine/frontend-components/form/fields/form-field-enum.frontend-component.specification.d.ts.map +1 -1
  677. package/dist/esm/engine/frontend-components/form/fields/form-field-file.frontend-component.specification.d.ts.map +1 -1
  678. package/dist/esm/engine/frontend-components/form/fields/form-field-money.frontend-component.specification.d.ts.map +1 -1
  679. package/dist/esm/engine/frontend-components/form/fields/form-field-number.frontend-component.specification.d.ts.map +1 -1
  680. package/dist/esm/engine/frontend-components/form/fields/form-field-phone.frontend-component.specification.d.ts.map +1 -1
  681. package/dist/esm/engine/frontend-components/form/fields/form-field-range-bigdecimal.frontend-component.specification.d.ts.map +1 -1
  682. package/dist/esm/engine/frontend-components/form/fields/form-field-range-date.frontend-component.specification.d.ts.map +1 -1
  683. package/dist/esm/engine/frontend-components/form/fields/form-field-range-datetime.frontend-component.specification.d.ts.map +1 -1
  684. package/dist/esm/engine/frontend-components/form/fields/form-field-range-money.frontend-component.specification.d.ts.map +1 -1
  685. package/dist/esm/engine/frontend-components/form/fields/form-field-range-number.frontend-component.specification.d.ts.map +1 -1
  686. package/dist/esm/engine/frontend-components/form/fields/form-field-range-time.frontend-component.specification.d.ts.map +1 -1
  687. package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.d.ts.map +1 -1
  688. package/dist/esm/engine/frontend-components/form/fields/form-field-time.frontend-component.specification.d.ts.map +1 -1
  689. package/dist/esm/engine/frontend-components/form/form-field-foreign-key.frontend-component.specification.d.ts.map +1 -1
  690. package/dist/esm/engine/frontend-components/guidance/guidance-announcement.frontend-component.specification.d.ts.map +1 -1
  691. package/dist/esm/engine/frontend-components/guidance/guidance-badge.frontend-component.specification.d.ts.map +1 -1
  692. package/dist/esm/engine/frontend-components/guidance/guidance-banner.frontend-component.specification.d.ts.map +1 -1
  693. package/dist/esm/engine/frontend-components/guidance/guidance-card.frontend-component.specification.d.ts.map +1 -1
  694. package/dist/esm/engine/frontend-components/guidance/guidance-checklist-item.frontend-component.specification.d.ts.map +1 -1
  695. package/dist/esm/engine/frontend-components/guidance/guidance-checklist.frontend-component.specification.d.ts.map +1 -1
  696. package/dist/esm/engine/frontend-components/guidance/guidance-modal.frontend-component.specification.d.ts.map +1 -1
  697. package/dist/esm/engine/frontend-components/guidance/guidance-onboarding-view.frontend-component.specification.d.ts.map +1 -1
  698. package/dist/esm/engine/frontend-components/guidance/guidance-survey.frontend-component.specification.d.ts.map +1 -1
  699. package/dist/esm/engine/frontend-components/guidance/guidance-tooltip.frontend-component.specification.d.ts.map +1 -1
  700. package/dist/esm/engine/frontend-components/guidance/guidance-tour.frontend-component.specification.d.ts.map +1 -1
  701. package/dist/esm/engine/frontend-components/high-level-views/chart-echarts.frontend-component.specification.d.ts.map +1 -1
  702. package/dist/esm/engine/frontend-components/high-level-views/chart-widget.frontend-component.specification.d.ts.map +1 -1
  703. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-chart.frontend-component.specification.d.ts.map +1 -1
  704. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-composite.frontend-component.specification.d.ts.map +1 -1
  705. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-execution.frontend-component.specification.d.ts.map +1 -1
  706. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-flows-actors.frontend-component.specification.d.ts.map +1 -1
  707. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-full-custom.frontend-component.specification.d.ts.map +1 -1
  708. package/dist/esm/engine/frontend-components/high-level-views/high-level-views-not-found.frontend-component.specification.d.ts.map +1 -1
  709. package/dist/esm/engine/frontend-components/index.d.ts +0 -2
  710. package/dist/esm/engine/frontend-components/index.d.ts.map +1 -1
  711. package/dist/esm/engine/frontend-components/index.js +4 -6
  712. package/dist/esm/engine/frontend-components/index.js.map +1 -1
  713. package/dist/esm/engine/frontend-components/internal/_tier2-virtual-slot-spec.factory.d.ts.map +1 -1
  714. package/dist/esm/engine/frontend-components/layout/aspect-ratio.frontend-component.specification.d.ts.map +1 -1
  715. package/dist/esm/engine/frontend-components/layout/carousel.frontend-component.specification.d.ts.map +1 -1
  716. package/dist/esm/engine/frontend-components/layout/divider.frontend-component.specification.d.ts.map +1 -1
  717. package/dist/esm/engine/frontend-components/layout/resizable-panel-group.frontend-component.specification.d.ts.map +1 -1
  718. package/dist/esm/engine/frontend-components/layout/scroll-area.frontend-component.specification.d.ts.map +1 -1
  719. package/dist/esm/engine/frontend-components/layout/separator.frontend-component.specification.d.ts.map +1 -1
  720. package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section-container.frontend-component.specification.d.ts.map +1 -1
  721. package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section-group.frontend-component.specification.d.ts.map +1 -1
  722. package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section-legend.frontend-component.specification.d.ts.map +1 -1
  723. package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section.frontend-component.specification.d.ts.map +1 -1
  724. package/dist/esm/engine/frontend-components/layout-internals/low-level-overlay-container.frontend-component.specification.d.ts.map +1 -1
  725. package/dist/esm/engine/frontend-components/navigation/app-level/activity-bar.frontend-component.specification.d.ts.map +1 -1
  726. package/dist/esm/engine/frontend-components/navigation/app-level/command-menu.frontend-component.specification.d.ts.map +1 -1
  727. package/dist/esm/engine/frontend-components/navigation/app-level/control-panel.frontend-component.specification.d.ts.map +1 -1
  728. package/dist/esm/engine/frontend-components/navigation/app-level/menubar.frontend-component.specification.d.ts.map +1 -1
  729. package/dist/esm/engine/frontend-components/navigation/app-level/navigation-back.frontend-component.specification.d.ts.map +1 -1
  730. package/dist/esm/engine/frontend-components/navigation/app-level/notification-center.frontend-component.specification.d.ts.map +1 -1
  731. package/dist/esm/engine/frontend-components/navigation/app-level/quick-action-button.frontend-component.specification.d.ts.map +1 -1
  732. package/dist/esm/engine/frontend-components/navigation/app-level/quick-switcher.frontend-component.specification.d.ts.map +1 -1
  733. package/dist/esm/engine/frontend-components/navigation/app-level/sidebar.frontend-component.specification.d.ts.map +1 -1
  734. package/dist/esm/engine/frontend-components/navigation/app-level/status-bar.frontend-component.specification.d.ts.map +1 -1
  735. package/dist/esm/engine/frontend-components/navigation/app-level/toolbar.frontend-component.specification.d.ts.map +1 -1
  736. package/dist/esm/engine/frontend-components/navigation/app-level/user-dropdown.frontend-component.specification.d.ts.map +1 -1
  737. package/dist/esm/engine/frontend-components/navigation/app-level/utility-panel.frontend-component.specification.d.ts.map +1 -1
  738. package/dist/esm/engine/frontend-components/navigation/breadcrumb.frontend-component.specification.d.ts.map +1 -1
  739. package/dist/esm/engine/frontend-components/navigation/command.frontend-component.specification.d.ts.map +1 -1
  740. package/dist/esm/engine/frontend-components/navigation/menu-bar.frontend-component.specification.d.ts.map +1 -1
  741. package/dist/esm/engine/frontend-components/navigation/navbar.frontend-component.specification.d.ts.map +1 -1
  742. package/dist/esm/engine/frontend-components/navigation/sidebar.frontend-component.specification.d.ts.map +1 -1
  743. package/dist/esm/engine/frontend-components/overlays/containers/alert-dialog.frontend-component.specification.d.ts.map +1 -1
  744. package/dist/esm/engine/frontend-components/overlays/containers/alert.frontend-component.specification.d.ts.map +1 -1
  745. package/dist/esm/engine/frontend-components/overlays/containers/dialog.frontend-component.specification.d.ts.map +1 -1
  746. package/dist/esm/engine/frontend-components/overlays/containers/drawer.frontend-component.specification.d.ts.map +1 -1
  747. package/dist/esm/engine/frontend-components/overlays/containers/sheet.frontend-component.specification.d.ts.map +1 -1
  748. package/dist/esm/engine/frontend-components/overlays/floating/context-menu.frontend-component.specification.d.ts.map +1 -1
  749. package/dist/esm/engine/frontend-components/overlays/floating/dropdown-menu.frontend-component.specification.d.ts.map +1 -1
  750. package/dist/esm/engine/frontend-components/overlays/floating/hover-card.frontend-component.specification.d.ts.map +1 -1
  751. package/dist/esm/engine/frontend-components/overlays/floating/popover.frontend-component.specification.d.ts.map +1 -1
  752. package/dist/esm/engine/frontend-components/overlays/floating/tooltip.frontend-component.specification.d.ts.map +1 -1
  753. package/dist/esm/engine/frontend-components/progression/progression-achievement-badge.frontend-component.specification.d.ts.map +1 -1
  754. package/dist/esm/engine/frontend-components/progression/progression-milestone-tracker.frontend-component.specification.d.ts.map +1 -1
  755. package/dist/esm/engine/frontend-components/resources/_framework-layout-resource-layout-spec.factory.d.ts.map +1 -1
  756. package/dist/esm/engine/frontend-components/resources/resource-layout-action.frontend-component.specification.d.ts.map +1 -1
  757. package/dist/esm/engine/frontend-components/resources/resource-layout-breadcrumb.frontend-component.specification.d.ts.map +1 -1
  758. package/dist/esm/engine/frontend-components/resources/resource-layout-container-dialogs.frontend-component.specification.d.ts.map +1 -1
  759. package/dist/esm/engine/frontend-components/resources/resource-layout-container-nested.frontend-component.specification.d.ts.map +1 -1
  760. package/dist/esm/engine/frontend-components/resources/resource-layout-create.frontend-component.specification.d.ts.map +1 -1
  761. package/dist/esm/engine/frontend-components/resources/resource-layout-danger-zone.frontend-component.specification.d.ts.map +1 -1
  762. package/dist/esm/engine/frontend-components/resources/resource-layout-empty-state.frontend-component.specification.d.ts.map +1 -1
  763. package/dist/esm/engine/frontend-components/resources/resource-layout-filters.frontend-component.specification.d.ts.map +1 -1
  764. package/dist/esm/engine/frontend-components/resources/resource-layout-header.frontend-component.specification.d.ts.map +1 -1
  765. package/dist/esm/engine/frontend-components/resources/resource-layout-list-table.frontend-component.preset-specification.d.ts.map +1 -1
  766. package/dist/esm/engine/frontend-components/resources/resource-layout-list.frontend-component.specification.d.ts.map +1 -1
  767. package/dist/esm/engine/frontend-components/resources/resource-layout-operation-bulk.frontend-component.specification.d.ts.map +1 -1
  768. package/dist/esm/engine/frontend-components/resources/resource-layout-operations-items.frontend-component.specification.d.ts.map +1 -1
  769. package/dist/esm/engine/frontend-components/resources/resource-layout-pagination.frontend-component.specification.d.ts.map +1 -1
  770. package/dist/esm/engine/frontend-components/resources/resource-layout-read-expandable.frontend-component.preset-specification.d.ts.map +1 -1
  771. package/dist/esm/engine/frontend-components/resources/resource-layout-read-summary-table-row.frontend-component.preset-specification.d.ts.map +1 -1
  772. package/dist/esm/engine/frontend-components/resources/resource-layout-read-summary.frontend-component.specification.d.ts.map +1 -1
  773. package/dist/esm/engine/frontend-components/resources/resource-layout-read.frontend-component.specification.d.ts.map +1 -1
  774. package/dist/esm/engine/frontend-components/resources/resource-layout-search-table.frontend-component.preset-specification.d.ts.map +1 -1
  775. package/dist/esm/engine/frontend-components/resources/resource-layout-search.frontend-component.specification.d.ts.map +1 -1
  776. package/dist/esm/engine/frontend-components/resources/resource-layout-update.frontend-component.specification.d.ts.map +1 -1
  777. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-display.frontend-component.specification.d.ts.map +1 -1
  778. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit-search.frontend-component.preset-specification.d.ts.map +1 -1
  779. package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit.frontend-component.specification.d.ts.map +1 -1
  780. package/dist/esm/engine/frontend-components/sections/accordion.frontend-component.specification.d.ts.map +1 -1
  781. package/dist/esm/engine/frontend-components/sections/card.frontend-component.specification.d.ts.map +1 -1
  782. package/dist/esm/engine/frontend-components/sections/collapsible.frontend-component.specification.d.ts.map +1 -1
  783. package/dist/esm/engine/frontend-components/sections/pagination.frontend-component.specification.d.ts.map +1 -1
  784. package/dist/esm/engine/frontend-components/sections/stacked-layout.frontend-component.specification.d.ts.map +1 -1
  785. package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.d.ts.map +1 -1
  786. package/dist/esm/engine/frontend-components/sections/table.frontend-component.specification.d.ts.map +1 -1
  787. package/dist/esm/engine/frontend-components/sections/tabs.frontend-component.specification.d.ts.map +1 -1
  788. package/dist/esm/engine/frontend-components/typography/code.frontend-component.specification.d.ts.map +1 -1
  789. package/dist/esm/engine/frontend-components/typography/heading.frontend-component.specification.d.ts.map +1 -1
  790. package/dist/esm/engine/frontend-components/typography/label.frontend-component.specification.d.ts.map +1 -1
  791. package/dist/esm/engine/frontend-components/typography/link.frontend-component.specification.d.ts.map +1 -1
  792. package/dist/esm/engine/frontend-components/typography/strong.frontend-component.specification.d.ts.map +1 -1
  793. package/dist/esm/engine/frontend-components/typography/subheading.frontend-component.specification.d.ts.map +1 -1
  794. package/dist/esm/engine/frontend-components/typography/text-link.frontend-component.specification.d.ts.map +1 -1
  795. package/dist/esm/engine/frontend-components/typography/text.frontend-component.specification.d.ts.map +1 -1
  796. package/dist/esm/engine/full-custom-views/index.d.ts.map +1 -1
  797. package/dist/esm/engine/guidance/index.d.ts.map +1 -1
  798. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.d.ts.map +1 -1
  799. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js +12 -12
  800. package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js.map +1 -1
  801. package/dist/esm/engine/guidance/resources/index.d.ts.map +1 -1
  802. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts.map +1 -1
  803. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js +9 -9
  804. package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js.map +1 -1
  805. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts +8 -0
  806. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts.map +1 -1
  807. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js +6 -6
  808. package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
  809. package/dist/esm/engine/index.d.ts +1 -0
  810. package/dist/esm/engine/index.d.ts.map +1 -1
  811. package/dist/esm/engine/index.js +1 -0
  812. package/dist/esm/engine/index.js.map +1 -1
  813. package/dist/esm/engine/infrastructure/index.d.ts.map +1 -1
  814. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.d.ts.map +1 -1
  815. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +17 -17
  816. package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
  817. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.d.ts.map +1 -1
  818. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +7 -7
  819. package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
  820. package/dist/esm/engine/infrastructure/resources/index.d.ts.map +1 -1
  821. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts.map +1 -1
  822. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js +8 -8
  823. package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js.map +1 -1
  824. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts +7 -2
  825. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts.map +1 -1
  826. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +10 -5
  827. package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
  828. package/dist/esm/engine/notifications/index.d.ts.map +1 -1
  829. package/dist/esm/engine/notifications/resources/index.d.ts.map +1 -1
  830. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
  831. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +20 -15
  832. package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
  833. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts.map +1 -1
  834. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js +11 -10
  835. package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js.map +1 -1
  836. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
  837. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +29 -6
  838. package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
  839. package/dist/esm/engine/notifications/system-emails/authentication.system-emails.specification.d.ts.map +1 -1
  840. package/dist/esm/engine/notifications/system-emails/index.d.ts.map +1 -1
  841. package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.d.ts.map +1 -1
  842. package/dist/esm/engine/notifications/system-emails/security.system-emails.specification.d.ts.map +1 -1
  843. package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.d.ts.map +1 -1
  844. package/dist/esm/engine/organizations/index.d.ts.map +1 -1
  845. package/dist/esm/engine/organizations/resources/index.d.ts.map +1 -1
  846. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts.map +1 -1
  847. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +9 -9
  848. package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
  849. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.d.ts.map +1 -1
  850. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js +3 -3
  851. package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js.map +1 -1
  852. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.d.ts.map +1 -1
  853. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js +4 -4
  854. package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js.map +1 -1
  855. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts.map +1 -1
  856. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +2 -2
  857. package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
  858. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts.map +1 -1
  859. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +1 -1
  860. package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
  861. package/dist/esm/engine/organizations/resources/organization-units.resource.specification.d.ts.map +1 -1
  862. package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts.map +1 -1
  863. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +7 -7
  864. package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
  865. package/dist/esm/engine/providers/_engine-provider-shared.d.ts +9 -0
  866. package/dist/esm/engine/providers/_engine-provider-shared.d.ts.map +1 -0
  867. package/dist/esm/engine/providers/_engine-provider-shared.js +19 -0
  868. package/dist/esm/engine/providers/_engine-provider-shared.js.map +1 -0
  869. package/dist/esm/engine/providers/anthropic.provider.specification.d.ts +7 -0
  870. package/dist/esm/engine/providers/anthropic.provider.specification.d.ts.map +1 -0
  871. package/dist/esm/engine/providers/anthropic.provider.specification.js +42 -0
  872. package/dist/esm/engine/providers/anthropic.provider.specification.js.map +1 -0
  873. package/dist/esm/engine/providers/apple.provider.specification.d.ts +7 -0
  874. package/dist/esm/engine/providers/apple.provider.specification.d.ts.map +1 -0
  875. package/dist/esm/engine/providers/apple.provider.specification.js +44 -0
  876. package/dist/esm/engine/providers/apple.provider.specification.js.map +1 -0
  877. package/dist/esm/engine/providers/email-preview.provider.specification.d.ts +7 -0
  878. package/dist/esm/engine/providers/email-preview.provider.specification.d.ts.map +1 -0
  879. package/dist/esm/engine/providers/email-preview.provider.specification.js +39 -0
  880. package/dist/esm/engine/providers/email-preview.provider.specification.js.map +1 -0
  881. package/dist/esm/engine/providers/github.provider.specification.d.ts +7 -0
  882. package/dist/esm/engine/providers/github.provider.specification.d.ts.map +1 -0
  883. package/dist/esm/engine/providers/github.provider.specification.js +39 -0
  884. package/dist/esm/engine/providers/github.provider.specification.js.map +1 -0
  885. package/dist/esm/engine/providers/google.provider.specification.d.ts +7 -0
  886. package/dist/esm/engine/providers/google.provider.specification.d.ts.map +1 -0
  887. package/dist/esm/engine/providers/google.provider.specification.js +43 -0
  888. package/dist/esm/engine/providers/google.provider.specification.js.map +1 -0
  889. package/dist/esm/engine/providers/grok.provider.specification.d.ts +7 -0
  890. package/dist/esm/engine/providers/grok.provider.specification.d.ts.map +1 -0
  891. package/dist/esm/engine/providers/grok.provider.specification.js +39 -0
  892. package/dist/esm/engine/providers/grok.provider.specification.js.map +1 -0
  893. package/dist/esm/engine/providers/index.d.ts +23 -0
  894. package/dist/esm/engine/providers/index.d.ts.map +1 -0
  895. package/dist/esm/engine/providers/index.js +37 -0
  896. package/dist/esm/engine/providers/index.js.map +1 -0
  897. package/dist/esm/engine/providers/microsoft.provider.specification.d.ts +7 -0
  898. package/dist/esm/engine/providers/microsoft.provider.specification.d.ts.map +1 -0
  899. package/dist/esm/engine/providers/microsoft.provider.specification.js +39 -0
  900. package/dist/esm/engine/providers/microsoft.provider.specification.js.map +1 -0
  901. package/dist/esm/engine/providers/mistral.provider.specification.d.ts +7 -0
  902. package/dist/esm/engine/providers/mistral.provider.specification.d.ts.map +1 -0
  903. package/dist/esm/engine/providers/mistral.provider.specification.js +42 -0
  904. package/dist/esm/engine/providers/mistral.provider.specification.js.map +1 -0
  905. package/dist/esm/engine/providers/openai.provider.specification.d.ts +7 -0
  906. package/dist/esm/engine/providers/openai.provider.specification.d.ts.map +1 -0
  907. package/dist/esm/engine/providers/openai.provider.specification.js +52 -0
  908. package/dist/esm/engine/providers/openai.provider.specification.js.map +1 -0
  909. package/dist/esm/engine/providers/opencode.provider.specification.d.ts +7 -0
  910. package/dist/esm/engine/providers/opencode.provider.specification.d.ts.map +1 -0
  911. package/dist/esm/engine/providers/opencode.provider.specification.js +58 -0
  912. package/dist/esm/engine/providers/opencode.provider.specification.js.map +1 -0
  913. package/dist/esm/engine/providers/perplexity.provider.specification.d.ts +7 -0
  914. package/dist/esm/engine/providers/perplexity.provider.specification.d.ts.map +1 -0
  915. package/dist/esm/engine/providers/perplexity.provider.specification.js +39 -0
  916. package/dist/esm/engine/providers/perplexity.provider.specification.js.map +1 -0
  917. package/dist/esm/engine/providers/resend.provider.specification.d.ts +7 -0
  918. package/dist/esm/engine/providers/resend.provider.specification.d.ts.map +1 -0
  919. package/dist/esm/engine/providers/resend.provider.specification.js +42 -0
  920. package/dist/esm/engine/providers/resend.provider.specification.js.map +1 -0
  921. package/dist/esm/engine/providers/stripe.provider.specification.d.ts +7 -0
  922. package/dist/esm/engine/providers/stripe.provider.specification.d.ts.map +1 -0
  923. package/dist/esm/engine/providers/stripe.provider.specification.js +44 -0
  924. package/dist/esm/engine/providers/stripe.provider.specification.js.map +1 -0
  925. package/dist/esm/engine/providers/twilio.provider.specification.d.ts +7 -0
  926. package/dist/esm/engine/providers/twilio.provider.specification.d.ts.map +1 -0
  927. package/dist/esm/engine/providers/twilio.provider.specification.js +42 -0
  928. package/dist/esm/engine/providers/twilio.provider.specification.js.map +1 -0
  929. package/dist/esm/engine/roles/_engine-role-shared.d.ts.map +1 -1
  930. package/dist/esm/engine/roles/app-admin-billing-manager.role.specification.d.ts.map +1 -1
  931. package/dist/esm/engine/roles/app-admin-marketing-editor.role.specification.d.ts.map +1 -1
  932. package/dist/esm/engine/roles/app-admin-super-admin.role.specification.d.ts.map +1 -1
  933. package/dist/esm/engine/roles/app-admin-viewer.role.specification.d.ts.map +1 -1
  934. package/dist/esm/engine/roles/app-anonymous.role.specification.d.ts.map +1 -1
  935. package/dist/esm/engine/roles/app-public.role.specification.d.ts.map +1 -1
  936. package/dist/esm/engine/roles/app-user.role.specification.d.ts.map +1 -1
  937. package/dist/esm/engine/roles/index.d.ts.map +1 -1
  938. package/dist/esm/engine/roles/org-admin.role.specification.d.ts.map +1 -1
  939. package/dist/esm/engine/roles/org-guest.role.specification.d.ts.map +1 -1
  940. package/dist/esm/engine/roles/org-manager.role.specification.d.ts.map +1 -1
  941. package/dist/esm/engine/roles/org-member.role.specification.d.ts.map +1 -1
  942. package/dist/esm/engine/roles/org-owner.role.specification.d.ts.map +1 -1
  943. package/dist/esm/engine/users/index.d.ts.map +1 -1
  944. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.d.ts.map +1 -1
  945. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js +7 -7
  946. package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
  947. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.d.ts.map +1 -1
  948. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +9 -9
  949. package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
  950. package/dist/esm/engine/users/resources/index.d.ts.map +1 -1
  951. package/dist/esm/engine/users/resources/self-service-user-notifications.shared.d.ts.map +1 -1
  952. package/dist/esm/engine/users/resources/user-credentials.resource.specification.d.ts.map +1 -1
  953. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js +2 -2
  954. package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
  955. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts.map +1 -1
  956. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +8 -8
  957. package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
  958. package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts.map +1 -1
  959. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +4 -4
  960. package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts.map +1 -1
  961. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +4 -4
  962. package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
  963. package/dist/esm/engine/users/resources/user-profiles.resource.specification.d.ts.map +1 -1
  964. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +2 -2
  965. package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
  966. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +4 -4
  967. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
  968. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +13 -11
  969. package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
  970. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.d.ts.map +1 -1
  971. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js +1 -1
  972. package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js.map +1 -1
  973. package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts.map +1 -1
  974. package/dist/esm/engine/users/resources/user-self.resource.specification.js +9 -9
  975. package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
  976. package/dist/esm/engine/users/resources/users-api-reference.examples.d.ts.map +1 -1
  977. package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
  978. package/dist/esm/engine/users/resources/users.resource.specification.js +93 -0
  979. package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
  980. package/dist/esm/index.d.ts.map +1 -1
  981. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
  982. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +95 -45
  983. package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
  984. package/dist/esm/technical-documentation/technical-documentation-api-reference-targets.schemas.d.ts.map +1 -1
  985. package/dist/esm/technical-documentation/technical-documentation-assets.schemas.d.ts.map +1 -1
  986. package/dist/esm/technical-documentation/technical-documentation-capture.schemas.d.ts.map +1 -1
  987. package/dist/esm/technical-documentation/technical-documentation-common.schemas.d.ts.map +1 -1
  988. package/dist/esm/technical-documentation/technical-documentation-environment-identity.schemas.d.ts.map +1 -1
  989. package/dist/esm/technical-documentation/technical-documentation-evidence.schemas.d.ts.map +1 -1
  990. package/dist/esm/technical-documentation/technical-documentation-lifecycle.schemas.d.ts.map +1 -1
  991. package/dist/esm/technical-documentation/technical-documentation-publication.schemas.d.ts.map +1 -1
  992. package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts +37 -1
  993. package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts.map +1 -1
  994. package/dist/esm/technical-documentation/technical-documentation-units.schemas.js +36 -0
  995. package/dist/esm/technical-documentation/technical-documentation-units.schemas.js.map +1 -1
  996. package/dist/esm/technical-documentation.exports.d.ts.map +1 -1
  997. package/dist/tsconfig.build.tsbuildinfo +1 -1
  998. package/package.json +8 -8
  999. package/dist/assurance/external-framework-mapping.json +0 -980
  1000. package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.d.ts +0 -4
  1001. package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.d.ts.map +0 -1
  1002. package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.js +0 -21
  1003. package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.js.map +0 -1
  1004. package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.d.ts +0 -4
  1005. package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.d.ts.map +0 -1
  1006. package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.js +0 -21
  1007. package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"invoice-refs.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/invoice-refs.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { billingAdminPresets, billingMainPresets } from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n CoreResourceType,\n InvoiceStatus,\n ResourcePrimaryScope,\n InvoiceRefSchema,\n invoiceRefsPolymorphicFactories,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport {\n BILLING_API_REFERENCE_PAGE_REQUEST,\n billingApiReferencePage,\n createBillingApiReferenceScopeExample,\n type BillingApiReferenceExampleScope,\n} from './billing-api-reference-examples';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype InvResourceType = CoreResourceType.ORGANIZATION_INVOICE_REFS | CoreResourceType.USER_INVOICE_REFS;\ntype InvResourceTypeMember = 'ORGANIZATION_INVOICE_REFS' | 'USER_INVOICE_REFS';\n\nconst invResourcePrimaryScopeByResourceType: Record<InvResourceType, BillingApiReferenceExampleScope> = {\n [CoreResourceType.ORGANIZATION_INVOICE_REFS]: ResourcePrimaryScope.ORGANIZATIONS,\n [CoreResourceType.USER_INVOICE_REFS]: ResourcePrimaryScope.USER_SELF,\n};\n\ntype Cfg = ReturnType<(typeof invoiceRefsPolymorphicFactories)[CoreResourceType.ORGANIZATION_INVOICE_REFS]>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = typeof InvoiceRefSchema;\ntype InvFrontend = ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nfunction resolveInvUI(source: Partial<Record<string, unknown>>, resourceType: InvResourceType, sourceName: string): InvFrontend {\n const uiBehavior = source[resourceType] as InvFrontend | undefined;\n if (!uiBehavior) {\n throw new Error(`Missing \"${resourceType}\" UI behavior in ${sourceName}.`);\n }\n return uiBehavior;\n}\n\nfunction buildInvoiceRefBase(resourceType: InvResourceType, memberName: InvResourceTypeMember) {\n const exampleScope = createBillingApiReferenceScopeExample(\n invResourcePrimaryScopeByResourceType[resourceType],\n );\n const invoiceTotalExample = { amount: 4900, currency: 'USD', decimals: 2 };\n const invoiceRefExample = {\n _id: 'invoice_ref_01HX2EXAMPLE',\n ...exampleScope.billingAccountIdentity,\n status: InvoiceStatus.PAID,\n total: invoiceTotalExample,\n createdAt: '2026-06-02T08:00:00.000Z',\n updatedAt: '2026-06-02T08:05:00.000Z',\n ...exampleScope.scopeIdentity,\n };\n const invoiceRefSummaryExample = {\n _id: invoiceRefExample._id,\n status: invoiceRefExample.status,\n total: invoiceRefExample.total,\n };\n\n return resourceSpecification<undefined, Core, Main>(\n invoiceRefsPolymorphicFactories[resourceType],\n InvoiceRefSchema,\n ({ schemaShape }) => ({\n purpose:\n 'Invoice summary for a billing account: exposes lifecycle status, money total, and timestamps without leaking provider identifiers or provider-hosted document locations.',\n businessRole: 'Lets billing surfaces show recent invoice state and money totals while invoice documents remain available through the protected billing portal.',\n lifecycleRole: 'Created and updated from billing-provider events. The public API exposes invoice summaries as read-only records; it does not provide create, update, or delete operations.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'InvoiceRefSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactoryCollectionEntry: {\n collectionSymbol: { packageName: '@wildo-ai/saas-models', exportName: 'invoiceRefsPolymorphicFactories', symbolKind: CodeSymbolKind.FACTORY },\n identifierField: 'collectionKey',\n identifierValue: resourceType,\n },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName },\n operationVocabulary: { coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM } },\n frontendConfigurationSourceEntries: [\n { collectionSymbol: { packageName: '@wildo-ai/presets-components', exportName: 'billingMainPresets', symbolKind: CodeSymbolKind.UI_BEHAVIOR }, identifierField: 'collectionKey', identifierValue: resourceType },\n { collectionSymbol: { packageName: '@wildo-ai/presets-components', exportName: 'billingAdminPresets', symbolKind: CodeSymbolKind.UI_BEHAVIOR }, identifierField: 'collectionKey', identifierValue: resourceType },\n ],\n notes: ['Payment-failed and invoice-ready emails may reference these rows — verify `userNotifications[]` on operations in the factory before claiming fan-outs.'],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Invoice ref document id.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n billingAccountId: schemaShape.billingAccountId.stringSpec({ meaning: 'Polymorphic parent billing account FK.', importance: FieldSemanticImportance.PRIMARY }),\n status: schemaShape.status.enumSpec({\n meaning: 'Provider invoice payment state for past-due surfacing.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'InvoiceStatus', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [InvoiceStatus.DRAFT]: { meaning: 'Not finalized for collection.' },\n [InvoiceStatus.OPEN]: { meaning: 'Awaiting payment.' },\n [InvoiceStatus.PAID]: { meaning: 'Settled successfully.' },\n [InvoiceStatus.VOID]: { meaning: 'Voided at provider.' },\n [InvoiceStatus.UNCOLLECTIBLE]: { meaning: 'Written off or uncollectible per provider.' },\n },\n }),\n total: schemaShape.total.objectSpec({ meaning: 'Money object (amount + currency) for invoice total display.' }),\n hostedInvoiceUrl: schemaShape.hostedInvoiceUrl.stringSpec({ meaning: 'Provider-hosted invoice page. BACKEND-ONLY — never returned to a client: it is an unauthenticated capability link to a tax invoice, which legally carries the customer name and billing address. Clients reach invoice documents through the billing account\\'s open_portal operation instead.' }),\n invoicePdfUrl: schemaShape.invoicePdfUrl.stringSpec({ meaning: 'Provider-hosted invoice PDF. BACKEND-ONLY for the same reason as hostedInvoiceUrl.' }),\n providerInvoiceId: schemaShape.providerInvoiceId.stringSpec({ meaning: 'Opaque provider id — backend-only. Also the upsert key the billing webhook uses to find an existing invoice row.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Row creation time.', temporalRole: 'creation' }),\n updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Last sync time.', temporalRole: 'modified' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Open one invoice ref for detail panes.',\n outcome: 'Status and total for support and user self-serve. The invoice DOCUMENT is not linked from here — clients open it through the billing account\\'s open_portal operation.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The invoice ref was found and its status and total are returned. The provider-hosted URLs are backend-only and deliberately absent from the response.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No invoice ref exists for the supplied id in the caller’s scope.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Inspect a paid invoice header',\n response: invoiceRefExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: 'Inspect an invoice header with available relationship context',\n response: invoiceRefExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: 'Inspect the compact invoice summary',\n response: invoiceRefSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n [Op.LIST]: {\n purpose: 'History table under a billing account.',\n outcome: 'Chronological refs for org or user scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) chronological page of invoice refs for the billing account / scope.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Browse recent invoice headers',\n request: BILLING_API_REFERENCE_PAGE_REQUEST,\n response: billingApiReferencePage([invoiceRefExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: 'Browse invoice headers with relationship context',\n request: BILLING_API_REFERENCE_PAGE_REQUEST,\n response: billingApiReferencePage([invoiceRefExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: 'Browse compact invoice summaries',\n request: BILLING_API_REFERENCE_PAGE_REQUEST,\n response: billingApiReferencePage([invoiceRefSummaryExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n [Op.SEARCH]: {\n purpose: 'Repository search (status and similar) for admin tooling.',\n outcome: 'Filtered page of invoice refs when search is enabled in factory.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of invoice refs matching the status/repository search query.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the admin entitlement required to run repository-level invoice searches.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Backfill or webhook ingestion path when the service inserts a new ref document.',\n outcome: 'New row keyed to provider invoice id in implementation.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'An invoice ref mirror was inserted (internal/repository path) and is returned keyed to its provider invoice id. Not a client-facing create — invoice refs are system-written from provider webhooks or backfills.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The ingested payload fails schema validation (e.g. missing `billingAccountId` or `providerInvoiceId`).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not the internal/webhook/repository path permitted to insert invoice mirrors.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The referenced parent `billingAccountId` does not exist in the caller’s scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'An invoice ref already mirrors this `providerInvoiceId` (idempotent webhook re-delivery target).', errorCode: 'INVOICE_REF_EXISTS' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Internal ingestion of a provider invoice mirror',\n request: {\n ...exampleScope.billingAccountIdentity,\n providerInvoiceId: 'in_01HX2EXAMPLE',\n status: InvoiceStatus.OPEN,\n total: invoiceTotalExample,\n hostedInvoiceUrl: 'https://billing.example.test/invoices/in_01HX2EXAMPLE',\n },\n response: { ...invoiceRefExample, status: InvoiceStatus.OPEN },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Sync status/total/url fields when webhooks arrive.',\n outcome: 'Patched provider-mirrored fields.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The invoice ref’s provider-mirrored fields (status, total, urls) were synced and the updated row is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The synced fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not the internal/webhook path permitted to sync invoice mirrors.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No invoice ref exists for the supplied id in the caller’s scope.' },\n ],\n idempotent: true,\n },\n },\n businessConstraints: ['Line-item detail lives at the provider — this row is intentionally shallow.'],\n }),\n { resourcePrimaryScope: invResourcePrimaryScopeByResourceType[resourceType] },\n );\n}\n\nfunction buildInvoiceRefSpec(resourceType: InvResourceType, memberName: InvResourceTypeMember) {\n const base = buildInvoiceRefBase(resourceType, memberName);\n const main = resolveInvUI(billingMainPresets as Partial<Record<string, unknown>>, resourceType, 'billingMainPresets');\n const admin = resolveInvUI(billingAdminPresets as Partial<Record<string, unknown>>, resourceType, 'billingAdminPresets');\n return resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(main), resourceFrontendConfiguration(admin)),\n base,\n () => ({\n label: { purpose: 'Preset builds `Invoice ${status}` as a readable list label.' },\n views: {\n [Op.LIST]: { purpose: 'List op present in merged preset `views` as non-addressable — document for overlay alignment.', whenToUse: 'Account invoice history surfaces when wired.' },\n [Op.READ]: { purpose: 'Read op present in merged preset `views` as non-addressable.', whenToUse: 'Invoice detail drawer from list selection.' },\n },\n }),\n );\n}\n\nexport const organizationInvoiceRefsResourceSpecification = buildInvoiceRefSpec(\n CoreResourceType.ORGANIZATION_INVOICE_REFS,\n 'ORGANIZATION_INVOICE_REFS',\n);\n\nexport const userInvoiceRefsResourceSpecification = buildInvoiceRefSpec(CoreResourceType.USER_INVOICE_REFS, 'USER_INVOICE_REFS');\n"]}
1
+ {"version":3,"file":"invoice-refs.resource.specification.js","sourceRoot":"","sources":["../../../../../src/engine/billing/resources/invoice-refs.resource.specification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxG,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,gBAAgB,EAChB,aAAa,EACb,oBAAoB,EACpB,gBAAgB,EAChB,+BAA+B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,mCAAmC,EACnC,6BAA6B,EAC7B,qBAAqB,EACrB,8CAA8C,GAC/C,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kCAAkC,EAClC,uBAAuB,EACvB,qCAAqC,GAEtC,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAK3E,MAAM,qCAAqC,GAA6D;IACtG,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,EAAE,oBAAoB,CAAC,aAAa;IAChF,CAAC,gBAAgB,CAAC,iBAAiB,CAAC,EAAE,oBAAoB,CAAC,SAAS;CACrE,CAAC;AAOF,SAAS,YAAY,CAAC,MAAwC,EAAE,YAA6B,EAAE,UAAkB;IAC/G,MAAM,UAAU,GAAG,MAAM,CAAC,YAAY,CAA4B,CAAC;IACnE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,YAAY,YAAY,oBAAoB,UAAU,GAAG,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,mBAAmB,CAAC,YAA6B,EAAE,UAAiC;IAC3F,MAAM,YAAY,GAAG,qCAAqC,CACxD,qCAAqC,CAAC,YAAY,CAAC,CACpD,CAAC;IACF,MAAM,mBAAmB,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC3E,MAAM,iBAAiB,GAAG;QACxB,GAAG,EAAE,0BAA0B;QAC/B,GAAG,YAAY,CAAC,sBAAsB;QACtC,MAAM,EAAE,aAAa,CAAC,IAAI;QAC1B,KAAK,EAAE,mBAAmB;QAC1B,SAAS,EAAE,0BAA0B;QACrC,SAAS,EAAE,0BAA0B;QACrC,GAAG,YAAY,CAAC,aAAa;KAC9B,CAAC;IACF,MAAM,wBAAwB,GAAG;QAC/B,GAAG,EAAE,iBAAiB,CAAC,GAAG;QAC1B,MAAM,EAAE,iBAAiB,CAAC,MAAM;QAChC,KAAK,EAAE,iBAAiB,CAAC,KAAK;KAC/B,CAAC;IAEF,OAAO,qBAAqB,CAC1B,+BAA+B,CAAC,YAAY,CAAC,EAC7C,gBAAgB,EAChB,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QACpB,OAAO,EACL,0KAA0K;QAC5K,YAAY,EAAE,iJAAiJ;QAC/J,aAAa,EAAE,4KAA4K;QAC3L,QAAQ,EAAE,aAAa,CAAC,KAAK;QAC7B,SAAS,EAAE,uBAAuB,CAAC,OAAO;QAC1C,YAAY,EAAE;YACZ,UAAU,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,CAAC,MAAM,EAAE,eAAe,EAAE,mBAAmB,CAAC,UAAU,EAAE;YACxK,8BAA8B,EAAE;gBAC9B,gBAAgB,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,UAAU,EAAE,iCAAiC,EAAE,UAAU,EAAE,cAAc,CAAC,OAAO,EAAE;gBAC7I,eAAe,EAAE,eAAe;gBAChC,eAAe,EAAE,YAAY;aAC9B;YACD,YAAY,EAAE,EAAE,eAAe,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,UAAU,EAAE,kBAAkB,EAAE,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,CAAC,eAAe,EAAE,EAAE,UAAU,EAAE;YAC9M,mBAAmB,EAAE,EAAE,QAAQ,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,UAAU,EAAE,uBAAuB,EAAE,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,CAAC,eAAe,EAAE,EAAE;YACvM,kCAAkC,EAAE;gBAClC,EAAE,gBAAgB,EAAE,EAAE,WAAW,EAAE,8BAA8B,EAAE,UAAU,EAAE,oBAAoB,EAAE,UAAU,EAAE,cAAc,CAAC,WAAW,EAAE,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE;gBAChN,EAAE,gBAAgB,EAAE,EAAE,WAAW,EAAE,8BAA8B,EAAE,UAAU,EAAE,qBAAqB,EAAE,UAAU,EAAE,cAAc,CAAC,WAAW,EAAE,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,YAAY,EAAE;aAClN;YACD,KAAK,EAAE,CAAC,wJAAwJ,CAAC;SAClK;QACD,MAAM,EAAE;YACN,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,uBAAuB,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC;YACjJ,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,UAAU,EAAE,uBAAuB,CAAC,OAAO,EAAE,CAAC;YAC7J,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;gBAClC,OAAO,EAAE,wDAAwD;gBACjE,eAAe,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,CAAC,eAAe,EAAE;gBAC7K,MAAM,EAAE;oBACN,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE;oBACnE,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,mBAAmB,EAAE;oBACtD,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,uBAAuB,EAAE;oBAC1D,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE;oBACxD,CAAC,aAAa,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE;iBACzF;aACF,CAAC;YACF,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC;YAC/G,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,gSAAgS,EAAE,CAAC;YACxW,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,oFAAoF,EAAE,CAAC;YACtJ,iBAAiB,EAAE,WAAW,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,qHAAqH,EAAE,CAAC;YAC/L,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;YACzG,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;SACpG;QACD,UAAU,EAAE;YACV,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;gBACT,OAAO,EAAE,wCAAwC;gBACjD,OAAO,EAAE,wKAAwK;gBACjL,gBAAgB,EAAE;oBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,uJAAuJ,EAAE;iBAC1M;gBACD,cAAc,EAAE;oBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,kEAAkE,EAAE;iBACzH;gBACD,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,CAAC;wBACT,KAAK,EAAE,+BAA+B;wBACtC,QAAQ,EAAE,iBAAiB;wBAC3B,SAAS,EAAE,sBAAsB,CAAC,MAAM;qBACzC,CAAC;gBACF,QAAQ,EAAE;oBACR,OAAO,EAAE;wBACP,QAAQ,EAAE,CAAC;gCACT,KAAK,EAAE,+DAA+D;gCACtE,QAAQ,EAAE,iBAAiB;gCAC3B,SAAS,EAAE,sBAAsB,CAAC,MAAM;6BACzC,CAAC;qBACH;oBACD,OAAO,EAAE;wBACP,QAAQ,EAAE,CAAC;gCACT,KAAK,EAAE,qCAAqC;gCAC5C,QAAQ,EAAE,wBAAwB;gCAClC,SAAS,EAAE,sBAAsB,CAAC,MAAM;6BACzC,CAAC;qBACH;iBACF;aACF;YACD,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;gBACT,OAAO,EAAE,wCAAwC;gBACjD,OAAO,EAAE,2CAA2C;gBACpD,gBAAgB,EAAE;oBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,wFAAwF,EAAE;iBAC3I;gBACD,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,CAAC;wBACT,KAAK,EAAE,+BAA+B;wBACtC,OAAO,EAAE,kCAAkC;wBAC3C,QAAQ,EAAE,uBAAuB,CAAC,CAAC,iBAAiB,CAAC,CAAC;wBACtD,SAAS,EAAE,sBAAsB,CAAC,MAAM;qBACzC,CAAC;gBACF,QAAQ,EAAE;oBACR,OAAO,EAAE;wBACP,QAAQ,EAAE,CAAC;gCACT,KAAK,EAAE,kDAAkD;gCACzD,OAAO,EAAE,kCAAkC;gCAC3C,QAAQ,EAAE,uBAAuB,CAAC,CAAC,iBAAiB,CAAC,CAAC;gCACtD,SAAS,EAAE,sBAAsB,CAAC,MAAM;6BACzC,CAAC;qBACH;oBACD,OAAO,EAAE;wBACP,QAAQ,EAAE,CAAC;gCACT,KAAK,EAAE,kCAAkC;gCACzC,OAAO,EAAE,kCAAkC;gCAC3C,QAAQ,EAAE,uBAAuB,CAAC,CAAC,wBAAwB,CAAC,CAAC;gCAC7D,SAAS,EAAE,sBAAsB,CAAC,MAAM;6BACzC,CAAC;qBACH;iBACF;aACF;YACD,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;gBACX,OAAO,EAAE,2DAA2D;gBACpE,OAAO,EAAE,kEAAkE;gBAC3E,gBAAgB,EAAE;oBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,sFAAsF,EAAE;iBACzI;gBACD,cAAc,EAAE;oBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,2FAA2F,EAAE;iBAClJ;gBACD,UAAU,EAAE,IAAI;aACjB;YACD,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;gBACX,OAAO,EAAE,iFAAiF;gBAC1F,OAAO,EAAE,yDAAyD;gBAClE,gBAAgB,EAAE;oBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,WAAW,EAAE,OAAO,EAAE,mNAAmN,EAAE;iBAC3Q;gBACD,cAAc,EAAE;oBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,eAAe,EAAE,IAAI,EAAE,wGAAwG,EAAE,SAAS,EAAE,mBAAmB,EAAE;oBAChM,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,6FAA6F,EAAE;oBACnJ,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,gFAAgF,EAAE;oBACtI,EAAE,IAAI,EAAE,sBAAsB,CAAC,YAAY,EAAE,IAAI,EAAE,kGAAkG,EAAE,SAAS,EAAE,oBAAoB,EAAE;iBACzL;gBACD,UAAU,EAAE,KAAK;gBACjB,QAAQ,EAAE;oBACR;wBACE,KAAK,EAAE,iDAAiD;wBACxD,OAAO,EAAE;4BACP,GAAG,YAAY,CAAC,sBAAsB;4BACtC,iBAAiB,EAAE,iBAAiB;4BACpC,MAAM,EAAE,aAAa,CAAC,IAAI;4BAC1B,KAAK,EAAE,mBAAmB;4BAC1B,gBAAgB,EAAE,uDAAuD;yBAC1E;wBACD,QAAQ,EAAE,EAAE,GAAG,iBAAiB,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE;wBAC9D,SAAS,EAAE,sBAAsB,CAAC,WAAW;qBAC9C;iBACF;aACF;YACD,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;gBACX,OAAO,EAAE,oDAAoD;gBAC7D,OAAO,EAAE,mCAAmC;gBAC5C,gBAAgB,EAAE;oBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,kHAAkH,EAAE;iBACrK;gBACD,cAAc,EAAE;oBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,eAAe,EAAE,IAAI,EAAE,2CAA2C,EAAE,SAAS,EAAE,mBAAmB,EAAE;oBACnI,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,gFAAgF,EAAE;oBACtI,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,kEAAkE,EAAE;iBACzH;gBACD,UAAU,EAAE,IAAI;aACjB;SACF;QACD,mBAAmB,EAAE,CAAC,6EAA6E,CAAC;KACrG,CAAC,EACF,EAAE,oBAAoB,EAAE,qCAAqC,CAAC,YAAY,CAAC,EAAE,CAC9E,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,YAA6B,EAAE,UAAiC;IAC3F,MAAM,IAAI,GAAG,mBAAmB,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,YAAY,CAAC,kBAAsD,EAAE,YAAY,EAAE,oBAAoB,CAAC,CAAC;IACtH,MAAM,KAAK,GAAG,YAAY,CAAC,mBAAuD,EAAE,YAAY,EAAE,qBAAqB,CAAC,CAAC;IACzH,OAAO,8CAA8C,CACnD,mCAAmC,CAAC,6BAA6B,CAAC,IAAI,CAAC,EAAE,6BAA6B,CAAC,KAAK,CAAC,CAAC,EAC9G,IAAI,EACJ,GAAG,EAAE,CAAC,CAAC;QACL,KAAK,EAAE,EAAE,OAAO,EAAE,6DAA6D,EAAE;QACjF,KAAK,EAAE;YACL,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,+FAA+F,EAAE,SAAS,EAAE,8CAA8C,EAAE;YAClL,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,8DAA8D,EAAE,SAAS,EAAE,4CAA4C,EAAE;SAChJ;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,4CAA4C,GAAG,mBAAmB,CAC7E,gBAAgB,CAAC,yBAAyB,EAC1C,2BAA2B,CAC5B,CAAC;AAEF,MAAM,CAAC,MAAM,oCAAoC,GAAG,mBAAmB,CAAC,gBAAgB,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,CAAC","sourcesContent":["import { billingAdminPresets, billingMainPresets } from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n CoreResourceType,\n InvoiceStatus,\n ResourcePrimaryScope,\n InvoiceRefSchema,\n invoiceRefsPolymorphicFactories,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport {\n BILLING_API_REFERENCE_PAGE_REQUEST,\n billingApiReferencePage,\n createBillingApiReferenceScopeExample,\n type BillingApiReferenceExampleScope,\n} from './billing-api-reference-examples';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype InvResourceType = CoreResourceType.ORGANIZATION_INVOICE_REFS | CoreResourceType.USER_INVOICE_REFS;\ntype InvResourceTypeMember = 'ORGANIZATION_INVOICE_REFS' | 'USER_INVOICE_REFS';\n\nconst invResourcePrimaryScopeByResourceType: Record<InvResourceType, BillingApiReferenceExampleScope> = {\n [CoreResourceType.ORGANIZATION_INVOICE_REFS]: ResourcePrimaryScope.ORGANIZATIONS,\n [CoreResourceType.USER_INVOICE_REFS]: ResourcePrimaryScope.USER_SELF,\n};\n\ntype Cfg = ReturnType<(typeof invoiceRefsPolymorphicFactories)[CoreResourceType.ORGANIZATION_INVOICE_REFS]>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = typeof InvoiceRefSchema;\ntype InvFrontend = ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nfunction resolveInvUI(source: Partial<Record<string, unknown>>, resourceType: InvResourceType, sourceName: string): InvFrontend {\n const uiBehavior = source[resourceType] as InvFrontend | undefined;\n if (!uiBehavior) {\n throw new Error(`Missing \"${resourceType}\" UI behavior in ${sourceName}.`);\n }\n return uiBehavior;\n}\n\nfunction buildInvoiceRefBase(resourceType: InvResourceType, memberName: InvResourceTypeMember) {\n const exampleScope = createBillingApiReferenceScopeExample(\n invResourcePrimaryScopeByResourceType[resourceType],\n );\n const invoiceTotalExample = { amount: 4900, currency: 'USD', decimals: 2 };\n const invoiceRefExample = {\n _id: 'invoice_ref_01HX2EXAMPLE',\n ...exampleScope.billingAccountIdentity,\n status: InvoiceStatus.PAID,\n total: invoiceTotalExample,\n createdAt: '2026-06-02T08:00:00.000Z',\n updatedAt: '2026-06-02T08:05:00.000Z',\n ...exampleScope.scopeIdentity,\n };\n const invoiceRefSummaryExample = {\n _id: invoiceRefExample._id,\n status: invoiceRefExample.status,\n total: invoiceRefExample.total,\n };\n\n return resourceSpecification<undefined, Core, Main>(\n invoiceRefsPolymorphicFactories[resourceType],\n InvoiceRefSchema,\n ({ schemaShape }) => ({\n purpose:\n 'Invoice summary for a billing account: exposes lifecycle status, money total, and timestamps without leaking provider identifiers or provider-hosted document locations.',\n businessRole: 'Lets billing surfaces show recent invoice state and money totals while invoice documents remain available through the protected billing portal.',\n lifecycleRole: 'Created and updated from billing-provider events. The public API exposes invoice summaries as read-only records; it does not provide create, update, or delete operations.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'InvoiceRefSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactoryCollectionEntry: {\n collectionSymbol: { packageName: '@wildo-ai/saas-models', exportName: 'invoiceRefsPolymorphicFactories', symbolKind: CodeSymbolKind.FACTORY },\n identifierField: 'collectionKey',\n identifierValue: resourceType,\n },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName },\n operationVocabulary: { coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM } },\n frontendConfigurationSourceEntries: [\n { collectionSymbol: { packageName: '@wildo-ai/presets-components', exportName: 'billingMainPresets', symbolKind: CodeSymbolKind.UI_BEHAVIOR }, identifierField: 'collectionKey', identifierValue: resourceType },\n { collectionSymbol: { packageName: '@wildo-ai/presets-components', exportName: 'billingAdminPresets', symbolKind: CodeSymbolKind.UI_BEHAVIOR }, identifierField: 'collectionKey', identifierValue: resourceType },\n ],\n notes: ['Payment-failed and invoice-ready emails may reference these rows — verify `userNotifications[]` on operations in the factory before claiming fan-outs.'],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Invoice ref document id.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n billingAccountId: schemaShape.billingAccountId.stringSpec({ meaning: 'Polymorphic parent billing account FK.', importance: FieldSemanticImportance.PRIMARY }),\n status: schemaShape.status.enumSpec({\n meaning: 'Provider invoice payment state for past-due surfacing.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'InvoiceStatus', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [InvoiceStatus.DRAFT]: { meaning: 'Not finalized for collection.' },\n [InvoiceStatus.OPEN]: { meaning: 'Awaiting payment.' },\n [InvoiceStatus.PAID]: { meaning: 'Settled successfully.' },\n [InvoiceStatus.VOID]: { meaning: 'Voided at provider.' },\n [InvoiceStatus.UNCOLLECTIBLE]: { meaning: 'Written off or uncollectible per provider.' },\n },\n }),\n total: schemaShape.total.objectSpec({ meaning: 'Money object (amount + currency) for invoice total display.' }),\n hostedInvoiceUrl: schemaShape.hostedInvoiceUrl.stringSpec({ meaning: 'Provider-hosted invoice page. BACKEND-ONLY — never returned to a client: it is an unauthenticated capability link to a tax invoice, which legally carries the customer name and billing address. Clients reach invoice documents through the billing account\\'s open_portal operation instead.' }),\n invoicePdfUrl: schemaShape.invoicePdfUrl.stringSpec({ meaning: 'Provider-hosted invoice PDF. BACKEND-ONLY for the same reason as hostedInvoiceUrl.' }),\n providerInvoiceId: schemaShape.providerInvoiceId.stringSpec({ meaning: 'Opaque provider id — backend-only. Also the upsert key the billing webhook uses to find an existing invoice record.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Record creation time.', temporalRole: 'creation' }),\n updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Last sync time.', temporalRole: 'modified' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Open one invoice ref for detail panes.',\n outcome: 'Status and total for support and user self-serve. The invoice DOCUMENT is not linked from here — clients open it through the billing account\\'s open_portal operation.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The invoice ref was found and its status and total are returned. The provider-hosted URLs are backend-only and deliberately absent from the response.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No invoice ref exists for the supplied id in the caller’s scope.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Inspect a paid invoice header',\n response: invoiceRefExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: 'Inspect an invoice header with available relationship context',\n response: invoiceRefExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: 'Inspect the compact invoice summary',\n response: invoiceRefSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n [Op.LIST]: {\n purpose: 'History table under a billing account.',\n outcome: 'Chronological refs for org or user scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) chronological page of invoice refs for the billing account / scope.' },\n ],\n idempotent: true,\n examples: [{\n title: 'Browse recent invoice headers',\n request: BILLING_API_REFERENCE_PAGE_REQUEST,\n response: billingApiReferencePage([invoiceRefExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: 'Browse invoice headers with relationship context',\n request: BILLING_API_REFERENCE_PAGE_REQUEST,\n response: billingApiReferencePage([invoiceRefExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: 'Browse compact invoice summaries',\n request: BILLING_API_REFERENCE_PAGE_REQUEST,\n response: billingApiReferencePage([invoiceRefSummaryExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n [Op.SEARCH]: {\n purpose: 'Repository search (status and similar) for admin tooling.',\n outcome: 'Filtered page of invoice refs when search is enabled in factory.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of invoice refs matching the status/repository search query.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the admin entitlement required to run repository-level invoice searches.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Backfill or webhook ingestion path when the service inserts a new ref document.',\n outcome: 'New row keyed to provider invoice id in implementation.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'An invoice ref mirror was inserted (internal/repository path) and is returned keyed to its provider invoice id. Not a client-facing create — invoice refs are system-written from provider webhooks or backfills.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The ingested payload fails schema validation (e.g. missing `billingAccountId` or `providerInvoiceId`).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not the internal/webhook/repository path permitted to insert invoice mirrors.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The referenced parent `billingAccountId` does not exist in the caller’s scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'An invoice ref already mirrors this `providerInvoiceId` (idempotent webhook re-delivery target).', errorCode: 'INVOICE_REF_EXISTS' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Internal ingestion of a provider invoice mirror',\n request: {\n ...exampleScope.billingAccountIdentity,\n providerInvoiceId: 'in_01HX2EXAMPLE',\n status: InvoiceStatus.OPEN,\n total: invoiceTotalExample,\n hostedInvoiceUrl: 'https://billing.example.test/invoices/in_01HX2EXAMPLE',\n },\n response: { ...invoiceRefExample, status: InvoiceStatus.OPEN },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Sync status/total/url fields when webhooks arrive.',\n outcome: 'Patched provider-mirrored fields.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The invoice ref’s provider-mirrored fields (status, total, urls) were synced and the updated record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The synced fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not the internal/webhook path permitted to sync invoice mirrors.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No invoice ref exists for the supplied id in the caller’s scope.' },\n ],\n idempotent: true,\n },\n },\n businessConstraints: ['Line-item detail lives at the provider — this row is intentionally shallow.'],\n }),\n { resourcePrimaryScope: invResourcePrimaryScopeByResourceType[resourceType] },\n );\n}\n\nfunction buildInvoiceRefSpec(resourceType: InvResourceType, memberName: InvResourceTypeMember) {\n const base = buildInvoiceRefBase(resourceType, memberName);\n const main = resolveInvUI(billingMainPresets as Partial<Record<string, unknown>>, resourceType, 'billingMainPresets');\n const admin = resolveInvUI(billingAdminPresets as Partial<Record<string, unknown>>, resourceType, 'billingAdminPresets');\n return resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(main), resourceFrontendConfiguration(admin)),\n base,\n () => ({\n label: { purpose: 'Preset builds `Invoice ${status}` as a readable list label.' },\n views: {\n [Op.LIST]: { purpose: 'List op present in merged preset `views` as non-addressable — document for overlay alignment.', whenToUse: 'Account invoice history surfaces when wired.' },\n [Op.READ]: { purpose: 'Read op present in merged preset `views` as non-addressable.', whenToUse: 'Invoice detail drawer from list selection.' },\n },\n }),\n );\n}\n\nexport const organizationInvoiceRefsResourceSpecification = buildInvoiceRefSpec(\n CoreResourceType.ORGANIZATION_INVOICE_REFS,\n 'ORGANIZATION_INVOICE_REFS',\n);\n\nexport const userInvoiceRefsResourceSpecification = buildInvoiceRefSpec(CoreResourceType.USER_INVOICE_REFS, 'USER_INVOICE_REFS');\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"prices.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/prices.resource.specification.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,eAAe,EAEf,YAAY,EAEZ,cAAc,EACd,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AA8K/B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;iCAoBvC,CAAC"}
1
+ {"version":3,"file":"prices.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/billing/resources/prices.resource.specification.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,eAAe,EAEf,YAAY,EAEZ,cAAc,EACd,oBAAoB,EAErB,MAAM,uBAAuB,CAAC;AA8K/B,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;iCAoBvC,CAAC"}
@@ -23,7 +23,7 @@ const pricesBase = resourceSpecification(pricesFactory, PriceSchema, ({ schemaSh
23
23
  ],
24
24
  },
25
25
  fields: {
26
- _id: schemaShape._id.stringSpec({ meaning: 'Price row id; referenced as `priceId` on subscription items.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),
26
+ _id: schemaShape._id.stringSpec({ meaning: 'Price record id; referenced as `priceId` on subscription items.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),
27
27
  productId: schemaShape.productId.stringSpec({ meaning: 'FK to the owning `PRODUCTS` document.', importance: FieldSemanticImportance.PRIMARY }),
28
28
  model: schemaShape.model.enumSpec({
29
29
  meaning: 'Stripe-style pricing model for how quantity maps to line items.',
@@ -36,7 +36,7 @@ const pricesBase = resourceSpecification(pricesFactory, PriceSchema, ({ schemaSh
36
36
  [PricingModel.PACKAGE]: { meaning: 'Blocks of units sold as packages.' },
37
37
  },
38
38
  }),
39
- unitPrice: schemaShape.unitPrice.objectSpec({ meaning: 'Money object (amount + currency) for FLAT/PER_UNIT models; not used for pure tiered/graduated rows that rely on `tiers` instead.' }),
39
+ unitPrice: schemaShape.unitPrice.objectSpec({ meaning: 'Money object (amount + currency) for FLAT/PER_UNIT models; not used for pure tiered/graduated records that rely on `tiers` instead.' }),
40
40
  interval: schemaShape.interval.enumSpec({
41
41
  meaning: 'Billing period anchor when recurring.',
42
42
  enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'BillingInterval', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
@@ -49,7 +49,7 @@ const pricesBase = resourceSpecification(pricesFactory, PriceSchema, ({ schemaSh
49
49
  tiers: schemaShape.tiers.arraySpec({ meaning: 'Tier ladder for TIERED/GRADUATED models with per-tier money blocks.', elementMeaning: 'One `PriceTierSchema` row with `upTo`, `unitPrice`, and `flatPrice` money objects.' }),
50
50
  packageSize: schemaShape.packageSize.numberSpec({ meaning: 'Units per price package for PACKAGE model pricing.' }),
51
51
  usageAggregation: schemaShape.usageAggregation.enumSpec({
52
- meaning: 'Authored intent for how a provider meter should roll up usage. The current application metering flush always groups pending local rows by account and product and sums their quantities; it does not consume this field, so the provider meter configuration and observed invoice remain the effective billing proof.',
52
+ meaning: 'Authored intent for how a provider meter should roll up usage. The current application metering flush always groups pending local records by account and product and sums their quantities; it does not consume this field, so the provider meter configuration and observed invoice remain the effective billing proof.',
53
53
  enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'UsageAggregationType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
54
54
  values: {
55
55
  [UsageAggregationType.SUM]: { meaning: 'Sum raw quantities in the period.' },
@@ -68,14 +68,14 @@ const pricesBase = resourceSpecification(pricesFactory, PriceSchema, ({ schemaSh
68
68
  providerPriceId: schemaShape.providerPriceId.stringSpec({ meaning: 'Provider price id for sync; backend-only in many responses.' }),
69
69
  isDefault: schemaShape.isDefault.booleanSpec({ meaning: 'Preferred default price for UIs that pick one price per product if multiple exist.' }),
70
70
  isActive: schemaShape.isActive.booleanSpec({ meaning: 'Whether new checkouts can select this price when multiple exist.' }),
71
- createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Row creation time.', temporalRole: 'creation' }),
71
+ createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Record creation time.', temporalRole: 'creation' }),
72
72
  },
73
73
  operations: {
74
74
  [Op.READ]: {
75
75
  purpose: 'Read price details for plan pickers, invoice lines, and admin audit.',
76
76
  outcome: 'Money + interval + tier blocks per schema.',
77
77
  responseStatuses: [
78
- { code: HttpResponseStatusCode.OK_200, meaning: 'The price row was found and its money / interval / tier blocks are returned.' },
78
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The price record was found and its money / interval / tier blocks are returned.' },
79
79
  ],
80
80
  errorScenarios: [
81
81
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No price exists for the supplied id in the catalog.' },
@@ -133,7 +133,7 @@ const pricesBase = resourceSpecification(pricesFactory, PriceSchema, ({ schemaSh
133
133
  purpose: 'Change activation, default flag, or money fields in controlled admin flows.',
134
134
  outcome: 'Patched row — verify provider sync rules before claiming invoices update retroactively.',
135
135
  responseStatuses: [
136
- { code: HttpResponseStatusCode.OK_200, meaning: 'The price row was patched (activation / default flag / money fields) and the updated DTO is returned.' },
136
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The price record was patched (activation / default flag / money fields) and the updated DTO is returned.' },
137
137
  ],
138
138
  errorScenarios: [
139
139
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },
@@ -147,7 +147,7 @@ const pricesBase = resourceSpecification(pricesFactory, PriceSchema, ({ schemaSh
147
147
  purpose: 'Repository-only teardown of the price row when its owning product is deleted (composition `onParentDelete` cascade).',
148
148
  outcome: 'Every price under the product is removed together with the product — the composition parts do not outlive their whole.',
149
149
  responseStatuses: [
150
- { code: HttpResponseStatusCode.OK_200, meaning: 'The price row was deleted as part of the owning product’s deletion cascade.' },
150
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The price record was deleted as part of the owning product’s deletion cascade.' },
151
151
  ],
152
152
  // REPOSITORY_ONLY variant (ORG_OWNER) — invoked by the onParentDelete cascade, not a public HTTP endpoint, so no client-facing 400/403/404 are documented.
153
153
  idempotent: true,
@@ -1 +1 @@
1
- {"version":3,"file":"prices.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/prices.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n pricesAdminResourceUIBehavior as pricesAdminSource,\n pricesMainResourceUIBehavior as pricesMainSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n BillingInterval,\n PriceSchema,\n PricingModel,\n ResourcePrimaryScope,\n TaxDisplayMode,\n UsageAggregationType,\n pricesResourceConfiguration_InitializationFactory as pricesFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof pricesFactory>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\nconst pricesMainUI = pricesMainSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\nconst pricesAdminUI = pricesAdminSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nconst pricesBase = resourceSpecification<undefined, Core, Main>(\n pricesFactory,\n PriceSchema,\n ({ schemaShape }) => ({\n purpose: 'One way to pay for a product: its pricing model, amount, currency, billing interval and tiers. Checkout and subscriptions refer to a price by its identifier.',\n businessRole: 'Binds a catalog product to a billable money shape (flat, per-unit, tiered, …) the provider can invoice.',\n lifecycleRole: 'Admin-managed: created with products; activation toggles hide from new purchases without mutating old subscriptions in typical flows.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'PriceSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactory: { packageName: '@wildo-ai/saas-models', exportName: 'pricesResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName: 'PRICES' },\n operationVocabulary: { coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM } },\n frontendConfigurationSources: [\n { packageName: '@wildo-ai/presets-components', exportName: 'pricesMainResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n { packageName: '@wildo-ai/presets-components', exportName: 'pricesAdminResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n ],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Price row id; referenced as `priceId` on subscription items.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n productId: schemaShape.productId.stringSpec({ meaning: 'FK to the owning `PRODUCTS` document.', importance: FieldSemanticImportance.PRIMARY }),\n model: schemaShape.model.enumSpec({\n meaning: 'Stripe-style pricing model for how quantity maps to line items.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'PricingModel', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [PricingModel.FLAT]: { meaning: 'One fixed price without per-seat scaling.' },\n [PricingModel.PER_UNIT]: { meaning: 'Linear in quantity (seats, tokens bucket).' },\n [PricingModel.TIERED]: { meaning: 'Volume pricing: the reached tier supplies the unit rate for the whole quantity.' },\n [PricingModel.GRADUATED]: { meaning: 'Graduated pricing: each quantity bracket is priced independently and the bracket amounts are added.' },\n [PricingModel.PACKAGE]: { meaning: 'Blocks of units sold as packages.' },\n },\n }),\n unitPrice: schemaShape.unitPrice.objectSpec({ meaning: 'Money object (amount + currency) for FLAT/PER_UNIT models; not used for pure tiered/graduated rows that rely on `tiers` instead.' }),\n interval: schemaShape.interval.enumSpec({\n meaning: 'Billing period anchor when recurring.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'BillingInterval', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [BillingInterval.MONTH]: { meaning: 'Monthly cadence at provider.' },\n [BillingInterval.YEAR]: { meaning: 'Annual cadence at provider.' },\n },\n }),\n intervalCount: schemaShape.intervalCount.numberSpec({ meaning: 'Multiplier on interval (e.g. every 3 months).' }),\n tiers: schemaShape.tiers.arraySpec({ meaning: 'Tier ladder for TIERED/GRADUATED models with per-tier money blocks.', elementMeaning: 'One `PriceTierSchema` row with `upTo`, `unitPrice`, and `flatPrice` money objects.' }),\n packageSize: schemaShape.packageSize.numberSpec({ meaning: 'Units per price package for PACKAGE model pricing.' }),\n usageAggregation: schemaShape.usageAggregation.enumSpec({\n meaning:\n 'Authored intent for how a provider meter should roll up usage. The current application metering flush always groups pending local rows by account and product and sums their quantities; it does not consume this field, so the provider meter configuration and observed invoice remain the effective billing proof.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'UsageAggregationType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [UsageAggregationType.SUM]: { meaning: 'Sum raw quantities in the period.' },\n [UsageAggregationType.MAX]: { meaning: 'Use peak usage in the period when the price model calls for it.' },\n [UsageAggregationType.LAST]: { meaning: 'Use the last reported sample in the window for certain meter designs.' },\n },\n }),\n taxBehavior: schemaShape.taxBehavior.enumSpec({\n meaning: 'Per-price tax display — overrides product-level `taxDisplayMode` when set.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'TaxDisplayMode', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [TaxDisplayMode.EXCLUSIVE]: { meaning: 'HT list amounts before tax in invoices using this price.' },\n [TaxDisplayMode.INCLUSIVE]: { meaning: 'TTC amounts embedded in the published price point.' },\n },\n }),\n providerPriceId: schemaShape.providerPriceId.stringSpec({ meaning: 'Provider price id for sync; backend-only in many responses.' }),\n isDefault: schemaShape.isDefault.booleanSpec({ meaning: 'Preferred default price for UIs that pick one price per product if multiple exist.' }),\n isActive: schemaShape.isActive.booleanSpec({ meaning: 'Whether new checkouts can select this price when multiple exist.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Row creation time.', temporalRole: 'creation' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Read price details for plan pickers, invoice lines, and admin audit.',\n outcome: 'Money + interval + tier blocks per schema.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The price row was found and its money / interval / tier blocks are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No price exists for the supplied id in the catalog.' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'List prices; often filter by `productId` in application code.',\n outcome: 'All offers for a product in admin.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of price offers, optionally narrowed by `productId`.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to browse the full price catalog.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Add a new offer row under a product when catalog expands.',\n outcome: 'New price id in catalog.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The price offer was created under its product and is returned with its server-assigned `priceId`.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The price payload fails schema validation (e.g. a TIERED model with no `tiers`, or a missing `unitPrice` for FLAT/PER_UNIT).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to extend the price catalog.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The referenced parent `productId` does not exist in the catalog.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A price already maps to the same provider price id (duplicate provider sync target).', errorCode: 'PROVIDER_PRICE_EXISTS' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Add a recurring per-seat monthly price to a product',\n request: {\n productId: 'prod_01HX2…',\n model: PricingModel.PER_UNIT,\n unitPrice: { amount: 1200, currency: 'usd' },\n interval: BillingInterval.MONTH,\n intervalCount: 1,\n isDefault: true,\n isActive: true,\n },\n response: {\n _id: 'price_01HX2…',\n productId: 'prod_01HX2…',\n model: PricingModel.PER_UNIT,\n interval: BillingInterval.MONTH,\n isActive: true,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Change activation, default flag, or money fields in controlled admin flows.',\n outcome: 'Patched row — verify provider sync rules before claiming invoices update retroactively.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The price row was patched (activation / default flag / money fields) and the updated DTO is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to mutate the price catalog.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No price exists for the supplied id in the catalog.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The price is already synced/locked at the provider in a way that forbids mutating immutable money fields (provider prices are immutable after creation).' },\n ],\n idempotent: true,\n },\n [Op.DELETE]: {\n purpose: 'Repository-only teardown of the price row when its owning product is deleted (composition `onParentDelete` cascade).',\n outcome: 'Every price under the product is removed together with the product — the composition parts do not outlive their whole.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The price row was deleted as part of the owning product’s deletion cascade.' },\n ],\n // REPOSITORY_ONLY variant (ORG_OWNER) — invoked by the onParentDelete cascade, not a public HTTP endpoint, so no client-facing 400/403/404 are documented.\n idempotent: true,\n },\n },\n businessConstraints: [\n 'Tax behavior and tier arrays can be large — UI should paginate or collapse in admin when many tiers exist.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n\nexport const pricesResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(pricesMainUI), resourceFrontendConfiguration(pricesAdminUI)),\n pricesBase,\n () => ({\n label: { purpose: 'Preset `getFrontendResourceLabel` uses `model — interval` (or one-time) for a compact sublabel under the product context.' },\n layout: {\n purpose: 'Section refs `pricing`, `tiers`, `tax`, `availability` in billing presets: money + cadence, tier ladders, tax behavior, default/active flags.',\n displayPurpose: 'Merged admin adds LIST+READ `views` (non-addressable) on top of main empty-views for catalog admin browse.',\n sections: {\n pricing: { purpose: 'Model, `unitPrice`, and interval for the headline commercial terms.', whenToUse: 'Checkout price selection and subscription diff tools.', textSlots: { title: { purpose: 'Pricing block.' }, description: { purpose: 'Provider ids may exist as backend-only fields in implementation — not in this spec layer.' } } },\n tiers: { purpose: 'Volume tiers, package size, and usage aggregation for advanced models.', whenToUse: 'Metered and tiered SKUs only.', textSlots: { title: { purpose: 'Tiers block.' }, description: { purpose: 'Empty in flat pricing — UI should not imply misconfiguration when absent.' } } },\n tax: { purpose: 'Tax display behavior on invoices for this price.', whenToUse: 'Jurisdictional checkout messaging.', textSlots: { title: { purpose: 'Tax block.' }, description: { purpose: 'Not a legal tax engine in Wildo — provider calculates actual tax.' } } },\n availability: { purpose: '`isDefault` and `isActive` to steer which price auto-selects in UIs.', whenToUse: 'When multiple active prices per product are normal (regional, promo base, etc.).', textSlots: { title: { purpose: 'Availability block.' }, description: { purpose: 'Deactivating a price does not by itself change existing subscription items until change-plan flows run.' } } },\n },\n },\n views: {\n [Op.LIST]: { purpose: 'Merged admin LIST view entry (non-addressable in billing `views` wiring).', whenToUse: 'Catalog admin for prices.' },\n [Op.READ]: { purpose: 'Merged admin READ view entry (non-addressable in billing `views` wiring).', whenToUse: 'Admin drill-down on one price id.' },\n },\n }),\n);\n"]}
1
+ {"version":3,"file":"prices.resource.specification.js","sourceRoot":"","sources":["../../../../../src/engine/billing/resources/prices.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n pricesAdminResourceUIBehavior as pricesAdminSource,\n pricesMainResourceUIBehavior as pricesMainSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n BillingInterval,\n PriceSchema,\n PricingModel,\n ResourcePrimaryScope,\n TaxDisplayMode,\n UsageAggregationType,\n pricesResourceConfiguration_InitializationFactory as pricesFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof pricesFactory>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\nconst pricesMainUI = pricesMainSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\nconst pricesAdminUI = pricesAdminSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nconst pricesBase = resourceSpecification<undefined, Core, Main>(\n pricesFactory,\n PriceSchema,\n ({ schemaShape }) => ({\n purpose: 'One way to pay for a product: its pricing model, amount, currency, billing interval and tiers. Checkout and subscriptions refer to a price by its identifier.',\n businessRole: 'Binds a catalog product to a billable money shape (flat, per-unit, tiered, …) the provider can invoice.',\n lifecycleRole: 'Admin-managed: created with products; activation toggles hide from new purchases without mutating old subscriptions in typical flows.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'PriceSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactory: { packageName: '@wildo-ai/saas-models', exportName: 'pricesResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName: 'PRICES' },\n operationVocabulary: { coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM } },\n frontendConfigurationSources: [\n { packageName: '@wildo-ai/presets-components', exportName: 'pricesMainResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n { packageName: '@wildo-ai/presets-components', exportName: 'pricesAdminResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n ],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Price record id; referenced as `priceId` on subscription items.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n productId: schemaShape.productId.stringSpec({ meaning: 'FK to the owning `PRODUCTS` document.', importance: FieldSemanticImportance.PRIMARY }),\n model: schemaShape.model.enumSpec({\n meaning: 'Stripe-style pricing model for how quantity maps to line items.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'PricingModel', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [PricingModel.FLAT]: { meaning: 'One fixed price without per-seat scaling.' },\n [PricingModel.PER_UNIT]: { meaning: 'Linear in quantity (seats, tokens bucket).' },\n [PricingModel.TIERED]: { meaning: 'Volume pricing: the reached tier supplies the unit rate for the whole quantity.' },\n [PricingModel.GRADUATED]: { meaning: 'Graduated pricing: each quantity bracket is priced independently and the bracket amounts are added.' },\n [PricingModel.PACKAGE]: { meaning: 'Blocks of units sold as packages.' },\n },\n }),\n unitPrice: schemaShape.unitPrice.objectSpec({ meaning: 'Money object (amount + currency) for FLAT/PER_UNIT models; not used for pure tiered/graduated records that rely on `tiers` instead.' }),\n interval: schemaShape.interval.enumSpec({\n meaning: 'Billing period anchor when recurring.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'BillingInterval', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [BillingInterval.MONTH]: { meaning: 'Monthly cadence at provider.' },\n [BillingInterval.YEAR]: { meaning: 'Annual cadence at provider.' },\n },\n }),\n intervalCount: schemaShape.intervalCount.numberSpec({ meaning: 'Multiplier on interval (e.g. every 3 months).' }),\n tiers: schemaShape.tiers.arraySpec({ meaning: 'Tier ladder for TIERED/GRADUATED models with per-tier money blocks.', elementMeaning: 'One `PriceTierSchema` row with `upTo`, `unitPrice`, and `flatPrice` money objects.' }),\n packageSize: schemaShape.packageSize.numberSpec({ meaning: 'Units per price package for PACKAGE model pricing.' }),\n usageAggregation: schemaShape.usageAggregation.enumSpec({\n meaning:\n 'Authored intent for how a provider meter should roll up usage. The current application metering flush always groups pending local records by account and product and sums their quantities; it does not consume this field, so the provider meter configuration and observed invoice remain the effective billing proof.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'UsageAggregationType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [UsageAggregationType.SUM]: { meaning: 'Sum raw quantities in the period.' },\n [UsageAggregationType.MAX]: { meaning: 'Use peak usage in the period when the price model calls for it.' },\n [UsageAggregationType.LAST]: { meaning: 'Use the last reported sample in the window for certain meter designs.' },\n },\n }),\n taxBehavior: schemaShape.taxBehavior.enumSpec({\n meaning: 'Per-price tax display — overrides product-level `taxDisplayMode` when set.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'TaxDisplayMode', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [TaxDisplayMode.EXCLUSIVE]: { meaning: 'HT list amounts before tax in invoices using this price.' },\n [TaxDisplayMode.INCLUSIVE]: { meaning: 'TTC amounts embedded in the published price point.' },\n },\n }),\n providerPriceId: schemaShape.providerPriceId.stringSpec({ meaning: 'Provider price id for sync; backend-only in many responses.' }),\n isDefault: schemaShape.isDefault.booleanSpec({ meaning: 'Preferred default price for UIs that pick one price per product if multiple exist.' }),\n isActive: schemaShape.isActive.booleanSpec({ meaning: 'Whether new checkouts can select this price when multiple exist.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Record creation time.', temporalRole: 'creation' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Read price details for plan pickers, invoice lines, and admin audit.',\n outcome: 'Money + interval + tier blocks per schema.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The price record was found and its money / interval / tier blocks are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No price exists for the supplied id in the catalog.' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'List prices; often filter by `productId` in application code.',\n outcome: 'All offers for a product in admin.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of price offers, optionally narrowed by `productId`.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to browse the full price catalog.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Add a new offer row under a product when catalog expands.',\n outcome: 'New price id in catalog.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The price offer was created under its product and is returned with its server-assigned `priceId`.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The price payload fails schema validation (e.g. a TIERED model with no `tiers`, or a missing `unitPrice` for FLAT/PER_UNIT).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to extend the price catalog.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The referenced parent `productId` does not exist in the catalog.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A price already maps to the same provider price id (duplicate provider sync target).', errorCode: 'PROVIDER_PRICE_EXISTS' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Add a recurring per-seat monthly price to a product',\n request: {\n productId: 'prod_01HX2…',\n model: PricingModel.PER_UNIT,\n unitPrice: { amount: 1200, currency: 'usd' },\n interval: BillingInterval.MONTH,\n intervalCount: 1,\n isDefault: true,\n isActive: true,\n },\n response: {\n _id: 'price_01HX2…',\n productId: 'prod_01HX2…',\n model: PricingModel.PER_UNIT,\n interval: BillingInterval.MONTH,\n isActive: true,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Change activation, default flag, or money fields in controlled admin flows.',\n outcome: 'Patched row — verify provider sync rules before claiming invoices update retroactively.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The price record was patched (activation / default flag / money fields) and the updated DTO is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to mutate the price catalog.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No price exists for the supplied id in the catalog.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The price is already synced/locked at the provider in a way that forbids mutating immutable money fields (provider prices are immutable after creation).' },\n ],\n idempotent: true,\n },\n [Op.DELETE]: {\n purpose: 'Repository-only teardown of the price row when its owning product is deleted (composition `onParentDelete` cascade).',\n outcome: 'Every price under the product is removed together with the product — the composition parts do not outlive their whole.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The price record was deleted as part of the owning product’s deletion cascade.' },\n ],\n // REPOSITORY_ONLY variant (ORG_OWNER) — invoked by the onParentDelete cascade, not a public HTTP endpoint, so no client-facing 400/403/404 are documented.\n idempotent: true,\n },\n },\n businessConstraints: [\n 'Tax behavior and tier arrays can be large — UI should paginate or collapse in admin when many tiers exist.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n\nexport const pricesResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(pricesMainUI), resourceFrontendConfiguration(pricesAdminUI)),\n pricesBase,\n () => ({\n label: { purpose: 'Preset `getFrontendResourceLabel` uses `model — interval` (or one-time) for a compact sublabel under the product context.' },\n layout: {\n purpose: 'Section refs `pricing`, `tiers`, `tax`, `availability` in billing presets: money + cadence, tier ladders, tax behavior, default/active flags.',\n displayPurpose: 'Merged admin adds LIST+READ `views` (non-addressable) on top of main empty-views for catalog admin browse.',\n sections: {\n pricing: { purpose: 'Model, `unitPrice`, and interval for the headline commercial terms.', whenToUse: 'Checkout price selection and subscription diff tools.', textSlots: { title: { purpose: 'Pricing block.' }, description: { purpose: 'Provider ids may exist as backend-only fields in implementation — not in this spec layer.' } } },\n tiers: { purpose: 'Volume tiers, package size, and usage aggregation for advanced models.', whenToUse: 'Metered and tiered SKUs only.', textSlots: { title: { purpose: 'Tiers block.' }, description: { purpose: 'Empty in flat pricing — UI should not imply misconfiguration when absent.' } } },\n tax: { purpose: 'Tax display behavior on invoices for this price.', whenToUse: 'Jurisdictional checkout messaging.', textSlots: { title: { purpose: 'Tax block.' }, description: { purpose: 'Not a legal tax engine in Wildo — provider calculates actual tax.' } } },\n availability: { purpose: '`isDefault` and `isActive` to steer which price auto-selects in UIs.', whenToUse: 'When multiple active prices per product are normal (regional, promo base, etc.).', textSlots: { title: { purpose: 'Availability block.' }, description: { purpose: 'Deactivating a price does not by itself change existing subscription items until change-plan flows run.' } } },\n },\n },\n views: {\n [Op.LIST]: { purpose: 'Merged admin LIST view entry (non-addressable in billing `views` wiring).', whenToUse: 'Catalog admin for prices.' },\n [Op.READ]: { purpose: 'Merged admin READ view entry (non-addressable in billing `views` wiring).', whenToUse: 'Admin drill-down on one price id.' },\n },\n }),\n);\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"products.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/products.resource.specification.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,WAAW,EAEX,oBAAoB,EACpB,cAAc,EAEf,MAAM,uBAAuB,CAAC;AA8K/B,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAqBzC,CAAC"}
1
+ {"version":3,"file":"products.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/billing/resources/products.resource.specification.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,WAAW,EAEX,oBAAoB,EACpB,cAAc,EAEf,MAAM,uBAAuB,CAAC;AA8K/B,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAqBzC,CAAC"}
@@ -31,7 +31,7 @@ const productsBase = resourceSpecification(productsFactory, ProductSchema, ({ sc
31
31
  values: {
32
32
  [ProductType.PLAN]: { meaning: 'Primary subscription entitlements and tiering.' },
33
33
  [ProductType.ADDON]: { meaning: 'Optional capacity or feature on top of a plan.' },
34
- [ProductType.METERED]: { meaning: 'Usage-billed add-on; ties to `UsageRecord` rows.' },
34
+ [ProductType.METERED]: { meaning: 'Usage-billed add-on; ties to `UsageRecord` records.' },
35
35
  [ProductType.ONE_TIME]: { meaning: 'One-shot purchase, not a recurring subscription state machine.' },
36
36
  [ProductType.CREDIT_PACK]: { meaning: 'Prepaid credits to a `CreditPool` balance.' },
37
37
  [ProductType.ITEM]: { meaning: 'Generic one-off line item in catalog semantics.' },
@@ -64,18 +64,18 @@ const productsBase = resourceSpecification(productsFactory, ProductSchema, ({ sc
64
64
  behaviorPolicy: schemaShape.behaviorPolicy.objectSpec({ meaning: 'Nested policy for trial, proration, cancellation windows, and metering hooks — the authoritative behavior engine for this SKU in services.' }),
65
65
  providerProductId: schemaShape.providerProductId.stringSpec({ meaning: 'Provider-side id after first sync — backend-only in many API shapes.' }),
66
66
  isPublic: schemaShape.isPublic.booleanSpec({ meaning: 'Visibility for self-serve catalog vs org-admin-only offer matrix.' }),
67
- isActive: schemaShape.isActive.booleanSpec({ meaning: 'Whether the product is offered to new checkouts; historical subs may still reference inactive rows.' }),
67
+ isActive: schemaShape.isActive.booleanSpec({ meaning: 'Whether the product is offered to new checkouts; historical subs may still reference inactive records.' }),
68
68
  sortOrder: schemaShape.sortOrder.numberSpec({ meaning: 'Display ordering in pickers and marketing surfaces.' }),
69
69
  metadata: schemaShape.metadata.objectSpec({ meaning: 'Opaque key/value for provider sync or A/B test tags — not PII by contract.' }),
70
- createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Row creation time.', temporalRole: 'creation' }),
71
- updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Row update time for syncs.', temporalRole: 'modified' }),
70
+ createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Record creation time.', temporalRole: 'creation' }),
71
+ updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Record update time for syncs.', temporalRole: 'modified' }),
72
72
  },
73
73
  operations: {
74
74
  [Op.READ]: {
75
75
  purpose: 'Read one catalog row (features, keys, and limits) for admin and in-app gating code.',
76
76
  outcome: 'Full product + behavior policy in implementation.',
77
77
  responseStatuses: [
78
- { code: HttpResponseStatusCode.OK_200, meaning: 'The product catalog row was found and its full DTO (features, limits, behavior policy) is returned.' },
78
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The product catalog record was found and its full DTO (features, limits, behavior policy) is returned.' },
79
79
  ],
80
80
  errorScenarios: [
81
81
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No product exists for the supplied id in this application catalog.' },
@@ -108,7 +108,7 @@ const productsBase = resourceSpecification(productsFactory, ProductSchema, ({ sc
108
108
  purpose: 'Internal service-pipeline lazy insert (not HTTP-exposed) of the first DB row for a `ProductDefinition` on demand.',
109
109
  outcome: 'Seeded `key` and immutable bits from the definition in services.',
110
110
  responseStatuses: [
111
- { code: HttpResponseStatusCode.CREATED_201, meaning: 'The product row was materialized from its `ProductDefinition` and is returned with its server-assigned id.' },
111
+ { code: HttpResponseStatusCode.CREATED_201, meaning: 'The product record was materialized from its `ProductDefinition` and is returned with its server-assigned id.' },
112
112
  ],
113
113
  errorScenarios: [
114
114
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The product payload fails schema validation (e.g. missing `key` or unknown `type`).', errorCode: 'VALIDATION_FAILED' },
@@ -144,7 +144,7 @@ const productsBase = resourceSpecification(productsFactory, ProductSchema, ({ sc
144
144
  purpose: 'Sync metadata, activation flags, or provider ids; not end-user ad-hoc edits in production discipline.',
145
145
  outcome: 'Patched product row per admin workflow.',
146
146
  responseStatuses: [
147
- { code: HttpResponseStatusCode.OK_200, meaning: 'The product row was patched and the updated catalog DTO is returned.' },
147
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The product record was patched and the updated catalog DTO is returned.' },
148
148
  ],
149
149
  errorScenarios: [
150
150
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },
@@ -1 +1 @@
1
- {"version":3,"file":"products.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/products.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n productsAdminResourceUIBehavior as productsAdminSource,\n productsMainResourceUIBehavior as productsMainSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n ProductType,\n ProductSchema,\n ResourcePrimaryScope,\n TaxDisplayMode,\n productsResourceConfiguration_InitializationFactory as productsFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof productsFactory>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\nconst productsMainUI = productsMainSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\nconst productsAdminUI = productsAdminSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nconst productsBase = resourceSpecification<undefined, Core, Main>(\n productsFactory,\n ProductSchema,\n ({ schemaShape }) => ({\n purpose: 'One product in the application\\'s catalog: the plan, add-on or credit pack an organization can subscribe to, with the features and limits it grants. The catalog is defined by the application, not edited per organization.',\n businessRole: 'Anchor for prices, promotions, and subscription line items; drives plan tiers, add-ons, and feature/limit grants.',\n lifecycleRole: 'Lazy DB row created from definitions; provider ids filled on first use; bulk sync in admin; edits are deployment-driven, not ad-hoc CRUD in end-user UI.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'ProductSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactory: { packageName: '@wildo-ai/saas-models', exportName: 'productsResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName: 'PRODUCTS' },\n operationVocabulary: { coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM } },\n frontendConfigurationSources: [\n { packageName: '@wildo-ai/presets-components', exportName: 'productsMainResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n { packageName: '@wildo-ai/presets-components', exportName: 'productsAdminResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n ],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Product document id in the app catalog collection.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n key: schemaShape.key.stringSpec({ meaning: 'Stable key that maps 1:1 to `ProductDefinition.key` in the code catalog — unique globally per app database.', importance: FieldSemanticImportance.PRIMARY }),\n type: schemaShape.type.enumSpec({\n meaning: 'Commercial shape of the product (PLAN, ADDON, METERED, etc.).',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ProductType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [ProductType.PLAN]: { meaning: 'Primary subscription entitlements and tiering.' },\n [ProductType.ADDON]: { meaning: 'Optional capacity or feature on top of a plan.' },\n [ProductType.METERED]: { meaning: 'Usage-billed add-on; ties to `UsageRecord` rows.' },\n [ProductType.ONE_TIME]: { meaning: 'One-shot purchase, not a recurring subscription state machine.' },\n [ProductType.CREDIT_PACK]: { meaning: 'Prepaid credits to a `CreditPool` balance.' },\n [ProductType.ITEM]: { meaning: 'Generic one-off line item in catalog semantics.' },\n },\n }),\n targetScopes: schemaShape.targetScopes.arraySpec({\n meaning: 'Which `ResourcePrimaryScope` values may attach subscriptions to this product (org vs user vs app).',\n elementMeaning: 'One primary scope discriminator the product is sold into.',\n elementType: {\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ResourcePrimaryScope', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n },\n }),\n grantedFeatures: schemaShape.grantedFeatures.arraySpec({\n meaning: 'Feature keys this product enables when the subscription line is active — merged by billing feature sync with ADDON rules.',\n elementMeaning: 'One string feature id from the app feature catalog.',\n }),\n grantedLimits: schemaShape.grantedLimits.objectSpec({ meaning: 'Named limit grants (`LimitGrantSchema`) and aggregation mode for entitlements in runtime checks.' }),\n planTier: schemaShape.planTier.stringSpec({ meaning: 'For PLAN: human tier label; used with `planTierOrder` for upgrade/downgrade heuristics.' }),\n planTierOrder: schemaShape.planTierOrder.numberSpec({ meaning: 'Numeric order for plan comparisons within the app.' }),\n requiredPlanTiers: schemaShape.requiredPlanTiers.arraySpec({ meaning: 'For ADDON: plan tier keys that must be active before this add-on is purchasable.', elementMeaning: 'One `planTier` string id.' }),\n taxDisplayMode: schemaShape.taxDisplayMode.enumSpec({\n meaning: 'Whether displayed prices for this product are tax-exclusive or tax-inclusive, overriding the global default when set.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'TaxDisplayMode', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [TaxDisplayMode.EXCLUSIVE]: { meaning: 'Amounts shown before tax; tax added at checkout.' },\n [TaxDisplayMode.INCLUSIVE]: { meaning: 'Amounts include tax in displayed totals.' },\n },\n }),\n purchaseConfig: schemaShape.purchaseConfig.objectSpec({ meaning: 'Per-purchase options for one-time and credit products (max quantity, credits per unit, target credit pool key).' }),\n behaviorPolicy: schemaShape.behaviorPolicy.objectSpec({ meaning: 'Nested policy for trial, proration, cancellation windows, and metering hooks — the authoritative behavior engine for this SKU in services.' }),\n providerProductId: schemaShape.providerProductId.stringSpec({ meaning: 'Provider-side id after first sync — backend-only in many API shapes.' }),\n isPublic: schemaShape.isPublic.booleanSpec({ meaning: 'Visibility for self-serve catalog vs org-admin-only offer matrix.' }),\n isActive: schemaShape.isActive.booleanSpec({ meaning: 'Whether the product is offered to new checkouts; historical subs may still reference inactive rows.' }),\n sortOrder: schemaShape.sortOrder.numberSpec({ meaning: 'Display ordering in pickers and marketing surfaces.' }),\n metadata: schemaShape.metadata.objectSpec({ meaning: 'Opaque key/value for provider sync or A/B test tags — not PII by contract.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Row creation time.', temporalRole: 'creation' }),\n updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Row update time for syncs.', temporalRole: 'modified' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Read one catalog row (features, keys, and limits) for admin and in-app gating code.',\n outcome: 'Full product + behavior policy in implementation.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The product catalog row was found and its full DTO (features, limits, behavior policy) is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No product exists for the supplied id in this application catalog.' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'Browse the catalog in admin and tooling.',\n outcome: 'Paginated products for the application scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of catalog products for the application scope.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to browse the product catalog.' },\n ],\n idempotent: true,\n },\n [Op.SEARCH]: {\n purpose: 'Search by `key` / `type` per factory searchable fields in repository variant.',\n outcome: 'Filtered list for typeahead in admin UIs.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of products matching the `key` / `type` search query.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to search the product catalog.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Internal service-pipeline lazy insert (not HTTP-exposed) of the first DB row for a `ProductDefinition` on demand.',\n outcome: 'Seeded `key` and immutable bits from the definition in services.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The product row was materialized from its `ProductDefinition` and is returned with its server-assigned id.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The product payload fails schema validation (e.g. missing `key` or unknown `type`).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not the platform/admin/repository path permitted to seed catalog rows.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A product with the same globally-unique `key` already exists in this application database.', errorCode: 'PRODUCT_KEY_EXISTS' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Materialize a plan product from its definition',\n request: {\n key: 'plan_pro',\n type: ProductType.PLAN,\n targetScopes: [ResourcePrimaryScope.ORGANIZATIONS],\n grantedFeatures: ['advanced_reporting'],\n planTier: 'pro',\n planTierOrder: 20,\n isPublic: true,\n isActive: true,\n },\n response: {\n _id: 'prod_01HX2…',\n key: 'plan_pro',\n type: ProductType.PLAN,\n planTier: 'pro',\n isActive: true,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Sync metadata, activation flags, or provider ids; not end-user ad-hoc edits in production discipline.',\n outcome: 'Patched product row per admin workflow.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The product row was patched and the updated catalog DTO is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to mutate the product catalog.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No product exists for the supplied id in this application catalog.' },\n ],\n idempotent: true,\n },\n },\n businessConstraints: [\n 'Code definitions remain the conceptual source of truth — treat DB as materialized state for the billing engine, not a CMS.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n\nexport const productsResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(productsMainUI), resourceFrontendConfiguration(productsAdminUI)),\n productsBase,\n () => ({\n label: { purpose: 'Preset `getFrontendResourceLabel` uses `key` for short catalog rows.' },\n layout: {\n purpose: 'Five section refs: `overview` (key, type, plan tier, feature grants), `tax` (tax display mode), `purchase` (credit pack config), `behavior` (policy), `visibility` (public/active/metadata).',\n displayPurpose: 'Main preset has no addressable `views` — merged admin adds LIST+READ for catalog browse (all non-addressable in billing presets).',\n sections: {\n overview: { purpose: 'Identity and tier information for a product in one card.', whenToUse: 'Admin or pricing tables.', textSlots: { title: { purpose: 'Product header.' }, description: { purpose: 'Feature/limit details follow `grantedFeatures` and `grantedLimits` in schema — not repeated field-by-field here.' } } },\n tax: { purpose: 'How tax is displayed on invoices for this product line.', whenToUse: 'When jurisdiction matters for checkout copy.', textSlots: { title: { purpose: 'Tax block.' }, description: { purpose: 'Does not set legal tax rates — that is the provider in production.' } } },\n purchase: { purpose: 'Per-unit, credit, and max-quantity options for one-time and credit products.', whenToUse: 'CREDIT_PACK and one-time flows.', textSlots: { title: { purpose: 'Purchase settings.' }, description: { purpose: 'Align with `ProductBehaviorPolicy` in implementation for when fields apply.' } } },\n behavior: { purpose: 'Policies for metering, trials, and add-on compatibility.', whenToUse: 'When tuning product-behavior for engineering.', textSlots: { title: { purpose: 'Behavior block.' }, description: { purpose: 'Backend enforcement lives in services — UI is a structured editor over the zod object.' } } },\n visibility: { purpose: 'Public, active, and free-form `metadata` for integrations.', whenToUse: 'Gating a product in marketing vs admin-only.', textSlots: { title: { purpose: 'Visibility block.' }, description: { purpose: 'Turning `isActive` off does not cancel existing subscriptions in typical billing semantics.' } } },\n },\n },\n views: {\n [Op.LIST]: { purpose: 'Merged admin exposes LIST in `views` as non-addressable; included for overlay truthfulness.', whenToUse: 'App operator catalog screens when wired.' },\n [Op.READ]: { purpose: 'Merged admin exposes READ in `views` as non-addressable.', whenToUse: 'Drill into one product in admin UIs when wired.' },\n },\n }),\n);\n"]}
1
+ {"version":3,"file":"products.resource.specification.js","sourceRoot":"","sources":["../../../../../src/engine/billing/resources/products.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n productsAdminResourceUIBehavior as productsAdminSource,\n productsMainResourceUIBehavior as productsMainSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n ProductType,\n ProductSchema,\n ResourcePrimaryScope,\n TaxDisplayMode,\n productsResourceConfiguration_InitializationFactory as productsFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof productsFactory>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\nconst productsMainUI = productsMainSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\nconst productsAdminUI = productsAdminSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nconst productsBase = resourceSpecification<undefined, Core, Main>(\n productsFactory,\n ProductSchema,\n ({ schemaShape }) => ({\n purpose: 'One product in the application\\'s catalog: the plan, add-on or credit pack an organization can subscribe to, with the features and limits it grants. The catalog is defined by the application, not edited per organization.',\n businessRole: 'Anchor for prices, promotions, and subscription line items; drives plan tiers, add-ons, and feature/limit grants.',\n lifecycleRole: 'Lazy DB row created from definitions; provider ids filled on first use; bulk sync in admin; edits are deployment-driven, not ad-hoc CRUD in end-user UI.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'ProductSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactory: { packageName: '@wildo-ai/saas-models', exportName: 'productsResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName: 'PRODUCTS' },\n operationVocabulary: { coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM } },\n frontendConfigurationSources: [\n { packageName: '@wildo-ai/presets-components', exportName: 'productsMainResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n { packageName: '@wildo-ai/presets-components', exportName: 'productsAdminResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n ],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Product document id in the app catalog collection.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n key: schemaShape.key.stringSpec({ meaning: 'Stable key that maps 1:1 to `ProductDefinition.key` in the code catalog — unique globally per app database.', importance: FieldSemanticImportance.PRIMARY }),\n type: schemaShape.type.enumSpec({\n meaning: 'Commercial shape of the product (PLAN, ADDON, METERED, etc.).',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ProductType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [ProductType.PLAN]: { meaning: 'Primary subscription entitlements and tiering.' },\n [ProductType.ADDON]: { meaning: 'Optional capacity or feature on top of a plan.' },\n [ProductType.METERED]: { meaning: 'Usage-billed add-on; ties to `UsageRecord` records.' },\n [ProductType.ONE_TIME]: { meaning: 'One-shot purchase, not a recurring subscription state machine.' },\n [ProductType.CREDIT_PACK]: { meaning: 'Prepaid credits to a `CreditPool` balance.' },\n [ProductType.ITEM]: { meaning: 'Generic one-off line item in catalog semantics.' },\n },\n }),\n targetScopes: schemaShape.targetScopes.arraySpec({\n meaning: 'Which `ResourcePrimaryScope` values may attach subscriptions to this product (org vs user vs app).',\n elementMeaning: 'One primary scope discriminator the product is sold into.',\n elementType: {\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ResourcePrimaryScope', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n },\n }),\n grantedFeatures: schemaShape.grantedFeatures.arraySpec({\n meaning: 'Feature keys this product enables when the subscription line is active — merged by billing feature sync with ADDON rules.',\n elementMeaning: 'One string feature id from the app feature catalog.',\n }),\n grantedLimits: schemaShape.grantedLimits.objectSpec({ meaning: 'Named limit grants (`LimitGrantSchema`) and aggregation mode for entitlements in runtime checks.' }),\n planTier: schemaShape.planTier.stringSpec({ meaning: 'For PLAN: human tier label; used with `planTierOrder` for upgrade/downgrade heuristics.' }),\n planTierOrder: schemaShape.planTierOrder.numberSpec({ meaning: 'Numeric order for plan comparisons within the app.' }),\n requiredPlanTiers: schemaShape.requiredPlanTiers.arraySpec({ meaning: 'For ADDON: plan tier keys that must be active before this add-on is purchasable.', elementMeaning: 'One `planTier` string id.' }),\n taxDisplayMode: schemaShape.taxDisplayMode.enumSpec({\n meaning: 'Whether displayed prices for this product are tax-exclusive or tax-inclusive, overriding the global default when set.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'TaxDisplayMode', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [TaxDisplayMode.EXCLUSIVE]: { meaning: 'Amounts shown before tax; tax added at checkout.' },\n [TaxDisplayMode.INCLUSIVE]: { meaning: 'Amounts include tax in displayed totals.' },\n },\n }),\n purchaseConfig: schemaShape.purchaseConfig.objectSpec({ meaning: 'Per-purchase options for one-time and credit products (max quantity, credits per unit, target credit pool key).' }),\n behaviorPolicy: schemaShape.behaviorPolicy.objectSpec({ meaning: 'Nested policy for trial, proration, cancellation windows, and metering hooks — the authoritative behavior engine for this SKU in services.' }),\n providerProductId: schemaShape.providerProductId.stringSpec({ meaning: 'Provider-side id after first sync — backend-only in many API shapes.' }),\n isPublic: schemaShape.isPublic.booleanSpec({ meaning: 'Visibility for self-serve catalog vs org-admin-only offer matrix.' }),\n isActive: schemaShape.isActive.booleanSpec({ meaning: 'Whether the product is offered to new checkouts; historical subs may still reference inactive records.' }),\n sortOrder: schemaShape.sortOrder.numberSpec({ meaning: 'Display ordering in pickers and marketing surfaces.' }),\n metadata: schemaShape.metadata.objectSpec({ meaning: 'Opaque key/value for provider sync or A/B test tags — not PII by contract.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Record creation time.', temporalRole: 'creation' }),\n updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Record update time for syncs.', temporalRole: 'modified' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Read one catalog row (features, keys, and limits) for admin and in-app gating code.',\n outcome: 'Full product + behavior policy in implementation.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The product catalog record was found and its full DTO (features, limits, behavior policy) is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No product exists for the supplied id in this application catalog.' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'Browse the catalog in admin and tooling.',\n outcome: 'Paginated products for the application scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of catalog products for the application scope.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to browse the product catalog.' },\n ],\n idempotent: true,\n },\n [Op.SEARCH]: {\n purpose: 'Search by `key` / `type` per factory searchable fields in repository variant.',\n outcome: 'Filtered list for typeahead in admin UIs.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of products matching the `key` / `type` search query.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to search the product catalog.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Internal service-pipeline lazy insert (not HTTP-exposed) of the first DB row for a `ProductDefinition` on demand.',\n outcome: 'Seeded `key` and immutable bits from the definition in services.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The product record was materialized from its `ProductDefinition` and is returned with its server-assigned id.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The product payload fails schema validation (e.g. missing `key` or unknown `type`).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not the platform/admin/repository path permitted to seed catalog rows.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A product with the same globally-unique `key` already exists in this application database.', errorCode: 'PRODUCT_KEY_EXISTS' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Materialize a plan product from its definition',\n request: {\n key: 'plan_pro',\n type: ProductType.PLAN,\n targetScopes: [ResourcePrimaryScope.ORGANIZATIONS],\n grantedFeatures: ['advanced_reporting'],\n planTier: 'pro',\n planTierOrder: 20,\n isPublic: true,\n isActive: true,\n },\n response: {\n _id: 'prod_01HX2…',\n key: 'plan_pro',\n type: ProductType.PLAN,\n planTier: 'pro',\n isActive: true,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Sync metadata, activation flags, or provider ids; not end-user ad-hoc edits in production discipline.',\n outcome: 'Patched product row per admin workflow.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The product record was patched and the updated catalog DTO is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to mutate the product catalog.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No product exists for the supplied id in this application catalog.' },\n ],\n idempotent: true,\n },\n },\n businessConstraints: [\n 'Code definitions remain the conceptual source of truth — treat DB as materialized state for the billing engine, not a CMS.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n\nexport const productsResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(productsMainUI), resourceFrontendConfiguration(productsAdminUI)),\n productsBase,\n () => ({\n label: { purpose: 'Preset `getFrontendResourceLabel` uses `key` for short catalog rows.' },\n layout: {\n purpose: 'Five section refs: `overview` (key, type, plan tier, feature grants), `tax` (tax display mode), `purchase` (credit pack config), `behavior` (policy), `visibility` (public/active/metadata).',\n displayPurpose: 'Main preset has no addressable `views` — merged admin adds LIST+READ for catalog browse (all non-addressable in billing presets).',\n sections: {\n overview: { purpose: 'Identity and tier information for a product in one card.', whenToUse: 'Admin or pricing tables.', textSlots: { title: { purpose: 'Product header.' }, description: { purpose: 'Feature/limit details follow `grantedFeatures` and `grantedLimits` in schema — not repeated field-by-field here.' } } },\n tax: { purpose: 'How tax is displayed on invoices for this product line.', whenToUse: 'When jurisdiction matters for checkout copy.', textSlots: { title: { purpose: 'Tax block.' }, description: { purpose: 'Does not set legal tax rates — that is the provider in production.' } } },\n purchase: { purpose: 'Per-unit, credit, and max-quantity options for one-time and credit products.', whenToUse: 'CREDIT_PACK and one-time flows.', textSlots: { title: { purpose: 'Purchase settings.' }, description: { purpose: 'Align with `ProductBehaviorPolicy` in implementation for when fields apply.' } } },\n behavior: { purpose: 'Policies for metering, trials, and add-on compatibility.', whenToUse: 'When tuning product-behavior for engineering.', textSlots: { title: { purpose: 'Behavior block.' }, description: { purpose: 'Backend enforcement lives in services — UI is a structured editor over the zod object.' } } },\n visibility: { purpose: 'Public, active, and free-form `metadata` for integrations.', whenToUse: 'Gating a product in marketing vs admin-only.', textSlots: { title: { purpose: 'Visibility block.' }, description: { purpose: 'Turning `isActive` off does not cancel existing subscriptions in typical billing semantics.' } } },\n },\n },\n views: {\n [Op.LIST]: { purpose: 'Merged admin exposes LIST in `views` as non-addressable; included for overlay truthfulness.', whenToUse: 'App operator catalog screens when wired.' },\n [Op.READ]: { purpose: 'Merged admin exposes READ in `views` as non-addressable.', whenToUse: 'Drill into one product in admin UIs when wired.' },\n },\n }),\n);\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"promotions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/promotions.resource.specification.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,YAAY,EACZ,aAAa,EACb,iBAAiB,EAEjB,oBAAoB,EAGrB,MAAM,uBAAuB,CAAC;AAkN/B,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;iCAuB3C,CAAC"}
1
+ {"version":3,"file":"promotions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/billing/resources/promotions.resource.specification.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,YAAY,EACZ,aAAa,EACb,iBAAiB,EAEjB,oBAAoB,EAGrB,MAAM,uBAAuB,CAAC;AAoN/B,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;iCAuB3C,CAAC"}
@@ -65,7 +65,7 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
65
65
  timesRedeemed: schemaShape.timesRedeemed.numberSpec({ meaning: 'Counter mirrored for admin read of campaign health.' }),
66
66
  validFrom: schemaShape.validFrom.dateSpec({ meaning: 'Earliest datetime the code is valid.', temporalRole: 'scheduled' }),
67
67
  validUntil: schemaShape.validUntil.dateSpec({ meaning: 'Hard stop for new redemptions.', temporalRole: 'deadline' }),
68
- isActive: schemaShape.isActive.booleanSpec({ meaning: 'Soft switch to stop new uses without deleting the row.' }),
68
+ isActive: schemaShape.isActive.booleanSpec({ meaning: 'Soft switch to stop new uses without deleting the record.' }),
69
69
  metadata: schemaShape.metadata.objectSpec({ meaning: 'Extra campaign tags for analytics — not user PII.' }),
70
70
  },
71
71
  operations: {
@@ -85,7 +85,7 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
85
85
  purpose: 'Browse campaigns in admin (merged admin adds non-addressable LIST view).',
86
86
  outcome: 'Paginated promotions in application scope.',
87
87
  responseStatuses: [
88
- { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of promotion rows in the application scope.' },
88
+ { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of promotion records in the application scope.' },
89
89
  ],
90
90
  errorScenarios: [
91
91
  { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to browse the promotion catalog.' },
@@ -107,7 +107,7 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
107
107
  purpose: 'Author a new promotion row for an upcoming campaign.',
108
108
  outcome: 'New id and code when unique constraints pass.',
109
109
  responseStatuses: [
110
- { code: HttpResponseStatusCode.CREATED_201, meaning: 'A promotion row was created and is returned with its server-assigned id.' },
110
+ { code: HttpResponseStatusCode.CREATED_201, meaning: 'A promotion record was created and is returned with its server-assigned id.' },
111
111
  ],
112
112
  errorScenarios: [
113
113
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The discount mechanics are inconsistent (e.g. percentage value with `discountType` fixed, or `REPEATING` duration without `durationInMonths`) or the payload otherwise fails schema validation.', errorCode: 'VALIDATION_FAILED' },
@@ -144,7 +144,7 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
144
144
  purpose: 'Adjust limits, validity, or active bit before or during a campaign.',
145
145
  outcome: 'Patched row with provider sync where required.',
146
146
  responseStatuses: [
147
- { code: HttpResponseStatusCode.OK_200, meaning: 'The promotion’s limits / validity window / active bit were patched and the updated row is returned.' },
147
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The promotion’s limits / validity window / active bit were patched and the updated record is returned.' },
148
148
  ],
149
149
  errorScenarios: [
150
150
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited discount or duration fields are inconsistent, or the patch otherwise fails schema validation.', errorCode: 'VALIDATION_FAILED' },
@@ -156,10 +156,10 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
156
156
  },
157
157
  [Promotion_Operations.APPLY]: {
158
158
  operationId: Promotion_Operations.APPLY,
159
- purpose: 'Validate and apply a promotion at checkout or plan change when a user supplies a code.',
160
- outcome: 'Discount object or error for the checkout session — main preset surfaces this in `views` as non-addressable.',
159
+ purpose: 'Validate a promotion code a user supplied, and return the discount it resolves to. Records no redemption.',
160
+ outcome: 'Discount object or error for the checkout session.',
161
161
  responseStatuses: [
162
- { code: HttpResponseStatusCode.OK_200, meaning: 'The supplied `code` was valid and applicable; the resolved discount object is returned and the redemption counter is advanced.' },
162
+ { code: HttpResponseStatusCode.OK_200, meaning: 'The supplied `code` was valid and applicable; the resolved discount object is returned. `timesRedeemed` is NOT advanced — a redemption is counted when the purchase completes.' },
163
163
  ],
164
164
  errorScenarios: [
165
165
  { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The `code` is missing/empty or fails request-DTO validation.', errorCode: 'VALIDATION_FAILED' },
@@ -167,10 +167,12 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
167
167
  { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No promotion matches the supplied `code`.' },
168
168
  { code: HttpResponseStatusCode.CONFLICT_409, when: 'The matched promotion is inactive, outside its `validFrom`/`validUntil` window, exhausted (`maxRedemptions` reached), or not applicable to the targeted products.' },
169
169
  ],
170
- // Each successful APPLY records a redemption and advances `timesRedeemed`, so
171
- // re-issuing the same request is NOT side-effect-free — it consumes another
172
- // redemption (and may then trip the exhaustion 409 above).
173
- idempotent: false,
170
+ // Side-effect-free: this verb validates and reports, and advances no counter. It used to
171
+ // increment `timesRedeemed`, which counted a redemption when a customer TYPED a code —
172
+ // so a limited campaign was exhausted by window-shoppers, and a customer who then bought
173
+ // was counted twice once completion started counting. The redemption is now counted only
174
+ // by `checkout.session.completed`.
175
+ idempotent: true,
174
176
  rateLimitNote: 'Code-application is abuse-sensitive (coupon brute-forcing) — the platform may throttle repeated APPLY attempts per caller/account.',
175
177
  },
176
178
  [Promotion_Operations.DEACTIVATE]: {
@@ -209,7 +211,7 @@ export const promotionsResourceSpecification = resourceSpecificationFromFrontend
209
211
  views: {
210
212
  [Op.LIST]: { purpose: 'Merged admin LIST (non-addressable) for operator catalog alignment.', whenToUse: 'Super-admin promotion management when routes exist.' },
211
213
  [Op.READ]: { purpose: 'Merged admin READ (non-addressable) for drill-down alignment.', whenToUse: 'Inspect one campaign when wired.' },
212
- [Promotion_Operations.APPLY]: { purpose: 'Apply path for checkout integration; non-addressable in merged `views` array but op is present for action buttons.', whenToUse: 'User enters code in purchase flow.' },
214
+ [Promotion_Operations.APPLY]: { purpose: 'Code-validation path for checkout integration; non-addressable in merged `views` array but op is present for action buttons. Reports the discount; the redemption is counted at purchase completion.', whenToUse: 'User enters code in purchase flow.' },
213
215
  [Promotion_Operations.DEACTIVATE]: { purpose: 'Deactivate path for admin shutoff; present in both main and merged `views` maps as non-addressable.', whenToUse: 'End a campaign early without deleting history.' },
214
216
  },
215
217
  }));