@sksharma72000/ai-chat-websdk 1.0.4 → 1.2.0

package/hooks/useChatMode.d.ts

@@ -9,6 +9,8 @@ interface UseChatModeProps {
     setIsPerformingClientAction: (v: boolean) => void;
     /** Async callback invoked on 401 — must return a fresh JWT string */
     onTokenExpired?: () => Promise<string>;
+    /** Called before sending the request body to the API. May modify and return the body. */
+    onBeforeMessageSend?: (body: any) => Promise<any> | any;
     /** Called after a successful token refresh so the parent can persist the new token */
     onTokenRefreshed?: (newToken: string) => void;
 }
@@ -18,5 +20,5 @@ interface UseChatModeReturn {
         optionIndex?: number;
     }) => Promise<AIResponseData>;
 }
-export declare function useChatMode({ apiUrl, jwtToken, sessionId, browserSession, setIsPerformingClientAction: _setIsPerformingClientAction, onTokenExpired, onTokenRefreshed, }: UseChatModeProps): UseChatModeReturn;
+export declare function useChatMode({ apiUrl, jwtToken, sessionId, browserSession, setIsPerformingClientAction: _setIsPerformingClientAction, onTokenExpired, onBeforeMessageSend, onTokenRefreshed, }: UseChatModeProps): UseChatModeReturn;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sksharma72000/ai-chat-websdk",
-  "version": "1.0.4",
+  "version": "1.2.0",
   "description": "@sksharma72000/ai-chat-websdk is an embeddable, fully themeable AI chat widget for web apps. Supports JWT authentication with auto-refresh, rich content rendering (tables, code blocks, markdown), theming via CSS custom properties, and framework-agnostic mounting.",
   "main": "./ai-chat-websdk.umd.js",
   "module": "./ai-chat-websdk.es.js",

package/types/config.d.ts

@@ -22,6 +22,13 @@ export interface SDKTheme {
 export interface SDKConfig {
     /** Base URL of the AI server, e.g. 'http://localhost:4001' */
     apiUrl: string;
+    /**
+     * Caller-supplied session identifier. When `initialize()` is called again
+     * with a different `chatID` the SDK creates a new `ai_sdk_correlation_id`
+     * so the conversation starts fresh. Repeated calls with the same `chatID`
+     * are no-ops (the existing session is preserved).
+     */
+    chatID?: string;
     /**
      * JWT token (full Authorization header value, e.g. 'Bearer eyJ…').
      * Sent as `Authorization` header on every API request.
@@ -60,6 +67,15 @@ export interface SDKConfig {
      * }
      */
     onTokenExpired?: () => Promise<string>;
+    /**
+     * Called immediately before the SDK sends the request body to the API.
+     * Receives the JS object that will be JSON-stringified. May modify and
+     * return the object (or a replacement). May be async.
+     *
+     * Example:
+     * onBeforeMessageSend: async (body) => { body.meta = { source: 'widget' }; return body }
+     */
+    onBeforeMessageSend?: (body: any) => Promise<any> | any;
     /**
      * When true the widget renders in embedded/panel mode:
      * - Chat opens immediately (no FAB step)

package/utils/correlationId.d.ts

@@ -9,12 +9,15 @@ export declare class CorrelationIdManager {
     private static readonly SESSIONS_KEY;
     /** Key for the permanent browser-level identifier (never changes, survives session resets). */
     private static readonly BROWSER_SESSION_KEY;
+    private static readonly CHAT_ID_KEY;
     /**
      * Returns the permanent browser session token.
      * Created once and stored in localStorage forever — sent as the `browser-session` header
      * on every API request so the backend can group all chat sessions for this browser.
      */
     static getBrowserSession(): string;
+    static getChatId(): string | null;
+    static setChatId(chatId: string): void;
     static getCorrelationId(): string;
     /** Save the current session into the persisted list with a display name. */
     static saveCurrentSession(name: string): void;