@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,349 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * BillingContext
+ *
+ * Central context for billing operations on the frontend.
+ *
+ * Responsibilities:
+ * - Self-resolves scope (org/user) from AppScope + user context — no external props needed
+ * - Fetches billing state via the GET_STATE resource operation on the billing account
+ * - The backend auto-creates the billing account if one doesn't exist
+ * - Provides actions: openCheckout, openCustomerPortal (via resource operations)
+ * - Caches billing state and invalidates on WebSocket events
+ * - Exposes convenience accessors for current plan, subscription status, etc.
+ *
+ * DELEGATION PRINCIPLE: The frontend does NOT build payment UI.
+ * - Stripe Checkout (hosted page): for new subscriptions and upgrades
+ * - Stripe Customer Portal (hosted page): for invoices, payment methods, cancellation
+ */
+import { createContext, useEffect, useState, useCallback, useMemo, useRef } from 'react';
+import { CoreWebSocketEvent, CoreResourceType, ResourcePrimaryScope, } from '@wildo-ai/saas-models';
+import { useWebSocket } from '../../core/requests/websockets/useWebSocket.js';
+import { useUserOrgs } from '../../core/security/useUserOrgs.js';
+import { useAppScopeSafe } from '../../core/scope/useAppScope.js';
+import { useApplication } from '../../core/runtime/useApplication.js';
+import { LoggerFrontendService } from '../../core/monitoring/logger.frontend.service.js';
+import { getManualCallsHttpClient } from '../../core/requests/wildo-http-client-manual-calls.frontend.service.js';
+// ================================
+// Logger
+// ================================
+const billingLogger = LoggerFrontendService.getLogger();
+const logDebug = billingLogger.debugByType('BillingContext');
+billingLogger.setDebugTypeLogging('BillingContext', false);
+// ================================
+// Constants
+// ================================
+const API_PREFIX = '/api/v1';
+/** WebSocket events that trigger a refetch of billing state */
+const INVALIDATION_EVENTS = [
+    CoreWebSocketEvent.BILLING_STATUS_CHANGED,
+    CoreWebSocketEvent.BILLING_SUBSCRIPTION_UPDATED,
+    CoreWebSocketEvent.BILLING_ACCOUNT_CHANGED,
+    CoreWebSocketEvent.BILLING_USAGE_UPDATED,
+    CoreWebSocketEvent.BILLING_CREDIT_POOL_UPDATED,
+    CoreWebSocketEvent.BILLING_FEATURES_UPDATED,
+];
+/** Maps ResourcePrimaryScope → billing account variant resource type (for resource operations) */
+const SCOPE_TO_BILLING_ACCOUNT_RESOURCE = {
+    [ResourcePrimaryScope.ORGANIZATIONS]: CoreResourceType.ORGANIZATION_BILLING_ACCOUNTS,
+    [ResourcePrimaryScope.USER_SELF]: CoreResourceType.USER_BILLING_ACCOUNTS,
+};
+/** Maps ResourcePrimaryScope → GET_STATE URL builder (uses engine resource operation URLs) */
+const SCOPE_TO_GET_STATE_URL = {
+    [ResourcePrimaryScope.ORGANIZATIONS]: (id) => `${API_PREFIX}/organizations/${id}/organization-billing-accounts/get-state`,
+    [ResourcePrimaryScope.USER_SELF]: (id) => `${API_PREFIX}/users/${id}/user-billing-accounts/get-state`,
+};
+// ── Default empty state ──
+const EMPTY_USAGE = {
+    byProduct: {},
+};
+export const BillingContext = createContext(undefined);
+export function BillingProvider({ children, productDefinitions: injectedProductDefinitions }) {
+    // ── Self-resolve configuration from hooks ──
+    const userOrgs = useUserOrgs();
+    const appScope = useAppScopeSafe();
+    const { appConfig } = useApplication();
+    const billingConfig = appConfig.billing;
+    const isEnabled = billingConfig?.enabled ?? false;
+    // ── Self-resolve scope ──
+    const enabledScopes = billingConfig?.enabledScopes ?? [ResourcePrimaryScope.ORGANIZATIONS];
+    const { scopeType, scopeEntityId } = useMemo(() => {
+        if (enabledScopes.includes(ResourcePrimaryScope.ORGANIZATIONS) && appScope?.currentOrganizationId) {
+            return { scopeType: ResourcePrimaryScope.ORGANIZATIONS, scopeEntityId: appScope.currentOrganizationId };
+        }
+        if (enabledScopes.includes(ResourcePrimaryScope.USER_SELF) && userOrgs.user?._id) {
+            return { scopeType: ResourcePrimaryScope.USER_SELF, scopeEntityId: userOrgs.user._id };
+        }
+        return { scopeType: null, scopeEntityId: null };
+    }, [enabledScopes, appScope?.currentOrganizationId, userOrgs.user?._id]);
+    // ── Derive variant resource type for operations ──
+    const billingAccountResourceType = scopeType ? SCOPE_TO_BILLING_ACCOUNT_RESOURCE[scopeType] : null;
+    // ── State ──
+    const [billingState, setBillingState] = useState(null);
+    const [isLoading, setIsLoading] = useState(isEnabled && !!scopeEntityId);
+    const [error, setError] = useState(null);
+    // ── Refs for stable callbacks ──
+    const fetchInFlightRef = useRef(false);
+    const mountedRef = useRef(true);
+    const debounceTimerRef = useRef(null);
+    const checkoutInFlightRef = useRef(false);
+    // ── WebSocket ──
+    const { on } = useWebSocket();
+    // ── Resolve redirect base URL ──
+    const resolvedRedirectBase = useMemo(() => typeof window !== 'undefined' ? window.location.origin : '', []);
+    // ── billingAccountId from response ──
+    const billingAccountId = billingState?.billingAccount?._id ?? null;
+    // ── Clear stale state on scope change ──
+    useEffect(() => {
+        setBillingState(null);
+        setError(null);
+        setIsLoading(isEnabled && !!scopeEntityId);
+    }, [scopeType, scopeEntityId, isEnabled]);
+    // ── Fetch billing state from backend ──
+    const fetchBillingState = useCallback(async () => {
+        if (!isEnabled || !scopeType || !scopeEntityId)
+            return;
+        if (fetchInFlightRef.current)
+            return;
+        fetchInFlightRef.current = true;
+        try {
+            logDebug('Fetching billing state', { scopeType, scopeEntityId });
+            const httpClient = getManualCallsHttpClient();
+            const urlBuilder = SCOPE_TO_GET_STATE_URL[scopeType];
+            if (!urlBuilder)
+                return;
+            const url = urlBuilder(scopeEntityId);
+            const response = await httpClient.get(url);
+            if (mountedRef.current) {
+                setBillingState({
+                    billingAccount: response.billingAccount,
+                    subscription: response.subscription,
+                    products: response.products ?? [],
+                    prices: response.prices ?? [],
+                    invoices: response.invoices ?? [],
+                    usage: response.usage ?? EMPTY_USAGE,
+                    creditPools: response.creditPools ?? {},
+                    activePromotions: response.activePromotions ?? [],
+                    scopeType: response.scopeType,
+                });
+                setError(null);
+                logDebug('Billing state fetched', {
+                    hasAccount: !!response.billingAccount,
+                    hasSubscription: !!response.subscription,
+                    productCount: response.products?.length ?? 0,
+                    priceCount: response.prices?.length ?? 0,
+                    billingAccountId: response.billingAccount?._id,
+                });
+            }
+        }
+        catch (err) {
+            if (mountedRef.current) {
+                const message = err instanceof Error ? err.message : 'Failed to fetch billing state';
+                setError(err instanceof Error ? err : new Error(message));
+                logDebug('Failed to fetch billing state', { error: message });
+            }
+        }
+        finally {
+            if (mountedRef.current) {
+                setIsLoading(false);
+            }
+            fetchInFlightRef.current = false;
+        }
+    }, [isEnabled, scopeType, scopeEntityId]);
+    // ── Initial fetch ──
+    useEffect(() => {
+        mountedRef.current = true;
+        if (isEnabled && scopeType && scopeEntityId) {
+            fetchBillingState();
+        }
+        else {
+            setIsLoading(false);
+        }
+        return () => {
+            mountedRef.current = false;
+        };
+    }, [fetchBillingState, isEnabled, scopeType, scopeEntityId]);
+    // ── WebSocket invalidation (debounced) ──
+    useEffect(() => {
+        if (!isEnabled)
+            return;
+        const unsubscribers = [];
+        const debouncedRefetch = () => {
+            if (debounceTimerRef.current) {
+                clearTimeout(debounceTimerRef.current);
+            }
+            debounceTimerRef.current = setTimeout(() => {
+                debounceTimerRef.current = null;
+                fetchBillingState();
+            }, 300);
+        };
+        for (const event of INVALIDATION_EVENTS) {
+            const unsub = on(event, (payload) => {
+                if (!scopeType || !scopeEntityId) {
+                    logDebug('Ignoring billing invalidation without active scope', { event, payload });
+                    return;
+                }
+                if (payload.scopeType !== scopeType || payload.scopeEntityId !== scopeEntityId) {
+                    logDebug('Ignoring billing invalidation for another scope', {
+                        event,
+                        payload,
+                        currentScopeType: scopeType,
+                        currentScopeEntityId: scopeEntityId,
+                    });
+                    return;
+                }
+                if (billingAccountId && payload.billingAccountId !== billingAccountId) {
+                    logDebug('Ignoring billing invalidation for another billing account', {
+                        event,
+                        payload,
+                        currentBillingAccountId: billingAccountId,
+                    });
+                    return;
+                }
+                logDebug('WebSocket invalidation event received, scheduling refetch', { event, payload });
+                debouncedRefetch();
+            });
+            unsubscribers.push(unsub);
+        }
+        return () => {
+            if (debounceTimerRef.current) {
+                clearTimeout(debounceTimerRef.current);
+            }
+            for (const unsub of unsubscribers) {
+                unsub();
+            }
+        };
+    }, [on, fetchBillingState, isEnabled, scopeType, scopeEntityId, billingAccountId]);
+    // ── Derived state ──
+    const billingAccount = billingState?.billingAccount ?? null;
+    const subscription = billingState?.subscription ?? null;
+    const products = billingState?.products ?? [];
+    const prices = billingState?.prices ?? [];
+    const invoices = billingState?.invoices ?? [];
+    const usage = billingState?.usage ?? EMPTY_USAGE;
+    const creditPools = billingState?.creditPools ?? {};
+    const activePromotions = billingState?.activePromotions ?? [];
+    const currentScope = scopeType ?? null;
+    // ── Product catalog lookups ──
+    const productsByKey = useMemo(() => {
+        const map = new Map();
+        for (const p of products) {
+            map.set(p.key, p);
+        }
+        return map;
+    }, [products]);
+    const pricesByProductId = useMemo(() => {
+        const map = new Map();
+        for (const price of prices) {
+            const existing = map.get(price.productId) ?? [];
+            existing.push(price);
+            map.set(price.productId, existing);
+        }
+        return map;
+    }, [prices]);
+    const getPricesForProduct = useCallback((productId) => pricesByProductId.get(productId) ?? [], [pricesByProductId]);
+    const getProductByKey = useCallback((key) => productsByKey.get(key), [productsByKey]);
+    // ── Current plan derivation ──
+    const { currentPlanKey, currentPlanProduct } = useMemo(() => {
+        if (!subscription || !subscription.items?.length) {
+            return { currentPlanKey: null, currentPlanProduct: null };
+        }
+        for (const item of subscription.items) {
+            const product = products.find(p => p._id === item.productId);
+            if (product && product.type === 'plan') {
+                return { currentPlanKey: product.key, currentPlanProduct: product };
+            }
+        }
+        return { currentPlanKey: null, currentPlanProduct: null };
+    }, [subscription, products]);
+    const productDefinitions = useMemo(() => injectedProductDefinitions ?? [], [injectedProductDefinitions]);
+    // ── Actions ──
+    const openCheckout = useCallback(async (productKey, priceId, options) => {
+        if (!billingAccountId || !billingAccountResourceType) {
+            throw new Error('No billing account available. Cannot open checkout.');
+        }
+        if (checkoutInFlightRef.current) {
+            logDebug('Checkout already in progress, ignoring duplicate request');
+            return;
+        }
+        checkoutInFlightRef.current = true;
+        try {
+            logDebug('Opening checkout session', { productKey, priceId, ...options });
+            const httpClient = getManualCallsHttpClient();
+            const response = await httpClient.post(`${API_PREFIX}/${billingAccountResourceType}/${billingAccountId}/operations/open_checkout`, {
+                productKey,
+                priceId,
+                successUrl: `${resolvedRedirectBase}/billing/success?session_id={CHECKOUT_SESSION_ID}`,
+                cancelUrl: `${resolvedRedirectBase}/billing/cancel`,
+                quantity: options?.quantity,
+                promotionCode: options?.promotionCode,
+                trialDays: options?.trialDays,
+            });
+            if (response.url) {
+                window.location.href = response.url;
+            }
+        }
+        finally {
+            checkoutInFlightRef.current = false;
+        }
+    }, [billingAccountId, billingAccountResourceType, resolvedRedirectBase]);
+    const openCustomerPortal = useCallback(async () => {
+        if (!billingAccountId || !billingAccountResourceType) {
+            throw new Error('No billing account available. Cannot open customer portal.');
+        }
+        logDebug('Opening customer portal session');
+        const httpClient = getManualCallsHttpClient();
+        const response = await httpClient.post(`${API_PREFIX}/${billingAccountResourceType}/${billingAccountId}/operations/open_portal`, { returnUrl: `${resolvedRedirectBase}/billing` });
+        if (response.url) {
+            window.location.href = response.url;
+        }
+    }, [billingAccountId, billingAccountResourceType, resolvedRedirectBase]);
+    // ── Context value (memoized for stable reference) ──
+    const contextValue = useMemo(() => ({
+        isEnabled,
+        billingConfiguration: billingConfig,
+        billingAccount,
+        subscription,
+        currentPlanKey,
+        currentPlanProduct,
+        currentScope,
+        products,
+        prices,
+        invoices,
+        productDefinitions,
+        getPricesForProduct,
+        getProductByKey,
+        activePromotions,
+        usage,
+        creditPools,
+        openCheckout,
+        openCustomerPortal,
+        isLoading,
+        error,
+        refetch: fetchBillingState,
+    }), [
+        isEnabled,
+        billingConfig,
+        billingAccount,
+        subscription,
+        currentPlanKey,
+        currentPlanProduct,
+        currentScope,
+        products,
+        prices,
+        invoices,
+        productDefinitions,
+        getPricesForProduct,
+        getProductByKey,
+        activePromotions,
+        usage,
+        creditPools,
+        openCheckout,
+        openCustomerPortal,
+        isLoading,
+        error,
+        fetchBillingState,
+    ]);
+    return (_jsx(BillingContext.Provider, { value: contextValue, children: children }));
+}
+//# sourceMappingURL=BillingContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BillingContext.js","sourceRoot":"","sources":["../../../../src/core/billing/BillingContext.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+/**
+ * BillingErrorNotifier
+ *
+ * Bridge component that sits inside both BillingProvider and NotificationProvider.
+ * Watches BillingContext.error and dispatches a notification when billing state
+ * fetch fails. Uses a ref to avoid duplicate notifications on re-renders.
+ *
+ * Rendered in ApplicationMainContext inside the NotificationProvider subtree.
+ */
+export declare function BillingErrorNotifier(): null;
+//# sourceMappingURL=BillingErrorNotifier.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,31 @@
+/**
+ * BillingErrorNotifier
+ *
+ * Bridge component that sits inside both BillingProvider and NotificationProvider.
+ * Watches BillingContext.error and dispatches a notification when billing state
+ * fetch fails. Uses a ref to avoid duplicate notifications on re-renders.
+ *
+ * Rendered in ApplicationMainContext inside the NotificationProvider subtree.
+ */
+import { useEffect, useRef } from 'react';
+import { useBillingSafe } from './useBilling.js';
+import { useNotification } from '../../core/events/useNotification.js';
+export function BillingErrorNotifier() {
+    const billing = useBillingSafe();
+    const { notifyError } = useNotification();
+    const lastNotifiedErrorRef = useRef(null);
+    useEffect(() => {
+        if (billing?.error) {
+            const errorMessage = billing.error.message;
+            if (lastNotifiedErrorRef.current !== errorMessage) {
+                lastNotifiedErrorRef.current = errorMessage;
+                notifyError(errorMessage);
+            }
+        }
+        else {
+            lastNotifiedErrorRef.current = null;
+        }
+    }, [billing?.error, notifyError]);
+    return null;
+}
+//# sourceMappingURL=BillingErrorNotifier.js.map

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

@@ -0,0 +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"}

package/dist/esm/core/billing/apply-engine-billing.frontend.d.ts

@@ -0,0 +1,16 @@
+import type { AppConfiguration_Frontend } from '../../core/config/app-configuration-frontend.schemas.js';
+import type { AppLevelComponentConfiguration } from '../../core/config/app-configuration-frontend.schemas.js';
+/**
+ * Injects engine billing sidebar + command menu rows. Safe to call multiple times
+ * (dedupes by launcher key). Skips sidebar mutation when sidebar is disabled; skips command
+ * menu mutation when command menu is `false`.
+ */
+export declare function mergeAppShellWithBilling(shell: AppLevelComponentConfiguration): AppLevelComponentConfiguration;
+/**
+ * Merges engine billing `fullCustomViews` + sidebar/command launcher rows into a frontend
+ * config. Safe to compose with app-specific `fullCustomViews` / shell overrides — uses
+ * ref-based deduping. Billing rows use `omitUnlessBillingEnabled` and are hidden at
+ * runtime when `BillingContext.isEnabled` is false.
+ */
+export declare function applyEngineBillingToFrontendConfig(config: AppConfiguration_Frontend): AppConfiguration_Frontend;
+//# sourceMappingURL=apply-engine-billing.frontend.d.ts.map

package/dist/esm/core/billing/apply-engine-billing.frontend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-engine-billing.frontend.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/apply-engine-billing.frontend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,oEAAoE,CAAC;AACpH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,oEAAoE,CAAC;AAgBzH;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,8BAA8B,GACpC,8BAA8B,CA6DhC;AAED;;;;;GAKG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,yBAAyB,GAChC,yBAAyB,CAM3B"}

package/dist/esm/core/billing/apply-engine-billing.frontend.js

@@ -0,0 +1,71 @@
+import { CommandBarPolicy } from '../../core/config/app-configuration-frontend.schemas.js';
+import { ApplicationLevelComponentType } from '../../core/config/app-level-components.frontend.schemas.js';
+import { appendNavChildrenToSidebarSection, mergeCommandMenuCommandLists, mergeFullCustomViewsByRef, } from '../../core/config/config-merge-utilities.js';
+import { BILLING_COMMAND_MENU_ITEM, BILLING_FULL_CUSTOM_VIEW, BILLING_SIDEBAR_LAUNCHER_ITEM, } from '../../core/billing/billing-launcher.js';
+/**
+ * Injects engine billing sidebar + command menu rows. Safe to call multiple times
+ * (dedupes by launcher key). Skips sidebar mutation when sidebar is disabled; skips command
+ * menu mutation when command menu is `false`.
+ */
+export function mergeAppShellWithBilling(shell) {
+    const sidebarKey = ApplicationLevelComponentType.SIDEBAR;
+    const commandKey = ApplicationLevelComponentType.COMMAND_MENU;
+    let next = { ...shell };
+    const rawSidebar = next[sidebarKey];
+    if (typeof rawSidebar === 'object' && rawSidebar !== null && 'contentSections' in rawSidebar) {
+        const contentSections = rawSidebar.contentSections;
+        if (contentSections?.length) {
+            next = {
+                ...next,
+                [sidebarKey]: {
+                    ...rawSidebar,
+                    contentSections: appendNavChildrenToSidebarSection(contentSections, 'settings', [BILLING_SIDEBAR_LAUNCHER_ITEM]),
+                },
+            };
+        }
+    }
+    const rawCmd = next[commandKey];
+    if (rawCmd === false) {
+        return next;
+    }
+    if (rawCmd === true) {
+        return {
+            ...next,
+            [commandKey]: {
+                policy: CommandBarPolicy.COMMAND_ONLY,
+                showRecent: true,
+                maxRecentItems: 5,
+                showShortcuts: true,
+                commands: mergeCommandMenuCommandLists(undefined, [BILLING_COMMAND_MENU_ITEM]),
+            },
+        };
+    }
+    if (typeof rawCmd === 'object' && rawCmd !== null) {
+        const cmdObj = rawCmd;
+        return {
+            ...next,
+            [commandKey]: {
+                policy: cmdObj.policy ?? CommandBarPolicy.COMMAND_ONLY,
+                showRecent: cmdObj.showRecent !== false,
+                maxRecentItems: cmdObj.maxRecentItems ?? 5,
+                showShortcuts: cmdObj.showShortcuts !== false,
+                commands: mergeCommandMenuCommandLists(cmdObj.commands, [BILLING_COMMAND_MENU_ITEM]),
+            },
+        };
+    }
+    return next;
+}
+/**
+ * Merges engine billing `fullCustomViews` + sidebar/command launcher rows into a frontend
+ * config. Safe to compose with app-specific `fullCustomViews` / shell overrides — uses
+ * ref-based deduping. Billing rows use `omitUnlessBillingEnabled` and are hidden at
+ * runtime when `BillingContext.isEnabled` is false.
+ */
+export function applyEngineBillingToFrontendConfig(config) {
+    return {
+        ...config,
+        fullCustomViews: mergeFullCustomViewsByRef(config.fullCustomViews, [BILLING_FULL_CUSTOM_VIEW]),
+        appComponentsConfiguration: mergeAppShellWithBilling(config.appComponentsConfiguration),
+    };
+}
+//# sourceMappingURL=apply-engine-billing.frontend.js.map

package/dist/esm/core/billing/apply-engine-billing.frontend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-engine-billing.frontend.js","sourceRoot":"","sources":["../../../../src/core/billing/apply-engine-billing.frontend.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oEAAoE,CAAC;AACtG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uEAAuE,CAAC;AACtH,OAAO,EACL,iCAAiC,EACjC,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,wDAAwD,CAAC;AAGhE,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,mDAAmD,CAAC;AAE3D;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAAqC;IAErC,MAAM,UAAU,GAAG,6BAA6B,CAAC,OAAO,CAAC;IACzD,MAAM,UAAU,GAAG,6BAA6B,CAAC,YAAY,CAAC;IAE9D,IAAI,IAAI,GAAmC,EAAE,GAAG,KAAK,EAAE,CAAC;IAExD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,IAAI,iBAAiB,IAAI,UAAU,EAAE,CAAC;QAC7F,MAAM,eAAe,GAAI,UAAqD,CAAC,eAAe,CAAC;QAC/F,IAAI,eAAe,EAAE,MAAM,EAAE,CAAC;YAC5B,IAAI,GAAG;gBACL,GAAG,IAAI;gBACP,CAAC,UAAU,CAAC,EAAE;oBACZ,GAAG,UAAU;oBACb,eAAe,EAAE,iCAAiC,CAChD,eAAe,EACf,UAAU,EACV,CAAC,6BAA6B,CAAC,CAChC;iBACF;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IAChC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO;YACL,GAAG,IAAI;YACP,CAAC,UAAU,CAAC,EAAE;gBACZ,MAAM,EAAE,gBAAgB,CAAC,YAAY;gBACrC,UAAU,EAAE,IAAI;gBAChB,cAAc,EAAE,CAAC;gBACjB,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE,4BAA4B,CAAC,SAAS,EAAE,CAAC,yBAAyB,CAAC,CAAC;aAC/E;SACF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,MAMd,CAAC;QACF,OAAO;YACL,GAAG,IAAI;YACP,CAAC,UAAU,CAAC,EAAE;gBACZ,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,gBAAgB,CAAC,YAAY;gBACtD,UAAU,EAAE,MAAM,CAAC,UAAU,KAAK,KAAK;gBACvC,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,CAAC;gBAC1C,aAAa,EAAE,MAAM,CAAC,aAAa,KAAK,KAAK;gBAC7C,QAAQ,EAAE,4BAA4B,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,yBAAyB,CAAC,CAAC;aACrF;SACF,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kCAAkC,CAChD,MAAiC;IAEjC,OAAO;QACL,GAAG,MAAM;QACT,eAAe,EAAE,yBAAyB,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC,wBAAwB,CAAC,CAAC;QAC9F,0BAA0B,EAAE,wBAAwB,CAAC,MAAM,CAAC,0BAA0B,CAAC;KACxF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,9 @@
+import type { CommandMenuCommand } from '../../core/config/launcher-items.frontend.schemas.js';
+/**
+ * Transitional command-menu-only billing filter.
+ *
+ * Sidebar rows now use generic declarative `runtimeAvailability`; command menu
+ * keeps this temporary filter until its D-1 slice migrates too.
+ */
+export declare function filterCommandMenuCommandsUnlessBillingEnabled(commands: CommandMenuCommand[] | undefined, billingEnabled: boolean): CommandMenuCommand[] | undefined;
+//# sourceMappingURL=billing-launcher-filters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing-launcher-filters.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/billing-launcher-filters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EACnB,MAAM,iEAAiE,CAAC;AAEzE;;;;;GAKG;AACH,wBAAgB,6CAA6C,CAC3D,QAAQ,EAAE,kBAAkB,EAAE,GAAG,SAAS,EAC1C,cAAc,EAAE,OAAO,GACtB,kBAAkB,EAAE,GAAG,SAAS,CAGlC"}

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

@@ -0,0 +1,12 @@
+/**
+ * Transitional command-menu-only billing filter.
+ *
+ * Sidebar rows now use generic declarative `runtimeAvailability`; command menu
+ * keeps this temporary filter until its D-1 slice migrates too.
+ */
+export function filterCommandMenuCommandsUnlessBillingEnabled(commands, billingEnabled) {
+    if (!commands?.length)
+        return commands;
+    return commands.filter(cmd => !cmd.omitUnlessBillingEnabled || billingEnabled);
+}
+//# sourceMappingURL=billing-launcher-filters.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing-launcher-filters.js","sourceRoot":"","sources":["../../../../src/core/billing/billing-launcher-filters.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,UAAU,6CAA6C,CAC3D,QAA0C,EAC1C,cAAuB;IAEvB,IAAI,CAAC,QAAQ,EAAE,MAAM;QAAE,OAAO,QAAQ,CAAC;IACvC,OAAO,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,wBAAwB,IAAI,cAAc,CAAC,CAAC;AACjF,CAAC"}

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

@@ -0,0 +1,20 @@
+/**
+ * Declarative billing launcher entries + full-custom view definition.
+ *
+ * Presets merge these into `contentSections` / `commands` in presets-components
+ * (see `billing-shell.presets.ts` + explicit `fullCustomViews` in `presets.ts`).
+ * Sidebar and command-menu visibility now both use generic declarative
+ * `runtimeAvailability`.
+ */
+import type { FullCustomViewDefinition } from '../../core/config/full-custom-view.schemas.js';
+import { type CommandMenuCommand, type SidebarItem } from '../../core/config/launcher-items.frontend.schemas.js';
+/** View ref for the engine billing overview page (`/custom/:viewRef`). */
+export declare const BILLING_VIEW_REF = "billing";
+/** Component ref for the billing overview (resolved when FullCustomView renders real component). */
+export declare const BILLING_COMPONENT_REF = "billing-overview";
+export declare const BILLING_FULL_CUSTOM_VIEW: FullCustomViewDefinition;
+/** Sidebar row targeting the registered full-custom billing view. */
+export declare const BILLING_SIDEBAR_LAUNCHER_ITEM: SidebarItem;
+/** Command menu entry for the billing overview. */
+export declare const BILLING_COMMAND_MENU_ITEM: CommandMenuCommand;
+//# sourceMappingURL=billing-launcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing-launcher.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/billing-launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,0DAA0D,CAAC;AACzG,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,iEAAiE,CAAC;AAGzE,0EAA0E;AAC1E,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAE1C,oGAAoG;AACpG,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAMxD,eAAO,MAAM,wBAAwB,EAAE,wBAOtC,CAAC;AAEF,qEAAqE;AACrE,eAAO,MAAM,6BAA6B,EAAE,WAK3C,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,yBAAyB,EAAE,kBAMvC,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Declarative billing launcher entries + full-custom view definition.
+ *
+ * Presets merge these into `contentSections` / `commands` in presets-components
+ * (see `billing-shell.presets.ts` + explicit `fullCustomViews` in `presets.ts`).
+ * Sidebar and command-menu visibility now both use generic declarative
+ * `runtimeAvailability`.
+ */
+import { CoreResourceOperation, ResourcePrimaryScope } from '@wildo-ai/saas-models';
+import { SidebarItemDisplayPolicy } from '../../core/config/app-level-components.frontend.schemas.js';
+import { LauncherItemTargetKind, } from '../../core/config/launcher-items.frontend.schemas.js';
+import { FrontendView_ScopeMode } from '../../core/config/views-frontend.schemas.js';
+/** View ref for the engine billing overview page (`/custom/:viewRef`). */
+export const BILLING_VIEW_REF = 'billing';
+/** Component ref for the billing overview (resolved when FullCustomView renders real component). */
+export const BILLING_COMPONENT_REF = 'billing-overview';
+const BILLING_RUNTIME_AVAILABILITY = {
+    requiredCapabilities: ['billingEnabled'],
+};
+export const BILLING_FULL_CUSTOM_VIEW = {
+    scope: FrontendView_ScopeMode.APPLICATION,
+    ref: BILLING_VIEW_REF,
+    isAddressable: true,
+    operationLike: CoreResourceOperation.READ,
+    primaryScope: ResourcePrimaryScope.ORGANIZATIONS,
+    componentRef: BILLING_COMPONENT_REF,
+};
+/** Sidebar row targeting the registered full-custom billing view. */
+export const BILLING_SIDEBAR_LAUNCHER_ITEM = {
+    kind: LauncherItemTargetKind.VIEW,
+    viewRef: BILLING_VIEW_REF,
+    displayPolicy: SidebarItemDisplayPolicy.ALWAYS,
+    runtimeAvailability: BILLING_RUNTIME_AVAILABILITY,
+};
+/** Command menu entry for the billing overview. */
+export const BILLING_COMMAND_MENU_ITEM = {
+    kind: LauncherItemTargetKind.VIEW,
+    viewRef: BILLING_VIEW_REF,
+    category: 'billing',
+    searchKeywords: ['billing', 'subscription', 'plan', 'payment', 'invoice', 'upgrade'],
+    runtimeAvailability: BILLING_RUNTIME_AVAILABILITY,
+};
+//# sourceMappingURL=billing-launcher.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing-launcher.js","sourceRoot":"","sources":["../../../../src/core/billing/billing-launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,OAAO,EAAE,wBAAwB,EAAE,MAAM,uEAAuE,CAAC;AAEjH,OAAO,EACL,sBAAsB,GAIvB,MAAM,iEAAiE,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wDAAwD,CAAC;AAEhG,0EAA0E;AAC1E,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAE1C,oGAAoG;AACpG,MAAM,CAAC,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAExD,MAAM,4BAA4B,GAAsC;IACtE,oBAAoB,EAAE,CAAC,gBAAgB,CAAC;CACzC,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAA6B;IAChE,KAAK,EAAE,sBAAsB,CAAC,WAAW;IACzC,GAAG,EAAE,gBAAgB;IACrB,aAAa,EAAE,IAAI;IACnB,aAAa,EAAE,qBAAqB,CAAC,IAAI;IACzC,YAAY,EAAE,oBAAoB,CAAC,aAAa;IAChD,YAAY,EAAE,qBAAqB;CACpC,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,6BAA6B,GAAgB;IACxD,IAAI,EAAE,sBAAsB,CAAC,IAAI;IACjC,OAAO,EAAE,gBAAgB;IACzB,aAAa,EAAE,wBAAwB,CAAC,MAAM;IAC9C,mBAAmB,EAAE,4BAA4B;CAClD,CAAC;AAEF,mDAAmD;AACnD,MAAM,CAAC,MAAM,yBAAyB,GAAuB;IAC3D,IAAI,EAAE,sBAAsB,CAAC,IAAI;IACjC,OAAO,EAAE,gBAAgB;IACzB,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"}