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

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

@@ -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;;;;;;;;;;;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"}
+{"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.map

@@ -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 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"]}
+{"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"]}

package/dist/esm/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.mutations.custom-impl.backend.service.d.ts","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiBH,OAAO,EAEL,KAAK,0CAA0C,EAChD,MAAM,4GAA4G,CAAC;AA8CpH,wBAAgB,iCAAiC,IAAI,0CAA0C,EAAE,CA0FhG;AAMD;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,IAAI,0CAA0C,EAAE,CAwChG;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,IAAI,0CAA0C,EAAE,CA0HpG;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,IAAI,0CAA0C,EAAE,CAoFlG;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sCAAsC,IAAI,0CAA0C,EAAE,CAmDrG"}
+{"version":3,"file":"subscription.mutations.custom-impl.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAiBH,OAAO,EAEL,KAAK,0CAA0C,EAChD,MAAM,4GAA4G,CAAC;AA8CpH,wBAAgB,iCAAiC,IAAI,0CAA0C,EAAE,CA0FhG;AAMD;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,IAAI,0CAA0C,EAAE,CAwChG;AAMD;;;;;;;;GAQG;AACH,wBAAgB,qCAAqC,IAAI,0CAA0C,EAAE,CA0HpG;AAMD;;;;;;;;GAQG;AACH,wBAAgB,mCAAmC,IAAI,0CAA0C,EAAE,CAoFlG;AAMD;;;;;;;;GAQG;AACH,wBAAgB,sCAAsC,IAAI,0CAA0C,EAAE,CAmDrG"}

package/dist/esm/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"subscription.mutations.custom-impl.backend.service.js","sourceRoot":"","sources":["../../../../../../src/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,gBAAgB,EAChB,4BAA4B,EAC5B,kBAAkB,EAClB,SAAS,EACT,2BAA2B,EAC3B,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,8BAA8B,EAC9B,oCAAoC,EACpC,wCAAwC,EACxC,sCAAsC,EACtC,yCAAyC,GAC1C,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,yCAAyC,GAE1C,MAAM,4GAA4G,CAAC;AAEpH,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,wFAAwF,CAAC;AAC9I,OAAO,EACL,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,mBAAmB,EACnB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,mFAAmF,CAAC;AAE3F,wEAAwE;AAExE,MAAM,0BAA0B,GAAG;IACjC,gBAAgB,CAAC,0BAA0B;IAC3C,gBAAgB,CAAC,kBAAkB;CAC3B,CAAC;AAEX;;;;;;;GAOG;AACH,KAAK,UAAU,eAAe,CAC5B,YAAqD,EACrD,gBAAuD,EACvD,KAA4C;IAE5C,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;QACtC,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;QACnF,IAAI,WAAW,CAAC,IAAI,KAAK,WAAW,CAAC,IAAI,EAAE,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uEAAuE;AACvE,SAAS;AACT,uEAAuE;AAEvE,MAAM,UAAU,iCAAiC;IAC/C,OAAO,0BAA0B,CAAC,GAAG,CAAC,CAAC,mBAAmB,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,CAAC,yBAA0D,EAAE,EAAE;YAC7E,OAAO,yCAAyC,CAAC;gBAC/C,aAAa,EAAE;oBACb,kBAAkB,EAAE,mBAAmB;oBACvC,mBAAmB,EAAE,8BAA8B,CAAC,MAAM;oBAC1D,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,kBAAkB,EAAE,IAAI;iBACzB;gBACD,gBAAgB,EAAE,oCAAoC;gBACtD,QAAQ,EAAE;oBACR,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE;wBAClF,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC;wBACzC,4BAA4B,CAAC,YAAY,EAAE,GAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAE1E;;;;;;;;;;;;;;;;;;;2BAmBG;wBACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAC9E,MAAM,WAAW,GAAG,QAAQ;4BAC1B,CAAC,CAAC,MAAM,eAAe,CAAC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,CAAC;4BACpE,CAAC,CAAC,IAAI,CAAC;wBACT,MAAM,kBAAkB,GAAG,WAAW,EAAE,cAAc,EAAE,YAAY,CAAC;wBAErE,MAAM,kBAAkB,GAAG,KAAK,CAAC,iBAAiB,CAAC;wBACnD,IAAI,kBAAkB,KAAK,IAAI,IAAI,kBAAkB,EAAE,cAAc,KAAK,KAAK,EAAE,CAAC;4BAChF,MAAM,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,gBAAgB,EAAE;gCACxE,sBAAsB,EAAE,2BAA2B,CAAC,QAAQ;gCAC5D,OAAO,EAAE;oCACP,MAAM,EAAE,gDAAgD;oCACxD,OAAO,EAAE,6GAA6G;oCACtH,UAAU,EAAE,WAAW,EAAE,GAAG;iCAC7B;6BACF,CAAC,CAAC;wBACL,CAAC;wBAED;;;;;;;;;;;2BAWG;wBACH,MAAM,cAAc,GAAG,kBAAkB,EAAE,eAAe;+BACrD,gBAAgB,EAAE,CAAC,qBAAqB,EAAE,mBAAmB,CAAC;wBACnE,MAAM,iBAAiB,GAAG,kBAAkB;+BACvC,CAAC,cAAc,KAAK,aAAa,CAAC,SAAS,CAAC,CAAC;wBAClD,MAAM,WAAW,GAAG,CAAC,iBAAiB,CAAC;wBAEvC,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;wBACtC,MAAM,QAAQ,CAAC,kBAAkB,CAAC,YAAY,CAAC,sBAAsB,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;wBAExF,OAAO;4BACL,iBAAiB,EAAE,WAAW;4BAC9B,WAAW,EAAE,IAAI,IAAI,EAAE;4BACvB,GAAG,CAAC,CAAC,WAAW,IAAI,EAAE,MAAM,EAAE,kBAAkB,CAAC,SAAS,EAAE,CAAC;4BAC7D,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,kBAAkB,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;yBAC1D,CAAC;oBACJ,CAAC;oBAED,kFAAkF;iBACnF;aACF,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,OAAO,OAAgE,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AACvE,SAAS;AACT,uEAAuE;AAEvE;;;;;;;GAOG;AACH,MAAM,UAAU,iCAAiC;IAC/C,OAAO,0BAA0B,CAAC,GAAG,CAAC,CAAC,mBAAmB,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,CAAC,yBAA0D,EAAE,EAAE;YAC7E,OAAO,yCAAyC,CAAC;gBAC/C,aAAa,EAAE;oBACb,kBAAkB,EAAE,mBAAmB;oBACvC,mBAAmB,EAAE,8BAA8B,CAAC,MAAM;oBAC1D,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,kBAAkB,EAAE,IAAI;iBACzB;gBACD,QAAQ,EAAE;oBACR,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE;wBACnF,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC;wBACzC,4BAA4B,CAAC,YAAY,EAAE,GAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAE1E,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,CAAC;4BACpC,MAAM,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,aAAa,EAAE,gBAAgB,EAAE;gCAC7E,sBAAsB,EAAE,2BAA2B,CAAC,8BAA8B;gCAClF,OAAO,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,0CAA0C,EAAE;6BACrF,CAAC,CAAC;wBACL,CAAC;wBAED,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;wBACtC,MAAM,QAAQ,CAAC,kBAAkB,CAAC,YAAY,CAAC,sBAAsB,CAAC,CAAC;wBAEvE,OAAO;4BACL,iBAAiB,EAAE,KAAK;4BACxB,WAAW,EAAE,IAAI;4BACjB,kBAAkB,EAAE,IAAI;4BACxB,MAAM,EAAE,kBAAkB,CAAC,MAAM;yBAClC,CAAC;oBACJ,CAAC;oBAED,kFAAkF;iBACnF;aACF,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,OAAO,OAAgE,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AACvE,cAAc;AACd,uEAAuE;AAEvE;;;;;;;;GAQG;AACH,MAAM,UAAU,qCAAqC;IACnD,OAAO,0BAA0B,CAAC,GAAG,CAAC,CAAC,mBAAmB,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,CAAC,yBAA0D,EAAE,EAAE;YAC7E,OAAO,yCAAyC,CAAC;gBAC/C,aAAa,EAAE;oBACb,kBAAkB,EAAE,mBAAmB;oBACvC,mBAAmB,EAAE,8BAA8B,CAAC,WAAW;oBAC/D,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,kBAAkB,EAAE,IAAI;iBACzB;gBACD,gBAAgB,EAAE,wCAAwC;gBAC1D,QAAQ,EAAE;oBACR,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE;wBAClF,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC;wBACzC,4BAA4B,CAAC,YAAY,EAAE,GAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAE1E,8DAA8D;wBAC9D,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,aAAa,EAAE,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAC1H,8EAA8E;wBAC9E,2FAA2F;wBAC3F,qFAAqF;wBACrF,mDAAmD;wBACnD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAElG,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;4BAC9B,MAAM,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,aAAa,EAAE,gBAAgB,EAAE;gCAC7E,sBAAsB,EAAE,2BAA2B,CAAC,yBAAyB;gCAC7E,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,aAAa,EAAE;6BACxE,CAAC,CAAC;wBACL,CAAC;wBAED,6EAA6E;wBAC7E,MAAM,eAAe,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBACrF,MAAM,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,eAAoD,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;wBAE9H,2DAA2D;wBAC3D,MAAM,aAAa,GAA8F,EAAE,CAAC;wBACpH,MAAM,UAAU,GAAe,EAAE,CAAC;wBAElC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;4BACnD,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC;gCACxB,aAAa,CAAC,IAAI,CAAC;oCACjB,0BAA0B,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,0BAA0B;oCAC5E,eAAe,EAAE,QAAQ,CAAC,eAAe;oCACzC,QAAQ,EAAE,CAAC;iCACZ,CAAC,CAAC;gCACH,UAAU,CAAC,IAAI,CAAC;oCACd,GAAG,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG;oCAC9B,SAAS,EAAE,UAAU,CAAC,GAAG;oCACzB,OAAO,EAAE,QAAQ,CAAC,GAAG;oCACrB,QAAQ,EAAE,CAAC;iCACZ,CAAC,CAAC;4BACL,CAAC;iCAAM,CAAC;gCACN,MAAM,KAAK,GAAG,MAAM,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;gCAC1F,aAAa,CAAC,IAAI,CAAC;oCACjB,0BAA0B,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,0BAA0B;oCAC5E,eAAe,EAAE,KAAK,CAAC,eAAe,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO;oCACvE,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ;iCACzC,CAAC,CAAC;gCACH,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;4BACzC,CAAC;wBACH,CAAC;wBAED,8CAA8C;wBAC9C,IAAI,aAAa,KAAK,CAAC,CAAC,EAAE,CAAC;4BACzB,aAAa,CAAC,OAAO,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,eAAe,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;4BAClF,UAAU,CAAC,OAAO,CAAC;gCACjB,GAAG,EAAE,GAAG,YAAY,CAAC,sBAAsB,YAAY;gCACvD,SAAS,EAAE,UAAU,CAAC,GAAG;gCACzB,OAAO,EAAE,QAAQ,CAAC,GAAG;gCACrB,QAAQ,EAAE,CAAC;6BACZ,CAAC,CAAC;wBACL,CAAC;wBAED,mDAAmD;wBACnD,MAAM,cAAc,GAAG,aAAa,IAAI,CAAC;4BACvC,CAAC,CAAC,MAAM,eAAe,CAAC,YAAY,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,CAAC;4BAC7F,CAAC,CAAC,IAAI,CAAC;wBACT,MAAM,SAAS,GAAG,cAAc;4BAC9B,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,IAAI,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,aAAa,IAAI,CAAC,CAAC;4BACvE,CAAC,CAAC,IAAI,CAAC;wBACT,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;wBAClC,MAAM,MAAM,GAAG,SAAS;4BACtB,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,OAAO,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,CAAC;4BACvI,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,EAAE,SAAS,IAAI,EAAE,SAAS,EAAE,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,aAAa,CAAC,aAAa,EAAE,CAAC,CAAC;wBAEzH,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;wBACtC,MAAM,QAAQ,CAAC,kBAAkB,CAAC,YAAY,CAAC,sBAAsB,EAAE;4BACrE,KAAK,EAAE,aAAa;4BACpB;;;;;;;;+BAQG;4BACH,iBAAiB,EAAE,MAAM,CAAC,SAAS;4BACnC,QAAQ,EAAE;gCACR;;;;;;;mCAOG;gCACH,eAAe,EAAE,MAAM,CAAC,MAAM;6BAC/B;yBACF,CAAC,CAAC;wBAEH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;oBAC/B,CAAC;oBAED,kFAAkF;iBACnF;aACF,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,OAAO,OAAgE,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AACvE,YAAY;AACZ,uEAAuE;AAEvE;;;;;;;;GAQG;AACH,MAAM,UAAU,mCAAmC;IACjD,OAAO,0BAA0B,CAAC,GAAG,CAAC,CAAC,mBAAmB,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,CAAC,yBAA0D,EAAE,EAAE;YAC7E,OAAO,yCAAyC,CAAC;gBAC/C,aAAa,EAAE;oBACb,kBAAkB,EAAE,mBAAmB;oBACvC,mBAAmB,EAAE,8BAA8B,CAAC,SAAS;oBAC7D,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,kBAAkB,EAAE,IAAI;iBACzB;gBACD,gBAAgB,EAAE,sCAAsC;gBACxD,QAAQ,EAAE;oBACR,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE;wBAClF,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC;wBACzC,4BAA4B,CAAC,YAAY,EAAE,GAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAE1E,qCAAqC;wBACrC,sCAAsC;wBACtC,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,eAAe,EAAE,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAC9H,IAAI,YAAY,CAAC,IAAI,KAAK,WAAW,CAAC,KAAK,EAAE,CAAC;4BAC5C,MAAM,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,EAAE,gBAAgB,EAAE;gCAC1E,sBAAsB,EAAE,2BAA2B,CAAC,4BAA4B;gCAChF,OAAO,EAAE,EAAE,UAAU,EAAE,KAAK,CAAC,eAAe,EAAE,YAAY,EAAE,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,CAAC,IAAI,EAAE;6BAC/G,CAAC,CAAC;wBACL,CAAC;wBAED,6BAA6B;wBAC7B,IAAI,YAAY,CAAC,iBAAiB,IAAI,YAAY,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAChF,MAAM,eAAe,GAAG,MAAM,eAAe,CAAC,YAAY,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;4BACrF,MAAM,eAAe,GAAG,eAAe;gCACrC,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,eAAe,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ;gCACtF,CAAC,CAAC,SAAS,CAAC;4BACd,IAAI,CAAC,eAAe,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;gCAClF,MAAM,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,aAAa,EAAE,gBAAgB,EAAE;oCAC7E,sBAAsB,EAAE,2BAA2B,CAAC,0BAA0B;oCAC9E,OAAO,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,aAAa,EAAE,YAAY,CAAC,iBAAiB,EAAE,WAAW,EAAE,eAAe,IAAI,IAAI,EAAE;iCACzI,CAAC,CAAC;4BACL,CAAC;wBACH,CAAC;wBAED,wFAAwF;wBACxF,uFAAuF;wBACvF,6DAA6D;wBAC7D,MAAM,UAAU,GAAG,MAAM,mBAAmB,CAAC,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBACnG,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;4BAChC,MAAM,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,aAAa,EAAE,gBAAgB,EAAE;gCAC7E,sBAAsB,EAAE,2BAA2B,CAAC,yBAAyB;gCAC7E,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,eAAe,EAAE;6BACvE,CAAC,CAAC;wBACL,CAAC;wBAED,mDAAmD;wBACnD,MAAM,qBAAqB,GAAG,MAAM,oBAAoB,CAAC,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBACtG,qBAAqB,CAAC,IAAI,CAAC;4BACzB,eAAe,EAAE,UAAU,CAAC,eAAe;4BAC3C,QAAQ,EAAE,CAAC;yBACZ,CAAC,CAAC;wBAEH,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;wBACtC,MAAM,QAAQ,CAAC,kBAAkB,CAAC,YAAY,CAAC,sBAAsB,EAAE;4BACrE,KAAK,EAAE,qBAAqB;yBAC7B,CAAC,CAAC;wBAEH,gDAAgD;wBAChD,MAAM,QAAQ,GAAG;4BACf,GAAG,YAAY,CAAC,KAAK;4BACrB;gCACE,GAAG,EAAE,GAAG,YAAY,CAAC,sBAAsB,SAAS,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE;gCAC/E,SAAS,EAAE,YAAY,CAAC,GAAG;gCAC3B,OAAO,EAAE,UAAU,CAAC,GAAG;gCACvB,QAAQ,EAAE,CAAC;6BACZ;yBACF,CAAC;wBAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;oBAC7B,CAAC;oBAED,kFAAkF;iBACnF;aACF,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,OAAO,OAAgE,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC;AAED,uEAAuE;AACvE,eAAe;AACf,uEAAuE;AAEvE;;;;;;;;GAQG;AACH,MAAM,UAAU,sCAAsC;IACpD,OAAO,0BAA0B,CAAC,GAAG,CAAC,CAAC,mBAAmB,EAAE,EAAE;QAC5D,MAAM,OAAO,GAAG,CAAC,yBAA0D,EAAE,EAAE;YAC7E,OAAO,yCAAyC,CAAC;gBAC/C,aAAa,EAAE;oBACb,kBAAkB,EAAE,mBAAmB;oBACvC,mBAAmB,EAAE,8BAA8B,CAAC,YAAY;oBAChE,WAAW,EAAE,4BAA4B,CAAC,QAAQ;oBAClD,kBAAkB,EAAE,IAAI;iBACzB;gBACD,gBAAgB,EAAE,yCAAyC;gBAC3D,QAAQ,EAAE;oBACR,oBAAoB,EAAE,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,KAAK,EAAE,EAAE;wBAClF,MAAM,YAAY,GAAG,KAAK,CAAC,aAAa,CAAC;wBACzC,4BAA4B,CAAC,YAAY,EAAE,GAAI,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAE1E,wBAAwB;wBACxB;;;;2BAIG;wBACH,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,KAAK,CAAC,eAAe,EAAE,wBAAwB,CAAC,SAAS,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAEhI,iCAAiC;wBACjC,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,YAAY,CAAC,GAAG,CAAC,CAAC;wBACrG,IAAI,cAAc,CAAC,MAAM,KAAK,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;4BACxD,MAAM,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,SAAS,EAAE,gBAAgB,EAAE;gCACzE,sBAAsB,EAAE,2BAA2B,CAAC,iCAAiC;gCACrF,OAAO,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,cAAc,EAAE,GAAG,EAAE;6BACzE,CAAC,CAAC;wBACL,CAAC;wBAED,4CAA4C;wBAC5C,MAAM,aAAa,GAAG,MAAM,oBAAoB,CAAC,cAAc,EAAE,gBAAgB,EAAE,KAAK,CAAC,CAAC;wBAE1F,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;wBACtC,MAAM,QAAQ,CAAC,kBAAkB,CAAC,YAAY,CAAC,sBAAsB,EAAE;4BACrE,KAAK,EAAE,aAAa;yBACrB,CAAC,CAAC;wBAEH,OAAO,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;oBACnC,CAAC;oBAED,kFAAkF;iBACnF;aACF,CAAC,CAAC;QACL,CAAC,CAAC;QAEF,OAAO,OAAgE,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["/**\n * Subscription Mutations Custom Implementations\n *\n * Implements CANCEL, RESUME, CHANGE_PLAN, ADD_ADDON, REMOVE_ADDON operations\n * on subscription polymorphic variants.\n *\n * Pattern: PREFIX_CORE_OPERATIONS\n *   PREFIX  → validate, call billing provider (Stripe), return update payload\n *   CORE    → standard UPDATE (engine handles DB write)\n *   Feature sync is handled automatically by the post-operation hook infrastructure.\n *\n * One factory per polymorphic variant (org, user) per operation.\n * All variants share the same handler logic.\n *\n * @see billing-polymorphic-full-implementation.md §4.2 + §4.3\n */\n\nimport {\n  CoreResourceType,\n  ResourceOperationVariantType,\n  SubscriptionStatus,\n  ErrorType,\n  ErrorCustomMessageReference,\n  ProductType,\n  ProrationBehavior,\n  BillingTiming,\n  BillingSubscription_Operations,\n  BillingSubscription_CancelRequestDto,\n  BillingSubscription_ChangePlanRequestDto,\n  BillingSubscription_AddAddonRequestDto,\n  BillingSubscription_RemoveAddonRequestDto,\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, getBillingConfig } from '~wildo-backend-lib/billing/services/custom-impl/billing-custom-implementations.backend';\nimport {\n  BillingCatalogReadIntent,\n  readProductByKey,\n  readProductById,\n  readPriceById,\n  readPriceForProduct,\n  validateProviderSubscription,\n  resolveProviderItems,\n} from '~wildo-backend-lib/billing/services/custom-impl/billing-custom-impl-utils.backend';\n\n// ── Subscription polymorphic variant types ───────────────────────────\n\nconst SUBSCRIPTION_VARIANT_TYPES = [\n  CoreResourceType.ORGANIZATION_SUBSCRIPTIONS,\n  CoreResourceType.USER_SUBSCRIPTIONS,\n] as const;\n\n/**\n * The subscription item carrying the PLAN, or `null` when a subscription holds only addons.\n *\n * A subscription's items are a plan plus any addons, and three places in this file needed to find\n * the plan among them — the change-plan path, the addon plan-tier gate, and now the cancellation\n * policy (#408). Each had its own inline loop. One helper because \"which item is the plan\" is a\n * single question with a single answer, and three copies is how the fourth one comes to differ.\n */\nasync function resolvePlanItem(\n  subscription: { items: Array<{ productId: string }> },\n  executionContext: Parameters<typeof readProductById>[1],\n  utils: Parameters<typeof readProductById>[2],\n): Promise<{ productId: string } | null> {\n  for (const item of subscription.items) {\n    const itemProduct = await readProductById(item.productId, executionContext, utils);\n    if (itemProduct.type === ProductType.PLAN) {\n      return item;\n    }\n  }\n  return null;\n}\n\n// ════════════════════════════════════════════════════════════════════\n// CANCEL\n// ════════════════════════════════════════════════════════════════════\n\nexport function createSubscriptionCancelFactories(): ResourceCustomServiceImplementationFactory[] {\n  return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {\n    const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n      return createResourceCustomServiceImplementation({\n        operationPath: {\n          resourceIdentifier: variantResourceType,\n          operationIdentifier: BillingSubscription_Operations.CANCEL,\n          variantType: ResourceOperationVariantType.API_CALL,\n          isOperationDefault: true,\n        },\n        requestDtoSchema: BillingSubscription_CancelRequestDto,\n        handlers: {\n          prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n            const subscription = utils.currentObject;\n            validateProviderSubscription(subscription, _id!, executionContext, utils);\n\n            /*\n             * `ProductBehaviorPolicy.cancellation` now governs this operation (#408, decided\n             * 2026-09-08). Until then it was read by NOTHING: timing came solely from the caller's\n             * `cancelImmediately` flag, so a product declaring that immediate cancellation is not\n             * allowed could not refuse one — and Wonder Todos authors `allowImmediate: false` on\n             * BOTH plans, unenforced.\n             *\n             * Two distinct things come from the policy, and conflating them was the trap:\n             *   - `allowImmediate` is a REFUSAL. A caller who asks for immediate cancellation\n             *     against a product that forbids it gets a 409, not a silent downgrade to\n             *     period-end. Silently honouring the safer timing would tell the caller their\n             *     subscription had ended when it has not, which is worse than refusing.\n             *   - `defaultBehavior` decides the timing when the caller expresses NO preference.\n             *     `cancelImmediately` is optional on the request DTO, so \"absent\" is a real state\n             *     and is where an authored default belongs.\n             *\n             * The policy is read from the subscription's PLAN product, resolved the same way the\n             * change-plan path above resolves it. An addon does not carry the cancellation policy\n             * of the subscription it rides on.\n             */\n            const planItem = await resolvePlanItem(subscription, executionContext, utils);\n            const planProduct = planItem\n              ? await readProductById(planItem.productId, executionContext, utils)\n              : null;\n            const cancellationPolicy = planProduct?.behaviorPolicy?.cancellation;\n\n            const requestedImmediate = input.cancelImmediately;\n            if (requestedImmediate === true && cancellationPolicy?.allowImmediate === false) {\n              throw utils.errorBuilder.buildError(ErrorType.CONFLICT, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.CONFLICT,\n                context: {\n                  reason: 'billing_product_forbids_immediate_cancellation',\n                  message: 'This plan does not allow immediate cancellation; it can only be cancelled at the end of the current period.',\n                  productKey: planProduct?.key,\n                },\n              });\n            }\n\n            /*\n             * Absent preference resolves down a chain, most specific first: the caller, the plan\n             * product's own default, the application's `defaultCancellation`, then period-end.\n             *\n             * The application-level step is what makes `billing.defaultBehaviorPolicy.defaultCancellation`\n             * mean something. It was dead alongside its neighbours, and it is BOUND rather than\n             * relabelled because — unlike grace periods and retry counts, which are dunning settings\n             * living at the provider — cancellation timing is resolved locally. The only thing\n             * standing between that key and an effect was a reader.\n             *\n             * Period-end is the floor because it never ends access a customer has already paid for.\n             */\n            const resolvedTiming = cancellationPolicy?.defaultBehavior\n              ?? getBillingConfig().defaultBehaviorPolicy?.defaultCancellation;\n            const cancelImmediately = requestedImmediate\n              ?? (resolvedTiming === BillingTiming.IMMEDIATE);\n            const atPeriodEnd = !cancelImmediately;\n\n            const provider = getBillingProvider();\n            await provider.cancelSubscription(subscription.providerSubscriptionId, { atPeriodEnd });\n\n            return {\n              cancelAtPeriodEnd: atPeriodEnd,\n              cancelledAt: new Date(),\n              ...(!atPeriodEnd && { status: SubscriptionStatus.CANCELLED }),\n              ...(input.reason && { cancellationReason: input.reason }),\n            };\n          },\n\n          // Feature sync is handled automatically by the post-operation hook infrastructure\n        },\n      });\n    };\n\n    return factory as unknown as ResourceCustomServiceImplementationFactory;\n  });\n}\n\n// ════════════════════════════════════════════════════════════════════\n// RESUME\n// ════════════════════════════════════════════════════════════════════\n\n/**\n * Create RESUME custom impl factories for all subscription variants.\n *\n * RESUME un-cancels a subscription that has cancelAtPeriodEnd = true.\n *   PREFIX:  validates subscription is pending cancellation, calls provider resumeSubscription()\n *   CORE:    standard UPDATE clears cancellation fields\n *   (Feature sync handled by post-operation hook)\n */\nexport function createSubscriptionResumeFactories(): ResourceCustomServiceImplementationFactory[] {\n  return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {\n    const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n      return createResourceCustomServiceImplementation({\n        operationPath: {\n          resourceIdentifier: variantResourceType,\n          operationIdentifier: BillingSubscription_Operations.RESUME,\n          variantType: ResourceOperationVariantType.API_CALL,\n          isOperationDefault: true,\n        },\n        handlers: {\n          prefixCoreOperations: async (_id, _input, executionContext, _operationPath, utils) => {\n            const subscription = utils.currentObject;\n            validateProviderSubscription(subscription, _id!, executionContext, utils);\n\n            if (!subscription.cancelAtPeriodEnd) {\n              throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.BILLING_NO_ACTIVE_SUBSCRIPTION,\n                context: { subscriptionId: _id, reason: 'Subscription is not pending cancellation' },\n              });\n            }\n\n            const provider = getBillingProvider();\n            await provider.resumeSubscription(subscription.providerSubscriptionId);\n\n            return {\n              cancelAtPeriodEnd: false,\n              cancelledAt: null,\n              cancellationReason: null,\n              status: SubscriptionStatus.ACTIVE,\n            };\n          },\n\n          // Feature sync is handled automatically by the post-operation hook infrastructure\n        },\n      });\n    };\n\n    return factory as unknown as ResourceCustomServiceImplementationFactory;\n  });\n}\n\n// ════════════════════════════════════════════════════════════════════\n// CHANGE_PLAN\n// ════════════════════════════════════════════════════════════════════\n\n/**\n * Create CHANGE_PLAN custom impl factories for all subscription variants.\n *\n * CHANGE_PLAN upgrades or downgrades the subscription plan.\n *   PREFIX:  resolves new product/price, determines proration, builds provider items,\n *            calls provider updateSubscription(), returns update payload with new items\n *   CORE:    standard UPDATE writes new items to DB\n *   (Feature sync handled by post-operation hook)\n */\nexport function createSubscriptionChangePlanFactories(): ResourceCustomServiceImplementationFactory[] {\n  return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {\n    const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n      return createResourceCustomServiceImplementation({\n        operationPath: {\n          resourceIdentifier: variantResourceType,\n          operationIdentifier: BillingSubscription_Operations.CHANGE_PLAN,\n          variantType: ResourceOperationVariantType.API_CALL,\n          isOperationDefault: true,\n        },\n        requestDtoSchema: BillingSubscription_ChangePlanRequestDto,\n        handlers: {\n          prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n            const subscription = utils.currentObject;\n            validateProviderSubscription(subscription, _id!, executionContext, utils);\n\n            // ACQUIRE: the subscription is being moved ONTO this product.\n            const newProduct = await readProductByKey(input.newProductKey, BillingCatalogReadIntent.ACQUIRE, executionContext, utils);\n            // The price MUST belong to the product being switched to. These were resolved\n            // independently, so pairing a premium `newProductKey` with a cheap `newPriceId` billed the\n            // provider the cheap price while the local item — and every entitlement derived from\n            // `item.productId` — recorded the premium product.\n            const newPrice = await readPriceForProduct(input.newPriceId, newProduct, executionContext, utils);\n\n            if (!newPrice.providerPriceId) {\n              throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.BILLING_NO_PROVIDER_PRICE,\n                context: { priceId: input.newPriceId, productKey: input.newProductKey },\n              });\n            }\n\n            // Find the current plan item (type === PLAN) and determine upgrade/downgrade\n            const currentPlanItem = await resolvePlanItem(subscription, executionContext, utils);\n            const planItemIndex = currentPlanItem ? subscription.items.indexOf(currentPlanItem as typeof subscription.items[number]) : -1;\n\n            // Build provider items: replace plan item, preserve addons\n            const providerItems: Array<{ providerSubscriptionItemId?: string; providerPriceId: string; quantity: number }> = [];\n            const localItems: Array<any> = [];\n\n            for (let i = 0; i < subscription.items.length; i++) {\n              if (i === planItemIndex) {\n                providerItems.push({\n                  providerSubscriptionItemId: subscription.items[i].providerSubscriptionItemId,\n                  providerPriceId: newPrice.providerPriceId,\n                  quantity: 1,\n                });\n                localItems.push({\n                  _id: subscription.items[i]._id,\n                  productId: newProduct._id,\n                  priceId: newPrice._id,\n                  quantity: 1,\n                });\n              } else {\n                const price = await readPriceById(subscription.items[i].priceId, executionContext, utils);\n                providerItems.push({\n                  providerSubscriptionItemId: subscription.items[i].providerSubscriptionItemId,\n                  providerPriceId: price.providerPriceId || subscription.items[i].priceId,\n                  quantity: subscription.items[i].quantity,\n                });\n                localItems.push(subscription.items[i]);\n              }\n            }\n\n            // If no plan item found, prepend the new plan\n            if (planItemIndex === -1) {\n              providerItems.unshift({ providerPriceId: newPrice.providerPriceId, quantity: 1 });\n              localItems.unshift({\n                _id: `${subscription.providerSubscriptionId}_item_plan`,\n                productId: newProduct._id,\n                priceId: newPrice._id,\n                quantity: 1,\n              });\n            }\n\n            // Determine proration from product behavior policy\n            const currentProduct = planItemIndex >= 0\n              ? await readProductById(subscription.items[planItemIndex].productId, executionContext, utils)\n              : null;\n            const isUpgrade = currentProduct\n              ? (newProduct.planTierOrder ?? 0) > (currentProduct.planTierOrder ?? 0)\n              : true;\n            const config = getBillingConfig();\n            const policy = isUpgrade\n              ? (newProduct.behaviorPolicy?.upgrade ?? { proration: config.defaultBehaviorPolicy.defaultProration, timing: BillingTiming.IMMEDIATE })\n              : (newProduct.behaviorPolicy?.downgrade ?? { proration: ProrationBehavior.NONE, timing: BillingTiming.AT_PERIOD_END });\n\n            const provider = getBillingProvider();\n            await provider.updateSubscription(subscription.providerSubscriptionId, {\n              items: providerItems,\n              /*\n               * The resolved proration, as a REQUEST FIELD (#516).\n               *\n               * It was `metadata.prorationBehavior` until 2026-09-08 — a free-form key/value bag the\n               * provider stores and never reads — so this policy was correctly resolved from the target\n               * product's `upgrade`/`downgrade` block and then discarded at the boundary. A product\n               * declaring `ProrationBehavior.NONE` for a downgrade was prorated anyway, by the\n               * provider's account default. Wonder Todos authors exactly that.\n               */\n              prorationBehavior: policy.proration,\n              metadata: {\n                /*\n                 * TIMING remains metadata, and that is honest rather than an oversight: a provider's\n                 * proration parameter says HOW a change settles, not WHEN it applies. Deferring a\n                 * change to the period end needs a subscription schedule, which is a different call and\n                 * a different mechanism — so `prorationTiming` is still carried for a connector that\n                 * grows one, and still changes nothing today. Do not read this field's presence as the\n                 * timing being honoured.\n                 */\n                prorationTiming: policy.timing,\n              },\n            });\n\n            return { items: localItems };\n          },\n\n          // Feature sync is handled automatically by the post-operation hook infrastructure\n        },\n      });\n    };\n\n    return factory as unknown as ResourceCustomServiceImplementationFactory;\n  });\n}\n\n// ════════════════════════════════════════════════════════════════════\n// ADD_ADDON\n// ════════════════════════════════════════════════════════════════════\n\n/**\n * Create ADD_ADDON custom impl factories for all subscription variants.\n *\n * ADD_ADDON adds an addon product to the existing subscription.\n *   PREFIX:  validates addon product (type, requiredPlanTiers), builds provider items,\n *            calls provider updateSubscription(), returns update payload with expanded items\n *   CORE:    standard UPDATE writes new items to DB\n *   (Feature sync handled by post-operation hook)\n */\nexport function createSubscriptionAddAddonFactories(): ResourceCustomServiceImplementationFactory[] {\n  return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {\n    const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n      return createResourceCustomServiceImplementation({\n        operationPath: {\n          resourceIdentifier: variantResourceType,\n          operationIdentifier: BillingSubscription_Operations.ADD_ADDON,\n          variantType: ResourceOperationVariantType.API_CALL,\n          isOperationDefault: true,\n        },\n        requestDtoSchema: BillingSubscription_AddAddonRequestDto,\n        handlers: {\n          prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n            const subscription = utils.currentObject;\n            validateProviderSubscription(subscription, _id!, executionContext, utils);\n\n            // Resolve addon product and validate\n            // ACQUIRE: an add-on is being bought.\n            const addonProduct = await readProductByKey(input.addonProductKey, BillingCatalogReadIntent.ACQUIRE, executionContext, utils);\n            if (addonProduct.type !== ProductType.ADDON) {\n              throw utils.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.BILLING_INVALID_PRODUCT_TYPE,\n                context: { productKey: input.addonProductKey, expectedType: ProductType.ADDON, actualType: addonProduct.type },\n              });\n            }\n\n            // Validate requiredPlanTiers\n            if (addonProduct.requiredPlanTiers && addonProduct.requiredPlanTiers.length > 0) {\n              const planItemForTier = await resolvePlanItem(subscription, executionContext, utils);\n              const currentPlanTier = planItemForTier\n                ? (await readProductById(planItemForTier.productId, executionContext, utils)).planTier\n                : undefined;\n              if (!currentPlanTier || !addonProduct.requiredPlanTiers.includes(currentPlanTier)) {\n                throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n                  customMessageReference: ErrorCustomMessageReference.BILLING_PLAN_TIER_REQUIRED,\n                  context: { addonProductKey: input.addonProductKey, requiredTiers: addonProduct.requiredPlanTiers, currentTier: currentPlanTier ?? null },\n                });\n              }\n            }\n\n            // Resolve addon price — and prove it belongs to the addon product. Same defect shape as\n            // CHANGE_PLAN: the addon's entitlements come from `addonProduct._id` on the local item\n            // while the provider is billed `addonPrice.providerPriceId`.\n            const addonPrice = await readPriceForProduct(input.priceId, addonProduct, executionContext, utils);\n            if (!addonPrice.providerPriceId) {\n              throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.BILLING_NO_PROVIDER_PRICE,\n                context: { priceId: input.priceId, productKey: input.addonProductKey },\n              });\n            }\n\n            // Build provider items: existing items + new addon\n            const existingProviderItems = await resolveProviderItems(subscription.items, executionContext, utils);\n            existingProviderItems.push({\n              providerPriceId: addonPrice.providerPriceId,\n              quantity: 1,\n            });\n\n            const provider = getBillingProvider();\n            await provider.updateSubscription(subscription.providerSubscriptionId, {\n              items: existingProviderItems,\n            });\n\n            // Build local items with the new addon appended\n            const newItems = [\n              ...subscription.items,\n              {\n                _id: `${subscription.providerSubscriptionId}_item_${subscription.items.length}`,\n                productId: addonProduct._id,\n                priceId: addonPrice._id,\n                quantity: 1,\n              },\n            ];\n\n            return { items: newItems };\n          },\n\n          // Feature sync is handled automatically by the post-operation hook infrastructure\n        },\n      });\n    };\n\n    return factory as unknown as ResourceCustomServiceImplementationFactory;\n  });\n}\n\n// ════════════════════════════════════════════════════════════════════\n// REMOVE_ADDON\n// ════════════════════════════════════════════════════════════════════\n\n/**\n * Create REMOVE_ADDON custom impl factories for all subscription variants.\n *\n * REMOVE_ADDON removes an addon product from the subscription.\n *   PREFIX:  finds addon item, builds remaining items, calls provider updateSubscription(),\n *            returns update payload with remaining items\n *   CORE:    standard UPDATE writes remaining items to DB\n *   (Feature sync handled by post-operation hook)\n */\nexport function createSubscriptionRemoveAddonFactories(): ResourceCustomServiceImplementationFactory[] {\n  return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {\n    const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n      return createResourceCustomServiceImplementation({\n        operationPath: {\n          resourceIdentifier: variantResourceType,\n          operationIdentifier: BillingSubscription_Operations.REMOVE_ADDON,\n          variantType: ResourceOperationVariantType.API_CALL,\n          isOperationDefault: true,\n        },\n        requestDtoSchema: BillingSubscription_RemoveAddonRequestDto,\n        handlers: {\n          prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n            const subscription = utils.currentObject;\n            validateProviderSubscription(subscription, _id!, executionContext, utils);\n\n            // Resolve addon product\n            /*\n             * REFERENCE, deliberately — the ONE site of the four that must not refuse a retired\n             * product. This resolves the add-on the subscription ALREADY carries in order to drop\n             * it, so gating it would trap a customer on the very add-on the catalogue withdrew.\n             */\n            const addonProduct = await readProductByKey(input.addonProductKey, BillingCatalogReadIntent.REFERENCE, executionContext, utils);\n\n            // Find and remove the addon item\n            const remainingItems = subscription.items.filter((item: any) => item.productId !== addonProduct._id);\n            if (remainingItems.length === subscription.items.length) {\n              throw utils.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.BILLING_ADDON_NOT_ON_SUBSCRIPTION,\n                context: { addonProductKey: input.addonProductKey, subscriptionId: _id },\n              });\n            }\n\n            // Build provider items from remaining items\n            const providerItems = await resolveProviderItems(remainingItems, executionContext, utils);\n\n            const provider = getBillingProvider();\n            await provider.updateSubscription(subscription.providerSubscriptionId, {\n              items: providerItems,\n            });\n\n            return { items: remainingItems };\n          },\n\n          // Feature sync is handled automatically by the post-operation hook infrastructure\n        },\n      });\n    };\n\n    return factory as unknown as ResourceCustomServiceImplementationFactory;\n  });\n}\n"]}
+{"version":3,"file":"subscription.mutations.custom-impl.backend.service.js","sourceRoot":"","sources":["../../../../../src/billing/services/custom-impl/subscription.mutations.custom-impl.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Subscription Mutations Custom Implementations\n *\n * Implements CANCEL, RESUME, CHANGE_PLAN, ADD_ADDON, REMOVE_ADDON operations\n * on subscription polymorphic variants.\n *\n * Pattern: PREFIX_CORE_OPERATIONS\n *   PREFIX  → validate, call billing provider (Stripe), return update payload\n *   CORE    → standard UPDATE (engine handles DB write)\n *   Feature sync is handled automatically by the post-operation hook infrastructure.\n *\n * One factory per polymorphic variant (org, user) per operation.\n * All variants share the same handler logic.\n *\n * @see billing-polymorphic-full-implementation.md §4.2 + §4.3\n */\n\nimport {\n  CoreResourceType,\n  ResourceOperationVariantType,\n  SubscriptionStatus,\n  ErrorType,\n  ErrorCustomMessageReference,\n  ProductType,\n  ProrationBehavior,\n  BillingTiming,\n  BillingSubscription_Operations,\n  BillingSubscription_CancelRequestDto,\n  BillingSubscription_ChangePlanRequestDto,\n  BillingSubscription_AddAddonRequestDto,\n  BillingSubscription_RemoveAddonRequestDto,\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, getBillingConfig } from '~wildo-backend-lib/billing/services/custom-impl/billing-custom-implementations.backend';\nimport {\n  BillingCatalogReadIntent,\n  readProductByKey,\n  readProductById,\n  readPriceById,\n  readPriceForProduct,\n  validateProviderSubscription,\n  resolveProviderItems,\n} from '~wildo-backend-lib/billing/services/custom-impl/billing-custom-impl-utils.backend';\n\n// ── Subscription polymorphic variant types ───────────────────────────\n\nconst SUBSCRIPTION_VARIANT_TYPES = [\n  CoreResourceType.ORGANIZATION_SUBSCRIPTIONS,\n  CoreResourceType.USER_SUBSCRIPTIONS,\n] as const;\n\n/**\n * The subscription item carrying the PLAN, or `null` when a subscription holds only addons.\n *\n * A subscription's items are a plan plus any addons, and three places in this file needed to find\n * the plan among them — the change-plan path, the addon plan-tier gate, and now the cancellation\n * policy (#408). Each had its own inline loop. One helper because \"which item is the plan\" is a\n * single question with a single answer, and three copies is how the fourth one comes to differ.\n */\nasync function resolvePlanItem(\n  subscription: { items: Array<{ productId: string }> },\n  executionContext: Parameters<typeof readProductById>[1],\n  utils: Parameters<typeof readProductById>[2],\n): Promise<{ productId: string } | null> {\n  for (const item of subscription.items) {\n    const itemProduct = await readProductById(item.productId, executionContext, utils);\n    if (itemProduct.type === ProductType.PLAN) {\n      return item;\n    }\n  }\n  return null;\n}\n\n// ════════════════════════════════════════════════════════════════════\n// CANCEL\n// ════════════════════════════════════════════════════════════════════\n\nexport function createSubscriptionCancelFactories(): ResourceCustomServiceImplementationFactory[] {\n  return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {\n    const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n      return createResourceCustomServiceImplementation({\n        operationPath: {\n          resourceIdentifier: variantResourceType,\n          operationIdentifier: BillingSubscription_Operations.CANCEL,\n          variantType: ResourceOperationVariantType.API_CALL,\n          isOperationDefault: true,\n        },\n        requestDtoSchema: BillingSubscription_CancelRequestDto,\n        handlers: {\n          prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n            const subscription = utils.currentObject;\n            validateProviderSubscription(subscription, _id!, executionContext, utils);\n\n            /*\n             * `ProductBehaviorPolicy.cancellation` now governs this operation (#408, decided\n             * 2026-09-08). Until then it was read by NOTHING: timing came solely from the caller's\n             * `cancelImmediately` flag, so a product declaring that immediate cancellation is not\n             * allowed could not refuse one — and Wonder Todos authors `allowImmediate: false` on\n             * BOTH plans, unenforced.\n             *\n             * Two distinct things come from the policy, and conflating them was the trap:\n             *   - `allowImmediate` is a REFUSAL. A caller who asks for immediate cancellation\n             *     against a product that forbids it gets a 409, not a silent downgrade to\n             *     period-end. Silently honouring the safer timing would tell the caller their\n             *     subscription had ended when it has not, which is worse than refusing.\n             *   - `defaultBehavior` decides the timing when the caller expresses NO preference.\n             *     `cancelImmediately` is optional on the request DTO, so \"absent\" is a real state\n             *     and is where an authored default belongs.\n             *\n             * The policy is read from the subscription's PLAN product, resolved the same way the\n             * change-plan path above resolves it. An addon does not carry the cancellation policy\n             * of the subscription it rides on.\n             */\n            const planItem = await resolvePlanItem(subscription, executionContext, utils);\n            const planProduct = planItem\n              ? await readProductById(planItem.productId, executionContext, utils)\n              : null;\n            const cancellationPolicy = planProduct?.behaviorPolicy?.cancellation;\n\n            const requestedImmediate = input.cancelImmediately;\n            if (requestedImmediate === true && cancellationPolicy?.allowImmediate === false) {\n              throw utils.errorBuilder.buildError(ErrorType.CONFLICT, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.CONFLICT,\n                context: {\n                  reason: 'billing_product_forbids_immediate_cancellation',\n                  message: 'This plan does not allow immediate cancellation; it can only be cancelled at the end of the current period.',\n                  productKey: planProduct?.key,\n                },\n              });\n            }\n\n            /*\n             * Absent preference resolves down a chain, most specific first: the caller, the plan\n             * product's own default, the application's `defaultCancellation`, then period-end.\n             *\n             * The application-level step is what makes `billing.defaultBehaviorPolicy.defaultCancellation`\n             * mean something. It was dead alongside its neighbours, and it is BOUND rather than\n             * relabelled because — unlike grace periods and retry counts, which are dunning settings\n             * living at the provider — cancellation timing is resolved locally. The only thing\n             * standing between that key and an effect was a reader.\n             *\n             * Period-end is the floor because it never ends access a customer has already paid for.\n             */\n            const resolvedTiming = cancellationPolicy?.defaultBehavior\n              ?? getBillingConfig().defaultBehaviorPolicy?.defaultCancellation;\n            const cancelImmediately = requestedImmediate\n              ?? (resolvedTiming === BillingTiming.IMMEDIATE);\n            const atPeriodEnd = !cancelImmediately;\n\n            const provider = getBillingProvider();\n            await provider.cancelSubscription(subscription.providerSubscriptionId, { atPeriodEnd });\n\n            return {\n              cancelAtPeriodEnd: atPeriodEnd,\n              cancelledAt: new Date(),\n              ...(!atPeriodEnd && { status: SubscriptionStatus.CANCELLED }),\n              ...(input.reason && { cancellationReason: input.reason }),\n            };\n          },\n\n          // Feature sync is handled automatically by the post-operation hook infrastructure\n        },\n      });\n    };\n\n    return factory as unknown as ResourceCustomServiceImplementationFactory;\n  });\n}\n\n// ════════════════════════════════════════════════════════════════════\n// RESUME\n// ════════════════════════════════════════════════════════════════════\n\n/**\n * Create RESUME custom impl factories for all subscription variants.\n *\n * RESUME un-cancels a subscription that has cancelAtPeriodEnd = true.\n *   PREFIX:  validates subscription is pending cancellation, calls provider resumeSubscription()\n *   CORE:    standard UPDATE clears cancellation fields\n *   (Feature sync handled by post-operation hook)\n */\nexport function createSubscriptionResumeFactories(): ResourceCustomServiceImplementationFactory[] {\n  return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {\n    const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n      return createResourceCustomServiceImplementation({\n        operationPath: {\n          resourceIdentifier: variantResourceType,\n          operationIdentifier: BillingSubscription_Operations.RESUME,\n          variantType: ResourceOperationVariantType.API_CALL,\n          isOperationDefault: true,\n        },\n        handlers: {\n          prefixCoreOperations: async (_id, _input, executionContext, _operationPath, utils) => {\n            const subscription = utils.currentObject;\n            validateProviderSubscription(subscription, _id!, executionContext, utils);\n\n            if (!subscription.cancelAtPeriodEnd) {\n              throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.BILLING_NO_ACTIVE_SUBSCRIPTION,\n                context: { subscriptionId: _id, reason: 'Subscription is not pending cancellation' },\n              });\n            }\n\n            const provider = getBillingProvider();\n            await provider.resumeSubscription(subscription.providerSubscriptionId);\n\n            return {\n              cancelAtPeriodEnd: false,\n              cancelledAt: null,\n              cancellationReason: null,\n              status: SubscriptionStatus.ACTIVE,\n            };\n          },\n\n          // Feature sync is handled automatically by the post-operation hook infrastructure\n        },\n      });\n    };\n\n    return factory as unknown as ResourceCustomServiceImplementationFactory;\n  });\n}\n\n// ════════════════════════════════════════════════════════════════════\n// CHANGE_PLAN\n// ════════════════════════════════════════════════════════════════════\n\n/**\n * Create CHANGE_PLAN custom impl factories for all subscription variants.\n *\n * CHANGE_PLAN upgrades or downgrades the subscription plan.\n *   PREFIX:  resolves new product/price, determines proration, builds provider items,\n *            calls provider updateSubscription(), returns update payload with new items\n *   CORE:    standard UPDATE writes new items to DB\n *   (Feature sync handled by post-operation hook)\n */\nexport function createSubscriptionChangePlanFactories(): ResourceCustomServiceImplementationFactory[] {\n  return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {\n    const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n      return createResourceCustomServiceImplementation({\n        operationPath: {\n          resourceIdentifier: variantResourceType,\n          operationIdentifier: BillingSubscription_Operations.CHANGE_PLAN,\n          variantType: ResourceOperationVariantType.API_CALL,\n          isOperationDefault: true,\n        },\n        requestDtoSchema: BillingSubscription_ChangePlanRequestDto,\n        handlers: {\n          prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n            const subscription = utils.currentObject;\n            validateProviderSubscription(subscription, _id!, executionContext, utils);\n\n            // ACQUIRE: the subscription is being moved ONTO this product.\n            const newProduct = await readProductByKey(input.newProductKey, BillingCatalogReadIntent.ACQUIRE, executionContext, utils);\n            // The price MUST belong to the product being switched to. These were resolved\n            // independently, so pairing a premium `newProductKey` with a cheap `newPriceId` billed the\n            // provider the cheap price while the local item — and every entitlement derived from\n            // `item.productId` — recorded the premium product.\n            const newPrice = await readPriceForProduct(input.newPriceId, newProduct, executionContext, utils);\n\n            if (!newPrice.providerPriceId) {\n              throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.BILLING_NO_PROVIDER_PRICE,\n                context: { priceId: input.newPriceId, productKey: input.newProductKey },\n              });\n            }\n\n            // Find the current plan item (type === PLAN) and determine upgrade/downgrade\n            const currentPlanItem = await resolvePlanItem(subscription, executionContext, utils);\n            const planItemIndex = currentPlanItem ? subscription.items.indexOf(currentPlanItem as typeof subscription.items[number]) : -1;\n\n            // Build provider items: replace plan item, preserve addons\n            const providerItems: Array<{ providerSubscriptionItemId?: string; providerPriceId: string; quantity: number }> = [];\n            const localItems: Array<any> = [];\n\n            for (let i = 0; i < subscription.items.length; i++) {\n              if (i === planItemIndex) {\n                providerItems.push({\n                  providerSubscriptionItemId: subscription.items[i].providerSubscriptionItemId,\n                  providerPriceId: newPrice.providerPriceId,\n                  quantity: 1,\n                });\n                localItems.push({\n                  _id: subscription.items[i]._id,\n                  productId: newProduct._id,\n                  priceId: newPrice._id,\n                  quantity: 1,\n                });\n              } else {\n                const price = await readPriceById(subscription.items[i].priceId, executionContext, utils);\n                providerItems.push({\n                  providerSubscriptionItemId: subscription.items[i].providerSubscriptionItemId,\n                  providerPriceId: price.providerPriceId || subscription.items[i].priceId,\n                  quantity: subscription.items[i].quantity,\n                });\n                localItems.push(subscription.items[i]);\n              }\n            }\n\n            // If no plan item found, prepend the new plan\n            if (planItemIndex === -1) {\n              providerItems.unshift({ providerPriceId: newPrice.providerPriceId, quantity: 1 });\n              localItems.unshift({\n                _id: `${subscription.providerSubscriptionId}_item_plan`,\n                productId: newProduct._id,\n                priceId: newPrice._id,\n                quantity: 1,\n              });\n            }\n\n            // Determine proration from product behavior policy\n            const currentProduct = planItemIndex >= 0\n              ? await readProductById(subscription.items[planItemIndex].productId, executionContext, utils)\n              : null;\n            const isUpgrade = currentProduct\n              ? (newProduct.planTierOrder ?? 0) > (currentProduct.planTierOrder ?? 0)\n              : true;\n            const config = getBillingConfig();\n            const policy = isUpgrade\n              ? (newProduct.behaviorPolicy?.upgrade ?? { proration: config.defaultBehaviorPolicy.defaultProration, timing: BillingTiming.IMMEDIATE })\n              : (newProduct.behaviorPolicy?.downgrade ?? { proration: ProrationBehavior.NONE, timing: BillingTiming.AT_PERIOD_END });\n\n            const provider = getBillingProvider();\n            await provider.updateSubscription(subscription.providerSubscriptionId, {\n              items: providerItems,\n              /*\n               * The resolved proration, as a REQUEST FIELD (#516).\n               *\n               * It was `metadata.prorationBehavior` until 2026-09-08 — a free-form key/value bag the\n               * provider stores and never reads — so this policy was correctly resolved from the target\n               * product's `upgrade`/`downgrade` block and then discarded at the boundary. A product\n               * declaring `ProrationBehavior.NONE` for a downgrade was prorated anyway, by the\n               * provider's account default. Wonder Todos authors exactly that.\n               */\n              prorationBehavior: policy.proration,\n              metadata: {\n                /*\n                 * TIMING remains metadata, and that is honest rather than an oversight: a provider's\n                 * proration parameter says HOW a change settles, not WHEN it applies. Deferring a\n                 * change to the period end needs a subscription schedule, which is a different call and\n                 * a different mechanism — so `prorationTiming` is still carried for a connector that\n                 * grows one, and still changes nothing today. Do not read this field's presence as the\n                 * timing being honoured.\n                 */\n                prorationTiming: policy.timing,\n              },\n            });\n\n            return { items: localItems };\n          },\n\n          // Feature sync is handled automatically by the post-operation hook infrastructure\n        },\n      });\n    };\n\n    return factory as unknown as ResourceCustomServiceImplementationFactory;\n  });\n}\n\n// ════════════════════════════════════════════════════════════════════\n// ADD_ADDON\n// ════════════════════════════════════════════════════════════════════\n\n/**\n * Create ADD_ADDON custom impl factories for all subscription variants.\n *\n * ADD_ADDON adds an addon product to the existing subscription.\n *   PREFIX:  validates addon product (type, requiredPlanTiers), builds provider items,\n *            calls provider updateSubscription(), returns update payload with expanded items\n *   CORE:    standard UPDATE writes new items to DB\n *   (Feature sync handled by post-operation hook)\n */\nexport function createSubscriptionAddAddonFactories(): ResourceCustomServiceImplementationFactory[] {\n  return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {\n    const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n      return createResourceCustomServiceImplementation({\n        operationPath: {\n          resourceIdentifier: variantResourceType,\n          operationIdentifier: BillingSubscription_Operations.ADD_ADDON,\n          variantType: ResourceOperationVariantType.API_CALL,\n          isOperationDefault: true,\n        },\n        requestDtoSchema: BillingSubscription_AddAddonRequestDto,\n        handlers: {\n          prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n            const subscription = utils.currentObject;\n            validateProviderSubscription(subscription, _id!, executionContext, utils);\n\n            // Resolve addon product and validate\n            // ACQUIRE: an add-on is being bought.\n            const addonProduct = await readProductByKey(input.addonProductKey, BillingCatalogReadIntent.ACQUIRE, executionContext, utils);\n            if (addonProduct.type !== ProductType.ADDON) {\n              throw utils.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.BILLING_INVALID_PRODUCT_TYPE,\n                context: { productKey: input.addonProductKey, expectedType: ProductType.ADDON, actualType: addonProduct.type },\n              });\n            }\n\n            // Validate requiredPlanTiers\n            if (addonProduct.requiredPlanTiers && addonProduct.requiredPlanTiers.length > 0) {\n              const planItemForTier = await resolvePlanItem(subscription, executionContext, utils);\n              const currentPlanTier = planItemForTier\n                ? (await readProductById(planItemForTier.productId, executionContext, utils)).planTier\n                : undefined;\n              if (!currentPlanTier || !addonProduct.requiredPlanTiers.includes(currentPlanTier)) {\n                throw utils.errorBuilder.buildError(ErrorType.BUSINESS_RULE, executionContext, {\n                  customMessageReference: ErrorCustomMessageReference.BILLING_PLAN_TIER_REQUIRED,\n                  context: { addonProductKey: input.addonProductKey, requiredTiers: addonProduct.requiredPlanTiers, currentTier: currentPlanTier ?? null },\n                });\n              }\n            }\n\n            // Resolve addon price — and prove it belongs to the addon product. Same defect shape as\n            // CHANGE_PLAN: the addon's entitlements come from `addonProduct._id` on the local item\n            // while the provider is billed `addonPrice.providerPriceId`.\n            const addonPrice = await readPriceForProduct(input.priceId, addonProduct, executionContext, utils);\n            if (!addonPrice.providerPriceId) {\n              throw utils.errorBuilder.buildError(ErrorType.CONFIGURATION, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.BILLING_NO_PROVIDER_PRICE,\n                context: { priceId: input.priceId, productKey: input.addonProductKey },\n              });\n            }\n\n            // Build provider items: existing items + new addon\n            const existingProviderItems = await resolveProviderItems(subscription.items, executionContext, utils);\n            existingProviderItems.push({\n              providerPriceId: addonPrice.providerPriceId,\n              quantity: 1,\n            });\n\n            const provider = getBillingProvider();\n            await provider.updateSubscription(subscription.providerSubscriptionId, {\n              items: existingProviderItems,\n            });\n\n            // Build local items with the new addon appended\n            const newItems = [\n              ...subscription.items,\n              {\n                _id: `${subscription.providerSubscriptionId}_item_${subscription.items.length}`,\n                productId: addonProduct._id,\n                priceId: addonPrice._id,\n                quantity: 1,\n              },\n            ];\n\n            return { items: newItems };\n          },\n\n          // Feature sync is handled automatically by the post-operation hook infrastructure\n        },\n      });\n    };\n\n    return factory as unknown as ResourceCustomServiceImplementationFactory;\n  });\n}\n\n// ════════════════════════════════════════════════════════════════════\n// REMOVE_ADDON\n// ════════════════════════════════════════════════════════════════════\n\n/**\n * Create REMOVE_ADDON custom impl factories for all subscription variants.\n *\n * REMOVE_ADDON removes an addon product from the subscription.\n *   PREFIX:  finds addon item, builds remaining items, calls provider updateSubscription(),\n *            returns update payload with remaining items\n *   CORE:    standard UPDATE writes remaining items to DB\n *   (Feature sync handled by post-operation hook)\n */\nexport function createSubscriptionRemoveAddonFactories(): ResourceCustomServiceImplementationFactory[] {\n  return SUBSCRIPTION_VARIANT_TYPES.map((variantResourceType) => {\n    const factory = (_resourcesRegistryService: ResourcesRegistryBackendService) => {\n      return createResourceCustomServiceImplementation({\n        operationPath: {\n          resourceIdentifier: variantResourceType,\n          operationIdentifier: BillingSubscription_Operations.REMOVE_ADDON,\n          variantType: ResourceOperationVariantType.API_CALL,\n          isOperationDefault: true,\n        },\n        requestDtoSchema: BillingSubscription_RemoveAddonRequestDto,\n        handlers: {\n          prefixCoreOperations: async (_id, input, executionContext, _operationPath, utils) => {\n            const subscription = utils.currentObject;\n            validateProviderSubscription(subscription, _id!, executionContext, utils);\n\n            // Resolve addon product\n            /*\n             * REFERENCE, deliberately — the ONE site of the four that must not refuse a retired\n             * product. This resolves the add-on the subscription ALREADY carries in order to drop\n             * it, so gating it would trap a customer on the very add-on the catalogue withdrew.\n             */\n            const addonProduct = await readProductByKey(input.addonProductKey, BillingCatalogReadIntent.REFERENCE, executionContext, utils);\n\n            // Find and remove the addon item\n            const remainingItems = subscription.items.filter((item: any) => item.productId !== addonProduct._id);\n            if (remainingItems.length === subscription.items.length) {\n              throw utils.errorBuilder.buildError(ErrorType.NOT_FOUND, executionContext, {\n                customMessageReference: ErrorCustomMessageReference.BILLING_ADDON_NOT_ON_SUBSCRIPTION,\n                context: { addonProductKey: input.addonProductKey, subscriptionId: _id },\n              });\n            }\n\n            // Build provider items from remaining items\n            const providerItems = await resolveProviderItems(remainingItems, executionContext, utils);\n\n            const provider = getBillingProvider();\n            await provider.updateSubscription(subscription.providerSubscriptionId, {\n              items: providerItems,\n            });\n\n            return { items: remainingItems };\n          },\n\n          // Feature sync is handled automatically by the post-operation hook infrastructure\n        },\n      });\n    };\n\n    return factory as unknown as ResourceCustomServiceImplementationFactory;\n  });\n}\n"]}

package/dist/esm/billing/services/stripe-standard-billing-provider.backend.service.d.ts

@@ -40,12 +40,15 @@ export declare class StripeStandardBillingProvider implements StandardBilling_In
     /**
      * One page of the customer's invoices, newest first.
      *
-     * `total` rather than `amount_paid`, deliberately, and it disagrees with what the webhook router
-     * records for the same invoice. The router reads `amount_paid ?? total`, which is `0` for every
-     * invoice that is finalized-but-unpaid — so an OPEN invoice lands locally at zero. That reading is
-     * not corrected here (it is a separate finding on a separate write path); what this file
-     * guarantees is that the two never fight, because the reconciliation sweep only ever INSERTS a
-     * total and never updates one.
+     * `total` rather than `amount_paid`, deliberately — the local field is the invoice's TOTAL, and
+     * `amount_paid` is a different fact about money that has no home on that row.
+     *
+     * The webhook router used to disagree here: it read `amount_paid ?? total`, which is `0` for every
+     * invoice that is finalized-but-unpaid, so an OPEN invoice landed locally at zero. That was
+     * corrected on its own write path (2026-09-09) and both writers now read `total`. The structural
+     * guarantee is unchanged and is what makes the agreement safe rather than merely current: the
+     * reconciliation sweep only ever INSERTS a total and never updates one, so the two cannot fight
+     * over money on a tick even if they were to diverge again.
      *
      * An invoice whose Stripe status is not in {@link STRIPE_INVOICE_STATUS_MAP} is SKIPPED rather
      * than defaulted. A defaulted status is a wrong fact about money written into a durable row; an

package/dist/esm/billing/services/stripe-standard-billing-provider.backend.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stripe-standard-billing-provider.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/billing/services/stripe-standard-billing-provider.backend.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"stripe-standard-billing-provider.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/billing/services/stripe-standard-billing-provider.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/billing/services/stripe-standard-billing-provider.backend.service.js

@@ -351,12 +351,15 @@ export class StripeStandardBillingProvider {
     /**
      * One page of the customer's invoices, newest first.
      *
-     * `total` rather than `amount_paid`, deliberately, and it disagrees with what the webhook router
-     * records for the same invoice. The router reads `amount_paid ?? total`, which is `0` for every
-     * invoice that is finalized-but-unpaid — so an OPEN invoice lands locally at zero. That reading is
-     * not corrected here (it is a separate finding on a separate write path); what this file
-     * guarantees is that the two never fight, because the reconciliation sweep only ever INSERTS a
-     * total and never updates one.
+     * `total` rather than `amount_paid`, deliberately — the local field is the invoice's TOTAL, and
+     * `amount_paid` is a different fact about money that has no home on that row.
+     *
+     * The webhook router used to disagree here: it read `amount_paid ?? total`, which is `0` for every
+     * invoice that is finalized-but-unpaid, so an OPEN invoice landed locally at zero. That was
+     * corrected on its own write path (2026-09-09) and both writers now read `total`. The structural
+     * guarantee is unchanged and is what makes the agreement safe rather than merely current: the
+     * reconciliation sweep only ever INSERTS a total and never updates one, so the two cannot fight
+     * over money on a tick even if they were to diverge again.
      *
      * An invoice whose Stripe status is not in {@link STRIPE_INVOICE_STATUS_MAP} is SKIPPED rather
      * than defaulted. A defaulted status is a wrong fact about money written into a durable row; an