@varity-labs/ui-kit 2.0.0-alpha.1

package/dist/hooks/useAuth.js

@@ -0,0 +1,198 @@
+/**
+ * useAuth - Authentication state management hook
+ *
+ * Manages user authentication state with SIWE (Sign-In with Ethereum).
+ */
+import { useState, useCallback, useEffect } from 'react';
+import { useVarityAPI } from './useVarityAPI';
+/**
+ * useAuth Hook
+ *
+ * Manages authentication state with Sign-In with Ethereum (SIWE).
+ *
+ * @example
+ * ```tsx
+ * const { user, isAuthenticated, login, logout } = useAuth()
+ *
+ * // Login
+ * await login(siweMessage, signature)
+ *
+ * // Logout
+ * await logout()
+ * ```
+ */
+export const useAuth = () => {
+    const { client, isAuthenticated, setAuthenticated } = useVarityAPI();
+    const [user, setUser] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const refreshUser = useCallback(async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const userData = await client.auth.me();
+            setUser({
+                address: userData.address,
+                name: userData.name,
+                email: userData.email,
+                avatarUrl: userData.avatarUrl,
+                metadata: userData.metadata
+            });
+            setAuthenticated(true);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to fetch user');
+            setError(error);
+            setUser(null);
+            setAuthenticated(false);
+            // Clear invalid token
+            localStorage.removeItem('varity_token');
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, setAuthenticated]);
+    const login = useCallback(async (message, signature) => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            const response = await client.auth.login(message, signature);
+            // Store token
+            if (response.token) {
+                localStorage.setItem('varity_token', response.token);
+                client.setAPIKey(response.token);
+            }
+            // Set user data
+            setUser({
+                address: response.address,
+                name: response.name,
+                email: response.email,
+                avatarUrl: response.avatarUrl,
+                metadata: response.metadata
+            });
+            setAuthenticated(true);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Login failed');
+            setError(error);
+            throw error;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [client, setAuthenticated]);
+    // Load user on mount if token exists
+    useEffect(() => {
+        const token = localStorage.getItem('varity_token');
+        if (token) {
+            refreshUser();
+        }
+    }, [refreshUser]);
+    const logout = useCallback(async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            await client.auth.logout();
+        }
+        catch (err) {
+            // Log error but continue with logout
+            console.error('Logout error:', err);
+        }
+        finally {
+            // Clear local state regardless of API call success
+            localStorage.removeItem('varity_token');
+            setUser(null);
+            setAuthenticated(false);
+            setIsLoading(false);
+        }
+    }, [client, setAuthenticated]);
+    return {
+        user,
+        isAuthenticated,
+        isLoading,
+        error,
+        login,
+        logout,
+        refreshUser
+    };
+};
+/**
+ * useWalletConnect Hook
+ *
+ * Helper hook for connecting Web3 wallets (MetaMask, WalletConnect, etc).
+ *
+ * @example
+ * ```tsx
+ * const { connect, disconnect, address, isConnected } = useWalletConnect()
+ * await connect()
+ * ```
+ */
+export const useWalletConnect = () => {
+    const [address, setAddress] = useState(null);
+    const [isConnected, setIsConnected] = useState(false);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const connect = useCallback(async () => {
+        setIsLoading(true);
+        setError(null);
+        try {
+            // Check if MetaMask is installed
+            const ethereum = window.ethereum;
+            if (!ethereum) {
+                throw new Error('MetaMask is not installed');
+            }
+            // Request account access
+            const result = await ethereum.request({
+                method: 'eth_requestAccounts'
+            });
+            // Type guard for accounts array
+            const accounts = Array.isArray(result) ? result : [];
+            if (accounts.length === 0) {
+                throw new Error('No accounts found');
+            }
+            setAddress(accounts[0]);
+            setIsConnected(true);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to connect wallet');
+            setError(error);
+            throw error;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, []);
+    const disconnect = useCallback(() => {
+        setAddress(null);
+        setIsConnected(false);
+    }, []);
+    // Listen for account changes
+    useEffect(() => {
+        const ethereum = window.ethereum;
+        if (!ethereum)
+            return;
+        const handleAccountsChanged = (...args) => {
+            // Type guard for accounts parameter
+            const accounts = Array.isArray(args[0]) ? args[0] : [];
+            if (accounts.length === 0) {
+                disconnect();
+            }
+            else {
+                setAddress(accounts[0]);
+            }
+        };
+        ethereum.on('accountsChanged', handleAccountsChanged);
+        return () => {
+            ethereum.removeListener('accountsChanged', handleAccountsChanged);
+        };
+    }, [disconnect]);
+    return {
+        address,
+        isConnected,
+        isLoading,
+        error,
+        connect,
+        disconnect
+    };
+};
+//# sourceMappingURL=useAuth.js.map

package/dist/hooks/useAuth.js.map

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

package/dist/hooks/useDashboard.d.ts

@@ -0,0 +1,110 @@
+/**
+ * useDashboard - Dashboard state management hook
+ *
+ * Manages dashboard configuration, layout, and data.
+ */
+export interface DashboardWidget {
+    /** Widget ID */
+    id: string;
+    /** Widget type */
+    type: 'kpi' | 'chart' | 'table' | 'ai-chat' | 'custom';
+    /** Widget title */
+    title: string;
+    /** Widget configuration */
+    config: Record<string, any>;
+    /** Widget position */
+    position: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+export interface DashboardConfig {
+    /** Dashboard ID */
+    id: string;
+    /** Dashboard title */
+    title: string;
+    /** Dashboard description */
+    description?: string;
+    /** Dashboard widgets */
+    widgets: DashboardWidget[];
+    /** Dashboard layout */
+    layout?: 'grid' | 'flex' | 'custom';
+    /** Dashboard theme */
+    theme?: string;
+}
+export interface UseDashboardOptions {
+    /** Dashboard ID to load */
+    dashboardId?: string;
+    /** Auto-save changes */
+    autoSave?: boolean;
+    /** Auto-save interval in milliseconds */
+    autoSaveInterval?: number;
+}
+export interface UseDashboardReturn {
+    /** Dashboard configuration */
+    config: DashboardConfig | null;
+    /** Loading state */
+    loading: boolean;
+    /** Error state */
+    error: Error | null;
+    /** Update dashboard config */
+    updateConfig: (config: Partial<DashboardConfig>) => void;
+    /** Add widget */
+    addWidget: (widget: DashboardWidget) => void;
+    /** Remove widget */
+    removeWidget: (widgetId: string) => void;
+    /** Update widget */
+    updateWidget: (widgetId: string, updates: Partial<DashboardWidget>) => void;
+    /** Save dashboard */
+    save: () => Promise<void>;
+    /** Load dashboard */
+    load: (dashboardId: string) => Promise<void>;
+    /** Reset dashboard */
+    reset: () => void;
+}
+/**
+ * useDashboard Hook
+ *
+ * Manage dashboard configuration and widgets.
+ *
+ * @example
+ * ```tsx
+ * const { config, addWidget, save } = useDashboard({
+ *   dashboardId: 'my-dashboard',
+ *   autoSave: true
+ * })
+ *
+ * // Add a widget
+ * addWidget({
+ *   id: 'widget-1',
+ *   type: 'kpi',
+ *   title: 'Total Revenue',
+ *   config: { metric: 'revenue' },
+ *   position: { x: 0, y: 0, width: 4, height: 2 }
+ * })
+ * ```
+ */
+export declare const useDashboard: (options?: UseDashboardOptions) => UseDashboardReturn;
+/**
+ * useWidgetData Hook
+ *
+ * Fetch data for a specific dashboard widget.
+ *
+ * @example
+ * ```tsx
+ * const { data, loading } = useWidgetData({
+ *   id: 'widget-1',
+ *   type: 'kpi',
+ *   config: { metric: 'revenue' }
+ * })
+ * ```
+ */
+export declare const useWidgetData: (widget: DashboardWidget) => {
+    data: any;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+//# sourceMappingURL=useDashboard.d.ts.map

package/dist/hooks/useDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDashboard.d.ts","sourceRoot":"","sources":["../../src/hooks/useDashboard.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,eAAe;IAC9B,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAA;IACV,kBAAkB;IAClB,IAAI,EAAE,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAA;IACtD,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC3B,sBAAsB;IACtB,QAAQ,EAAE;QACR,CAAC,EAAE,MAAM,CAAA;QACT,CAAC,EAAE,MAAM,CAAA;QACT,KAAK,EAAE,MAAM,CAAA;QACb,MAAM,EAAE,MAAM,CAAA;KACf,CAAA;CACF;AAED,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wBAAwB;IACxB,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,uBAAuB;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;IACnC,sBAAsB;IACtB,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,yCAAyC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,8BAA8B;IAC9B,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;IAC9B,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,kBAAkB;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,8BAA8B;IAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAA;IACxD,iBAAiB;IACjB,SAAS,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAA;IAC5C,oBAAoB;IACpB,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,oBAAoB;IACpB,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,KAAK,IAAI,CAAA;IAC3E,qBAAqB;IACrB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,qBAAqB;IACrB,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,sBAAsB;IACtB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,YAAY,GAAI,UAAS,mBAAwB,KAAG,kBAqHhE,CAAA;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ,eAAe;;;;;CA8CpD,CAAA"}

package/dist/hooks/useDashboard.js

@@ -0,0 +1,201 @@
+/**
+ * useDashboard - Dashboard state management hook
+ *
+ * Manages dashboard configuration, layout, and data.
+ */
+import { useState, useCallback, useEffect } from 'react';
+import { useVarityAPI } from './useVarityAPI';
+/**
+ * useDashboard Hook
+ *
+ * Manage dashboard configuration and widgets.
+ *
+ * @example
+ * ```tsx
+ * const { config, addWidget, save } = useDashboard({
+ *   dashboardId: 'my-dashboard',
+ *   autoSave: true
+ * })
+ *
+ * // Add a widget
+ * addWidget({
+ *   id: 'widget-1',
+ *   type: 'kpi',
+ *   title: 'Total Revenue',
+ *   config: { metric: 'revenue' },
+ *   position: { x: 0, y: 0, width: 4, height: 2 }
+ * })
+ * ```
+ */
+export const useDashboard = (options = {}) => {
+    const { client } = useVarityAPI();
+    const [config, setConfig] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const [hasChanges, setHasChanges] = useState(false);
+    const { dashboardId, autoSave = false, autoSaveInterval = 30000 } = options;
+    const load = useCallback(async (id) => {
+        setLoading(true);
+        setError(null);
+        try {
+            const dashboard = await client.dashboard.get(id);
+            setConfig(dashboard);
+            setHasChanges(false);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to load dashboard');
+            setError(error);
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [client]);
+    const save = useCallback(async () => {
+        if (!config)
+            return;
+        setLoading(true);
+        setError(null);
+        try {
+            await client.dashboard.save(config);
+            setHasChanges(false);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to save dashboard');
+            setError(error);
+            throw error;
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [client, config]);
+    // Load dashboard on mount
+    useEffect(() => {
+        if (dashboardId) {
+            load(dashboardId);
+        }
+    }, [dashboardId, load]);
+    // Auto-save if enabled
+    useEffect(() => {
+        if (!autoSave || !hasChanges || !config)
+            return;
+        const interval = setInterval(() => {
+            save();
+        }, autoSaveInterval);
+        return () => clearInterval(interval);
+    }, [autoSave, hasChanges, config, autoSaveInterval, save]);
+    const updateConfig = useCallback((updates) => {
+        setConfig((prev) => prev ? { ...prev, ...updates } : null);
+        setHasChanges(true);
+    }, []);
+    const addWidget = useCallback((widget) => {
+        setConfig((prev) => {
+            if (!prev)
+                return null;
+            return {
+                ...prev,
+                widgets: [...prev.widgets, widget]
+            };
+        });
+        setHasChanges(true);
+    }, []);
+    const removeWidget = useCallback((widgetId) => {
+        setConfig((prev) => {
+            if (!prev)
+                return null;
+            return {
+                ...prev,
+                widgets: prev.widgets.filter((w) => w.id !== widgetId)
+            };
+        });
+        setHasChanges(true);
+    }, []);
+    const updateWidget = useCallback((widgetId, updates) => {
+        setConfig((prev) => {
+            if (!prev)
+                return null;
+            return {
+                ...prev,
+                widgets: prev.widgets.map((w) => w.id === widgetId ? { ...w, ...updates } : w)
+            };
+        });
+        setHasChanges(true);
+    }, []);
+    const reset = useCallback(() => {
+        setConfig(null);
+        setHasChanges(false);
+        setError(null);
+    }, []);
+    return {
+        config,
+        loading,
+        error,
+        updateConfig,
+        addWidget,
+        removeWidget,
+        updateWidget,
+        save,
+        load,
+        reset
+    };
+};
+/**
+ * useWidgetData Hook
+ *
+ * Fetch data for a specific dashboard widget.
+ *
+ * @example
+ * ```tsx
+ * const { data, loading } = useWidgetData({
+ *   id: 'widget-1',
+ *   type: 'kpi',
+ *   config: { metric: 'revenue' }
+ * })
+ * ```
+ */
+export const useWidgetData = (widget) => {
+    const { client } = useVarityAPI();
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const fetchData = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        try {
+            let result;
+            switch (widget.type) {
+                case 'kpi':
+                    result = await client.analytics.getKPIs({ period: 'current_month' });
+                    break;
+                case 'chart':
+                    result = await client.analytics.getTrends({
+                        startDate: widget.config.startDate,
+                        endDate: widget.config.endDate
+                    });
+                    break;
+                case 'table':
+                    result = await client.analytics.getData(widget.config);
+                    break;
+                default:
+                    result = null;
+            }
+            setData(result);
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to fetch widget data');
+            setError(error);
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [client, widget]);
+    useEffect(() => {
+        fetchData();
+    }, [fetchData]);
+    return {
+        data,
+        loading,
+        error,
+        refetch: fetchData
+    };
+};
+//# sourceMappingURL=useDashboard.js.map

package/dist/hooks/useDashboard.js.map

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

package/dist/hooks/useVarityAPI.d.ts

@@ -0,0 +1,88 @@
+/**
+ * useVarityAPI - Main hook for Varity API integration
+ *
+ * Provides a React hook interface to the Varity API with automatic error handling,
+ * loading states, and caching.
+ */
+import React, { ReactNode } from 'react';
+import { VarityClient, VarityClientConfig } from '../core/VarityClient';
+export interface VarityAPIContextValue {
+    /** Varity client instance */
+    client: VarityClient;
+    /** Whether client is authenticated */
+    isAuthenticated: boolean;
+    /** Set authentication status */
+    setAuthenticated: (authenticated: boolean) => void;
+}
+export interface VarityAPIProviderProps {
+    /** Varity client configuration */
+    config: VarityClientConfig;
+    /** Child components */
+    children: ReactNode;
+}
+/**
+ * VarityAPIProvider - Context provider for Varity API
+ *
+ * Wrap your app with this provider to enable useVarityAPI hook.
+ *
+ * @example
+ * ```tsx
+ * <VarityAPIProvider config={{ apiEndpoint: 'https://api.varity.io' }}>
+ *   <App />
+ * </VarityAPIProvider>
+ * ```
+ */
+export declare const VarityAPIProvider: React.FC<VarityAPIProviderProps>;
+/**
+ * useVarityAPI Hook
+ *
+ * Access Varity client from any component.
+ *
+ * @example
+ * ```tsx
+ * const { client, isAuthenticated } = useVarityAPI()
+ * const data = await client.analytics.getKPIs({ period: 'current_month' })
+ * ```
+ */
+export declare const useVarityAPI: () => VarityAPIContextValue;
+/**
+ * useVarityQuery Hook
+ *
+ * Execute API queries with automatic loading and error states.
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, error, refetch } = useVarityQuery(
+ *   async (client) => client.analytics.getKPIs({ period: 'current_month' })
+ * )
+ * ```
+ */
+export declare function useVarityQuery<T>(queryFn: (client: VarityClient) => Promise<T>, deps?: any[]): {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<T>;
+};
+/**
+ * useVarityMutation Hook
+ *
+ * Execute API mutations with loading and error states.
+ *
+ * @example
+ * ```tsx
+ * const { mutate, loading, error } = useVarityMutation(
+ *   async (client, file: File) => client.storage.uploadFile(file)
+ * )
+ *
+ * // Later in code
+ * await mutate(file)
+ * ```
+ */
+export declare function useVarityMutation<TArgs extends any[], TResult>(mutationFn: (client: VarityClient, ...args: TArgs) => Promise<TResult>): {
+    mutate: (...args: TArgs) => Promise<TResult>;
+    loading: boolean;
+    error: Error | null;
+    data: TResult | null;
+    reset: () => void;
+};
+//# sourceMappingURL=useVarityAPI.d.ts.map

package/dist/hooks/useVarityAPI.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useVarityAPI.d.ts","sourceRoot":"","sources":["../../src/hooks/useVarityAPI.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAA6B,SAAS,EAAyB,MAAM,OAAO,CAAA;AAC1F,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAEvE,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,MAAM,EAAE,YAAY,CAAA;IACpB,sCAAsC;IACtC,eAAe,EAAE,OAAO,CAAA;IACxB,gCAAgC;IAChC,gBAAgB,EAAE,CAAC,aAAa,EAAE,OAAO,KAAK,IAAI,CAAA;CACnD;AAID,MAAM,WAAW,sBAAsB;IACrC,kCAAkC;IAClC,MAAM,EAAE,kBAAkB,CAAA;IAC1B,uBAAuB;IACvB,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAS9D,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,QAAO,qBAM/B,CAAA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC9B,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,CAAC,EAC7C,IAAI,GAAE,GAAG,EAAO;;;;;EAkCjB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,GAAG,EAAE,EAAE,OAAO,EAC5D,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,OAAO,CAAC;sBAO3B,KAAK,KAAG,OAAO,CAAC,OAAO,CAAC;;;;;EA0BpE"}