npm - @wildo-ai/saas-backend-lib - Versions diffs - 1.1.1 → 1.1.3 - Mend

@wildo-ai/saas-backend-lib 1.1.1 → 1.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (972) hide show

package/dist/esm/billing/services/custom-impl/billing-custom-impl-utils.backend.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"billing-custom-impl-utils.backend.js","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/billing-custom-impl-utils.backend.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Shared helpers for billing custom implementations.\n \n Used by subscription and billing account custom impl factories,\n * the webhook event router, and the feature sync service\n * for cross-resource reads, provider validation, variant resolution,\n * and feature sync.\n /\n\nimport {\n CoreResourceOperation,\n CoreResourceType,\n ResourcePrimaryScope,\n ErrorType,\n ErrorCustomMessageReference,\n RelationshipNature,\n coreSharedResourceRelationship,\n} from '@wildo-ai/saas-models';\nimport type { ResourceType } from '@wildo-ai/saas-models';\nimport type { ResourceOperation_CustomImplementation_Utils } from '~wildo-backend-lib/base-classes/services/services/resource-operation-custom-implementation-base.backend.service';\nimport type { ExecutionContext } from '~wildo-backend-lib/runtime/models/execution-context.backend.schemas';\n\n// ── Credit Pool Variant Types ───────────────────────────────────────\n\n/* All credit pool polymorphic variant types (org, user). /\nexport const CREDIT_POOL_VARIANT_TYPES = [\n CoreResourceType.ORGANIZATION_CREDIT_POOLS,\n CoreResourceType.USER_CREDIT_POOLS,\n] as const;\n\n// ── Polymorphic Variant Resolution ──────────────────────────────────\n\n/\n Resolved billing polymorphic variant context.\n \n Provides the concrete resource types and FK field names for a specific\n * billing scope (organization or user). Used by the webhook\n * router, custom implementation postfix handlers, and the feature sync service\n * to query the correct polymorphic collections with the correct field names.\n /\nexport interface BillingResolvedVariants {\n /* The scope key on ExecutionContext that identifies this variant ('organizationId' \| 'userId') /\n scopeKey: string;\n /\n The scope entity FK field name as it appears on variant DOCUMENTS.\n * May differ from `scopeKey` for some variants.\n /\n scopeEntityDocField: string;\n /* The corresponding ResourcePrimaryScope value for features resource resolution /\n scopeType: ResourcePrimaryScope;\n /* The polymorphic FK field name on child resources (e.g., 'organizationBillingAccountId') /\n billingAccountFkField: string;\n /* The billing account variant resource type /\n billingAccount: string;\n /* The subscription variant resource type /\n subscription: string;\n /* The invoice ref variant resource type /\n invoiceRef: string;\n /* The credit pool variant resource type /\n creditPool: string;\n /* The usage record variant resource type /\n usageRecord: string;\n}\n\n/\n Deterministic mapping from execution context scope key to billing polymorphic variants.\n * All billing child resources share the same scope prefix per variant.\n /\nexport const BILLING_SCOPE_TO_VARIANTS: Record<string, Omit<BillingResolvedVariants, 'scopeKey'>> = {\n organizationId: {\n scopeEntityDocField: 'organizationId',\n scopeType: ResourcePrimaryScope.ORGANIZATIONS,\n billingAccountFkField: 'organizationBillingAccountId',\n billingAccount: CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS,\n subscription: CoreResourceType.ORGANIZATION_SUBSCRIPTIONS,\n invoiceRef: CoreResourceType.ORGANIZATION_INVOICE_REFS,\n creditPool: CoreResourceType.ORGANIZATION_CREDIT_POOLS,\n usageRecord: CoreResourceType.ORGANIZATION_USAGE_RECORDS,\n },\n userId: {\n scopeEntityDocField: 'userId',\n scopeType: ResourcePrimaryScope.USER_SELF,\n billingAccountFkField: 'userBillingAccountId',\n billingAccount: CoreResourceType.USER_BILLING_ACCOUNTS,\n subscription: CoreResourceType.USER_SUBSCRIPTIONS,\n invoiceRef: CoreResourceType.USER_INVOICE_REFS,\n creditPool: CoreResourceType.USER_CREDIT_POOLS,\n usageRecord: CoreResourceType.USER_USAGE_RECORDS,\n },\n};\n\n/\n Resolve billing variants from an execution context's scope IDs.\n * Returns null for APPLICATION-scoped events (no entity scope).\n /\nexport function resolveBillingVariants(execCtx: ExecutionContext<any>): BillingResolvedVariants \| null {\n if (execCtx.organizationId) return { scopeKey: 'organizationId', ...BILLING_SCOPE_TO_VARIANTS.organizationId };\n if (execCtx.userId) return { scopeKey: 'userId', ...BILLING_SCOPE_TO_VARIANTS.userId };\n return null;\n}\n\n/\n Resolve billing variants from a known variant resource type.\n * Used by custom implementation factories that know their variant at registration time.\n /\nconst VARIANT_TO_SCOPE_KEY: Record<string, string> = {\n [CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS]: 'organizationId',\n [CoreResourceType.USER_BILLING_ACCOUNTS]: 'userId',\n [CoreResourceType.ORGANIZATION_SUBSCRIPTIONS]: 'organizationId',\n [CoreResourceType.USER_SUBSCRIPTIONS]: 'userId',\n [CoreResourceType.ORGANIZATION_CREDIT_POOLS]: 'organizationId',\n [CoreResourceType.USER_CREDIT_POOLS]: 'userId',\n [CoreResourceType.ORGANIZATION_INVOICE_REFS]: 'organizationId',\n [CoreResourceType.USER_INVOICE_REFS]: 'userId',\n [CoreResourceType.ORGANIZATION_USAGE_RECORDS]: 'organizationId',\n [CoreResourceType.USER_USAGE_RECORDS]: 'userId',\n};\n\nexport function resolveBillingVariantsFromResourceType(variantResourceType: string): BillingResolvedVariants \| null {\n const scopeKey = VARIANT_TO_SCOPE_KEY[variantResourceType];\n if (!scopeKey) return null;\n return { scopeKey, ...BILLING_SCOPE_TO_VARIANTS[scopeKey] };\n}\n\n/\n Reverse mapping: ResourcePrimaryScope → scope key for BILLING_SCOPE_TO_VARIANTS.\n /\nconst SCOPE_TYPE_TO_SCOPE_KEY: Record<string, string> = {\n [ResourcePrimaryScope.ORGANIZATIONS]: 'organizationId',\n [ResourcePrimaryScope.USER_SELF]: 'userId',\n};\n\n/\n Resolve billing variants from a ResourcePrimaryScope value.\n * Used by the billing state endpoint where the caller provides scopeType directly.\n /\nexport function resolveBillingVariantsFromScopeType(scopeType: ResourcePrimaryScope): BillingResolvedVariants \| null {\n const scopeKey = SCOPE_TYPE_TO_SCOPE_KEY[scopeType];\n if (!scopeKey \|\| !BILLING_SCOPE_TO_VARIANTS[scopeKey]) return null;\n return { scopeKey, ...BILLING_SCOPE_TO_VARIANTS[scopeKey] };\n}\n\n// ── Product / Price repository reads ────────────────────────────────\n\n/\n Build the read context for an APPLICATION-scoped catalog resource (products, prices, promotions).\n \n ## The correction this encodes\n \n These readers used to pass the CALLER's execution context straight to the repository, under a\n * comment that read \"Products are APPLICATION-scoped — no org/user scope filtering applies\". That\n * statement is true about the RESOURCE and false about the READ, and the gap between the two was a\n * live 500.\n \n `PRODUCTS` / `PRICES` / `PROMOTIONS` are indeed APPLICATION-primary-scoped and model neither\n * `organizationId` nor `userId`. But the repository does not filter by the TARGET's scoping model —\n * it applies whatever the CALLER's context carries, and it is fail-closed on a field the target does\n * not model: it THROWS `CONFIGURATION` / `context_filter` rather than skipping it. So \"no scope\n * filtering applies\" describes the intent and inverts the consequence.\n \n It fires for real. Every caller here is a `BILLING_ACCOUNTS` / `SUBSCRIPTIONS` custom impl, and both\n * are polymorphic resources whose organization variant injects `organizationId` into the operation\n * context — so an org-scoped purchase or plan change reached a catalog read with an `organizationId`\n * the catalog has no column for.\n \n The sub-call context narrows the inherited context to fields the target actually models, which for\n * these resources is none of the caller's scope FKs — giving the unfiltered catalog read the original\n * comment assumed it already had.\n /\nasync function createCatalogReadContext(\n resourceType: ResourceType,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<ExecutionContext<any>> {\n return utils.executionContextCreator.createForSubCall(\n executionContext,\n resourceType,\n CoreResourceOperation.READ,\n utils.serviceOptions,\n );\n}\n\n/\n Read a product from the repository by key.\n \n Products are APPLICATION-scoped, so no org/user scoping is MEANT to apply — which is precisely why\n * the read must not inherit the caller's scope context. See {@link createCatalogReadContext}.\n /\nexport async function readProductByKey(\n key: string,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<any> {\n const productRepo = utils.repositoriesRegistry.getRepository(CoreResourceType.PRODUCTS);\n if (!productRepo) {\n throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,\n context: { productKey: key },\n });\n }\n const product = await productRepo.read(await createCatalogReadContext(CoreResourceType.PRODUCTS, executionContext, utils), { key });\n if (!product) {\n throw utils.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,\n context: { productKey: key },\n });\n }\n return product;\n}\n\n/\n Read a product from the repository by ID.\n /\nexport async function readProductById(\n productId: string,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<any> {\n const productRepo = utils.repositoriesRegistry.getRepository(CoreResourceType.PRODUCTS);\n if (!productRepo) {\n throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,\n context: { productId },\n });\n }\n const product = await productRepo.read(await createCatalogReadContext(CoreResourceType.PRODUCTS, executionContext, utils), productId);\n if (!product) {\n throw utils.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,\n context: { productId },\n });\n }\n return product;\n}\n\n/\n Read a price from the repository by ID.\n \n APPLICATION-scoped like products, and read on a sub-call context for the same reason — see\n * {@link createCatalogReadContext}.\n \n ## Use {@link readPriceForProduct} whenever a product is also in play\n \n This reader answers \"what is price X\", nothing more. It is correct for resolving the price of an\n * ALREADY-PERSISTED subscription item, where the product↔price pairing was decided (and validated)\n * when the item was written. It is NOT correct for a purchase path where the caller names a product\n * and a price in the same request: there the pairing is the thing an attacker controls, and reading\n * the two independently is precisely the defect {@link assertPriceBelongsToProduct} closes.\n /\nexport async function readPriceById(\n priceId: string,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<any> {\n const priceRepo = utils.repositoriesRegistry.getRepository(CoreResourceType.PRICES);\n if (!priceRepo) {\n throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRICE_NOT_FOUND,\n context: { priceId },\n });\n }\n const price = await priceRepo.read(await createCatalogReadContext(CoreResourceType.PRICES, executionContext, utils), priceId);\n if (!price) {\n throw utils.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRICE_NOT_FOUND,\n context: { priceId },\n });\n }\n return price;\n}\n\n/\n Refuse a price that does not belong to the product it is being purchased against.\n \n ## Why this has to exist\n \n `Price.productId` is a declared foreign key — every price already knows its product. Every\n * purchase path nevertheless resolved the two INDEPENDENTLY (product by key, price by id) and\n * checked only that the price had a `providerPriceId`. The FK was never consulted.\n \n The consequence is a split between what is CHARGED and what is GRANTED. The provider is billed\n * `price.providerPriceId`, while the local subscription item records `productId: product._id`, and\n * entitlements (feature sync, plan tier, credit pack size) derive from the ITEM's product. So a\n * caller who pairs the premium product key with a cheap product's price id is billed the cheap\n * price and entitled at the premium product — an authorization outcome purchased at the wrong\n * amount, with both sides internally consistent and nothing downstream able to notice.\n \n ## Why a combined reader rather than a check at each site\n \n The three purchase paths (OPEN_CHECKOUT, CHANGE_PLAN, ADD_ADDON) are edited in different sessions\n * and each had the same omission. {@link readPriceForProduct} is the shape that makes the invariant\n * unbypassable for the next one: resolving a price in a product context and validating the pairing\n * are one call, so a new purchase path cannot obtain the price without the check having run.\n \n @param price - The price row, as read from the catalog.\n * @param product - The product row the purchase names.\n * @throws `VALIDATION` (400, `BILLING_PRICE_PRODUCT_MISMATCH`) when `price.productId !== product._id`.\n /\nexport function assertPriceBelongsToProduct(\n price: any,\n product: any,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): void {\n if (price?.productId === product?._id) return;\n\n throw utils.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRICE_PRODUCT_MISMATCH,\n context: {\n priceId: price?._id,\n priceProductId: price?.productId ?? null,\n productId: product?._id,\n productKey: product?.key,\n },\n });\n}\n\n/\n Read a price and prove it belongs to the given product, in one step.\n \n The safe reader for every path where the caller names a product AND a price. See\n * {@link assertPriceBelongsToProduct} for what goes wrong when the two are resolved independently.\n /\nexport async function readPriceForProduct(\n priceId: string,\n product: any,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<any> {\n const price = await readPriceById(priceId, executionContext, utils);\n assertPriceBelongsToProduct(price, product, executionContext, utils);\n return price;\n}\n\n// ── Promotion resolution ────────────────────────────────────────────\n\n/\n Read an active promotion from the repository by its user-facing code.\n * Returns null if no active promotion with that code exists.\n /\nexport async function readPromotionByCode(\n code: string,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<any> {\n const promoRepo = utils.repositoriesRegistry.getRepository(CoreResourceType.PROMOTIONS);\n if (!promoRepo) return null;\n const promotion = await promoRepo.read(await createCatalogReadContext(CoreResourceType.PROMOTIONS, executionContext, utils), { code, isActive: true });\n return promotion ?? null;\n}\n\n// ── Billing account dependent scan (hard-delete guard) ──────────────\n\n/\n The retained financial child families that pin a billing account in place.\n \n Typed against `BillingResolvedVariants` so a rename of any variant field breaks the build\n * here rather than silently dropping a family from the guard.\n /\nexport type BillingAccountDependentFamily = Extract<\n keyof BillingResolvedVariants,\n 'subscription' \| 'invoiceRef' \| 'usageRecord' \| 'creditPool'\n>;\n\n/\n Canonical ORDER of the billing child families. Order only — membership is derived below.\n \n Kept as an explicit tuple so the guard's scan order (and the report a human reads when a delete\n * is refused) is stable and mirrors the registry's declaration order, rather than depending on\n * however the relationship array happens to be arranged.\n /\nconst BILLING_ACCOUNT_DEPENDENT_FAMILY_ORDER: readonly BillingAccountDependentFamily[] = [\n 'subscription',\n 'invoiceRef',\n 'usageRecord',\n 'creditPool',\n] as const;\n\n/\n Every child family whose rows are RETAINED when their billing account is deleted.\n \n DERIVED from the registry, not restated. This used to be a hand-maintained list with a comment\n * asking a human to keep it in lock-step with `resources-registry.shared.core.definitions.ts` — the\n * exact coupling that rots, because the two live in different packages and nothing failed when they\n * disagreed. A family whose cascade is re-ENABLED now drops out of this list automatically (it is\n * no longer retained, so it no longer pins the account), and a family that stops being declared\n * disappears with it.\n \n The derivation asks the registry one question: for each `BillingAccounts → <child>` COMPOSITION\n * edge, is `onParentDelete` disabled? Disabled means \"these rows survive their parent\", which is\n * precisely what makes them a dependent that blocks a hard delete.\n \n Note this reads the BILLING-ACCOUNT edges specifically, not the scope edges. Both are disabled by\n * the same decision, but it is the account-parent edge that this guard is about.\n /\nexport const BILLING_ACCOUNT_DEPENDENT_FAMILIES: readonly BillingAccountDependentFamily[] =\n deriveRetainedBillingAccountDependentFamilies();\n\nfunction deriveRetainedBillingAccountDependentFamilies(): readonly BillingAccountDependentFamily[] {\n const billingAccountResourceTypes = new Set<string>(\n Object.values(BILLING_SCOPE_TO_VARIANTS).map((variants) => variants.billingAccount as string),\n );\n\n // child resource type → family key, across BOTH scope variants.\n const childResourceTypeToFamily = new Map<string, BillingAccountDependentFamily>();\n for (const variants of Object.values(BILLING_SCOPE_TO_VARIANTS)) {\n for (const family of BILLING_ACCOUNT_DEPENDENT_FAMILY_ORDER) {\n childResourceTypeToFamily.set(variants[family] as string, family);\n }\n }\n\n const retained = new Set<BillingAccountDependentFamily>();\n for (const relationship of coreSharedResourceRelationship) {\n if (relationship.nature !== RelationshipNature.COMPOSITION) continue;\n if (!billingAccountResourceTypes.has(relationship.resourceType1 as string)) continue;\n // Disabled (or absent) cascade == the child survives its parent == a retained dependent.\n if (relationship.childOperations?.lifecycle?.onParentDelete?.enabled === true) continue;\n\n const family = childResourceTypeToFamily.get(relationship.resourceType2 as string);\n if (family) retained.add(family);\n }\n\n return BILLING_ACCOUNT_DEPENDENT_FAMILY_ORDER.filter((family) => retained.has(family));\n}\n\n/\n Refuse hard removal of a billing account while retained financial children still reference it.\n \n ## Why this guard exists\n \n The billing-retention decision (2026-07-29) disabled `onParentDelete` on all 18 billing\n * cascades, so subscriptions / invoice refs / usage records / credit pools SURVIVE the deletion\n * of their scope and of their billing account. That made a direct hard delete of the account the\n * only remaining way to strand those retained rows behind a dangling FK.\n \n The damage is not merely referential: `providerCustomerId` is `.isBackendOnly()` and lives ONLY\n * on the account row. The children carry `providerInvoiceId` / `providerSubscriptionId` but NOT\n * the provider CUSTOMER id — so deleting the account destroys the only local key that maps a\n * retained invoice back to the customer it was billed to. A financial record that cannot be\n * reconciled against the provider defeats the purpose of retaining it. Nothing provider-side is\n * cleaned up on delete either, so the provider record lives on regardless.\n \n ## Why it fails closed\n \n The operation is `riskLevel: CRITICAL` and guards a compliance obligation, so \"cannot verify\"\n * must never read as \"nothing found\". A missing child repository raises `CONFIGURATION` rather\n * than being skipped, and any scope-filter failure inside the reads propagates instead of being\n * swallowed.\n \n The product off-boarding path is the soft retire (`isActive: false`), which this does not touch.\n \n Detection uses `read()` rather than `count()` deliberately: none of the four child families\n * declares a `COUNT` core operation, so `repository.count()` would throw INTERNAL. All four\n * declare `READ`. Each read is a single indexed hit on the billing-account FK, and the FK is\n * globally unique, so the result is correct regardless of how the execution context scopes it.\n \n @param billingAccountId - The account row about to be hard-deleted.\n * @param variants - Resolved polymorphic variants for the account's scope (org or user).\n * @throws `CONFLICT` (409, `BILLING_ACCOUNT_HAS_DEPENDENTS`) listing every blocking family.\n * @throws `CONFIGURATION` when a child family's repository is not registered (unverifiable).\n /\nexport async function assertNoBillingAccountDependents(\n billingAccountId: string,\n variants: BillingResolvedVariants,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<void> {\n const dependentFilter = { [variants.billingAccountFkField]: billingAccountId };\n\n const blockingFamilies = (\n await Promise.all(\n BILLING_ACCOUNT_DEPENDENT_FAMILIES.map(async (family) => {\n const childResourceType = variants[family];\n const childRepository = utils.repositoriesRegistry.getRepository(childResourceType);\n\n // Fail closed: an unregistered child repository means we cannot prove the family is\n // empty. Skipping it would silently downgrade the guard to \"nothing found\".\n if (!childRepository) {\n throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.CONFIGURATION,\n context: {\n message: 'Cannot verify billing-account dependents: child repository is not registered',\n billingAccountId,\n dependentFamily: family,\n childResourceType,\n },\n });\n }\n\n const existingChild = await childRepository.read(executionContext, dependentFilter);\n return existingChild ? family : undefined;\n }),\n )\n ).filter((family): family is BillingAccountDependentFamily => family !== undefined);\n\n if (blockingFamilies.length > 0) {\n throw utils.errorBuilder.buildError(ErrorType.CONFLICT, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_ACCOUNT_HAS_DEPENDENTS,\n context: {\n billingAccountId,\n blockingDependentFamilies: blockingFamilies,\n blockingResourceTypes: blockingFamilies.map((family) => variants[family]),\n },\n });\n }\n}\n\n// ── Provider validation ─────────────────────────────────────────────\n\n/\n Validate that a subscription has a provider subscription ID.\n /\nexport function validateProviderSubscription(\n subscription: any,\n subscriptionId: string,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): void {\n if (!subscription?.providerSubscriptionId) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_NO_PROVIDER_SUBSCRIPTION,\n context: { subscriptionId },\n });\n }\n}\n\n// ── Provider item resolution ────────────────────────────────────────\n\n/\n Resolve the providerPriceId for each subscription item by reading prices.\n */\nexport async function resolveProviderItems(\n items: any[],\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<Array<{ providerSubscriptionItemId?: string; providerPriceId: string; quantity: number }>> {\n return Promise.all(\n items.map(async (item: any) => {\n const price = await readPriceById(item.priceId, executionContext, utils);\n return {\n providerSubscriptionItemId: item.providerSubscriptionItemId,\n providerPriceId: price.providerPriceId \|\| item.priceId,\n quantity: item.quantity,\n };\n }),\n );\n}\n"]}
1	+ {"version":3,"file":"billing-custom-impl-utils.backend.js","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/billing-custom-impl-utils.backend.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Shared helpers for billing custom implementations.\n \n Used by subscription and billing account custom impl factories,\n * the webhook event router, and the feature sync service\n * for cross-resource reads, provider validation, variant resolution,\n * and feature sync.\n /\n\nimport {\n CoreResourceOperation,\n CoreResourceType,\n ResourcePrimaryScope,\n ErrorType,\n ErrorCustomMessageReference,\n RelationshipNature,\n coreSharedResourceRelationship,\n} from '@wildo-ai/saas-models';\nimport type { ResourceType } from '@wildo-ai/saas-models';\nimport type { ResourceOperation_CustomImplementation_Utils } from '~wildo-backend-lib/base-classes/services/services/resource-operation-custom-implementation-base.backend.service';\nimport type { ExecutionContext } from '~wildo-backend-lib/runtime/models/execution-context.backend.schemas';\n\n// ── Credit Pool Variant Types ───────────────────────────────────────\n\n/* All credit pool polymorphic variant types (org, user). /\nexport const CREDIT_POOL_VARIANT_TYPES = [\n CoreResourceType.ORGANIZATION_CREDIT_POOLS,\n CoreResourceType.USER_CREDIT_POOLS,\n] as const;\n\n// ── Polymorphic Variant Resolution ──────────────────────────────────\n\n/\n Resolved billing polymorphic variant context.\n \n Provides the concrete resource types and FK field names for a specific\n * billing scope (organization or user). Used by the webhook\n * router, custom implementation postfix handlers, and the feature sync service\n * to query the correct polymorphic collections with the correct field names.\n /\nexport interface BillingResolvedVariants {\n /* The scope key on ExecutionContext that identifies this variant ('organizationId' \| 'userId') /\n scopeKey: string;\n /\n The scope entity FK field name as it appears on variant DOCUMENTS.\n * May differ from `scopeKey` for some variants.\n /\n scopeEntityDocField: string;\n /* The corresponding ResourcePrimaryScope value for features resource resolution /\n scopeType: ResourcePrimaryScope;\n /* The polymorphic FK field name on child resources (e.g., 'organizationBillingAccountId') /\n billingAccountFkField: string;\n /* The billing account variant resource type /\n billingAccount: string;\n /* The subscription variant resource type /\n subscription: string;\n /* The invoice ref variant resource type /\n invoiceRef: string;\n /* The credit pool variant resource type /\n creditPool: string;\n /* The usage record variant resource type /\n usageRecord: string;\n}\n\n/\n Deterministic mapping from execution context scope key to billing polymorphic variants.\n * All billing child resources share the same scope prefix per variant.\n /\nexport const BILLING_SCOPE_TO_VARIANTS: Record<string, Omit<BillingResolvedVariants, 'scopeKey'>> = {\n organizationId: {\n scopeEntityDocField: 'organizationId',\n scopeType: ResourcePrimaryScope.ORGANIZATIONS,\n billingAccountFkField: 'organizationBillingAccountId',\n billingAccount: CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS,\n subscription: CoreResourceType.ORGANIZATION_SUBSCRIPTIONS,\n invoiceRef: CoreResourceType.ORGANIZATION_INVOICE_REFS,\n creditPool: CoreResourceType.ORGANIZATION_CREDIT_POOLS,\n usageRecord: CoreResourceType.ORGANIZATION_USAGE_RECORDS,\n },\n userId: {\n scopeEntityDocField: 'userId',\n scopeType: ResourcePrimaryScope.USER_SELF,\n billingAccountFkField: 'userBillingAccountId',\n billingAccount: CoreResourceType.USER_BILLING_ACCOUNTS,\n subscription: CoreResourceType.USER_SUBSCRIPTIONS,\n invoiceRef: CoreResourceType.USER_INVOICE_REFS,\n creditPool: CoreResourceType.USER_CREDIT_POOLS,\n usageRecord: CoreResourceType.USER_USAGE_RECORDS,\n },\n};\n\n/\n Resolve billing variants from an execution context's scope IDs.\n * Returns null for APPLICATION-scoped events (no entity scope).\n /\nexport function resolveBillingVariants(execCtx: ExecutionContext<any>): BillingResolvedVariants \| null {\n if (execCtx.organizationId) return { scopeKey: 'organizationId', ...BILLING_SCOPE_TO_VARIANTS.organizationId };\n if (execCtx.userId) return { scopeKey: 'userId', ...BILLING_SCOPE_TO_VARIANTS.userId };\n return null;\n}\n\n/\n Resolve billing variants from a known variant resource type.\n * Used by custom implementation factories that know their variant at registration time.\n /\nconst VARIANT_TO_SCOPE_KEY: Record<string, string> = {\n [CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS]: 'organizationId',\n [CoreResourceType.USER_BILLING_ACCOUNTS]: 'userId',\n [CoreResourceType.ORGANIZATION_SUBSCRIPTIONS]: 'organizationId',\n [CoreResourceType.USER_SUBSCRIPTIONS]: 'userId',\n [CoreResourceType.ORGANIZATION_CREDIT_POOLS]: 'organizationId',\n [CoreResourceType.USER_CREDIT_POOLS]: 'userId',\n [CoreResourceType.ORGANIZATION_INVOICE_REFS]: 'organizationId',\n [CoreResourceType.USER_INVOICE_REFS]: 'userId',\n [CoreResourceType.ORGANIZATION_USAGE_RECORDS]: 'organizationId',\n [CoreResourceType.USER_USAGE_RECORDS]: 'userId',\n};\n\nexport function resolveBillingVariantsFromResourceType(variantResourceType: string): BillingResolvedVariants \| null {\n const scopeKey = VARIANT_TO_SCOPE_KEY[variantResourceType];\n if (!scopeKey) return null;\n return { scopeKey, ...BILLING_SCOPE_TO_VARIANTS[scopeKey] };\n}\n\n/\n Reverse mapping: ResourcePrimaryScope → scope key for BILLING_SCOPE_TO_VARIANTS.\n /\nconst SCOPE_TYPE_TO_SCOPE_KEY: Record<string, string> = {\n [ResourcePrimaryScope.ORGANIZATIONS]: 'organizationId',\n [ResourcePrimaryScope.USER_SELF]: 'userId',\n};\n\n/\n Resolve billing variants from a ResourcePrimaryScope value.\n * Used by the billing state endpoint where the caller provides scopeType directly.\n /\nexport function resolveBillingVariantsFromScopeType(scopeType: ResourcePrimaryScope): BillingResolvedVariants \| null {\n const scopeKey = SCOPE_TYPE_TO_SCOPE_KEY[scopeType];\n if (!scopeKey \|\| !BILLING_SCOPE_TO_VARIANTS[scopeKey]) return null;\n return { scopeKey, ...BILLING_SCOPE_TO_VARIANTS[scopeKey] };\n}\n\n// ── Product / Price repository reads ────────────────────────────────\n\n/\n Build the read context for an APPLICATION-scoped catalog resource (products, prices, promotions).\n \n ## The correction this encodes\n \n These readers used to pass the CALLER's execution context straight to the repository, under a\n * comment that read \"Products are APPLICATION-scoped — no org/user scope filtering applies\". That\n * statement is true about the RESOURCE and false about the READ, and the gap between the two was a\n * live 500.\n \n `PRODUCTS` / `PRICES` / `PROMOTIONS` are indeed APPLICATION-primary-scoped and model neither\n * `organizationId` nor `userId`. But the repository does not filter by the TARGET's scoping model —\n * it applies whatever the CALLER's context carries, and it is fail-closed on a field the target does\n * not model: it THROWS `CONFIGURATION` / `context_filter` rather than skipping it. So \"no scope\n * filtering applies\" describes the intent and inverts the consequence.\n \n It fires for real. Every caller here is a `BILLING_ACCOUNTS` / `SUBSCRIPTIONS` custom impl, and both\n * are polymorphic resources whose organization variant injects `organizationId` into the operation\n * context — so an org-scoped purchase or plan change reached a catalog read with an `organizationId`\n * the catalog has no column for.\n \n The sub-call context narrows the inherited context to fields the target actually models, which for\n * these resources is none of the caller's scope FKs — giving the unfiltered catalog read the original\n * comment assumed it already had.\n /\nasync function createCatalogReadContext(\n resourceType: ResourceType,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<ExecutionContext<any>> {\n return utils.executionContextCreator.createForSubCall(\n executionContext,\n resourceType,\n CoreResourceOperation.READ,\n utils.serviceOptions,\n );\n}\n\n/\n Why a catalog row is being read — and therefore whether a RETIRED row may be returned.\n \n ## Why this is a required parameter rather than a check at the sites that need it\n \n `Product.isActive` is the declared off-boarding path (`assertNoBillingAccountDependents` calls\n * the soft retire exactly that), and no purchase path consulted it: `readProductByKey` handed back\n * a retired product exactly like a live one, so \"retired\" was a label with no behaviour behind it\n * and the catalogue-retirement reconciliation below would have been cosmetic.\n \n The gate is a REQUIRED argument on the reader — the same shape, and for the same reason, as\n * {@link readPriceForProduct} making the price→product FK check unbypassable: the four call sites\n * are edited in different sessions, three of them must refuse and one must NOT, and a separate\n * `assertProductIsPurchasable` helper is exactly the thing the fourth session forgets. Making the\n * distinction unrepresentable-by-omission costs one argument and removes the whole failure mode.\n \n The enumeration, so a fifth site can see which company it is in:\n * - OPEN_CHECKOUT (`billing-account.mutations`) — ACQUIRE.\n * - CHANGE_PLAN target product (`subscription.mutations`) — ACQUIRE.\n * - ADD_ADDON product (`subscription.mutations`) — ACQUIRE.\n * - REMOVE_ADDON product (`subscription.mutations`) — REFERENCE, deliberately. A customer\n * holding a retired add-on must be able to drop it; refusing here would trap them on the very\n * product the catalogue withdrew.\n /\nexport enum BillingCatalogReadIntent {\n /\n The caller is about to BUY this, or move a subscription onto it. A retired row is refused with\n * `CONFLICT` / `BILLING_PRODUCT_RETIRED`.\n /\n ACQUIRE = 'acquire',\n /\n The caller is naming a row that a subscription ALREADY points at — to display it, to remove it,\n * to rebuild a provider item list. A retired row is returned normally, because refusing would\n * break the paths a customer on a retired product needs most.\n /\n REFERENCE = 'reference',\n}\n\n/\n Read a product from the repository by key.\n \n Products are APPLICATION-scoped, so no org/user scoping is MEANT to apply — which is precisely why\n * the read must not inherit the caller's scope context. See {@link createCatalogReadContext}.\n /\nexport async function readProductByKey(\n key: string,\n intent: BillingCatalogReadIntent,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<any> {\n const productRepo = utils.repositoriesRegistry.getRepository(CoreResourceType.PRODUCTS);\n if (!productRepo) {\n throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,\n context: { productKey: key },\n });\n }\n const product = await productRepo.read(await createCatalogReadContext(CoreResourceType.PRODUCTS, executionContext, utils), { key });\n if (!product) {\n throw utils.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,\n context: { productKey: key },\n });\n }\n const productRow = product as any;\n if (intent === BillingCatalogReadIntent.ACQUIRE && productRow.isActive === false) {\n throw utils.errorBuilder.buildError(ErrorType.CONFLICT, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_RETIRED,\n context: { productKey: key, productId: productRow._id },\n });\n }\n return productRow;\n}\n\n/\n Read a product from the repository by ID.\n /\nexport async function readProductById(\n productId: string,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<any> {\n const productRepo = utils.repositoriesRegistry.getRepository(CoreResourceType.PRODUCTS);\n if (!productRepo) {\n throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,\n context: { productId },\n });\n }\n const product = await productRepo.read(await createCatalogReadContext(CoreResourceType.PRODUCTS, executionContext, utils), productId);\n if (!product) {\n throw utils.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,\n context: { productId },\n });\n }\n return product;\n}\n\n/\n Read a price from the repository by ID.\n \n APPLICATION-scoped like products, and read on a sub-call context for the same reason — see\n * {@link createCatalogReadContext}.\n \n ## Use {@link readPriceForProduct} whenever a product is also in play\n \n This reader answers \"what is price X\", nothing more. It is correct for resolving the price of an\n * ALREADY-PERSISTED subscription item, where the product↔price pairing was decided (and validated)\n * when the item was written. It is NOT correct for a purchase path where the caller names a product\n * and a price in the same request: there the pairing is the thing an attacker controls, and reading\n * the two independently is precisely the defect {@link assertPriceBelongsToProduct} closes.\n /\nexport async function readPriceById(\n priceId: string,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<any> {\n const priceRepo = utils.repositoriesRegistry.getRepository(CoreResourceType.PRICES);\n if (!priceRepo) {\n throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRICE_NOT_FOUND,\n context: { priceId },\n });\n }\n const price = await priceRepo.read(await createCatalogReadContext(CoreResourceType.PRICES, executionContext, utils), priceId);\n if (!price) {\n throw utils.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRICE_NOT_FOUND,\n context: { priceId },\n });\n }\n return price;\n}\n\n/\n Refuse a price that does not belong to the product it is being purchased against.\n \n ## Why this has to exist\n \n `Price.productId` is a declared foreign key — every price already knows its product. Every\n * purchase path nevertheless resolved the two INDEPENDENTLY (product by key, price by id) and\n * checked only that the price had a `providerPriceId`. The FK was never consulted.\n \n The consequence is a split between what is CHARGED and what is GRANTED. The provider is billed\n * `price.providerPriceId`, while the local subscription item records `productId: product._id`, and\n * entitlements (feature sync, plan tier, credit pack size) derive from the ITEM's product. So a\n * caller who pairs the premium product key with a cheap product's price id is billed the cheap\n * price and entitled at the premium product — an authorization outcome purchased at the wrong\n * amount, with both sides internally consistent and nothing downstream able to notice.\n \n ## Why a combined reader rather than a check at each site\n \n The three purchase paths (OPEN_CHECKOUT, CHANGE_PLAN, ADD_ADDON) are edited in different sessions\n * and each had the same omission. {@link readPriceForProduct} is the shape that makes the invariant\n * unbypassable for the next one: resolving a price in a product context and validating the pairing\n * are one call, so a new purchase path cannot obtain the price without the check having run.\n \n @param price - The price row, as read from the catalog.\n * @param product - The product row the purchase names.\n * @throws `VALIDATION` (400, `BILLING_PRICE_PRODUCT_MISMATCH`) when `price.productId !== product._id`.\n /\nexport function assertPriceBelongsToProduct(\n price: any,\n product: any,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): void {\n if (price?.productId === product?._id) return;\n\n throw utils.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRICE_PRODUCT_MISMATCH,\n context: {\n priceId: price?._id,\n priceProductId: price?.productId ?? null,\n productId: product?._id,\n productKey: product?.key,\n },\n });\n}\n\n/\n Read a price and prove it belongs to the given product, in one step.\n \n The safe reader for every path where the caller names a product AND a price. See\n * {@link assertPriceBelongsToProduct} for what goes wrong when the two are resolved independently.\n /\nexport async function readPriceForProduct(\n priceId: string,\n product: any,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<any> {\n const price = await readPriceById(priceId, executionContext, utils);\n assertPriceBelongsToProduct(price, product, executionContext, utils);\n /\n * A retired PRICE is refused here and nowhere else, and that placement is the whole argument.\n \n All three callers of this reader are acquisitions (OPEN_CHECKOUT, CHANGE_PLAN, ADD_ADDON) —\n * that is what the reader is FOR, per its own doc above — so the gate needs no intent argument\n * and cannot be reached by a reference read. `readPriceById`, which resolves the price of an\n * already-persisted subscription item, is deliberately left ungated: a subscriber on a retired\n * plan rebuilds their provider item list through it on every add-on change, and refusing there\n * would break the customer the retirement was supposed to leave alone.\n \n The catalogue-retirement sweep deactivates a retired product's prices alongside the product, so\n * in practice this fires together with the product gate; it is separate because an operator may\n * also retire a single price (a currency, an interval) while the product stays on sale.\n /\n if (price?.isActive === false) {\n throw utils.errorBuilder.buildError(ErrorType.CONFLICT, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_RETIRED,\n context: { priceId, productId: product?._id, productKey: product?.key },\n });\n }\n return price;\n}\n\n// ── Promotion resolution ────────────────────────────────────────────\n\n/\n Read an active promotion from the repository by its user-facing code.\n * Returns null if no active promotion with that code exists.\n /\nexport async function readPromotionByCode(\n code: string,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<any> {\n const promoRepo = utils.repositoriesRegistry.getRepository(CoreResourceType.PROMOTIONS);\n if (!promoRepo) return null;\n const promotion = await promoRepo.read(await createCatalogReadContext(CoreResourceType.PROMOTIONS, executionContext, utils), { code, isActive: true });\n return promotion ?? null;\n}\n\n// ── Billing account dependent scan (hard-delete guard) ──────────────\n\n/\n The retained financial child families that pin a billing account in place.\n \n Typed against `BillingResolvedVariants` so a rename of any variant field breaks the build\n * here rather than silently dropping a family from the guard.\n /\nexport type BillingAccountDependentFamily = Extract<\n keyof BillingResolvedVariants,\n 'subscription' \| 'invoiceRef' \| 'usageRecord' \| 'creditPool'\n>;\n\n/\n Canonical ORDER of the billing child families. Order only — membership is derived below.\n \n Kept as an explicit tuple so the guard's scan order (and the report a human reads when a delete\n * is refused) is stable and mirrors the registry's declaration order, rather than depending on\n * however the relationship array happens to be arranged.\n /\nconst BILLING_ACCOUNT_DEPENDENT_FAMILY_ORDER: readonly BillingAccountDependentFamily[] = [\n 'subscription',\n 'invoiceRef',\n 'usageRecord',\n 'creditPool',\n] as const;\n\n/\n Every child family whose rows are RETAINED when their billing account is deleted.\n \n DERIVED from the registry, not restated. This used to be a hand-maintained list with a comment\n * asking a human to keep it in lock-step with `resources-registry.shared.core.definitions.ts` — the\n * exact coupling that rots, because the two live in different packages and nothing failed when they\n * disagreed. A family whose cascade is re-ENABLED now drops out of this list automatically (it is\n * no longer retained, so it no longer pins the account), and a family that stops being declared\n * disappears with it.\n \n The derivation asks the registry one question: for each `BillingAccounts → <child>` COMPOSITION\n * edge, is `onParentDelete` disabled? Disabled means \"these rows survive their parent\", which is\n * precisely what makes them a dependent that blocks a hard delete.\n \n Note this reads the BILLING-ACCOUNT edges specifically, not the scope edges. Both are disabled by\n * the same decision, but it is the account-parent edge that this guard is about.\n /\nexport const BILLING_ACCOUNT_DEPENDENT_FAMILIES: readonly BillingAccountDependentFamily[] =\n deriveRetainedBillingAccountDependentFamilies();\n\nfunction deriveRetainedBillingAccountDependentFamilies(): readonly BillingAccountDependentFamily[] {\n const billingAccountResourceTypes = new Set<string>(\n Object.values(BILLING_SCOPE_TO_VARIANTS).map((variants) => variants.billingAccount as string),\n );\n\n // child resource type → family key, across BOTH scope variants.\n const childResourceTypeToFamily = new Map<string, BillingAccountDependentFamily>();\n for (const variants of Object.values(BILLING_SCOPE_TO_VARIANTS)) {\n for (const family of BILLING_ACCOUNT_DEPENDENT_FAMILY_ORDER) {\n childResourceTypeToFamily.set(variants[family] as string, family);\n }\n }\n\n const retained = new Set<BillingAccountDependentFamily>();\n for (const relationship of coreSharedResourceRelationship) {\n if (relationship.nature !== RelationshipNature.COMPOSITION) continue;\n if (!billingAccountResourceTypes.has(relationship.resourceType1 as string)) continue;\n // Disabled (or absent) cascade == the child survives its parent == a retained dependent.\n if (relationship.childOperations?.lifecycle?.onParentDelete?.enabled === true) continue;\n\n const family = childResourceTypeToFamily.get(relationship.resourceType2 as string);\n if (family) retained.add(family);\n }\n\n return BILLING_ACCOUNT_DEPENDENT_FAMILY_ORDER.filter((family) => retained.has(family));\n}\n\n/\n Refuse hard removal of a billing account while retained financial children still reference it.\n \n ## Why this guard exists\n \n The billing-retention decision (2026-07-29) disabled `onParentDelete` on all 18 billing\n * cascades, so subscriptions / invoice refs / usage records / credit pools SURVIVE the deletion\n * of their scope and of their billing account. That made a direct hard delete of the account the\n * only remaining way to strand those retained rows behind a dangling FK.\n \n The damage is not merely referential: `providerCustomerId` is `.isBackendOnly()` and lives ONLY\n * on the account row. The children carry `providerInvoiceId` / `providerSubscriptionId` but NOT\n * the provider CUSTOMER id — so deleting the account destroys the only local key that maps a\n * retained invoice back to the customer it was billed to. A financial record that cannot be\n * reconciled against the provider defeats the purpose of retaining it. Nothing provider-side is\n * cleaned up on delete either, so the provider record lives on regardless.\n \n ## Why it fails closed\n \n The operation is `riskLevel: CRITICAL` and guards a compliance obligation, so \"cannot verify\"\n * must never read as \"nothing found\". A missing child repository raises `CONFIGURATION` rather\n * than being skipped, and any scope-filter failure inside the reads propagates instead of being\n * swallowed.\n \n The product off-boarding path is the soft retire (`isActive: false`), which this does not touch.\n \n Detection uses `read()` rather than `count()` deliberately: none of the four child families\n * declares a `COUNT` core operation, so `repository.count()` would throw INTERNAL. All four\n * declare `READ`. Each read is a single indexed hit on the billing-account FK, and the FK is\n * globally unique, so the result is correct regardless of how the execution context scopes it.\n \n @param billingAccountId - The account row about to be hard-deleted.\n * @param variants - Resolved polymorphic variants for the account's scope (org or user).\n * @throws `CONFLICT` (409, `BILLING_ACCOUNT_HAS_DEPENDENTS`) listing every blocking family.\n * @throws `CONFIGURATION` when a child family's repository is not registered (unverifiable).\n /\nexport async function assertNoBillingAccountDependents(\n billingAccountId: string,\n variants: BillingResolvedVariants,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<void> {\n const dependentFilter = { [variants.billingAccountFkField]: billingAccountId };\n\n const blockingFamilies = (\n await Promise.all(\n BILLING_ACCOUNT_DEPENDENT_FAMILIES.map(async (family) => {\n const childResourceType = variants[family];\n const childRepository = utils.repositoriesRegistry.getRepository(childResourceType);\n\n // Fail closed: an unregistered child repository means we cannot prove the family is\n // empty. Skipping it would silently downgrade the guard to \"nothing found\".\n if (!childRepository) {\n throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.CONFIGURATION,\n context: {\n message: 'Cannot verify billing-account dependents: child repository is not registered',\n billingAccountId,\n dependentFamily: family,\n childResourceType,\n },\n });\n }\n\n const existingChild = await childRepository.read(executionContext, dependentFilter);\n return existingChild ? family : undefined;\n }),\n )\n ).filter((family): family is BillingAccountDependentFamily => family !== undefined);\n\n if (blockingFamilies.length > 0) {\n throw utils.errorBuilder.buildError(ErrorType.CONFLICT, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_ACCOUNT_HAS_DEPENDENTS,\n context: {\n billingAccountId,\n blockingDependentFamilies: blockingFamilies,\n blockingResourceTypes: blockingFamilies.map((family) => variants[family]),\n },\n });\n }\n}\n\n// ── Provider validation ─────────────────────────────────────────────\n\n/\n Validate that a subscription has a provider subscription ID.\n /\nexport function validateProviderSubscription(\n subscription: any,\n subscriptionId: string,\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): void {\n if (!subscription?.providerSubscriptionId) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_NO_PROVIDER_SUBSCRIPTION,\n context: { subscriptionId },\n });\n }\n}\n\n// ── Provider item resolution ────────────────────────────────────────\n\n/\n Resolve the providerPriceId for each subscription item by reading prices.\n */\nexport async function resolveProviderItems(\n items: any[],\n executionContext: ExecutionContext<any>,\n utils: ResourceOperation_CustomImplementation_Utils,\n): Promise<Array<{ providerSubscriptionItemId?: string; providerPriceId: string; quantity: number }>> {\n return Promise.all(\n items.map(async (item: any) => {\n const price = await readPriceById(item.priceId, executionContext, utils);\n return {\n providerSubscriptionItemId: item.providerSubscriptionItemId,\n providerPriceId: price.providerPriceId \|\| item.priceId,\n quantity: item.quantity,\n };\n }),\n );\n}\n"]}

package/dist/esm/billing/services/custom-impl/billing-custom-implementations.backend.d.ts CHANGED Viewed

@@ -23,11 +23,31 @@ import type { BillingStateBackendService } from '../../../billing/services/back-
  * Called from start-application after the billing provider is resolved.
  * Must be called before any billing custom operation executes.
  */
-export declare function initializeBillingCustomImplementations(provider: StandardBilling_Interface, featureSyncService: BillingFeatureSyncBackendService, billingStateService: BillingStateBackendService, billingConfig: BillingConfiguration, errorBuilder: ErrorBuilderBackendService): void;
+export declare function initializeBillingCustomImplementations(provider: StandardBilling_Interface, featureSyncService: BillingFeatureSyncBackendService, billingStateService: BillingStateBackendService, billingConfig: BillingConfiguration, errorBuilder: ErrorBuilderBackendService, providerRef: string): void;
 /**
  * Set the WebSocket service for credit pool post-op event emission.
  * Called from start-application after WebSocket service is resolved.
  */
+/**
+ * Publish the usage-metering service for the post-operation usage hook (#415).
+ *
+ * A module-level seam rather than a DI edge, deliberately and for the same reason the WebSocket
+ * service beside it uses one: `UsageMeteringBackendService` injects
+ * `ServicesRegistryHandlerService`, and the hook lives ON that handler — so injecting the metering
+ * service there would be a container cycle.
+ *
+ * It also gives the right behaviour for free: an application with no billing configured never calls
+ * this, `getUsageMeteringService()` returns `null`, and the hook costs one null check per write
+ * instead of resolving a service that would refuse anyway.
+ */
+export declare function setUsageMeteringService(usageMeteringService: import('../../../billing/services/back-office/usage-metering.backend.service').UsageMeteringBackendService): void;
+/**
+ * The usage-metering service, or `null` when billing is not configured.
+ *
+ * `null` rather than a throw, unlike `getBillingProvider()`: a write on a resource that declares no
+ * metered usage must not be able to fail because billing is absent, and the caller checks.
+ */
+export declare function getUsageMeteringService(): import('../../../billing/services/back-office/usage-metering.backend.service').UsageMeteringBackendService | null;
 export declare function setBillingWebSocketService(webSocketService: import('../../../requests/service/websocket.service').WebSocketService): void;
 /**
  * Get the WebSocket service (optional — returns null if not initialized).
@@ -38,6 +58,15 @@ export declare function getWebSocketService(): import('../../../requests/service
  * @throws if initializeBillingCustomImplementations() has not been called
  */
 export declare function getBillingProvider(): StandardBilling_Interface;
+/**
+ * The provider ref the billing adapter was resolved under. Rows that record which provider
+ * owns a customer (`providerRef` on billing accounts) take it from HERE — never from a literal
+ * default: `config.providerRef || 'stripe'` stood at that site until 2026-09-05 (#327), a branch
+ * on a provider ref that the guard test could not see and that would have stamped every row
+ * 'stripe' under any other billing adapter.
+ * @throws if initializeBillingCustomImplementations() has not been called
+ */
+export declare function getBillingProviderRef(): string;
 /**
  * Get the feature sync service (lazy — resolved at operation execution time).
  * @throws if initializeBillingCustomImplementations() has not been called

package/dist/esm/billing/services/custom-impl/billing-custom-implementations.backend.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"billing-custom-implementations.backend.d.ts","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/billing-custom-implementations.backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,6FAA6F,CAAC;AAEzJ,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,4GAA4G,CAAC;AAC7K,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AACnH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sFAAsF,CAAC;AAC7I,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+EAA+E,CAAC;~~AA8ChI~~;;;;GAIG;AACH,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,yBAAyB,EACnC,kBAAkB,EAAE,gCAAgC,EACpD,mBAAmB,EAAE,0BAA0B,EAC/C,aAAa,EAAE,oBAAoB,EACnC,YAAY,EAAE,0BAA0B,~~GACvC~~,IAAI,~~CAMN~~;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,OAAO,uDAAuD,EAAE,gBAAgB,GACjG,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,uDAAuD,EAAE,gBAAgB,GAAG,IAAI,CAE7H;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,yBAAyB,CAO9D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,gCAAgC,CAOxE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,0BAA0B,CAOnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,oBAAoB,CAOvD;AAID,eAAO,MAAM,4BAA4B,EAAE,0CAA0C,EAqBpF,CAAC;AAUF;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,gBAAgB,EAAE,qCAAqC,GACtD,IAAI,CAwCN"}
1	+ {"version":3,"file":"billing-custom-implementations.backend.d.ts","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/billing-custom-implementations.backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEtF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,6FAA6F,CAAC;AAEzJ,OAAO,KAAK,EAAE,0CAA0C,EAAE,MAAM,4GAA4G,CAAC;AAC7K,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AACnH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sFAAsF,CAAC;AAC7I,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,+EAA+E,CAAC;AAiDhI;;;;GAIG;AACH,wBAAgB,sCAAsC,CACpD,QAAQ,EAAE,yBAAyB,EACnC,kBAAkB,EAAE,gCAAgC,EACpD,mBAAmB,EAAE,0BAA0B,EAC/C,aAAa,EAAE,oBAAoB,EACnC,YAAY,EAAE,0BAA0B,EACxC,WAAW,EAAE,MAAM,GAClB,IAAI,CAON;AAED;;;GAGG;AACH;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,oBAAoB,EAAE,OAAO,gFAAgF,EAAE,2BAA2B,GACzI,IAAI,CAEN;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,IACrC,OAAO,gFAAgF,EAAE,2BAA2B,GAAG,IAAI,CAE5H;AAED,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,OAAO,uDAAuD,EAAE,gBAAgB,GACjG,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,uDAAuD,EAAE,gBAAgB,GAAG,IAAI,CAE7H;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,yBAAyB,CAO9D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAO9C;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,gCAAgC,CAOxE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,0BAA0B,CAOnE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,oBAAoB,CAOvD;AAID,eAAO,MAAM,4BAA4B,EAAE,0CAA0C,EAqBpF,CAAC;AAUF;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,gBAAgB,EAAE,qCAAqC,GACtD,IAAI,CAwCN"}

package/dist/esm/billing/services/custom-impl/billing-custom-implementations.backend.js CHANGED Viewed

@@ -22,8 +22,11 @@ let _billingProvider = null;
 let _featureSyncService = null;
 let _billingStateService = null;
 let _billingConfig = null;
+/** The ref the billing provider was RESOLVED under at startup — the one rows are stamped with. */
+let _billingProviderRef = null;
 let _errorBuilder = null;
 let _webSocketService = null;
+let _usageMeteringService = null;
 /** Throw a CONFIGURATION WildoError_Backend, or fall back to plain Error if error builder itself isn't initialized yet. */
 function throwBillingNotInitialized(message) {
     if (_errorBuilder) {
@@ -39,8 +42,9 @@ function throwBillingNotInitialized(message) {
  * Called from start-application after the billing provider is resolved.
  * Must be called before any billing custom operation executes.
  */
-export function initializeBillingCustomImplementations(provider, featureSyncService, billingStateService, billingConfig, errorBuilder) {
+export function initializeBillingCustomImplementations(provider, featureSyncService, billingStateService, billingConfig, errorBuilder, providerRef) {
     _billingProvider = provider;
+    _billingProviderRef = providerRef;
     _featureSyncService = featureSyncService;
     _billingStateService = billingStateService;
     _billingConfig = billingConfig;
@@ -50,6 +54,30 @@ export function initializeBillingCustomImplementations(provider, featureSyncServ
  * Set the WebSocket service for credit pool post-op event emission.
  * Called from start-application after WebSocket service is resolved.
  */
+/**
+ * Publish the usage-metering service for the post-operation usage hook (#415).
+ *
+ * A module-level seam rather than a DI edge, deliberately and for the same reason the WebSocket
+ * service beside it uses one: `UsageMeteringBackendService` injects
+ * `ServicesRegistryHandlerService`, and the hook lives ON that handler — so injecting the metering
+ * service there would be a container cycle.
+ *
+ * It also gives the right behaviour for free: an application with no billing configured never calls
+ * this, `getUsageMeteringService()` returns `null`, and the hook costs one null check per write
+ * instead of resolving a service that would refuse anyway.
+ */
+export function setUsageMeteringService(usageMeteringService) {
+    _usageMeteringService = usageMeteringService;
+}
+/**
+ * The usage-metering service, or `null` when billing is not configured.
+ *
+ * `null` rather than a throw, unlike `getBillingProvider()`: a write on a resource that declares no
+ * metered usage must not be able to fail because billing is absent, and the caller checks.
+ */
+export function getUsageMeteringService() {
+    return _usageMeteringService;
+}
 export function setBillingWebSocketService(webSocketService) {
     _webSocketService = webSocketService;
 }
@@ -69,6 +97,20 @@ export function getBillingProvider() {
     }
     return _billingProvider;
 }
+/**
+ * The provider ref the billing adapter was resolved under. Rows that record which provider
+ * owns a customer (`providerRef` on billing accounts) take it from HERE — never from a literal
+ * default: `config.providerRef || 'stripe'` stood at that site until 2026-09-05 (#327), a branch
+ * on a provider ref that the guard test could not see and that would have stamped every row
+ * 'stripe' under any other billing adapter.
+ * @throws if initializeBillingCustomImplementations() has not been called
+ */
+export function getBillingProviderRef() {
+    if (!_billingProviderRef) {
+        throwBillingNotInitialized('Billing provider ref not initialized — initializeBillingCustomImplementations() must be called first');
+    }
+    return _billingProviderRef;
+}
 /**
  * Get the feature sync service (lazy — resolved at operation execution time).
  * @throws if initializeBillingCustomImplementations() has not been called

package/dist/esm/billing/services/custom-impl/billing-custom-implementations.backend.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"billing-custom-implementations.backend.js","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/billing-custom-implementations.backend.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Billing Custom Implementations — Aggregator + Late-Binding Setup\n \n Exports all billing resource custom implementations for registration\n * in CoreBackend_ServiceImplementationsFactories.\n \n Uses late-binding for the billing provider and feature sync service:\n * - Factory functions are registered at startup (before billing is initialized)\n * - Handler functions execute at operation time (after billing is initialized)\n * - initializeBillingCustomImplementations() must be called during billing setup\n \n @see billing-polymorphic-full-implementation.md §4.4\n /\n\nimport type { StandardBilling_Interface } from '@wildo-ai/external-connectors-models';\nimport { CoreResourceType, CoreWebSocketEvent, ResourcePrimaryScope, ErrorType, ErrorCustomMessageReference } from '@wildo-ai/saas-models';\nimport type { BillingConfiguration } from '@wildo-ai/saas-models';\nimport type { ServicesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/services/services-registry-handler.backend.service';\nimport { BILLING_SCOPE_TO_VARIANTS, CREDIT_POOL_VARIANT_TYPES, resolveBillingVariantsFromResourceType } from '~wildo-backend-lib/billing/services/custom-impl/billing-custom-impl-utils.backend';\nimport type { ResourceCustomServiceImplementationFactory } from '~wildo-backend-lib/base-classes/services/services/resource-operation-custom-implementation.factory.backend';\nimport type { ErrorBuilderBackendService } from '~wildo-backend-lib/errors/services/error-builder.backend.service';\nimport type { BillingFeatureSyncBackendService } from '~wildo-backend-lib/billing/services/back-office/billing-feature-sync.backend.service';\nimport type { BillingStateBackendService } from '~wildo-backend-lib/billing/services/back-office/billing-state.backend.service';\nimport {\n createSubscriptionCancelFactories,\n createSubscriptionResumeFactories,\n createSubscriptionChangePlanFactories,\n createSubscriptionAddAddonFactories,\n createSubscriptionRemoveAddonFactories,\n} from '~wildo-backend-lib/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service';\nimport {\n createBillingAccountCreateFactories,\n createBillingAccountDeleteDependentsGuardFactories,\n createBillingAccountOpenCheckoutFactories,\n createBillingAccountOpenPortalFactories,\n createBillingAccountGetStateFactories,\n} from '~wildo-backend-lib/billing/services/custom-impl/billing-account.mutations.custom-impl.backend.service';\nimport {\n createCreditPoolConsumeFactories,\n createCreditPoolTopUpFactories,\n} from '~wildo-backend-lib/billing/services/custom-impl/credit-pool.custom-ops.custom-impl.backend.service';\nimport {\n createPromotionCreateFactory,\n createPromotionApplyFactory,\n createPromotionDeactivateFactory,\n createPromotionDeactivateBulkFactory,\n} from '~wildo-backend-lib/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service';\n\n// ── Late-Binding References ──────────────────────────────────────────\n\nlet _billingProvider: StandardBilling_Interface \| null = null;\nlet _featureSyncService: BillingFeatureSyncBackendService \| null = null;\nlet _billingStateService: BillingStateBackendService \| null = null;\nlet _billingConfig: BillingConfiguration \| null = null;\nlet _errorBuilder: ErrorBuilderBackendService \| null = null;\nlet _webSocketService: import('~wildo-backend-lib/requests/service/websocket.service').WebSocketService \| null = null;\n\n/* Throw a CONFIGURATION WildoError_Backend, or fall back to plain Error if error builder itself isn't initialized yet. /\nfunction throwBillingNotInitialized(message: string): never {\n if (_errorBuilder) {\n throw _errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {\n customMessageReference: ErrorCustomMessageReference.CONFIGURATION,\n context: { message },\n });\n }\n throw new Error(message);\n}\n\n/\n Initialize billing custom implementation dependencies.\n * Called from start-application after the billing provider is resolved.\n * Must be called before any billing custom operation executes.\n /\nexport function initializeBillingCustomImplementations(\n provider: StandardBilling_Interface,\n featureSyncService: BillingFeatureSyncBackendService,\n billingStateService: BillingStateBackendService,\n billingConfig: BillingConfiguration,\n errorBuilder: ErrorBuilderBackendService,\n): void {\n _billingProvider = provider;\n _featureSyncService = featureSyncService;\n _billingStateService = billingStateService;\n _billingConfig = billingConfig;\n _errorBuilder = errorBuilder;\n}\n\n/\n Set the WebSocket service for credit pool post-op event emission.\n * Called from start-application after WebSocket service is resolved.\n /\nexport function setBillingWebSocketService(\n webSocketService: import('~wildo-backend-lib/requests/service/websocket.service').WebSocketService,\n): void {\n _webSocketService = webSocketService;\n}\n\n/\n Get the WebSocket service (optional — returns null if not initialized).\n /\nexport function getWebSocketService(): import('~wildo-backend-lib/requests/service/websocket.service').WebSocketService \| null {\n return _webSocketService;\n}\n\n/\n Get the billing provider (lazy — resolved at operation execution time).\n * @throws if initializeBillingCustomImplementations() has not been called\n /\nexport function getBillingProvider(): StandardBilling_Interface {\n if (!_billingProvider) {\n throwBillingNotInitialized(\n 'Billing provider not initialized — initializeBillingCustomImplementations() must be called first',\n );\n }\n return _billingProvider;\n}\n\n/\n Get the feature sync service (lazy — resolved at operation execution time).\n * @throws if initializeBillingCustomImplementations() has not been called\n /\nexport function getFeatureSyncService(): BillingFeatureSyncBackendService {\n if (!_featureSyncService) {\n throwBillingNotInitialized(\n 'Feature sync service not initialized — initializeBillingCustomImplementations() must be called first',\n );\n }\n return _featureSyncService;\n}\n\n/\n Get the billing state service (lazy — resolved at operation execution time).\n * @throws if initializeBillingCustomImplementations() has not been called\n /\nexport function getBillingStateService(): BillingStateBackendService {\n if (!_billingStateService) {\n throwBillingNotInitialized(\n 'Billing state service not initialized — initializeBillingCustomImplementations() must be called first',\n );\n }\n return _billingStateService;\n}\n\n/\n Get the billing configuration (lazy — resolved at operation execution time).\n * @throws if initializeBillingCustomImplementations() has not been called\n /\nexport function getBillingConfig(): BillingConfiguration {\n if (!_billingConfig) {\n throwBillingNotInitialized(\n 'Billing config not initialized — initializeBillingCustomImplementations() must be called first',\n );\n }\n return _billingConfig;\n}\n\n// ── All billing custom implementation factories ──────────────────────\n\nexport const billingCustomImplementations: ResourceCustomServiceImplementationFactory[] = [\n // Subscription operations\n ...createSubscriptionCancelFactories(),\n ...createSubscriptionResumeFactories(),\n ...createSubscriptionChangePlanFactories(),\n ...createSubscriptionAddAddonFactories(),\n ...createSubscriptionRemoveAddonFactories(),\n // Billing account operations\n ...createBillingAccountCreateFactories(),\n ...createBillingAccountDeleteDependentsGuardFactories(),\n ...createBillingAccountOpenCheckoutFactories(),\n ...createBillingAccountOpenPortalFactories(),\n ...createBillingAccountGetStateFactories(),\n // Credit pool operations\n ...createCreditPoolConsumeFactories(),\n ...createCreditPoolTopUpFactories(),\n // Promotion operations\n createPromotionCreateFactory(),\n createPromotionApplyFactory(),\n createPromotionDeactivateFactory(),\n createPromotionDeactivateBulkFactory(),\n];\n\n// ── Post-operation hook registration ─────────────────────────────────\n\n/* All subscription polymorphic variant types. /\nconst SUBSCRIPTION_VARIANT_TYPES: readonly string[] = [\n CoreResourceType.ORGANIZATION_SUBSCRIPTIONS,\n CoreResourceType.USER_SUBSCRIPTIONS,\n];\n\n/\n Register post-operation hooks on subscription variant types.\n * After any successful mutation on a subscription, triggers feature sync\n * to recompute billing-derived features from current subscription state.\n \n This replaces explicit feature sync calls in subscription custom impls\n * and the webhook event router — the hook fires automatically.\n */\nexport function registerBillingPostOperationHooks(\n servicesRegistry: ServicesRegistryHandlerBackendService,\n): void {\n for (const subscriptionType of SUBSCRIPTION_VARIANT_TYPES) {\n servicesRegistry.registerPostOperationHook(subscriptionType, async (resourceType, _operationIdentifier, result, _executionContext) => {\n const variants = resolveBillingVariantsFromResourceType(resourceType);\n if (!variants) return;\n\n const billingAccountId = result?.[variants.billingAccountFkField] as string \| undefined;\n if (!billingAccountId) return;\n\n const featureSyncService = getFeatureSyncService();\n await featureSyncService.onSubscriptionChanged(billingAccountId, variants);\n });\n }\n\n for (const creditPoolType of CREDIT_POOL_VARIANT_TYPES) {\n servicesRegistry.registerPostOperationHook(creditPoolType, async (resourceType, _operationIdentifier, result, executionContext) => {\n const ws = getWebSocketService();\n if (!ws) return;\n\n const variants = resolveBillingVariantsFromResourceType(resourceType);\n if (!variants) return;\n\n const billingAccountId = result?.[variants.billingAccountFkField] as string \| undefined;\n if (!billingAccountId) return;\n\n const scopeEntityId = executionContext[variants.scopeKey] as string \| undefined;\n if (!scopeEntityId) return;\n\n const message = {\n type: CoreWebSocketEvent.BILLING_CREDIT_POOL_UPDATED,\n payload: { scopeType: variants.scopeType, scopeEntityId, billingAccountId },\n timestamp: new Date(),\n };\n\n switch (variants.scopeType) {\n case ResourcePrimaryScope.ORGANIZATIONS: await ws.sendToOrganization(scopeEntityId, message); break;\n case ResourcePrimaryScope.USER_SELF: await ws.sendToUser(scopeEntityId, message); break;\n }\n });\n }\n}\n"]}
1	+ {"version":3,"file":"billing-custom-implementations.backend.js","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/billing-custom-implementations.backend.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Billing Custom Implementations — Aggregator + Late-Binding Setup\n \n Exports all billing resource custom implementations for registration\n * in CoreBackend_ServiceImplementationsFactories.\n \n Uses late-binding for the billing provider and feature sync service:\n * - Factory functions are registered at startup (before billing is initialized)\n * - Handler functions execute at operation time (after billing is initialized)\n * - initializeBillingCustomImplementations() must be called during billing setup\n \n @see billing-polymorphic-full-implementation.md §4.4\n /\n\nimport type { StandardBilling_Interface } from '@wildo-ai/external-connectors-models';\nimport { CoreResourceType, CoreWebSocketEvent, ResourcePrimaryScope, ErrorType, ErrorCustomMessageReference } from '@wildo-ai/saas-models';\nimport type { BillingConfiguration } from '@wildo-ai/saas-models';\nimport type { ServicesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/services/services-registry-handler.backend.service';\nimport { BILLING_SCOPE_TO_VARIANTS, CREDIT_POOL_VARIANT_TYPES, resolveBillingVariantsFromResourceType } from '~wildo-backend-lib/billing/services/custom-impl/billing-custom-impl-utils.backend';\nimport type { ResourceCustomServiceImplementationFactory } from '~wildo-backend-lib/base-classes/services/services/resource-operation-custom-implementation.factory.backend';\nimport type { ErrorBuilderBackendService } from '~wildo-backend-lib/errors/services/error-builder.backend.service';\nimport type { BillingFeatureSyncBackendService } from '~wildo-backend-lib/billing/services/back-office/billing-feature-sync.backend.service';\nimport type { BillingStateBackendService } from '~wildo-backend-lib/billing/services/back-office/billing-state.backend.service';\nimport {\n createSubscriptionCancelFactories,\n createSubscriptionResumeFactories,\n createSubscriptionChangePlanFactories,\n createSubscriptionAddAddonFactories,\n createSubscriptionRemoveAddonFactories,\n} from '~wildo-backend-lib/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service';\nimport {\n createBillingAccountCreateFactories,\n createBillingAccountDeleteDependentsGuardFactories,\n createBillingAccountOpenCheckoutFactories,\n createBillingAccountOpenPortalFactories,\n createBillingAccountGetStateFactories,\n} from '~wildo-backend-lib/billing/services/custom-impl/billing-account.mutations.custom-impl.backend.service';\nimport {\n createCreditPoolConsumeFactories,\n createCreditPoolTopUpFactories,\n} from '~wildo-backend-lib/billing/services/custom-impl/credit-pool.custom-ops.custom-impl.backend.service';\nimport {\n createPromotionCreateFactory,\n createPromotionApplyFactory,\n createPromotionDeactivateFactory,\n createPromotionDeactivateBulkFactory,\n} from '~wildo-backend-lib/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service';\n\n// ── Late-Binding References ──────────────────────────────────────────\n\nlet _billingProvider: StandardBilling_Interface \| null = null;\nlet _featureSyncService: BillingFeatureSyncBackendService \| null = null;\nlet _billingStateService: BillingStateBackendService \| null = null;\nlet _billingConfig: BillingConfiguration \| null = null;\n/* The ref the billing provider was RESOLVED under at startup — the one rows are stamped with. /\nlet _billingProviderRef: string \| null = null;\nlet _errorBuilder: ErrorBuilderBackendService \| null = null;\nlet _webSocketService: import('~wildo-backend-lib/requests/service/websocket.service').WebSocketService \| null = null;\nlet _usageMeteringService: import('~wildo-backend-lib/billing/services/back-office/usage-metering.backend.service').UsageMeteringBackendService \| null = null;\n\n/* Throw a CONFIGURATION WildoError_Backend, or fall back to plain Error if error builder itself isn't initialized yet. /\nfunction throwBillingNotInitialized(message: string): never {\n if (_errorBuilder) {\n throw _errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {\n customMessageReference: ErrorCustomMessageReference.CONFIGURATION,\n context: { message },\n });\n }\n throw new Error(message);\n}\n\n/\n Initialize billing custom implementation dependencies.\n * Called from start-application after the billing provider is resolved.\n * Must be called before any billing custom operation executes.\n /\nexport function initializeBillingCustomImplementations(\n provider: StandardBilling_Interface,\n featureSyncService: BillingFeatureSyncBackendService,\n billingStateService: BillingStateBackendService,\n billingConfig: BillingConfiguration,\n errorBuilder: ErrorBuilderBackendService,\n providerRef: string,\n): void {\n _billingProvider = provider;\n _billingProviderRef = providerRef;\n _featureSyncService = featureSyncService;\n _billingStateService = billingStateService;\n _billingConfig = billingConfig;\n _errorBuilder = errorBuilder;\n}\n\n/\n Set the WebSocket service for credit pool post-op event emission.\n * Called from start-application after WebSocket service is resolved.\n /\n/\n Publish the usage-metering service for the post-operation usage hook (#415).\n \n A module-level seam rather than a DI edge, deliberately and for the same reason the WebSocket\n * service beside it uses one: `UsageMeteringBackendService` injects\n * `ServicesRegistryHandlerService`, and the hook lives ON that handler — so injecting the metering\n * service there would be a container cycle.\n \n It also gives the right behaviour for free: an application with no billing configured never calls\n * this, `getUsageMeteringService()` returns `null`, and the hook costs one null check per write\n * instead of resolving a service that would refuse anyway.\n /\nexport function setUsageMeteringService(\n usageMeteringService: import('~wildo-backend-lib/billing/services/back-office/usage-metering.backend.service').UsageMeteringBackendService,\n): void {\n _usageMeteringService = usageMeteringService;\n}\n\n/\n The usage-metering service, or `null` when billing is not configured.\n \n `null` rather than a throw, unlike `getBillingProvider()`: a write on a resource that declares no\n * metered usage must not be able to fail because billing is absent, and the caller checks.\n /\nexport function getUsageMeteringService():\n import('~wildo-backend-lib/billing/services/back-office/usage-metering.backend.service').UsageMeteringBackendService \| null {\n return _usageMeteringService;\n}\n\nexport function setBillingWebSocketService(\n webSocketService: import('~wildo-backend-lib/requests/service/websocket.service').WebSocketService,\n): void {\n _webSocketService = webSocketService;\n}\n\n/\n Get the WebSocket service (optional — returns null if not initialized).\n /\nexport function getWebSocketService(): import('~wildo-backend-lib/requests/service/websocket.service').WebSocketService \| null {\n return _webSocketService;\n}\n\n/\n Get the billing provider (lazy — resolved at operation execution time).\n * @throws if initializeBillingCustomImplementations() has not been called\n /\nexport function getBillingProvider(): StandardBilling_Interface {\n if (!_billingProvider) {\n throwBillingNotInitialized(\n 'Billing provider not initialized — initializeBillingCustomImplementations() must be called first',\n );\n }\n return _billingProvider;\n}\n\n/\n The provider ref the billing adapter was resolved under. Rows that record which provider\n * owns a customer (`providerRef` on billing accounts) take it from HERE — never from a literal\n * default: `config.providerRef \|\| 'stripe'` stood at that site until 2026-09-05 (#327), a branch\n * on a provider ref that the guard test could not see and that would have stamped every row\n * 'stripe' under any other billing adapter.\n * @throws if initializeBillingCustomImplementations() has not been called\n /\nexport function getBillingProviderRef(): string {\n if (!_billingProviderRef) {\n throwBillingNotInitialized(\n 'Billing provider ref not initialized — initializeBillingCustomImplementations() must be called first',\n );\n }\n return _billingProviderRef;\n}\n\n/\n Get the feature sync service (lazy — resolved at operation execution time).\n * @throws if initializeBillingCustomImplementations() has not been called\n /\nexport function getFeatureSyncService(): BillingFeatureSyncBackendService {\n if (!_featureSyncService) {\n throwBillingNotInitialized(\n 'Feature sync service not initialized — initializeBillingCustomImplementations() must be called first',\n );\n }\n return _featureSyncService;\n}\n\n/\n Get the billing state service (lazy — resolved at operation execution time).\n * @throws if initializeBillingCustomImplementations() has not been called\n /\nexport function getBillingStateService(): BillingStateBackendService {\n if (!_billingStateService) {\n throwBillingNotInitialized(\n 'Billing state service not initialized — initializeBillingCustomImplementations() must be called first',\n );\n }\n return _billingStateService;\n}\n\n/\n Get the billing configuration (lazy — resolved at operation execution time).\n * @throws if initializeBillingCustomImplementations() has not been called\n /\nexport function getBillingConfig(): BillingConfiguration {\n if (!_billingConfig) {\n throwBillingNotInitialized(\n 'Billing config not initialized — initializeBillingCustomImplementations() must be called first',\n );\n }\n return _billingConfig;\n}\n\n// ── All billing custom implementation factories ──────────────────────\n\nexport const billingCustomImplementations: ResourceCustomServiceImplementationFactory[] = [\n // Subscription operations\n ...createSubscriptionCancelFactories(),\n ...createSubscriptionResumeFactories(),\n ...createSubscriptionChangePlanFactories(),\n ...createSubscriptionAddAddonFactories(),\n ...createSubscriptionRemoveAddonFactories(),\n // Billing account operations\n ...createBillingAccountCreateFactories(),\n ...createBillingAccountDeleteDependentsGuardFactories(),\n ...createBillingAccountOpenCheckoutFactories(),\n ...createBillingAccountOpenPortalFactories(),\n ...createBillingAccountGetStateFactories(),\n // Credit pool operations\n ...createCreditPoolConsumeFactories(),\n ...createCreditPoolTopUpFactories(),\n // Promotion operations\n createPromotionCreateFactory(),\n createPromotionApplyFactory(),\n createPromotionDeactivateFactory(),\n createPromotionDeactivateBulkFactory(),\n];\n\n// ── Post-operation hook registration ─────────────────────────────────\n\n/* All subscription polymorphic variant types. /\nconst SUBSCRIPTION_VARIANT_TYPES: readonly string[] = [\n CoreResourceType.ORGANIZATION_SUBSCRIPTIONS,\n CoreResourceType.USER_SUBSCRIPTIONS,\n];\n\n/\n Register post-operation hooks on subscription variant types.\n * After any successful mutation on a subscription, triggers feature sync\n * to recompute billing-derived features from current subscription state.\n \n This replaces explicit feature sync calls in subscription custom impls\n * and the webhook event router — the hook fires automatically.\n */\nexport function registerBillingPostOperationHooks(\n servicesRegistry: ServicesRegistryHandlerBackendService,\n): void {\n for (const subscriptionType of SUBSCRIPTION_VARIANT_TYPES) {\n servicesRegistry.registerPostOperationHook(subscriptionType, async (resourceType, _operationIdentifier, result, _executionContext) => {\n const variants = resolveBillingVariantsFromResourceType(resourceType);\n if (!variants) return;\n\n const billingAccountId = result?.[variants.billingAccountFkField] as string \| undefined;\n if (!billingAccountId) return;\n\n const featureSyncService = getFeatureSyncService();\n await featureSyncService.onSubscriptionChanged(billingAccountId, variants);\n });\n }\n\n for (const creditPoolType of CREDIT_POOL_VARIANT_TYPES) {\n servicesRegistry.registerPostOperationHook(creditPoolType, async (resourceType, _operationIdentifier, result, executionContext) => {\n const ws = getWebSocketService();\n if (!ws) return;\n\n const variants = resolveBillingVariantsFromResourceType(resourceType);\n if (!variants) return;\n\n const billingAccountId = result?.[variants.billingAccountFkField] as string \| undefined;\n if (!billingAccountId) return;\n\n const scopeEntityId = executionContext[variants.scopeKey] as string \| undefined;\n if (!scopeEntityId) return;\n\n const message = {\n type: CoreWebSocketEvent.BILLING_CREDIT_POOL_UPDATED,\n payload: { scopeType: variants.scopeType, scopeEntityId, billingAccountId },\n timestamp: new Date(),\n };\n\n switch (variants.scopeType) {\n case ResourcePrimaryScope.ORGANIZATIONS: await ws.sendToOrganization(scopeEntityId, message); break;\n case ResourcePrimaryScope.USER_SELF: await ws.sendToUser(scopeEntityId, message); break;\n }\n });\n }\n}\n"]}

package/dist/esm/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service.d.ts CHANGED Viewed

@@ -4,7 +4,8 @@
  * Promotions are APPLICATION-scoped (not polymorphic) — 1 factory per operation.
  *
  * CREATE:     PREFIX syncs coupon to billing provider → core CREATE writes to DB with provider IDs
- * APPLY:      REPLACE validates the promotion + records redemption. No standard CRUD equivalent.
+ * APPLY:      REPLACE validates the promotion and reports its discount. No standard CRUD equivalent,
+ *             and it records NO redemption — completion does (see the factory's docstring).
  * DEACTIVATE: PREFIX returns { isActive: false } → core UPDATE writes to DB
  *
  * @see billing-polymorphic-full-implementation.md §4.6.3 + §4.6.4 + §4.6.5
@@ -28,8 +29,15 @@ export declare function createPromotionCreateFactory(): ResourceCustomServiceImp
 /**
  * Create Promotion APPLY replace factory.
  *
- * Validates the promotion, records a redemption, and returns discount info.
- * The caller (typically OPEN_CHECKOUT) uses the returned discount to pass the coupon to Stripe.
+ * VALIDATES the promotion and returns its discount info. It records NOTHING.
+ *
+ * The redemption is counted when the purchase COMPLETES — `handleCheckoutCompleted`, behind the
+ * durable settlement claim — because entering a code is not redeeming one. See the block where the
+ * increment used to be for the full reasoning, including why leaving it here would double-count.
+ *
+ * The docstring here previously said "the caller (typically OPEN_CHECKOUT)". `OPEN_CHECKOUT` has
+ * never called this verb: it re-validates a supplied code inline. This is a CLIENT-facing verb, for
+ * a purchase form that wants to show the discount before the customer commits.
  */
 export declare function createPromotionApplyFactory(): ResourceCustomServiceImplementationFactory;
 /**

package/dist/esm/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"promotion.custom-ops.custom-impl.backend.service.d.ts","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service.ts"],"names":[],"mappings":"AAAA~~;;;;;;;;;;GAUG~~;AAaH,OAAO,EAEL,KAAK,0CAA0C,EAChD,MAAM,4GAA4G,CAAC;AAQpH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,IAAI,0CAA0C,CAiEzF;AAMD~~;;;;;GAKG~~;AACH,wBAAgB,2BAA2B,IAAI,0CAA0C,~~CA+FxF~~;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,IAAI,0CAA0C,CAkB7F;AAED;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,IAAI,0CAA0C,CAmBjG"}
1	+ {"version":3,"file":"promotion.custom-ops.custom-impl.backend.service.d.ts","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,OAAO,EAEL,KAAK,0CAA0C,EAChD,MAAM,4GAA4G,CAAC;AAQpH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,4BAA4B,IAAI,0CAA0C,CAiEzF;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,IAAI,0CAA0C,CA4FxF;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,gCAAgC,IAAI,0CAA0C,CAkB7F;AAED;;;;;;;GAOG;AACH,wBAAgB,oCAAoC,IAAI,0CAA0C,CAmBjG"}

package/dist/esm/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service.js CHANGED Viewed

@@ -4,7 +4,8 @@
  * Promotions are APPLICATION-scoped (not polymorphic) — 1 factory per operation.
  *
  * CREATE:     PREFIX syncs coupon to billing provider → core CREATE writes to DB with provider IDs
- * APPLY:      REPLACE validates the promotion + records redemption. No standard CRUD equivalent.
+ * APPLY:      REPLACE validates the promotion and reports its discount. No standard CRUD equivalent,
+ *             and it records NO redemption — completion does (see the factory's docstring).
  * DEACTIVATE: PREFIX returns { isActive: false } → core UPDATE writes to DB
  *
  * @see billing-polymorphic-full-implementation.md §4.6.3 + §4.6.4 + §4.6.5
@@ -96,8 +97,15 @@ export function createPromotionCreateFactory() {
 /**
  * Create Promotion APPLY replace factory.
  *
- * Validates the promotion, records a redemption, and returns discount info.
- * The caller (typically OPEN_CHECKOUT) uses the returned discount to pass the coupon to Stripe.
+ * VALIDATES the promotion and returns its discount info. It records NOTHING.
+ *
+ * The redemption is counted when the purchase COMPLETES — `handleCheckoutCompleted`, behind the
+ * durable settlement claim — because entering a code is not redeeming one. See the block where the
+ * increment used to be for the full reasoning, including why leaving it here would double-count.
+ *
+ * The docstring here previously said "the caller (typically OPEN_CHECKOUT)". `OPEN_CHECKOUT` has
+ * never called this verb: it re-validates a supplied code inline. This is a CLIENT-facing verb, for
+ * a purchase form that wants to show the discount before the customer commits.
  */
 export function createPromotionApplyFactory() {
     const factory = (_resourcesRegistryService) => {
@@ -148,19 +156,25 @@ export function createPromotionApplyFactory() {
                             context: { promotionId: _id, reason: 'Code does not match' },
                         });
                     }
-                    // C2: Atomically increment timesRedeemed to prevent race conditions
-                    if (promotion.maxRedemptions !== null && promotion.maxRedemptions !== undefined) {
-                        const result = await utils.repositoriesRegistry.atomicGuardedMutation(CoreResourceType.PROMOTIONS, { _id, timesRedeemed: { $lt: promotion.maxRedemptions } }, { increment: { timesRedeemed: 1 } }, executionContext);
-                        if (!result) {
-                            throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {
-                                customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,
-                                context: { promotionId: _id, reason: 'Maximum redemptions reached' },
-                            });
-                        }
-                    }
-                    else {
-                        await utils.repositoriesRegistry.atomicGuardedMutation(CoreResourceType.PROMOTIONS, { _id }, { increment: { timesRedeemed: 1 } }, executionContext);
-                    }
+                    /*
+                     * COUNTS NOTHING, and that is the change (#518 follow-up).
+                     *
+                     * This used to increment `timesRedeemed` here, guarded by the cap. It was the only place
+                     * a redemption was ever counted, and it counted at the WRONG MOMENT — this verb runs when
+                     * a customer types a code into a purchase form, which is not a redemption. A customer who
+                     * types a code and closes the tab consumed one anyway, so a limited campaign was exhausted
+                     * by window-shoppers.
+                     *
+                     * A redemption is now counted exactly where the money moves: the
+                     * `checkout.session.completed` webhook, behind the durable settlement claim that makes the
+                     * count exactly-once across replicas and retries. Leaving the increment here as well would
+                     * double-count every customer who used this verb and then completed the purchase — the two
+                     * are two views of ONE redemption, not two redemptions.
+                     *
+                     * The cap check above stays, because it is what makes this verb answer honestly: an
+                     * exhausted code must be refused at the moment it is entered, not silently accepted and
+                     * then refused at completion when the customer has already paid.
+                     */
                     // Return discount info for the caller
                     return {
                         valid: true,

package/dist/esm/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"promotion.custom-ops.custom-impl.backend.service.js","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Promotion Custom Operations — CREATE (prefix), APPLY (replace), DEACTIVATE (prefix)\n \n Promotions are APPLICATION-scoped (not polymorphic) — 1 factory per operation.\n \n CREATE: PREFIX syncs coupon to billing provider → core CREATE writes to DB with provider IDs\n * APPLY: REPLACE validates the promotion + records redemption. No standard CRUD equivalent.\n * DEACTIVATE: PREFIX returns { isActive: false } → core UPDATE writes to DB\n \n @see billing-polymorphic-full-implementation.md §4.6.3 + §4.6.4 + §4.6.5\n /\n\nimport {\n CoreResourceType,\n ResourceOperationVariantType,\n CoreResourceOperation,\n ErrorType,\n ErrorCustomMessageReference,\n PromotionType,\n DiscountType,\n PromotionDuration,\n Promotion_Operations,\n} from '@wildo-ai/saas-models';\nimport {\n createResourceCustomServiceImplementation,\n type ResourceCustomServiceImplementationFactory,\n} from '~wildo-backend-lib/base-classes/services/services/resource-operation-custom-implementation.factory.backend';\nimport type { ResourcesRegistryBackendService } from '~wildo-backend-lib/resources/services/resources-registry.backend.service';\nimport { getBillingProvider } from '~wildo-backend-lib/billing/services/custom-impl/billing-custom-implementations.backend';\n\n// ════════════════════════════════════════════════════════════════════\n// CREATE — PREFIX_CORE_OPERATIONS\n// ════════════════════════════════════════════════════════════════════\n\n/\n Create Promotion CREATE prefix factory.\n \n Syncs the coupon (and optionally promotion code) to the billing provider\n * before the core CREATE writes to DB. Augments input with provider IDs.\n \n Registered on `INTERNAL_CALL` — the variant the resource configuration actually declares\n * for CREATE. Same drift class as the billing-account CREATE prefix: authored against\n * `REPOSITORY_ONLY`, orphaned once the configured variant moved, and silent because custom\n * implementations resolve by an EXACT operation-path key embedding `variantType`. Orphaned,\n * the promotion row is persisted with no `providerCouponId` / `providerPromotionId`, and\n * OPEN_CHECKOUT later rejects it as \"not synced to billing provider\". Pinned by\n * `billing-custom-impl-operation-path-coherence.test.ts`.\n /\nexport function createPromotionCreateFactory(): ResourceCustomServiceImplementationFactory {\n const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n return createResourceCustomServiceImplementation({\n operationPath: {\n resourceIdentifier: CoreResourceType.PROMOTIONS,\n operationIdentifier: CoreResourceOperation.CREATE,\n variantType: ResourceOperationVariantType.INTERNAL_CALL,\n isOperationDefault: true,\n },\n handlers: {\n prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n // L5: Validate discount fields match the declared discountType\n if (input.discountType === DiscountType.PERCENTAGE && (input.discountPercentage === undefined \|\| input.discountPercentage === null)) {\n throw utils.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { reason: 'discountPercentage is required for PERCENTAGE discount type' },\n });\n }\n if (input.discountType === DiscountType.FIXED_AMOUNT && !input.discountFixedAmount) {\n throw utils.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { reason: 'discountFixedAmount is required for FIXED_AMOUNT discount type' },\n });\n }\n\n const durationMap: Record<string, 'once' \| 'repeating' \| 'forever'> = {\n [PromotionDuration.ONCE]: 'once',\n [PromotionDuration.REPEATING]: 'repeating',\n [PromotionDuration.FOREVER]: 'forever',\n };\n\n // H1: Provider sync must succeed — throw on failure\n const provider = getBillingProvider();\n const couponResult = await provider.createCoupon({\n ...(input.discountType === DiscountType.PERCENTAGE && { percentOff: input.discountPercentage }),\n ...(input.discountType === DiscountType.FIXED_AMOUNT && input.discountFixedAmount && {\n amountOff: Number(input.discountFixedAmount.amount),\n currency: input.discountFixedAmount.currency,\n }),\n duration: durationMap[input.duration] ?? 'once',\n ...(input.durationInMonths && { durationInMonths: input.durationInMonths }),\n ...(input.maxRedemptions && { maxRedemptions: input.maxRedemptions }),\n ...(input.metadata && { metadata: input.metadata }),\n });\n const providerCouponId = couponResult.providerCouponId;\n\n let providerPromotionId: string \| undefined;\n if (input.type === PromotionType.PROMOTION_CODE && input.code && providerCouponId) {\n const promoResult = await provider.createPromotionCode(providerCouponId, input.code);\n providerPromotionId = promoResult.providerPromotionId;\n }\n\n return {\n ...input,\n providerCouponId,\n providerPromotionId,\n isActive: true,\n timesRedeemed: 0,\n };\n },\n },\n });\n };\n\n return factory as unknown as ResourceCustomServiceImplementationFactory;\n}\n\n// ════════════════════════════════════════════════════════════════════\n// APPLY — REPLACE_CORE_OPERATIONS\n// ════════════════════════════════════════════════════════════════════\n\n/\n Create Promotion APPLY replace factory.\n \n Validates the promotion, records a redemption, and returns discount info.\n * The caller (typically OPEN_CHECKOUT) uses the returned discount to pass the coupon to Stripe.\n /\nexport function createPromotionApplyFactory(): ResourceCustomServiceImplementationFactory {\n const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n return createResourceCustomServiceImplementation({\n operationPath: {\n resourceIdentifier: CoreResourceType.PROMOTIONS,\n operationIdentifier: Promotion_Operations.APPLY,\n variantType: ResourceOperationVariantType.API_CALL,\n isOperationDefault: true,\n },\n handlers: {\n replaceCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n const promotion = utils.currentObject;\n\n // Validate promotion is active\n if (!promotion.isActive) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Promotion is not active' },\n });\n }\n\n // Validate date range\n const now = new Date();\n if (promotion.validFrom && now < new Date(promotion.validFrom)) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Promotion has not started yet' },\n });\n }\n if (promotion.validUntil && now > new Date(promotion.validUntil)) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Promotion has expired' },\n });\n }\n\n // Validate max redemptions\n if (promotion.maxRedemptions !== null && promotion.maxRedemptions !== undefined) {\n if ((promotion.timesRedeemed ?? 0) >= promotion.maxRedemptions) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Maximum redemptions reached' },\n });\n }\n }\n\n // Validate code match (when the promotion has a code)\n if (promotion.code && input.code !== promotion.code) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Code does not match' },\n });\n }\n\n // C2: Atomically increment timesRedeemed to prevent race conditions\n if (promotion.maxRedemptions !== null && promotion.maxRedemptions !== undefined) {\n const result = await utils.repositoriesRegistry.atomicGuardedMutation(\n CoreResourceType.PROMOTIONS,\n { _id, timesRedeemed: { $lt: promotion.maxRedemptions } },\n { increment: { timesRedeemed: 1 } },\n executionContext,\n );\n if (!result) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Maximum redemptions reached' },\n });\n }\n } else {\n await utils.repositoriesRegistry.atomicGuardedMutation(\n CoreResourceType.PROMOTIONS,\n { _id },\n { increment: { timesRedeemed: 1 } },\n executionContext,\n );\n }\n\n // Return discount info for the caller\n return {\n valid: true,\n promotionId: _id,\n providerCouponId: promotion.providerCouponId,\n providerPromotionId: promotion.providerPromotionId,\n discount: {\n type: promotion.discountType,\n ...(promotion.discountType === DiscountType.PERCENTAGE && { percentage: promotion.discountPercentage }),\n ...(promotion.discountType === DiscountType.FIXED_AMOUNT && { amount: promotion.discountFixedAmount }),\n },\n };\n },\n },\n });\n };\n\n return factory as unknown as ResourceCustomServiceImplementationFactory;\n}\n\n// ════════════════════════════════════════════════════════════════════\n// DEACTIVATE — PREFIX_CORE_OPERATIONS\n// ════════════════════════════════════════════════════════════════════\n\n/\n Create Promotion DEACTIVATE prefix factory.\n \n Trivially returns { isActive: false } — core UPDATE writes to DB.\n \n The operation declares `requestDto: z.object({})` (single) / `{ _ids }` (bulk), so `isActive`\n * can ONLY arrive from here. Before that narrowing the verb inherited the resource's full update\n * contract — including `isActive` itself, so \"deactivate\" could re-activate — and this return was\n * MERGED onto the caller payload rather than replacing it, leaving `code`, `discountPercentage`\n * and `maxRedemptions` writable through a route named deactivate.\n /\nexport function createPromotionDeactivateFactory(): ResourceCustomServiceImplementationFactory {\n const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n return createResourceCustomServiceImplementation({\n operationPath: {\n resourceIdentifier: CoreResourceType.PROMOTIONS,\n operationIdentifier: Promotion_Operations.DEACTIVATE,\n variantType: ResourceOperationVariantType.API_CALL,\n isOperationDefault: true,\n },\n handlers: {\n prefixCoreOperations: async () => {\n return { isActive: false };\n },\n },\n });\n };\n\n return factory as unknown as ResourceCustomServiceImplementationFactory;\n}\n\n/\n Create Promotion DEACTIVATE prefix factory — BULK companion (`haveBulkOperation: true`).\n \n A bulk companion is a SEPARATE operation variant with its own path key (`isOperationDefault:\n * false` + `isBulkOperation: true`), so it needs its own registration: the single-row factory\n * above does not cover it. The bulk contract is `{ _ids }` and `_ids` is not a persisted field,\n * so without this handler the route would validate a list of promotion ids and write nothing.\n */\nexport function createPromotionDeactivateBulkFactory(): ResourceCustomServiceImplementationFactory {\n const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n return createResourceCustomServiceImplementation({\n operationPath: {\n resourceIdentifier: CoreResourceType.PROMOTIONS,\n operationIdentifier: Promotion_Operations.DEACTIVATE,\n variantType: ResourceOperationVariantType.API_CALL,\n isOperationDefault: false,\n isBulkOperation: true,\n },\n handlers: {\n prefixCoreOperations: async () => {\n return { isActive: false };\n },\n },\n });\n };\n\n return factory as unknown as ResourceCustomServiceImplementationFactory;\n}\n"]}
1	+ {"version":3,"file":"promotion.custom-ops.custom-impl.backend.service.js","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/promotion.custom-ops.custom-impl.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Promotion Custom Operations — CREATE (prefix), APPLY (replace), DEACTIVATE (prefix)\n \n Promotions are APPLICATION-scoped (not polymorphic) — 1 factory per operation.\n \n CREATE: PREFIX syncs coupon to billing provider → core CREATE writes to DB with provider IDs\n * APPLY: REPLACE validates the promotion and reports its discount. No standard CRUD equivalent,\n * and it records NO redemption — completion does (see the factory's docstring).\n * DEACTIVATE: PREFIX returns { isActive: false } → core UPDATE writes to DB\n \n @see billing-polymorphic-full-implementation.md §4.6.3 + §4.6.4 + §4.6.5\n /\n\nimport {\n CoreResourceType,\n ResourceOperationVariantType,\n CoreResourceOperation,\n ErrorType,\n ErrorCustomMessageReference,\n PromotionType,\n DiscountType,\n PromotionDuration,\n Promotion_Operations,\n} from '@wildo-ai/saas-models';\nimport {\n createResourceCustomServiceImplementation,\n type ResourceCustomServiceImplementationFactory,\n} from '~wildo-backend-lib/base-classes/services/services/resource-operation-custom-implementation.factory.backend';\nimport type { ResourcesRegistryBackendService } from '~wildo-backend-lib/resources/services/resources-registry.backend.service';\nimport { getBillingProvider } from '~wildo-backend-lib/billing/services/custom-impl/billing-custom-implementations.backend';\n\n// ════════════════════════════════════════════════════════════════════\n// CREATE — PREFIX_CORE_OPERATIONS\n// ════════════════════════════════════════════════════════════════════\n\n/\n Create Promotion CREATE prefix factory.\n \n Syncs the coupon (and optionally promotion code) to the billing provider\n * before the core CREATE writes to DB. Augments input with provider IDs.\n \n Registered on `INTERNAL_CALL` — the variant the resource configuration actually declares\n * for CREATE. Same drift class as the billing-account CREATE prefix: authored against\n * `REPOSITORY_ONLY`, orphaned once the configured variant moved, and silent because custom\n * implementations resolve by an EXACT operation-path key embedding `variantType`. Orphaned,\n * the promotion row is persisted with no `providerCouponId` / `providerPromotionId`, and\n * OPEN_CHECKOUT later rejects it as \"not synced to billing provider\". Pinned by\n * `billing-custom-impl-operation-path-coherence.test.ts`.\n /\nexport function createPromotionCreateFactory(): ResourceCustomServiceImplementationFactory {\n const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n return createResourceCustomServiceImplementation({\n operationPath: {\n resourceIdentifier: CoreResourceType.PROMOTIONS,\n operationIdentifier: CoreResourceOperation.CREATE,\n variantType: ResourceOperationVariantType.INTERNAL_CALL,\n isOperationDefault: true,\n },\n handlers: {\n prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n // L5: Validate discount fields match the declared discountType\n if (input.discountType === DiscountType.PERCENTAGE && (input.discountPercentage === undefined \|\| input.discountPercentage === null)) {\n throw utils.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { reason: 'discountPercentage is required for PERCENTAGE discount type' },\n });\n }\n if (input.discountType === DiscountType.FIXED_AMOUNT && !input.discountFixedAmount) {\n throw utils.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { reason: 'discountFixedAmount is required for FIXED_AMOUNT discount type' },\n });\n }\n\n const durationMap: Record<string, 'once' \| 'repeating' \| 'forever'> = {\n [PromotionDuration.ONCE]: 'once',\n [PromotionDuration.REPEATING]: 'repeating',\n [PromotionDuration.FOREVER]: 'forever',\n };\n\n // H1: Provider sync must succeed — throw on failure\n const provider = getBillingProvider();\n const couponResult = await provider.createCoupon({\n ...(input.discountType === DiscountType.PERCENTAGE && { percentOff: input.discountPercentage }),\n ...(input.discountType === DiscountType.FIXED_AMOUNT && input.discountFixedAmount && {\n amountOff: Number(input.discountFixedAmount.amount),\n currency: input.discountFixedAmount.currency,\n }),\n duration: durationMap[input.duration] ?? 'once',\n ...(input.durationInMonths && { durationInMonths: input.durationInMonths }),\n ...(input.maxRedemptions && { maxRedemptions: input.maxRedemptions }),\n ...(input.metadata && { metadata: input.metadata }),\n });\n const providerCouponId = couponResult.providerCouponId;\n\n let providerPromotionId: string \| undefined;\n if (input.type === PromotionType.PROMOTION_CODE && input.code && providerCouponId) {\n const promoResult = await provider.createPromotionCode(providerCouponId, input.code);\n providerPromotionId = promoResult.providerPromotionId;\n }\n\n return {\n ...input,\n providerCouponId,\n providerPromotionId,\n isActive: true,\n timesRedeemed: 0,\n };\n },\n },\n });\n };\n\n return factory as unknown as ResourceCustomServiceImplementationFactory;\n}\n\n// ════════════════════════════════════════════════════════════════════\n// APPLY — REPLACE_CORE_OPERATIONS\n// ════════════════════════════════════════════════════════════════════\n\n/\n Create Promotion APPLY replace factory.\n \n VALIDATES the promotion and returns its discount info. It records NOTHING.\n \n The redemption is counted when the purchase COMPLETES — `handleCheckoutCompleted`, behind the\n * durable settlement claim — because entering a code is not redeeming one. See the block where the\n * increment used to be for the full reasoning, including why leaving it here would double-count.\n \n The docstring here previously said \"the caller (typically OPEN_CHECKOUT)\". `OPEN_CHECKOUT` has\n * never called this verb: it re-validates a supplied code inline. This is a CLIENT-facing verb, for\n * a purchase form that wants to show the discount before the customer commits.\n /\nexport function createPromotionApplyFactory(): ResourceCustomServiceImplementationFactory {\n const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n return createResourceCustomServiceImplementation({\n operationPath: {\n resourceIdentifier: CoreResourceType.PROMOTIONS,\n operationIdentifier: Promotion_Operations.APPLY,\n variantType: ResourceOperationVariantType.API_CALL,\n isOperationDefault: true,\n },\n handlers: {\n replaceCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n const promotion = utils.currentObject;\n\n // Validate promotion is active\n if (!promotion.isActive) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Promotion is not active' },\n });\n }\n\n // Validate date range\n const now = new Date();\n if (promotion.validFrom && now < new Date(promotion.validFrom)) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Promotion has not started yet' },\n });\n }\n if (promotion.validUntil && now > new Date(promotion.validUntil)) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Promotion has expired' },\n });\n }\n\n // Validate max redemptions\n if (promotion.maxRedemptions !== null && promotion.maxRedemptions !== undefined) {\n if ((promotion.timesRedeemed ?? 0) >= promotion.maxRedemptions) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Maximum redemptions reached' },\n });\n }\n }\n\n // Validate code match (when the promotion has a code)\n if (promotion.code && input.code !== promotion.code) {\n throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n customMessageReference: ErrorCustomMessageReference.BILLING_PROMOTION_INVALID,\n context: { promotionId: _id, reason: 'Code does not match' },\n });\n }\n\n /\n * COUNTS NOTHING, and that is the change (#518 follow-up).\n \n This used to increment `timesRedeemed` here, guarded by the cap. It was the only place\n * a redemption was ever counted, and it counted at the WRONG MOMENT — this verb runs when\n * a customer types a code into a purchase form, which is not a redemption. A customer who\n * types a code and closes the tab consumed one anyway, so a limited campaign was exhausted\n * by window-shoppers.\n \n A redemption is now counted exactly where the money moves: the\n * `checkout.session.completed` webhook, behind the durable settlement claim that makes the\n * count exactly-once across replicas and retries. Leaving the increment here as well would\n * double-count every customer who used this verb and then completed the purchase — the two\n * are two views of ONE redemption, not two redemptions.\n \n The cap check above stays, because it is what makes this verb answer honestly: an\n * exhausted code must be refused at the moment it is entered, not silently accepted and\n * then refused at completion when the customer has already paid.\n /\n\n // Return discount info for the caller\n return {\n valid: true,\n promotionId: _id,\n providerCouponId: promotion.providerCouponId,\n providerPromotionId: promotion.providerPromotionId,\n discount: {\n type: promotion.discountType,\n ...(promotion.discountType === DiscountType.PERCENTAGE && { percentage: promotion.discountPercentage }),\n ...(promotion.discountType === DiscountType.FIXED_AMOUNT && { amount: promotion.discountFixedAmount }),\n },\n };\n },\n },\n });\n };\n\n return factory as unknown as ResourceCustomServiceImplementationFactory;\n}\n\n// ════════════════════════════════════════════════════════════════════\n// DEACTIVATE — PREFIX_CORE_OPERATIONS\n// ════════════════════════════════════════════════════════════════════\n\n/\n Create Promotion DEACTIVATE prefix factory.\n \n Trivially returns { isActive: false } — core UPDATE writes to DB.\n \n The operation declares `requestDto: z.object({})` (single) / `{ _ids }` (bulk), so `isActive`\n * can ONLY arrive from here. Before that narrowing the verb inherited the resource's full update\n * contract — including `isActive` itself, so \"deactivate\" could re-activate — and this return was\n * MERGED onto the caller payload rather than replacing it, leaving `code`, `discountPercentage`\n * and `maxRedemptions` writable through a route named deactivate.\n /\nexport function createPromotionDeactivateFactory(): ResourceCustomServiceImplementationFactory {\n const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n return createResourceCustomServiceImplementation({\n operationPath: {\n resourceIdentifier: CoreResourceType.PROMOTIONS,\n operationIdentifier: Promotion_Operations.DEACTIVATE,\n variantType: ResourceOperationVariantType.API_CALL,\n isOperationDefault: true,\n },\n handlers: {\n prefixCoreOperations: async () => {\n return { isActive: false };\n },\n },\n });\n };\n\n return factory as unknown as ResourceCustomServiceImplementationFactory;\n}\n\n/\n Create Promotion DEACTIVATE prefix factory — BULK companion (`haveBulkOperation: true`).\n \n A bulk companion is a SEPARATE operation variant with its own path key (`isOperationDefault:\n * false` + `isBulkOperation: true`), so it needs its own registration: the single-row factory\n * above does not cover it. The bulk contract is `{ _ids }` and `_ids` is not a persisted field,\n * so without this handler the route would validate a list of promotion ids and write nothing.\n */\nexport function createPromotionDeactivateBulkFactory(): ResourceCustomServiceImplementationFactory {\n const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n return createResourceCustomServiceImplementation({\n operationPath: {\n resourceIdentifier: CoreResourceType.PROMOTIONS,\n operationIdentifier: Promotion_Operations.DEACTIVATE,\n variantType: ResourceOperationVariantType.API_CALL,\n isOperationDefault: false,\n isBulkOperation: true,\n },\n handlers: {\n prefixCoreOperations: async () => {\n return { isActive: false };\n },\n },\n });\n };\n\n return factory as unknown as ResourceCustomServiceImplementationFactory;\n}\n"]}