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

package/dist/core/config.js

@@ -0,0 +1,156 @@
+/**
+ * Varity UI Kit - Configuration
+ *
+ * Configuration for the public frontend SDK.
+ * All blockchain/crypto operations are handled by the API server.
+ */
+/**
+ * Default API endpoint for development
+ */
+export const DEFAULT_API_ENDPOINT = 'http://localhost:3009';
+/**
+ * API base path
+ */
+export const API_BASE_PATH = '/api/v1';
+/**
+ * API endpoints configuration
+ */
+export const API_ENDPOINTS = {
+    // Authentication
+    auth: {
+        login: '/auth/login',
+        logout: '/auth/logout',
+        me: '/auth/me',
+        refresh: '/auth/refresh'
+    },
+    // Storage
+    storage: {
+        pin: '/storage/pin',
+        uploadFile: '/storage/upload-file',
+        retrieve: '/storage/retrieve',
+        pinCID: '/storage/pin',
+        unpinCID: '/storage/unpin',
+        listPins: '/storage/pins'
+    },
+    // Celestia
+    celestia: {
+        submit: '/celestia/submit',
+        retrieve: '/celestia/retrieve'
+    },
+    // Compute (LLM)
+    llm: {
+        compute: '/llm/compute',
+        computeStatus: '/llm/compute',
+        computeResult: '/llm/compute',
+        computeCancel: '/llm/compute',
+        query: '/llm/query',
+        queryRAG: '/llm/query-rag',
+        queryTEE: '/llm/query-tee'
+    },
+    // RAG
+    rag: {
+        ingest: '/rag/ingest',
+        search: '/rag/search'
+    },
+    // TEE (Trusted Execution Environment)
+    tee: {
+        attestation: '/tee/attestation',
+        verifyAttestation: '/tee/verify-attestation',
+        query: '/tee/query'
+    },
+    // ZKML (Zero-Knowledge Machine Learning)
+    zkml: {
+        prove: '/zkml/prove',
+        verify: '/zkml/verify',
+        stats: '/zkml/stats',
+        circuits: '/zkml/circuits'
+    },
+    // ZK (Zero-Knowledge)
+    zk: {
+        generate: '/zk/generate',
+        verify: '/zk/verify'
+    },
+    // Analytics
+    analytics: {
+        kpis: '/analytics/kpis',
+        trends: '/analytics/trends',
+        leaderboard: '/analytics/leaderboard',
+        growthMetrics: '/analytics/growth-metrics',
+        timeSeries: '/analytics/time-series',
+        comparative: '/analytics/comparative',
+        realtime: '/analytics/realtime'
+    },
+    // Notifications
+    notifications: {
+        send: '/notifications/send',
+        schedule: '/notifications/schedule',
+        history: '/notifications/history',
+        preferences: '/notifications/preferences',
+        alerts: '/notifications/alerts'
+    },
+    // Export
+    export: {
+        data: '/export/data',
+        report: '/export/report',
+        download: '/export/download',
+        bulk: '/export/bulk',
+        schedule: '/export/schedule'
+    },
+    // Cache
+    cache: {
+        get: '/cache',
+        set: '/cache',
+        delete: '/cache',
+        batch: '/cache/batch',
+        invalidate: '/cache/invalidate',
+        stats: '/cache/stats'
+    },
+    // Monitoring
+    monitoring: {
+        health: '/monitoring/health',
+        metrics: '/monitoring/metrics',
+        metricsQuery: '/monitoring/metrics/query',
+        traces: '/monitoring/traces',
+        logs: '/monitoring/logs',
+        errors: '/monitoring/errors'
+    },
+    // Forecasting
+    forecasting: {
+        predict: '/forecasting/predict',
+        detectAnomalies: '/forecasting/detect-anomalies',
+        analyzeTrend: '/forecasting/analyze-trend',
+        simulate: '/forecasting/simulate',
+        train: '/forecasting/train',
+        evaluate: '/forecasting/evaluate'
+    },
+    // Webhooks
+    webhooks: {
+        register: '/webhooks/register',
+        list: '/webhooks/list',
+        update: '/webhooks',
+        delete: '/webhooks',
+        test: '/webhooks',
+        logs: '/webhooks',
+        deliver: '/webhooks/deliver',
+        events: '/webhooks/events',
+        stats: '/webhooks/stats'
+    },
+    // Oracle
+    oracle: {
+        query: '/oracle/query',
+        priceHistory: '/oracle/price-history'
+    }
+};
+/**
+ * Get the full API endpoint URL
+ */
+export function getAPIEndpoint(endpoint) {
+    return endpoint || DEFAULT_API_ENDPOINT;
+}
+/**
+ * Get the full API URL for a specific endpoint
+ */
+export function getFullAPIURL(baseEndpoint, path) {
+    return `${baseEndpoint}${API_BASE_PATH}${path}`;
+}
+//# sourceMappingURL=config.js.map

package/dist/core/config.js.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Varity UI Kit - React Hooks
+ *
+ * Custom React hooks for Varity SDK integration.
+ */
+export { useVarityAPI, useVarityQuery, useVarityMutation, VarityAPIProvider } from './useVarityAPI';
+export type { VarityAPIContextValue, VarityAPIProviderProps } from './useVarityAPI';
+export { useAuth, useWalletConnect } from './useAuth';
+export type { User, UseAuthReturn } from './useAuth';
+export { useAnalytics, useKPI } from './useAnalytics';
+export type { KPIData, AnalyticsData, UseAnalyticsOptions, UseAnalyticsReturn } from './useAnalytics';
+export { useDashboard, useWidgetData } from './useDashboard';
+export type { DashboardWidget, DashboardConfig, UseDashboardOptions, UseDashboardReturn } from './useDashboard';
+export { useTheme } from '../components/Branding/ThemeProvider';
+export { useWalletAuth, } from './useWalletAuth';
+export type { WalletSession, SessionInfo, UseWalletAuthReturn, UseWalletAuthConfig, } from './useWalletAuth';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AACvB,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAA;AAGnF,OAAO,EACL,OAAO,EACP,gBAAgB,EACjB,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAGpD,OAAO,EACL,YAAY,EACZ,MAAM,EACP,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EACL,YAAY,EACZ,aAAa,EACd,MAAM,gBAAgB,CAAA;AACvB,YAAY,EACV,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAG/D,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,iBAAiB,CAAA"}

package/dist/hooks/index.js

@@ -0,0 +1,18 @@
+/**
+ * Varity UI Kit - React Hooks
+ *
+ * Custom React hooks for Varity SDK integration.
+ */
+// Main API Hook
+export { useVarityAPI, useVarityQuery, useVarityMutation, VarityAPIProvider } from './useVarityAPI';
+// Authentication Hooks
+export { useAuth, useWalletConnect } from './useAuth';
+// Analytics Hooks
+export { useAnalytics, useKPI } from './useAnalytics';
+// Dashboard Hooks
+export { useDashboard, useWidgetData } from './useDashboard';
+// Re-export useTheme from Branding components
+export { useTheme } from '../components/Branding/ThemeProvider';
+// Wallet Authentication Hooks (Privy + Backend Session Management)
+export { useWalletAuth, } from './useWalletAuth';
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gBAAgB;AAChB,OAAO,EACL,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,gBAAgB,CAAA;AAGvB,uBAAuB;AACvB,OAAO,EACL,OAAO,EACP,gBAAgB,EACjB,MAAM,WAAW,CAAA;AAGlB,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,MAAM,EACP,MAAM,gBAAgB,CAAA;AAQvB,kBAAkB;AAClB,OAAO,EACL,YAAY,EACZ,aAAa,EACd,MAAM,gBAAgB,CAAA;AAQvB,8CAA8C;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,sCAAsC,CAAA;AAE/D,mEAAmE;AACnE,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAA"}

package/dist/hooks/useAnalytics.d.ts

@@ -0,0 +1,94 @@
+/**
+ * useAnalytics - Analytics data fetching and tracking hook
+ *
+ * Provides easy access to analytics data with automatic caching and refresh.
+ */
+import type { AnalyticsPeriod } from '../types/api-extensions';
+export interface KPIData {
+    /** KPI identifier */
+    id: string;
+    /** KPI label */
+    label: string;
+    /** KPI value */
+    value: number | string;
+    /** Value unit */
+    unit?: string;
+    /** Trend direction */
+    trend?: 'up' | 'down' | 'neutral';
+    /** Trend percentage */
+    trendValue?: number;
+    /** Comparison period */
+    comparisonPeriod?: string;
+}
+export interface AnalyticsData {
+    /** Key performance indicators */
+    kpis: KPIData[];
+    /** Time series data */
+    timeSeries?: Array<{
+        date: string;
+        value: number;
+    }>;
+    /** Additional metrics */
+    metrics?: Record<string, any>;
+}
+export interface UseAnalyticsOptions {
+    /** Time period for analytics */
+    period?: AnalyticsPeriod;
+    /** Start date for custom period */
+    startDate?: string;
+    /** End date for custom period */
+    endDate?: string;
+    /** Auto-refresh interval in milliseconds */
+    refreshInterval?: number;
+    /** Enable caching */
+    cache?: boolean;
+}
+export interface UseAnalyticsReturn {
+    /** Analytics data */
+    data: AnalyticsData | null;
+    /** Loading state */
+    loading: boolean;
+    /** Error state */
+    error: Error | null;
+    /** Refetch data */
+    refetch: () => Promise<void>;
+    /** Track custom event */
+    trackEvent: (eventName: string, properties?: Record<string, any>) => Promise<void>;
+}
+/**
+ * useAnalytics Hook
+ *
+ * Fetch and track analytics data.
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, trackEvent } = useAnalytics({
+ *   period: 'current_month',
+ *   refreshInterval: 30000
+ * })
+ *
+ * // Track custom event
+ * await trackEvent('button_clicked', { buttonId: 'export' })
+ * ```
+ */
+export declare const useAnalytics: (options?: UseAnalyticsOptions) => UseAnalyticsReturn;
+/**
+ * useKPI Hook
+ *
+ * Fetch a single KPI with real-time updates.
+ *
+ * @example
+ * ```tsx
+ * const { value, trend, loading } = useKPI('total_revenue', { period: 'current_month' })
+ * ```
+ */
+export declare const useKPI: (kpiId: string, options?: UseAnalyticsOptions) => {
+    value: string | number | null;
+    unit: string | undefined;
+    trend: "down" | "up" | "neutral" | undefined;
+    trendValue: number | undefined;
+    loading: boolean;
+    error: Error | null;
+    refetch: () => Promise<void>;
+};
+//# sourceMappingURL=useAnalytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAnalytics.d.ts","sourceRoot":"","sources":["../../src/hooks/useAnalytics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAA4B,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAExF,MAAM,WAAW,OAAO;IACtB,qBAAqB;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,gBAAgB;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB;IAChB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,iBAAiB;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sBAAsB;IACtB,KAAK,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAA;IACjC,uBAAuB;IACvB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,IAAI,EAAE,OAAO,EAAE,CAAA;IACf,uBAAuB;IACvB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACnD,yBAAyB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,gCAAgC;IAChC,MAAM,CAAC,EAAE,eAAe,CAAA;IACxB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,qBAAqB;IACrB,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,qBAAqB;IACrB,IAAI,EAAE,aAAa,GAAG,IAAI,CAAA;IAC1B,oBAAoB;IACpB,OAAO,EAAE,OAAO,CAAA;IAChB,kBAAkB;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,mBAAmB;IACnB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,yBAAyB;IACzB,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACnF;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,GAAI,UAAS,mBAAwB,KAAG,kBA0EhE,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,MAAM,GAAI,OAAO,MAAM,EAAE,UAAS,mBAAwB;;;;;;;mBA3GtD,OAAO,CAAC,IAAI,CAAC;CAyH7B,CAAA"}

package/dist/hooks/useAnalytics.js

@@ -0,0 +1,116 @@
+/**
+ * useAnalytics - Analytics data fetching and tracking hook
+ *
+ * Provides easy access to analytics data with automatic caching and refresh.
+ */
+import { useState, useEffect, useCallback } from 'react';
+import { useVarityAPI } from './useVarityAPI';
+/**
+ * useAnalytics Hook
+ *
+ * Fetch and track analytics data.
+ *
+ * @example
+ * ```tsx
+ * const { data, loading, trackEvent } = useAnalytics({
+ *   period: 'current_month',
+ *   refreshInterval: 30000
+ * })
+ *
+ * // Track custom event
+ * await trackEvent('button_clicked', { buttonId: 'export' })
+ * ```
+ */
+export const useAnalytics = (options = {}) => {
+    const { client } = useVarityAPI();
+    const [data, setData] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [error, setError] = useState(null);
+    const { period = 'current_month', refreshInterval, cache = true } = options;
+    const fetchAnalytics = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        try {
+            // Fetch KPIs
+            const kpisResponse = await client.analytics.getKPIs({ period });
+            // Fetch trends if available
+            let timeSeries;
+            if (options.startDate && options.endDate) {
+                const trendsResponse = await client.analytics.getTrends({
+                    startDate: options.startDate,
+                    endDate: options.endDate
+                });
+                timeSeries = trendsResponse.data;
+            }
+            setData({
+                kpis: kpisResponse.kpis || [],
+                timeSeries,
+                metrics: kpisResponse.metrics
+            });
+        }
+        catch (err) {
+            const error = err instanceof Error ? err : new Error('Failed to fetch analytics');
+            setError(error);
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [client, period, options.startDate, options.endDate]);
+    // Fetch on mount and when dependencies change
+    useEffect(() => {
+        fetchAnalytics();
+    }, [fetchAnalytics]);
+    // Auto-refresh if interval is set
+    useEffect(() => {
+        if (!refreshInterval)
+            return;
+        const interval = setInterval(() => {
+            fetchAnalytics();
+        }, refreshInterval);
+        return () => clearInterval(interval);
+    }, [refreshInterval, fetchAnalytics]);
+    const trackEvent = useCallback(async (eventName, properties) => {
+        try {
+            // Track event via analytics API
+            await client.analytics.trackEvent({
+                event: eventName,
+                properties: properties || {},
+                timestamp: new Date().toISOString()
+            });
+        }
+        catch (err) {
+            console.error('Failed to track event:', err);
+        }
+    }, [client]);
+    return {
+        data,
+        loading,
+        error,
+        refetch: fetchAnalytics,
+        trackEvent
+    };
+};
+/**
+ * useKPI Hook
+ *
+ * Fetch a single KPI with real-time updates.
+ *
+ * @example
+ * ```tsx
+ * const { value, trend, loading } = useKPI('total_revenue', { period: 'current_month' })
+ * ```
+ */
+export const useKPI = (kpiId, options = {}) => {
+    const { data, loading, error, refetch } = useAnalytics(options);
+    const kpi = data?.kpis?.find((k) => k.id === kpiId) || null;
+    return {
+        value: kpi?.value || null,
+        unit: kpi?.unit,
+        trend: kpi?.trend,
+        trendValue: kpi?.trendValue,
+        loading,
+        error,
+        refetch
+    };
+};
+//# sourceMappingURL=useAnalytics.js.map

package/dist/hooks/useAnalytics.js.map

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

package/dist/hooks/useAuth.d.ts

@@ -0,0 +1,71 @@
+/**
+ * useAuth - Authentication state management hook
+ *
+ * Manages user authentication state with SIWE (Sign-In with Ethereum).
+ */
+import { Metadata } from '@varity-labs/types';
+export interface User {
+    /** User's wallet address */
+    address: string;
+    /** User's display name */
+    name?: string;
+    /** User's email */
+    email?: string;
+    /** User's avatar URL */
+    avatarUrl?: string;
+    /** Additional user metadata */
+    metadata?: Metadata;
+}
+export interface UseAuthReturn {
+    /** Current user (null if not authenticated) */
+    user: User | null;
+    /** Whether user is authenticated */
+    isAuthenticated: boolean;
+    /** Whether auth is loading */
+    isLoading: boolean;
+    /** Authentication error */
+    error: Error | null;
+    /** Login with SIWE */
+    login: (message: string, signature: string) => Promise<void>;
+    /** Logout */
+    logout: () => Promise<void>;
+    /** Refresh user data */
+    refreshUser: () => Promise<void>;
+}
+/**
+ * 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 declare const useAuth: () => UseAuthReturn;
+/**
+ * useWalletConnect Hook
+ *
+ * Helper hook for connecting Web3 wallets (MetaMask, WalletConnect, etc).
+ *
+ * @example
+ * ```tsx
+ * const { connect, disconnect, address, isConnected } = useWalletConnect()
+ * await connect()
+ * ```
+ */
+export declare const useWalletConnect: () => {
+    address: string | null;
+    isConnected: boolean;
+    isLoading: boolean;
+    error: Error | null;
+    connect: () => Promise<void>;
+    disconnect: () => void;
+};
+//# sourceMappingURL=useAuth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../../src/hooks/useAuth.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAE7C,MAAM,WAAW,IAAI;IACnB,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,wBAAwB;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACjB,oCAAoC;IACpC,eAAe,EAAE,OAAO,CAAA;IACxB,8BAA8B;IAC9B,SAAS,EAAE,OAAO,CAAA;IAClB,2BAA2B;IAC3B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,sBAAsB;IACtB,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5D,aAAa;IACb,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAC3B,wBAAwB;IACxB,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CACjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,OAAO,QAAO,aA+F1B,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB;;;;;;;CA0E5B,CAAA"}