@navsi.ai/sdk 1.0.0

package/dist/components/index.d.ts

@@ -0,0 +1,66 @@
+import React__default from 'react';
+import { NavigationAdapter, ServerAction, FlatWidgetConfig, WidgetConfig } from '@navsi.ai/shared';
+
+/**
+ * ChatbotProvider Component
+ *
+ * Main provider component that initializes the chatbot SDK.
+ * Manages WebSocket connection, message state, and provides context to children.
+ */
+
+interface ChatbotProviderProps {
+    /** API key for authentication */
+    apiKey: string;
+    /** WebSocket server URL */
+    serverUrl: string;
+    /** Navigation adapter (defaults to memory adapter) */
+    navigationAdapter?: NavigationAdapter;
+    /** Server actions to register */
+    serverActions?: ServerAction[];
+    /** Widget config from API (flat shape). Fetched e.g. from GET /api/sdk/config. Takes precedence over options when merged. */
+    config?: FlatWidgetConfig | null;
+    /** Widget configuration (nested shape). Merged with config if both provided. */
+    options?: Partial<WidgetConfig>;
+    /** Optional list of available routes (included in page context for the AI) */
+    routes?: string[];
+    /** Enable debug mode */
+    debug?: boolean;
+    /** Auto-connect on mount */
+    autoConnect?: boolean;
+    /** Children components */
+    children: React__default.ReactNode;
+}
+declare function ChatbotProvider({ apiKey, serverUrl, navigationAdapter, serverActions, config: configFromApi, options, routes, debug, autoConnect, children, }: ChatbotProviderProps): React__default.ReactElement;
+
+/**
+ * ChatbotWidget Component
+ *
+ * Floating chat widget UI component.
+ */
+
+interface ChatbotWidgetProps {
+    /** Custom class name for the widget container */
+    className?: string;
+    /** Custom class name for the widget window */
+    windowClassName?: string;
+    /** Custom class name for the toggle button */
+    buttonClassName?: string;
+}
+/**
+ * Floating chat widget component. Open state is stored in context so the panel
+ * stays open across navigation (e.g. when using Action mode).
+ * Supports Ask and Action modes for text chat.
+ *
+ * All styling is controlled via CSS classes. Users have full control over appearance.
+ *
+ * @example
+ * ```tsx
+ * <ChatbotProvider apiKey="..." serverUrl="...">
+ *   <App />
+ *   <ChatbotWidget className="my-chatbot" />
+ * </ChatbotProvider>
+ * ```
+ */
+declare function ChatbotWidget({ className, windowClassName, buttonClassName }: ChatbotWidgetProps): React__default.ReactElement;
+
+export { ChatbotProvider, type ChatbotProviderProps, ChatbotWidget, type ChatbotWidgetProps };

package/dist/components/index.js

@@ -0,0 +1,4 @@
+export { ChatbotProvider, ChatbotWidget } from '../chunk-EHZXIZIP.js';
+import '../chunk-6FUUG5WB.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/hooks/index.d.ts

@@ -0,0 +1,104 @@
+import { WidgetConfig, Message, ChatMode, ServerAction, ConnectionState, ExecutionState } from '@navsi.ai/shared';
+
+/**
+ * useChatbot Hook
+ *
+ * Main hook for accessing chatbot functionality.
+ * Provides simplified API for common operations.
+ */
+
+interface UseChatbotReturn {
+    /** Widget styling/copy from admin (or options). Use in ChatbotWidget. */
+    widgetConfig: Partial<WidgetConfig> | null;
+    /** Effective voice/response language (user-selected or config). Use for STT/TTS and locale. */
+    voiceLanguage: string | undefined;
+    setVoiceLanguage: (lang: string | undefined) => void;
+    messages: Message[];
+    sendMessage: (content: string) => void;
+    clearMessages: () => void;
+    mode: ChatMode;
+    setMode: (mode: ChatMode) => void;
+    isWidgetOpen: boolean;
+    setWidgetOpen: (open: boolean) => void;
+    isConnected: boolean;
+    connect: () => void;
+    disconnect: () => void;
+    executeAction: (actionId: string, params?: Record<string, unknown>) => Promise<unknown>;
+    registerServerAction: (action: ServerAction) => void;
+    stopExecution: () => void;
+    isExecuting: boolean;
+    error: Error | null;
+    clearError: () => void;
+}
+/**
+ * Main hook for chatbot functionality
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const {
+ *     messages,
+ *     sendMessage,
+ *     isConnected,
+ *     mode,
+ *     setMode,
+ *   } = useChatbot();
+ *
+ *   return (
+ *     <div>
+ *       <button onClick={() => sendMessage('Hello!')}>
+ *         Send
+ *       </button>
+ *       <button onClick={() => startVoice()}>
+ *         Start Voice
+ *       </button>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function useChatbot(): UseChatbotReturn;
+
+/**
+ * useWebSocket Hook
+ *
+ * Hook for managing WebSocket connection state.
+ */
+
+interface UseWebSocketReturn {
+    connectionState: ConnectionState;
+    isConnected: boolean;
+    isConnecting: boolean;
+    isReconnecting: boolean;
+    connect: () => void;
+    disconnect: () => void;
+}
+/**
+ * Hook for WebSocket connection management
+ */
+declare function useWebSocket(): UseWebSocketReturn;
+
+/**
+ * useActionExecution Hook
+ *
+ * Hook for monitoring action execution state.
+ */
+
+interface UseActionExecutionReturn {
+    isExecuting: boolean;
+    executionState: ExecutionState | null;
+    currentCommand: ExecutionState['currentCommand'] | undefined;
+    progress: {
+        current: number;
+        total: number;
+        percentage: number;
+        /** Optional human-readable description of the current step */
+        description?: string;
+    } | null;
+}
+/**
+ * Hook for monitoring action execution
+ */
+declare function useActionExecution(): UseActionExecutionReturn;
+
+export { type UseActionExecutionReturn, type UseChatbotReturn, type UseWebSocketReturn, useActionExecution, useChatbot, useWebSocket };

package/dist/hooks/index.js

@@ -0,0 +1,4 @@
+import '../chunk-427NHGTX.js';
+export { useActionExecution, useChatbot, useWebSocket } from '../chunk-6FUUG5WB.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/index.d.ts

@@ -0,0 +1,286 @@
+export { ChatbotProvider, ChatbotProviderProps, ChatbotWidget, ChatbotWidgetProps } from './components/index.js';
+export { UseActionExecutionReturn, UseChatbotReturn, UseWebSocketReturn, useActionExecution, useChatbot, useWebSocket } from './hooks/index.js';
+import * as React from 'react';
+import { WidgetConfig, Message, ChatMode, ConnectionState as ConnectionState$1, ExecutionState, ServerAction, ClientMessage, WebSocketEvents, NavigationAdapter, PageContext } from '@navsi.ai/shared';
+export { ActionDefinition, ChatMode, Command, ExecutionState, Message, NavigationAdapter, PageContext, SDKConfig, ServerAction, WidgetConfig, WidgetTheme } from '@navsi.ai/shared';
+
+interface ChatbotContextValue {
+    /** Widget styling and copy (from admin / API). Applied by ChatbotWidget. */
+    widgetConfig: Partial<WidgetConfig> | null;
+    messages: Message[];
+    mode: ChatMode;
+    connectionState: ConnectionState$1;
+    isExecuting: boolean;
+    executionState: ExecutionState | null;
+    error: Error | null;
+    isWidgetOpen: boolean;
+    setWidgetOpen: (open: boolean) => void;
+    /** User-selected voice/response language (e.g. 'en-US', 'hi-IN'). Overrides widgetConfig.voiceLanguage when set. */
+    voiceLanguage: string | undefined;
+    setVoiceLanguage: (lang: string | undefined) => void;
+    sendMessage: (content: string) => void;
+    setMode: (mode: ChatMode) => void;
+    executeAction: (actionId: string, params?: Record<string, unknown>) => Promise<unknown>;
+    registerServerAction: (action: ServerAction) => void;
+    clearMessages: () => void;
+    clearError: () => void;
+    stopExecution: () => void;
+    connect: () => void;
+    disconnect: () => void;
+    isConnected: boolean;
+}
+declare const ChatbotContext: React.Context<ChatbotContextValue | null>;
+/**
+ * Hook to access chatbot context
+ * Must be used within ChatbotProvider
+ */
+declare function useChatbotContext(): ChatbotContextValue;
+
+/**
+ * WebSocket Client for AI Chatbot SDK
+ *
+ * Features:
+ * - Auto-reconnection with exponential backoff
+ * - Message queue for offline scenarios
+ * - Heartbeat mechanism (ping/pong every 30s)
+ * - Token refresh before expiry
+ * - Connection state management
+ */
+
+type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'failed';
+interface WebSocketClientConfig {
+    /** WebSocket server URL */
+    serverUrl: string;
+    /** API key for authentication */
+    apiKey: string;
+    /** Enable auto-reconnection */
+    autoReconnect?: boolean;
+    /** Maximum reconnection attempts */
+    maxReconnectAttempts?: number;
+    /** Initial reconnection delay in ms */
+    reconnectDelay?: number;
+    /** Heartbeat interval in ms */
+    heartbeatInterval?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+type EventCallback<T> = (data: T) => void;
+declare class WebSocketClient {
+    private ws;
+    private config;
+    private state;
+    private logger;
+    private reconnectAttempts;
+    private reconnectTimeout;
+    private heartbeatInterval;
+    private lastPongTime;
+    private messageQueue;
+    private sessionId;
+    private refreshToken;
+    private tokenExpiresAt;
+    private tokenRefreshTimeout;
+    private listeners;
+    constructor(config: WebSocketClientConfig);
+    /**
+     * Connect to the WebSocket server
+     */
+    connect(): void;
+    /**
+     * Disconnect from the server
+     */
+    disconnect(): void;
+    /**
+     * Send a message to the server
+     */
+    send(message: ClientMessage): void;
+    /**
+     * Get current connection state
+     */
+    getState(): ConnectionState;
+    /**
+     * Get session ID
+     */
+    getSessionId(): string | null;
+    /**
+     * Check if connected
+     */
+    isConnected(): boolean;
+    /**
+     * Subscribe to an event
+     */
+    on<K extends keyof WebSocketEvents>(event: K, callback: EventCallback<WebSocketEvents[K]>): () => void;
+    /**
+     * Emit an event to all listeners
+     */
+    private emit;
+    private createWebSocket;
+    private handleOpen;
+    private handleMessage;
+    private handleClose;
+    private handleError;
+    private handleConnected;
+    private handleAuthSuccess;
+    private handleAuthError;
+    private scheduleTokenRefresh;
+    private refreshAccessToken;
+    private handleTokenRefreshed;
+    private startHeartbeat;
+    private stopHeartbeat;
+    private handlePong;
+    private scheduleReconnect;
+    private handleConnectionFailure;
+    private flushMessageQueue;
+    private setState;
+    private cleanup;
+    private log;
+}
+declare function createWebSocketClient(config: WebSocketClientConfig): WebSocketClient;
+
+/**
+ * Navigation Adapter Interface
+ *
+ * Abstract interface for routing library integration.
+ * Companies can implement this for any routing solution:
+ * - React Router v6
+ * - Next.js Router
+ * - Reach Router
+ * - Custom routing
+ */
+
+/**
+ * Create a simple in-memory navigation adapter
+ * Useful for testing or non-SPA applications
+ */
+declare function createMemoryAdapter(initialPath?: string): NavigationAdapter;
+
+/**
+ * React Router v6 Adapter
+ *
+ * Provides navigation adapter implementation for React Router v6.
+ * This is a hook that creates an adapter from React Router hooks.
+ */
+
+/**
+ * Type for React Router's navigate function
+ */
+type NavigateFunction = (to: string) => void;
+/**
+ * Type for React Router's location object
+ */
+interface RouterLocation {
+    pathname: string;
+}
+/**
+ * Creates a React Router v6 navigation adapter
+ *
+ * @example
+ * ```tsx
+ * import { useNavigate, useLocation } from 'react-router-dom';
+ *
+ * function App() {
+ *   const navigate = useNavigate();
+ *   const location = useLocation();
+ *   const adapter = useReactRouterAdapter(navigate, location);
+ *
+ *   return (
+ *     <ChatbotProvider navigationAdapter={adapter}>
+ *       ...
+ *     </ChatbotProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function useReactRouterAdapter(navigate: NavigateFunction, location: RouterLocation): NavigationAdapter;
+/**
+ * Create a React Router adapter from outside React context
+ * Useful when you need to create the adapter before rendering
+ *
+ * @param getNavigate Function that returns the navigate function
+ * @param getLocation Function that returns the current location
+ */
+declare function createReactRouterAdapter(getNavigate: () => NavigateFunction, getLocation: () => RouterLocation, subscribeToLocation: (callback: (location: RouterLocation) => void) => () => void): NavigationAdapter;
+
+/**
+ * Navigation Controller
+ *
+ * Coordinates navigation and DOM stability detection for cross-route actions.
+ */
+
+interface NavigationControllerConfig {
+    /** DOM stability quiet period in ms */
+    domStabilityDelay?: number;
+    /** Maximum wait time for DOM stability */
+    domStabilityTimeout?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Called when DOM has become stable (e.g. to re-scan and update action registry) */
+    onDOMStable?: () => void;
+}
+declare class NavigationController {
+    private adapter;
+    private config;
+    private scanCallback;
+    private logger;
+    constructor(adapter: NavigationAdapter, config?: NavigationControllerConfig);
+    /**
+     * Set the page scanner callback
+     */
+    setScanner(scanner: () => Promise<PageContext>): void;
+    /**
+     * Get current route
+     */
+    getCurrentRoute(): string;
+    /**
+     * Navigate to a route and wait for it to load
+     */
+    navigateTo(route: string, timeout?: number): Promise<boolean>;
+    /**
+     * Execute navigation and rescan page context
+     */
+    executeNavigation(route: string): Promise<PageContext | null>;
+    /**
+     * Wait for DOM to become stable after navigation
+     * Uses MutationObserver to detect when DOM stops changing
+     */
+    waitForDOMStable(): Promise<void>;
+    /**
+     * Subscribe to route changes
+     */
+    onRouteChange(callback: (route: string) => void): () => void;
+    private log;
+}
+/**
+ * Create a navigation controller
+ */
+declare function createNavigationController(adapter: NavigationAdapter, config?: NavigationControllerConfig): NavigationController;
+
+/** Next.js App Router: router from useRouter(), pathname from usePathname() */
+type NextRouterLike = {
+    push: (href: string) => void;
+};
+/**
+ * Creates a Next.js App Router navigation adapter.
+ * Must be used in a Client Component. Requires next to be installed.
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { useRouter, usePathname } from 'next/navigation';
+ * import { ChatbotProvider, ChatbotWidget, useNextRouterAdapter } from '@navsi/sdk';
+ *
+ * function ChatbotWrapper({ children }: { children: React.ReactNode }) {
+ *   const router = useRouter();
+ *   const pathname = usePathname();
+ *   const adapter = useNextRouterAdapter(router, pathname);
+ *   return (
+ *     <ChatbotProvider apiKey="..." serverUrl="..." navigationAdapter={adapter}>
+ *       {children}
+ *       <ChatbotWidget />
+ *     </ChatbotProvider>
+ *   );
+ * }
+ * ```
+ */
+declare function useNextRouterAdapter(router: NextRouterLike, pathname: string): NavigationAdapter;
+
+export { ChatbotContext, type ChatbotContextValue, type ConnectionState, type NavigateFunction, NavigationController, type NavigationControllerConfig, type NextRouterLike, type RouterLocation, WebSocketClient, type WebSocketClientConfig, createMemoryAdapter, createNavigationController, createReactRouterAdapter, createWebSocketClient, useChatbotContext, useNextRouterAdapter, useReactRouterAdapter };

package/dist/index.js

@@ -0,0 +1,182 @@
+import { DEFAULT_ROUTE_TIMEOUT } from './chunk-EHZXIZIP.js';
+export { ChatbotProvider, ChatbotWidget, NavigationController, WebSocketClient, createMemoryAdapter, createNavigationController, createWebSocketClient } from './chunk-EHZXIZIP.js';
+import './chunk-427NHGTX.js';
+export { ChatbotContext, useActionExecution, useChatbot, useChatbotContext, useWebSocket } from './chunk-6FUUG5WB.js';
+import { useRef, useEffect, useCallback } from 'react';
+
+function useReactRouterAdapter(navigate, location) {
+  const listenersRef = useRef(/* @__PURE__ */ new Set());
+  const currentPathRef = useRef(location.pathname);
+  useEffect(() => {
+    if (location.pathname !== currentPathRef.current) {
+      currentPathRef.current = location.pathname;
+      listenersRef.current.forEach((callback) => {
+        callback(location.pathname);
+      });
+    }
+  }, [location.pathname]);
+  const navigateTo = useCallback((path) => {
+    navigate(path);
+  }, [navigate]);
+  const getCurrentPath = useCallback(() => {
+    return currentPathRef.current;
+  }, []);
+  const onRouteChange = useCallback((callback) => {
+    listenersRef.current.add(callback);
+    return () => {
+      listenersRef.current.delete(callback);
+    };
+  }, []);
+  const waitForRoute = useCallback(async (path, timeout = DEFAULT_ROUTE_TIMEOUT) => {
+    return new Promise((resolve) => {
+      if (currentPathRef.current === path) {
+        resolve(true);
+        return;
+      }
+      let resolved = false;
+      const unsubscribe = onRouteChange((newPath) => {
+        if (newPath === path && !resolved) {
+          resolved = true;
+          unsubscribe();
+          resolve(true);
+        }
+      });
+      setTimeout(() => {
+        if (!resolved) {
+          resolved = true;
+          unsubscribe();
+          resolve(currentPathRef.current === path);
+        }
+      }, timeout);
+    });
+  }, [onRouteChange]);
+  const adapterRef = useRef(null);
+  if (!adapterRef.current) {
+    adapterRef.current = {
+      navigate: navigateTo,
+      getCurrentPath,
+      onRouteChange,
+      waitForRoute
+    };
+  } else {
+    adapterRef.current.navigate = navigateTo;
+    adapterRef.current.getCurrentPath = getCurrentPath;
+    adapterRef.current.onRouteChange = onRouteChange;
+    adapterRef.current.waitForRoute = waitForRoute;
+  }
+  return adapterRef.current;
+}
+function createReactRouterAdapter(getNavigate, getLocation, subscribeToLocation) {
+  const listeners = /* @__PURE__ */ new Set();
+  subscribeToLocation((location) => {
+    listeners.forEach((callback) => callback(location.pathname));
+  });
+  return {
+    navigate(path) {
+      getNavigate()(path);
+    },
+    getCurrentPath() {
+      return getLocation().pathname;
+    },
+    onRouteChange(callback) {
+      listeners.add(callback);
+      return () => listeners.delete(callback);
+    },
+    async waitForRoute(path, timeout = DEFAULT_ROUTE_TIMEOUT) {
+      return new Promise((resolve) => {
+        const currentPath = getLocation().pathname;
+        if (currentPath === path) {
+          resolve(true);
+          return;
+        }
+        let resolved = false;
+        const unsubscribe = this.onRouteChange((newPath) => {
+          if (newPath === path && !resolved) {
+            resolved = true;
+            unsubscribe();
+            resolve(true);
+          }
+        });
+        setTimeout(() => {
+          if (!resolved) {
+            resolved = true;
+            unsubscribe();
+            resolve(getLocation().pathname === path);
+          }
+        }, timeout);
+      });
+    }
+  };
+}
+function useNextRouterAdapter(router, pathname) {
+  const listenersRef = useRef(/* @__PURE__ */ new Set());
+  const currentPathRef = useRef(pathname);
+  useEffect(() => {
+    if (pathname !== currentPathRef.current) {
+      currentPathRef.current = pathname;
+      listenersRef.current.forEach((callback) => {
+        callback(pathname);
+      });
+    }
+  }, [pathname]);
+  const navigateTo = useCallback(
+    (path) => {
+      router.push(path);
+    },
+    [router]
+  );
+  const getCurrentPath = useCallback(() => {
+    return currentPathRef.current;
+  }, []);
+  const onRouteChange = useCallback((callback) => {
+    listenersRef.current.add(callback);
+    return () => {
+      listenersRef.current.delete(callback);
+    };
+  }, []);
+  const waitForRoute = useCallback(
+    async (path, timeout = DEFAULT_ROUTE_TIMEOUT) => {
+      return new Promise((resolve) => {
+        if (currentPathRef.current === path) {
+          resolve(true);
+          return;
+        }
+        let resolved = false;
+        const unsubscribe = onRouteChange((newPath) => {
+          if (newPath === path && !resolved) {
+            resolved = true;
+            unsubscribe();
+            resolve(true);
+          }
+        });
+        setTimeout(() => {
+          if (!resolved) {
+            resolved = true;
+            unsubscribe();
+            resolve(currentPathRef.current === path);
+          }
+        }, timeout);
+      });
+    },
+    [onRouteChange]
+  );
+  const adapterRef = useRef(null);
+  if (!adapterRef.current) {
+    adapterRef.current = {
+      navigate: navigateTo,
+      getCurrentPath,
+      onRouteChange,
+      waitForRoute
+    };
+  } else {
+    adapterRef.current.navigate = navigateTo;
+    adapterRef.current.getCurrentPath = getCurrentPath;
+    adapterRef.current.onRouteChange = onRouteChange;
+    adapterRef.current.waitForRoute = waitForRoute;
+  }
+  return adapterRef.current;
+}
+
+export { createReactRouterAdapter, useNextRouterAdapter, useReactRouterAdapter };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/navigation/react-router-adapter.ts","../src/core/navigation/nextjs-adapter.ts"],"names":["useRef","useEffect","useCallback"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * React Router v6 Adapter\n * \n * Provides navigation adapter implementation for React Router v6.\n * This is a hook that creates an adapter from React Router hooks.\n */\n\nimport { useCallback, useEffect, useRef } from 'react';\nimport type { NavigationAdapter } from '@navsi.ai/shared';\nimport { DEFAULT_ROUTE_TIMEOUT } from './adapter.js';\n\n/**\n * Type for React Router's navigate function\n */\nexport type NavigateFunction = (to: string) => void;\n\n/**\n * Type for React Router's location object\n */\nexport interface RouterLocation {\n    pathname: string;\n}\n\n/**\n * Creates a React Router v6 navigation adapter\n * \n * @example\n * ```tsx\n * import { useNavigate, useLocation } from 'react-router-dom';\n * \n * function App() {\n *   const navigate = useNavigate();\n *   const location = useLocation();\n *   const adapter = useReactRouterAdapter(navigate, location);\n *   \n *   return (\n *     <ChatbotProvider navigationAdapter={adapter}>\n *       ...\n *     </ChatbotProvider>\n *   );\n * }\n * ```\n */\nexport function useReactRouterAdapter(\n    navigate: NavigateFunction,\n    location: RouterLocation\n): NavigationAdapter {\n    const listenersRef = useRef<Set<(path: string) => void>>(new Set());\n    const currentPathRef = useRef(location.pathname);\n\n    // Update current path and notify listeners when location changes\n    useEffect(() => {\n        if (location.pathname !== currentPathRef.current) {\n            currentPathRef.current = location.pathname;\n            listenersRef.current.forEach((callback) => {\n                callback(location.pathname);\n            });\n        }\n    }, [location.pathname]);\n\n    const navigateTo = useCallback((path: string) => {\n        navigate(path);\n    }, [navigate]);\n\n    const getCurrentPath = useCallback(() => {\n        return currentPathRef.current;\n    }, []);\n\n    const onRouteChange = useCallback((callback: (path: string) => void) => {\n        listenersRef.current.add(callback);\n        return () => {\n            listenersRef.current.delete(callback);\n        };\n    }, []);\n\n    const waitForRoute = useCallback(async (path: string, timeout = DEFAULT_ROUTE_TIMEOUT): Promise<boolean> => {\n        return new Promise((resolve) => {\n            if (currentPathRef.current === path) {\n                resolve(true);\n                return;\n            }\n\n            let resolved = false;\n\n            const unsubscribe = onRouteChange((newPath) => {\n                if (newPath === path && !resolved) {\n                    resolved = true;\n                    unsubscribe();\n                    resolve(true);\n                }\n            });\n\n            setTimeout(() => {\n                if (!resolved) {\n                    resolved = true;\n                    unsubscribe();\n                    resolve(currentPathRef.current === path);\n                }\n            }, timeout);\n        });\n    }, [onRouteChange]);\n\n    // Return a stable reference to the adapter\n    const adapterRef = useRef<NavigationAdapter | null>(null);\n\n    if (!adapterRef.current) {\n        adapterRef.current = {\n            navigate: navigateTo,\n            getCurrentPath,\n            onRouteChange,\n            waitForRoute,\n        };\n    } else {\n        // Update functions to use latest refs\n        adapterRef.current.navigate = navigateTo;\n        adapterRef.current.getCurrentPath = getCurrentPath;\n        adapterRef.current.onRouteChange = onRouteChange;\n        adapterRef.current.waitForRoute = waitForRoute;\n    }\n\n    return adapterRef.current;\n}\n\n/**\n * Create a React Router adapter from outside React context\n * Useful when you need to create the adapter before rendering\n * \n * @param getNavigate Function that returns the navigate function\n * @param getLocation Function that returns the current location\n */\nexport function createReactRouterAdapter(\n    getNavigate: () => NavigateFunction,\n    getLocation: () => RouterLocation,\n    subscribeToLocation: (callback: (location: RouterLocation) => void) => () => void\n): NavigationAdapter {\n    const listeners = new Set<(path: string) => void>();\n\n    // Subscribe to location changes\n    subscribeToLocation((location) => {\n        listeners.forEach((callback) => callback(location.pathname));\n    });\n\n    return {\n        navigate(path: string): void {\n            getNavigate()(path);\n        },\n\n        getCurrentPath(): string {\n            return getLocation().pathname;\n        },\n\n        onRouteChange(callback: (path: string) => void): () => void {\n            listeners.add(callback);\n            return () => listeners.delete(callback);\n        },\n\n        async waitForRoute(path: string, timeout = DEFAULT_ROUTE_TIMEOUT): Promise<boolean> {\n            return new Promise((resolve) => {\n                const currentPath = getLocation().pathname;\n\n                if (currentPath === path) {\n                    resolve(true);\n                    return;\n                }\n\n                let resolved = false;\n\n                const unsubscribe = this.onRouteChange((newPath) => {\n                    if (newPath === path && !resolved) {\n                        resolved = true;\n                        unsubscribe();\n                        resolve(true);\n                    }\n                });\n\n                setTimeout(() => {\n                    if (!resolved) {\n                        resolved = true;\n                        unsubscribe();\n                        resolve(getLocation().pathname === path);\n                    }\n                }, timeout);\n            });\n        },\n    };\n}\n","'use client';\n/**\n * Next.js App Router Adapter\n *\n * Provides navigation adapter implementation for Next.js App Router.\n * Uses next/navigation: useRouter(), usePathname().\n */\n\nimport { useCallback, useEffect, useRef } from 'react';\nimport type { NavigationAdapter } from '@navsi.ai/shared';\nimport { DEFAULT_ROUTE_TIMEOUT } from './adapter.js';\n\n/** Next.js App Router: router from useRouter(), pathname from usePathname() */\nexport type NextRouterLike = { push: (href: string) => void };\n\n/**\n * Creates a Next.js App Router navigation adapter.\n * Must be used in a Client Component. Requires next to be installed.\n *\n * @example\n * ```tsx\n * 'use client';\n * import { useRouter, usePathname } from 'next/navigation';\n * import { ChatbotProvider, ChatbotWidget, useNextRouterAdapter } from '@navsi/sdk';\n *\n * function ChatbotWrapper({ children }: { children: React.ReactNode }) {\n *   const router = useRouter();\n *   const pathname = usePathname();\n *   const adapter = useNextRouterAdapter(router, pathname);\n *   return (\n *     <ChatbotProvider apiKey=\"...\" serverUrl=\"...\" navigationAdapter={adapter}>\n *       {children}\n *       <ChatbotWidget />\n *     </ChatbotProvider>\n *   );\n * }\n * ```\n */\nexport function useNextRouterAdapter(\n    router: NextRouterLike,\n    pathname: string\n): NavigationAdapter {\n    const listenersRef = useRef<Set<(path: string) => void>>(new Set());\n    const currentPathRef = useRef(pathname);\n\n    useEffect(() => {\n        if (pathname !== currentPathRef.current) {\n            currentPathRef.current = pathname;\n            listenersRef.current.forEach((callback) => {\n                callback(pathname);\n            });\n        }\n    }, [pathname]);\n\n    const navigateTo = useCallback(\n        (path: string) => {\n            router.push(path);\n        },\n        [router]\n    );\n\n    const getCurrentPath = useCallback(() => {\n        return currentPathRef.current;\n    }, []);\n\n    const onRouteChange = useCallback((callback: (path: string) => void) => {\n        listenersRef.current.add(callback);\n        return () => {\n            listenersRef.current.delete(callback);\n        };\n    }, []);\n\n    const waitForRoute = useCallback(\n        async (path: string, timeout = DEFAULT_ROUTE_TIMEOUT): Promise<boolean> => {\n            return new Promise((resolve) => {\n                if (currentPathRef.current === path) {\n                    resolve(true);\n                    return;\n                }\n\n                let resolved = false;\n\n                const unsubscribe = onRouteChange((newPath) => {\n                    if (newPath === path && !resolved) {\n                        resolved = true;\n                        unsubscribe();\n                        resolve(true);\n                    }\n                });\n\n                setTimeout(() => {\n                    if (!resolved) {\n                        resolved = true;\n                        unsubscribe();\n                        resolve(currentPathRef.current === path);\n                    }\n                }, timeout);\n            });\n        },\n        [onRouteChange]\n    );\n\n    const adapterRef = useRef<NavigationAdapter | null>(null);\n\n    if (!adapterRef.current) {\n        adapterRef.current = {\n            navigate: navigateTo,\n            getCurrentPath,\n            onRouteChange,\n            waitForRoute,\n        };\n    } else {\n        adapterRef.current.navigate = navigateTo;\n        adapterRef.current.getCurrentPath = getCurrentPath;\n        adapterRef.current.onRouteChange = onRouteChange;\n        adapterRef.current.waitForRoute = waitForRoute;\n    }\n\n    return adapterRef.current;\n}\n"]}