@courseecho/ai-core-sdk 1.0.23 → 1.0.26

package/dist/communication-service.d.ts

@@ -24,6 +24,11 @@ export declare class AiCommunicationService {
      * Send query to backend API
      */
     sendQuery(request: AiQueryRequest): Promise<AiQueryResponse>;
+    /**
+     * Exchange an API key for a short-lived JWT via POST /api/auth/token.
+     * Returns the JWT string on success; throws ApiError on failure.
+     */
+    fetchToken(apiKey: string): Promise<string>;
     /**
      * Check backend health
      */

package/dist/communication-service.js

@@ -80,6 +80,32 @@ export class AiCommunicationService {
             throw new ApiError(`Failed to send query: ${String(error)}`, 500);
         }
     }
+    /**
+     * Exchange an API key for a short-lived JWT via POST /api/auth/token.
+     * Returns the JWT string on success; throws ApiError on failure.
+     */
+    async fetchToken(apiKey) {
+        try {
+            const response = await fetch(`${this.apiEndpoint}/api/auth/token`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ apiKey }),
+            });
+            const data = await safeJson(response);
+            if (!response.ok) {
+                throw new ApiError(data?.error || `Token exchange failed: HTTP ${response.status}`, response.status, data);
+            }
+            if (!data?.token) {
+                throw new ApiError('No token returned from auth endpoint', 500);
+            }
+            return data.token;
+        }
+        catch (error) {
+            if (error instanceof ApiError)
+                throw error;
+            throw new ApiError(`Failed to fetch token: ${String(error)}`, 500);
+        }
+    }
     /**
      * Check backend health
      */

package/dist/sdk.d.ts

@@ -21,6 +21,17 @@ export declare class AiWidgetSDK {
      * Initialize auto-suggestions based on page content
      */
     initializeAutoSuggestions(): Promise<void>;
+    /**
+     * Auto-authenticate: exchange apiKey for a JWT via POST /api/auth/token,
+     * set it on the communication service, then refresh suggestions.
+     * No-op if already authenticated or no apiKey is configured.
+     */
+    autoAuthenticate(): Promise<void>;
+    /**
+     * Re-generate suggestions for the current URL (call after SPA navigation).
+     * Clears stale suggestions and rescans the new page content.
+     */
+    refreshSuggestionsForCurrentUrl(): Promise<void>;
     /**
      * Validate configuration
      */
@@ -29,6 +40,8 @@ export declare class AiWidgetSDK {
      * Set JWT token for authentication
      */
     setJwtToken(token: string): void;
+    /** Get the currently stored JWT token (if any). */
+    getJwtToken(): string | undefined;
     /**
      * Send a query to the AI backend
      */

package/dist/sdk.js

@@ -66,6 +66,37 @@ export class AiWidgetSDK {
             }, scanInterval);
         }
     }
+    /**
+     * Auto-authenticate: exchange apiKey for a JWT via POST /api/auth/token,
+     * set it on the communication service, then refresh suggestions.
+     * No-op if already authenticated or no apiKey is configured.
+     */
+    async autoAuthenticate() {
+        if (this.communicationService.isAuthenticated())
+            return;
+        if (!this.config.apiKey)
+            return;
+        const jwt = await this.communicationService.fetchToken(this.config.apiKey);
+        this.communicationService.setJwtToken(jwt);
+        // Refresh suggestions now that auth is established
+        if (this.config.suggestionConfig?.autoGenerate !== false) {
+            this.suggestionManager.clearSuggestions();
+            await this.initializeAutoSuggestions();
+        }
+    }
+    /**
+     * Re-generate suggestions for the current URL (call after SPA navigation).
+     * Clears stale suggestions and rescans the new page content.
+     */
+    async refreshSuggestionsForCurrentUrl() {
+        this.suggestionManager.clearSuggestions();
+        // PageContentScanner caches by URL, so a new URL will be scanned fresh.
+        // Also clear the old-URL cache entry to free memory.
+        this.pageContentScanner.clearCache();
+        if (this.config.suggestionConfig?.autoGenerate !== false) {
+            await this.initializeAutoSuggestions();
+        }
+    }
     /**
      * Validate configuration
      */
@@ -80,6 +111,10 @@ export class AiWidgetSDK {
     setJwtToken(token) {
         this.communicationService.setJwtToken(token);
     }
+    /** Get the currently stored JWT token (if any). */
+    getJwtToken() {
+        return this.communicationService.getJwtToken();
+    }
     /**
      * Send a query to the AI backend
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@courseecho/ai-core-sdk",
-  "version": "1.0.23",
+  "version": "1.0.26",
   "description": "Framework-agnostic core AI chat SDK. Shared logic for all framework wrappers.",
   "license": "MIT",
   "author": "CourseEcho",