@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.
- package/dist/esm/_catalogs/index.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/_catalog-spec.shared.schemas.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/aggregate-offer.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/aggregate-rating.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/article.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/blog-posting.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/breadcrumb-list.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/faq-page.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/index.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/offer.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/organization.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/product.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/review.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_catalogs/schema-org/website.catalog-spec.d.ts.map +1 -1
- package/dist/esm/_core/assertions/assertion-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/assertions/assertion-behaviors.schemas.d.ts.map +1 -1
- package/dist/esm/_core/assertions/assertion-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/assertions/assertion-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/assertions/assertion-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-asset.schemas.d.ts +4 -6
- package/dist/esm/_core/brand/brand-asset.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-asset.schemas.js +4 -12
- package/dist/esm/_core/brand/brand-asset.schemas.js.map +1 -1
- package/dist/esm/_core/brand/brand-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-generation.schemas.d.ts +5 -3
- package/dist/esm/_core/brand/brand-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-generation.schemas.js +5 -2
- package/dist/esm/_core/brand/brand-generation.schemas.js.map +1 -1
- package/dist/esm/_core/brand/brand-logo-direction.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-name.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-snapshot.schemas.d.ts +10 -3
- package/dist/esm/_core/brand/brand-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-snapshot.schemas.js +10 -2
- package/dist/esm/_core/brand/brand-snapshot.schemas.js.map +1 -1
- package/dist/esm/_core/brand/brand-visual-tone.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.js +15 -5
- package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.js.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts +40 -3
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js +85 -6
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph.schemas.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js +10 -4
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts +15 -0
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/pricing-plan.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-semantics.specifications.schemas.d.ts.map +1 -1
- package/dist/esm/_core/chart-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-completeness-statement.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts +118 -0
- package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.js +65 -3
- package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts +508 -7
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js +489 -19
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/processor-register.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts +2 -0
- package/dist/esm/_core/compliance-documents/processor-register.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/processor-register.schemas.js +2 -0
- package/dist/esm/_core/compliance-documents/processor-register.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/required-document-set.schemas.d.ts.map +1 -1
- package/dist/esm/_core/composite-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/cross-registry-assertions.d.ts.map +1 -1
- package/dist/esm/_core/data-seed-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/definition-specification-validators.d.ts.map +1 -1
- package/dist/esm/_core/definition-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan-output-set-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan-output-set-validation.d.ts.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan-output-set.schemas.d.ts.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/error-message-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/execution-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts +6 -7
- package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js +6 -13
- package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-validation.d.ts +0 -11
- package/dist/esm/_core/expert-personas/expert-persona-validation.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-validation.js +0 -19
- package/dist/esm/_core/expert-personas/expert-persona-validation.js.map +1 -1
- package/dist/esm/_core/expert-personas/expert-role-template.schemas.d.ts +1 -2
- package/dist/esm/_core/expert-personas/expert-role-template.schemas.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-role-template.schemas.js +1 -2
- package/dist/esm/_core/expert-personas/expert-role-template.schemas.js.map +1 -1
- package/dist/esm/_core/family-aspects.registry.d.ts.map +1 -1
- package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -1
- package/dist/esm/_core/family-aspects.schemas.js.map +1 -1
- package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +9 -9
- package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/capability-map-output-set-validation.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/capability-map-output-set.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.js.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.js +17 -4
- package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.js.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts-validation.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/flows-actors-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/frontend-component-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/full-custom-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/guidance-flow-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/index.d.ts +1 -0
- package/dist/esm/_core/index.d.ts.map +1 -1
- package/dist/esm/_core/index.js +1 -0
- package/dist/esm/_core/index.js.map +1 -1
- package/dist/esm/_core/market/feature-benefit.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/inherit-from.d.ts.map +1 -1
- package/dist/esm/_core/market/is-benefit-available.d.ts.map +1 -1
- package/dist/esm/_core/market/market-alternative.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-buying-journey.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-category.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-channel.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-context-block.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-gain.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-icp.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-job.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-message-template.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-objection.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-pain.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-persona.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-positioning.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-proof.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-scoring.d.ts.map +1 -1
- package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +18 -18
- package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-snapshot-generation.schemas.js +5 -40
- package/dist/esm/_core/market/market-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-snapshot-validation.d.ts +15 -0
- package/dist/esm/_core/market/market-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/market/market-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/market/market-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-tone-of-voice.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-trigger.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/milestone-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/onboarding-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js +11 -5
- package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts +72 -9
- package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-validation.js +68 -20
- package/dist/esm/_core/placement-plan/placement-plan-validation.js.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts +12 -5
- package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.js +12 -5
- package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
- package/dist/esm/_core/product-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/provider-specification.schemas.d.ts +98 -0
- package/dist/esm/_core/provider-specification.schemas.d.ts.map +1 -0
- package/dist/esm/_core/provider-specification.schemas.js +124 -0
- package/dist/esm/_core/provider-specification.schemas.js.map +1 -0
- package/dist/esm/_core/required-features-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/functional-requirement.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/non-functional-requirement.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js +13 -8
- package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts +15 -0
- package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/resource-specification-registry-alignment.d.ts.map +1 -1
- package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/resource-type-member-name.types.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-phase.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js +7 -2
- package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-validation.d.ts +15 -0
- package/dist/esm/_core/roadmap/roadmap-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap.family-aspects.d.ts.map +1 -1
- package/dist/esm/_core/role-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/sidebar-section-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/system-email-template-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/translation-slot-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/utils/extract-field-specs.d.ts.map +1 -1
- package/dist/esm/_core/utils/family-ref-stamping.d.ts +64 -0
- package/dist/esm/_core/utils/family-ref-stamping.d.ts.map +1 -0
- package/dist/esm/_core/utils/family-ref-stamping.js +73 -0
- package/dist/esm/_core/utils/family-ref-stamping.js.map +1 -0
- package/dist/esm/_core/utils/retention-marker-field-specs.d.ts.map +1 -1
- package/dist/esm/_core/utils/validate-field-shapes.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-authored-metadata.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-constraint.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-idea.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-mission.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-problem.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-references.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-snapshot-generation.schemas.js +23 -9
- package/dist/esm/_core/vision/vision-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/vision/vision-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-success-criterion.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision.family-aspects.d.ts.map +1 -1
- package/dist/esm/application-creation/application-coding-tasks.application-creation.schemas.d.ts +0 -4
- package/dist/esm/application-creation/application-coding-tasks.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +7 -7
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +6 -7
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.d.ts +3 -3
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js +3 -3
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts +2 -2
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js +2 -2
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/document-facts.family-aspects.d.ts.map +1 -1
- package/dist/esm/application-creation/document-release-policy.family-aspects.d.ts.map +1 -1
- package/dist/esm/application-creation/domain-plan-evaluation-identities.application-creation.definitions.d.ts.map +1 -1
- package/dist/esm/application-creation/journey.application-creation.schemas.d.ts +18 -6
- package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/journey.application-creation.schemas.js +18 -6
- package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +16 -23
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js +65 -27
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/specification-content-validation-state.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation-playbook-runtime.exports.d.ts.map +1 -1
- package/dist/esm/application-creation.exports.d.ts.map +1 -1
- package/dist/esm/assurance/application-document-publication.schemas.d.ts +20 -6
- package/dist/esm/assurance/application-document-publication.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/application-document-publication.schemas.js +26 -10
- package/dist/esm/assurance/application-document-publication.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +83 -49
- package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.js +194 -60
- package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +25 -0
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts +30 -0
- package/dist/esm/assurance/assurance-document-blueprint-selection.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-blueprint-selection.js +40 -0
- package/dist/esm/assurance/assurance-document-blueprint-selection.js.map +1 -1
- package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts +49 -0
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts.map +1 -0
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js +2832 -0
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -0
- package/dist/esm/assurance/assurance-external-framework-mapping.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-foundation.schemas.d.ts +43 -0
- package/dist/esm/assurance/assurance-foundation.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-foundation.schemas.js +56 -0
- package/dist/esm/assurance/assurance-foundation.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts +44 -7
- package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js +64 -7
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +8 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.js +10 -2
- package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-program.family-aspects.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.d.ts +463 -11
- package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.js +301 -5
- package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-sources.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts +35 -0
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts.map +1 -0
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js +1028 -0
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -0
- package/dist/esm/assurance/document-publication.family-aspects.d.ts.map +1 -1
- package/dist/esm/assurance.exports.d.ts.map +1 -1
- package/dist/esm/companion-exports.d.ts +7 -6
- package/dist/esm/companion-exports.d.ts.map +1 -1
- package/dist/esm/companion-exports.js.map +1 -1
- package/dist/esm/engine/_bootstrap.d.ts.map +1 -1
- package/dist/esm/engine/_bootstrap.js +3 -1
- package/dist/esm/engine/_bootstrap.js.map +1 -1
- package/dist/esm/engine/applications/index.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +13 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts +2 -0
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +14 -2
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +9 -9
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.js +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/auth/index.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts +47 -0
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js +355 -0
- package/dist/esm/engine/auth/resources/application-access-grants.resource.specification.js.map +1 -0
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js +3 -3
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/index.d.ts +1 -0
- package/dist/esm/engine/auth/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/index.js +1 -0
- package/dist/esm/engine/auth/resources/index.js.map +1 -1
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +1 -1
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +13 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts +2 -0
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +14 -2
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts +32 -0
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js +308 -0
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -0
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +4 -4
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +2 -2
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +6 -6
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +9 -9
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js +2 -2
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts +9 -25
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +112 -10
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts +2 -6
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts +32 -0
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js +297 -0
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js.map +1 -0
- package/dist/esm/engine/billing/index.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +4 -3
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/billing-api-reference-examples.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js +2 -2
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +3 -3
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/prices.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/prices.resource.specification.js +7 -7
- package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/products.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/products.resource.specification.js +7 -7
- package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/promotions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/promotions.resource.specification.js +14 -12
- package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/referrals.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/referrals.resource.specification.js +7 -7
- package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +6 -3
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts +7 -3
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +28 -11
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
- package/dist/esm/engine/compliance/index.d.ts.map +1 -1
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts +69 -0
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js +316 -0
- package/dist/esm/engine/compliance/resources/application-audit-logs.resource.specification.js.map +1 -0
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +8 -8
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
- package/dist/esm/engine/compliance/resources/index.d.ts +1 -0
- package/dist/esm/engine/compliance/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/compliance/resources/index.js +1 -0
- package/dist/esm/engine/compliance/resources/index.js.map +1 -1
- package/dist/esm/engine/engine-resource-specifications.registry.d.ts +2 -2
- package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
- package/dist/esm/engine/engine-resource-specifications.registry.js +10 -2
- package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
- package/dist/esm/engine/engine-resource-sub-domain.d.ts +20 -0
- package/dist/esm/engine/engine-resource-sub-domain.d.ts.map +1 -1
- package/dist/esm/engine/engine-resource-sub-domain.js +66 -0
- package/dist/esm/engine/engine-resource-sub-domain.js.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.js +33 -0
- package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
- package/dist/esm/engine/errors/index.d.ts.map +1 -1
- package/dist/esm/engine/features/_engine-feature-shared.d.ts.map +1 -1
- package/dist/esm/engine/features/advanced-analytics.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/audit-logs.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/audit-logs.feature.specification.js +4 -4
- package/dist/esm/engine/features/audit-logs.feature.specification.js.map +1 -1
- package/dist/esm/engine/features/core-limits.feature.specifications.d.ts.map +1 -1
- package/dist/esm/engine/features/core-limits.feature.specifications.js +7 -7
- package/dist/esm/engine/features/core-limits.feature.specifications.js.map +1 -1
- package/dist/esm/engine/features/custom-branding.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/directory-provisioning.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/index.d.ts.map +1 -1
- package/dist/esm/engine/features/m2m-webhook-delivery.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/application-features.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/application-features.resource.specification.js +3 -3
- package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/organization-features.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/organization-features.resource.specification.js +3 -3
- package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/resources/user-features.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/resources/user-features.resource.specification.js +3 -3
- package/dist/esm/engine/features/resources/user-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/security-event-export.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/features/single-sign-on.feature.specification.d.ts.map +1 -1
- package/dist/esm/engine/files/index.d.ts.map +1 -1
- package/dist/esm/engine/files/resources/files.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/files/resources/files.resource.specification.js +11 -11
- package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
- package/dist/esm/engine/files/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js +11 -11
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +4 -4
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +2 -2
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/action-bar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/action-button.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/button-group-separator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/button-group-text.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/button-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/actions/button.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-artifact-list.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-artifact.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-code-block.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-image.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/artifacts/ai-web-preview.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-conversation.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-message.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-prompt-input.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-sources.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-suggestion.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/chat/ai-suggestions.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-queue.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-approval-request.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-decision-request.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/decision/ai-human-input-request.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/execution/ai-confirmation.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/execution/ai-queue.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/execution/ai-task.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/execution/ai-tool.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-canvas.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-connection.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-controls.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-edge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-node.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-panel.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/graph/ai-toolbar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-capabilities.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-card.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-list.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-agent-prompt-spec.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-context.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-model-selector.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/meta/ai-open-in-chat.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/shared/ai-loader.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/shared/ai-shimmer.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/trace/ai-chain-of-thought.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/trace/ai-checkpoint.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/trace/ai-inline-citation.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/trace/ai-plan.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/ai-elements/trace/ai-reasoning.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-appearance-settings.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts +5 -0
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts.map +1 -0
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js +81 -0
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js.map +1 -0
- package/dist/esm/engine/frontend-components/app/app-layout-error-boundary.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-home.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-invitations-settings.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-main-container.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-router-error-boundary.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-settings-hub.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layouts-test-component.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/lifecycle-home-activation-progress.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/lifecycle-home-dashboard.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/lifecycle-home-welcome-back.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.d.ts +4 -0
- package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.d.ts.map +1 -0
- package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.js +22 -0
- package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.js.map +1 -0
- package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/public-layout-static-content-container.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/app/public-layout-terms.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/admin-config/app-page-security-settings.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-auth-callback.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-enrollment-required.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-magic-link-verify.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-mfa-challenge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-oauth-consent.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-oauth-logged-out.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-oauth-logout-confirm.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-one-off-session.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-user-auth.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-user-confirm-email.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-user-invitation.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-user-password-lost.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/auth/public-layout-user-register.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-invoice-history.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-portal-link.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-pricing-table.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-subscription-status.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/billing/billing-usage-dashboard.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/avatar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/badge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/description-details.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/description-list.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/description-term.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/_display-field-spec.factory.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-bigdecimal.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-boolean.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-code.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-date.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-datetime.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-duration.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-enum.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-audio.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-document.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-gallery.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-image.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file-video.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-file.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-foreign-key.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-money.extra-props.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-money.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-number.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-phone.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-bigdecimal.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-date.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-datetime.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-money.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-number.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-range-time.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-string.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/formatters/display-field-time.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/data-display/notification-indicator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/celebration-overlay.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/danger-zone.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/empty-state.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/error-display.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/features/feature-limit-indicator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/features/feature-lock-badge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/features/feature-unavailable-dialog.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/features/feature-unavailable-prompt.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/loading-overlay.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/loading-spinner.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/operations-confirm-critical.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/progress.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/skeleton.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/feedback/toast.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-actor.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-agent-config.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-approval.frontend-component.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-artifact-browser.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-decision.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-plan.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-execution-stream.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-flow-execution.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-flow-node.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-system-catalog.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-task-detail.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/flows-actors/low-level-ai-task-memory.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/_framework-layout-form-field-spec.factory.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/_low-level-preset-wrapper-spec.factory.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/autosave-indicator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-content.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-description.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-error.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-label.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-separator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field-title.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/field.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-control.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-description.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-field.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-item.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-label.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-message.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/chromes/form-root.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/combobox-multiple.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/combobox.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/boolean/checkbox.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/boolean/switch.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/boolean/toggle-group-boolean.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/boolean/toggle.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/calendar-day-button.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/calendar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/date-range-picker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/datepicker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-picker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/datetime-range-picker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/time-picker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/date-time/time-range-picker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/enum/radio-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/enum/radio-item.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/enum/select-multiple.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/enum/select.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/enum/toggle-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/file/file-upload.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/file/image-crop.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group-addon.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group-button.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group-input.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group-text.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group-textarea.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/input.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/number/range-slider.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/number/slider.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/string/color-input.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/string/input-otp.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/string/markdown-editor.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/string/password-input.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/controls/string/textarea.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-bigdecimal.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-boolean.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-code.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-date.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-datetime.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-duration.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-enum.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-file.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-money.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-number.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-phone.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-bigdecimal.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-date.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-datetime.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-money.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-number.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-range-time.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-string.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/fields/form-field-time.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/form/form-field-foreign-key.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-announcement.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-badge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-banner.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-card.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-checklist-item.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-checklist.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-modal.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-onboarding-view.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-survey.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-tooltip.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/guidance/guidance-tour.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/chart-echarts.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/chart-widget.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-chart.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-composite.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-execution.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-flows-actors.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-full-custom.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/high-level-views/high-level-views-not-found.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/index.d.ts +0 -2
- package/dist/esm/engine/frontend-components/index.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/index.js +4 -6
- package/dist/esm/engine/frontend-components/index.js.map +1 -1
- package/dist/esm/engine/frontend-components/internal/_tier2-virtual-slot-spec.factory.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/aspect-ratio.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/carousel.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/divider.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/resizable-panel-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/scroll-area.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout/separator.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section-container.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section-group.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section-legend.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout-internals/low-level-content-section.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/layout-internals/low-level-overlay-container.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/activity-bar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/command-menu.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/control-panel.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/menubar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/navigation-back.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/notification-center.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/quick-action-button.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/quick-switcher.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/sidebar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/status-bar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/toolbar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/user-dropdown.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/app-level/utility-panel.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/breadcrumb.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/command.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/menu-bar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/navbar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/navigation/sidebar.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/containers/alert-dialog.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/containers/alert.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/containers/dialog.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/containers/drawer.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/containers/sheet.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/floating/context-menu.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/floating/dropdown-menu.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/floating/hover-card.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/floating/popover.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/overlays/floating/tooltip.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/progression/progression-achievement-badge.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/progression/progression-milestone-tracker.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/_framework-layout-resource-layout-spec.factory.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-action.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-breadcrumb.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-container-dialogs.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-container-nested.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-create.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-danger-zone.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-empty-state.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-filters.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-header.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-list-table.frontend-component.preset-specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-list.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-operation-bulk.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-operations-items.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-pagination.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-read-expandable.frontend-component.preset-specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-read-summary-table-row.frontend-component.preset-specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-read-summary.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-read.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-search-table.frontend-component.preset-specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-search.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resource-layout-update.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-display.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit-search.frontend-component.preset-specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/resources/resources-fields-resource-reference-edit.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/accordion.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/card.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/collapsible.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/pagination.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/stacked-layout.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/stepper.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/table.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/sections/tabs.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/code.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/heading.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/label.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/link.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/strong.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/subheading.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/text-link.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/typography/text.frontend-component.specification.d.ts.map +1 -1
- package/dist/esm/engine/full-custom-views/index.d.ts.map +1 -1
- package/dist/esm/engine/guidance/index.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js +12 -12
- package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js +9 -9
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts +8 -0
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js +6 -6
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/index.d.ts +1 -0
- package/dist/esm/engine/index.d.ts.map +1 -1
- package/dist/esm/engine/index.js +1 -0
- package/dist/esm/engine/index.js.map +1 -1
- package/dist/esm/engine/infrastructure/index.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +17 -17
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +7 -7
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js +8 -8
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts +7 -2
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +10 -5
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/index.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +20 -15
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js +11 -10
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +29 -6
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/system-emails/authentication.system-emails.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/system-emails/index.d.ts.map +1 -1
- package/dist/esm/engine/notifications/system-emails/organization.system-emails.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/system-emails/security.system-emails.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/system-emails/subscription.system-emails.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/index.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +9 -9
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js +3 -3
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js +4 -4
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +2 -2
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-units.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +7 -7
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
- package/dist/esm/engine/providers/_engine-provider-shared.d.ts +9 -0
- package/dist/esm/engine/providers/_engine-provider-shared.d.ts.map +1 -0
- package/dist/esm/engine/providers/_engine-provider-shared.js +19 -0
- package/dist/esm/engine/providers/_engine-provider-shared.js.map +1 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.js +42 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/apple.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/apple.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/apple.provider.specification.js +44 -0
- package/dist/esm/engine/providers/apple.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/email-preview.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/email-preview.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/email-preview.provider.specification.js +39 -0
- package/dist/esm/engine/providers/email-preview.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/github.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/github.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/github.provider.specification.js +39 -0
- package/dist/esm/engine/providers/github.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/google.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/google.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/google.provider.specification.js +43 -0
- package/dist/esm/engine/providers/google.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/grok.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/grok.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/grok.provider.specification.js +39 -0
- package/dist/esm/engine/providers/grok.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/index.d.ts +23 -0
- package/dist/esm/engine/providers/index.d.ts.map +1 -0
- package/dist/esm/engine/providers/index.js +37 -0
- package/dist/esm/engine/providers/index.js.map +1 -0
- package/dist/esm/engine/providers/microsoft.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/microsoft.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/microsoft.provider.specification.js +39 -0
- package/dist/esm/engine/providers/microsoft.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/mistral.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/mistral.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/mistral.provider.specification.js +42 -0
- package/dist/esm/engine/providers/mistral.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/openai.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/openai.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/openai.provider.specification.js +52 -0
- package/dist/esm/engine/providers/openai.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/opencode.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/opencode.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/opencode.provider.specification.js +58 -0
- package/dist/esm/engine/providers/opencode.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/perplexity.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/perplexity.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/perplexity.provider.specification.js +39 -0
- package/dist/esm/engine/providers/perplexity.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/resend.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/resend.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/resend.provider.specification.js +42 -0
- package/dist/esm/engine/providers/resend.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/stripe.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/stripe.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/stripe.provider.specification.js +44 -0
- package/dist/esm/engine/providers/stripe.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/twilio.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/twilio.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/twilio.provider.specification.js +42 -0
- package/dist/esm/engine/providers/twilio.provider.specification.js.map +1 -0
- package/dist/esm/engine/roles/_engine-role-shared.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-admin-billing-manager.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-admin-marketing-editor.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-admin-super-admin.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-admin-viewer.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-anonymous.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-public.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/app-user.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/index.d.ts.map +1 -1
- package/dist/esm/engine/roles/org-admin.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/org-guest.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/org-manager.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/org-member.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/roles/org-owner.role.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/index.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/anonymous-users.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js +7 -7
- package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +9 -9
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/index.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/self-service-user-notifications.shared.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.js +2 -2
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +8 -8
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences-api-reference.examples.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +4 -4
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +4 -4
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +2 -2
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +4 -4
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +13 -11
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js +1 -1
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-self.resource.specification.js +9 -9
- package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/users-api-reference.examples.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/users.resource.specification.js +93 -0
- package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
- package/dist/esm/index.d.ts.map +1 -1
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +95 -45
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-api-reference-targets.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-assets.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-capture.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-common.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-environment-identity.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-evidence.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-lifecycle.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-publication.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts +37 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.js +36 -0
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.js.map +1 -1
- package/dist/esm/technical-documentation.exports.d.ts.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +8 -8
- package/dist/assurance/external-framework-mapping.json +0 -980
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.d.ts +0 -4
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.d.ts.map +0 -1
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.js +0 -21
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.js.map +0 -1
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.d.ts +0 -4
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.d.ts.map +0 -1
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.js +0 -21
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.js.map +0 -1
|
@@ -100,7 +100,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
100
100
|
[FileStorageAccepted.WILDO_MANAGED]: { meaning: 'Managed object storage (S3-compatible) selected by the platform default configuration.' },
|
|
101
101
|
[FileStorageAccepted.LOCAL_DIRECTORY]: { meaning: 'Local filesystem directory for development or air-gapped single-node installs.' },
|
|
102
102
|
[FileStorageAccepted.ONEDRIVE]: { meaning: 'Optional Microsoft OneDrive-backed storage when an app enables the connector.' },
|
|
103
|
-
[FileStorageAccepted.GOOGLE_DRIVE]: { meaning: '
|
|
103
|
+
[FileStorageAccepted.GOOGLE_DRIVE]: { meaning: 'Google Drive-backed storage: the bytes stay in the Drive of the person who linked (via the Drive picker) or uploaded the file, and are read through that person\'s delegated grant — never an application credential. Deleting the row forgets the reference and leaves the file in their Drive.' },
|
|
104
104
|
[FileStorageAccepted.DROPBOX]: { meaning: 'Optional Dropbox-backed storage when an app enables the connector.' },
|
|
105
105
|
},
|
|
106
106
|
}),
|
|
@@ -119,7 +119,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
119
119
|
semanticRole: 'uri',
|
|
120
120
|
}),
|
|
121
121
|
status: schemaShape.status.enumSpec({
|
|
122
|
-
meaning: 'Lifecycle state for upload, AV, linkage, and deletion. Text extraction/indexing state is NOT here — it lives on the per-field RAG chunk
|
|
122
|
+
meaning: 'Lifecycle state for upload, AV, linkage, and deletion. Text extraction/indexing state is NOT here — it lives on the per-field RAG chunk records.',
|
|
123
123
|
importance: FieldSemanticImportance.PRIMARY,
|
|
124
124
|
enumDeclaration: {
|
|
125
125
|
packageName: '@wildo-ai/saas-models',
|
|
@@ -128,12 +128,12 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
128
128
|
declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
|
|
129
129
|
},
|
|
130
130
|
values: {
|
|
131
|
-
[FileStatus.PENDING]: { meaning: 'Upload not finished — metadata
|
|
131
|
+
[FileStatus.PENDING]: { meaning: 'Upload not finished — metadata record exists, bytes not ready yet.' },
|
|
132
132
|
[FileStatus.UPLOADED]: { meaning: 'Bytes are stored and ready for post-processing or linking.' },
|
|
133
133
|
[FileStatus.LINKED]: { meaning: 'Bound to a parent resource’s `z_file()` field; primary happy path for production assets.' },
|
|
134
134
|
[FileStatus.DELETED]: { meaning: 'Soft-deleted; bytes may still exist until vacuum jobs run.' },
|
|
135
135
|
[FileStatus.ORPHANED]: { meaning: 'No live parent link — retained for re-link or background cleanup only.' },
|
|
136
|
-
[FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this
|
|
136
|
+
[FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this record.' },
|
|
137
137
|
[FileStatus.SCANNING]: { meaning: 'AV pipeline is running before download is allowed in hardened tenants.' },
|
|
138
138
|
[FileStatus.CLEAN]: { meaning: 'AV says the payload is not malicious.' },
|
|
139
139
|
[FileStatus.INFECTED]: { meaning: 'Quarantine candidate — do not serve for download.' },
|
|
@@ -177,7 +177,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
177
177
|
semanticRole: 'code',
|
|
178
178
|
}),
|
|
179
179
|
primaryScope: schemaShape.primaryScope.enumSpec({
|
|
180
|
-
meaning: 'Which isolation bucket this
|
|
180
|
+
meaning: 'Which isolation bucket this record participates in: app-wide, org-wide, or user-private (within an org).',
|
|
181
181
|
whyItMatters: 'Field is optional at rest until an upload binds scope identifiers; `FileSchema` superRefine enforces consistency between `primaryScope` and the id triple.',
|
|
182
182
|
enumDeclaration: {
|
|
183
183
|
packageName: '@wildo-ai/saas-models',
|
|
@@ -200,11 +200,11 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
200
200
|
semanticRole: 'identifier',
|
|
201
201
|
}),
|
|
202
202
|
userId: schemaShape.userId.stringSpec({
|
|
203
|
-
meaning: 'User id for `USER_SELF` scoped file
|
|
203
|
+
meaning: 'User id for `USER_SELF` scoped file records, paired with `organizationId` as required by `validateFileScopeIdentifiers`.',
|
|
204
204
|
semanticRole: 'identifier',
|
|
205
205
|
}),
|
|
206
206
|
uploadedBy: schemaShape.uploadedBy.stringSpec({
|
|
207
|
-
meaning: 'Raw uploader id when the uploader is not necessarily a Wildo `users`
|
|
207
|
+
meaning: 'Raw uploader id when the uploader is not necessarily a Wildo `users` record (service principal, system job, …).',
|
|
208
208
|
semanticRole: 'identifier',
|
|
209
209
|
}),
|
|
210
210
|
uploadedByEntityType: schemaShape.uploadedByEntityType.enumSpec({
|
|
@@ -243,7 +243,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
243
243
|
whenToUse: 'Use in server-side `FilesBackendService` flows — not exposed to anonymous callers for arbitrary ids.',
|
|
244
244
|
importance: FieldSemanticImportance.PRIMARY,
|
|
245
245
|
responseStatuses: [
|
|
246
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The file metadata
|
|
246
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The file metadata record for the supplied `fileId` was found and its storage pointers, lifecycle `status`, and `linkedResource*` fields are returned.' },
|
|
247
247
|
],
|
|
248
248
|
errorScenarios: [
|
|
249
249
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (never created, or already hard-deleted after soft-delete vacuum).' },
|
|
@@ -256,7 +256,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
256
256
|
outcome: 'Background jobs and admin UIs can page through the storage ledger under org/app isolation.',
|
|
257
257
|
whenToUse: 'Use in cleanup jobs, quota dashboards, or when syncing CDN metadata for the tenant.',
|
|
258
258
|
responseStatuses: [
|
|
259
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of file metadata
|
|
259
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of file metadata records matching the uploader / linkage / scope filters under org/app isolation.' },
|
|
260
260
|
],
|
|
261
261
|
errorScenarios: [
|
|
262
262
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the role required to page the storage ledger for the requested scope.' },
|
|
@@ -269,7 +269,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
269
269
|
whenToUse: 'Use on upload start or completion events before linking to a parent resource’s `z_file()` slot.',
|
|
270
270
|
importance: FieldSemanticImportance.PRIMARY,
|
|
271
271
|
responseStatuses: [
|
|
272
|
-
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'A file metadata
|
|
272
|
+
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'A file metadata record was materialized with its server-assigned `fileId` and initial `PENDING`/`UPLOADED` status. Internal/service write path — `FilesBackendService` drives this from upload flows, not a public CRUD controller.' },
|
|
273
273
|
],
|
|
274
274
|
errorScenarios: [
|
|
275
275
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The upload metadata fails validation — a disallowed `mimeType`, a `size` over the configured per-scope upload limit (over-size is surfaced here, not as a transport-level 413), or scope ids inconsistent with `primaryScope` per `validateFileScopeIdentifiers`.', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -305,7 +305,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
305
305
|
whenToUse: 'Use in workers and trusted services; users never mutate this row ad hoc in consumer APIs.',
|
|
306
306
|
importance: FieldSemanticImportance.PRIMARY,
|
|
307
307
|
responseStatuses: [
|
|
308
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The metadata patch (lifecycle `status`, `linkedResource*`, `size`, storage pointers, or media analytics) was applied and the updated
|
|
308
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The metadata patch (lifecycle `status`, `linkedResource*`, `size`, storage pointers, or media analytics) was applied and the updated record is returned. Internal/service write path owned by workers and trusted services.' },
|
|
309
309
|
],
|
|
310
310
|
errorScenarios: [
|
|
311
311
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` to patch.' },
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"files.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/files/resources/files.resource.specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AACpE,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,UAAU,EACV,UAAU,EACV,gDAAgD,EAChD,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAE3E,MAAM,CAAC,MAAM,0BAA0B,GAAG,qBAAqB,CAC7D,gDAAgD,EAChD,UAAU,EACV,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;IACpB,OAAO,EAAE,2HAA2H;IACpI,YAAY,EAAE,+HAA+H;IAC7I,aAAa,EAAE,4JAA4J;IAC3K,QAAQ,EAAE,aAAa,CAAC,QAAQ;IAChC,SAAS,EAAE,uBAAuB,CAAC,KAAK;IACxC,YAAY,EAAE;QACZ,UAAU,EAAE;YACV,WAAW,EAAE,uBAAuB;YACpC,UAAU,EAAE,YAAY;YACxB,UAAU,EAAE,cAAc,CAAC,MAAM;YACjC,eAAe,EAAE,mBAAmB,CAAC,UAAU;SAChD;QACD,eAAe,EAAE;YACf,WAAW,EAAE,uBAAuB;YACpC,UAAU,EAAE,kDAAkD;YAC9D,UAAU,EAAE,cAAc,CAAC,OAAO;YAClC,eAAe,EAAE,mBAAmB,CAAC,QAAQ;SAC9C;QACD,YAAY,EAAE;YACZ,eAAe,EAAE;gBACf,WAAW,EAAE,uBAAuB;gBACpC,UAAU,EAAE,kBAAkB;gBAC9B,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,UAAU,EAAE,OAAO;SACpB;QACD,mBAAmB,EAAE;YACnB,QAAQ,EAAE;gBACR,WAAW,EAAE,uBAAuB;gBACpC,UAAU,EAAE,uBAAuB;gBACnC,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;SACF;QACD,KAAK,EAAE;YACL,kJAAkJ;YAClJ,6OAA6O;SAC9O;KACF;IAED,MAAM,EAAE;QACN,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC;YACpC,OAAO,EAAE,mSAAmS;YAC5S,YAAY,EAAE,mQAAmQ;YACjR,YAAY,EAAE,YAAY;YAC1B,UAAU,EAAE,uBAAuB,CAAC,OAAO;SAC5C,CAAC;QAEF,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;YACxC,OAAO,EAAE,qDAAqD;YAC9D,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,YAAY,EAAE,OAAO;SACtB,CAAC;QAEF,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC;YACxD,OAAO,EAAE,0EAA0E;YACnF,YAAY,EAAE,OAAO;SACtB,CAAC;QAEF,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;YACxC,OAAO,EAAE,+EAA+E;YACxF,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC;YAChC,OAAO,EAAE,0DAA0D;YACnE,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,uBAAuB,CAAC,OAAO;SAC5C,CAAC;QAEF,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC;YAC1C,OAAO,EAAE,qFAAqF;YAC9F,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC;YACxC,OAAO,EAAE,4EAA4E;YACrF,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC;YACpD,OAAO,EAAE,6EAA6E;YACtF,eAAe,EAAE;gBACf,WAAW,EAAE,0BAA0B;gBACvC,UAAU,EAAE,qBAAqB;gBACjC,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,MAAM,EAAE;gBACN,CAAC,mBAAmB,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,wFAAwF,EAAE;gBAC1I,CAAC,mBAAmB,CAAC,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,gFAAgF,EAAE;gBACpI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,+EAA+E,EAAE;gBAC5H,CAAC,mBAAmB,CAAC,YAAY,CAAC,EAAE,EAAE,OAAO,EAAE,yEAAyE,EAAE;gBAC1H,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,oEAAoE,EAAE;aACjH;SACF,CAAC;QAEF,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC;YAC5C,OAAO,EAAE,yGAAyG;YAClH,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC;YAC5C,OAAO,EAAE,wQAAwQ;YACjR,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC;YAC9B,OAAO,EAAE,mGAAmG;YAC5G,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;YAClC,OAAO,EAAE,+IAA+I;YACxJ,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,eAAe,EAAE;gBACf,WAAW,EAAE,uBAAuB;gBACpC,UAAU,EAAE,YAAY;gBACxB,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,MAAM,EAAE;gBACN,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,iEAAiE,EAAE;gBACpG,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,4DAA4D,EAAE;gBAChG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,0FAA0F,EAAE;gBAC5H,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,4DAA4D,EAAE;gBAC/F,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,wEAAwE,EAAE;gBAC5G,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,OAAO,EAAE,yDAAyD,EAAE;gBAC3F,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,wEAAwE,EAAE;gBAC5G,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE;gBACxE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,mDAAmD,EAAE;gBACvF,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,2DAA2D,EAAE;aACnG;SACF,CAAC;QAEF,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;YAClC,OAAO,EAAE,oHAAoH;YAC7H,eAAe,EAAE;gBACf,WAAW,EAAE,0BAA0B;gBACvC,UAAU,EAAE,mBAAmB;gBAC/B,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,MAAM,EAAE;gBACN,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,oEAAoE,EAAE;gBAC5G,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,wEAAwE,EAAE;gBAChH,CAAC,iBAAiB,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE;gBAClF,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,uDAAuD,EAAE;gBAClG,CAAC,iBAAiB,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,EAAE,+DAA+D,EAAE;aAC1G;SACF,CAAC;QAEF,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;QAC3F,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;QAC9F,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,0DAA0D,EAAE,CAAC;QAClH,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,8EAA8E,EAAE,CAAC;QAExI,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,UAAU,CAAC;YAChD,OAAO,EAAE,mEAAmE;YAC5E,YAAY,EAAE,KAAK;SACpB,CAAC;QAEF,kBAAkB,EAAE,WAAW,CAAC,kBAAkB,CAAC,UAAU,CAAC;YAC5D,OAAO,EAAE,uGAAuG;YAChH,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,gBAAgB,EAAE,WAAW,CAAC,gBAAgB,CAAC,UAAU,CAAC;YACxD,OAAO,EAAE,iEAAiE;YAC1E,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC,UAAU,CAAC;YACtD,OAAO,EAAE,kFAAkF;YAC3F,YAAY,EAAE,MAAM;SACrB,CAAC;QAEF,YAAY,EAAE,WAAW,CAAC,YAAY,CAAC,QAAQ,CAAC;YAC9C,OAAO,EAAE,uGAAuG;YAChH,YAAY,EACV,4JAA4J;YAC9J,eAAe,EAAE;gBACf,WAAW,EAAE,uBAAuB;gBACpC,UAAU,EAAE,sBAAsB;gBAClC,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,MAAM,EAAE;gBACN,CAAC,oBAAoB,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,8EAA8E,EAAE;gBAC/H,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,qDAAqD,EAAE;gBACxG,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,EAAE,OAAO,EAAE,yGAAyG,EAAE;aACzJ;SACF,CAAC;QAEF,aAAa,EAAE,WAAW,CAAC,aAAa,CAAC,UAAU,CAAC;YAClD,OAAO,EAAE,6DAA6D;YACtE,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,cAAc,EAAE,WAAW,CAAC,cAAc,CAAC,UAAU,CAAC;YACpD,OAAO,EAAE,0EAA0E;YACnF,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC;YACpC,OAAO,EAAE,uHAAuH;YAChI,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC;YAC5C,OAAO,EAAE,8GAA8G;YACvH,YAAY,EAAE,YAAY;SAC3B,CAAC;QAEF,oBAAoB,EAAE,WAAW,CAAC,oBAAoB,CAAC,QAAQ,CAAC;YAC9D,OAAO,EAAE,2GAA2G;YACpH,eAAe,EAAE;gBACf,WAAW,EAAE,0BAA0B;gBACvC,UAAU,EAAE,wBAAwB;gBACpC,UAAU,EAAE,cAAc,CAAC,IAAI;gBAC/B,eAAe,EAAE,mBAAmB,CAAC,eAAe;aACrD;YACD,MAAM,EAAE;gBACN,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,uDAAuD,EAAE;gBACnG,CAAC,sBAAsB,CAAC,cAAc,CAAC,EAAE,EAAE,OAAO,EAAE,0EAA0E,EAAE;gBAChI,CAAC,sBAAsB,CAAC,oBAAoB,CAAC,EAAE,EAAE,OAAO,EAAE,0KAA0K,EAAE;gBACtO,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,EAAE,EAAE,OAAO,EAAE,4KAA4K,EAAE;aACxO;SACF,CAAC;QAEF,UAAU,EAAE,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC;YAC1C,OAAO,EAAE,oDAAoD;YAC7D,YAAY,EAAE,UAAU;YACxB,UAAU,EAAE,uBAAuB,CAAC,OAAO;SAC5C,CAAC;QAEF,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC;YACxC,OAAO,EAAE,oGAAoG;YAC7G,YAAY,EAAE,UAAU;SACzB,CAAC;QAEF,SAAS,EAAE,WAAW,CAAC,SAAS,CAAC,QAAQ,CAAC;YACxC,OAAO,EAAE,8EAA8E;YACvF,YAAY,EAAE,UAAU;SACzB,CAAC;KACH;IAED,UAAU,EAAE;QACV,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;YACT,OAAO,EAAE,+FAA+F;YACxG,OAAO,EAAE,sGAAsG;YAC/G,SAAS,EAAE,sGAAsG;YACjH,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,gBAAgB,EAAE;gBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,oJAAoJ,EAAE;aACvM;YACD,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,0HAA0H,EAAE;gBAChL,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,mMAAmM,EAAE;aAC1P;YACD,UAAU,EAAE,IAAI;SACjB;QAED,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE;YACT,OAAO,EAAE,2FAA2F;YACpG,OAAO,EAAE,4FAA4F;YACrG,SAAS,EAAE,qFAAqF;YAChG,gBAAgB,EAAE;gBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,wHAAwH,EAAE;aAC3K;YACD,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,wFAAwF,EAAE;aAC/I;YACD,UAAU,EAAE,IAAI;SACjB;QAED,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACX,OAAO,EAAE,2NAA2N;YACpO,OAAO,EAAE,yGAAyG;YAClH,SAAS,EAAE,iGAAiG;YAC5G,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,gBAAgB,EAAE;gBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,WAAW,EAAE,OAAO,EAAE,kOAAkO,EAAE;aAC1R;YACD,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,eAAe,EAAE,IAAI,EAAE,mQAAmQ,EAAE,SAAS,EAAE,mBAAmB,EAAE;gBAC3V,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,uGAAuG,EAAE;aAC9J;YACD,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE;gBACR;oBACE,KAAK,EAAE,wCAAwC;oBAC/C,OAAO,EAAE;wBACP,QAAQ,EAAE,mBAAmB;wBAC7B,QAAQ,EAAE,iBAAiB;wBAC3B,IAAI,EAAE,MAAM;wBACZ,YAAY,EAAE,oBAAoB,CAAC,aAAa;wBAChD,cAAc,EAAE,YAAY;qBAC7B;oBACD,QAAQ,EAAE;wBACR,MAAM,EAAE,aAAa;wBACrB,QAAQ,EAAE,mBAAmB;wBAC7B,QAAQ,EAAE,iBAAiB;wBAC3B,IAAI,EAAE,MAAM;wBACZ,MAAM,EAAE,UAAU,CAAC,OAAO;wBAC1B,YAAY,EAAE,oBAAoB,CAAC,aAAa;qBACjD;oBACD,SAAS,EAAE,sBAAsB,CAAC,WAAW;iBAC9C;aACF;YACD,aAAa,EAAE,6JAA6J;SAC7K;QAED,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACX,OAAO,EAAE,wHAAwH;YACjI,OAAO,EAAE,yHAAyH;YAClI,SAAS,EAAE,2FAA2F;YACtG,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,gBAAgB,EAAE;gBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,0NAA0N,EAAE;aAC7Q;YACD,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,iEAAiE,EAAE;gBACvH,EAAE,IAAI,EAAE,sBAAsB,CAAC,eAAe,EAAE,IAAI,EAAE,+HAA+H,EAAE,SAAS,EAAE,mBAAmB,EAAE;gBACvN,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,8GAA8G,EAAE;aACrK;YACD,UAAU,EAAE,IAAI;SACjB;QAED,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE;YACX,OAAO,EAAE,iFAAiF;YAC1F,OAAO,EAAE,wGAAwG;YACjH,SAAS,EAAE,yGAAyG;YACpH,UAAU,EAAE,uBAAuB,CAAC,OAAO;YAC3C,gBAAgB,EAAE;gBAChB,EAAE,IAAI,EAAE,sBAAsB,CAAC,cAAc,EAAE,OAAO,EAAE,yLAAyL,EAAE;aACpP;YACD,cAAc,EAAE;gBACd,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,oFAAoF,EAAE;gBAC1I,EAAE,IAAI,EAAE,sBAAsB,CAAC,aAAa,EAAE,IAAI,EAAE,kEAAkE,EAAE;aACzH;YACD,UAAU,EAAE,IAAI;SACjB;KACF;IAED,mBAAmB,EAAE;QACnB,gfAAgf;QAChf,oNAAoN;KACrN;CACF,CAAC;AACF,sEAAsE;AACtE,0EAA0E;AAC1E,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,wEAAwE;AACxE,2EAA2E;AAC3E,SAAS;AACT,EAAE,oBAAoB,EAAE,oBAAoB,CAAC,WAAW,EAAE,CAC3D,CAAC","sourcesContent":["/**\n * Resource: `files` — Wildo SaaS engine specification (backend-only).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/files/files.shared.schemas.ts → `FileSchema`\n * - Factory: engine/saas-models/src/files/files.shared.resources-config.schemas.ts\n * → `filesResourceConfiguration_InitializationFactory`\n * - Custom operations: none\n * - UI presets: none\n */\n\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n FileDisplayNature,\n FileStorageAccepted,\n FileUploaderEntityType,\n} from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n FileSchema,\n FileStatus,\n filesResourceConfiguration_InitializationFactory,\n ResourcePrimaryScope,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\nexport const filesResourceSpecification = resourceSpecification(\n filesResourceConfiguration_InitializationFactory,\n FileSchema,\n ({ schemaShape }) => ({\n purpose: 'Store file metadata (name, MIME, storage pointers, lifecycle, and scope) for assets managed by the platform file service.',\n businessRole: 'The shared “file row” truth that links uploaded bytes in object storage to domain resources through `linkedResource*` fields.',\n lifecycleRole: 'Moves from `PENDING` upload through `UPLOADED`, optional AV / extraction states, linking to business records, and eventual `DELETED` / `ORPHANED` cleanup.',\n audience: LabelAudience.END_USER,\n subDomain: EngineResourceSubDomain.FILES,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'filesResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'FILES',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'Repository-only resource: all operations are `REPOSITORY_ONLY` — `FilesBackendService` is the intended entry point, not public CRUD controllers.',\n 'Per-record `primaryScope` + scope id fields can represent APPLICATION, ORGANIZATIONS, or USER_SELF rows; the resource-level `resourcePrimaryScope` declared here is the registry default for the FILES type, not every row’s dynamic scope.',\n ],\n },\n\n fields: {\n fileId: schemaShape.fileId.stringSpec({\n meaning: 'Stable public identifier for this file metadata document, embedded in storage keys and download URLs. It is a virtual projection of the document’s underlying Mongo `_id` (`fileId === String(_id)`), so the file has a single stored identity and there is no separate persisted `fileId` field.',\n whyItMatters: 'This is the identifier other resources store in `z_file()` fields and that presigned URL flows reference. Because it projects `_id`, the value is allocated by the database at insert time rather than minted before the row exists, so creation is insert-first.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n filename: schemaShape.filename.stringSpec({\n meaning: 'Sanitized filename used in UI and download headers.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'label',\n }),\n\n originalFilename: schemaShape.originalFilename.stringSpec({\n meaning: 'Original client-provided filename before sanitization for audit/support.',\n semanticRole: 'label',\n }),\n\n mimeType: schemaShape.mimeType.stringSpec({\n meaning: 'IANA-style MIME classification for validation, AV routing, and viewer choice.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n size: schemaShape.size.numberSpec({\n meaning: 'Byte length of the stored object after upload completes.',\n unit: 'bytes',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n extension: schemaShape.extension.stringSpec({\n meaning: 'Filename extension snapshot (without dot) for quick filtering when MIME is generic.',\n semanticRole: 'code',\n }),\n\n checksum: schemaShape.checksum.stringSpec({\n meaning: 'Optional content hash for deduplication and integrity checks after upload.',\n semanticRole: 'code',\n }),\n\n storageProvider: schemaShape.storageProvider.enumSpec({\n meaning: 'Which registered storage backend (S3-compatible, local, …) holds the bytes.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileStorageAccepted',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStorageAccepted.WILDO_MANAGED]: { meaning: 'Managed object storage (S3-compatible) selected by the platform default configuration.' },\n [FileStorageAccepted.LOCAL_DIRECTORY]: { meaning: 'Local filesystem directory for development or air-gapped single-node installs.' },\n [FileStorageAccepted.ONEDRIVE]: { meaning: 'Optional Microsoft OneDrive-backed storage when an app enables the connector.' },\n [FileStorageAccepted.GOOGLE_DRIVE]: { meaning: 'Optional Google Drive-backed storage when an app enables the connector.' },\n [FileStorageAccepted.DROPBOX]: { meaning: 'Optional Dropbox-backed storage when an app enables the connector.' },\n },\n }),\n\n storageRef: schemaShape.storageRef.stringSpec({\n meaning: 'Opaque handle the active storage adapter uses to retrieve bytes (bucket/key tuple is adapter-specific).',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'identifier',\n }),\n\n storageKey: schemaShape.storageKey.stringSpec({\n meaning: 'Derived, human-debuggable key encoding the scope path (`app/...`, `org/...`, `user/...`) and `fileId`, used in logs and migrations. Because it depends on the database-assigned `fileId`, it is populated immediately after insert and is optional at rest until then.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n url: schemaShape.url.stringSpec({\n meaning: 'Cached HTTP(S) URL when a long-lived public or CDN URL is available (may be presigned elsewhere).',\n semanticRole: 'uri',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Lifecycle state for upload, AV, linkage, and deletion. Text extraction/indexing state is NOT here — it lives on the per-field RAG chunk rows.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStatus.PENDING]: { meaning: 'Upload not finished — metadata row exists, bytes not ready yet.' },\n [FileStatus.UPLOADED]: { meaning: 'Bytes are stored and ready for post-processing or linking.' },\n [FileStatus.LINKED]: { meaning: 'Bound to a parent resource’s `z_file()` field; primary happy path for production assets.' },\n [FileStatus.DELETED]: { meaning: 'Soft-deleted; bytes may still exist until vacuum jobs run.' },\n [FileStatus.ORPHANED]: { meaning: 'No live parent link — retained for re-link or background cleanup only.' },\n [FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this row.' },\n [FileStatus.SCANNING]: { meaning: 'AV pipeline is running before download is allowed in hardened tenants.' },\n [FileStatus.CLEAN]: { meaning: 'AV says the payload is not malicious.' },\n [FileStatus.INFECTED]: { meaning: 'Quarantine candidate — do not serve for download.' },\n [FileStatus.QUARANTINED]: { meaning: 'Isolated for operator review; download blocked by policy.' },\n },\n }),\n\n nature: schemaShape.nature.enumSpec({\n meaning: 'Resolved high-level file kind (image / video / document) used for template selection, not raw MIME subtypes alone.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileDisplayNature',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileDisplayNature.IMAGE]: { meaning: 'Raster/vector still asset suitable for lightbox and thumbnail UIs.' },\n [FileDisplayNature.VIDEO]: { meaning: 'Time-based media; shows duration and streaming-friendly player chrome.' },\n [FileDisplayNature.AUDIO]: { meaning: 'Sound-only media with duration metadata.' },\n [FileDisplayNature.DOCUMENT]: { meaning: 'Text-first assets such as office/PDF/structured docs.' },\n [FileDisplayNature.GENERIC]: { meaning: 'Fallback bucket when a generic download affordance is enough.' },\n },\n }),\n\n width: schemaShape.width.numberSpec({ meaning: 'Image/video width in pixels when known.' }),\n height: schemaShape.height.numberSpec({ meaning: 'Image/video height in pixels when known.' }),\n duration: schemaShape.duration.numberSpec({ meaning: 'Audio/video length in seconds when analyzers provide it.' }),\n pageCount: schemaShape.pageCount.numberSpec({ meaning: 'Page count for paginated document previews when the analyzer could infer it.' }),\n\n thumbnailUrl: schemaShape.thumbnailUrl.stringSpec({\n meaning: 'Optional derived thumbnail or poster frame URL for list/grid UIs.',\n semanticRole: 'uri',\n }),\n\n linkedResourceType: schemaShape.linkedResourceType.stringSpec({\n meaning: 'When linked, the `CoreResourceType` (string form) of the parent record carrying the `z_file()` field.',\n semanticRole: 'code',\n }),\n\n linkedResourceId: schemaShape.linkedResourceId.stringSpec({\n meaning: 'Primary id of the parent resource using this file, when linked.',\n semanticRole: 'identifier',\n }),\n\n linkedFieldName: schemaShape.linkedFieldName.stringSpec({\n meaning: 'Field name on the parent schema (e.g. `avatarId`) to support multi-file parents.',\n semanticRole: 'code',\n }),\n\n primaryScope: schemaShape.primaryScope.enumSpec({\n meaning: 'Which isolation bucket this row participates in: app-wide, org-wide, or user-private (within an org).',\n whyItMatters:\n 'Field is optional at rest until an upload binds scope identifiers; `FileSchema` superRefine enforces consistency between `primaryScope` and the id triple.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ResourcePrimaryScope',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ResourcePrimaryScope.APPLICATION]: { meaning: 'App-wide marketing/branding or singleton assets (uses `applicationId` only).' },\n [ResourcePrimaryScope.ORGANIZATIONS]: { meaning: 'Shared within a tenant; uses `organizationId` only.' },\n [ResourcePrimaryScope.USER_SELF]: { meaning: 'Private to a user, but still in org context; requires `organizationId` + `userId` per file scope rules.' },\n },\n }),\n\n applicationId: schemaShape.applicationId.stringSpec({\n meaning: 'Parent application id when `primaryScope` is `APPLICATION`.',\n semanticRole: 'identifier',\n }),\n\n organizationId: schemaShape.organizationId.stringSpec({\n meaning: 'Org id for org-scoped files and as local context for user-private files.',\n semanticRole: 'identifier',\n }),\n\n userId: schemaShape.userId.stringSpec({\n meaning: 'User id for `USER_SELF` scoped file rows, paired with `organizationId` as required by `validateFileScopeIdentifiers`.',\n semanticRole: 'identifier',\n }),\n\n uploadedBy: schemaShape.uploadedBy.stringSpec({\n meaning: 'Raw uploader id when the uploader is not necessarily a Wildo `users` row (service principal, system job, …).',\n semanticRole: 'identifier',\n }),\n\n uploadedByEntityType: schemaShape.uploadedByEntityType.enumSpec({\n meaning: 'What kind of principal `uploadedBy` references so hydration code can disambiguate cross-entity uploaders.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileUploaderEntityType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileUploaderEntityType.USER]: { meaning: 'Uploader is a people identity from the `users` table.' },\n [FileUploaderEntityType.ANONYMOUS_USER]: { meaning: 'Uploader is an anonymous marketing-site session before account creation.' },\n [FileUploaderEntityType.ORGANIZATION_MACHINE]: { meaning: 'Uploader is an org-scoped MACHINE principal (M2M automation) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n [FileUploaderEntityType.APPLICATION_MACHINE]: { meaning: 'Uploader is an app-scoped MACHINE principal (integration jobs) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n },\n }),\n\n uploadedAt: schemaShape.uploadedAt.dateSpec({\n meaning: 'When the file bytes finished uploading to storage.',\n temporalRole: 'occurred',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'Last time metadata or link state on this document changed (excluding every storage adapter retry).',\n temporalRole: 'modified',\n }),\n\n deletedAt: schemaShape.deletedAt.dateSpec({\n meaning: 'When the file entered a soft-deleted / tombstone state for background purge.',\n temporalRole: 'occurred',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Resolve a single `File` row, usually when issuing download authorization or parent hydration.',\n outcome: 'Callers can trust storage pointers, status, and linkage fields before streaming bytes to the client.',\n whenToUse: 'Use in server-side `FilesBackendService` flows — not exposed to anonymous callers for arbitrary ids.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The file metadata row for the supplied `fileId` was found and its storage pointers, lifecycle `status`, and `linkedResource*` fields are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (never created, or already hard-deleted after soft-delete vacuum).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized for the row’s scope — download authorization must still re-check the parent `z_file()` ACL; this row alone is not a permission boundary (see `businessConstraints`).' },\n ],\n idempotent: true,\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate file rows filtered by uploader, parent linkage, or scope in repository queries.',\n outcome: 'Background jobs and admin UIs can page through the storage ledger under org/app isolation.',\n whenToUse: 'Use in cleanup jobs, quota dashboards, or when syncing CDN metadata for the tenant.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of file metadata rows matching the uploader / linkage / scope filters under org/app isolation.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the role required to page the storage ledger for the requested scope.' },\n ],\n idempotent: true,\n },\n\n [Op.CREATE]: {\n purpose: 'Materialize a new metadata document for an upload flow; the database assigns the row’s identity (`_id`, projected as `fileId`) at insert, so the row — and its `fileId` — can be created before or after the bytes exist.',\n outcome: 'The system gets a first-class file row that can track upload progress, checksums, and eventual linking.',\n whenToUse: 'Use on upload start or completion events before linking to a parent resource’s `z_file()` slot.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A file metadata row was materialized with its server-assigned `fileId` and initial `PENDING`/`UPLOADED` status. Internal/service write path — `FilesBackendService` drives this from upload flows, not a public CRUD controller.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The upload metadata fails validation — a disallowed `mimeType`, a `size` over the configured per-scope upload limit (over-size is surfaced here, not as a transport-level 413), or scope ids inconsistent with `primaryScope` per `validateFileScopeIdentifiers`.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to upload into the requested scope (org/app/user-self isolation bucket).' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Materialize a file row on upload start',\n request: {\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n organizationId: 'org_01HX2…',\n },\n response: {\n fileId: 'file_01HX2…',\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n status: FileStatus.PENDING,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n rateLimitNote: 'Upload materialization is the hot path for client file submissions; throttle per uploader/scope to bound abusive bulk-upload bursts against object storage.',\n },\n\n [Op.UPDATE]: {\n purpose: 'Patch metadata (status, linkage, size, storage pointers, media analytics) as upload/analyze/link/cleanup events occur.',\n outcome: 'The row stays synchronized with object storage, AV/extraction, and the parent business record that references the file.',\n whenToUse: 'Use in workers and trusted services; users never mutate this row ad hoc in consumer APIs.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The metadata patch (lifecycle `status`, `linkedResource*`, `size`, storage pointers, or media analytics) was applied and the updated row is returned. Internal/service write path owned by workers and trusted services.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` to patch.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patch fails validation (e.g. an illegal `status` transition or a `linkedResource*` triple that breaks scope consistency).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A consumer caller attempts to mutate the row ad hoc — only workers and trusted services patch file metadata.' },\n ],\n idempotent: true,\n },\n\n [Op.DELETE]: {\n purpose: 'Mark or remove file metadata in coordination with object-storage deletion jobs.',\n outcome: 'The platform can enforce retention, GDPR erasure, and org teardown without orphan metadata references.',\n whenToUse: 'Use in compliance purges, org deletion, or when a business record severs a file attachment permanently.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The file metadata was soft-deleted / removed in coordination with object-storage cleanup; no body is returned. Internal/service path used in retention, GDPR erasure, and org teardown.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (or it was already deleted).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to delete files in the row’s scope.' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'FILES declares NO `persistenceAdapter` — it follows the application default, so a file-metadata row and the resource row that owns it share one store and one native transaction (the pin that used to force MongoDB here was removed by the persistence-adapter parity work). This resource is precisely the case that must NOT declare one: it is written inside cross-resource atomic boundaries by design, so it could never make the `persistenceAdapterIsolation` claim that admits a divergent adapter.',\n 'Download authorization must still re-check the parent `z_file()` access policy: this row alone is not a permission boundary; `linkedResource*` fields and scope ids must be evaluated together with resource ACLs.',\n ],\n }),\n // Scope mirrors the registry-derived value: the `APPLICATION → FILES`\n // relationship in `resources-registry.shared.core.definitions.ts` carries\n // `isPrimaryScope: true` (applicationId is propagated to every file record\n // from the execution context), so the factory derives APPLICATION. Per-org /\n // per-user containment is enforced through the `linkedResource*` fields and\n // the parent `z_file()` access policy, not through the primary scope anchor.\n // Was ORGANIZATIONS until the companion alignment guard started pairing\n // engine specs with materialized core configs (2026-07-02) and flagged the\n // drift.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
|
|
1
|
+
{"version":3,"file":"files.resource.specification.js","sourceRoot":"","sources":["../../../../../src/engine/files/resources/files.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource: `files` — Wildo SaaS engine specification (backend-only).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/files/files.shared.schemas.ts → `FileSchema`\n * - Factory: engine/saas-models/src/files/files.shared.resources-config.schemas.ts\n * → `filesResourceConfiguration_InitializationFactory`\n * - Custom operations: none\n * - UI presets: none\n */\n\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n FileDisplayNature,\n FileStorageAccepted,\n FileUploaderEntityType,\n} from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n FileSchema,\n FileStatus,\n filesResourceConfiguration_InitializationFactory,\n ResourcePrimaryScope,\n} from '@wildo-ai/saas-models';\nimport { HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\nexport const filesResourceSpecification = resourceSpecification(\n filesResourceConfiguration_InitializationFactory,\n FileSchema,\n ({ schemaShape }) => ({\n purpose: 'Store file metadata (name, MIME, storage pointers, lifecycle, and scope) for assets managed by the platform file service.',\n businessRole: 'The shared “file row” truth that links uploaded bytes in object storage to domain resources through `linkedResource*` fields.',\n lifecycleRole: 'Moves from `PENDING` upload through `UPLOADED`, optional AV / extraction states, linking to business records, and eventual `DELETED` / `ORPHANED` cleanup.',\n audience: LabelAudience.END_USER,\n subDomain: EngineResourceSubDomain.FILES,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'filesResourceConfiguration_InitializationFactory',\n symbolKind: CodeSymbolKind.FACTORY,\n declarationKind: CodeDeclarationKind.FUNCTION,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: 'FILES',\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'Repository-only resource: all operations are `REPOSITORY_ONLY` — `FilesBackendService` is the intended entry point, not public CRUD controllers.',\n 'Per-record `primaryScope` + scope id fields can represent APPLICATION, ORGANIZATIONS, or USER_SELF rows; the resource-level `resourcePrimaryScope` declared here is the registry default for the FILES type, not every row’s dynamic scope.',\n ],\n },\n\n fields: {\n fileId: schemaShape.fileId.stringSpec({\n meaning: 'Stable public identifier for this file metadata document, embedded in storage keys and download URLs. It is a virtual projection of the document’s underlying Mongo `_id` (`fileId === String(_id)`), so the file has a single stored identity and there is no separate persisted `fileId` field.',\n whyItMatters: 'This is the identifier other resources store in `z_file()` fields and that presigned URL flows reference. Because it projects `_id`, the value is allocated by the database at insert time rather than minted before the row exists, so creation is insert-first.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n filename: schemaShape.filename.stringSpec({\n meaning: 'Sanitized filename used in UI and download headers.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'label',\n }),\n\n originalFilename: schemaShape.originalFilename.stringSpec({\n meaning: 'Original client-provided filename before sanitization for audit/support.',\n semanticRole: 'label',\n }),\n\n mimeType: schemaShape.mimeType.stringSpec({\n meaning: 'IANA-style MIME classification for validation, AV routing, and viewer choice.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n size: schemaShape.size.numberSpec({\n meaning: 'Byte length of the stored object after upload completes.',\n unit: 'bytes',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n extension: schemaShape.extension.stringSpec({\n meaning: 'Filename extension snapshot (without dot) for quick filtering when MIME is generic.',\n semanticRole: 'code',\n }),\n\n checksum: schemaShape.checksum.stringSpec({\n meaning: 'Optional content hash for deduplication and integrity checks after upload.',\n semanticRole: 'code',\n }),\n\n storageProvider: schemaShape.storageProvider.enumSpec({\n meaning: 'Which registered storage backend (S3-compatible, local, …) holds the bytes.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileStorageAccepted',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStorageAccepted.WILDO_MANAGED]: { meaning: 'Managed object storage (S3-compatible) selected by the platform default configuration.' },\n [FileStorageAccepted.LOCAL_DIRECTORY]: { meaning: 'Local filesystem directory for development or air-gapped single-node installs.' },\n [FileStorageAccepted.ONEDRIVE]: { meaning: 'Optional Microsoft OneDrive-backed storage when an app enables the connector.' },\n [FileStorageAccepted.GOOGLE_DRIVE]: { meaning: 'Google Drive-backed storage: the bytes stay in the Drive of the person who linked (via the Drive picker) or uploaded the file, and are read through that person\\'s delegated grant — never an application credential. Deleting the row forgets the reference and leaves the file in their Drive.' },\n [FileStorageAccepted.DROPBOX]: { meaning: 'Optional Dropbox-backed storage when an app enables the connector.' },\n },\n }),\n\n storageRef: schemaShape.storageRef.stringSpec({\n meaning: 'Opaque handle the active storage adapter uses to retrieve bytes (bucket/key tuple is adapter-specific).',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'identifier',\n }),\n\n storageKey: schemaShape.storageKey.stringSpec({\n meaning: 'Derived, human-debuggable key encoding the scope path (`app/...`, `org/...`, `user/...`) and `fileId`, used in logs and migrations. Because it depends on the database-assigned `fileId`, it is populated immediately after insert and is optional at rest until then.',\n importance: FieldSemanticImportance.PRIMARY,\n semanticRole: 'code',\n }),\n\n url: schemaShape.url.stringSpec({\n meaning: 'Cached HTTP(S) URL when a long-lived public or CDN URL is available (may be presigned elsewhere).',\n semanticRole: 'uri',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Lifecycle state for upload, AV, linkage, and deletion. Text extraction/indexing state is NOT here — it lives on the per-field RAG chunk records.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'FileStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileStatus.PENDING]: { meaning: 'Upload not finished — metadata record exists, bytes not ready yet.' },\n [FileStatus.UPLOADED]: { meaning: 'Bytes are stored and ready for post-processing or linking.' },\n [FileStatus.LINKED]: { meaning: 'Bound to a parent resource’s `z_file()` field; primary happy path for production assets.' },\n [FileStatus.DELETED]: { meaning: 'Soft-deleted; bytes may still exist until vacuum jobs run.' },\n [FileStatus.ORPHANED]: { meaning: 'No live parent link — retained for re-link or background cleanup only.' },\n [FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this record.' },\n [FileStatus.SCANNING]: { meaning: 'AV pipeline is running before download is allowed in hardened tenants.' },\n [FileStatus.CLEAN]: { meaning: 'AV says the payload is not malicious.' },\n [FileStatus.INFECTED]: { meaning: 'Quarantine candidate — do not serve for download.' },\n [FileStatus.QUARANTINED]: { meaning: 'Isolated for operator review; download blocked by policy.' },\n },\n }),\n\n nature: schemaShape.nature.enumSpec({\n meaning: 'Resolved high-level file kind (image / video / document) used for template selection, not raw MIME subtypes alone.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileDisplayNature',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileDisplayNature.IMAGE]: { meaning: 'Raster/vector still asset suitable for lightbox and thumbnail UIs.' },\n [FileDisplayNature.VIDEO]: { meaning: 'Time-based media; shows duration and streaming-friendly player chrome.' },\n [FileDisplayNature.AUDIO]: { meaning: 'Sound-only media with duration metadata.' },\n [FileDisplayNature.DOCUMENT]: { meaning: 'Text-first assets such as office/PDF/structured docs.' },\n [FileDisplayNature.GENERIC]: { meaning: 'Fallback bucket when a generic download affordance is enough.' },\n },\n }),\n\n width: schemaShape.width.numberSpec({ meaning: 'Image/video width in pixels when known.' }),\n height: schemaShape.height.numberSpec({ meaning: 'Image/video height in pixels when known.' }),\n duration: schemaShape.duration.numberSpec({ meaning: 'Audio/video length in seconds when analyzers provide it.' }),\n pageCount: schemaShape.pageCount.numberSpec({ meaning: 'Page count for paginated document previews when the analyzer could infer it.' }),\n\n thumbnailUrl: schemaShape.thumbnailUrl.stringSpec({\n meaning: 'Optional derived thumbnail or poster frame URL for list/grid UIs.',\n semanticRole: 'uri',\n }),\n\n linkedResourceType: schemaShape.linkedResourceType.stringSpec({\n meaning: 'When linked, the `CoreResourceType` (string form) of the parent record carrying the `z_file()` field.',\n semanticRole: 'code',\n }),\n\n linkedResourceId: schemaShape.linkedResourceId.stringSpec({\n meaning: 'Primary id of the parent resource using this file, when linked.',\n semanticRole: 'identifier',\n }),\n\n linkedFieldName: schemaShape.linkedFieldName.stringSpec({\n meaning: 'Field name on the parent schema (e.g. `avatarId`) to support multi-file parents.',\n semanticRole: 'code',\n }),\n\n primaryScope: schemaShape.primaryScope.enumSpec({\n meaning: 'Which isolation bucket this record participates in: app-wide, org-wide, or user-private (within an org).',\n whyItMatters:\n 'Field is optional at rest until an upload binds scope identifiers; `FileSchema` superRefine enforces consistency between `primaryScope` and the id triple.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'ResourcePrimaryScope',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [ResourcePrimaryScope.APPLICATION]: { meaning: 'App-wide marketing/branding or singleton assets (uses `applicationId` only).' },\n [ResourcePrimaryScope.ORGANIZATIONS]: { meaning: 'Shared within a tenant; uses `organizationId` only.' },\n [ResourcePrimaryScope.USER_SELF]: { meaning: 'Private to a user, but still in org context; requires `organizationId` + `userId` per file scope rules.' },\n },\n }),\n\n applicationId: schemaShape.applicationId.stringSpec({\n meaning: 'Parent application id when `primaryScope` is `APPLICATION`.',\n semanticRole: 'identifier',\n }),\n\n organizationId: schemaShape.organizationId.stringSpec({\n meaning: 'Org id for org-scoped files and as local context for user-private files.',\n semanticRole: 'identifier',\n }),\n\n userId: schemaShape.userId.stringSpec({\n meaning: 'User id for `USER_SELF` scoped file records, paired with `organizationId` as required by `validateFileScopeIdentifiers`.',\n semanticRole: 'identifier',\n }),\n\n uploadedBy: schemaShape.uploadedBy.stringSpec({\n meaning: 'Raw uploader id when the uploader is not necessarily a Wildo `users` record (service principal, system job, …).',\n semanticRole: 'identifier',\n }),\n\n uploadedByEntityType: schemaShape.uploadedByEntityType.enumSpec({\n meaning: 'What kind of principal `uploadedBy` references so hydration code can disambiguate cross-entity uploaders.',\n enumDeclaration: {\n packageName: '@wildo-ai/zod-decorators',\n exportName: 'FileUploaderEntityType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [FileUploaderEntityType.USER]: { meaning: 'Uploader is a people identity from the `users` table.' },\n [FileUploaderEntityType.ANONYMOUS_USER]: { meaning: 'Uploader is an anonymous marketing-site session before account creation.' },\n [FileUploaderEntityType.ORGANIZATION_MACHINE]: { meaning: 'Uploader is an org-scoped MACHINE principal (M2M automation) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n [FileUploaderEntityType.APPLICATION_MACHINE]: { meaning: 'Uploader is an app-scoped MACHINE principal (integration jobs) — an api-key OR an OAuth client; the specific credential kind + id are on `initiatorIds.machineCredential`.' },\n },\n }),\n\n uploadedAt: schemaShape.uploadedAt.dateSpec({\n meaning: 'When the file bytes finished uploading to storage.',\n temporalRole: 'occurred',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n updatedAt: schemaShape.updatedAt.dateSpec({\n meaning: 'Last time metadata or link state on this document changed (excluding every storage adapter retry).',\n temporalRole: 'modified',\n }),\n\n deletedAt: schemaShape.deletedAt.dateSpec({\n meaning: 'When the file entered a soft-deleted / tombstone state for background purge.',\n temporalRole: 'occurred',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Resolve a single `File` row, usually when issuing download authorization or parent hydration.',\n outcome: 'Callers can trust storage pointers, status, and linkage fields before streaming bytes to the client.',\n whenToUse: 'Use in server-side `FilesBackendService` flows — not exposed to anonymous callers for arbitrary ids.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The file metadata record for the supplied `fileId` was found and its storage pointers, lifecycle `status`, and `linkedResource*` fields are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (never created, or already hard-deleted after soft-delete vacuum).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized for the row’s scope — download authorization must still re-check the parent `z_file()` ACL; this row alone is not a permission boundary (see `businessConstraints`).' },\n ],\n idempotent: true,\n },\n\n [Op.LIST]: {\n purpose: 'Enumerate file rows filtered by uploader, parent linkage, or scope in repository queries.',\n outcome: 'Background jobs and admin UIs can page through the storage ledger under org/app isolation.',\n whenToUse: 'Use in cleanup jobs, quota dashboards, or when syncing CDN metadata for the tenant.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of file metadata records matching the uploader / linkage / scope filters under org/app isolation.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the role required to page the storage ledger for the requested scope.' },\n ],\n idempotent: true,\n },\n\n [Op.CREATE]: {\n purpose: 'Materialize a new metadata document for an upload flow; the database assigns the row’s identity (`_id`, projected as `fileId`) at insert, so the row — and its `fileId` — can be created before or after the bytes exist.',\n outcome: 'The system gets a first-class file row that can track upload progress, checksums, and eventual linking.',\n whenToUse: 'Use on upload start or completion events before linking to a parent resource’s `z_file()` slot.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A file metadata record was materialized with its server-assigned `fileId` and initial `PENDING`/`UPLOADED` status. Internal/service write path — `FilesBackendService` drives this from upload flows, not a public CRUD controller.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The upload metadata fails validation — a disallowed `mimeType`, a `size` over the configured per-scope upload limit (over-size is surfaced here, not as a transport-level 413), or scope ids inconsistent with `primaryScope` per `validateFileScopeIdentifiers`.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to upload into the requested scope (org/app/user-self isolation bucket).' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Materialize a file row on upload start',\n request: {\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n organizationId: 'org_01HX2…',\n },\n response: {\n fileId: 'file_01HX2…',\n filename: 'release-notes.pdf',\n mimeType: 'application/pdf',\n size: 248213,\n status: FileStatus.PENDING,\n primaryScope: ResourcePrimaryScope.ORGANIZATIONS,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n rateLimitNote: 'Upload materialization is the hot path for client file submissions; throttle per uploader/scope to bound abusive bulk-upload bursts against object storage.',\n },\n\n [Op.UPDATE]: {\n purpose: 'Patch metadata (status, linkage, size, storage pointers, media analytics) as upload/analyze/link/cleanup events occur.',\n outcome: 'The row stays synchronized with object storage, AV/extraction, and the parent business record that references the file.',\n whenToUse: 'Use in workers and trusted services; users never mutate this row ad hoc in consumer APIs.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The metadata patch (lifecycle `status`, `linkedResource*`, `size`, storage pointers, or media analytics) was applied and the updated record is returned. Internal/service write path owned by workers and trusted services.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` to patch.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patch fails validation (e.g. an illegal `status` transition or a `linkedResource*` triple that breaks scope consistency).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'A consumer caller attempts to mutate the row ad hoc — only workers and trusted services patch file metadata.' },\n ],\n idempotent: true,\n },\n\n [Op.DELETE]: {\n purpose: 'Mark or remove file metadata in coordination with object-storage deletion jobs.',\n outcome: 'The platform can enforce retention, GDPR erasure, and org teardown without orphan metadata references.',\n whenToUse: 'Use in compliance purges, org deletion, or when a business record severs a file attachment permanently.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The file metadata was soft-deleted / removed in coordination with object-storage cleanup; no body is returned. Internal/service path used in retention, GDPR erasure, and org teardown.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No file metadata row exists for the supplied `fileId` (or it was already deleted).' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to delete files in the row’s scope.' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'FILES declares NO `persistenceAdapter` — it follows the application default, so a file-metadata row and the resource row that owns it share one store and one native transaction (the pin that used to force MongoDB here was removed by the persistence-adapter parity work). This resource is precisely the case that must NOT declare one: it is written inside cross-resource atomic boundaries by design, so it could never make the `persistenceAdapterIsolation` claim that admits a divergent adapter.',\n 'Download authorization must still re-check the parent `z_file()` access policy: this row alone is not a permission boundary; `linkedResource*` fields and scope ids must be evaluated together with resource ACLs.',\n ],\n }),\n // Scope mirrors the registry-derived value: the `APPLICATION → FILES`\n // relationship in `resources-registry.shared.core.definitions.ts` carries\n // `isPrimaryScope: true` (applicationId is propagated to every file record\n // from the execution context), so the factory derives APPLICATION. Per-org /\n // per-user containment is enforced through the `linkedResource*` fields and\n // the parent `z_file()` access policy, not through the primary scope anchor.\n // Was ORGANIZATIONS until the companion alignment guard started pairing\n // engine specs with materialized core configs (2026-07-02) and flagged the\n // drift.\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/engine/files/resources/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC"}
|
package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"a2a-push-delivery-log.resource.specification.d.ts","sourceRoot":"","sources":["
|
|
1
|
+
{"version":3,"file":"a2a-push-delivery-log.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,qBAAqB,EACrB,qBAAqB,IAAI,EAAE,EAI5B,MAAM,uBAAuB,CAAC;AA+gB/B,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;;;;iCAGvD,CAAC;AAEF,eAAO,MAAM,mDAAmD;;;;;;;;;;;;;;;;;;;;iCAG/D,CAAC;AAEF,eAAO,MAAM,kDAAkD;;;;;;;;;;;;;;;;;;;;iCAG9D,CAAC"}
|
package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js
CHANGED
|
@@ -166,12 +166,12 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
166
166
|
},
|
|
167
167
|
fields: {
|
|
168
168
|
_id: schemaShape._id.stringSpec({
|
|
169
|
-
meaning: 'Document id of this delivery
|
|
169
|
+
meaning: 'Document id of this delivery record.',
|
|
170
170
|
semanticRole: 'identifier',
|
|
171
171
|
importance: FieldSemanticImportance.PRIMARY,
|
|
172
172
|
}),
|
|
173
173
|
deliveryId: schemaShape.deliveryId.stringSpec({
|
|
174
|
-
meaning: 'Stable identity of this delivery, generated once when the
|
|
174
|
+
meaning: 'Stable identity of this delivery, generated once when the record is opened and sent with every attempt.',
|
|
175
175
|
whyItMatters: 'It is what makes duplicates RECOGNISABLE to the receiver. §4.3.3 asks clients to process notifications idempotently, which they can only do if a retry is identifiable as the same delivery — hence generated at row creation, never per attempt.',
|
|
176
176
|
semanticRole: 'identifier',
|
|
177
177
|
importance: FieldSemanticImportance.PRIMARY,
|
|
@@ -183,7 +183,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
183
183
|
importance: FieldSemanticImportance.PRIMARY,
|
|
184
184
|
}),
|
|
185
185
|
pushNotificationConfigId: schemaShape.pushNotificationConfigId.stringSpec({
|
|
186
|
-
meaning: 'Which registered webhook configuration this
|
|
186
|
+
meaning: 'Which registered webhook configuration this record delivers to — a task may carry several.',
|
|
187
187
|
whyItMatters: 'Distinguishes "one of my endpoints is broken" from "notifications are broken", which are different incidents with different owners.',
|
|
188
188
|
semanticRole: 'identifier',
|
|
189
189
|
}),
|
|
@@ -217,8 +217,8 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
217
217
|
declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
|
|
218
218
|
},
|
|
219
219
|
values: {
|
|
220
|
-
[A2APushDeliveryStatus.PENDING]: { meaning: 'The
|
|
221
|
-
[A2APushDeliveryStatus.IN_FLIGHT]: { meaning: 'A worker has claimed the
|
|
220
|
+
[A2APushDeliveryStatus.PENDING]: { meaning: 'The record is open and either waiting for its first attempt or re-queued for another after a retryable failure.' },
|
|
221
|
+
[A2APushDeliveryStatus.IN_FLIGHT]: { meaning: 'A worker has claimed the record (PENDING → IN_FLIGHT compare-and-swap) and is POSTing to the webhook.' },
|
|
222
222
|
[A2APushDeliveryStatus.DELIVERED]: { meaning: 'The endpoint answered 2xx — terminal success, and the evidence that §4.3.3 delivery obligation was met.' },
|
|
223
223
|
[A2APushDeliveryStatus.FAILED]: { meaning: 'Terminal failure: a non-retryable response, or the §13.2 attempt budget exhausted.' },
|
|
224
224
|
},
|
|
@@ -258,7 +258,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
258
258
|
temporalRole: 'occurred',
|
|
259
259
|
}),
|
|
260
260
|
createdAt: schemaShape.createdAt.dateSpec({
|
|
261
|
-
meaning: 'When the
|
|
261
|
+
meaning: 'When the record was opened, which is BEFORE the first delivery attempt.',
|
|
262
262
|
temporalRole: 'creation',
|
|
263
263
|
}),
|
|
264
264
|
},
|
|
@@ -366,7 +366,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
366
366
|
purpose: 'Open a PENDING row for one (task transition × registered webhook), before any delivery is attempted.',
|
|
367
367
|
outcome: 'Every delivery obligation is recorded up front, so an unreachable queue leaves a visible row rather than silence.',
|
|
368
368
|
responseStatuses: [
|
|
369
|
-
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The delivery
|
|
369
|
+
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'The delivery record was opened. REPOSITORY_ONLY — a delivery record is EVIDENCE that a notification was attempted, and a caller able to author one could fabricate that evidence. The dispatcher writes it via `createAsSystem`; there is no HTTP surface at all.' },
|
|
370
370
|
],
|
|
371
371
|
errorScenarios: [
|
|
372
372
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails schema validation (e.g. a missing `deliveryId` or the injected owner FK).', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -377,7 +377,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
377
377
|
purpose: 'Advance a delivery through its lifecycle — claim it, then record the outcome.',
|
|
378
378
|
outcome: 'The row reflects what actually happened to the notification, including scheduled retries.',
|
|
379
379
|
responseStatuses: [
|
|
380
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The transition was recorded. REPOSITORY_ONLY, like CREATE: `repository.update` needs a default UPDATE operation to resolve, and exposing it would let a caller mark its own undelivered notifications as DELIVERED. The PENDING → IN_FLIGHT claim carries the prior status in its filter, so two workers racing one queue message cannot both claim the
|
|
380
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The transition was recorded. REPOSITORY_ONLY, like CREATE: `repository.update` needs a default UPDATE operation to resolve, and exposing it would let a caller mark its own undelivered notifications as DELIVERED. The PENDING → IN_FLIGHT claim carries the prior status in its filter, so two workers racing one queue message cannot both claim the record.' },
|
|
381
381
|
],
|
|
382
382
|
errorScenarios: [
|
|
383
383
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The row is gone, or another worker already claimed it — the compare-and-swap matched nothing, and the loser stops rather than sending a duplicate POST.' },
|
|
@@ -388,7 +388,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
388
388
|
purpose: 'Remove a delivery row — retention purging, and the cleanup the owning user/org/app deletion cascades to.',
|
|
389
389
|
outcome: 'Delivery evidence does not outlive the tenant it describes.',
|
|
390
390
|
responseStatuses: [
|
|
391
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The
|
|
391
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The record was removed. REPOSITORY_ONLY and deliberately NOT offered to the owner: a trail an owner can selectively erase is not a trail. The same default op powers the composition onParentDelete cascade, which runs at the repository tier below role checks.' },
|
|
392
392
|
],
|
|
393
393
|
errorScenarios: [
|
|
394
394
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No such row (already purged, or never existed).' },
|
|
@@ -399,7 +399,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
399
399
|
purpose: 'In-place scrub of retained rows when a data subject is erased.',
|
|
400
400
|
outcome: 'The delivery history survives for operational accounting while the personal data in it does not.',
|
|
401
401
|
responseStatuses: [
|
|
402
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The matching
|
|
402
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were scrubbed. INTERNAL_CALL — it registers no HTTP route, and exists because `retentionPolicy` reaches records through `updateManyAsSystem`.' },
|
|
403
403
|
],
|
|
404
404
|
errorScenarios: [
|
|
405
405
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -409,7 +409,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
409
409
|
purpose: 'Bulk removal for retention windows and owner-scope teardown.',
|
|
410
410
|
outcome: 'Delivery history is bounded without a per-row round trip.',
|
|
411
411
|
responseStatuses: [
|
|
412
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The matching
|
|
412
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were removed. REPOSITORY_ONLY, the bulk twin of DELETE and restricted for the same reason.' },
|
|
413
413
|
],
|
|
414
414
|
errorScenarios: [
|
|
415
415
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },
|
package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"a2a-push-delivery-log.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n A2APushDeliveryLogSchema,\n A2APushDeliveryStatus,\n CoreResourceOperation as Op,\n CoreResourceType,\n ResourcePrimaryScope,\n a2aPushDeliveryLogPolymorphicFactories,\n} from '@wildo-ai/saas-models';\nimport { type CoreResourceTypeMemberName, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for the `a2aPushDeliveryLog` POLYMORPHIC family: the durable\n * EVIDENCE that the agent attempted to notify a client's webhook when one of its Agent2Agent (A2A)\n * tasks changed state. One base envelope is stamped out as three variants, each owned by its\n * injected owner FK — mirroring the task resource's scope set exactly:\n * - `userA2aPushDeliveryLog` (USER_SELF — user-delegated A2A turns)\n * - `organizationA2aPushDeliveryLog` (ORGANIZATIONS — org-machine A2A turns)\n * - `applicationA2aPushDeliveryLog` (APPLICATION — app-machine A2A turns)\n *\n * A row is opened per (task transition × registered webhook) BEFORE the delivery is attempted, and\n * that ordering is the reason the resource exists at all: were the row created by the worker on its\n * first attempt, an unreachable queue would leave no trace, and an operator would see silence —\n * which is indistinguishable from \"no webhook was configured\". Writing first means there is always\n * one row per obligation, including the deliveries that never got as far as being tried.\n *\n * spec-cite: A2A 1.0 §4.3.3 — *\"Agents MUST attempt delivery at least once for each configured\n * webhook\"* — and §13.2, which asks for retry with exponential backoff and permits abandoning after\n * a configured number of consecutive failures. This row is where all three become CHECKABLE rather\n * than asserted.\n *\n * SIBLING, NOT A VARIANT, of `m2mWebhookDeliveryLog`. The two share a delivery PATTERN — row first,\n * one queue job per row, a worker that classifies and retries — and even the transport primitive.\n * What they do not share is a SCOPE SET: the M2M log is stamped out for ORGANIZATIONS and\n * APPLICATION only, while an A2A task can be owned by a USER, which is the ORDINARY case for a\n * delegated-user caller. Extending the M2M resource would have meant adding a user-facing variant to\n * a shipped feature on behalf of a different subsystem. Keeping them apart also keeps the two\n * producers separable in every query: a resource-operation notification and a task-lifecycle\n * notification are different facts about different things.\n *\n * ONE spec covers all three variants (per the flow-actor-tasks / token-budget polymorphic precedent).\n */\n\ntype A2APushDeliveryResourceType =\n | CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG\n | CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG\n | CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG;\ntype A2APushDeliveryResourceTypeMember = CoreResourceTypeMemberName<A2APushDeliveryResourceType>;\n\nconst a2aPushDeliveryPrimaryScopeByResourceType: Record<A2APushDeliveryResourceType, ResourcePrimaryScope> = {\n [CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.USER_SELF,\n [CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.ORGANIZATIONS,\n [CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.APPLICATION,\n};\n\ninterface A2APushDeliveryScopeExample {\n readonly deliveryResourceIdentity: Readonly<Record<string, string>>;\n readonly machineCredentialIdentity: Readonly<Record<string, string>>;\n readonly scopeIdentity: Readonly<Record<string, string>>;\n /** Human-readable prose fragment for example titles, not a semantic vocabulary. */\n readonly scopeLabel: string;\n}\n\n/**\n * Projects one semantic delivery scenario onto the concrete owner and route-id\n * fields of each polymorphic resource. Keeping this mapping beside the spec\n * prevents examples for one public contract from silently leaking a sibling's\n * `userId`, `organizationId`, `applicationId`, or resource-id parameter.\n */\nfunction createA2APushDeliveryScopeExample(resourceType: A2APushDeliveryResourceType): A2APushDeliveryScopeExample {\n switch (resourceType) {\n case CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { userA2aPushDeliveryLogId: 'a2a_delivery_user_01JEXAMPLE' },\n machineCredentialIdentity: {},\n scopeIdentity: { userId: 'user_01JEXAMPLE' },\n scopeLabel: 'user',\n };\n case CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { organizationA2aPushDeliveryLogId: 'a2a_delivery_org_01JEXAMPLE' },\n machineCredentialIdentity: { machineCredentialId: 'machine_credential_org_01JEXAMPLE' },\n scopeIdentity: { organizationId: 'org_01JEXAMPLE' },\n scopeLabel: 'organization',\n };\n case CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { applicationA2aPushDeliveryLogId: 'a2a_delivery_app_01JEXAMPLE' },\n machineCredentialIdentity: { machineCredentialId: 'machine_credential_app_01JEXAMPLE' },\n scopeIdentity: { applicationId: 'app_01JEXAMPLE' },\n scopeLabel: 'application',\n };\n default: {\n const exhaustiveResourceType: never = resourceType;\n throw new Error(`Unsupported A2A push-delivery resource type: ${String(exhaustiveResourceType)}`);\n }\n }\n}\n\nfunction createA2APushDeliveryPage<T>(data: readonly T[]) {\n return {\n data,\n pagination: { page: 1, limit: 20, total: data.length, totalPages: data.length === 0 ? 0 : 1 },\n };\n}\n\ntype Cfg = ReturnType<(typeof a2aPushDeliveryLogPolymorphicFactories)[CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG]>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = typeof A2APushDeliveryLogSchema;\n\nfunction buildA2APushDeliveryLogResourceSpecification(\n resourceType: A2APushDeliveryResourceType,\n resourceTypeMemberName: A2APushDeliveryResourceTypeMember,\n) {\n const exampleScope = createA2APushDeliveryScopeExample(resourceType);\n const deliveryIdentity = {\n _id: Object.values(exampleScope.deliveryResourceIdentity)[0],\n deliveryId: 'delivery_attempt_01JEXAMPLE',\n taskId: 'task_01JEXAMPLE',\n pushNotificationConfigId: 'push_config_01JEXAMPLE',\n resourceServerInstanceRef: 'support-automation-agent',\n ...exampleScope.machineCredentialIdentity,\n httpUrl: 'https://integrations.customer.example/a2a/task-updates',\n payloadHash: 'c3e4db884cb42dd0ef818ae2ea032bdf3b45af622dbb39f9dc343b395874c8fc',\n payload: {\n statusUpdate: {\n taskId: 'task_01JEXAMPLE',\n contextId: 'support_case_INC_4821',\n status: { state: 'completed', timestamp: '2026-08-20T09:42:00.000Z' },\n final: true,\n },\n },\n createdAt: '2026-08-20T09:42:00.000Z',\n ...exampleScope.scopeIdentity,\n };\n const deliveredExample = {\n ...deliveryIdentity,\n status: A2APushDeliveryStatus.DELIVERED,\n attemptCount: 1,\n lastAttemptAt: '2026-08-20T09:42:03.000Z',\n responseStatus: 204,\n deliveredAt: '2026-08-20T09:42:03.000Z',\n };\n const retryingExample = {\n ...deliveryIdentity,\n _id: `${deliveryIdentity._id}_retrying`,\n deliveryId: 'delivery_attempt_01JRETRY',\n status: A2APushDeliveryStatus.PENDING,\n attemptCount: 2,\n lastAttemptAt: '2026-08-20T09:44:00.000Z',\n nextAttemptAt: '2026-08-20T09:49:00.000Z',\n responseStatus: 503,\n responseBodyTruncated: 'Service temporarily unavailable',\n failureReason: 'The receiver returned HTTP 503; another attempt is scheduled.',\n };\n const failedExample = {\n ...deliveryIdentity,\n _id: `${deliveryIdentity._id}_failed`,\n deliveryId: 'delivery_attempt_01JFAILED',\n status: A2APushDeliveryStatus.FAILED,\n attemptCount: 5,\n lastAttemptAt: '2026-08-20T10:02:00.000Z',\n responseStatus: 503,\n responseBodyTruncated: 'Service temporarily unavailable',\n failureReason: 'The receiver returned HTTP 503 after the final retry.',\n failedAt: '2026-08-20T10:02:00.000Z',\n };\n const pendingSummaryExample = {\n _id: `${deliveryIdentity._id}_pending`,\n deliveryId: 'delivery_attempt_01JPENDING',\n taskId: deliveryIdentity.taskId,\n pushNotificationConfigId: deliveryIdentity.pushNotificationConfigId,\n resourceServerInstanceRef: deliveryIdentity.resourceServerInstanceRef,\n status: A2APushDeliveryStatus.PENDING,\n attemptCount: 0,\n createdAt: '2026-08-20T10:10:00.000Z',\n };\n const listRequest = {\n ...exampleScope.scopeIdentity,\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n };\n\n return resourceSpecification<undefined, Core, Main>(\n a2aPushDeliveryLogPolymorphicFactories[resourceType],\n A2APushDeliveryLogSchema,\n ({ schemaShape }) => ({\n purpose: 'Record every attempt to notify a registered webhook that an A2A task changed state, so an integration owner can see whether the destination was reached.',\n businessRole: 'Operational history for diagnosing A2A push notifications by task, destination, status, attempt count, and HTTP outcome.',\n lifecycleRole: 'Created before the first delivery attempt, then progresses through pending and in-flight states to delivered or failed; retryable failures return to pending with a next-attempt time.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.FLOWS_ACTORS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'A2APushDeliveryLogSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactoryCollectionEntry: {\n collectionSymbol: { packageName: '@wildo-ai/saas-models', exportName: 'a2aPushDeliveryLogPolymorphicFactories', symbolKind: CodeSymbolKind.FACTORY },\n identifierField: 'collectionKey',\n identifierValue: resourceType,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: resourceTypeMemberName,\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'Three variants under `A2A_PUSH_DELIVERY_SCOPE_VARIANTS`, mirroring the task resource\\'s scope set exactly — an owner with no delivery-log variant is an owner whose notifications cannot be recorded.',\n 'MULTI-ROW: the declaration opts OUT of the singleton auto-business-key (`optOutPolymorphicAutoBusinessKey`) — there is one row per (task transition × registered webhook), so the owner FK is not its identity.',\n '`A2APushDeliveryStatus` is deliberately its OWN enum rather than a reuse of `M2MWebhookDeliveryLogStatus`, even though the members coincide: that enum is owned by the M2M notifications feature, and borrowing it would make either feature\\'s future state change a cross-feature edit.',\n 'Writers are `A2APushDispatcherBackendService` (opens the row) and the `a2a-push-delivery` batch worker (every status transition), both through `A2APushDeliveryLogRepository` and `*AsSystem` under this resource\\'s `systemAccessPolicy`. It follows the TASK service\\'s pattern rather than the M2M log\\'s because a push notification is triggered by `advanceTask` — a system-owned transition with no caller ExecutionContext to borrow.',\n 'CREATE and UPDATE are `INTERNAL_CALL`, which is MANDATORY rather than stylistic for a `*AsSystem` writer: those primitives dispatch through the SERVICE tier and resolve the operation via `getServiceOperationPathDefault`, which matches only INTERNAL_CALL / API_CALL variants. A REPOSITORY_ONLY default resolves to nothing and the write silently does not happen. DELETE / DELETE_MANY stay REPOSITORY_ONLY because nothing system-deletes a row — they are reached only by retention purging and the owner-scope cascade, both at the repository tier.',\n 'The webhook CREDENTIAL is never stored on a row: the worker re-resolves it from the live configuration at attempt time, so a client that rotates its credential (which §13.2 asks clients to do) does not have every queued retry keep presenting the stale one.',\n 'Runtime has no userNotifications / m2mNotifications — do not add communications.* (DF-1).',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Document id of this delivery row.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n deliveryId: schemaShape.deliveryId.stringSpec({\n meaning: 'Stable identity of this delivery, generated once when the row is opened and sent with every attempt.',\n whyItMatters: 'It is what makes duplicates RECOGNISABLE to the receiver. §4.3.3 asks clients to process notifications idempotently, which they can only do if a retry is identifiable as the same delivery — hence generated at row creation, never per attempt.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n taskId: schemaShape.taskId.stringSpec({\n meaning: 'The A2A task whose status transition triggered this notification.',\n whyItMatters: 'The join back to the work being reported on — an owner diagnosing a missed notification starts from the task they were expecting to hear about.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n pushNotificationConfigId: schemaShape.pushNotificationConfigId.stringSpec({\n meaning: 'Which registered webhook configuration this row delivers to — a task may carry several.',\n whyItMatters: 'Distinguishes \"one of my endpoints is broken\" from \"notifications are broken\", which are different incidents with different owners.',\n semanticRole: 'identifier',\n }),\n\n resourceServerInstanceRef: schemaShape.resourceServerInstanceRef.stringSpec({\n meaning: 'The named A2A agent instance the task belongs to.',\n whyItMatters: 'The isolation axis that keeps two agents of one tenant apart — the same axis the task read enforces, carried here so per-agent attribution and per-agent purging cannot reach another agent\\'s rows.',\n semanticRole: 'identifier',\n }),\n\n machineCredentialId: schemaShape.machineCredentialId.stringSpec({\n meaning: 'The machine credential that owns the task, when the caller presented one.',\n whyItMatters: 'The worker must re-read the LIVE configuration to obtain the client\\'s credential, and that read enforces all four isolation axes. Without this the read falls back to the \"no credential\" sentinel and matches nothing for any task a machine client created — which is most A2A tasks. Optional rather than sentinel-defaulted: a delegated-user task genuinely has none, and a sentinel would make \"absent\" and \"explicitly none\" the same value on a row whose whole job is to be evidence.',\n semanticRole: 'identifier',\n }),\n\n httpUrl: schemaShape.httpUrl.stringSpec({\n meaning: 'The webhook destination, captured as it was AT DISPATCH.',\n whyItMatters: 'Recorded on the row rather than read live so a later configuration edit cannot rewrite history — the evidence must say where this delivery was actually addressed. It is also why the worker POSTs to the row\\'s URL, not the configuration\\'s: honouring an edit mid-flight would redirect an in-flight notification to an address the SSRF guard approved for a different delivery.',\n semanticRole: 'uri',\n }),\n\n payloadHash: schemaShape.payloadHash.stringSpec({\n meaning: 'SHA-256 of the exact body sent, so a recorded delivery can be tied to precise bytes.',\n semanticRole: 'identifier',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Where this delivery is in its lifecycle: PENDING, IN_FLIGHT, DELIVERED or FAILED.',\n whyItMatters: 'The one field that answers \"was my integration reached?\". The PENDING → IN_FLIGHT claim is a compare-and-swap, so a duplicate queue message cannot cause a second POST to a customer endpoint.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'A2APushDeliveryStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [A2APushDeliveryStatus.PENDING]: { meaning: 'The row is open and either waiting for its first attempt or re-queued for another after a retryable failure.' },\n [A2APushDeliveryStatus.IN_FLIGHT]: { meaning: 'A worker has claimed the row (PENDING → IN_FLIGHT compare-and-swap) and is POSTing to the webhook.' },\n [A2APushDeliveryStatus.DELIVERED]: { meaning: 'The endpoint answered 2xx — terminal success, and the evidence that §4.3.3 delivery obligation was met.' },\n [A2APushDeliveryStatus.FAILED]: { meaning: 'Terminal failure: a non-retryable response, or the §13.2 attempt budget exhausted.' },\n },\n }),\n\n attemptCount: schemaShape.attemptCount.numberSpec({\n meaning: 'How many POST attempts have been made for this delivery.',\n whyItMatters: 'Bounds the retry schedule — the worker terminates the row as FAILED once the cap is reached, which is the §13.2 allowance to stop after a configured number of consecutive failures.',\n unit: 'attempts',\n }),\n\n lastAttemptAt: schemaShape.lastAttemptAt.dateSpec({\n meaning: 'When the most recent attempt was made.',\n temporalRole: 'occurred',\n }),\n\n nextAttemptAt: schemaShape.nextAttemptAt.dateSpec({\n meaning: 'When the next retry becomes eligible, under the exponential backoff schedule.',\n whyItMatters: 'Indexed — this is the field a drain query orders by, and the durable form of the backoff §13.2 asks for.',\n temporalRole: 'scheduled',\n }),\n\n responseStatus: schemaShape.responseStatus.numberSpec({\n meaning: 'The HTTP status the webhook answered with, when it answered at all.',\n whyItMatters: 'Only 2xx acknowledges receipt. A 3xx is NOT success: a redirect on a webhook is either a misconfiguration or an attempt to move our authenticated POST somewhere the SSRF guard never inspected.',\n }),\n\n responseBodyTruncated: schemaShape.responseBodyTruncated.stringSpec({\n meaning: 'A capped slice of the webhook\\'s response body, kept for diagnosis.',\n whyItMatters: 'Capped deliberately: a webhook is a third party\\'s endpoint and its error body is attacker-influenced in the general case, so an uncapped copy would let the RECEIVER decide how much of our storage one failed delivery consumes.',\n }),\n\n failureReason: schemaShape.failureReason.stringSpec({\n meaning: 'Why the delivery failed — a transport error, or the status the endpoint returned.',\n whyItMatters: 'The field an owner searches when asking \"why did my webhook stop working\", which is the question this resource exists to answer.',\n }),\n\n deliveredAt: schemaShape.deliveredAt.dateSpec({\n meaning: 'When the webhook acknowledged the notification with a 2xx.',\n temporalRole: 'occurred',\n }),\n\n failedAt: schemaShape.failedAt.dateSpec({\n meaning: 'When the delivery was abandoned — a non-retryable response, or the attempt cap.',\n temporalRole: 'occurred',\n }),\n\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the row was opened, which is BEFORE the first delivery attempt.',\n temporalRole: 'creation',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Inspect the destination, task update, status, attempt history, and latest HTTP outcome for one A2A push delivery.',\n outcome: 'The integration owner can determine whether the notification arrived and, when it did not, see the recorded failure evidence.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The delivery was found and its destination, task update, lifecycle status, attempts, and available HTTP outcome are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to inspect A2A push-delivery history in this user, organization, or application scope.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The delivery id does not exist in this scope, including when it belongs to another scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Inspect a terminal failure for the ${exampleScope.scopeLabel} integration`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: failedExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: `Inspect a delivered ${exampleScope.scopeLabel} notification with context`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: deliveredExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: `Inspect a pending ${exampleScope.scopeLabel} delivery summary`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: pendingSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Browse an owner\\'s recent notification deliveries.',\n outcome: 'An operator sees the delivery history for their integrations in one place, including the attempts that never left the queue.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A possibly empty page of A2A push deliveries in this scope is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to browse A2A push-delivery history in this scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Browse delivered and retrying ${exampleScope.scopeLabel} notifications`,\n request: listRequest,\n response: createA2APushDeliveryPage([deliveredExample, retryingExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: `Browse ${exampleScope.scopeLabel} deliveries with relationship context`,\n request: listRequest,\n response: createA2APushDeliveryPage([deliveredExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: `Browse compact ${exampleScope.scopeLabel} delivery summaries`,\n request: listRequest,\n response: createA2APushDeliveryPage([pendingSummaryExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Filter deliveries by status, task, agent instance or date.',\n outcome: 'An owner can answer \"which of my notifications failed, and why\" without reading every row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A possibly empty page of deliveries matching the supplied status, task, agent-instance, text, date, and pagination filters is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'A filter value fails validation (e.g. an unknown status).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to search A2A push-delivery history in this scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Find terminal failures for one ${exampleScope.scopeLabel} task`,\n request: {\n ...exampleScope.scopeIdentity,\n q: 'receiver returned HTTP 503',\n status: A2APushDeliveryStatus.FAILED,\n taskId: deliveryIdentity.taskId,\n resourceServerInstanceRef: deliveryIdentity.resourceServerInstanceRef,\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n },\n response: createA2APushDeliveryPage([failedExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n\n [Op.CREATE]: {\n purpose: 'Open a PENDING row for one (task transition × registered webhook), before any delivery is attempted.',\n outcome: 'Every delivery obligation is recorded up front, so an unreachable queue leaves a visible row rather than silence.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The delivery row was opened. REPOSITORY_ONLY — a delivery row is EVIDENCE that a notification was attempted, and a caller able to author one could fabricate that evidence. The dispatcher writes it via `createAsSystem`; there is no HTTP surface at all.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails schema validation (e.g. a missing `deliveryId` or the injected owner FK).', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n },\n\n [Op.UPDATE]: {\n purpose: 'Advance a delivery through its lifecycle — claim it, then record the outcome.',\n outcome: 'The row reflects what actually happened to the notification, including scheduled retries.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The transition was recorded. REPOSITORY_ONLY, like CREATE: `repository.update` needs a default UPDATE operation to resolve, and exposing it would let a caller mark its own undelivered notifications as DELIVERED. The PENDING → IN_FLIGHT claim carries the prior status in its filter, so two workers racing one queue message cannot both claim the row.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The row is gone, or another worker already claimed it — the compare-and-swap matched nothing, and the loser stops rather than sending a duplicate POST.' },\n ],\n idempotent: false,\n },\n\n [Op.DELETE]: {\n purpose: 'Remove a delivery row — retention purging, and the cleanup the owning user/org/app deletion cascades to.',\n outcome: 'Delivery evidence does not outlive the tenant it describes.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The row was removed. REPOSITORY_ONLY and deliberately NOT offered to the owner: a trail an owner can selectively erase is not a trail. The same default op powers the composition onParentDelete cascade, which runs at the repository tier below role checks.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No such row (already purged, or never existed).' },\n ],\n idempotent: true,\n },\n\n [Op.UPDATE_MANY]: {\n purpose: 'In-place scrub of retained rows when a data subject is erased.',\n outcome: 'The delivery history survives for operational accounting while the personal data in it does not.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The matching rows were scrubbed. INTERNAL_CALL — it registers no HTTP route, and exists because `retentionPolicy` reaches rows through `updateManyAsSystem`.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n },\n [Op.DELETE_MANY]: {\n purpose: 'Bulk removal for retention windows and owner-scope teardown.',\n outcome: 'Delivery history is bounded without a per-row round trip.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The matching rows were removed. REPOSITORY_ONLY, the bulk twin of DELETE and restricted for the same reason.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'The notification BODY is an A2A `StreamResponse` carrying a `statusUpdate` event, never a whole `Task`. Both are conformant under §4.3.3, but a Task echoes the entire conversation — including message content — to an endpoint that only needed to learn the task finished, which would turn a stolen or mistyped webhook URL into a transcript exfiltration channel. The stored `payload` therefore holds status facts only.',\n 'A row is opened BEFORE the delivery is attempted, never by the worker on first contact. That ordering is the resource\\'s entire value: an unreachable queue must leave a visible PENDING row rather than silence, because silence is indistinguishable from \"no webhook was configured\".',\n 'One row per (task transition × registered webhook). A task carrying several configurations produces several rows for one transition, and a failure on one endpoint never suppresses the others.',\n 'The webhook CREDENTIAL is never persisted here. It is re-resolved from the live configuration at attempt time, so a client that rotates its credential does not have every queued retry keep presenting the stale one. The cost — a configuration deleted mid-flight ends the delivery — is the correct outcome: the client asked to stop being notified there.',\n 'The destination is captured at dispatch and the worker POSTs to the ROW\\'s URL, not the configuration\\'s. Honouring a URL edit mid-flight would redirect an in-flight notification to an address the SSRF guard approved for a different delivery.',\n 'Only 2xx acknowledges receipt. 3xx is treated as a failure rather than followed, because a redirect on a webhook is either a misconfiguration or an attempt to move an authenticated POST past the URL validation entirely.',\n 'READ / LIST / SEARCH are owner-level, not admin-gated: a row names a webhook the owner registered and its outcome, and carries no message content by construction (the payload is a `statusUpdate` event, never a whole `Task`). Forcing an owner to an administrator to diagnose their own endpoint helps nobody.',\n 'Every WRITE is REPOSITORY_ONLY. A delivery row is evidence a notification was attempted: a caller able to CREATE one could fabricate that evidence, and one able to UPDATE could mark its own undelivered notifications DELIVERED. There is deliberately no external single-row delete either.',\n 'There is NO owner-facing retry operation, unlike the M2M delivery log. There, retry is an administrator repairing their own integration; here the caller is an external agent client, and letting it re-fire deliveries on demand would hand it an amplifier pointed at a URL it also chose. Retries belong to the worker\\'s backoff schedule.',\n 'Rows are cascade-deleted with the owning scope (COMPOSITION, IMMEDIATE) rather than retained the way billing records are. A delivery log carries no financial or statutory obligation, and retaining it would leave a tenant\\'s webhook URLs — their own infrastructure addresses — alive after erasure.',\n 'A delivery row is owned by exactly ONE scope; the polymorphic owner FK is injected on each concrete variant schema, not on `A2APushDeliveryLogSchema` itself, and the owner primary-scope filter must never expose another tenant\\'s deliveries.',\n ],\n }),\n // The owner is the injected scope FK, anchored by the `<SCOPE> → *A2aPushDeliveryLog`\n // primary-scope COMPOSITION edge in `resources-registry.shared.core.definitions.ts`\n // (generated by `createPolymorphicScopeRelationships`, default MANY cardinality). The registry\n // factory derives the scope from `isPrimaryScope: true`; this declaration feeds the spec ↔\n // registry alignment guard and must match per variant.\n { resourcePrimaryScope: a2aPushDeliveryPrimaryScopeByResourceType[resourceType] },\n );\n}\n\nexport const userA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG,\n 'USER_A2A_PUSH_DELIVERY_LOG',\n);\n\nexport const organizationA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG,\n 'ORGANIZATION_A2A_PUSH_DELIVERY_LOG',\n);\n\nexport const applicationA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG,\n 'APPLICATION_A2A_PUSH_DELIVERY_LOG',\n);\n"]}
|
|
1
|
+
{"version":3,"file":"a2a-push-delivery-log.resource.specification.js","sourceRoot":"","sources":["../../../../../src/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import { LabelAudience } from '@wildo-ai/presets-components-models';\nimport {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n A2APushDeliveryLogSchema,\n A2APushDeliveryStatus,\n CoreResourceOperation as Op,\n CoreResourceType,\n ResourcePrimaryScope,\n a2aPushDeliveryLogPolymorphicFactories,\n} from '@wildo-ai/saas-models';\nimport { type CoreResourceTypeMemberName, HttpResponseStatusCode, resourceSpecification } from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/**\n * Framework-owned specification for the `a2aPushDeliveryLog` POLYMORPHIC family: the durable\n * EVIDENCE that the agent attempted to notify a client's webhook when one of its Agent2Agent (A2A)\n * tasks changed state. One base envelope is stamped out as three variants, each owned by its\n * injected owner FK — mirroring the task resource's scope set exactly:\n * - `userA2aPushDeliveryLog` (USER_SELF — user-delegated A2A turns)\n * - `organizationA2aPushDeliveryLog` (ORGANIZATIONS — org-machine A2A turns)\n * - `applicationA2aPushDeliveryLog` (APPLICATION — app-machine A2A turns)\n *\n * A row is opened per (task transition × registered webhook) BEFORE the delivery is attempted, and\n * that ordering is the reason the resource exists at all: were the row created by the worker on its\n * first attempt, an unreachable queue would leave no trace, and an operator would see silence —\n * which is indistinguishable from \"no webhook was configured\". Writing first means there is always\n * one row per obligation, including the deliveries that never got as far as being tried.\n *\n * spec-cite: A2A 1.0 §4.3.3 — *\"Agents MUST attempt delivery at least once for each configured\n * webhook\"* — and §13.2, which asks for retry with exponential backoff and permits abandoning after\n * a configured number of consecutive failures. This row is where all three become CHECKABLE rather\n * than asserted.\n *\n * SIBLING, NOT A VARIANT, of `m2mWebhookDeliveryLog`. The two share a delivery PATTERN — row first,\n * one queue job per row, a worker that classifies and retries — and even the transport primitive.\n * What they do not share is a SCOPE SET: the M2M log is stamped out for ORGANIZATIONS and\n * APPLICATION only, while an A2A task can be owned by a USER, which is the ORDINARY case for a\n * delegated-user caller. Extending the M2M resource would have meant adding a user-facing variant to\n * a shipped feature on behalf of a different subsystem. Keeping them apart also keeps the two\n * producers separable in every query: a resource-operation notification and a task-lifecycle\n * notification are different facts about different things.\n *\n * ONE spec covers all three variants (per the flow-actor-tasks / token-budget polymorphic precedent).\n */\n\ntype A2APushDeliveryResourceType =\n | CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG\n | CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG\n | CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG;\ntype A2APushDeliveryResourceTypeMember = CoreResourceTypeMemberName<A2APushDeliveryResourceType>;\n\nconst a2aPushDeliveryPrimaryScopeByResourceType: Record<A2APushDeliveryResourceType, ResourcePrimaryScope> = {\n [CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.USER_SELF,\n [CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.ORGANIZATIONS,\n [CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.APPLICATION,\n};\n\ninterface A2APushDeliveryScopeExample {\n readonly deliveryResourceIdentity: Readonly<Record<string, string>>;\n readonly machineCredentialIdentity: Readonly<Record<string, string>>;\n readonly scopeIdentity: Readonly<Record<string, string>>;\n /** Human-readable prose fragment for example titles, not a semantic vocabulary. */\n readonly scopeLabel: string;\n}\n\n/**\n * Projects one semantic delivery scenario onto the concrete owner and route-id\n * fields of each polymorphic resource. Keeping this mapping beside the spec\n * prevents examples for one public contract from silently leaking a sibling's\n * `userId`, `organizationId`, `applicationId`, or resource-id parameter.\n */\nfunction createA2APushDeliveryScopeExample(resourceType: A2APushDeliveryResourceType): A2APushDeliveryScopeExample {\n switch (resourceType) {\n case CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { userA2aPushDeliveryLogId: 'a2a_delivery_user_01JEXAMPLE' },\n machineCredentialIdentity: {},\n scopeIdentity: { userId: 'user_01JEXAMPLE' },\n scopeLabel: 'user',\n };\n case CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { organizationA2aPushDeliveryLogId: 'a2a_delivery_org_01JEXAMPLE' },\n machineCredentialIdentity: { machineCredentialId: 'machine_credential_org_01JEXAMPLE' },\n scopeIdentity: { organizationId: 'org_01JEXAMPLE' },\n scopeLabel: 'organization',\n };\n case CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG:\n return {\n deliveryResourceIdentity: { applicationA2aPushDeliveryLogId: 'a2a_delivery_app_01JEXAMPLE' },\n machineCredentialIdentity: { machineCredentialId: 'machine_credential_app_01JEXAMPLE' },\n scopeIdentity: { applicationId: 'app_01JEXAMPLE' },\n scopeLabel: 'application',\n };\n default: {\n const exhaustiveResourceType: never = resourceType;\n throw new Error(`Unsupported A2A push-delivery resource type: ${String(exhaustiveResourceType)}`);\n }\n }\n}\n\nfunction createA2APushDeliveryPage<T>(data: readonly T[]) {\n return {\n data,\n pagination: { page: 1, limit: 20, total: data.length, totalPages: data.length === 0 ? 0 : 1 },\n };\n}\n\ntype Cfg = ReturnType<(typeof a2aPushDeliveryLogPolymorphicFactories)[CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG]>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = typeof A2APushDeliveryLogSchema;\n\nfunction buildA2APushDeliveryLogResourceSpecification(\n resourceType: A2APushDeliveryResourceType,\n resourceTypeMemberName: A2APushDeliveryResourceTypeMember,\n) {\n const exampleScope = createA2APushDeliveryScopeExample(resourceType);\n const deliveryIdentity = {\n _id: Object.values(exampleScope.deliveryResourceIdentity)[0],\n deliveryId: 'delivery_attempt_01JEXAMPLE',\n taskId: 'task_01JEXAMPLE',\n pushNotificationConfigId: 'push_config_01JEXAMPLE',\n resourceServerInstanceRef: 'support-automation-agent',\n ...exampleScope.machineCredentialIdentity,\n httpUrl: 'https://integrations.customer.example/a2a/task-updates',\n payloadHash: 'c3e4db884cb42dd0ef818ae2ea032bdf3b45af622dbb39f9dc343b395874c8fc',\n payload: {\n statusUpdate: {\n taskId: 'task_01JEXAMPLE',\n contextId: 'support_case_INC_4821',\n status: { state: 'completed', timestamp: '2026-08-20T09:42:00.000Z' },\n final: true,\n },\n },\n createdAt: '2026-08-20T09:42:00.000Z',\n ...exampleScope.scopeIdentity,\n };\n const deliveredExample = {\n ...deliveryIdentity,\n status: A2APushDeliveryStatus.DELIVERED,\n attemptCount: 1,\n lastAttemptAt: '2026-08-20T09:42:03.000Z',\n responseStatus: 204,\n deliveredAt: '2026-08-20T09:42:03.000Z',\n };\n const retryingExample = {\n ...deliveryIdentity,\n _id: `${deliveryIdentity._id}_retrying`,\n deliveryId: 'delivery_attempt_01JRETRY',\n status: A2APushDeliveryStatus.PENDING,\n attemptCount: 2,\n lastAttemptAt: '2026-08-20T09:44:00.000Z',\n nextAttemptAt: '2026-08-20T09:49:00.000Z',\n responseStatus: 503,\n responseBodyTruncated: 'Service temporarily unavailable',\n failureReason: 'The receiver returned HTTP 503; another attempt is scheduled.',\n };\n const failedExample = {\n ...deliveryIdentity,\n _id: `${deliveryIdentity._id}_failed`,\n deliveryId: 'delivery_attempt_01JFAILED',\n status: A2APushDeliveryStatus.FAILED,\n attemptCount: 5,\n lastAttemptAt: '2026-08-20T10:02:00.000Z',\n responseStatus: 503,\n responseBodyTruncated: 'Service temporarily unavailable',\n failureReason: 'The receiver returned HTTP 503 after the final retry.',\n failedAt: '2026-08-20T10:02:00.000Z',\n };\n const pendingSummaryExample = {\n _id: `${deliveryIdentity._id}_pending`,\n deliveryId: 'delivery_attempt_01JPENDING',\n taskId: deliveryIdentity.taskId,\n pushNotificationConfigId: deliveryIdentity.pushNotificationConfigId,\n resourceServerInstanceRef: deliveryIdentity.resourceServerInstanceRef,\n status: A2APushDeliveryStatus.PENDING,\n attemptCount: 0,\n createdAt: '2026-08-20T10:10:00.000Z',\n };\n const listRequest = {\n ...exampleScope.scopeIdentity,\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n };\n\n return resourceSpecification<undefined, Core, Main>(\n a2aPushDeliveryLogPolymorphicFactories[resourceType],\n A2APushDeliveryLogSchema,\n ({ schemaShape }) => ({\n purpose: 'Record every attempt to notify a registered webhook that an A2A task changed state, so an integration owner can see whether the destination was reached.',\n businessRole: 'Operational history for diagnosing A2A push notifications by task, destination, status, attempt count, and HTTP outcome.',\n lifecycleRole: 'Created before the first delivery attempt, then progresses through pending and in-flight states to delivered or failed; retryable failures return to pending with a next-attempt time.',\n audience: LabelAudience.DEVELOPER,\n subDomain: EngineResourceSubDomain.FLOWS_ACTORS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'A2APushDeliveryLogSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactoryCollectionEntry: {\n collectionSymbol: { packageName: '@wildo-ai/saas-models', exportName: 'a2aPushDeliveryLogPolymorphicFactories', symbolKind: CodeSymbolKind.FACTORY },\n identifierField: 'collectionKey',\n identifierValue: resourceType,\n },\n resourceType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceType',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n memberName: resourceTypeMemberName,\n },\n operationVocabulary: {\n coreEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CoreResourceOperation',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n notes: [\n 'Three variants under `A2A_PUSH_DELIVERY_SCOPE_VARIANTS`, mirroring the task resource\\'s scope set exactly — an owner with no delivery-log variant is an owner whose notifications cannot be recorded.',\n 'MULTI-ROW: the declaration opts OUT of the singleton auto-business-key (`optOutPolymorphicAutoBusinessKey`) — there is one row per (task transition × registered webhook), so the owner FK is not its identity.',\n '`A2APushDeliveryStatus` is deliberately its OWN enum rather than a reuse of `M2MWebhookDeliveryLogStatus`, even though the members coincide: that enum is owned by the M2M notifications feature, and borrowing it would make either feature\\'s future state change a cross-feature edit.',\n 'Writers are `A2APushDispatcherBackendService` (opens the row) and the `a2a-push-delivery` batch worker (every status transition), both through `A2APushDeliveryLogRepository` and `*AsSystem` under this resource\\'s `systemAccessPolicy`. It follows the TASK service\\'s pattern rather than the M2M log\\'s because a push notification is triggered by `advanceTask` — a system-owned transition with no caller ExecutionContext to borrow.',\n 'CREATE and UPDATE are `INTERNAL_CALL`, which is MANDATORY rather than stylistic for a `*AsSystem` writer: those primitives dispatch through the SERVICE tier and resolve the operation via `getServiceOperationPathDefault`, which matches only INTERNAL_CALL / API_CALL variants. A REPOSITORY_ONLY default resolves to nothing and the write silently does not happen. DELETE / DELETE_MANY stay REPOSITORY_ONLY because nothing system-deletes a row — they are reached only by retention purging and the owner-scope cascade, both at the repository tier.',\n 'The webhook CREDENTIAL is never stored on a row: the worker re-resolves it from the live configuration at attempt time, so a client that rotates its credential (which §13.2 asks clients to do) does not have every queued retry keep presenting the stale one.',\n 'Runtime has no userNotifications / m2mNotifications — do not add communications.* (DF-1).',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Document id of this delivery record.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n deliveryId: schemaShape.deliveryId.stringSpec({\n meaning: 'Stable identity of this delivery, generated once when the record is opened and sent with every attempt.',\n whyItMatters: 'It is what makes duplicates RECOGNISABLE to the receiver. §4.3.3 asks clients to process notifications idempotently, which they can only do if a retry is identifiable as the same delivery — hence generated at row creation, never per attempt.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n taskId: schemaShape.taskId.stringSpec({\n meaning: 'The A2A task whose status transition triggered this notification.',\n whyItMatters: 'The join back to the work being reported on — an owner diagnosing a missed notification starts from the task they were expecting to hear about.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n pushNotificationConfigId: schemaShape.pushNotificationConfigId.stringSpec({\n meaning: 'Which registered webhook configuration this record delivers to — a task may carry several.',\n whyItMatters: 'Distinguishes \"one of my endpoints is broken\" from \"notifications are broken\", which are different incidents with different owners.',\n semanticRole: 'identifier',\n }),\n\n resourceServerInstanceRef: schemaShape.resourceServerInstanceRef.stringSpec({\n meaning: 'The named A2A agent instance the task belongs to.',\n whyItMatters: 'The isolation axis that keeps two agents of one tenant apart — the same axis the task read enforces, carried here so per-agent attribution and per-agent purging cannot reach another agent\\'s rows.',\n semanticRole: 'identifier',\n }),\n\n machineCredentialId: schemaShape.machineCredentialId.stringSpec({\n meaning: 'The machine credential that owns the task, when the caller presented one.',\n whyItMatters: 'The worker must re-read the LIVE configuration to obtain the client\\'s credential, and that read enforces all four isolation axes. Without this the read falls back to the \"no credential\" sentinel and matches nothing for any task a machine client created — which is most A2A tasks. Optional rather than sentinel-defaulted: a delegated-user task genuinely has none, and a sentinel would make \"absent\" and \"explicitly none\" the same value on a row whose whole job is to be evidence.',\n semanticRole: 'identifier',\n }),\n\n httpUrl: schemaShape.httpUrl.stringSpec({\n meaning: 'The webhook destination, captured as it was AT DISPATCH.',\n whyItMatters: 'Recorded on the row rather than read live so a later configuration edit cannot rewrite history — the evidence must say where this delivery was actually addressed. It is also why the worker POSTs to the row\\'s URL, not the configuration\\'s: honouring an edit mid-flight would redirect an in-flight notification to an address the SSRF guard approved for a different delivery.',\n semanticRole: 'uri',\n }),\n\n payloadHash: schemaShape.payloadHash.stringSpec({\n meaning: 'SHA-256 of the exact body sent, so a recorded delivery can be tied to precise bytes.',\n semanticRole: 'identifier',\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Where this delivery is in its lifecycle: PENDING, IN_FLIGHT, DELIVERED or FAILED.',\n whyItMatters: 'The one field that answers \"was my integration reached?\". The PENDING → IN_FLIGHT claim is a compare-and-swap, so a duplicate queue message cannot cause a second POST to a customer endpoint.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'A2APushDeliveryStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [A2APushDeliveryStatus.PENDING]: { meaning: 'The record is open and either waiting for its first attempt or re-queued for another after a retryable failure.' },\n [A2APushDeliveryStatus.IN_FLIGHT]: { meaning: 'A worker has claimed the record (PENDING → IN_FLIGHT compare-and-swap) and is POSTing to the webhook.' },\n [A2APushDeliveryStatus.DELIVERED]: { meaning: 'The endpoint answered 2xx — terminal success, and the evidence that §4.3.3 delivery obligation was met.' },\n [A2APushDeliveryStatus.FAILED]: { meaning: 'Terminal failure: a non-retryable response, or the §13.2 attempt budget exhausted.' },\n },\n }),\n\n attemptCount: schemaShape.attemptCount.numberSpec({\n meaning: 'How many POST attempts have been made for this delivery.',\n whyItMatters: 'Bounds the retry schedule — the worker terminates the row as FAILED once the cap is reached, which is the §13.2 allowance to stop after a configured number of consecutive failures.',\n unit: 'attempts',\n }),\n\n lastAttemptAt: schemaShape.lastAttemptAt.dateSpec({\n meaning: 'When the most recent attempt was made.',\n temporalRole: 'occurred',\n }),\n\n nextAttemptAt: schemaShape.nextAttemptAt.dateSpec({\n meaning: 'When the next retry becomes eligible, under the exponential backoff schedule.',\n whyItMatters: 'Indexed — this is the field a drain query orders by, and the durable form of the backoff §13.2 asks for.',\n temporalRole: 'scheduled',\n }),\n\n responseStatus: schemaShape.responseStatus.numberSpec({\n meaning: 'The HTTP status the webhook answered with, when it answered at all.',\n whyItMatters: 'Only 2xx acknowledges receipt. A 3xx is NOT success: a redirect on a webhook is either a misconfiguration or an attempt to move our authenticated POST somewhere the SSRF guard never inspected.',\n }),\n\n responseBodyTruncated: schemaShape.responseBodyTruncated.stringSpec({\n meaning: 'A capped slice of the webhook\\'s response body, kept for diagnosis.',\n whyItMatters: 'Capped deliberately: a webhook is a third party\\'s endpoint and its error body is attacker-influenced in the general case, so an uncapped copy would let the RECEIVER decide how much of our storage one failed delivery consumes.',\n }),\n\n failureReason: schemaShape.failureReason.stringSpec({\n meaning: 'Why the delivery failed — a transport error, or the status the endpoint returned.',\n whyItMatters: 'The field an owner searches when asking \"why did my webhook stop working\", which is the question this resource exists to answer.',\n }),\n\n deliveredAt: schemaShape.deliveredAt.dateSpec({\n meaning: 'When the webhook acknowledged the notification with a 2xx.',\n temporalRole: 'occurred',\n }),\n\n failedAt: schemaShape.failedAt.dateSpec({\n meaning: 'When the delivery was abandoned — a non-retryable response, or the attempt cap.',\n temporalRole: 'occurred',\n }),\n\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the record was opened, which is BEFORE the first delivery attempt.',\n temporalRole: 'creation',\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Inspect the destination, task update, status, attempt history, and latest HTTP outcome for one A2A push delivery.',\n outcome: 'The integration owner can determine whether the notification arrived and, when it did not, see the recorded failure evidence.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The delivery was found and its destination, task update, lifecycle status, attempts, and available HTTP outcome are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to inspect A2A push-delivery history in this user, organization, or application scope.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The delivery id does not exist in this scope, including when it belongs to another scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Inspect a terminal failure for the ${exampleScope.scopeLabel} integration`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: failedExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: `Inspect a delivered ${exampleScope.scopeLabel} notification with context`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: deliveredExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: `Inspect a pending ${exampleScope.scopeLabel} delivery summary`,\n request: { ...exampleScope.scopeIdentity, ...exampleScope.deliveryResourceIdentity },\n response: pendingSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Browse an owner\\'s recent notification deliveries.',\n outcome: 'An operator sees the delivery history for their integrations in one place, including the attempts that never left the queue.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A possibly empty page of A2A push deliveries in this scope is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to browse A2A push-delivery history in this scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Browse delivered and retrying ${exampleScope.scopeLabel} notifications`,\n request: listRequest,\n response: createA2APushDeliveryPage([deliveredExample, retryingExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n variants: {\n context: {\n examples: [{\n title: `Browse ${exampleScope.scopeLabel} deliveries with relationship context`,\n request: listRequest,\n response: createA2APushDeliveryPage([deliveredExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n summary: {\n examples: [{\n title: `Browse compact ${exampleScope.scopeLabel} delivery summaries`,\n request: listRequest,\n response: createA2APushDeliveryPage([pendingSummaryExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Filter deliveries by status, task, agent instance or date.',\n outcome: 'An owner can answer \"which of my notifications failed, and why\" without reading every row.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A possibly empty page of deliveries matching the supplied status, task, agent-instance, text, date, and pagination filters is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'A filter value fails validation (e.g. an unknown status).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not allowed to search A2A push-delivery history in this scope.' },\n ],\n idempotent: true,\n examples: [{\n title: `Find terminal failures for one ${exampleScope.scopeLabel} task`,\n request: {\n ...exampleScope.scopeIdentity,\n q: 'receiver returned HTTP 503',\n status: A2APushDeliveryStatus.FAILED,\n taskId: deliveryIdentity.taskId,\n resourceServerInstanceRef: deliveryIdentity.resourceServerInstanceRef,\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n },\n response: createA2APushDeliveryPage([failedExample]),\n forStatus: HttpResponseStatusCode.OK_200,\n }],\n },\n\n [Op.CREATE]: {\n purpose: 'Open a PENDING row for one (task transition × registered webhook), before any delivery is attempted.',\n outcome: 'Every delivery obligation is recorded up front, so an unreachable queue leaves a visible row rather than silence.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The delivery record was opened. REPOSITORY_ONLY — a delivery record is EVIDENCE that a notification was attempted, and a caller able to author one could fabricate that evidence. The dispatcher writes it via `createAsSystem`; there is no HTTP surface at all.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The payload fails schema validation (e.g. a missing `deliveryId` or the injected owner FK).', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n },\n\n [Op.UPDATE]: {\n purpose: 'Advance a delivery through its lifecycle — claim it, then record the outcome.',\n outcome: 'The row reflects what actually happened to the notification, including scheduled retries.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The transition was recorded. REPOSITORY_ONLY, like CREATE: `repository.update` needs a default UPDATE operation to resolve, and exposing it would let a caller mark its own undelivered notifications as DELIVERED. The PENDING → IN_FLIGHT claim carries the prior status in its filter, so two workers racing one queue message cannot both claim the record.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'The row is gone, or another worker already claimed it — the compare-and-swap matched nothing, and the loser stops rather than sending a duplicate POST.' },\n ],\n idempotent: false,\n },\n\n [Op.DELETE]: {\n purpose: 'Remove a delivery row — retention purging, and the cleanup the owning user/org/app deletion cascades to.',\n outcome: 'Delivery evidence does not outlive the tenant it describes.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The record was removed. REPOSITORY_ONLY and deliberately NOT offered to the owner: a trail an owner can selectively erase is not a trail. The same default op powers the composition onParentDelete cascade, which runs at the repository tier below role checks.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No such row (already purged, or never existed).' },\n ],\n idempotent: true,\n },\n\n [Op.UPDATE_MANY]: {\n purpose: 'In-place scrub of retained rows when a data subject is erased.',\n outcome: 'The delivery history survives for operational accounting while the personal data in it does not.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were scrubbed. INTERNAL_CALL — it registers no HTTP route, and exists because `retentionPolicy` reaches records through `updateManyAsSystem`.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n },\n [Op.DELETE_MANY]: {\n purpose: 'Bulk removal for retention windows and owner-scope teardown.',\n outcome: 'Delivery history is bounded without a per-row round trip.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The matching records were removed. REPOSITORY_ONLY, the bulk twin of DELETE and restricted for the same reason.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'The notification BODY is an A2A `StreamResponse` carrying a `statusUpdate` event, never a whole `Task`. Both are conformant under §4.3.3, but a Task echoes the entire conversation — including message content — to an endpoint that only needed to learn the task finished, which would turn a stolen or mistyped webhook URL into a transcript exfiltration channel. The stored `payload` therefore holds status facts only.',\n 'A row is opened BEFORE the delivery is attempted, never by the worker on first contact. That ordering is the resource\\'s entire value: an unreachable queue must leave a visible PENDING row rather than silence, because silence is indistinguishable from \"no webhook was configured\".',\n 'One row per (task transition × registered webhook). A task carrying several configurations produces several rows for one transition, and a failure on one endpoint never suppresses the others.',\n 'The webhook CREDENTIAL is never persisted here. It is re-resolved from the live configuration at attempt time, so a client that rotates its credential does not have every queued retry keep presenting the stale one. The cost — a configuration deleted mid-flight ends the delivery — is the correct outcome: the client asked to stop being notified there.',\n 'The destination is captured at dispatch and the worker POSTs to the ROW\\'s URL, not the configuration\\'s. Honouring a URL edit mid-flight would redirect an in-flight notification to an address the SSRF guard approved for a different delivery.',\n 'Only 2xx acknowledges receipt. 3xx is treated as a failure rather than followed, because a redirect on a webhook is either a misconfiguration or an attempt to move an authenticated POST past the URL validation entirely.',\n 'READ / LIST / SEARCH are owner-level, not admin-gated: a row names a webhook the owner registered and its outcome, and carries no message content by construction (the payload is a `statusUpdate` event, never a whole `Task`). Forcing an owner to an administrator to diagnose their own endpoint helps nobody.',\n 'Every WRITE is REPOSITORY_ONLY. A delivery row is evidence a notification was attempted: a caller able to CREATE one could fabricate that evidence, and one able to UPDATE could mark its own undelivered notifications DELIVERED. There is deliberately no external single-row delete either.',\n 'There is NO owner-facing retry operation, unlike the M2M delivery log. There, retry is an administrator repairing their own integration; here the caller is an external agent client, and letting it re-fire deliveries on demand would hand it an amplifier pointed at a URL it also chose. Retries belong to the worker\\'s backoff schedule.',\n 'Rows are cascade-deleted with the owning scope (COMPOSITION, IMMEDIATE) rather than retained the way billing records are. A delivery log carries no financial or statutory obligation, and retaining it would leave a tenant\\'s webhook URLs — their own infrastructure addresses — alive after erasure.',\n 'A delivery row is owned by exactly ONE scope; the polymorphic owner FK is injected on each concrete variant schema, not on `A2APushDeliveryLogSchema` itself, and the owner primary-scope filter must never expose another tenant\\'s deliveries.',\n ],\n }),\n // The owner is the injected scope FK, anchored by the `<SCOPE> → *A2aPushDeliveryLog`\n // primary-scope COMPOSITION edge in `resources-registry.shared.core.definitions.ts`\n // (generated by `createPolymorphicScopeRelationships`, default MANY cardinality). The registry\n // factory derives the scope from `isPrimaryScope: true`; this declaration feeds the spec ↔\n // registry alignment guard and must match per variant.\n { resourcePrimaryScope: a2aPushDeliveryPrimaryScopeByResourceType[resourceType] },\n );\n}\n\nexport const userA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG,\n 'USER_A2A_PUSH_DELIVERY_LOG',\n);\n\nexport const organizationA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG,\n 'ORGANIZATION_A2A_PUSH_DELIVERY_LOG',\n);\n\nexport const applicationA2aPushDeliveryLogResourceSpecification = buildA2APushDeliveryLogResourceSpecification(\n CoreResourceType.APPLICATION_A2A_PUSH_DELIVERY_LOG,\n 'APPLICATION_A2A_PUSH_DELIVERY_LOG',\n);\n"]}
|