@retrivora-ai/rag-engine 2.2.4 → 2.2.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@retrivora-ai/rag-engine",
-  "version": "2.2.4",
+  "version": "2.2.6",
   "description": "Retrivora AI is a plug-and-play AI engine for RAG chat experiences — generic vector DB + LLM provider, embeddable or standalone.",
   "author": "Abhinav Alkuchi",
   "license": "UNLICENSED",
@@ -37,6 +37,8 @@
       "import": "./dist/index.mjs"
     },
     "./style.css": "./dist/index.css",
+    "./index.css": "./dist/index.css",
+    "./styles.css": "./dist/index.css",
     "./handlers": {
       "types": "./dist/handlers/index.d.ts",
       "require": "./dist/handlers/index.js",

package/src/components/ChatWidget.tsx

@@ -1,10 +1,9 @@
-'use client';
-
 import React, { useState } from 'react';
-import { MessageSquare, X } from 'lucide-react';
+import { MessageSquare, X, AlertTriangle } from 'lucide-react';
 import { ChatWindow } from './ChatWindow';
 import { useConfig } from './ConfigProvider';
 import { ChatWidgetProps } from '../types';
+import { SDK_VERSION } from '../version';
 
 const DEFAULT_DIMENSIONS = { width: 380, height: 600 };
 
@@ -54,6 +53,8 @@ export function ChatWidget({ position = 'bottom-right', onAddToCart, apiUrl, ret
   const [isResizing, setIsResizing] = useState(false);
   const [isMaximized, setIsMaximized] = useState(false);
   const [prevDimensions, setPrevDimensions] = useState(DEFAULT_DIMENSIONS);
+  const [widgetError, setWidgetError] = useState<string | null>(null);
+  const [isValidating, setIsValidating] = useState(false);
 
   if (ui.showWidget === false) return null;
 
@@ -67,9 +68,50 @@ export function ChatWidget({ position = 'bottom-right', onAddToCart, apiUrl, ret
       ? 'bottom-20 left-6'
       : 'bottom-20 right-6';
 
-  const handleOpen = () => {
-    setIsOpen(true);
-    setHasUnread(false);
+  const handleOpen = async () => {
+    setIsValidating(true);
+    try {
+      const base = retrivoraApiBase || '/api/retrivora';
+      const configUrl = `${base.replace(/\/$/, '')}/config?sdkVersion=${SDK_VERSION}`;
+      const res = await fetch(configUrl, {
+        method: 'GET',
+        cache: 'no-store',
+        headers: {
+          'Content-Type': 'application/json',
+          'x-sdk-version': SDK_VERSION,
+          ...(headers || {})
+        },
+      });
+
+      if (!res.ok) {
+        const data = await res.json().catch(() => ({}));
+        if (res.status === 426 || data.code === 'SDK_VERSION_OUTDATED') {
+          const msg = data.error || 'Your Retrivora SDK package version is outdated. Please update your package to the latest version to continue.';
+          setWidgetError(msg);
+          setIsOpen(false); // DO NOT OPEN CHAT WIDGET
+          return;
+        }
+        if (
+          res.status === 403 ||
+          res.status === 401 ||
+          (typeof data.error === 'string' && data.error.toLowerCase().includes('license'))
+        ) {
+          const msg = (typeof data.error === 'string' ? data.error : data.error?.message) || 'Your Retrivora license is no longer valid. Please contact your administrator or obtain a valid license key.';
+          setWidgetError(msg);
+          setIsOpen(false); // DO NOT OPEN CHAT WIDGET
+          return;
+        }
+      }
+
+      setWidgetError(null);
+      setIsOpen(true);
+      setHasUnread(false);
+    } catch {
+      // Fallback
+      setIsOpen(true);
+    } finally {
+      setIsValidating(false);
+    }
   };
 
   const handleResizeStart = (e: React.MouseEvent) => {
@@ -157,6 +199,33 @@ export function ChatWidget({ position = 'bottom-right', onAddToCart, apiUrl, ret
         />
       </div>
 
+      {/* ── Widget Error Toast/Pop-over (when opening is blocked) ── */}
+      {widgetError && !isOpen && (
+        <div
+          className={`fixed z-[9999] max-w-sm p-4 rounded-2xl shadow-2xl border border-rose-200 dark:border-rose-900/60 bg-white/95 dark:bg-[#0f0f1a]/95 backdrop-blur-xl transition-all duration-300 animate-in fade-in slide-in-from-bottom-3 ${
+            position === 'bottom-left' ? 'bottom-24 left-6' : 'bottom-24 right-6'
+          }`}
+        >
+          <div className="flex items-start gap-3">
+            <div className="w-8 h-8 rounded-xl bg-rose-100 dark:bg-rose-900/40 text-rose-600 dark:text-rose-400 flex items-center justify-center shrink-0 mt-0.5">
+              <AlertTriangle className="w-4 h-4" />
+            </div>
+            <div className="flex-1 space-y-1">
+              <h5 className="text-xs font-bold text-slate-900 dark:text-white">Access Blocked</h5>
+              <p className="text-[11px] text-slate-600 dark:text-slate-300 leading-relaxed font-medium">
+                {widgetError}
+              </p>
+            </div>
+            <button
+              onClick={() => setWidgetError(null)}
+              className="text-slate-400 hover:text-slate-600 dark:hover:text-white transition-colors p-1"
+            >
+              <X className="w-3.5 h-3.5" />
+            </button>
+          </div>
+        </div>
+      )}
+
       {/* ── Floating Action Button ── */}
       <button
         onClick={isOpen ? () => setIsOpen(false) : handleOpen}

package/src/components/ChatWindow.tsx

@@ -7,6 +7,7 @@ import {
   X,
   Sparkles,
   ArrowUp,
+  ArrowUpCircle,
   TriangleAlert,
   RotateCcw,
   Maximize2,
@@ -21,6 +22,7 @@ import { useConfig } from './ConfigProvider';
 import { useRagChat } from '../hooks/useRagChat';
 import { BORDER_RADIUS_MAP, CHAT_SUGGESTIONS } from '../config/uiConstants';
 import { ChatWindowProps } from '../types';
+import { SDK_VERSION } from '../version';
 
 interface SpeechRecognitionEvent {
   resultIndex: number;
@@ -86,8 +88,58 @@ export function ChatWindow({
 
   const [isListening, setIsListening] = useState(false);
   const [isUploadModalOpen, setIsUploadModalOpen] = useState(false);
+  const [licenseError, setLicenseError] = useState<string | null>(null);
+  const [versionError, setVersionError] = useState<string | null>(null);
   const recognitionRef = useRef<ISpeechRecognition | null>(null);
 
+  // Validate server license and SDK version on ChatWindow session initialization
+  useEffect(() => {
+    let isMounted = true;
+    async function validateSessionLicense() {
+      try {
+        const base = retrivoraApiBase || '/api/retrivora';
+        const configUrl = `${base.replace(/\/$/, '')}/config?sdkVersion=${SDK_VERSION}`;
+        const res = await fetch(configUrl, {
+          method: 'GET',
+          cache: 'no-store',
+          headers: {
+            'Content-Type': 'application/json',
+            'x-sdk-version': SDK_VERSION,
+            ...(headers || {})
+          },
+        });
+
+        if (!res.ok) {
+          const data = await res.json().catch(() => ({}));
+          if (res.status === 426 || data.code === 'SDK_VERSION_OUTDATED') {
+            if (isMounted) {
+              setVersionError(data.error || 'Your Retrivora SDK package is outdated. Please update your package to the latest version to continue.');
+            }
+          } else if (
+            res.status === 403 ||
+            res.status === 401 ||
+            (typeof data.error === 'string' && data.error.toLowerCase().includes('license'))
+          ) {
+            if (isMounted) {
+              const errMsg = typeof data.error === 'string' ? data.error : data.error?.message || 'Your Retrivora license is no longer valid. Please contact your administrator or obtain a valid license key.';
+              setLicenseError(errMsg);
+            }
+          }
+        } else {
+          if (isMounted) {
+            setLicenseError(null);
+            setVersionError(null);
+          }
+        }
+      } catch {
+        // Non-blocking fallback
+      }
+    }
+
+    validateSessionLicense();
+    return () => { isMounted = false; };
+  }, [retrivoraApiBase, headers]);
+
   // Initialize SpeechRecognition
   useEffect(() => {
     if (typeof window !== 'undefined') {
@@ -345,7 +397,36 @@ export function ChatWindow({
       </div>
 
       <div className="flex-1 overflow-y-auto px-4 py-4 space-y-5 scrollbar-thin scrollbar-thumb-slate-200 dark:scrollbar-thumb-white/10 scrollbar-track-transparent min-h-0 bg-slate-50 dark:bg-transparent">
-        {!mounted || isEmpty ? (
+        {versionError ? (
+          <div className="h-full flex flex-col items-center justify-center text-center p-6 space-y-4 bg-amber-50/70 dark:bg-amber-950/20 rounded-2xl border border-amber-200/80 dark:border-amber-800/40 my-auto">
+            <div className="w-14 h-14 rounded-2xl bg-amber-100 dark:bg-amber-900/40 text-amber-600 dark:text-amber-400 flex items-center justify-center shadow-sm shrink-0">
+              <ArrowUpCircle className="w-7 h-7 animate-bounce" />
+            </div>
+            <div className="space-y-2 max-w-xs">
+              <h4 className="text-base font-extrabold text-slate-900 dark:text-white tracking-tight">Package Update Required</h4>
+              <p className="text-xs text-slate-600 dark:text-slate-300 leading-relaxed font-medium">
+                {versionError}
+              </p>
+              <div className="pt-2">
+                <code className="block bg-slate-900 text-amber-300 text-[10px] font-mono py-2 px-3 rounded-xl select-all border border-slate-800">
+                  npm i @retrivora-ai/rag-engine@latest
+                </code>
+              </div>
+            </div>
+          </div>
+        ) : licenseError ? (
+          <div className="h-full flex flex-col items-center justify-center text-center p-6 space-y-4 bg-rose-50/50 dark:bg-rose-950/20 rounded-2xl border border-rose-200/60 dark:border-rose-800/40 my-auto">
+            <div className="w-14 h-14 rounded-2xl bg-rose-100 dark:bg-rose-900/40 text-rose-600 dark:text-rose-400 flex items-center justify-center shadow-sm shrink-0">
+              <TriangleAlert className="w-7 h-7" />
+            </div>
+            <div className="space-y-2 max-w-xs">
+              <h4 className="text-base font-extrabold text-slate-900 dark:text-white tracking-tight">License Invalid</h4>
+              <p className="text-xs text-slate-600 dark:text-slate-300 leading-relaxed font-medium">
+                {licenseError}
+              </p>
+            </div>
+          </div>
+        ) : !mounted || isEmpty ? (
           /* Welcome state */
           <div className="h-full flex flex-col items-center justify-center text-center gap-4 px-6 py-4">
             <div
@@ -408,7 +489,7 @@ export function ChatWindow({
         )}
 
         {/* Error */}
-        {error && (
+        {error && !licenseError && (
           <div className="flex items-center gap-2 text-rose-500 dark:text-rose-400 text-sm bg-rose-50 dark:bg-rose-400/10 border border-rose-200 dark:border-rose-400/20 rounded-xl px-4 py-3">
             <TriangleAlert className="w-4 h-4 flex-shrink-0" />
             <span>{error}</span>
@@ -479,7 +560,7 @@ export function ChatWindow({
             onKeyDown={handleKeyDown}
             placeholder={ui.placeholder}
             rows={1}
-            disabled={isLoading}
+            disabled={isLoading || !!licenseError || !!versionError}
             className="flex-1 bg-transparent text-slate-900 dark:text-white/90 placeholder-slate-400 dark:placeholder-white/30 text-sm resize-none outline-none py-1.5 px-2 max-h-32 leading-relaxed disabled:opacity-50"
             style={{ scrollbarWidth: 'none' }}
           />
@@ -488,7 +569,7 @@ export function ChatWindow({
             <button
               type="button"
               onClick={toggleListening}
-              disabled={isLoading}
+              disabled={isLoading || !!licenseError || !!versionError}
               className={`flex-shrink-0 w-9 h-9 rounded-xl flex items-center justify-center transition-all hover:scale-105 active:scale-95 disabled:opacity-50 disabled:cursor-not-allowed disabled:hover:scale-100 disabled:active:scale-100 ${isListening
                   ? 'bg-rose-500 text-white animate-pulse shadow-md shadow-rose-500/20'
                   : 'text-slate-400 dark:text-white/40 hover:bg-slate-200 dark:hover:bg-white/10'
@@ -503,7 +584,8 @@ export function ChatWindow({
             <button
               type="button"
               onClick={() => setIsUploadModalOpen(true)}
-              className="flex-shrink-0 w-9 h-9 rounded-xl flex items-center justify-center transition-all hover:scale-105 active:scale-95 text-slate-400 dark:text-white/40 hover:bg-slate-200 dark:hover:bg-white/10"
+              disabled={isLoading || !!licenseError || !!versionError}
+              className="flex-shrink-0 w-9 h-9 rounded-xl flex items-center justify-center transition-all hover:scale-105 active:scale-95 text-slate-400 dark:text-white/40 hover:bg-slate-200 dark:hover:bg-white/10 disabled:opacity-50 disabled:cursor-not-allowed"
               title="Upload Document"
             >
               <Paperclip className="w-4 h-4" />
@@ -521,14 +603,10 @@ export function ChatWindow({
           ) : (
             <button
               onClick={sendMessage}
-              disabled={!input.trim()}
-              className="flex-shrink-0 w-9 h-9 rounded-xl flex items-center justify-center transition-all disabled:opacity-30 disabled:cursor-not-allowed hover:scale-105 active:scale-95 shadow-md"
-              style={{
-                background:
-                  input.trim()
-                    ? `linear-gradient(135deg, ${ui.primaryColor}, ${ui.accentColor})`
-                    : 'rgba(148, 163, 184, 0.2)', // slate-400/20 for light mode disabled
-              }}
+              disabled={!input.trim() || !!licenseError || !!versionError}
+              className={`flex-shrink-0 w-9 h-9 flex items-center justify-center transition-all shadow-md active:scale-95 cursor-pointer disabled:opacity-30 disabled:cursor-not-allowed disabled:active:scale-100 ${ui.borderRadius === 'full' ? 'rounded-full' : 'rounded-xl'}`}
+              style={{ background: `linear-gradient(135deg, ${ui.primaryColor}, ${ui.accentColor})` }}
+              title="Send message"
             >
               <ArrowUp className="w-4 h-4 text-white" />
             </button>

package/src/config/UniversalProfiles.ts

@@ -14,8 +14,7 @@ const OPENAI_BASE = {
 export const LLM_PROFILES = {
   'openai-compatible': OPENAI_BASE,
   'litellm': { 
-    ...OPENAI_BASE, 
-    chatPayloadTemplate: '{"model":"{{model}}","messages":{{messages}},"max_tokens":{{maxTokens}},"temperature":{{temperature}},"stream":false}' 
+    ...OPENAI_BASE,
   },
   'anthropic-claude': {
     chatPath: '/v1/messages',

package/src/config/serverConfig.ts

@@ -187,8 +187,10 @@ export function getEnvConfig(env: Record<string, string | undefined> = process.e
 
   // Default gateway: retrivora.com/api/v1 acts as a secure proxy that validates the license key
   // and forwards to llm.retrivora.com with LITELLM_MASTER_KEY (which end-users never need to know).
-  // Developers who self-host can override with LITELLM_BASE_URL.
-  const defaultGatewayUrl = readString(env, 'LITELLM_BASE_URL') ?? readString(env, 'LLM_BASE_URL') ?? 'https://www.retrivora.com/api/v1';
+  const defaultGatewayUrl =
+    readString(env, 'LITELLM_BASE_URL') ??
+    readString(env, 'LLM_BASE_URL') ??
+    'https://www.retrivora.com/api/v1';
 
   const defaultLlmProvider = isFreeTier ? 'universal_rest' : 'universal_rest';
   const llmProvider = (readEnum(env, 'LLM_PROVIDER', defaultLlmProvider, LLM_PROVIDERS) ?? base?.llm?.provider ?? defaultLlmProvider) as LLMProvider;
@@ -277,7 +279,7 @@ export function getEnvConfig(env: Record<string, string | undefined> = process.e
     },
     telemetry: {
       enabled: telemetryEnabled,
-      url: readString(env, 'TELEMETRY_URL') ?? readString(env, 'NEXT_PUBLIC_TELEMETRY_URL') ?? base?.telemetry?.url ?? (process.env.NODE_ENV === 'development' ? 'http://localhost:3001/api/telemetry' : 'https://retrivora.com/api/telemetry'),
+      url: readString(env, 'TELEMETRY_URL') ?? readString(env, 'NEXT_PUBLIC_TELEMETRY_URL') ?? base?.telemetry?.url ?? 'https://www.retrivora.com/api/telemetry',
     },
     // Optional graph DB — driven by GRAPH_DB_PROVIDER env var
     ...(readString(env, 'GRAPH_DB_PROVIDER') ? {

package/src/core/ConfigFetcher.ts

@@ -57,8 +57,8 @@ export class ConfigFetcher {
       process.env.NEXT_PUBLIC_RETRIVORA_CONTROL_PLANE_URL,
       'https://www.retrivora.com',
       'https://retrivora.com',
-      'http://localhost:3001',
       'http://localhost:3000',
+      'http://localhost:3001',
     ].filter(Boolean) as string[];
 
     for (const baseUrl of controlPlaneUrls) {

package/src/core/Pipeline.ts

@@ -586,16 +586,16 @@ You are a helpful assistant. Use the provided context to answer questions accura
         ? await this.vectorDB.query(queryVector, retrievalLimit, ns, filter)
         : []).filter((s): s is VectorMatch => Boolean(s && typeof s === 'object'));
 
-      console.log('[Pipeline] Raw vectorDB.query response:', {
-        rawCount: rawSources.length,
-        sample: rawSources.slice(0, 2).map((s) => ({
-          id: s?.id,
-          score: s?.score,
-          contentType: typeof s?.content,
-          contentSnippet: String(s?.content ?? '').substring(0, 150),
-          metadataKeys: Object.keys(s?.metadata || {}),
-        })),
-      });
+      // console.log('[Pipeline] Raw vectorDB.query response:', {
+      //   rawCount: rawSources.length,
+      //   sample: rawSources.slice(0, 2).map((s) => ({
+      //     id: s?.id,
+      //     score: s?.score,
+      //     contentType: typeof s?.content,
+      //     contentSnippet: String(s?.content ?? '').substring(0, 150),
+      //     metadataKeys: Object.keys(s?.metadata || {}),
+      //   })),
+      // });
 
       const retrieveEnd = performance.now();
       const embedMs = retrieveEnd - embedStart;
@@ -628,18 +628,18 @@ You are a helpful assistant. Use the provided context to answer questions accura
         .filter((s): s is VectorMatch => Boolean(s && typeof s === 'object'))
         .sort((a, b) => (b?.score ?? 0) - (a?.score ?? 0));
 
-      console.log('[Pipeline] Final sources for prompt & UI:', {
-        count: sources.length,
-        totalRawCount: rawSources.length,
-        sources: sources.slice(0, 10).map((s, idx) => ({
-          rank: idx + 1,
-          id: s?.id,
-          score: s?.score,
-          contentType: typeof s?.content,
-          contentSnippet: String(s?.content ?? '').substring(0, 150),
-          metadata: s?.metadata,
-        })),
-      });
+      // console.log('[Pipeline] Final sources for prompt & UI:', {
+      //   count: sources.length,
+      //   totalRawCount: rawSources.length,
+      //   sources: sources.slice(0, 10).map((s, idx) => ({
+      //     rank: idx + 1,
+      //     id: s?.id,
+      //     score: s?.score,
+      //     contentType: typeof s?.content,
+      //     contentSnippet: String(s?.content ?? '').substring(0, 150),
+      //     metadata: s?.metadata,
+      //   })),
+      // });
 
       if (graphData && graphData.nodes.length > 0) {
         const graphContext = graphData.nodes.map(n =>
@@ -912,14 +912,11 @@ You are a helpful assistant. Use the provided context to answer questions accura
       // Asynchronously trigger telemetry logging without blocking response yield
       const isTelemetryActive = this.config.telemetry?.enabled ?? Boolean(this.config.licenseKey);
       if (isTelemetryActive) {
-        const defaultUrl = process.env.NODE_ENV === 'development' && !process.env.TELEMETRY_URL && !process.env.NEXT_PUBLIC_TELEMETRY_URL
-          ? 'http://localhost:3001/api/telemetry'
-          : 'https://retrivora.com/api/telemetry';
-
+        const defaultUrl = 'https://www.retrivora.com/api/telemetry';
         const telemetryUrl = this.config.telemetry?.url || process.env.TELEMETRY_URL || process.env.NEXT_PUBLIC_TELEMETRY_URL || defaultUrl;
         const absoluteUrl = telemetryUrl.startsWith('http')
           ? telemetryUrl
-          : (process.env.NEXT_PUBLIC_APP_URL || `http://localhost:${process.env.PORT || 3000}`) + telemetryUrl;
+          : 'https://www.retrivora.com' + (telemetryUrl.startsWith('/') ? telemetryUrl : '/' + telemetryUrl);
 
         // Start background process for telemetry, awaiting hallucination scoring if it was backgrounded
         (async () => {

package/src/core/VectorPlugin.ts

@@ -155,8 +155,8 @@ export class VectorPlugin {
     }
     try {
       return await this.pipeline.getSuggestions(query, namespace);
-    } catch (err) {
-      throw wrapError(err, 'RETRIEVAL_FAILED');
+    } catch {
+      return [];
     }
   }
 }

package/src/handlers/index.ts

@@ -166,13 +166,10 @@ function reportTelemetry(
     const licenseKey = config.licenseKey || process.env.RAG_LICENSE_KEY || process.env.RETRIVORA_LICENSE_KEY || process.env.NEXT_PUBLIC_RETRIVORA_LICENSE_KEY;
     const telemetryConfig = config.telemetry;
 
-    const enabled = telemetryConfig?.enabled ?? Boolean(licenseKey);
-    const defaultUrl = process.env.NODE_ENV === 'development' && !process.env.TELEMETRY_URL && !process.env.NEXT_PUBLIC_TELEMETRY_URL
-      ? 'http://localhost:3001/api/telemetry'
-      : 'https://www.retrivora.com/api/telemetry';
+    const host = req.headers.get('host') || 'localhost';
+    const defaultUrl = 'https://www.retrivora.com/api/telemetry';
 
     const telemetryUrl = telemetryConfig?.url || process.env.TELEMETRY_URL || process.env.NEXT_PUBLIC_TELEMETRY_URL || defaultUrl;
-    const host = req.headers.get('host') || 'localhost';
     const userAgent = req.headers.get('user-agent') || `Retrivora-SDK/${SDK_VERSION}`;
 
     let absoluteUrl = telemetryUrl;
@@ -285,7 +282,7 @@ export function createChatHandler(
   const storage = new DatabaseStorage(plugin.getConfig());
   const onAuthorize = options?.onAuthorize;
 
-  return async function POST(req: NextRequest) {
+  return async function POST(req: any, context?: any) {
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult as any;
 
@@ -361,7 +358,7 @@ export function createStreamHandler(
   const storage = new DatabaseStorage(plugin.getConfig());
   const onAuthorize = options?.onAuthorize;
 
-  return async function POST(req: NextRequest) {
+  return async function POST(req: any, context?: any) {
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult as any;
 
@@ -532,7 +529,7 @@ export function createIngestHandler(
   const plugin = getOrCreatePlugin(configOrPlugin);
   const onAuthorize = options?.onAuthorize;
 
-  return async function POST(req: NextRequest) {
+  return async function POST(req: any, context?: any) {
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult as any;
 
@@ -599,7 +596,7 @@ export function createUploadHandler(
   const plugin = getOrCreatePlugin(configOrPlugin);
   const onAuthorize = options?.onAuthorize;
 
-  return async function POST(req: NextRequest) {
+  return async function POST(req: any, context?: any) {
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult as any;
 
@@ -926,7 +923,7 @@ export function createRagHandler(
   const feedbackHandler = createFeedbackHandler(plugin, { onAuthorize });
   const sessionsHandler = createSessionsHandler(plugin, { onAuthorize });
 
-  async function routePostRequest(req: NextRequest, segment: string) {
+  async function routePostRequest(req: any, segment: string) {
     switch (segment) {
       case 'chat':
         return streamHandler(req);
@@ -948,7 +945,7 @@ export function createRagHandler(
     }
   }
 
-  async function routeGetRequest(req: NextRequest, segment: string) {
+  async function routeGetRequest(req: any, segment: string) {
     switch (segment) {
       case 'health':
         return healthHandler(req);
@@ -965,7 +962,7 @@ export function createRagHandler(
     }
   }
 
-  async function getSegment(req: NextRequest, context: any): Promise<string> {
+  async function getSegment(req: any, context: any): Promise<string> {
     // 1. If content-type is multipart/form-data, it MUST be an upload request!
     const contentType = req.headers.get('content-type') || '';
     if (contentType.includes('multipart/form-data')) {
@@ -995,7 +992,7 @@ export function createRagHandler(
   }
 
   return {
-    GET: async (req: NextRequest, context: any) => {
+    GET: async (req: any, context?: any) => {
       try {
         const segment = await getSegment(req, context);
         return await routeGetRequest(req, segment);
@@ -1004,7 +1001,7 @@ export function createRagHandler(
         return NextResponse.json({ error: msg }, { status: 500 });
       }
     },
-    POST: async (req: NextRequest, context: any) => {
+    POST: async (req: any, context?: any) => {
       try {
         const segment = await getSegment(req, context);
         return await routePostRequest(req, segment);

package/src/hooks/useRagChat.ts

@@ -154,7 +154,15 @@ export function useRagChat(
 
         if (!response.ok) {
           const errorData = await response.json().catch(() => ({}));
-          throw new Error(errorData.error || `Server returned ${response.status}`);
+          if (
+            response.status === 403 ||
+            response.status === 401 ||
+            (typeof errorData.error === 'string' && errorData.error.toLowerCase().includes('license')) ||
+            errorData.error?.type === 'license_revoked'
+          ) {
+            throw new Error('Your Retrivora license is no longer valid. Please contact your administrator or obtain a valid license key.');
+          }
+          throw new Error(errorData.error?.message || errorData.error || `Server returned ${response.status}`);
         }
 
         if (!response.body) {