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

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":["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  BUILTIN_PROVIDER_CAPABILITY,\n  BUILTIN_PROVIDER_PROTOCOL,\n  CoreWebSocketEvent,\n  CoreResourceType,\n  ResourcePrimaryScope,\n  MAIN_API_BASE_PATH,\n  userRolesSatisfyRequiredRoles,\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 { 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  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  }) => 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  // ── 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, 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    // 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 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    }): 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,\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 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      previewPlanChange,\n      confirmPlanChange,\n      isLoading,\n      availability,\n      isSliceAvailable,\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      previewPlanChange,\n      confirmPlanChange,\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\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/billing-provider-display.frontend.utils.d.ts

@@ -1,7 +1,15 @@
-import type { FrontendAppProviderModule } from '@wildo-ai/external-connectors-public/app';
-export declare function collectBillingProviderLabelKeys(provider: FrontendAppProviderModule | null | undefined): string[];
+/**
+ * The billing provider's name, for the three billing components that show it (portal link, invoice
+ * history, subscription status).
+ *
+ * Keyed on the configured `billing.providerRef` and nothing else (#1701). The name is
+ * `providers.<ref>.displayName`, planned and generated for every declared provider (#1895). It used to
+ * be read off a frontend provider module — Stripe's, which loaded no Stripe code and existed only to
+ * carry it — so billing's visible name depended on declaring a browser module that did nothing.
+ */
+export declare function collectBillingProviderLabelKeys(providerRef: string | null | undefined): string[];
 export declare function resolveBillingProviderDisplayName(input: {
-    provider: FrontendAppProviderModule | null | undefined;
+    providerRef: string | null | undefined;
     translate?: (key: string) => string;
 }): string | undefined;
 //# sourceMappingURL=billing-provider-display.frontend.utils.d.ts.map

package/dist/esm/core/billing/billing-provider-display.frontend.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"billing-provider-display.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/billing-provider-display.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAM1F,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GACrD,MAAM,EAAE,CAIV;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,QAAQ,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,CAAC;IACvD,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC,GAAG,MAAM,GAAG,SAAS,CAWrB"}
+{"version":3,"file":"billing-provider-display.frontend.utils.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/billing-provider-display.frontend.utils.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,CAEhG;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE;IACvD,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACvC,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC,GAAG,MAAM,GAAG,SAAS,CASrB"}

package/dist/esm/core/billing/billing-provider-display.frontend.utils.js

@@ -1,17 +1,23 @@
+import { buildProviderDisplayNameLabelKey } from '@wildo-ai/saas-models/public-runtime';
 import { collectFrontendProviderDisplayLabelKeys, resolveFrontendProviderDisplayLabel, } from '../../core/external-providers/frontend-provider-display-label.frontend.utils.js';
-export function collectBillingProviderLabelKeys(provider) {
-    return collectFrontendProviderDisplayLabelKeys([
-        provider?.metadata.displayNameLabelKey,
-    ]);
+/**
+ * The billing provider's name, for the three billing components that show it (portal link, invoice
+ * history, subscription status).
+ *
+ * Keyed on the configured `billing.providerRef` and nothing else (#1701). The name is
+ * `providers.<ref>.displayName`, planned and generated for every declared provider (#1895). It used to
+ * be read off a frontend provider module — Stripe's, which loaded no Stripe code and existed only to
+ * carry it — so billing's visible name depended on declaring a browser module that did nothing.
+ */
+export function collectBillingProviderLabelKeys(providerRef) {
+    return collectFrontendProviderDisplayLabelKeys([providerRef ? buildProviderDisplayNameLabelKey(providerRef) : undefined]);
 }
 export function resolveBillingProviderDisplayName(input) {
-    if (!input.provider) {
+    if (!input.providerRef) {
         return undefined;
     }
     return resolveFrontendProviderDisplayLabel({
-        providerRef: input.provider.metadata.ref,
-        displayName: input.provider.metadata.displayName,
-        displayNameLabelKey: input.provider.metadata.displayNameLabelKey,
+        providerRef: input.providerRef,
         translate: input.translate,
     });
 }

package/dist/esm/core/billing/billing-provider-display.frontend.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"billing-provider-display.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/billing/billing-provider-display.frontend.utils.ts"],"names":[],"mappings":"AACA,OAAO,EACL,uCAAuC,EACvC,mCAAmC,GACpC,MAAM,4FAA4F,CAAC;AAEpG,MAAM,UAAU,+BAA+B,CAC7C,QAAsD;IAEtD,OAAO,uCAAuC,CAAC;QAC7C,QAAQ,EAAE,QAAQ,CAAC,mBAAmB;KACvC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,KAGjD;IACC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,mCAAmC,CAAC;QACzC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG;QACxC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,WAAW;QAChD,mBAAmB,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,mBAAmB;QAChE,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { FrontendAppProviderModule } from '@wildo-ai/external-connectors-public/app';\nimport {\n  collectFrontendProviderDisplayLabelKeys,\n  resolveFrontendProviderDisplayLabel,\n} from '~wildo-frontend-lib/core/external-providers/frontend-provider-display-label.frontend.utils';\n\nexport function collectBillingProviderLabelKeys(\n  provider: FrontendAppProviderModule | null | undefined,\n): string[] {\n  return collectFrontendProviderDisplayLabelKeys([\n    provider?.metadata.displayNameLabelKey,\n  ]);\n}\n\nexport function resolveBillingProviderDisplayName(input: {\n  provider: FrontendAppProviderModule | null | undefined;\n  translate?: (key: string) => string;\n}): string | undefined {\n  if (!input.provider) {\n    return undefined;\n  }\n\n  return resolveFrontendProviderDisplayLabel({\n    providerRef: input.provider.metadata.ref,\n    displayName: input.provider.metadata.displayName,\n    displayNameLabelKey: input.provider.metadata.displayNameLabelKey,\n    translate: input.translate,\n  });\n}\n"]}
+{"version":3,"file":"billing-provider-display.frontend.utils.js","sourceRoot":"","sources":["../../../../../src/core/billing/billing-provider-display.frontend.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AACxF,OAAO,EACL,uCAAuC,EACvC,mCAAmC,GACpC,MAAM,4FAA4F,CAAC;AAEpG;;;;;;;;GAQG;AACH,MAAM,UAAU,+BAA+B,CAAC,WAAsC;IACpF,OAAO,uCAAuC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,gCAAgC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5H,CAAC;AAED,MAAM,UAAU,iCAAiC,CAAC,KAGjD;IACC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,mCAAmC,CAAC;QACzC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { buildProviderDisplayNameLabelKey } from '@wildo-ai/saas-models/public-runtime';\nimport {\n  collectFrontendProviderDisplayLabelKeys,\n  resolveFrontendProviderDisplayLabel,\n} from '~wildo-frontend-lib/core/external-providers/frontend-provider-display-label.frontend.utils';\n\n/**\n * The billing provider's name, for the three billing components that show it (portal link, invoice\n * history, subscription status).\n *\n * Keyed on the configured `billing.providerRef` and nothing else (#1701). The name is\n * `providers.<ref>.displayName`, planned and generated for every declared provider (#1895). It used to\n * be read off a frontend provider module — Stripe's, which loaded no Stripe code and existed only to\n * carry it — so billing's visible name depended on declaring a browser module that did nothing.\n */\nexport function collectBillingProviderLabelKeys(providerRef: string | null | undefined): string[] {\n  return collectFrontendProviderDisplayLabelKeys([providerRef ? buildProviderDisplayNameLabelKey(providerRef) : undefined]);\n}\n\nexport function resolveBillingProviderDisplayName(input: {\n  providerRef: string | null | undefined;\n  translate?: (key: string) => string;\n}): string | undefined {\n  if (!input.providerRef) {\n    return undefined;\n  }\n\n  return resolveFrontendProviderDisplayLabel({\n    providerRef: input.providerRef,\n    translate: input.translate,\n  });\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useBillingPlanChange.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/useBillingPlanChange.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAEtH,oBAAY,sBAAsB;IAChC,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAED,KAAK,SAAS,GAAG;IAAE,MAAM,EAAE,uBAAuB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5E,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,sBAAsB,CAAC,IAAI,CAAA;CAAE,GACtC,CAAC,SAAS,GAAG;IAAE,KAAK,EAAE,sBAAsB,CAAC,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAA;CAAE,CAAC,GAC1F,CAAC,SAAS,GAAG;IAAE,KAAK,EAAE,sBAAsB,CAAC,KAAK,GAAG,sBAAsB,CAAC,UAAU,CAAC;IAAC,QAAQ,EAAE,gCAAgC,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEvL,sGAAsG;AACtG,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gCAAgC,GAAG,cAAc,CAYnG;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS;;qBAgChC,uBAAuB;;;EA4ClE"}
+{"version":3,"file":"useBillingPlanChange.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/useBillingPlanChange.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,gCAAgC,EAAE,MAAM,kBAAkB,CAAC;AAEtH,oBAAY,sBAAsB;IAChC,IAAI,SAAS;IACb,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,UAAU,eAAe;IACzB,MAAM,WAAW;CAClB;AAED,KAAK,SAAS,GAAG;IAAE,MAAM,EAAE,uBAAuB,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,CAAC;AAC5E,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,sBAAsB,CAAC,IAAI,CAAA;CAAE,GACtC,CAAC,SAAS,GAAG;IAAE,KAAK,EAAE,sBAAsB,CAAC,UAAU,GAAG,sBAAsB,CAAC,MAAM,CAAA;CAAE,CAAC,GAC1F,CAAC,SAAS,GAAG;IAAE,KAAK,EAAE,sBAAsB,CAAC,KAAK,GAAG,sBAAsB,CAAC,UAAU,CAAC;IAAC,QAAQ,EAAE,gCAAgC,CAAC;IAAC,OAAO,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAEvL,sGAAsG;AACtG,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gCAAgC,GAAG,cAAc,CAcnG;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS;;qBAgChC,uBAAuB;;;EA4ClE"}

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

@@ -21,6 +21,8 @@ export function invoicePreviewForDisplay(response) {
         lineItems: response.lineItems.map(item => ({ ...item, amount: { amount: BigInt(item.amount), currency, decimals } })),
         periodStart: response.periodStart,
         periodEnd: response.periodEnd,
+        timing: response.timing,
+        effectiveAt: new Date(response.effectiveAt),
     };
 }
 /** Owns the composed selection flow. A server token is only usable with its original selection.

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

@@ -1 +1 @@
-{"version":3,"file":"useBillingPlanChange.js","sourceRoot":"","sources":["../../../../../src/core/billing/useBillingPlanChange.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport { currencyMinorUnitDecimals } from '@wildo-ai/zod-decorators';\nimport { BillingStateSlice, type InvoicePreview } from '@wildo-ai/saas-models';\nimport type { BillingContextType, BillingPlanChangeTarget, BillingPlanChangePreviewResponse } from './BillingContext';\n\nexport enum BillingPlanChangePhase {\n  IDLE = 'idle',\n  PREVIEWING = 'previewing',\n  READY = 'ready',\n  CONFIRMING = 'confirming',\n  FAILED = 'failed',\n}\n\ntype Selection = { target: BillingPlanChangeTarget; scopeIdentity: string };\nexport type BillingPlanChangeState =\n  | { phase: BillingPlanChangePhase.IDLE }\n  | (Selection & { phase: BillingPlanChangePhase.PREVIEWING | BillingPlanChangePhase.FAILED })\n  | (Selection & { phase: BillingPlanChangePhase.READY | BillingPlanChangePhase.CONFIRMING; response: BillingPlanChangePreviewResponse; preview: InvoicePreview; hasError?: boolean });\n\n/** A provider amount uses the currency's own minor units, not an authored price's arbitrary scale. */\nexport function invoicePreviewForDisplay(response: BillingPlanChangePreviewResponse): InvoicePreview {\n  const currency = response.currency.toUpperCase();\n  const decimals = currencyMinorUnitDecimals(currency);\n  if (decimals === undefined || !Number.isSafeInteger(response.amount) || response.lineItems.some(item => !Number.isSafeInteger(item.amount))) {\n    throw new Error('The invoice estimate contains unsupported monetary values.');\n  }\n  return {\n    amount: { amount: BigInt(response.amount), currency, decimals },\n    lineItems: response.lineItems.map(item => ({ ...item, amount: { amount: BigInt(item.amount), currency, decimals } })),\n    periodStart: response.periodStart,\n    periodEnd: response.periodEnd,\n  };\n}\n\n/** Owns the composed selection flow. A server token is only usable with its original selection.\n * Request generation fences late responses; cancellation aborts only a preview, never an accepted mutation.\n * A failed confirmation retains its token for the server's idempotent retry path.\n */\nexport function useBillingPlanChange(billing: BillingContextType | undefined) {\n  const [state, setState] = useState<BillingPlanChangeState>({ phase: BillingPlanChangePhase.IDLE });\n  const generation = useRef(0);\n  const pendingPreview = useRef<AbortController | null>(null);\n  const confirming = useRef(false);\n  const stateRef = useRef(state);\n  stateRef.current = state;\n  const scopeIdentity = JSON.stringify([billing?.currentScope, billing?.billingAccount?._id, billing?.subscription?._id]);\n  const currentIdentity = useRef(scopeIdentity);\n  currentIdentity.current = scopeIdentity;\n  const ready = !!billing?.isEnabled && [BillingStateSlice.BILLING_ACCOUNT, BillingStateSlice.SUBSCRIPTION, BillingStateSlice.PRODUCTS, BillingStateSlice.PRICES].every(billing.isSliceAvailable);\n\n  useEffect(() => {\n    generation.current += 1;\n    pendingPreview.current?.abort();\n    setState({ phase: BillingPlanChangePhase.IDLE });\n    return () => { generation.current += 1; pendingPreview.current?.abort(); };\n  }, [scopeIdentity]);\n\n  // A same-scope refresh cannot revoke an already submitted confirmation or its retry token.\n  // Availability controls whether another dispatch is allowed; it is not evidence that the\n  // provider did not accept the first one. The server validates the quote's semantic basis.\n  useEffect(() => {\n    const current = stateRef.current;\n    if (confirming.current || (current.phase === BillingPlanChangePhase.READY && current.hasError)) return;\n    if (!ready) {\n      generation.current += 1;\n      pendingPreview.current?.abort();\n      setState({ phase: BillingPlanChangePhase.IDLE });\n    }\n  }, [ready]);\n\n  const select = useCallback(async (target: BillingPlanChangeTarget) => {\n    if (!billing || !ready || !billing.subscription || confirming.current) return;\n    const requestGeneration = ++generation.current;\n    pendingPreview.current?.abort();\n    const controller = new AbortController();\n    pendingPreview.current = controller;\n    const selection = { target, scopeIdentity };\n    setState({ ...selection, phase: BillingPlanChangePhase.PREVIEWING });\n    try {\n      const response = await billing.previewPlanChange(target, { signal: controller.signal });\n      const preview = invoicePreviewForDisplay(response);\n      if (!response.previewToken) throw new Error('The invoice estimate has no confirmation binding.');\n      if (generation.current !== requestGeneration || currentIdentity.current !== scopeIdentity) return;\n      setState({ ...selection, phase: BillingPlanChangePhase.READY, response, preview });\n    } catch {\n      if (generation.current !== requestGeneration || controller.signal.aborted) return;\n      setState({ ...selection, phase: BillingPlanChangePhase.FAILED });\n    }\n  }, [billing, ready, scopeIdentity]);\n\n  const cancel = useCallback(() => {\n    if (confirming.current) return;\n    generation.current += 1;\n    pendingPreview.current?.abort();\n    setState({ phase: BillingPlanChangePhase.IDLE });\n  }, []);\n\n  const confirm = useCallback(async () => {\n    const current = stateRef.current;\n    if (!billing || !ready || confirming.current || current.phase !== BillingPlanChangePhase.READY || current.scopeIdentity !== currentIdentity.current) return;\n    confirming.current = true;\n    const requestGeneration = generation.current;\n    setState({ ...current, phase: BillingPlanChangePhase.CONFIRMING, hasError: false });\n    try {\n      await billing.confirmPlanChange({ ...current.target, previewToken: current.response.previewToken });\n      if (generation.current === requestGeneration) setState({ phase: BillingPlanChangePhase.IDLE });\n    } catch {\n      if (generation.current === requestGeneration) setState({ ...current, phase: BillingPlanChangePhase.READY, hasError: true });\n    } finally {\n      confirming.current = false;\n    }\n  }, [billing, ready]);\n\n  return { state, select, cancel, confirm };\n}\n"]}
+{"version":3,"file":"useBillingPlanChange.js","sourceRoot":"","sources":["../../../../../src/core/billing/useBillingPlanChange.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useEffect, useRef, useState } from 'react';\nimport { currencyMinorUnitDecimals } from '@wildo-ai/zod-decorators';\nimport { BillingStateSlice, type InvoicePreview } from '@wildo-ai/saas-models';\nimport type { BillingContextType, BillingPlanChangeTarget, BillingPlanChangePreviewResponse } from './BillingContext';\n\nexport enum BillingPlanChangePhase {\n  IDLE = 'idle',\n  PREVIEWING = 'previewing',\n  READY = 'ready',\n  CONFIRMING = 'confirming',\n  FAILED = 'failed',\n}\n\ntype Selection = { target: BillingPlanChangeTarget; scopeIdentity: string };\nexport type BillingPlanChangeState =\n  | { phase: BillingPlanChangePhase.IDLE }\n  | (Selection & { phase: BillingPlanChangePhase.PREVIEWING | BillingPlanChangePhase.FAILED })\n  | (Selection & { phase: BillingPlanChangePhase.READY | BillingPlanChangePhase.CONFIRMING; response: BillingPlanChangePreviewResponse; preview: InvoicePreview; hasError?: boolean });\n\n/** A provider amount uses the currency's own minor units, not an authored price's arbitrary scale. */\nexport function invoicePreviewForDisplay(response: BillingPlanChangePreviewResponse): InvoicePreview {\n  const currency = response.currency.toUpperCase();\n  const decimals = currencyMinorUnitDecimals(currency);\n  if (decimals === undefined || !Number.isSafeInteger(response.amount) || response.lineItems.some(item => !Number.isSafeInteger(item.amount))) {\n    throw new Error('The invoice estimate contains unsupported monetary values.');\n  }\n  return {\n    amount: { amount: BigInt(response.amount), currency, decimals },\n    lineItems: response.lineItems.map(item => ({ ...item, amount: { amount: BigInt(item.amount), currency, decimals } })),\n    periodStart: response.periodStart,\n    periodEnd: response.periodEnd,\n    timing: response.timing,\n    effectiveAt: new Date(response.effectiveAt),\n  };\n}\n\n/** Owns the composed selection flow. A server token is only usable with its original selection.\n * Request generation fences late responses; cancellation aborts only a preview, never an accepted mutation.\n * A failed confirmation retains its token for the server's idempotent retry path.\n */\nexport function useBillingPlanChange(billing: BillingContextType | undefined) {\n  const [state, setState] = useState<BillingPlanChangeState>({ phase: BillingPlanChangePhase.IDLE });\n  const generation = useRef(0);\n  const pendingPreview = useRef<AbortController | null>(null);\n  const confirming = useRef(false);\n  const stateRef = useRef(state);\n  stateRef.current = state;\n  const scopeIdentity = JSON.stringify([billing?.currentScope, billing?.billingAccount?._id, billing?.subscription?._id]);\n  const currentIdentity = useRef(scopeIdentity);\n  currentIdentity.current = scopeIdentity;\n  const ready = !!billing?.isEnabled && [BillingStateSlice.BILLING_ACCOUNT, BillingStateSlice.SUBSCRIPTION, BillingStateSlice.PRODUCTS, BillingStateSlice.PRICES].every(billing.isSliceAvailable);\n\n  useEffect(() => {\n    generation.current += 1;\n    pendingPreview.current?.abort();\n    setState({ phase: BillingPlanChangePhase.IDLE });\n    return () => { generation.current += 1; pendingPreview.current?.abort(); };\n  }, [scopeIdentity]);\n\n  // A same-scope refresh cannot revoke an already submitted confirmation or its retry token.\n  // Availability controls whether another dispatch is allowed; it is not evidence that the\n  // provider did not accept the first one. The server validates the quote's semantic basis.\n  useEffect(() => {\n    const current = stateRef.current;\n    if (confirming.current || (current.phase === BillingPlanChangePhase.READY && current.hasError)) return;\n    if (!ready) {\n      generation.current += 1;\n      pendingPreview.current?.abort();\n      setState({ phase: BillingPlanChangePhase.IDLE });\n    }\n  }, [ready]);\n\n  const select = useCallback(async (target: BillingPlanChangeTarget) => {\n    if (!billing || !ready || !billing.subscription || confirming.current) return;\n    const requestGeneration = ++generation.current;\n    pendingPreview.current?.abort();\n    const controller = new AbortController();\n    pendingPreview.current = controller;\n    const selection = { target, scopeIdentity };\n    setState({ ...selection, phase: BillingPlanChangePhase.PREVIEWING });\n    try {\n      const response = await billing.previewPlanChange(target, { signal: controller.signal });\n      const preview = invoicePreviewForDisplay(response);\n      if (!response.previewToken) throw new Error('The invoice estimate has no confirmation binding.');\n      if (generation.current !== requestGeneration || currentIdentity.current !== scopeIdentity) return;\n      setState({ ...selection, phase: BillingPlanChangePhase.READY, response, preview });\n    } catch {\n      if (generation.current !== requestGeneration || controller.signal.aborted) return;\n      setState({ ...selection, phase: BillingPlanChangePhase.FAILED });\n    }\n  }, [billing, ready, scopeIdentity]);\n\n  const cancel = useCallback(() => {\n    if (confirming.current) return;\n    generation.current += 1;\n    pendingPreview.current?.abort();\n    setState({ phase: BillingPlanChangePhase.IDLE });\n  }, []);\n\n  const confirm = useCallback(async () => {\n    const current = stateRef.current;\n    if (!billing || !ready || confirming.current || current.phase !== BillingPlanChangePhase.READY || current.scopeIdentity !== currentIdentity.current) return;\n    confirming.current = true;\n    const requestGeneration = generation.current;\n    setState({ ...current, phase: BillingPlanChangePhase.CONFIRMING, hasError: false });\n    try {\n      await billing.confirmPlanChange({ ...current.target, previewToken: current.response.previewToken });\n      if (generation.current === requestGeneration) setState({ phase: BillingPlanChangePhase.IDLE });\n    } catch {\n      if (generation.current === requestGeneration) setState({ ...current, phase: BillingPlanChangePhase.READY, hasError: true });\n    } finally {\n      confirming.current = false;\n    }\n  }, [billing, ready]);\n\n  return { state, select, cancel, confirm };\n}\n"]}

package/dist/esm/core/components-registry/assert-registry-completeness.frontend.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assert-registry-completeness.frontend.helper.d.ts","sourceRoot":"","sources":["../../../../../src/core/components-registry/assert-registry-completeness.frontend.helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AA4H5E,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,0BAA0B,CAoBxE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IACnD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,0BAA0B,CAwB7B"}
+{"version":3,"file":"assert-registry-completeness.frontend.helper.d.ts","sourceRoot":"","sources":["../../../../../src/core/components-registry/assert-registry-completeness.frontend.helper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AA6H5E,MAAM,WAAW,0BAA0B;IACzC,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,qBAAqB,EAAE,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,0BAA0B,CAoBxE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,CAAC,EAAE;IACnD;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GAAG,0BAA0B,CAwB7B"}

package/dist/esm/core/components-registry/assert-registry-completeness.frontend.helper.js

@@ -109,6 +109,7 @@ const KNOWN_NON_REGISTERED_COMPONENT_TYPES = new Set([
     FrontendComponentType.APP_LAYOUTS_INVITATIONS_SETTINGS,
     FrontendComponentType.APP_LAYOUTS_BILLING_SETTINGS,
     FrontendComponentType.APP_LAYOUTS_CONNECTED_ACCOUNTS_SETTINGS,
+    FrontendComponentType.APP_LAYOUTS_AGENT_WORK_OVERRIDE_RATE_SETTINGS,
     // (a) i18n-bundle-only — SurfaceErrorBoundary is rendered directly by `Surface` when the surface
     // policy asks for a boundary, never resolved through the registry. The enum entry exists so the
     // fallback's words are addressable labels.

package/dist/esm/core/components-registry/assert-registry-completeness.frontend.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"assert-registry-completeness.frontend.helper.js","sourceRoot":"","sources":["../../../../../src/core/components-registry/assert-registry-completeness.frontend.helper.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tier-1 Registration Completeness Check\n *\n * Validates that every `FrontendComponentType` value that should have a\n * registered preset (Tier-1 — DI/registry-resolved) actually has one.\n *\n * Tier-2 / framework-internal / dispatcher / i18n-bundle-only slots are\n * explicitly deny-listed below. Any new addition to the enum that does\n * NOT belong on that list MUST be registered, otherwise this check fails.\n *\n * See `.cursor/plans/compound-component-system.md` Section 15 for the\n * full Tier-1 vs Tier-2 model.\n */\n\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { ComponentRegistryService } from './component-registry.frontend.service';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\n\n/**\n * Enum entries that intentionally have NO registered preset.\n *\n * Each entry MUST have a one-line justification explaining why it is not\n * registered. Categories:\n *\n *   (a) i18n-bundle-only — exists for `useI18n({ component })` lookup\n *       but is rendered via direct composition, not via `resolve()`.\n *   (b) framework-internal — the framework ships the implementation, so no\n *       preset is registered and this check must not demand one. It does NOT\n *       mean unswappable: a slot in this category may still consult the\n *       registry first and fall back to its built-in (see the guidance\n *       renderers below). Read each entry's own justification.\n *   (c) deprecated — superseded by another slot, kept only for migration.\n *   (d) dispatcher — meta-slot that resolves to one of several concrete\n *       slots at render time (HIGH_LEVEL_VIEWS_COMPOSITE etc.).\n *   (e) orphan — historical leftover, kept on the enum for back-compat\n *       of i18n keys but no longer wired to any wrapper.\n */\nconst KNOWN_NON_REGISTERED_COMPONENT_TYPES: ReadonlySet<FrontendComponentType> = new Set([\n  // (a) i18n-bundle-only — ContentSectionContainer uses direct composition. (The\n  // SECTION / GROUP / LEGEND slots are now registered ContentSection primitives.)\n  FrontendComponentType.LOW_LEVEL_CONTENT_SECTION_CONTAINER,\n  // (a) i18n-bundle-only — used by OverlayContainer direct composition\n  FrontendComponentType.LOW_LEVEL_OVERLAY_CONTAINER,\n\n  // (b) framework-internal — Flows-Actors orchestration shells (engine/saas-frontend-lib/src/components/flows-actors/*)\n  FrontendComponentType.LOW_LEVEL_AI_FLOW_NODE,\n  FrontendComponentType.LOW_LEVEL_AI_FLOW_EXECUTION,\n  FrontendComponentType.LOW_LEVEL_AI_SYSTEM_CATALOG,\n  FrontendComponentType.LOW_LEVEL_AI_ACTOR,\n  FrontendComponentType.LOW_LEVEL_AI_EXECUTION_PLAN,\n  FrontendComponentType.LOW_LEVEL_AI_TASK_DETAIL,\n  FrontendComponentType.LOW_LEVEL_AI_TASK_MEMORY,\n  FrontendComponentType.LOW_LEVEL_AI_APPROVAL,\n  FrontendComponentType.LOW_LEVEL_AI_DECISION,\n  FrontendComponentType.LOW_LEVEL_AI_EXECUTION_STREAM,\n  FrontendComponentType.LOW_LEVEL_AI_ARTIFACT_BROWSER,\n  FrontendComponentType.LOW_LEVEL_AI_AGENT_CONFIG,\n\n  /**\n   * (b) framework-internal — Guidance renderers\n   * (`engine/saas-frontend-lib/src/core/guidance/renderers/*`).\n   *\n   * Deny-listed because the ENGINE registers no preset for them: `GuidanceRenderer` ships working\n   * built-in implementations and falls back to them. That is why they belong here and why the\n   * check must not demand a registration.\n   *\n   * They are NOT unswappable, and this entry used to say they were. `GuidanceRenderer` resolves\n   * each element type through `GUIDANCE_ELEMENT_COMPONENT_TYPE` against this registry BEFORE its\n   * built-in map, so an application that registers a preset under `CorePresetNames.DEFAULT` for any\n   * of these types replaces that renderer — which is what the frontend-component specifications for\n   * these slots have always advertised.\n   */\n  FrontendComponentType.GUIDANCE_CHECKLIST,\n  FrontendComponentType.GUIDANCE_CHECKLIST_ITEM,\n  FrontendComponentType.GUIDANCE_TOUR,\n  FrontendComponentType.GUIDANCE_TOOLTIP,\n  FrontendComponentType.GUIDANCE_MODAL,\n  FrontendComponentType.GUIDANCE_BANNER,\n  FrontendComponentType.GUIDANCE_ANNOUNCEMENT,\n  FrontendComponentType.GUIDANCE_BADGE,\n  FrontendComponentType.GUIDANCE_CARD,\n  FrontendComponentType.GUIDANCE_SURVEY,\n  FrontendComponentType.GUIDANCE_ONBOARDING_VIEW,\n\n  // (b) framework-internal — Progression renderers (engine/saas-frontend-lib/src/components/progression/*)\n  FrontendComponentType.PROGRESSION_MILESTONE_TRACKER,\n  FrontendComponentType.PROGRESSION_ACHIEVEMENT_BADGE,\n\n  // (b) framework-internal — Lifecycle renderers (composed directly in app shells)\n  FrontendComponentType.LIFECYCLE_HOME_ACTIVATION_PROGRESS,\n  FrontendComponentType.LIFECYCLE_HOME_WELCOME_BACK,\n  FrontendComponentType.LIFECYCLE_HOME_DASHBOARD,\n\n  // (d) dispatcher — meta-slots that resolve to a concrete view at render time\n  FrontendComponentType.HIGH_LEVEL_VIEWS_COMPOSITE,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_CHART,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_FULL_CUSTOM,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_FLOWS_ACTORS,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_EXECUTION,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_NOT_FOUND,\n\n  // (b) framework-internal — H-8: app-owned shell slots. The enum entry is\n  // kept so that (1) host apps can register their own preset implementation\n  // for the slot if/when they need it, and (2) i18n labels remain\n  // addressable. The framework itself does not ship a default preset because\n  // the layout shape is intentionally app-owned (test harness page, security\n  // settings page).\n  FrontendComponentType.APP_LAYOUTS_TEST_COMPONENT,\n  FrontendComponentType.APP_LAYOUTS_SECURITY_SETTINGS,\n  // The Settings Hub + its bespoke panels are composed by the navigation\n  // runtime (NavigationContentRenderer → SettingsHub) and the hub's own panel\n  // resolver, NOT the ComponentRegistry. Their enum entries exist for i18n\n  // label addressability + spec coverage; the framework ships no default preset.\n  FrontendComponentType.APP_LAYOUTS_SETTINGS_HUB,\n  FrontendComponentType.APP_LAYOUTS_APPEARANCE_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_INVITATIONS_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_BILLING_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_CONNECTED_ACCOUNTS_SETTINGS,\n\n  // (a) i18n-bundle-only — SurfaceErrorBoundary is rendered directly by `Surface` when the surface\n  // policy asks for a boundary, never resolved through the registry. The enum entry exists so the\n  // fallback's words are addressable labels.\n  FrontendComponentType.APP_LAYOUTS_SURFACE_ERROR_BOUNDARY,\n\n  // (e) orphan — H-5: FK editing AND display both flow through the\n  // dedicated RESOURCES_FIELDS_RESOURCE_REFERENCE preset (registered by\n  // category EDIT/DISPLAY in register-framework-layouts.ts) so there is no\n  // separate FORM_FIELD / DISPLAY_FIELD wrapper to register. The enum\n  // entries are kept on the schema for consumers that key i18n labels off\n  // them; renaming has cross-package blast radius (presets, generated\n  // specs, locale bundles), so we treat them as documented orphans rather\n  // than removing them.\n  FrontendComponentType.LOW_LEVEL_FORM_FIELD_FOREIGN_KEY,\n  FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FOREIGN_KEY,\n]);\n\nexport interface RegistryCompletenessReport {\n  totalEnumValues: number;\n  registeredCount: number;\n  denyListedCount: number;\n  missing: FrontendComponentType[];\n}\n\n/**\n * Compute (without throwing) the set of enum entries that should be\n * registered but are not. Useful for tests and for the boot-time check.\n */\nexport function computeRegistryCompleteness(): RegistryCompletenessReport {\n  const allValues = Object.values(FrontendComponentType) as FrontendComponentType[];\n  const missing: FrontendComponentType[] = [];\n  let registeredCount = 0;\n\n  for (const type of allValues) {\n    if (KNOWN_NON_REGISTERED_COMPONENT_TYPES.has(type)) continue;\n    if (ComponentRegistryService.hasComponentType(type)) {\n      registeredCount += 1;\n    } else {\n      missing.push(type);\n    }\n  }\n\n  return {\n    totalEnumValues: allValues.length,\n    registeredCount,\n    denyListedCount: KNOWN_NON_REGISTERED_COMPONENT_TYPES.size,\n    missing,\n  };\n}\n\n/**\n * Boot-time guard.\n *\n * Call this once after every `registerDefaultPresets()` /\n * `registerFrameworkLayouts()` invocation completes during app startup.\n *\n * Behaviour:\n *  - In `development`: throws a hard error listing all missing entries.\n *    The developer must either register the missing component or add\n *    its enum value to `KNOWN_NON_REGISTERED_COMPONENT_TYPES` with a\n *    justification.\n *  - In `production`: logs a warning and returns. Avoids breaking a\n *    deployed app over a registration omission, but surfaces it loudly\n *    in monitoring.\n *\n * @returns the same report `computeRegistryCompleteness()` returned.\n */\nexport function assertRegistryCompleteness(options?: {\n  /**\n   * When true, throw even outside `development`. Useful for CI / unit\n   * tests that want a strict gate regardless of NODE_ENV.\n   */\n  strict?: boolean;\n}): RegistryCompletenessReport {\n  const report = computeRegistryCompleteness();\n\n  if (report.missing.length === 0) {\n    return report;\n  }\n\n  const message =\n    `[ComponentRegistry] Tier-1 completeness check failed: ${report.missing.length} ` +\n    `FrontendComponentType value(s) have no registered preset.\\n\\n` +\n    `Missing entries:\\n${report.missing.map(t => `  - ${t}`).join('\\n')}\\n\\n` +\n    `For each missing entry you must EITHER:\\n` +\n    `  (1) register a default preset in registerDefaultPresets() / registerFrameworkLayouts(); OR\\n` +\n    `  (2) add the enum value to KNOWN_NON_REGISTERED_COMPONENT_TYPES in ` +\n    `assert-registry-completeness.frontend.helper.ts with a one-line justification ` +\n    `(see compound-component-system.md Section 15 for the Tier-1 vs Tier-2 model).`;\n\n  const isDev = typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';\n  if (options?.strict || isDev) {\n    throw new Error(message);\n  }\n\n  logger.warn('component-registry.completeness-check.failed', { message, missing: report.missing });\n  return report;\n}\n"]}
+{"version":3,"file":"assert-registry-completeness.frontend.helper.js","sourceRoot":"","sources":["../../../../../src/core/components-registry/assert-registry-completeness.frontend.helper.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Tier-1 Registration Completeness Check\n *\n * Validates that every `FrontendComponentType` value that should have a\n * registered preset (Tier-1 — DI/registry-resolved) actually has one.\n *\n * Tier-2 / framework-internal / dispatcher / i18n-bundle-only slots are\n * explicitly deny-listed below. Any new addition to the enum that does\n * NOT belong on that list MUST be registered, otherwise this check fails.\n *\n * See `.cursor/plans/compound-component-system.md` Section 15 for the\n * full Tier-1 vs Tier-2 model.\n */\n\nimport { FrontendComponentType } from '@wildo-ai/presets-components-models';\nimport { ComponentRegistryService } from './component-registry.frontend.service';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\n\nconst logger: LoggerFrontendService = LoggerFrontendService.getLogger();\n\n/**\n * Enum entries that intentionally have NO registered preset.\n *\n * Each entry MUST have a one-line justification explaining why it is not\n * registered. Categories:\n *\n *   (a) i18n-bundle-only — exists for `useI18n({ component })` lookup\n *       but is rendered via direct composition, not via `resolve()`.\n *   (b) framework-internal — the framework ships the implementation, so no\n *       preset is registered and this check must not demand one. It does NOT\n *       mean unswappable: a slot in this category may still consult the\n *       registry first and fall back to its built-in (see the guidance\n *       renderers below). Read each entry's own justification.\n *   (c) deprecated — superseded by another slot, kept only for migration.\n *   (d) dispatcher — meta-slot that resolves to one of several concrete\n *       slots at render time (HIGH_LEVEL_VIEWS_COMPOSITE etc.).\n *   (e) orphan — historical leftover, kept on the enum for back-compat\n *       of i18n keys but no longer wired to any wrapper.\n */\nconst KNOWN_NON_REGISTERED_COMPONENT_TYPES: ReadonlySet<FrontendComponentType> = new Set([\n  // (a) i18n-bundle-only — ContentSectionContainer uses direct composition. (The\n  // SECTION / GROUP / LEGEND slots are now registered ContentSection primitives.)\n  FrontendComponentType.LOW_LEVEL_CONTENT_SECTION_CONTAINER,\n  // (a) i18n-bundle-only — used by OverlayContainer direct composition\n  FrontendComponentType.LOW_LEVEL_OVERLAY_CONTAINER,\n\n  // (b) framework-internal — Flows-Actors orchestration shells (engine/saas-frontend-lib/src/components/flows-actors/*)\n  FrontendComponentType.LOW_LEVEL_AI_FLOW_NODE,\n  FrontendComponentType.LOW_LEVEL_AI_FLOW_EXECUTION,\n  FrontendComponentType.LOW_LEVEL_AI_SYSTEM_CATALOG,\n  FrontendComponentType.LOW_LEVEL_AI_ACTOR,\n  FrontendComponentType.LOW_LEVEL_AI_EXECUTION_PLAN,\n  FrontendComponentType.LOW_LEVEL_AI_TASK_DETAIL,\n  FrontendComponentType.LOW_LEVEL_AI_TASK_MEMORY,\n  FrontendComponentType.LOW_LEVEL_AI_APPROVAL,\n  FrontendComponentType.LOW_LEVEL_AI_DECISION,\n  FrontendComponentType.LOW_LEVEL_AI_EXECUTION_STREAM,\n  FrontendComponentType.LOW_LEVEL_AI_ARTIFACT_BROWSER,\n  FrontendComponentType.LOW_LEVEL_AI_AGENT_CONFIG,\n\n  /**\n   * (b) framework-internal — Guidance renderers\n   * (`engine/saas-frontend-lib/src/core/guidance/renderers/*`).\n   *\n   * Deny-listed because the ENGINE registers no preset for them: `GuidanceRenderer` ships working\n   * built-in implementations and falls back to them. That is why they belong here and why the\n   * check must not demand a registration.\n   *\n   * They are NOT unswappable, and this entry used to say they were. `GuidanceRenderer` resolves\n   * each element type through `GUIDANCE_ELEMENT_COMPONENT_TYPE` against this registry BEFORE its\n   * built-in map, so an application that registers a preset under `CorePresetNames.DEFAULT` for any\n   * of these types replaces that renderer — which is what the frontend-component specifications for\n   * these slots have always advertised.\n   */\n  FrontendComponentType.GUIDANCE_CHECKLIST,\n  FrontendComponentType.GUIDANCE_CHECKLIST_ITEM,\n  FrontendComponentType.GUIDANCE_TOUR,\n  FrontendComponentType.GUIDANCE_TOOLTIP,\n  FrontendComponentType.GUIDANCE_MODAL,\n  FrontendComponentType.GUIDANCE_BANNER,\n  FrontendComponentType.GUIDANCE_ANNOUNCEMENT,\n  FrontendComponentType.GUIDANCE_BADGE,\n  FrontendComponentType.GUIDANCE_CARD,\n  FrontendComponentType.GUIDANCE_SURVEY,\n  FrontendComponentType.GUIDANCE_ONBOARDING_VIEW,\n\n  // (b) framework-internal — Progression renderers (engine/saas-frontend-lib/src/components/progression/*)\n  FrontendComponentType.PROGRESSION_MILESTONE_TRACKER,\n  FrontendComponentType.PROGRESSION_ACHIEVEMENT_BADGE,\n\n  // (b) framework-internal — Lifecycle renderers (composed directly in app shells)\n  FrontendComponentType.LIFECYCLE_HOME_ACTIVATION_PROGRESS,\n  FrontendComponentType.LIFECYCLE_HOME_WELCOME_BACK,\n  FrontendComponentType.LIFECYCLE_HOME_DASHBOARD,\n\n  // (d) dispatcher — meta-slots that resolve to a concrete view at render time\n  FrontendComponentType.HIGH_LEVEL_VIEWS_COMPOSITE,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_CHART,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_FULL_CUSTOM,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_FLOWS_ACTORS,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_EXECUTION,\n  FrontendComponentType.HIGH_LEVEL_VIEWS_NOT_FOUND,\n\n  // (b) framework-internal — H-8: app-owned shell slots. The enum entry is\n  // kept so that (1) host apps can register their own preset implementation\n  // for the slot if/when they need it, and (2) i18n labels remain\n  // addressable. The framework itself does not ship a default preset because\n  // the layout shape is intentionally app-owned (test harness page, security\n  // settings page).\n  FrontendComponentType.APP_LAYOUTS_TEST_COMPONENT,\n  FrontendComponentType.APP_LAYOUTS_SECURITY_SETTINGS,\n  // The Settings Hub + its bespoke panels are composed by the navigation\n  // runtime (NavigationContentRenderer → SettingsHub) and the hub's own panel\n  // resolver, NOT the ComponentRegistry. Their enum entries exist for i18n\n  // label addressability + spec coverage; the framework ships no default preset.\n  FrontendComponentType.APP_LAYOUTS_SETTINGS_HUB,\n  FrontendComponentType.APP_LAYOUTS_APPEARANCE_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_INVITATIONS_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_BILLING_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_CONNECTED_ACCOUNTS_SETTINGS,\n  FrontendComponentType.APP_LAYOUTS_AGENT_WORK_OVERRIDE_RATE_SETTINGS,\n\n  // (a) i18n-bundle-only — SurfaceErrorBoundary is rendered directly by `Surface` when the surface\n  // policy asks for a boundary, never resolved through the registry. The enum entry exists so the\n  // fallback's words are addressable labels.\n  FrontendComponentType.APP_LAYOUTS_SURFACE_ERROR_BOUNDARY,\n\n  // (e) orphan — H-5: FK editing AND display both flow through the\n  // dedicated RESOURCES_FIELDS_RESOURCE_REFERENCE preset (registered by\n  // category EDIT/DISPLAY in register-framework-layouts.ts) so there is no\n  // separate FORM_FIELD / DISPLAY_FIELD wrapper to register. The enum\n  // entries are kept on the schema for consumers that key i18n labels off\n  // them; renaming has cross-package blast radius (presets, generated\n  // specs, locale bundles), so we treat them as documented orphans rather\n  // than removing them.\n  FrontendComponentType.LOW_LEVEL_FORM_FIELD_FOREIGN_KEY,\n  FrontendComponentType.LOW_LEVEL_DISPLAY_FIELD_FOREIGN_KEY,\n]);\n\nexport interface RegistryCompletenessReport {\n  totalEnumValues: number;\n  registeredCount: number;\n  denyListedCount: number;\n  missing: FrontendComponentType[];\n}\n\n/**\n * Compute (without throwing) the set of enum entries that should be\n * registered but are not. Useful for tests and for the boot-time check.\n */\nexport function computeRegistryCompleteness(): RegistryCompletenessReport {\n  const allValues = Object.values(FrontendComponentType) as FrontendComponentType[];\n  const missing: FrontendComponentType[] = [];\n  let registeredCount = 0;\n\n  for (const type of allValues) {\n    if (KNOWN_NON_REGISTERED_COMPONENT_TYPES.has(type)) continue;\n    if (ComponentRegistryService.hasComponentType(type)) {\n      registeredCount += 1;\n    } else {\n      missing.push(type);\n    }\n  }\n\n  return {\n    totalEnumValues: allValues.length,\n    registeredCount,\n    denyListedCount: KNOWN_NON_REGISTERED_COMPONENT_TYPES.size,\n    missing,\n  };\n}\n\n/**\n * Boot-time guard.\n *\n * Call this once after every `registerDefaultPresets()` /\n * `registerFrameworkLayouts()` invocation completes during app startup.\n *\n * Behaviour:\n *  - In `development`: throws a hard error listing all missing entries.\n *    The developer must either register the missing component or add\n *    its enum value to `KNOWN_NON_REGISTERED_COMPONENT_TYPES` with a\n *    justification.\n *  - In `production`: logs a warning and returns. Avoids breaking a\n *    deployed app over a registration omission, but surfaces it loudly\n *    in monitoring.\n *\n * @returns the same report `computeRegistryCompleteness()` returned.\n */\nexport function assertRegistryCompleteness(options?: {\n  /**\n   * When true, throw even outside `development`. Useful for CI / unit\n   * tests that want a strict gate regardless of NODE_ENV.\n   */\n  strict?: boolean;\n}): RegistryCompletenessReport {\n  const report = computeRegistryCompleteness();\n\n  if (report.missing.length === 0) {\n    return report;\n  }\n\n  const message =\n    `[ComponentRegistry] Tier-1 completeness check failed: ${report.missing.length} ` +\n    `FrontendComponentType value(s) have no registered preset.\\n\\n` +\n    `Missing entries:\\n${report.missing.map(t => `  - ${t}`).join('\\n')}\\n\\n` +\n    `For each missing entry you must EITHER:\\n` +\n    `  (1) register a default preset in registerDefaultPresets() / registerFrameworkLayouts(); OR\\n` +\n    `  (2) add the enum value to KNOWN_NON_REGISTERED_COMPONENT_TYPES in ` +\n    `assert-registry-completeness.frontend.helper.ts with a one-line justification ` +\n    `(see compound-component-system.md Section 15 for the Tier-1 vs Tier-2 model).`;\n\n  const isDev = typeof process !== 'undefined' && process.env?.NODE_ENV === 'development';\n  if (options?.strict || isDev) {\n    throw new Error(message);\n  }\n\n  logger.warn('component-registry.completeness-check.failed', { message, missing: report.missing });\n  return report;\n}\n"]}