npm - @wildo-ai/saas-backend-lib - Versions diffs - 1.1.2 → 1.1.4 - Mend

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

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

Files changed (1358) hide show

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

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

package/dist/esm/billing/services/back-office/usage-metering.backend.service.d.ts CHANGED Viewed

@@ -6,13 +6,13 @@
  *
  * Flow:
  * 1. Operation hook calls recordUsage() after successful operation
- * 2. Usage records are stored in DB (reportedToProvider: false)
+ * 2. Usage records are stored in DB (flushState: pending)
  * 3. Periodic flush (cron) aggregates and reports to provider
  * 4. Provider bills at the end of the billing period
  *
  * @see billing-and-features-system.md §9 (Usage & Consumption Tracking)
  */
-import { UsageSourceType } from '@wildo-ai/saas-models';
+import { type MeteredUsageRecordingDefinition, UsageSourceType } from '@wildo-ai/saas-models';
 import type { StandardBilling_Interface } from '@wildo-ai/external-connectors-models';
 import { AbstractBillingBackendService } from '../../../billing/services/back-office/abstract-billing.backend.service';
 import { type BillingResolvedVariants } from '../../../billing/services/custom-impl/billing-custom-impl-utils.backend';
@@ -21,6 +21,7 @@ import type { ServicesRegistryHandlerBackendService } from '../../../base-classe
 import type { ExecutionContextCreatorBackendService } from '../../../runtime/services/execution-context-creator.backend.service';
 import type { ResourcesRegistryBackendService } from '../../../resources/services/resources-registry.backend.service';
 import type { ErrorBuilderBackendService } from '../../../errors/services/error-builder.backend.service';
+import type { ExecutionContext } from '../../../runtime/models/execution-context.backend.schemas';
 import type { RepositoriesRegistryHandlerBackendService } from '../../../base-classes/services/repositories/repositories-registry-handler.backend.service';
 export interface RecordUsageOptions {
     /** What generated this usage */
@@ -36,10 +37,58 @@ export interface UsageFlushResult {
     totalRecords: number;
     reported: number;
     failed: number;
+    /**
+     * Rows this run moved to `flushState: unreportable` — a PERMANENT determination, distinct from
+     * `failed`, which means "try again next run" (#512).
+     *
+     * The two must never be merged. A failure that is counted as unreportable silently abandons
+     * billable usage; an unreportable row counted as failed is re-selected forever and grows a
+     * backlog nothing can drain, which is the defect this counter was added with.
+     */
+    unreportable: number;
     errors: string[];
+    /**
+     * The RECONCILIATION line: quantity recorded locally versus quantity reported to the provider,
+     * per run (#415).
+     *
+     * Getting metering wrong moves money in BOTH directions, and neither direction announces itself —
+     * an under-report is revenue that never appears, an over-report is a customer charged twice. A
+     * counter of ROWS cannot see either, because rows carry quantities: ten rows reported can be any
+     * amount at all. So the run states what it took in and what it sent out, and the two are meant to
+     * be equal. When they are not, `errors` says why.
+     */
+    quantityRecorded: number;
+    quantityReported: number;
+    /**
+     * Quantity this run determined will NEVER be billed. Counted separately from
+     * {@link quantityReported} because it is the opposite outcome: the provider was not told, and
+     * never will be. It closes the reconciliation identity —
+     * `quantityRecorded === quantityReported + quantityUnreportable + (what stays pending)`.
+     */
+    quantityUnreportable: number;
 }
 export declare class UsageMeteringBackendService extends AbstractBillingBackendService {
     private readonly repositoriesRegistry;
+    /**
+     * How many rows one LIST page fetches while draining the pending set.
+     *
+     * A page size, never a cap: the drain pages until exhausted. It exists because a single query for an
+     * unbounded set is the shape that produced the `limit: 10000` this replaced.
+     */
+    private static readonly FLUSH_PAGE_SIZE;
+    /**
+     * The runaway guard, in PAGES. Reaching it aborts the scope and reports nothing — see
+     * `listAllUnreportedRecords` for why a partial flush is worse than none.
+     *
+     * 2,000 pages is a million pending rows. That is not a busy hour, it is a flush that has not run for
+     * a long time, and the right response is a person rather than a bigger number.
+     */
+    private static readonly MAX_FLUSH_PAGES;
+    /** First retry delay; each subsequent one multiplies by the product's `backoffMultiplier`. */
+    private static readonly RETRY_BASE_DELAY_MS;
+    /** Per-run caches, held only for the duration of one `flushToProvider`. `null` means "looked up, absent". */
+    private flushProductCache?;
+    private flushPeriodCache?;
     constructor(logger: LoggerService, servicesRegistry: ServicesRegistryHandlerBackendService, executionContextCreator: ExecutionContextCreatorBackendService, resourcesRegistry: ResourcesRegistryBackendService, errorBuilder: ErrorBuilderBackendService, repositoriesRegistry: RepositoriesRegistryHandlerBackendService);
     initialize(provider: StandardBilling_Interface): Promise<void>;
     /**
@@ -47,8 +96,46 @@ export declare class UsageMeteringBackendService extends AbstractBillingBackendS
      * Stores locally — NOT reported to provider immediately.
      *
      * @param variants — resolved billing polymorphic variants for the target scope
+     * @returns whether a usage row was actually written.
+     *
+     * The return type was `void` until 2026-09-08 (#415), which was harmless only while nothing called
+     * this: the method DECLINES silently when the account holds no active metered subscription, so a
+     * caller could not distinguish "recorded" from "declined". The first real caller then reported the
+     * quantity it had ASKED for whichever happened — an operational counter claiming usage that was
+     * never written, the same shape as the discarded `modifiedCount` this file already fixed once in
+     * the flush. Caught by a pin rather than by a reading, which is the argument for writing the
+     * refusal cases as carefully as the success ones.
+     */
+    recordUsage(variants: BillingResolvedVariants, billingAccountId: string, productKey: string, quantity: number, options?: RecordUsageOptions): Promise<boolean>;
+    /**
+     * Record usage declared by an OPERATION, resolving the scope, the billing account and the quantity
+     * from the operation's own execution context and result (#415).
+     *
+     * This is the caller `recordUsage` never had. Until it existed, a product could be declared METERED,
+     * priced and synced to the provider while nothing in the framework ever wrote a usage row — the
+     * only way to meter was to reach into this service by hand from a custom implementation, which is a
+     * workaround rather than an authoring surface.
+     *
+     * **Never throws.** It runs after a write has already committed, so a failure here must not turn a
+     * successful operation into an error the caller sees. Every refusal is a warning naming the product
+     * and the reason, because an unrecorded unit is revenue that will not be billed and the log line is
+     * the only thing that will ever say so.
+     *
+     * @returns the quantity recorded, or 0 when nothing was recorded — so a caller can log the outcome
+     *   rather than assume it.
+     */
+    recordDeclaredOperationUsage(declaration: MeteredUsageRecordingDefinition, executionContext: ExecutionContext<any>, operationResult: unknown): Promise<number>;
+    /**
+     * The declared quantity: fixed, or read from the written row.
+     *
+     * A `quantityFromResultField` that does not resolve to a finite non-negative number records NOTHING
+     * and warns, rather than falling back to 1. Silently billing the wrong amount is worse than billing
+     * nothing and saying so — a fallback here would be a wrong number nobody could distinguish from a
+     * right one.
      */
-    recordUsage(variants: BillingResolvedVariants, billingAccountId: string, productKey: string, quantity: number, options?: RecordUsageOptions): Promise<void>;
+    private resolveDeclaredQuantity;
+    /** The scope's billing account, addressed by the scope entity rather than by an id the caller supplies. */
+    private resolveBillingAccountIdForScope;
     /**
      * Get usage summary for a billing account.
      *
@@ -67,6 +154,82 @@ export declare class UsageMeteringBackendService extends AbstractBillingBackendS
      */
     flushToProvider(): Promise<UsageFlushResult>;
     private flushScopeToProvider;
+    /**
+     * Page through EVERY unreported row in this scope.
+     *
+     * The whole set is read before anything is reported, because aggregation is defined over the whole
+     * pending set and a page is not a meaningful unit of it.
+     *
+     * This replaced a single `{ limit: 10000 }` (#415). That cap did not fail when it was reached — it
+     * returned the first ten thousand rows and the run looked healthy, so the eleven-thousandth unit of
+     * usage was simply never billed and nothing anywhere said so. A cap that is reached is money not
+     * billed; the only honest cap is one that REFUSES.
+     */
+    private listAllUnreportedRecords;
+    /**
+     * Keep only the rows whose PRODUCT is due to be flushed, per its authored `flushIntervalMinutes`
+     * (#415).
+     *
+     * The field means "usage for this product should reach the provider within N minutes of being
+     * recorded", so a product is due when its OLDEST pending row has waited that long. Derived from the
+     * rows already in hand — no last-flush timestamp is stored anywhere, because storing one would be a
+     * second source of truth for something the rows already say, and one that can go stale.
+     *
+     * The batch runs on a cadence at least as fast as the shortest interval any product can author; this
+     * is what turns one shared schedule into per-product intervals. A product authoring 1440 accumulates
+     * for a day and produces one provider event instead of 288, which is what its author asked for.
+     *
+     * Note the ASYMMETRY, and it is deliberate: waiting is per product, but once ONE product is due its
+     * rows go now rather than at the next tick. Reporting sooner than authored is never wrong; later is.
+     */
+    private selectDueRecords;
+    /**
+     * Turn pending rows into the groups that will each become one provider meter event, honouring the
+     * product's authored `metering` policy (#415).
+     *
+     * Until this existed the policy block was declared, defaulted, documented and read by NOTHING: every
+     * row was merged by (account, product) whatever the product said, so `preFlushAggregation: false`
+     * was unrepresentable and `aggregationWindow` chose between two behaviours that were the same one.
+     * Its own JSDoc said so and asked that the gap stay visible, which is why this comment says what
+     * replaced it.
+     *
+     * The policy is per PRODUCT, so two products flushing in the same run are grouped by their own
+     * rules — that is why the policy is resolved inside the loop rather than once for the run.
+     */
+    private buildFlushGroups;
+    private reportGroup;
+    /**
+     * Report one meter event, honouring the product's authored `retryPolicy` (#415).
+     *
+     * `maxRetries` and `backoffMultiplier` were authored, defaulted and read by nothing — a provider
+     * blip failed the whole group and left it for the next scheduled run, which on a 60-minute schedule
+     * is an hour of unbilled usage for a fault that would have cleared in a second.
+     *
+     * The retry is SAFE only because of the idempotency identifier the caller supplies: a retry after a
+     * response that was lost in transit re-sends the same identifier, and the provider discards it. Retry
+     * without that is how a timeout becomes a double charge, which is why the two landed together.
+     */
+    private reportWithRetry;
+    /**
+     * A stable, bounded idempotency key for one meter event.
+     *
+     * Derived from the ROWS the event carries — sorted, so ordering cannot change it — and hashed, so a
+     * group of ten thousand rows produces the same short key as a group of one. Two different groups
+     * cannot collide; the same group retried, or re-reported after a partial marking, produces the same
+     * key and the provider discards the repeat.
+     */
+    private buildUsageEventIdentifier;
+    /** The product's authored metering policy, or `undefined` when it authored none. */
+    private resolveMeteringPolicy;
+    /**
+     * The start of the billing period containing `timestamp`, for `PER_BILLING_PERIOD` grouping.
+     *
+     * Derived from the subscription's own `currentPeriodStart` / `currentPeriodEnd` — real data, not a
+     * calendar rule invented here — stepping backwards by the period's own length for usage older than
+     * the current period. Returns `undefined` when no subscription can be resolved, which merges the
+     * rows exactly as `PER_FLUSH` would: an unknown boundary must not silently invent one.
+     */
+    private resolvePeriodStartFor;
     /**
      * Validate that the billing account has an active subscription containing
      * a metered product matching the given product key. Returns true as soon
@@ -75,6 +238,39 @@ export declare class UsageMeteringBackendService extends AbstractBillingBackendS
      * not by subscription item.
      */
     private hasActiveMeteredSubscription;
-    private resolveProviderCustomerId;
+    /**
+     * Resolve the provider customer for a billing account, distinguishing the two ways it can fail.
+     *
+     * This used to return `string | null`, and that single `null` fused a PERMANENT condition with a
+     * TRANSIENT one (#512):
+     *
+     * - the account row is GONE — legitimately reachable, because usage rows are RETAINED when their
+     *   subject is erased, so a deleted account leaves rows behind. Nothing will ever restore the
+     *   mapping, and a flush that keeps retrying is building a backlog it cannot drain;
+     * - the account EXISTS but carries no `providerCustomerId` yet — provisioning may still complete,
+     *   and abandoning those rows would throw away billable usage.
+     *
+     * They lead to opposite actions, so the caller must be able to tell them apart. Two plain fields
+     * rather than a discriminated union deliberately: `engine/tsconfig.common.json` sets
+     * `strict: false`, under which narrowing a union on a boolean-literal discriminant does not work,
+     * and a caller that cannot narrow reads the wrong field with no diagnostic.
+     *
+     * A read that THROWS is treated as transient — `degradeOrRethrow` has already decided the error is
+     * survivable, and a storage failure says nothing about whether the row exists.
+     */
+    private resolveProviderCustomer;
+    /**
+     * Move a group's rows to the terminal `unreportable` state so the flush stops re-selecting them.
+     *
+     * NO money moved and none ever will, which is why this is its own state rather than a convenient
+     * `reported: true`. The reason and the instant are written beside it, because the row is a
+     * RETAINED financial record and the next reader of it — an auditor, an operator reconciling a
+     * period — needs to know why a measured quantity was never billed.
+     *
+     * A marking that does not fully land is reported and NOT retried here: the rows that stayed
+     * pending are simply selected again next run, which is harmless (unlike the reported case, where
+     * a partial marking risks double-billing). The counters follow what the write actually did.
+     */
+    private markGroupUnreportable;
 }
 //# sourceMappingURL=usage-metering.backend.service.d.ts.map

package/dist/esm/billing/services/back-office/usage-metering.backend.service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"usage-metering.backend.service.d.ts","sourceRoot":"","sources":["~~../../../../../../~~src/billing/services/back-office/usage-metering.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;~~AAGH~~,OAAO,~~EAIL~~,eAAe,~~EAKhB~~,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,yBAAyB,~~EAAE~~,MAAM,sCAAsC,CAAC;~~AACtF~~,OAAO,EAAE,6BAA6B,EAAE,MAAM,kFAAkF,CAAC;AACjI,OAAO,EAAE,KAAK,uBAAuB,~~EAA6B~~,MAAM,mFAAmF,CAAC;~~AAE5J~~,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;AACnH,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,qGAAqG,CAAC;AAMrK,MAAM,WAAW,kBAAkB;IACjC,gCAAgC;IAChC,MAAM,CAAC,EAAE;QACP,IAAI,EAAE,eAAe,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;~~CAClB~~;~~AAMD~~,qBACa,2BAA4B,SAAQ,6BAA6B;~~IAQX~~,OAAO,CAAC,QAAQ,CAAC,oBAAoB;~~gBALjE~~,MAAM,EAAE,aAAa,EACG,gBAAgB,EAAE,qCAAqC,EAChD,uBAAuB,EAAE,qCAAqC,EAC5E,iBAAiB,EAAE,+BAA+B,EACtD,YAAY,EAAE,0BAA0B,EACR,oBAAoB,EAAE,yCAAyC;IASpI,UAAU,CAAC,QAAQ,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3E~~;;;;;OAKG~~;IACU,WAAW,CACtB,QAAQ,EAAE,uBAAuB,EACjC,gBAAgB,EAAE,MAAM,EACxB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,~~IAAI~~,CAAC;~~IAyBhB~~;;;;OAIG;IACU,QAAQ,CACnB,QAAQ,EAAE,uBAAuB,EACjC,gBAAgB,EAAE,MAAM,EACxB,UAAU,CAAC,EAAE,MAAM,EACnB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,GAAG,EAAE,IAAI,CAAA;KAAE,GAClC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;~~IAwBlC~~;;;;;;OAMG;IACU,eAAe,IAAI,OAAO,CAAC,gBAAgB,CAAC;~~YAgC3C~~,oBAAoB;~~IAoGlC~~;;;;;;OAMG;YACW,4BAA4B;~~YAoC5B~~,~~yBAAyB~~;~~CAYxC~~"}
1	+ {"version":3,"file":"usage-metering.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/billing/services/back-office/usage-metering.backend.service.ts"],"names":[],"mappings":"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"}