@wildo-ai/saas-backend-lib 1.0.1

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

@@ -0,0 +1,102 @@
+/**
+ * Billing Feature Sync Backend Service
+ *
+ * THE BRIDGE: billing events → feature state updates.
+ * This is the CORE VALUE of the billing integration.
+ *
+ * When a subscription changes (created, updated, cancelled, addon added/removed),
+ * this service recomputes the billing-derived features for the affected scope entity
+ * and writes them to the scope features resource.
+ *
+ * Limit aggregation algorithm:
+ *   1. Start with active PLAN product's limits (SET mode: absolute values)
+ *   2. For each active ADDON:
+ *      - ADD mode limits: sum onto current value
+ *      - SET mode limits: take max(current, addon value)
+ *   3. FEATURES_UNLIMITED always wins in any comparison
+ *   4. Features (boolean): union of all active products' grantedFeatures
+ *
+ * @see billing-and-features-system.md §8.5 (Feature Sync Flow)
+ */
+import { type ScopeFeatures } from '@wildo-ai/saas-models';
+import type { LoggerService } from '../../../monitoring/logger/services/logger.service.js';
+import type { ServicesRegistryHandlerBackendService } from '../../../base-classes/services/services/services-registry-handler.backend.service.js';
+import type { ExecutionContextCreatorBackendService } from '../../../runtime/services/execution-context-creator.backend.service.js';
+import type { ResourcesRegistryBackendService } from '../../../resources/services/resources-registry.backend.service.js';
+import type { ErrorBuilderBackendService } from '../../../errors/services/error-builder.backend.service.js';
+import type { RedisService } from '../../../databases/services/redis.service.js';
+import type { WebSocketService } from '../../../requests/service/websocket.service.js';
+import { AbstractBillingBackendService } from '../../../billing/services/back-office/abstract-billing.backend.service.js';
+import { type BillingResolvedVariants } from '../../../billing/services/custom-impl/billing-custom-impl-utils.backend.js';
+export declare class BillingFeatureSyncBackendService extends AbstractBillingBackendService {
+    protected readonly redisService: RedisService;
+    private readonly webSocketService;
+    constructor(logger: LoggerService, servicesRegistry: ServicesRegistryHandlerBackendService, executionContextCreator: ExecutionContextCreatorBackendService, resourcesRegistry: ResourcesRegistryBackendService, errorBuilder: ErrorBuilderBackendService, redisService: RedisService, webSocketService: WebSocketService);
+    /**
+     * Recompute billing-derived features for a billing account.
+     * Called whenever a subscription changes.
+     *
+     * Flow:
+     * 1. Fetch the billing account to get scope info
+     * 2. Fetch all active subscriptions for this account
+     * 3. Collect grantedFeatures + grantedLimits from all products
+     * 4. Aggregate using SET/ADD rules
+     * 5. Write to scope features resource
+     * 6. Invalidate feature resolution cache
+     * 7. Emit WebSocket event for frontend invalidation
+     */
+    onSubscriptionChanged(billingAccountId: string, variantContext: BillingResolvedVariants): Promise<void>;
+    /**
+     * Compute billing-derived features from all active subscriptions on an account.
+     * Does NOT write — caller is responsible for persisting.
+     */
+    computeBillingDerivedFeatures(billingAccountId: string, subscriptionType: string, billingAccountFkField: string): Promise<ScopeFeatures>;
+    /**
+     * Recompute billing-derived features for ALL billing accounts.
+     * Used after product catalog changes (when grantedFeatures/grantedLimits change in code).
+     */
+    recomputeAll(): Promise<{
+        accountsProcessed: number;
+        accountsFailed: string[];
+    }>;
+    /**
+     * Aggregate features from all active products.
+     *
+     * Algorithm:
+     * 1. Find the PLAN product (only one active plan allowed) → SET limits
+     * 2. For each ADDON product → ADD or SET limits (per LimitGrantMode)
+     * 3. Union all boolean features
+     * 4. FEATURES_UNLIMITED always wins
+     */
+    private aggregateProductFeatures;
+    /**
+     * Write billing-derived features to the appropriate scope features resource,
+     * invalidate the feature resolution cache, and emit a WebSocket event.
+     *
+     * Dispatches to the correct resource type based on scopeType:
+     * - ORGANIZATIONS → ORGANIZATION_FEATURES
+     * - USER_SELF → USER_FEATURES
+     */
+    private writeBillingDerivedFeatures;
+    /**
+     * Invalidate the feature resolution cache for this scope entity.
+     */
+    private invalidateFeatureCache;
+    /**
+     * Emit a WebSocket event so the frontend can invalidate its feature cache in real-time.
+     * Dispatches to the correct scope room (organization or user).
+     */
+    private emitFeaturesUpdatedEvent;
+    private getBillingAccount;
+    private getActiveSubscriptions;
+    private getProduct;
+    /**
+     * Map scope type to the corresponding features resource type.
+     */
+    private getScopeFeaturesResourceType;
+    /**
+     * Map scope type to the foreign key field name used in the features resource.
+     */
+    private getScopeForeignKeyField;
+}
+//# sourceMappingURL=billing-feature-sync.backend.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing-feature-sync.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/billing/services/back-office/billing-feature-sync.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAIL,KAAK,aAAa,EAWnB,MAAM,uBAAuB,CAAC;AAE/B,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,YAAY,EAAE,MAAM,qDAAqD,CAAC;AACxF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uDAAuD,CAAC;AAC9F,OAAO,EAAE,6BAA6B,EAAE,MAAM,kFAAkF,CAAC;AAEjI,OAAO,EAAE,KAAK,uBAAuB,EAA6B,MAAM,mFAAmF,CAAC;AAM5J,qBACa,gCAAiC,SAAQ,6BAA6B;IAOtC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBAN3C,MAAM,EAAE,aAAa,EACG,gBAAgB,EAAE,qCAAqC,EAChD,uBAAuB,EAAE,qCAAqC,EAC5E,iBAAiB,EAAE,+BAA+B,EACtD,YAAY,EAAE,0BAA0B,EAC5B,YAAY,EAAE,YAAY,EACxB,gBAAgB,EAAE,gBAAgB;IASlG;;;;;;;;;;;;OAYG;IACU,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiCpH;;;OAGG;IACU,6BAA6B,CACxC,gBAAgB,EAAE,MAAM,EACxB,gBAAgB,EAAE,MAAM,EACxB,qBAAqB,EAAE,MAAM,GAC5B,OAAO,CAAC,aAAa,CAAC;IA6BzB;;;OAGG;IACU,YAAY,IAAI,OAAO,CAAC;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAyD7F;;;;;;;;OAQG;IACH,OAAO,CAAC,wBAAwB;IAuDhC;;;;;;;OAOG;YACW,2BAA2B;IA6CzC;;OAEG;YACW,sBAAsB;IAcpC;;;OAGG;YACW,wBAAwB;YAoCxB,iBAAiB;YAUjB,sBAAsB;YAiBtB,UAAU;IAgBxB;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAiBpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAgBhC"}

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

@@ -0,0 +1,405 @@
+/**
+ * Billing Feature Sync Backend Service
+ *
+ * THE BRIDGE: billing events → feature state updates.
+ * This is the CORE VALUE of the billing integration.
+ *
+ * When a subscription changes (created, updated, cancelled, addon added/removed),
+ * this service recomputes the billing-derived features for the affected scope entity
+ * and writes them to the scope features resource.
+ *
+ * Limit aggregation algorithm:
+ *   1. Start with active PLAN product's limits (SET mode: absolute values)
+ *   2. For each active ADDON:
+ *      - ADD mode limits: sum onto current value
+ *      - SET mode limits: take max(current, addon value)
+ *   3. FEATURES_UNLIMITED always wins in any comparison
+ *   4. Features (boolean): union of all active products' grantedFeatures
+ *
+ * @see billing-and-features-system.md §8.5 (Feature Sync Flow)
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { injectable, inject } from 'inversify';
+import { FEATURES_UNLIMITED, LimitGrantMode, ProductType, SubscriptionStatus, ResourcePrimaryScope, CoreResourceType, CoreResourceOperation, CoreWebSocketEvent, ErrorType, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { SAAS_SERVICE_TYPES } from '../../../inject/models/service-types.js';
+import { AbstractBillingBackendService } from '../../../billing/services/back-office/abstract-billing.backend.service.js';
+import { mergeLimit } from '../../../billing/services/billing.utils.js';
+import { BILLING_SCOPE_TO_VARIANTS } from '../../../billing/services/custom-impl/billing-custom-impl-utils.backend.js';
+// =====================================================
+// Service
+// =====================================================
+let BillingFeatureSyncBackendService = class BillingFeatureSyncBackendService extends AbstractBillingBackendService {
+    redisService;
+    webSocketService;
+    constructor(logger, servicesRegistry, executionContextCreator, resourcesRegistry, errorBuilder, redisService, webSocketService) {
+        super(logger, servicesRegistry, executionContextCreator, resourcesRegistry, errorBuilder);
+        this.redisService = redisService;
+        this.webSocketService = webSocketService;
+    }
+    // ════════════════════════════════════════════════════════════
+    // Public API
+    // ════════════════════════════════════════════════════════════
+    /**
+     * Recompute billing-derived features for a billing account.
+     * Called whenever a subscription changes.
+     *
+     * Flow:
+     * 1. Fetch the billing account to get scope info
+     * 2. Fetch all active subscriptions for this account
+     * 3. Collect grantedFeatures + grantedLimits from all products
+     * 4. Aggregate using SET/ADD rules
+     * 5. Write to scope features resource
+     * 6. Invalidate feature resolution cache
+     * 7. Emit WebSocket event for frontend invalidation
+     */
+    async onSubscriptionChanged(billingAccountId, variantContext) {
+        this.logDebug('Subscription changed, recomputing features', { billingAccountId, scopeKey: variantContext.scopeKey });
+        // 1. Get billing account from the correct polymorphic variant collection
+        const billingAccount = await this.getBillingAccount(billingAccountId, variantContext.billingAccount);
+        if (!billingAccount) {
+            this.logger.warn('Billing account not found for feature sync', { billingAccountId, billingAccountType: variantContext.billingAccount });
+            return;
+        }
+        // 2. Compute billing-derived features using the correct subscription variant
+        const features = await this.computeBillingDerivedFeatures(billingAccountId, variantContext.subscription, variantContext.billingAccountFkField);
+        // 3. Resolve scope from variant context.
+        // NOTE: uses scopeEntityDocField (document field name), NOT scopeKey (ExecutionContext field).
+        const scopeEntityId = billingAccount[variantContext.scopeEntityDocField] ?? '';
+        await this.writeBillingDerivedFeatures(variantContext.scopeType, scopeEntityId, billingAccountId, features);
+        this.logDebug('Feature sync complete', {
+            billingAccountId,
+            scopeType: variantContext.scopeType,
+            scopeEntityId,
+            featuresCount: features.features.length,
+            limitsCount: Object.keys(features.limits).length,
+        });
+    }
+    /**
+     * Compute billing-derived features from all active subscriptions on an account.
+     * Does NOT write — caller is responsible for persisting.
+     */
+    async computeBillingDerivedFeatures(billingAccountId, subscriptionType, billingAccountFkField) {
+        // Fetch all active subscriptions from the correct polymorphic variant
+        const subscriptions = await this.getActiveSubscriptions(billingAccountId, subscriptionType, billingAccountFkField);
+        if (subscriptions.length === 0) {
+            return { features: [], limits: {} };
+        }
+        // Collect all products from all subscription items
+        const allProducts = [];
+        for (const sub of subscriptions) {
+            for (const item of sub.items) {
+                try {
+                    const product = await this.getProduct(item.productId);
+                    allProducts.push(product);
+                }
+                catch (error) {
+                    this.logger.warn('Product not found for subscription item', {
+                        productId: item.productId,
+                        subscriptionId: sub._id,
+                        error: error.message,
+                    });
+                }
+            }
+        }
+        // Aggregate
+        return this.aggregateProductFeatures(allProducts);
+    }
+    /**
+     * Recompute billing-derived features for ALL billing accounts.
+     * Used after product catalog changes (when grantedFeatures/grantedLimits change in code).
+     */
+    async recomputeAll() {
+        this.logDebug('Starting recomputeAll for all billing accounts');
+        const result = { accountsProcessed: 0, accountsFailed: [] };
+        const PAGE_SIZE = 100;
+        // Iterate all 3 polymorphic billing account variant collections
+        for (const [scopeKey, variantData] of Object.entries(BILLING_SCOPE_TO_VARIANTS)) {
+            const variantContext = { scopeKey, ...variantData };
+            try {
+                let hasMore = true;
+                let currentPage = 1;
+                while (hasMore) {
+                    const ctx = await this.internalCtx(variantContext.billingAccount, CoreResourceOperation.LIST);
+                    const accounts = await this.servicesRegistry.list(variantContext.billingAccount, ctx, { isActive: true }, { limit: PAGE_SIZE, page: currentPage });
+                    if (accounts.length < PAGE_SIZE) {
+                        hasMore = false;
+                    }
+                    currentPage++;
+                    for (const account of accounts) {
+                        try {
+                            await this.onSubscriptionChanged(account._id, variantContext);
+                            result.accountsProcessed++;
+                        }
+                        catch (error) {
+                            result.accountsFailed.push(account._id);
+                            this.logger.error('Failed to recompute features for billing account', {
+                                billingAccountId: account._id,
+                                variant: variantContext.billingAccount,
+                                error: error.message,
+                            });
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                this.logger.error('Failed to list billing accounts for recomputeAll', {
+                    variant: variantContext.billingAccount,
+                    error: error.message,
+                });
+            }
+        }
+        this.logDebug('recomputeAll complete', result);
+        return result;
+    }
+    // ════════════════════════════════════════════════════════════
+    // Private — Aggregation
+    // ════════════════════════════════════════════════════════════
+    /**
+     * Aggregate features from all active products.
+     *
+     * Algorithm:
+     * 1. Find the PLAN product (only one active plan allowed) → SET limits
+     * 2. For each ADDON product → ADD or SET limits (per LimitGrantMode)
+     * 3. Union all boolean features
+     * 4. FEATURES_UNLIMITED always wins
+     */
+    aggregateProductFeatures(products) {
+        const allFeatures = new Set();
+        const aggregatedLimits = {};
+        // Step 1: Find the PLAN product and use its limits as the base (SET mode)
+        const planProduct = products.find(p => p.type === ProductType.PLAN);
+        if (planProduct) {
+            // Add plan's boolean features
+            for (const f of planProduct.grantedFeatures ?? []) {
+                allFeatures.add(f);
+            }
+            // Add plan's limits (SET = absolute values)
+            for (const [key, grant] of Object.entries(planProduct.grantedLimits ?? {})) {
+                aggregatedLimits[key] = grant.value;
+            }
+        }
+        // Step 2: Process addons and other products
+        const nonPlanProducts = products.filter(p => p.type !== ProductType.PLAN);
+        for (const product of nonPlanProducts) {
+            // Add boolean features (union)
+            for (const f of product.grantedFeatures ?? []) {
+                allFeatures.add(f);
+            }
+            // Add limits with mode-aware aggregation
+            for (const [key, grant] of Object.entries(product.grantedLimits ?? {})) {
+                const currentValue = aggregatedLimits[key];
+                if (currentValue === undefined) {
+                    // First time seeing this limit key
+                    aggregatedLimits[key] = grant.value;
+                }
+                else if (grant.value === FEATURES_UNLIMITED || currentValue === FEATURES_UNLIMITED) {
+                    // FEATURES_UNLIMITED always wins
+                    aggregatedLimits[key] = FEATURES_UNLIMITED;
+                }
+                else if (grant.mode === LimitGrantMode.ADD) {
+                    // ADD mode: sum onto current
+                    aggregatedLimits[key] = currentValue + grant.value;
+                }
+                else {
+                    // SET mode on addon: take max(current, addon value)
+                    aggregatedLimits[key] = mergeLimit(currentValue, grant.value);
+                }
+            }
+        }
+        return {
+            features: [...allFeatures],
+            limits: aggregatedLimits,
+        };
+    }
+    // ════════════════════════════════════════════════════════════
+    // Private — Write & Invalidation
+    // ════════════════════════════════════════════════════════════
+    /**
+     * Write billing-derived features to the appropriate scope features resource,
+     * invalidate the feature resolution cache, and emit a WebSocket event.
+     *
+     * Dispatches to the correct resource type based on scopeType:
+     * - ORGANIZATIONS → ORGANIZATION_FEATURES
+     * - USER_SELF → USER_FEATURES
+     */
+    async writeBillingDerivedFeatures(scopeType, scopeEntityId, billingAccountId, features) {
+        const resourceType = this.getScopeFeaturesResourceType(scopeType);
+        const foreignKeyField = this.getScopeForeignKeyField(scopeType);
+        try {
+            // Attempt to find existing scope features for this entity
+            const listCtx = await this.internalCtx(resourceType, CoreResourceOperation.LIST);
+            const existing = await this.servicesRegistry.list(resourceType, listCtx, { [foreignKeyField]: scopeEntityId });
+            const featureData = {
+                [foreignKeyField]: scopeEntityId,
+                features: features.features,
+                limits: features.limits,
+            };
+            if (existing.length > 0) {
+                const updateCtx = await this.internalCtx(resourceType, CoreResourceOperation.UPDATE);
+                await this.servicesRegistry.update(resourceType, updateCtx, existing[0]._id, featureData);
+            }
+            else {
+                const createCtx = await this.internalCtx(resourceType, CoreResourceOperation.CREATE);
+                await this.servicesRegistry.create(resourceType, createCtx, featureData);
+            }
+        }
+        catch (error) {
+            this.logger.error('Failed to write billing-derived features', {
+                scopeType,
+                scopeEntityId,
+                resourceType,
+                error: error.message,
+            });
+        }
+        // Invalidate feature resolution cache
+        await this.invalidateFeatureCache(scopeType, scopeEntityId);
+        // Emit WebSocket event for frontend feature cache invalidation
+        await this.emitFeaturesUpdatedEvent(scopeType, scopeEntityId, billingAccountId);
+    }
+    /**
+     * Invalidate the feature resolution cache for this scope entity.
+     */
+    async invalidateFeatureCache(scopeType, scopeEntityId) {
+        try {
+            const cacheKey = `features:${scopeType}:${scopeEntityId}`;
+            await this.redisService.del(cacheKey);
+            this.logDebug('Feature cache invalidated', { cacheKey });
+        }
+        catch (error) {
+            this.logger.warn('Failed to invalidate feature cache', {
+                scopeType,
+                scopeEntityId,
+                error: error.message,
+            });
+        }
+    }
+    /**
+     * Emit a WebSocket event so the frontend can invalidate its feature cache in real-time.
+     * Dispatches to the correct scope room (organization or user).
+     */
+    async emitFeaturesUpdatedEvent(scopeType, scopeEntityId, billingAccountId) {
+        try {
+            const message = {
+                type: CoreWebSocketEvent.BILLING_FEATURES_UPDATED,
+                payload: { scopeType, scopeEntityId, billingAccountId },
+                timestamp: new Date(),
+            };
+            switch (scopeType) {
+                case ResourcePrimaryScope.ORGANIZATIONS:
+                    await this.webSocketService.sendToOrganization(scopeEntityId, message);
+                    break;
+                case ResourcePrimaryScope.USER_SELF:
+                    await this.webSocketService.sendToUser(scopeEntityId, message);
+                    break;
+            }
+            this.logDebug('Features updated WebSocket event emitted', { scopeType, scopeEntityId, billingAccountId });
+        }
+        catch (error) {
+            this.logger.warn('Failed to emit features updated WebSocket event', {
+                scopeType,
+                scopeEntityId,
+                billingAccountId,
+                error: error.message,
+            });
+        }
+    }
+    // ════════════════════════════════════════════════════════════
+    // Private — Resource Operations
+    // ════════════════════════════════════════════════════════════
+    async getBillingAccount(billingAccountId, billingAccountType) {
+        try {
+            const ctx = await this.internalCtx(billingAccountType, CoreResourceOperation.READ);
+            return await this.servicesRegistry.read(billingAccountType, ctx, billingAccountId);
+        }
+        catch (error) {
+            this.logDebug('Failed to read billing account', { billingAccountId, billingAccountType, error: error.message });
+            return null;
+        }
+    }
+    async getActiveSubscriptions(billingAccountId, subscriptionType, billingAccountFkField) {
+        try {
+            const ctx = await this.internalCtx(subscriptionType, CoreResourceOperation.LIST);
+            return await this.servicesRegistry.list(subscriptionType, ctx, { [billingAccountFkField]: billingAccountId, status: { $in: [SubscriptionStatus.ACTIVE, SubscriptionStatus.TRIALING] } });
+        }
+        catch (error) {
+            this.logDebug('Failed to list active subscriptions', { billingAccountId, subscriptionType, error: error.message });
+            return [];
+        }
+    }
+    async getProduct(productId) {
+        const ctx = await this.internalCtx(CoreResourceType.PRODUCTS, CoreResourceOperation.READ);
+        const product = await this.servicesRegistry.read(CoreResourceType.PRODUCTS, ctx, productId);
+        if (!product) {
+            throw this.errorBuilder.buildError(ErrorType.NOT_FOUND, undefined, {
+                customMessageReference: ErrorCustomMessageReference.BILLING_PRODUCT_NOT_FOUND,
+                context: { productId },
+            });
+        }
+        return product;
+    }
+    // ════════════════════════════════════════════════════════════
+    // Private — Scope Resolution
+    // ════════════════════════════════════════════════════════════
+    /**
+     * Map scope type to the corresponding features resource type.
+     */
+    getScopeFeaturesResourceType(scopeType) {
+        switch (scopeType) {
+            case ResourcePrimaryScope.ORGANIZATIONS:
+                return CoreResourceType.ORGANIZATION_FEATURES;
+            case ResourcePrimaryScope.USER_SELF:
+                return CoreResourceType.USER_FEATURES;
+            case ResourcePrimaryScope.APPLICATION:
+                throw new Error('APPLICATION scope has no billing feature variants');
+            case ResourcePrimaryScope.ANONYMOUS:
+                throw new Error('ANONYMOUS scope has no billing feature variants');
+            default: {
+                const _exhaustive = scopeType;
+                throw new Error(`Unsupported scope type for features: ${_exhaustive}`);
+            }
+        }
+    }
+    /**
+     * Map scope type to the foreign key field name used in the features resource.
+     */
+    getScopeForeignKeyField(scopeType) {
+        switch (scopeType) {
+            case ResourcePrimaryScope.ORGANIZATIONS:
+                return 'organizationId';
+            case ResourcePrimaryScope.USER_SELF:
+                return 'userId';
+            case ResourcePrimaryScope.APPLICATION:
+                throw new Error('APPLICATION scope has no billing FK field');
+            case ResourcePrimaryScope.ANONYMOUS:
+                throw new Error('ANONYMOUS scope has no billing FK field');
+            default: {
+                const _exhaustive = scopeType;
+                throw new Error(`Unsupported scope type for FK field: ${_exhaustive}`);
+            }
+        }
+    }
+};
+BillingFeatureSyncBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.ServicesRegistryHandlerService)),
+    __param(2, inject(SAAS_SERVICE_TYPES.ExecutionContextCreatorBackendService)),
+    __param(3, inject(SAAS_SERVICE_TYPES.ResourceRegistryService)),
+    __param(4, inject(SAAS_SERVICE_TYPES.ErrorBuilderService)),
+    __param(5, inject(SAAS_SERVICE_TYPES.RedisService)),
+    __param(6, inject(SAAS_SERVICE_TYPES.WebSocketService)),
+    __metadata("design:paramtypes", [Function, Function, Function, Function, Function, Function, Function])
+], BillingFeatureSyncBackendService);
+export { BillingFeatureSyncBackendService };
+//# sourceMappingURL=billing-feature-sync.backend.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing-feature-sync.backend.service.js","sourceRoot":"","sources":["../../../../../src/billing/services/back-office/billing-feature-sync.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/billing/services/back-office/billing-state.backend.service.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Billing State Backend Service
+ *
+ * Aggregated billing state endpoint (Strategy C — lazy facade).
+ *
+ * Accepts scopeType + scopeEntityId, resolves the billing account internally
+ * (auto-creates if missing), and returns the full aggregated state:
+ * billing account, subscription, products, prices, credit pools, usage.
+ *
+ * This is the single entry point the frontend BillingProvider calls on mount.
+ */
+import { type BillingStateResponse, ResourcePrimaryScope } from '@wildo-ai/saas-models';
+import type { LoggerService } from '../../../monitoring/logger/services/logger.service.js';
+import type { ServicesRegistryHandlerBackendService } from '../../../base-classes/services/services/services-registry-handler.backend.service.js';
+import type { ExecutionContextCreatorBackendService } from '../../../runtime/services/execution-context-creator.backend.service.js';
+import type { ResourcesRegistryBackendService } from '../../../resources/services/resources-registry.backend.service.js';
+import type { ErrorBuilderBackendService } from '../../../errors/services/error-builder.backend.service.js';
+import { AbstractBillingBackendService } from '../../../billing/services/back-office/abstract-billing.backend.service.js';
+import type { UsageMeteringBackendService } from '../../../billing/services/back-office/usage-metering.backend.service.js';
+export declare class BillingStateBackendService extends AbstractBillingBackendService {
+    private readonly usageMeteringService;
+    constructor(logger: LoggerService, servicesRegistry: ServicesRegistryHandlerBackendService, executionContextCreator: ExecutionContextCreatorBackendService, resourcesRegistry: ResourcesRegistryBackendService, errorBuilder: ErrorBuilderBackendService, usageMeteringService: UsageMeteringBackendService);
+    /**
+     * Fetch the full aggregated billing state for a scope entity.
+     *
+     * Flow:
+     * 1. Validate scopeType against enabledScopes
+     * 2. Resolve polymorphic variants for this scope
+     * 3. Query billing account (auto-create if missing)
+     * 4. Query subscription, products, prices, credit pools
+     * 5. Return aggregated response
+     */
+    getState(scopeType: ResourcePrimaryScope, scopeEntityId: string, enabledScopes: ResourcePrimaryScope[]): Promise<BillingStateResponse>;
+    private resolveOrCreateBillingAccount;
+    private findBillingAccount;
+    private getActiveSubscription;
+    private getAllProducts;
+    private getAllPrices;
+    private getInvoices;
+    private getCreditPools;
+    private getUsageSummary;
+    /**
+     * Return promotions that are valid for the current billing scope surface.
+     *
+     * The billing-state endpoint is consumed before the user has selected an exact
+     * checkout item, so this intentionally stays broader than "guaranteed
+     * redeemable for the next product click". What it guarantees instead:
+     * - the promotion is currently active and within its validity window
+     * - the promotion is synced to the billing provider
+     * - if it targets products explicitly, at least one targeted product is visible
+     *   in the current billing scope
+     */
+    private getActivePromotions;
+}
+//# sourceMappingURL=billing-state.backend.service.d.ts.map

package/dist/esm/billing/services/back-office/billing-state.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-state.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/billing/services/back-office/billing-state.backend.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAQL,KAAK,oBAAoB,EAIzB,oBAAoB,EAIrB,MAAM,uBAAuB,CAAC;AAE/B,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,EAAE,6BAA6B,EAAE,MAAM,kFAAkF,CAAC;AACjI,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,gFAAgF,CAAC;AAQlI,qBACa,0BAA2B,SAAQ,6BAA6B;IAOxB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;gBALnD,MAAM,EAAE,aAAa,EACG,gBAAgB,EAAE,qCAAqC,EAChD,uBAAuB,EAAE,qCAAqC,EAC5E,iBAAiB,EAAE,+BAA+B,EACtD,YAAY,EAAE,0BAA0B,EACtB,oBAAoB,EAAE,2BAA2B;IAKrH;;;;;;;;;OASG;IACU,QAAQ,CACnB,SAAS,EAAE,oBAAoB,EAC/B,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,oBAAoB,EAAE,GACpC,OAAO,CAAC,oBAAoB,CAAC;YAwDlB,6BAA6B;YA+B7B,kBAAkB;YA2BlB,qBAAqB;YAsBrB,cAAc;YAUd,YAAY;YAUZ,WAAW;YAoBX,cAAc;YA2Bd,eAAe;IAsC7B;;;;;;;;;;OAUG;YACW,mBAAmB;CAuBlC"}