@wildo-ai/saas-frontend-lib 1.1.4 → 1.1.6

package/dist/esm/core/billing/BillingContext.js

@@ -17,12 +17,12 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * - Stripe Customer Portal (hosted page): for invoices, payment methods, cancellation
  */
 import { createContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';
-import { BUILTIN_PROVIDER_CAPABILITY, BUILTIN_PROVIDER_PROTOCOL, CoreWebSocketEvent, CoreResourceType, ResourcePrimaryScope, MAIN_API_BASE_PATH, } from '@wildo-ai/saas-models';
+import { BillingAccount_Operations, BillingSubscription_Operations, BillingSubscription_PreviewPlanChangeRequestDto, BillingSubscription_ChangePlanRequestDto, BillingSubscription_PlanChangePreviewResponseDto, ResourceOperationVariantType, ResourcesConfig_OperationPathUtils, HttpMethod, BillingStateSlice, BillingSliceAvailability, CoreWebSocketEvent, CoreResourceType, ResourcePrimaryScope, MAIN_API_BASE_PATH, userRolesSatisfyRequiredRoles, } from '@wildo-ai/saas-models';
 import { useWebSocket } from '../../core/requests/websockets/useWebSocket.js';
 import { useUserOrgs } from '../../core/security/useUserOrgs.js';
 import { useAppScopeSafe } from '../../core/scope/useAppScope.js';
 import { useApplication } from '../../core/runtime/useApplication.js';
-import { useResourceRegistrySafe } from '../../core/resources/useResourceRegistry.js';
+import { isResourceReachable, useResourceRegistrySafe } from '../../core/resources/useResourceRegistry.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
 import { getManualCallsHttpClient } from '../../core/requests/wildo-http-client-manual-calls.frontend.service.js';
 import { useEmitLoadingScope } from '../../core/loading/useEmitLoadingScope.js';
@@ -85,27 +85,12 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
     // ── Self-resolve configuration from hooks ──
     const userOrgs = useUserOrgs();
     const appScope = useAppScopeSafe();
-    const { appConfig, frontendProviderRegistry } = useApplication();
+    const { appConfig } = useApplication();
     const resourceRegistry = useResourceRegistrySafe();
     const billingConfig = appConfig.billing;
     /** What the application CONFIGURED — see `isEnabled` below for why that is only half the answer. */
     const isConfiguredEnabled = billingConfig?.enabled ?? false;
-    const billingProvider = useMemo(() => {
-        const configuredProviderRef = billingConfig?.providerRef;
-        const configuredProvider = configuredProviderRef
-            ? frontendProviderRegistry?.getProviderByRef(configuredProviderRef)
-            : undefined;
-        const resolvedProvider = isBillingFrontendProvider(configuredProvider)
-            ? configuredProvider
-            : frontendProviderRegistry?.findByProviderCapabilityAndProtocol(BUILTIN_PROVIDER_CAPABILITY.BILLING, BUILTIN_PROVIDER_PROTOCOL.BILLING_PROVIDER) ?? null;
-        if (isConfiguredEnabled && configuredProviderRef && resolvedProvider?.metadata.ref !== configuredProviderRef) {
-            logDebug('Billing config providerRef does not match the hydrated frontend billing provider', {
-                configuredProviderRef,
-                resolvedProviderRef: resolvedProvider?.metadata.ref,
-            });
-        }
-        return resolvedProvider;
-    }, [billingConfig?.providerRef, frontendProviderRegistry, isConfiguredEnabled]);
+    const billingProviderRef = isConfiguredEnabled ? billingConfig?.providerRef ?? null : null;
     // ── Self-resolve scope ──
     const enabledScopes = billingConfig?.enabledScopes ?? [ResourcePrimaryScope.ORGANIZATIONS];
     const { scopeType, scopeEntityId } = useMemo(() => {
@@ -138,14 +123,43 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
      */
     const isEnabled = isConfiguredEnabled
         && billingAccountResourceType !== null
-        // A registry that is ABSENT is ignorance, not a negative answer — only a registry that HAS been
-        // asked and says no disables billing. Blocking on the absent case instead disabled billing for
-        // every consumer that mounts this provider without a registry in context, which is what three
-        // of this file's own tests do and what caught the first version of this gate.
-        && (resourceRegistry === undefined || resourceRegistry.hasResource(billingAccountResourceType));
+        // The absent-registry-is-ignorance rule lives on the seam (`isResourceReachable`), shared with the
+        // features, guidance and analytics providers since #1069 so the four cannot drift.
+        && isResourceReachable(resourceRegistry, billingAccountResourceType);
+    /**
+     * Whether THIS CALLER may read the billing state served for this scope — kept separate from `isEnabled`, on purpose.
+     *
+     * `isEnabled` says billing is PART OF the application. Every consumer of it — feature availability, operation
+     * gating, the launcher — needs that answer for every user alike, so it must not vary with who is looking.
+     *
+     * Fetching is a different question. `GET_STATE` is role-gated per scope (organization owners and administrators on
+     * the organization variant), and a plain member used to request it on every page load, be refused with 403, and
+     * see an access-denied message on a page with nothing wrong with it (#1039). That member already ended with a null
+     * billing state — the refusal produced it — so not asking changes nothing they can see except the message.
+     *
+     * The required roles are read from the registry's OWN operation, never copied, and decided by the same
+     * hierarchy-aware check the action bar uses. That check fails open on a role it cannot resolve, so a custom role
+     * inheriting an administrator role is not locked out here — the server stays the authority either way. With no
+     * registry, or no such operation in it, there is no evidence to withhold on, and the request goes out as before.
+     */
+    const permissions = userOrgs.permissions;
+    const currentOrganizationId = appScope?.currentOrganizationId ?? null;
+    const mayReadBillingState = useMemo(() => {
+        if (!isEnabled || !billingAccountResourceType)
+            return false;
+        const getStateOperation = resourceRegistry?.registry.resourceConfigurations[billingAccountResourceType]
+            ?.operations.find((operation) => String(operation.operationIdentifier) === BillingAccount_Operations.GET_STATE && operation.isOperationDefault === true);
+        if (!getStateOperation)
+            return true;
+        return userRolesSatisfyRequiredRoles({
+            requiredRoles: getStateOperation.roles,
+            userAppRoles: permissions?.appLevel ?? [],
+            userOrgRoles: currentOrganizationId ? permissions?.organizations?.[currentOrganizationId] ?? [] : [],
+        });
+    }, [isEnabled, billingAccountResourceType, resourceRegistry, permissions, currentOrganizationId]);
     // ── State ──
     const [billingState, setBillingState] = useState(null);
-    const [isLoading, setIsLoading] = useState(isEnabled && !!scopeEntityId);
+    const [isLoading, setIsLoading] = useState(mayReadBillingState && !!scopeEntityId);
     const [error, setError] = useState(null);
     // L-2.b: mirror local loading state onto the LoadingContext event bus so
     // unrelated components can observe billing-state lifecycle via
@@ -172,11 +186,11 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
     useEffect(() => {
         setBillingState(null);
         setError(null);
-        setIsLoading(isEnabled && !!scopeEntityId);
-    }, [scopeType, scopeEntityId, isEnabled]);
+        setIsLoading(mayReadBillingState && !!scopeEntityId);
+    }, [scopeType, scopeEntityId, mayReadBillingState]);
     // ── Fetch billing state from backend ──
     const fetchBillingState = useCallback(async () => {
-        if (!isEnabled || !scopeType || !scopeEntityId)
+        if (!mayReadBillingState || !scopeType || !scopeEntityId)
             return;
         if (fetchInFlightRef.current)
             return;
@@ -190,17 +204,7 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
             const url = urlBuilder(scopeEntityId);
             const response = await httpClient.get(url);
             if (mountedRef.current) {
-                setBillingState({
-                    billingAccount: response.billingAccount,
-                    subscription: response.subscription,
-                    products: response.products ?? [],
-                    prices: response.prices ?? [],
-                    invoices: response.invoices ?? [],
-                    usage: response.usage ?? EMPTY_USAGE,
-                    creditPools: response.creditPools ?? {},
-                    activePromotions: response.activePromotions ?? [],
-                    scopeType: response.scopeType,
-                });
+                setBillingState(response);
                 setError(null);
                 logDebug('Billing state fetched', {
                     hasAccount: !!response.billingAccount,
@@ -214,6 +218,7 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
         catch (err) {
             if (mountedRef.current) {
                 const message = err instanceof Error ? err.message : 'Failed to fetch billing state';
+                setBillingState(null);
                 setError(err instanceof Error ? err : new Error(message));
                 logDebug('Failed to fetch billing state', { error: message });
             }
@@ -224,11 +229,11 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
             }
             fetchInFlightRef.current = false;
         }
-    }, [isEnabled, scopeType, scopeEntityId]);
+    }, [mayReadBillingState, scopeType, scopeEntityId]);
     // ── Initial fetch ──
     useEffect(() => {
         mountedRef.current = true;
-        if (isEnabled && scopeType && scopeEntityId) {
+        if (mayReadBillingState && scopeType && scopeEntityId) {
             fetchBillingState();
         }
         else {
@@ -237,10 +242,10 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
         return () => {
             mountedRef.current = false;
         };
-    }, [fetchBillingState, isEnabled, scopeType, scopeEntityId]);
+    }, [fetchBillingState, mayReadBillingState, scopeType, scopeEntityId]);
     // ── WebSocket invalidation (debounced) ──
     useEffect(() => {
-        if (!isEnabled)
+        if (!mayReadBillingState)
             return;
         const unsubscribers = [];
         const debouncedRefetch = () => {
@@ -288,8 +293,10 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
                 unsub();
             }
         };
-    }, [on, fetchBillingState, isEnabled, scopeType, scopeEntityId, billingAccountId]);
+    }, [on, fetchBillingState, mayReadBillingState, scopeType, scopeEntityId, billingAccountId]);
     // ── Derived state ──
+    const availability = billingState?.availability ?? null;
+    const isSliceAvailable = useCallback((slice) => availability?.[slice] === BillingSliceAvailability.AVAILABLE, [availability]);
     const billingAccount = billingState?.billingAccount ?? null;
     const subscription = billingState?.subscription ?? null;
     const products = billingState?.products ?? [];
@@ -298,6 +305,7 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
     const usage = billingState?.usage ?? EMPTY_USAGE;
     const creditPools = billingState?.creditPools ?? {};
     const activePromotions = billingState?.activePromotions ?? [];
+    const acquirableProductKeys = billingState?.acquirableProductKeys;
     const currentScope = scopeType ?? null;
     // ── Product catalog lookups ──
     const productsByKey = useMemo(() => {
@@ -318,6 +326,8 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
     }, [prices]);
     const getPricesForProduct = useCallback((productId) => pricesByProductId.get(productId) ?? [], [pricesByProductId]);
     const getProductByKey = useCallback((key) => productsByKey.get(key), [productsByKey]);
+    const acquirableProductKeySet = useMemo(() => new Set(acquirableProductKeys ?? []), [acquirableProductKeys]);
+    const isProductAcquirable = useCallback((key) => acquirableProductKeySet.has(key), [acquirableProductKeySet]);
     // ── Current plan derivation ──
     const { currentPlanKey, currentPlanProduct } = useMemo(() => {
         if (!subscription || !subscription.items?.length) {
@@ -357,7 +367,6 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
                 cancelUrl: `${resolvedRedirectBase}/billing/cancel`,
                 quantity: options?.quantity,
                 promotionCode: options?.promotionCode,
-                trialDays: options?.trialDays,
             });
             if (response.url) {
                 window.location.href = response.url;
@@ -386,10 +395,48 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
         }
     }, [billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, resolvedRedirectBase]);
     // ── Context value (memoized for stable reference) ──
+    // Use the registry's compiled operation paths and parameter vocabulary. Subscription routes have
+    // account and scope parents; hand-authored URLs would silently diverge between org and user variants.
+    const callPlanOperation = useCallback(async (operationIdentifier, payload, signal) => {
+        if (!resourceRegistry || !subscription?._id || !billingAccountId || !billingAccountResourceType || !scopeType || !scopeEntityId
+            || ![BillingStateSlice.BILLING_ACCOUNT, BillingStateSlice.SUBSCRIPTION, BillingStateSlice.PRODUCTS, BillingStateSlice.PRICES].every(isSliceAvailable)) {
+            throw new Error('Billing plan change context is unavailable.');
+        }
+        const subscriptionType = scopeType === ResourcePrimaryScope.ORGANIZATIONS ? CoreResourceType.ORGANIZATION_SUBSCRIPTIONS : CoreResourceType.USER_SUBSCRIPTIONS;
+        const config = resourceRegistry.registry.resourceConfigurations[subscriptionType];
+        const operation = config?.operations.find(candidate => candidate.operationIdentifier === operationIdentifier
+            && candidate.variantType === ResourceOperationVariantType.API_CALL && candidate.isOperationDefault);
+        if (!operation || operation.variantType !== ResourceOperationVariantType.API_CALL)
+            throw new Error('Billing plan change operation is unavailable.');
+        const fields = resourceRegistry.registry.allResourceFieldIdentifiers;
+        const scopeResourceType = scopeType === ResourcePrimaryScope.ORGANIZATIONS ? CoreResourceType.ORGANIZATIONS : CoreResourceType.USERS;
+        const accountField = fields[billingAccountResourceType];
+        const scopeField = fields[scopeResourceType];
+        if (!config.resourceFieldIdentifier || !accountField || !scopeField)
+            throw new Error('Billing plan change route context is unavailable.');
+        return resourceRegistry.doOperation(ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation), {
+            contextualParameters: { [config.resourceFieldIdentifier]: subscription._id, [accountField]: billingAccountId, [scopeField]: scopeEntityId },
+            ...(operation.httpVerb === HttpMethod.GET ? { queryParameters: payload } : { requestData: payload }),
+        }, { signal, silent: true });
+    }, [resourceRegistry, subscription?._id, billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, isSliceAvailable]);
+    const previewPlanChange = useCallback(async (target, options) => {
+        const parsed = BillingSubscription_PreviewPlanChangeRequestDto.parse(target);
+        const response = await callPlanOperation(BillingSubscription_Operations.PREVIEW_PLAN_CHANGE, parsed, options?.signal);
+        return BillingSubscription_PlanChangePreviewResponseDto.parse(response);
+    }, [callPlanOperation]);
+    const confirmPlanChange = useCallback(async (confirmation) => {
+        const parsed = BillingSubscription_ChangePlanRequestDto.parse(confirmation);
+        await callPlanOperation(BillingSubscription_Operations.CHANGE_PLAN, parsed);
+        await fetchBillingState();
+    }, [callPlanOperation, fetchBillingState]);
+    const cancelPendingPlanChange = useCallback(async () => {
+        await callPlanOperation(BillingSubscription_Operations.CANCEL_PLAN_CHANGE, {});
+        await fetchBillingState();
+    }, [callPlanOperation, fetchBillingState]);
     const contextValue = useMemo(() => ({
         isEnabled,
         billingConfiguration: billingConfig,
-        billingProvider,
+        billingProviderRef,
         billingAccount,
         subscription,
         currentPlanKey,
@@ -401,18 +448,24 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
         productDefinitions,
         getPricesForProduct,
         getProductByKey,
+        isProductAcquirable,
         activePromotions,
         usage,
         creditPools,
         openCheckout,
         openCustomerPortal,
+        previewPlanChange,
+        confirmPlanChange,
+        cancelPendingPlanChange,
         isLoading,
+        availability,
+        isSliceAvailable,
         error,
         refetch: fetchBillingState,
     }), [
         isEnabled,
         billingConfig,
-        billingProvider,
+        billingProviderRef,
         billingAccount,
         subscription,
         currentPlanKey,
@@ -424,20 +477,21 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
         productDefinitions,
         getPricesForProduct,
         getProductByKey,
+        isProductAcquirable,
         activePromotions,
         usage,
         creditPools,
         openCheckout,
         openCustomerPortal,
+        previewPlanChange,
+        confirmPlanChange,
+        cancelPendingPlanChange,
         isLoading,
+        availability,
+        isSliceAvailable,
         error,
         fetchBillingState,
     ]);
     return (_jsx(BillingContext.Provider, { value: contextValue, children: children }));
 }
-function isBillingFrontendProvider(provider) {
-    return !!provider
-        && provider.providerCapabilities.includes(BUILTIN_PROVIDER_CAPABILITY.BILLING)
-        && provider.protocols.includes(BUILTIN_PROVIDER_PROTOCOL.BILLING_PROVIDER);
-}
 //# sourceMappingURL=BillingContext.js.map

package/dist/esm/core/billing/BillingContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"BillingContext.js","sourceRoot":"","sources":["../../../../src/core/billing/BillingContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * BillingContext\n *\n * Central context for billing operations on the frontend.\n *\n * Responsibilities:\n * - Self-resolves scope (org/user) from AppScope + user context — no external props needed\n * - Fetches billing state via the GET_STATE resource operation on the billing account\n * - The backend auto-creates the billing account if one doesn't exist\n * - Provides actions: openCheckout, openCustomerPortal (via resource operations)\n * - Caches billing state and invalidates on WebSocket events\n * - Exposes convenience accessors for current plan, subscription status, etc.\n *\n * DELEGATION PRINCIPLE: The frontend does NOT build payment UI.\n * - Stripe Checkout (hosted page): for new subscriptions and upgrades\n * - Stripe Customer Portal (hosted page): for invoices, payment methods, cancellation\n */\n\nimport React, { createContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';\nimport type {\n  BillingAccount,\n  BillingSubscriptionBase,\n  Product,\n  Price,\n  Promotion,\n  InvoiceRef,\n  UsageSummary,\n  BillingConfiguration,\n  ProductDefinition,\n  BillingStateResponse,\n  WS_BillingEventPayload,\n} from '@wildo-ai/saas-models';\nimport {\n  BUILTIN_PROVIDER_CAPABILITY,\n  BUILTIN_PROVIDER_PROTOCOL,\n  CoreWebSocketEvent,\n  CoreResourceType,\n  ResourcePrimaryScope,\n  MAIN_API_BASE_PATH,\n} from '@wildo-ai/saas-models';\nimport type { FrontendAppProviderModule, FrontendAppProviderRef } from '@wildo-ai/external-connectors-public/app';\nimport { useWebSocket } from '~wildo-frontend-lib/core/requests/websockets/useWebSocket';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useResourceRegistrySafe } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { useEmitLoadingScope } from '~wildo-frontend-lib/core/loading/useEmitLoadingScope';\nimport { ContextLoadingIdentifier } from '~wildo-frontend-lib/core/loading/loading-types.frontend.schemas';\n\n// ================================\n// Logger\n// ================================\n\nconst billingLogger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = billingLogger.debugByType('BillingContext');\nbillingLogger.setDebugTypeLogging('BillingContext', false);\n\n// ================================\n// Constants\n// ================================\n\nconst API_PREFIX = MAIN_API_BASE_PATH;\n\n/** WebSocket events that trigger a refetch of billing state */\nconst INVALIDATION_EVENTS = [\n  CoreWebSocketEvent.BILLING_STATUS_CHANGED,\n  CoreWebSocketEvent.BILLING_SUBSCRIPTION_UPDATED,\n  CoreWebSocketEvent.BILLING_ACCOUNT_CHANGED,\n  CoreWebSocketEvent.BILLING_USAGE_UPDATED,\n  CoreWebSocketEvent.BILLING_CREDIT_POOL_UPDATED,\n  CoreWebSocketEvent.BILLING_FEATURES_UPDATED,\n] as const;\n\n/** Maps ResourcePrimaryScope → billing account variant resource type (for resource operations) */\nconst SCOPE_TO_BILLING_ACCOUNT_RESOURCE: Record<string, string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS,\n  [ResourcePrimaryScope.USER_SELF]: CoreResourceType.USER_BILLING_ACCOUNTS,\n};\n\n// The billing-account GET_STATE / OPEN_CHECKOUT / OPEN_PORTAL custom operations\n// borrow COUNT / UPDATE / READ core semantics (see\n// `billing-account.shared.resources-config.schemas.ts`), so their canonical\n// routes follow the framework's scoped resource-operation shape:\n//   GET_STATE      (COUNT-like) → GET  /<scope>/{id}/<res>/get-state/count\n//   OPEN_CHECKOUT  (UPDATE-like) → PUT  /<scope>/{id}/<res>/{accountId}/open-checkout\n//   OPEN_PORTAL    (READ-like)   → GET  /<scope>/{id}/<res>/{accountId}/open-portal\n// Built here to mirror the routes the backend registers from the same\n// resources-config; the prior `/operations/open_checkout` POST 404'd.\n\n/** Maps ResourcePrimaryScope → GET_STATE URL builder (COUNT-like → trailing `/count`) */\nconst SCOPE_TO_GET_STATE_URL: Record<string, (scopeEntityId: string) => string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: (id) => `${API_PREFIX}/organizations/${id}/organization-billing-accounts/get-state/count`,\n  [ResourcePrimaryScope.USER_SELF]: (id) => `${API_PREFIX}/users/${id}/user-billing-accounts/get-state/count`,\n};\n\n/** Maps ResourcePrimaryScope → OPEN_CHECKOUT URL builder (UPDATE-like → keyed PUT) */\nconst SCOPE_TO_OPEN_CHECKOUT_URL: Record<string, (scopeEntityId: string, billingAccountId: string) => string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: (id, acc) => `${API_PREFIX}/organizations/${id}/organization-billing-accounts/${acc}/open-checkout`,\n  [ResourcePrimaryScope.USER_SELF]: (id, acc) => `${API_PREFIX}/users/${id}/user-billing-accounts/${acc}/open-checkout`,\n};\n\n/** Maps ResourcePrimaryScope → OPEN_PORTAL URL builder (READ-like → keyed GET) */\nconst SCOPE_TO_OPEN_PORTAL_URL: Record<string, (scopeEntityId: string, billingAccountId: string) => string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: (id, acc) => `${API_PREFIX}/organizations/${id}/organization-billing-accounts/${acc}/open-portal`,\n  [ResourcePrimaryScope.USER_SELF]: (id, acc) => `${API_PREFIX}/users/${id}/user-billing-accounts/${acc}/open-portal`,\n};\n\n// ================================\n// API Response Types\n// ================================\n\n/** Response from PUT /<scope>/{id}/<billing-accounts>/{accountId}/open-checkout (OPEN_CHECKOUT) */\ninterface CheckoutSessionResponse {\n  url: string;\n  sessionId: string;\n}\n\n/** Response from GET /<scope>/{id}/<billing-accounts>/{accountId}/open-portal (OPEN_PORTAL) */\ninterface PortalSessionResponse {\n  url: string;\n}\n\n// ================================\n// Context Type\n// ================================\n\n/**\n * @wildo_source:part:start saas.frontend.billing-context facet:layer:frontend facet:audience:app-developer\n *\n * Everything an application's own frontend reads or does about billing. Reached with `useBilling()`,\n * which throws outside a `BillingProvider`; `useBillingSafe()` returns `undefined` instead, for a\n * component that may render before the provider mounts or in an application where billing is off.\n *\n * The shipped billing components and the feature-gating hooks read this same context, so an\n * application composing its own purchase flow works from exactly what they do — no application code\n * builds the request.\n *\n * ## Starting a purchase\n *\n * `openCheckout(productKey, priceId, options)` posts to the scoped billing-account route and follows\n * the returned URL; success and cancel destinations come from the application's own redirect base. A\n * SECOND call while one is in flight is IGNORED, so a double-click cannot open two sessions — do not\n * add your own guard expecting otherwise, and do not read the silence as a failure.\n *\n * The `priceId` must belong to the product named by `productKey`; the checkout operation refuses a\n * mismatched pair. Resolve it through `getPricesForProduct` rather than assuming an ordering.\n *\n * `openCustomerPortal()` opens the provider's own portal — which is where payment methods, card\n * updates and receipt downloads live. Those are deliberately NOT rendered by the framework, so an\n * application that needs them links the portal rather than building them.\n *\n * ## What `usage` contains\n *\n * Metered consumption appears here only if the application RECORDS it. Nothing is automatic: a\n * metered product with no recorded usage shows an empty dashboard rather than an error.\n *\n * ## Invoices are capped\n *\n * `invoices` carries the fifty most recent, which is what the shipped history component renders. An\n * application needing more reads the invoices resource directly.\n */\nexport interface BillingContextType {\n  // ── Configuration ──\n  isEnabled: boolean;\n  billingConfiguration: BillingConfiguration | undefined;\n  billingProvider: FrontendAppProviderModule | null;\n\n  // ── Billing State ──\n  billingAccount: BillingAccount | null;\n  subscription: BillingSubscriptionBase | null;\n  currentPlanKey: string | null;\n  currentPlanProduct: Product | null;\n\n  // ── Product Catalog ──\n  products: Product[];\n  prices: Price[];\n  productDefinitions: ProductDefinition[];\n  getPricesForProduct: (productId: string) => Price[];\n  getProductByKey: (key: string) => Product | undefined;\n\n  // ── Scope ──\n  currentScope: ResourcePrimaryScope | null;\n\n  // ── Invoices ──\n  invoices: InvoiceRef[];\n\n  // ── Promotions ──\n  activePromotions: Promotion[];\n\n  // ── Usage & Credits ──\n  usage: UsageSummary;\n  creditPools: Record<string, { available: number; totalPurchased: number; totalConsumed: number }>;\n\n  // ── Actions ──\n  openCheckout: (productKey: string, priceId: string, options?: {\n    quantity?: number;\n    promotionCode?: string;\n    trialDays?: number;\n  }) => Promise<void>;\n\n  openCustomerPortal: () => Promise<void>;\n\n  // ── State ──\n  isLoading: boolean;\n  error: Error | null;\n\n  // ── Actions ──\n  refetch: () => void;\n}\n\n// ── Default empty state ──\nconst EMPTY_USAGE: UsageSummary = {\n  byProduct: {},\n};\n\n/** @wildo_source:part:end saas.frontend.billing-context */\n\nexport const BillingContext: React.Context<BillingContextType | undefined> = createContext<BillingContextType | undefined>(undefined);\n\n// ================================\n// Provider\n// ================================\n\nexport interface BillingProviderProps {\n  children: React.ReactNode;\n  productDefinitions?: ProductDefinition[];\n}\n\nexport function BillingProvider({ children, productDefinitions: injectedProductDefinitions }: BillingProviderProps): React.ReactElement {\n  // ── Self-resolve configuration from hooks ──\n  const userOrgs = useUserOrgs();\n  const appScope = useAppScopeSafe();\n  const { appConfig, frontendProviderRegistry } = useApplication();\n  const resourceRegistry = useResourceRegistrySafe();\n  const billingConfig = appConfig.billing;\n  /** What the application CONFIGURED — see `isEnabled` below for why that is only half the answer. */\n  const isConfiguredEnabled = billingConfig?.enabled ?? false;\n  const billingProvider = useMemo(() => {\n    const configuredProviderRef = billingConfig?.providerRef;\n\n    const configuredProvider = configuredProviderRef\n      ? frontendProviderRegistry?.getProviderByRef(\n          configuredProviderRef as FrontendAppProviderRef,\n        )\n      : undefined;\n\n    const resolvedProvider = isBillingFrontendProvider(configuredProvider)\n      ? configuredProvider\n      : frontendProviderRegistry?.findByProviderCapabilityAndProtocol(\n          BUILTIN_PROVIDER_CAPABILITY.BILLING,\n          BUILTIN_PROVIDER_PROTOCOL.BILLING_PROVIDER,\n        ) ?? null;\n\n    if (isConfiguredEnabled && configuredProviderRef && resolvedProvider?.metadata.ref !== configuredProviderRef) {\n      logDebug('Billing config providerRef does not match the hydrated frontend billing provider', {\n        configuredProviderRef,\n        resolvedProviderRef: resolvedProvider?.metadata.ref,\n      });\n    }\n\n    return resolvedProvider;\n  }, [billingConfig?.providerRef, frontendProviderRegistry, isConfiguredEnabled]);\n\n  // ── Self-resolve scope ──\n  const enabledScopes = billingConfig?.enabledScopes ?? [ResourcePrimaryScope.ORGANIZATIONS];\n\n  const { scopeType, scopeEntityId } = useMemo(() => {\n    if (enabledScopes.includes(ResourcePrimaryScope.ORGANIZATIONS) && appScope?.currentOrganizationId) {\n      return { scopeType: ResourcePrimaryScope.ORGANIZATIONS as ResourcePrimaryScope, scopeEntityId: appScope.currentOrganizationId };\n    }\n    if (enabledScopes.includes(ResourcePrimaryScope.USER_SELF) && userOrgs.user?._id) {\n      return { scopeType: ResourcePrimaryScope.USER_SELF as ResourcePrimaryScope, scopeEntityId: userOrgs.user._id };\n    }\n    return { scopeType: null as ResourcePrimaryScope | null, scopeEntityId: null as string | null };\n  }, [enabledScopes, appScope?.currentOrganizationId, userOrgs.user?._id]);\n\n  // ── Derive variant resource type for operations ──\n  const billingAccountResourceType = scopeType ? SCOPE_TO_BILLING_ACCOUNT_RESOURCE[scopeType] : null;\n\n  /**\n   * Enabled means CONFIGURED **and** REACHABLE — the config flag alone was not enough.\n   *\n   * Every request this provider makes is an operation on a billing-account resource, so a consumer\n   * whose registry does not carry that resource cannot serve one no matter what the config says.\n   * That is not hypothetical: the application-creation workbench excludes the whole tenant\n   * vocabulary from its registry (it observes an application's creation and is not that\n   * application's admin console) while rendering the OBSERVED application's config, which has\n   * billing enabled — so it fired `organization-billing-accounts/get-state/count` at its own origin\n   * on every page load, where the companion serves no billing routes, and answered 404 every time\n   * (issue #268, reproduced live).\n   *\n   * Reading the registry rather than adding a second opt-out keeps the two halves from disagreeing:\n   * a consumer that excludes the resource has already said billing is not part of its surface, and\n   * saying it twice is how the two copies drift. A tenant application carries the resource and is\n   * unaffected.\n   */\n  const isEnabled = isConfiguredEnabled\n    && billingAccountResourceType !== null\n    // A registry that is ABSENT is ignorance, not a negative answer — only a registry that HAS been\n    // asked and says no disables billing. Blocking on the absent case instead disabled billing for\n    // every consumer that mounts this provider without a registry in context, which is what three\n    // of this file's own tests do and what caught the first version of this gate.\n    && (resourceRegistry === undefined || resourceRegistry.hasResource(billingAccountResourceType));\n\n  // ── State ──\n  const [billingState, setBillingState] = useState<BillingStateResponse | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(isEnabled && !!scopeEntityId);\n  const [error, setError] = useState<Error | null>(null);\n\n  // L-2.b: mirror local loading state onto the LoadingContext event bus so\n  // unrelated components can observe billing-state lifecycle via\n  // `useComponentLoading({ customIdentifier: ContextLoadingIdentifier.BILLING_STATE })`\n  // or `<LoadingGate scopes={[buildContextLoadingScope(BILLING_STATE)]}>`.\n  // Local `isLoading` is still exposed for direct consumers (back-compat).\n  useEmitLoadingScope({\n    identifier: ContextLoadingIdentifier.BILLING_STATE,\n    isLoading,\n    hasLoadedOnce: billingState !== null,\n  });\n\n  // ── Refs for stable callbacks ──\n  const fetchInFlightRef = useRef<boolean>(false);\n  const mountedRef = useRef<boolean>(true);\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const checkoutInFlightRef = useRef<boolean>(false);\n\n  // ── WebSocket ──\n  const { on } = useWebSocket();\n\n  // ── Resolve redirect base URL ──\n  const resolvedRedirectBase = useMemo(\n    () => typeof window !== 'undefined' ? window.location.origin : '',\n    [],\n  );\n\n  // ── billingAccountId from response ──\n  const billingAccountId = billingState?.billingAccount?._id ?? null;\n\n  // ── Clear stale state on scope change ──\n  useEffect(() => {\n    setBillingState(null);\n    setError(null);\n    setIsLoading(isEnabled && !!scopeEntityId);\n  }, [scopeType, scopeEntityId, isEnabled]);\n\n  // ── Fetch billing state from backend ──\n  const fetchBillingState = useCallback(async () => {\n    if (!isEnabled || !scopeType || !scopeEntityId) return;\n    if (fetchInFlightRef.current) return;\n    fetchInFlightRef.current = true;\n\n    try {\n      logDebug('Fetching billing state', { scopeType, scopeEntityId });\n      const httpClient = getManualCallsHttpClient();\n\n      const urlBuilder = SCOPE_TO_GET_STATE_URL[scopeType];\n      if (!urlBuilder) return;\n      const url = urlBuilder(scopeEntityId);\n      const response = await httpClient.get<BillingStateResponse>(url);\n\n      if (mountedRef.current) {\n        setBillingState({\n          billingAccount: response.billingAccount,\n          subscription: response.subscription,\n          products: response.products ?? [],\n          prices: response.prices ?? [],\n          invoices: response.invoices ?? [],\n          usage: response.usage ?? EMPTY_USAGE,\n          creditPools: response.creditPools ?? {},\n          activePromotions: response.activePromotions ?? [],\n          scopeType: response.scopeType,\n        });\n        setError(null);\n\n        logDebug('Billing state fetched', {\n          hasAccount: !!response.billingAccount,\n          hasSubscription: !!response.subscription,\n          productCount: response.products?.length ?? 0,\n          priceCount: response.prices?.length ?? 0,\n          billingAccountId: response.billingAccount?._id,\n        });\n      }\n    } catch (err: unknown) {\n      if (mountedRef.current) {\n        const message = err instanceof Error ? err.message : 'Failed to fetch billing state';\n        setError(err instanceof Error ? err : new Error(message));\n        logDebug('Failed to fetch billing state', { error: message });\n      }\n    } finally {\n      if (mountedRef.current) {\n        setIsLoading(false);\n      }\n      fetchInFlightRef.current = false;\n    }\n  }, [isEnabled, scopeType, scopeEntityId]);\n\n  // ── Initial fetch ──\n  useEffect(() => {\n    mountedRef.current = true;\n    if (isEnabled && scopeType && scopeEntityId) {\n      fetchBillingState();\n    } else {\n      setIsLoading(false);\n    }\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [fetchBillingState, isEnabled, scopeType, scopeEntityId]);\n\n  // ── WebSocket invalidation (debounced) ──\n  useEffect(() => {\n    if (!isEnabled) return;\n\n    const unsubscribers: Array<() => void> = [];\n\n    const debouncedRefetch = () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = null;\n        fetchBillingState();\n      }, 300);\n    };\n\n    for (const event of INVALIDATION_EVENTS) {\n      const unsub = on<WS_BillingEventPayload>(event, (payload) => {\n        if (!scopeType || !scopeEntityId) {\n          logDebug('Ignoring billing invalidation without active scope', { event, payload });\n          return;\n        }\n\n        if (payload.scopeType !== scopeType || payload.scopeEntityId !== scopeEntityId) {\n          logDebug('Ignoring billing invalidation for another scope', {\n            event,\n            payload,\n            currentScopeType: scopeType,\n            currentScopeEntityId: scopeEntityId,\n          });\n          return;\n        }\n\n        if (billingAccountId && payload.billingAccountId !== billingAccountId) {\n          logDebug('Ignoring billing invalidation for another billing account', {\n            event,\n            payload,\n            currentBillingAccountId: billingAccountId,\n          });\n          return;\n        }\n\n        logDebug('WebSocket invalidation event received, scheduling refetch', { event, payload });\n        debouncedRefetch();\n      });\n      unsubscribers.push(unsub);\n    }\n\n    return () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      for (const unsub of unsubscribers) {\n        unsub();\n      }\n    };\n  }, [on, fetchBillingState, isEnabled, scopeType, scopeEntityId, billingAccountId]);\n\n  // ── Derived state ──\n  const billingAccount = billingState?.billingAccount ?? null;\n  const subscription = billingState?.subscription ?? null;\n  const products = billingState?.products ?? [];\n  const prices = billingState?.prices ?? [];\n  const invoices = billingState?.invoices ?? [];\n  const usage = billingState?.usage ?? EMPTY_USAGE;\n  const creditPools = billingState?.creditPools ?? {};\n  const activePromotions = billingState?.activePromotions ?? [];\n  const currentScope = scopeType ?? null;\n\n  // ── Product catalog lookups ──\n  const productsByKey = useMemo(() => {\n    const map = new Map<string, Product>();\n    for (const p of products) {\n      map.set(p.key, p);\n    }\n    return map;\n  }, [products]);\n\n  const pricesByProductId = useMemo(() => {\n    const map = new Map<string, Price[]>();\n    for (const price of prices) {\n      const existing = map.get(price.productId) ?? [];\n      existing.push(price);\n      map.set(price.productId, existing);\n    }\n    return map;\n  }, [prices]);\n\n  const getPricesForProduct = useCallback(\n    (productId: string): Price[] => pricesByProductId.get(productId) ?? [],\n    [pricesByProductId],\n  );\n\n  const getProductByKey = useCallback(\n    (key: string): Product | undefined => productsByKey.get(key),\n    [productsByKey],\n  );\n\n  // ── Current plan derivation ──\n  const { currentPlanKey, currentPlanProduct } = useMemo(() => {\n    if (!subscription || !subscription.items?.length) {\n      return { currentPlanKey: null, currentPlanProduct: null };\n    }\n    for (const item of subscription.items) {\n      const product = products.find(p => p._id === item.productId);\n      if (product && product.type === 'plan') {\n        return { currentPlanKey: product.key, currentPlanProduct: product };\n      }\n    }\n    return { currentPlanKey: null, currentPlanProduct: null };\n  }, [subscription, products]);\n\n  const productDefinitions = useMemo<ProductDefinition[]>(\n    () => injectedProductDefinitions ?? [],\n    [injectedProductDefinitions],\n  );\n\n  // ── Actions ──\n  const openCheckout = useCallback(\n    async (productKey: string, priceId: string, options?: {\n      quantity?: number;\n      promotionCode?: string;\n      trialDays?: number;\n    }): Promise<void> => {\n      if (!billingAccountId || !billingAccountResourceType || !scopeType || !scopeEntityId) {\n        throw new Error('No billing account available. Cannot open checkout.');\n      }\n      const checkoutUrl = SCOPE_TO_OPEN_CHECKOUT_URL[scopeType]?.(scopeEntityId, billingAccountId);\n      if (!checkoutUrl) {\n        throw new Error(`No OPEN_CHECKOUT URL builder for scope ${scopeType}.`);\n      }\n      if (checkoutInFlightRef.current) {\n        logDebug('Checkout already in progress, ignoring duplicate request');\n        return;\n      }\n\n      checkoutInFlightRef.current = true;\n      try {\n        logDebug('Opening checkout session', { productKey, priceId, ...options });\n        const httpClient = getManualCallsHttpClient();\n\n        // OPEN_CHECKOUT borrows UPDATE → keyed PUT on the scoped account route.\n        const response = await httpClient.put<CheckoutSessionResponse>(\n          checkoutUrl,\n          {\n            productKey,\n            priceId,\n            successUrl: `${resolvedRedirectBase}/billing/success?session_id={CHECKOUT_SESSION_ID}`,\n            cancelUrl: `${resolvedRedirectBase}/billing/cancel`,\n            quantity: options?.quantity,\n            promotionCode: options?.promotionCode,\n            trialDays: options?.trialDays,\n          },\n        );\n\n        if (response.url) {\n          window.location.href = response.url;\n        }\n      } finally {\n        checkoutInFlightRef.current = false;\n      }\n    },\n    [billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, resolvedRedirectBase],\n  );\n\n  const openCustomerPortal = useCallback(async (): Promise<void> => {\n    if (!billingAccountId || !billingAccountResourceType || !scopeType || !scopeEntityId) {\n      throw new Error('No billing account available. Cannot open customer portal.');\n    }\n    const portalUrlBase = SCOPE_TO_OPEN_PORTAL_URL[scopeType]?.(scopeEntityId, billingAccountId);\n    if (!portalUrlBase) {\n      throw new Error(`No OPEN_PORTAL URL builder for scope ${scopeType}.`);\n    }\n\n    logDebug('Opening customer portal session');\n    const httpClient = getManualCallsHttpClient();\n\n    // OPEN_PORTAL borrows READ → keyed GET on the scoped account route; the\n    // returnUrl travels as a query param since GET carries no request body.\n    const returnUrl = encodeURIComponent(`${resolvedRedirectBase}/billing`);\n    const response = await httpClient.get<PortalSessionResponse>(\n      `${portalUrlBase}?returnUrl=${returnUrl}`,\n    );\n\n    if (response.url) {\n      window.location.href = response.url;\n    }\n  }, [billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, resolvedRedirectBase]);\n\n  // ── Context value (memoized for stable reference) ──\n  const contextValue: BillingContextType = useMemo(\n    () => ({\n      isEnabled,\n      billingConfiguration: billingConfig,\n      billingProvider,\n      billingAccount,\n      subscription,\n      currentPlanKey,\n      currentPlanProduct,\n      currentScope,\n      products,\n      prices,\n      invoices,\n      productDefinitions,\n      getPricesForProduct,\n      getProductByKey,\n      activePromotions,\n      usage,\n      creditPools,\n      openCheckout,\n      openCustomerPortal,\n      isLoading,\n      error,\n      refetch: fetchBillingState,\n    }),\n    [\n      isEnabled,\n      billingConfig,\n      billingProvider,\n      billingAccount,\n      subscription,\n      currentPlanKey,\n      currentPlanProduct,\n      currentScope,\n      products,\n      prices,\n      invoices,\n      productDefinitions,\n      getPricesForProduct,\n      getProductByKey,\n      activePromotions,\n      usage,\n      creditPools,\n      openCheckout,\n      openCustomerPortal,\n      isLoading,\n      error,\n      fetchBillingState,\n    ],\n  );\n\n  return (\n    <BillingContext.Provider value={contextValue}>\n      {children}\n    </BillingContext.Provider>\n  );\n}\n\nfunction isBillingFrontendProvider(\n  provider: FrontendAppProviderModule | undefined,\n): provider is FrontendAppProviderModule {\n  return !!provider\n    && provider.providerCapabilities.includes(BUILTIN_PROVIDER_CAPABILITY.BILLING)\n    && provider.protocols.includes(BUILTIN_PROVIDER_PROTOCOL.BILLING_PROVIDER);\n}\n"]}
+{"version":3,"file":"BillingContext.js","sourceRoot":"","sources":["../../../../../src/core/billing/BillingContext.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { z } from 'zod';\n/**\n * BillingContext\n *\n * Central context for billing operations on the frontend.\n *\n * Responsibilities:\n * - Self-resolves scope (org/user) from AppScope + user context — no external props needed\n * - Fetches billing state via the GET_STATE resource operation on the billing account\n * - The backend auto-creates the billing account if one doesn't exist\n * - Provides actions: openCheckout, openCustomerPortal (via resource operations)\n * - Caches billing state and invalidates on WebSocket events\n * - Exposes convenience accessors for current plan, subscription status, etc.\n *\n * DELEGATION PRINCIPLE: The frontend does NOT build payment UI.\n * - Stripe Checkout (hosted page): for new subscriptions and upgrades\n * - Stripe Customer Portal (hosted page): for invoices, payment methods, cancellation\n */\n\nimport React, { createContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';\nimport type {\n  BillingAccount,\n  BillingSubscriptionBase,\n  Product,\n  Price,\n  Promotion,\n  InvoiceRef,\n  UsageSummary,\n  BillingConfiguration,\n  ProductDefinition,\n  BillingStateResponse,\n  BillingStateAvailability,\n  WS_BillingEventPayload,\n} from '@wildo-ai/saas-models';\nimport {\n  BillingAccount_Operations,\n  BillingSubscription_Operations,\n  BillingSubscription_PreviewPlanChangeRequestDto,\n  BillingSubscription_ChangePlanRequestDto,\n  BillingSubscription_PlanChangePreviewResponseDto,\n  ResourceOperationVariantType,\n  ResourcesConfig_OperationPathUtils,\n  HttpMethod,\n  BillingStateSlice,\n  BillingSliceAvailability,\n  CoreWebSocketEvent,\n  CoreResourceType,\n  ResourcePrimaryScope,\n  MAIN_API_BASE_PATH,\n  userRolesSatisfyRequiredRoles,\n} from '@wildo-ai/saas-models';\nimport { useWebSocket } from '~wildo-frontend-lib/core/requests/websockets/useWebSocket';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { isResourceReachable, useResourceRegistrySafe } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { useEmitLoadingScope } from '~wildo-frontend-lib/core/loading/useEmitLoadingScope';\nimport { ContextLoadingIdentifier } from '~wildo-frontend-lib/core/loading/loading-types.frontend.schemas';\n\n// ================================\n// Logger\n// ================================\n\nconst billingLogger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = billingLogger.debugByType('BillingContext');\nbillingLogger.setDebugTypeLogging('BillingContext', false);\n\n// ================================\n// Constants\n// ================================\n\nconst API_PREFIX = MAIN_API_BASE_PATH;\n\n/** WebSocket events that trigger a refetch of billing state */\nconst INVALIDATION_EVENTS = [\n  CoreWebSocketEvent.BILLING_STATUS_CHANGED,\n  CoreWebSocketEvent.BILLING_SUBSCRIPTION_UPDATED,\n  CoreWebSocketEvent.BILLING_ACCOUNT_CHANGED,\n  CoreWebSocketEvent.BILLING_USAGE_UPDATED,\n  CoreWebSocketEvent.BILLING_CREDIT_POOL_UPDATED,\n  CoreWebSocketEvent.BILLING_FEATURES_UPDATED,\n] as const;\n\n/** Maps ResourcePrimaryScope → billing account variant resource type (for resource operations) */\nconst SCOPE_TO_BILLING_ACCOUNT_RESOURCE: Record<string, string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS,\n  [ResourcePrimaryScope.USER_SELF]: CoreResourceType.USER_BILLING_ACCOUNTS,\n};\n\n// The billing-account GET_STATE / OPEN_CHECKOUT / OPEN_PORTAL custom operations\n// borrow COUNT / UPDATE / READ core semantics (see\n// `billing-account.shared.resources-config.schemas.ts`), so their canonical\n// routes follow the framework's scoped resource-operation shape:\n//   GET_STATE      (COUNT-like) → GET  /<scope>/{id}/<res>/get-state/count\n//   OPEN_CHECKOUT  (UPDATE-like) → PUT  /<scope>/{id}/<res>/{accountId}/open-checkout\n//   OPEN_PORTAL    (READ-like)   → GET  /<scope>/{id}/<res>/{accountId}/open-portal\n// Built here to mirror the routes the backend registers from the same\n// resources-config; the prior `/operations/open_checkout` POST 404'd.\n\n/** Maps ResourcePrimaryScope → GET_STATE URL builder (COUNT-like → trailing `/count`) */\nconst SCOPE_TO_GET_STATE_URL: Record<string, (scopeEntityId: string) => string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: (id) => `${API_PREFIX}/organizations/${id}/organization-billing-accounts/get-state/count`,\n  [ResourcePrimaryScope.USER_SELF]: (id) => `${API_PREFIX}/users/${id}/user-billing-accounts/get-state/count`,\n};\n\n/** Maps ResourcePrimaryScope → OPEN_CHECKOUT URL builder (UPDATE-like → keyed PUT) */\nconst SCOPE_TO_OPEN_CHECKOUT_URL: Record<string, (scopeEntityId: string, billingAccountId: string) => string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: (id, acc) => `${API_PREFIX}/organizations/${id}/organization-billing-accounts/${acc}/open-checkout`,\n  [ResourcePrimaryScope.USER_SELF]: (id, acc) => `${API_PREFIX}/users/${id}/user-billing-accounts/${acc}/open-checkout`,\n};\n\n/** Maps ResourcePrimaryScope → OPEN_PORTAL URL builder (READ-like → keyed GET) */\nconst SCOPE_TO_OPEN_PORTAL_URL: Record<string, (scopeEntityId: string, billingAccountId: string) => string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: (id, acc) => `${API_PREFIX}/organizations/${id}/organization-billing-accounts/${acc}/open-portal`,\n  [ResourcePrimaryScope.USER_SELF]: (id, acc) => `${API_PREFIX}/users/${id}/user-billing-accounts/${acc}/open-portal`,\n};\n\n// ================================\n// API Response Types\n// ================================\n\n/** Response from PUT /<scope>/{id}/<billing-accounts>/{accountId}/open-checkout (OPEN_CHECKOUT) */\ninterface CheckoutSessionResponse {\n  url: string;\n  sessionId: string;\n}\n\n/** Response from GET /<scope>/{id}/<billing-accounts>/{accountId}/open-portal (OPEN_PORTAL) */\ninterface PortalSessionResponse {\n  url: string;\n}\n\n// ================================\n// Context Type\n// ================================\n\n/**\n * @wildo_source:part:start saas.frontend.billing-context facet:layer:frontend facet:audience:app-developer\n *\n * Everything an application's own frontend reads or does about billing. Reached with `useBilling()`,\n * which throws outside a `BillingProvider`; `useBillingSafe()` returns `undefined` instead, for a\n * component that may render before the provider mounts or in an application where billing is off.\n *\n * The shipped billing components and the feature-gating hooks read this same context, so an\n * application composing its own purchase flow works from exactly what they do — no application code\n * builds the request.\n *\n * ## Starting a purchase\n *\n * `openCheckout(productKey, priceId, options)` posts to the scoped billing-account route and follows\n * the returned URL; success and cancel destinations come from the application's own redirect base. A\n * SECOND call while one is in flight is IGNORED, so a double-click cannot open two sessions — do not\n * add your own guard expecting otherwise, and do not read the silence as a failure.\n *\n * The `priceId` must belong to the product named by `productKey`; the checkout operation refuses a\n * mismatched pair. Resolve it through `getPricesForProduct` rather than assuming an ordering.\n *\n * `openCustomerPortal()` opens the provider's own portal — which is where payment methods, card\n * updates and receipt downloads live. Those are deliberately NOT rendered by the framework, so an\n * application that needs them links the portal rather than building them.\n *\n * ## What `usage` contains\n *\n * Metered consumption appears here only if the application RECORDS it. Nothing is automatic: a\n * metered product with no recorded usage shows an empty dashboard rather than an error.\n *\n * ## Invoices are capped\n *\n * `invoices` carries the fifty most recent, which is what the shipped history component renders. An\n * application needing more reads the invoices resource directly.\n */\nexport type BillingPlanChangeTarget = z.infer<typeof BillingSubscription_PreviewPlanChangeRequestDto>;\nexport type BillingPlanChangeConfirmation = z.infer<typeof BillingSubscription_ChangePlanRequestDto>;\nexport type BillingPlanChangePreviewResponse = z.infer<typeof BillingSubscription_PlanChangePreviewResponseDto>;\n\nexport interface BillingContextType {\n  // ── Configuration ──\n  isEnabled: boolean;\n  billingConfiguration: BillingConfiguration | undefined;\n  /**\n   * The configured billing provider's REF (`billing.providerRef`), or null when billing is off or\n   * names none. Surfaces show the vendor's name from it (`providers.<ref>.displayName`, #1895).\n   *\n   * It used to be a frontend provider MODULE, resolved from the registry by ref or by the `BILLING`\n   * capability. The only such module was Stripe's, which loaded no Stripe code — checkout and the\n   * customer portal are hosted redirects — and existed only to carry that name (#1701). The ref is the\n   * fact the application configured; a module was a second place that had to agree with it.\n   */\n  billingProviderRef: string | null;\n\n  // ── Billing State ──\n  billingAccount: BillingAccount | null;\n  subscription: BillingSubscriptionBase | null;\n  currentPlanKey: string | null;\n  currentPlanProduct: Product | null;\n\n  // ── Product Catalog ──\n  products: Product[];\n  prices: Price[];\n  productDefinitions: ProductDefinition[];\n  getPricesForProduct: (productId: string) => Price[];\n  getProductByKey: (key: string) => Product | undefined;\n  /**\n   * May this product be bought, or moved onto, right now? Answered from the billing state's\n   * `acquirableProductKeys` — the set the backend derives with the SAME predicate its checkout,\n   * plan-change and add-on doors enforce — so a surface never re-derives it from `isActive` and can\n   * never offer a plan the backend refuses (a retired one, or an announced-but-upcoming one, #1835).\n   * Fails closed: a state that did not carry the set answers `false`, because an unknown answer must\n   * not offer a checkout.\n   */\n  isProductAcquirable: (key: string) => boolean;\n\n  // ── Scope ──\n  currentScope: ResourcePrimaryScope | null;\n\n  // ── Invoices ──\n  invoices: InvoiceRef[];\n\n  // ── Promotions ──\n  activePromotions: Promotion[];\n\n  // ── Usage & Credits ──\n  usage: UsageSummary;\n  creditPools: Record<string, { available: number; totalPurchased: number; totalGranted: number; totalConsumed: number }>;\n\n  // ── Actions ──\n  openCheckout: (productKey: string, priceId: string, options?: {\n    quantity?: number;\n    promotionCode?: string;\n  }) => Promise<void>;\n\n  openCustomerPortal: () => Promise<void>;\n  /** Provider estimate bound to the current subscription and selected target; never commits a change. */\n  previewPlanChange: (target: BillingPlanChangeTarget, options?: { signal?: AbortSignal }) => Promise<BillingPlanChangePreviewResponse>;\n  /** Confirm only the server token returned for the displayed preview. Successful mutation refreshes billing state. */\n  confirmPlanChange: (confirmation: BillingPlanChangeConfirmation) => Promise<void>;\n  /**\n   * Withdraw the plan change pending at the end of the period (`subscription.pendingPlanChange`, #1868), so the subscription renews\n   * on its current plan. Successful withdrawal refreshes billing state.\n   */\n  cancelPendingPlanChange: () => Promise<void>;\n\n  // ── State ──\n  isLoading: boolean;\n  error: Error | null;\n  /** Only a successful slice read establishes emptiness; failed or absent state is unavailable. */\n  availability: BillingStateAvailability | null;\n  isSliceAvailable: (slice: BillingStateSlice) => boolean;\n\n  // ── Actions ──\n  refetch: () => void;\n}\n\n// ── Default empty state ──\nconst EMPTY_USAGE: UsageSummary = {\n  byProduct: {},\n};\n\n/** @wildo_source:part:end saas.frontend.billing-context */\n\nexport const BillingContext: React.Context<BillingContextType | undefined> = createContext<BillingContextType | undefined>(undefined);\n\n// ================================\n// Provider\n// ================================\n\nexport interface BillingProviderProps {\n  children: React.ReactNode;\n  productDefinitions?: ProductDefinition[];\n}\n\nexport function BillingProvider({ children, productDefinitions: injectedProductDefinitions }: BillingProviderProps): React.ReactElement {\n  // ── Self-resolve configuration from hooks ──\n  const userOrgs = useUserOrgs();\n  const appScope = useAppScopeSafe();\n  const { appConfig } = useApplication();\n  const resourceRegistry = useResourceRegistrySafe();\n  const billingConfig = appConfig.billing;\n  /** What the application CONFIGURED — see `isEnabled` below for why that is only half the answer. */\n  const isConfiguredEnabled = billingConfig?.enabled ?? false;\n  const billingProviderRef = isConfiguredEnabled ? billingConfig?.providerRef ?? null : null;\n\n  // ── Self-resolve scope ──\n  const enabledScopes = billingConfig?.enabledScopes ?? [ResourcePrimaryScope.ORGANIZATIONS];\n\n  const { scopeType, scopeEntityId } = useMemo(() => {\n    if (enabledScopes.includes(ResourcePrimaryScope.ORGANIZATIONS) && appScope?.currentOrganizationId) {\n      return { scopeType: ResourcePrimaryScope.ORGANIZATIONS as ResourcePrimaryScope, scopeEntityId: appScope.currentOrganizationId };\n    }\n    if (enabledScopes.includes(ResourcePrimaryScope.USER_SELF) && userOrgs.user?._id) {\n      return { scopeType: ResourcePrimaryScope.USER_SELF as ResourcePrimaryScope, scopeEntityId: userOrgs.user._id };\n    }\n    return { scopeType: null as ResourcePrimaryScope | null, scopeEntityId: null as string | null };\n  }, [enabledScopes, appScope?.currentOrganizationId, userOrgs.user?._id]);\n\n  // ── Derive variant resource type for operations ──\n  const billingAccountResourceType = scopeType ? SCOPE_TO_BILLING_ACCOUNT_RESOURCE[scopeType] : null;\n\n  /**\n   * Enabled means CONFIGURED **and** REACHABLE — the config flag alone was not enough.\n   *\n   * Every request this provider makes is an operation on a billing-account resource, so a consumer\n   * whose registry does not carry that resource cannot serve one no matter what the config says.\n   * That is not hypothetical: the application-creation workbench excludes the whole tenant\n   * vocabulary from its registry (it observes an application's creation and is not that\n   * application's admin console) while rendering the OBSERVED application's config, which has\n   * billing enabled — so it fired `organization-billing-accounts/get-state/count` at its own origin\n   * on every page load, where the companion serves no billing routes, and answered 404 every time\n   * (issue #268, reproduced live).\n   *\n   * Reading the registry rather than adding a second opt-out keeps the two halves from disagreeing:\n   * a consumer that excludes the resource has already said billing is not part of its surface, and\n   * saying it twice is how the two copies drift. A tenant application carries the resource and is\n   * unaffected.\n   */\n  const isEnabled = isConfiguredEnabled\n    && billingAccountResourceType !== null\n    // The absent-registry-is-ignorance rule lives on the seam (`isResourceReachable`), shared with the\n    // features, guidance and analytics providers since #1069 so the four cannot drift.\n    && isResourceReachable(resourceRegistry, billingAccountResourceType);\n\n  /**\n   * Whether THIS CALLER may read the billing state served for this scope — kept separate from `isEnabled`, on purpose.\n   *\n   * `isEnabled` says billing is PART OF the application. Every consumer of it — feature availability, operation\n   * gating, the launcher — needs that answer for every user alike, so it must not vary with who is looking.\n   *\n   * Fetching is a different question. `GET_STATE` is role-gated per scope (organization owners and administrators on\n   * the organization variant), and a plain member used to request it on every page load, be refused with 403, and\n   * see an access-denied message on a page with nothing wrong with it (#1039). That member already ended with a null\n   * billing state — the refusal produced it — so not asking changes nothing they can see except the message.\n   *\n   * The required roles are read from the registry's OWN operation, never copied, and decided by the same\n   * hierarchy-aware check the action bar uses. That check fails open on a role it cannot resolve, so a custom role\n   * inheriting an administrator role is not locked out here — the server stays the authority either way. With no\n   * registry, or no such operation in it, there is no evidence to withhold on, and the request goes out as before.\n   */\n  const permissions = userOrgs.permissions;\n  const currentOrganizationId = appScope?.currentOrganizationId ?? null;\n  const mayReadBillingState = useMemo((): boolean => {\n    if (!isEnabled || !billingAccountResourceType) return false;\n    const getStateOperation = resourceRegistry?.registry.resourceConfigurations[billingAccountResourceType]\n      ?.operations.find((operation) =>\n        String(operation.operationIdentifier) === BillingAccount_Operations.GET_STATE && operation.isOperationDefault === true);\n    if (!getStateOperation) return true;\n    return userRolesSatisfyRequiredRoles({\n      requiredRoles: getStateOperation.roles,\n      userAppRoles: permissions?.appLevel ?? [],\n      userOrgRoles: currentOrganizationId ? permissions?.organizations?.[currentOrganizationId] ?? [] : [],\n    });\n  }, [isEnabled, billingAccountResourceType, resourceRegistry, permissions, currentOrganizationId]);\n\n  // ── State ──\n  const [billingState, setBillingState] = useState<BillingStateResponse | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(mayReadBillingState && !!scopeEntityId);\n  const [error, setError] = useState<Error | null>(null);\n\n  // L-2.b: mirror local loading state onto the LoadingContext event bus so\n  // unrelated components can observe billing-state lifecycle via\n  // `useComponentLoading({ customIdentifier: ContextLoadingIdentifier.BILLING_STATE })`\n  // or `<LoadingGate scopes={[buildContextLoadingScope(BILLING_STATE)]}>`.\n  // Local `isLoading` is still exposed for direct consumers (back-compat).\n  useEmitLoadingScope({\n    identifier: ContextLoadingIdentifier.BILLING_STATE,\n    isLoading,\n    hasLoadedOnce: billingState !== null,\n  });\n\n  // ── Refs for stable callbacks ──\n  const fetchInFlightRef = useRef<boolean>(false);\n  const mountedRef = useRef<boolean>(true);\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const checkoutInFlightRef = useRef<boolean>(false);\n\n  // ── WebSocket ──\n  const { on } = useWebSocket();\n\n  // ── Resolve redirect base URL ──\n  const resolvedRedirectBase = useMemo(\n    () => typeof window !== 'undefined' ? window.location.origin : '',\n    [],\n  );\n\n  // ── billingAccountId from response ──\n  const billingAccountId = billingState?.billingAccount?._id ?? null;\n\n  // ── Clear stale state on scope change ──\n  useEffect(() => {\n    setBillingState(null);\n    setError(null);\n    setIsLoading(mayReadBillingState && !!scopeEntityId);\n  }, [scopeType, scopeEntityId, mayReadBillingState]);\n\n  // ── Fetch billing state from backend ──\n  const fetchBillingState = useCallback(async () => {\n    if (!mayReadBillingState || !scopeType || !scopeEntityId) return;\n    if (fetchInFlightRef.current) return;\n    fetchInFlightRef.current = true;\n\n    try {\n      logDebug('Fetching billing state', { scopeType, scopeEntityId });\n      const httpClient = getManualCallsHttpClient();\n\n      const urlBuilder = SCOPE_TO_GET_STATE_URL[scopeType];\n      if (!urlBuilder) return;\n      const url = urlBuilder(scopeEntityId);\n      const response = await httpClient.get<BillingStateResponse>(url);\n\n      if (mountedRef.current) {\n        setBillingState(response);\n        setError(null);\n\n        logDebug('Billing state fetched', {\n          hasAccount: !!response.billingAccount,\n          hasSubscription: !!response.subscription,\n          productCount: response.products?.length ?? 0,\n          priceCount: response.prices?.length ?? 0,\n          billingAccountId: response.billingAccount?._id,\n        });\n      }\n    } catch (err: unknown) {\n      if (mountedRef.current) {\n        const message = err instanceof Error ? err.message : 'Failed to fetch billing state';\n        setBillingState(null);\n        setError(err instanceof Error ? err : new Error(message));\n        logDebug('Failed to fetch billing state', { error: message });\n      }\n    } finally {\n      if (mountedRef.current) {\n        setIsLoading(false);\n      }\n      fetchInFlightRef.current = false;\n    }\n  }, [mayReadBillingState, scopeType, scopeEntityId]);\n\n  // ── Initial fetch ──\n  useEffect(() => {\n    mountedRef.current = true;\n    if (mayReadBillingState && scopeType && scopeEntityId) {\n      fetchBillingState();\n    } else {\n      setIsLoading(false);\n    }\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [fetchBillingState, mayReadBillingState, scopeType, scopeEntityId]);\n\n  // ── WebSocket invalidation (debounced) ──\n  useEffect(() => {\n    if (!mayReadBillingState) return;\n\n    const unsubscribers: Array<() => void> = [];\n\n    const debouncedRefetch = () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = null;\n        fetchBillingState();\n      }, 300);\n    };\n\n    for (const event of INVALIDATION_EVENTS) {\n      const unsub = on<WS_BillingEventPayload>(event, (payload) => {\n        if (!scopeType || !scopeEntityId) {\n          logDebug('Ignoring billing invalidation without active scope', { event, payload });\n          return;\n        }\n\n        if (payload.scopeType !== scopeType || payload.scopeEntityId !== scopeEntityId) {\n          logDebug('Ignoring billing invalidation for another scope', {\n            event,\n            payload,\n            currentScopeType: scopeType,\n            currentScopeEntityId: scopeEntityId,\n          });\n          return;\n        }\n\n        if (billingAccountId && payload.billingAccountId !== billingAccountId) {\n          logDebug('Ignoring billing invalidation for another billing account', {\n            event,\n            payload,\n            currentBillingAccountId: billingAccountId,\n          });\n          return;\n        }\n\n        logDebug('WebSocket invalidation event received, scheduling refetch', { event, payload });\n        debouncedRefetch();\n      });\n      unsubscribers.push(unsub);\n    }\n\n    return () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      for (const unsub of unsubscribers) {\n        unsub();\n      }\n    };\n  }, [on, fetchBillingState, mayReadBillingState, scopeType, scopeEntityId, billingAccountId]);\n\n  // ── Derived state ──\n  const availability = billingState?.availability ?? null;\n  const isSliceAvailable = useCallback((slice: BillingStateSlice) => availability?.[slice] === BillingSliceAvailability.AVAILABLE, [availability]);\n\n  const billingAccount = billingState?.billingAccount ?? null;\n  const subscription = billingState?.subscription ?? null;\n  const products = billingState?.products ?? [];\n  const prices = billingState?.prices ?? [];\n  const invoices = billingState?.invoices ?? [];\n  const usage = billingState?.usage ?? EMPTY_USAGE;\n  const creditPools = billingState?.creditPools ?? {};\n  const activePromotions = billingState?.activePromotions ?? [];\n  const acquirableProductKeys = billingState?.acquirableProductKeys;\n  const currentScope = scopeType ?? null;\n\n  // ── Product catalog lookups ──\n  const productsByKey = useMemo(() => {\n    const map = new Map<string, Product>();\n    for (const p of products) {\n      map.set(p.key, p);\n    }\n    return map;\n  }, [products]);\n\n  const pricesByProductId = useMemo(() => {\n    const map = new Map<string, Price[]>();\n    for (const price of prices) {\n      const existing = map.get(price.productId) ?? [];\n      existing.push(price);\n      map.set(price.productId, existing);\n    }\n    return map;\n  }, [prices]);\n\n  const getPricesForProduct = useCallback(\n    (productId: string): Price[] => pricesByProductId.get(productId) ?? [],\n    [pricesByProductId],\n  );\n\n  const getProductByKey = useCallback(\n    (key: string): Product | undefined => productsByKey.get(key),\n    [productsByKey],\n  );\n\n  const acquirableProductKeySet = useMemo(() => new Set(acquirableProductKeys ?? []), [acquirableProductKeys]);\n  const isProductAcquirable = useCallback((key: string): boolean => acquirableProductKeySet.has(key), [acquirableProductKeySet]);\n\n  // ── Current plan derivation ──\n  const { currentPlanKey, currentPlanProduct } = useMemo(() => {\n    if (!subscription || !subscription.items?.length) {\n      return { currentPlanKey: null, currentPlanProduct: null };\n    }\n    for (const item of subscription.items) {\n      const product = products.find(p => p._id === item.productId);\n      if (product && product.type === 'plan') {\n        return { currentPlanKey: product.key, currentPlanProduct: product };\n      }\n    }\n    return { currentPlanKey: null, currentPlanProduct: null };\n  }, [subscription, products]);\n\n  const productDefinitions = useMemo<ProductDefinition[]>(\n    () => injectedProductDefinitions ?? [],\n    [injectedProductDefinitions],\n  );\n\n  // ── Actions ──\n  const openCheckout = useCallback(\n    async (productKey: string, priceId: string, options?: {\n      quantity?: number;\n      promotionCode?: string;\n    }): Promise<void> => {\n      if (!billingAccountId || !billingAccountResourceType || !scopeType || !scopeEntityId) {\n        throw new Error('No billing account available. Cannot open checkout.');\n      }\n      const checkoutUrl = SCOPE_TO_OPEN_CHECKOUT_URL[scopeType]?.(scopeEntityId, billingAccountId);\n      if (!checkoutUrl) {\n        throw new Error(`No OPEN_CHECKOUT URL builder for scope ${scopeType}.`);\n      }\n      if (checkoutInFlightRef.current) {\n        logDebug('Checkout already in progress, ignoring duplicate request');\n        return;\n      }\n\n      checkoutInFlightRef.current = true;\n      try {\n        logDebug('Opening checkout session', { productKey, priceId, ...options });\n        const httpClient = getManualCallsHttpClient();\n\n        // OPEN_CHECKOUT borrows UPDATE → keyed PUT on the scoped account route.\n        const response = await httpClient.put<CheckoutSessionResponse>(\n          checkoutUrl,\n          {\n            productKey,\n            priceId,\n            successUrl: `${resolvedRedirectBase}/billing/success?session_id={CHECKOUT_SESSION_ID}`,\n            cancelUrl: `${resolvedRedirectBase}/billing/cancel`,\n            quantity: options?.quantity,\n            promotionCode: options?.promotionCode,\n          },\n        );\n\n        if (response.url) {\n          window.location.href = response.url;\n        }\n      } finally {\n        checkoutInFlightRef.current = false;\n      }\n    },\n    [billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, resolvedRedirectBase],\n  );\n\n  const openCustomerPortal = useCallback(async (): Promise<void> => {\n    if (!billingAccountId || !billingAccountResourceType || !scopeType || !scopeEntityId) {\n      throw new Error('No billing account available. Cannot open customer portal.');\n    }\n    const portalUrlBase = SCOPE_TO_OPEN_PORTAL_URL[scopeType]?.(scopeEntityId, billingAccountId);\n    if (!portalUrlBase) {\n      throw new Error(`No OPEN_PORTAL URL builder for scope ${scopeType}.`);\n    }\n\n    logDebug('Opening customer portal session');\n    const httpClient = getManualCallsHttpClient();\n\n    // OPEN_PORTAL borrows READ → keyed GET on the scoped account route; the\n    // returnUrl travels as a query param since GET carries no request body.\n    const returnUrl = encodeURIComponent(`${resolvedRedirectBase}/billing`);\n    const response = await httpClient.get<PortalSessionResponse>(\n      `${portalUrlBase}?returnUrl=${returnUrl}`,\n    );\n\n    if (response.url) {\n      window.location.href = response.url;\n    }\n  }, [billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, resolvedRedirectBase]);\n\n  // ── Context value (memoized for stable reference) ──\n  // Use the registry's compiled operation paths and parameter vocabulary. Subscription routes have\n  // account and scope parents; hand-authored URLs would silently diverge between org and user variants.\n  const callPlanOperation = useCallback(async <TResponse,>(\n    operationIdentifier: BillingSubscription_Operations,\n    payload: BillingPlanChangeTarget | BillingPlanChangeConfirmation | Record<string, never>,\n    signal?: AbortSignal,\n  ): Promise<TResponse> => {\n    if (!resourceRegistry || !subscription?._id || !billingAccountId || !billingAccountResourceType || !scopeType || !scopeEntityId\n      || ![BillingStateSlice.BILLING_ACCOUNT, BillingStateSlice.SUBSCRIPTION, BillingStateSlice.PRODUCTS, BillingStateSlice.PRICES].every(isSliceAvailable)) {\n      throw new Error('Billing plan change context is unavailable.');\n    }\n    const subscriptionType = scopeType === ResourcePrimaryScope.ORGANIZATIONS ? CoreResourceType.ORGANIZATION_SUBSCRIPTIONS : CoreResourceType.USER_SUBSCRIPTIONS;\n    const config = resourceRegistry.registry.resourceConfigurations[subscriptionType];\n    const operation = config?.operations.find(candidate => candidate.operationIdentifier === operationIdentifier\n      && candidate.variantType === ResourceOperationVariantType.API_CALL && candidate.isOperationDefault);\n    if (!operation || operation.variantType !== ResourceOperationVariantType.API_CALL) throw new Error('Billing plan change operation is unavailable.');\n    const fields = resourceRegistry.registry.allResourceFieldIdentifiers;\n    const scopeResourceType = scopeType === ResourcePrimaryScope.ORGANIZATIONS ? CoreResourceType.ORGANIZATIONS : CoreResourceType.USERS;\n    const accountField = fields[billingAccountResourceType];\n    const scopeField = fields[scopeResourceType];\n    if (!config.resourceFieldIdentifier || !accountField || !scopeField) throw new Error('Billing plan change route context is unavailable.');\n    return resourceRegistry.doOperation<TResponse>(ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation), {\n      contextualParameters: { [config.resourceFieldIdentifier]: subscription._id, [accountField]: billingAccountId, [scopeField]: scopeEntityId },\n      ...(operation.httpVerb === HttpMethod.GET ? { queryParameters: payload } : { requestData: payload }),\n    }, { signal, silent: true });\n  }, [resourceRegistry, subscription?._id, billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, isSliceAvailable]);\n\n  const previewPlanChange = useCallback(async (target: BillingPlanChangeTarget, options?: { signal?: AbortSignal }): Promise<BillingPlanChangePreviewResponse> => {\n    const parsed = BillingSubscription_PreviewPlanChangeRequestDto.parse(target);\n    const response = await callPlanOperation<BillingPlanChangePreviewResponse>(BillingSubscription_Operations.PREVIEW_PLAN_CHANGE, parsed, options?.signal);\n    return BillingSubscription_PlanChangePreviewResponseDto.parse(response);\n  }, [callPlanOperation]);\n\n  const confirmPlanChange = useCallback(async (confirmation: BillingPlanChangeConfirmation): Promise<void> => {\n    const parsed = BillingSubscription_ChangePlanRequestDto.parse(confirmation);\n    await callPlanOperation(BillingSubscription_Operations.CHANGE_PLAN, parsed);\n    await fetchBillingState();\n  }, [callPlanOperation, fetchBillingState]);\n\n  const cancelPendingPlanChange = useCallback(async (): Promise<void> => {\n    await callPlanOperation(BillingSubscription_Operations.CANCEL_PLAN_CHANGE, {});\n    await fetchBillingState();\n  }, [callPlanOperation, fetchBillingState]);\n\n  const contextValue: BillingContextType = useMemo(\n    () => ({\n      isEnabled,\n      billingConfiguration: billingConfig,\n      billingProviderRef,\n      billingAccount,\n      subscription,\n      currentPlanKey,\n      currentPlanProduct,\n      currentScope,\n      products,\n      prices,\n      invoices,\n      productDefinitions,\n      getPricesForProduct,\n      getProductByKey,\n      isProductAcquirable,\n      activePromotions,\n      usage,\n      creditPools,\n      openCheckout,\n      openCustomerPortal,\n      previewPlanChange,\n      confirmPlanChange,\n      cancelPendingPlanChange,\n      isLoading,\n      availability,\n      isSliceAvailable,\n      error,\n      refetch: fetchBillingState,\n    }),\n    [\n      isEnabled,\n      billingConfig,\n      billingProviderRef,\n      billingAccount,\n      subscription,\n      currentPlanKey,\n      currentPlanProduct,\n      currentScope,\n      products,\n      prices,\n      invoices,\n      productDefinitions,\n      getPricesForProduct,\n      getProductByKey,\n      isProductAcquirable,\n      activePromotions,\n      usage,\n      creditPools,\n      openCheckout,\n      openCustomerPortal,\n      previewPlanChange,\n      confirmPlanChange,\n      cancelPendingPlanChange,\n      isLoading,\n      availability,\n      isSliceAvailable,\n      error,\n      fetchBillingState,\n    ],\n  );\n\n  return (\n    <BillingContext.Provider value={contextValue}>\n      {children}\n    </BillingContext.Provider>\n  );\n}\n"]}

package/dist/esm/core/billing/BillingErrorNotifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BillingErrorNotifier.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/BillingErrorNotifier.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,wBAAgB,oBAAoB,IAAI,IAAI,CAkB3C"}
+{"version":3,"file":"BillingErrorNotifier.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/BillingErrorNotifier.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,wBAAgB,oBAAoB,IAAI,IAAI,CAqB3C"}

package/dist/esm/core/billing/BillingErrorNotifier.js

@@ -10,22 +10,26 @@
 import { useEffect, useRef } from 'react';
 import { useBillingSafe } from './useBilling.js';
 import { useNotification } from '../../core/events/useNotification.js';
+import { useUserFacingErrorMessage } from '../../core/errors/useUserFacingErrorMessage.js';
 export function BillingErrorNotifier() {
     const billing = useBillingSafe();
     const { notifyError } = useNotification();
+    const toUserFacingErrorMessage = useUserFacingErrorMessage();
     const lastNotifiedErrorRef = useRef(null);
     useEffect(() => {
         if (billing?.error) {
-            const errorMessage = billing.error.message;
-            if (lastNotifiedErrorRef.current !== errorMessage) {
-                lastNotifiedErrorRef.current = errorMessage;
-                notifyError(errorMessage);
+            // The raw message only DEDUPLICATES (a refetch failing the same way is not a new notification);
+            // the person reads the failure's localized words.
+            const errorKey = billing.error.message;
+            if (lastNotifiedErrorRef.current !== errorKey) {
+                lastNotifiedErrorRef.current = errorKey;
+                notifyError(toUserFacingErrorMessage(billing.error));
             }
         }
         else {
             lastNotifiedErrorRef.current = null;
         }
-    }, [billing?.error, notifyError]);
+    }, [billing?.error, notifyError, toUserFacingErrorMessage]);
     return null;
 }
 //# sourceMappingURL=BillingErrorNotifier.js.map

package/dist/esm/core/billing/BillingErrorNotifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"BillingErrorNotifier.js","sourceRoot":"","sources":["../../../../src/core/billing/BillingErrorNotifier.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAAC;IAC1C,MAAM,oBAAoB,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAEzD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YAC3C,IAAI,oBAAoB,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;gBAClD,oBAAoB,CAAC,OAAO,GAAG,YAAY,CAAC;gBAC5C,WAAW,CAAC,YAAY,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC;QACtC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IAElC,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * BillingErrorNotifier\n *\n * Bridge component that sits inside both BillingProvider and NotificationProvider.\n * Watches BillingContext.error and dispatches a notification when billing state\n * fetch fails. Uses a ref to avoid duplicate notifications on re-renders.\n *\n * Rendered in ApplicationMainContext inside the NotificationProvider subtree.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { useBillingSafe } from './useBilling';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\n\nexport function BillingErrorNotifier(): null {\n  const billing = useBillingSafe();\n  const { notifyError } = useNotification();\n  const lastNotifiedErrorRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (billing?.error) {\n      const errorMessage = billing.error.message;\n      if (lastNotifiedErrorRef.current !== errorMessage) {\n        lastNotifiedErrorRef.current = errorMessage;\n        notifyError(errorMessage);\n      }\n    } else {\n      lastNotifiedErrorRef.current = null;\n    }\n  }, [billing?.error, notifyError]);\n\n  return null;\n}\n"]}
+{"version":3,"file":"BillingErrorNotifier.js","sourceRoot":"","sources":["../../../../../src/core/billing/BillingErrorNotifier.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2DAA2D,CAAC;AAEtG,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAAC;IAC1C,MAAM,wBAAwB,GAAG,yBAAyB,EAAE,CAAC;IAC7D,MAAM,oBAAoB,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAEzD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,gGAAgG;YAChG,kDAAkD;YAClD,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YACvC,IAAI,oBAAoB,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC9C,oBAAoB,CAAC,OAAO,GAAG,QAAQ,CAAC;gBACxC,WAAW,CAAC,wBAAwB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC;QACtC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,wBAAwB,CAAC,CAAC,CAAC;IAE5D,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * BillingErrorNotifier\n *\n * Bridge component that sits inside both BillingProvider and NotificationProvider.\n * Watches BillingContext.error and dispatches a notification when billing state\n * fetch fails. Uses a ref to avoid duplicate notifications on re-renders.\n *\n * Rendered in ApplicationMainContext inside the NotificationProvider subtree.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { useBillingSafe } from './useBilling';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\nimport { useUserFacingErrorMessage } from '~wildo-frontend-lib/core/errors/useUserFacingErrorMessage';\n\nexport function BillingErrorNotifier(): null {\n  const billing = useBillingSafe();\n  const { notifyError } = useNotification();\n  const toUserFacingErrorMessage = useUserFacingErrorMessage();\n  const lastNotifiedErrorRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (billing?.error) {\n      // The raw message only DEDUPLICATES (a refetch failing the same way is not a new notification);\n      // the person reads the failure's localized words.\n      const errorKey = billing.error.message;\n      if (lastNotifiedErrorRef.current !== errorKey) {\n        lastNotifiedErrorRef.current = errorKey;\n        notifyError(toUserFacingErrorMessage(billing.error));\n      }\n    } else {\n      lastNotifiedErrorRef.current = null;\n    }\n  }, [billing?.error, notifyError, toUserFacingErrorMessage]);\n\n  return null;\n}\n"]}

package/dist/esm/core/billing/billing-launcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing-launcher.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/billing-launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,iEAAiE,CAAC;AAGzE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAA6C,CAAC;AAMzF,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB,EAAE,kBAMvC,CAAC"}
+{"version":3,"file":"billing-launcher.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/billing-launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,iEAAiE,CAAC;AAGzE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAA6C,CAAC;AAMzF,0EAA0E;AAC1E,eAAO,MAAM,yBAAyB,EAAE,kBAMvC,CAAC"}

package/dist/esm/core/billing/billing-launcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing-launcher.js","sourceRoot":"","sources":["../../../../src/core/billing/billing-launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,sBAAsB,GAGvB,MAAM,iEAAiE,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAW,4BAA4B,CAAC,OAAO,CAAC;AAEzF,MAAM,4BAA4B,GAAsC;IACtE,oBAAoB,EAAE,CAAC,gBAAgB,CAAC;CACzC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,yBAAyB,GAAuB;IAC3D,IAAI,EAAE,sBAAsB,CAAC,gBAAgB;IAC7C,UAAU,EAAE,4BAA4B;IACxC,QAAQ,EAAE,SAAS;IACnB,cAAc,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IACpF,mBAAmB,EAAE,4BAA4B;CAClD,CAAC","sourcesContent":["/**\n * Declarative billing launcher entry.\n *\n * THE billing home is the Settings Hub \"billing\" destination (a bespoke\n * `ENGINE_PANEL` — see `engine-settings-destinations.ts` /\n * `AppPage_BillingSettings`). The only launcher the framework ships for billing\n * is a command-menu entry that opens the hub at that section.\n *\n * Note the engine ships the DESTINATION, never its placement: whether billing\n * appears in the rail at all, and where, is the application's\n * `settingsHub.placements`. That is why the command entry below is verified\n * against what the application placed rather than assumed reachable.\n *\n * HISTORY: billing used to ALSO ship an app-level full-custom view\n * (`/custom/billing`, componentRef `billing-overview`) plus a sidebar row\n * pointing at it — a second, app-registered billing home beside the settings\n * one. That placement was retired (2026-08-18): one billing surface, inside\n * settings, engine-owned. Do not reintroduce a `FullCustomViewDefinition` here;\n * apps that want extra billing surfaces compose the self-hydrating billing\n * widgets (`SubscriptionStatus`, `PricingTable`, …) in their own views.\n */\n\nimport {\n  LauncherItemTargetKind,\n  type LauncherRuntimeAvailabilityConfig,\n  type CommandMenuCommand,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { EngineSettingsDestinationRef } from '@wildo-ai/saas-models';\n\n/**\n * Settings Hub section ref for the billing home (`/settings/billing`).\n *\n * Derived from the destination catalog rather than written as a literal. It used\n * to be `= 'billing'`, an engine surface asserting a ref with nothing tying it to\n * the catalog entry it names — and the failure is silent in both directions:\n * `resolveItemRef` falls back to the hub's DEFAULT section for an unknown\n * `sectionRef`, so a command labelled \"Billing\" would open Profile rather than\n * error.\n *\n * The other half of that hole is that an application may simply not PLACE the\n * billing destination, which no static reference can know. That is checked at\n * DEV startup — see `SETTINGS_SECTION_NOT_PLACED` in `verify-launcher-content.ts`.\n */\nexport const BILLING_SETTINGS_SECTION_REF: string = EngineSettingsDestinationRef.BILLING;\n\nconst BILLING_RUNTIME_AVAILABILITY: LauncherRuntimeAvailabilityConfig = {\n  requiredCapabilities: ['billingEnabled'],\n};\n\n/** Command menu entry — opens the Settings Hub at the billing section. */\nexport const BILLING_COMMAND_MENU_ITEM: CommandMenuCommand = {\n  kind: LauncherItemTargetKind.SETTINGS_SECTION,\n  sectionRef: BILLING_SETTINGS_SECTION_REF,\n  category: 'billing',\n  searchKeywords: ['billing', 'subscription', 'plan', 'payment', 'invoice', 'upgrade'],\n  runtimeAvailability: BILLING_RUNTIME_AVAILABILITY,\n};\n"]}
+{"version":3,"file":"billing-launcher.js","sourceRoot":"","sources":["../../../../../src/core/billing/billing-launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EACL,sBAAsB,GAGvB,MAAM,iEAAiE,CAAC;AACzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAW,4BAA4B,CAAC,OAAO,CAAC;AAEzF,MAAM,4BAA4B,GAAsC;IACtE,oBAAoB,EAAE,CAAC,gBAAgB,CAAC;CACzC,CAAC;AAEF,0EAA0E;AAC1E,MAAM,CAAC,MAAM,yBAAyB,GAAuB;IAC3D,IAAI,EAAE,sBAAsB,CAAC,gBAAgB;IAC7C,UAAU,EAAE,4BAA4B;IACxC,QAAQ,EAAE,SAAS;IACnB,cAAc,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;IACpF,mBAAmB,EAAE,4BAA4B;CAClD,CAAC","sourcesContent":["/**\n * Declarative billing launcher entry.\n *\n * THE billing home is the Settings Hub \"billing\" destination (a bespoke\n * `ENGINE_PANEL` — see `engine-settings-destinations.ts` /\n * `AppPage_BillingSettings`). The only launcher the framework ships for billing\n * is a command-menu entry that opens the hub at that section.\n *\n * Note the engine ships the DESTINATION, never its placement: whether billing\n * appears in the rail at all, and where, is the application's\n * `settingsHub.placements`. That is why the command entry below is verified\n * against what the application placed rather than assumed reachable.\n *\n * HISTORY: billing used to ALSO ship an app-level full-custom view\n * (`/custom/billing`, componentRef `billing-overview`) plus a sidebar row\n * pointing at it — a second, app-registered billing home beside the settings\n * one. That placement was retired (2026-08-18): one billing surface, inside\n * settings, engine-owned. Do not reintroduce a `FullCustomViewDefinition` here;\n * apps that want extra billing surfaces compose the self-hydrating billing\n * widgets (`SubscriptionStatus`, `PricingTable`, …) in their own views.\n */\n\nimport {\n  LauncherItemTargetKind,\n  type LauncherRuntimeAvailabilityConfig,\n  type CommandMenuCommand,\n} from '~wildo-frontend-lib/core/config/launcher-items.frontend.schemas';\nimport { EngineSettingsDestinationRef } from '@wildo-ai/saas-models';\n\n/**\n * Settings Hub section ref for the billing home (`/settings/billing`).\n *\n * Derived from the destination catalog rather than written as a literal. It used\n * to be `= 'billing'`, an engine surface asserting a ref with nothing tying it to\n * the catalog entry it names — and the failure is silent in both directions:\n * `resolveItemRef` falls back to the hub's DEFAULT section for an unknown\n * `sectionRef`, so a command labelled \"Billing\" would open Profile rather than\n * error.\n *\n * The other half of that hole is that an application may simply not PLACE the\n * billing destination, which no static reference can know. That is checked at\n * DEV startup — see `SETTINGS_SECTION_NOT_PLACED` in `verify-launcher-content.ts`.\n */\nexport const BILLING_SETTINGS_SECTION_REF: string = EngineSettingsDestinationRef.BILLING;\n\nconst BILLING_RUNTIME_AVAILABILITY: LauncherRuntimeAvailabilityConfig = {\n  requiredCapabilities: ['billingEnabled'],\n};\n\n/** Command menu entry — opens the Settings Hub at the billing section. */\nexport const BILLING_COMMAND_MENU_ITEM: CommandMenuCommand = {\n  kind: LauncherItemTargetKind.SETTINGS_SECTION,\n  sectionRef: BILLING_SETTINGS_SECTION_REF,\n  category: 'billing',\n  searchKeywords: ['billing', 'subscription', 'plan', 'payment', 'invoice', 'upgrade'],\n  runtimeAvailability: BILLING_RUNTIME_AVAILABILITY,\n};\n"]}