@navsi.ai/shared 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @navsi/shared
+ *
+ * Shared types and protocol definitions for the AI Chatbot SDK Platform
+ */
+export * from './types.js';
+export * from './protocol.js';
+export * from './logger.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,cAAc,YAAY,CAAC;AAG3B,cAAc,eAAe,CAAC;AAG9B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @navsi/shared
+ *
+ * Shared types and protocol definitions for the AI Chatbot SDK Platform
+ */
+// Export all types
+export * from './types.js';
+// Export all protocol definitions
+export * from './protocol.js';
+// Export logging utilities
+export * from './logger.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,mBAAmB;AACnB,cAAc,YAAY,CAAC;AAE3B,kCAAkC;AAClC,cAAc,eAAe,CAAC;AAE9B,2BAA2B;AAC3B,cAAc,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Simple logger with scoped prefixes and configurable levels.
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LoggerOptions {
+    /** Enable debug/info logging */
+    enabled?: boolean;
+    /** Minimum level to log when enabled */
+    level?: LogLevel;
+    /** Optional scope name shown in the prefix */
+    scope?: string;
+}
+export declare function createLogger(scope: string, options?: LoggerOptions): {
+    debug: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+    child: (childScope: string, childOptions?: LoggerOptions) => /*elided*/ any;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC1B,gCAAgC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAoDD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB;qBAgB9C,OAAO,EAAE;oBACV,OAAO,EAAE;oBACT,OAAO,EAAE;qBACR,OAAO,EAAE;wBACN,MAAM,iBAAiB,aAAa;EAG/D"}

package/dist/logger.js

@@ -0,0 +1,74 @@
+/**
+ * Simple logger with scoped prefixes and configurable levels.
+ */
+const LEVEL_PRIORITY = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+};
+function normalizeLevel(value) {
+    if (!value)
+        return null;
+    const lower = value.toLowerCase();
+    if (lower === 'debug' || lower === 'info' || lower === 'warn' || lower === 'error') {
+        return lower;
+    }
+    return null;
+}
+function readGlobalLevel() {
+    const globalAny = globalThis;
+    const fromGlobal = normalizeLevel(globalAny.NAVSI_LOG_LEVEL);
+    if (fromGlobal)
+        return fromGlobal;
+    const env = globalThis.process?.env;
+    return normalizeLevel(env?.NAVSI_LOG_LEVEL);
+}
+function readGlobalDebug() {
+    const globalAny = globalThis;
+    if (typeof globalAny.NAVSI_DEBUG === 'boolean')
+        return globalAny.NAVSI_DEBUG;
+    if (typeof globalAny.NAVSI_DEBUG === 'string') {
+        return ['1', 'true', 'yes', 'on'].includes(globalAny.NAVSI_DEBUG.toLowerCase());
+    }
+    const env = globalThis.process?.env;
+    const raw = env?.NAVSI_DEBUG;
+    if (!raw)
+        return null;
+    return ['1', 'true', 'yes', 'on'].includes(raw.toLowerCase());
+}
+function shouldLog(level, enabled, minLevel) {
+    if (!enabled)
+        return false;
+    return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[minLevel];
+}
+function getConsoleMethod(level) {
+    if (level === 'debug')
+        return console.debug ? console.debug.bind(console) : console.log.bind(console);
+    if (level === 'info')
+        return console.info ? console.info.bind(console) : console.log.bind(console);
+    if (level === 'warn')
+        return console.warn.bind(console);
+    return console.error.bind(console);
+}
+export function createLogger(scope, options = {}) {
+    const globalLevel = readGlobalLevel();
+    const globalDebug = readGlobalDebug();
+    const enabled = options.enabled ?? (globalLevel ? true : (globalDebug ?? false));
+    const level = options.level ?? globalLevel ?? (globalDebug ? 'debug' : 'info');
+    const prefix = scope ? `[Navsi ${scope}]` : '[Navsi]';
+    const logAt = (lvl, args) => {
+        if (!shouldLog(lvl, enabled, level))
+            return;
+        const consoleFn = getConsoleMethod(lvl);
+        consoleFn(prefix, new Date().toISOString(), ...args);
+    };
+    return {
+        debug: (...args) => logAt('debug', args),
+        info: (...args) => logAt('info', args),
+        warn: (...args) => logAt('warn', args),
+        error: (...args) => logAt('error', args),
+        child: (childScope, childOptions) => createLogger(`${scope}.${childScope}`, { ...options, ...childOptions }),
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/protocol.d.ts

@@ -0,0 +1,277 @@
+/**
+ * WebSocket Message Protocol for AI Chatbot SDK
+ *
+ * This file defines all message types exchanged between the SDK client
+ * and the backend server over WebSocket connections.
+ */
+import type { PageContext, Command, ServerActionResult, ChatMode } from './types.js';
+/**
+ * User sends a chat message
+ */
+export interface ClientMessageMessage {
+    type: 'message';
+    /** The user's message content */
+    content: string;
+    /** Current page context */
+    context: PageContext;
+    /** Current chat mode */
+    mode: ChatMode;
+    /** Message ID for correlation */
+    messageId: string;
+    /** Optional BCP-47 locale for response language (e.g. 'hi-IN', 'en-US') */
+    locale?: string;
+}
+/**
+ * Context update (e.g., after navigation)
+ */
+export interface ClientContextMessage {
+    type: 'context';
+    /** Updated page context */
+    context: PageContext;
+}
+/**
+ * Result of action execution
+ */
+export interface ClientActionResultMessage {
+    type: 'action_result';
+    /** ID of the action that was executed */
+    actionId: string;
+    /** Whether the action succeeded */
+    success: boolean;
+    /** Result data if successful */
+    result?: unknown;
+    /** Error message if failed */
+    error?: string;
+    /** ID of the command that triggered this action */
+    commandId?: string;
+}
+/**
+ * Request to execute a server action (webhook mode)
+ */
+export interface ClientServerActionRequestMessage {
+    type: 'server_action_request';
+    /** ID of the server action to execute */
+    actionId: string;
+    /** Parameters for the action */
+    params: Record<string, unknown>;
+    /** Request ID for correlation */
+    requestId: string;
+}
+/**
+ * Ping message for heartbeat
+ */
+export interface ClientPingMessage {
+    type: 'ping';
+    timestamp: number;
+}
+/**
+ * Authentication message
+ */
+export interface ClientAuthMessage {
+    type: 'auth';
+    /** API key */
+    apiKey: string;
+    /** Session ID (optional, for reconnection) */
+    sessionId?: string;
+}
+/**
+ * Token refresh request
+ */
+export interface ClientTokenRefreshMessage {
+    type: 'token_refresh';
+    /** Refresh token */
+    refreshToken: string;
+}
+/**
+ * Union of all client-to-server message types
+ */
+export type ClientMessage = ClientMessageMessage | ClientContextMessage | ClientActionResultMessage | ClientServerActionRequestMessage | ClientPingMessage | ClientAuthMessage | ClientTokenRefreshMessage;
+/**
+ * AI text response
+ */
+export interface ServerResponseMessage {
+    type: 'response';
+    /** The AI's response message */
+    message: string;
+    /** Message ID */
+    messageId: string;
+    /** Whether this is a final response or streaming chunk */
+    isFinal?: boolean;
+}
+/**
+ * Commands to execute (Navigate mode)
+ */
+export interface ServerCommandMessage {
+    type: 'command';
+    /** List of commands to execute sequentially */
+    commands: Command[];
+    /** Accompanying message to display */
+    message?: string;
+    /** Command batch ID for correlation */
+    batchId: string;
+}
+/**
+ * Typing indicator
+ */
+export interface ServerTypingMessage {
+    type: 'typing';
+    /** Whether the AI is typing */
+    isTyping: boolean;
+}
+/**
+ * Result of server action execution
+ */
+export interface ServerActionResultMessage {
+    type: 'server_action_result';
+    /** ID of the action that was executed */
+    actionId: string;
+    /** Request ID for correlation */
+    requestId: string;
+    /** Execution result */
+    result: ServerActionResult;
+}
+/**
+ * Pong response to ping
+ */
+export interface ServerPongMessage {
+    type: 'pong';
+    timestamp: number;
+}
+/**
+ * Authentication success
+ */
+export interface ServerAuthSuccessMessage {
+    type: 'auth_success';
+    /** Session ID */
+    sessionId: string;
+    /** Access token */
+    accessToken: string;
+    /** Refresh token */
+    refreshToken: string;
+    /** Token expiry timestamp */
+    expiresAt: number;
+}
+/**
+ * Authentication failure
+ */
+export interface ServerAuthErrorMessage {
+    type: 'auth_error';
+    /** Error message */
+    error: string;
+    /** Error code */
+    code: string;
+}
+/**
+ * Token refreshed
+ */
+export interface ServerTokenRefreshedMessage {
+    type: 'token_refreshed';
+    /** New access token */
+    accessToken: string;
+    /** New refresh token */
+    refreshToken: string;
+    /** New expiry timestamp */
+    expiresAt: number;
+}
+/**
+ * Error message
+ */
+export interface ServerErrorMessage {
+    type: 'error';
+    /** Error message */
+    error: string;
+    /** Error code */
+    code: string;
+    /** Related message ID if applicable */
+    messageId?: string;
+    /** Additional details */
+    details?: Record<string, unknown>;
+}
+/**
+ * Request context update (after navigation)
+ */
+export interface ServerRequestContextMessage {
+    type: 'request_context';
+    /** Reason for the request */
+    reason: 'navigation_complete' | 'action_complete' | 'refresh';
+}
+/**
+ * Connection established
+ */
+export interface ServerConnectedMessage {
+    type: 'connected';
+    /** Server version */
+    version: string;
+    /** Connection timestamp */
+    timestamp: number;
+}
+/**
+ * Union of all server-to-client message types
+ */
+export type ServerMessage = ServerResponseMessage | ServerCommandMessage | ServerTypingMessage | ServerActionResultMessage | ServerPongMessage | ServerAuthSuccessMessage | ServerAuthErrorMessage | ServerTokenRefreshedMessage | ServerErrorMessage | ServerRequestContextMessage | ServerConnectedMessage;
+/**
+ * Events emitted by the WebSocket client
+ */
+export interface WebSocketEvents {
+    /** Connection established */
+    connected: {
+        sessionId: string;
+    };
+    /** Connection closed */
+    disconnected: {
+        reason: string;
+        code: number;
+    };
+    /** Reconnection attempt */
+    reconnecting: {
+        attempt: number;
+        maxAttempts: number;
+    };
+    /** Reconnection failed */
+    reconnect_failed: {
+        reason: string;
+    };
+    /** Message received */
+    message: ServerMessage;
+    /** Error occurred */
+    error: {
+        error: Error;
+        code?: string;
+    };
+    /** Authentication success */
+    authenticated: {
+        sessionId: string;
+        expiresAt: number;
+    };
+    /** Token refreshed */
+    token_refreshed: {
+        expiresAt: number;
+    };
+}
+/**
+ * Extract message type from union
+ */
+export type ExtractMessageType<T, K> = T extends {
+    type: K;
+} ? T : never;
+/**
+ * Get client message by type
+ */
+export type ClientMessageByType<T extends ClientMessage['type']> = ExtractMessageType<ClientMessage, T>;
+/**
+ * Get server message by type
+ */
+export type ServerMessageByType<T extends ServerMessage['type']> = ExtractMessageType<ServerMessage, T>;
+/**
+ * Create a unique message ID
+ */
+export declare function createMessageId(): string;
+/**
+ * Create a unique request ID
+ */
+export declare function createRequestId(): string;
+/**
+ * Create a unique batch ID
+ */
+export declare function createBatchId(): string;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/protocol.d.ts.map

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

package/dist/protocol.js

@@ -0,0 +1,28 @@
+/**
+ * WebSocket Message Protocol for AI Chatbot SDK
+ *
+ * This file defines all message types exchanged between the SDK client
+ * and the backend server over WebSocket connections.
+ */
+// ============================================================================
+// Message Creators (Utility functions)
+// ============================================================================
+/**
+ * Create a unique message ID
+ */
+export function createMessageId() {
+    return `msg_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+/**
+ * Create a unique request ID
+ */
+export function createRequestId() {
+    return `req_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+/**
+ * Create a unique batch ID
+ */
+export function createBatchId() {
+    return `batch_${Date.now()}_${Math.random().toString(36).substring(2, 9)}`;
+}
+//# sourceMappingURL=protocol.js.map

package/dist/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../src/protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAgTH,+EAA+E;AAC/E,uCAAuC;AACvC,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,eAAe;IAC3B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe;IAC3B,OAAO,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IACzB,OAAO,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AAC/E,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,442 @@
+/**
+ * Core type definitions for the AI Chatbot SDK Platform
+ */
+/**
+ * Definition of a parameter for actions and server actions
+ */
+export interface ParameterDefinition {
+    /** Unique name of the parameter */
+    name: string;
+    /** Type of the parameter value */
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    /** Whether the parameter is required */
+    required: boolean;
+    /** Human-readable description */
+    description?: string;
+    /** Default value if not provided */
+    defaultValue?: unknown;
+    /** Enum of allowed values */
+    enumValues?: string[];
+}
+/**
+ * Types of DOM interactions the chatbot can perform
+ */
+export type ActionType = 'click' | 'type' | 'select' | 'scroll' | 'focus' | 'hover';
+/**
+ * Definition of a client-side DOM action
+ */
+export interface ActionDefinition {
+    /** Unique identifier for the action */
+    id: string;
+    /** Type of DOM interaction */
+    type: ActionType;
+    /** CSS selector to find the target element */
+    selector: string;
+    /** Human-readable label for the action */
+    label: string;
+    /** Route where this action is available */
+    route: string;
+    /** Optional parameters for the action (e.g., text to type) */
+    parameters?: ParameterDefinition[];
+    /** Priority for action matching (higher = preferred) */
+    priority?: number;
+    /** Whether this was auto-discovered or manually defined */
+    isAutoDiscovered?: boolean;
+    /** Additional metadata from data attributes */
+    metadata?: Record<string, string>;
+}
+/**
+ * Context provided to server action handlers
+ */
+export interface ServerActionContext {
+    /** Current session ID */
+    sessionId: string;
+    /** User ID if authenticated */
+    userId?: string;
+    /** Authentication token */
+    authToken?: string;
+    /** Current route */
+    currentRoute: string;
+    /** Additional custom context */
+    custom?: Record<string, unknown>;
+}
+/**
+ * Result returned from server action execution
+ */
+export interface ServerActionResult {
+    /** Whether the action succeeded */
+    success: boolean;
+    /** Result data on success */
+    data?: unknown;
+    /** Error message on failure */
+    error?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Handler function type for server actions
+ */
+export type ServerActionHandler = (params: Record<string, unknown>, context: ServerActionContext) => Promise<ServerActionResult>;
+/**
+ * Definition of a server-side action
+ */
+export interface ServerAction {
+    /** Unique identifier for the action */
+    id: string;
+    /** Human-readable name */
+    name: string;
+    /** Description of what the action does (used for AI understanding) */
+    description: string;
+    /** Parameters the action accepts */
+    parameters: ParameterDefinition[];
+    /** Handler function (for handler mode - runs in browser) */
+    handler?: ServerActionHandler;
+    /** Webhook URL (for webhook mode - backend-to-backend) */
+    webhookUrl?: string;
+    /** Secret for HMAC signing (webhook mode) */
+    webhookSecret?: string;
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Whether this action requires confirmation before executing */
+    requiresConfirmation?: boolean;
+}
+/**
+ * Abstract interface for navigation adapters
+ * Allows the SDK to work with any routing library
+ */
+export interface NavigationAdapter {
+    /** Navigate to a path */
+    navigate(path: string): void;
+    /** Get the current path */
+    getCurrentPath(): string;
+    /** Subscribe to route changes, returns unsubscribe function */
+    onRouteChange(callback: (path: string) => void): () => void;
+    /** Wait for a specific route to become active */
+    waitForRoute(path: string, timeout?: number): Promise<boolean>;
+}
+/**
+ * Position options for the chat widget
+ */
+export type WidgetPosition = 'bottom-right' | 'bottom-left' | 'top-right' | 'top-left';
+/**
+ * Theme configuration for the widget
+ */
+export interface WidgetTheme {
+    /** Primary brand color */
+    primaryColor: string;
+    /** Secondary/accent color */
+    secondaryColor: string;
+    /** Widget position on screen */
+    position: WidgetPosition;
+    /** Background color */
+    backgroundColor?: string;
+    /** Text color */
+    textColor?: string;
+    /** Font family */
+    fontFamily?: string;
+    /** Border radius for rounded corners */
+    borderRadius?: number;
+    /** Enable dark mode */
+    darkMode?: boolean;
+}
+/**
+ * Full widget configuration
+ */
+export interface WidgetConfig {
+    /** Theme settings */
+    theme: WidgetTheme;
+    /** Welcome message shown when chat opens */
+    welcomeMessage?: string;
+    /** Placeholder text for input field */
+    inputPlaceholder?: string;
+    /** Show mode toggle (Ask/Navigate) */
+    showModeToggle?: boolean;
+    /** Default mode when chat opens */
+    defaultMode?: ChatMode;
+    /** Whether the widget is open by default */
+    defaultOpen?: boolean;
+    /** Enable keyboard shortcuts */
+    enableKeyboardShortcuts?: boolean;
+    /** Custom CSS classes */
+    customClassName?: string;
+    /** Avatar URL for the bot */
+    botAvatarUrl?: string;
+    /** Header title */
+    headerTitle?: string;
+    /** BCP-47 language for voice input/output and AI response (e.g. 'hi-IN' for Hindi) */
+    voiceLanguage?: string;
+    /** Subtitle / hint text shown below title or in empty state */
+    subtitle?: string;
+    /** Placeholder for Ask mode input */
+    askPlaceholder?: string;
+    /** Placeholder for Navigate mode input */
+    navigatePlaceholder?: string;
+    /** Supported voice languages shown in language picker */
+    supportedLanguages?: Array<{
+        code: string;
+        label: string;
+    }>;
+}
+/**
+ * Flat widget config (API/Prisma shape). Use normalizeWidgetConfig() to convert to WidgetConfig.
+ */
+export interface FlatWidgetConfig {
+    primaryColor?: string;
+    secondaryColor?: string;
+    position?: WidgetPosition;
+    backgroundColor?: string;
+    textColor?: string;
+    fontFamily?: string;
+    borderRadius?: number;
+    darkMode?: boolean;
+    welcomeMessage?: string;
+    inputPlaceholder?: string;
+    showModeToggle?: boolean;
+    defaultMode?: string;
+    headerTitle?: string;
+    botAvatarUrl?: string | null;
+    /** BCP-47 language for voice (e.g. 'hi-IN') */
+    voiceLanguage?: string;
+}
+/**
+ * Convert flat API config to WidgetConfig for the SDK.
+ */
+export declare function normalizeWidgetConfig(flat?: FlatWidgetConfig | null): WidgetConfig;
+/**
+ * Operating modes for the chatbot
+ */
+export type ChatMode = 'ask' | 'navigate';
+/**
+ * Context information about a form on the page
+ */
+export interface FormContext {
+    /** Form ID or selector */
+    id: string;
+    /** Form name attribute */
+    name?: string;
+    /** Form action URL */
+    action?: string;
+    /** HTTP method */
+    method?: string;
+    /** Input fields in the form */
+    fields: Array<{
+        name: string;
+        type: string;
+        label?: string;
+        placeholder?: string;
+        required?: boolean;
+        value?: string;
+    }>;
+}
+/**
+ * Content extracted from the current page
+ */
+export interface PageContent {
+    /** Heading elements text */
+    headings: string[];
+    /** Main content summary (truncated if too long) */
+    mainContent: string;
+    /** Forms on the page */
+    forms: FormContext[];
+    /** Meta description */
+    metaDescription?: string;
+}
+/**
+ * Complete context of the current page state
+ * Sent to the AI engine for understanding available actions
+ */
+export interface PageContext {
+    /** Current route/path */
+    route: string;
+    /** Page title */
+    title: string;
+    /** Available DOM actions */
+    actions: ActionDefinition[];
+    /** Available server actions */
+    serverActions: ServerAction[];
+    /** Page content */
+    content: PageContent;
+    /** Timestamp when context was captured */
+    timestamp: number;
+    /** Optional list of all available routes in the application */
+    routes?: string[];
+}
+/**
+ * Role of the message sender
+ */
+export type MessageRole = 'user' | 'assistant' | 'system';
+/**
+ * Status of a chat message
+ */
+export type MessageStatus = 'sending' | 'sent' | 'error';
+/**
+ * A single chat message
+ */
+export interface Message {
+    /** Unique message ID */
+    id: string;
+    /** Who sent the message */
+    role: MessageRole;
+    /** Message content */
+    content: string;
+    /** Timestamp */
+    timestamp: number;
+    /** Message status */
+    status?: MessageStatus;
+    /** Associated commands (for assistant messages in navigate mode) */
+    commands?: Command[];
+    /** Error if status is 'error' */
+    error?: string;
+}
+/**
+ * Types of commands the AI can generate
+ */
+export type CommandType = 'navigate' | 'wait_for_route' | 'wait_for_dom_stable' | 'scan_context' | 'click' | 'type' | 'select' | 'scroll' | 'server_action' | 'report_result';
+/**
+ * Base command interface
+ */
+export interface BaseCommand {
+    /** Command type */
+    type: CommandType;
+    /** Optional timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Navigate to a route
+ */
+export interface NavigateCommand extends BaseCommand {
+    type: 'navigate';
+    target: string;
+}
+/**
+ * Wait for a route to become active
+ */
+export interface WaitForRouteCommand extends BaseCommand {
+    type: 'wait_for_route';
+    target: string;
+}
+/**
+ * Wait for DOM to stabilize after navigation
+ */
+export interface WaitForDomStableCommand extends BaseCommand {
+    type: 'wait_for_dom_stable';
+}
+/**
+ * Rescan the page context
+ */
+export interface ScanContextCommand extends BaseCommand {
+    type: 'scan_context';
+}
+/**
+ * Click an element
+ */
+export interface ClickCommand extends BaseCommand {
+    type: 'click';
+    /** CSS selector; omit when using text to resolve */
+    selector?: string;
+    /** Alternative text to find element by */
+    text?: string;
+    /** Disambiguate when multiple elements share the same label (e.g. product name for "remove") */
+    context?: string;
+}
+/**
+ * Type text into an input
+ */
+export interface TypeCommand extends BaseCommand {
+    type: 'type';
+    /** CSS selector; omit when using text to resolve */
+    selector?: string;
+    value: string;
+    /** Clear existing content before typing */
+    clear?: boolean;
+    /** Label/placeholder to find the field when selector is ambiguous */
+    text?: string;
+}
+/**
+ * Select an option from a dropdown
+ */
+export interface SelectCommand extends BaseCommand {
+    type: 'select';
+    /** CSS selector; omit when using text to resolve */
+    selector?: string;
+    value: string;
+    /** Label/placeholder to find the field when selector is ambiguous */
+    text?: string;
+}
+/**
+ * Scroll to an element or position
+ */
+export interface ScrollCommand extends BaseCommand {
+    type: 'scroll';
+    selector?: string;
+    position?: {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * Execute a server action
+ */
+export interface ServerActionCommand extends BaseCommand {
+    type: 'server_action';
+    actionId: string;
+    params: Record<string, unknown>;
+}
+/**
+ * Report execution result
+ */
+export interface ReportResultCommand extends BaseCommand {
+    type: 'report_result';
+}
+/**
+ * Union type of all commands
+ */
+export type Command = NavigateCommand | WaitForRouteCommand | WaitForDomStableCommand | ScanContextCommand | ClickCommand | TypeCommand | SelectCommand | ScrollCommand | ServerActionCommand | ReportResultCommand;
+/**
+ * WebSocket connection states
+ */
+export type ConnectionState = 'disconnected' | 'connecting' | 'connected' | 'reconnecting' | 'failed';
+/**
+ * State of command execution
+ */
+export interface ExecutionState {
+    /** Whether execution is in progress */
+    isExecuting: boolean;
+    /** Current command being executed */
+    currentCommand?: Command;
+    /** Index in the command queue */
+    currentIndex: number;
+    /** Total commands in queue */
+    totalCommands: number;
+    /** Error if execution failed */
+    error?: string;
+    /**
+     * Optional human-readable description of what is currently happening.
+     * e.g. "Clicking \"Checkout\" button" or "Typing into email field".
+     */
+    description?: string;
+}
+/**
+ * Main SDK configuration
+ */
+export interface SDKConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** WebSocket server URL */
+    serverUrl: string;
+    /** Navigation adapter for routing */
+    navigationAdapter?: NavigationAdapter;
+    /** Server actions to register */
+    serverActions?: ServerAction[];
+    /** Widget configuration */
+    widget?: Partial<WidgetConfig>;
+    /** Enable debug mode */
+    debug?: boolean;
+    /** Auto-reconnect settings */
+    reconnect?: {
+        enabled: boolean;
+        maxAttempts: number;
+        delayMs: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,43 @@
+/**
+ * Core type definitions for the AI Chatbot SDK Platform
+ */
+/** Default theme when no config is provided */
+const DEFAULT_THEME = {
+    primaryColor: '#6366f1',
+    secondaryColor: '#8b5cf6',
+    position: 'bottom-right',
+    backgroundColor: '#ffffff',
+    textColor: '#1f2937',
+    fontFamily: 'Inter, system-ui, sans-serif',
+    borderRadius: 12,
+    darkMode: false,
+};
+/**
+ * Convert flat API config to WidgetConfig for the SDK.
+ */
+export function normalizeWidgetConfig(flat) {
+    if (!flat) {
+        return { theme: { ...DEFAULT_THEME } };
+    }
+    const mode = (flat.defaultMode === 'navigate' ? 'navigate' : 'ask');
+    return {
+        theme: {
+            primaryColor: flat.primaryColor ?? DEFAULT_THEME.primaryColor,
+            secondaryColor: flat.secondaryColor ?? DEFAULT_THEME.secondaryColor,
+            position: flat.position ?? DEFAULT_THEME.position,
+            backgroundColor: flat.backgroundColor ?? DEFAULT_THEME.backgroundColor,
+            textColor: flat.textColor ?? DEFAULT_THEME.textColor,
+            fontFamily: flat.fontFamily ?? DEFAULT_THEME.fontFamily,
+            borderRadius: flat.borderRadius ?? DEFAULT_THEME.borderRadius,
+            darkMode: flat.darkMode ?? DEFAULT_THEME.darkMode,
+        },
+        welcomeMessage: flat.welcomeMessage,
+        inputPlaceholder: flat.inputPlaceholder,
+        showModeToggle: flat.showModeToggle,
+        defaultMode: mode,
+        headerTitle: flat.headerTitle,
+        botAvatarUrl: flat.botAvatarUrl ?? undefined,
+        voiceLanguage: flat.voiceLanguage,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAuOH,+CAA+C;AAC/C,MAAM,aAAa,GAAgB;IAC/B,YAAY,EAAE,SAAS;IACvB,cAAc,EAAE,SAAS;IACzB,QAAQ,EAAE,cAAc;IACxB,eAAe,EAAE,SAAS;IAC1B,SAAS,EAAE,SAAS;IACpB,UAAU,EAAE,8BAA8B;IAC1C,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,KAAK;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAA8B;IAChE,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO,EAAE,KAAK,EAAE,EAAE,GAAG,aAAa,EAAE,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAa,CAAC;IAChF,OAAO;QACH,KAAK,EAAE;YACH,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,aAAa,CAAC,YAAY;YAC7D,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,aAAa,CAAC,cAAc;YACnE,QAAQ,EAAG,IAAI,CAAC,QAA2B,IAAI,aAAa,CAAC,QAAQ;YACrE,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,aAAa,CAAC,eAAe;YACtE,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,aAAa,CAAC,SAAS;YACpD,UAAU,EAAE,IAAI,CAAC,UAAU,IAAI,aAAa,CAAC,UAAU;YACvD,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,aAAa,CAAC,YAAY;YAC7D,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,aAAa,CAAC,QAAQ;SACpD;QACD,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,SAAS;QAC5C,aAAa,EAAE,IAAI,CAAC,aAAa;KACpC,CAAC;AACN,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@navsi.ai/shared",
+  "version": "1.0.0",
+  "description": "Shared types, protocols and utilities for Navsi AI chatbot platform",
+  "author": "Kushagra Tiwari",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Bolona-ai/bolona-integrated.git",
+    "directory": "packages/shared"
+  },
+  "keywords": [
+    "navsi",
+    "chatbot",
+    "ai",
+    "sdk",
+    "types",
+    "protocol"
+  ],
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js"
+    },
+    "./protocol": {
+      "types": "./dist/protocol.d.ts",
+      "import": "./dist/protocol.js"
+    }
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm build && node --test test/*.test.js"
+  },
+  "devDependencies": {
+    "@navsi/eslint-config": "1.0.0",
+    "typescript": "^5.3.0"
+  }
+}