@wildo-ai/saas-frontend-lib 1.0.1

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

@@ -0,0 +1,20 @@
+/**
+ * useBilling Hook
+ *
+ * Separated from BillingContext.tsx for React Fast Refresh compatibility.
+ * Provides access to the billing context: state, actions, and product catalog.
+ */
+import { type BillingContextType } from './BillingContext.js';
+/**
+ * Hook to access the Billing context.
+ * @returns BillingContextType with billing state, actions, and product catalog.
+ * @throws Error if used outside of BillingProvider.
+ */
+export declare const useBilling: () => BillingContextType;
+/**
+ * Safe version that returns undefined if outside provider.
+ * Useful for components that may render before the provider is mounted
+ * or in contexts where billing may not be enabled.
+ */
+export declare const useBillingSafe: () => BillingContextType | undefined;
+//# sourceMappingURL=useBilling.d.ts.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * useBilling Hook
+ *
+ * Separated from BillingContext.tsx for React Fast Refresh compatibility.
+ * Provides access to the billing context: state, actions, and product catalog.
+ */
+import { useContext } from 'react';
+import { BillingContext } from './BillingContext.js';
+/**
+ * Hook to access the Billing context.
+ * @returns BillingContextType with billing state, actions, and product catalog.
+ * @throws Error if used outside of BillingProvider.
+ */
+export const useBilling = () => {
+    const context = useContext(BillingContext);
+    if (!context) {
+        throw new Error('useBilling must be used within a BillingProvider');
+    }
+    return context;
+};
+/**
+ * Safe version that returns undefined if outside provider.
+ * Useful for components that may render before the provider is mounted
+ * or in contexts where billing may not be enabled.
+ */
+export const useBillingSafe = () => {
+    return useContext(BillingContext);
+};
+//# sourceMappingURL=useBilling.js.map

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

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

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

@@ -0,0 +1,22 @@
+/**
+ * useBillingAction Hook
+ *
+ * Resolves the appropriate billing action from a FeatureAvailability object.
+ * Used by FeatureRouteGuard, FeatureGate, and action bar buttons to wire
+ * feature unavailability prompts to billing checkout or customer portal flows.
+ *
+ * If billing is not enabled (useBillingSafe returns undefined), the action is a no-op.
+ */
+import type { FeatureAvailability } from '../../core/features/useFeatureAvailability.js';
+/**
+ * Returns a callback that executes the appropriate billing action for a given FeatureAvailability.
+ *
+ * - upgrade_prompt / limit_upgrade_prompt → openCheckout with suggested product + default price
+ * - addon_prompt → openCheckout with suggested addon product + default price
+ * - contact_admin → no-op (no billing action)
+ * - disable / hide / custom → no-op
+ *
+ * Falls back gracefully when billing is not enabled.
+ */
+export declare function useBillingAction(): (availability: FeatureAvailability) => void;
+//# sourceMappingURL=useBillingAction.d.ts.map

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

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

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

@@ -0,0 +1,74 @@
+/**
+ * useBillingAction Hook
+ *
+ * Resolves the appropriate billing action from a FeatureAvailability object.
+ * Used by FeatureRouteGuard, FeatureGate, and action bar buttons to wire
+ * feature unavailability prompts to billing checkout or customer portal flows.
+ *
+ * If billing is not enabled (useBillingSafe returns undefined), the action is a no-op.
+ */
+import { useCallback } from 'react';
+import { FeatureUnavailabilityBehavior } from '@wildo-ai/saas-models';
+import { useBillingSafe } from './useBilling.js';
+import { useSafeBillingActionExecutor } from './useSafeBillingActionExecutor.js';
+/**
+ * Returns a callback that executes the appropriate billing action for a given FeatureAvailability.
+ *
+ * - upgrade_prompt / limit_upgrade_prompt → openCheckout with suggested product + default price
+ * - addon_prompt → openCheckout with suggested addon product + default price
+ * - contact_admin → no-op (no billing action)
+ * - disable / hide / custom → no-op
+ *
+ * Falls back gracefully when billing is not enabled.
+ */
+export function useBillingAction() {
+    const billing = useBillingSafe();
+    const runBillingActionSafely = useSafeBillingActionExecutor();
+    return useCallback((availability) => {
+        if (!billing || !billing.isEnabled)
+            return;
+        const { behavior, suggestedProductRef, upgradeOptions } = availability;
+        // Determine which product/price to use for checkout
+        let productKey;
+        let priceId;
+        // Try the suggestedProductRef first (per-feature override)
+        if (suggestedProductRef) {
+            const product = billing.getProductByKey(suggestedProductRef);
+            if (product) {
+                productKey = product.key;
+                const prices = billing.getPricesForProduct(product._id);
+                const defaultPrice = prices.find(p => p.isDefault) ?? prices[0];
+                priceId = defaultPrice?._id;
+            }
+        }
+        // Fallback to upgrade options from resolved features
+        if (!productKey && upgradeOptions && upgradeOptions.length > 0) {
+            const firstOption = upgradeOptions[0];
+            if (firstOption) {
+                productKey = firstOption.productKey;
+                priceId = firstOption.priceId;
+            }
+        }
+        switch (behavior) {
+            case FeatureUnavailabilityBehavior.UPGRADE_PROMPT:
+            case FeatureUnavailabilityBehavior.LIMIT_UPGRADE_PROMPT:
+            case FeatureUnavailabilityBehavior.ADDON_PROMPT:
+                if (productKey && priceId) {
+                    runBillingActionSafely(() => billing.openCheckout(productKey, priceId));
+                }
+                else {
+                    // No specific product found — open customer portal as fallback
+                    runBillingActionSafely(() => billing.openCustomerPortal());
+                }
+                break;
+            case FeatureUnavailabilityBehavior.CONTACT_ADMIN:
+            case FeatureUnavailabilityBehavior.DISABLE:
+            case FeatureUnavailabilityBehavior.HIDE:
+            case FeatureUnavailabilityBehavior.CUSTOM:
+            default:
+                // No billing action for these behaviors
+                break;
+        }
+    }, [billing, runBillingActionSafely]);
+}
+//# sourceMappingURL=useBillingAction.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * useBillingNavigationItems
+ *
+ * Optional hook for **programmatic** navigation lists (outside declarative launcher config).
+ * Prefer preset-driven `BILLING_SIDEBAR_LAUNCHER_ITEM` / `BILLING_COMMAND_MENU_ITEM` merged
+ * in presets-components (`billing-shell.presets.ts` + `presets.ts` `fullCustomViews`).
+ *
+ * When billing is enabled, returns a single `ViewNavigationItem` for the billing full-custom
+ * view (`/custom/billing` when resolved through the router).
+ */
+import { type AnyNavigationItem } from '../../core/navigation/navigation.schemas.js';
+/**
+ * Returns billing navigation items when billing is enabled.
+ * Returns an empty array when billing is disabled or not configured.
+ *
+ * The items are:
+ * - "Billing" — main billing page (subscription status, portal, usage)
+ *   Appears in: sidebar (settings section), command menu
+ */
+export declare function useBillingNavigationItems(): AnyNavigationItem[];
+//# sourceMappingURL=useBillingNavigationItems.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingNavigationItems.d.ts","sourceRoot":"","sources":["../../../../src/core/billing/useBillingNavigationItems.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,wDAAwD,CAAC;AAMhE;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,IAAI,iBAAiB,EAAE,CAkC/D"}

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

@@ -0,0 +1,57 @@
+/**
+ * useBillingNavigationItems
+ *
+ * Optional hook for **programmatic** navigation lists (outside declarative launcher config).
+ * Prefer preset-driven `BILLING_SIDEBAR_LAUNCHER_ITEM` / `BILLING_COMMAND_MENU_ITEM` merged
+ * in presets-components (`billing-shell.presets.ts` + `presets.ts` `fullCustomViews`).
+ *
+ * When billing is enabled, returns a single `ViewNavigationItem` for the billing full-custom
+ * view (`/custom/billing` when resolved through the router).
+ */
+import { useMemo } from 'react';
+import { SidebarItemDisplayPolicy } from '../../core/config/app-level-components.frontend.schemas.js';
+import { useBillingSafe } from './useBilling.js';
+import { BILLING_COMPONENT_REF, BILLING_VIEW_REF, } from '../../core/billing/billing-launcher.js';
+import { useIconRegistry } from '../../core/icons/useIconRegistry.js';
+import { IconSize, StandardIconReference } from '../../core/icons/icon-registry.frontend.schemas.js';
+import { useI18n } from '../../core/i18n/useI18n.js';
+import { NavigationContentType, NavigationItemType, } from '../../core/navigation/navigation.schemas.js';
+// ================================
+// Hook
+// ================================
+/**
+ * Returns billing navigation items when billing is enabled.
+ * Returns an empty array when billing is disabled or not configured.
+ *
+ * The items are:
+ * - "Billing" — main billing page (subscription status, portal, usage)
+ *   Appears in: sidebar (settings section), command menu
+ */
+export function useBillingNavigationItems() {
+    const billing = useBillingSafe();
+    const { renderIcon } = useIconRegistry();
+    const { tResourceHeader, isReady } = useI18n({ resource: BILLING_VIEW_REF });
+    return useMemo(() => {
+        if (!billing || !billing.isEnabled)
+            return [];
+        const billingIcon = renderIcon(StandardIconReference.CREDIT_CARD, { size: IconSize.SM });
+        const label = tResourceHeader(BILLING_VIEW_REF, 'title');
+        const billingItem = {
+            itemType: NavigationItemType.VIEW,
+            id: 'nav-billing-overview',
+            ref: `view:fullCustom:${BILLING_VIEW_REF}`,
+            label,
+            urlPath: `/custom/${BILLING_VIEW_REF}`,
+            viewRef: BILLING_VIEW_REF,
+            contentType: NavigationContentType.FULL_CUSTOM_VIEW,
+            fullCustomComponentRef: BILLING_COMPONENT_REF,
+            icon: billingIcon,
+            section: 'settings',
+            displayPolicy: SidebarItemDisplayPolicy.ALWAYS,
+            searchKeywords: ['billing', 'subscription', 'plan', 'payment', 'invoice', 'upgrade'],
+            commandCategory: 'Billing',
+        };
+        return [billingItem];
+    }, [billing, renderIcon, tResourceHeader]);
+}
+//# sourceMappingURL=useBillingNavigationItems.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingNavigationItems.js","sourceRoot":"","sources":["../../../../src/core/billing/useBillingNavigationItems.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,wBAAwB,EAAE,MAAM,uEAAuE,CAAC;AACjH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EACL,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,mDAAmD,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,+DAA+D,CAAC;AAChH,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,GAGnB,MAAM,wDAAwD,CAAC;AAEhE,mCAAmC;AACnC,OAAO;AACP,mCAAmC;AAEnC;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB;IACvC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;IACjC,MAAM,EAAE,UAAU,EAAE,GAAG,eAAe,EAAE,CAAC;IACzC,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAG7E,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAE9C,MAAM,WAAW,GAAG,UAAU,CAC5B,qBAAqB,CAAC,WAAW,EACjC,EAAE,IAAI,EAAE,QAAQ,CAAC,EAAE,EAAE,CACtB,CAAC;QAEF,MAAM,KAAK,GAAG,eAAe,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QAEzD,MAAM,WAAW,GAAuB;YACtC,QAAQ,EAAE,kBAAkB,CAAC,IAAI;YACjC,EAAE,EAAE,sBAAsB;YAC1B,GAAG,EAAE,mBAAmB,gBAAgB,EAAE;YAC1C,KAAK;YACL,OAAO,EAAE,WAAW,gBAAgB,EAAE;YACtC,OAAO,EAAE,gBAAgB;YACzB,WAAW,EAAE,qBAAqB,CAAC,gBAAgB;YACnD,sBAAsB,EAAE,qBAAqB;YAC7C,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,UAAU;YACnB,aAAa,EAAE,wBAAwB,CAAC,MAAM;YAC9C,cAAc,EAAE,CAAC,SAAS,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC;YACpF,eAAe,EAAE,SAAS;SAC3B,CAAC;QAEF,OAAO,CAAC,WAAW,CAAC,CAAC;IACvB,CAAC,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC,CAAC;AAC7C,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Wrap billing UI actions so user-triggered checkout / portal failures surface
+ * through the notification system instead of becoming dropped promise rejections.
+ */
+export declare function useSafeBillingActionExecutor(): (action: () => Promise<void>) => void;
+//# sourceMappingURL=useSafeBillingActionExecutor.d.ts.map

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

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

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

@@ -0,0 +1,18 @@
+import { useCallback } from 'react';
+import { useNotification } from '../../core/events/useNotification.js';
+/**
+ * Wrap billing UI actions so user-triggered checkout / portal failures surface
+ * through the notification system instead of becoming dropped promise rejections.
+ */
+export function useSafeBillingActionExecutor() {
+    const { notifyError } = useNotification();
+    return useCallback((action) => {
+        void action().catch((error) => {
+            const message = error instanceof Error
+                ? error.message
+                : 'An unexpected billing error occurred';
+            notifyError(message);
+        });
+    }, [notifyError]);
+}
+//# sourceMappingURL=useSafeBillingActionExecutor.js.map

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

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

package/dist/esm/core/commons/devices.frontend.schemas.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Device Shared Schemas
+ *
+ * Centralized device-related schemas and enums
+ */
+import { z } from 'zod';
+/**
+ * Device type enum for authentication, sessions, and DTOs
+ */
+export declare enum DeviceType {
+    DESKTOP = "desktop",
+    MOBILE = "mobile",
+    TABLET = "tablet",
+    API = "api"
+}
+/**
+ * SameSite cookie option enum
+ */
+export declare enum SameSite {
+    STRICT = "strict",
+    LAX = "lax",
+    NONE = "none"
+}
+export declare const DeviceInfoSchema: z.ZodObject<{
+    userAgent: z.ZodString;
+    ipAddress: z.ZodIPv4;
+    deviceType: z.ZodDefault<z.ZodEnum<typeof DeviceType>>;
+    location: z.ZodOptional<z.ZodString>;
+    fingerprint: z.ZodOptional<z.ZodString>;
+}, z.core.$strip, core.$ZodObjectExtra>;
+export type DeviceInfo = z.infer<typeof DeviceInfoSchema>;
+export type DeviceTypeValue = DeviceType;
+//# sourceMappingURL=devices.frontend.schemas.d.ts.map

package/dist/esm/core/commons/devices.frontend.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/commons/devices.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,oBAAY,UAAU;IACpB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,oBAAY,QAAQ;IAClB,MAAM,WAAW;IACjB,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,eAAO,MAAM,gBAAgB;;;;;;uCAM3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAG1D,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC"}

package/dist/esm/core/commons/devices.frontend.schemas.js

@@ -0,0 +1,33 @@
+/**
+ * Device Shared Schemas
+ *
+ * Centralized device-related schemas and enums
+ */
+import { z } from 'zod';
+/**
+ * Device type enum for authentication, sessions, and DTOs
+ */
+export var DeviceType;
+(function (DeviceType) {
+    DeviceType["DESKTOP"] = "desktop";
+    DeviceType["MOBILE"] = "mobile";
+    DeviceType["TABLET"] = "tablet";
+    DeviceType["API"] = "api";
+})(DeviceType || (DeviceType = {}));
+/**
+ * SameSite cookie option enum
+ */
+export var SameSite;
+(function (SameSite) {
+    SameSite["STRICT"] = "strict";
+    SameSite["LAX"] = "lax";
+    SameSite["NONE"] = "none";
+})(SameSite || (SameSite = {}));
+export const DeviceInfoSchema = z.object({
+    userAgent: z.string().min(1, 'User agent is required'),
+    ipAddress: z.ipv4(),
+    deviceType: z.enum(DeviceType).default(DeviceType.DESKTOP),
+    location: z.string().optional(),
+    fingerprint: z.string().optional()
+});
+//# sourceMappingURL=devices.frontend.schemas.js.map

package/dist/esm/core/commons/devices.frontend.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devices.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/commons/devices.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAN,IAAY,UAKX;AALD,WAAY,UAAU;IACpB,iCAAmB,CAAA;IACnB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,yBAAW,CAAA;AACb,CAAC,EALW,UAAU,KAAV,UAAU,QAKrB;AAED;;GAEG;AACH,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,6BAAiB,CAAA;IACjB,uBAAW,CAAA;IACX,yBAAa,CAAA;AACf,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE;IACnB,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;IAC1D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC"}

package/dist/esm/core/commons/local-storage.frontend.schemas.d.ts

@@ -0,0 +1,45 @@
+/**
+ * [Capacitor] [OAuth2] [SAML]
+ * This module is the single abstraction point for persistent key-value storage.
+ * Currently backed by browser localStorage.
+ *
+ * When Ionic Capacitor is introduced, these functions should be swapped to use
+ * platform-aware secure storage:
+ * - iOS: Keychain via @capacitor/preferences or @nicepkg/capacitor-secure-storage
+ * - Android: Keystore-backed EncryptedSharedPreferences
+ * - Web: remains localStorage (or optionally IndexedDB for larger payloads)
+ *
+ * Critical keys affected:
+ * - JWT_TOKEN, REFRESH_TOKEN — auth tokens must be encrypted at rest on mobile
+ * - All other keys are non-sensitive preferences, but should move to the same
+ *   backend for consistency (Capacitor Preferences API is async, so the getters
+ *   will need to become async too — plan for that interface change).
+ */
+export declare enum LOCAL_STORAGE_KEYS {
+    JWT_TOKEN = "jwtToken",
+    REFRESH_TOKEN = "refreshToken",
+    LANGUAGE = "language",
+    CURRENT_ORGANIZATION_ID = "currentOrganizationId",
+    SCOPE_VALUES = "scopeValues",
+    SIDEBAR_SECTION_COLLAPSED = "wildo-sidebar-section-collapsed",
+    ANONYMOUS_USER_ID = "anonymousUserId",
+    ANONYMOUS_SESSION_TOKEN = "anonymousSessionToken"
+}
+/**
+ * Get an item from localStorage
+ * @param key - The key to retrieve
+ * @returns The stored value or null if not found or unavailable
+ */
+export declare const getLocalStorageItem: (key: string) => string | null;
+/**
+ * Set an item in localStorage
+ * @param key - The key to store
+ * @param value - The value to store
+ */
+export declare const setLocalStorageItem: (key: string, value: string) => void;
+/**
+ * Remove an item from localStorage
+ * @param key - The key to remove
+ */
+export declare const removeLocalStorageItem: (key: string) => void;
+//# sourceMappingURL=local-storage.frontend.schemas.d.ts.map

package/dist/esm/core/commons/local-storage.frontend.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/commons/local-storage.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,oBAAY,kBAAkB;IAC5B,SAAS,aAA4B;IACrC,aAAa,iBAA4B;IACzC,QAAQ,aAA6B;IACrC,uBAAuB,0BAA2B;IAClD,YAAY,gBAA4B;IACxC,yBAAyB,oCAAoC;IAC7D,iBAAiB,oBAA2B;IAC5C,uBAAuB,0BAA2B;CACnD;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAO1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,IAOhE,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,MAAM,KAAG,IAOpD,CAAC"}

package/dist/esm/core/commons/local-storage.frontend.schemas.js

@@ -0,0 +1,73 @@
+/**
+ * [Capacitor] [OAuth2] [SAML]
+ * This module is the single abstraction point for persistent key-value storage.
+ * Currently backed by browser localStorage.
+ *
+ * When Ionic Capacitor is introduced, these functions should be swapped to use
+ * platform-aware secure storage:
+ * - iOS: Keychain via @capacitor/preferences or @nicepkg/capacitor-secure-storage
+ * - Android: Keystore-backed EncryptedSharedPreferences
+ * - Web: remains localStorage (or optionally IndexedDB for larger payloads)
+ *
+ * Critical keys affected:
+ * - JWT_TOKEN, REFRESH_TOKEN — auth tokens must be encrypted at rest on mobile
+ * - All other keys are non-sensitive preferences, but should move to the same
+ *   backend for consistency (Capacitor Preferences API is async, so the getters
+ *   will need to become async too — plan for that interface change).
+ */
+export var LOCAL_STORAGE_KEYS;
+(function (LOCAL_STORAGE_KEYS) {
+    LOCAL_STORAGE_KEYS["JWT_TOKEN"] = "jwtToken";
+    LOCAL_STORAGE_KEYS["REFRESH_TOKEN"] = "refreshToken";
+    LOCAL_STORAGE_KEYS["LANGUAGE"] = "language";
+    LOCAL_STORAGE_KEYS["CURRENT_ORGANIZATION_ID"] = "currentOrganizationId";
+    LOCAL_STORAGE_KEYS["SCOPE_VALUES"] = "scopeValues";
+    LOCAL_STORAGE_KEYS["SIDEBAR_SECTION_COLLAPSED"] = "wildo-sidebar-section-collapsed";
+    LOCAL_STORAGE_KEYS["ANONYMOUS_USER_ID"] = "anonymousUserId";
+    LOCAL_STORAGE_KEYS["ANONYMOUS_SESSION_TOKEN"] = "anonymousSessionToken";
+})(LOCAL_STORAGE_KEYS || (LOCAL_STORAGE_KEYS = {}));
+/**
+ * Get an item from localStorage
+ * @param key - The key to retrieve
+ * @returns The stored value or null if not found or unavailable
+ */
+export const getLocalStorageItem = (key) => {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        return localStorage.getItem(key);
+    }
+    catch {
+        return null;
+    }
+};
+/**
+ * Set an item in localStorage
+ * @param key - The key to store
+ * @param value - The value to store
+ */
+export const setLocalStorageItem = (key, value) => {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        localStorage.setItem(key, value);
+    }
+    catch {
+        // Silently fail if localStorage is not available
+    }
+};
+/**
+ * Remove an item from localStorage
+ * @param key - The key to remove
+ */
+export const removeLocalStorageItem = (key) => {
+    if (typeof window === 'undefined')
+        return;
+    try {
+        localStorage.removeItem(key);
+    }
+    catch {
+        // Silently fail if localStorage is not available
+    }
+};
+//# sourceMappingURL=local-storage.frontend.schemas.js.map

package/dist/esm/core/commons/local-storage.frontend.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-storage.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/commons/local-storage.frontend.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,CAAN,IAAY,kBASX;AATD,WAAY,kBAAkB;IAC5B,4CAAqC,CAAA;IACrC,oDAAyC,CAAA;IACzC,2CAAqC,CAAA;IACrC,uEAAkD,CAAA;IAClD,kDAAwC,CAAA;IACxC,mFAA6D,CAAA;IAC7D,2DAA4C,CAAA;IAC5C,uEAAkD,CAAA;AACpD,CAAC,EATW,kBAAkB,KAAlB,kBAAkB,QAS7B;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAiB,EAAE;IAChE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAE,KAAa,EAAQ,EAAE;IACtE,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC1D,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,CAAC;QACH,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,iDAAiD;IACnD,CAAC;AACH,CAAC,CAAC"}

package/dist/esm/core/commons/window-event.frontend.schemas.d.ts

@@ -0,0 +1,10 @@
+export declare enum WINDOW_EVENTS_SLUGS {
+    LOGOUT = "logout",
+    RESET_ALL_CONTEXT = "resetAllContext",
+    REFRESH_TOKEN = "refresh_token"
+}
+export type WindowEventHandler = {
+    slugs: WINDOW_EVENTS_SLUGS;
+    handler: (e: CustomEvent) => void;
+};
+//# sourceMappingURL=window-event.frontend.schemas.d.ts.map

package/dist/esm/core/commons/window-event.frontend.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-event.frontend.schemas.d.ts","sourceRoot":"","sources":["../../../../src/core/commons/window-event.frontend.schemas.ts"],"names":[],"mappings":"AAEA,oBAAY,mBAAmB;IAC7B,MAAM,WAAW;IACjB,iBAAiB,oBAAoB;IACrC,aAAa,kBAAkB;CAChC;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,mBAAmB,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;CACnC,CAAA"}

package/dist/esm/core/commons/window-event.frontend.schemas.js

@@ -0,0 +1,7 @@
+export var WINDOW_EVENTS_SLUGS;
+(function (WINDOW_EVENTS_SLUGS) {
+    WINDOW_EVENTS_SLUGS["LOGOUT"] = "logout";
+    WINDOW_EVENTS_SLUGS["RESET_ALL_CONTEXT"] = "resetAllContext";
+    WINDOW_EVENTS_SLUGS["REFRESH_TOKEN"] = "refresh_token";
+})(WINDOW_EVENTS_SLUGS || (WINDOW_EVENTS_SLUGS = {}));
+//# sourceMappingURL=window-event.frontend.schemas.js.map

package/dist/esm/core/commons/window-event.frontend.schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window-event.frontend.schemas.js","sourceRoot":"","sources":["../../../../src/core/commons/window-event.frontend.schemas.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,mBAIX;AAJD,WAAY,mBAAmB;IAC7B,wCAAiB,CAAA;IACjB,4DAAqC,CAAA;IACrC,sDAA+B,CAAA;AACjC,CAAC,EAJW,mBAAmB,KAAnB,mBAAmB,QAI9B"}

package/dist/esm/core/components-registry/ComponentNotInjected.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+interface ComponentNotInjectedProps {
+    componentType: string;
+    componentName: string;
+    [key: string]: unknown;
+}
+export declare function ComponentNotInjected({ componentType, componentName }: ComponentNotInjectedProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=ComponentNotInjected.d.ts.map

package/dist/esm/core/components-registry/ComponentNotInjected.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentNotInjected.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/ComponentNotInjected.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,UAAU,yBAAyB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAgB,oBAAoB,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,EAAE,yBAAyB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA2BnH"}

package/dist/esm/core/components-registry/ComponentNotInjected.js

@@ -0,0 +1,17 @@
+import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function ComponentNotInjected({ componentType, componentName }) {
+    if (process.env.NODE_ENV === 'production') {
+        return _jsx(_Fragment, {});
+    }
+    return (_jsxs("div", { style: {
+            border: '2px dashed #ef4444',
+            borderRadius: '6px',
+            padding: '12px 16px',
+            margin: '4px 0',
+            backgroundColor: '#fef2f2',
+            color: '#991b1b',
+            fontSize: '13px',
+            fontFamily: 'system-ui, sans-serif',
+        }, children: [_jsx("div", { style: { fontWeight: 600, marginBottom: '4px' }, children: "Component not injected" }), _jsxs("div", { style: { fontSize: '12px', opacity: 0.8 }, children: [_jsx("strong", { children: componentName }), " (", componentType, ") has no registered preset. Register it via ", _jsx("code", { children: "registerDefaultPresets()" }), " in your app entry point."] })] }));
+}
+//# sourceMappingURL=ComponentNotInjected.js.map

package/dist/esm/core/components-registry/ComponentNotInjected.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComponentNotInjected.js","sourceRoot":"","sources":["../../../../src/core/components-registry/ComponentNotInjected.tsx"],"names":[],"mappings":";AAQA,MAAM,UAAU,oBAAoB,CAAC,EAAE,aAAa,EAAE,aAAa,EAA6B;IAC9F,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC1C,OAAO,mBAAK,CAAC;IACf,CAAC;IAED,OAAO,CACL,eACE,KAAK,EAAE;YACL,MAAM,EAAE,oBAAoB;YAC5B,YAAY,EAAE,KAAK;YACnB,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,OAAO;YACf,eAAe,EAAE,SAAS;YAC1B,KAAK,EAAE,SAAS;YAChB,QAAQ,EAAE,MAAM;YAChB,UAAU,EAAE,uBAAuB;SACpC,aAED,cAAK,KAAK,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,uCAE9C,EACN,eAAK,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,aAC5C,2BAAS,aAAa,GAAU,QAAG,aAAa,kDAChC,sDAAqC,iCACjD,IACF,CACP,CAAC;AACJ,CAAC"}

package/dist/esm/core/components-registry/component-registry-loader.frontend.service.d.ts

@@ -0,0 +1,18 @@
+import type { FrontendComponentRegistration } from '../runtime/domain-module.frontend.definitions.js';
+/**
+ * Load and register custom components from app-custom libraries
+ *
+ * Custom components are already imported in the runnable App.tsx,
+ * so their modules are already loaded. This function ensures they
+ * are registered in the ComponentRegistryService.
+ *
+ * This handles the case where custom components use the old
+ * registry pattern (direct component in registry object).
+ */
+export declare function loadCustomComponents(customRegistries: Array<Partial<Record<string, any>>>): void;
+export declare function getLoadingStats(): {
+    totalRegistered: number;
+    byCategory: Map<string, number>;
+};
+export declare function registerFrontendComponentRegistrations(registrations: FrontendComponentRegistration[]): void;
+//# sourceMappingURL=component-registry-loader.frontend.service.d.ts.map

package/dist/esm/core/components-registry/component-registry-loader.frontend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-registry-loader.frontend.service.d.ts","sourceRoot":"","sources":["../../../../src/core/components-registry/component-registry-loader.frontend.service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+CAA+C,CAAC;AAOnG;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,GACpD,IAAI,CAsCN;AAED,wBAAgB,eAAe,IAAI;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAgBA;AAED,wBAAgB,sCAAsC,CACpD,aAAa,EAAE,6BAA6B,EAAE,GAC7C,IAAI,CASN"}