@retrivora-ai/rag-engine 2.2.6 → 2.2.8

package/dist/{ILLMProvider-BWa68XX5.d.mts → ILLMProvider-teTNQ1lh.d.mts}

@@ -51,6 +51,8 @@ interface UseRagChatOptions {
     onError?: (error: string) => void;
     /** Optional custom headers to send with the chat request */
     headers?: Record<string, string>;
+    /** Optional Retrivora license key override */
+    licenseKey?: string;
     /** Session ID for history and feedback tracking (default: 'default') */
     sessionId?: string;
 }

package/dist/{ILLMProvider-BWa68XX5.d.ts → ILLMProvider-teTNQ1lh.d.ts}

@@ -51,6 +51,8 @@ interface UseRagChatOptions {
     onError?: (error: string) => void;
     /** Optional custom headers to send with the chat request */
     headers?: Record<string, string>;
+    /** Optional Retrivora license key override */
+    licenseKey?: string;
     /** Session ID for history and feedback tracking (default: 'default') */
     sessionId?: string;
 }

package/dist/{index-BCbeeh74.d.ts → LicenseValidator-CENvo9o2.d.mts}

@@ -1,5 +1,5 @@
 import { CSSProperties, MouseEvent, ReactNode, ElementType } from 'react';
-import { y as Product, m as UIConfig, j as RagMessage, q as VectorMatch, J as UITransformationResponse, i as RagConfig, I as ILLMProvider, f as IngestDocument, C as ChatMessage, c as ChatResponse, z as RetrievalResult, n as UniversalRagConfig } from './ILLMProvider-BWa68XX5.js';
+import { y as Product, m as UIConfig, j as RagMessage, q as VectorMatch, J as UITransformationResponse, i as RagConfig, I as ILLMProvider, f as IngestDocument, C as ChatMessage, c as ChatResponse, z as RetrievalResult, n as UniversalRagConfig } from './ILLMProvider-teTNQ1lh.mjs';
 
 interface ArchitectureCardProps {
     icon: ReactNode;
@@ -53,11 +53,12 @@ interface ChatWindowProps {
     onAddToCart?: (product: Product) => void;
     /** Optional custom API URL to send chat messages to */
     apiUrl?: string;
-    /**
-     * Base URL for Retrivora SDK history/feedback/sessions endpoints.
+    /** Base URL for Retrivora SDK history/feedback/sessions endpoints.
      * Defaults to '/api/retrivora'. Set this to match your catch-all route location.
      */
     retrivoraApiBase?: string;
+    /** Optional Retrivora license key override */
+    licenseKey?: string;
     /** Optional custom headers to send with the chat request */
     headers?: Record<string, string>;
 }
@@ -73,6 +74,8 @@ interface ChatWidgetProps {
      * Defaults to '/api/retrivora'.
      */
     retrivoraApiBase?: string;
+    /** Optional Retrivora license key override */
+    licenseKey?: string;
     /** Optional custom headers to send with the chat request */
     headers?: Record<string, string>;
 }
@@ -509,7 +512,7 @@ declare class Retrivora {
 /**
  * Named SDK exceptions make failures machine-readable for host applications.
  */
-type RetrivoraErrorCode = 'PROVIDER_NOT_FOUND' | 'EMBEDDING_FAILED' | 'RETRIEVAL_FAILED' | 'RATE_LIMITED' | 'CONFIGURATION_ERROR' | 'AUTHENTICATION_ERROR';
+type RetrivoraErrorCode = 'PROVIDER_NOT_FOUND' | 'EMBEDDING_FAILED' | 'RETRIEVAL_FAILED' | 'RATE_LIMITED' | 'CONFIGURATION_ERROR' | 'AUTHENTICATION_ERROR' | 'SDK_VERSION_UNSUPPORTED' | 'LICENSE_VALIDATION_ERROR';
 declare class RetrivoraError extends Error {
     readonly code: RetrivoraErrorCode;
     readonly details?: unknown;
@@ -533,9 +536,49 @@ declare class ConfigurationException extends RetrivoraError {
 declare class AuthenticationException extends RetrivoraError {
     constructor(message?: string, details?: unknown);
 }
+declare class SDKVersionUnsupportedError extends RetrivoraError {
+    constructor(message?: string, details?: unknown);
+}
+declare class LicenseValidationError extends RetrivoraError {
+    constructor(message?: string, details?: unknown);
+}
 /**
  * Wraps any unknown error into an appropriate RetrivoraError subclass.
  */
 declare function wrapError(err: unknown, defaultCode: RetrivoraErrorCode, defaultMessage?: string): RetrivoraError;
 
-export { AuthenticationException as A, type ChatViewportSize as B, type ChatWidgetProps as C, type DocumentUploadProps as D, EmbeddingFailedException as E, DocumentChunker as F, MixedRendererStrategy as G, Pipeline as H, type IRenderRule as I, type PipelineStep as J, type ProviderPill as K, type RenderSectionDecision as L, type MessageBubbleProps as M, type Snippet as N, TextRendererStrategy as O, type ProductCardProps as P, wrapError as Q, RateLimitException as R, type SourceCardProps as S, TableRendererStrategy as T, VisualizationDecisionEngine as V, type ChatWindowProps as a, type ConfigProviderProps as b, type ClientConfig as c, type ProductCarouselProps as d, type ChartType as e, type Chunk as f, type ChunkOptions as g, ConfigurationException as h, type DecisionContext as i, type IRendererStrategy as j, type IntentCategory as k, IntentClassifier as l, ProviderNotFoundException as m, type RenderDecision as n, type RenderType as o, RendererRegistry as p, RetrievalException as q, Retrivora as r, RetrivoraError as s, type RetrivoraErrorCode as t, RuleEngine as u, SDK_VERSION as v, decideVisualization as w, type ArchitectureCardProps as x, CarouselRendererStrategy as y, ChartRendererStrategy as z };
+interface LicenseValidationRequest {
+    licenseKey: string;
+    projectId?: string;
+    sdkVersion?: string;
+    sdk?: string;
+    platform?: string;
+    retrivoraApiBase?: string;
+    headers?: Record<string, string>;
+}
+interface LicenseValidationResponse {
+    valid: boolean;
+    licenseStatus: 'ACTIVE' | 'SUSPENDED' | 'TERMINATED' | 'EXPIRED' | 'REVOKED';
+    minimumSupportedVersion: string;
+    latestVersion: string;
+    forceUpgrade: boolean;
+    expiresAt: string | null;
+    message: string;
+}
+declare class LicenseValidator {
+    private static instance;
+    private cache;
+    private static readonly SUCCESS_CACHE_TTL_MS;
+    private constructor();
+    static getInstance(): LicenseValidator;
+    /**
+     * Invalidate local validation cache for a license key
+     */
+    purgeCache(licenseKey?: string): void;
+    /**
+     * Validate license status and SDK version against Retrivora License Service
+     */
+    validate(request: LicenseValidationRequest): Promise<LicenseValidationResponse>;
+}
+
+export { AuthenticationException as A, decideVisualization as B, type ChatWidgetProps as C, type DocumentUploadProps as D, EmbeddingFailedException as E, type ArchitectureCardProps as F, CarouselRendererStrategy as G, ChartRendererStrategy as H, type IRenderRule as I, type ChatViewportSize as J, DocumentChunker as K, LicenseValidationError as L, type MessageBubbleProps as M, MixedRendererStrategy as N, Pipeline as O, type ProductCardProps as P, type PipelineStep as Q, RateLimitException as R, type SourceCardProps as S, type ProviderPill as T, type RenderSectionDecision as U, VisualizationDecisionEngine as V, type Snippet as W, TableRendererStrategy as X, TextRendererStrategy as Y, wrapError as Z, type ChatWindowProps as a, type ConfigProviderProps as b, type ClientConfig as c, type ProductCarouselProps as d, type ChartType as e, type Chunk as f, type ChunkOptions as g, ConfigurationException as h, type DecisionContext as i, type IRendererStrategy as j, type IntentCategory as k, IntentClassifier as l, type LicenseValidationRequest as m, type LicenseValidationResponse as n, LicenseValidator as o, ProviderNotFoundException as p, type RenderDecision as q, type RenderType as r, RendererRegistry as s, RetrievalException as t, Retrivora as u, RetrivoraError as v, type RetrivoraErrorCode as w, RuleEngine as x, SDKVersionUnsupportedError as y, SDK_VERSION as z };

package/dist/{index-BbJGyNmW.d.mts → LicenseValidator-CsjJp2PP.d.ts}

@@ -1,5 +1,5 @@
 import { CSSProperties, MouseEvent, ReactNode, ElementType } from 'react';
-import { y as Product, m as UIConfig, j as RagMessage, q as VectorMatch, J as UITransformationResponse, i as RagConfig, I as ILLMProvider, f as IngestDocument, C as ChatMessage, c as ChatResponse, z as RetrievalResult, n as UniversalRagConfig } from './ILLMProvider-BWa68XX5.mjs';
+import { y as Product, m as UIConfig, j as RagMessage, q as VectorMatch, J as UITransformationResponse, i as RagConfig, I as ILLMProvider, f as IngestDocument, C as ChatMessage, c as ChatResponse, z as RetrievalResult, n as UniversalRagConfig } from './ILLMProvider-teTNQ1lh.js';
 
 interface ArchitectureCardProps {
     icon: ReactNode;
@@ -53,11 +53,12 @@ interface ChatWindowProps {
     onAddToCart?: (product: Product) => void;
     /** Optional custom API URL to send chat messages to */
     apiUrl?: string;
-    /**
-     * Base URL for Retrivora SDK history/feedback/sessions endpoints.
+    /** Base URL for Retrivora SDK history/feedback/sessions endpoints.
      * Defaults to '/api/retrivora'. Set this to match your catch-all route location.
      */
     retrivoraApiBase?: string;
+    /** Optional Retrivora license key override */
+    licenseKey?: string;
     /** Optional custom headers to send with the chat request */
     headers?: Record<string, string>;
 }
@@ -73,6 +74,8 @@ interface ChatWidgetProps {
      * Defaults to '/api/retrivora'.
      */
     retrivoraApiBase?: string;
+    /** Optional Retrivora license key override */
+    licenseKey?: string;
     /** Optional custom headers to send with the chat request */
     headers?: Record<string, string>;
 }
@@ -509,7 +512,7 @@ declare class Retrivora {
 /**
  * Named SDK exceptions make failures machine-readable for host applications.
  */
-type RetrivoraErrorCode = 'PROVIDER_NOT_FOUND' | 'EMBEDDING_FAILED' | 'RETRIEVAL_FAILED' | 'RATE_LIMITED' | 'CONFIGURATION_ERROR' | 'AUTHENTICATION_ERROR';
+type RetrivoraErrorCode = 'PROVIDER_NOT_FOUND' | 'EMBEDDING_FAILED' | 'RETRIEVAL_FAILED' | 'RATE_LIMITED' | 'CONFIGURATION_ERROR' | 'AUTHENTICATION_ERROR' | 'SDK_VERSION_UNSUPPORTED' | 'LICENSE_VALIDATION_ERROR';
 declare class RetrivoraError extends Error {
     readonly code: RetrivoraErrorCode;
     readonly details?: unknown;
@@ -533,9 +536,49 @@ declare class ConfigurationException extends RetrivoraError {
 declare class AuthenticationException extends RetrivoraError {
     constructor(message?: string, details?: unknown);
 }
+declare class SDKVersionUnsupportedError extends RetrivoraError {
+    constructor(message?: string, details?: unknown);
+}
+declare class LicenseValidationError extends RetrivoraError {
+    constructor(message?: string, details?: unknown);
+}
 /**
  * Wraps any unknown error into an appropriate RetrivoraError subclass.
  */
 declare function wrapError(err: unknown, defaultCode: RetrivoraErrorCode, defaultMessage?: string): RetrivoraError;
 
-export { AuthenticationException as A, type ChatViewportSize as B, type ChatWidgetProps as C, type DocumentUploadProps as D, EmbeddingFailedException as E, DocumentChunker as F, MixedRendererStrategy as G, Pipeline as H, type IRenderRule as I, type PipelineStep as J, type ProviderPill as K, type RenderSectionDecision as L, type MessageBubbleProps as M, type Snippet as N, TextRendererStrategy as O, type ProductCardProps as P, wrapError as Q, RateLimitException as R, type SourceCardProps as S, TableRendererStrategy as T, VisualizationDecisionEngine as V, type ChatWindowProps as a, type ConfigProviderProps as b, type ClientConfig as c, type ProductCarouselProps as d, type ChartType as e, type Chunk as f, type ChunkOptions as g, ConfigurationException as h, type DecisionContext as i, type IRendererStrategy as j, type IntentCategory as k, IntentClassifier as l, ProviderNotFoundException as m, type RenderDecision as n, type RenderType as o, RendererRegistry as p, RetrievalException as q, Retrivora as r, RetrivoraError as s, type RetrivoraErrorCode as t, RuleEngine as u, SDK_VERSION as v, decideVisualization as w, type ArchitectureCardProps as x, CarouselRendererStrategy as y, ChartRendererStrategy as z };
+interface LicenseValidationRequest {
+    licenseKey: string;
+    projectId?: string;
+    sdkVersion?: string;
+    sdk?: string;
+    platform?: string;
+    retrivoraApiBase?: string;
+    headers?: Record<string, string>;
+}
+interface LicenseValidationResponse {
+    valid: boolean;
+    licenseStatus: 'ACTIVE' | 'SUSPENDED' | 'TERMINATED' | 'EXPIRED' | 'REVOKED';
+    minimumSupportedVersion: string;
+    latestVersion: string;
+    forceUpgrade: boolean;
+    expiresAt: string | null;
+    message: string;
+}
+declare class LicenseValidator {
+    private static instance;
+    private cache;
+    private static readonly SUCCESS_CACHE_TTL_MS;
+    private constructor();
+    static getInstance(): LicenseValidator;
+    /**
+     * Invalidate local validation cache for a license key
+     */
+    purgeCache(licenseKey?: string): void;
+    /**
+     * Validate license status and SDK version against Retrivora License Service
+     */
+    validate(request: LicenseValidationRequest): Promise<LicenseValidationResponse>;
+}
+
+export { AuthenticationException as A, decideVisualization as B, type ChatWidgetProps as C, type DocumentUploadProps as D, EmbeddingFailedException as E, type ArchitectureCardProps as F, CarouselRendererStrategy as G, ChartRendererStrategy as H, type IRenderRule as I, type ChatViewportSize as J, DocumentChunker as K, LicenseValidationError as L, type MessageBubbleProps as M, MixedRendererStrategy as N, Pipeline as O, type ProductCardProps as P, type PipelineStep as Q, RateLimitException as R, type SourceCardProps as S, type ProviderPill as T, type RenderSectionDecision as U, VisualizationDecisionEngine as V, type Snippet as W, TableRendererStrategy as X, TextRendererStrategy as Y, wrapError as Z, type ChatWindowProps as a, type ConfigProviderProps as b, type ClientConfig as c, type ProductCarouselProps as d, type ChartType as e, type Chunk as f, type ChunkOptions as g, ConfigurationException as h, type DecisionContext as i, type IRendererStrategy as j, type IntentCategory as k, IntentClassifier as l, type LicenseValidationRequest as m, type LicenseValidationResponse as n, LicenseValidator as o, ProviderNotFoundException as p, type RenderDecision as q, type RenderType as r, RendererRegistry as s, RetrievalException as t, Retrivora as u, RetrivoraError as v, type RetrivoraErrorCode as w, RuleEngine as x, SDKVersionUnsupportedError as y, SDK_VERSION as z };

package/dist/handlers/index.d.mts

@@ -1,3 +1,3 @@
 import 'next/server';
-export { o as HandlerOptions, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, p as createSuggestionsHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, q as sseObservabilityFrame, n as sseTextFrame, r as sseUIFrame } from '../index-DvbtNz7m.mjs';
-import '../ILLMProvider-BWa68XX5.mjs';
+export { o as HandlerOptions, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, p as createLicenseHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, q as createSuggestionsHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, r as sseObservabilityFrame, n as sseTextFrame, t as sseUIFrame } from '../index-Dmq5lH0j.mjs';
+import '../ILLMProvider-teTNQ1lh.mjs';

package/dist/handlers/index.d.ts

@@ -1,3 +1,3 @@
 import 'next/server';
-export { o as HandlerOptions, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, p as createSuggestionsHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, q as sseObservabilityFrame, n as sseTextFrame, r as sseUIFrame } from '../index-B5TTZWkx.js';
-import '../ILLMProvider-BWa68XX5.js';
+export { o as HandlerOptions, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, p as createLicenseHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, q as createSuggestionsHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, r as sseObservabilityFrame, n as sseTextFrame, t as sseUIFrame } from '../index-BPJ3KDYI.js';
+import '../ILLMProvider-teTNQ1lh.js';

package/dist/handlers/index.js

@@ -2209,6 +2209,7 @@ __export(handlers_exports, {
   createHealthHandler: () => createHealthHandler,
   createHistoryHandler: () => createHistoryHandler,
   createIngestHandler: () => createIngestHandler,
+  createLicenseHandler: () => createLicenseHandler,
   createRagHandler: () => createRagHandler,
   createSessionsHandler: () => createSessionsHandler,
   createStreamHandler: () => createStreamHandler,
@@ -2281,8 +2282,10 @@ function wrapError(err, defaultCode, defaultMessage) {
   if (status === 429 || /rate[- ]?limit/i.test(message) || code === "RATE_LIMIT_EXCEEDED") {
     return new RateLimitException(message, err);
   }
-  if (status === 401 || status === 403 || /unauthorized|auth|api[- ]?key/i.test(message) || code === "INVALID_API_KEY") {
-    return new AuthenticationException(message, err);
+  if (status === 401 || status === 403 || /unauthorized|auth|license|revoked|terminated|api[- ]?key/i.test(message) || code === "INVALID_API_KEY" || code === "LICENSE_DELETED" || code === "LICENSE_INACTIVE") {
+    const isLicenseError = /403|license|revoked|terminated/i.test(message) || status === 403;
+    const cleanMsg = isLicenseError ? "Your Retrivora license key has been terminated, suspended, or revoked. Access denied." : message;
+    return new AuthenticationException(cleanMsg, err);
   }
   switch (defaultCode) {
     case "PROVIDER_NOT_FOUND":
@@ -4707,7 +4710,7 @@ var ConfigValidator = class {
 // package.json
 var package_default = {
   name: "@retrivora-ai/rag-engine",
-  version: "2.2.6",
+  version: "2.2.8",
   description: "Retrivora AI is a plug-and-play AI engine for RAG chat experiences \u2014 generic vector DB + LLM provider, embeddable or standalone.",
   author: "Abhinav Alkuchi",
   license: "UNLICENSED",
@@ -10510,7 +10513,10 @@ function createStreamHandler(configOrPlugin, options) {
           }
         } catch (streamError) {
           if (isActive) {
-            const errorMessage = streamError instanceof Error ? streamError.message : String(streamError);
+            let errorMessage = streamError instanceof Error ? streamError.message : String(streamError);
+            if (errorMessage.includes("403") || errorMessage.toLowerCase().includes("license") || errorMessage.toLowerCase().includes("revoked") || errorMessage.toLowerCase().includes("terminated")) {
+              errorMessage = "Your Retrivora license key has been terminated, suspended, or revoked. Access denied.";
+            }
             console.error("[createStreamHandler] Stream error:", streamError);
             reportTelemetry(req, plugin, "QUERY_GENERATION", "error", errorMessage);
             try {
@@ -10580,6 +10586,46 @@ function createHealthHandler(configOrPlugin, options) {
     }
   };
 }
+function createLicenseHandler(configOrPlugin, options) {
+  const plugin = getOrCreatePlugin(configOrPlugin);
+  const onAuthorize = options == null ? void 0 : options.onAuthorize;
+  return async function POST(req) {
+    var _a2;
+    if (req) {
+      const authResult = await checkAuth(req, onAuthorize);
+      if (authResult) return authResult;
+    }
+    try {
+      const body = await req.json().catch(() => ({}));
+      const config = plugin.getConfig();
+      const licenseKey = req.headers.get("x-license-key") || (body == null ? void 0 : body.licenseKey) || ((_a2 = req.headers.get("authorization")) == null ? void 0 : _a2.replace(/^Bearer\s+/i, "")) || config.licenseKey || process.env.RETRIVORA_LICENSE_KEY || process.env.NEXT_PUBLIC_RETRIVORA_LICENSE_KEY || "";
+      const projectId = (body == null ? void 0 : body.projectId) || config.projectId || "my-rag-app";
+      const payload = LicenseVerifier.verify(licenseKey, projectId);
+      return import_server.NextResponse.json({
+        valid: true,
+        licenseStatus: "ACTIVE",
+        minimumSupportedVersion: "2.1.0",
+        latestVersion: SDK_VERSION,
+        forceUpgrade: false,
+        expiresAt: payload.expiresAt ? new Date(payload.expiresAt * 1e3).toISOString() : null,
+        message: "License key is active and valid."
+      });
+    } catch (err) {
+      return import_server.NextResponse.json(
+        {
+          valid: false,
+          licenseStatus: "REVOKED",
+          minimumSupportedVersion: "2.1.0",
+          latestVersion: SDK_VERSION,
+          forceUpgrade: false,
+          expiresAt: null,
+          message: (err == null ? void 0 : err.message) || "License validation failed."
+        },
+        { status: 400 }
+      );
+    }
+  };
+}
 function createUploadHandler(configOrPlugin, options) {
   const plugin = getOrCreatePlugin(configOrPlugin);
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
@@ -10831,6 +10877,7 @@ function createRagHandler(configOrPlugin, options) {
   const historyHandler = createHistoryHandler(plugin, { onAuthorize });
   const feedbackHandler = createFeedbackHandler(plugin, { onAuthorize });
   const sessionsHandler = createSessionsHandler(plugin, { onAuthorize });
+  const licenseHandler = createLicenseHandler(plugin, { onAuthorize });
   async function routePostRequest(req, segment) {
     switch (segment) {
       case "chat":
@@ -10848,6 +10895,9 @@ function createRagHandler(configOrPlugin, options) {
         return historyHandler(req);
       case "feedback":
         return feedbackHandler(req);
+      case "license/validate":
+      case "v1/license/validate":
+        return licenseHandler(req);
       default:
         return import_server.NextResponse.json({ error: `Not Found: POST segment "${segment}" not supported.` }, { status: 404 });
     }
@@ -10877,6 +10927,7 @@ function createRagHandler(configOrPlugin, options) {
     try {
       const url = new URL(req.url);
       const pathname = url.pathname;
+      if (pathname.includes("/license/validate")) return "v1/license/validate";
       if (pathname.endsWith("/upload")) return "upload";
       if (pathname.endsWith("/chat") || pathname.endsWith("/chat-sync")) return "chat";
       if (pathname.endsWith("/health")) return "health";
@@ -10918,6 +10969,7 @@ function createRagHandler(configOrPlugin, options) {
   createHealthHandler,
   createHistoryHandler,
   createIngestHandler,
+  createLicenseHandler,
   createRagHandler,
   createSessionsHandler,
   createStreamHandler,

package/dist/handlers/index.mjs

@@ -2246,8 +2246,10 @@ function wrapError(err, defaultCode, defaultMessage) {
   if (status === 429 || /rate[- ]?limit/i.test(message) || code === "RATE_LIMIT_EXCEEDED") {
     return new RateLimitException(message, err);
   }
-  if (status === 401 || status === 403 || /unauthorized|auth|api[- ]?key/i.test(message) || code === "INVALID_API_KEY") {
-    return new AuthenticationException(message, err);
+  if (status === 401 || status === 403 || /unauthorized|auth|license|revoked|terminated|api[- ]?key/i.test(message) || code === "INVALID_API_KEY" || code === "LICENSE_DELETED" || code === "LICENSE_INACTIVE") {
+    const isLicenseError = /403|license|revoked|terminated/i.test(message) || status === 403;
+    const cleanMsg = isLicenseError ? "Your Retrivora license key has been terminated, suspended, or revoked. Access denied." : message;
+    return new AuthenticationException(cleanMsg, err);
   }
   switch (defaultCode) {
     case "PROVIDER_NOT_FOUND":
@@ -4672,7 +4674,7 @@ var ConfigValidator = class {
 // package.json
 var package_default = {
   name: "@retrivora-ai/rag-engine",
-  version: "2.2.6",
+  version: "2.2.8",
   description: "Retrivora AI is a plug-and-play AI engine for RAG chat experiences \u2014 generic vector DB + LLM provider, embeddable or standalone.",
   author: "Abhinav Alkuchi",
   license: "UNLICENSED",
@@ -10475,7 +10477,10 @@ function createStreamHandler(configOrPlugin, options) {
           }
         } catch (streamError) {
           if (isActive) {
-            const errorMessage = streamError instanceof Error ? streamError.message : String(streamError);
+            let errorMessage = streamError instanceof Error ? streamError.message : String(streamError);
+            if (errorMessage.includes("403") || errorMessage.toLowerCase().includes("license") || errorMessage.toLowerCase().includes("revoked") || errorMessage.toLowerCase().includes("terminated")) {
+              errorMessage = "Your Retrivora license key has been terminated, suspended, or revoked. Access denied.";
+            }
             console.error("[createStreamHandler] Stream error:", streamError);
             reportTelemetry(req, plugin, "QUERY_GENERATION", "error", errorMessage);
             try {
@@ -10545,6 +10550,46 @@ function createHealthHandler(configOrPlugin, options) {
     }
   };
 }
+function createLicenseHandler(configOrPlugin, options) {
+  const plugin = getOrCreatePlugin(configOrPlugin);
+  const onAuthorize = options == null ? void 0 : options.onAuthorize;
+  return async function POST(req) {
+    var _a2;
+    if (req) {
+      const authResult = await checkAuth(req, onAuthorize);
+      if (authResult) return authResult;
+    }
+    try {
+      const body = await req.json().catch(() => ({}));
+      const config = plugin.getConfig();
+      const licenseKey = req.headers.get("x-license-key") || (body == null ? void 0 : body.licenseKey) || ((_a2 = req.headers.get("authorization")) == null ? void 0 : _a2.replace(/^Bearer\s+/i, "")) || config.licenseKey || process.env.RETRIVORA_LICENSE_KEY || process.env.NEXT_PUBLIC_RETRIVORA_LICENSE_KEY || "";
+      const projectId = (body == null ? void 0 : body.projectId) || config.projectId || "my-rag-app";
+      const payload = LicenseVerifier.verify(licenseKey, projectId);
+      return NextResponse.json({
+        valid: true,
+        licenseStatus: "ACTIVE",
+        minimumSupportedVersion: "2.1.0",
+        latestVersion: SDK_VERSION,
+        forceUpgrade: false,
+        expiresAt: payload.expiresAt ? new Date(payload.expiresAt * 1e3).toISOString() : null,
+        message: "License key is active and valid."
+      });
+    } catch (err) {
+      return NextResponse.json(
+        {
+          valid: false,
+          licenseStatus: "REVOKED",
+          minimumSupportedVersion: "2.1.0",
+          latestVersion: SDK_VERSION,
+          forceUpgrade: false,
+          expiresAt: null,
+          message: (err == null ? void 0 : err.message) || "License validation failed."
+        },
+        { status: 400 }
+      );
+    }
+  };
+}
 function createUploadHandler(configOrPlugin, options) {
   const plugin = getOrCreatePlugin(configOrPlugin);
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
@@ -10796,6 +10841,7 @@ function createRagHandler(configOrPlugin, options) {
   const historyHandler = createHistoryHandler(plugin, { onAuthorize });
   const feedbackHandler = createFeedbackHandler(plugin, { onAuthorize });
   const sessionsHandler = createSessionsHandler(plugin, { onAuthorize });
+  const licenseHandler = createLicenseHandler(plugin, { onAuthorize });
   async function routePostRequest(req, segment) {
     switch (segment) {
       case "chat":
@@ -10813,6 +10859,9 @@ function createRagHandler(configOrPlugin, options) {
         return historyHandler(req);
       case "feedback":
         return feedbackHandler(req);
+      case "license/validate":
+      case "v1/license/validate":
+        return licenseHandler(req);
       default:
         return NextResponse.json({ error: `Not Found: POST segment "${segment}" not supported.` }, { status: 404 });
     }
@@ -10842,6 +10891,7 @@ function createRagHandler(configOrPlugin, options) {
     try {
       const url = new URL(req.url);
       const pathname = url.pathname;
+      if (pathname.includes("/license/validate")) return "v1/license/validate";
       if (pathname.endsWith("/upload")) return "upload";
       if (pathname.endsWith("/chat") || pathname.endsWith("/chat-sync")) return "chat";
       if (pathname.endsWith("/health")) return "health";
@@ -10882,6 +10932,7 @@ export {
   createHealthHandler,
   createHistoryHandler,
   createIngestHandler,
+  createLicenseHandler,
   createRagHandler,
   createSessionsHandler,
   createStreamHandler,

package/dist/{index-DvbtNz7m.d.mts → index-BPJ3KDYI.d.ts}

@@ -1,5 +1,5 @@
 import { NextRequest } from 'next/server';
-import { i as RagConfig, I as ILLMProvider, C as ChatMessage, c as ChatResponse, f as IngestDocument } from './ILLMProvider-BWa68XX5.mjs';
+import { i as RagConfig, I as ILLMProvider, C as ChatMessage, c as ChatResponse, f as IngestDocument } from './ILLMProvider-teTNQ1lh.js';
 
 interface ValidationError {
     field: string;
@@ -158,6 +158,10 @@ declare function createIngestHandler(configOrPlugin?: Partial<RagConfig> | Vecto
  * createHealthHandler — factory for the health-check endpoint.
  */
 declare function createHealthHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req?: NextRequest) => Promise<any>;
+/**
+ * createLicenseHandler — factory for the license validation endpoint (/v1/license/validate).
+ */
+declare function createLicenseHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createUploadHandler — factory for the file upload ingestion endpoint.
  */
@@ -188,4 +192,4 @@ declare function createRagHandler(configOrPlugin?: Partial<RagConfig> | VectorPl
     POST: (req: any, context?: any) => Promise<any>;
 };
 
-export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, VectorPlugin as b, createChatHandler as c, createFeedbackHandler as d, createHealthHandler as e, createHistoryHandler as f, createIngestHandler as g, createRagHandler as h, createSessionsHandler as i, createStreamHandler as j, createUploadHandler as k, sseFrame as l, sseMetaFrame as m, sseTextFrame as n, type HandlerOptions as o, createSuggestionsHandler as p, sseObservabilityFrame as q, sseUIFrame as r, sseErrorFrame as s };
+export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, VectorPlugin as b, createChatHandler as c, createFeedbackHandler as d, createHealthHandler as e, createHistoryHandler as f, createIngestHandler as g, createRagHandler as h, createSessionsHandler as i, createStreamHandler as j, createUploadHandler as k, sseFrame as l, sseMetaFrame as m, sseTextFrame as n, type HandlerOptions as o, createLicenseHandler as p, createSuggestionsHandler as q, sseObservabilityFrame as r, sseErrorFrame as s, sseUIFrame as t };

package/dist/{index-B5TTZWkx.d.ts → index-Dmq5lH0j.d.mts}

@@ -1,5 +1,5 @@
 import { NextRequest } from 'next/server';
-import { i as RagConfig, I as ILLMProvider, C as ChatMessage, c as ChatResponse, f as IngestDocument } from './ILLMProvider-BWa68XX5.js';
+import { i as RagConfig, I as ILLMProvider, C as ChatMessage, c as ChatResponse, f as IngestDocument } from './ILLMProvider-teTNQ1lh.mjs';
 
 interface ValidationError {
     field: string;
@@ -158,6 +158,10 @@ declare function createIngestHandler(configOrPlugin?: Partial<RagConfig> | Vecto
  * createHealthHandler — factory for the health-check endpoint.
  */
 declare function createHealthHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req?: NextRequest) => Promise<any>;
+/**
+ * createLicenseHandler — factory for the license validation endpoint (/v1/license/validate).
+ */
+declare function createLicenseHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createUploadHandler — factory for the file upload ingestion endpoint.
  */
@@ -188,4 +192,4 @@ declare function createRagHandler(configOrPlugin?: Partial<RagConfig> | VectorPl
     POST: (req: any, context?: any) => Promise<any>;
 };
 
-export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, VectorPlugin as b, createChatHandler as c, createFeedbackHandler as d, createHealthHandler as e, createHistoryHandler as f, createIngestHandler as g, createRagHandler as h, createSessionsHandler as i, createStreamHandler as j, createUploadHandler as k, sseFrame as l, sseMetaFrame as m, sseTextFrame as n, type HandlerOptions as o, createSuggestionsHandler as p, sseObservabilityFrame as q, sseUIFrame as r, sseErrorFrame as s };
+export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, VectorPlugin as b, createChatHandler as c, createFeedbackHandler as d, createHealthHandler as e, createHistoryHandler as f, createIngestHandler as g, createRagHandler as h, createSessionsHandler as i, createStreamHandler as j, createUploadHandler as k, sseFrame as l, sseMetaFrame as m, sseTextFrame as n, type HandlerOptions as o, createLicenseHandler as p, createSuggestionsHandler as q, sseObservabilityFrame as r, sseErrorFrame as s, sseUIFrame as t };

package/dist/index.d.mts

@@ -1,13 +1,13 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as ChatWidgetProps, a as ChatWindowProps, D as DocumentUploadProps, M as MessageBubbleProps, S as SourceCardProps, b as ConfigProviderProps, c as ClientConfig, P as ProductCardProps, d as ProductCarouselProps } from './index-BbJGyNmW.mjs';
-export { A as AuthenticationException, e as ChartType, f as Chunk, g as ChunkOptions, h as ConfigurationException, i as DecisionContext, E as EmbeddingFailedException, I as IRenderRule, j as IRendererStrategy, k as IntentCategory, l as IntentClassifier, m as ProviderNotFoundException, R as RateLimitException, n as RenderDecision, o as RenderType, p as RendererRegistry, q as RetrievalException, r as Retrivora, s as RetrivoraError, t as RetrivoraErrorCode, u as RuleEngine, v as SDK_VERSION, V as VisualizationDecisionEngine, w as decideVisualization } from './index-BbJGyNmW.mjs';
-import { O as ObservabilityTrace, U as UseRagChatOptions, a as UseRagChatReturn } from './ILLMProvider-BWa68XX5.mjs';
-export { C as ChatMessage, b as ChatOptions, c as ChatResponse, E as EmbedOptions, d as EmbeddingConfig, e as EmbeddingProvider, I as ILLMProvider, f as IngestDocument, L as LLMConfig, g as LLMProvider, h as LatencyBreakdown, R as RAGConfig, i as RagConfig, j as RagMessage, k as RetrievalConfig, l as RetrievedChunk, T as TokenUsage, m as UIConfig, n as UniversalRagConfig, o as UpsertDocument, V as VectorDBConfig, p as VectorDBProvider, q as VectorMatch, W as WorkflowConfig } from './ILLMProvider-BWa68XX5.mjs';
+import { C as ChatWidgetProps, a as ChatWindowProps, D as DocumentUploadProps, M as MessageBubbleProps, S as SourceCardProps, b as ConfigProviderProps, c as ClientConfig, P as ProductCardProps, d as ProductCarouselProps } from './LicenseValidator-CENvo9o2.mjs';
+export { A as AuthenticationException, e as ChartType, f as Chunk, g as ChunkOptions, h as ConfigurationException, i as DecisionContext, E as EmbeddingFailedException, I as IRenderRule, j as IRendererStrategy, k as IntentCategory, l as IntentClassifier, L as LicenseValidationError, m as LicenseValidationRequest, n as LicenseValidationResponse, o as LicenseValidator, p as ProviderNotFoundException, R as RateLimitException, q as RenderDecision, r as RenderType, s as RendererRegistry, t as RetrievalException, u as Retrivora, v as RetrivoraError, w as RetrivoraErrorCode, x as RuleEngine, y as SDKVersionUnsupportedError, z as SDK_VERSION, V as VisualizationDecisionEngine, B as decideVisualization } from './LicenseValidator-CENvo9o2.mjs';
+import { O as ObservabilityTrace, U as UseRagChatOptions, a as UseRagChatReturn } from './ILLMProvider-teTNQ1lh.mjs';
+export { C as ChatMessage, b as ChatOptions, c as ChatResponse, E as EmbedOptions, d as EmbeddingConfig, e as EmbeddingProvider, I as ILLMProvider, f as IngestDocument, L as LLMConfig, g as LLMProvider, h as LatencyBreakdown, R as RAGConfig, i as RagConfig, j as RagMessage, k as RetrievalConfig, l as RetrievedChunk, T as TokenUsage, m as UIConfig, n as UniversalRagConfig, o as UpsertDocument, V as VectorDBConfig, p as VectorDBProvider, q as VectorMatch, W as WorkflowConfig } from './ILLMProvider-teTNQ1lh.mjs';
 import 'react';
 
-declare function ChatWidget({ position, onAddToCart, apiUrl, retrivoraApiBase, headers }: ChatWidgetProps): react_jsx_runtime.JSX.Element | null;
+declare function ChatWidget({ position, onAddToCart, apiUrl, retrivoraApiBase, licenseKey: licenseKeyProp, headers }: ChatWidgetProps): react_jsx_runtime.JSX.Element | null;
 
-declare function ChatWindow({ className, style, onClose, showClose, onResizeStart, onResetResize, isResized, onMaximize, isMaximized, onAddToCart, apiUrl, retrivoraApiBase, headers }: ChatWindowProps): react_jsx_runtime.JSX.Element;
+declare function ChatWindow({ className, style, onClose, showClose, onResizeStart, onResetResize, isResized, onMaximize, isMaximized, onAddToCart, apiUrl, retrivoraApiBase, licenseKey: licenseKeyProp, headers }: ChatWindowProps): react_jsx_runtime.JSX.Element;
 
 declare function DocumentUpload({ namespace, uploadUrl, retrivoraApiBase, onUploadComplete, className }: DocumentUploadProps): react_jsx_runtime.JSX.Element;
 

package/dist/index.d.ts

@@ -1,13 +1,13 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { C as ChatWidgetProps, a as ChatWindowProps, D as DocumentUploadProps, M as MessageBubbleProps, S as SourceCardProps, b as ConfigProviderProps, c as ClientConfig, P as ProductCardProps, d as ProductCarouselProps } from './index-BCbeeh74.js';
-export { A as AuthenticationException, e as ChartType, f as Chunk, g as ChunkOptions, h as ConfigurationException, i as DecisionContext, E as EmbeddingFailedException, I as IRenderRule, j as IRendererStrategy, k as IntentCategory, l as IntentClassifier, m as ProviderNotFoundException, R as RateLimitException, n as RenderDecision, o as RenderType, p as RendererRegistry, q as RetrievalException, r as Retrivora, s as RetrivoraError, t as RetrivoraErrorCode, u as RuleEngine, v as SDK_VERSION, V as VisualizationDecisionEngine, w as decideVisualization } from './index-BCbeeh74.js';
-import { O as ObservabilityTrace, U as UseRagChatOptions, a as UseRagChatReturn } from './ILLMProvider-BWa68XX5.js';
-export { C as ChatMessage, b as ChatOptions, c as ChatResponse, E as EmbedOptions, d as EmbeddingConfig, e as EmbeddingProvider, I as ILLMProvider, f as IngestDocument, L as LLMConfig, g as LLMProvider, h as LatencyBreakdown, R as RAGConfig, i as RagConfig, j as RagMessage, k as RetrievalConfig, l as RetrievedChunk, T as TokenUsage, m as UIConfig, n as UniversalRagConfig, o as UpsertDocument, V as VectorDBConfig, p as VectorDBProvider, q as VectorMatch, W as WorkflowConfig } from './ILLMProvider-BWa68XX5.js';
+import { C as ChatWidgetProps, a as ChatWindowProps, D as DocumentUploadProps, M as MessageBubbleProps, S as SourceCardProps, b as ConfigProviderProps, c as ClientConfig, P as ProductCardProps, d as ProductCarouselProps } from './LicenseValidator-CsjJp2PP.js';
+export { A as AuthenticationException, e as ChartType, f as Chunk, g as ChunkOptions, h as ConfigurationException, i as DecisionContext, E as EmbeddingFailedException, I as IRenderRule, j as IRendererStrategy, k as IntentCategory, l as IntentClassifier, L as LicenseValidationError, m as LicenseValidationRequest, n as LicenseValidationResponse, o as LicenseValidator, p as ProviderNotFoundException, R as RateLimitException, q as RenderDecision, r as RenderType, s as RendererRegistry, t as RetrievalException, u as Retrivora, v as RetrivoraError, w as RetrivoraErrorCode, x as RuleEngine, y as SDKVersionUnsupportedError, z as SDK_VERSION, V as VisualizationDecisionEngine, B as decideVisualization } from './LicenseValidator-CsjJp2PP.js';
+import { O as ObservabilityTrace, U as UseRagChatOptions, a as UseRagChatReturn } from './ILLMProvider-teTNQ1lh.js';
+export { C as ChatMessage, b as ChatOptions, c as ChatResponse, E as EmbedOptions, d as EmbeddingConfig, e as EmbeddingProvider, I as ILLMProvider, f as IngestDocument, L as LLMConfig, g as LLMProvider, h as LatencyBreakdown, R as RAGConfig, i as RagConfig, j as RagMessage, k as RetrievalConfig, l as RetrievedChunk, T as TokenUsage, m as UIConfig, n as UniversalRagConfig, o as UpsertDocument, V as VectorDBConfig, p as VectorDBProvider, q as VectorMatch, W as WorkflowConfig } from './ILLMProvider-teTNQ1lh.js';
 import 'react';
 
-declare function ChatWidget({ position, onAddToCart, apiUrl, retrivoraApiBase, headers }: ChatWidgetProps): react_jsx_runtime.JSX.Element | null;
+declare function ChatWidget({ position, onAddToCart, apiUrl, retrivoraApiBase, licenseKey: licenseKeyProp, headers }: ChatWidgetProps): react_jsx_runtime.JSX.Element | null;
 
-declare function ChatWindow({ className, style, onClose, showClose, onResizeStart, onResetResize, isResized, onMaximize, isMaximized, onAddToCart, apiUrl, retrivoraApiBase, headers }: ChatWindowProps): react_jsx_runtime.JSX.Element;
+declare function ChatWindow({ className, style, onClose, showClose, onResizeStart, onResetResize, isResized, onMaximize, isMaximized, onAddToCart, apiUrl, retrivoraApiBase, licenseKey: licenseKeyProp, headers }: ChatWindowProps): react_jsx_runtime.JSX.Element;
 
 declare function DocumentUpload({ namespace, uploadUrl, retrivoraApiBase, onUploadComplete, className }: DocumentUploadProps): react_jsx_runtime.JSX.Element;