@wildo-ai/saas-specifications 1.1.2 → 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/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/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/compliance-documents/compliance-document-candidate.schemas.d.ts +10 -0
- 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 +17 -0
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.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/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/index.d.ts +1 -0
- package/dist/esm/_core/index.d.ts.map +1 -1
- package/dist/esm/_core/index.js +1 -0
- package/dist/esm/_core/index.js.map +1 -1
- package/dist/esm/_core/market/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/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.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/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/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/application-creation/application-coding-tasks.application-creation.schemas.d.ts +0 -4
- package/dist/esm/application-creation/application-coding-tasks.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +7 -7
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +6 -7
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.d.ts +3 -3
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js +3 -3
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts +2 -2
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js +2 -2
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/journey.application-creation.schemas.d.ts +18 -6
- package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/journey.application-creation.schemas.js +18 -6
- package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +8 -23
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js +57 -27
- package/dist/esm/application-creation/playbooks.application-creation.schemas.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 +72 -49
- package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.js +161 -60
- package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +25 -0
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-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-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 +14 -7
- package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js +24 -7
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +8 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.js +10 -2
- package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.d.ts +447 -11
- package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.js +293 -5
- package/dist/esm/assurance/assurance-program.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/companion-exports.d.ts +7 -6
- package/dist/esm/companion-exports.d.ts.map +1 -1
- package/dist/esm/companion-exports.js.map +1 -1
- package/dist/esm/engine/_bootstrap.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 +13 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts +2 -0
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +14 -2
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +9 -9
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.js +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js +3 -3
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +1 -1
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +13 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts +2 -0
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +14 -2
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts +32 -0
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js +308 -0
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -0
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +4 -4
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +2 -2
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +6 -6
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +9 -9
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js +2 -2
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts +9 -25
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +104 -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/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.map +1 -1
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +4 -3
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js +2 -2
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +3 -3
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/prices.resource.specification.js +7 -7
- package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/products.resource.specification.js +7 -7
- package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/promotions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/promotions.resource.specification.js +14 -12
- package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/referrals.resource.specification.js +7 -7
- package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +6 -3
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts +7 -3
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +28 -11
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +8 -8
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
- package/dist/esm/engine/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 +6 -2
- package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
- package/dist/esm/engine/engine-resource-sub-domain.d.ts +20 -0
- package/dist/esm/engine/engine-resource-sub-domain.d.ts.map +1 -1
- package/dist/esm/engine/engine-resource-sub-domain.js +66 -0
- package/dist/esm/engine/engine-resource-sub-domain.js.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.js +14 -0
- 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.js +3 -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.js +3 -3
- package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/resources/user-features.resource.specification.js +3 -3
- package/dist/esm/engine/features/resources/user-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/files/resources/files.resource.specification.js +10 -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.js +11 -11
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +4 -4
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +2 -2
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.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/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.js +12 -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.js +9 -9
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts +8 -0
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js +6 -6
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/index.d.ts +1 -0
- package/dist/esm/engine/index.d.ts.map +1 -1
- package/dist/esm/engine/index.js +1 -0
- package/dist/esm/engine/index.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +17 -17
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +7 -7
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js +8 -8
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts +7 -2
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +10 -5
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +20 -15
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js +11 -10
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +29 -6
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +9 -9
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js +3 -3
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js +4 -4
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +2 -2
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +7 -7
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
- package/dist/esm/engine/providers/_engine-provider-shared.d.ts +9 -0
- package/dist/esm/engine/providers/_engine-provider-shared.d.ts.map +1 -0
- package/dist/esm/engine/providers/_engine-provider-shared.js +19 -0
- package/dist/esm/engine/providers/_engine-provider-shared.js.map +1 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.js +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.js +7 -7
- package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +9 -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.js +2 -2
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +8 -8
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +4 -4
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +4 -4
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +2 -2
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +4 -4
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +13 -11
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js +1 -1
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self.resource.specification.js +8 -8
- 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 +93 -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.map +1 -1
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +95 -45
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts +37 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.js +36 -0
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.js.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +8 -8
- package/dist/assurance/external-framework-mapping.json +0 -980
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"users.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/users/resources/users.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n usersAdminResourceUIBehavior as usersAdminResourceUIBehaviorSource,\n usersMainResourceUIBehavior as usersMainResourceUIBehaviorSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport {\n CORE_APP_ROLES,\n CoreResourceOperation as Op,\n CoreUserNotificationTarget,\n RetentionStatus,\n ResourcePrimaryScope,\n UserSchema,\n UserStatus,\n Users_Operations,\n usersResourceConfiguration_InitializationFactory as usersFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n RETENTION_MARKER_FIELD_SPECS,\n} from '~wildo-specifications/_core';\n\nimport {\n USERS_API_REFERENCE_ORGANIZATION_ID,\n USERS_API_REFERENCE_USER_ID,\n usersApiReferenceContextExample,\n usersApiReferenceExample,\n usersApiReferencePage,\n usersApiReferenceSummaryExample,\n} from './users-api-reference.examples';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/*\n * Generic-parameter casts for the two preset UI behaviors. Pure typing\n * infrastructure — kept at module scope only because the\n * `ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>` generic\n * cannot be expressed inline at the call site without losing the\n * `as`-cast narrowing the framework relies on for variant-shape inference.\n */\ntype UsersResourceConfiguration = ReturnType<typeof usersFactory>;\ntype UsersCustomOperation = NonNullable<UsersResourceConfiguration['customOperation']>;\ntype UsersCoreOperation = UsersResourceConfiguration['coreOperations'][number];\ntype UsersMainSchema = UsersResourceConfiguration['mainSchema'];\n\nconst usersMainResourceUIBehavior = usersMainResourceUIBehaviorSource as ResourceUIBehaviorConfig<\n UsersCustomOperation,\n UsersCoreOperation,\n UsersMainSchema\n>;\n\nconst usersAdminResourceUIBehavior = usersAdminResourceUIBehaviorSource as ResourceUIBehaviorConfig<\n UsersCustomOperation,\n UsersCoreOperation,\n UsersMainSchema\n>;\n\n/*\n * DRY anchors for the engine USERS resource's per-operation admin-audit\n * email blocks. These two constants are referenced by every mutation\n * operation's `communications.email` block,\n * so a single source of truth keeps the audit voice and audience prose\n * consistent and prevents drift across the public mutations. Re-inlining\n * them per-operation would itself be a DRY violation and would dilute\n * the documented \"this is the admin-audit channel, not the user-facing\n * dispatch\" semantic anchor that justifies declaring these blocks at\n * all.\n */\nconst ADMIN_AUDIT_AUDIENCE = 'Application administrators monitoring the user-management ledger — internal audit trail, not the user-facing dispatch.';\nconst ADMIN_AUDIT_TONE = 'Operational and factual — surfaces what changed, who acted, and which user identity was affected, without dramatizing the event.';\n\n/**\n * Single, framework-owned `users` resource specification.\n *\n * **Why this is one named export but TWO nested factory calls.**\n * The framework intentionally separates spec assembly into two\n * load-bearing layers, both of which run here as nested arguments to\n * preserve the contract while keeping a single authoring surface:\n *\n * 1. `resourceSpecification(usersFactory, UserSchema, …)` builds the\n * domain-truth layer. It validates field shapes against the Zod\n * schema, validates `operations[].communications` against the\n * declared `resourcePrimaryScope`, validates `scheduledExecution`,\n * and stamps the resolved scope onto the returned config.\n * 2. `resourceSpecificationFromFrontendConfiguration(...)` wraps the\n * base with the **merged preset UI behaviors**\n * (`usersMainResourceUIBehavior` + `usersAdminResourceUIBehavior`).\n * It runs `validateFrontendSpecificationAgainstConfiguration(...)`\n * so a frontend-op variant declared in the spec but missing from\n * the presets fails closed at module load, derives\n * `surfacedOperations` from the merged UI behaviors, and merges\n * `base.frontend` with the authored frontend overlay via\n * `mergeFrontendSpecification(...)`.\n *\n * Collapsing into a single `resourceSpecification(...)` call would lose\n * the preset-validation gate, the surfaced-operations derivation, and\n * the merge step — i.e., a fail-closed contract would silently degrade\n * to a fail-open one. The two calls therefore remain, but the file\n * exposes only one named export so the entire spec reads as one\n * declaration.\n *\n * **Step 7 deferred follow-up #1 — `communications.email` blocks\n * (runtime parity contract).** Verified against\n * `engine/saas-models/src/users/users.shared.resources-config.schemas.ts`:\n * every USERS mutation operation declares exactly one\n * `userNotifications[]` entry, all targeting\n * `CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR` via\n * `CoreUserNotificationChannel.EMAIL`. These are administrator audit\n * emails — internal monitoring of the user-management ledger — NOT\n * the user-facing system templates that live in\n * `SystemEmailTemplateRegistry`. Read/List/Search operations have no\n * `userNotifications` and therefore no `communications.email` block\n * here either; the spec must mirror the runtime exactly so companion\n * prompts cannot invent an email surface that the engine never fires.\n *\n * **System-template cross-link is intentionally NOT declared via\n * `email.deliveries[i].systemEmailTemplateRef`.** That field is only\n * valid when the resource operation's runtime fan-out actually fires\n * a system template; today the engine USERS resource does not — the\n * user-facing `PASSWORD_RESET` / `ORGANIZATION_INVITATION` /\n * `SECURITY_ALERT` / `ORGANIZATION_MEMBER_REMOVED` templates are\n * dispatched by separate services (auth, organization, notifications)\n * outside the resource-operation `userNotifications` plumbing.\n * Cross-references are captured in `notes` so companion prompts know\n * where to look without the spec asserting a fan-out the runtime\n * would not produce. When a future engine workstream wires the\n * system templates through the resource-operation fan-out, replace\n * the prose note with a real `systemEmailTemplateRef` cross-link\n * (the `assertSystemEmailTemplateCrossLink` validator will then pin\n * the cross-package contract).\n */\nexport const usersResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(\n resourceFrontendConfiguration(usersMainResourceUIBehavior),\n resourceFrontendConfiguration(usersAdminResourceUIBehavior),\n ),\n resourceSpecification(\n usersFactory,\n UserSchema,\n ({ schemaShape }) => ({\n purpose: 'Represent an application-known person or actor that can authenticate, receive permissions, and participate in application scope.',\n businessRole: 'Administrative identity record used to manage who can access the application and under which authority posture.',\n lifecycleRole: 'Moves through invitation, verification, active usage, suspension, and deactivation states under administrative governance.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.USERS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'UserSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'usersResourceConfiguration_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: 'USERS',\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 customEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'Users_Operations',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n frontendConfigurationSources: [\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'usersMainResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'usersAdminResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n ],\n notes: [\n 'Frontend-facing prose should be authored from the merged main+admin UI behavior contributions, not from one raw leaf in isolation.',\n ],\n },\n\n /**\n * `USERS` / `USER_SELF` declare `retentionPolicy`, so the resource factory injects the two\n * retention markers. They are absent from `UserSchema`, so the field-spec extractor cannot see\n * them and they must be declared here — see `RETENTION_MARKER_FIELD_SPECS` for why the documented\n * meaning is load-bearing on fields that render nowhere.\n */\n additionalFieldSpecs: [...RETENTION_MARKER_FIELD_SPECS],\n\n fields: {\n email: schemaShape.email.stringSpec({\n meaning: 'Canonical contact and identity anchor for the user inside the application.',\n whyItMatters: 'It is the main administrative lookup point and the primary human-facing identity reference during onboarding and support.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Current access/lifecycle state of the user account.',\n whyItMatters: 'This tells the system and operators whether the user should be able to enter the application, is still onboarding, or has been restricted.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'UserStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [UserStatus.ACTIVE]: { meaning: 'Full access — the user can use the application normally.' },\n [UserStatus.INACTIVE]: { meaning: 'Deactivated — the account exists but access is removed.' },\n [UserStatus.SUSPENDED]: { meaning: 'Temporarily blocked — access intentionally interrupted, reinstatement possible.' },\n [UserStatus.PENDING_VERIFICATION]: { meaning: 'Account created but the user has not verified their identity yet.' },\n [UserStatus.PENDING_INVITATION]: { meaning: 'Invitation sent but the user has not accepted it yet.' },\n [UserStatus.DELETED]: { meaning: 'Soft-deleted — the identity record is retained for audit but is no longer usable.' },\n },\n }),\n\n scheduledReactivationAt: schemaShape.scheduledReactivationAt.dateSpec({\n meaning: 'When the automated suspension sweep returns this account to ACTIVE. Written only by admin SUSPEND_USER from its optional `suspensionDuration` in DAYS; voluntary self-deactivation has no schedule and returns only when its subject calls REACTIVATE_ACCOUNT. Absent means the current lifecycle state has no automatic return.',\n whyItMatters: 'The stable field name lets the reactivation sweep query the same scheduling coordinate on user and organization-member rows. It is server-owned and written only by guarded lifecycle transitions. Deliberately not audit evidence: it does not decide what the principal may do, and the transition’s own audit event already records the reason and resulting status.',\n }),\n\n appRoles: schemaShape.appRoles.arraySpec({\n meaning: 'Application-level authority granted to the user.',\n whyItMatters: 'Roles drive permission posture and therefore change what the user is allowed to see or do across the product.',\n elementMeaning: 'Each role grants a discrete set of permissions for application features.',\n importance: FieldSemanticImportance.PRIMARY,\n elementType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CORE_APP_ROLES',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n notes: [\n 'Import role members from the shared framework role vocabulary rather than re-authoring raw role strings.',\n 'Element schema is a union of the framework enum and free-form tenant-defined role strings; both branches are surfaced via the framework-derived array element metadata.',\n ],\n },\n }),\n\n userTypes: schemaShape.userTypes.arraySpec({\n meaning: 'Business/authentication category used to apply different enrollment, policy, and user-journey rules.',\n whyItMatters: 'This field often determines which auth policy, registration path, or product posture applies to a user beyond raw roles.',\n elementMeaning: 'Each type tag represents a classification that can drive conditional behavior across the application.',\n elementType: {\n notes: [\n 'Values are application-declared userType keys from backend configuration, not a fixed framework enum.',\n ],\n },\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Retrieve a known user identity record.',\n outcome: 'The caller receives the user representation authorized for this route.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The addressed user identity record was found and the route-specific representation is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to read the addressed user through this route.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the route’s authorized scope.' },\n ],\n idempotent: true,\n variants: {\n default: {\n purpose: 'Read the authenticated caller’s own user identity record without entering an administration workflow.',\n outcome: 'The caller receives their own complete user identity representation.',\n whenToUse: 'Use when an authenticated client needs the caller’s identity anchor, current account status, roles or user classifications.',\n examples: [\n {\n title: 'Read the authenticated user identity',\n request: { userId: USERS_API_REFERENCE_USER_ID },\n response: usersApiReferenceExample,\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n context: {\n purpose: 'Read the authenticated caller’s own user identity together with its available relationship context.',\n outcome: 'The caller receives their user record plus the profile and organization-membership context exposed by this representation.',\n whenToUse: 'Use when a client must bootstrap identity-aware application context without issuing separate profile and membership reads.',\n examples: [\n {\n title: 'Read the authenticated user with relationship context',\n request: { userId: USERS_API_REFERENCE_USER_ID },\n response: usersApiReferenceContextExample,\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n summary: {\n purpose: 'Read a compact representation of the authenticated caller’s own user identity.',\n outcome: 'The caller receives only the identity, email, status and creation timestamp required by lightweight user surfaces.',\n whenToUse: 'Use when a compact identity representation is sufficient and the complete user record is unnecessary.',\n examples: [\n {\n title: 'Read the authenticated user summary',\n request: { userId: USERS_API_REFERENCE_USER_ID },\n response: usersApiReferenceSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n admin: {\n purpose: 'Read a user in administrator workflows with management-focused context.',\n outcome: 'The administrator receives the current management representation of the addressed user.',\n whenToUse: 'Use when the caller is acting in a user-governance posture rather than a normal end-user flow.',\n examples: [\n {\n title: 'Read one managed user',\n request: { userId: USERS_API_REFERENCE_USER_ID },\n response: usersApiReferenceExample,\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Browse collections of known users.',\n outcome: 'The caller can iterate through a user set instead of addressing one identity directly.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of user identity records matching the supplied governance filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to enumerate the user directory.' },\n ],\n idempotent: true,\n variants: {\n default: {\n purpose: 'Provide internal non-HTTP user enumeration for supporting flows that need user lists behind the scenes.',\n whenToUse: 'Use when infrastructure or internal service logic needs a user collection without exposing a user-management route.',\n },\n admin: {\n purpose: 'Provide the administrable user directory surface.',\n whenToUse: 'Use when an operator needs to browse the user base as part of management or support work.',\n examples: [\n {\n title: 'List active managed users',\n request: {\n organizationId: USERS_API_REFERENCE_ORGANIZATION_ID,\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n },\n response: usersApiReferencePage(),\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Locate users by email (own field) and, through the linked user profile, by first/last/display name. Also powers org-scoped people pickers (e.g. a `createdByUserId` filter), where results are constrained to the caller’s organization.',\n outcome: 'Administrators and org-scoped pickers can narrow the user population to the relevant identity subset by email or name quickly.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of user identity records whose email, or whose linked profile’s first/last/display name, matches the search query.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to search the user population.' },\n ],\n idempotent: true,\n variants: {\n admin: {\n purpose: 'Expose admin-grade user lookup across identity attributes and governance filters.',\n whenToUse: 'Use when the operator knows part of the target identity or needs filtered user discovery.',\n examples: [\n {\n title: 'Search active users by name or email',\n request: {\n organizationId: USERS_API_REFERENCE_ORGANIZATION_ID,\n q: 'alex',\n status: UserStatus.ACTIVE,\n page: 1,\n limit: 20,\n sort: 'email:asc',\n },\n response: usersApiReferencePage(),\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n },\n },\n\n [Op.CREATE]: {\n purpose: 'Create a managed user identity record.',\n outcome: 'A new application-known person can be onboarded into the user-governance lifecycle.',\n whenToUse: 'Use when an administrator must explicitly introduce a new user into the application.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A new user identity record was provisioned and is returned with its server-assigned id.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The email is missing/malformed or the user payload fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to provision new users.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The payload assigns an `appRoles` entry outside the caller’s own role ceiling — a principal cannot provision a user carrying authority it does not itself hold. Omitting `appRoles` applies the schema default instead and is never measured against the ceiling.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'Another user identity already exists with the supplied email (the canonical identity anchor must be unique).' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Provision a new managed user',\n request: {\n email: 'new.member@example.com',\n status: UserStatus.PENDING_INVITATION,\n appRoles: [CORE_APP_ROLES.APP_USER],\n userTypes: ['employee'],\n },\n response: {\n _id: 'user_01HX2…',\n email: 'new.member@example.com',\n status: UserStatus.PENDING_INVITATION,\n appRoles: [CORE_APP_ROLES.APP_USER],\n userTypes: ['employee'],\n createdAt: '2026-08-20T09:00:00.000Z',\n updatedAt: '2026-08-20T09:00:00.000Z',\n // retention-authority: N/A — a DOCUMENTATION example pinning the wire value the\n // generated `UsersCreateResponse` DTO really carries (default `active`); no\n // predicate, no visibility decision, and a specification layer cannot consume the\n // backend emitter regardless.\n retentionStatus: RetentionStatus.ACTIVE,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a new user identity was provisioned so the user-governance team has an auditable trail of every onboarding event.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'A new user identity record is created via the administrative create flow.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a new user identity was provisioned and identify which user.',\n },\n },\n eventData: {\n purpose: 'Describe the create payload: the new user identity, the administrator who created it, and the initial role / status posture.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime CREATE operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'No user-facing welcome email fires from this operation today — `SystemEmailTemplateRef.WELCOME_EMAIL` is dispatched by the auth/onboarding service after the user accepts the invitation, not from the resource-operation fan-out.',\n ],\n },\n },\n },\n\n [Op.UPDATE]: {\n purpose: 'Modify the role set or application-defined user classifications on an existing user record.',\n outcome: 'The target user keeps the same identity record with updated `appRoles` and/or `userTypes`; identity and lifecycle fields remain unchanged.',\n whenToUse: 'Use for record maintenance. This operation CAN also rewrite `appRoles`, but it replaces the whole array — prefer the dedicated `assign_roles` / `revoke_roles` verbs for an authority change, which apply an additive or subtractive delta and so cannot clobber a concurrent edit.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The user record was updated and the new administrative state is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The supplied `appRoles` or `userTypes` values fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to edit another user’s record.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The edit sets an `appRoles` entry outside the caller’s own role ceiling. Because this operation replaces the whole array, every entry it names is treated as caller-authored — including roles the user already held.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The edit would remove the LAST administratively usable application super-administrator by rewriting `appRoles` so it no longer confers `APP_ADMIN_SUPER_ADMIN`. Grant the role to another active user first. Carries the stable client-branchable `code: LAST_SUPER_ADMINISTRATOR`.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Replace a user classification without rewriting roles',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n userTypes: ['employee', 'support'],\n },\n response: {\n ...usersApiReferenceExample,\n userTypes: ['employee', 'support'],\n updatedAt: '2026-08-20T10:15:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that an existing user record was edited so the user-governance team can audit non-trivial profile or status changes.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator updates governance-relevant attributes on a user record.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a user record was updated and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the update payload: the affected user identity, the administrator who acted, and which fields changed.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime UPDATE operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'No dedicated user-facing system template exists for generic profile updates — security-sensitive edits surface separately via `SystemEmailTemplateRef.SECURITY_ALERT`, dispatched by the security service.',\n ],\n },\n },\n },\n\n [Op.DELETE]: {\n purpose: 'Remove a user identity record from normal operational use.',\n outcome: 'The user is no longer treated as an active administrative identity in the application lifecycle.',\n whenToUse: 'Use only when the business decision is true removal, not temporary suspension or narrower access.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The user identity record was removed; no body is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the high-trust governance authority required to remove a user identity.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The operation declares `requiresStepUpAuthentication`, and the request carried no valid single-use re-authentication token. Obtain one from the re-authentication route and retry with it — holding a valid session is deliberately not sufficient for irreversible identity destruction.', errorCode: 'STEP_UP_REQUIRED' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id (or it was already removed).' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The user still owns dependent records (organization memberships, owned resources) that block hard removal; resolve or reassign them first.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The target is the LAST administratively usable application super-administrator. Destroying the row that holds the last application authority locks the application out exactly as revoking the role would, so it is refused on the same terms — grant the role to another active user first. Carries the stable client-branchable `code: LAST_SUPER_ADMINISTRATOR`.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Remove one managed user',\n request: { userId: USERS_API_REFERENCE_USER_ID },\n forStatus: HttpResponseStatusCode.NO_CONTENT_204,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a user identity was removed so the user-governance team has an auditable trail of every removal event.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator deletes a user identity record.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a user identity was removed and identify which user.',\n },\n },\n eventData: {\n purpose: 'Describe the delete payload: the removed user identity and the administrator who initiated removal.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime DELETE operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'When the deletion happens via organization-membership removal, the user-facing `SystemEmailTemplateRef.ORGANIZATION_MEMBER_REMOVED` is dispatched by the organization service — not from this resource-operation fan-out.',\n ],\n },\n },\n },\n\n [Users_Operations.ASSIGN_ROLES]: {\n operationId: Users_Operations.ASSIGN_ROLES,\n purpose: 'Grant or widen the authority posture of an existing user.',\n outcome: 'The user gains application permissions that change their effective access surface.',\n whenToUse: 'Use when the administrative intent is permission delegation, not profile maintenance. The named roles are ADDED to the roles the user already holds — this is a delta, not a replacement, so it never drops authority the request did not mention. Re-granting a held role is a no-op that still answers 200.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The requested roles are present on the user and the updated identity record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'A supplied role is unknown to the application role vocabulary or the payload is malformed.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the authority to delegate the requested roles (e.g. cannot grant a role they do not themselves hold).' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Grant an application administration role',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n roles: [CORE_APP_ROLES.APP_ADMIN_VIEWER],\n reason: 'Provide read-only access for the quarterly access review.',\n },\n response: {\n ...usersApiReferenceExample,\n appRoles: [\n CORE_APP_ROLES.APP_USER,\n CORE_APP_ROLES.APP_ADMIN_VIEWER,\n ],\n updatedAt: '2026-08-20T10:30:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a user gained one or more roles so the user-governance team can audit privilege widening.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator assigns one or more application roles to an existing user.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that roles were granted and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the role-grant payload: the affected user, the granted roles, and the administrator who acted.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime ASSIGN_ROLES operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'No dedicated user-facing system template exists for role-grant events — the user typically learns about the change through the in-app permissions surface, not a dedicated email.',\n ],\n },\n },\n },\n\n [Users_Operations.REVOKE_ROLES]: {\n operationId: Users_Operations.REVOKE_ROLES,\n purpose: 'Reduce or remove previously granted authority from a user.',\n outcome: 'The user loses one or more permission-bearing roles and therefore a narrower access surface applies.',\n whenToUse: 'Use when the administrative intent is access reduction, offboarding, or separation-of-duty correction. Only the named roles are REMOVED — this is a delta, not a replacement. Revoking every remaining role is permitted and leaves the user with none, which withdraws application access without deleting the identity; `assign_roles` restores it. The ONE exception is the application super-administrator floor: the last usable super-administrator cannot be demoted, because no in-product path could then appoint another.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The requested roles are no longer present on the user and the updated identity record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'A supplied role is unknown to the application role vocabulary or the payload is malformed.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the authority to revoke the requested roles (e.g. separation-of-duty restriction).' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The revocation would remove the LAST administratively usable application super-administrator (an ACTIVE user holding a role that confers `APP_ADMIN_SUPER_ADMIN`, directly or by inheritance). Grant the role to another active user first. Not a 403: the caller IS authorized — the current state of the application forbids it. Carries the stable client-branchable `code: LAST_SUPER_ADMINISTRATOR` so a client can branch without parsing the message.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Revoke one application administration role',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n roles: [CORE_APP_ROLES.APP_ADMIN_VIEWER],\n reason: 'The temporary access-review assignment has ended.',\n },\n response: {\n ...usersApiReferenceExample,\n appRoles: [CORE_APP_ROLES.APP_USER],\n updatedAt: '2026-08-20T11:00:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a user lost one or more roles so the user-governance team can audit privilege narrowing.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator revokes one or more application roles from a user.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that roles were revoked and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the role-revoke payload: the affected user, the revoked roles, and the administrator who acted.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime REVOKE_ROLES operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'No dedicated user-facing system template exists for role-revoke events — the user typically learns about the change through the in-app permissions surface, not a dedicated email.',\n ],\n },\n },\n },\n\n [Users_Operations.SUSPEND_USER]: {\n operationId: Users_Operations.SUSPEND_USER,\n purpose: 'Temporarily block a user from normal access without deleting the identity record.',\n outcome: 'The user remains known to the application, but their operational access is intentionally interrupted. `suspensionDuration` is expressed in DAYS and is resolved to an absolute instant at write time — a duration has no meaning without the moment it is counted from, and the row records no such moment — after which an hourly sweep lifts the suspension automatically by running the ordinary UNSUSPEND_USER verb, so the same state machine and administrative floors apply. Omitting it means the suspension is indefinite.',\n whenToUse: 'Use when you need immediate access restriction while preserving auditability and potential reinstatement. The ONE exception is the application super-administrator floor: the last usable super-administrator cannot be suspended, because suspension removes the only status that can authenticate and no in-product path could then appoint another.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The user account is in the suspended state and the updated identity record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to suspend a user account.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The account is not ACTIVE, so suspension is not a legal transition from its current state (already suspended, soft-deleted, or still pending verification/invitation). Carries `resource_status_transition_conflict`, whose context names the current status, the target status and the permitted source statuses. Most callers meet the earlier `enabledCondition` gate (403) instead; this reference covers the paths that gate does not reach.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The target is the LAST administratively usable application super-administrator. Suspending them moves the sole administrator out of ACTIVE — the only status that can authenticate — which locks the application out exactly as revoking the role would, so it is refused on the same terms. Grant the role to another active user first. Not a 403: the caller IS authorized; the current state of the application forbids it. Carries the stable client-branchable `code: LAST_SUPER_ADMINISTRATOR`.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Suspend access for fourteen days',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n reason: 'Temporary access hold during a security review.',\n suspensionDuration: 14,\n notifyUser: true,\n },\n response: {\n ...usersApiReferenceExample,\n status: UserStatus.SUSPENDED,\n scheduledReactivationAt: '2026-09-03T11:30:00.000Z',\n updatedAt: '2026-08-20T11:30:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a user account was suspended so the user-governance and security teams can audit access interruptions.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator suspends a user account.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a user account was suspended and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the suspension payload: the affected user, the administrator who acted, and any documented reason.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime SUSPEND_USER operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'When the suspension is security-driven, a separate `SystemEmailTemplateRef.SECURITY_ALERT` may be dispatched to the affected user by the security service — outside this resource-operation fan-out.',\n ],\n },\n },\n },\n\n [Users_Operations.UNSUSPEND_USER]: {\n operationId: Users_Operations.UNSUSPEND_USER,\n purpose: 'Restore a previously suspended user to an active operational posture.',\n outcome: 'The user can resume normal access under the currently assigned authority set. Any pending automatic-reactivation deadline is CLEARED, so an account reinstated by hand does not carry the sweep’s old date into a later suspension.',\n whenToUse: 'Use when an earlier suspension has been resolved and access should be reinstated.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The user account is no longer suspended and the updated identity record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to reinstate a user account.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The account is not SUSPENDED, so there is no suspension to reverse. Notably an INACTIVE account — one the user voluntarily deactivated through the self door — is refused here rather than reinstated: an imposed suspension and a chosen deactivation are distinct states with distinct remedies, and merging them into one verb would let an administrator silently undo a user’s own decision. Carries `resource_status_transition_conflict` with the current and permitted statuses in its context.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Restore a suspended user',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n reason: 'The security review completed successfully.',\n notifyUser: true,\n },\n response: {\n ...usersApiReferenceExample,\n status: UserStatus.ACTIVE,\n updatedAt: '2026-08-20T12:00:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a previously suspended user account was reinstated so the user-governance team can audit access-restoration events.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator reverses a prior suspension on a user account.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a user account was reinstated and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the reinstatement payload: the affected user and the administrator who acted.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime UNSUSPEND_USER operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'No dedicated user-facing system template exists for reinstatement — the user simply regains access on next sign-in.',\n ],\n },\n },\n },\n\n [Users_Operations.FORCE_PASSWORD_RESET]: {\n operationId: Users_Operations.FORCE_PASSWORD_RESET,\n purpose: 'Compel a credential reset as a security or recovery action.',\n outcome: 'The target’s live sessions are revoked and a single-use reset link is mailed to them, so they must re-establish a password before regaining password-based access.',\n whenToUse: 'Use for account recovery, suspected compromise, or mandatory credential rotation events.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The reset was forced: sessions revoked and a single-use link mailed to the target. The response carries the link’s expiry, never the link or token itself.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the security/governance authority required to force a credential reset, or the execution carries no attributable principal to record as the actor.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The target account is soft-deleted, so it has no credential path to reset.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'No documented `reason` was supplied, or the caller addressed their own account — self-service credential change belongs to the authenticated password-change route, which proves knowledge of the current password.' },\n ],\n idempotent: false,\n rateLimitNote: 'Rate-sensitive: forcing repeated resets dispatches reset tokens; operators should throttle bulk rotations to avoid flooding affected users.',\n examples: [\n {\n title: 'Force credential recovery after suspected compromise',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n reason: 'Credential exposure was reported by the security team.',\n },\n response: {\n expiresAt: '2026-08-20T13:00:00.000Z',\n sessionsRevoked: true,\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a credential-reset was forced on a user account so the user-governance and security teams can audit recovery and rotation events.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator forces a credential reset on a user account.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a forced credential reset was triggered and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the forced-reset payload: the affected user, the administrator who acted, and the documented reason.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime FORCE_PASSWORD_RESET operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'The user-facing reset email is `SystemEmailTemplateRef.PASSWORD_RESET`, dispatched by the auth service when the reset token is generated — not from this resource-operation fan-out. When a future engine workstream wires that dispatch through `userNotifications`, replace this prose note with a `systemEmailTemplateRef: SystemEmailTemplateRef.PASSWORD_RESET` cross-link on a new USER_SELF delivery.',\n 'That user-facing mail carries the ONLY copy of the reset link. The operation response deliberately withholds it: handing an administrator a link that sets another account’s password would let them authenticate as that user — unnoticed by the owner and, absent an actor claim on session tokens, indistinguishable downstream from a genuine login. The token TTL is likewise a framework policy constant rather than a caller-supplied window.',\n 'Beyond this admin-audit mail, the operation emits the `USER_PASSWORD_RESET_FORCED` audit event (severity CRITICAL) naming the acting administrator, the target, and the documented reason — deliberately distinct from the self-service `USER_PASSWORD_RESET_REQUESTED`, which has no actor field and would credit the account owner with the administrator’s action.',\n ],\n },\n },\n },\n\n },\n\n businessConstraints: [\n 'This resource is an administrative identity record, not the self-service profile-editing surface; self-service changes belong on `user_self` and related profile/preference resources.',\n 'Role and lifecycle operations on users should be treated as governance actions because they affect access posture, not only cosmetic account data.',\n 'The `users` resource should remain centered on identity governance and access administration, not become the dumping ground for every piece of personal profile information.',\n 'Erasing a subject SCRUBS AND RETAINS this row rather than deleting it: the email is masked to an unreachable placeholder and the record is marked retained, so retained financial records whose foreign keys point at the person still resolve — to an anonymized subject. A retained row is hidden from every normal read and frozen against writes; only an audited see-through read reaches it.',\n 'The bulk-update operation exists solely to let the trusted erasure writer scrub rows in place, and is deliberately not exposed over HTTP — a bulk user mutation route would allow mass role and status rewrites. Treat it as a capability, never as an administrative surface to build on.',\n 'Retention decisions here bind `user_self` too: it is a second resource over the same underlying user records, so the two must always declare the same retention posture or an erased identity stays reachable through the self-service door.',\n ],\n }),\n // Phase 4.5 Step 2 (F-1): explicit scope declaration. The USERS resource\n // is the self-anchor for the USER_SELF scope (see\n // `PRIMARY_SCOPE_TO_CORE_RESOURCE_TYPE` in\n // `engine/saas-models/src/resources/resources.shared.schemas.ts` — the\n // registry-layer factory's branch-2 self-anchor lookup resolves\n // USERS → USER_SELF). The post-factory cross-check (Phase 4.5 Step 2.5,\n // tracked) is the right layer to enforce that this declared value\n // matches the registry-assembled scope.\n { resourcePrimaryScope: ResourcePrimaryScope.USER_SELF },\n ),\n () => ({\n label: {\n purpose: 'Use the email as the stable human-facing identity anchor whenever the frontend needs to identify a user succinctly in supporting or administrative contexts.',\n textSlots: {\n label: {\n purpose: 'Name the resource as a managed user identity, typically represented by the email-backed identity anchor.',\n },\n },\n },\n layout: {\n purpose: 'Organize user information by governance meaning so operators can distinguish identity facts, permission posture, and lifecycle evidence at a glance.',\n displayPurpose: 'Present the user record as an administrative identity card rather than a broad social/profile page.',\n summaryPurpose: 'Provide a compact user identity snapshot for relationship-heavy surfaces such as assignments, lookups, and related-object summaries.',\n editPurpose: 'Keep mutable governance inputs focused on the fields administrators are expected to curate directly.',\n sections: {\n overview: {\n purpose: 'Anchor the record around the core identifying attributes and current account state.',\n whenToUse: 'Use this section for the fields an operator must read first to verify who the user is and whether the account is currently usable.',\n textSlots: {\n title: {\n purpose: 'Label this section as the primary identity overview rather than as permissions or audit history.',\n },\n description: {\n purpose: 'Explain that the section helps operators verify the user identity and present usability state at a glance.',\n },\n },\n },\n access: {\n purpose: 'Group the permission-bearing and classification fields that directly affect what the user may access.',\n whenToUse: 'Use this section when the task is authority review, delegation, or access troubleshooting.',\n textSlots: {\n title: {\n purpose: 'Label this section as the access-and-permissions area of the user record.',\n },\n description: {\n purpose: 'Explain that the section is about authorization posture and classifications that affect access.',\n },\n },\n },\n lifecycle: {\n purpose: 'Expose timestamped lifecycle evidence and historical state context around the managed identity.',\n whenToUse: 'Use this section when the operator needs chronology and audit-oriented context rather than editable governance controls.',\n textSlots: {\n title: {\n purpose: 'Label this section as lifecycle or audit history instead of active permission controls.',\n },\n description: {\n purpose: 'Explain that the section captures chronology, timestamps, and historical context around the identity.',\n },\n },\n },\n },\n },\n views: {\n [Op.READ]: {\n variants: {\n default: {\n purpose: 'Surface user read in the main application only as a lightweight supporting view.',\n whenToUse: 'Use when end-user workflows need to resolve who a referenced user is without turning the users resource into a full end-user management surface.',\n },\n admin: {\n purpose: 'Surface the user detail view inside administration workflows.',\n whenToUse: 'Use when the operator is already in user governance and needs a focused detail panel for one identity.',\n },\n },\n },\n\n [Op.LIST]: {\n variants: {\n admin: {\n purpose: 'Surface the administrator-facing user-management directory.',\n whenToUse: 'Use when an operator needs to browse users as a managed collection rather than resolving a single known identity.',\n },\n },\n },\n\n [Op.SEARCH]: {\n variants: {\n admin: {\n purpose: 'Surface administrative user search and filtering by email or (via the linked profile) name.',\n whenToUse: 'Use when support, compliance, or administration needs fast identity lookup across the user population, or when an org-scoped picker resolves users by name/email.',\n },\n },\n },\n\n [Op.CREATE]: {\n purpose: 'Surface administrator-driven user creation.',\n whenToUse: 'Use when the product exposes explicit user provisioning to administrators.',\n },\n\n [Op.UPDATE]: {\n purpose: 'Surface administrator-driven edits to managed user records.',\n whenToUse: 'Use when the operator is curating the authoritative user record rather than acting through self-service flows.',\n },\n\n [Op.DELETE]: {\n purpose: 'Surface destructive administrative removal of a user.',\n whenToUse: 'Use only in high-trust governance workflows where removal is intentional and understood.',\n },\n\n [Users_Operations.ASSIGN_ROLES]: {\n purpose: 'Surface role-assignment as a first-class administrative action.',\n },\n\n [Users_Operations.REVOKE_ROLES]: {\n purpose: 'Surface role revocation as a first-class administrative action.',\n },\n\n [Users_Operations.SUSPEND_USER]: {\n purpose: 'Surface suspension directly in user-governance workflows.',\n },\n\n [Users_Operations.UNSUSPEND_USER]: {\n purpose: 'Surface reactivation of suspended users in user-governance workflows.',\n },\n\n [Users_Operations.FORCE_PASSWORD_RESET]: {\n purpose: 'Surface credential-reset enforcement for security operators and administrators.',\n },\n\n },\n }),\n);\n"]}
|
|
1
|
+
{"version":3,"file":"users.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/users/resources/users.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n usersAdminResourceUIBehavior as usersAdminResourceUIBehaviorSource,\n usersMainResourceUIBehavior as usersMainResourceUIBehaviorSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport {\n CORE_APP_ROLES,\n CoreResourceOperation as Op,\n CoreUserNotificationTarget,\n RetentionStatus,\n ResourcePrimaryScope,\n UserSchema,\n UserStatus,\n Users_Operations,\n usersResourceConfiguration_InitializationFactory as usersFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n RETENTION_MARKER_FIELD_SPECS,\n} from '~wildo-specifications/_core';\n\nimport {\n USERS_API_REFERENCE_ORGANIZATION_ID,\n USERS_API_REFERENCE_USER_ID,\n usersApiReferenceContextExample,\n usersApiReferenceExample,\n usersApiReferencePage,\n usersApiReferenceSummaryExample,\n} from './users-api-reference.examples';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\n/*\n * Generic-parameter casts for the two preset UI behaviors. Pure typing\n * infrastructure — kept at module scope only because the\n * `ResourceUIBehaviorConfig<TCustomOp, TCoreOp, TSchema>` generic\n * cannot be expressed inline at the call site without losing the\n * `as`-cast narrowing the framework relies on for variant-shape inference.\n */\ntype UsersResourceConfiguration = ReturnType<typeof usersFactory>;\ntype UsersCustomOperation = NonNullable<UsersResourceConfiguration['customOperation']>;\ntype UsersCoreOperation = UsersResourceConfiguration['coreOperations'][number];\ntype UsersMainSchema = UsersResourceConfiguration['mainSchema'];\n\nconst usersMainResourceUIBehavior = usersMainResourceUIBehaviorSource as ResourceUIBehaviorConfig<\n UsersCustomOperation,\n UsersCoreOperation,\n UsersMainSchema\n>;\n\nconst usersAdminResourceUIBehavior = usersAdminResourceUIBehaviorSource as ResourceUIBehaviorConfig<\n UsersCustomOperation,\n UsersCoreOperation,\n UsersMainSchema\n>;\n\n/*\n * DRY anchors for the engine USERS resource's per-operation admin-audit\n * email blocks. These two constants are referenced by every mutation\n * operation's `communications.email` block,\n * so a single source of truth keeps the audit voice and audience prose\n * consistent and prevents drift across the public mutations. Re-inlining\n * them per-operation would itself be a DRY violation and would dilute\n * the documented \"this is the admin-audit channel, not the user-facing\n * dispatch\" semantic anchor that justifies declaring these blocks at\n * all.\n */\nconst ADMIN_AUDIT_AUDIENCE = 'Application administrators monitoring the user-management ledger — internal audit trail, not the user-facing dispatch.';\nconst ADMIN_AUDIT_TONE = 'Operational and factual — surfaces what changed, who acted, and which user identity was affected, without dramatizing the event.';\n\n/**\n * Single, framework-owned `users` resource specification.\n *\n * **Why this is one named export but TWO nested factory calls.**\n * The framework intentionally separates spec assembly into two\n * load-bearing layers, both of which run here as nested arguments to\n * preserve the contract while keeping a single authoring surface:\n *\n * 1. `resourceSpecification(usersFactory, UserSchema, …)` builds the\n * domain-truth layer. It validates field shapes against the Zod\n * schema, validates `operations[].communications` against the\n * declared `resourcePrimaryScope`, validates `scheduledExecution`,\n * and stamps the resolved scope onto the returned config.\n * 2. `resourceSpecificationFromFrontendConfiguration(...)` wraps the\n * base with the **merged preset UI behaviors**\n * (`usersMainResourceUIBehavior` + `usersAdminResourceUIBehavior`).\n * It runs `validateFrontendSpecificationAgainstConfiguration(...)`\n * so a frontend-op variant declared in the spec but missing from\n * the presets fails closed at module load, derives\n * `surfacedOperations` from the merged UI behaviors, and merges\n * `base.frontend` with the authored frontend overlay via\n * `mergeFrontendSpecification(...)`.\n *\n * Collapsing into a single `resourceSpecification(...)` call would lose\n * the preset-validation gate, the surfaced-operations derivation, and\n * the merge step — i.e., a fail-closed contract would silently degrade\n * to a fail-open one. The two calls therefore remain, but the file\n * exposes only one named export so the entire spec reads as one\n * declaration.\n *\n * **Step 7 deferred follow-up #1 — `communications.email` blocks\n * (runtime parity contract).** Verified against\n * `engine/saas-models/src/users/users.shared.resources-config.schemas.ts`:\n * every USERS mutation operation declares exactly one\n * `userNotifications[]` entry, all targeting\n * `CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR` via\n * `CoreUserNotificationChannel.EMAIL`. These are administrator audit\n * emails — internal monitoring of the user-management ledger — NOT\n * the user-facing system templates that live in\n * `SystemEmailTemplateRegistry`. Read/List/Search operations have no\n * `userNotifications` and therefore no `communications.email` block\n * here either; the spec must mirror the runtime exactly so companion\n * prompts cannot invent an email surface that the engine never fires.\n *\n * **System-template cross-link is intentionally NOT declared via\n * `email.deliveries[i].systemEmailTemplateRef`.** That field is only\n * valid when the resource operation's runtime fan-out actually fires\n * a system template; today the engine USERS resource does not — the\n * user-facing `PASSWORD_RESET` / `ORGANIZATION_INVITATION` /\n * `SECURITY_ALERT` / `ORGANIZATION_MEMBER_REMOVED` templates are\n * dispatched by separate services (auth, organization, notifications)\n * outside the resource-operation `userNotifications` plumbing.\n * Cross-references are captured in `notes` so companion prompts know\n * where to look without the spec asserting a fan-out the runtime\n * would not produce. When a future engine workstream wires the\n * system templates through the resource-operation fan-out, replace\n * the prose note with a real `systemEmailTemplateRef` cross-link\n * (the `assertSystemEmailTemplateCrossLink` validator will then pin\n * the cross-package contract).\n */\nexport const usersResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(\n resourceFrontendConfiguration(usersMainResourceUIBehavior),\n resourceFrontendConfiguration(usersAdminResourceUIBehavior),\n ),\n resourceSpecification(\n usersFactory,\n UserSchema,\n ({ schemaShape }) => ({\n purpose: 'Represent an application-known person or actor that can authenticate, receive permissions, and participate in application scope.',\n businessRole: 'Administrative identity record used to manage who can access the application and under which authority posture.',\n lifecycleRole: 'Moves through invitation, verification, active usage, suspension, and deactivation states under administrative governance.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.USERS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'UserSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'usersResourceConfiguration_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: 'USERS',\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 customEnum: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'Users_Operations',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n },\n frontendConfigurationSources: [\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'usersMainResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'usersAdminResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n ],\n notes: [\n 'Frontend-facing prose should be authored from the merged main+admin UI behavior contributions, not from one raw leaf in isolation.',\n ],\n },\n\n /**\n * `USERS` / `USER_SELF` declare `retentionPolicy`, so the resource factory injects the two\n * retention markers. They are absent from `UserSchema`, so the field-spec extractor cannot see\n * them and they must be declared here — see `RETENTION_MARKER_FIELD_SPECS` for why the documented\n * meaning is load-bearing on fields that render nowhere.\n */\n additionalFieldSpecs: [...RETENTION_MARKER_FIELD_SPECS],\n\n fields: {\n email: schemaShape.email.stringSpec({\n meaning: 'Canonical contact and identity anchor for the user inside the application.',\n whyItMatters: 'It is the main administrative lookup point and the primary human-facing identity reference during onboarding and support.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n status: schemaShape.status.enumSpec({\n meaning: 'Current access/lifecycle state of the user account.',\n whyItMatters: 'This tells the system and operators whether the user should be able to enter the application, is still onboarding, or has been restricted.',\n importance: FieldSemanticImportance.PRIMARY,\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'UserStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [UserStatus.ACTIVE]: { meaning: 'Full access — the user can use the application normally.' },\n [UserStatus.INACTIVE]: { meaning: 'Deactivated — the account exists but access is removed.' },\n [UserStatus.SUSPENDED]: { meaning: 'Temporarily blocked — access intentionally interrupted, reinstatement possible.' },\n [UserStatus.PENDING_VERIFICATION]: { meaning: 'Account created but the user has not verified their identity yet.' },\n [UserStatus.PENDING_INVITATION]: { meaning: 'Invitation sent but the user has not accepted it yet.' },\n [UserStatus.DELETED]: { meaning: 'Soft-deleted — the identity record is retained for audit but is no longer usable.' },\n },\n }),\n\n scheduledReactivationAt: schemaShape.scheduledReactivationAt.dateSpec({\n meaning: 'When the automated suspension sweep returns this account to ACTIVE. Written only by admin SUSPEND_USER from its optional `suspensionDuration` in DAYS; voluntary self-deactivation has no schedule and returns only when its subject calls REACTIVATE_ACCOUNT. Absent means the current lifecycle state has no automatic return.',\n whyItMatters: 'The stable field name lets the reactivation sweep query the same scheduling coordinate on user and organization-member rows. It is server-owned and written only by guarded lifecycle transitions. Deliberately not audit evidence: it does not decide what the principal may do, and the transition’s own audit event already records the reason and resulting status.',\n }),\n\n appRoles: schemaShape.appRoles.arraySpec({\n meaning: 'Application-level authority granted to the user.',\n whyItMatters: 'Roles drive permission posture and therefore change what the user is allowed to see or do across the product.',\n elementMeaning: 'Each role grants a discrete set of permissions for application features.',\n importance: FieldSemanticImportance.PRIMARY,\n elementType: {\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'CORE_APP_ROLES',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n notes: [\n 'Import role members from the shared framework role vocabulary rather than re-authoring raw role strings.',\n 'Element schema is a union of the framework enum and free-form tenant-defined role strings; both branches are surfaced via the framework-derived array element metadata.',\n ],\n },\n }),\n\n userTypes: schemaShape.userTypes.arraySpec({\n meaning: 'Business/authentication category used to apply different enrollment, policy, and user-journey rules.',\n whyItMatters: 'This field often determines which auth policy, registration path, or product posture applies to a user beyond raw roles.',\n elementMeaning: 'Each type tag represents a classification that can drive conditional behavior across the application.',\n elementType: {\n notes: [\n 'Values are application-declared userType keys from backend configuration, not a fixed framework enum.',\n ],\n },\n }),\n },\n\n operations: {\n [Op.READ]: {\n purpose: 'Retrieve a known user identity record.',\n outcome: 'The caller receives the user representation authorized for this route.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The addressed user identity record was found and the route-specific representation is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not authorized to read the addressed user through this route.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the route’s authorized scope.' },\n ],\n idempotent: true,\n variants: {\n default: {\n purpose: 'Read the authenticated caller’s own user identity record without entering an administration workflow.',\n outcome: 'The caller receives their own complete user identity representation.',\n whenToUse: 'Use when an authenticated client needs the caller’s identity anchor, current account status, roles or user classifications.',\n examples: [\n {\n title: 'Read the authenticated user identity',\n request: { userId: USERS_API_REFERENCE_USER_ID },\n response: usersApiReferenceExample,\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n context: {\n purpose: 'Read the authenticated caller’s own user identity together with its available relationship context.',\n outcome: 'The caller receives their user record plus the profile and organization-membership context exposed by this representation.',\n whenToUse: 'Use when a client must bootstrap identity-aware application context without issuing separate profile and membership reads.',\n examples: [\n {\n title: 'Read the authenticated user with relationship context',\n request: { userId: USERS_API_REFERENCE_USER_ID },\n response: usersApiReferenceContextExample,\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n summary: {\n purpose: 'Read a compact representation of the authenticated caller’s own user identity.',\n outcome: 'The caller receives only the identity, email, status and creation timestamp required by lightweight user surfaces.',\n whenToUse: 'Use when a compact identity representation is sufficient and the complete user record is unnecessary.',\n examples: [\n {\n title: 'Read the authenticated user summary',\n request: { userId: USERS_API_REFERENCE_USER_ID },\n response: usersApiReferenceSummaryExample,\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n admin: {\n purpose: 'Read a user in administrator workflows with management-focused context.',\n outcome: 'The administrator receives the current management representation of the addressed user.',\n whenToUse: 'Use when the caller is acting in a user-governance posture rather than a normal end-user flow.',\n examples: [\n {\n title: 'Read one managed user',\n request: { userId: USERS_API_REFERENCE_USER_ID },\n response: usersApiReferenceExample,\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n },\n },\n\n [Op.LIST]: {\n purpose: 'Browse collections of known users.',\n outcome: 'The caller can iterate through a user set instead of addressing one identity directly.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of user identity records matching the supplied governance filters.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to enumerate the user directory.' },\n ],\n idempotent: true,\n variants: {\n default: {\n purpose: 'Provide internal non-HTTP user enumeration for supporting flows that need user lists behind the scenes.',\n whenToUse: 'Use when infrastructure or internal service logic needs a user collection without exposing a user-management route.',\n },\n admin: {\n purpose: 'Provide the administrable user directory surface.',\n whenToUse: 'Use when an operator needs to browse the user base as part of management or support work.',\n examples: [\n {\n title: 'List active managed users',\n request: {\n organizationId: USERS_API_REFERENCE_ORGANIZATION_ID,\n page: 1,\n limit: 20,\n sort: 'createdAt:desc',\n },\n response: usersApiReferencePage(),\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n },\n },\n\n [Op.SEARCH]: {\n purpose: 'Locate users by email (own field) and, through the linked user profile, by first/last/display name. Also powers org-scoped people pickers (e.g. a `createdByUserId` filter), where results are constrained to the caller’s organization.',\n outcome: 'Administrators and org-scoped pickers can narrow the user population to the relevant identity subset by email or name quickly.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of user identity records whose email, or whose linked profile’s first/last/display name, matches the search query.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to search the user population.' },\n ],\n idempotent: true,\n variants: {\n admin: {\n purpose: 'Expose admin-grade user lookup across identity attributes and governance filters.',\n whenToUse: 'Use when the operator knows part of the target identity or needs filtered user discovery.',\n examples: [\n {\n title: 'Search active users by name or email',\n request: {\n organizationId: USERS_API_REFERENCE_ORGANIZATION_ID,\n q: 'alex',\n status: UserStatus.ACTIVE,\n page: 1,\n limit: 20,\n sort: 'email:asc',\n },\n response: usersApiReferencePage(),\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n },\n },\n\n [Op.CREATE]: {\n purpose: 'Create a managed user identity record.',\n outcome: 'A new application-known person can be onboarded into the user-governance lifecycle.',\n whenToUse: 'Use when an administrator must explicitly introduce a new user into the application.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A new user identity record was provisioned and is returned with its server-assigned id.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The email is missing/malformed or the user payload fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to provision new users.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The payload assigns an `appRoles` entry outside the caller’s own role ceiling — a principal cannot provision a user carrying authority it does not itself hold. Omitting `appRoles` applies the schema default instead and is never measured against the ceiling.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'Another user identity already exists with the supplied email (the canonical identity anchor must be unique).' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Provision a new managed user',\n request: {\n email: 'new.member@example.com',\n status: UserStatus.PENDING_INVITATION,\n appRoles: [CORE_APP_ROLES.APP_USER],\n userTypes: ['employee'],\n },\n response: {\n _id: 'user_01HX2…',\n email: 'new.member@example.com',\n status: UserStatus.PENDING_INVITATION,\n appRoles: [CORE_APP_ROLES.APP_USER],\n userTypes: ['employee'],\n createdAt: '2026-08-20T09:00:00.000Z',\n updatedAt: '2026-08-20T09:00:00.000Z',\n // retention-authority: N/A — a DOCUMENTATION example pinning the wire value the\n // generated `UsersCreateResponse` DTO really carries (default `active`); no\n // predicate, no visibility decision, and a specification layer cannot consume the\n // backend emitter regardless.\n retentionStatus: RetentionStatus.ACTIVE,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a new user identity was provisioned so the user-governance team has an auditable trail of every onboarding event.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'A new user identity record is created via the administrative create flow.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a new user identity was provisioned and identify which user.',\n },\n },\n eventData: {\n purpose: 'Describe the create payload: the new user identity, the administrator who created it, and the initial role / status posture.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime CREATE operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'No user-facing welcome email fires from this operation today — `SystemEmailTemplateRef.WELCOME_EMAIL` is dispatched by the auth/onboarding service after the user accepts the invitation, not from the resource-operation fan-out.',\n ],\n },\n },\n },\n\n [Op.UPDATE]: {\n purpose: 'Modify the role set or application-defined user classifications on an existing user record.',\n outcome: 'The target user keeps the same identity record with updated `appRoles` and/or `userTypes`; identity and lifecycle fields remain unchanged.',\n whenToUse: 'Use for record maintenance. This operation CAN also rewrite `appRoles`, but it replaces the whole array — prefer the dedicated `assign_roles` / `revoke_roles` verbs for an authority change, which apply an additive or subtractive delta and so cannot clobber a concurrent edit.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The user record was updated and the new administrative state is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The supplied `appRoles` or `userTypes` values fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to edit another user’s record.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The edit sets an `appRoles` entry outside the caller’s own role ceiling. Because this operation replaces the whole array, every entry it names is treated as caller-authored — including roles the user already held.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The edit would remove the LAST administratively usable application super-administrator by rewriting `appRoles` so it no longer confers `APP_ADMIN_SUPER_ADMIN`. Grant the role to another active user first. Carries the stable client-branchable `code: LAST_SUPER_ADMINISTRATOR`.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Replace a user classification without rewriting roles',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n userTypes: ['employee', 'support'],\n },\n response: {\n ...usersApiReferenceExample,\n userTypes: ['employee', 'support'],\n updatedAt: '2026-08-20T10:15:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that an existing user record was edited so the user-governance team can audit non-trivial profile or status changes.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator updates governance-relevant attributes on a user record.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a user record was updated and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the update payload: the affected user identity, the administrator who acted, and which fields changed.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime UPDATE operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'No dedicated user-facing system template exists for generic profile updates — security-sensitive edits surface separately via `SystemEmailTemplateRef.SECURITY_ALERT`, dispatched by the security service.',\n ],\n },\n },\n },\n\n [Op.DELETE]: {\n purpose: 'Remove a user identity record from normal operational use.',\n outcome: 'The user is no longer treated as an active administrative identity in the application lifecycle.',\n whenToUse: 'Use only when the business decision is true removal, not temporary suspension or narrower access.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The user identity record was removed; no body is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the high-trust governance authority required to remove a user identity.' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The operation declares `requiresStepUpAuthentication`, and the request carried no valid single-use re-authentication token. Obtain one from the re-authentication route and retry with it — holding a valid session is deliberately not sufficient for irreversible identity destruction.', errorCode: 'STEP_UP_REQUIRED' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id (or it was already removed).' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The user still owns dependent records (organization memberships, owned resources) that block hard removal; resolve or reassign them first.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The target is the LAST administratively usable application super-administrator. Destroying the row that holds the last application authority locks the application out exactly as revoking the role would, so it is refused on the same terms — grant the role to another active user first. Carries the stable client-branchable `code: LAST_SUPER_ADMINISTRATOR`.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Remove one managed user',\n request: { userId: USERS_API_REFERENCE_USER_ID },\n forStatus: HttpResponseStatusCode.NO_CONTENT_204,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a user identity was removed so the user-governance team has an auditable trail of every removal event.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator deletes a user identity record.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a user identity was removed and identify which user.',\n },\n },\n eventData: {\n purpose: 'Describe the delete payload: the removed user identity and the administrator who initiated removal.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime DELETE operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'When the deletion happens via organization-membership removal, the user-facing `SystemEmailTemplateRef.ORGANIZATION_MEMBER_REMOVED` is dispatched by the organization service — not from this resource-operation fan-out.',\n ],\n },\n },\n },\n\n [Users_Operations.ASSIGN_ROLES]: {\n operationId: Users_Operations.ASSIGN_ROLES,\n purpose: 'Grant or widen the authority posture of an existing user.',\n outcome: 'The user gains application permissions that change their effective access surface.',\n whenToUse: 'Use when the administrative intent is permission delegation, not profile maintenance. The named roles are ADDED to the roles the user already holds — this is a delta, not a replacement, so it never drops authority the request did not mention. Re-granting a held role is a no-op that still answers 200.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The requested roles are present on the user and the updated identity record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'A supplied role is unknown to the application role vocabulary or the payload is malformed.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the authority to delegate the requested roles (e.g. cannot grant a role they do not themselves hold).' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Grant an application administration role',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n roles: [CORE_APP_ROLES.APP_ADMIN_VIEWER],\n reason: 'Provide read-only access for the quarterly access review.',\n },\n response: {\n ...usersApiReferenceExample,\n appRoles: [\n CORE_APP_ROLES.APP_USER,\n CORE_APP_ROLES.APP_ADMIN_VIEWER,\n ],\n updatedAt: '2026-08-20T10:30:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a user gained one or more roles so the user-governance team can audit privilege widening.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator assigns one or more application roles to an existing user.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that roles were granted and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the role-grant payload: the affected user, the granted roles, and the administrator who acted.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime ASSIGN_ROLES operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'No dedicated user-facing system template exists for role-grant events — the user typically learns about the change through the in-app permissions surface, not a dedicated email.',\n ],\n },\n },\n },\n\n [Users_Operations.REVOKE_ROLES]: {\n operationId: Users_Operations.REVOKE_ROLES,\n purpose: 'Reduce or remove previously granted authority from a user.',\n outcome: 'The user loses one or more permission-bearing roles and therefore a narrower access surface applies.',\n whenToUse: 'Use when the administrative intent is access reduction, offboarding, or separation-of-duty correction. Only the named roles are REMOVED — this is a delta, not a replacement. Revoking every remaining role is permitted and leaves the user with none, which withdraws application access without deleting the identity; `assign_roles` restores it. The ONE exception is the application super-administrator floor: the last usable super-administrator cannot be demoted, because no in-product path could then appoint another.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The requested roles are no longer present on the user and the updated identity record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'A supplied role is unknown to the application role vocabulary or the payload is malformed.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the authority to revoke the requested roles (e.g. separation-of-duty restriction).' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The revocation would remove the LAST administratively usable application super-administrator (an ACTIVE user holding a role that confers `APP_ADMIN_SUPER_ADMIN`, directly or by inheritance). Grant the role to another active user first. Not a 403: the caller IS authorized — the current state of the application forbids it. Carries the stable client-branchable `code: LAST_SUPER_ADMINISTRATOR` so a client can branch without parsing the message.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Revoke one application administration role',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n roles: [CORE_APP_ROLES.APP_ADMIN_VIEWER],\n reason: 'The temporary access-review assignment has ended.',\n },\n response: {\n ...usersApiReferenceExample,\n appRoles: [CORE_APP_ROLES.APP_USER],\n updatedAt: '2026-08-20T11:00:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a user lost one or more roles so the user-governance team can audit privilege narrowing.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator revokes one or more application roles from a user.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that roles were revoked and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the role-revoke payload: the affected user, the revoked roles, and the administrator who acted.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime REVOKE_ROLES operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'No dedicated user-facing system template exists for role-revoke events — the user typically learns about the change through the in-app permissions surface, not a dedicated email.',\n ],\n },\n },\n },\n\n [Users_Operations.READ_RETAINED]: {\n operationId: Users_Operations.READ_RETAINED,\n purpose: 'Reveal a RETAINED user record — one an erasure scrubbed and kept — under a recorded justification.',\n outcome: 'The retained identity record is returned as it is stored, with its subject fields already impersonalized by the erasure, and a `RETAINED_DATA_ACCESS` audit event is written naming the administrator, their roles and the stated reason. Nothing is written to the record itself: the operation is shaped like an update so the justification travels in a request body rather than in a URL, and its implementation replaces the core write entirely.',\n whenToUse: 'Use when an operator must see an erased subject’s remaining record for a reason that survives scrutiny — a legal hold, a dispute, a regulatory investigation. This is the ONLY sanctioned route: a retained row is hidden from every ordinary read, so the alternative is a database console, which discloses the same data with no record of who looked or why.',\n importance: FieldSemanticImportance.CONTEXTUAL,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The retained record is returned and the reveal has been recorded in the audit trail.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the privileged application role required to reveal retained data, or is a MACHINE principal. An API key or OAuth client can name a credential but not a person, and this record exists to say who chose to look.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'No justification was supplied, or the request addressed a population rather than one user. One stated reason cannot justify a disclosure nobody sized.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No record exists for the supplied id within the caller’s scope. The see-through read suppresses the retention filter only — never the scope filter — so it cannot reach a record the caller could not otherwise address.' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Reveal a retained record under a legal hold',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n reason: 'Legal hold LH-2026-114: identity confirmation requested by counsel.',\n },\n response: {\n ...usersApiReferenceExample,\n // The scrub's fixed replacement — the record is returned as ERASED, which is the point:\n // the reveal shows what survived the erasure, not what the erasure removed.\n email: 'erased@erased.invalid',\n status: UserStatus.INACTIVE,\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n },\n\n [Users_Operations.SUSPEND_USER]: {\n operationId: Users_Operations.SUSPEND_USER,\n purpose: 'Temporarily block a user from normal access without deleting the identity record.',\n outcome: 'The user remains known to the application, but their operational access is intentionally interrupted. `suspensionDuration` is expressed in DAYS and is resolved to an absolute instant at write time — a duration has no meaning without the moment it is counted from, and the row records no such moment — after which an hourly sweep lifts the suspension automatically by running the ordinary UNSUSPEND_USER verb, so the same state machine and administrative floors apply. Omitting it means the suspension is indefinite.',\n whenToUse: 'Use when you need immediate access restriction while preserving auditability and potential reinstatement. The ONE exception is the application super-administrator floor: the last usable super-administrator cannot be suspended, because suspension removes the only status that can authenticate and no in-product path could then appoint another.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The user account is in the suspended state and the updated identity record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to suspend a user account.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The account is not ACTIVE, so suspension is not a legal transition from its current state (already suspended, soft-deleted, or still pending verification/invitation). Carries `resource_status_transition_conflict`, whose context names the current status, the target status and the permitted source statuses. Most callers meet the earlier `enabledCondition` gate (403) instead; this reference covers the paths that gate does not reach.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The target is the LAST administratively usable application super-administrator. Suspending them moves the sole administrator out of ACTIVE — the only status that can authenticate — which locks the application out exactly as revoking the role would, so it is refused on the same terms. Grant the role to another active user first. Not a 403: the caller IS authorized; the current state of the application forbids it. Carries the stable client-branchable `code: LAST_SUPER_ADMINISTRATOR`.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Suspend access for fourteen days',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n reason: 'Temporary access hold during a security review.',\n suspensionDuration: 14,\n notifyUser: true,\n },\n response: {\n ...usersApiReferenceExample,\n status: UserStatus.SUSPENDED,\n scheduledReactivationAt: '2026-09-03T11:30:00.000Z',\n updatedAt: '2026-08-20T11:30:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a user account was suspended so the user-governance and security teams can audit access interruptions.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator suspends a user account.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a user account was suspended and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the suspension payload: the affected user, the administrator who acted, and any documented reason.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime SUSPEND_USER operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'When the suspension is security-driven, a separate `SystemEmailTemplateRef.SECURITY_ALERT` may be dispatched to the affected user by the security service — outside this resource-operation fan-out.',\n ],\n },\n },\n },\n\n [Users_Operations.UNSUSPEND_USER]: {\n operationId: Users_Operations.UNSUSPEND_USER,\n purpose: 'Restore a previously suspended user to an active operational posture.',\n outcome: 'The user can resume normal access under the currently assigned authority set. Any pending automatic-reactivation deadline is CLEARED, so an account reinstated by hand does not carry the sweep’s old date into a later suspension.',\n whenToUse: 'Use when an earlier suspension has been resolved and access should be reinstated.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The user account is no longer suspended and the updated identity record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to reinstate a user account.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The account is not SUSPENDED, so there is no suspension to reverse. Notably an INACTIVE account — one the user voluntarily deactivated through the self door — is refused here rather than reinstated: an imposed suspension and a chosen deactivation are distinct states with distinct remedies, and merging them into one verb would let an administrator silently undo a user’s own decision. Carries `resource_status_transition_conflict` with the current and permitted statuses in its context.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Restore a suspended user',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n reason: 'The security review completed successfully.',\n notifyUser: true,\n },\n response: {\n ...usersApiReferenceExample,\n status: UserStatus.ACTIVE,\n updatedAt: '2026-08-20T12:00:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a previously suspended user account was reinstated so the user-governance team can audit access-restoration events.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator reverses a prior suspension on a user account.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a user account was reinstated and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the reinstatement payload: the affected user and the administrator who acted.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime UNSUSPEND_USER operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'No dedicated user-facing system template exists for reinstatement — the user simply regains access on next sign-in.',\n ],\n },\n },\n },\n\n [Users_Operations.REACTIVATE_USER]: {\n operationId: Users_Operations.REACTIVATE_USER,\n purpose: 'Reinstate a user who deactivated their own account.',\n outcome: 'The account returns to ACTIVE and the person can sign in again. This is the ONLY door back from a self-deactivation: the self-service reactivation verb needs a session, and sign-in admits only ACTIVE accounts — so a person who deactivates their own account cannot reverse it themselves and must ask an administrator. `reason` is mandatory here, unlike on reinstatement from suspension, because an administrator is reversing a decision the account owner made about their own account.',\n whenToUse: 'Use when a person who voluntarily deactivated their account asks to return. It does NOT lift an administrative suspension — that stays with the unsuspend verb, and the two have deliberately disjoint source states.',\n importance: FieldSemanticImportance.PRIMARY,\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The account is ACTIVE again and the updated identity record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the administrative authority required to reinstate a deactivated account.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The account is not INACTIVE, so there is no self-deactivation to reverse. A SUSPENDED account is refused here on purpose — an imposed halt is lifted by the unsuspend verb, and merging the two would erase the distinction between an administrator stopping someone and a person choosing to leave. Carries `resource_status_transition_conflict` with the current and permitted statuses in its context.' },\n ],\n idempotent: true,\n examples: [\n {\n title: 'Reinstate an account the user deactivated',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n reason: 'The account owner asked to return and confirmed their identity by email.',\n notifyUser: true,\n },\n response: {\n ...usersApiReferenceExample,\n status: UserStatus.ACTIVE,\n updatedAt: '2026-09-08T09:15:00.000Z',\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a self-deactivated account was reinstated by an administrator, so the user-governance team can audit reversals of a person’s own account decision.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator reactivates an account the user had deactivated themselves.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a self-deactivated account was reinstated and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the reinstatement payload: the affected user, the administrator who acted, and the stated reason.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime REACTIVATE_USER operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'The reason is carried into the event data because this verb reverses the account owner’s own decision, which the audit trail must be able to explain.',\n ],\n },\n },\n },\n\n [Users_Operations.FORCE_PASSWORD_RESET]: {\n operationId: Users_Operations.FORCE_PASSWORD_RESET,\n purpose: 'Compel a credential reset as a security or recovery action.',\n outcome: 'The target’s live sessions are revoked and a single-use reset link is mailed to them, so they must re-establish a password before regaining password-based access.',\n whenToUse: 'Use for account recovery, suspected compromise, or mandatory credential rotation events.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The reset was forced: sessions revoked and a single-use link mailed to the target. The response carries the link’s expiry, never the link or token itself.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the security/governance authority required to force a credential reset, or the execution carries no attributable principal to record as the actor.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No user identity record exists for the supplied id within the caller’s administrative scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The target account is soft-deleted, so it has no credential path to reset.' },\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'No documented `reason` was supplied, or the caller addressed their own account — self-service credential change belongs to the authenticated password-change route, which proves knowledge of the current password.' },\n ],\n idempotent: false,\n rateLimitNote: 'Rate-sensitive: forcing repeated resets dispatches reset tokens; operators should throttle bulk rotations to avoid flooding affected users.',\n examples: [\n {\n title: 'Force credential recovery after suspected compromise',\n request: {\n userId: USERS_API_REFERENCE_USER_ID,\n reason: 'Credential exposure was reported by the security team.',\n },\n response: {\n expiresAt: '2026-08-20T13:00:00.000Z',\n sessionsRevoked: true,\n },\n forStatus: HttpResponseStatusCode.OK_200,\n },\n ],\n communications: {\n email: {\n purpose: 'Notify application administrators that a credential-reset was forced on a user account so the user-governance and security teams can audit recovery and rotation events.',\n tone: ADMIN_AUDIT_TONE,\n useWhen: 'An administrator forces a credential reset on a user account.',\n textSlots: {\n subject: {\n purpose: 'Announce, in the subject line, that a forced credential reset was triggered and identify the affected user.',\n },\n },\n eventData: {\n purpose: 'Describe the forced-reset payload: the affected user, the administrator who acted, and the documented reason.',\n },\n deliveries: [\n {\n audience: ADMIN_AUDIT_AUDIENCE,\n targetRef: CoreUserNotificationTarget.APPLICATION_ADMINISTRATOR,\n },\n ],\n notes: [\n 'Mirrors the single `userNotifications[]` entry declared on the runtime FORCE_PASSWORD_RESET operation (target=APPLICATION_ADMINISTRATOR, channel=EMAIL).',\n 'The user-facing reset email is `SystemEmailTemplateRef.PASSWORD_RESET`, dispatched by the auth service when the reset token is generated — not from this resource-operation fan-out. When a future engine workstream wires that dispatch through `userNotifications`, replace this prose note with a `systemEmailTemplateRef: SystemEmailTemplateRef.PASSWORD_RESET` cross-link on a new USER_SELF delivery.',\n 'That user-facing mail carries the ONLY copy of the reset link. The operation response deliberately withholds it: handing an administrator a link that sets another account’s password would let them authenticate as that user — unnoticed by the owner and, absent an actor claim on session tokens, indistinguishable downstream from a genuine login. The token TTL is likewise a framework policy constant rather than a caller-supplied window.',\n 'Beyond this admin-audit mail, the operation emits the `USER_PASSWORD_RESET_FORCED` audit event (severity CRITICAL) naming the acting administrator, the target, and the documented reason — deliberately distinct from the self-service `USER_PASSWORD_RESET_REQUESTED`, which has no actor field and would credit the account owner with the administrator’s action.',\n ],\n },\n },\n },\n\n },\n\n businessConstraints: [\n 'This resource is an administrative identity record, not the self-service profile-editing surface; self-service changes belong on `user_self` and related profile/preference resources.',\n 'Role and lifecycle operations on users should be treated as governance actions because they affect access posture, not only cosmetic account data.',\n 'The `users` resource should remain centered on identity governance and access administration, not become the dumping ground for every piece of personal profile information.',\n 'Erasing a subject SCRUBS AND RETAINS this row rather than deleting it: the email is masked to an unreachable placeholder and the record is marked retained, so retained financial records whose foreign keys point at the person still resolve — to an anonymized subject. A retained row is hidden from every normal read and frozen against writes; only an audited see-through read reaches it.',\n 'The bulk-update operation exists solely to let the trusted erasure writer scrub rows in place, and is deliberately not exposed over HTTP — a bulk user mutation route would allow mass role and status rewrites. Treat it as a capability, never as an administrative surface to build on.',\n 'Retention decisions here bind `user_self` too: it is a second resource over the same underlying user records, so the two must always declare the same retention posture or an erased identity stays reachable through the self-service door.',\n ],\n }),\n // Phase 4.5 Step 2 (F-1): explicit scope declaration. The USERS resource\n // is the self-anchor for the USER_SELF scope (see\n // `PRIMARY_SCOPE_TO_CORE_RESOURCE_TYPE` in\n // `engine/saas-models/src/resources/resources.shared.schemas.ts` — the\n // registry-layer factory's branch-2 self-anchor lookup resolves\n // USERS → USER_SELF). The post-factory cross-check (Phase 4.5 Step 2.5,\n // tracked) is the right layer to enforce that this declared value\n // matches the registry-assembled scope.\n { resourcePrimaryScope: ResourcePrimaryScope.USER_SELF },\n ),\n () => ({\n label: {\n purpose: 'Use the email as the stable human-facing identity anchor whenever the frontend needs to identify a user succinctly in supporting or administrative contexts.',\n textSlots: {\n label: {\n purpose: 'Name the resource as a managed user identity, typically represented by the email-backed identity anchor.',\n },\n },\n },\n layout: {\n purpose: 'Organize user information by governance meaning so operators can distinguish identity facts, permission posture, and lifecycle evidence at a glance.',\n displayPurpose: 'Present the user record as an administrative identity card rather than a broad social/profile page.',\n summaryPurpose: 'Provide a compact user identity snapshot for relationship-heavy surfaces such as assignments, lookups, and related-object summaries.',\n editPurpose: 'Keep mutable governance inputs focused on the fields administrators are expected to curate directly.',\n sections: {\n overview: {\n purpose: 'Anchor the record around the core identifying attributes and current account state.',\n whenToUse: 'Use this section for the fields an operator must read first to verify who the user is and whether the account is currently usable.',\n textSlots: {\n title: {\n purpose: 'Label this section as the primary identity overview rather than as permissions or audit history.',\n },\n description: {\n purpose: 'Explain that the section helps operators verify the user identity and present usability state at a glance.',\n },\n },\n },\n access: {\n purpose: 'Group the permission-bearing and classification fields that directly affect what the user may access.',\n whenToUse: 'Use this section when the task is authority review, delegation, or access troubleshooting.',\n textSlots: {\n title: {\n purpose: 'Label this section as the access-and-permissions area of the user record.',\n },\n description: {\n purpose: 'Explain that the section is about authorization posture and classifications that affect access.',\n },\n },\n },\n lifecycle: {\n purpose: 'Expose timestamped lifecycle evidence and historical state context around the managed identity.',\n whenToUse: 'Use this section when the operator needs chronology and audit-oriented context rather than editable governance controls.',\n textSlots: {\n title: {\n purpose: 'Label this section as lifecycle or audit history instead of active permission controls.',\n },\n description: {\n purpose: 'Explain that the section captures chronology, timestamps, and historical context around the identity.',\n },\n },\n },\n },\n },\n views: {\n [Op.READ]: {\n variants: {\n default: {\n purpose: 'Surface user read in the main application only as a lightweight supporting view.',\n whenToUse: 'Use when end-user workflows need to resolve who a referenced user is without turning the users resource into a full end-user management surface.',\n },\n admin: {\n purpose: 'Surface the user detail view inside administration workflows.',\n whenToUse: 'Use when the operator is already in user governance and needs a focused detail panel for one identity.',\n },\n },\n },\n\n [Op.LIST]: {\n variants: {\n admin: {\n purpose: 'Surface the administrator-facing user-management directory.',\n whenToUse: 'Use when an operator needs to browse users as a managed collection rather than resolving a single known identity.',\n },\n },\n },\n\n [Op.SEARCH]: {\n variants: {\n admin: {\n purpose: 'Surface administrative user search and filtering by email or (via the linked profile) name.',\n whenToUse: 'Use when support, compliance, or administration needs fast identity lookup across the user population, or when an org-scoped picker resolves users by name/email.',\n },\n },\n },\n\n [Op.CREATE]: {\n purpose: 'Surface administrator-driven user creation.',\n whenToUse: 'Use when the product exposes explicit user provisioning to administrators.',\n },\n\n [Op.UPDATE]: {\n purpose: 'Surface administrator-driven edits to managed user records.',\n whenToUse: 'Use when the operator is curating the authoritative user record rather than acting through self-service flows.',\n },\n\n [Op.DELETE]: {\n purpose: 'Surface destructive administrative removal of a user.',\n whenToUse: 'Use only in high-trust governance workflows where removal is intentional and understood.',\n },\n\n [Users_Operations.ASSIGN_ROLES]: {\n purpose: 'Surface role-assignment as a first-class administrative action.',\n },\n\n [Users_Operations.REVOKE_ROLES]: {\n purpose: 'Surface role revocation as a first-class administrative action.',\n },\n\n [Users_Operations.SUSPEND_USER]: {\n purpose: 'Surface suspension directly in user-governance workflows.',\n },\n\n [Users_Operations.UNSUSPEND_USER]: {\n purpose: 'Surface reactivation of suspended users in user-governance workflows.',\n },\n\n [Users_Operations.REACTIVATE_USER]: {\n purpose: 'Surface the only route back from a self-deactivated account, so support can act on a return request without a database write.',\n },\n\n [Users_Operations.FORCE_PASSWORD_RESET]: {\n purpose: 'Surface credential-reset enforcement for security operators and administrators.',\n },\n\n },\n }),\n);\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"engine-documentation-specification-catalog.companion.d.ts","sourceRoot":"","sources":["../../../../src/technical-documentation/engine-documentation-specification-catalog.companion.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,UAAU,
|
|
1
|
+
{"version":3,"file":"engine-documentation-specification-catalog.companion.d.ts","sourceRoot":"","sources":["../../../../src/technical-documentation/engine-documentation-specification-catalog.companion.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,UAAU,EAmEX,MAAM,uBAAuB,CAAC;AA8C/B,OAAO,EAEL,KAAK,iDAAiD,EACvD,MAAM,4CAA4C,CAAC;AAEpD,KAAK,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;AACtD,MAAM,MAAM,2CAA2C,GAAG,aAAa,GAAG,SAAS,2CAA2C,EAAE,GAAG;IACjI,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,2CAA2C,CAAC;CACrE,CAAC;AAEF,wHAAwH;AACxH,oBAAY,yCAAyC;IACnD,aAAa,uCAAuC;IACpD,iBAAiB,2CAA2C;IAC5D,gBAAgB,0CAA0C;IAC1D,OAAO,iCAAiC;IACxC,QAAQ,kCAAkC;IAC1C,2BAA2B,qDAAqD;CACjF;AAED,oBAAY,qCAAqC;IAC/C,uCAAuC,4CAA4C;IACnF,4DAA4D,iEAAiE;CAC9H;AAED,oBAAY,uCAAuC;IACjD,SAAS,cAAc;CACxB;AAED,eAAO,MAAM,wDAAwD,4DAA4D,CAAC;AAClI,eAAO,MAAM,4DAA4D,IAAI,CAAC;AAW9E,MAAM,WAAW,uDAAuD;IACtE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,sBAAsB,EAAE,yCAAyC,CAAC;IAC3E,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,8CAA8C;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,sBAAsB,EAAE,yCAAyC,CAAC;IAC3E,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,2CAA2C,CAAC;CACnE;AAED,MAAM,WAAW,yCAAyC;IACxD,QAAQ,CAAC,QAAQ,EAAE,iDAAiD,CAAC;IACrE,QAAQ,CAAC,OAAO,EAAE,SAAS,8CAA8C,EAAE,CAAC;IAC5E,2EAA2E;IAC3E,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC;CACrC;AAmXD,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAIzH;AA6nCD;;;;;;;;;GASG;AACH,eAAO,MAAM,0DAA0D,yIACiE,CAAC;AAgTzI,uFAAuF;AACvF,eAAO,MAAM,6DAA6D,EAAE,SAAS,uDAAuD,EAO3I,CAAC;AA0BF,0IAA0I;AAC1I,wBAAgB,+CAA+C,IAAI,yCAAyC,CAwC3G"}
|