@wildo-ai/saas-specifications 1.1.2 → 1.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/esm/_core/brand/brand-asset.schemas.d.ts +4 -6
- package/dist/esm/_core/brand/brand-asset.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-asset.schemas.js +4 -12
- package/dist/esm/_core/brand/brand-asset.schemas.js.map +1 -1
- package/dist/esm/_core/brand/brand-generation.schemas.d.ts +5 -3
- package/dist/esm/_core/brand/brand-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-generation.schemas.js +5 -2
- package/dist/esm/_core/brand/brand-generation.schemas.js.map +1 -1
- package/dist/esm/_core/brand/brand-snapshot.schemas.d.ts +10 -3
- package/dist/esm/_core/brand/brand-snapshot.schemas.d.ts.map +1 -1
- package/dist/esm/_core/brand/brand-snapshot.schemas.js +10 -2
- package/dist/esm/_core/brand/brand-snapshot.schemas.js.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.js +15 -5
- package/dist/esm/_core/build-plan/build-plan-task-graph-generation.schemas.js.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts +40 -3
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.d.ts.map +1 -1
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js +85 -6
- package/dist/esm/_core/build-plan/build-plan-task-graph-validation.js.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js +10 -4
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts +15 -0
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/business-model-lite/business-model-lite-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts +10 -0
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.d.ts.map +1 -1
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js +17 -0
- package/dist/esm/_core/compliance-documents/compliance-document-candidate.schemas.js.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts +6 -7
- package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js +6 -13
- package/dist/esm/_core/expert-personas/expert-persona-charter.schemas.js.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-validation.d.ts +0 -11
- package/dist/esm/_core/expert-personas/expert-persona-validation.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-persona-validation.js +0 -19
- package/dist/esm/_core/expert-personas/expert-persona-validation.js.map +1 -1
- package/dist/esm/_core/expert-personas/expert-role-template.schemas.d.ts +1 -2
- package/dist/esm/_core/expert-personas/expert-role-template.schemas.d.ts.map +1 -1
- package/dist/esm/_core/expert-personas/expert-role-template.schemas.js +1 -2
- package/dist/esm/_core/expert-personas/expert-role-template.schemas.js.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.js +17 -4
- package/dist/esm/_core/feature-drafts/feature-specification-drafts-generation.schemas.js.map +1 -1
- package/dist/esm/_core/index.d.ts +1 -0
- package/dist/esm/_core/index.d.ts.map +1 -1
- package/dist/esm/_core/index.js +1 -0
- package/dist/esm/_core/index.js.map +1 -1
- package/dist/esm/_core/market/market-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/market/market-snapshot-generation.schemas.js +5 -40
- package/dist/esm/_core/market/market-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/market/market-snapshot-validation.d.ts +15 -0
- package/dist/esm/_core/market/market-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/market/market-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js +11 -5
- package/dist/esm/_core/placement-plan/placement-plan-generation.schemas.js.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts +66 -9
- package/dist/esm/_core/placement-plan/placement-plan-validation.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan-validation.js +62 -20
- package/dist/esm/_core/placement-plan/placement-plan-validation.js.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts +4 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.d.ts.map +1 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.js +4 -1
- package/dist/esm/_core/placement-plan/placement-plan.schemas.js.map +1 -1
- package/dist/esm/_core/provider-specification.schemas.d.ts +82 -0
- package/dist/esm/_core/provider-specification.schemas.d.ts.map +1 -0
- package/dist/esm/_core/provider-specification.schemas.js +144 -0
- package/dist/esm/_core/provider-specification.schemas.js.map +1 -0
- package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js +13 -8
- package/dist/esm/_core/requirements/requirements-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts +15 -0
- package/dist/esm/_core/requirements/requirements-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/requirements/requirements-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js +7 -2
- package/dist/esm/_core/roadmap/roadmap-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-validation.d.ts +15 -0
- package/dist/esm/_core/roadmap/roadmap-snapshot-validation.d.ts.map +1 -1
- package/dist/esm/_core/roadmap/roadmap-snapshot-validation.js.map +1 -1
- package/dist/esm/_core/utils/family-ref-stamping.d.ts +64 -0
- package/dist/esm/_core/utils/family-ref-stamping.d.ts.map +1 -0
- package/dist/esm/_core/utils/family-ref-stamping.js +73 -0
- package/dist/esm/_core/utils/family-ref-stamping.js.map +1 -0
- package/dist/esm/_core/vision/vision-snapshot-generation.schemas.d.ts.map +1 -1
- package/dist/esm/_core/vision/vision-snapshot-generation.schemas.js +23 -9
- package/dist/esm/_core/vision/vision-snapshot-generation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-coding-tasks.application-creation.schemas.d.ts +0 -4
- package/dist/esm/application-creation/application-coding-tasks.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts +7 -7
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js +6 -7
- package/dist/esm/application-creation/application-document-fact-specification.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.d.ts +3 -3
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js +3 -3
- package/dist/esm/application-creation/application-document-release-policy-specification.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.d.ts +2 -2
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js +2 -2
- package/dist/esm/application-creation/application-specification-family-identity.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/journey.application-creation.schemas.d.ts +18 -6
- package/dist/esm/application-creation/journey.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/journey.application-creation.schemas.js +18 -6
- package/dist/esm/application-creation/journey.application-creation.schemas.js.map +1 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts +8 -23
- package/dist/esm/application-creation/playbooks.application-creation.schemas.d.ts.map +1 -1
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js +57 -27
- package/dist/esm/application-creation/playbooks.application-creation.schemas.js.map +1 -1
- package/dist/esm/assurance/application-document-publication.schemas.d.ts +20 -6
- package/dist/esm/assurance/application-document-publication.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/application-document-publication.schemas.js +26 -10
- package/dist/esm/assurance/application-document-publication.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts +72 -49
- package/dist/esm/assurance/assurance-authority-basis.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.definitions.js +161 -60
- package/dist/esm/assurance/assurance-authority-basis.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts +25 -0
- package/dist/esm/assurance/assurance-authority-basis.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts +36 -0
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.d.ts.map +1 -0
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js +859 -0
- package/dist/esm/assurance/assurance-evidence-requirement-bodies.definitions.js.map +1 -0
- package/dist/esm/assurance/assurance-foundation.schemas.d.ts +43 -0
- package/dist/esm/assurance/assurance-foundation.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-foundation.schemas.js +56 -0
- package/dist/esm/assurance/assurance-foundation.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts +14 -7
- package/dist/esm/assurance/assurance-objective-catalog.definitions.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js +24 -7
- package/dist/esm/assurance/assurance-objective-catalog.definitions.js.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts +8 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program-generation.schemas.js +10 -2
- package/dist/esm/assurance/assurance-program-generation.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.d.ts +447 -11
- package/dist/esm/assurance/assurance-program.schemas.d.ts.map +1 -1
- package/dist/esm/assurance/assurance-program.schemas.js +293 -5
- package/dist/esm/assurance/assurance-program.schemas.js.map +1 -1
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts +35 -0
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.d.ts.map +1 -0
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js +999 -0
- package/dist/esm/assurance/assurance-verification-requirement-bodies.definitions.js.map +1 -0
- package/dist/esm/companion-exports.d.ts +7 -6
- package/dist/esm/companion-exports.d.ts.map +1 -1
- package/dist/esm/companion-exports.js.map +1 -1
- package/dist/esm/engine/_bootstrap.js +3 -1
- package/dist/esm/engine/_bootstrap.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js +13 -1
- package/dist/esm/engine/applications/resources/application-api-keys.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js +1 -1
- package/dist/esm/engine/applications/resources/application-metadata.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts +2 -0
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js +14 -2
- package/dist/esm/engine/applications/resources/application-oauth-clients.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.js +9 -9
- package/dist/esm/engine/applications/resources/application-versions.resource.specification.js.map +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.js +1 -1
- package/dist/esm/engine/applications/resources/applications.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js +3 -3
- package/dist/esm/engine/auth/resources/consumable-tokens.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js +1 -1
- package/dist/esm/engine/auth/resources/oauth-consent-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js +13 -1
- package/dist/esm/engine/auth/resources/organization-api-keys.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts +2 -0
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js +14 -2
- package/dist/esm/engine/auth/resources/organization-oauth-clients.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts +32 -0
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js +308 -0
- package/dist/esm/engine/auth/resources/organization-provider-credentials.resource.specification.js.map +1 -0
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js +4 -4
- package/dist/esm/engine/auth/resources/platform-access-grants.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js +2 -2
- package/dist/esm/engine/auth/resources/scim-provisioning-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js +6 -6
- package/dist/esm/engine/auth/resources/scim-tokens.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js +9 -9
- package/dist/esm/engine/auth/resources/siem-delivery-dlq.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js +2 -2
- package/dist/esm/engine/auth/resources/siem-export-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts +9 -25
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.js +104 -10
- package/dist/esm/engine/auth/resources/sso-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts +0 -6
- package/dist/esm/engine/auth/resources/sso-connections.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts +32 -0
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.d.ts.map +1 -0
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js +297 -0
- package/dist/esm/engine/auth/resources/user-provider-credentials.resource.specification.js.map +1 -0
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js +4 -3
- package/dist/esm/engine/billing/resources/billing-accounts.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js +2 -2
- package/dist/esm/engine/billing/resources/credit-pools.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js +3 -3
- package/dist/esm/engine/billing/resources/invoice-refs.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/prices.resource.specification.js +7 -7
- package/dist/esm/engine/billing/resources/prices.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/products.resource.specification.js +7 -7
- package/dist/esm/engine/billing/resources/products.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/promotions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/promotions.resource.specification.js +14 -12
- package/dist/esm/engine/billing/resources/promotions.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/referrals.resource.specification.js +7 -7
- package/dist/esm/engine/billing/resources/referrals.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js +6 -3
- package/dist/esm/engine/billing/resources/subscriptions.resource.specification.js.map +1 -1
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts +7 -3
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.js +28 -11
- package/dist/esm/engine/billing/resources/usage-records.resource.specification.js.map +1 -1
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js +8 -8
- package/dist/esm/engine/compliance/resources/audit-logs.resource.specification.js.map +1 -1
- package/dist/esm/engine/engine-resource-specifications.registry.d.ts +2 -2
- package/dist/esm/engine/engine-resource-specifications.registry.d.ts.map +1 -1
- package/dist/esm/engine/engine-resource-specifications.registry.js +6 -2
- package/dist/esm/engine/engine-resource-specifications.registry.js.map +1 -1
- package/dist/esm/engine/engine-resource-sub-domain.d.ts +20 -0
- package/dist/esm/engine/engine-resource-sub-domain.d.ts.map +1 -1
- package/dist/esm/engine/engine-resource-sub-domain.js +66 -0
- package/dist/esm/engine/engine-resource-sub-domain.js.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.d.ts.map +1 -1
- package/dist/esm/engine/errors/error-messages.specification.js +14 -0
- package/dist/esm/engine/errors/error-messages.specification.js.map +1 -1
- package/dist/esm/engine/features/audit-logs.feature.specification.js +4 -4
- package/dist/esm/engine/features/audit-logs.feature.specification.js.map +1 -1
- package/dist/esm/engine/features/core-limits.feature.specifications.js +7 -7
- package/dist/esm/engine/features/core-limits.feature.specifications.js.map +1 -1
- package/dist/esm/engine/features/resources/application-features.resource.specification.js +3 -3
- package/dist/esm/engine/features/resources/application-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/resources/organization-features.resource.specification.js +3 -3
- package/dist/esm/engine/features/resources/organization-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/features/resources/user-features.resource.specification.js +3 -3
- package/dist/esm/engine/features/resources/user-features.resource.specification.js.map +1 -1
- package/dist/esm/engine/files/resources/files.resource.specification.js +10 -10
- package/dist/esm/engine/files/resources/files.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js +11 -11
- package/dist/esm/engine/flows-actors/resources/a2a-push-delivery-log.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js +4 -4
- package/dist/esm/engine/flows-actors/resources/a2a-token-budget-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js +2 -2
- package/dist/esm/engine/flows-actors/resources/flow-actor-executions.resource.specification.js.map +1 -1
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts +5 -0
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.d.ts.map +1 -0
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js +81 -0
- package/dist/esm/engine/frontend-components/app/app-layout-connected-accounts-settings.frontend-component.specification.js.map +1 -0
- package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.d.ts +4 -0
- package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.d.ts.map +1 -0
- package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.js +22 -0
- package/dist/esm/engine/frontend-components/app/public-layout-file-upload-grant.frontend-component.specification.js.map +1 -0
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.d.ts +0 -4
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.d.ts.map +0 -1
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.js +0 -21
- package/dist/esm/engine/frontend-components/billing/billing-plan-change-preview.frontend-component.specification.js.map +0 -1
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.d.ts +0 -4
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.d.ts.map +0 -1
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.js +0 -21
- package/dist/esm/engine/frontend-components/billing/billing-promotion-code-input.frontend-component.specification.js.map +0 -1
- package/dist/esm/engine/frontend-components/index.d.ts +0 -2
- package/dist/esm/engine/frontend-components/index.d.ts.map +1 -1
- package/dist/esm/engine/frontend-components/index.js +4 -6
- package/dist/esm/engine/frontend-components/index.js.map +1 -1
- package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js +12 -12
- package/dist/esm/engine/guidance/resources/guidance-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js +9 -9
- package/dist/esm/engine/guidance/resources/lifecycle-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts +8 -0
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js +6 -6
- package/dist/esm/engine/guidance/resources/progression-state.resource.specification.js.map +1 -1
- package/dist/esm/engine/index.d.ts +1 -0
- package/dist/esm/engine/index.d.ts.map +1 -1
- package/dist/esm/engine/index.js +1 -0
- package/dist/esm/engine/index.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js +17 -17
- package/dist/esm/engine/infrastructure/resources/data-seed-runs.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js +7 -7
- package/dist/esm/engine/infrastructure/resources/external-data-pipeline-states.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js +8 -8
- package/dist/esm/engine/infrastructure/resources/job-executions.resource.specification.js.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts +7 -2
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js +10 -5
- package/dist/esm/engine/infrastructure/resources/job-payload-storage.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js +20 -15
- package/dist/esm/engine/notifications/resources/m2m-webhook-delivery-log.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js +11 -10
- package/dist/esm/engine/notifications/resources/notification-badges.resource.specification.js.map +1 -1
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js +29 -6
- package/dist/esm/engine/notifications/resources/webhook-config.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js +9 -9
- package/dist/esm/engine/organizations/resources/organization-members.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js +3 -3
- package/dist/esm/engine/organizations/resources/organization-notifications.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js +4 -4
- package/dist/esm/engine/organizations/resources/organization-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js +2 -2
- package/dist/esm/engine/organizations/resources/organization-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js +1 -1
- package/dist/esm/engine/organizations/resources/organization-unit-members.resource.specification.js.map +1 -1
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.js +7 -7
- package/dist/esm/engine/organizations/resources/organizations.resource.specification.js.map +1 -1
- package/dist/esm/engine/providers/_engine-provider-shared.d.ts +9 -0
- package/dist/esm/engine/providers/_engine-provider-shared.d.ts.map +1 -0
- package/dist/esm/engine/providers/_engine-provider-shared.js +19 -0
- package/dist/esm/engine/providers/_engine-provider-shared.js.map +1 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.js +33 -0
- package/dist/esm/engine/providers/anthropic.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/apple.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/apple.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/apple.provider.specification.js +35 -0
- package/dist/esm/engine/providers/apple.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/email-preview.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/email-preview.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/email-preview.provider.specification.js +31 -0
- package/dist/esm/engine/providers/email-preview.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/github.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/github.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/github.provider.specification.js +30 -0
- package/dist/esm/engine/providers/github.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/google.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/google.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/google.provider.specification.js +34 -0
- package/dist/esm/engine/providers/google.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/grok.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/grok.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/grok.provider.specification.js +30 -0
- package/dist/esm/engine/providers/grok.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/index.d.ts +23 -0
- package/dist/esm/engine/providers/index.d.ts.map +1 -0
- package/dist/esm/engine/providers/index.js +37 -0
- package/dist/esm/engine/providers/index.js.map +1 -0
- package/dist/esm/engine/providers/microsoft.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/microsoft.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/microsoft.provider.specification.js +30 -0
- package/dist/esm/engine/providers/microsoft.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/mistral.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/mistral.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/mistral.provider.specification.js +33 -0
- package/dist/esm/engine/providers/mistral.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/openai.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/openai.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/openai.provider.specification.js +43 -0
- package/dist/esm/engine/providers/openai.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/opencode.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/opencode.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/opencode.provider.specification.js +50 -0
- package/dist/esm/engine/providers/opencode.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/perplexity.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/perplexity.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/perplexity.provider.specification.js +30 -0
- package/dist/esm/engine/providers/perplexity.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/resend.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/resend.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/resend.provider.specification.js +33 -0
- package/dist/esm/engine/providers/resend.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/stripe.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/stripe.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/stripe.provider.specification.js +35 -0
- package/dist/esm/engine/providers/stripe.provider.specification.js.map +1 -0
- package/dist/esm/engine/providers/twilio.provider.specification.d.ts +7 -0
- package/dist/esm/engine/providers/twilio.provider.specification.d.ts.map +1 -0
- package/dist/esm/engine/providers/twilio.provider.specification.js +33 -0
- package/dist/esm/engine/providers/twilio.provider.specification.js.map +1 -0
- package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js +7 -7
- package/dist/esm/engine/users/resources/anonymous-users.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js +9 -9
- package/dist/esm/engine/users/resources/inbound-contacts.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.js +2 -2
- package/dist/esm/engine/users/resources/user-credentials.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js +8 -8
- package/dist/esm/engine/users/resources/user-identity-links.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.d.ts +4 -4
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.js +4 -4
- package/dist/esm/engine/users/resources/user-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.js +2 -2
- package/dist/esm/engine/users/resources/user-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts +4 -4
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js +13 -11
- package/dist/esm/engine/users/resources/user-self-preferences.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js +1 -1
- package/dist/esm/engine/users/resources/user-self-profiles.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/user-self.resource.specification.js +8 -8
- package/dist/esm/engine/users/resources/user-self.resource.specification.js.map +1 -1
- package/dist/esm/engine/users/resources/users.resource.specification.d.ts.map +1 -1
- package/dist/esm/engine/users/resources/users.resource.specification.js +93 -0
- package/dist/esm/engine/users/resources/users.resource.specification.js.map +1 -1
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.d.ts.map +1 -1
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js +95 -45
- package/dist/esm/technical-documentation/engine-documentation-specification-catalog.companion.js.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts +37 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.d.ts.map +1 -1
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.js +36 -0
- package/dist/esm/technical-documentation/technical-documentation-units.schemas.js.map +1 -1
- package/dist/tsconfig.build.tsbuildinfo +1 -1
- package/package.json +8 -8
- package/dist/assurance/external-framework-mapping.json +0 -980
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"products.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/products.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n productsAdminResourceUIBehavior as productsAdminSource,\n productsMainResourceUIBehavior as productsMainSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n ProductType,\n ProductSchema,\n ResourcePrimaryScope,\n TaxDisplayMode,\n productsResourceConfiguration_InitializationFactory as productsFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof productsFactory>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\nconst productsMainUI = productsMainSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\nconst productsAdminUI = productsAdminSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nconst productsBase = resourceSpecification<undefined, Core, Main>(\n productsFactory,\n ProductSchema,\n ({ schemaShape }) => ({\n purpose: 'One product in the application\\'s catalog: the plan, add-on or credit pack an organization can subscribe to, with the features and limits it grants. The catalog is defined by the application, not edited per organization.',\n businessRole: 'Anchor for prices, promotions, and subscription line items; drives plan tiers, add-ons, and feature/limit grants.',\n lifecycleRole: 'Lazy DB row created from definitions; provider ids filled on first use; bulk sync in admin; edits are deployment-driven, not ad-hoc CRUD in end-user UI.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'ProductSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactory: { packageName: '@wildo-ai/saas-models', exportName: 'productsResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName: 'PRODUCTS' },\n operationVocabulary: { coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM } },\n frontendConfigurationSources: [\n { packageName: '@wildo-ai/presets-components', exportName: 'productsMainResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n { packageName: '@wildo-ai/presets-components', exportName: 'productsAdminResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n ],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Product document id in the app catalog collection.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n key: schemaShape.key.stringSpec({ meaning: 'Stable key that maps 1:1 to `ProductDefinition.key` in the code catalog — unique globally per app database.', importance: FieldSemanticImportance.PRIMARY }),\n type: schemaShape.type.enumSpec({\n meaning: 'Commercial shape of the product (PLAN, ADDON, METERED, etc.).',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ProductType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [ProductType.PLAN]: { meaning: 'Primary subscription entitlements and tiering.' },\n [ProductType.ADDON]: { meaning: 'Optional capacity or feature on top of a plan.' },\n [ProductType.METERED]: { meaning: 'Usage-billed add-on; ties to `UsageRecord` rows.' },\n [ProductType.ONE_TIME]: { meaning: 'One-shot purchase, not a recurring subscription state machine.' },\n [ProductType.CREDIT_PACK]: { meaning: 'Prepaid credits to a `CreditPool` balance.' },\n [ProductType.ITEM]: { meaning: 'Generic one-off line item in catalog semantics.' },\n },\n }),\n targetScopes: schemaShape.targetScopes.arraySpec({\n meaning: 'Which `ResourcePrimaryScope` values may attach subscriptions to this product (org vs user vs app).',\n elementMeaning: 'One primary scope discriminator the product is sold into.',\n elementType: {\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ResourcePrimaryScope', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n },\n }),\n grantedFeatures: schemaShape.grantedFeatures.arraySpec({\n meaning: 'Feature keys this product enables when the subscription line is active — merged by billing feature sync with ADDON rules.',\n elementMeaning: 'One string feature id from the app feature catalog.',\n }),\n grantedLimits: schemaShape.grantedLimits.objectSpec({ meaning: 'Named limit grants (`LimitGrantSchema`) and aggregation mode for entitlements in runtime checks.' }),\n planTier: schemaShape.planTier.stringSpec({ meaning: 'For PLAN: human tier label; used with `planTierOrder` for upgrade/downgrade heuristics.' }),\n planTierOrder: schemaShape.planTierOrder.numberSpec({ meaning: 'Numeric order for plan comparisons within the app.' }),\n requiredPlanTiers: schemaShape.requiredPlanTiers.arraySpec({ meaning: 'For ADDON: plan tier keys that must be active before this add-on is purchasable.', elementMeaning: 'One `planTier` string id.' }),\n taxDisplayMode: schemaShape.taxDisplayMode.enumSpec({\n meaning: 'Whether displayed prices for this product are tax-exclusive or tax-inclusive, overriding the global default when set.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'TaxDisplayMode', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [TaxDisplayMode.EXCLUSIVE]: { meaning: 'Amounts shown before tax; tax added at checkout.' },\n [TaxDisplayMode.INCLUSIVE]: { meaning: 'Amounts include tax in displayed totals.' },\n },\n }),\n purchaseConfig: schemaShape.purchaseConfig.objectSpec({ meaning: 'Per-purchase options for one-time and credit products (max quantity, credits per unit, target credit pool key).' }),\n behaviorPolicy: schemaShape.behaviorPolicy.objectSpec({ meaning: 'Nested policy for trial, proration, cancellation windows, and metering hooks — the authoritative behavior engine for this SKU in services.' }),\n providerProductId: schemaShape.providerProductId.stringSpec({ meaning: 'Provider-side id after first sync — backend-only in many API shapes.' }),\n isPublic: schemaShape.isPublic.booleanSpec({ meaning: 'Visibility for self-serve catalog vs org-admin-only offer matrix.' }),\n isActive: schemaShape.isActive.booleanSpec({ meaning: 'Whether the product is offered to new checkouts; historical subs may still reference inactive rows.' }),\n sortOrder: schemaShape.sortOrder.numberSpec({ meaning: 'Display ordering in pickers and marketing surfaces.' }),\n metadata: schemaShape.metadata.objectSpec({ meaning: 'Opaque key/value for provider sync or A/B test tags — not PII by contract.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Row creation time.', temporalRole: 'creation' }),\n updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Row update time for syncs.', temporalRole: 'modified' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Read one catalog row (features, keys, and limits) for admin and in-app gating code.',\n outcome: 'Full product + behavior policy in implementation.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The product catalog row was found and its full DTO (features, limits, behavior policy) is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No product exists for the supplied id in this application catalog.' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'Browse the catalog in admin and tooling.',\n outcome: 'Paginated products for the application scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of catalog products for the application scope.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to browse the product catalog.' },\n ],\n idempotent: true,\n },\n [Op.SEARCH]: {\n purpose: 'Search by `key` / `type` per factory searchable fields in repository variant.',\n outcome: 'Filtered list for typeahead in admin UIs.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of products matching the `key` / `type` search query.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to search the product catalog.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Internal service-pipeline lazy insert (not HTTP-exposed) of the first DB row for a `ProductDefinition` on demand.',\n outcome: 'Seeded `key` and immutable bits from the definition in services.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The product row was materialized from its `ProductDefinition` and is returned with its server-assigned id.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The product payload fails schema validation (e.g. missing `key` or unknown `type`).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not the platform/admin/repository path permitted to seed catalog rows.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A product with the same globally-unique `key` already exists in this application database.', errorCode: 'PRODUCT_KEY_EXISTS' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Materialize a plan product from its definition',\n request: {\n key: 'plan_pro',\n type: ProductType.PLAN,\n targetScopes: [ResourcePrimaryScope.ORGANIZATIONS],\n grantedFeatures: ['advanced_reporting'],\n planTier: 'pro',\n planTierOrder: 20,\n isPublic: true,\n isActive: true,\n },\n response: {\n _id: 'prod_01HX2…',\n key: 'plan_pro',\n type: ProductType.PLAN,\n planTier: 'pro',\n isActive: true,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Sync metadata, activation flags, or provider ids; not end-user ad-hoc edits in production discipline.',\n outcome: 'Patched product row per admin workflow.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The product row was patched and the updated catalog DTO is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to mutate the product catalog.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No product exists for the supplied id in this application catalog.' },\n ],\n idempotent: true,\n },\n },\n businessConstraints: [\n 'Code definitions remain the conceptual source of truth — treat DB as materialized state for the billing engine, not a CMS.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n\nexport const productsResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(productsMainUI), resourceFrontendConfiguration(productsAdminUI)),\n productsBase,\n () => ({\n label: { purpose: 'Preset `getFrontendResourceLabel` uses `key` for short catalog rows.' },\n layout: {\n purpose: 'Five section refs: `overview` (key, type, plan tier, feature grants), `tax` (tax display mode), `purchase` (credit pack config), `behavior` (policy), `visibility` (public/active/metadata).',\n displayPurpose: 'Main preset has no addressable `views` — merged admin adds LIST+READ for catalog browse (all non-addressable in billing presets).',\n sections: {\n overview: { purpose: 'Identity and tier information for a product in one card.', whenToUse: 'Admin or pricing tables.', textSlots: { title: { purpose: 'Product header.' }, description: { purpose: 'Feature/limit details follow `grantedFeatures` and `grantedLimits` in schema — not repeated field-by-field here.' } } },\n tax: { purpose: 'How tax is displayed on invoices for this product line.', whenToUse: 'When jurisdiction matters for checkout copy.', textSlots: { title: { purpose: 'Tax block.' }, description: { purpose: 'Does not set legal tax rates — that is the provider in production.' } } },\n purchase: { purpose: 'Per-unit, credit, and max-quantity options for one-time and credit products.', whenToUse: 'CREDIT_PACK and one-time flows.', textSlots: { title: { purpose: 'Purchase settings.' }, description: { purpose: 'Align with `ProductBehaviorPolicy` in implementation for when fields apply.' } } },\n behavior: { purpose: 'Policies for metering, trials, and add-on compatibility.', whenToUse: 'When tuning product-behavior for engineering.', textSlots: { title: { purpose: 'Behavior block.' }, description: { purpose: 'Backend enforcement lives in services — UI is a structured editor over the zod object.' } } },\n visibility: { purpose: 'Public, active, and free-form `metadata` for integrations.', whenToUse: 'Gating a product in marketing vs admin-only.', textSlots: { title: { purpose: 'Visibility block.' }, description: { purpose: 'Turning `isActive` off does not cancel existing subscriptions in typical billing semantics.' } } },\n },\n },\n views: {\n [Op.LIST]: { purpose: 'Merged admin exposes LIST in `views` as non-addressable; included for overlay truthfulness.', whenToUse: 'App operator catalog screens when wired.' },\n [Op.READ]: { purpose: 'Merged admin exposes READ in `views` as non-addressable.', whenToUse: 'Drill into one product in admin UIs when wired.' },\n },\n }),\n);\n"]}
|
|
1
|
+
{"version":3,"file":"products.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/products.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n productsAdminResourceUIBehavior as productsAdminSource,\n productsMainResourceUIBehavior as productsMainSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n ProductType,\n ProductSchema,\n ResourcePrimaryScope,\n TaxDisplayMode,\n productsResourceConfiguration_InitializationFactory as productsFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof productsFactory>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\nconst productsMainUI = productsMainSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\nconst productsAdminUI = productsAdminSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nconst productsBase = resourceSpecification<undefined, Core, Main>(\n productsFactory,\n ProductSchema,\n ({ schemaShape }) => ({\n purpose: 'One product in the application\\'s catalog: the plan, add-on or credit pack an organization can subscribe to, with the features and limits it grants. The catalog is defined by the application, not edited per organization.',\n businessRole: 'Anchor for prices, promotions, and subscription line items; drives plan tiers, add-ons, and feature/limit grants.',\n lifecycleRole: 'Lazy DB row created from definitions; provider ids filled on first use; bulk sync in admin; edits are deployment-driven, not ad-hoc CRUD in end-user UI.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'ProductSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactory: { packageName: '@wildo-ai/saas-models', exportName: 'productsResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName: 'PRODUCTS' },\n operationVocabulary: { coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM } },\n frontendConfigurationSources: [\n { packageName: '@wildo-ai/presets-components', exportName: 'productsMainResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n { packageName: '@wildo-ai/presets-components', exportName: 'productsAdminResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n ],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Product document id in the app catalog collection.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n key: schemaShape.key.stringSpec({ meaning: 'Stable key that maps 1:1 to `ProductDefinition.key` in the code catalog — unique globally per app database.', importance: FieldSemanticImportance.PRIMARY }),\n type: schemaShape.type.enumSpec({\n meaning: 'Commercial shape of the product (PLAN, ADDON, METERED, etc.).',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ProductType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [ProductType.PLAN]: { meaning: 'Primary subscription entitlements and tiering.' },\n [ProductType.ADDON]: { meaning: 'Optional capacity or feature on top of a plan.' },\n [ProductType.METERED]: { meaning: 'Usage-billed add-on; ties to `UsageRecord` records.' },\n [ProductType.ONE_TIME]: { meaning: 'One-shot purchase, not a recurring subscription state machine.' },\n [ProductType.CREDIT_PACK]: { meaning: 'Prepaid credits to a `CreditPool` balance.' },\n [ProductType.ITEM]: { meaning: 'Generic one-off line item in catalog semantics.' },\n },\n }),\n targetScopes: schemaShape.targetScopes.arraySpec({\n meaning: 'Which `ResourcePrimaryScope` values may attach subscriptions to this product (org vs user vs app).',\n elementMeaning: 'One primary scope discriminator the product is sold into.',\n elementType: {\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ResourcePrimaryScope', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n },\n }),\n grantedFeatures: schemaShape.grantedFeatures.arraySpec({\n meaning: 'Feature keys this product enables when the subscription line is active — merged by billing feature sync with ADDON rules.',\n elementMeaning: 'One string feature id from the app feature catalog.',\n }),\n grantedLimits: schemaShape.grantedLimits.objectSpec({ meaning: 'Named limit grants (`LimitGrantSchema`) and aggregation mode for entitlements in runtime checks.' }),\n planTier: schemaShape.planTier.stringSpec({ meaning: 'For PLAN: human tier label; used with `planTierOrder` for upgrade/downgrade heuristics.' }),\n planTierOrder: schemaShape.planTierOrder.numberSpec({ meaning: 'Numeric order for plan comparisons within the app.' }),\n requiredPlanTiers: schemaShape.requiredPlanTiers.arraySpec({ meaning: 'For ADDON: plan tier keys that must be active before this add-on is purchasable.', elementMeaning: 'One `planTier` string id.' }),\n taxDisplayMode: schemaShape.taxDisplayMode.enumSpec({\n meaning: 'Whether displayed prices for this product are tax-exclusive or tax-inclusive, overriding the global default when set.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'TaxDisplayMode', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [TaxDisplayMode.EXCLUSIVE]: { meaning: 'Amounts shown before tax; tax added at checkout.' },\n [TaxDisplayMode.INCLUSIVE]: { meaning: 'Amounts include tax in displayed totals.' },\n },\n }),\n purchaseConfig: schemaShape.purchaseConfig.objectSpec({ meaning: 'Per-purchase options for one-time and credit products (max quantity, credits per unit, target credit pool key).' }),\n behaviorPolicy: schemaShape.behaviorPolicy.objectSpec({ meaning: 'Nested policy for trial, proration, cancellation windows, and metering hooks — the authoritative behavior engine for this SKU in services.' }),\n providerProductId: schemaShape.providerProductId.stringSpec({ meaning: 'Provider-side id after first sync — backend-only in many API shapes.' }),\n isPublic: schemaShape.isPublic.booleanSpec({ meaning: 'Visibility for self-serve catalog vs org-admin-only offer matrix.' }),\n isActive: schemaShape.isActive.booleanSpec({ meaning: 'Whether the product is offered to new checkouts; historical subs may still reference inactive records.' }),\n sortOrder: schemaShape.sortOrder.numberSpec({ meaning: 'Display ordering in pickers and marketing surfaces.' }),\n metadata: schemaShape.metadata.objectSpec({ meaning: 'Opaque key/value for provider sync or A/B test tags — not PII by contract.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Record creation time.', temporalRole: 'creation' }),\n updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Record update time for syncs.', temporalRole: 'modified' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Read one catalog row (features, keys, and limits) for admin and in-app gating code.',\n outcome: 'Full product + behavior policy in implementation.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The product catalog record was found and its full DTO (features, limits, behavior policy) is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No product exists for the supplied id in this application catalog.' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'Browse the catalog in admin and tooling.',\n outcome: 'Paginated products for the application scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of catalog products for the application scope.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to browse the product catalog.' },\n ],\n idempotent: true,\n },\n [Op.SEARCH]: {\n purpose: 'Search by `key` / `type` per factory searchable fields in repository variant.',\n outcome: 'Filtered list for typeahead in admin UIs.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of products matching the `key` / `type` search query.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to search the product catalog.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Internal service-pipeline lazy insert (not HTTP-exposed) of the first DB row for a `ProductDefinition` on demand.',\n outcome: 'Seeded `key` and immutable bits from the definition in services.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'The product record was materialized from its `ProductDefinition` and is returned with its server-assigned id.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The product payload fails schema validation (e.g. missing `key` or unknown `type`).', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is not the platform/admin/repository path permitted to seed catalog rows.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A product with the same globally-unique `key` already exists in this application database.', errorCode: 'PRODUCT_KEY_EXISTS' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Materialize a plan product from its definition',\n request: {\n key: 'plan_pro',\n type: ProductType.PLAN,\n targetScopes: [ResourcePrimaryScope.ORGANIZATIONS],\n grantedFeatures: ['advanced_reporting'],\n planTier: 'pro',\n planTierOrder: 20,\n isPublic: true,\n isActive: true,\n },\n response: {\n _id: 'prod_01HX2…',\n key: 'plan_pro',\n type: ProductType.PLAN,\n planTier: 'pro',\n isActive: true,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Sync metadata, activation flags, or provider ids; not end-user ad-hoc edits in production discipline.',\n outcome: 'Patched product row per admin workflow.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The product record was patched and the updated catalog DTO is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the platform/admin entitlement required to mutate the product catalog.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No product exists for the supplied id in this application catalog.' },\n ],\n idempotent: true,\n },\n },\n businessConstraints: [\n 'Code definitions remain the conceptual source of truth — treat DB as materialized state for the billing engine, not a CMS.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n\nexport const productsResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(productsMainUI), resourceFrontendConfiguration(productsAdminUI)),\n productsBase,\n () => ({\n label: { purpose: 'Preset `getFrontendResourceLabel` uses `key` for short catalog rows.' },\n layout: {\n purpose: 'Five section refs: `overview` (key, type, plan tier, feature grants), `tax` (tax display mode), `purchase` (credit pack config), `behavior` (policy), `visibility` (public/active/metadata).',\n displayPurpose: 'Main preset has no addressable `views` — merged admin adds LIST+READ for catalog browse (all non-addressable in billing presets).',\n sections: {\n overview: { purpose: 'Identity and tier information for a product in one card.', whenToUse: 'Admin or pricing tables.', textSlots: { title: { purpose: 'Product header.' }, description: { purpose: 'Feature/limit details follow `grantedFeatures` and `grantedLimits` in schema — not repeated field-by-field here.' } } },\n tax: { purpose: 'How tax is displayed on invoices for this product line.', whenToUse: 'When jurisdiction matters for checkout copy.', textSlots: { title: { purpose: 'Tax block.' }, description: { purpose: 'Does not set legal tax rates — that is the provider in production.' } } },\n purchase: { purpose: 'Per-unit, credit, and max-quantity options for one-time and credit products.', whenToUse: 'CREDIT_PACK and one-time flows.', textSlots: { title: { purpose: 'Purchase settings.' }, description: { purpose: 'Align with `ProductBehaviorPolicy` in implementation for when fields apply.' } } },\n behavior: { purpose: 'Policies for metering, trials, and add-on compatibility.', whenToUse: 'When tuning product-behavior for engineering.', textSlots: { title: { purpose: 'Behavior block.' }, description: { purpose: 'Backend enforcement lives in services — UI is a structured editor over the zod object.' } } },\n visibility: { purpose: 'Public, active, and free-form `metadata` for integrations.', whenToUse: 'Gating a product in marketing vs admin-only.', textSlots: { title: { purpose: 'Visibility block.' }, description: { purpose: 'Turning `isActive` off does not cancel existing subscriptions in typical billing semantics.' } } },\n },\n },\n views: {\n [Op.LIST]: { purpose: 'Merged admin exposes LIST in `views` as non-addressable; included for overlay truthfulness.', whenToUse: 'App operator catalog screens when wired.' },\n [Op.READ]: { purpose: 'Merged admin exposes READ in `views` as non-addressable.', whenToUse: 'Drill into one product in admin UIs when wired.' },\n },\n }),\n);\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"promotions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/promotions.resource.specification.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,YAAY,EACZ,aAAa,EACb,iBAAiB,EAEjB,oBAAoB,EAGrB,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"promotions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/promotions.resource.specification.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,qBAAqB,IAAI,EAAE,EAC3B,YAAY,EACZ,aAAa,EACb,iBAAiB,EAEjB,oBAAoB,EAGrB,MAAM,uBAAuB,CAAC;AAoN/B,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;iCAuB3C,CAAC"}
|
|
@@ -65,7 +65,7 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
|
|
|
65
65
|
timesRedeemed: schemaShape.timesRedeemed.numberSpec({ meaning: 'Counter mirrored for admin read of campaign health.' }),
|
|
66
66
|
validFrom: schemaShape.validFrom.dateSpec({ meaning: 'Earliest datetime the code is valid.', temporalRole: 'scheduled' }),
|
|
67
67
|
validUntil: schemaShape.validUntil.dateSpec({ meaning: 'Hard stop for new redemptions.', temporalRole: 'deadline' }),
|
|
68
|
-
isActive: schemaShape.isActive.booleanSpec({ meaning: 'Soft switch to stop new uses without deleting the
|
|
68
|
+
isActive: schemaShape.isActive.booleanSpec({ meaning: 'Soft switch to stop new uses without deleting the record.' }),
|
|
69
69
|
metadata: schemaShape.metadata.objectSpec({ meaning: 'Extra campaign tags for analytics — not user PII.' }),
|
|
70
70
|
},
|
|
71
71
|
operations: {
|
|
@@ -85,7 +85,7 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
|
|
|
85
85
|
purpose: 'Browse campaigns in admin (merged admin adds non-addressable LIST view).',
|
|
86
86
|
outcome: 'Paginated promotions in application scope.',
|
|
87
87
|
responseStatuses: [
|
|
88
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of promotion
|
|
88
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of promotion records in the application scope.' },
|
|
89
89
|
],
|
|
90
90
|
errorScenarios: [
|
|
91
91
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to browse the promotion catalog.' },
|
|
@@ -107,7 +107,7 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
|
|
|
107
107
|
purpose: 'Author a new promotion row for an upcoming campaign.',
|
|
108
108
|
outcome: 'New id and code when unique constraints pass.',
|
|
109
109
|
responseStatuses: [
|
|
110
|
-
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'A promotion
|
|
110
|
+
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'A promotion record was created and is returned with its server-assigned id.' },
|
|
111
111
|
],
|
|
112
112
|
errorScenarios: [
|
|
113
113
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The discount mechanics are inconsistent (e.g. percentage value with `discountType` fixed, or `REPEATING` duration without `durationInMonths`) or the payload otherwise fails schema validation.', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -144,7 +144,7 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
|
|
|
144
144
|
purpose: 'Adjust limits, validity, or active bit before or during a campaign.',
|
|
145
145
|
outcome: 'Patched row with provider sync where required.',
|
|
146
146
|
responseStatuses: [
|
|
147
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The promotion’s limits / validity window / active bit were patched and the updated
|
|
147
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The promotion’s limits / validity window / active bit were patched and the updated record is returned.' },
|
|
148
148
|
],
|
|
149
149
|
errorScenarios: [
|
|
150
150
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited discount or duration fields are inconsistent, or the patch otherwise fails schema validation.', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -156,10 +156,10 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
|
|
|
156
156
|
},
|
|
157
157
|
[Promotion_Operations.APPLY]: {
|
|
158
158
|
operationId: Promotion_Operations.APPLY,
|
|
159
|
-
purpose: 'Validate
|
|
160
|
-
outcome: 'Discount object or error for the checkout session
|
|
159
|
+
purpose: 'Validate a promotion code a user supplied, and return the discount it resolves to. Records no redemption.',
|
|
160
|
+
outcome: 'Discount object or error for the checkout session.',
|
|
161
161
|
responseStatuses: [
|
|
162
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The supplied `code` was valid and applicable; the resolved discount object is returned
|
|
162
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The supplied `code` was valid and applicable; the resolved discount object is returned. `timesRedeemed` is NOT advanced — a redemption is counted when the purchase completes.' },
|
|
163
163
|
],
|
|
164
164
|
errorScenarios: [
|
|
165
165
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The `code` is missing/empty or fails request-DTO validation.', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -167,10 +167,12 @@ const promotionsBase = resourceSpecification(promotionsFactory, PromotionSchema,
|
|
|
167
167
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No promotion matches the supplied `code`.' },
|
|
168
168
|
{ code: HttpResponseStatusCode.CONFLICT_409, when: 'The matched promotion is inactive, outside its `validFrom`/`validUntil` window, exhausted (`maxRedemptions` reached), or not applicable to the targeted products.' },
|
|
169
169
|
],
|
|
170
|
-
//
|
|
171
|
-
//
|
|
172
|
-
//
|
|
173
|
-
|
|
170
|
+
// Side-effect-free: this verb validates and reports, and advances no counter. It used to
|
|
171
|
+
// increment `timesRedeemed`, which counted a redemption when a customer TYPED a code —
|
|
172
|
+
// so a limited campaign was exhausted by window-shoppers, and a customer who then bought
|
|
173
|
+
// was counted twice once completion started counting. The redemption is now counted only
|
|
174
|
+
// by `checkout.session.completed`.
|
|
175
|
+
idempotent: true,
|
|
174
176
|
rateLimitNote: 'Code-application is abuse-sensitive (coupon brute-forcing) — the platform may throttle repeated APPLY attempts per caller/account.',
|
|
175
177
|
},
|
|
176
178
|
[Promotion_Operations.DEACTIVATE]: {
|
|
@@ -209,7 +211,7 @@ export const promotionsResourceSpecification = resourceSpecificationFromFrontend
|
|
|
209
211
|
views: {
|
|
210
212
|
[Op.LIST]: { purpose: 'Merged admin LIST (non-addressable) for operator catalog alignment.', whenToUse: 'Super-admin promotion management when routes exist.' },
|
|
211
213
|
[Op.READ]: { purpose: 'Merged admin READ (non-addressable) for drill-down alignment.', whenToUse: 'Inspect one campaign when wired.' },
|
|
212
|
-
[Promotion_Operations.APPLY]: { purpose: '
|
|
214
|
+
[Promotion_Operations.APPLY]: { purpose: 'Code-validation path for checkout integration; non-addressable in merged `views` array but op is present for action buttons. Reports the discount; the redemption is counted at purchase completion.', whenToUse: 'User enters code in purchase flow.' },
|
|
213
215
|
[Promotion_Operations.DEACTIVATE]: { purpose: 'Deactivate path for admin shutoff; present in both main and merged `views` maps as non-addressable.', whenToUse: 'End a campaign early without deleting history.' },
|
|
214
216
|
},
|
|
215
217
|
}));
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"promotions.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/promotions.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n promotionsAdminResourceUIBehavior as promotionsAdminSource,\n promotionsMainResourceUIBehavior as promotionsMainSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n DiscountType,\n PromotionType,\n PromotionDuration,\n PromotionSchema,\n Promotion_Operations,\n ResourcePrimaryScope,\n promotionsResourceConfiguration_InitializationFactory as promotionsFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof promotionsFactory>;\ntype Custom = NonNullable<Cfg['customOperation']>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\nconst promotionsMainUI = promotionsMainSource as ResourceUIBehaviorConfig<Custom, Core, Main>;\nconst promotionsAdminUI = promotionsAdminSource as ResourceUIBehaviorConfig<Custom, Core, Main>;\n\nconst promotionsBase = resourceSpecification<Custom, Core, Main>(\n promotionsFactory,\n PromotionSchema,\n ({ schemaShape }) => ({\n purpose: 'Promotional instrument (coupon, promotion code, referral program, deal) with discount mechanics, validity window, and redemption counters — synced to the provider where applicable.',\n businessRole: 'Feeds checkout `promotionCode` validation and subscription discount objects; distinct from `REFERRALS` relationship rows.',\n lifecycleRole: 'Authored by operators; `APPLY` validates at purchase; `DEACTIVATE` ends new redemptions while historical subs may retain benefits per policy.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'PromotionSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactory: { packageName: '@wildo-ai/saas-models', exportName: 'promotionsResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName: 'PROMOTIONS' },\n operationVocabulary: {\n coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n customEnum: { packageName: '@wildo-ai/saas-models', exportName: 'Promotion_Operations', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n },\n frontendConfigurationSources: [\n { packageName: '@wildo-ai/presets-components', exportName: 'promotionsMainResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n { packageName: '@wildo-ai/presets-components', exportName: 'promotionsAdminResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n ],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Promotion document id.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n name: schemaShape.name.stringSpec({ meaning: 'Human label in admin and support tools.', importance: FieldSemanticImportance.PRIMARY }),\n description: schemaShape.description.stringSpec({ meaning: 'Longer explanation of the offer and legal/restriction copy when needed.' }),\n type: schemaShape.type.enumSpec({\n meaning: 'Kind of promotion surface in catalog and checkout.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'PromotionType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [PromotionType.COUPON]: { meaning: 'Checkout coupon code style.' },\n [PromotionType.PROMOTION_CODE]: { meaning: 'Provider-style promotion code.' },\n [PromotionType.REFERRAL]: { meaning: 'Referral-driven automatic benefit (cross-link to referral program when present).' },\n [PromotionType.DEAL]: { meaning: 'Negotiated or campaign deal object with custom rules.' },\n },\n }),\n code: schemaShape.code.stringSpec({ meaning: 'The string customers or APIs pass at checkout when applicable.' }),\n discountType: schemaShape.discountType.enumSpec({\n meaning: 'Whether the benefit is percentage, fixed money, or free trial extension per schema rules.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'DiscountType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [DiscountType.PERCENTAGE]: { meaning: 'Percent off list or subtotal.' },\n [DiscountType.FIXED_AMOUNT]: { meaning: 'Flat money off (currency in provider sync).' },\n },\n }),\n discountPercentage: schemaShape.discountPercentage.numberSpec({ meaning: 'Percent off when `discountType` is percentage.' }),\n discountFixedAmount: schemaShape.discountFixedAmount.numberSpec({ meaning: 'Money off when `discountType` is fixed amount in provider currency.' }),\n duration: schemaShape.duration.enumSpec({\n meaning: 'How long the discount applies to a subscription once redeemed.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'PromotionDuration', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [PromotionDuration.ONCE]: { meaning: 'First invoice only.' },\n [PromotionDuration.REPEATING]: { meaning: 'Repeats for N months when `durationInMonths` is set.' },\n [PromotionDuration.FOREVER]: { meaning: 'Applies for the life of the subscription while active.' },\n },\n }),\n durationInMonths: schemaShape.durationInMonths.numberSpec({ meaning: 'Repeat window for `REPEATING` duration mode.' }),\n applicableProducts: schemaShape.applicableProducts.arraySpec({ meaning: 'Product keys this promo can apply to — empty may mean all catalog per policy.', elementMeaning: 'One product `key` string.' }),\n maxRedemptions: schemaShape.maxRedemptions.numberSpec({ meaning: 'Cap on redemptions across all customers; null may mean unlimited per implementation.' }),\n timesRedeemed: schemaShape.timesRedeemed.numberSpec({ meaning: 'Counter mirrored for admin read of campaign health.' }),\n validFrom: schemaShape.validFrom.dateSpec({ meaning: 'Earliest datetime the code is valid.', temporalRole: 'scheduled' }),\n validUntil: schemaShape.validUntil.dateSpec({ meaning: 'Hard stop for new redemptions.', temporalRole: 'deadline' }),\n isActive: schemaShape.isActive.booleanSpec({ meaning: 'Soft switch to stop new uses without deleting the row.' }),\n metadata: schemaShape.metadata.objectSpec({ meaning: 'Extra campaign tags for analytics — not user PII.' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Inspect one promotion’s terms and counters in admin.',\n outcome: 'Full discount and validity block for editing support.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The promotion was found and its full discount mechanics + validity block + redemption counters are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to read the admin-managed promotion catalog.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No promotion exists for the supplied id in the application scope.' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'Browse campaigns in admin (merged admin adds non-addressable LIST view).',\n outcome: 'Paginated promotions in application scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of promotion rows in the application scope.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to browse the promotion catalog.' },\n ],\n idempotent: true,\n },\n [Op.SEARCH]: {\n purpose: 'Search by `name` / `code` per factory search config.',\n outcome: 'Filtered list for operators.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of promotions matching the `name` / `code` query (case-insensitive, max 50 per page).' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to search the promotion catalog.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Author a new promotion row for an upcoming campaign.',\n outcome: 'New id and code when unique constraints pass.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A promotion row was created and is returned with its server-assigned id.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The discount mechanics are inconsistent (e.g. percentage value with `discountType` fixed, or `REPEATING` duration without `durationInMonths`) or the payload otherwise fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to author promotions.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A promotion with the same `code` already exists (codes are the customer-facing checkout key and must be unique).' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Create a percentage coupon',\n request: {\n name: 'Summer launch 20%',\n type: PromotionType.COUPON,\n code: 'SUMMER20',\n discountType: DiscountType.PERCENTAGE,\n discountPercentage: 20,\n duration: PromotionDuration.ONCE,\n maxRedemptions: 500,\n },\n response: {\n _id: 'promo_01HX2…',\n name: 'Summer launch 20%',\n code: 'SUMMER20',\n discountType: DiscountType.PERCENTAGE,\n discountPercentage: 20,\n isActive: true,\n timesRedeemed: 0,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Adjust limits, validity, or active bit before or during a campaign.',\n outcome: 'Patched row with provider sync where required.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The promotion’s limits / validity window / active bit were patched and the updated row is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited discount or duration fields are inconsistent, or the patch otherwise fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to edit promotions.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No promotion exists for the supplied id in the application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A `code` change collides with another promotion’s existing code.' },\n ],\n idempotent: true,\n },\n [Promotion_Operations.APPLY]: {\n operationId: Promotion_Operations.APPLY,\n purpose: 'Validate and apply a promotion at checkout or plan change when a user supplies a code.',\n outcome: 'Discount object or error for the checkout session — main preset surfaces this in `views` as non-addressable.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The supplied `code` was valid and applicable; the resolved discount object is returned and the redemption counter is advanced.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The `code` is missing/empty or fails request-DTO validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is neither an org owner nor an org member, so cannot apply promotions in this scope.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No promotion matches the supplied `code`.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The matched promotion is inactive, outside its `validFrom`/`validUntil` window, exhausted (`maxRedemptions` reached), or not applicable to the targeted products.' },\n ],\n // Each successful APPLY records a redemption and advances `timesRedeemed`, so\n // re-issuing the same request is NOT side-effect-free — it consumes another\n // redemption (and may then trip the exhaustion 409 above).\n idempotent: false,\n rateLimitNote: 'Code-application is abuse-sensitive (coupon brute-forcing) — the platform may throttle repeated APPLY attempts per caller/account.',\n },\n [Promotion_Operations.DEACTIVATE]: {\n operationId: Promotion_Operations.DEACTIVATE,\n purpose: 'Disable new redemptions while preserving history for audits.',\n outcome: 'Sets `isActive` false in implementation; still listed in merged `views` for action wiring.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The promotion’s `isActive` flag is now false; the campaign accepts no new redemptions while history is preserved.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to deactivate a promotion.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No promotion exists for the supplied id in the application scope.' },\n ],\n // Convergent state-set: deactivating drives `isActive` to a fixed value, so\n // repeating the request lands the campaign in the same disabled state.\n idempotent: true,\n },\n },\n businessConstraints: [\n 'Provider is the settlement system of record — Wildo rows follow provider capabilities for multi-currency and duration semantics.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n\nexport const promotionsResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(promotionsMainUI), resourceFrontendConfiguration(promotionsAdminUI)),\n promotionsBase,\n () => ({\n label: { purpose: 'Preset `getFrontendResourceLabel` uses the promotion `name` for list rows.' },\n layout: {\n purpose: 'Section refs `overview`, `discount`, `duration`, `applicability`, `validity` in billing presets — form and display walk the same order.',\n displayPurpose: 'Main bundle exposes `APPLY` and `DEACTIVATE` custom views; merged admin adds LIST+READ for catalog browse (non-addressable).',\n sections: {\n overview: { purpose: 'Name, description, type, and public `code`.', whenToUse: 'Campaign identification in admin.', textSlots: { title: { purpose: 'Promotion title block.' }, description: { purpose: 'Type drives which provider API is used when syncing.' } } },\n discount: { purpose: 'Percent vs fixed amount semantics with the two discount fields.', whenToUse: 'Setting the commercial terms of the deal.', textSlots: { title: { purpose: 'Discount block.' }, description: { purpose: 'Only one of percentage/fixed is meaningful per `discountType` — UI enforces in product.' } } },\n duration: { purpose: '`duration` + `durationInMonths` for repeating windows.', whenToUse: 'When promos apply across multiple renewal cycles.', textSlots: { title: { purpose: 'Duration block.' }, description: { purpose: '“Forever” maps to provider “forever coupon” semantics where available.' } } },\n applicability: { purpose: 'Which products can consume the promo and redemption caps.', whenToUse: 'Limiting an offer to specific SKUs.', textSlots: { title: { purpose: 'Applicability block.' }, description: { purpose: '`maxRedemptions` is global — not per-user unless extended in policy layers.' } } },\n validity: { purpose: '`validFrom`, `validUntil`, `isActive`, and `metadata` for ops and analytics.', whenToUse: 'Sunsetting and seasonal windows.', textSlots: { title: { purpose: 'Validity block.' }, description: { purpose: 'Past `validUntil` should reject `APPLY` at API even if `isActive` is true until a job flips it.' } } },\n },\n },\n views: {\n [Op.LIST]: { purpose: 'Merged admin LIST (non-addressable) for operator catalog alignment.', whenToUse: 'Super-admin promotion management when routes exist.' },\n [Op.READ]: { purpose: 'Merged admin READ (non-addressable) for drill-down alignment.', whenToUse: 'Inspect one campaign when wired.' },\n [Promotion_Operations.APPLY]: { purpose: 'Apply path for checkout integration; non-addressable in merged `views` array but op is present for action buttons.', whenToUse: 'User enters code in purchase flow.' },\n [Promotion_Operations.DEACTIVATE]: { purpose: 'Deactivate path for admin shutoff; present in both main and merged `views` maps as non-addressable.', whenToUse: 'End a campaign early without deleting history.' },\n },\n }),\n);\n"]}
|
|
1
|
+
{"version":3,"file":"promotions.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/promotions.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n promotionsAdminResourceUIBehavior as promotionsAdminSource,\n promotionsMainResourceUIBehavior as promotionsMainSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n CoreResourceOperation as Op,\n DiscountType,\n PromotionType,\n PromotionDuration,\n PromotionSchema,\n Promotion_Operations,\n ResourcePrimaryScope,\n promotionsResourceConfiguration_InitializationFactory as promotionsFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof promotionsFactory>;\ntype Custom = NonNullable<Cfg['customOperation']>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\nconst promotionsMainUI = promotionsMainSource as ResourceUIBehaviorConfig<Custom, Core, Main>;\nconst promotionsAdminUI = promotionsAdminSource as ResourceUIBehaviorConfig<Custom, Core, Main>;\n\nconst promotionsBase = resourceSpecification<Custom, Core, Main>(\n promotionsFactory,\n PromotionSchema,\n ({ schemaShape }) => ({\n purpose: 'Promotional instrument (coupon, promotion code, referral program, deal) with discount mechanics, validity window, and redemption counters — synced to the provider where applicable.',\n businessRole: 'Feeds checkout `promotionCode` validation and subscription discount objects; distinct from `REFERRALS` relationship rows.',\n lifecycleRole: 'Authored by operators; `APPLY` validates at purchase; `DEACTIVATE` ends new redemptions while historical subs may retain benefits per policy.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'PromotionSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactory: { packageName: '@wildo-ai/saas-models', exportName: 'promotionsResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName: 'PROMOTIONS' },\n operationVocabulary: {\n coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n customEnum: { packageName: '@wildo-ai/saas-models', exportName: 'Promotion_Operations', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n },\n frontendConfigurationSources: [\n { packageName: '@wildo-ai/presets-components', exportName: 'promotionsMainResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n { packageName: '@wildo-ai/presets-components', exportName: 'promotionsAdminResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n ],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Promotion document id.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n name: schemaShape.name.stringSpec({ meaning: 'Human label in admin and support tools.', importance: FieldSemanticImportance.PRIMARY }),\n description: schemaShape.description.stringSpec({ meaning: 'Longer explanation of the offer and legal/restriction copy when needed.' }),\n type: schemaShape.type.enumSpec({\n meaning: 'Kind of promotion surface in catalog and checkout.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'PromotionType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [PromotionType.COUPON]: { meaning: 'Checkout coupon code style.' },\n [PromotionType.PROMOTION_CODE]: { meaning: 'Provider-style promotion code.' },\n [PromotionType.REFERRAL]: { meaning: 'Referral-driven automatic benefit (cross-link to referral program when present).' },\n [PromotionType.DEAL]: { meaning: 'Negotiated or campaign deal object with custom rules.' },\n },\n }),\n code: schemaShape.code.stringSpec({ meaning: 'The string customers or APIs pass at checkout when applicable.' }),\n discountType: schemaShape.discountType.enumSpec({\n meaning: 'Whether the benefit is percentage, fixed money, or free trial extension per schema rules.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'DiscountType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [DiscountType.PERCENTAGE]: { meaning: 'Percent off list or subtotal.' },\n [DiscountType.FIXED_AMOUNT]: { meaning: 'Flat money off (currency in provider sync).' },\n },\n }),\n discountPercentage: schemaShape.discountPercentage.numberSpec({ meaning: 'Percent off when `discountType` is percentage.' }),\n discountFixedAmount: schemaShape.discountFixedAmount.numberSpec({ meaning: 'Money off when `discountType` is fixed amount in provider currency.' }),\n duration: schemaShape.duration.enumSpec({\n meaning: 'How long the discount applies to a subscription once redeemed.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'PromotionDuration', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [PromotionDuration.ONCE]: { meaning: 'First invoice only.' },\n [PromotionDuration.REPEATING]: { meaning: 'Repeats for N months when `durationInMonths` is set.' },\n [PromotionDuration.FOREVER]: { meaning: 'Applies for the life of the subscription while active.' },\n },\n }),\n durationInMonths: schemaShape.durationInMonths.numberSpec({ meaning: 'Repeat window for `REPEATING` duration mode.' }),\n applicableProducts: schemaShape.applicableProducts.arraySpec({ meaning: 'Product keys this promo can apply to — empty may mean all catalog per policy.', elementMeaning: 'One product `key` string.' }),\n maxRedemptions: schemaShape.maxRedemptions.numberSpec({ meaning: 'Cap on redemptions across all customers; null may mean unlimited per implementation.' }),\n timesRedeemed: schemaShape.timesRedeemed.numberSpec({ meaning: 'Counter mirrored for admin read of campaign health.' }),\n validFrom: schemaShape.validFrom.dateSpec({ meaning: 'Earliest datetime the code is valid.', temporalRole: 'scheduled' }),\n validUntil: schemaShape.validUntil.dateSpec({ meaning: 'Hard stop for new redemptions.', temporalRole: 'deadline' }),\n isActive: schemaShape.isActive.booleanSpec({ meaning: 'Soft switch to stop new uses without deleting the record.' }),\n metadata: schemaShape.metadata.objectSpec({ meaning: 'Extra campaign tags for analytics — not user PII.' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Inspect one promotion’s terms and counters in admin.',\n outcome: 'Full discount and validity block for editing support.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The promotion was found and its full discount mechanics + validity block + redemption counters are returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to read the admin-managed promotion catalog.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No promotion exists for the supplied id in the application scope.' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'Browse campaigns in admin (merged admin adds non-addressable LIST view).',\n outcome: 'Paginated promotions in application scope.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of promotion records in the application scope.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to browse the promotion catalog.' },\n ],\n idempotent: true,\n },\n [Op.SEARCH]: {\n purpose: 'Search by `name` / `code` per factory search config.',\n outcome: 'Filtered list for operators.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of promotions matching the `name` / `code` query (case-insensitive, max 50 per page).' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to search the promotion catalog.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Author a new promotion row for an upcoming campaign.',\n outcome: 'New id and code when unique constraints pass.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A promotion record was created and is returned with its server-assigned id.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The discount mechanics are inconsistent (e.g. percentage value with `discountType` fixed, or `REPEATING` duration without `durationInMonths`) or the payload otherwise fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to author promotions.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A promotion with the same `code` already exists (codes are the customer-facing checkout key and must be unique).' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Create a percentage coupon',\n request: {\n name: 'Summer launch 20%',\n type: PromotionType.COUPON,\n code: 'SUMMER20',\n discountType: DiscountType.PERCENTAGE,\n discountPercentage: 20,\n duration: PromotionDuration.ONCE,\n maxRedemptions: 500,\n },\n response: {\n _id: 'promo_01HX2…',\n name: 'Summer launch 20%',\n code: 'SUMMER20',\n discountType: DiscountType.PERCENTAGE,\n discountPercentage: 20,\n isActive: true,\n timesRedeemed: 0,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Adjust limits, validity, or active bit before or during a campaign.',\n outcome: 'Patched row with provider sync where required.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The promotion’s limits / validity window / active bit were patched and the updated record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The edited discount or duration fields are inconsistent, or the patch otherwise fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to edit promotions.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No promotion exists for the supplied id in the application scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'A `code` change collides with another promotion’s existing code.' },\n ],\n idempotent: true,\n },\n [Promotion_Operations.APPLY]: {\n operationId: Promotion_Operations.APPLY,\n purpose: 'Validate a promotion code a user supplied, and return the discount it resolves to. Records no redemption.',\n outcome: 'Discount object or error for the checkout session.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The supplied `code` was valid and applicable; the resolved discount object is returned. `timesRedeemed` is NOT advanced — a redemption is counted when the purchase completes.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The `code` is missing/empty or fails request-DTO validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller is neither an org owner nor an org member, so cannot apply promotions in this scope.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No promotion matches the supplied `code`.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The matched promotion is inactive, outside its `validFrom`/`validUntil` window, exhausted (`maxRedemptions` reached), or not applicable to the targeted products.' },\n ],\n // Side-effect-free: this verb validates and reports, and advances no counter. It used to\n // increment `timesRedeemed`, which counted a redemption when a customer TYPED a code —\n // so a limited campaign was exhausted by window-shoppers, and a customer who then bought\n // was counted twice once completion started counting. The redemption is now counted only\n // by `checkout.session.completed`.\n idempotent: true,\n rateLimitNote: 'Code-application is abuse-sensitive (coupon brute-forcing) — the platform may throttle repeated APPLY attempts per caller/account.',\n },\n [Promotion_Operations.DEACTIVATE]: {\n operationId: Promotion_Operations.DEACTIVATE,\n purpose: 'Disable new redemptions while preserving history for audits.',\n outcome: 'Sets `isActive` false in implementation; still listed in merged `views` for action wiring.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The promotion’s `isActive` flag is now false; the campaign accepts no new redemptions while history is preserved.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to deactivate a promotion.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No promotion exists for the supplied id in the application scope.' },\n ],\n // Convergent state-set: deactivating drives `isActive` to a fixed value, so\n // repeating the request lands the campaign in the same disabled state.\n idempotent: true,\n },\n },\n businessConstraints: [\n 'Provider is the settlement system of record — Wildo rows follow provider capabilities for multi-currency and duration semantics.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.APPLICATION },\n);\n\nexport const promotionsResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(promotionsMainUI), resourceFrontendConfiguration(promotionsAdminUI)),\n promotionsBase,\n () => ({\n label: { purpose: 'Preset `getFrontendResourceLabel` uses the promotion `name` for list rows.' },\n layout: {\n purpose: 'Section refs `overview`, `discount`, `duration`, `applicability`, `validity` in billing presets — form and display walk the same order.',\n displayPurpose: 'Main bundle exposes `APPLY` and `DEACTIVATE` custom views; merged admin adds LIST+READ for catalog browse (non-addressable).',\n sections: {\n overview: { purpose: 'Name, description, type, and public `code`.', whenToUse: 'Campaign identification in admin.', textSlots: { title: { purpose: 'Promotion title block.' }, description: { purpose: 'Type drives which provider API is used when syncing.' } } },\n discount: { purpose: 'Percent vs fixed amount semantics with the two discount fields.', whenToUse: 'Setting the commercial terms of the deal.', textSlots: { title: { purpose: 'Discount block.' }, description: { purpose: 'Only one of percentage/fixed is meaningful per `discountType` — UI enforces in product.' } } },\n duration: { purpose: '`duration` + `durationInMonths` for repeating windows.', whenToUse: 'When promos apply across multiple renewal cycles.', textSlots: { title: { purpose: 'Duration block.' }, description: { purpose: '“Forever” maps to provider “forever coupon” semantics where available.' } } },\n applicability: { purpose: 'Which products can consume the promo and redemption caps.', whenToUse: 'Limiting an offer to specific SKUs.', textSlots: { title: { purpose: 'Applicability block.' }, description: { purpose: '`maxRedemptions` is global — not per-user unless extended in policy layers.' } } },\n validity: { purpose: '`validFrom`, `validUntil`, `isActive`, and `metadata` for ops and analytics.', whenToUse: 'Sunsetting and seasonal windows.', textSlots: { title: { purpose: 'Validity block.' }, description: { purpose: 'Past `validUntil` should reject `APPLY` at API even if `isActive` is true until a job flips it.' } } },\n },\n },\n views: {\n [Op.LIST]: { purpose: 'Merged admin LIST (non-addressable) for operator catalog alignment.', whenToUse: 'Super-admin promotion management when routes exist.' },\n [Op.READ]: { purpose: 'Merged admin READ (non-addressable) for drill-down alignment.', whenToUse: 'Inspect one campaign when wired.' },\n [Promotion_Operations.APPLY]: { purpose: 'Code-validation path for checkout integration; non-addressable in merged `views` array but op is present for action buttons. Reports the discount; the redemption is counted at purchase completion.', whenToUse: 'User enters code in purchase flow.' },\n [Promotion_Operations.DEACTIVATE]: { purpose: 'Deactivate path for admin shutoff; present in both main and merged `views` maps as non-addressable.', whenToUse: 'End a campaign early without deleting history.' },\n },\n }),\n);\n"]}
|
|
@@ -25,7 +25,7 @@ const referralsBase = resourceSpecification(referralsFactory, ReferralSchema, ({
|
|
|
25
25
|
fields: {
|
|
26
26
|
_id: schemaShape._id.stringSpec({ meaning: 'Referral document id.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),
|
|
27
27
|
referralCode: schemaShape.referralCode.stringSpec({ meaning: 'Globally unique shareable code embedded in invite links.', importance: FieldSemanticImportance.PRIMARY }),
|
|
28
|
-
referrerBillingAccountId: schemaShape.referrerBillingAccountId.foreignKeySpec({ meaning: 'Billing account of the party that ISSUED the referral (the referrer) and is entitled to referrer-side rewards on conversion. Per-record DISCRIMINATED polymorphic FK: resolves to a `userBillingAccounts` OR `organizationBillingAccounts` record, selected per
|
|
28
|
+
referrerBillingAccountId: schemaShape.referrerBillingAccountId.foreignKeySpec({ meaning: 'Billing account of the party that ISSUED the referral (the referrer) and is entitled to referrer-side rewards on conversion. Per-record DISCRIMINATED polymorphic FK: resolves to a `userBillingAccounts` OR `organizationBillingAccounts` record, selected per record by `referrerScopeType`.', importance: FieldSemanticImportance.PRIMARY }),
|
|
29
29
|
referrerScopeType: schemaShape.referrerScopeType.enumSpec({
|
|
30
30
|
meaning: 'Discriminator that selects which billing-account branch `referrerBillingAccountId` points at (org- vs user-scoped); matched against the branch’s primary scope.',
|
|
31
31
|
enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'BillingScopeType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
|
|
@@ -44,7 +44,7 @@ const referralsBase = resourceSpecification(referralsFactory, ReferralSchema, ({
|
|
|
44
44
|
},
|
|
45
45
|
}),
|
|
46
46
|
status: schemaShape.status.enumSpec({
|
|
47
|
-
meaning: 'Lifecycle of the referral
|
|
47
|
+
meaning: 'Lifecycle of the referral record for reward eligibility.',
|
|
48
48
|
enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ReferralStatus', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },
|
|
49
49
|
values: {
|
|
50
50
|
[ReferralStatus.PENDING]: { meaning: 'Code issued; no conversion yet.' },
|
|
@@ -62,7 +62,7 @@ const referralsBase = resourceSpecification(referralsFactory, ReferralSchema, ({
|
|
|
62
62
|
convertedAt: schemaShape.convertedAt.dateSpec({ meaning: 'When the business defines “conversion” (often first paid subscription).', temporalRole: 'occurred' }),
|
|
63
63
|
expiresAt: schemaShape.expiresAt.dateSpec({ meaning: 'When the offer window closes for this code if limited.', temporalRole: 'deadline' }),
|
|
64
64
|
metadata: schemaShape.metadata.objectSpec({ meaning: 'Campaign ids or UTM echo for marketing analytics.' }),
|
|
65
|
-
createdAt: schemaShape.createdAt.dateSpec({ meaning: '
|
|
65
|
+
createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Record creation time.', temporalRole: 'creation' }),
|
|
66
66
|
updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Last reward or status change.', temporalRole: 'modified' }),
|
|
67
67
|
},
|
|
68
68
|
operations: {
|
|
@@ -70,7 +70,7 @@ const referralsBase = resourceSpecification(referralsFactory, ReferralSchema, ({
|
|
|
70
70
|
purpose: 'Inspect a referral in partner or CSM UIs and support tools.',
|
|
71
71
|
outcome: 'Full state + reward config snapshot.',
|
|
72
72
|
responseStatuses: [
|
|
73
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The referral
|
|
73
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The referral record was found and its full state + reward-config snapshot is returned.' },
|
|
74
74
|
],
|
|
75
75
|
errorScenarios: [
|
|
76
76
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to read referral program rows (the operation is an internal service-pipeline op, back-office scoped, not HTTP-exposed).' },
|
|
@@ -82,7 +82,7 @@ const referralsBase = resourceSpecification(referralsFactory, ReferralSchema, ({
|
|
|
82
82
|
purpose: 'Program dashboards over referrals for an org or app (merged admin adds LIST in `views` as non-addressable).',
|
|
83
83
|
outcome: 'Paginated rows filtered by app policies.',
|
|
84
84
|
responseStatuses: [
|
|
85
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of referral
|
|
85
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of referral records scoped to the caller’s billing account and filtered by app policy.' },
|
|
86
86
|
],
|
|
87
87
|
errorScenarios: [
|
|
88
88
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to enumerate referral program rows.' },
|
|
@@ -93,7 +93,7 @@ const referralsBase = resourceSpecification(referralsFactory, ReferralSchema, ({
|
|
|
93
93
|
purpose: 'Issue a new referral when a user/org starts a share from billing settings.',
|
|
94
94
|
outcome: 'New `referralCode` and reward templates from the active program config.',
|
|
95
95
|
responseStatuses: [
|
|
96
|
-
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'A referral
|
|
96
|
+
{ code: HttpResponseStatusCode.CREATED_201, meaning: 'A referral record was created with a freshly minted `referralCode` and reward templates copied from the active program config.' },
|
|
97
97
|
],
|
|
98
98
|
errorScenarios: [
|
|
99
99
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The referral payload (referrer account / scope) fails schema validation.', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -123,7 +123,7 @@ const referralsBase = resourceSpecification(referralsFactory, ReferralSchema, ({
|
|
|
123
123
|
purpose: 'Patch status, referred ids, applied flags, and timestamps as the funnel progresses.',
|
|
124
124
|
outcome: 'Updated row; reward application should be transactional in the service layer.',
|
|
125
125
|
responseStatuses: [
|
|
126
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The referral
|
|
126
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The referral record advanced (status / referred ids / reward-applied flags / timestamps) and the updated record is returned.' },
|
|
127
127
|
],
|
|
128
128
|
errorScenarios: [
|
|
129
129
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patched fields (status transition, referred account, applied flags) fail schema validation.', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"referrals.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/referrals.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n referralsAdminResourceUIBehavior as referralsAdminSource,\n referralsMainResourceUIBehavior as referralsMainSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n BillingScopeType,\n CoreResourceOperation as Op,\n ReferralSchema,\n ReferralStatus,\n ResourcePrimaryScope,\n referralsResourceConfiguration_InitializationFactory as referralsFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof referralsFactory>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\nconst referralsMainUI = referralsMainSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\nconst referralsAdminUI = referralsAdminSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nconst referralsBase = resourceSpecification<undefined, Core, Main>(\n referralsFactory,\n ReferralSchema,\n ({ schemaShape }) => ({\n purpose: 'A referral between two billing accounts: the code that was shared, whether it converted, and the rewards each side earned. Promotions define the offer; a referral records one use of it.',\n businessRole: 'Tracks who referred whom across org vs user billing scopes and whether rewards were applied once the referred party converts.',\n lifecycleRole: 'Created when a code is issued; `referredBillingAccountId` fills in on signup; status moves to CONVERTED on first subscription per product rules; rewards are idempotent via `*RewardApplied` flags.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'ReferralSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactory: { packageName: '@wildo-ai/saas-models', exportName: 'referralsResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName: 'REFERRALS' },\n operationVocabulary: { coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM } },\n frontendConfigurationSources: [\n { packageName: '@wildo-ai/presets-components', exportName: 'referralsMainResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n { packageName: '@wildo-ai/presets-components', exportName: 'referralsAdminResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n ],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Referral document id.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n referralCode: schemaShape.referralCode.stringSpec({ meaning: 'Globally unique shareable code embedded in invite links.', importance: FieldSemanticImportance.PRIMARY }),\n referrerBillingAccountId: schemaShape.referrerBillingAccountId.foreignKeySpec({ meaning: 'Billing account of the party that ISSUED the referral (the referrer) and is entitled to referrer-side rewards on conversion. Per-record DISCRIMINATED polymorphic FK: resolves to a `userBillingAccounts` OR `organizationBillingAccounts` record, selected per row by `referrerScopeType`.', importance: FieldSemanticImportance.PRIMARY }),\n referrerScopeType: schemaShape.referrerScopeType.enumSpec({\n meaning: 'Discriminator that selects which billing-account branch `referrerBillingAccountId` points at (org- vs user-scoped); matched against the branch’s primary scope.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'BillingScopeType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [BillingScopeType.ORGANIZATIONS]: { meaning: 'Referrer account lives under an organization billing account resource.' },\n [BillingScopeType.USER_SELF]: { meaning: 'Referrer account is a user billing account resource.' },\n },\n }),\n referredBillingAccountId: schemaShape.referredBillingAccountId.foreignKeySpec({ meaning: 'Billing account of the party that WAS REFERRED (the referee), populated once they create a billing account through the program and entitled to referred-side credit. Per-record DISCRIMINATED polymorphic FK like `referrerBillingAccountId`, with the branch selected by `referredScopeType`.', importance: FieldSemanticImportance.PRIMARY }),\n referredScopeType: schemaShape.referredScopeType.enumSpec({\n meaning: 'Discriminator that selects which billing-account branch `referredBillingAccountId` points at, once the referred account is known.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'BillingScopeType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [BillingScopeType.ORGANIZATIONS]: { meaning: 'Referred tenant org billing account.' },\n [BillingScopeType.USER_SELF]: { meaning: 'Referred individual billing account.' },\n },\n }),\n status: schemaShape.status.enumSpec({\n meaning: 'Lifecycle of the referral row for reward eligibility.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ReferralStatus', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [ReferralStatus.PENDING]: { meaning: 'Code issued; no conversion yet.' },\n [ReferralStatus.ACCEPTED]: { meaning: 'Referee signed up; not yet monetized.' },\n [ReferralStatus.CONVERTED]: { meaning: 'First qualifying subscription completed — reward hooks run here.' },\n [ReferralStatus.EXPIRED]: { meaning: 'Past `expiresAt` without conversion.' },\n [ReferralStatus.CANCELLED]: { meaning: 'Programmatically voided referral.' },\n },\n }),\n referrerReward: schemaShape.referrerReward.objectSpec({ meaning: 'Serialized reward terms for the referrer when status hits CONVERTED.' }),\n referredReward: schemaShape.referredReward.objectSpec({ meaning: 'Serialized reward terms for the referred account on conversion.' }),\n referrerRewardApplied: schemaShape.referrerRewardApplied.booleanSpec({ meaning: 'Idempotency bit so payout jobs do not double-apply benefits.' }),\n referredRewardApplied: schemaShape.referredRewardApplied.booleanSpec({ meaning: 'Idempotency for the referred-side credit/discount application.' }),\n acceptedAt: schemaShape.acceptedAt.dateSpec({ meaning: 'When the referred party accepted/registered using the code.', temporalRole: 'occurred' }),\n convertedAt: schemaShape.convertedAt.dateSpec({ meaning: 'When the business defines “conversion” (often first paid subscription).', temporalRole: 'occurred' }),\n expiresAt: schemaShape.expiresAt.dateSpec({ meaning: 'When the offer window closes for this code if limited.', temporalRole: 'deadline' }),\n metadata: schemaShape.metadata.objectSpec({ meaning: 'Campaign ids or UTM echo for marketing analytics.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Row creation time.', temporalRole: 'creation' }),\n updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Last reward or status change.', temporalRole: 'modified' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Inspect a referral in partner or CSM UIs and support tools.',\n outcome: 'Full state + reward config snapshot.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The referral row was found and its full state + reward-config snapshot is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to read referral program rows (the operation is an internal service-pipeline op, back-office scoped, not HTTP-exposed).' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No referral exists for the supplied id in the caller’s billing scope.' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'Program dashboards over referrals for an org or app (merged admin adds LIST in `views` as non-addressable).',\n outcome: 'Paginated rows filtered by app policies.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of referral rows scoped to the caller’s billing account and filtered by app policy.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to enumerate referral program rows.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Issue a new referral when a user/org starts a share from billing settings.',\n outcome: 'New `referralCode` and reward templates from the active program config.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A referral row was created with a freshly minted `referralCode` and reward templates copied from the active program config.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The referral payload (referrer account / scope) fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to issue referral rows (this is an internal service-pipeline, back-office-issued resource, not HTTP-exposed).' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The generated `referralCode` collides with an existing code, or the referrer is attempting a self-referral that program rules forbid.' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Issue a referral for an organization referrer',\n request: {\n referrerBillingAccountId: 'billacct_org_01HX2…',\n referrerScopeType: BillingScopeType.ORGANIZATIONS,\n },\n response: {\n _id: 'referral_01HX2…',\n referralCode: 'WILDO-7Q2K9X',\n referrerBillingAccountId: 'billacct_org_01HX2…',\n referrerScopeType: BillingScopeType.ORGANIZATIONS,\n status: ReferralStatus.PENDING,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Patch status, referred ids, applied flags, and timestamps as the funnel progresses.',\n outcome: 'Updated row; reward application should be transactional in the service layer.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The referral row advanced (status / referred ids / reward-applied flags / timestamps) and the updated row is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patched fields (status transition, referred account, applied flags) fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to mutate referral program rows.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No referral exists for the supplied id in the caller’s billing scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The referee is already claimed/converted on this referral, or a `*RewardApplied` idempotency bit conflicts with a concurrent payout job.' },\n ],\n idempotent: true,\n },\n },\n businessConstraints: [\n 'Referral program definitions may live in separate config; this row is the per-relationship state machine, not the global program editor.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.ORGANIZATIONS },\n);\n\nexport const referralsResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(referralsMainUI), resourceFrontendConfiguration(referralsAdminUI)),\n referralsBase,\n () => ({\n label: { purpose: 'Preset `getFrontendResourceLabel` shows `referralCode` in lists for share/audit.' },\n layout: {\n purpose: 'Inline summary in billing presets (no `refs.sections`) shows `referralCode`, status, scope badges, key dates, and referrer id.',\n displayPurpose: 'Main bundle has no addressable `views`; merged admin adds LIST+READ (non-addressable) for back-office triage with org owner roles in the factory.',\n },\n views: {\n [Op.LIST]: { purpose: 'Merged admin includes LIST in `views` as non-addressable — document for spec/preset overlay parity.', whenToUse: 'Org referral tables when super-admin or org-admin routes are wired.' },\n [Op.READ]: { purpose: 'Merged admin includes READ in `views` as non-addressable.', whenToUse: 'Detail drawer on one referral when wired.' },\n },\n }),\n);\n"]}
|
|
1
|
+
{"version":3,"file":"referrals.resource.specification.js","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/referrals.resource.specification.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n referralsAdminResourceUIBehavior as referralsAdminSource,\n referralsMainResourceUIBehavior as referralsMainSource,\n} from '@wildo-ai/presets-components';\nimport { LabelAudience } from '@wildo-ai/presets-components-models';\nimport type { ResourceUIBehaviorConfig } from '@wildo-ai/saas-frontend-lib/companion';\nimport { CodeDeclarationKind, CodeSymbolKind, FieldSemanticImportance } from '@wildo-ai/zod-decorators';\nimport {\n BillingScopeType,\n CoreResourceOperation as Op,\n ReferralSchema,\n ReferralStatus,\n ResourcePrimaryScope,\n referralsResourceConfiguration_InitializationFactory as referralsFactory,\n} from '@wildo-ai/saas-models';\nimport {\n HttpResponseStatusCode,\n mergeResourceFrontendConfigurations,\n resourceFrontendConfiguration,\n resourceSpecification,\n resourceSpecificationFromFrontendConfiguration,\n} from '~wildo-specifications/_core';\nimport { EngineResourceSubDomain } from '../../engine-resource-sub-domain';\n\ntype Cfg = ReturnType<typeof referralsFactory>;\ntype Core = Cfg['coreOperations'][number];\ntype Main = Cfg['mainSchema'];\nconst referralsMainUI = referralsMainSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\nconst referralsAdminUI = referralsAdminSource as ResourceUIBehaviorConfig<undefined, Core, Main>;\n\nconst referralsBase = resourceSpecification<undefined, Core, Main>(\n referralsFactory,\n ReferralSchema,\n ({ schemaShape }) => ({\n purpose: 'A referral between two billing accounts: the code that was shared, whether it converted, and the rewards each side earned. Promotions define the offer; a referral records one use of it.',\n businessRole: 'Tracks who referred whom across org vs user billing scopes and whether rewards were applied once the referred party converts.',\n lifecycleRole: 'Created when a code is issued; `referredBillingAccountId` fills in on signup; status moves to CONVERTED on first subscription per product rules; rewards are idempotent via `*RewardApplied` flags.',\n audience: LabelAudience.ADMIN,\n subDomain: EngineResourceSubDomain.BILLING,\n codeHandling: {\n mainSchema: { packageName: '@wildo-ai/saas-models', exportName: 'ReferralSchema', symbolKind: CodeSymbolKind.SCHEMA, declarationKind: CodeDeclarationKind.ZOD_SCHEMA },\n resourceFactory: { packageName: '@wildo-ai/saas-models', exportName: 'referralsResourceConfiguration_InitializationFactory', symbolKind: CodeSymbolKind.FACTORY, declarationKind: CodeDeclarationKind.FUNCTION },\n resourceType: { enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM }, memberName: 'REFERRALS' },\n operationVocabulary: { coreEnum: { packageName: '@wildo-ai/saas-models', exportName: 'CoreResourceOperation', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM } },\n frontendConfigurationSources: [\n { packageName: '@wildo-ai/presets-components', exportName: 'referralsMainResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n { packageName: '@wildo-ai/presets-components', exportName: 'referralsAdminResourceUIBehavior', symbolKind: CodeSymbolKind.UI_BEHAVIOR },\n ],\n },\n fields: {\n _id: schemaShape._id.stringSpec({ meaning: 'Referral document id.', importance: FieldSemanticImportance.PRIMARY, semanticRole: 'identifier' }),\n referralCode: schemaShape.referralCode.stringSpec({ meaning: 'Globally unique shareable code embedded in invite links.', importance: FieldSemanticImportance.PRIMARY }),\n referrerBillingAccountId: schemaShape.referrerBillingAccountId.foreignKeySpec({ meaning: 'Billing account of the party that ISSUED the referral (the referrer) and is entitled to referrer-side rewards on conversion. Per-record DISCRIMINATED polymorphic FK: resolves to a `userBillingAccounts` OR `organizationBillingAccounts` record, selected per record by `referrerScopeType`.', importance: FieldSemanticImportance.PRIMARY }),\n referrerScopeType: schemaShape.referrerScopeType.enumSpec({\n meaning: 'Discriminator that selects which billing-account branch `referrerBillingAccountId` points at (org- vs user-scoped); matched against the branch’s primary scope.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'BillingScopeType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [BillingScopeType.ORGANIZATIONS]: { meaning: 'Referrer account lives under an organization billing account resource.' },\n [BillingScopeType.USER_SELF]: { meaning: 'Referrer account is a user billing account resource.' },\n },\n }),\n referredBillingAccountId: schemaShape.referredBillingAccountId.foreignKeySpec({ meaning: 'Billing account of the party that WAS REFERRED (the referee), populated once they create a billing account through the program and entitled to referred-side credit. Per-record DISCRIMINATED polymorphic FK like `referrerBillingAccountId`, with the branch selected by `referredScopeType`.', importance: FieldSemanticImportance.PRIMARY }),\n referredScopeType: schemaShape.referredScopeType.enumSpec({\n meaning: 'Discriminator that selects which billing-account branch `referredBillingAccountId` points at, once the referred account is known.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'BillingScopeType', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [BillingScopeType.ORGANIZATIONS]: { meaning: 'Referred tenant org billing account.' },\n [BillingScopeType.USER_SELF]: { meaning: 'Referred individual billing account.' },\n },\n }),\n status: schemaShape.status.enumSpec({\n meaning: 'Lifecycle of the referral record for reward eligibility.',\n enumDeclaration: { packageName: '@wildo-ai/saas-models', exportName: 'ReferralStatus', symbolKind: CodeSymbolKind.ENUM, declarationKind: CodeDeclarationKind.TYPESCRIPT_ENUM },\n values: {\n [ReferralStatus.PENDING]: { meaning: 'Code issued; no conversion yet.' },\n [ReferralStatus.ACCEPTED]: { meaning: 'Referee signed up; not yet monetized.' },\n [ReferralStatus.CONVERTED]: { meaning: 'First qualifying subscription completed — reward hooks run here.' },\n [ReferralStatus.EXPIRED]: { meaning: 'Past `expiresAt` without conversion.' },\n [ReferralStatus.CANCELLED]: { meaning: 'Programmatically voided referral.' },\n },\n }),\n referrerReward: schemaShape.referrerReward.objectSpec({ meaning: 'Serialized reward terms for the referrer when status hits CONVERTED.' }),\n referredReward: schemaShape.referredReward.objectSpec({ meaning: 'Serialized reward terms for the referred account on conversion.' }),\n referrerRewardApplied: schemaShape.referrerRewardApplied.booleanSpec({ meaning: 'Idempotency bit so payout jobs do not double-apply benefits.' }),\n referredRewardApplied: schemaShape.referredRewardApplied.booleanSpec({ meaning: 'Idempotency for the referred-side credit/discount application.' }),\n acceptedAt: schemaShape.acceptedAt.dateSpec({ meaning: 'When the referred party accepted/registered using the code.', temporalRole: 'occurred' }),\n convertedAt: schemaShape.convertedAt.dateSpec({ meaning: 'When the business defines “conversion” (often first paid subscription).', temporalRole: 'occurred' }),\n expiresAt: schemaShape.expiresAt.dateSpec({ meaning: 'When the offer window closes for this code if limited.', temporalRole: 'deadline' }),\n metadata: schemaShape.metadata.objectSpec({ meaning: 'Campaign ids or UTM echo for marketing analytics.' }),\n createdAt: schemaShape.createdAt.dateSpec({ meaning: 'Record creation time.', temporalRole: 'creation' }),\n updatedAt: schemaShape.updatedAt.dateSpec({ meaning: 'Last reward or status change.', temporalRole: 'modified' }),\n },\n operations: {\n [Op.READ]: {\n purpose: 'Inspect a referral in partner or CSM UIs and support tools.',\n outcome: 'Full state + reward config snapshot.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The referral record was found and its full state + reward-config snapshot is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to read referral program rows (the operation is an internal service-pipeline op, back-office scoped, not HTTP-exposed).' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No referral exists for the supplied id in the caller’s billing scope.' },\n ],\n idempotent: true,\n },\n [Op.LIST]: {\n purpose: 'Program dashboards over referrals for an org or app (merged admin adds LIST in `views` as non-addressable).',\n outcome: 'Paginated rows filtered by app policies.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'A (possibly empty) page of referral records scoped to the caller’s billing account and filtered by app policy.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to enumerate referral program rows.' },\n ],\n idempotent: true,\n },\n [Op.CREATE]: {\n purpose: 'Issue a new referral when a user/org starts a share from billing settings.',\n outcome: 'New `referralCode` and reward templates from the active program config.',\n responseStatuses: [\n { code: HttpResponseStatusCode.CREATED_201, meaning: 'A referral record was created with a freshly minted `referralCode` and reward templates copied from the active program config.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The referral payload (referrer account / scope) fails schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to issue referral rows (this is an internal service-pipeline, back-office-issued resource, not HTTP-exposed).' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The generated `referralCode` collides with an existing code, or the referrer is attempting a self-referral that program rules forbid.' },\n ],\n idempotent: false,\n examples: [\n {\n title: 'Issue a referral for an organization referrer',\n request: {\n referrerBillingAccountId: 'billacct_org_01HX2…',\n referrerScopeType: BillingScopeType.ORGANIZATIONS,\n },\n response: {\n _id: 'referral_01HX2…',\n referralCode: 'WILDO-7Q2K9X',\n referrerBillingAccountId: 'billacct_org_01HX2…',\n referrerScopeType: BillingScopeType.ORGANIZATIONS,\n status: ReferralStatus.PENDING,\n },\n forStatus: HttpResponseStatusCode.CREATED_201,\n },\n ],\n },\n [Op.UPDATE]: {\n purpose: 'Patch status, referred ids, applied flags, and timestamps as the funnel progresses.',\n outcome: 'Updated row; reward application should be transactional in the service layer.',\n responseStatuses: [\n { code: HttpResponseStatusCode.OK_200, meaning: 'The referral record advanced (status / referred ids / reward-applied flags / timestamps) and the updated record is returned.' },\n ],\n errorScenarios: [\n { code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patched fields (status transition, referred account, applied flags) fail schema validation.', errorCode: 'VALIDATION_FAILED' },\n { code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner role required to mutate referral program rows.' },\n { code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No referral exists for the supplied id in the caller’s billing scope.' },\n { code: HttpResponseStatusCode.CONFLICT_409, when: 'The referee is already claimed/converted on this referral, or a `*RewardApplied` idempotency bit conflicts with a concurrent payout job.' },\n ],\n idempotent: true,\n },\n },\n businessConstraints: [\n 'Referral program definitions may live in separate config; this row is the per-relationship state machine, not the global program editor.',\n ],\n }),\n { resourcePrimaryScope: ResourcePrimaryScope.ORGANIZATIONS },\n);\n\nexport const referralsResourceSpecification = resourceSpecificationFromFrontendConfiguration(\n mergeResourceFrontendConfigurations(resourceFrontendConfiguration(referralsMainUI), resourceFrontendConfiguration(referralsAdminUI)),\n referralsBase,\n () => ({\n label: { purpose: 'Preset `getFrontendResourceLabel` shows `referralCode` in lists for share/audit.' },\n layout: {\n purpose: 'Inline summary in billing presets (no `refs.sections`) shows `referralCode`, status, scope badges, key dates, and referrer id.',\n displayPurpose: 'Main bundle has no addressable `views`; merged admin adds LIST+READ (non-addressable) for back-office triage with org owner roles in the factory.',\n },\n views: {\n [Op.LIST]: { purpose: 'Merged admin includes LIST in `views` as non-addressable — document for spec/preset overlay parity.', whenToUse: 'Org referral tables when super-admin or org-admin routes are wired.' },\n [Op.READ]: { purpose: 'Merged admin includes READ in `views` as non-addressable.', whenToUse: 'Detail drawer on one referral when wired.' },\n },\n }),\n);\n"]}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"subscriptions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/subscriptions.resource.specification.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,8BAA8B,EAC9B,qBAAqB,IAAI,EAAE,EAG3B,kBAAkB,EAEnB,MAAM,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"subscriptions.resource.specification.d.ts","sourceRoot":"","sources":["../../../../../../src/engine/billing/resources/subscriptions.resource.specification.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,8BAA8B,EAC9B,qBAAqB,IAAI,EAAE,EAG3B,kBAAkB,EAEnB,MAAM,uBAAuB,CAAC;AAuZ/B,eAAO,MAAM,8CAA8C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAG1D,CAAC;AAEF,eAAO,MAAM,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iCAAmF,CAAC"}
|
|
@@ -181,7 +181,7 @@ function buildSubscriptionBase(resourceType, memberName) {
|
|
|
181
181
|
purpose: 'Internal updates from webhooks or migration; user-facing changes often use custom ops.',
|
|
182
182
|
outcome: 'Patched fields per DTO rules in factory.',
|
|
183
183
|
responseStatuses: [
|
|
184
|
-
{ code: HttpResponseStatusCode.OK_200, meaning: 'The subscription fields were patched (typically reconciling provider webhook state) and the updated
|
|
184
|
+
{ code: HttpResponseStatusCode.OK_200, meaning: 'The subscription fields were patched (typically reconciling provider webhook state) and the updated record is returned.' },
|
|
185
185
|
],
|
|
186
186
|
errorScenarios: [
|
|
187
187
|
{ code: HttpResponseStatusCode.BAD_REQUEST_400, when: 'The patched fields fail schema validation.', errorCode: 'VALIDATION_FAILED' },
|
|
@@ -192,8 +192,8 @@ function buildSubscriptionBase(resourceType, memberName) {
|
|
|
192
192
|
},
|
|
193
193
|
[BillingSubscription_Operations.CANCEL]: {
|
|
194
194
|
operationId: BillingSubscription_Operations.CANCEL,
|
|
195
|
-
purpose: 'Cancel at
|
|
196
|
-
outcome: 'Provider and row updated; emails may fire per runtime config.',
|
|
195
|
+
purpose: 'Cancel at the end of the current period or immediately, within what the plan permits.',
|
|
196
|
+
outcome: 'Provider and row updated; emails may fire per runtime config. Timing is decided in this order: the request’s `cancelImmediately` when it names one, then the plan product’s authored default, then the end of the current period. A plan may FORBID immediate cancellation, in which case a request for one is refused rather than quietly downgraded — a caller told their subscription ended when it has not is worse served than one told no.',
|
|
197
197
|
responseStatuses: [
|
|
198
198
|
{ code: HttpResponseStatusCode.OK_200, meaning: 'The cancellation was accepted at the provider and mirrored locally — either `cancelAtPeriodEnd` is set or the subscription is now `CANCELLED` per the `cancelImmediately` flag.' },
|
|
199
199
|
],
|
|
@@ -201,6 +201,7 @@ function buildSubscriptionBase(resourceType, memberName) {
|
|
|
201
201
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner/org-admin role required to cancel the subscription (a CRITICAL-risk lifecycle action).' },
|
|
202
202
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No subscription exists for the supplied id under the caller’s billing account.' },
|
|
203
203
|
{ code: HttpResponseStatusCode.CONFLICT_409, when: 'The subscription is in a state the provider will not cancel (e.g. already terminated, or `INCOMPLETE_EXPIRED`).' },
|
|
204
|
+
{ code: HttpResponseStatusCode.CONFLICT_409, when: 'Immediate cancellation was requested for a plan whose product forbids it. The subscription can still be cancelled at the end of the current period.' },
|
|
204
205
|
],
|
|
205
206
|
// Convergent lifecycle set: cancelling drives the subscription toward a fixed
|
|
206
207
|
// cancelled / cancel-at-period-end state, so a repeat request lands the same
|
|
@@ -257,6 +258,7 @@ function buildSubscriptionBase(resourceType, memberName) {
|
|
|
257
258
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner/org-admin role required to change the plan (a HIGH-risk commercial action).' },
|
|
258
259
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No subscription exists for the supplied id, or the target product/price is not in the catalog.' },
|
|
259
260
|
{ code: HttpResponseStatusCode.CONFLICT_409, when: 'The requested price is incompatible with the current subscription, or the provider rejects the proration in the subscription’s current state.' },
|
|
261
|
+
{ code: HttpResponseStatusCode.CONFLICT_409, when: '`newProductKey` (or the price named by `newPriceId`) has been RETIRED from the code catalogue. A subscription may not be MOVED ONTO a retired product; a subscription already on one keeps running, and REMOVE_ADDON deliberately still works so a customer is never trapped on a withdrawn add-on.', errorCode: 'BILLING_PRODUCT_RETIRED' },
|
|
260
262
|
],
|
|
261
263
|
// Non-convergent: each plan swap is a distinct commercial change with its own
|
|
262
264
|
// proration at the provider, so repeating the request is not side-effect-free.
|
|
@@ -290,6 +292,7 @@ function buildSubscriptionBase(resourceType, memberName) {
|
|
|
290
292
|
{ code: HttpResponseStatusCode.FORBIDDEN_403, when: 'The caller lacks the org-owner/org-admin role required to add an add-on (a HIGH-risk commercial action).' },
|
|
291
293
|
{ code: HttpResponseStatusCode.NOT_FOUND_404, when: 'No subscription exists for the supplied id, or the add-on product is not in the catalog.' },
|
|
292
294
|
{ code: HttpResponseStatusCode.CONFLICT_409, when: 'The add-on is already attached, or is incompatible with the current plan per provider rules.' },
|
|
295
|
+
{ code: HttpResponseStatusCode.CONFLICT_409, when: '`addonProductKey` (or the price named by `priceId`) has been RETIRED from the code catalogue and may no longer be bought.', errorCode: 'BILLING_PRODUCT_RETIRED' },
|
|
293
296
|
],
|
|
294
297
|
// Non-convergent: adding an add-on is an incremental commercial change; a repeat
|
|
295
298
|
// call would attempt to attach the same add-on again (and trips the 409 above).
|