@23blocks/react 1.1.1 → 1.1.3

package/dist/index.esm.js

@@ -0,0 +1,1306 @@
+import { _ } from '@swc/helpers/_/_extends';
+import { jsx } from 'react/jsx-runtime';
+import { useMemo, useCallback, createContext, useContext, useState } from 'react';
+import { createHttpTransport } from '@23blocks/transport-http';
+import { createAuthenticationBlock } from '@23blocks/block-authentication';
+import { createSearchBlock } from '@23blocks/block-search';
+import { createProductsBlock } from '@23blocks/block-products';
+import { createCrmBlock } from '@23blocks/block-crm';
+import { createContentBlock } from '@23blocks/block-content';
+import { createGeolocationBlock } from '@23blocks/block-geolocation';
+import { createConversationsBlock } from '@23blocks/block-conversations';
+import { createFilesBlock } from '@23blocks/block-files';
+import { createFormsBlock } from '@23blocks/block-forms';
+import { createAssetsBlock } from '@23blocks/block-assets';
+import { createCampaignsBlock } from '@23blocks/block-campaigns';
+import { createCompanyBlock } from '@23blocks/block-company';
+import { createRewardsBlock } from '@23blocks/block-rewards';
+import { createSalesBlock } from '@23blocks/block-sales';
+import { createWalletBlock } from '@23blocks/block-wallet';
+import { createJarvisBlock } from '@23blocks/block-jarvis';
+import { createOnboardingBlock } from '@23blocks/block-onboarding';
+import { createUniversityBlock } from '@23blocks/block-university';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Token Manager Implementation
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Generate storage key scoped to app and tenant
+ */ function getStorageKey(type, appId, tenantId) {
+    const scope = tenantId ? `${appId}_${tenantId}` : appId;
+    return `23blocks_${scope}_${type}_token`;
+}
+let MemoryStorage = class MemoryStorage {
+    getItem(key) {
+        var _this_data_get;
+        return (_this_data_get = this.data.get(key)) != null ? _this_data_get : null;
+    }
+    setItem(key, value) {
+        this.data.set(key, value);
+    }
+    removeItem(key) {
+        this.data.delete(key);
+    }
+    constructor(){
+        this.data = new Map();
+    }
+};
+function createTokenManager(appId, storageType, tenantId) {
+    const isBrowser = typeof window !== 'undefined' && typeof window.localStorage !== 'undefined';
+    const accessTokenKey = getStorageKey('access', appId, tenantId);
+    const refreshTokenKey = getStorageKey('refresh', appId, tenantId);
+    let storage;
+    if (!isBrowser) {
+        storage = new MemoryStorage();
+    } else {
+        switch(storageType){
+            case 'sessionStorage':
+                storage = window.sessionStorage;
+                break;
+            case 'memory':
+                storage = new MemoryStorage();
+                break;
+            default:
+                storage = window.localStorage;
+        }
+    }
+    return {
+        getAccessToken () {
+            try {
+                return storage.getItem(accessTokenKey);
+            } catch (e) {
+                return null;
+            }
+        },
+        getRefreshToken () {
+            try {
+                return storage.getItem(refreshTokenKey);
+            } catch (e) {
+                return null;
+            }
+        },
+        setTokens (accessToken, refreshToken) {
+            try {
+                storage.setItem(accessTokenKey, accessToken);
+                if (refreshToken) {
+                    storage.setItem(refreshTokenKey, refreshToken);
+                }
+            } catch (e) {
+                console.warn('[23blocks] Unable to store tokens');
+            }
+        },
+        clearTokens () {
+            try {
+                storage.removeItem(accessTokenKey);
+                storage.removeItem(refreshTokenKey);
+            } catch (e) {
+            // Silently fail
+            }
+        },
+        onStorageChange (callback) {
+            // Only works in browser with localStorage/sessionStorage
+            if (!isBrowser || storageType === 'memory') {
+                // Return no-op unsubscribe for SSR/memory storage
+                return ()=>{};
+            }
+            const handler = (event)=>{
+                // Only trigger if our keys changed
+                if (event.key === accessTokenKey || event.key === refreshTokenKey) {
+                    callback();
+                }
+            };
+            window.addEventListener('storage', handler);
+            // Return unsubscribe function
+            return ()=>{
+                window.removeEventListener('storage', handler);
+            };
+        }
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────────
+const Blocks23Context = /*#__PURE__*/ createContext(null);
+// ─────────────────────────────────────────────────────────────────────────────
+// Provider Component
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Helper to create a proxy that throws when accessing unconfigured service
+ */ function createUnconfiguredServiceProxy(serviceName, urlKey) {
+    return new Proxy({}, {
+        get (_target, prop) {
+            throw new Error(`[23blocks] Cannot access '${serviceName}.${String(prop)}': ` + `The ${serviceName} service URL is not configured. ` + `Add 'urls.${urlKey}' to your Provider configuration.`);
+        }
+    });
+}
+/**
+ * Provider component for 23blocks services.
+ *
+ * Wrap your app with this provider to access all 23blocks services
+ * with automatic token management.
+ *
+ * Services are only available if their URL is configured. Accessing
+ * a service without a configured URL will throw an error.
+ *
+ * @example Basic usage with multiple services
+ * ```tsx
+ * import { Provider } from '@23blocks/react';
+ *
+ * function App() {
+ *   return (
+ *     <Provider
+ *       appId="your-app-id"
+ *       urls={{
+ *         authentication: 'https://gateway.23blocks.com',
+ *         crm: 'https://crm.23blocks.com',
+ *         products: 'https://products.23blocks.com',
+ *       }}
+ *     >
+ *       <MyApp />
+ *     </Provider>
+ *   );
+ * }
+ * ```
+ *
+ * @example Cookie mode (recommended for security)
+ * ```tsx
+ * <Provider
+ *   appId="your-app-id"
+ *   authMode="cookie"
+ *   urls={{
+ *     authentication: 'https://gateway.23blocks.com',
+ *     crm: 'https://crm.23blocks.com',
+ *   }}
+ * >
+ *   <MyApp />
+ * </Provider>
+ * ```
+ */ function Provider({ children, urls, appId, tenantId, authMode = 'token', storage = 'localStorage', headers: staticHeaders = {}, timeout }) {
+    // Create token manager (memoized) with scoped storage keys
+    const tokenManager = useMemo(()=>authMode === 'token' ? createTokenManager(appId, storage, tenantId) : null, [
+        authMode,
+        appId,
+        storage,
+        tenantId
+    ]);
+    // Factory to create transport for a specific service URL
+    const createServiceTransport = useCallback((baseUrl)=>{
+        return createHttpTransport({
+            baseUrl,
+            timeout,
+            credentials: authMode === 'cookie' ? 'include' : undefined,
+            headers: ()=>{
+                const headers = _({}, staticHeaders, {
+                    appid: appId
+                });
+                if (tenantId) {
+                    headers['tenant-id'] = tenantId;
+                }
+                if (authMode === 'token' && tokenManager) {
+                    const token = tokenManager.getAccessToken();
+                    if (token) {
+                        headers['Authorization'] = `Bearer ${token}`;
+                    }
+                }
+                return headers;
+            }
+        });
+    }, [
+        appId,
+        tenantId,
+        authMode,
+        staticHeaders,
+        timeout,
+        tokenManager
+    ]);
+    // Create blocks (memoized) - each with its own transport (no fallback)
+    const blockConfig = useMemo(()=>({
+            appId,
+            tenantId
+        }), [
+        appId,
+        tenantId
+    ]);
+    // Create blocks only if URL is configured, otherwise use proxy that throws helpful error
+    const authentication = useMemo(()=>{
+        if (!urls.authentication) {
+            return createUnconfiguredServiceProxy('authentication', 'authentication');
+        }
+        return createAuthenticationBlock(createServiceTransport(urls.authentication), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.authentication,
+        blockConfig
+    ]);
+    const search = useMemo(()=>{
+        if (!urls.search) {
+            return createUnconfiguredServiceProxy('search', 'search');
+        }
+        return createSearchBlock(createServiceTransport(urls.search), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.search,
+        blockConfig
+    ]);
+    const products = useMemo(()=>{
+        if (!urls.products) {
+            return createUnconfiguredServiceProxy('products', 'products');
+        }
+        return createProductsBlock(createServiceTransport(urls.products), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.products,
+        blockConfig
+    ]);
+    const crm = useMemo(()=>{
+        if (!urls.crm) {
+            return createUnconfiguredServiceProxy('crm', 'crm');
+        }
+        return createCrmBlock(createServiceTransport(urls.crm), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.crm,
+        blockConfig
+    ]);
+    const content = useMemo(()=>{
+        if (!urls.content) {
+            return createUnconfiguredServiceProxy('content', 'content');
+        }
+        return createContentBlock(createServiceTransport(urls.content), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.content,
+        blockConfig
+    ]);
+    const geolocation = useMemo(()=>{
+        if (!urls.geolocation) {
+            return createUnconfiguredServiceProxy('geolocation', 'geolocation');
+        }
+        return createGeolocationBlock(createServiceTransport(urls.geolocation), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.geolocation,
+        blockConfig
+    ]);
+    const conversations = useMemo(()=>{
+        if (!urls.conversations) {
+            return createUnconfiguredServiceProxy('conversations', 'conversations');
+        }
+        return createConversationsBlock(createServiceTransport(urls.conversations), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.conversations,
+        blockConfig
+    ]);
+    const files = useMemo(()=>{
+        if (!urls.files) {
+            return createUnconfiguredServiceProxy('files', 'files');
+        }
+        return createFilesBlock(createServiceTransport(urls.files), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.files,
+        blockConfig
+    ]);
+    const forms = useMemo(()=>{
+        if (!urls.forms) {
+            return createUnconfiguredServiceProxy('forms', 'forms');
+        }
+        return createFormsBlock(createServiceTransport(urls.forms), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.forms,
+        blockConfig
+    ]);
+    const assets = useMemo(()=>{
+        if (!urls.assets) {
+            return createUnconfiguredServiceProxy('assets', 'assets');
+        }
+        return createAssetsBlock(createServiceTransport(urls.assets), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.assets,
+        blockConfig
+    ]);
+    const campaigns = useMemo(()=>{
+        if (!urls.campaigns) {
+            return createUnconfiguredServiceProxy('campaigns', 'campaigns');
+        }
+        return createCampaignsBlock(createServiceTransport(urls.campaigns), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.campaigns,
+        blockConfig
+    ]);
+    const company = useMemo(()=>{
+        if (!urls.company) {
+            return createUnconfiguredServiceProxy('company', 'company');
+        }
+        return createCompanyBlock(createServiceTransport(urls.company), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.company,
+        blockConfig
+    ]);
+    const rewards = useMemo(()=>{
+        if (!urls.rewards) {
+            return createUnconfiguredServiceProxy('rewards', 'rewards');
+        }
+        return createRewardsBlock(createServiceTransport(urls.rewards), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.rewards,
+        blockConfig
+    ]);
+    const sales = useMemo(()=>{
+        if (!urls.sales) {
+            return createUnconfiguredServiceProxy('sales', 'sales');
+        }
+        return createSalesBlock(createServiceTransport(urls.sales), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.sales,
+        blockConfig
+    ]);
+    const wallet = useMemo(()=>{
+        if (!urls.wallet) {
+            return createUnconfiguredServiceProxy('wallet', 'wallet');
+        }
+        return createWalletBlock(createServiceTransport(urls.wallet), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.wallet,
+        blockConfig
+    ]);
+    const jarvis = useMemo(()=>{
+        if (!urls.jarvis) {
+            return createUnconfiguredServiceProxy('jarvis', 'jarvis');
+        }
+        return createJarvisBlock(createServiceTransport(urls.jarvis), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.jarvis,
+        blockConfig
+    ]);
+    const onboarding = useMemo(()=>{
+        if (!urls.onboarding) {
+            return createUnconfiguredServiceProxy('onboarding', 'onboarding');
+        }
+        return createOnboardingBlock(createServiceTransport(urls.onboarding), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.onboarding,
+        blockConfig
+    ]);
+    const university = useMemo(()=>{
+        if (!urls.university) {
+            return createUnconfiguredServiceProxy('university', 'university');
+        }
+        return createUniversityBlock(createServiceTransport(urls.university), blockConfig);
+    }, [
+        createServiceTransport,
+        urls.university,
+        blockConfig
+    ]);
+    // Check if authentication is configured for auth methods
+    const isAuthConfigured = !!urls.authentication;
+    // Auth methods with automatic token management
+    const signIn = useCallback(async (request)=>{
+        if (!isAuthConfigured) {
+            throw new Error('[23blocks] Cannot call signIn: The authentication service URL is not configured. ' + "Add 'urls.authentication' to your Provider configuration.");
+        }
+        const response = await authentication.auth.signIn(request);
+        if (authMode === 'token' && tokenManager && response.accessToken) {
+            tokenManager.setTokens(response.accessToken, response.refreshToken);
+        }
+        return response;
+    }, [
+        authentication,
+        authMode,
+        tokenManager,
+        isAuthConfigured
+    ]);
+    const signUp = useCallback(async (request)=>{
+        if (!isAuthConfigured) {
+            throw new Error('[23blocks] Cannot call signUp: The authentication service URL is not configured. ' + "Add 'urls.authentication' to your Provider configuration.");
+        }
+        const response = await authentication.auth.signUp(request);
+        if (authMode === 'token' && tokenManager && response.accessToken) {
+            tokenManager.setTokens(response.accessToken);
+        }
+        return response;
+    }, [
+        authentication,
+        authMode,
+        tokenManager,
+        isAuthConfigured
+    ]);
+    const signOut = useCallback(async ()=>{
+        if (!isAuthConfigured) {
+            throw new Error('[23blocks] Cannot call signOut: The authentication service URL is not configured. ' + "Add 'urls.authentication' to your Provider configuration.");
+        }
+        await authentication.auth.signOut();
+        if (authMode === 'token' && tokenManager) {
+            tokenManager.clearTokens();
+        }
+    }, [
+        authentication,
+        authMode,
+        tokenManager,
+        isAuthConfigured
+    ]);
+    // Token utilities
+    const getAccessToken = useCallback(()=>{
+        var _tokenManager_getAccessToken;
+        return (_tokenManager_getAccessToken = tokenManager == null ? void 0 : tokenManager.getAccessToken()) != null ? _tokenManager_getAccessToken : null;
+    }, [
+        tokenManager
+    ]);
+    const getRefreshToken = useCallback(()=>{
+        var _tokenManager_getRefreshToken;
+        return (_tokenManager_getRefreshToken = tokenManager == null ? void 0 : tokenManager.getRefreshToken()) != null ? _tokenManager_getRefreshToken : null;
+    }, [
+        tokenManager
+    ]);
+    const setTokens = useCallback((accessToken, refreshToken)=>{
+        tokenManager == null ? void 0 : tokenManager.setTokens(accessToken, refreshToken);
+    }, [
+        tokenManager
+    ]);
+    const clearTokens = useCallback(()=>tokenManager == null ? void 0 : tokenManager.clearTokens(), [
+        tokenManager
+    ]);
+    const isAuthenticated = useCallback(()=>{
+        if (authMode === 'cookie') return null;
+        return tokenManager ? !!tokenManager.getAccessToken() : false;
+    }, [
+        authMode,
+        tokenManager
+    ]);
+    const onStorageChange = useCallback((callback)=>{
+        var _tokenManager_onStorageChange;
+        return (_tokenManager_onStorageChange = tokenManager == null ? void 0 : tokenManager.onStorageChange(callback)) != null ? _tokenManager_onStorageChange : ()=>{};
+    }, [
+        tokenManager
+    ]);
+    const value = useMemo(()=>({
+            // Blocks
+            authentication,
+            search,
+            products,
+            crm,
+            content,
+            geolocation,
+            conversations,
+            files,
+            forms,
+            assets,
+            campaigns,
+            company,
+            rewards,
+            sales,
+            wallet,
+            jarvis,
+            onboarding,
+            university,
+            // Auth with token management
+            signIn,
+            signUp,
+            signOut,
+            // Token utilities
+            getAccessToken,
+            getRefreshToken,
+            setTokens,
+            clearTokens,
+            isAuthenticated,
+            onStorageChange,
+            // Config
+            authMode
+        }), [
+        authentication,
+        search,
+        products,
+        crm,
+        content,
+        geolocation,
+        conversations,
+        files,
+        forms,
+        assets,
+        campaigns,
+        company,
+        rewards,
+        sales,
+        wallet,
+        jarvis,
+        onboarding,
+        university,
+        signIn,
+        signUp,
+        signOut,
+        getAccessToken,
+        getRefreshToken,
+        setTokens,
+        clearTokens,
+        isAuthenticated,
+        onStorageChange,
+        authMode
+    ]);
+    return jsx(Blocks23Context.Provider, {
+        value: value,
+        children: children
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Hooks
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook to access all 23blocks services.
+ *
+ * @example
+ * ```tsx
+ * function Dashboard() {
+ *   const { products, crm, files } = useClient();
+ *
+ *   // Access any service
+ *   const loadProducts = async () => {
+ *     const { data } = await products.products.list({ limit: 10 });
+ *   };
+ * }
+ * ```
+ */ function useClient() {
+    const context = useContext(Blocks23Context);
+    if (!context) {
+        throw new Error('useClient must be used within a Provider');
+    }
+    return context;
+}
+/**
+ * Hook for authentication operations with automatic token management.
+ *
+ * @example
+ * ```tsx
+ * function LoginPage() {
+ *   const { signIn, signOut, isAuthenticated } = useAuth();
+ *
+ *   const handleLogin = async () => {
+ *     await signIn({ email: 'user@example.com', password: 'password' });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       {isAuthenticated() ? (
+ *         <button onClick={signOut}>Sign Out</button>
+ *       ) : (
+ *         <button onClick={handleLogin}>Sign In</button>
+ *       )}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */ function useAuth$1() {
+    const context = useClient();
+    return {
+        signIn: context.signIn,
+        signUp: context.signUp,
+        signOut: context.signOut,
+        getAccessToken: context.getAccessToken,
+        getRefreshToken: context.getRefreshToken,
+        setTokens: context.setTokens,
+        clearTokens: context.clearTokens,
+        isAuthenticated: context.isAuthenticated,
+        onStorageChange: context.onStorageChange,
+        authentication: context.authentication
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Backward Compatibility Aliases (deprecated)
+// ─────────────────────────────────────────────────────────────────────────────
+/** @deprecated Use `Provider` instead */ const SimpleBlocks23Provider = Provider;
+/** @deprecated Use `useClient` instead */ const useSimpleBlocks23 = useClient;
+/** @deprecated Use `useAuth` instead */ const useSimpleAuth = useAuth$1;
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Context
+// ─────────────────────────────────────────────────────────────────────────────
+const Blocks23ContextInternal = /*#__PURE__*/ createContext(null);
+// ─────────────────────────────────────────────────────────────────────────────
+// Provider Component
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Provider component for 23blocks services.
+ *
+ * @example
+ * ```tsx
+ * import { Blocks23Provider } from '@23blocks/react';
+ * import { createHttpTransport } from '@23blocks/transport-http';
+ *
+ * const transport = createHttpTransport({
+ *   baseUrl: 'https://api.example.com',
+ *   headers: () => ({
+ *     'Authorization': `Bearer ${localStorage.getItem('token')}`,
+ *   }),
+ * });
+ *
+ * function App() {
+ *   return (
+ *     <Blocks23Provider
+ *       transport={transport}
+ *       authentication={{ appId: 'my-app' }}
+ *       search={{ appId: 'my-app' }}
+ *       products={{ appId: 'my-app' }}
+ *       crm={{ appId: 'my-app' }}
+ *     >
+ *       <MyApp />
+ *     </Blocks23Provider>
+ *   );
+ * }
+ * ```
+ */ function Blocks23Provider({ children, transport, authentication, search, products, crm, content, geolocation, conversations, files, forms, assets, campaigns, company, rewards, sales, wallet, jarvis, onboarding, university }) {
+    const value = useMemo(()=>({
+            transport,
+            authentication: authentication ? createAuthenticationBlock(transport, authentication) : null,
+            search: search ? createSearchBlock(transport, search) : null,
+            products: products ? createProductsBlock(transport, products) : null,
+            crm: crm ? createCrmBlock(transport, crm) : null,
+            content: content ? createContentBlock(transport, content) : null,
+            geolocation: geolocation ? createGeolocationBlock(transport, geolocation) : null,
+            conversations: conversations ? createConversationsBlock(transport, conversations) : null,
+            files: files ? createFilesBlock(transport, files) : null,
+            forms: forms ? createFormsBlock(transport, forms) : null,
+            assets: assets ? createAssetsBlock(transport, assets) : null,
+            campaigns: campaigns ? createCampaignsBlock(transport, campaigns) : null,
+            company: company ? createCompanyBlock(transport, company) : null,
+            rewards: rewards ? createRewardsBlock(transport, rewards) : null,
+            sales: sales ? createSalesBlock(transport, sales) : null,
+            wallet: wallet ? createWalletBlock(transport, wallet) : null,
+            jarvis: jarvis ? createJarvisBlock(transport, jarvis) : null,
+            onboarding: onboarding ? createOnboardingBlock(transport, onboarding) : null,
+            university: university ? createUniversityBlock(transport, university) : null
+        }), [
+        transport,
+        authentication,
+        search,
+        products,
+        crm,
+        content,
+        geolocation,
+        conversations,
+        files,
+        forms,
+        assets,
+        campaigns,
+        company,
+        rewards,
+        sales,
+        wallet,
+        jarvis,
+        onboarding,
+        university
+    ]);
+    return jsx(Blocks23ContextInternal.Provider, {
+        value: value,
+        children: children
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Context Hook
+// ─────────────────────────────────────────────────────────────────────────────
+function use23Blocks() {
+    const context = useContext(Blocks23ContextInternal);
+    if (!context) {
+        throw new Error('use23Blocks must be used within a Blocks23Provider');
+    }
+    return context;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Block-specific hooks
+// ─────────────────────────────────────────────────────────────────────────────
+function useAuthenticationBlock() {
+    const { authentication } = use23Blocks();
+    if (!authentication) throw new Error('Authentication block not configured. Pass `authentication` prop to Blocks23Provider.');
+    return authentication;
+}
+function useSearchBlock() {
+    const { search } = use23Blocks();
+    if (!search) throw new Error('Search block not configured. Pass `search` prop to Blocks23Provider.');
+    return search;
+}
+function useProductsBlock() {
+    const { products } = use23Blocks();
+    if (!products) throw new Error('Products block not configured. Pass `products` prop to Blocks23Provider.');
+    return products;
+}
+function useCrmBlock() {
+    const { crm } = use23Blocks();
+    if (!crm) throw new Error('CRM block not configured. Pass `crm` prop to Blocks23Provider.');
+    return crm;
+}
+function useContentBlock() {
+    const { content } = use23Blocks();
+    if (!content) throw new Error('Content block not configured. Pass `content` prop to Blocks23Provider.');
+    return content;
+}
+function useGeolocationBlock() {
+    const { geolocation } = use23Blocks();
+    if (!geolocation) throw new Error('Geolocation block not configured. Pass `geolocation` prop to Blocks23Provider.');
+    return geolocation;
+}
+function useConversationsBlock() {
+    const { conversations } = use23Blocks();
+    if (!conversations) throw new Error('Conversations block not configured. Pass `conversations` prop to Blocks23Provider.');
+    return conversations;
+}
+function useFilesBlock() {
+    const { files } = use23Blocks();
+    if (!files) throw new Error('Files block not configured. Pass `files` prop to Blocks23Provider.');
+    return files;
+}
+function useFormsBlock() {
+    const { forms } = use23Blocks();
+    if (!forms) throw new Error('Forms block not configured. Pass `forms` prop to Blocks23Provider.');
+    return forms;
+}
+function useAssetsBlock() {
+    const { assets } = use23Blocks();
+    if (!assets) throw new Error('Assets block not configured. Pass `assets` prop to Blocks23Provider.');
+    return assets;
+}
+function useCampaignsBlock() {
+    const { campaigns } = use23Blocks();
+    if (!campaigns) throw new Error('Campaigns block not configured. Pass `campaigns` prop to Blocks23Provider.');
+    return campaigns;
+}
+function useCompanyBlock() {
+    const { company } = use23Blocks();
+    if (!company) throw new Error('Company block not configured. Pass `company` prop to Blocks23Provider.');
+    return company;
+}
+function useRewardsBlock() {
+    const { rewards } = use23Blocks();
+    if (!rewards) throw new Error('Rewards block not configured. Pass `rewards` prop to Blocks23Provider.');
+    return rewards;
+}
+function useSalesBlock() {
+    const { sales } = use23Blocks();
+    if (!sales) throw new Error('Sales block not configured. Pass `sales` prop to Blocks23Provider.');
+    return sales;
+}
+function useWalletBlock() {
+    const { wallet } = use23Blocks();
+    if (!wallet) throw new Error('Wallet block not configured. Pass `wallet` prop to Blocks23Provider.');
+    return wallet;
+}
+function useJarvisBlock() {
+    const { jarvis } = use23Blocks();
+    if (!jarvis) throw new Error('Jarvis block not configured. Pass `jarvis` prop to Blocks23Provider.');
+    return jarvis;
+}
+function useOnboardingBlock() {
+    const { onboarding } = use23Blocks();
+    if (!onboarding) throw new Error('Onboarding block not configured. Pass `onboarding` prop to Blocks23Provider.');
+    return onboarding;
+}
+function useUniversityBlock() {
+    const { university } = use23Blocks();
+    if (!university) throw new Error('University block not configured. Pass `university` prop to Blocks23Provider.');
+    return university;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for authentication operations with state management.
+ *
+ * @example
+ * ```tsx
+ * function LoginForm() {
+ *   const { signIn, isLoading, error, user } = useAuth();
+ *
+ *   const handleSubmit = async (e: FormEvent) => {
+ *     e.preventDefault();
+ *     try {
+ *       await signIn({ email, password });
+ *       navigate('/dashboard');
+ *     } catch (err) {
+ *       // Error is automatically captured in `error` state
+ *     }
+ *   };
+ *
+ *   if (user) {
+ *     return <p>Welcome, {user.email}!</p>;
+ *   }
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       {error && <p className="error">{error.message}</p>}
+ *       <button disabled={isLoading}>
+ *         {isLoading ? 'Signing in...' : 'Sign In'}
+ *       </button>
+ *     </form>
+ *   );
+ * }
+ * ```
+ */ function useAuth() {
+    const block = useAuthenticationBlock();
+    const [user, setUser] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const signIn = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const response = await block.auth.signIn(request);
+            setUser(response.user);
+            return response;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const signUp = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const response = await block.auth.signUp(request);
+            setUser(response.user);
+            return response;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const signOut = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.auth.signOut();
+            setUser(null);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const requestPasswordReset = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.auth.requestPasswordReset(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const updatePassword = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.auth.updatePassword(request);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const refreshUser = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const currentUser = await block.auth.getCurrentUser();
+            setUser(currentUser);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.auth
+    ]);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        // State
+        user,
+        isLoading,
+        error,
+        isAuthenticated: user !== null,
+        // Actions
+        signIn,
+        signUp,
+        signOut,
+        requestPasswordReset,
+        updatePassword,
+        refreshUser,
+        clearError
+    };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for user management operations.
+ *
+ * @example
+ * ```tsx
+ * function UserList() {
+ *   const { users, listUsers, isLoading, error } = useUsers();
+ *
+ *   useEffect(() => {
+ *     listUsers({ page: 1, perPage: 20 });
+ *   }, [listUsers]);
+ *
+ *   if (isLoading) return <Spinner />;
+ *   if (error) return <Error message={error.message} />;
+ *
+ *   return (
+ *     <ul>
+ *       {users.map(user => (
+ *         <li key={user.id}>{user.email}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */ function useUsers() {
+    const block = useAuthenticationBlock();
+    const [users, setUsers] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const listUsers = useCallback(async (params)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.users.list(params);
+            setUsers(result);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const getUser = useCallback(async (id)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.users.get(id);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const updateUser = useCallback(async (id, request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const updated = await block.users.update(id, request);
+            setUsers((prev)=>prev.map((u)=>u.id === id ? updated : u));
+            return updated;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const deleteUser = useCallback(async (id)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.users.delete(id);
+            setUsers((prev)=>prev.filter((u)=>u.id !== id));
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.users
+    ]);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        users,
+        isLoading,
+        error,
+        listUsers,
+        getUser,
+        updateUser,
+        deleteUser,
+        clearError
+    };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for search operations with state management.
+ *
+ * @example
+ * ```tsx
+ * function SearchPage() {
+ *   const { results, search, isLoading, query } = useSearch();
+ *   const [inputValue, setInputValue] = useState('');
+ *
+ *   const handleSearch = async (e: FormEvent) => {
+ *     e.preventDefault();
+ *     await search({ query: inputValue });
+ *   };
+ *
+ *   return (
+ *     <div>
+ *       <form onSubmit={handleSearch}>
+ *         <input
+ *           value={inputValue}
+ *           onChange={(e) => setInputValue(e.target.value)}
+ *           placeholder="Search..."
+ *         />
+ *         <button disabled={isLoading}>Search</button>
+ *       </form>
+ *
+ *       {query && <p>Results for: {query}</p>}
+ *
+ *       <ul>
+ *         {results.map(result => (
+ *           <li key={result.id}>{result.entityDescription}</li>
+ *         ))}
+ *       </ul>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */ function useSearch() {
+    const block = useSearchBlock();
+    const [results, setResults] = useState([]);
+    const [totalRecords, setTotalRecords] = useState(0);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [query, setQuery] = useState('');
+    const search = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        setQuery(request.query);
+        try {
+            const response = await block.search.search(request);
+            setResults(response.results);
+            setTotalRecords(response.totalRecords);
+            return response;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.search
+    ]);
+    const suggest = useCallback(async (query, limit)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.search.suggest(query, limit);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.search
+    ]);
+    const getEntityTypes = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            return await block.search.entityTypes();
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.search
+    ]);
+    const clearResults = useCallback(()=>{
+        setResults([]);
+        setTotalRecords(0);
+        setQuery('');
+    }, []);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        results,
+        totalRecords,
+        isLoading,
+        error,
+        query,
+        search,
+        suggest,
+        getEntityTypes,
+        clearResults,
+        clearError
+    };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Hook
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Hook for managing favorites.
+ *
+ * @example
+ * ```tsx
+ * function FavoritesList() {
+ *   const { favorites, listFavorites, removeFavorite, isLoading } = useFavorites();
+ *
+ *   useEffect(() => {
+ *     listFavorites();
+ *   }, [listFavorites]);
+ *
+ *   return (
+ *     <ul>
+ *       {favorites.map(fav => (
+ *         <li key={fav.id}>
+ *           {fav.entityDescription}
+ *           <button onClick={() => removeFavorite(fav.id)}>Remove</button>
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */ function useFavorites() {
+    const block = useSearchBlock();
+    const [favorites, setFavorites] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const listFavorites = useCallback(async ()=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const result = await block.favorites.list();
+            setFavorites(result);
+            return result;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.favorites
+    ]);
+    const addFavorite = useCallback(async (request)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            const favorite = await block.favorites.add(request);
+            setFavorites((prev)=>[
+                    ...prev,
+                    favorite
+                ]);
+            return favorite;
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.favorites
+    ]);
+    const removeFavorite = useCallback(async (id)=>{
+        setIsLoading(true);
+        setError(null);
+        try {
+            await block.favorites.remove(id);
+            setFavorites((prev)=>prev.filter((f)=>f.id !== id));
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        } finally{
+            setIsLoading(false);
+        }
+    }, [
+        block.favorites
+    ]);
+    const isFavorite = useCallback(async (entityUniqueId)=>{
+        try {
+            return await block.favorites.isFavorite(entityUniqueId);
+        } catch (err) {
+            const error = err instanceof Error ? err : new Error(String(err));
+            setError(error);
+            throw error;
+        }
+    }, [
+        block.favorites
+    ]);
+    const clearError = useCallback(()=>{
+        setError(null);
+    }, []);
+    return {
+        favorites,
+        isLoading,
+        error,
+        listFavorites,
+        addFavorite,
+        removeFavorite,
+        isFavorite,
+        clearError
+    };
+}
+
+export { Blocks23Provider, Provider, SimpleBlocks23Provider, use23Blocks, useAssetsBlock, useAuth$1 as useAuth, useAuth as useAuthState, useAuthenticationBlock, useCampaignsBlock, useClient, useCompanyBlock, useContentBlock, useConversationsBlock, useCrmBlock, useFavorites, useFilesBlock, useFormsBlock, useGeolocationBlock, useJarvisBlock, useOnboardingBlock, useProductsBlock, useRewardsBlock, useSalesBlock, useSearch, useSearchBlock, useSimpleAuth, useSimpleBlocks23, useUniversityBlock, useUsers, useWalletBlock };