@devicai/ui 0.10.2 → 0.10.3

package/dist/esm/hooks/usePolling.js

@@ -1,4 +1,5 @@
-import { useState, useRef, useEffect, useCallback } from 'react';
+import { useMemo, useRef, useState, useEffect, useCallback } from 'react';
+import { createLogger } from '../utils/logger.js';
 
 /**
  * Hook for polling real-time chat history
@@ -8,7 +9,10 @@ import { useState, useRef, useEffect, useCallback } from 'react';
  * @param options - Polling options
  */
 function usePolling(chatUid, fetchFn, options = {}) {
-    const { interval = 1000, enabled = true, stopStatuses = ['completed', 'error'], onStop, onUpdate, onError, } = options;
+    const { interval = 1000, enabled = true, stopStatuses = ['completed', 'error'], onStop, onUpdate, onError, debug = false, } = options;
+    const log = useMemo(() => createLogger(debug), [debug]);
+    const logRef = useRef(log);
+    logRef.current = log;
     const [data, setData] = useState(null);
     const [isPolling, setIsPolling] = useState(false);
     const [error, setError] = useState(null);
@@ -38,13 +42,13 @@ function usePolling(chatUid, fetchFn, options = {}) {
         isPollingRef.current = false;
     }, []);
     const fetchData = useCallback(async () => {
-        console.log('[usePolling] fetchData called, isMounted:', isMountedRef.current);
+        logRef.current.log('[usePolling] fetchData called, isMounted:', isMountedRef.current);
         if (!isMountedRef.current)
             return;
         try {
-            console.log('[usePolling] Fetching...');
+            logRef.current.log('[usePolling] Fetching...');
             const result = await fetchFnRef.current();
-            console.log('[usePolling] Fetch result:', { status: result.status, messageCount: result.chatHistory?.length });
+            logRef.current.log('[usePolling] Fetch result:', { status: result.status, messageCount: result.chatHistory?.length });
             if (!isMountedRef.current)
                 return;
             setData(result);
@@ -52,16 +56,16 @@ function usePolling(chatUid, fetchFn, options = {}) {
             onUpdateRef.current?.(result);
             // Check if we should stop polling
             const shouldStop = stopStatusesRef.current.includes(result.status);
-            console.log('[usePolling] Should stop?', shouldStop, 'stopStatuses:', stopStatusesRef.current, 'current status:', result.status);
+            logRef.current.log('[usePolling] Should stop?', shouldStop, 'stopStatuses:', stopStatusesRef.current, 'current status:', result.status);
             if (shouldStop) {
-                console.log('[usePolling] Stopping polling due to status:', result.status);
+                logRef.current.log('[usePolling] Stopping polling due to status:', result.status);
                 clearPolling();
                 setIsPolling(false);
                 onStopRef.current?.(result);
             }
         }
         catch (err) {
-            console.error('[usePolling] Fetch error:', err);
+            logRef.current.error('[usePolling] Fetch error:', err);
             if (!isMountedRef.current)
                 return;
             const error = err instanceof Error ? err : new Error(String(err));
@@ -92,9 +96,9 @@ function usePolling(chatUid, fetchFn, options = {}) {
     }, [fetchData]);
     // Auto-start polling when enabled and chatUid is set
     useEffect(() => {
-        console.log('[usePolling] Auto-start effect triggered:', { enabled, chatUid, isPollingRef: isPollingRef.current, intervalRef: !!intervalRef.current });
+        logRef.current.log('[usePolling] Auto-start effect triggered:', { enabled, chatUid, isPollingRef: isPollingRef.current, intervalRef: !!intervalRef.current });
         if (!enabled || !chatUid) {
-            console.log('[usePolling] Not enabled or no chatUid, stopping if active');
+            logRef.current.log('[usePolling] Not enabled or no chatUid, stopping if active');
             // Stop polling if disabled or no chatUid
             if (isPollingRef.current) {
                 clearPolling();
@@ -104,7 +108,7 @@ function usePolling(chatUid, fetchFn, options = {}) {
         }
         // Start polling if not already polling
         if (!isPollingRef.current) {
-            console.log('[usePolling] Starting polling, interval:', intervalValueRef.current);
+            logRef.current.log('[usePolling] Starting polling, interval:', intervalValueRef.current);
             isPollingRef.current = true;
             setIsPolling(true);
             setError(null);
@@ -112,10 +116,10 @@ function usePolling(chatUid, fetchFn, options = {}) {
             fetchData();
             // Set up interval
             intervalRef.current = setInterval(fetchData, intervalValueRef.current);
-            console.log('[usePolling] Interval set:', intervalRef.current);
+            logRef.current.log('[usePolling] Interval set:', intervalRef.current);
         }
         else {
-            console.log('[usePolling] Already polling, skipping start');
+            logRef.current.log('[usePolling] Already polling, skipping start');
         }
         // Only cleanup on unmount, not on every dependency change
     }, [enabled, chatUid, fetchData, clearPolling]);

package/dist/esm/hooks/usePolling.js.map

@@ -1 +1 @@
-{"version":3,"file":"usePolling.js","sources":["../../../src/hooks/usePolling.ts"],"sourcesContent":["import { useState, useEffect, useRef, useCallback } from 'react';\nimport type { RealtimeChatHistory, RealtimeStatus } from '../api/types';\n\nexport interface UsePollingOptions {\n  /**\n   * Polling interval in milliseconds\n   * @default 1000\n   */\n  interval?: number;\n\n  /**\n   * Whether polling is enabled\n   * @default true\n   */\n  enabled?: boolean;\n\n  /**\n   * Statuses that should stop polling\n   * @default ['completed', 'error']\n   */\n  stopStatuses?: RealtimeStatus[];\n\n  /**\n   * Callback when polling stops\n   */\n  onStop?: (data: RealtimeChatHistory | null) => void;\n\n  /**\n   * Callback on each poll update\n   */\n  onUpdate?: (data: RealtimeChatHistory) => void;\n\n  /**\n   * Callback on poll error\n   */\n  onError?: (error: Error) => void;\n}\n\nexport interface UsePollingResult {\n  /**\n   * Current polling data\n   */\n  data: RealtimeChatHistory | null;\n\n  /**\n   * Whether polling is currently active\n   */\n  isPolling: boolean;\n\n  /**\n   * Last error that occurred\n   */\n  error: Error | null;\n\n  /**\n   * Start polling\n   */\n  start: () => void;\n\n  /**\n   * Stop polling\n   */\n  stop: () => void;\n\n  /**\n   * Manually trigger a fetch\n   */\n  refetch: () => Promise<void>;\n}\n\n/**\n * Hook for polling real-time chat history\n *\n * @param chatUid - The chat UID to poll for\n * @param fetchFn - Function that fetches the realtime history\n * @param options - Polling options\n */\nexport function usePolling(\n  chatUid: string | null,\n  fetchFn: () => Promise<RealtimeChatHistory>,\n  options: UsePollingOptions = {}\n): UsePollingResult {\n  const {\n    interval = 1000,\n    enabled = true,\n    stopStatuses = ['completed', 'error'],\n    onStop,\n    onUpdate,\n    onError,\n  } = options;\n\n  const [data, setData] = useState<RealtimeChatHistory | null>(null);\n  const [isPolling, setIsPolling] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const intervalRef = useRef<ReturnType<typeof setInterval> | null>(null);\n  const isMountedRef = useRef(true);\n\n  // Refs for callbacks and options to avoid stale closures and unnecessary re-renders\n  const onStopRef = useRef(onStop);\n  const onUpdateRef = useRef(onUpdate);\n  const onErrorRef = useRef(onError);\n  const fetchFnRef = useRef(fetchFn);\n  const stopStatusesRef = useRef(stopStatuses);\n  const intervalValueRef = useRef(interval);\n  const isPollingRef = useRef(false);\n\n  useEffect(() => {\n    onStopRef.current = onStop;\n    onUpdateRef.current = onUpdate;\n    onErrorRef.current = onError;\n    fetchFnRef.current = fetchFn;\n    stopStatusesRef.current = stopStatuses;\n    intervalValueRef.current = interval;\n  });\n\n  const clearPolling = useCallback(() => {\n    if (intervalRef.current) {\n      clearInterval(intervalRef.current);\n      intervalRef.current = null;\n    }\n    isPollingRef.current = false;\n  }, []);\n\n  const fetchData = useCallback(async () => {\n    console.log('[usePolling] fetchData called, isMounted:', isMountedRef.current);\n    if (!isMountedRef.current) return;\n\n    try {\n      console.log('[usePolling] Fetching...');\n      const result = await fetchFnRef.current();\n      console.log('[usePolling] Fetch result:', { status: result.status, messageCount: result.chatHistory?.length });\n\n      if (!isMountedRef.current) return;\n\n      setData(result);\n      setError(null);\n      onUpdateRef.current?.(result);\n\n      // Check if we should stop polling\n      const shouldStop = stopStatusesRef.current.includes(result.status);\n      console.log('[usePolling] Should stop?', shouldStop, 'stopStatuses:', stopStatusesRef.current, 'current status:', result.status);\n      if (shouldStop) {\n        console.log('[usePolling] Stopping polling due to status:', result.status);\n        clearPolling();\n        setIsPolling(false);\n        onStopRef.current?.(result);\n      }\n    } catch (err) {\n      console.error('[usePolling] Fetch error:', err);\n      if (!isMountedRef.current) return;\n\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      onErrorRef.current?.(error);\n\n      // Stop polling on error\n      clearPolling();\n      setIsPolling(false);\n    }\n  }, [clearPolling]);\n\n  const start = useCallback(() => {\n    if (intervalRef.current) return;\n\n    isPollingRef.current = true;\n    setIsPolling(true);\n    setError(null);\n\n    // Immediate first fetch\n    fetchData();\n\n    // Set up interval\n    intervalRef.current = setInterval(fetchData, intervalValueRef.current);\n  }, [fetchData]);\n\n  const stop = useCallback(() => {\n    clearPolling();\n    setIsPolling(false);\n  }, [clearPolling]);\n\n  const refetch = useCallback(async () => {\n    await fetchData();\n  }, [fetchData]);\n\n  // Auto-start polling when enabled and chatUid is set\n  useEffect(() => {\n    console.log('[usePolling] Auto-start effect triggered:', { enabled, chatUid, isPollingRef: isPollingRef.current, intervalRef: !!intervalRef.current });\n\n    if (!enabled || !chatUid) {\n      console.log('[usePolling] Not enabled or no chatUid, stopping if active');\n      // Stop polling if disabled or no chatUid\n      if (isPollingRef.current) {\n        clearPolling();\n        setIsPolling(false);\n      }\n      return;\n    }\n\n    // Start polling if not already polling\n    if (!isPollingRef.current) {\n      console.log('[usePolling] Starting polling, interval:', intervalValueRef.current);\n      isPollingRef.current = true;\n      setIsPolling(true);\n      setError(null);\n\n      // Immediate first fetch\n      fetchData();\n\n      // Set up interval\n      intervalRef.current = setInterval(fetchData, intervalValueRef.current);\n      console.log('[usePolling] Interval set:', intervalRef.current);\n    } else {\n      console.log('[usePolling] Already polling, skipping start');\n    }\n\n    // Only cleanup on unmount, not on every dependency change\n  }, [enabled, chatUid, fetchData, clearPolling]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    isMountedRef.current = true;\n    return () => {\n      isMountedRef.current = false;\n      clearPolling();\n    };\n  }, [clearPolling]);\n\n  return {\n    data,\n    isPolling,\n    error,\n    start,\n    stop,\n    refetch,\n  };\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"usePolling.js","sources":["../../../src/hooks/usePolling.ts"],"sourcesContent":["import { useState, useEffect, useRef, useCallback, useMemo } from 'react';\nimport type { RealtimeChatHistory, RealtimeStatus } from '../api/types';\nimport { createLogger } from '../utils/logger';\n\nexport interface UsePollingOptions {\n  /**\n   * Polling interval in milliseconds\n   * @default 1000\n   */\n  interval?: number;\n\n  /**\n   * Whether polling is enabled\n   * @default true\n   */\n  enabled?: boolean;\n\n  /**\n   * Statuses that should stop polling\n   * @default ['completed', 'error']\n   */\n  stopStatuses?: RealtimeStatus[];\n\n  /**\n   * Callback when polling stops\n   */\n  onStop?: (data: RealtimeChatHistory | null) => void;\n\n  /**\n   * Callback on each poll update\n   */\n  onUpdate?: (data: RealtimeChatHistory) => void;\n\n  /**\n   * Callback on poll error\n   */\n  onError?: (error: Error) => void;\n\n  /**\n   * Enable debug logging\n   * @default false\n   */\n  debug?: boolean;\n}\n\nexport interface UsePollingResult {\n  /**\n   * Current polling data\n   */\n  data: RealtimeChatHistory | null;\n\n  /**\n   * Whether polling is currently active\n   */\n  isPolling: boolean;\n\n  /**\n   * Last error that occurred\n   */\n  error: Error | null;\n\n  /**\n   * Start polling\n   */\n  start: () => void;\n\n  /**\n   * Stop polling\n   */\n  stop: () => void;\n\n  /**\n   * Manually trigger a fetch\n   */\n  refetch: () => Promise<void>;\n}\n\n/**\n * Hook for polling real-time chat history\n *\n * @param chatUid - The chat UID to poll for\n * @param fetchFn - Function that fetches the realtime history\n * @param options - Polling options\n */\nexport function usePolling(\n  chatUid: string | null,\n  fetchFn: () => Promise<RealtimeChatHistory>,\n  options: UsePollingOptions = {}\n): UsePollingResult {\n  const {\n    interval = 1000,\n    enabled = true,\n    stopStatuses = ['completed', 'error'],\n    onStop,\n    onUpdate,\n    onError,\n    debug = false,\n  } = options;\n\n  const log = useMemo(() => createLogger(debug), [debug]);\n  const logRef = useRef(log);\n  logRef.current = log;\n\n  const [data, setData] = useState<RealtimeChatHistory | null>(null);\n  const [isPolling, setIsPolling] = useState(false);\n  const [error, setError] = useState<Error | null>(null);\n\n  const intervalRef = useRef<ReturnType<typeof setInterval> | null>(null);\n  const isMountedRef = useRef(true);\n\n  // Refs for callbacks and options to avoid stale closures and unnecessary re-renders\n  const onStopRef = useRef(onStop);\n  const onUpdateRef = useRef(onUpdate);\n  const onErrorRef = useRef(onError);\n  const fetchFnRef = useRef(fetchFn);\n  const stopStatusesRef = useRef(stopStatuses);\n  const intervalValueRef = useRef(interval);\n  const isPollingRef = useRef(false);\n\n  useEffect(() => {\n    onStopRef.current = onStop;\n    onUpdateRef.current = onUpdate;\n    onErrorRef.current = onError;\n    fetchFnRef.current = fetchFn;\n    stopStatusesRef.current = stopStatuses;\n    intervalValueRef.current = interval;\n  });\n\n  const clearPolling = useCallback(() => {\n    if (intervalRef.current) {\n      clearInterval(intervalRef.current);\n      intervalRef.current = null;\n    }\n    isPollingRef.current = false;\n  }, []);\n\n  const fetchData = useCallback(async () => {\n    logRef.current.log('[usePolling] fetchData called, isMounted:', isMountedRef.current);\n    if (!isMountedRef.current) return;\n\n    try {\n      logRef.current.log('[usePolling] Fetching...');\n      const result = await fetchFnRef.current();\n      logRef.current.log('[usePolling] Fetch result:', { status: result.status, messageCount: result.chatHistory?.length });\n\n      if (!isMountedRef.current) return;\n\n      setData(result);\n      setError(null);\n      onUpdateRef.current?.(result);\n\n      // Check if we should stop polling\n      const shouldStop = stopStatusesRef.current.includes(result.status);\n      logRef.current.log('[usePolling] Should stop?', shouldStop, 'stopStatuses:', stopStatusesRef.current, 'current status:', result.status);\n      if (shouldStop) {\n        logRef.current.log('[usePolling] Stopping polling due to status:', result.status);\n        clearPolling();\n        setIsPolling(false);\n        onStopRef.current?.(result);\n      }\n    } catch (err) {\n      logRef.current.error('[usePolling] Fetch error:', err);\n      if (!isMountedRef.current) return;\n\n      const error = err instanceof Error ? err : new Error(String(err));\n      setError(error);\n      onErrorRef.current?.(error);\n\n      // Stop polling on error\n      clearPolling();\n      setIsPolling(false);\n    }\n  }, [clearPolling]);\n\n  const start = useCallback(() => {\n    if (intervalRef.current) return;\n\n    isPollingRef.current = true;\n    setIsPolling(true);\n    setError(null);\n\n    // Immediate first fetch\n    fetchData();\n\n    // Set up interval\n    intervalRef.current = setInterval(fetchData, intervalValueRef.current);\n  }, [fetchData]);\n\n  const stop = useCallback(() => {\n    clearPolling();\n    setIsPolling(false);\n  }, [clearPolling]);\n\n  const refetch = useCallback(async () => {\n    await fetchData();\n  }, [fetchData]);\n\n  // Auto-start polling when enabled and chatUid is set\n  useEffect(() => {\n    logRef.current.log('[usePolling] Auto-start effect triggered:', { enabled, chatUid, isPollingRef: isPollingRef.current, intervalRef: !!intervalRef.current });\n\n    if (!enabled || !chatUid) {\n      logRef.current.log('[usePolling] Not enabled or no chatUid, stopping if active');\n      // Stop polling if disabled or no chatUid\n      if (isPollingRef.current) {\n        clearPolling();\n        setIsPolling(false);\n      }\n      return;\n    }\n\n    // Start polling if not already polling\n    if (!isPollingRef.current) {\n      logRef.current.log('[usePolling] Starting polling, interval:', intervalValueRef.current);\n      isPollingRef.current = true;\n      setIsPolling(true);\n      setError(null);\n\n      // Immediate first fetch\n      fetchData();\n\n      // Set up interval\n      intervalRef.current = setInterval(fetchData, intervalValueRef.current);\n      logRef.current.log('[usePolling] Interval set:', intervalRef.current);\n    } else {\n      logRef.current.log('[usePolling] Already polling, skipping start');\n    }\n\n    // Only cleanup on unmount, not on every dependency change\n  }, [enabled, chatUid, fetchData, clearPolling]);\n\n  // Cleanup on unmount\n  useEffect(() => {\n    isMountedRef.current = true;\n    return () => {\n      isMountedRef.current = false;\n      clearPolling();\n    };\n  }, [clearPolling]);\n\n  return {\n    data,\n    isPolling,\n    error,\n    start,\n    stop,\n    refetch,\n  };\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/provider/DevicProvider.d.ts

@@ -14,4 +14,4 @@ import type { DevicProviderProps } from './types';
  * </DevicProvider>
  * ```
  */
-export declare function DevicProvider({ apiKey, baseUrl, tenantId, tenantMetadata, children, }: DevicProviderProps): JSX.Element;
+export declare function DevicProvider({ apiKey, baseUrl, tenantId, tenantMetadata, debug, children, }: DevicProviderProps): JSX.Element;

package/dist/esm/provider/DevicProvider.js

@@ -19,7 +19,7 @@ const DEFAULT_BASE_URL = 'https://api.devic.ai';
  * </DevicProvider>
  * ```
  */
-function DevicProvider({ apiKey, baseUrl = DEFAULT_BASE_URL, tenantId, tenantMetadata, children, }) {
+function DevicProvider({ apiKey, baseUrl = DEFAULT_BASE_URL, tenantId, tenantMetadata, debug, children, }) {
     const contextValue = useMemo(() => {
         const client = new DevicApiClient({
             apiKey,
@@ -32,8 +32,9 @@ function DevicProvider({ apiKey, baseUrl = DEFAULT_BASE_URL, tenantId, tenantMet
             tenantId,
             tenantMetadata,
             isConfigured: !!apiKey,
+            debug,
         };
-    }, [apiKey, baseUrl, tenantId, tenantMetadata]);
+    }, [apiKey, baseUrl, tenantId, tenantMetadata, debug]);
     return (jsx(DevicContext.Provider, { value: contextValue, children: children }));
 }
 

package/dist/esm/provider/DevicProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"DevicProvider.js","sources":["../../../src/provider/DevicProvider.tsx"],"sourcesContent":["import React, { useMemo } from 'react';\nimport { DevicContext } from './DevicContext';\nimport { DevicApiClient } from '../api/client';\nimport type { DevicProviderProps, DevicContextValue } from './types';\n\nconst DEFAULT_BASE_URL = 'https://api.devic.ai';\n\n/**\n * Provider component for Devic UI configuration\n *\n * @example\n * ```tsx\n * <DevicProvider\n *   apiKey=\"devic-xxx\"\n *   baseUrl=\"https://api.devic.ai\"\n *   tenantId=\"tenant-123\"\n *   tenantMetadata={{ userId: '456' }}\n * >\n *   <App />\n * </DevicProvider>\n * ```\n */\nexport function DevicProvider({\n  apiKey,\n  baseUrl = DEFAULT_BASE_URL,\n  tenantId,\n  tenantMetadata,\n  children,\n}: DevicProviderProps): JSX.Element {\n  const contextValue = useMemo<DevicContextValue>(() => {\n    const client = new DevicApiClient({\n      apiKey,\n      baseUrl,\n    });\n\n    return {\n      client,\n      apiKey,\n      baseUrl,\n      tenantId,\n      tenantMetadata,\n      isConfigured: !!apiKey,\n    };\n  }, [apiKey, baseUrl, tenantId, tenantMetadata]);\n\n  return (\n    <DevicContext.Provider value={contextValue}>\n      {children}\n    </DevicContext.Provider>\n  );\n}\n"],"names":["_jsx"],"mappings":";;;;;AAKA,MAAM,gBAAgB,GAAG,sBAAsB;AAE/C;;;;;;;;;;;;;;AAcG;AACG,SAAU,aAAa,CAAC,EAC5B,MAAM,EACN,OAAO,GAAG,gBAAgB,EAC1B,QAAQ,EACR,cAAc,EACd,QAAQ,GACW,EAAA;AACnB,IAAA,MAAM,YAAY,GAAG,OAAO,CAAoB,MAAK;AACnD,QAAA,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;YAChC,MAAM;YACN,OAAO;AACR,SAAA,CAAC;QAEF,OAAO;YACL,MAAM;YACN,MAAM;YACN,OAAO;YACP,QAAQ;YACR,cAAc;YACd,YAAY,EAAE,CAAC,CAAC,MAAM;SACvB;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,CAAC,CAAC;AAE/C,IAAA,QACEA,GAAA,CAAC,YAAY,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,YAAY,EAAA,QAAA,EACvC,QAAQ,EAAA,CACa;AAE5B;;;;"}
+{"version":3,"file":"DevicProvider.js","sources":["../../../src/provider/DevicProvider.tsx"],"sourcesContent":["import React, { useMemo } from 'react';\nimport { DevicContext } from './DevicContext';\nimport { DevicApiClient } from '../api/client';\nimport type { DevicProviderProps, DevicContextValue } from './types';\n\nconst DEFAULT_BASE_URL = 'https://api.devic.ai';\n\n/**\n * Provider component for Devic UI configuration\n *\n * @example\n * ```tsx\n * <DevicProvider\n *   apiKey=\"devic-xxx\"\n *   baseUrl=\"https://api.devic.ai\"\n *   tenantId=\"tenant-123\"\n *   tenantMetadata={{ userId: '456' }}\n * >\n *   <App />\n * </DevicProvider>\n * ```\n */\nexport function DevicProvider({\n  apiKey,\n  baseUrl = DEFAULT_BASE_URL,\n  tenantId,\n  tenantMetadata,\n  debug,\n  children,\n}: DevicProviderProps): JSX.Element {\n  const contextValue = useMemo<DevicContextValue>(() => {\n    const client = new DevicApiClient({\n      apiKey,\n      baseUrl,\n    });\n\n    return {\n      client,\n      apiKey,\n      baseUrl,\n      tenantId,\n      tenantMetadata,\n      isConfigured: !!apiKey,\n      debug,\n    };\n  }, [apiKey, baseUrl, tenantId, tenantMetadata, debug]);\n\n  return (\n    <DevicContext.Provider value={contextValue}>\n      {children}\n    </DevicContext.Provider>\n  );\n}\n"],"names":["_jsx"],"mappings":";;;;;AAKA,MAAM,gBAAgB,GAAG,sBAAsB;AAE/C;;;;;;;;;;;;;;AAcG;SACa,aAAa,CAAC,EAC5B,MAAM,EACN,OAAO,GAAG,gBAAgB,EAC1B,QAAQ,EACR,cAAc,EACd,KAAK,EACL,QAAQ,GACW,EAAA;AACnB,IAAA,MAAM,YAAY,GAAG,OAAO,CAAoB,MAAK;AACnD,QAAA,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;YAChC,MAAM;YACN,OAAO;AACR,SAAA,CAAC;QAEF,OAAO;YACL,MAAM;YACN,MAAM;YACN,OAAO;YACP,QAAQ;YACR,cAAc;YACd,YAAY,EAAE,CAAC,CAAC,MAAM;YACtB,KAAK;SACN;AACH,IAAA,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,CAAC,CAAC;AAEtD,IAAA,QACEA,GAAA,CAAC,YAAY,CAAC,QAAQ,EAAA,EAAC,KAAK,EAAE,YAAY,EAAA,QAAA,EACvC,QAAQ,EAAA,CACa;AAE5B;;;;"}

package/dist/esm/provider/types.d.ts

@@ -20,6 +20,11 @@ export interface DevicProviderConfig {
      * Global tenant metadata
      */
     tenantMetadata?: Record<string, any>;
+    /**
+     * Enable debug logging to the browser console
+     * @default false
+     */
+    debug?: boolean;
 }
 /**
  * Context value provided by DevicProvider
@@ -49,6 +54,10 @@ export interface DevicContextValue {
      * Whether the provider is properly configured
      */
     isConfigured: boolean;
+    /**
+     * Whether debug logging is enabled
+     */
+    debug?: boolean;
 }
 /**
  * Props for the DevicProvider component

package/dist/esm/utils/index.d.ts

@@ -1,4 +1,6 @@
 export { segmentToolCalls } from './toolGroups';
+export { createLogger } from './logger';
+export type { DevicLogger } from './logger';
 export type { ToolGroupSegment } from './toolGroups';
 /**
  * Generate a unique ID

package/dist/esm/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/utils/index.ts"],"sourcesContent":["export { segmentToolCalls } from './toolGroups';\nexport type { ToolGroupSegment } from './toolGroups';\n\n/**\n * Generate a unique ID\n */\nexport function generateId(): string {\n  return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;\n}\n\n/**\n * Deep merge two objects\n */\nexport function deepMerge<T extends Record<string, any>>(\n  target: T,\n  source: Partial<T>\n): T {\n  const result = { ...target };\n\n  for (const key in source) {\n    if (Object.prototype.hasOwnProperty.call(source, key)) {\n      const sourceValue = source[key];\n      const targetValue = result[key];\n\n      if (\n        sourceValue &&\n        typeof sourceValue === 'object' &&\n        !Array.isArray(sourceValue) &&\n        targetValue &&\n        typeof targetValue === 'object' &&\n        !Array.isArray(targetValue)\n      ) {\n        result[key] = deepMerge(targetValue, sourceValue as any);\n      } else if (sourceValue !== undefined) {\n        result[key] = sourceValue as any;\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Debounce a function\n */\nexport function debounce<T extends (...args: any[]) => any>(\n  fn: T,\n  delay: number\n): (...args: Parameters<T>) => void {\n  let timeoutId: ReturnType<typeof setTimeout>;\n\n  return (...args: Parameters<T>) => {\n    clearTimeout(timeoutId);\n    timeoutId = setTimeout(() => fn(...args), delay);\n  };\n}\n\n/**\n * Throttle a function\n */\nexport function throttle<T extends (...args: any[]) => any>(\n  fn: T,\n  delay: number\n): (...args: Parameters<T>) => void {\n  let lastCall = 0;\n\n  return (...args: Parameters<T>) => {\n    const now = Date.now();\n    if (now - lastCall >= delay) {\n      lastCall = now;\n      fn(...args);\n    }\n  };\n}\n\n/**\n * Format file size for display\n */\nexport function formatFileSize(bytes: number): string {\n  if (bytes === 0) return '0 B';\n\n  const units = ['B', 'KB', 'MB', 'GB'];\n  const k = 1024;\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(1))} ${units[i]}`;\n}\n\n/**\n * Check if running in browser\n */\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\n/**\n * Local storage helper with JSON serialization\n */\nexport const storage = {\n  get<T>(key: string, defaultValue?: T): T | null {\n    if (!isBrowser()) return defaultValue ?? null;\n\n    try {\n      const item = localStorage.getItem(key);\n      return item ? JSON.parse(item) : (defaultValue ?? null);\n    } catch {\n      return defaultValue ?? null;\n    }\n  },\n\n  set<T>(key: string, value: T): void {\n    if (!isBrowser()) return;\n\n    try {\n      localStorage.setItem(key, JSON.stringify(value));\n    } catch {\n      // Storage full or other error\n    }\n  },\n\n  remove(key: string): void {\n    if (!isBrowser()) return;\n\n    try {\n      localStorage.removeItem(key);\n    } catch {\n      // Error removing item\n    }\n  },\n};\n"],"names":[],"mappings":"AAGA;;AAEG;SACa,UAAU,GAAA;IACxB,OAAO,CAAA,EAAG,IAAI,CAAC,GAAG,EAAE,CAAA,CAAA,EAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA,CAAE;AACtE;AAEA;;AAEG;AACG,SAAU,SAAS,CACvB,MAAS,EACT,MAAkB,EAAA;AAElB,IAAA,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE;AAE5B,IAAA,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;AACxB,QAAA,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE;AACrD,YAAA,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC;AAC/B,YAAA,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC;AAE/B,YAAA,IACE,WAAW;gBACX,OAAO,WAAW,KAAK,QAAQ;AAC/B,gBAAA,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;gBAC3B,WAAW;gBACX,OAAO,WAAW,KAAK,QAAQ;AAC/B,gBAAA,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B;gBACA,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,WAAkB,CAAC;YAC1D;AAAO,iBAAA,IAAI,WAAW,KAAK,SAAS,EAAE;AACpC,gBAAA,MAAM,CAAC,GAAG,CAAC,GAAG,WAAkB;YAClC;QACF;IACF;AAEA,IAAA,OAAO,MAAM;AACf;AAEA;;AAEG;AACG,SAAU,QAAQ,CACtB,EAAK,EACL,KAAa,EAAA;AAEb,IAAA,IAAI,SAAwC;AAE5C,IAAA,OAAO,CAAC,GAAG,IAAmB,KAAI;QAChC,YAAY,CAAC,SAAS,CAAC;AACvB,QAAA,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC;AAClD,IAAA,CAAC;AACH;AAEA;;AAEG;AACG,SAAU,QAAQ,CACtB,EAAK,EACL,KAAa,EAAA;IAEb,IAAI,QAAQ,GAAG,CAAC;AAEhB,IAAA,OAAO,CAAC,GAAG,IAAmB,KAAI;AAChC,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;AACtB,QAAA,IAAI,GAAG,GAAG,QAAQ,IAAI,KAAK,EAAE;YAC3B,QAAQ,GAAG,GAAG;AACd,YAAA,EAAE,CAAC,GAAG,IAAI,CAAC;QACb;AACF,IAAA,CAAC;AACH;AAEA;;AAEG;AACG,SAAU,cAAc,CAAC,KAAa,EAAA;IAC1C,IAAI,KAAK,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK;IAE7B,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI;IACd,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEnD,OAAO,CAAA,EAAG,UAAU,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA,CAAA,EAAI,KAAK,CAAC,CAAC,CAAC,CAAA,CAAE;AACzE;AAEA;;AAEG;SACa,SAAS,GAAA;AACvB,IAAA,OAAO,OAAO,MAAM,KAAK,WAAW;AACtC;AAEA;;AAEG;AACI,MAAM,OAAO,GAAG;IACrB,GAAG,CAAI,GAAW,EAAE,YAAgB,EAAA;QAClC,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO,YAAY,IAAI,IAAI;AAE7C,QAAA,IAAI;YACF,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;AACtC,YAAA,OAAO,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,IAAI,IAAI,CAAC;QACzD;AAAE,QAAA,MAAM;YACN,OAAO,YAAY,IAAI,IAAI;QAC7B;IACF,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAA;QAC1B,IAAI,CAAC,SAAS,EAAE;YAAE;AAElB,QAAA,IAAI;AACF,YAAA,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD;AAAE,QAAA,MAAM;;QAER;IACF,CAAC;AAED,IAAA,MAAM,CAAC,GAAW,EAAA;QAChB,IAAI,CAAC,SAAS,EAAE;YAAE;AAElB,QAAA,IAAI;AACF,YAAA,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;QAC9B;AAAE,QAAA,MAAM;;QAER;IACF,CAAC;;;;;"}
+{"version":3,"file":"index.js","sources":["../../../src/utils/index.ts"],"sourcesContent":["export { segmentToolCalls } from './toolGroups';\nexport { createLogger } from './logger';\nexport type { DevicLogger } from './logger';\nexport type { ToolGroupSegment } from './toolGroups';\n\n/**\n * Generate a unique ID\n */\nexport function generateId(): string {\n  return `${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;\n}\n\n/**\n * Deep merge two objects\n */\nexport function deepMerge<T extends Record<string, any>>(\n  target: T,\n  source: Partial<T>\n): T {\n  const result = { ...target };\n\n  for (const key in source) {\n    if (Object.prototype.hasOwnProperty.call(source, key)) {\n      const sourceValue = source[key];\n      const targetValue = result[key];\n\n      if (\n        sourceValue &&\n        typeof sourceValue === 'object' &&\n        !Array.isArray(sourceValue) &&\n        targetValue &&\n        typeof targetValue === 'object' &&\n        !Array.isArray(targetValue)\n      ) {\n        result[key] = deepMerge(targetValue, sourceValue as any);\n      } else if (sourceValue !== undefined) {\n        result[key] = sourceValue as any;\n      }\n    }\n  }\n\n  return result;\n}\n\n/**\n * Debounce a function\n */\nexport function debounce<T extends (...args: any[]) => any>(\n  fn: T,\n  delay: number\n): (...args: Parameters<T>) => void {\n  let timeoutId: ReturnType<typeof setTimeout>;\n\n  return (...args: Parameters<T>) => {\n    clearTimeout(timeoutId);\n    timeoutId = setTimeout(() => fn(...args), delay);\n  };\n}\n\n/**\n * Throttle a function\n */\nexport function throttle<T extends (...args: any[]) => any>(\n  fn: T,\n  delay: number\n): (...args: Parameters<T>) => void {\n  let lastCall = 0;\n\n  return (...args: Parameters<T>) => {\n    const now = Date.now();\n    if (now - lastCall >= delay) {\n      lastCall = now;\n      fn(...args);\n    }\n  };\n}\n\n/**\n * Format file size for display\n */\nexport function formatFileSize(bytes: number): string {\n  if (bytes === 0) return '0 B';\n\n  const units = ['B', 'KB', 'MB', 'GB'];\n  const k = 1024;\n  const i = Math.floor(Math.log(bytes) / Math.log(k));\n\n  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(1))} ${units[i]}`;\n}\n\n/**\n * Check if running in browser\n */\nexport function isBrowser(): boolean {\n  return typeof window !== 'undefined';\n}\n\n/**\n * Local storage helper with JSON serialization\n */\nexport const storage = {\n  get<T>(key: string, defaultValue?: T): T | null {\n    if (!isBrowser()) return defaultValue ?? null;\n\n    try {\n      const item = localStorage.getItem(key);\n      return item ? JSON.parse(item) : (defaultValue ?? null);\n    } catch {\n      return defaultValue ?? null;\n    }\n  },\n\n  set<T>(key: string, value: T): void {\n    if (!isBrowser()) return;\n\n    try {\n      localStorage.setItem(key, JSON.stringify(value));\n    } catch {\n      // Storage full or other error\n    }\n  },\n\n  remove(key: string): void {\n    if (!isBrowser()) return;\n\n    try {\n      localStorage.removeItem(key);\n    } catch {\n      // Error removing item\n    }\n  },\n};\n"],"names":[],"mappings":"AAKA;;AAEG;SACa,UAAU,GAAA;IACxB,OAAO,CAAA,EAAG,IAAI,CAAC,GAAG,EAAE,CAAA,CAAA,EAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA,CAAE;AACtE;AAEA;;AAEG;AACG,SAAU,SAAS,CACvB,MAAS,EACT,MAAkB,EAAA;AAElB,IAAA,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE;AAE5B,IAAA,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE;AACxB,QAAA,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE;AACrD,YAAA,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC;AAC/B,YAAA,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC;AAE/B,YAAA,IACE,WAAW;gBACX,OAAO,WAAW,KAAK,QAAQ;AAC/B,gBAAA,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;gBAC3B,WAAW;gBACX,OAAO,WAAW,KAAK,QAAQ;AAC/B,gBAAA,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAC3B;gBACA,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,WAAW,EAAE,WAAkB,CAAC;YAC1D;AAAO,iBAAA,IAAI,WAAW,KAAK,SAAS,EAAE;AACpC,gBAAA,MAAM,CAAC,GAAG,CAAC,GAAG,WAAkB;YAClC;QACF;IACF;AAEA,IAAA,OAAO,MAAM;AACf;AAEA;;AAEG;AACG,SAAU,QAAQ,CACtB,EAAK,EACL,KAAa,EAAA;AAEb,IAAA,IAAI,SAAwC;AAE5C,IAAA,OAAO,CAAC,GAAG,IAAmB,KAAI;QAChC,YAAY,CAAC,SAAS,CAAC;AACvB,QAAA,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,KAAK,CAAC;AAClD,IAAA,CAAC;AACH;AAEA;;AAEG;AACG,SAAU,QAAQ,CACtB,EAAK,EACL,KAAa,EAAA;IAEb,IAAI,QAAQ,GAAG,CAAC;AAEhB,IAAA,OAAO,CAAC,GAAG,IAAmB,KAAI;AAChC,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;AACtB,QAAA,IAAI,GAAG,GAAG,QAAQ,IAAI,KAAK,EAAE;YAC3B,QAAQ,GAAG,GAAG;AACd,YAAA,EAAE,CAAC,GAAG,IAAI,CAAC;QACb;AACF,IAAA,CAAC;AACH;AAEA;;AAEG;AACG,SAAU,cAAc,CAAC,KAAa,EAAA;IAC1C,IAAI,KAAK,KAAK,CAAC;AAAE,QAAA,OAAO,KAAK;IAE7B,MAAM,KAAK,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;IACrC,MAAM,CAAC,GAAG,IAAI;IACd,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAEnD,OAAO,CAAA,EAAG,UAAU,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAA,CAAA,EAAI,KAAK,CAAC,CAAC,CAAC,CAAA,CAAE;AACzE;AAEA;;AAEG;SACa,SAAS,GAAA;AACvB,IAAA,OAAO,OAAO,MAAM,KAAK,WAAW;AACtC;AAEA;;AAEG;AACI,MAAM,OAAO,GAAG;IACrB,GAAG,CAAI,GAAW,EAAE,YAAgB,EAAA;QAClC,IAAI,CAAC,SAAS,EAAE;YAAE,OAAO,YAAY,IAAI,IAAI;AAE7C,QAAA,IAAI;YACF,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC;AACtC,YAAA,OAAO,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,YAAY,IAAI,IAAI,CAAC;QACzD;AAAE,QAAA,MAAM;YACN,OAAO,YAAY,IAAI,IAAI;QAC7B;IACF,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAA;QAC1B,IAAI,CAAC,SAAS,EAAE;YAAE;AAElB,QAAA,IAAI;AACF,YAAA,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD;AAAE,QAAA,MAAM;;QAER;IACF,CAAC;AAED,IAAA,MAAM,CAAC,GAAW,EAAA;QAChB,IAAI,CAAC,SAAS,EAAE;YAAE;AAElB,QAAA,IAAI;AACF,YAAA,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC;QAC9B;AAAE,QAAA,MAAM;;QAER;IACF,CAAC;;;;;"}

package/dist/esm/utils/logger.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Conditional logger for devic-ui.
+ * Only outputs when debug mode is enabled via the Provider or component props.
+ */
+export declare function createLogger(enabled: boolean): {
+    log: (...data: any[]) => void;
+    warn: (...data: any[]) => void;
+    error: (...data: any[]) => void;
+};
+export type DevicLogger = ReturnType<typeof createLogger>;

package/dist/esm/utils/logger.js

@@ -0,0 +1,15 @@
+/**
+ * Conditional logger for devic-ui.
+ * Only outputs when debug mode is enabled via the Provider or component props.
+ */
+function createLogger(enabled) {
+    const noop = () => { };
+    return {
+        log: enabled ? console.log.bind(console) : noop,
+        warn: enabled ? console.warn.bind(console) : noop,
+        error: enabled ? console.error.bind(console) : noop,
+    };
+}
+
+export { createLogger };
+//# sourceMappingURL=logger.js.map

package/dist/esm/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sources":["../../../src/utils/logger.ts"],"sourcesContent":["/**\n * Conditional logger for devic-ui.\n * Only outputs when debug mode is enabled via the Provider or component props.\n */\nexport function createLogger(enabled: boolean) {\n  const noop = () => {};\n  return {\n    log: enabled ? console.log.bind(console) : noop,\n    warn: enabled ? console.warn.bind(console) : noop,\n    error: enabled ? console.error.bind(console) : noop,\n  };\n}\n\nexport type DevicLogger = ReturnType<typeof createLogger>;\n"],"names":[],"mappings":"AAAA;;;AAGG;AACG,SAAU,YAAY,CAAC,OAAgB,EAAA;AAC3C,IAAA,MAAM,IAAI,GAAG,MAAK,EAAE,CAAC;IACrB,OAAO;AACL,QAAA,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI;AAC/C,QAAA,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI;AACjD,QAAA,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI;KACpD;AACH;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devicai/ui",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "type": "module",
   "description": "React component library for Devic AI assistants",
   "engines": {