@wildo-ai/saas-specifications 1.1.1 → 1.1.3
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/_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-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-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.family-aspects.d.ts +3 -0
- package/dist/esm/_core/brand/brand.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/brand/brand.family-aspects.js +51 -0
- package/dist/esm/_core/brand/brand.family-aspects.js.map +1 -0
- 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.family-aspects.d.ts +3 -0
- package/dist/esm/_core/build-plan/build-plan.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/build-plan/build-plan.family-aspects.js +28 -0
- package/dist/esm/_core/build-plan/build-plan.family-aspects.js.map +1 -0
- 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.family-aspects.d.ts +3 -0
- package/dist/esm/_core/business-model-lite/business-model.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/business-model-lite/business-model.family-aspects.js +21 -0
- package/dist/esm/_core/business-model-lite/business-model.family-aspects.js.map +1 -0
- package/dist/esm/_core/chart-view-specification.schemas.d.ts +11 -0
- package/dist/esm/_core/chart-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/chart-view-specification.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate-generation.schemas.d.ts +85 -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 +41 -0
- 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 +178 -2
- 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 +115 -9
- 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 +12 -0
- package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.js +47 -0
- package/dist/esm/_core/compliance-documents/compliance-documents.family-aspects.js.map +1 -0
- package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.js +8 -3
- package/dist/esm/_core/compliance-documents/document-fact-specification-generation.schemas.js.map +1 -1
- package/dist/esm/_core/compliance-documents/processor-register.family-aspects.d.ts +21 -0
- package/dist/esm/_core/compliance-documents/processor-register.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/compliance-documents/processor-register.family-aspects.js +40 -0
- package/dist/esm/_core/compliance-documents/processor-register.family-aspects.js.map +1 -0
- package/dist/esm/_core/composite-view-specification.schemas.d.ts +11 -0
- package/dist/esm/_core/composite-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/composite-view-specification.schemas.js.map +1 -1
- package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts +3 -0
- package/dist/esm/_core/domain-plan/domain-plan.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js +32 -0
- package/dist/esm/_core/domain-plan/domain-plan.family-aspects.js.map +1 -0
- package/dist/esm/_core/execution-view-specification.schemas.d.ts +11 -0
- package/dist/esm/_core/execution-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/execution-view-specification.schemas.js.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 +18 -0
- package/dist/esm/_core/family-aspects.registry.d.ts.map +1 -0
- package/dist/esm/_core/family-aspects.registry.js +60 -0
- package/dist/esm/_core/family-aspects.registry.js.map +1 -0
- package/dist/esm/_core/family-aspects.schemas.d.ts +122 -0
- package/dist/esm/_core/family-aspects.schemas.d.ts.map +1 -0
- package/dist/esm/_core/family-aspects.schemas.js +15 -0
- package/dist/esm/_core/family-aspects.schemas.js.map +1 -0
- package/dist/esm/_core/feature-drafts/capability-map-output-set-generation.schemas.d.ts +11 -11
- package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.d.ts +3 -0
- package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.js +25 -0
- package/dist/esm/_core/feature-drafts/feature-drafts.family-aspects.js.map +1 -0
- 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/flows-actors-view-specification.schemas.d.ts +11 -0
- package/dist/esm/_core/flows-actors-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/flows-actors-view-specification.schemas.js.map +1 -1
- package/dist/esm/_core/frontend-component-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/frontend-component-specification.schemas.js +19 -1
- package/dist/esm/_core/frontend-component-specification.schemas.js.map +1 -1
- package/dist/esm/_core/full-custom-view-specification.schemas.d.ts +11 -0
- package/dist/esm/_core/full-custom-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/full-custom-view-specification.schemas.js.map +1 -1
- package/dist/esm/_core/guidance-flow-specification.schemas.d.ts +11 -0
- package/dist/esm/_core/guidance-flow-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/guidance-flow-specification.schemas.js +14 -0
- package/dist/esm/_core/guidance-flow-specification.schemas.js.map +1 -1
- package/dist/esm/_core/index.d.ts +3 -0
- package/dist/esm/_core/index.d.ts.map +1 -1
- package/dist/esm/_core/index.js +3 -0
- package/dist/esm/_core/index.js.map +1 -1
- package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts +22 -22
- 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.family-aspects.d.ts +9 -0
- package/dist/esm/_core/market/market.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/market/market.family-aspects.js +227 -0
- package/dist/esm/_core/market/market.family-aspects.js.map +1 -0
- package/dist/esm/_core/onboarding-view-specification.schemas.d.ts +11 -0
- package/dist/esm/_core/onboarding-view-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/onboarding-view-specification.schemas.js +14 -0
- package/dist/esm/_core/onboarding-view-specification.schemas.js.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 +66 -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 +62 -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 +3 -0
- package/dist/esm/_core/placement-plan/placement-plan.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/placement-plan/placement-plan.family-aspects.js +31 -0
- package/dist/esm/_core/placement-plan/placement-plan.family-aspects.js.map +1 -0
- package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts +4 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.js +4 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
- package/dist/esm/_core/provider-specification.schemas.d.ts +82 -0
- package/dist/esm/_core/provider-specification.schemas.d.ts.map +1 -0
- package/dist/esm/_core/provider-specification.schemas.js +144 -0
- package/dist/esm/_core/provider-specification.schemas.js.map +1 -0
- 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.family-aspects.d.ts +9 -0
- package/dist/esm/_core/requirements/requirements.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/requirements/requirements.family-aspects.js +40 -0
- package/dist/esm/_core/requirements/requirements.family-aspects.js.map +1 -0
- package/dist/esm/_core/resource-specification.schemas.d.ts +22 -0
- package/dist/esm/_core/resource-specification.schemas.d.ts.map +1 -1
- package/dist/esm/_core/resource-specification.schemas.js.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.family-aspects.d.ts +3 -0
- package/dist/esm/_core/roadmap/roadmap.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/roadmap/roadmap.family-aspects.js +26 -0
- package/dist/esm/_core/roadmap/roadmap.family-aspects.js.map +1 -0
- 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/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.family-aspects.d.ts +11 -0
- package/dist/esm/_core/vision/vision.family-aspects.d.ts.map +1 -0
- package/dist/esm/_core/vision/vision.family-aspects.js +63 -0
- package/dist/esm/_core/vision/vision.family-aspects.js.map +1 -0
- 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 +193 -38
- 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 +157 -57
- 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.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 +38 -4
- 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 +37 -3
- 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 +12 -0
- package/dist/esm/application-creation/document-facts.family-aspects.d.ts.map +1 -0
- package/dist/esm/application-creation/document-facts.family-aspects.js +37 -0
- package/dist/esm/application-creation/document-facts.family-aspects.js.map +1 -0
- package/dist/esm/application-creation/document-release-policy.family-aspects.d.ts +3 -0
- package/dist/esm/application-creation/document-release-policy.family-aspects.d.ts.map +1 -0
- package/dist/esm/application-creation/document-release-policy.family-aspects.js +23 -0
- package/dist/esm/application-creation/document-release-policy.family-aspects.js.map +1 -0
- 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 +101 -85
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js +171 -86
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts +2 -0
- package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.js +2 -0
- package/dist/esm/application-creation/structured-artifact-landing.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation.exports.d.ts +11 -0
- package/dist/esm/application-creation.exports.d.ts.map +1 -1
- package/dist/esm/application-creation.exports.js +11 -0
- package/dist/esm/application-creation.exports.js.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 +999 -2
- package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.js +2127 -61
- package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +26 -0
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-system.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-system.definitions.js +18 -3
- package/dist/esm/assurance/assurance-document-system.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-document-system.schemas.d.ts +32 -2
- package/dist/esm/assurance/assurance-document-system.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-document-system.schemas.js +32 -2
- package/dist/esm/assurance/assurance-document-system.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts +36 -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 +859 -0
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -0
- package/dist/esm/assurance/assurance-external-framework-mapping.d.ts +90 -0
- package/dist/esm/assurance/assurance-external-framework-mapping.d.ts.map +1 -0
- package/dist/esm/assurance/assurance-external-framework-mapping.js +134 -0
- package/dist/esm/assurance/assurance-external-framework-mapping.js.map +1 -0
- 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 +78 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js +562 -5
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +148 -0
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -0
- package/dist/esm/assurance/assurance-program-generation.schemas.js +385 -0
- package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -0
- package/dist/esm/assurance/assurance-program.family-aspects.d.ts +13 -0
- package/dist/esm/assurance/assurance-program.family-aspects.d.ts.map +1 -0
- package/dist/esm/assurance/assurance-program.family-aspects.js +16 -0
- package/dist/esm/assurance/assurance-program.family-aspects.js.map +1 -0
- package/dist/esm/assurance/assurance-program.schemas.d.ts +474 -14
- package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.js +319 -8
- package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-source-registry.definitions.d.ts +1 -0
- package/dist/esm/assurance/assurance-source-registry.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-source-registry.definitions.js +12 -0
- package/dist/esm/assurance/assurance-source-registry.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-sources.schemas.d.ts +76 -0
- package/dist/esm/assurance/assurance-sources.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-sources.schemas.js +59 -0
- package/dist/esm/assurance/assurance-sources.schemas.js.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 +999 -0
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -0
- package/dist/esm/assurance/document-publication.family-aspects.d.ts +29 -0
- package/dist/esm/assurance/document-publication.family-aspects.d.ts.map +1 -0
- package/dist/esm/assurance/document-publication.family-aspects.js +48 -0
- package/dist/esm/assurance/document-publication.family-aspects.js.map +1 -0
- package/dist/esm/assurance.exports.d.ts +2 -0
- package/dist/esm/assurance.exports.d.ts.map +1 -1
- package/dist/esm/assurance.exports.js +2 -0
- package/dist/esm/assurance.exports.js.map +1 -1
- package/dist/esm/companion-exports.d.ts +26 -8
- package/dist/esm/companion-exports.d.ts.map +1 -1
- package/dist/esm/companion-exports.js.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/resources/application-api-keys.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +15 -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 +4 -2
- 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 +17 -3
- 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 +12 -10
- 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 +4 -2
- package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.d.ts +36 -0
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js +193 -0
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js.map +1 -0
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.d.ts +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 +3 -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 +15 -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 +17 -3
- 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 +1 -1
- 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 +6 -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 +4 -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 +8 -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 +11 -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 +8 -6
- 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 +106 -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 +0 -6
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js +2 -0
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.js.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/resources/billing-accounts.resource.specification.d.ts +2 -2
- 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 +6 -3
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.d.ts +8 -8
- 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 +4 -2
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.d.ts +2 -2
- 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 +5 -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 +10 -8
- 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 +10 -8
- 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 +16 -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 +10 -8
- package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts +6 -6
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +8 -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 +13 -9
- 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 +30 -11
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
- 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 +10 -8
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.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 +11 -2
- package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
- package/dist/esm/engine/engine-resource-sub-domain.d.ts +83 -0
- package/dist/esm/engine/engine-resource-sub-domain.d.ts.map +1 -0
- package/dist/esm/engine/engine-resource-sub-domain.js +153 -0
- package/dist/esm/engine/engine-resource-sub-domain.js.map +1 -0
- package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.js +44 -1
- package/dist/esm/engine/errors/error-messages.specification.js.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.js +7 -7
- package/dist/esm/engine/features/core-limits.feature.specifications.js.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 +5 -3
- package/dist/esm/engine/features/resources/application-features.resource.specification.js.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 +5 -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 +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 +5 -3
- package/dist/esm/engine/features/resources/user-features.resource.specification.js.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 +12 -10
- package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts +3 -3
- 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 +22 -10
- 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 +3 -3
- 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 +6 -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 +3 -3
- 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 +4 -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 +3 -3
- package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js +3 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-tasks.resource.specification.js.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/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-main-container.frontend-component.specification.js +8 -3
- package/dist/esm/engine/frontend-components/app/public-layout-main-container.frontend-component.specification.js.map +1 -1
- 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
- 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/guidance/resources/guidance-state.resource.specification.d.ts +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 +15 -12
- package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.d.ts +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 +12 -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 +9 -1
- 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 +9 -6
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/index.d.ts +2 -0
- package/dist/esm/engine/index.d.ts.map +1 -1
- package/dist/esm/engine/index.js +2 -0
- package/dist/esm/engine/index.js.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 +19 -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 +9 -7
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.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 +10 -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 +12 -5
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.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 +22 -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 +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 +14 -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 +31 -6
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.d.ts +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 +11 -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 +5 -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 +6 -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 +4 -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 +3 -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/organization-units.resource.specification.js +2 -0
- package/dist/esm/engine/organizations/resources/organization-units.resource.specification.js.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 +9 -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 +33 -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 +35 -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 +31 -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 +30 -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 +34 -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 +30 -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 +30 -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 +33 -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 +43 -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 +50 -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 +30 -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 +33 -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 +35 -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 +33 -0
- package/dist/esm/engine/providers/twilio.provider.specification.js.map +1 -0
- 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 +9 -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 +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 +11 -9
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.d.ts +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 +4 -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 +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 +10 -8
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +5 -5
- 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 +6 -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 +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 +4 -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 +5 -5
- 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 +15 -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 +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 +3 -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 +11 -9
- package/dist/esm/engine/users/resources/user-self.resource.specification.js.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 +95 -0
- package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts +5 -0
- 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 +451 -25
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.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 +37 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.js.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -0
- package/package.json +8 -8
- package/dist/esm/.builder.pid +0 -9
- package/dist/esm/_core/business-coverage/coverage-findings-validation.d.ts +0 -0
- package/dist/esm/_core/business-coverage/coverage-findings-validation.d.ts.map +0 -0
- package/dist/esm/_core/business-coverage/coverage-findings-validation.js.map +0 -0
- package/dist/esm/_core/business-coverage/coverage-findings.schemas.d.ts +0 -0
- package/dist/esm/_core/business-coverage/coverage-findings.schemas.d.ts.map +0 -0
- package/dist/esm/_core/business-coverage/coverage-findings.schemas.js.map +0 -0
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"files.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/files/resources/files.resource.specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAIL,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,IAAI,EAAE,EAE3B,UAAU,EAEV,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"files.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/files/resources/files.resource.specification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EAIL,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,IAAI,EAAE,EAE3B,UAAU,EAEV,oBAAoB,EACrB,MAAM,uBAAuB,CAAC;AAI/B,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAgXtC,CAAC"}
|
|
@@ -12,11 +12,13 @@ import { LabelAudience } from '@wildo-ai/presets-components-models';
|
|
|
12
12
|
import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, FileDisplayNature, FileStorageAccepted, FileUploaderEntityType, } from '@wildo-ai/zod-decorators';
|
|
13
13
|
import { CoreResourceOperation as Op, FileSchema, FileStatus, filesResourceConfiguration_InitializationFactory, ResourcePrimaryScope, } from '@wildo-ai/saas-models';
|
|
14
14
|
import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
|
|
15
|
+
import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
|
|
15
16
|
export const filesResourceSpecification = resourceSpecification(filesResourceConfiguration_InitializationFactory, FileSchema, ({ schemaShape }) => ({
|
|
16
17
|
purpose: 'Store file metadata (name, MIME, storage pointers, lifecycle, and scope) for assets managed by the platform file service.',
|
|
17
18
|
businessRole: 'The shared “file row” truth that links uploaded bytes in object storage to domain resources through `linkedResource*` fields.',
|
|
18
19
|
lifecycleRole: 'Moves from `PENDING` upload through `UPLOADED`, optional AV / extraction states, linking to business records, and eventual `DELETED` / `ORPHANED` cleanup.',
|
|
19
20
|
audience: LabelAudience.END_USER,
|
|
21
|
+
subDomain: EngineResourceSubDomain.FILES,
|
|
20
22
|
codeHandling: {
|
|
21
23
|
mainSchema: {
|
|
22
24
|
packageName: '@wildo-ai/saas-models',
|
|
@@ -117,7 +119,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
117
119
|
semanticRole: 'uri',
|
|
118
120
|
}),
|
|
119
121
|
status: schemaShape.status.enumSpec({
|
|
120
|
-
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.',
|
|
121
123
|
importance: FieldSemanticImportance.PRIMARY,
|
|
122
124
|
enumDeclaration: {
|
|
123
125
|
packageName: '@wildo-ai/saas-models',
|
|
@@ -126,12 +128,12 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
126
128
|
declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
|
|
127
129
|
},
|
|
128
130
|
values: {
|
|
129
|
-
[FileStatus.PENDING]: { meaning: 'Upload not finished — metadata
|
|
131
|
+
[FileStatus.PENDING]: { meaning: 'Upload not finished — metadata record exists, bytes not ready yet.' },
|
|
130
132
|
[FileStatus.UPLOADED]: { meaning: 'Bytes are stored and ready for post-processing or linking.' },
|
|
131
133
|
[FileStatus.LINKED]: { meaning: 'Bound to a parent resource’s `z_file()` field; primary happy path for production assets.' },
|
|
132
134
|
[FileStatus.DELETED]: { meaning: 'Soft-deleted; bytes may still exist until vacuum jobs run.' },
|
|
133
135
|
[FileStatus.ORPHANED]: { meaning: 'No live parent link — retained for re-link or background cleanup only.' },
|
|
134
|
-
[FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this
|
|
136
|
+
[FileStatus.FAILED]: { meaning: 'Upload or processing failed irrecoverably for this record.' },
|
|
135
137
|
[FileStatus.SCANNING]: { meaning: 'AV pipeline is running before download is allowed in hardened tenants.' },
|
|
136
138
|
[FileStatus.CLEAN]: { meaning: 'AV says the payload is not malicious.' },
|
|
137
139
|
[FileStatus.INFECTED]: { meaning: 'Quarantine candidate — do not serve for download.' },
|
|
@@ -175,7 +177,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
175
177
|
semanticRole: 'code',
|
|
176
178
|
}),
|
|
177
179
|
primaryScope: schemaShape.primaryScope.enumSpec({
|
|
178
|
-
meaning: 'Which isolation bucket this
|
|
180
|
+
meaning: 'Which isolation bucket this record participates in: app-wide, org-wide, or user-private (within an org).',
|
|
179
181
|
whyItMatters: 'Field is optional at rest until an upload binds scope identifiers; `FileSchema` superRefine enforces consistency between `primaryScope` and the id triple.',
|
|
180
182
|
enumDeclaration: {
|
|
181
183
|
packageName: '@wildo-ai/saas-models',
|
|
@@ -198,11 +200,11 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
198
200
|
semanticRole: 'identifier',
|
|
199
201
|
}),
|
|
200
202
|
userId: schemaShape.userId.stringSpec({
|
|
201
|
-
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`.',
|
|
202
204
|
semanticRole: 'identifier',
|
|
203
205
|
}),
|
|
204
206
|
uploadedBy: schemaShape.uploadedBy.stringSpec({
|
|
205
|
-
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, …).',
|
|
206
208
|
semanticRole: 'identifier',
|
|
207
209
|
}),
|
|
208
210
|
uploadedByEntityType: schemaShape.uploadedByEntityType.enumSpec({
|
|
@@ -241,7 +243,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
241
243
|
whenToUse: 'Use in server-side `FilesBackendService` flows — not exposed to anonymous callers for arbitrary ids.',
|
|
242
244
|
importance: FieldSemanticImportance.PRIMARY,
|
|
243
245
|
responseStatuses: [
|
|
244
|
-
{ 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.' },
|
|
245
247
|
],
|
|
246
248
|
errorScenarios: [
|
|
247
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).' },
|
|
@@ -254,7 +256,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
254
256
|
outcome: 'Background jobs and admin UIs can page through the storage ledger under org/app isolation.',
|
|
255
257
|
whenToUse: 'Use in cleanup jobs, quota dashboards, or when syncing CDN metadata for the tenant.',
|
|
256
258
|
responseStatuses: [
|
|
257
|
-
{ 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.' },
|
|
258
260
|
],
|
|
259
261
|
errorScenarios: [
|
|
260
262
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the role required to page the storage ledger for the requested scope.' },
|
|
@@ -267,7 +269,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
267
269
|
whenToUse: 'Use on upload start or completion events before linking to a parent resource’s `z_file()` slot.',
|
|
268
270
|
importance: FieldSemanticImportance.PRIMARY,
|
|
269
271
|
responseStatuses: [
|
|
270
|
-
{ 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.' },
|
|
271
273
|
],
|
|
272
274
|
errorScenarios: [
|
|
273
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' },
|
|
@@ -303,7 +305,7 @@ export const filesResourceSpecification = resourceSpecification(filesResourceCon
|
|
|
303
305
|
whenToUse: 'Use in workers and trusted services; users never mutate this row ad hoc in consumer APIs.',
|
|
304
306
|
importance: FieldSemanticImportance.PRIMARY,
|
|
305
307
|
responseStatuses: [
|
|
306
|
-
{ 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.' },
|
|
307
309
|
],
|
|
308
310
|
errorScenarios: [
|
|
309
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":"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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';\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 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: '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 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"]}
|
package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { A2APushDeliveryStatus, CoreResourceOperation as Op } from '@wildo-ai/saas-models';
|
|
2
|
-
export declare const userA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
|
|
2
|
+
export declare const userA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.UPDATE_MANY | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
|
|
3
3
|
_id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
|
|
4
4
|
deliveryId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
|
|
5
5
|
taskId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
|
|
@@ -20,7 +20,7 @@ export declare const userA2aPushDeliveryLogResourceSpecification: import("../../
|
|
|
20
20
|
failedAt: import("zod").ZodOptional<import("zod").ZodDate>;
|
|
21
21
|
createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodDate>>>;
|
|
22
22
|
}, import("zod/v4/core").$strip>>;
|
|
23
|
-
export declare const organizationA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
|
|
23
|
+
export declare const organizationA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.UPDATE_MANY | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
|
|
24
24
|
_id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
|
|
25
25
|
deliveryId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
|
|
26
26
|
taskId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
|
|
@@ -41,7 +41,7 @@ export declare const organizationA2aPushDeliveryLogResourceSpecification: import
|
|
|
41
41
|
failedAt: import("zod").ZodOptional<import("zod").ZodDate>;
|
|
42
42
|
createdAt: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodDefault<import("zod").ZodDate>>>;
|
|
43
43
|
}, import("zod/v4/core").$strip>>;
|
|
44
|
-
export declare const applicationA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
|
|
44
|
+
export declare const applicationA2aPushDeliveryLogResourceSpecification: import("../../../_core").ResourceSpecificationConfig<undefined, Op.READ | Op.UPDATE | Op.UPDATE_MANY | Op.DELETE | Op.DELETE_MANY | Op.CREATE | Op.LIST | Op.SEARCH, import("zod").ZodObject<{
|
|
45
45
|
_id: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
|
|
46
46
|
deliveryId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
|
|
47
47
|
taskId: import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("@wildo-ai/zod-decorators").DecoratedPrimitiveZodType<import("zod").ZodString>>;
|
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":["../../../../../../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;
|
|
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
|
@@ -2,6 +2,7 @@ import { LabelAudience } from '@wildo-ai/presets-components-models';
|
|
|
2
2
|
import { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance, } from '@wildo-ai/zod-decorators';
|
|
3
3
|
import { A2APushDeliveryLogSchema, A2APushDeliveryStatus, CoreResourceOperation as Op, CoreResourceType, ResourcePrimaryScope, a2aPushDeliveryLogPolymorphicFactories, } from '@wildo-ai/saas-models';
|
|
4
4
|
import { HttpResponseStatusCode, resourceSpecification } from '../../../_core/index.js';
|
|
5
|
+
import { EngineResourceSubDomain } from '../../engine-resource-sub-domain.js';
|
|
5
6
|
const a2aPushDeliveryPrimaryScopeByResourceType = {
|
|
6
7
|
[CoreResourceType.USER_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.USER_SELF,
|
|
7
8
|
[CoreResourceType.ORGANIZATION_A2A_PUSH_DELIVERY_LOG]: ResourcePrimaryScope.ORGANIZATIONS,
|
|
@@ -123,6 +124,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
123
124
|
businessRole: 'Operational history for diagnosing A2A push notifications by task, destination, status, attempt count, and HTTP outcome.',
|
|
124
125
|
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.',
|
|
125
126
|
audience: LabelAudience.DEVELOPER,
|
|
127
|
+
subDomain: EngineResourceSubDomain.FLOWS_ACTORS,
|
|
126
128
|
codeHandling: {
|
|
127
129
|
mainSchema: {
|
|
128
130
|
packageName: '@wildo-ai/saas-models',
|
|
@@ -164,12 +166,12 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
164
166
|
},
|
|
165
167
|
fields: {
|
|
166
168
|
_id: schemaShape._id.stringSpec({
|
|
167
|
-
meaning: 'Document id of this delivery
|
|
169
|
+
meaning: 'Document id of this delivery record.',
|
|
168
170
|
semanticRole: 'identifier',
|
|
169
171
|
importance: FieldSemanticImportance.PRIMARY,
|
|
170
172
|
}),
|
|
171
173
|
deliveryId: schemaShape.deliveryId.stringSpec({
|
|
172
|
-
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.',
|
|
173
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.',
|
|
174
176
|
semanticRole: 'identifier',
|
|
175
177
|
importance: FieldSemanticImportance.PRIMARY,
|
|
@@ -181,7 +183,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
181
183
|
importance: FieldSemanticImportance.PRIMARY,
|
|
182
184
|
}),
|
|
183
185
|
pushNotificationConfigId: schemaShape.pushNotificationConfigId.stringSpec({
|
|
184
|
-
meaning: 'Which registered webhook configuration this
|
|
186
|
+
meaning: 'Which registered webhook configuration this record delivers to — a task may carry several.',
|
|
185
187
|
whyItMatters: 'Distinguishes "one of my endpoints is broken" from "notifications are broken", which are different incidents with different owners.',
|
|
186
188
|
semanticRole: 'identifier',
|
|
187
189
|
}),
|
|
@@ -215,8 +217,8 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
215
217
|
declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,
|
|
216
218
|
},
|
|
217
219
|
values: {
|
|
218
|
-
[A2APushDeliveryStatus.PENDING]: { meaning: 'The
|
|
219
|
-
[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.' },
|
|
220
222
|
[A2APushDeliveryStatus.DELIVERED]: { meaning: 'The endpoint answered 2xx — terminal success, and the evidence that §4.3.3 delivery obligation was met.' },
|
|
221
223
|
[A2APushDeliveryStatus.FAILED]: { meaning: 'Terminal failure: a non-retryable response, or the §13.2 attempt budget exhausted.' },
|
|
222
224
|
},
|
|
@@ -256,7 +258,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
256
258
|
temporalRole: 'occurred',
|
|
257
259
|
}),
|
|
258
260
|
createdAt: schemaShape.createdAt.dateSpec({
|
|
259
|
-
meaning: 'When the
|
|
261
|
+
meaning: 'When the record was opened, which is BEFORE the first delivery attempt.',
|
|
260
262
|
temporalRole: 'creation',
|
|
261
263
|
}),
|
|
262
264
|
},
|
|
@@ -364,7 +366,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
364
366
|
purpose: 'Open a PENDING row for one (task transition × registered webhook), before any delivery is attempted.',
|
|
365
367
|
outcome: 'Every delivery obligation is recorded up front, so an unreachable queue leaves a visible row rather than silence.',
|
|
366
368
|
responseStatuses: [
|
|
367
|
-
{ 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.' },
|
|
368
370
|
],
|
|
369
371
|
errorScenarios: [
|
|
370
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' },
|
|
@@ -375,7 +377,7 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
375
377
|
purpose: 'Advance a delivery through its lifecycle — claim it, then record the outcome.',
|
|
376
378
|
outcome: 'The row reflects what actually happened to the notification, including scheduled retries.',
|
|
377
379
|
responseStatuses: [
|
|
378
|
-
{ 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.' },
|
|
379
381
|
],
|
|
380
382
|
errorScenarios: [
|
|
381
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.' },
|
|
@@ -386,18 +388,28 @@ function buildA2APushDeliveryLogResourceSpecification(resourceType, resourceType
|
|
|
386
388
|
purpose: 'Remove a delivery row — retention purging, and the cleanup the owning user/org/app deletion cascades to.',
|
|
387
389
|
outcome: 'Delivery evidence does not outlive the tenant it describes.',
|
|
388
390
|
responseStatuses: [
|
|
389
|
-
{ 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.' },
|
|
390
392
|
],
|
|
391
393
|
errorScenarios: [
|
|
392
394
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No such row (already purged, or never existed).' },
|
|
393
395
|
],
|
|
394
396
|
idempotent: true,
|
|
395
397
|
},
|
|
398
|
+
[Op.UPDATE_MANY]: {
|
|
399
|
+
purpose: 'In-place scrub of retained rows when a data subject is erased.',
|
|
400
|
+
outcome: 'The delivery history survives for operational accounting while the personal data in it does not.',
|
|
401
|
+
responseStatuses: [
|
|
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
|
+
],
|
|
404
|
+
errorScenarios: [
|
|
405
|
+
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },
|
|
406
|
+
],
|
|
407
|
+
},
|
|
396
408
|
[Op.DELETE_MANY]: {
|
|
397
409
|
purpose: 'Bulk removal for retention windows and owner-scope teardown.',
|
|
398
410
|
outcome: 'Delivery history is bounded without a per-row round trip.',
|
|
399
411
|
responseStatuses: [
|
|
400
|
-
{ 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.' },
|
|
401
413
|
],
|
|
402
414
|
errorScenarios: [
|
|
403
415
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The filter fails validation.', errorCode: 'VALIDATION_FAILED' },
|