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

package/dist/esm/billing/services/back-office/product-catalog-sync.backend.service.d.ts

@@ -28,6 +28,20 @@ export interface ProductCatalogSyncResult {
     created: number;
     updated: number;
     featuresDirty: string[];
+    /**
+     * Keys that exist in the DATABASE and no longer in the code catalogue, and were soft-retired by
+     * this run (`isActive: false` on the product and every one of its prices).
+     */
+    retired: string[];
+    /**
+     * Retired keys that STILL HAVE LIVE SUBSCRIBERS. Reported, never acted on — see
+     * {@link ProductCatalogSyncBackendService.reconcileRetiredProducts} for why the framework refuses
+     * to decide what happens to those customers.
+     */
+    retiredWithLiveSubscribers: Array<{
+        productKey: string;
+        liveSubscriptions: number;
+    }>;
     errors: string[];
 }
 export declare class ProductCatalogSyncBackendService extends AbstractBillingBackendService {
@@ -62,6 +76,77 @@ export declare class ProductCatalogSyncBackendService extends AbstractBillingBac
      * Idempotent and safe to run multiple times.
      */
     syncProductCatalog(): Promise<ProductCatalogSyncResult>;
+    /**
+     * Soft-retire every local product whose key has left the code catalogue.
+     *
+     * ## What was wrong
+     *
+     * `syncProductCatalog` iterated `this.productCatalog` and nothing else, so it could only ever ADD
+     * and UPDATE. A key deleted from the code catalogue left its `Product` row `isActive: true`, its
+     * `Price` rows active, and its provider product and prices live — and because the purchase path
+     * reads the DATABASE rather than the code catalogue, a product that no longer existed in code
+     * could still be bought, granting whatever `grantedFeatures` the last sync happened to write.
+     *
+     * ## The policy, stated because it changes what a paying customer experiences
+     *
+     * **Retire LOCALLY, always. Report the provider. Never migrate a subscriber. Never delete.**
+     *
+     * - **`isActive: false` on the product and on every one of its prices, unconditionally** — even
+     *   when subscribers are on it. It is entitlement-SAFE, which is the fact that makes the policy
+     *   possible: `BillingFeatureSyncBackendService.getProduct` resolves a subscription item's product
+     *   by `_id` with no `isActive` filter, and renewal happens entirely at the provider against the
+     *   provider price, which this does not touch. So an existing subscriber keeps their features and
+     *   keeps renewing; what stops is NEW acquisition, through the gate in
+     *   `readProductByKey(..., BillingCatalogReadIntent.ACQUIRE, ...)`.
+     *
+     * - **The PROVIDER catalogue is left completely alone.** REJECTED ALTERNATIVE: archive the
+     *   provider product and prices in the same pass. The provider is the party that actually charges,
+     *   and archiving a price a live subscription renews against is a customer-visible failed renewal
+     *   — the exact outcome this whole policy is arranged to avoid. It would also mean adding a
+     *   destructive provider write (`StandardBilling_Interface` has no archive verb today) in the same
+     *   change as the sweep that calls it. An operator archives provider rows deliberately, after
+     *   deciding what happens to the subscribers, and the report below is what tells them to.
+     *
+     * - **A retired key WITH LIVE SUBSCRIBERS is reported and otherwise untouched.** REJECTED
+     *   ALTERNATIVE: migrate them to the nearest surviving plan tier, or cancel them. Which plan a
+     *   customer should move to — and whether they should be moved at all rather than grandfathered —
+     *   is a commercial decision with a price attached, and a framework that guesses it either
+     *   overcharges someone or cancels a paying customer because a key was deleted in a refactor.
+     *   The count is reported at error level so the decision is put in front of a human.
+     *
+     * - **Nothing is ever deleted.** The `Product` and `Price` rows are the only local record of what
+     *   a RETAINED subscription and its retained invoices refer to, and billing rows deliberately
+     *   survive the deletion of their scope for a tax/audit obligation. Deleting a retired product
+     *   would strand exactly the trail that retention exists to preserve.
+     */
+    private reconcileRetiredProducts;
+    /**
+     * How many LIVE subscriptions reference each product, across every billing scope.
+     *
+     * Built by paging live subscriptions and reading their items, rather than by filtering on
+     * `items.productId` per product. Two reasons: a nested-path filter over an array is a document-store
+     * idiom that does not translate to the PostgreSQL adapter's JSON column, and one pass over the live
+     * set answers the question for every retired product at once instead of one query each.
+     */
+    private collectProductIdsWithLiveSubscriptions;
+    /**
+     * `isActive: false` on the product and on every price beneath it.
+     *
+     * The prices matter as much as the product: an application that lists prices directly, or a caller
+     * that names a price id, would otherwise still transact against a retired product's price — and
+     * `readPriceForProduct` refuses on the PRICE's own flag, so leaving them active would leave a
+     * second door open on the surface the gate was built for.
+     */
+    private deactivateProductAndPrices;
+    /** One page of the live-subscription scan. */
+    private static readonly SUBSCRIPTION_SCAN_PAGE_SIZE;
+    /**
+     * Page ceiling for the live-subscription scan. Reaching it UNDER-counts, which is the safe
+     * direction here for exactly one reason: the count only ever decides whether a WARNING is emitted
+     * — the retirement itself is unconditional — so a missed page costs a quieter log line, never a
+     * different write.
+     */
+    private static readonly MAX_SUBSCRIPTION_SCAN_PAGES;
     private findProductByKey;
     private upsertProduct;
     private upsertPrices;
@@ -83,6 +168,21 @@ export declare class ProductCatalogSyncBackendService extends AbstractBillingBac
      * provider catalog stale.
      */
     private syncUnsyncedPricesToProvider;
+    /**
+     * One amount, converted from its authored scale to the currency's smallest unit — or a throw naming
+     * exactly why it cannot be (#515).
+     *
+     * Throws rather than returning a result, because every caller is inside the per-price `try` and the
+     * only correct response to any of the three failures is the same: do not sync this price. Returning
+     * a union here would give each of the three call sites its own chance to forget one.
+     *
+     * **The currency is passed in rather than read off the value**, and that is the second half of the
+     * defect. A tier's `unitPrice`/`flatPrice` carry an OPTIONAL currency — they inherit the price's —
+     * so reading each amount's own currency would resolve a scale per amount and let one price be
+     * converted at up to three different ones. One price is denominated in one currency; the amounts
+     * are its parts.
+     */
+    private toProviderAmountOrThrow;
     /**
      * Check if a product's features/limits have changed relative to the catalog definition.
      * If so, all subscriptions using this product need feature recomputation.

package/dist/esm/billing/services/back-office/product-catalog-sync.backend.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"product-catalog-sync.backend.service.d.ts","sourceRoot":"","sources":["../../../../../../src/billing/services/back-office/product-catalog-sync.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,OAAO,EAOb,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEtF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kFAAkF,CAAC;AAEjI,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,6FAA6F,CAAC;AACzJ,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,+EAA+E,CAAC;AAC3I,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0EAA0E,CAAC;AAChI,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAMnH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD,qBACa,gCAAiC,SAAQ,6BAA6B;IAEjF,4DAA4D;IAC5D,OAAO,CAAC,cAAc,CAA2B;gBAGZ,MAAM,EAAE,aAAa,EACG,gBAAgB,EAAE,qCAAqC,EAChD,uBAAuB,EAAE,qCAAqC,EAC5E,iBAAiB,EAAE,+BAA+B,EACtD,YAAY,EAAE,0BAA0B;IAS1F;;OAEG;IACU,UAAU,CACrB,cAAc,EAAE,iBAAiB,EAAE,EACnC,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,IAAI,CAAC;IAWhB;;;OAGG;IACI,qBAAqB,IAAI,iBAAiB,EAAE;IAQnD;;;;;;;;;OASG;IACU,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoCtE;;;;;;OAMG;IACU,kBAAkB,IAAI,OAAO,CAAC,wBAAwB,CAAC;YAiEtD,gBAAgB;YAehB,aAAa;YAkCb,YAAY;IA4C1B;;;;;;;OAOG;IACH,OAAO,CAAC,+BAA+B;YAWzB,qBAAqB;IAsCnC;;;;;;OAMG;YACW,4BAA4B;IAoD1C;;;OAGG;IACH,OAAO,CAAC,eAAe;CAuBxB"}
+{"version":3,"file":"product-catalog-sync.backend.service.d.ts","sourceRoot":"","sources":["../../../../../../src/billing/services/back-office/product-catalog-sync.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,OAAO,EAQb,MAAM,uBAAuB,CAAC;AAK/B,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEtF,OAAO,EAAE,6BAA6B,EAAE,MAAM,kFAAkF,CAAC;AAOjI,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,6FAA6F,CAAC;AACzJ,OAAO,KAAK,EAAE,qCAAqC,EAAE,MAAM,+EAA+E,CAAC;AAC3I,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,0EAA0E,CAAC;AAChI,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAMnH,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,0BAA0B,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrF,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD,qBACa,gCAAiC,SAAQ,6BAA6B;IAEjF,4DAA4D;IAC5D,OAAO,CAAC,cAAc,CAA2B;gBAGZ,MAAM,EAAE,aAAa,EACG,gBAAgB,EAAE,qCAAqC,EAChD,uBAAuB,EAAE,qCAAqC,EAC5E,iBAAiB,EAAE,+BAA+B,EACtD,YAAY,EAAE,0BAA0B;IAS1F;;OAEG;IACU,UAAU,CACrB,cAAc,EAAE,iBAAiB,EAAE,EACnC,QAAQ,EAAE,yBAAyB,GAClC,OAAO,CAAC,IAAI,CAAC;IAWhB;;;OAGG;IACI,qBAAqB,IAAI,iBAAiB,EAAE;IAQnD;;;;;;;;;OASG;IACU,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoCtE;;;;;;OAMG;IACU,kBAAkB,IAAI,OAAO,CAAC,wBAAwB,CAAC;IAiFpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA0CG;YACW,wBAAwB;IAuCtC;;;;;;;OAOG;YACW,sCAAsC;IAiCpD;;;;;;;OAOG;YACW,0BAA0B;IAgBxC,8CAA8C;IAC9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,CAAO;IAE1D;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,2BAA2B,CAAM;YAM3C,gBAAgB;YAehB,aAAa;YAkCb,YAAY;IA4C1B;;;;;;;OAOG;IACH,OAAO,CAAC,+BAA+B;YAWzB,qBAAqB;IAsCnC;;;;;;OAMG;YACW,4BAA4B;IAwE1C;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,uBAAuB;IAY/B;;;OAGG;IACH,OAAO,CAAC,eAAe;CAuBxB"}

package/dist/esm/billing/services/back-office/product-catalog-sync.backend.service.js

@@ -27,14 +27,22 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
+var ProductCatalogSyncBackendService_1;
 import { injectable, inject } from 'inversify';
 import { CoreResourceType, CoreResourceOperation, ErrorType, ErrorCustomMessageReference, deriveTrustedSystemWritePreservedFields, } from '@wildo-ai/saas-models';
+// MoneyValue fields use bigint at an AUTHORED scale; the provider interface uses a number in the
+// CURRENCY's smallest unit. `Number()` alone crosses only the first of those two gaps, which is why
+// it was wrong here for as long as it stood — see `toProviderAmountOrThrow` (#515).
+import { MoneyMinorUnitConversionError, toCurrencyMinorUnitAmountOrThrow } from '@wildo-ai/zod-decorators';
 import { AbstractBillingBackendService } from '../../../billing/services/back-office/abstract-billing.backend.service.js';
+import { TERMINAL_SUBSCRIPTION_STATUSES } from '../../../billing/services/back-office/billing-subject-erasure-effect.backend.js';
+import { BILLING_SCOPE_TO_VARIANTS, } from '../../../billing/services/custom-impl/billing-custom-impl-utils.backend.js';
 import { SAAS_SERVICE_TYPES } from '../../../inject/models/service-types.js';
 // =====================================================
 // Service
 // =====================================================
 let ProductCatalogSyncBackendService = class ProductCatalogSyncBackendService extends AbstractBillingBackendService {
+    static { ProductCatalogSyncBackendService_1 = this; }
     /** The product catalog from code (set at initialization) */
     productCatalog = [];
     constructor(logger, servicesRegistry, executionContextCreator, resourcesRegistry, errorBuilder) {
@@ -121,6 +129,8 @@ let ProductCatalogSyncBackendService = class ProductCatalogSyncBackendService ex
             created: 0,
             updated: 0,
             featuresDirty: [],
+            retired: [],
+            retiredWithLiveSubscribers: [],
             errors: [],
         };
         for (const definition of this.productCatalog) {
@@ -163,10 +173,162 @@ let ProductCatalogSyncBackendService = class ProductCatalogSyncBackendService ex
                 });
             }
         }
+        /*
+         * The other direction, and it runs LAST so that a key present in both is upserted before it is
+         * examined for retirement — otherwise a first-ever sync would race itself.
+         *
+         * A failure here does not fail the sync: pushing the code catalogue is the primary job, and
+         * refusing to do it because the retirement pass could not read subscriptions would make an
+         * unrelated read fault block every deploy.
+         */
+        try {
+            await this.reconcileRetiredProducts(result);
+        }
+        catch (error) {
+            result.errors.push(`Retired-product reconciliation failed: ${error.message}`);
+        }
         this.logDebug('Bulk product catalog sync complete', { ...result });
         return result;
     }
     // ════════════════════════════════════════════════════════════
+    // Retirement — the catalogue's OTHER direction
+    // ════════════════════════════════════════════════════════════
+    /**
+     * Soft-retire every local product whose key has left the code catalogue.
+     *
+     * ## What was wrong
+     *
+     * `syncProductCatalog` iterated `this.productCatalog` and nothing else, so it could only ever ADD
+     * and UPDATE. A key deleted from the code catalogue left its `Product` row `isActive: true`, its
+     * `Price` rows active, and its provider product and prices live — and because the purchase path
+     * reads the DATABASE rather than the code catalogue, a product that no longer existed in code
+     * could still be bought, granting whatever `grantedFeatures` the last sync happened to write.
+     *
+     * ## The policy, stated because it changes what a paying customer experiences
+     *
+     * **Retire LOCALLY, always. Report the provider. Never migrate a subscriber. Never delete.**
+     *
+     * - **`isActive: false` on the product and on every one of its prices, unconditionally** — even
+     *   when subscribers are on it. It is entitlement-SAFE, which is the fact that makes the policy
+     *   possible: `BillingFeatureSyncBackendService.getProduct` resolves a subscription item's product
+     *   by `_id` with no `isActive` filter, and renewal happens entirely at the provider against the
+     *   provider price, which this does not touch. So an existing subscriber keeps their features and
+     *   keeps renewing; what stops is NEW acquisition, through the gate in
+     *   `readProductByKey(..., BillingCatalogReadIntent.ACQUIRE, ...)`.
+     *
+     * - **The PROVIDER catalogue is left completely alone.** REJECTED ALTERNATIVE: archive the
+     *   provider product and prices in the same pass. The provider is the party that actually charges,
+     *   and archiving a price a live subscription renews against is a customer-visible failed renewal
+     *   — the exact outcome this whole policy is arranged to avoid. It would also mean adding a
+     *   destructive provider write (`StandardBilling_Interface` has no archive verb today) in the same
+     *   change as the sweep that calls it. An operator archives provider rows deliberately, after
+     *   deciding what happens to the subscribers, and the report below is what tells them to.
+     *
+     * - **A retired key WITH LIVE SUBSCRIBERS is reported and otherwise untouched.** REJECTED
+     *   ALTERNATIVE: migrate them to the nearest surviving plan tier, or cancel them. Which plan a
+     *   customer should move to — and whether they should be moved at all rather than grandfathered —
+     *   is a commercial decision with a price attached, and a framework that guesses it either
+     *   overcharges someone or cancels a paying customer because a key was deleted in a refactor.
+     *   The count is reported at error level so the decision is put in front of a human.
+     *
+     * - **Nothing is ever deleted.** The `Product` and `Price` rows are the only local record of what
+     *   a RETAINED subscription and its retained invoices refer to, and billing rows deliberately
+     *   survive the deletion of their scope for a tax/audit obligation. Deleting a retired product
+     *   would strand exactly the trail that retention exists to preserve.
+     */
+    async reconcileRetiredProducts(result) {
+        const catalogKeys = new Set(this.productCatalog.map(definition => definition.key));
+        const listCtx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.LIST);
+        const localProducts = await this.servicesRegistry.list(CoreResourceType.PRODUCTS, listCtx, { isActive: true });
+        const retiredProducts = localProducts.filter(product => !catalogKeys.has(product.key));
+        if (retiredProducts.length === 0)
+            return;
+        const liveProductIds = await this.collectProductIdsWithLiveSubscriptions();
+        for (const product of retiredProducts) {
+            const liveSubscriptions = liveProductIds.get(product._id) ?? 0;
+            try {
+                await this.deactivateProductAndPrices(product);
+                result.retired.push(product.key);
+            }
+            catch (error) {
+                result.errors.push(`Failed to retire product ${product.key}: ${error.message}`);
+                continue;
+            }
+            if (liveSubscriptions > 0) {
+                result.retiredWithLiveSubscribers.push({ productKey: product.key, liveSubscriptions });
+                this.logger.error('Retired product still has live subscribers', {
+                    productKey: product.key,
+                    productId: product._id,
+                    liveSubscriptions,
+                    message: 'This product left the code catalogue and is no longer purchasable, but subscriptions still ' +
+                        'renew against it at the provider and still grant its last-synced features. Decide whether to ' +
+                        'migrate, grandfather or cancel these subscribers — the framework deliberately does not choose. ' +
+                        'Its provider product and prices were NOT archived, so renewals keep working until you act.',
+                });
+            }
+        }
+    }
+    /**
+     * How many LIVE subscriptions reference each product, across every billing scope.
+     *
+     * Built by paging live subscriptions and reading their items, rather than by filtering on
+     * `items.productId` per product. Two reasons: a nested-path filter over an array is a document-store
+     * idiom that does not translate to the PostgreSQL adapter's JSON column, and one pass over the live
+     * set answers the question for every retired product at once instead of one query each.
+     */
+    async collectProductIdsWithLiveSubscriptions() {
+        const counts = new Map();
+        for (const [scopeKey, scopeData] of Object.entries(BILLING_SCOPE_TO_VARIANTS)) {
+            const variants = { scopeKey, ...scopeData };
+            const ctx = await this.internalCtx(variants.subscription, CoreResourceOperation.LIST);
+            for (let page = 1; page <= ProductCatalogSyncBackendService_1.MAX_SUBSCRIPTION_SCAN_PAGES; page += 1) {
+                const subscriptions = await this.servicesRegistry.list(variants.subscription, ctx, { status: { $nin: TERMINAL_SUBSCRIPTION_STATUSES } }, { page, limit: ProductCatalogSyncBackendService_1.SUBSCRIPTION_SCAN_PAGE_SIZE });
+                for (const subscription of subscriptions) {
+                    const seen = new Set();
+                    for (const item of subscription.items ?? []) {
+                        // One subscription counts ONCE per product however many items name it — the number is
+                        // "how many customers am I about to strand", not "how many line items exist".
+                        if (!item?.productId || seen.has(item.productId))
+                            continue;
+                        seen.add(item.productId);
+                        counts.set(item.productId, (counts.get(item.productId) ?? 0) + 1);
+                    }
+                }
+                if (subscriptions.length < ProductCatalogSyncBackendService_1.SUBSCRIPTION_SCAN_PAGE_SIZE)
+                    break;
+            }
+        }
+        return counts;
+    }
+    /**
+     * `isActive: false` on the product and on every price beneath it.
+     *
+     * The prices matter as much as the product: an application that lists prices directly, or a caller
+     * that names a price id, would otherwise still transact against a retired product's price — and
+     * `readPriceForProduct` refuses on the PRICE's own flag, so leaving them active would leave a
+     * second door open on the surface the gate was built for.
+     */
+    async deactivateProductAndPrices(product) {
+        const productUpdate = { isActive: false };
+        const productCtx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.UPDATE);
+        await this.servicesRegistry.update(CoreResourceType.PRODUCTS, productCtx, product._id, productUpdate);
+        const pricesCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.LIST);
+        const prices = await this.servicesRegistry.list(CoreResourceType.PRICES, pricesCtx, { productId: product._id, isActive: true });
+        for (const price of prices) {
+            const priceCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.UPDATE);
+            await this.servicesRegistry.update(CoreResourceType.PRICES, priceCtx, price._id, { isActive: false });
+        }
+    }
+    /** One page of the live-subscription scan. */
+    static SUBSCRIPTION_SCAN_PAGE_SIZE = 200;
+    /**
+     * Page ceiling for the live-subscription scan. Reaching it UNDER-counts, which is the safe
+     * direction here for exactly one reason: the count only ever decides whether a WARNING is emitted
+     * — the retirement itself is unconditional — so a missed page costs a quieter log line, never a
+     * different write.
+     */
+    static MAX_SUBSCRIPTION_SCAN_PAGES = 50;
+    // ════════════════════════════════════════════════════════════
     // Private — Product Operations
     // ════════════════════════════════════════════════════════════
     async findProductByKey(productKey) {
@@ -318,17 +480,32 @@ let ProductCatalogSyncBackendService = class ProductCatalogSyncBackendService ex
             if (price.providerPriceId)
                 continue;
             try {
-                // Convert MoneyValue (bigint) → provider format (number in cents)
+                /*
+                 * Convert every amount from its AUTHORED scale to the CURRENCY's smallest unit (#515).
+                 *
+                 * This was `Number(price.unitPrice.amount)` and two more like it — the stored amount handed
+                 * over verbatim, with `MoneyValue.decimals` discarded. A price authored at any scale other
+                 * than the currency's was therefore synced at the wrong magnitude, by a factor of 10 per
+                 * decimal place of disagreement, and the three amounts in one price could each carry a
+                 * different scale and still be combined as if they shared one.
+                 *
+                 * A conversion that cannot be made exactly REFUSES the price rather than rounding it. The
+                 * throw is caught by the loop below, which logs and moves to the next price — so one
+                 * unrepresentable price does not stop a catalogue sync, and it does not reach the provider
+                 * either.
+                 */
+                const priceCurrency = price.unitPrice.currency;
+                const amount = this.toProviderAmountOrThrow(price.unitPrice, priceCurrency, `price ${price._id}`);
                 const { providerPriceId } = await this.billingProvider.syncPrice({
                     providerProductId,
-                    amount: Number(price.unitPrice.amount),
+                    amount,
                     currency: price.unitPrice.currency,
                     interval: price.interval,
                     model: price.model,
-                    tiers: price.tiers?.map(t => ({
+                    tiers: price.tiers?.map((t, index) => ({
                         upTo: t.upTo ?? null,
-                        unitAmount: Number(t.unitPrice.amount),
-                        flatAmount: Number(t.flatPrice.amount),
+                        unitAmount: this.toProviderAmountOrThrow(t.unitPrice, priceCurrency, `price ${price._id} tier ${index} unit amount`),
+                        flatAmount: this.toProviderAmountOrThrow(t.flatPrice, priceCurrency, `price ${price._id} tier ${index} flat amount`),
                     })),
                     packageSize: price.packageSize,
                     taxBehavior: price.taxBehavior,
@@ -344,11 +521,37 @@ let ProductCatalogSyncBackendService = class ProductCatalogSyncBackendService ex
                 this.logger.error('Failed to sync price to provider', {
                     priceId: price._id,
                     productKey: product.key,
+                    /*
+                     * The CLASSIFIED reason when the failure is a scale one (#515), because the three have
+                     * different remedies and an operator should not have to read prose to tell them apart:
+                     * `unknown_minor_unit` is a catalogue problem, `precision_loss` is an authoring problem,
+                     * `unsafe_magnitude` is a limit of the provider's number type. This `instanceof` is why the
+                     * conversion throws a TYPED error rather than returning a result union — the engine compiles
+                     * with `strict: false`, where a discriminated union does not narrow.
+                     */
+                    ...(error instanceof MoneyMinorUnitConversionError ? { moneyScaleFailure: error.reason } : {}),
                     error: error.message,
                 });
             }
         }
     }
+    /**
+     * One amount, converted from its authored scale to the currency's smallest unit — or a throw naming
+     * exactly why it cannot be (#515).
+     *
+     * Throws rather than returning a result, because every caller is inside the per-price `try` and the
+     * only correct response to any of the three failures is the same: do not sync this price. Returning
+     * a union here would give each of the three call sites its own chance to forget one.
+     *
+     * **The currency is passed in rather than read off the value**, and that is the second half of the
+     * defect. A tier's `unitPrice`/`flatPrice` carry an OPTIONAL currency — they inherit the price's —
+     * so reading each amount's own currency would resolve a scale per amount and let one price be
+     * converted at up to three different ones. One price is denominated in one currency; the amounts
+     * are its parts.
+     */
+    toProviderAmountOrThrow(value, currency, subject) {
+        return toCurrencyMinorUnitAmountOrThrow({ ...value, currency }, subject);
+    }
     // ════════════════════════════════════════════════════════════
     // Private — Dirty Detection
     // ════════════════════════════════════════════════════════════
@@ -384,7 +587,7 @@ let ProductCatalogSyncBackendService = class ProductCatalogSyncBackendService ex
         return false;
     }
 };
-ProductCatalogSyncBackendService = __decorate([
+ProductCatalogSyncBackendService = ProductCatalogSyncBackendService_1 = __decorate([
     injectable(),
     __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
     __param(1, inject(SAAS_SERVICE_TYPES.ServicesRegistryHandlerService)),

package/dist/esm/billing/services/back-office/product-catalog-sync.backend.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"product-catalog-sync.backend.service.js","sourceRoot":"","sources":["../../../../../../src/billing/services/back-office/product-catalog-sync.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Product Catalog Sync Backend Service\n *\n * Synchronizes the code-defined ProductDefinition catalog with the database\n * and the billing provider. Two modes:\n *\n * 1. LAZY: `ensureProductSynced(key)` — On-demand, single product (first checkout or admin view)\n * 2. BULK: `syncProductCatalog()` — Admin action, all products (post-deploy hook)\n *\n * Design:\n * - Config (code) is the source of truth → DB always reflects code\n * - Provider sync is separate from DB sync (happens on first use or bulk sync)\n * - \"features-dirty\" detection: when grantedFeatures/grantedLimits change, trigger\n *   feature recomputation for all affected subscriptions\n *\n * @see billing-and-features-system.md §8.6 (Product Catalog Versioning Strategy)\n */\n\nimport { injectable, inject } from 'inversify';\nimport {\n  type ProductDefinition,\n  type Product,\n  type Price,\n  CoreResourceType,\n  CoreResourceOperation,\n  ErrorType,\n  ErrorCustomMessageReference,\n  deriveTrustedSystemWritePreservedFields,\n} from '@wildo-ai/saas-models';\n// MoneyValue fields use bigint; provider interface uses number — convert at the boundary with Number()\nimport type { StandardBilling_Interface } from '@wildo-ai/external-connectors-models';\nimport type { ServiceOptions } from '~wildo-backend-lib/base-classes/models/repositories.backend.schemas';\nimport { AbstractBillingBackendService } from '~wildo-backend-lib/billing/services/back-office/abstract-billing.backend.service';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport type { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport type { ServicesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/services/services-registry-handler.backend.service';\nimport type { ExecutionContextCreatorBackendService } from '~wildo-backend-lib/runtime/services/execution-context-creator.backend.service';\nimport type { ResourcesRegistryBackendService } from '~wildo-backend-lib/resources/services/resources-registry.backend.service';\nimport type { ErrorBuilderBackendService } from '~wildo-backend-lib/errors/services/error-builder.backend.service';\n\n// =====================================================\n// Types\n// =====================================================\n\nexport interface ProductCatalogSyncResult {\n  synced: number;\n  created: number;\n  updated: number;\n  featuresDirty: string[];\n  errors: string[];\n}\n\n// =====================================================\n// Service\n// =====================================================\n\n@injectable()\nexport class ProductCatalogSyncBackendService extends AbstractBillingBackendService {\n\n  /** The product catalog from code (set at initialization) */\n  private productCatalog: ProductDefinition[] = [];\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger) logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.ServicesRegistryHandlerService) servicesRegistry: ServicesRegistryHandlerBackendService,\n    @inject(SAAS_SERVICE_TYPES.ExecutionContextCreatorBackendService) executionContextCreator: ExecutionContextCreatorBackendService,\n    @inject(SAAS_SERVICE_TYPES.ResourceRegistryService) resourcesRegistry: ResourcesRegistryBackendService,\n    @inject(SAAS_SERVICE_TYPES.ErrorBuilderService) errorBuilder: ErrorBuilderBackendService,\n  ) {\n    super(logger, servicesRegistry, executionContextCreator, resourcesRegistry, errorBuilder);\n  }\n\n  // ════════════════════════════════════════════════════════════\n  // Initialization\n  // ════════════════════════════════════════════════════════════\n\n  /**\n   * Initialize with the code-defined product catalog and billing provider.\n   */\n  public async initialize(\n    productCatalog: ProductDefinition[],\n    provider: StandardBilling_Interface,\n  ): Promise<void> {\n    if (this.isInitialized) return;\n\n    this.productCatalog = productCatalog;\n    this.initializeProvider(provider);\n\n    this.logDebug('Product catalog sync initialized', {\n      productsInCatalog: productCatalog.length,\n    });\n  }\n\n  /**\n   * Returns the in-memory product catalog (set at initialization).\n   * Used by the companion labelling service to discover billing keys for i18n.\n   */\n  public getProductDefinitions(): ProductDefinition[] {\n    return this.productCatalog;\n  }\n\n  // ════════════════════════════════════════════════════════════\n  // Lazy Sync (on-demand, single product)\n  // ════════════════════════════════════════════════════════════\n\n  /**\n   * Ensure a single product and its prices exist in DB and provider.\n   * Idempotent: safe to call multiple times.\n   *\n   * Flow:\n   * 1. Look up ProductDefinition by key in code catalog\n   * 2. Upsert Product DB record (key → _id mapping)\n   * 3. Upsert Price DB records for each inline price\n   * 4. If providerProductId is missing: sync to billing provider\n   */\n  public async ensureProductSynced(productKey: string): Promise<Product> {\n    this.ensureInitialized();\n    this.logDebug('Ensuring product synced', { productKey });\n\n    // 1. Find in code catalog\n    const definition = this.productCatalog.find(p => p.key === productKey);\n    if (!definition) {\n      throw this.errorBuilder.buildError(ErrorType.NOT_FOUND, undefined, {\n        customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,\n        context: { productKey },\n      });\n    }\n\n    // 2. Upsert product in DB\n    const product = await this.upsertProduct(definition);\n\n    // 3. Upsert prices\n    await this.upsertPrices(product._id, definition);\n\n    // 4. Sync to provider when available.\n    // Existing provider-linked products must still push any newly added local\n    // prices, otherwise the DB/provider catalogs silently drift.\n    if (this.billingProvider) {\n      if (!product.providerProductId) {\n        return await this.syncProductToProvider(product);\n      }\n      await this.syncUnsyncedPricesToProvider(product, product.providerProductId);\n    }\n\n    return product;\n  }\n\n  // ════════════════════════════════════════════════════════════\n  // Bulk Sync (admin action)\n  // ════════════════════════════════════════════════════════════\n\n  /**\n   * Sync ALL products from code catalog to DB + provider.\n   * Detects \"features-dirty\" products and returns their keys for\n   * downstream feature recomputation.\n   *\n   * Idempotent and safe to run multiple times.\n   */\n  public async syncProductCatalog(): Promise<ProductCatalogSyncResult> {\n    this.ensureInitialized();\n    this.logDebug('Starting bulk product catalog sync', {\n      productsInCatalog: this.productCatalog.length,\n    });\n\n    const result: ProductCatalogSyncResult = {\n      synced: 0,\n      created: 0,\n      updated: 0,\n      featuresDirty: [],\n      errors: [],\n    };\n\n    for (const definition of this.productCatalog) {\n      try {\n        // Check if existing product has different features/limits\n        const existingProduct = await this.findProductByKey(definition.key);\n        const isFeaturesDirty = existingProduct\n          ? this.isFeaturesDirty(existingProduct, definition)\n          : false;\n\n        // Upsert product (pass existing to avoid a second DB lookup)\n        const product = await this.upsertProduct(definition, existingProduct);\n        result.synced++;\n\n        if (!existingProduct) {\n          result.created++;\n        } else {\n          result.updated++;\n        }\n\n        // Upsert prices\n        await this.upsertPrices(product._id, definition);\n\n        // Sync to provider when available.\n        if (this.billingProvider) {\n          if (!product.providerProductId) {\n            await this.syncProductToProvider(product);\n          } else {\n            await this.syncUnsyncedPricesToProvider(product, product.providerProductId);\n          }\n        }\n\n        // Track features-dirty products\n        if (isFeaturesDirty) {\n          result.featuresDirty.push(definition.key);\n        }\n      } catch (error) {\n        result.errors.push(`${definition.key}: ${(error as Error).message}`);\n        this.logger.error('Failed to sync product', {\n          productKey: definition.key,\n          error: (error as Error).message,\n        });\n      }\n    }\n\n    this.logDebug('Bulk product catalog sync complete', { ...result });\n    return result;\n  }\n\n  // ════════════════════════════════════════════════════════════\n  // Private — Product Operations\n  // ════════════════════════════════════════════════════════════\n\n  private async findProductByKey(productKey: string): Promise<Product | null> {\n    // Context construction stays OUTSIDE the try: failing to resolve the\n    // INTERNAL_CALL operation path is a wiring fault, never \"product absent\".\n    // A masked failure is worse here than a missing read — callers treat null as\n    // \"not yet in the catalog\" and CREATE, so a swallowed fault duplicates products.\n    const ctx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.LIST);\n    try {\n      const items = await this.servicesRegistry.list<Product>(CoreResourceType.PRODUCTS, ctx, { key: productKey }) as Product[];\n      return items.length > 0 ? items[0] : null;\n    } catch (error) {\n      this.degradeOrRethrow(error, 'Failed to find product by key', { productKey });\n      return null;\n    }\n  }\n\n  private async upsertProduct(definition: ProductDefinition, existingProductHint?: Product | null): Promise<Product> {\n    // Use the pre-fetched product if available (avoids double DB lookup in bulk sync)\n    const existingProduct = existingProductHint !== undefined\n      ? existingProductHint\n      : await this.findProductByKey(definition.key);\n\n    const productData: Partial<Product> = {\n      type: definition.type,\n      key: definition.key,\n      targetScopes: definition.targetScopes,\n      grantedFeatures: definition.grantedFeatures,\n      grantedLimits: definition.grantedLimits,\n      planTier: definition.planTier,\n      planTierOrder: definition.planTierOrder,\n      requiredPlanTiers: definition.requiredPlanTiers,\n      taxDisplayMode: definition.taxDisplayMode,\n      purchaseConfig: definition.purchaseConfig,\n      behaviorPolicy: definition.behaviorPolicy,\n      sortOrder: definition.sortOrder,\n      isPublic: definition.isPublic,\n      isActive: true,\n    };\n\n    if (existingProduct) {\n      // Update\n      const ctx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.UPDATE);\n      return await this.servicesRegistry.update<Product>(CoreResourceType.PRODUCTS, ctx, existingProduct._id, productData) as Product;\n    } else {\n      // Create\n      const ctx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.CREATE);\n      return await this.servicesRegistry.create<Product>(CoreResourceType.PRODUCTS, ctx, productData);\n    }\n  }\n\n  private async upsertPrices(productId: string, definition: ProductDefinition): Promise<void> {\n    for (const priceDef of definition.prices) {\n      const priceData: Partial<Price> = {\n        productId,\n        model: priceDef.model,\n        unitPrice: priceDef.unitPrice,\n        interval: priceDef.interval,\n        intervalCount: priceDef.intervalCount,\n        tiers: priceDef.tiers,\n        packageSize: priceDef.packageSize,\n        usageAggregation: priceDef.usageAggregation,\n        taxBehavior: priceDef.taxBehavior,\n        isDefault: priceDef.isDefault,\n        isActive: true,\n      };\n\n      // Try to find existing price for this product with same model+interval+currency\n      try {\n        const listCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.LIST);\n        const items = await this.servicesRegistry.list<Price>(CoreResourceType.PRICES, listCtx, {\n          productId,\n          model: priceDef.model,\n          'unitPrice.currency': priceDef.unitPrice.currency,\n          ...(priceDef.interval && { interval: priceDef.interval }),\n        }) as Price[];\n\n        if (items.length > 0) {\n          const updateCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.UPDATE);\n          await this.servicesRegistry.update<Price>(CoreResourceType.PRICES, updateCtx, items[0]._id, priceData);\n        } else {\n          const createCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.CREATE);\n          await this.servicesRegistry.create<Price>(CoreResourceType.PRICES, createCtx, priceData);\n        }\n      } catch (error) {\n        this.logger.error('Failed to upsert price', {\n          productId,\n          model: priceDef.model,\n          currency: priceDef.unitPrice.currency,\n          error: (error as Error).message,\n        });\n      }\n    }\n  }\n\n  /**\n   * `ServiceOptions` that re-attach the backend-only provider-link field(s) a plain update request\n   * DTO would strip. The billing catalog sync is a trusted in-process write of provider identifiers\n   * (`providerProductId` / `providerPriceId`, both `.isBackendOnly()`); without this the strict\n   * request-DTO parse drops them and the update persists nothing. Mirrors the billing webhook\n   * event router's trusted-system write (`deriveTrustedSystemWritePreservedFields` — schema-aware,\n   * so it only preserves fields that are genuinely backend-only AND present in the payload).\n   */\n  private trustedProviderLinkWriteOptions(resourceType: CoreResourceType, payload: Record<string, unknown>): ServiceOptions {\n    const { mainSchema } = this.resourcesRegistry.getResourceConfiguration(resourceType);\n    return {\n      preserveServerInjectedFields: deriveTrustedSystemWritePreservedFields(\n        mainSchema,\n        Object.keys(payload),\n        CoreResourceOperation.UPDATE,\n      ),\n    };\n  }\n\n  private async syncProductToProvider(product: Product): Promise<Product> {\n    if (!this.billingProvider) return product;\n\n    try {\n      // Sync product\n      const { providerProductId } = await this.billingProvider.syncProduct({\n        productKey: product.key,\n        name: product.key,\n        metadata: { key: product.key, type: product.type },\n      });\n\n      // Persist the provider link locally. `providerProductId` is `.isBackendOnly()`, so a plain\n      // update request DTO STRIPS it: the write \"succeeds\" but the field never lands, leaving the\n      // local link null forever — which is what made every catalog sync re-create the provider\n      // product (accumulating duplicates). Re-attach it through the trusted-system-write allowlist,\n      // the same seam the billing webhook path uses for the same class of backend-only field.\n      const providerLink = { providerProductId };\n      const updateCtx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.UPDATE);\n      const updated = await this.servicesRegistry.update<Product>(\n        CoreResourceType.PRODUCTS,\n        updateCtx,\n        product._id,\n        providerLink,\n        this.trustedProviderLinkWriteOptions(CoreResourceType.PRODUCTS, providerLink),\n      ) as Product;\n\n      await this.syncUnsyncedPricesToProvider(updated, providerProductId);\n\n      return updated;\n    } catch (error) {\n      this.logger.error('Failed to sync product to provider', {\n        productKey: product.key,\n        error: (error as Error).message,\n      });\n      return product;\n    }\n  }\n\n  /**\n   * Sync any locally defined prices that do not yet have a provider identifier.\n   *\n   * This must run for both first-time product syncs and already-synced products,\n   * otherwise adding a new local price after the initial product sync leaves the\n   * provider catalog stale.\n   */\n  private async syncUnsyncedPricesToProvider(product: Product, providerProductId: string): Promise<void> {\n    if (!this.billingProvider) return;\n\n    const listCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.LIST);\n    const prices = await this.servicesRegistry.list<Price>(CoreResourceType.PRICES, listCtx, { productId: product._id }) as Price[];\n\n    for (const price of prices) {\n      if (price.providerPriceId) continue;\n\n      try {\n        // Convert MoneyValue (bigint) → provider format (number in cents)\n        const { providerPriceId } = await this.billingProvider.syncPrice({\n          providerProductId,\n          amount: Number(price.unitPrice.amount),\n          currency: price.unitPrice.currency,\n          interval: price.interval,\n          model: price.model,\n          tiers: price.tiers?.map(t => ({\n            upTo: t.upTo ?? null,\n            unitAmount: Number(t.unitPrice.amount),\n            flatAmount: Number(t.flatPrice.amount),\n          })),\n          packageSize: price.packageSize,\n          taxBehavior: price.taxBehavior,\n          metadata: { productKey: product.key },\n        });\n\n        // `providerPriceId` is `.isBackendOnly()` too — same trusted-system-write preservation as\n        // the product link above, or the price link would silently never persist.\n        const priceLink = { providerPriceId };\n        const priceUpdateCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.UPDATE);\n        await this.servicesRegistry.update<Price>(\n          CoreResourceType.PRICES,\n          priceUpdateCtx,\n          price._id,\n          priceLink,\n          this.trustedProviderLinkWriteOptions(CoreResourceType.PRICES, priceLink),\n        );\n      } catch (error) {\n        this.logger.error('Failed to sync price to provider', {\n          priceId: price._id,\n          productKey: product.key,\n          error: (error as Error).message,\n        });\n      }\n    }\n  }\n\n  // ════════════════════════════════════════════════════════════\n  // Private — Dirty Detection\n  // ════════════════════════════════════════════════════════════\n\n  /**\n   * Check if a product's features/limits have changed relative to the catalog definition.\n   * If so, all subscriptions using this product need feature recomputation.\n   */\n  private isFeaturesDirty(existing: Product, definition: ProductDefinition): boolean {\n    // Check grantedFeatures\n    const existingFeatures = new Set(existing.grantedFeatures ?? []);\n    const newFeatures = new Set(definition.grantedFeatures ?? []);\n    if (existingFeatures.size !== newFeatures.size) return true;\n    for (const f of existingFeatures) {\n      if (!newFeatures.has(f)) return true;\n    }\n\n    // Check grantedLimits\n    const existingLimits = existing.grantedLimits ?? {};\n    const newLimits = definition.grantedLimits ?? {};\n    const existingKeys = Object.keys(existingLimits);\n    const newKeys = Object.keys(newLimits);\n    if (existingKeys.length !== newKeys.length) return true;\n    for (const key of existingKeys) {\n      if (!newLimits[key]) return true;\n      if (existingLimits[key].value !== newLimits[key].value) return true;\n      if (existingLimits[key].mode !== newLimits[key].mode) return true;\n    }\n\n    return false;\n  }\n}\n"]}
+{"version":3,"file":"product-catalog-sync.backend.service.js","sourceRoot":"","sources":["../../../../../../src/billing/services/back-office/product-catalog-sync.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Product Catalog Sync Backend Service\n *\n * Synchronizes the code-defined ProductDefinition catalog with the database\n * and the billing provider. Two modes:\n *\n * 1. LAZY: `ensureProductSynced(key)` — On-demand, single product (first checkout or admin view)\n * 2. BULK: `syncProductCatalog()` — Admin action, all products (post-deploy hook)\n *\n * Design:\n * - Config (code) is the source of truth → DB always reflects code\n * - Provider sync is separate from DB sync (happens on first use or bulk sync)\n * - \"features-dirty\" detection: when grantedFeatures/grantedLimits change, trigger\n *   feature recomputation for all affected subscriptions\n *\n * @see billing-and-features-system.md §8.6 (Product Catalog Versioning Strategy)\n */\n\nimport { injectable, inject } from 'inversify';\nimport {\n  type ProductDefinition,\n  type Product,\n  type Price,\n  type BillingSubscriptionBase,\n  CoreResourceType,\n  CoreResourceOperation,\n  ErrorType,\n  ErrorCustomMessageReference,\n  deriveTrustedSystemWritePreservedFields,\n} from '@wildo-ai/saas-models';\n// MoneyValue fields use bigint at an AUTHORED scale; the provider interface uses a number in the\n// CURRENCY's smallest unit. `Number()` alone crosses only the first of those two gaps, which is why\n// it was wrong here for as long as it stood — see `toProviderAmountOrThrow` (#515).\nimport { MoneyMinorUnitConversionError, toCurrencyMinorUnitAmountOrThrow } from '@wildo-ai/zod-decorators';\nimport type { StandardBilling_Interface } from '@wildo-ai/external-connectors-models';\nimport type { ServiceOptions } from '~wildo-backend-lib/base-classes/models/repositories.backend.schemas';\nimport { AbstractBillingBackendService } from '~wildo-backend-lib/billing/services/back-office/abstract-billing.backend.service';\nimport { TERMINAL_SUBSCRIPTION_STATUSES } from '~wildo-backend-lib/billing/services/back-office/billing-subject-erasure-effect.backend';\nimport {\n  BILLING_SCOPE_TO_VARIANTS,\n  type BillingResolvedVariants,\n} from '~wildo-backend-lib/billing/services/custom-impl/billing-custom-impl-utils.backend';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport type { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport type { ServicesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/services/services-registry-handler.backend.service';\nimport type { ExecutionContextCreatorBackendService } from '~wildo-backend-lib/runtime/services/execution-context-creator.backend.service';\nimport type { ResourcesRegistryBackendService } from '~wildo-backend-lib/resources/services/resources-registry.backend.service';\nimport type { ErrorBuilderBackendService } from '~wildo-backend-lib/errors/services/error-builder.backend.service';\n\n// =====================================================\n// Types\n// =====================================================\n\nexport interface ProductCatalogSyncResult {\n  synced: number;\n  created: number;\n  updated: number;\n  featuresDirty: string[];\n  /**\n   * Keys that exist in the DATABASE and no longer in the code catalogue, and were soft-retired by\n   * this run (`isActive: false` on the product and every one of its prices).\n   */\n  retired: string[];\n  /**\n   * Retired keys that STILL HAVE LIVE SUBSCRIBERS. Reported, never acted on — see\n   * {@link ProductCatalogSyncBackendService.reconcileRetiredProducts} for why the framework refuses\n   * to decide what happens to those customers.\n   */\n  retiredWithLiveSubscribers: Array<{ productKey: string; liveSubscriptions: number }>;\n  errors: string[];\n}\n\n// =====================================================\n// Service\n// =====================================================\n\n@injectable()\nexport class ProductCatalogSyncBackendService extends AbstractBillingBackendService {\n\n  /** The product catalog from code (set at initialization) */\n  private productCatalog: ProductDefinition[] = [];\n\n  constructor(\n    @inject(SAAS_SERVICE_TYPES.Logger) logger: LoggerService,\n    @inject(SAAS_SERVICE_TYPES.ServicesRegistryHandlerService) servicesRegistry: ServicesRegistryHandlerBackendService,\n    @inject(SAAS_SERVICE_TYPES.ExecutionContextCreatorBackendService) executionContextCreator: ExecutionContextCreatorBackendService,\n    @inject(SAAS_SERVICE_TYPES.ResourceRegistryService) resourcesRegistry: ResourcesRegistryBackendService,\n    @inject(SAAS_SERVICE_TYPES.ErrorBuilderService) errorBuilder: ErrorBuilderBackendService,\n  ) {\n    super(logger, servicesRegistry, executionContextCreator, resourcesRegistry, errorBuilder);\n  }\n\n  // ════════════════════════════════════════════════════════════\n  // Initialization\n  // ════════════════════════════════════════════════════════════\n\n  /**\n   * Initialize with the code-defined product catalog and billing provider.\n   */\n  public async initialize(\n    productCatalog: ProductDefinition[],\n    provider: StandardBilling_Interface,\n  ): Promise<void> {\n    if (this.isInitialized) return;\n\n    this.productCatalog = productCatalog;\n    this.initializeProvider(provider);\n\n    this.logDebug('Product catalog sync initialized', {\n      productsInCatalog: productCatalog.length,\n    });\n  }\n\n  /**\n   * Returns the in-memory product catalog (set at initialization).\n   * Used by the companion labelling service to discover billing keys for i18n.\n   */\n  public getProductDefinitions(): ProductDefinition[] {\n    return this.productCatalog;\n  }\n\n  // ════════════════════════════════════════════════════════════\n  // Lazy Sync (on-demand, single product)\n  // ════════════════════════════════════════════════════════════\n\n  /**\n   * Ensure a single product and its prices exist in DB and provider.\n   * Idempotent: safe to call multiple times.\n   *\n   * Flow:\n   * 1. Look up ProductDefinition by key in code catalog\n   * 2. Upsert Product DB record (key → _id mapping)\n   * 3. Upsert Price DB records for each inline price\n   * 4. If providerProductId is missing: sync to billing provider\n   */\n  public async ensureProductSynced(productKey: string): Promise<Product> {\n    this.ensureInitialized();\n    this.logDebug('Ensuring product synced', { productKey });\n\n    // 1. Find in code catalog\n    const definition = this.productCatalog.find(p => p.key === productKey);\n    if (!definition) {\n      throw this.errorBuilder.buildError(ErrorType.NOT_FOUND, undefined, {\n        customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,\n        context: { productKey },\n      });\n    }\n\n    // 2. Upsert product in DB\n    const product = await this.upsertProduct(definition);\n\n    // 3. Upsert prices\n    await this.upsertPrices(product._id, definition);\n\n    // 4. Sync to provider when available.\n    // Existing provider-linked products must still push any newly added local\n    // prices, otherwise the DB/provider catalogs silently drift.\n    if (this.billingProvider) {\n      if (!product.providerProductId) {\n        return await this.syncProductToProvider(product);\n      }\n      await this.syncUnsyncedPricesToProvider(product, product.providerProductId);\n    }\n\n    return product;\n  }\n\n  // ════════════════════════════════════════════════════════════\n  // Bulk Sync (admin action)\n  // ════════════════════════════════════════════════════════════\n\n  /**\n   * Sync ALL products from code catalog to DB + provider.\n   * Detects \"features-dirty\" products and returns their keys for\n   * downstream feature recomputation.\n   *\n   * Idempotent and safe to run multiple times.\n   */\n  public async syncProductCatalog(): Promise<ProductCatalogSyncResult> {\n    this.ensureInitialized();\n    this.logDebug('Starting bulk product catalog sync', {\n      productsInCatalog: this.productCatalog.length,\n    });\n\n    const result: ProductCatalogSyncResult = {\n      synced: 0,\n      created: 0,\n      updated: 0,\n      featuresDirty: [],\n      retired: [],\n      retiredWithLiveSubscribers: [],\n      errors: [],\n    };\n\n    for (const definition of this.productCatalog) {\n      try {\n        // Check if existing product has different features/limits\n        const existingProduct = await this.findProductByKey(definition.key);\n        const isFeaturesDirty = existingProduct\n          ? this.isFeaturesDirty(existingProduct, definition)\n          : false;\n\n        // Upsert product (pass existing to avoid a second DB lookup)\n        const product = await this.upsertProduct(definition, existingProduct);\n        result.synced++;\n\n        if (!existingProduct) {\n          result.created++;\n        } else {\n          result.updated++;\n        }\n\n        // Upsert prices\n        await this.upsertPrices(product._id, definition);\n\n        // Sync to provider when available.\n        if (this.billingProvider) {\n          if (!product.providerProductId) {\n            await this.syncProductToProvider(product);\n          } else {\n            await this.syncUnsyncedPricesToProvider(product, product.providerProductId);\n          }\n        }\n\n        // Track features-dirty products\n        if (isFeaturesDirty) {\n          result.featuresDirty.push(definition.key);\n        }\n      } catch (error) {\n        result.errors.push(`${definition.key}: ${(error as Error).message}`);\n        this.logger.error('Failed to sync product', {\n          productKey: definition.key,\n          error: (error as Error).message,\n        });\n      }\n    }\n\n    /*\n     * The other direction, and it runs LAST so that a key present in both is upserted before it is\n     * examined for retirement — otherwise a first-ever sync would race itself.\n     *\n     * A failure here does not fail the sync: pushing the code catalogue is the primary job, and\n     * refusing to do it because the retirement pass could not read subscriptions would make an\n     * unrelated read fault block every deploy.\n     */\n    try {\n      await this.reconcileRetiredProducts(result);\n    } catch (error) {\n      result.errors.push(`Retired-product reconciliation failed: ${(error as Error).message}`);\n    }\n\n    this.logDebug('Bulk product catalog sync complete', { ...result });\n    return result;\n  }\n\n  // ════════════════════════════════════════════════════════════\n  // Retirement — the catalogue's OTHER direction\n  // ════════════════════════════════════════════════════════════\n\n  /**\n   * Soft-retire every local product whose key has left the code catalogue.\n   *\n   * ## What was wrong\n   *\n   * `syncProductCatalog` iterated `this.productCatalog` and nothing else, so it could only ever ADD\n   * and UPDATE. A key deleted from the code catalogue left its `Product` row `isActive: true`, its\n   * `Price` rows active, and its provider product and prices live — and because the purchase path\n   * reads the DATABASE rather than the code catalogue, a product that no longer existed in code\n   * could still be bought, granting whatever `grantedFeatures` the last sync happened to write.\n   *\n   * ## The policy, stated because it changes what a paying customer experiences\n   *\n   * **Retire LOCALLY, always. Report the provider. Never migrate a subscriber. Never delete.**\n   *\n   * - **`isActive: false` on the product and on every one of its prices, unconditionally** — even\n   *   when subscribers are on it. It is entitlement-SAFE, which is the fact that makes the policy\n   *   possible: `BillingFeatureSyncBackendService.getProduct` resolves a subscription item's product\n   *   by `_id` with no `isActive` filter, and renewal happens entirely at the provider against the\n   *   provider price, which this does not touch. So an existing subscriber keeps their features and\n   *   keeps renewing; what stops is NEW acquisition, through the gate in\n   *   `readProductByKey(..., BillingCatalogReadIntent.ACQUIRE, ...)`.\n   *\n   * - **The PROVIDER catalogue is left completely alone.** REJECTED ALTERNATIVE: archive the\n   *   provider product and prices in the same pass. The provider is the party that actually charges,\n   *   and archiving a price a live subscription renews against is a customer-visible failed renewal\n   *   — the exact outcome this whole policy is arranged to avoid. It would also mean adding a\n   *   destructive provider write (`StandardBilling_Interface` has no archive verb today) in the same\n   *   change as the sweep that calls it. An operator archives provider rows deliberately, after\n   *   deciding what happens to the subscribers, and the report below is what tells them to.\n   *\n   * - **A retired key WITH LIVE SUBSCRIBERS is reported and otherwise untouched.** REJECTED\n   *   ALTERNATIVE: migrate them to the nearest surviving plan tier, or cancel them. Which plan a\n   *   customer should move to — and whether they should be moved at all rather than grandfathered —\n   *   is a commercial decision with a price attached, and a framework that guesses it either\n   *   overcharges someone or cancels a paying customer because a key was deleted in a refactor.\n   *   The count is reported at error level so the decision is put in front of a human.\n   *\n   * - **Nothing is ever deleted.** The `Product` and `Price` rows are the only local record of what\n   *   a RETAINED subscription and its retained invoices refer to, and billing rows deliberately\n   *   survive the deletion of their scope for a tax/audit obligation. Deleting a retired product\n   *   would strand exactly the trail that retention exists to preserve.\n   */\n  private async reconcileRetiredProducts(result: ProductCatalogSyncResult): Promise<void> {\n    const catalogKeys = new Set(this.productCatalog.map(definition => definition.key));\n\n    const listCtx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.LIST);\n    const localProducts = await this.servicesRegistry.list<Product>(\n      CoreResourceType.PRODUCTS, listCtx, { isActive: true },\n    ) as Product[];\n\n    const retiredProducts = localProducts.filter(product => !catalogKeys.has(product.key));\n    if (retiredProducts.length === 0) return;\n\n    const liveProductIds = await this.collectProductIdsWithLiveSubscriptions();\n\n    for (const product of retiredProducts) {\n      const liveSubscriptions = liveProductIds.get(product._id) ?? 0;\n      try {\n        await this.deactivateProductAndPrices(product);\n        result.retired.push(product.key);\n      } catch (error) {\n        result.errors.push(`Failed to retire product ${product.key}: ${(error as Error).message}`);\n        continue;\n      }\n\n      if (liveSubscriptions > 0) {\n        result.retiredWithLiveSubscribers.push({ productKey: product.key, liveSubscriptions });\n        this.logger.error('Retired product still has live subscribers', {\n          productKey: product.key,\n          productId: product._id,\n          liveSubscriptions,\n          message:\n            'This product left the code catalogue and is no longer purchasable, but subscriptions still ' +\n            'renew against it at the provider and still grant its last-synced features. Decide whether to ' +\n            'migrate, grandfather or cancel these subscribers — the framework deliberately does not choose. ' +\n            'Its provider product and prices were NOT archived, so renewals keep working until you act.',\n        });\n      }\n    }\n  }\n\n  /**\n   * How many LIVE subscriptions reference each product, across every billing scope.\n   *\n   * Built by paging live subscriptions and reading their items, rather than by filtering on\n   * `items.productId` per product. Two reasons: a nested-path filter over an array is a document-store\n   * idiom that does not translate to the PostgreSQL adapter's JSON column, and one pass over the live\n   * set answers the question for every retired product at once instead of one query each.\n   */\n  private async collectProductIdsWithLiveSubscriptions(): Promise<Map<string, number>> {\n    const counts = new Map<string, number>();\n\n    for (const [scopeKey, scopeData] of Object.entries(BILLING_SCOPE_TO_VARIANTS)) {\n      const variants: BillingResolvedVariants = { scopeKey, ...scopeData };\n      const ctx = await this.internalCtx(variants.subscription as CoreResourceType, CoreResourceOperation.LIST);\n\n      for (let page = 1; page <= ProductCatalogSyncBackendService.MAX_SUBSCRIPTION_SCAN_PAGES; page += 1) {\n        const subscriptions = await this.servicesRegistry.list<BillingSubscriptionBase>(\n          variants.subscription as CoreResourceType,\n          ctx,\n          { status: { $nin: TERMINAL_SUBSCRIPTION_STATUSES } },\n          { page, limit: ProductCatalogSyncBackendService.SUBSCRIPTION_SCAN_PAGE_SIZE },\n        ) as BillingSubscriptionBase[];\n\n        for (const subscription of subscriptions) {\n          const seen = new Set<string>();\n          for (const item of subscription.items ?? []) {\n            // One subscription counts ONCE per product however many items name it — the number is\n            // \"how many customers am I about to strand\", not \"how many line items exist\".\n            if (!item?.productId || seen.has(item.productId)) continue;\n            seen.add(item.productId);\n            counts.set(item.productId, (counts.get(item.productId) ?? 0) + 1);\n          }\n        }\n\n        if (subscriptions.length < ProductCatalogSyncBackendService.SUBSCRIPTION_SCAN_PAGE_SIZE) break;\n      }\n    }\n\n    return counts;\n  }\n\n  /**\n   * `isActive: false` on the product and on every price beneath it.\n   *\n   * The prices matter as much as the product: an application that lists prices directly, or a caller\n   * that names a price id, would otherwise still transact against a retired product's price — and\n   * `readPriceForProduct` refuses on the PRICE's own flag, so leaving them active would leave a\n   * second door open on the surface the gate was built for.\n   */\n  private async deactivateProductAndPrices(product: Product): Promise<void> {\n    const productUpdate = { isActive: false };\n    const productCtx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.UPDATE);\n    await this.servicesRegistry.update<Product>(CoreResourceType.PRODUCTS, productCtx, product._id, productUpdate);\n\n    const pricesCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.LIST);\n    const prices = await this.servicesRegistry.list<Price>(\n      CoreResourceType.PRICES, pricesCtx, { productId: product._id, isActive: true },\n    ) as Price[];\n\n    for (const price of prices) {\n      const priceCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.UPDATE);\n      await this.servicesRegistry.update<Price>(CoreResourceType.PRICES, priceCtx, price._id, { isActive: false });\n    }\n  }\n\n  /** One page of the live-subscription scan. */\n  private static readonly SUBSCRIPTION_SCAN_PAGE_SIZE = 200;\n\n  /**\n   * Page ceiling for the live-subscription scan. Reaching it UNDER-counts, which is the safe\n   * direction here for exactly one reason: the count only ever decides whether a WARNING is emitted\n   * — the retirement itself is unconditional — so a missed page costs a quieter log line, never a\n   * different write.\n   */\n  private static readonly MAX_SUBSCRIPTION_SCAN_PAGES = 50;\n\n  // ════════════════════════════════════════════════════════════\n  // Private — Product Operations\n  // ════════════════════════════════════════════════════════════\n\n  private async findProductByKey(productKey: string): Promise<Product | null> {\n    // Context construction stays OUTSIDE the try: failing to resolve the\n    // INTERNAL_CALL operation path is a wiring fault, never \"product absent\".\n    // A masked failure is worse here than a missing read — callers treat null as\n    // \"not yet in the catalog\" and CREATE, so a swallowed fault duplicates products.\n    const ctx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.LIST);\n    try {\n      const items = await this.servicesRegistry.list<Product>(CoreResourceType.PRODUCTS, ctx, { key: productKey }) as Product[];\n      return items.length > 0 ? items[0] : null;\n    } catch (error) {\n      this.degradeOrRethrow(error, 'Failed to find product by key', { productKey });\n      return null;\n    }\n  }\n\n  private async upsertProduct(definition: ProductDefinition, existingProductHint?: Product | null): Promise<Product> {\n    // Use the pre-fetched product if available (avoids double DB lookup in bulk sync)\n    const existingProduct = existingProductHint !== undefined\n      ? existingProductHint\n      : await this.findProductByKey(definition.key);\n\n    const productData: Partial<Product> = {\n      type: definition.type,\n      key: definition.key,\n      targetScopes: definition.targetScopes,\n      grantedFeatures: definition.grantedFeatures,\n      grantedLimits: definition.grantedLimits,\n      planTier: definition.planTier,\n      planTierOrder: definition.planTierOrder,\n      requiredPlanTiers: definition.requiredPlanTiers,\n      taxDisplayMode: definition.taxDisplayMode,\n      purchaseConfig: definition.purchaseConfig,\n      behaviorPolicy: definition.behaviorPolicy,\n      sortOrder: definition.sortOrder,\n      isPublic: definition.isPublic,\n      isActive: true,\n    };\n\n    if (existingProduct) {\n      // Update\n      const ctx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.UPDATE);\n      return await this.servicesRegistry.update<Product>(CoreResourceType.PRODUCTS, ctx, existingProduct._id, productData) as Product;\n    } else {\n      // Create\n      const ctx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.CREATE);\n      return await this.servicesRegistry.create<Product>(CoreResourceType.PRODUCTS, ctx, productData);\n    }\n  }\n\n  private async upsertPrices(productId: string, definition: ProductDefinition): Promise<void> {\n    for (const priceDef of definition.prices) {\n      const priceData: Partial<Price> = {\n        productId,\n        model: priceDef.model,\n        unitPrice: priceDef.unitPrice,\n        interval: priceDef.interval,\n        intervalCount: priceDef.intervalCount,\n        tiers: priceDef.tiers,\n        packageSize: priceDef.packageSize,\n        usageAggregation: priceDef.usageAggregation,\n        taxBehavior: priceDef.taxBehavior,\n        isDefault: priceDef.isDefault,\n        isActive: true,\n      };\n\n      // Try to find existing price for this product with same model+interval+currency\n      try {\n        const listCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.LIST);\n        const items = await this.servicesRegistry.list<Price>(CoreResourceType.PRICES, listCtx, {\n          productId,\n          model: priceDef.model,\n          'unitPrice.currency': priceDef.unitPrice.currency,\n          ...(priceDef.interval && { interval: priceDef.interval }),\n        }) as Price[];\n\n        if (items.length > 0) {\n          const updateCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.UPDATE);\n          await this.servicesRegistry.update<Price>(CoreResourceType.PRICES, updateCtx, items[0]._id, priceData);\n        } else {\n          const createCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.CREATE);\n          await this.servicesRegistry.create<Price>(CoreResourceType.PRICES, createCtx, priceData);\n        }\n      } catch (error) {\n        this.logger.error('Failed to upsert price', {\n          productId,\n          model: priceDef.model,\n          currency: priceDef.unitPrice.currency,\n          error: (error as Error).message,\n        });\n      }\n    }\n  }\n\n  /**\n   * `ServiceOptions` that re-attach the backend-only provider-link field(s) a plain update request\n   * DTO would strip. The billing catalog sync is a trusted in-process write of provider identifiers\n   * (`providerProductId` / `providerPriceId`, both `.isBackendOnly()`); without this the strict\n   * request-DTO parse drops them and the update persists nothing. Mirrors the billing webhook\n   * event router's trusted-system write (`deriveTrustedSystemWritePreservedFields` — schema-aware,\n   * so it only preserves fields that are genuinely backend-only AND present in the payload).\n   */\n  private trustedProviderLinkWriteOptions(resourceType: CoreResourceType, payload: Record<string, unknown>): ServiceOptions {\n    const { mainSchema } = this.resourcesRegistry.getResourceConfiguration(resourceType);\n    return {\n      preserveServerInjectedFields: deriveTrustedSystemWritePreservedFields(\n        mainSchema,\n        Object.keys(payload),\n        CoreResourceOperation.UPDATE,\n      ),\n    };\n  }\n\n  private async syncProductToProvider(product: Product): Promise<Product> {\n    if (!this.billingProvider) return product;\n\n    try {\n      // Sync product\n      const { providerProductId } = await this.billingProvider.syncProduct({\n        productKey: product.key,\n        name: product.key,\n        metadata: { key: product.key, type: product.type },\n      });\n\n      // Persist the provider link locally. `providerProductId` is `.isBackendOnly()`, so a plain\n      // update request DTO STRIPS it: the write \"succeeds\" but the field never lands, leaving the\n      // local link null forever — which is what made every catalog sync re-create the provider\n      // product (accumulating duplicates). Re-attach it through the trusted-system-write allowlist,\n      // the same seam the billing webhook path uses for the same class of backend-only field.\n      const providerLink = { providerProductId };\n      const updateCtx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.UPDATE);\n      const updated = await this.servicesRegistry.update<Product>(\n        CoreResourceType.PRODUCTS,\n        updateCtx,\n        product._id,\n        providerLink,\n        this.trustedProviderLinkWriteOptions(CoreResourceType.PRODUCTS, providerLink),\n      ) as Product;\n\n      await this.syncUnsyncedPricesToProvider(updated, providerProductId);\n\n      return updated;\n    } catch (error) {\n      this.logger.error('Failed to sync product to provider', {\n        productKey: product.key,\n        error: (error as Error).message,\n      });\n      return product;\n    }\n  }\n\n  /**\n   * Sync any locally defined prices that do not yet have a provider identifier.\n   *\n   * This must run for both first-time product syncs and already-synced products,\n   * otherwise adding a new local price after the initial product sync leaves the\n   * provider catalog stale.\n   */\n  private async syncUnsyncedPricesToProvider(product: Product, providerProductId: string): Promise<void> {\n    if (!this.billingProvider) return;\n\n    const listCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.LIST);\n    const prices = await this.servicesRegistry.list<Price>(CoreResourceType.PRICES, listCtx, { productId: product._id }) as Price[];\n\n    for (const price of prices) {\n      if (price.providerPriceId) continue;\n\n      try {\n        /*\n         * Convert every amount from its AUTHORED scale to the CURRENCY's smallest unit (#515).\n         *\n         * This was `Number(price.unitPrice.amount)` and two more like it — the stored amount handed\n         * over verbatim, with `MoneyValue.decimals` discarded. A price authored at any scale other\n         * than the currency's was therefore synced at the wrong magnitude, by a factor of 10 per\n         * decimal place of disagreement, and the three amounts in one price could each carry a\n         * different scale and still be combined as if they shared one.\n         *\n         * A conversion that cannot be made exactly REFUSES the price rather than rounding it. The\n         * throw is caught by the loop below, which logs and moves to the next price — so one\n         * unrepresentable price does not stop a catalogue sync, and it does not reach the provider\n         * either.\n         */\n        const priceCurrency = price.unitPrice.currency;\n        const amount = this.toProviderAmountOrThrow(price.unitPrice, priceCurrency, `price ${price._id}`);\n        const { providerPriceId } = await this.billingProvider.syncPrice({\n          providerProductId,\n          amount,\n          currency: price.unitPrice.currency,\n          interval: price.interval,\n          model: price.model,\n          tiers: price.tiers?.map((t, index) => ({\n            upTo: t.upTo ?? null,\n            unitAmount: this.toProviderAmountOrThrow(t.unitPrice, priceCurrency, `price ${price._id} tier ${index} unit amount`),\n            flatAmount: this.toProviderAmountOrThrow(t.flatPrice, priceCurrency, `price ${price._id} tier ${index} flat amount`),\n          })),\n          packageSize: price.packageSize,\n          taxBehavior: price.taxBehavior,\n          metadata: { productKey: product.key },\n        });\n\n        // `providerPriceId` is `.isBackendOnly()` too — same trusted-system-write preservation as\n        // the product link above, or the price link would silently never persist.\n        const priceLink = { providerPriceId };\n        const priceUpdateCtx = await this.internalCtx(CoreResourceType.PRICES, CoreResourceOperation.UPDATE);\n        await this.servicesRegistry.update<Price>(\n          CoreResourceType.PRICES,\n          priceUpdateCtx,\n          price._id,\n          priceLink,\n          this.trustedProviderLinkWriteOptions(CoreResourceType.PRICES, priceLink),\n        );\n      } catch (error) {\n        this.logger.error('Failed to sync price to provider', {\n          priceId: price._id,\n          productKey: product.key,\n          /*\n           * The CLASSIFIED reason when the failure is a scale one (#515), because the three have\n           * different remedies and an operator should not have to read prose to tell them apart:\n           * `unknown_minor_unit` is a catalogue problem, `precision_loss` is an authoring problem,\n           * `unsafe_magnitude` is a limit of the provider's number type. This `instanceof` is why the\n           * conversion throws a TYPED error rather than returning a result union — the engine compiles\n           * with `strict: false`, where a discriminated union does not narrow.\n           */\n          ...(error instanceof MoneyMinorUnitConversionError ? { moneyScaleFailure: error.reason } : {}),\n          error: (error as Error).message,\n        });\n      }\n    }\n  }\n\n  /**\n   * One amount, converted from its authored scale to the currency's smallest unit — or a throw naming\n   * exactly why it cannot be (#515).\n   *\n   * Throws rather than returning a result, because every caller is inside the per-price `try` and the\n   * only correct response to any of the three failures is the same: do not sync this price. Returning\n   * a union here would give each of the three call sites its own chance to forget one.\n   *\n   * **The currency is passed in rather than read off the value**, and that is the second half of the\n   * defect. A tier's `unitPrice`/`flatPrice` carry an OPTIONAL currency — they inherit the price's —\n   * so reading each amount's own currency would resolve a scale per amount and let one price be\n   * converted at up to three different ones. One price is denominated in one currency; the amounts\n   * are its parts.\n   */\n  private toProviderAmountOrThrow(\n    value: { amount: bigint; decimals: number },\n    currency: string,\n    subject: string,\n  ): number {\n    return toCurrencyMinorUnitAmountOrThrow({ ...value, currency }, subject);\n  }\n\n  // ════════════════════════════════════════════════════════════\n  // Private — Dirty Detection\n  // ════════════════════════════════════════════════════════════\n\n  /**\n   * Check if a product's features/limits have changed relative to the catalog definition.\n   * If so, all subscriptions using this product need feature recomputation.\n   */\n  private isFeaturesDirty(existing: Product, definition: ProductDefinition): boolean {\n    // Check grantedFeatures\n    const existingFeatures = new Set(existing.grantedFeatures ?? []);\n    const newFeatures = new Set(definition.grantedFeatures ?? []);\n    if (existingFeatures.size !== newFeatures.size) return true;\n    for (const f of existingFeatures) {\n      if (!newFeatures.has(f)) return true;\n    }\n\n    // Check grantedLimits\n    const existingLimits = existing.grantedLimits ?? {};\n    const newLimits = definition.grantedLimits ?? {};\n    const existingKeys = Object.keys(existingLimits);\n    const newKeys = Object.keys(newLimits);\n    if (existingKeys.length !== newKeys.length) return true;\n    for (const key of existingKeys) {\n      if (!newLimits[key]) return true;\n      if (existingLimits[key].value !== newLimits[key].value) return true;\n      if (existingLimits[key].mode !== newLimits[key].mode) return true;\n    }\n\n    return false;\n  }\n}\n"]}