@wildo-ai/saas-frontend-lib 1.1.1 → 1.1.3

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

@@ -22,6 +22,7 @@ import { useWebSocket } from '../../core/requests/websockets/useWebSocket.js';
 import { useUserOrgs } from '../../core/security/useUserOrgs.js';
 import { useAppScopeSafe } from '../../core/scope/useAppScope.js';
 import { useApplication } from '../../core/runtime/useApplication.js';
+import { useResourceRegistrySafe } from '../../core/resources/useResourceRegistry.js';
 import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
 import { getManualCallsHttpClient } from '../../core/requests/wildo-http-client-manual-calls.frontend.service.js';
 import { useEmitLoadingScope } from '../../core/loading/useEmitLoadingScope.js';
@@ -78,14 +79,17 @@ const SCOPE_TO_OPEN_PORTAL_URL = {
 const EMPTY_USAGE = {
     byProduct: {},
 };
+/** @wildo_source:part:end saas.frontend.billing-context */
 export const BillingContext = createContext(undefined);
 export function BillingProvider({ children, productDefinitions: injectedProductDefinitions }) {
     // ── Self-resolve configuration from hooks ──
     const userOrgs = useUserOrgs();
     const appScope = useAppScopeSafe();
     const { appConfig, frontendProviderRegistry } = useApplication();
+    const resourceRegistry = useResourceRegistrySafe();
     const billingConfig = appConfig.billing;
-    const isEnabled = billingConfig?.enabled ?? false;
+    /** What the application CONFIGURED — see `isEnabled` below for why that is only half the answer. */
+    const isConfiguredEnabled = billingConfig?.enabled ?? false;
     const billingProvider = useMemo(() => {
         const configuredProviderRef = billingConfig?.providerRef;
         const configuredProvider = configuredProviderRef
@@ -94,14 +98,14 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
         const resolvedProvider = isBillingFrontendProvider(configuredProvider)
             ? configuredProvider
             : frontendProviderRegistry?.findByProviderCapabilityAndProtocol(BUILTIN_PROVIDER_CAPABILITY.BILLING, BUILTIN_PROVIDER_PROTOCOL.BILLING_PROVIDER) ?? null;
-        if (isEnabled && configuredProviderRef && resolvedProvider?.metadata.ref !== configuredProviderRef) {
+        if (isConfiguredEnabled && configuredProviderRef && resolvedProvider?.metadata.ref !== configuredProviderRef) {
             logDebug('Billing config providerRef does not match the hydrated frontend billing provider', {
                 configuredProviderRef,
                 resolvedProviderRef: resolvedProvider?.metadata.ref,
             });
         }
         return resolvedProvider;
-    }, [billingConfig?.providerRef, frontendProviderRegistry, isEnabled]);
+    }, [billingConfig?.providerRef, frontendProviderRegistry, isConfiguredEnabled]);
     // ── Self-resolve scope ──
     const enabledScopes = billingConfig?.enabledScopes ?? [ResourcePrimaryScope.ORGANIZATIONS];
     const { scopeType, scopeEntityId } = useMemo(() => {
@@ -115,6 +119,30 @@ export function BillingProvider({ children, productDefinitions: injectedProductD
     }, [enabledScopes, appScope?.currentOrganizationId, userOrgs.user?._id]);
     // ── Derive variant resource type for operations ──
     const billingAccountResourceType = scopeType ? SCOPE_TO_BILLING_ACCOUNT_RESOURCE[scopeType] : null;
+    /**
+     * Enabled means CONFIGURED **and** REACHABLE — the config flag alone was not enough.
+     *
+     * Every request this provider makes is an operation on a billing-account resource, so a consumer
+     * whose registry does not carry that resource cannot serve one no matter what the config says.
+     * That is not hypothetical: the application-creation workbench excludes the whole tenant
+     * vocabulary from its registry (it observes an application's creation and is not that
+     * application's admin console) while rendering the OBSERVED application's config, which has
+     * billing enabled — so it fired `organization-billing-accounts/get-state/count` at its own origin
+     * on every page load, where the companion serves no billing routes, and answered 404 every time
+     * (issue #268, reproduced live).
+     *
+     * Reading the registry rather than adding a second opt-out keeps the two halves from disagreeing:
+     * a consumer that excludes the resource has already said billing is not part of its surface, and
+     * saying it twice is how the two copies drift. A tenant application carries the resource and is
+     * unaffected.
+     */
+    const isEnabled = isConfiguredEnabled
+        && billingAccountResourceType !== null
+        // A registry that is ABSENT is ignorance, not a negative answer — only a registry that HAS been
+        // asked and says no disables billing. Blocking on the absent case instead disabled billing for
+        // every consumer that mounts this provider without a registry in context, which is what three
+        // of this file's own tests do and what caught the first version of this gate.
+        && (resourceRegistry === undefined || resourceRegistry.hasResource(billingAccountResourceType));
     // ── State ──
     const [billingState, setBillingState] = useState(null);
     const [isLoading, setIsLoading] = useState(isEnabled && !!scopeEntityId);

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

@@ -1 +1 @@
-{"version":3,"file":"BillingContext.js","sourceRoot":"","sources":["../../../../../src/core/billing/BillingContext.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAc,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAchG,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,EACzB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,2DAA2D,CAAC;AACzF,OAAO,EAAE,WAAW,EAAE,MAAM,+CAA+C,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,4CAA4C,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,wBAAwB,EAAE,MAAM,mFAAmF,CAAC;AAC7H,OAAO,EAAE,mBAAmB,EAAE,MAAM,sDAAsD,CAAC;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,iEAAiE,CAAC;AAE3G,mCAAmC;AACnC,SAAS;AACT,mCAAmC;AAEnC,MAAM,aAAa,GAA0B,qBAAqB,CAAC,SAAS,EAAE,CAAC;AAC/E,MAAM,QAAQ,GAAiE,aAAa,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAC3H,aAAa,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AAE3D,mCAAmC;AACnC,YAAY;AACZ,mCAAmC;AAEnC,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAEtC,+DAA+D;AAC/D,MAAM,mBAAmB,GAAG;IAC1B,kBAAkB,CAAC,sBAAsB;IACzC,kBAAkB,CAAC,4BAA4B;IAC/C,kBAAkB,CAAC,uBAAuB;IAC1C,kBAAkB,CAAC,qBAAqB;IACxC,kBAAkB,CAAC,2BAA2B;IAC9C,kBAAkB,CAAC,wBAAwB;CACnC,CAAC;AAEX,kGAAkG;AAClG,MAAM,iCAAiC,GAA2B;IAChE,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,gBAAgB,CAAC,6BAA6B;IACpF,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC,qBAAqB;CACzE,CAAC;AAEF,gFAAgF;AAChF,mDAAmD;AACnD,4EAA4E;AAC5E,iEAAiE;AACjE,2EAA2E;AAC3E,sFAAsF;AACtF,oFAAoF;AACpF,sEAAsE;AACtE,sEAAsE;AAEtE,yFAAyF;AACzF,MAAM,sBAAsB,GAAsD;IAChF,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,kBAAkB,EAAE,gDAAgD;IAC/H,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,UAAU,EAAE,wCAAwC;CAC5G,CAAC;AAEF,sFAAsF;AACtF,MAAM,0BAA0B,GAAgF;IAC9G,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,UAAU,kBAAkB,EAAE,kCAAkC,GAAG,gBAAgB;IACzI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,UAAU,UAAU,EAAE,0BAA0B,GAAG,gBAAgB;CACtH,CAAC;AAEF,kFAAkF;AAClF,MAAM,wBAAwB,GAAgF;IAC5G,CAAC,oBAAoB,CAAC,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,UAAU,kBAAkB,EAAE,kCAAkC,GAAG,cAAc;IACvI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,UAAU,UAAU,EAAE,0BAA0B,GAAG,cAAc;CACpH,CAAC;AAsEF,4BAA4B;AAC5B,MAAM,WAAW,GAAiB;IAChC,SAAS,EAAE,EAAE;CACd,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAkD,aAAa,CAAiC,SAAS,CAAC,CAAC;AAWtI,MAAM,UAAU,eAAe,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,0BAA0B,EAAwB;IAChH,8CAA8C;IAC9C,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,MAAM,EAAE,SAAS,EAAE,wBAAwB,EAAE,GAAG,cAAc,EAAE,CAAC;IACjE,MAAM,aAAa,GAAG,SAAS,CAAC,OAAO,CAAC;IACxC,MAAM,SAAS,GAAG,aAAa,EAAE,OAAO,IAAI,KAAK,CAAC;IAClD,MAAM,eAAe,GAAG,OAAO,CAAC,GAAG,EAAE;QACnC,MAAM,qBAAqB,GAAG,aAAa,EAAE,WAAW,CAAC;QAEzD,MAAM,kBAAkB,GAAG,qBAAqB;YAC9C,CAAC,CAAC,wBAAwB,EAAE,gBAAgB,CACxC,qBAA+C,CAChD;YACH,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,kBAAkB,CAAC;YACpE,CAAC,CAAC,kBAAkB;YACpB,CAAC,CAAC,wBAAwB,EAAE,mCAAmC,CAC3D,2BAA2B,CAAC,OAAO,EACnC,yBAAyB,CAAC,gBAAgB,CAC3C,IAAI,IAAI,CAAC;QAEd,IAAI,SAAS,IAAI,qBAAqB,IAAI,gBAAgB,EAAE,QAAQ,CAAC,GAAG,KAAK,qBAAqB,EAAE,CAAC;YACnG,QAAQ,CAAC,kFAAkF,EAAE;gBAC3F,qBAAqB;gBACrB,mBAAmB,EAAE,gBAAgB,EAAE,QAAQ,CAAC,GAAG;aACpD,CAAC,CAAC;QACL,CAAC;QAED,OAAO,gBAAgB,CAAC;IAC1B,CAAC,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,wBAAwB,EAAE,SAAS,CAAC,CAAC,CAAC;IAEtE,2BAA2B;IAC3B,MAAM,aAAa,GAAG,aAAa,EAAE,aAAa,IAAI,CAAC,oBAAoB,CAAC,aAAa,CAAC,CAAC;IAE3F,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QAChD,IAAI,aAAa,CAAC,QAAQ,CAAC,oBAAoB,CAAC,aAAa,CAAC,IAAI,QAAQ,EAAE,qBAAqB,EAAE,CAAC;YAClG,OAAO,EAAE,SAAS,EAAE,oBAAoB,CAAC,aAAqC,EAAE,aAAa,EAAE,QAAQ,CAAC,qBAAqB,EAAE,CAAC;QAClI,CAAC;QACD,IAAI,aAAa,CAAC,QAAQ,CAAC,oBAAoB,CAAC,SAAS,CAAC,IAAI,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC;YACjF,OAAO,EAAE,SAAS,EAAE,oBAAoB,CAAC,SAAiC,EAAE,aAAa,EAAE,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;QACjH,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,IAAmC,EAAE,aAAa,EAAE,IAAqB,EAAE,CAAC;IAClG,CAAC,EAAE,CAAC,aAAa,EAAE,QAAQ,EAAE,qBAAqB,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAEzE,oDAAoD;IACpD,MAAM,0BAA0B,GAAG,SAAS,CAAC,CAAC,CAAC,iCAAiC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEnG,cAAc;IACd,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAA8B,IAAI,CAAC,CAAC;IACpF,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAU,SAAS,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC;IAClF,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,yEAAyE;IACzE,+DAA+D;IAC/D,sFAAsF;IACtF,yEAAyE;IACzE,yEAAyE;IACzE,mBAAmB,CAAC;QAClB,UAAU,EAAE,wBAAwB,CAAC,aAAa;QAClD,SAAS;QACT,aAAa,EAAE,YAAY,KAAK,IAAI;KACrC,CAAC,CAAC;IAEH,kCAAkC;IAClC,MAAM,gBAAgB,GAAG,MAAM,CAAU,KAAK,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,MAAM,CAAU,IAAI,CAAC,CAAC;IACzC,MAAM,gBAAgB,GAAG,MAAM,CAAuC,IAAI,CAAC,CAAC;IAC5E,MAAM,mBAAmB,GAAG,MAAM,CAAU,KAAK,CAAC,CAAC;IAEnD,kBAAkB;IAClB,MAAM,EAAE,EAAE,EAAE,GAAG,YAAY,EAAE,CAAC;IAE9B,kCAAkC;IAClC,MAAM,oBAAoB,GAAG,OAAO,CAClC,GAAG,EAAE,CAAC,OAAO,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EACjE,EAAE,CACH,CAAC;IAEF,uCAAuC;IACvC,MAAM,gBAAgB,GAAG,YAAY,EAAE,cAAc,EAAE,GAAG,IAAI,IAAI,CAAC;IAEnE,0CAA0C;IAC1C,SAAS,CAAC,GAAG,EAAE;QACb,eAAe,CAAC,IAAI,CAAC,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,YAAY,CAAC,SAAS,IAAI,CAAC,CAAC,aAAa,CAAC,CAAC;IAC7C,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;IAE1C,yCAAyC;IACzC,MAAM,iBAAiB,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAC/C,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa;YAAE,OAAO;QACvD,IAAI,gBAAgB,CAAC,OAAO;YAAE,OAAO;QACrC,gBAAgB,CAAC,OAAO,GAAG,IAAI,CAAC;QAEhC,IAAI,CAAC;YACH,QAAQ,CAAC,wBAAwB,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,CAAC;YACjE,MAAM,UAAU,GAAG,wBAAwB,EAAE,CAAC;YAE9C,MAAM,UAAU,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC;YACrD,IAAI,CAAC,UAAU;gBAAE,OAAO;YACxB,MAAM,GAAG,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;YACtC,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,CAAuB,GAAG,CAAC,CAAC;YAEjE,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACvB,eAAe,CAAC;oBACd,cAAc,EAAE,QAAQ,CAAC,cAAc;oBACvC,YAAY,EAAE,QAAQ,CAAC,YAAY;oBACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE;oBACjC,MAAM,EAAE,QAAQ,CAAC,MAAM,IAAI,EAAE;oBAC7B,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE;oBACjC,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,WAAW;oBACpC,WAAW,EAAE,QAAQ,CAAC,WAAW,IAAI,EAAE;oBACvC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,IAAI,EAAE;oBACjD,SAAS,EAAE,QAAQ,CAAC,SAAS;iBAC9B,CAAC,CAAC;gBACH,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAEf,QAAQ,CAAC,uBAAuB,EAAE;oBAChC,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,cAAc;oBACrC,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,YAAY;oBACxC,YAAY,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;oBAC5C,UAAU,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAC;oBACxC,gBAAgB,EAAE,QAAQ,CAAC,cAAc,EAAE,GAAG;iBAC/C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACvB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B,CAAC;gBACrF,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC1D,QAAQ,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC;gBACvB,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,gBAAgB,CAAC,OAAO,GAAG,KAAK,CAAC;QACnC,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAE1C,sBAAsB;IACtB,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,IAAI,SAAS,IAAI,SAAS,IAAI,aAAa,EAAE,CAAC;YAC5C,iBAAiB,EAAE,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAE7D,2CAA2C;IAC3C,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,aAAa,GAAsB,EAAE,CAAC;QAE5C,MAAM,gBAAgB,GAAG,GAAG,EAAE;YAC5B,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBAC7B,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACzC,CAAC;YACD,gBAAgB,CAAC,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBACzC,gBAAgB,CAAC,OAAO,GAAG,IAAI,CAAC;gBAChC,iBAAiB,EAAE,CAAC;YACtB,CAAC,EAAE,GAAG,CAAC,CAAC;QACV,CAAC,CAAC;QAEF,KAAK,MAAM,KAAK,IAAI,mBAAmB,EAAE,CAAC;YACxC,MAAM,KAAK,GAAG,EAAE,CAAyB,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE;gBAC1D,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;oBACjC,QAAQ,CAAC,oDAAoD,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;oBACnF,OAAO;gBACT,CAAC;gBAED,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,CAAC,aAAa,KAAK,aAAa,EAAE,CAAC;oBAC/E,QAAQ,CAAC,iDAAiD,EAAE;wBAC1D,KAAK;wBACL,OAAO;wBACP,gBAAgB,EAAE,SAAS;wBAC3B,oBAAoB,EAAE,aAAa;qBACpC,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,IAAI,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,KAAK,gBAAgB,EAAE,CAAC;oBACtE,QAAQ,CAAC,2DAA2D,EAAE;wBACpE,KAAK;wBACL,OAAO;wBACP,uBAAuB,EAAE,gBAAgB;qBAC1C,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,QAAQ,CAAC,2DAA2D,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC1F,gBAAgB,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC;YACH,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QAED,OAAO,GAAG,EAAE;YACV,IAAI,gBAAgB,CAAC,OAAO,EAAE,CAAC;gBAC7B,YAAY,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;YACzC,CAAC;YACD,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;gBAClC,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,EAAE,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAEnF,sBAAsB;IACtB,MAAM,cAAc,GAAG,YAAY,EAAE,cAAc,IAAI,IAAI,CAAC;IAC5D,MAAM,YAAY,GAAG,YAAY,EAAE,YAAY,IAAI,IAAI,CAAC;IACxD,MAAM,QAAQ,GAAG,YAAY,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,YAAY,EAAE,MAAM,IAAI,EAAE,CAAC;IAC1C,MAAM,QAAQ,GAAG,YAAY,EAAE,QAAQ,IAAI,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,YAAY,EAAE,KAAK,IAAI,WAAW,CAAC;IACjD,MAAM,WAAW,GAAG,YAAY,EAAE,WAAW,IAAI,EAAE,CAAC;IACpD,MAAM,gBAAgB,GAAG,YAAY,EAAE,gBAAgB,IAAI,EAAE,CAAC;IAC9D,MAAM,YAAY,GAAG,SAAS,IAAI,IAAI,CAAC;IAEvC,gCAAgC;IAChC,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE;QACjC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmB,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;YACzB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEf,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,EAAE;QACrC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAmB,CAAC;QACvC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;YAChD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,MAAM,mBAAmB,GAAG,WAAW,CACrC,CAAC,SAAiB,EAAW,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,EACtE,CAAC,iBAAiB,CAAC,CACpB,CAAC;IAEF,MAAM,eAAe,GAAG,WAAW,CACjC,CAAC,GAAW,EAAuB,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,EAC5D,CAAC,aAAa,CAAC,CAChB,CAAC;IAEF,gCAAgC;IAChC,MAAM,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QAC1D,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,CAAC;YACjD,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;QAC5D,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7D,IAAI,OAAO,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACvC,OAAO,EAAE,cAAc,EAAE,OAAO,CAAC,GAAG,EAAE,kBAAkB,EAAE,OAAO,EAAE,CAAC;YACtE,CAAC;QACH,CAAC;QACD,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IAC5D,CAAC,EAAE,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;IAE7B,MAAM,kBAAkB,GAAG,OAAO,CAChC,GAAG,EAAE,CAAC,0BAA0B,IAAI,EAAE,EACtC,CAAC,0BAA0B,CAAC,CAC7B,CAAC;IAEF,gBAAgB;IAChB,MAAM,YAAY,GAAG,WAAW,CAC9B,KAAK,EAAE,UAAkB,EAAE,OAAe,EAAE,OAI3C,EAAiB,EAAE;QAClB,IAAI,CAAC,gBAAgB,IAAI,CAAC,0BAA0B,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;YACrF,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,WAAW,GAAG,0BAA0B,CAAC,SAAS,CAAC,EAAE,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;QAC7F,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,0CAA0C,SAAS,GAAG,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,mBAAmB,CAAC,OAAO,EAAE,CAAC;YAChC,QAAQ,CAAC,0DAA0D,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,mBAAmB,CAAC,OAAO,GAAG,IAAI,CAAC;QACnC,IAAI,CAAC;YACH,QAAQ,CAAC,0BAA0B,EAAE,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;YAC1E,MAAM,UAAU,GAAG,wBAAwB,EAAE,CAAC;YAE9C,wEAAwE;YACxE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,CACnC,WAAW,EACX;gBACE,UAAU;gBACV,OAAO;gBACP,UAAU,EAAE,GAAG,oBAAoB,mDAAmD;gBACtF,SAAS,EAAE,GAAG,oBAAoB,iBAAiB;gBACnD,QAAQ,EAAE,OAAO,EAAE,QAAQ;gBAC3B,aAAa,EAAE,OAAO,EAAE,aAAa;gBACrC,SAAS,EAAE,OAAO,EAAE,SAAS;aAC9B,CACF,CAAC;YAEF,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;gBACjB,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC;YACtC,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,mBAAmB,CAAC,OAAO,GAAG,KAAK,CAAC;QACtC,CAAC;IACH,CAAC,EACD,CAAC,gBAAgB,EAAE,0BAA0B,EAAE,SAAS,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAC/F,CAAC;IAEF,MAAM,kBAAkB,GAAG,WAAW,CAAC,KAAK,IAAmB,EAAE;QAC/D,IAAI,CAAC,gBAAgB,IAAI,CAAC,0BAA0B,IAAI,CAAC,SAAS,IAAI,CAAC,aAAa,EAAE,CAAC;YACrF,MAAM,IAAI,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,aAAa,GAAG,wBAAwB,CAAC,SAAS,CAAC,EAAE,CAAC,aAAa,EAAE,gBAAgB,CAAC,CAAC;QAC7F,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,wCAAwC,SAAS,GAAG,CAAC,CAAC;QACxE,CAAC;QAED,QAAQ,CAAC,iCAAiC,CAAC,CAAC;QAC5C,MAAM,UAAU,GAAG,wBAAwB,EAAE,CAAC;QAE9C,wEAAwE;QACxE,wEAAwE;QACxE,MAAM,SAAS,GAAG,kBAAkB,CAAC,GAAG,oBAAoB,UAAU,CAAC,CAAC;QACxE,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,GAAG,CACnC,GAAG,aAAa,cAAc,SAAS,EAAE,CAC1C,CAAC;QAEF,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;YACjB,MAAM,CAAC,QAAQ,CAAC,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC;QACtC,CAAC;IACH,CAAC,EAAE,CAAC,gBAAgB,EAAE,0BAA0B,EAAE,SAAS,EAAE,aAAa,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAEnG,sDAAsD;IACtD,MAAM,YAAY,GAAuB,OAAO,CAC9C,GAAG,EAAE,CAAC,CAAC;QACL,SAAS;QACT,oBAAoB,EAAE,aAAa;QACnC,eAAe;QACf,cAAc;QACd,YAAY;QACZ,cAAc;QACd,kBAAkB;QAClB,YAAY;QACZ,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,kBAAkB;QAClB,mBAAmB;QACnB,eAAe;QACf,gBAAgB;QAChB,KAAK;QACL,WAAW;QACX,YAAY;QACZ,kBAAkB;QAClB,SAAS;QACT,KAAK;QACL,OAAO,EAAE,iBAAiB;KAC3B,CAAC,EACF;QACE,SAAS;QACT,aAAa;QACb,eAAe;QACf,cAAc;QACd,YAAY;QACZ,cAAc;QACd,kBAAkB;QAClB,YAAY;QACZ,QAAQ;QACR,MAAM;QACN,QAAQ;QACR,kBAAkB;QAClB,mBAAmB;QACnB,eAAe;QACf,gBAAgB;QAChB,KAAK;QACL,WAAW;QACX,YAAY;QACZ,kBAAkB;QAClB,SAAS;QACT,KAAK;QACL,iBAAiB;KAClB,CACF,CAAC;IAEF,OAAO,CACL,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,YAAY,YACzC,QAAQ,GACe,CAC3B,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,QAA+C;IAE/C,OAAO,CAAC,CAAC,QAAQ;WACZ,QAAQ,CAAC,oBAAoB,CAAC,QAAQ,CAAC,2BAA2B,CAAC,OAAO,CAAC;WAC3E,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,yBAAyB,CAAC,gBAAgB,CAAC,CAAC;AAC/E,CAAC","sourcesContent":["/**\n * BillingContext\n *\n * Central context for billing operations on the frontend.\n *\n * Responsibilities:\n * - Self-resolves scope (org/user) from AppScope + user context — no external props needed\n * - Fetches billing state via the GET_STATE resource operation on the billing account\n * - The backend auto-creates the billing account if one doesn't exist\n * - Provides actions: openCheckout, openCustomerPortal (via resource operations)\n * - Caches billing state and invalidates on WebSocket events\n * - Exposes convenience accessors for current plan, subscription status, etc.\n *\n * DELEGATION PRINCIPLE: The frontend does NOT build payment UI.\n * - Stripe Checkout (hosted page): for new subscriptions and upgrades\n * - Stripe Customer Portal (hosted page): for invoices, payment methods, cancellation\n */\n\nimport React, { createContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';\nimport type {\n  BillingAccount,\n  BillingSubscriptionBase,\n  Product,\n  Price,\n  Promotion,\n  InvoiceRef,\n  UsageSummary,\n  BillingConfiguration,\n  ProductDefinition,\n  BillingStateResponse,\n  WS_BillingEventPayload,\n} from '@wildo-ai/saas-models';\nimport {\n  BUILTIN_PROVIDER_CAPABILITY,\n  BUILTIN_PROVIDER_PROTOCOL,\n  CoreWebSocketEvent,\n  CoreResourceType,\n  ResourcePrimaryScope,\n  MAIN_API_BASE_PATH,\n} from '@wildo-ai/saas-models';\nimport type { FrontendAppProviderModule, FrontendAppProviderRef } from '@wildo-ai/external-connectors-public/app';\nimport { useWebSocket } from '~wildo-frontend-lib/core/requests/websockets/useWebSocket';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { 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\nexport interface BillingContextType {\n  // ── Configuration ──\n  isEnabled: boolean;\n  billingConfiguration: BillingConfiguration | undefined;\n  billingProvider: FrontendAppProviderModule | null;\n\n  // ── Billing State ──\n  billingAccount: BillingAccount | null;\n  subscription: BillingSubscriptionBase | null;\n  currentPlanKey: string | null;\n  currentPlanProduct: Product | null;\n\n  // ── Product Catalog ──\n  products: Product[];\n  prices: Price[];\n  productDefinitions: ProductDefinition[];\n  getPricesForProduct: (productId: string) => Price[];\n  getProductByKey: (key: string) => Product | undefined;\n\n  // ── Scope ──\n  currentScope: ResourcePrimaryScope | null;\n\n  // ── Invoices ──\n  invoices: InvoiceRef[];\n\n  // ── Promotions ──\n  activePromotions: Promotion[];\n\n  // ── Usage & Credits ──\n  usage: UsageSummary;\n  creditPools: Record<string, { available: number; totalPurchased: number; totalConsumed: number }>;\n\n  // ── Actions ──\n  openCheckout: (productKey: string, priceId: string, options?: {\n    quantity?: number;\n    promotionCode?: string;\n    trialDays?: number;\n  }) => Promise<void>;\n\n  openCustomerPortal: () => Promise<void>;\n\n  // ── State ──\n  isLoading: boolean;\n  error: Error | null;\n\n  // ── Actions ──\n  refetch: () => void;\n}\n\n// ── Default empty state ──\nconst EMPTY_USAGE: UsageSummary = {\n  byProduct: {},\n};\n\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 billingConfig = appConfig.billing;\n  const isEnabled = 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 (isEnabled && 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, isEnabled]);\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  // ── State ──\n  const [billingState, setBillingState] = useState<BillingStateResponse | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(isEnabled && !!scopeEntityId);\n  const [error, setError] = useState<Error | null>(null);\n\n  // L-2.b: mirror local loading state onto the LoadingContext event bus so\n  // unrelated components can observe billing-state lifecycle via\n  // `useComponentLoading({ customIdentifier: ContextLoadingIdentifier.BILLING_STATE })`\n  // or `<LoadingGate scopes={[buildContextLoadingScope(BILLING_STATE)]}>`.\n  // Local `isLoading` is still exposed for direct consumers (back-compat).\n  useEmitLoadingScope({\n    identifier: ContextLoadingIdentifier.BILLING_STATE,\n    isLoading,\n    hasLoadedOnce: billingState !== null,\n  });\n\n  // ── Refs for stable callbacks ──\n  const fetchInFlightRef = useRef<boolean>(false);\n  const mountedRef = useRef<boolean>(true);\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const checkoutInFlightRef = useRef<boolean>(false);\n\n  // ── WebSocket ──\n  const { on } = useWebSocket();\n\n  // ── Resolve redirect base URL ──\n  const resolvedRedirectBase = useMemo(\n    () => typeof window !== 'undefined' ? window.location.origin : '',\n    [],\n  );\n\n  // ── billingAccountId from response ──\n  const billingAccountId = billingState?.billingAccount?._id ?? null;\n\n  // ── Clear stale state on scope change ──\n  useEffect(() => {\n    setBillingState(null);\n    setError(null);\n    setIsLoading(isEnabled && !!scopeEntityId);\n  }, [scopeType, scopeEntityId, isEnabled]);\n\n  // ── Fetch billing state from backend ──\n  const fetchBillingState = useCallback(async () => {\n    if (!isEnabled || !scopeType || !scopeEntityId) return;\n    if (fetchInFlightRef.current) return;\n    fetchInFlightRef.current = true;\n\n    try {\n      logDebug('Fetching billing state', { scopeType, scopeEntityId });\n      const httpClient = getManualCallsHttpClient();\n\n      const urlBuilder = SCOPE_TO_GET_STATE_URL[scopeType];\n      if (!urlBuilder) return;\n      const url = urlBuilder(scopeEntityId);\n      const response = await httpClient.get<BillingStateResponse>(url);\n\n      if (mountedRef.current) {\n        setBillingState({\n          billingAccount: response.billingAccount,\n          subscription: response.subscription,\n          products: response.products ?? [],\n          prices: response.prices ?? [],\n          invoices: response.invoices ?? [],\n          usage: response.usage ?? EMPTY_USAGE,\n          creditPools: response.creditPools ?? {},\n          activePromotions: response.activePromotions ?? [],\n          scopeType: response.scopeType,\n        });\n        setError(null);\n\n        logDebug('Billing state fetched', {\n          hasAccount: !!response.billingAccount,\n          hasSubscription: !!response.subscription,\n          productCount: response.products?.length ?? 0,\n          priceCount: response.prices?.length ?? 0,\n          billingAccountId: response.billingAccount?._id,\n        });\n      }\n    } catch (err: unknown) {\n      if (mountedRef.current) {\n        const message = err instanceof Error ? err.message : 'Failed to fetch billing state';\n        setError(err instanceof Error ? err : new Error(message));\n        logDebug('Failed to fetch billing state', { error: message });\n      }\n    } finally {\n      if (mountedRef.current) {\n        setIsLoading(false);\n      }\n      fetchInFlightRef.current = false;\n    }\n  }, [isEnabled, scopeType, scopeEntityId]);\n\n  // ── Initial fetch ──\n  useEffect(() => {\n    mountedRef.current = true;\n    if (isEnabled && scopeType && scopeEntityId) {\n      fetchBillingState();\n    } else {\n      setIsLoading(false);\n    }\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [fetchBillingState, isEnabled, scopeType, scopeEntityId]);\n\n  // ── WebSocket invalidation (debounced) ──\n  useEffect(() => {\n    if (!isEnabled) return;\n\n    const unsubscribers: Array<() => void> = [];\n\n    const debouncedRefetch = () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = null;\n        fetchBillingState();\n      }, 300);\n    };\n\n    for (const event of INVALIDATION_EVENTS) {\n      const unsub = on<WS_BillingEventPayload>(event, (payload) => {\n        if (!scopeType || !scopeEntityId) {\n          logDebug('Ignoring billing invalidation without active scope', { event, payload });\n          return;\n        }\n\n        if (payload.scopeType !== scopeType || payload.scopeEntityId !== scopeEntityId) {\n          logDebug('Ignoring billing invalidation for another scope', {\n            event,\n            payload,\n            currentScopeType: scopeType,\n            currentScopeEntityId: scopeEntityId,\n          });\n          return;\n        }\n\n        if (billingAccountId && payload.billingAccountId !== billingAccountId) {\n          logDebug('Ignoring billing invalidation for another billing account', {\n            event,\n            payload,\n            currentBillingAccountId: billingAccountId,\n          });\n          return;\n        }\n\n        logDebug('WebSocket invalidation event received, scheduling refetch', { event, payload });\n        debouncedRefetch();\n      });\n      unsubscribers.push(unsub);\n    }\n\n    return () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      for (const unsub of unsubscribers) {\n        unsub();\n      }\n    };\n  }, [on, fetchBillingState, isEnabled, scopeType, scopeEntityId, billingAccountId]);\n\n  // ── Derived state ──\n  const billingAccount = billingState?.billingAccount ?? null;\n  const subscription = billingState?.subscription ?? null;\n  const products = billingState?.products ?? [];\n  const prices = billingState?.prices ?? [];\n  const invoices = billingState?.invoices ?? [];\n  const usage = billingState?.usage ?? EMPTY_USAGE;\n  const creditPools = billingState?.creditPools ?? {};\n  const activePromotions = billingState?.activePromotions ?? [];\n  const currentScope = scopeType ?? null;\n\n  // ── Product catalog lookups ──\n  const productsByKey = useMemo(() => {\n    const map = new Map<string, Product>();\n    for (const p of products) {\n      map.set(p.key, p);\n    }\n    return map;\n  }, [products]);\n\n  const pricesByProductId = useMemo(() => {\n    const map = new Map<string, Price[]>();\n    for (const price of prices) {\n      const existing = map.get(price.productId) ?? [];\n      existing.push(price);\n      map.set(price.productId, existing);\n    }\n    return map;\n  }, [prices]);\n\n  const getPricesForProduct = useCallback(\n    (productId: string): Price[] => pricesByProductId.get(productId) ?? [],\n    [pricesByProductId],\n  );\n\n  const getProductByKey = useCallback(\n    (key: string): Product | undefined => productsByKey.get(key),\n    [productsByKey],\n  );\n\n  // ── Current plan derivation ──\n  const { currentPlanKey, currentPlanProduct } = useMemo(() => {\n    if (!subscription || !subscription.items?.length) {\n      return { currentPlanKey: null, currentPlanProduct: null };\n    }\n    for (const item of subscription.items) {\n      const product = products.find(p => p._id === item.productId);\n      if (product && product.type === 'plan') {\n        return { currentPlanKey: product.key, currentPlanProduct: product };\n      }\n    }\n    return { currentPlanKey: null, currentPlanProduct: null };\n  }, [subscription, products]);\n\n  const productDefinitions = useMemo<ProductDefinition[]>(\n    () => injectedProductDefinitions ?? [],\n    [injectedProductDefinitions],\n  );\n\n  // ── Actions ──\n  const openCheckout = useCallback(\n    async (productKey: string, priceId: string, options?: {\n      quantity?: number;\n      promotionCode?: string;\n      trialDays?: number;\n    }): Promise<void> => {\n      if (!billingAccountId || !billingAccountResourceType || !scopeType || !scopeEntityId) {\n        throw new Error('No billing account available. Cannot open checkout.');\n      }\n      const checkoutUrl = SCOPE_TO_OPEN_CHECKOUT_URL[scopeType]?.(scopeEntityId, billingAccountId);\n      if (!checkoutUrl) {\n        throw new Error(`No OPEN_CHECKOUT URL builder for scope ${scopeType}.`);\n      }\n      if (checkoutInFlightRef.current) {\n        logDebug('Checkout already in progress, ignoring duplicate request');\n        return;\n      }\n\n      checkoutInFlightRef.current = true;\n      try {\n        logDebug('Opening checkout session', { productKey, priceId, ...options });\n        const httpClient = getManualCallsHttpClient();\n\n        // OPEN_CHECKOUT borrows UPDATE → keyed PUT on the scoped account route.\n        const response = await httpClient.put<CheckoutSessionResponse>(\n          checkoutUrl,\n          {\n            productKey,\n            priceId,\n            successUrl: `${resolvedRedirectBase}/billing/success?session_id={CHECKOUT_SESSION_ID}`,\n            cancelUrl: `${resolvedRedirectBase}/billing/cancel`,\n            quantity: options?.quantity,\n            promotionCode: options?.promotionCode,\n            trialDays: options?.trialDays,\n          },\n        );\n\n        if (response.url) {\n          window.location.href = response.url;\n        }\n      } finally {\n        checkoutInFlightRef.current = false;\n      }\n    },\n    [billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, resolvedRedirectBase],\n  );\n\n  const openCustomerPortal = useCallback(async (): Promise<void> => {\n    if (!billingAccountId || !billingAccountResourceType || !scopeType || !scopeEntityId) {\n      throw new Error('No billing account available. Cannot open customer portal.');\n    }\n    const portalUrlBase = SCOPE_TO_OPEN_PORTAL_URL[scopeType]?.(scopeEntityId, billingAccountId);\n    if (!portalUrlBase) {\n      throw new Error(`No OPEN_PORTAL URL builder for scope ${scopeType}.`);\n    }\n\n    logDebug('Opening customer portal session');\n    const httpClient = getManualCallsHttpClient();\n\n    // OPEN_PORTAL borrows READ → keyed GET on the scoped account route; the\n    // returnUrl travels as a query param since GET carries no request body.\n    const returnUrl = encodeURIComponent(`${resolvedRedirectBase}/billing`);\n    const response = await httpClient.get<PortalSessionResponse>(\n      `${portalUrlBase}?returnUrl=${returnUrl}`,\n    );\n\n    if (response.url) {\n      window.location.href = response.url;\n    }\n  }, [billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, resolvedRedirectBase]);\n\n  // ── Context value (memoized for stable reference) ──\n  const contextValue: BillingContextType = useMemo(\n    () => ({\n      isEnabled,\n      billingConfiguration: billingConfig,\n      billingProvider,\n      billingAccount,\n      subscription,\n      currentPlanKey,\n      currentPlanProduct,\n      currentScope,\n      products,\n      prices,\n      invoices,\n      productDefinitions,\n      getPricesForProduct,\n      getProductByKey,\n      activePromotions,\n      usage,\n      creditPools,\n      openCheckout,\n      openCustomerPortal,\n      isLoading,\n      error,\n      refetch: fetchBillingState,\n    }),\n    [\n      isEnabled,\n      billingConfig,\n      billingProvider,\n      billingAccount,\n      subscription,\n      currentPlanKey,\n      currentPlanProduct,\n      currentScope,\n      products,\n      prices,\n      invoices,\n      productDefinitions,\n      getPricesForProduct,\n      getProductByKey,\n      activePromotions,\n      usage,\n      creditPools,\n      openCheckout,\n      openCustomerPortal,\n      isLoading,\n      error,\n      fetchBillingState,\n    ],\n  );\n\n  return (\n    <BillingContext.Provider value={contextValue}>\n      {children}\n    </BillingContext.Provider>\n  );\n}\n\nfunction isBillingFrontendProvider(\n  provider: FrontendAppProviderModule | undefined,\n): provider is FrontendAppProviderModule {\n  return !!provider\n    && provider.providerCapabilities.includes(BUILTIN_PROVIDER_CAPABILITY.BILLING)\n    && provider.protocols.includes(BUILTIN_PROVIDER_PROTOCOL.BILLING_PROVIDER);\n}\n"]}
+{"version":3,"file":"BillingContext.js","sourceRoot":"","sources":["../../../../src/core/billing/BillingContext.tsx"],"names":[],"mappings":"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","sourcesContent":["/**\n * BillingContext\n *\n * Central context for billing operations on the frontend.\n *\n * Responsibilities:\n * - Self-resolves scope (org/user) from AppScope + user context — no external props needed\n * - Fetches billing state via the GET_STATE resource operation on the billing account\n * - The backend auto-creates the billing account if one doesn't exist\n * - Provides actions: openCheckout, openCustomerPortal (via resource operations)\n * - Caches billing state and invalidates on WebSocket events\n * - Exposes convenience accessors for current plan, subscription status, etc.\n *\n * DELEGATION PRINCIPLE: The frontend does NOT build payment UI.\n * - Stripe Checkout (hosted page): for new subscriptions and upgrades\n * - Stripe Customer Portal (hosted page): for invoices, payment methods, cancellation\n */\n\nimport React, { createContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';\nimport type {\n  BillingAccount,\n  BillingSubscriptionBase,\n  Product,\n  Price,\n  Promotion,\n  InvoiceRef,\n  UsageSummary,\n  BillingConfiguration,\n  ProductDefinition,\n  BillingStateResponse,\n  WS_BillingEventPayload,\n} from '@wildo-ai/saas-models';\nimport {\n  BUILTIN_PROVIDER_CAPABILITY,\n  BUILTIN_PROVIDER_PROTOCOL,\n  CoreWebSocketEvent,\n  CoreResourceType,\n  ResourcePrimaryScope,\n  MAIN_API_BASE_PATH,\n} from '@wildo-ai/saas-models';\nimport type { FrontendAppProviderModule, FrontendAppProviderRef } from '@wildo-ai/external-connectors-public/app';\nimport { useWebSocket } from '~wildo-frontend-lib/core/requests/websockets/useWebSocket';\nimport { useUserOrgs } from '~wildo-frontend-lib/core/security/useUserOrgs';\nimport { useAppScopeSafe } from '~wildo-frontend-lib/core/scope/useAppScope';\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useResourceRegistrySafe } from '~wildo-frontend-lib/core/resources/useResourceRegistry';\nimport { LoggerFrontendService } from '~wildo-frontend-lib/core/monitoring/logger.frontend.service';\nimport { getManualCallsHttpClient } from '~wildo-frontend-lib/core/requests/wildo-http-client-manual-calls.frontend.service';\nimport { useEmitLoadingScope } from '~wildo-frontend-lib/core/loading/useEmitLoadingScope';\nimport { ContextLoadingIdentifier } from '~wildo-frontend-lib/core/loading/loading-types.frontend.schemas';\n\n// ================================\n// Logger\n// ================================\n\nconst billingLogger: LoggerFrontendService = LoggerFrontendService.getLogger();\nconst logDebug: (message: string, context?: Record<string, unknown>) => void = billingLogger.debugByType('BillingContext');\nbillingLogger.setDebugTypeLogging('BillingContext', false);\n\n// ================================\n// Constants\n// ================================\n\nconst API_PREFIX = MAIN_API_BASE_PATH;\n\n/** WebSocket events that trigger a refetch of billing state */\nconst INVALIDATION_EVENTS = [\n  CoreWebSocketEvent.BILLING_STATUS_CHANGED,\n  CoreWebSocketEvent.BILLING_SUBSCRIPTION_UPDATED,\n  CoreWebSocketEvent.BILLING_ACCOUNT_CHANGED,\n  CoreWebSocketEvent.BILLING_USAGE_UPDATED,\n  CoreWebSocketEvent.BILLING_CREDIT_POOL_UPDATED,\n  CoreWebSocketEvent.BILLING_FEATURES_UPDATED,\n] as const;\n\n/** Maps ResourcePrimaryScope → billing account variant resource type (for resource operations) */\nconst SCOPE_TO_BILLING_ACCOUNT_RESOURCE: Record<string, string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS,\n  [ResourcePrimaryScope.USER_SELF]: CoreResourceType.USER_BILLING_ACCOUNTS,\n};\n\n// The billing-account GET_STATE / OPEN_CHECKOUT / OPEN_PORTAL custom operations\n// borrow COUNT / UPDATE / READ core semantics (see\n// `billing-account.shared.resources-config.schemas.ts`), so their canonical\n// routes follow the framework's scoped resource-operation shape:\n//   GET_STATE      (COUNT-like) → GET  /<scope>/{id}/<res>/get-state/count\n//   OPEN_CHECKOUT  (UPDATE-like) → PUT  /<scope>/{id}/<res>/{accountId}/open-checkout\n//   OPEN_PORTAL    (READ-like)   → GET  /<scope>/{id}/<res>/{accountId}/open-portal\n// Built here to mirror the routes the backend registers from the same\n// resources-config; the prior `/operations/open_checkout` POST 404'd.\n\n/** Maps ResourcePrimaryScope → GET_STATE URL builder (COUNT-like → trailing `/count`) */\nconst SCOPE_TO_GET_STATE_URL: Record<string, (scopeEntityId: string) => string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: (id) => `${API_PREFIX}/organizations/${id}/organization-billing-accounts/get-state/count`,\n  [ResourcePrimaryScope.USER_SELF]: (id) => `${API_PREFIX}/users/${id}/user-billing-accounts/get-state/count`,\n};\n\n/** Maps ResourcePrimaryScope → OPEN_CHECKOUT URL builder (UPDATE-like → keyed PUT) */\nconst SCOPE_TO_OPEN_CHECKOUT_URL: Record<string, (scopeEntityId: string, billingAccountId: string) => string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: (id, acc) => `${API_PREFIX}/organizations/${id}/organization-billing-accounts/${acc}/open-checkout`,\n  [ResourcePrimaryScope.USER_SELF]: (id, acc) => `${API_PREFIX}/users/${id}/user-billing-accounts/${acc}/open-checkout`,\n};\n\n/** Maps ResourcePrimaryScope → OPEN_PORTAL URL builder (READ-like → keyed GET) */\nconst SCOPE_TO_OPEN_PORTAL_URL: Record<string, (scopeEntityId: string, billingAccountId: string) => string> = {\n  [ResourcePrimaryScope.ORGANIZATIONS]: (id, acc) => `${API_PREFIX}/organizations/${id}/organization-billing-accounts/${acc}/open-portal`,\n  [ResourcePrimaryScope.USER_SELF]: (id, acc) => `${API_PREFIX}/users/${id}/user-billing-accounts/${acc}/open-portal`,\n};\n\n// ================================\n// API Response Types\n// ================================\n\n/** Response from PUT /<scope>/{id}/<billing-accounts>/{accountId}/open-checkout (OPEN_CHECKOUT) */\ninterface CheckoutSessionResponse {\n  url: string;\n  sessionId: string;\n}\n\n/** Response from GET /<scope>/{id}/<billing-accounts>/{accountId}/open-portal (OPEN_PORTAL) */\ninterface PortalSessionResponse {\n  url: string;\n}\n\n// ================================\n// Context Type\n// ================================\n\n/**\n * @wildo_source:part:start saas.frontend.billing-context facet:layer:frontend facet:audience:app-developer\n *\n * Everything an application's own frontend reads or does about billing. Reached with `useBilling()`,\n * which throws outside a `BillingProvider`; `useBillingSafe()` returns `undefined` instead, for a\n * component that may render before the provider mounts or in an application where billing is off.\n *\n * The shipped billing components and the feature-gating hooks read this same context, so an\n * application composing its own purchase flow works from exactly what they do — no application code\n * builds the request.\n *\n * ## Starting a purchase\n *\n * `openCheckout(productKey, priceId, options)` posts to the scoped billing-account route and follows\n * the returned URL; success and cancel destinations come from the application's own redirect base. A\n * SECOND call while one is in flight is IGNORED, so a double-click cannot open two sessions — do not\n * add your own guard expecting otherwise, and do not read the silence as a failure.\n *\n * The `priceId` must belong to the product named by `productKey`; the checkout operation refuses a\n * mismatched pair. Resolve it through `getPricesForProduct` rather than assuming an ordering.\n *\n * `openCustomerPortal()` opens the provider's own portal — which is where payment methods, card\n * updates and receipt downloads live. Those are deliberately NOT rendered by the framework, so an\n * application that needs them links the portal rather than building them.\n *\n * ## What `usage` contains\n *\n * Metered consumption appears here only if the application RECORDS it. Nothing is automatic: a\n * metered product with no recorded usage shows an empty dashboard rather than an error.\n *\n * ## Invoices are capped\n *\n * `invoices` carries the fifty most recent, which is what the shipped history component renders. An\n * application needing more reads the invoices resource directly.\n */\nexport interface BillingContextType {\n  // ── Configuration ──\n  isEnabled: boolean;\n  billingConfiguration: BillingConfiguration | undefined;\n  billingProvider: FrontendAppProviderModule | null;\n\n  // ── Billing State ──\n  billingAccount: BillingAccount | null;\n  subscription: BillingSubscriptionBase | null;\n  currentPlanKey: string | null;\n  currentPlanProduct: Product | null;\n\n  // ── Product Catalog ──\n  products: Product[];\n  prices: Price[];\n  productDefinitions: ProductDefinition[];\n  getPricesForProduct: (productId: string) => Price[];\n  getProductByKey: (key: string) => Product | undefined;\n\n  // ── Scope ──\n  currentScope: ResourcePrimaryScope | null;\n\n  // ── Invoices ──\n  invoices: InvoiceRef[];\n\n  // ── Promotions ──\n  activePromotions: Promotion[];\n\n  // ── Usage & Credits ──\n  usage: UsageSummary;\n  creditPools: Record<string, { available: number; totalPurchased: number; totalConsumed: number }>;\n\n  // ── Actions ──\n  openCheckout: (productKey: string, priceId: string, options?: {\n    quantity?: number;\n    promotionCode?: string;\n    trialDays?: number;\n  }) => Promise<void>;\n\n  openCustomerPortal: () => Promise<void>;\n\n  // ── State ──\n  isLoading: boolean;\n  error: Error | null;\n\n  // ── Actions ──\n  refetch: () => void;\n}\n\n// ── Default empty state ──\nconst EMPTY_USAGE: UsageSummary = {\n  byProduct: {},\n};\n\n/** @wildo_source:part:end saas.frontend.billing-context */\n\nexport const BillingContext: React.Context<BillingContextType | undefined> = createContext<BillingContextType | undefined>(undefined);\n\n// ================================\n// Provider\n// ================================\n\nexport interface BillingProviderProps {\n  children: React.ReactNode;\n  productDefinitions?: ProductDefinition[];\n}\n\nexport function BillingProvider({ children, productDefinitions: injectedProductDefinitions }: BillingProviderProps): React.ReactElement {\n  // ── Self-resolve configuration from hooks ──\n  const userOrgs = useUserOrgs();\n  const appScope = useAppScopeSafe();\n  const { appConfig, frontendProviderRegistry } = useApplication();\n  const resourceRegistry = useResourceRegistrySafe();\n  const billingConfig = appConfig.billing;\n  /** What the application CONFIGURED — see `isEnabled` below for why that is only half the answer. */\n  const isConfiguredEnabled = billingConfig?.enabled ?? false;\n  const billingProvider = useMemo(() => {\n    const configuredProviderRef = billingConfig?.providerRef;\n\n    const configuredProvider = configuredProviderRef\n      ? frontendProviderRegistry?.getProviderByRef(\n          configuredProviderRef as FrontendAppProviderRef,\n        )\n      : undefined;\n\n    const resolvedProvider = isBillingFrontendProvider(configuredProvider)\n      ? configuredProvider\n      : frontendProviderRegistry?.findByProviderCapabilityAndProtocol(\n          BUILTIN_PROVIDER_CAPABILITY.BILLING,\n          BUILTIN_PROVIDER_PROTOCOL.BILLING_PROVIDER,\n        ) ?? null;\n\n    if (isConfiguredEnabled && configuredProviderRef && resolvedProvider?.metadata.ref !== configuredProviderRef) {\n      logDebug('Billing config providerRef does not match the hydrated frontend billing provider', {\n        configuredProviderRef,\n        resolvedProviderRef: resolvedProvider?.metadata.ref,\n      });\n    }\n\n    return resolvedProvider;\n  }, [billingConfig?.providerRef, frontendProviderRegistry, isConfiguredEnabled]);\n\n  // ── Self-resolve scope ──\n  const enabledScopes = billingConfig?.enabledScopes ?? [ResourcePrimaryScope.ORGANIZATIONS];\n\n  const { scopeType, scopeEntityId } = useMemo(() => {\n    if (enabledScopes.includes(ResourcePrimaryScope.ORGANIZATIONS) && appScope?.currentOrganizationId) {\n      return { scopeType: ResourcePrimaryScope.ORGANIZATIONS as ResourcePrimaryScope, scopeEntityId: appScope.currentOrganizationId };\n    }\n    if (enabledScopes.includes(ResourcePrimaryScope.USER_SELF) && userOrgs.user?._id) {\n      return { scopeType: ResourcePrimaryScope.USER_SELF as ResourcePrimaryScope, scopeEntityId: userOrgs.user._id };\n    }\n    return { scopeType: null as ResourcePrimaryScope | null, scopeEntityId: null as string | null };\n  }, [enabledScopes, appScope?.currentOrganizationId, userOrgs.user?._id]);\n\n  // ── Derive variant resource type for operations ──\n  const billingAccountResourceType = scopeType ? SCOPE_TO_BILLING_ACCOUNT_RESOURCE[scopeType] : null;\n\n  /**\n   * Enabled means CONFIGURED **and** REACHABLE — the config flag alone was not enough.\n   *\n   * Every request this provider makes is an operation on a billing-account resource, so a consumer\n   * whose registry does not carry that resource cannot serve one no matter what the config says.\n   * That is not hypothetical: the application-creation workbench excludes the whole tenant\n   * vocabulary from its registry (it observes an application's creation and is not that\n   * application's admin console) while rendering the OBSERVED application's config, which has\n   * billing enabled — so it fired `organization-billing-accounts/get-state/count` at its own origin\n   * on every page load, where the companion serves no billing routes, and answered 404 every time\n   * (issue #268, reproduced live).\n   *\n   * Reading the registry rather than adding a second opt-out keeps the two halves from disagreeing:\n   * a consumer that excludes the resource has already said billing is not part of its surface, and\n   * saying it twice is how the two copies drift. A tenant application carries the resource and is\n   * unaffected.\n   */\n  const isEnabled = isConfiguredEnabled\n    && billingAccountResourceType !== null\n    // A registry that is ABSENT is ignorance, not a negative answer — only a registry that HAS been\n    // asked and says no disables billing. Blocking on the absent case instead disabled billing for\n    // every consumer that mounts this provider without a registry in context, which is what three\n    // of this file's own tests do and what caught the first version of this gate.\n    && (resourceRegistry === undefined || resourceRegistry.hasResource(billingAccountResourceType));\n\n  // ── State ──\n  const [billingState, setBillingState] = useState<BillingStateResponse | null>(null);\n  const [isLoading, setIsLoading] = useState<boolean>(isEnabled && !!scopeEntityId);\n  const [error, setError] = useState<Error | null>(null);\n\n  // L-2.b: mirror local loading state onto the LoadingContext event bus so\n  // unrelated components can observe billing-state lifecycle via\n  // `useComponentLoading({ customIdentifier: ContextLoadingIdentifier.BILLING_STATE })`\n  // or `<LoadingGate scopes={[buildContextLoadingScope(BILLING_STATE)]}>`.\n  // Local `isLoading` is still exposed for direct consumers (back-compat).\n  useEmitLoadingScope({\n    identifier: ContextLoadingIdentifier.BILLING_STATE,\n    isLoading,\n    hasLoadedOnce: billingState !== null,\n  });\n\n  // ── Refs for stable callbacks ──\n  const fetchInFlightRef = useRef<boolean>(false);\n  const mountedRef = useRef<boolean>(true);\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n  const checkoutInFlightRef = useRef<boolean>(false);\n\n  // ── WebSocket ──\n  const { on } = useWebSocket();\n\n  // ── Resolve redirect base URL ──\n  const resolvedRedirectBase = useMemo(\n    () => typeof window !== 'undefined' ? window.location.origin : '',\n    [],\n  );\n\n  // ── billingAccountId from response ──\n  const billingAccountId = billingState?.billingAccount?._id ?? null;\n\n  // ── Clear stale state on scope change ──\n  useEffect(() => {\n    setBillingState(null);\n    setError(null);\n    setIsLoading(isEnabled && !!scopeEntityId);\n  }, [scopeType, scopeEntityId, isEnabled]);\n\n  // ── Fetch billing state from backend ──\n  const fetchBillingState = useCallback(async () => {\n    if (!isEnabled || !scopeType || !scopeEntityId) return;\n    if (fetchInFlightRef.current) return;\n    fetchInFlightRef.current = true;\n\n    try {\n      logDebug('Fetching billing state', { scopeType, scopeEntityId });\n      const httpClient = getManualCallsHttpClient();\n\n      const urlBuilder = SCOPE_TO_GET_STATE_URL[scopeType];\n      if (!urlBuilder) return;\n      const url = urlBuilder(scopeEntityId);\n      const response = await httpClient.get<BillingStateResponse>(url);\n\n      if (mountedRef.current) {\n        setBillingState({\n          billingAccount: response.billingAccount,\n          subscription: response.subscription,\n          products: response.products ?? [],\n          prices: response.prices ?? [],\n          invoices: response.invoices ?? [],\n          usage: response.usage ?? EMPTY_USAGE,\n          creditPools: response.creditPools ?? {},\n          activePromotions: response.activePromotions ?? [],\n          scopeType: response.scopeType,\n        });\n        setError(null);\n\n        logDebug('Billing state fetched', {\n          hasAccount: !!response.billingAccount,\n          hasSubscription: !!response.subscription,\n          productCount: response.products?.length ?? 0,\n          priceCount: response.prices?.length ?? 0,\n          billingAccountId: response.billingAccount?._id,\n        });\n      }\n    } catch (err: unknown) {\n      if (mountedRef.current) {\n        const message = err instanceof Error ? err.message : 'Failed to fetch billing state';\n        setError(err instanceof Error ? err : new Error(message));\n        logDebug('Failed to fetch billing state', { error: message });\n      }\n    } finally {\n      if (mountedRef.current) {\n        setIsLoading(false);\n      }\n      fetchInFlightRef.current = false;\n    }\n  }, [isEnabled, scopeType, scopeEntityId]);\n\n  // ── Initial fetch ──\n  useEffect(() => {\n    mountedRef.current = true;\n    if (isEnabled && scopeType && scopeEntityId) {\n      fetchBillingState();\n    } else {\n      setIsLoading(false);\n    }\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [fetchBillingState, isEnabled, scopeType, scopeEntityId]);\n\n  // ── WebSocket invalidation (debounced) ──\n  useEffect(() => {\n    if (!isEnabled) return;\n\n    const unsubscribers: Array<() => void> = [];\n\n    const debouncedRefetch = () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      debounceTimerRef.current = setTimeout(() => {\n        debounceTimerRef.current = null;\n        fetchBillingState();\n      }, 300);\n    };\n\n    for (const event of INVALIDATION_EVENTS) {\n      const unsub = on<WS_BillingEventPayload>(event, (payload) => {\n        if (!scopeType || !scopeEntityId) {\n          logDebug('Ignoring billing invalidation without active scope', { event, payload });\n          return;\n        }\n\n        if (payload.scopeType !== scopeType || payload.scopeEntityId !== scopeEntityId) {\n          logDebug('Ignoring billing invalidation for another scope', {\n            event,\n            payload,\n            currentScopeType: scopeType,\n            currentScopeEntityId: scopeEntityId,\n          });\n          return;\n        }\n\n        if (billingAccountId && payload.billingAccountId !== billingAccountId) {\n          logDebug('Ignoring billing invalidation for another billing account', {\n            event,\n            payload,\n            currentBillingAccountId: billingAccountId,\n          });\n          return;\n        }\n\n        logDebug('WebSocket invalidation event received, scheduling refetch', { event, payload });\n        debouncedRefetch();\n      });\n      unsubscribers.push(unsub);\n    }\n\n    return () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n      for (const unsub of unsubscribers) {\n        unsub();\n      }\n    };\n  }, [on, fetchBillingState, isEnabled, scopeType, scopeEntityId, billingAccountId]);\n\n  // ── Derived state ──\n  const billingAccount = billingState?.billingAccount ?? null;\n  const subscription = billingState?.subscription ?? null;\n  const products = billingState?.products ?? [];\n  const prices = billingState?.prices ?? [];\n  const invoices = billingState?.invoices ?? [];\n  const usage = billingState?.usage ?? EMPTY_USAGE;\n  const creditPools = billingState?.creditPools ?? {};\n  const activePromotions = billingState?.activePromotions ?? [];\n  const currentScope = scopeType ?? null;\n\n  // ── Product catalog lookups ──\n  const productsByKey = useMemo(() => {\n    const map = new Map<string, Product>();\n    for (const p of products) {\n      map.set(p.key, p);\n    }\n    return map;\n  }, [products]);\n\n  const pricesByProductId = useMemo(() => {\n    const map = new Map<string, Price[]>();\n    for (const price of prices) {\n      const existing = map.get(price.productId) ?? [];\n      existing.push(price);\n      map.set(price.productId, existing);\n    }\n    return map;\n  }, [prices]);\n\n  const getPricesForProduct = useCallback(\n    (productId: string): Price[] => pricesByProductId.get(productId) ?? [],\n    [pricesByProductId],\n  );\n\n  const getProductByKey = useCallback(\n    (key: string): Product | undefined => productsByKey.get(key),\n    [productsByKey],\n  );\n\n  // ── Current plan derivation ──\n  const { currentPlanKey, currentPlanProduct } = useMemo(() => {\n    if (!subscription || !subscription.items?.length) {\n      return { currentPlanKey: null, currentPlanProduct: null };\n    }\n    for (const item of subscription.items) {\n      const product = products.find(p => p._id === item.productId);\n      if (product && product.type === 'plan') {\n        return { currentPlanKey: product.key, currentPlanProduct: product };\n      }\n    }\n    return { currentPlanKey: null, currentPlanProduct: null };\n  }, [subscription, products]);\n\n  const productDefinitions = useMemo<ProductDefinition[]>(\n    () => injectedProductDefinitions ?? [],\n    [injectedProductDefinitions],\n  );\n\n  // ── Actions ──\n  const openCheckout = useCallback(\n    async (productKey: string, priceId: string, options?: {\n      quantity?: number;\n      promotionCode?: string;\n      trialDays?: number;\n    }): Promise<void> => {\n      if (!billingAccountId || !billingAccountResourceType || !scopeType || !scopeEntityId) {\n        throw new Error('No billing account available. Cannot open checkout.');\n      }\n      const checkoutUrl = SCOPE_TO_OPEN_CHECKOUT_URL[scopeType]?.(scopeEntityId, billingAccountId);\n      if (!checkoutUrl) {\n        throw new Error(`No OPEN_CHECKOUT URL builder for scope ${scopeType}.`);\n      }\n      if (checkoutInFlightRef.current) {\n        logDebug('Checkout already in progress, ignoring duplicate request');\n        return;\n      }\n\n      checkoutInFlightRef.current = true;\n      try {\n        logDebug('Opening checkout session', { productKey, priceId, ...options });\n        const httpClient = getManualCallsHttpClient();\n\n        // OPEN_CHECKOUT borrows UPDATE → keyed PUT on the scoped account route.\n        const response = await httpClient.put<CheckoutSessionResponse>(\n          checkoutUrl,\n          {\n            productKey,\n            priceId,\n            successUrl: `${resolvedRedirectBase}/billing/success?session_id={CHECKOUT_SESSION_ID}`,\n            cancelUrl: `${resolvedRedirectBase}/billing/cancel`,\n            quantity: options?.quantity,\n            promotionCode: options?.promotionCode,\n            trialDays: options?.trialDays,\n          },\n        );\n\n        if (response.url) {\n          window.location.href = response.url;\n        }\n      } finally {\n        checkoutInFlightRef.current = false;\n      }\n    },\n    [billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, resolvedRedirectBase],\n  );\n\n  const openCustomerPortal = useCallback(async (): Promise<void> => {\n    if (!billingAccountId || !billingAccountResourceType || !scopeType || !scopeEntityId) {\n      throw new Error('No billing account available. Cannot open customer portal.');\n    }\n    const portalUrlBase = SCOPE_TO_OPEN_PORTAL_URL[scopeType]?.(scopeEntityId, billingAccountId);\n    if (!portalUrlBase) {\n      throw new Error(`No OPEN_PORTAL URL builder for scope ${scopeType}.`);\n    }\n\n    logDebug('Opening customer portal session');\n    const httpClient = getManualCallsHttpClient();\n\n    // OPEN_PORTAL borrows READ → keyed GET on the scoped account route; the\n    // returnUrl travels as a query param since GET carries no request body.\n    const returnUrl = encodeURIComponent(`${resolvedRedirectBase}/billing`);\n    const response = await httpClient.get<PortalSessionResponse>(\n      `${portalUrlBase}?returnUrl=${returnUrl}`,\n    );\n\n    if (response.url) {\n      window.location.href = response.url;\n    }\n  }, [billingAccountId, billingAccountResourceType, scopeType, scopeEntityId, resolvedRedirectBase]);\n\n  // ── Context value (memoized for stable reference) ──\n  const contextValue: BillingContextType = useMemo(\n    () => ({\n      isEnabled,\n      billingConfiguration: billingConfig,\n      billingProvider,\n      billingAccount,\n      subscription,\n      currentPlanKey,\n      currentPlanProduct,\n      currentScope,\n      products,\n      prices,\n      invoices,\n      productDefinitions,\n      getPricesForProduct,\n      getProductByKey,\n      activePromotions,\n      usage,\n      creditPools,\n      openCheckout,\n      openCustomerPortal,\n      isLoading,\n      error,\n      refetch: fetchBillingState,\n    }),\n    [\n      isEnabled,\n      billingConfig,\n      billingProvider,\n      billingAccount,\n      subscription,\n      currentPlanKey,\n      currentPlanProduct,\n      currentScope,\n      products,\n      prices,\n      invoices,\n      productDefinitions,\n      getPricesForProduct,\n      getProductByKey,\n      activePromotions,\n      usage,\n      creditPools,\n      openCheckout,\n      openCustomerPortal,\n      isLoading,\n      error,\n      fetchBillingState,\n    ],\n  );\n\n  return (\n    <BillingContext.Provider value={contextValue}>\n      {children}\n    </BillingContext.Provider>\n  );\n}\n\nfunction isBillingFrontendProvider(\n  provider: FrontendAppProviderModule | undefined,\n): provider is FrontendAppProviderModule {\n  return !!provider\n    && provider.providerCapabilities.includes(BUILTIN_PROVIDER_CAPABILITY.BILLING)\n    && provider.protocols.includes(BUILTIN_PROVIDER_PROTOCOL.BILLING_PROVIDER);\n}\n"]}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"BillingErrorNotifier.js","sourceRoot":"","sources":["../../../../../src/core/billing/BillingErrorNotifier.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAAC;IAC1C,MAAM,oBAAoB,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAEzD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YAC3C,IAAI,oBAAoB,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;gBAClD,oBAAoB,CAAC,OAAO,GAAG,YAAY,CAAC;gBAC5C,WAAW,CAAC,YAAY,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC;QACtC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IAElC,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * BillingErrorNotifier\n *\n * Bridge component that sits inside both BillingProvider and NotificationProvider.\n * Watches BillingContext.error and dispatches a notification when billing state\n * fetch fails. Uses a ref to avoid duplicate notifications on re-renders.\n *\n * Rendered in ApplicationMainContext inside the NotificationProvider subtree.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { useBillingSafe } from './useBilling';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\n\nexport function BillingErrorNotifier(): null {\n  const billing = useBillingSafe();\n  const { notifyError } = useNotification();\n  const lastNotifiedErrorRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (billing?.error) {\n      const errorMessage = billing.error.message;\n      if (lastNotifiedErrorRef.current !== errorMessage) {\n        lastNotifiedErrorRef.current = errorMessage;\n        notifyError(errorMessage);\n      }\n    } else {\n      lastNotifiedErrorRef.current = null;\n    }\n  }, [billing?.error, notifyError]);\n\n  return null;\n}\n"]}
+{"version":3,"file":"BillingErrorNotifier.js","sourceRoot":"","sources":["../../../../src/core/billing/BillingErrorNotifier.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF,MAAM,UAAU,oBAAoB;IAClC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAAC;IAC1C,MAAM,oBAAoB,GAAG,MAAM,CAAgB,IAAI,CAAC,CAAC;IAEzD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,EAAE,KAAK,EAAE,CAAC;YACnB,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;YAC3C,IAAI,oBAAoB,CAAC,OAAO,KAAK,YAAY,EAAE,CAAC;gBAClD,oBAAoB,CAAC,OAAO,GAAG,YAAY,CAAC;gBAC5C,WAAW,CAAC,YAAY,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,oBAAoB,CAAC,OAAO,GAAG,IAAI,CAAC;QACtC,CAAC;IACH,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC;IAElC,OAAO,IAAI,CAAC;AACd,CAAC","sourcesContent":["/**\n * BillingErrorNotifier\n *\n * Bridge component that sits inside both BillingProvider and NotificationProvider.\n * Watches BillingContext.error and dispatches a notification when billing state\n * fetch fails. Uses a ref to avoid duplicate notifications on re-renders.\n *\n * Rendered in ApplicationMainContext inside the NotificationProvider subtree.\n */\n\nimport { useEffect, useRef } from 'react';\nimport { useBillingSafe } from './useBilling';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\n\nexport function BillingErrorNotifier(): null {\n  const billing = useBillingSafe();\n  const { notifyError } = useNotification();\n  const lastNotifiedErrorRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (billing?.error) {\n      const errorMessage = billing.error.message;\n      if (lastNotifiedErrorRef.current !== errorMessage) {\n        lastNotifiedErrorRef.current = errorMessage;\n        notifyError(errorMessage);\n      }\n    } else {\n      lastNotifiedErrorRef.current = null;\n    }\n  }, [billing?.error, notifyError]);\n\n  return null;\n}\n"]}

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

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

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

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

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":"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"}

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":"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"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useBilling.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/useBilling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAAO,kBAM7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,kBAAkB,GAAG,SAEtD,CAAC"}
+{"version":3,"file":"useBilling.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/useBilling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAAO,kBAM7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,kBAAkB,GAAG,SAEtD,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"useBilling.js","sourceRoot":"","sources":["../../../../../src/core/billing/useBilling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,cAAc,EAA2B,MAAM,kBAAkB,CAAC;AAE3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAuB,EAAE;IACjD,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAmC,EAAE;IACjE,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC;AACpC,CAAC,CAAC","sourcesContent":["/**\n * useBilling Hook\n *\n * Separated from BillingContext.tsx for React Fast Refresh compatibility.\n * Provides access to the billing context: state, actions, and product catalog.\n */\n\nimport { useContext } from 'react';\nimport { BillingContext, type BillingContextType } from './BillingContext';\n\n/**\n * Hook to access the Billing context.\n * @returns BillingContextType with billing state, actions, and product catalog.\n * @throws Error if used outside of BillingProvider.\n */\nexport const useBilling = (): BillingContextType => {\n  const context = useContext(BillingContext);\n  if (!context) {\n    throw new Error('useBilling must be used within a BillingProvider');\n  }\n  return context;\n};\n\n/**\n * Safe version that returns undefined if outside provider.\n * Useful for components that may render before the provider is mounted\n * or in contexts where billing may not be enabled.\n */\nexport const useBillingSafe = (): BillingContextType | undefined => {\n  return useContext(BillingContext);\n};\n"]}
+{"version":3,"file":"useBilling.js","sourceRoot":"","sources":["../../../../src/core/billing/useBilling.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,cAAc,EAA2B,MAAM,kBAAkB,CAAC;AAE3E;;;;GAIG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,GAAuB,EAAE;IACjD,MAAM,OAAO,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,GAAmC,EAAE;IACjE,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC;AACpC,CAAC,CAAC","sourcesContent":["/**\n * useBilling Hook\n *\n * Separated from BillingContext.tsx for React Fast Refresh compatibility.\n * Provides access to the billing context: state, actions, and product catalog.\n */\n\nimport { useContext } from 'react';\nimport { BillingContext, type BillingContextType } from './BillingContext';\n\n/**\n * Hook to access the Billing context.\n * @returns BillingContextType with billing state, actions, and product catalog.\n * @throws Error if used outside of BillingProvider.\n */\nexport const useBilling = (): BillingContextType => {\n  const context = useContext(BillingContext);\n  if (!context) {\n    throw new Error('useBilling must be used within a BillingProvider');\n  }\n  return context;\n};\n\n/**\n * Safe version that returns undefined if outside provider.\n * Useful for components that may render before the provider is mounted\n * or in contexts where billing may not be enabled.\n */\nexport const useBillingSafe = (): BillingContextType | undefined => {\n  return useContext(BillingContext);\n};\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useBillingAction.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/useBillingAction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0DAA0D,CAAC;AAIpG;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,CAyD9E"}
+{"version":3,"file":"useBillingAction.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/useBillingAction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0DAA0D,CAAC;AAIpG;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,IAAI,CAAC,YAAY,EAAE,mBAAmB,KAAK,IAAI,CAyD9E"}

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

@@ -1 +1 @@
-{"version":3,"file":"useBillingAction.js","sourceRoot":"","sources":["../../../../../src/core/billing/useBillingAction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,sBAAsB,GAAG,4BAA4B,EAAE,CAAC;IAE9D,OAAO,WAAW,CAChB,CAAC,YAAiC,EAAE,EAAE;QACpC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,OAAO;QAE3C,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,GAAG,YAAY,CAAC;QAEvE,oDAAoD;QACpD,IAAI,UAA8B,CAAC;QACnC,IAAI,OAA2B,CAAC;QAEhC,2DAA2D;QAC3D,IAAI,mBAAmB,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;YAC7D,IAAI,OAAO,EAAE,CAAC;gBACZ,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;gBACzB,MAAM,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACxD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;gBAChE,OAAO,GAAG,YAAY,EAAE,GAAG,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,IAAI,CAAC,UAAU,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,WAAW,EAAE,CAAC;gBAChB,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC;gBACpC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;YAChC,CAAC;QACH,CAAC;QAED,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,6BAA6B,CAAC,cAAc,CAAC;YAClD,KAAK,6BAA6B,CAAC,oBAAoB,CAAC;YACxD,KAAK,6BAA6B,CAAC,YAAY;gBAC7C,IAAI,UAAU,IAAI,OAAO,EAAE,CAAC;oBAC1B,sBAAsB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC1E,CAAC;qBAAM,CAAC;oBACN,+DAA+D;oBAC/D,sBAAsB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;gBAC7D,CAAC;gBACD,MAAM;YAER,KAAK,6BAA6B,CAAC,aAAa,CAAC;YACjD,KAAK,6BAA6B,CAAC,OAAO,CAAC;YAC3C,KAAK,6BAA6B,CAAC,IAAI,CAAC;YACxC,KAAK,6BAA6B,CAAC,MAAM,CAAC;YAC1C;gBACE,wCAAwC;gBACxC,MAAM;QACV,CAAC;IACH,CAAC,EACD,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAClC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * useBillingAction Hook\n *\n * Resolves the appropriate billing action from a FeatureAvailability object.\n * Used by FeatureRouteGuard, FeatureGate, and action bar buttons to wire\n * feature unavailability prompts to billing checkout or customer portal flows.\n *\n * If billing is not enabled (useBillingSafe returns undefined), the action is a no-op.\n */\n\nimport { useCallback } from 'react';\nimport { FeatureUnavailabilityBehavior } from '@wildo-ai/saas-models';\nimport type { FeatureAvailability } from '~wildo-frontend-lib/core/features/useFeatureAvailability';\nimport { useBillingSafe } from './useBilling';\nimport { useSafeBillingActionExecutor } from './useSafeBillingActionExecutor';\n\n/**\n * Returns a callback that executes the appropriate billing action for a given FeatureAvailability.\n *\n * - upgrade_prompt / limit_upgrade_prompt → openCheckout with suggested product + default price\n * - addon_prompt → openCheckout with suggested addon product + default price\n * - contact_admin → no-op (no billing action)\n * - disable / hide / custom → no-op\n *\n * Falls back gracefully when billing is not enabled.\n */\nexport function useBillingAction(): (availability: FeatureAvailability) => void {\n  const billing = useBillingSafe();\n  const runBillingActionSafely = useSafeBillingActionExecutor();\n\n  return useCallback(\n    (availability: FeatureAvailability) => {\n      if (!billing || !billing.isEnabled) return;\n\n      const { behavior, suggestedProductRef, upgradeOptions } = availability;\n\n      // Determine which product/price to use for checkout\n      let productKey: string | undefined;\n      let priceId: string | undefined;\n\n      // Try the suggestedProductRef first (per-feature override)\n      if (suggestedProductRef) {\n        const product = billing.getProductByKey(suggestedProductRef);\n        if (product) {\n          productKey = product.key;\n          const prices = billing.getPricesForProduct(product._id);\n          const defaultPrice = prices.find(p => p.isDefault) ?? prices[0];\n          priceId = defaultPrice?._id;\n        }\n      }\n\n      // Fallback to upgrade options from resolved features\n      if (!productKey && upgradeOptions && upgradeOptions.length > 0) {\n        const firstOption = upgradeOptions[0];\n        if (firstOption) {\n          productKey = firstOption.productKey;\n          priceId = firstOption.priceId;\n        }\n      }\n\n      switch (behavior) {\n        case FeatureUnavailabilityBehavior.UPGRADE_PROMPT:\n        case FeatureUnavailabilityBehavior.LIMIT_UPGRADE_PROMPT:\n        case FeatureUnavailabilityBehavior.ADDON_PROMPT:\n          if (productKey && priceId) {\n            runBillingActionSafely(() => billing.openCheckout(productKey, priceId));\n          } else {\n            // No specific product found — open customer portal as fallback\n            runBillingActionSafely(() => billing.openCustomerPortal());\n          }\n          break;\n\n        case FeatureUnavailabilityBehavior.CONTACT_ADMIN:\n        case FeatureUnavailabilityBehavior.DISABLE:\n        case FeatureUnavailabilityBehavior.HIDE:\n        case FeatureUnavailabilityBehavior.CUSTOM:\n        default:\n          // No billing action for these behaviors\n          break;\n      }\n    },\n    [billing, runBillingActionSafely],\n  );\n}\n"]}
+{"version":3,"file":"useBillingAction.js","sourceRoot":"","sources":["../../../../src/core/billing/useBillingAction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAEtE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,sBAAsB,GAAG,4BAA4B,EAAE,CAAC;IAE9D,OAAO,WAAW,CAChB,CAAC,YAAiC,EAAE,EAAE;QACpC,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,OAAO;QAE3C,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,cAAc,EAAE,GAAG,YAAY,CAAC;QAEvE,oDAAoD;QACpD,IAAI,UAA8B,CAAC;QACnC,IAAI,OAA2B,CAAC;QAEhC,2DAA2D;QAC3D,IAAI,mBAAmB,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC;YAC7D,IAAI,OAAO,EAAE,CAAC;gBACZ,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC;gBACzB,MAAM,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACxD,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;gBAChE,OAAO,GAAG,YAAY,EAAE,GAAG,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,qDAAqD;QACrD,IAAI,CAAC,UAAU,IAAI,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC/D,MAAM,WAAW,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;YACtC,IAAI,WAAW,EAAE,CAAC;gBAChB,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC;gBACpC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;YAChC,CAAC;QACH,CAAC;QAED,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,6BAA6B,CAAC,cAAc,CAAC;YAClD,KAAK,6BAA6B,CAAC,oBAAoB,CAAC;YACxD,KAAK,6BAA6B,CAAC,YAAY;gBAC7C,IAAI,UAAU,IAAI,OAAO,EAAE,CAAC;oBAC1B,sBAAsB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;gBAC1E,CAAC;qBAAM,CAAC;oBACN,+DAA+D;oBAC/D,sBAAsB,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC,CAAC;gBAC7D,CAAC;gBACD,MAAM;YAER,KAAK,6BAA6B,CAAC,aAAa,CAAC;YACjD,KAAK,6BAA6B,CAAC,OAAO,CAAC;YAC3C,KAAK,6BAA6B,CAAC,IAAI,CAAC;YACxC,KAAK,6BAA6B,CAAC,MAAM,CAAC;YAC1C;gBACE,wCAAwC;gBACxC,MAAM;QACV,CAAC;IACH,CAAC,EACD,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAClC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * useBillingAction Hook\n *\n * Resolves the appropriate billing action from a FeatureAvailability object.\n * Used by FeatureRouteGuard, FeatureGate, and action bar buttons to wire\n * feature unavailability prompts to billing checkout or customer portal flows.\n *\n * If billing is not enabled (useBillingSafe returns undefined), the action is a no-op.\n */\n\nimport { useCallback } from 'react';\nimport { FeatureUnavailabilityBehavior } from '@wildo-ai/saas-models';\nimport type { FeatureAvailability } from '~wildo-frontend-lib/core/features/useFeatureAvailability';\nimport { useBillingSafe } from './useBilling';\nimport { useSafeBillingActionExecutor } from './useSafeBillingActionExecutor';\n\n/**\n * Returns a callback that executes the appropriate billing action for a given FeatureAvailability.\n *\n * - upgrade_prompt / limit_upgrade_prompt → openCheckout with suggested product + default price\n * - addon_prompt → openCheckout with suggested addon product + default price\n * - contact_admin → no-op (no billing action)\n * - disable / hide / custom → no-op\n *\n * Falls back gracefully when billing is not enabled.\n */\nexport function useBillingAction(): (availability: FeatureAvailability) => void {\n  const billing = useBillingSafe();\n  const runBillingActionSafely = useSafeBillingActionExecutor();\n\n  return useCallback(\n    (availability: FeatureAvailability) => {\n      if (!billing || !billing.isEnabled) return;\n\n      const { behavior, suggestedProductRef, upgradeOptions } = availability;\n\n      // Determine which product/price to use for checkout\n      let productKey: string | undefined;\n      let priceId: string | undefined;\n\n      // Try the suggestedProductRef first (per-feature override)\n      if (suggestedProductRef) {\n        const product = billing.getProductByKey(suggestedProductRef);\n        if (product) {\n          productKey = product.key;\n          const prices = billing.getPricesForProduct(product._id);\n          const defaultPrice = prices.find(p => p.isDefault) ?? prices[0];\n          priceId = defaultPrice?._id;\n        }\n      }\n\n      // Fallback to upgrade options from resolved features\n      if (!productKey && upgradeOptions && upgradeOptions.length > 0) {\n        const firstOption = upgradeOptions[0];\n        if (firstOption) {\n          productKey = firstOption.productKey;\n          priceId = firstOption.priceId;\n        }\n      }\n\n      switch (behavior) {\n        case FeatureUnavailabilityBehavior.UPGRADE_PROMPT:\n        case FeatureUnavailabilityBehavior.LIMIT_UPGRADE_PROMPT:\n        case FeatureUnavailabilityBehavior.ADDON_PROMPT:\n          if (productKey && priceId) {\n            runBillingActionSafely(() => billing.openCheckout(productKey, priceId));\n          } else {\n            // No specific product found — open customer portal as fallback\n            runBillingActionSafely(() => billing.openCustomerPortal());\n          }\n          break;\n\n        case FeatureUnavailabilityBehavior.CONTACT_ADMIN:\n        case FeatureUnavailabilityBehavior.DISABLE:\n        case FeatureUnavailabilityBehavior.HIDE:\n        case FeatureUnavailabilityBehavior.CUSTOM:\n        default:\n          // No billing action for these behaviors\n          break;\n      }\n    },\n    [billing, runBillingActionSafely],\n  );\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"useSafeBillingActionExecutor.d.ts","sourceRoot":"","sources":["../../../../../src/core/billing/useSafeBillingActionExecutor.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAWpF"}
+{"version":3,"file":"useSafeBillingActionExecutor.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/useSafeBillingActionExecutor.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAWpF"}

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

@@ -1 +1 @@
-{"version":3,"file":"useSafeBillingActionExecutor.js","sourceRoot":"","sources":["../../../../../src/core/billing/useSafeBillingActionExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF;;;GAGG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAAC;IAE1C,OAAO,WAAW,CAAC,CAAC,MAA2B,EAAE,EAAE;QACjD,KAAK,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK;gBACpC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,sCAAsC,CAAC;YAC3C,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;AACpB,CAAC","sourcesContent":["import { useCallback } from 'react';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\n\n/**\n * Wrap billing UI actions so user-triggered checkout / portal failures surface\n * through the notification system instead of becoming dropped promise rejections.\n */\nexport function useSafeBillingActionExecutor(): (action: () => Promise<void>) => void {\n  const { notifyError } = useNotification();\n\n  return useCallback((action: () => Promise<void>) => {\n    void action().catch((error: unknown) => {\n      const message = error instanceof Error\n        ? error.message\n        : 'An unexpected billing error occurred';\n      notifyError(message);\n    });\n  }, [notifyError]);\n}\n"]}
+{"version":3,"file":"useSafeBillingActionExecutor.js","sourceRoot":"","sources":["../../../../src/core/billing/useSafeBillingActionExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,eAAe,EAAE,MAAM,iDAAiD,CAAC;AAElF;;;GAGG;AACH,MAAM,UAAU,4BAA4B;IAC1C,MAAM,EAAE,WAAW,EAAE,GAAG,eAAe,EAAE,CAAC;IAE1C,OAAO,WAAW,CAAC,CAAC,MAA2B,EAAE,EAAE;QACjD,KAAK,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK;gBACpC,CAAC,CAAC,KAAK,CAAC,OAAO;gBACf,CAAC,CAAC,sCAAsC,CAAC;YAC3C,WAAW,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;AACpB,CAAC","sourcesContent":["import { useCallback } from 'react';\nimport { useNotification } from '~wildo-frontend-lib/core/events/useNotification';\n\n/**\n * Wrap billing UI actions so user-triggered checkout / portal failures surface\n * through the notification system instead of becoming dropped promise rejections.\n */\nexport function useSafeBillingActionExecutor(): (action: () => Promise<void>) => void {\n  const { notifyError } = useNotification();\n\n  return useCallback((action: () => Promise<void>) => {\n    void action().catch((error: unknown) => {\n      const message = error instanceof Error\n        ? error.message\n        : 'An unexpected billing error occurred';\n      notifyError(message);\n    });\n  }, [notifyError]);\n}\n"]}

package/dist/esm/core/branding/useBrandIdentity.d.ts

@@ -52,6 +52,8 @@ export interface UseBrandIdentityOptions {
     theme?: BrandAssetTheme;
 }
 /**
+ * @wildo_source:part:start saas.frontend.brand-identity facet:layer:frontend facet:audience:app-developer
+ *
  * Reads the application's brand identity for a shell surface.
  *
  * Owns ONE decision every brand-rendering surface would otherwise re-derive:
@@ -63,6 +65,21 @@ export interface UseBrandIdentityOptions {
  *
  * Must be used inside `ApplicationMainProvider` (it reads the application
  * config) and inside `UIProvider` (it reads the resolved dark-mode state).
+ *
+ * ## Two things a caller does not have to solve
+ *
+ * The MARK VARIANT follows the active UI theme by default — dark UI asks for the dark mark, light UI
+ * for the light one, each falling back through the default. So an application that generated only a
+ * default-theme mark still gets it in dark mode rather than nothing. Pin `options.theme` only when a
+ * surface genuinely needs a fixed variant, such as a monochrome mark.
+ *
+ * WHOSE identity is rendered is decided here too, and it matters for any frontend that observes an
+ * application rather than being one — a creation tool, a back office. Such a frontend declares
+ * `shellIdentity` in its frontend configuration, and that identity WINS over the application config
+ * it reads. Without that precedence the tool renders its customer's brand as its own, because there
+ * is exactly one application-config endpoint and it belongs to the application.
+ *
+ * @wildo_source:part:end saas.frontend.brand-identity
  */
 export declare function useBrandIdentity(options?: UseBrandIdentityOptions): BrandIdentity;
 //# sourceMappingURL=useBrandIdentity.d.ts.map

package/dist/esm/core/branding/useBrandIdentity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useBrandIdentity.d.ts","sourceRoot":"","sources":["../../../../../src/core/branding/useBrandIdentity.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EAGhB,MAAM,uBAAuB,CAAC;AAK/B;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,oEAAoE;IACpE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,aAAa,CA4BrF"}
+{"version":3,"file":"useBrandIdentity.d.ts","sourceRoot":"","sources":["../../../../src/core/branding/useBrandIdentity.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EAGhB,MAAM,uBAAuB,CAAC;AAK/B;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,MAAM,WAAW,uBAAuB;IACtC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,qBAAqB,CAAC;IACpC,oEAAoE;IACpE,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,aAAa,CAqDrF"}

package/dist/esm/core/branding/useBrandIdentity.js

@@ -3,6 +3,8 @@ import { BrandAssetComposition, BrandAssetPurpose, BrandAssetTheme, resolveBrand
 import { useApplication } from '../../core/runtime/useApplication.js';
 import { useUI } from '../../core/ui/useUI.js';
 /**
+ * @wildo_source:part:start saas.frontend.brand-identity facet:layer:frontend facet:audience:app-developer
+ *
  * Reads the application's brand identity for a shell surface.
  *
  * Owns ONE decision every brand-rendering surface would otherwise re-derive:
@@ -14,17 +16,57 @@ import { useUI } from '../../core/ui/useUI.js';
  *
  * Must be used inside `ApplicationMainProvider` (it reads the application
  * config) and inside `UIProvider` (it reads the resolved dark-mode state).
+ *
+ * ## Two things a caller does not have to solve
+ *
+ * The MARK VARIANT follows the active UI theme by default — dark UI asks for the dark mark, light UI
+ * for the light one, each falling back through the default. So an application that generated only a
+ * default-theme mark still gets it in dark mode rather than nothing. Pin `options.theme` only when a
+ * surface genuinely needs a fixed variant, such as a monochrome mark.
+ *
+ * WHOSE identity is rendered is decided here too, and it matters for any frontend that observes an
+ * application rather than being one — a creation tool, a back office. Such a frontend declares
+ * `shellIdentity` in its frontend configuration, and that identity WINS over the application config
+ * it reads. Without that precedence the tool renders its customer's brand as its own, because there
+ * is exactly one application-config endpoint and it belongs to the application.
+ *
+ * @wildo_source:part:end saas.frontend.brand-identity
  */
 export function useBrandIdentity(options = {}) {
     const { composition = BrandAssetComposition.SYMBOL, purpose = BrandAssetPurpose.PRIMARY, theme } = options;
     const { appConfig } = useApplication();
-    const { isDark } = useUI();
+    const { isDark, shellIdentity } = useUI();
+    // ── WHOSE identity is this? ────────────────────────────────────────────────
+    //
+    // A frontend that declares `shellIdentity` in its frontend configuration is
+    // saying "I am not the application I talk to" — a creation tool, a back
+    // office, anything observing an application rather than being one. Its
+    // identity WINS here, because the alternative is silently presenting the
+    // customer's brand as the tool's own.
+    //
+    // That is not hypothetical. There is exactly ONE application-config endpoint
+    // and it belongs to the application: the dev companion answers
+    // `GET /api/v1/application-config?frontendServiceName=application-creation-workbench`
+    // with `appIdentity.displayName: "Wonder CRM"` (measured 2026-08-31), so
+    // without this precedence the workbench's brand header reads as the managed
+    // application.
+    //
+    // The two halves are taken TOGETHER, never mixed. A shell that declared a name
+    // but no assets must render its name UNMARKED rather than borrowing the
+    // application's mark — a foreign logo beside your own name is worse than no
+    // logo, and it is the exact mismatch this field exists to prevent. So the
+    // assets are read from whichever side supplied the name.
+    //
     // `appConfig` is non-optional on the context type and the provider only mounts
     // past the bootstrap gate, so it is read directly; `appIdentity` keeps its
     // optional read because the runtime payload has historically been treated as
     // possibly-absent (see `ApplicationMainContext`'s own `appIdentity?.version`).
-    const brandAssets = appConfig.brandAssets;
-    const name = appConfig.appIdentity?.displayName || appConfig.appIdentity?.appName || '';
+    const brandAssets = shellIdentity
+        ? shellIdentity.brandAssets
+        : appConfig.brandAssets;
+    const name = shellIdentity
+        ? shellIdentity.name
+        : (appConfig.appIdentity?.displayName || appConfig.appIdentity?.appName || '');
     const resolved = useMemo(() => {
         if (!brandAssets?.length)
             return undefined;

package/dist/esm/core/branding/useBrandIdentity.js.map

@@ -1 +1 @@
-{"version":3,"file":"useBrandIdentity.js","sourceRoot":"","sources":["../../../../../src/core/branding/useBrandIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAwD1D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,EAAE,WAAW,GAAG,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC3G,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IACvC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IAE3B,+EAA+E;IAC/E,2EAA2E;IAC3E,6EAA6E;IAC7E,+EAA+E;IAC/E,MAAM,WAAW,GAAoC,SAAS,CAAC,WAAW,CAAC;IAC3E,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,WAAW,IAAI,SAAS,CAAC,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC;IAExF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,IAAI,CAAC,WAAW,EAAE,MAAM;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,iBAAiB,CAAC,WAAW,EAAE;YACpC,WAAW;YACX,uEAAuE;YACvE,wEAAwE;YACxE,wEAAwE;YACxE,wEAAwE;YACxE,qEAAqE;YACrE,aAAa;YACb,KAAK,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC;YACvE,OAAO;SACR,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAClF,CAAC","sourcesContent":["import { useMemo } from 'react';\n\nimport {\n  BrandAssetComposition,\n  BrandAssetPurpose,\n  BrandAssetTheme,\n  resolveBrandAsset,\n  type RuntimeBrandAsset,\n} from '@wildo-ai/saas-models';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\n\n/**\n * The application's brand identity as a shell surface needs it: a display name\n * plus the URL of the brand asset matching the requested composition and the\n * ACTIVE light/dark theme.\n */\nexport interface BrandIdentity {\n  /**\n   * Human-readable application name — `appIdentity.displayName` when authored,\n   * falling back to the technical `appName` (which the config schema requires,\n   * so this is always non-empty).\n   */\n  name: string;\n  /**\n   * Resolved brand-asset URL, or `undefined` when the application has generated\n   * no brand yet. Consumers must degrade gracefully rather than render a broken\n   * image (the schema documents brand assets as absent until generated).\n   */\n  logoUrl?: string;\n  /**\n   * Composition of the asset that was ACTUALLY resolved — which may differ from\n   * the one requested. `resolveBrandAsset`'s last fallback rung matches any\n   * composition at `(DEFAULT, PRIMARY)`, so an application whose brand contains\n   * no `SYMBOL` (a wordmark-only identity is a supported brand shape) yields its\n   * `WORDMARK`/`LOCKUP` master here.\n   *\n   * Surfaces MUST branch on this rather than assume they got what they asked\n   * for: a wordmark or lockup already CONTAINS the application name, so\n   * rendering it beside a name label duplicates the name, and squeezing a wide\n   * asset into a square icon slot letterboxes it.\n   */\n  logoComposition?: BrandAssetComposition;\n}\n\nexport interface UseBrandIdentityOptions {\n  /**\n   * Which brand composition the surface wants. Defaults to\n   * {@link BrandAssetComposition.SYMBOL} — the right choice for any surface that\n   * renders the application NAME as text beside the mark, because a `LOCKUP`\n   * already contains the name and would duplicate it.\n   */\n  composition?: BrandAssetComposition;\n  /** Asset purpose. Defaults to {@link BrandAssetPurpose.PRIMARY}. */\n  purpose?: BrandAssetPurpose;\n  /**\n   * PINS the mark variant instead of following the active UI theme — e.g.\n   * {@link BrandAssetTheme.MONOCHROME} for the single-colour mark, or\n   * {@link BrandAssetTheme.DEFAULT} to keep the colour mark on a dark shell.\n   *\n   * Omitted (the default) means ADAPTIVE: dark UI asks for `DARK`, light UI for\n   * `LIGHT`, both falling back through `DEFAULT` inside `resolveBrandAsset`.\n   */\n  theme?: BrandAssetTheme;\n}\n\n/**\n * Reads the application's brand identity for a shell surface.\n *\n * Owns ONE decision every brand-rendering surface would otherwise re-derive:\n * how the active UI theme maps onto {@link BrandAssetTheme} (dark UI → `DARK`,\n * light UI → `LIGHT`), unless the caller PINS a variant via `options.theme`.\n * `resolveBrandAsset` then applies the framework's documented fallback chain, so\n * an app that generated only a default-theme mark still gets it in dark mode\n * instead of nothing.\n *\n * Must be used inside `ApplicationMainProvider` (it reads the application\n * config) and inside `UIProvider` (it reads the resolved dark-mode state).\n */\nexport function useBrandIdentity(options: UseBrandIdentityOptions = {}): BrandIdentity {\n  const { composition = BrandAssetComposition.SYMBOL, purpose = BrandAssetPurpose.PRIMARY, theme } = options;\n  const { appConfig } = useApplication();\n  const { isDark } = useUI();\n\n  // `appConfig` is non-optional on the context type and the provider only mounts\n  // past the bootstrap gate, so it is read directly; `appIdentity` keeps its\n  // optional read because the runtime payload has historically been treated as\n  // possibly-absent (see `ApplicationMainContext`'s own `appIdentity?.version`).\n  const brandAssets: RuntimeBrandAsset[] | undefined = appConfig.brandAssets;\n  const name = appConfig.appIdentity?.displayName || appConfig.appIdentity?.appName || '';\n\n  const resolved = useMemo(() => {\n    if (!brandAssets?.length) return undefined;\n    return resolveBrandAsset(brandAssets, {\n      composition,\n      // An explicit `theme` pins the variant (monochrome, or a forced side).\n      // Otherwise ADAPTIVE: LIGHT rather than DEFAULT for a light UI, because\n      // `resolveBrandAsset` tries the requested theme first and falls back to\n      // DEFAULT on its own — so asking for LIGHT strictly adds the ability to\n      // honor a light-specific asset, while asking for DEFAULT could never\n      // reach one.\n      theme: theme ?? (isDark ? BrandAssetTheme.DARK : BrandAssetTheme.LIGHT),\n      purpose,\n    });\n  }, [brandAssets, composition, purpose, theme, isDark]);\n\n  return { name, logoUrl: resolved?.url, logoComposition: resolved?.composition };\n}\n"]}
+{"version":3,"file":"useBrandIdentity.js","sourceRoot":"","sources":["../../../../src/core/branding/useBrandIdentity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EACL,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,cAAc,EAAE,MAAM,iDAAiD,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAwD1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,EAAE,WAAW,GAAG,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC3G,MAAM,EAAE,SAAS,EAAE,GAAG,cAAc,EAAE,CAAC;IACvC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,KAAK,EAAE,CAAC;IAE1C,8EAA8E;IAC9E,EAAE;IACF,4EAA4E;IAC5E,wEAAwE;IACxE,uEAAuE;IACvE,yEAAyE;IACzE,sCAAsC;IACtC,EAAE;IACF,6EAA6E;IAC7E,+DAA+D;IAC/D,sFAAsF;IACtF,yEAAyE;IACzE,4EAA4E;IAC5E,eAAe;IACf,EAAE;IACF,+EAA+E;IAC/E,wEAAwE;IACxE,4EAA4E;IAC5E,0EAA0E;IAC1E,yDAAyD;IACzD,EAAE;IACF,+EAA+E;IAC/E,2EAA2E;IAC3E,6EAA6E;IAC7E,+EAA+E;IAC/E,MAAM,WAAW,GAAoC,aAAa;QAChE,CAAC,CAAC,aAAa,CAAC,WAAW;QAC3B,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC;IAC1B,MAAM,IAAI,GAAG,aAAa;QACxB,CAAC,CAAC,aAAa,CAAC,IAAI;QACpB,CAAC,CAAC,CAAC,SAAS,CAAC,WAAW,EAAE,WAAW,IAAI,SAAS,CAAC,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;IAEjF,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE;QAC5B,IAAI,CAAC,WAAW,EAAE,MAAM;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,iBAAiB,CAAC,WAAW,EAAE;YACpC,WAAW;YACX,uEAAuE;YACvE,wEAAwE;YACxE,wEAAwE;YACxE,wEAAwE;YACxE,qEAAqE;YACrE,aAAa;YACb,KAAK,EAAE,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC;YACvE,OAAO;SACR,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IAEvD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AAClF,CAAC","sourcesContent":["import { useMemo } from 'react';\n\nimport {\n  BrandAssetComposition,\n  BrandAssetPurpose,\n  BrandAssetTheme,\n  resolveBrandAsset,\n  type RuntimeBrandAsset,\n} from '@wildo-ai/saas-models';\n\nimport { useApplication } from '~wildo-frontend-lib/core/runtime/useApplication';\nimport { useUI } from '~wildo-frontend-lib/core/ui/useUI';\n\n/**\n * The application's brand identity as a shell surface needs it: a display name\n * plus the URL of the brand asset matching the requested composition and the\n * ACTIVE light/dark theme.\n */\nexport interface BrandIdentity {\n  /**\n   * Human-readable application name — `appIdentity.displayName` when authored,\n   * falling back to the technical `appName` (which the config schema requires,\n   * so this is always non-empty).\n   */\n  name: string;\n  /**\n   * Resolved brand-asset URL, or `undefined` when the application has generated\n   * no brand yet. Consumers must degrade gracefully rather than render a broken\n   * image (the schema documents brand assets as absent until generated).\n   */\n  logoUrl?: string;\n  /**\n   * Composition of the asset that was ACTUALLY resolved — which may differ from\n   * the one requested. `resolveBrandAsset`'s last fallback rung matches any\n   * composition at `(DEFAULT, PRIMARY)`, so an application whose brand contains\n   * no `SYMBOL` (a wordmark-only identity is a supported brand shape) yields its\n   * `WORDMARK`/`LOCKUP` master here.\n   *\n   * Surfaces MUST branch on this rather than assume they got what they asked\n   * for: a wordmark or lockup already CONTAINS the application name, so\n   * rendering it beside a name label duplicates the name, and squeezing a wide\n   * asset into a square icon slot letterboxes it.\n   */\n  logoComposition?: BrandAssetComposition;\n}\n\nexport interface UseBrandIdentityOptions {\n  /**\n   * Which brand composition the surface wants. Defaults to\n   * {@link BrandAssetComposition.SYMBOL} — the right choice for any surface that\n   * renders the application NAME as text beside the mark, because a `LOCKUP`\n   * already contains the name and would duplicate it.\n   */\n  composition?: BrandAssetComposition;\n  /** Asset purpose. Defaults to {@link BrandAssetPurpose.PRIMARY}. */\n  purpose?: BrandAssetPurpose;\n  /**\n   * PINS the mark variant instead of following the active UI theme — e.g.\n   * {@link BrandAssetTheme.MONOCHROME} for the single-colour mark, or\n   * {@link BrandAssetTheme.DEFAULT} to keep the colour mark on a dark shell.\n   *\n   * Omitted (the default) means ADAPTIVE: dark UI asks for `DARK`, light UI for\n   * `LIGHT`, both falling back through `DEFAULT` inside `resolveBrandAsset`.\n   */\n  theme?: BrandAssetTheme;\n}\n\n/**\n * @wildo_source:part:start saas.frontend.brand-identity facet:layer:frontend facet:audience:app-developer\n *\n * Reads the application's brand identity for a shell surface.\n *\n * Owns ONE decision every brand-rendering surface would otherwise re-derive:\n * how the active UI theme maps onto {@link BrandAssetTheme} (dark UI → `DARK`,\n * light UI → `LIGHT`), unless the caller PINS a variant via `options.theme`.\n * `resolveBrandAsset` then applies the framework's documented fallback chain, so\n * an app that generated only a default-theme mark still gets it in dark mode\n * instead of nothing.\n *\n * Must be used inside `ApplicationMainProvider` (it reads the application\n * config) and inside `UIProvider` (it reads the resolved dark-mode state).\n *\n * ## Two things a caller does not have to solve\n *\n * The MARK VARIANT follows the active UI theme by default — dark UI asks for the dark mark, light UI\n * for the light one, each falling back through the default. So an application that generated only a\n * default-theme mark still gets it in dark mode rather than nothing. Pin `options.theme` only when a\n * surface genuinely needs a fixed variant, such as a monochrome mark.\n *\n * WHOSE identity is rendered is decided here too, and it matters for any frontend that observes an\n * application rather than being one — a creation tool, a back office. Such a frontend declares\n * `shellIdentity` in its frontend configuration, and that identity WINS over the application config\n * it reads. Without that precedence the tool renders its customer's brand as its own, because there\n * is exactly one application-config endpoint and it belongs to the application.\n *\n * @wildo_source:part:end saas.frontend.brand-identity\n */\nexport function useBrandIdentity(options: UseBrandIdentityOptions = {}): BrandIdentity {\n  const { composition = BrandAssetComposition.SYMBOL, purpose = BrandAssetPurpose.PRIMARY, theme } = options;\n  const { appConfig } = useApplication();\n  const { isDark, shellIdentity } = useUI();\n\n  // ── WHOSE identity is this? ────────────────────────────────────────────────\n  //\n  // A frontend that declares `shellIdentity` in its frontend configuration is\n  // saying \"I am not the application I talk to\" — a creation tool, a back\n  // office, anything observing an application rather than being one. Its\n  // identity WINS here, because the alternative is silently presenting the\n  // customer's brand as the tool's own.\n  //\n  // That is not hypothetical. There is exactly ONE application-config endpoint\n  // and it belongs to the application: the dev companion answers\n  // `GET /api/v1/application-config?frontendServiceName=application-creation-workbench`\n  // with `appIdentity.displayName: \"Wonder CRM\"` (measured 2026-08-31), so\n  // without this precedence the workbench's brand header reads as the managed\n  // application.\n  //\n  // The two halves are taken TOGETHER, never mixed. A shell that declared a name\n  // but no assets must render its name UNMARKED rather than borrowing the\n  // application's mark — a foreign logo beside your own name is worse than no\n  // logo, and it is the exact mismatch this field exists to prevent. So the\n  // assets are read from whichever side supplied the name.\n  //\n  // `appConfig` is non-optional on the context type and the provider only mounts\n  // past the bootstrap gate, so it is read directly; `appIdentity` keeps its\n  // optional read because the runtime payload has historically been treated as\n  // possibly-absent (see `ApplicationMainContext`'s own `appIdentity?.version`).\n  const brandAssets: RuntimeBrandAsset[] | undefined = shellIdentity\n    ? shellIdentity.brandAssets\n    : appConfig.brandAssets;\n  const name = shellIdentity\n    ? shellIdentity.name\n    : (appConfig.appIdentity?.displayName || appConfig.appIdentity?.appName || '');\n\n  const resolved = useMemo(() => {\n    if (!brandAssets?.length) return undefined;\n    return resolveBrandAsset(brandAssets, {\n      composition,\n      // An explicit `theme` pins the variant (monochrome, or a forced side).\n      // Otherwise ADAPTIVE: LIGHT rather than DEFAULT for a light UI, because\n      // `resolveBrandAsset` tries the requested theme first and falls back to\n      // DEFAULT on its own — so asking for LIGHT strictly adds the ability to\n      // honor a light-specific asset, while asking for DEFAULT could never\n      // reach one.\n      theme: theme ?? (isDark ? BrandAssetTheme.DARK : BrandAssetTheme.LIGHT),\n      purpose,\n    });\n  }, [brandAssets, composition, purpose, theme, isDark]);\n\n  return { name, logoUrl: resolved?.url, logoComposition: resolved?.composition };\n}\n"]}