@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
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';
|
|
2
|
+
import { providerSpecificationFromDefinition } from '../../_core/index.js';
|
|
3
|
+
import { backendProviderModuleSymbol, ENGINE_BACKEND_PROVIDERS_PACKAGE, ENGINE_PROVIDER_OWNER_REF, } from './_engine-provider-shared.js';
|
|
4
|
+
/**
|
|
5
|
+
* Engine provider specification for `openai` (#328). The FACTS (protocols, capabilities,
|
|
6
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
7
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
8
|
+
*/
|
|
9
|
+
export const openaiProviderSpecification = providerSpecificationFromDefinition({ ref: 'openai' }, () => ({
|
|
10
|
+
purpose: 'Serve chat completions, embeddings and image generation to the engine\'s AI slots.',
|
|
11
|
+
businessRole: 'MAIN AI provider covering four engine slots — the one provider the companion reaches for logo generation, and one of three that can run an autonomous coding agent.',
|
|
12
|
+
useWhen: 'Use when GPT models, OpenAI embeddings or image generation are wanted.',
|
|
13
|
+
avoidWhen: 'Avoid assuming its presence in the backend scope implies image generation there; the companion scope declares that separately.',
|
|
14
|
+
businessConstraints: [
|
|
15
|
+
'One API key serves the three HTTP protocols; rotating it affects chat, embeddings and images at once.',
|
|
16
|
+
'The coding-agent arm does NOT use that key: it runs Codex through an ACP adapter under the operator\'s own '
|
|
17
|
+
+ 'host login, so a coding run is credentialed by whoever is signed in rather than by configuration.',
|
|
18
|
+
'Codex does not raise a permission request before writing inside the workspace, in any of its modes — measured. '
|
|
19
|
+
+ 'An application selecting it accepts that Wildo\'s permission ceiling and task mutation scope are not enforced '
|
|
20
|
+
+ 'in flight, and that the change set taken after the run is the only record of what it touched.',
|
|
21
|
+
],
|
|
22
|
+
packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,
|
|
23
|
+
tier: ProviderTier.MAIN,
|
|
24
|
+
vendor: 'openai',
|
|
25
|
+
origin: { kind: ProviderOriginKind.ENGINE },
|
|
26
|
+
facets: ['backend'],
|
|
27
|
+
protocols: ['LLM_PROVIDER', 'IMAGE_PROVIDER', 'EMBEDDINGS_PROVIDER', 'AGENT_CLIENT_PROTOCOL'],
|
|
28
|
+
providerCapabilities: ['IMAGE_GENERATION', 'LLM_CHAT', 'LLM_EMBEDDINGS', 'CODING_AGENT'],
|
|
29
|
+
engineCapabilities: [
|
|
30
|
+
EngineCapability.AI_IMAGE_GENERATION,
|
|
31
|
+
EngineCapability.AI_LLM,
|
|
32
|
+
EngineCapability.AI_EMBEDDINGS,
|
|
33
|
+
EngineCapability.AI_CODING_AGENT,
|
|
34
|
+
],
|
|
35
|
+
secretsContract: [
|
|
36
|
+
{ slug: 'apiKey', envVarName: 'OPENAI_API_KEY', required: true, description: 'OpenAI API key for LLM calls.' },
|
|
37
|
+
],
|
|
38
|
+
codeHandling: {
|
|
39
|
+
definitionOwner: ENGINE_PROVIDER_OWNER_REF,
|
|
40
|
+
definitionSymbol: backendProviderModuleSymbol('OpenAIBackendProvider'),
|
|
41
|
+
},
|
|
42
|
+
}));
|
|
43
|
+
//# sourceMappingURL=openai.provider.specification.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"openai.provider.specification.js","sourceRoot":"","sources":["../../../../../src/engine/providers/openai.provider.specification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mCAAmC,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,mCAAmC,CAC5E,EAAE,GAAG,EAAE,QAAQ,EAAE,EACjB,GAAG,EAAE,CAAC,CAAC;IACL,OAAO,EAAE,oFAAoF;IAC7F,YAAY,EAAE,qKAAqK;IACnL,OAAO,EAAE,wEAAwE;IACjF,SAAS,EAAE,gIAAgI;IAC3I,mBAAmB,EAAE;QACnB,uGAAuG;QACvG,6GAA6G;cAC3G,mGAAmG;QACrG,iHAAiH;cAC/G,gHAAgH;cAChH,+FAA+F;KAClG;IACD,WAAW,EAAE,gCAAgC;IAC7C,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,SAAS,EAAE,CAAC,cAAc,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,uBAAuB,CAAC;IAC7F,oBAAoB,EAAE,CAAC,kBAAkB,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,CAAC;IACxF,kBAAkB,EAAE;QAClB,gBAAgB,CAAC,mBAAmB;QACpC,gBAAgB,CAAC,MAAM;QACvB,gBAAgB,CAAC,aAAa;QAC9B,gBAAgB,CAAC,eAAe;KACjC;IACD,eAAe,EAAE;QACf,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,+BAA+B,EAAE;KAC/G;IACD,YAAY,EAAE;QACZ,eAAe,EAAE,yBAAyB;QAC1C,gBAAgB,EAAE,2BAA2B,CAAC,uBAAuB,CAAC;KACvE;CACF,CAAC,CACH,CAAC","sourcesContent":["import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';\nimport { providerSpecificationFromDefinition } from '~wildo-specifications/_core';\nimport {\n backendProviderModuleSymbol,\n ENGINE_BACKEND_PROVIDERS_PACKAGE,\n ENGINE_PROVIDER_OWNER_REF,\n} from './_engine-provider-shared';\n\n/**\n * Engine provider specification for `openai` (#328). The FACTS (protocols, capabilities,\n * engine slots, secrets) mirror the backend module and are reconciled against it by\n * `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.\n */\nexport const openaiProviderSpecification = providerSpecificationFromDefinition(\n { ref: 'openai' },\n () => ({\n purpose: 'Serve chat completions, embeddings and image generation to the engine\\'s AI slots.',\n businessRole: 'MAIN AI provider covering four engine slots — the one provider the companion reaches for logo generation, and one of three that can run an autonomous coding agent.',\n useWhen: 'Use when GPT models, OpenAI embeddings or image generation are wanted.',\n avoidWhen: 'Avoid assuming its presence in the backend scope implies image generation there; the companion scope declares that separately.',\n businessConstraints: [\n 'One API key serves the three HTTP protocols; rotating it affects chat, embeddings and images at once.',\n 'The coding-agent arm does NOT use that key: it runs Codex through an ACP adapter under the operator\\'s own '\n + 'host login, so a coding run is credentialed by whoever is signed in rather than by configuration.',\n 'Codex does not raise a permission request before writing inside the workspace, in any of its modes — measured. '\n + 'An application selecting it accepts that Wildo\\'s permission ceiling and task mutation scope are not enforced '\n + 'in flight, and that the change set taken after the run is the only record of what it touched.',\n ],\n packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,\n tier: ProviderTier.MAIN,\n vendor: 'openai',\n origin: { kind: ProviderOriginKind.ENGINE },\n facets: ['backend'],\n protocols: ['LLM_PROVIDER', 'IMAGE_PROVIDER', 'EMBEDDINGS_PROVIDER', 'AGENT_CLIENT_PROTOCOL'],\n providerCapabilities: ['IMAGE_GENERATION', 'LLM_CHAT', 'LLM_EMBEDDINGS', 'CODING_AGENT'],\n engineCapabilities: [\n EngineCapability.AI_IMAGE_GENERATION,\n EngineCapability.AI_LLM,\n EngineCapability.AI_EMBEDDINGS,\n EngineCapability.AI_CODING_AGENT,\n ],\n secretsContract: [\n { slug: 'apiKey', envVarName: 'OPENAI_API_KEY', required: true, description: 'OpenAI API key for LLM calls.' },\n ],\n codeHandling: {\n definitionOwner: ENGINE_PROVIDER_OWNER_REF,\n definitionSymbol: backendProviderModuleSymbol('OpenAIBackendProvider'),\n },\n }),\n);\n"]}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Engine provider specification for `opencode` (#328). The FACTS (protocols, capabilities,
|
|
3
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
4
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
5
|
+
*/
|
|
6
|
+
export declare const opencodeProviderSpecification: import("../../_core").ProviderSpecificationConfig;
|
|
7
|
+
//# sourceMappingURL=opencode.provider.specification.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"opencode.provider.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/providers/opencode.provider.specification.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,mEA8CzC,CAAC"}
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';
|
|
2
|
+
import { providerSpecificationFromDefinition } from '../../_core/index.js';
|
|
3
|
+
import { backendProviderModuleSymbol, ENGINE_BACKEND_PROVIDERS_PACKAGE, ENGINE_PROVIDER_OWNER_REF, } from './_engine-provider-shared.js';
|
|
4
|
+
/**
|
|
5
|
+
* Engine provider specification for `opencode` (#328). The FACTS (protocols, capabilities,
|
|
6
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
7
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
8
|
+
*/
|
|
9
|
+
export const opencodeProviderSpecification = providerSpecificationFromDefinition({ ref: 'opencode' }, () => ({
|
|
10
|
+
purpose: 'Run an autonomous coding agent that reaches many model vendors through one transport.',
|
|
11
|
+
businessRole: 'The GENERALIST coding agent. Where the other two coding providers each serve their own vendor, this one '
|
|
12
|
+
+ 'routes to whichever model vendor the operator has configured — so reaching a new model costs a credential '
|
|
13
|
+
+ 'rather than a new adapter, a new admission measurement and a new provider module.',
|
|
14
|
+
useWhen: 'Use when the wanted model is served by no dedicated coding agent, or when one agent should cover several '
|
|
15
|
+
+ 'vendors at once.',
|
|
16
|
+
avoidWhen: 'Avoid when the task relies on Wildo refusing a write in flight, and avoid when a coding run must be able to '
|
|
17
|
+
+ 'PARK on a question — see the constraints below.',
|
|
18
|
+
businessConstraints: [
|
|
19
|
+
'It carries NO secret. The agent resolves its own model-vendor credentials from the operator\'s host state '
|
|
20
|
+
+ '(`opencode auth login`), so a coding run is credentialed by whoever is signed in rather than by configuration.',
|
|
21
|
+
'It does not raise a permission request before writing inside the workspace UNLESS the application points it at '
|
|
22
|
+
+ 'an escalating permission configuration. Without that pointer, Wildo\'s permission ceiling and the task '
|
|
23
|
+
+ 'mutation scope are both inert and the change set taken after the run is the only record of what it touched.',
|
|
24
|
+
'That configuration file must live OUTSIDE the application workspace. Written into the worktree it joins the '
|
|
25
|
+
+ 'change set the run is attributed from, and under an autonomous posture is committed as though the agent had '
|
|
26
|
+
+ 'authored it.',
|
|
27
|
+
'Its host-configuration posture cannot be narrowed: the agent exposes no option for it, so a profile authoring '
|
|
28
|
+
+ 'anything but HOST_INHERITED is refused when the session opens rather than silently downgraded.',
|
|
29
|
+
'The compliance profile describes the AGENT, which is a binary on the host — not the model vendor a given run '
|
|
30
|
+
+ 'reaches. That destination is model-dependent and is not derivable from this provider; an application '
|
|
31
|
+
+ 'declaring where its code is processed must state it per model, and a hosted gateway in front of a vendor is '
|
|
32
|
+
+ 'its own sub-processor.',
|
|
33
|
+
],
|
|
34
|
+
packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,
|
|
35
|
+
tier: ProviderTier.MAIN,
|
|
36
|
+
vendor: 'opencode',
|
|
37
|
+
origin: { kind: ProviderOriginKind.ENGINE },
|
|
38
|
+
facets: ['backend'],
|
|
39
|
+
protocols: ['AGENT_CLIENT_PROTOCOL'],
|
|
40
|
+
providerCapabilities: ['CODING_AGENT'],
|
|
41
|
+
engineCapabilities: [EngineCapability.AI_CODING_AGENT],
|
|
42
|
+
// None. The agent holds its own credentials in host state; an agent that edits a workspace
|
|
43
|
+
// must not also be handed a key by configuration.
|
|
44
|
+
secretsContract: [],
|
|
45
|
+
codeHandling: {
|
|
46
|
+
definitionOwner: ENGINE_PROVIDER_OWNER_REF,
|
|
47
|
+
definitionSymbol: backendProviderModuleSymbol('OpenCodeBackendProvider'),
|
|
48
|
+
},
|
|
49
|
+
}));
|
|
50
|
+
//# sourceMappingURL=opencode.provider.specification.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"opencode.provider.specification.js","sourceRoot":"","sources":["../../../../../src/engine/providers/opencode.provider.specification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mCAAmC,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,mCAAmC,CAC9E,EAAE,GAAG,EAAE,UAAU,EAAE,EACnB,GAAG,EAAE,CAAC,CAAC;IACL,OAAO,EAAE,uFAAuF;IAChG,YAAY,EACV,0GAA0G;UACxG,4GAA4G;UAC5G,mFAAmF;IACvF,OAAO,EACL,2GAA2G;UACzG,kBAAkB;IACtB,SAAS,EACP,8GAA8G;UAC5G,iDAAiD;IACrD,mBAAmB,EAAE;QACnB,4GAA4G;cAC1G,gHAAgH;QAClH,iHAAiH;cAC/G,yGAAyG;cACzG,6GAA6G;QAC/G,8GAA8G;cAC5G,8GAA8G;cAC9G,cAAc;QAChB,gHAAgH;cAC9G,gGAAgG;QAClG,+GAA+G;cAC7G,uGAAuG;cACvG,8GAA8G;cAC9G,wBAAwB;KAC3B;IACD,WAAW,EAAE,gCAAgC;IAC7C,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,SAAS,EAAE,CAAC,uBAAuB,CAAC;IACpC,oBAAoB,EAAE,CAAC,cAAc,CAAC;IACtC,kBAAkB,EAAE,CAAC,gBAAgB,CAAC,eAAe,CAAC;IACtD,2FAA2F;IAC3F,kDAAkD;IAClD,eAAe,EAAE,EAAE;IACnB,YAAY,EAAE;QACZ,eAAe,EAAE,yBAAyB;QAC1C,gBAAgB,EAAE,2BAA2B,CAAC,yBAAyB,CAAC;KACzE;CACF,CAAC,CACH,CAAC","sourcesContent":["import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';\nimport { providerSpecificationFromDefinition } from '~wildo-specifications/_core';\nimport {\n backendProviderModuleSymbol,\n ENGINE_BACKEND_PROVIDERS_PACKAGE,\n ENGINE_PROVIDER_OWNER_REF,\n} from './_engine-provider-shared';\n\n/**\n * Engine provider specification for `opencode` (#328). The FACTS (protocols, capabilities,\n * engine slots, secrets) mirror the backend module and are reconciled against it by\n * `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.\n */\nexport const opencodeProviderSpecification = providerSpecificationFromDefinition(\n { ref: 'opencode' },\n () => ({\n purpose: 'Run an autonomous coding agent that reaches many model vendors through one transport.',\n businessRole:\n 'The GENERALIST coding agent. Where the other two coding providers each serve their own vendor, this one '\n + 'routes to whichever model vendor the operator has configured — so reaching a new model costs a credential '\n + 'rather than a new adapter, a new admission measurement and a new provider module.',\n useWhen:\n 'Use when the wanted model is served by no dedicated coding agent, or when one agent should cover several '\n + 'vendors at once.',\n avoidWhen:\n 'Avoid when the task relies on Wildo refusing a write in flight, and avoid when a coding run must be able to '\n + 'PARK on a question — see the constraints below.',\n businessConstraints: [\n 'It carries NO secret. The agent resolves its own model-vendor credentials from the operator\\'s host state '\n + '(`opencode auth login`), so a coding run is credentialed by whoever is signed in rather than by configuration.',\n 'It does not raise a permission request before writing inside the workspace UNLESS the application points it at '\n + 'an escalating permission configuration. Without that pointer, Wildo\\'s permission ceiling and the task '\n + 'mutation scope are both inert and the change set taken after the run is the only record of what it touched.',\n 'That configuration file must live OUTSIDE the application workspace. Written into the worktree it joins the '\n + 'change set the run is attributed from, and under an autonomous posture is committed as though the agent had '\n + 'authored it.',\n 'Its host-configuration posture cannot be narrowed: the agent exposes no option for it, so a profile authoring '\n + 'anything but HOST_INHERITED is refused when the session opens rather than silently downgraded.',\n 'The compliance profile describes the AGENT, which is a binary on the host — not the model vendor a given run '\n + 'reaches. That destination is model-dependent and is not derivable from this provider; an application '\n + 'declaring where its code is processed must state it per model, and a hosted gateway in front of a vendor is '\n + 'its own sub-processor.',\n ],\n packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,\n tier: ProviderTier.MAIN,\n vendor: 'opencode',\n origin: { kind: ProviderOriginKind.ENGINE },\n facets: ['backend'],\n protocols: ['AGENT_CLIENT_PROTOCOL'],\n providerCapabilities: ['CODING_AGENT'],\n engineCapabilities: [EngineCapability.AI_CODING_AGENT],\n // None. The agent holds its own credentials in host state; an agent that edits a workspace\n // must not also be handed a key by configuration.\n secretsContract: [],\n codeHandling: {\n definitionOwner: ENGINE_PROVIDER_OWNER_REF,\n definitionSymbol: backendProviderModuleSymbol('OpenCodeBackendProvider'),\n },\n }),\n);\n"]}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Engine provider specification for `perplexity` (#328). The FACTS (protocols, capabilities,
|
|
3
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
4
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
5
|
+
*/
|
|
6
|
+
export declare const perplexityProviderSpecification: import("../../_core").ProviderSpecificationConfig;
|
|
7
|
+
//# sourceMappingURL=perplexity.provider.specification.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"perplexity.provider.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/providers/perplexity.provider.specification.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,+BAA+B,mEAuB3C,CAAC"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';
|
|
2
|
+
import { providerSpecificationFromDefinition } from '../../_core/index.js';
|
|
3
|
+
import { backendProviderModuleSymbol, ENGINE_BACKEND_PROVIDERS_PACKAGE, ENGINE_PROVIDER_OWNER_REF, } from './_engine-provider-shared.js';
|
|
4
|
+
/**
|
|
5
|
+
* Engine provider specification for `perplexity` (#328). The FACTS (protocols, capabilities,
|
|
6
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
7
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
8
|
+
*/
|
|
9
|
+
export const perplexityProviderSpecification = providerSpecificationFromDefinition({ ref: 'perplexity' }, () => ({
|
|
10
|
+
purpose: 'Serve retrieval-augmented chat completions through Perplexity\'s models.',
|
|
11
|
+
businessRole: 'MAIN LLM provider suited to web-grounded answers.',
|
|
12
|
+
useWhen: 'Use when agents need answers grounded in current web content.',
|
|
13
|
+
avoidWhen: 'Avoid for tasks needing tool use the provider does not expose.',
|
|
14
|
+
packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,
|
|
15
|
+
tier: ProviderTier.MAIN,
|
|
16
|
+
vendor: 'perplexity',
|
|
17
|
+
origin: { kind: ProviderOriginKind.ENGINE },
|
|
18
|
+
facets: ['backend'],
|
|
19
|
+
protocols: ['LLM_PROVIDER'],
|
|
20
|
+
providerCapabilities: ['LLM_CHAT'],
|
|
21
|
+
engineCapabilities: [EngineCapability.AI_LLM],
|
|
22
|
+
secretsContract: [
|
|
23
|
+
{ slug: 'apiKey', envVarName: 'PERPLEXITY_API_KEY', required: true, description: 'Perplexity API key for LLM calls.' },
|
|
24
|
+
],
|
|
25
|
+
codeHandling: {
|
|
26
|
+
definitionOwner: ENGINE_PROVIDER_OWNER_REF,
|
|
27
|
+
definitionSymbol: backendProviderModuleSymbol('PerplexityBackendProvider'),
|
|
28
|
+
},
|
|
29
|
+
}));
|
|
30
|
+
//# sourceMappingURL=perplexity.provider.specification.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"perplexity.provider.specification.js","sourceRoot":"","sources":["../../../../../src/engine/providers/perplexity.provider.specification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mCAAmC,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,mCAAmC,CAChF,EAAE,GAAG,EAAE,YAAY,EAAE,EACrB,GAAG,EAAE,CAAC,CAAC;IACL,OAAO,EAAE,0EAA0E;IACnF,YAAY,EAAE,mDAAmD;IACjE,OAAO,EAAE,+DAA+D;IACxE,SAAS,EAAE,gEAAgE;IAC3E,WAAW,EAAE,gCAAgC;IAC7C,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,SAAS,EAAE,CAAC,cAAc,CAAC;IAC3B,oBAAoB,EAAE,CAAC,UAAU,CAAC;IAClC,kBAAkB,EAAE,CAAC,gBAAgB,CAAC,MAAM,CAAC;IAC7C,eAAe,EAAE;QACf,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mCAAmC,EAAE;KACvH;IACD,YAAY,EAAE;QACZ,eAAe,EAAE,yBAAyB;QAC1C,gBAAgB,EAAE,2BAA2B,CAAC,2BAA2B,CAAC;KAC3E;CACF,CAAC,CACH,CAAC","sourcesContent":["import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';\nimport { providerSpecificationFromDefinition } from '~wildo-specifications/_core';\nimport {\n backendProviderModuleSymbol,\n ENGINE_BACKEND_PROVIDERS_PACKAGE,\n ENGINE_PROVIDER_OWNER_REF,\n} from './_engine-provider-shared';\n\n/**\n * Engine provider specification for `perplexity` (#328). The FACTS (protocols, capabilities,\n * engine slots, secrets) mirror the backend module and are reconciled against it by\n * `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.\n */\nexport const perplexityProviderSpecification = providerSpecificationFromDefinition(\n { ref: 'perplexity' },\n () => ({\n purpose: 'Serve retrieval-augmented chat completions through Perplexity\\'s models.',\n businessRole: 'MAIN LLM provider suited to web-grounded answers.',\n useWhen: 'Use when agents need answers grounded in current web content.',\n avoidWhen: 'Avoid for tasks needing tool use the provider does not expose.',\n packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,\n tier: ProviderTier.MAIN,\n vendor: 'perplexity',\n origin: { kind: ProviderOriginKind.ENGINE },\n facets: ['backend'],\n protocols: ['LLM_PROVIDER'],\n providerCapabilities: ['LLM_CHAT'],\n engineCapabilities: [EngineCapability.AI_LLM],\n secretsContract: [\n { slug: 'apiKey', envVarName: 'PERPLEXITY_API_KEY', required: true, description: 'Perplexity API key for LLM calls.' },\n ],\n codeHandling: {\n definitionOwner: ENGINE_PROVIDER_OWNER_REF,\n definitionSymbol: backendProviderModuleSymbol('PerplexityBackendProvider'),\n },\n }),\n);\n"]}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Engine provider specification for `resend` (#328). The FACTS (protocols, capabilities,
|
|
3
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
4
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
5
|
+
*/
|
|
6
|
+
export declare const resendProviderSpecification: import("../../_core").ProviderSpecificationConfig;
|
|
7
|
+
//# sourceMappingURL=resend.provider.specification.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resend.provider.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/providers/resend.provider.specification.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,mEA0BvC,CAAC"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';
|
|
2
|
+
import { providerSpecificationFromDefinition } from '../../_core/index.js';
|
|
3
|
+
import { backendProviderModuleSymbol, ENGINE_BACKEND_PROVIDERS_PACKAGE, ENGINE_PROVIDER_OWNER_REF, } from './_engine-provider-shared.js';
|
|
4
|
+
/**
|
|
5
|
+
* Engine provider specification for `resend` (#328). The FACTS (protocols, capabilities,
|
|
6
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
7
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
8
|
+
*/
|
|
9
|
+
export const resendProviderSpecification = providerSpecificationFromDefinition({ ref: 'resend' }, () => ({
|
|
10
|
+
purpose: 'Deliver the transactional email every engine flow sends — invitations, address verification, password reset, magic links — through Resend\'s HTTP API.',
|
|
11
|
+
businessRole: 'Primary MAIN email sink; the provider a fresh application is expected to configure first.',
|
|
12
|
+
useWhen: 'Use as the transactional email provider in every environment that reaches real inboxes.',
|
|
13
|
+
avoidWhen: 'Avoid for marketing campaigns; Resend is wired for transactional delivery only here.',
|
|
14
|
+
businessConstraints: [
|
|
15
|
+
'A verified sending domain must exist in the Resend account before invitations go out.',
|
|
16
|
+
],
|
|
17
|
+
packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,
|
|
18
|
+
tier: ProviderTier.MAIN,
|
|
19
|
+
vendor: 'resend',
|
|
20
|
+
origin: { kind: ProviderOriginKind.ENGINE },
|
|
21
|
+
facets: ['backend'],
|
|
22
|
+
protocols: ['EMAIL_PROVIDER'],
|
|
23
|
+
providerCapabilities: ['EMAIL_TRANSACTIONAL'],
|
|
24
|
+
engineCapabilities: [EngineCapability.EMAIL_TRANSACTIONAL],
|
|
25
|
+
secretsContract: [
|
|
26
|
+
{ slug: 'apiKey', envVarName: 'RESEND_API_KEY', required: true, description: 'Resend API credential for email delivery.' },
|
|
27
|
+
],
|
|
28
|
+
codeHandling: {
|
|
29
|
+
definitionOwner: ENGINE_PROVIDER_OWNER_REF,
|
|
30
|
+
definitionSymbol: backendProviderModuleSymbol('ResendBackendProvider'),
|
|
31
|
+
},
|
|
32
|
+
}));
|
|
33
|
+
//# sourceMappingURL=resend.provider.specification.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resend.provider.specification.js","sourceRoot":"","sources":["../../../../../src/engine/providers/resend.provider.specification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mCAAmC,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,mCAAmC,CAC5E,EAAE,GAAG,EAAE,QAAQ,EAAE,EACjB,GAAG,EAAE,CAAC,CAAC;IACL,OAAO,EAAE,wJAAwJ;IACjK,YAAY,EAAE,2FAA2F;IACzG,OAAO,EAAE,yFAAyF;IAClG,SAAS,EAAE,sFAAsF;IACjG,mBAAmB,EAAE;QACnB,uFAAuF;KACxF;IACD,WAAW,EAAE,gCAAgC;IAC7C,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,SAAS,EAAE,CAAC,gBAAgB,CAAC;IAC7B,oBAAoB,EAAE,CAAC,qBAAqB,CAAC;IAC7C,kBAAkB,EAAE,CAAC,gBAAgB,CAAC,mBAAmB,CAAC;IAC1D,eAAe,EAAE;QACf,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,2CAA2C,EAAE;KAC3H;IACD,YAAY,EAAE;QACZ,eAAe,EAAE,yBAAyB;QAC1C,gBAAgB,EAAE,2BAA2B,CAAC,uBAAuB,CAAC;KACvE;CACF,CAAC,CACH,CAAC","sourcesContent":["import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';\nimport { providerSpecificationFromDefinition } from '~wildo-specifications/_core';\nimport {\n backendProviderModuleSymbol,\n ENGINE_BACKEND_PROVIDERS_PACKAGE,\n ENGINE_PROVIDER_OWNER_REF,\n} from './_engine-provider-shared';\n\n/**\n * Engine provider specification for `resend` (#328). The FACTS (protocols, capabilities,\n * engine slots, secrets) mirror the backend module and are reconciled against it by\n * `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.\n */\nexport const resendProviderSpecification = providerSpecificationFromDefinition(\n { ref: 'resend' },\n () => ({\n purpose: 'Deliver the transactional email every engine flow sends — invitations, address verification, password reset, magic links — through Resend\\'s HTTP API.',\n businessRole: 'Primary MAIN email sink; the provider a fresh application is expected to configure first.',\n useWhen: 'Use as the transactional email provider in every environment that reaches real inboxes.',\n avoidWhen: 'Avoid for marketing campaigns; Resend is wired for transactional delivery only here.',\n businessConstraints: [\n 'A verified sending domain must exist in the Resend account before invitations go out.',\n ],\n packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,\n tier: ProviderTier.MAIN,\n vendor: 'resend',\n origin: { kind: ProviderOriginKind.ENGINE },\n facets: ['backend'],\n protocols: ['EMAIL_PROVIDER'],\n providerCapabilities: ['EMAIL_TRANSACTIONAL'],\n engineCapabilities: [EngineCapability.EMAIL_TRANSACTIONAL],\n secretsContract: [\n { slug: 'apiKey', envVarName: 'RESEND_API_KEY', required: true, description: 'Resend API credential for email delivery.' },\n ],\n codeHandling: {\n definitionOwner: ENGINE_PROVIDER_OWNER_REF,\n definitionSymbol: backendProviderModuleSymbol('ResendBackendProvider'),\n },\n }),\n);\n"]}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Engine provider specification for `stripe` (#328). The FACTS (protocols, capabilities,
|
|
3
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
4
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
5
|
+
*/
|
|
6
|
+
export declare const stripeProviderSpecification: import("../../_core").ProviderSpecificationConfig;
|
|
7
|
+
//# sourceMappingURL=stripe.provider.specification.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"stripe.provider.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/providers/stripe.provider.specification.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,mEA4BvC,CAAC"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';
|
|
2
|
+
import { providerSpecificationFromDefinition } from '../../_core/index.js';
|
|
3
|
+
import { backendProviderModuleSymbol, ENGINE_BACKEND_PROVIDERS_PACKAGE, ENGINE_PROVIDER_OWNER_REF, } from './_engine-provider-shared.js';
|
|
4
|
+
/**
|
|
5
|
+
* Engine provider specification for `stripe` (#328). The FACTS (protocols, capabilities,
|
|
6
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
7
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
8
|
+
*/
|
|
9
|
+
export const stripeProviderSpecification = providerSpecificationFromDefinition({ ref: 'stripe' }, () => ({
|
|
10
|
+
purpose: 'Bill organizations: product catalogue sync, checkout, subscriptions, usage metering and the webhooks that keep billing state in step with Stripe.',
|
|
11
|
+
businessRole: 'The MAIN billing provider; the only one the engine\'s billing services instantiate today.',
|
|
12
|
+
useWhen: 'Use whenever the application enables the BILLING engine capability.',
|
|
13
|
+
avoidWhen: 'Avoid enabling BILLING without it — the billing bootstrap fails closed with no resolvable provider.',
|
|
14
|
+
businessConstraints: [
|
|
15
|
+
'The webhook secret must match the endpoint registered in the Stripe dashboard, or every delivery is refused as unsigned.',
|
|
16
|
+
'Stripe is a third-party processor of customer billing identity; the compliance lane records it as a recipient.',
|
|
17
|
+
],
|
|
18
|
+
packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,
|
|
19
|
+
tier: ProviderTier.MAIN,
|
|
20
|
+
vendor: 'stripe',
|
|
21
|
+
origin: { kind: ProviderOriginKind.ENGINE },
|
|
22
|
+
facets: ['backend', 'frontend-app'],
|
|
23
|
+
protocols: ['BILLING_PROVIDER', 'WEBHOOK_ORIGINATOR'],
|
|
24
|
+
providerCapabilities: ['BILLING'],
|
|
25
|
+
engineCapabilities: [EngineCapability.BILLING],
|
|
26
|
+
secretsContract: [
|
|
27
|
+
{ slug: 'secretKey', envVarName: 'STRIPE_SECRET_KEY', required: true, description: 'Stripe secret key for Billing API calls.' },
|
|
28
|
+
{ slug: 'webhookSecret', envVarName: 'STRIPE_WEBHOOK_SECRET', required: true, description: 'Stripe webhook signing secret for Billing event verification.' },
|
|
29
|
+
],
|
|
30
|
+
codeHandling: {
|
|
31
|
+
definitionOwner: ENGINE_PROVIDER_OWNER_REF,
|
|
32
|
+
definitionSymbol: backendProviderModuleSymbol('StripeBackendProvider'),
|
|
33
|
+
},
|
|
34
|
+
}));
|
|
35
|
+
//# sourceMappingURL=stripe.provider.specification.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"stripe.provider.specification.js","sourceRoot":"","sources":["../../../../../src/engine/providers/stripe.provider.specification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mCAAmC,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,mCAAmC,CAC5E,EAAE,GAAG,EAAE,QAAQ,EAAE,EACjB,GAAG,EAAE,CAAC,CAAC;IACL,OAAO,EAAE,mJAAmJ;IAC5J,YAAY,EAAE,2FAA2F;IACzG,OAAO,EAAE,qEAAqE;IAC9E,SAAS,EAAE,qGAAqG;IAChH,mBAAmB,EAAE;QACnB,0HAA0H;QAC1H,gHAAgH;KACjH;IACD,WAAW,EAAE,gCAAgC;IAC7C,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,SAAS,EAAE,CAAC,kBAAkB,EAAE,oBAAoB,CAAC;IACrD,oBAAoB,EAAE,CAAC,SAAS,CAAC;IACjC,kBAAkB,EAAE,CAAC,gBAAgB,CAAC,OAAO,CAAC;IAC9C,eAAe,EAAE;QACf,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,0CAA0C,EAAE;QAC/H,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,uBAAuB,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,+DAA+D,EAAE;KAC7J;IACD,YAAY,EAAE;QACZ,eAAe,EAAE,yBAAyB;QAC1C,gBAAgB,EAAE,2BAA2B,CAAC,uBAAuB,CAAC;KACvE;CACF,CAAC,CACH,CAAC","sourcesContent":["import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';\nimport { providerSpecificationFromDefinition } from '~wildo-specifications/_core';\nimport {\n backendProviderModuleSymbol,\n ENGINE_BACKEND_PROVIDERS_PACKAGE,\n ENGINE_PROVIDER_OWNER_REF,\n} from './_engine-provider-shared';\n\n/**\n * Engine provider specification for `stripe` (#328). The FACTS (protocols, capabilities,\n * engine slots, secrets) mirror the backend module and are reconciled against it by\n * `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.\n */\nexport const stripeProviderSpecification = providerSpecificationFromDefinition(\n { ref: 'stripe' },\n () => ({\n purpose: 'Bill organizations: product catalogue sync, checkout, subscriptions, usage metering and the webhooks that keep billing state in step with Stripe.',\n businessRole: 'The MAIN billing provider; the only one the engine\\'s billing services instantiate today.',\n useWhen: 'Use whenever the application enables the BILLING engine capability.',\n avoidWhen: 'Avoid enabling BILLING without it — the billing bootstrap fails closed with no resolvable provider.',\n businessConstraints: [\n 'The webhook secret must match the endpoint registered in the Stripe dashboard, or every delivery is refused as unsigned.',\n 'Stripe is a third-party processor of customer billing identity; the compliance lane records it as a recipient.',\n ],\n packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,\n tier: ProviderTier.MAIN,\n vendor: 'stripe',\n origin: { kind: ProviderOriginKind.ENGINE },\n facets: ['backend', 'frontend-app'],\n protocols: ['BILLING_PROVIDER', 'WEBHOOK_ORIGINATOR'],\n providerCapabilities: ['BILLING'],\n engineCapabilities: [EngineCapability.BILLING],\n secretsContract: [\n { slug: 'secretKey', envVarName: 'STRIPE_SECRET_KEY', required: true, description: 'Stripe secret key for Billing API calls.' },\n { slug: 'webhookSecret', envVarName: 'STRIPE_WEBHOOK_SECRET', required: true, description: 'Stripe webhook signing secret for Billing event verification.' },\n ],\n codeHandling: {\n definitionOwner: ENGINE_PROVIDER_OWNER_REF,\n definitionSymbol: backendProviderModuleSymbol('StripeBackendProvider'),\n },\n }),\n);\n"]}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Engine provider specification for `twilio` (#328). The FACTS (protocols, capabilities,
|
|
3
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
4
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
5
|
+
*/
|
|
6
|
+
export declare const twilioProviderSpecification: import("../../_core").ProviderSpecificationConfig;
|
|
7
|
+
//# sourceMappingURL=twilio.provider.specification.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"twilio.provider.specification.d.ts","sourceRoot":"","sources":["../../../../../src/engine/providers/twilio.provider.specification.ts"],"names":[],"mappings":"AAQA;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,mEA0BvC,CAAC"}
|
|
@@ -0,0 +1,33 @@
|
|
|
1
|
+
import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';
|
|
2
|
+
import { providerSpecificationFromDefinition } from '../../_core/index.js';
|
|
3
|
+
import { backendProviderModuleSymbol, ENGINE_BACKEND_PROVIDERS_PACKAGE, ENGINE_PROVIDER_OWNER_REF, } from './_engine-provider-shared.js';
|
|
4
|
+
/**
|
|
5
|
+
* Engine provider specification for `twilio` (#328). The FACTS (protocols, capabilities,
|
|
6
|
+
* engine slots, secrets) mirror the backend module and are reconciled against it by
|
|
7
|
+
* `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.
|
|
8
|
+
*/
|
|
9
|
+
export const twilioProviderSpecification = providerSpecificationFromDefinition({ ref: 'twilio' }, () => ({
|
|
10
|
+
purpose: 'Send the SMS the engine needs for phone verification and SMS-based second factors.',
|
|
11
|
+
businessRole: 'The MAIN SMS provider.',
|
|
12
|
+
useWhen: 'Use when the application enables the SMS engine capability.',
|
|
13
|
+
avoidWhen: 'Avoid for marketing SMS; only engine verification flows are wired.',
|
|
14
|
+
businessConstraints: [
|
|
15
|
+
'Sending numbers and regulatory registrations are managed in the Twilio console, not in the application.',
|
|
16
|
+
],
|
|
17
|
+
packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,
|
|
18
|
+
tier: ProviderTier.MAIN,
|
|
19
|
+
vendor: 'twilio',
|
|
20
|
+
origin: { kind: ProviderOriginKind.ENGINE },
|
|
21
|
+
facets: ['backend'],
|
|
22
|
+
protocols: ['SMS_PROVIDER'],
|
|
23
|
+
providerCapabilities: ['SMS'],
|
|
24
|
+
engineCapabilities: [EngineCapability.SMS],
|
|
25
|
+
secretsContract: [
|
|
26
|
+
{ slug: 'credentials', envVarName: 'TWILIO_CREDENTIALS', required: true, description: 'Twilio credentials bundle for SMS delivery.' },
|
|
27
|
+
],
|
|
28
|
+
codeHandling: {
|
|
29
|
+
definitionOwner: ENGINE_PROVIDER_OWNER_REF,
|
|
30
|
+
definitionSymbol: backendProviderModuleSymbol('TwilioBackendProvider'),
|
|
31
|
+
},
|
|
32
|
+
}));
|
|
33
|
+
//# sourceMappingURL=twilio.provider.specification.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"twilio.provider.specification.js","sourceRoot":"","sources":["../../../../../src/engine/providers/twilio.provider.specification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC3F,OAAO,EAAE,mCAAmC,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,EACL,2BAA2B,EAC3B,gCAAgC,EAChC,yBAAyB,GAC1B,MAAM,2BAA2B,CAAC;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,mCAAmC,CAC5E,EAAE,GAAG,EAAE,QAAQ,EAAE,EACjB,GAAG,EAAE,CAAC,CAAC;IACL,OAAO,EAAE,oFAAoF;IAC7F,YAAY,EAAE,wBAAwB;IACtC,OAAO,EAAE,6DAA6D;IACtE,SAAS,EAAE,oEAAoE;IAC/E,mBAAmB,EAAE;QACnB,yGAAyG;KAC1G;IACD,WAAW,EAAE,gCAAgC;IAC7C,IAAI,EAAE,YAAY,CAAC,IAAI;IACvB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,EAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE;IAC3C,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,SAAS,EAAE,CAAC,cAAc,CAAC;IAC3B,oBAAoB,EAAE,CAAC,KAAK,CAAC;IAC7B,kBAAkB,EAAE,CAAC,gBAAgB,CAAC,GAAG,CAAC;IAC1C,eAAe,EAAE;QACf,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,oBAAoB,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,6CAA6C,EAAE;KACtI;IACD,YAAY,EAAE;QACZ,eAAe,EAAE,yBAAyB;QAC1C,gBAAgB,EAAE,2BAA2B,CAAC,uBAAuB,CAAC;KACvE;CACF,CAAC,CACH,CAAC","sourcesContent":["import { EngineCapability, ProviderOriginKind, ProviderTier } from '@wildo-ai/saas-models';\nimport { providerSpecificationFromDefinition } from '~wildo-specifications/_core';\nimport {\n backendProviderModuleSymbol,\n ENGINE_BACKEND_PROVIDERS_PACKAGE,\n ENGINE_PROVIDER_OWNER_REF,\n} from './_engine-provider-shared';\n\n/**\n * Engine provider specification for `twilio` (#328). The FACTS (protocols, capabilities,\n * engine slots, secrets) mirror the backend module and are reconciled against it by\n * `engine-provider-specifications.reconciliation.test.ts`; the PROSE is the business meaning.\n */\nexport const twilioProviderSpecification = providerSpecificationFromDefinition(\n { ref: 'twilio' },\n () => ({\n purpose: 'Send the SMS the engine needs for phone verification and SMS-based second factors.',\n businessRole: 'The MAIN SMS provider.',\n useWhen: 'Use when the application enables the SMS engine capability.',\n avoidWhen: 'Avoid for marketing SMS; only engine verification flows are wired.',\n businessConstraints: [\n 'Sending numbers and regulatory registrations are managed in the Twilio console, not in the application.',\n ],\n packageName: ENGINE_BACKEND_PROVIDERS_PACKAGE,\n tier: ProviderTier.MAIN,\n vendor: 'twilio',\n origin: { kind: ProviderOriginKind.ENGINE },\n facets: ['backend'],\n protocols: ['SMS_PROVIDER'],\n providerCapabilities: ['SMS'],\n engineCapabilities: [EngineCapability.SMS],\n secretsContract: [\n { slug: 'credentials', envVarName: 'TWILIO_CREDENTIALS', required: true, description: 'Twilio credentials bundle for SMS delivery.' },\n ],\n codeHandling: {\n definitionOwner: ENGINE_PROVIDER_OWNER_REF,\n definitionSymbol: backendProviderModuleSymbol('TwilioBackendProvider'),\n },\n }),\n);\n"]}
|
|
@@ -101,7 +101,7 @@ export const anonymousUsersResourceSpecification = resourceSpecificationFromFron
|
|
|
101
101
|
semanticRole: 'identifier',
|
|
102
102
|
}),
|
|
103
103
|
transpositionStatus: schemaShape.transpositionStatus.enumSpec({
|
|
104
|
-
meaning: 'Whether the anonymous
|
|
104
|
+
meaning: 'Whether the anonymous record has been fully linked to a user account, partially, or is still pending.',
|
|
105
105
|
enumDeclaration: {
|
|
106
106
|
packageName: '@wildo-ai/saas-models',
|
|
107
107
|
exportName: 'AnonymousUserTranspositionStatus',
|
|
@@ -110,12 +110,12 @@ export const anonymousUsersResourceSpecification = resourceSpecificationFromFron
|
|
|
110
110
|
},
|
|
111
111
|
values: {
|
|
112
112
|
[AnonymousUserTranspositionStatus.PENDING]: { meaning: 'Session exists but no successful ownership transfer yet.' },
|
|
113
|
-
[AnonymousUserTranspositionStatus.PARTIAL]: { meaning: 'Some linkage (e.g. lead
|
|
114
|
-
[AnonymousUserTranspositionStatus.COMPLETE]: { meaning: 'The visitor became an authenticated `users`
|
|
113
|
+
[AnonymousUserTranspositionStatus.PARTIAL]: { meaning: 'Some linkage (e.g. lead record) without a full user account.' },
|
|
114
|
+
[AnonymousUserTranspositionStatus.COMPLETE]: { meaning: 'The visitor became an authenticated `users` record and FKs are coherent.' },
|
|
115
115
|
},
|
|
116
116
|
}),
|
|
117
117
|
createdAt: schemaShape.createdAt.dateSpec({
|
|
118
|
-
meaning: 'When the anonymous anchor
|
|
118
|
+
meaning: 'When the anonymous anchor record was first created (session start).',
|
|
119
119
|
temporalRole: 'creation',
|
|
120
120
|
importance: FieldSemanticImportance.PRIMARY,
|
|
121
121
|
}),
|
|
@@ -126,7 +126,7 @@ export const anonymousUsersResourceSpecification = resourceSpecificationFromFron
|
|
|
126
126
|
outcome: 'The platform can attach rate limits, lead rows, and marketing metadata to a stable id.',
|
|
127
127
|
whenToUse: 'Repository or system services — not a public unauthenticated CRUD in production.',
|
|
128
128
|
responseStatuses: [
|
|
129
|
-
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'A new anonymous anchor
|
|
129
|
+
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'A new anonymous anchor record is minted with a stable id that rate limits, leads, and marketing metadata can attach to.' },
|
|
130
130
|
],
|
|
131
131
|
errorScenarios: [
|
|
132
132
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The provisioning payload (privacy posture, forensic fields) fails schema validation.', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -155,7 +155,7 @@ export const anonymousUsersResourceSpecification = resourceSpecificationFromFron
|
|
|
155
155
|
outcome: 'Operators can verify transposition, privacy, and forensic fields during investigations.',
|
|
156
156
|
whenToUse: 'Super-admin investigation only. NOT an anonymous self-read: the session reaches its owned data via the nested `/anonymous-users/{uuidRef}/…` routes and validates via the JWT; a direct read resolves by `_id`, which is a server ObjectId, not the session `uuidRef`.',
|
|
157
157
|
responseStatuses: [
|
|
158
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The anonymous anchor
|
|
158
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The anonymous anchor record was found and its transposition/privacy/forensic fields are returned (marketing metadata stays backend-only).' },
|
|
159
159
|
],
|
|
160
160
|
errorScenarios: [
|
|
161
161
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No anonymous anchor exists for the supplied `_id` (the session expired, was purged, or never existed).' },
|
|
@@ -177,7 +177,7 @@ export const anonymousUsersResourceSpecification = resourceSpecificationFromFron
|
|
|
177
177
|
purpose: 'Internal mutation of transposition, privacy, or metadata during session upgrades.',
|
|
178
178
|
outcome: 'The record reflects the latest ownership and compliance state after backend flows.',
|
|
179
179
|
responseStatuses: [
|
|
180
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The anonymous
|
|
180
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The anonymous record’s transposition/privacy/metadata was updated and the latest state is returned.' },
|
|
181
181
|
],
|
|
182
182
|
errorScenarios: [
|
|
183
183
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The mutated fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"anonymous-users.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/users/resources/anonymous-users.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource: `anonymous_users` — Wildo SaaS engine specification (mixed).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/users/anonymous-users.shared.schema.ts → `AnonymousUserSchema`\n * - Factory: engine/saas-models/src/users/anonymous-users.shared.resources-config.schemas.ts\n * - Custom operations: none (core CRUD only)\n * - Presets: `anonymousUsersMainResourceUIBehavior` + `anonymousUsersAdminResourceUIBehavior` from\n * `engine/presets-components/src/config/resources/identity.resource-presets.tsx`\n */\n\nimport {\n anonymousUsersAdminResourceUIBehavior as anonymousUsersAdminResourceUIBehaviorSource,\n anonymousUsersMainResourceUIBehavior as anonymousUsersMainResourceUIBehaviorSource,\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 CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n AnonymousUserSchema,\n AnonymousUserTranspositionStatus,\n anonymousUsersResourceConfiguration_InitializationFactory as anonymousUsersFactory,\n CoreResourceOperation as Op,\n ResourcePrimaryScope,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype AnonymousUsersConfig = ReturnType<typeof anonymousUsersFactory>;\ntype AnonymousUsersCoreOp = AnonymousUsersConfig['coreOperations'][number];\ntype AnonymousUsersSchema = AnonymousUsersConfig['mainSchema'];\n\nconst anonymousUsersMainResourceUIBehavior = anonymousUsersMainResourceUIBehaviorSource as ResourceUIBehaviorConfig<\n undefined,\n AnonymousUsersCoreOp,\n AnonymousUsersSchema\n>;\n\nconst anonymousUsersAdminResourceUIBehavior = anonymousUsersAdminResourceUIBehaviorSource as ResourceUIBehaviorConfig<\n undefined,\n AnonymousUsersCoreOp,\n AnonymousUsersSchema\n>;\n\nexport const anonymousUsersResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(\n resourceFrontendConfiguration(anonymousUsersMainResourceUIBehavior),\n resourceFrontendConfiguration(anonymousUsersAdminResourceUIBehavior),\n ),\n resourceSpecification(\n anonymousUsersFactory,\n AnonymousUserSchema,\n ({ schemaShape }) => ({\n purpose: 'Anchor pre-authentication marketing sessions: privacy posture, first-touch metadata, and transposition into a real user.',\n businessRole: 'The anonymous side of the identity graph — every visitor gets a row before sign-up, tied to rate limits, inbound leads, and UTM context.',\n lifecycleRole: 'Created at session start, updated as privacy or transposition state changes, retained for audit unless compliance demands erasure.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.USERS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'AnonymousUserSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'anonymousUsersResourceConfiguration_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: 'ANONYMOUS_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 },\n frontendConfigurationSources: [\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'anonymousUsersMainResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'anonymousUsersAdminResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n ],\n notes: [\n 'No `userNotifications[]` on any operation — the runtime has no comms fan-out; do not add communications.* blocks (DF-1).',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Server-minted MongoDB storage id (ObjectId). Internal only — the anonymous user’s relational identity is `uuidRef`, not this. Child FKs and the session JWT never carry `_id`.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n uuidRef: schemaShape.uuidRef.stringSpec({\n meaning: 'Client-generated session UUID — the anonymous user’s relational identity. The `anonymousUserId` FK on child resources, the session JWT, and the `/anonymous-users/{uuidRef}/…` nested routes all key off this, never `_id`.',\n whyItMatters: 'Carries the same anonymous identity across origins (marketing site → app, which have separate localStorage) and across page reload / 24h JWT expiry; being an unguessable random UUID it can be safely presented at init to re-adopt an existing session.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n privacy: schemaShape.privacy.objectSpec({\n meaning: 'Per-session marketing and processing consent for anonymous browsing.',\n whyItMatters: 'Demonstrates the visitor agreed to the anonymous data policy before personalization or lead capture.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n userAgent: schemaShape.userAgent.stringSpec({\n meaning: 'Optional browser or client fingerprint string captured for fraud and support triage.',\n }),\n\n ipHash: schemaShape.ipHash.stringSpec({\n meaning: 'One-way hash of the client IP for rate limiting without storing raw PII in hot paths.',\n semanticRole: 'code',\n }),\n\n marketingMetadata: schemaShape.marketingMetadata.objectSpec({\n meaning: 'First-touch UTM, campaign, and path attribution — backend-only, joined server-side to leads.',\n whyItMatters: 'Powers “how did you hear about us” without duplicating the payload on `InboundContact` rows.',\n }),\n\n convertedToUserId: schemaShape.convertedToUserId.stringSpec({\n meaning: 'Wildo `users` id once the same anonymous session completes signup or login transposition.',\n semanticRole: 'identifier',\n }),\n\n transpositionStatus: schemaShape.transpositionStatus.enumSpec({\n meaning: 'Whether the anonymous row has been fully linked to a user account, partially, or is still pending.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'AnonymousUserTranspositionStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [AnonymousUserTranspositionStatus.PENDING]: { meaning: 'Session exists but no successful ownership transfer yet.' },\n [AnonymousUserTranspositionStatus.PARTIAL]: { meaning: 'Some linkage (e.g. lead row) without a full user account.' },\n [AnonymousUserTranspositionStatus.COMPLETE]: { meaning: 'The visitor became an authenticated `users` row and FKs are coherent.' },\n },\n }),\n\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the anonymous anchor row was first created (session start).',\n temporalRole: 'creation',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n },\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Internal provisioning of a new anonymous anchor when a session is minted.',\n outcome: 'The platform can attach rate limits, lead rows, and marketing metadata to a stable id.',\n whenToUse: 'Repository or system services — not a public unauthenticated CRUD in production.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A new anonymous anchor row is minted with a stable id that rate limits, leads, and marketing metadata can attach to.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The provisioning payload (privacy posture, forensic fields) fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Mint an anonymous session anchor',\n request: {\n uuidRef: '550e8400-e29b-41d4-a716-446655440000',\n privacy: { dataProcessingConsent: 'basic' },\n userAgent: 'Mozilla/5.0 (…)',\n },\n response: {\n _id: '507f1f77bcf86cd799439011',\n uuidRef: '550e8400-e29b-41d4-a716-446655440000',\n transpositionStatus: AnonymousUserTranspositionStatus.PENDING,\n createdAt: '2026-06-15T10:00:00.000Z',\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.READ]: {\n purpose: 'Super-admin inspection of an anonymous anchor row by its `_id`.',\n outcome: 'Operators can verify transposition, privacy, and forensic fields during investigations.',\n whenToUse: 'Super-admin investigation only. NOT an anonymous self-read: the session reaches its owned data via the nested `/anonymous-users/{uuidRef}/…` routes and validates via the JWT; a direct read resolves by `_id`, which is a server ObjectId, not the session `uuidRef`.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The anonymous anchor row was found and its transposition/privacy/forensic fields are returned (marketing metadata stays backend-only).' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No anonymous anchor exists for the supplied `_id` (the session expired, was purged, or never existed).' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'Administrative directory of recent anonymous visitors for support and anti-abuse review.',\n outcome: 'Operators can page session anchors in recency order within admin consoles.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of recent anonymous session anchors in recency order.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a super-admin; the global anonymous-visitor directory is never exposed to org-level operators (see businessConstraints).' },\n ],\n idempotent: true,\n },\n [Op.UPDATE]: {\n purpose: 'Internal mutation of transposition, privacy, or metadata during session upgrades.',\n outcome: 'The record reflects the latest ownership and compliance state after backend flows.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The anonymous row’s transposition/privacy/metadata was updated and the latest state is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The mutated fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No anonymous anchor exists for the supplied id.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A transposition mutation conflicts with existing ownership — e.g. `convertedToUserId` is already set to a different user, so re-binding the session to another identity is rejected.' },\n ],\n idempotent: true,\n },\n [Op.DELETE]: {\n purpose: 'Remove an anonymous row under compliance or when sessions are purged after retention policy.',\n outcome: 'The visitor anchor no longer exists — downstream FKs (e.g. leads) must already be nullified or re-bound.',\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The anonymous anchor was deleted under retention/compliance; no body is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the super-admin / compliance role required to purge an anonymous anchor.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No anonymous anchor exists for the supplied id (or it was already purged).' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'Dependent rows (e.g. `InboundContact` leads) still reference this anchor and must be nullified or re-bound before the anchor can be removed.' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'Marketing metadata is backend-only at rest — it never ships to the generic READ DTO; companion prompts must not assume client-visible UTM without checking runtime serialization.',\n 'LIST is super-admin only in the main runtime variants — do not expose unfiltered global anonymous lists to org-level operators.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.ANONYMOUS },\n ),\n () => ({\n layout: {\n purpose: 'Group anonymous-visitor inspection into session health, compliance, and forensic slices.',\n displayPurpose: 'Let admins review state without exposing more PII than the preset sections already surface.',\n summaryPurpose: 'Show transposition and creation time in compact list rows.',\n sections: {\n overview: {\n purpose: 'Surface transposition and lifecycle timestamps for triage at a glance.',\n whenToUse: 'First panel when opening an anonymous visitor detail.',\n textSlots: {\n title: { purpose: 'Label the “session overview” card.' },\n description: { purpose: 'Explain that this block shows conversion progress and when the row was created.' },\n },\n },\n privacy: {\n purpose: 'Show consent captured for the anonymous relationship.',\n whenToUse: 'When validating GDPR/marketing opt-in for the session.',\n textSlots: {\n title: { purpose: 'Label the privacy and consent area.' },\n description: { purpose: 'Clarify that this is the anonymous visitor’s policy posture, not the post-signup `users` privacy document.' },\n },\n },\n context: {\n purpose: 'Optional forensic context (user agent, IP hash) for support and abuse investigations.',\n whenToUse: 'When correlating a session with WAF or rate-limit logs.',\n textSlots: {\n title: { purpose: 'Label the forensic / technical context section.' },\n description: { purpose: 'State that these fields may be redacted in some deployments.' },\n },\n },\n },\n },\n views: {\n [Op.READ]: {\n purpose: 'Read-only anonymous session inspection in the super-admin context.',\n whenToUse: 'When a platform operator inspects a specific anonymous anchor during investigations.',\n },\n [Op.LIST]: {\n purpose: 'Admin-only list of anonymous session anchors for operational review.',\n whenToUse: 'When a platform operator triages sign-up funnel issues or fraud.',\n },\n },\n }),\n);\n"]}
|
|
1
|
+
{"version":3,"file":"anonymous-users.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/users/resources/anonymous-users.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource: `anonymous_users` — Wildo SaaS engine specification (mixed).\n *\n * Inputs:\n * - Schema: engine/saas-models/src/users/anonymous-users.shared.schema.ts → `AnonymousUserSchema`\n * - Factory: engine/saas-models/src/users/anonymous-users.shared.resources-config.schemas.ts\n * - Custom operations: none (core CRUD only)\n * - Presets: `anonymousUsersMainResourceUIBehavior` + `anonymousUsersAdminResourceUIBehavior` from\n * `engine/presets-components/src/config/resources/identity.resource-presets.tsx`\n */\n\nimport {\n anonymousUsersAdminResourceUIBehavior as anonymousUsersAdminResourceUIBehaviorSource,\n anonymousUsersMainResourceUIBehavior as anonymousUsersMainResourceUIBehaviorSource,\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 CodeDeclarationKind,\n CodeSymbolKind,\n FieldSemanticImportance,\n} from '@wildo-ai/zod-decorators';\nimport {\n AnonymousUserSchema,\n AnonymousUserTranspositionStatus,\n anonymousUsersResourceConfiguration_InitializationFactory as anonymousUsersFactory,\n CoreResourceOperation as Op,\n ResourcePrimaryScope,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype AnonymousUsersConfig = ReturnType<typeof anonymousUsersFactory>;\ntype AnonymousUsersCoreOp = AnonymousUsersConfig['coreOperations'][number];\ntype AnonymousUsersSchema = AnonymousUsersConfig['mainSchema'];\n\nconst anonymousUsersMainResourceUIBehavior = anonymousUsersMainResourceUIBehaviorSource as ResourceUIBehaviorConfig<\n undefined,\n AnonymousUsersCoreOp,\n AnonymousUsersSchema\n>;\n\nconst anonymousUsersAdminResourceUIBehavior = anonymousUsersAdminResourceUIBehaviorSource as ResourceUIBehaviorConfig<\n undefined,\n AnonymousUsersCoreOp,\n AnonymousUsersSchema\n>;\n\nexport const anonymousUsersResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(\n resourceFrontendConfiguration(anonymousUsersMainResourceUIBehavior),\n resourceFrontendConfiguration(anonymousUsersAdminResourceUIBehavior),\n ),\n resourceSpecification(\n anonymousUsersFactory,\n AnonymousUserSchema,\n ({ schemaShape }) => ({\n purpose: 'Anchor pre-authentication marketing sessions: privacy posture, first-touch metadata, and transposition into a real user.',\n businessRole: 'The anonymous side of the identity graph — every visitor gets a row before sign-up, tied to rate limits, inbound leads, and UTM context.',\n lifecycleRole: 'Created at session start, updated as privacy or transposition state changes, retained for audit unless compliance demands erasure.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.USERS,\n codeHandling: {\n mainSchema: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'AnonymousUserSchema',\n symbolKind: CodeSymbolKind.SCHEMA,\n declarationKind: CodeDeclarationKind.ZOD_SCHEMA,\n },\n resourceFactory: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'anonymousUsersResourceConfiguration_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: 'ANONYMOUS_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 },\n frontendConfigurationSources: [\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'anonymousUsersMainResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n {\n packageName: '@wildo-ai/presets-components',\n exportName: 'anonymousUsersAdminResourceUIBehavior',\n symbolKind: CodeSymbolKind.UI_BEHAVIOR,\n },\n ],\n notes: [\n 'No `userNotifications[]` on any operation — the runtime has no comms fan-out; do not add communications.* blocks (DF-1).',\n ],\n },\n\n fields: {\n _id: schemaShape._id.stringSpec({\n meaning: 'Server-minted MongoDB storage id (ObjectId). Internal only — the anonymous user’s relational identity is `uuidRef`, not this. Child FKs and the session JWT never carry `_id`.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n uuidRef: schemaShape.uuidRef.stringSpec({\n meaning: 'Client-generated session UUID — the anonymous user’s relational identity. The `anonymousUserId` FK on child resources, the session JWT, and the `/anonymous-users/{uuidRef}/…` nested routes all key off this, never `_id`.',\n whyItMatters: 'Carries the same anonymous identity across origins (marketing site → app, which have separate localStorage) and across page reload / 24h JWT expiry; being an unguessable random UUID it can be safely presented at init to re-adopt an existing session.',\n semanticRole: 'identifier',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n privacy: schemaShape.privacy.objectSpec({\n meaning: 'Per-session marketing and processing consent for anonymous browsing.',\n whyItMatters: 'Demonstrates the visitor agreed to the anonymous data policy before personalization or lead capture.',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n\n userAgent: schemaShape.userAgent.stringSpec({\n meaning: 'Optional browser or client fingerprint string captured for fraud and support triage.',\n }),\n\n ipHash: schemaShape.ipHash.stringSpec({\n meaning: 'One-way hash of the client IP for rate limiting without storing raw PII in hot paths.',\n semanticRole: 'code',\n }),\n\n marketingMetadata: schemaShape.marketingMetadata.objectSpec({\n meaning: 'First-touch UTM, campaign, and path attribution — backend-only, joined server-side to leads.',\n whyItMatters: 'Powers “how did you hear about us” without duplicating the payload on `InboundContact` rows.',\n }),\n\n convertedToUserId: schemaShape.convertedToUserId.stringSpec({\n meaning: 'Wildo `users` id once the same anonymous session completes signup or login transposition.',\n semanticRole: 'identifier',\n }),\n\n transpositionStatus: schemaShape.transpositionStatus.enumSpec({\n meaning: 'Whether the anonymous record has been fully linked to a user account, partially, or is still pending.',\n enumDeclaration: {\n packageName: '@wildo-ai/saas-models',\n exportName: 'AnonymousUserTranspositionStatus',\n symbolKind: CodeSymbolKind.ENUM,\n declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM,\n },\n values: {\n [AnonymousUserTranspositionStatus.PENDING]: { meaning: 'Session exists but no successful ownership transfer yet.' },\n [AnonymousUserTranspositionStatus.PARTIAL]: { meaning: 'Some linkage (e.g. lead record) without a full user account.' },\n [AnonymousUserTranspositionStatus.COMPLETE]: { meaning: 'The visitor became an authenticated `users` record and FKs are coherent.' },\n },\n }),\n\n createdAt: schemaShape.createdAt.dateSpec({\n meaning: 'When the anonymous anchor record was first created (session start).',\n temporalRole: 'creation',\n importance: FieldSemanticImportance.PRIMARY,\n }),\n },\n\n operations: {\n [Op.CREATE]: {\n purpose: 'Internal provisioning of a new anonymous anchor when a session is minted.',\n outcome: 'The platform can attach rate limits, lead rows, and marketing metadata to a stable id.',\n whenToUse: 'Repository or system services — not a public unauthenticated CRUD in production.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A new anonymous anchor record is minted with a stable id that rate limits, leads, and marketing metadata can attach to.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The provisioning payload (privacy posture, forensic fields) fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Mint an anonymous session anchor',\n request: {\n uuidRef: '550e8400-e29b-41d4-a716-446655440000',\n privacy: { dataProcessingConsent: 'basic' },\n userAgent: 'Mozilla/5.0 (…)',\n },\n response: {\n _id: '507f1f77bcf86cd799439011',\n uuidRef: '550e8400-e29b-41d4-a716-446655440000',\n transpositionStatus: AnonymousUserTranspositionStatus.PENDING,\n createdAt: '2026-06-15T10:00:00.000Z',\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.READ]: {\n purpose: 'Super-admin inspection of an anonymous anchor row by its `_id`.',\n outcome: 'Operators can verify transposition, privacy, and forensic fields during investigations.',\n whenToUse: 'Super-admin investigation only. NOT an anonymous self-read: the session reaches its owned data via the nested `/anonymous-users/{uuidRef}/…` routes and validates via the JWT; a direct read resolves by `_id`, which is a server ObjectId, not the session `uuidRef`.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The anonymous anchor record was found and its transposition/privacy/forensic fields are returned (marketing metadata stays backend-only).' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No anonymous anchor exists for the supplied `_id` (the session expired, was purged, or never existed).' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'Administrative directory of recent anonymous visitors for support and anti-abuse review.',\n outcome: 'Operators can page session anchors in recency order within admin consoles.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of recent anonymous session anchors in recency order.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not a super-admin; the global anonymous-visitor directory is never exposed to org-level operators (see businessConstraints).' },\n ],\n idempotent: true,\n },\n [Op.UPDATE]: {\n purpose: 'Internal mutation of transposition, privacy, or metadata during session upgrades.',\n outcome: 'The record reflects the latest ownership and compliance state after backend flows.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The anonymous record’s transposition/privacy/metadata was updated and the latest state is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The mutated fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No anonymous anchor exists for the supplied id.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A transposition mutation conflicts with existing ownership — e.g. `convertedToUserId` is already set to a different user, so re-binding the session to another identity is rejected.' },\n ],\n idempotent: true,\n },\n [Op.DELETE]: {\n purpose: 'Remove an anonymous row under compliance or when sessions are purged after retention policy.',\n outcome: 'The visitor anchor no longer exists — downstream FKs (e.g. leads) must already be nullified or re-bound.',\n responseStatuses: [\n { code: HttpResponseStatusCode.NO_CONTENT_204, meaning: 'The anonymous anchor was deleted under retention/compliance; no body is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the super-admin / compliance role required to purge an anonymous anchor.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No anonymous anchor exists for the supplied id (or it was already purged).' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'Dependent rows (e.g. `InboundContact` leads) still reference this anchor and must be nullified or re-bound before the anchor can be removed.' },\n ],\n idempotent: true,\n },\n },\n\n businessConstraints: [\n 'Marketing metadata is backend-only at rest — it never ships to the generic READ DTO; companion prompts must not assume client-visible UTM without checking runtime serialization.',\n 'LIST is super-admin only in the main runtime variants — do not expose unfiltered global anonymous lists to org-level operators.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.ANONYMOUS },\n ),\n () => ({\n layout: {\n purpose: 'Group anonymous-visitor inspection into session health, compliance, and forensic slices.',\n displayPurpose: 'Let admins review state without exposing more PII than the preset sections already surface.',\n summaryPurpose: 'Show transposition and creation time in compact list rows.',\n sections: {\n overview: {\n purpose: 'Surface transposition and lifecycle timestamps for triage at a glance.',\n whenToUse: 'First panel when opening an anonymous visitor detail.',\n textSlots: {\n title: { purpose: 'Label the “session overview” card.' },\n description: { purpose: 'Explain that this block shows conversion progress and when the row was created.' },\n },\n },\n privacy: {\n purpose: 'Show consent captured for the anonymous relationship.',\n whenToUse: 'When validating GDPR/marketing opt-in for the session.',\n textSlots: {\n title: { purpose: 'Label the privacy and consent area.' },\n description: { purpose: 'Clarify that this is the anonymous visitor’s policy posture, not the post-signup `users` privacy document.' },\n },\n },\n context: {\n purpose: 'Optional forensic context (user agent, IP hash) for support and abuse investigations.',\n whenToUse: 'When correlating a session with WAF or rate-limit logs.',\n textSlots: {\n title: { purpose: 'Label the forensic / technical context section.' },\n description: { purpose: 'State that these fields may be redacted in some deployments.' },\n },\n },\n },\n },\n views: {\n [Op.READ]: {\n purpose: 'Read-only anonymous session inspection in the super-admin context.',\n whenToUse: 'When a platform operator inspects a specific anonymous anchor during investigations.',\n },\n [Op.LIST]: {\n purpose: 'Admin-only list of anonymous session anchors for operational review.',\n whenToUse: 'When a platform operator triages sign-up funnel issues or fraud.',\n },\n },\n }),\n);\n"]}
|