@retrivora-ai/rag-engine 2.2.6 → 2.2.7

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

@@ -509,7 +509,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 +533,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-BCbeeh74.d.ts → LicenseValidator-D4I4pbSL.d.ts}

@@ -509,7 +509,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 +533,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.js

@@ -2281,8 +2281,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 +4709,7 @@ var ConfigValidator = class {
 // package.json
 var package_default = {
   name: "@retrivora-ai/rag-engine",
-  version: "2.2.6",
+  version: "2.2.7",
   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 +10512,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 {

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.7",
   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 {

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 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 { 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-B3xpJaVf.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-B3xpJaVf.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 'react';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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 { 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-D4I4pbSL.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-D4I4pbSL.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 'react';

package/dist/index.js

@@ -69,6 +69,8 @@ __export(index_exports, {
   DocumentUpload: () => DocumentUpload,
   EmbeddingFailedException: () => EmbeddingFailedException,
   IntentClassifier: () => IntentClassifier,
+  LicenseValidationError: () => LicenseValidationError,
+  LicenseValidator: () => LicenseValidator,
   MessageBubble: () => MessageBubble,
   ObservabilityPanel: () => ObservabilityPanel,
   ProductCard: () => ProductCard,
@@ -79,6 +81,7 @@ __export(index_exports, {
   RetrievalException: () => RetrievalException,
   RetrivoraError: () => RetrivoraError,
   RuleEngine: () => RuleEngine,
+  SDKVersionUnsupportedError: () => SDKVersionUnsupportedError,
   SDK_VERSION: () => SDK_VERSION,
   SourceCard: () => SourceCard,
   VisualizationDecisionEngine: () => VisualizationDecisionEngine,
@@ -2917,7 +2920,10 @@ function useRagChat(projectId, options = {}) {
           console.log("[useRagChat] Streaming stopped by user.");
           return;
         }
-        const msg = err instanceof Error ? err.message : "Something went wrong. Please try again.";
+        let msg = err instanceof Error ? err.message : "Something went wrong. Please try again.";
+        if (msg.includes("403") || msg.toLowerCase().includes("license") || msg.toLowerCase().includes("revoked") || msg.toLowerCase().includes("terminated")) {
+          msg = "Your Retrivora license key has been terminated, suspended, or revoked. Access denied.";
+        }
         setError(msg);
         onError == null ? void 0 : onError(msg);
       } finally {
@@ -3029,7 +3035,7 @@ function useRagChat(projectId, options = {}) {
 // package.json
 var package_default = {
   name: "@retrivora-ai/rag-engine",
-  version: "2.2.6",
+  version: "2.2.7",
   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",
@@ -3169,6 +3175,158 @@ var package_default = {
 // src/version.ts
 var SDK_VERSION = package_default.version || "2.1.3";
 
+// src/exceptions/index.ts
+var RetrivoraError = class extends Error {
+  constructor(message, code, details) {
+    super(message);
+    this.name = new.target.name;
+    this.code = code;
+    this.details = details;
+  }
+};
+var ProviderNotFoundException = class extends RetrivoraError {
+  constructor(providerType, provider, details) {
+    super(`Unsupported ${providerType} provider: ${provider}`, "PROVIDER_NOT_FOUND", details);
+  }
+};
+var EmbeddingFailedException = class extends RetrivoraError {
+  constructor(message = "Embedding generation failed", details) {
+    super(message, "EMBEDDING_FAILED", details);
+  }
+};
+var RetrievalException = class extends RetrivoraError {
+  constructor(message = "Retrieval failed", details) {
+    super(message, "RETRIEVAL_FAILED", details);
+  }
+};
+var RateLimitException = class extends RetrivoraError {
+  constructor(message = "Provider rate limit exceeded", details) {
+    super(message, "RATE_LIMITED", details);
+  }
+};
+var ConfigurationException = class extends RetrivoraError {
+  constructor(message, details) {
+    super(message, "CONFIGURATION_ERROR", details);
+  }
+};
+var AuthenticationException = class extends RetrivoraError {
+  constructor(message = "Provider authentication failed", details) {
+    super(message, "AUTHENTICATION_ERROR", details);
+  }
+};
+var SDKVersionUnsupportedError = class extends RetrivoraError {
+  constructor(message = "This SDK version is no longer supported.", details) {
+    super(message, "SDK_VERSION_UNSUPPORTED", details);
+  }
+};
+var LicenseValidationError = class extends RetrivoraError {
+  constructor(message = "License validation failed.", details) {
+    super(message, "LICENSE_VALIDATION_ERROR", details);
+  }
+};
+
+// src/core/LicenseValidator.ts
+var _LicenseValidator = class _LicenseValidator {
+  // 5-minute TTL for successful validation only
+  constructor() {
+    this.cache = /* @__PURE__ */ new Map();
+  }
+  static getInstance() {
+    if (!_LicenseValidator.instance) {
+      _LicenseValidator.instance = new _LicenseValidator();
+    }
+    return _LicenseValidator.instance;
+  }
+  /**
+   * Invalidate local validation cache for a license key
+   */
+  purgeCache(licenseKey) {
+    if (licenseKey) {
+      this.cache.delete(licenseKey);
+    } else {
+      this.cache.clear();
+    }
+  }
+  /**
+   * Validate license status and SDK version against Retrivora License Service
+   */
+  async validate(request) {
+    const {
+      licenseKey,
+      projectId,
+      sdkVersion = SDK_VERSION,
+      sdk = "@retrivora-ai/rag-engine",
+      platform = typeof window !== "undefined" ? "browser" : "node",
+      retrivoraApiBase,
+      headers: customHeaders
+    } = request;
+    if (!licenseKey) {
+      this.purgeCache(licenseKey);
+      throw new LicenseValidationError("Missing RETRIVORA_LICENSE_KEY in request.");
+    }
+    const cached = this.cache.get(licenseKey);
+    if (cached) {
+      const isFresh = Date.now() - cached.timestamp < _LicenseValidator.SUCCESS_CACHE_TTL_MS;
+      if (isFresh && cached.response.valid && cached.response.licenseStatus === "ACTIVE" && !cached.response.forceUpgrade) {
+        return cached.response;
+      } else {
+        this.cache.delete(licenseKey);
+      }
+    }
+    const base = retrivoraApiBase || (typeof process !== "undefined" ? process.env.NEXT_PUBLIC_RETRIVORA_API_BASE || process.env.RETRIVORA_API_BASE : "") || "/api/retrivora";
+    const validateUrl = `${base.replace(/\/$/, "")}/v1/license/validate`;
+    let res;
+    try {
+      res = await fetch(validateUrl, {
+        method: "POST",
+        cache: "no-store",
+        headers: __spreadValues({
+          "Content-Type": "application/json",
+          "x-license-key": licenseKey,
+          "x-sdk-version": sdkVersion
+        }, customHeaders || {}),
+        body: JSON.stringify({
+          licenseKey,
+          projectId,
+          sdkVersion,
+          sdk,
+          platform
+        })
+      });
+    } catch (err) {
+      this.purgeCache(licenseKey);
+      throw new LicenseValidationError(`License validation request failed: ${(err == null ? void 0 : err.message) || "Network error"}`);
+    }
+    const data = await res.json().catch(() => ({
+      valid: false,
+      licenseStatus: "REVOKED",
+      minimumSupportedVersion: "2.1.0",
+      latestVersion: SDK_VERSION,
+      forceUpgrade: false,
+      expiresAt: null,
+      message: "Failed to parse license validation response."
+    }));
+    if (!res.ok || !data.valid || data.licenseStatus !== "ACTIVE" || data.forceUpgrade) {
+      this.purgeCache(licenseKey);
+      if (data.forceUpgrade || res.status === 426) {
+        throw new SDKVersionUnsupportedError(
+          data.message || `This SDK version (${sdkVersion}) is no longer supported. Upgrade to version ${data.latestVersion || "2.2.6"} or later.`,
+          data
+        );
+      }
+      const errMsg = data.message || `License validation failed with status: ${data.licenseStatus}. Access denied.`;
+      throw new LicenseValidationError(errMsg, data);
+    }
+    this.cache.set(licenseKey, {
+      response: data,
+      timestamp: Date.now()
+    });
+    return data;
+  }
+};
+_LicenseValidator.SUCCESS_CACHE_TTL_MS = 5 * 60 * 1e3;
+var LicenseValidator = _LicenseValidator;
+
 // src/components/ChatWindow.tsx
 var import_jsx_runtime13 = require("react/jsx-runtime");
 function ChatWindow({
@@ -3212,42 +3370,32 @@ function ChatWindow({
     async function validateSessionLicense() {
       var _a2;
       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: __spreadValues({
-            "Content-Type": "application/json",
-            "x-sdk-version": SDK_VERSION
-          }, headers || {})
+        const licenseKey = (headers == null ? void 0 : headers["x-license-key"]) || ((_a2 = headers == null ? void 0 : headers["authorization"]) == null ? void 0 : _a2.replace(/^Bearer\s+/i, "")) || "";
+        await LicenseValidator.getInstance().validate({
+          licenseKey,
+          projectId,
+          retrivoraApiBase,
+          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 : ((_a2 = data.error) == null ? void 0 : _a2.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);
+        if (isMounted) {
+          setLicenseError(null);
+          setVersionError(null);
+        }
+      } catch (err) {
+        if (isMounted) {
+          if ((err == null ? void 0 : err.code) === "SDK_VERSION_UNSUPPORTED") {
+            setVersionError((err == null ? void 0 : err.message) || "SDK version unsupported.");
+          } else {
+            setLicenseError((err == null ? void 0 : err.message) || "License validation failed.");
           }
         }
-      } catch (e) {
       }
     }
     validateSessionLicense();
     return () => {
       isMounted = false;
     };
-  }, [retrivoraApiBase, headers]);
+  }, [retrivoraApiBase, headers, projectId]);
   (0, import_react12.useEffect)(() => {
     if (typeof window !== "undefined") {
       const win = window;
@@ -3696,7 +3844,7 @@ var GEMINI_STYLES = `
   }
 `;
 function ChatWidget({ position = "bottom-right", onAddToCart, apiUrl, retrivoraApiBase, headers }) {
-  const { ui } = useConfig();
+  const { ui, projectId } = useConfig();
   const [isOpen, setIsOpen] = (0, import_react13.useState)(false);
   const [hasUnread, setHasUnread] = (0, import_react13.useState)(false);
   const [dimensions, setDimensions] = (0, import_react13.useState)(DEFAULT_DIMENSIONS);
@@ -3712,36 +3860,19 @@ function ChatWidget({ position = "bottom-right", onAddToCart, apiUrl, retrivoraA
     var _a;
     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: __spreadValues({
-          "Content-Type": "application/json",
-          "x-sdk-version": SDK_VERSION
-        }, headers || {})
+      const licenseKey = (headers == null ? void 0 : headers["x-license-key"]) || ((_a = headers == null ? void 0 : headers["authorization"]) == null ? void 0 : _a.replace(/^Bearer\s+/i, "")) || "";
+      await LicenseValidator.getInstance().validate({
+        licenseKey,
+        projectId,
+        retrivoraApiBase,
+        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);
-          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 : (_a = data.error) == null ? void 0 : _a.message) || "Your Retrivora license is no longer valid. Please contact your administrator or obtain a valid license key.";
-          setWidgetError(msg);
-          setIsOpen(false);
-          return;
-        }
-      }
       setWidgetError(null);
       setIsOpen(true);
       setHasUnread(false);
-    } catch (e) {
-      setIsOpen(true);
+    } catch (err) {
+      setWidgetError((err == null ? void 0 : err.message) || "Access denied.");
+      setIsOpen(false);
     } finally {
       setIsValidating(false);
     }
@@ -5880,46 +6011,6 @@ _RendererRegistry.registerStrategy(new CarouselRendererStrategy());
 _RendererRegistry.registerStrategy(new ChartRendererStrategy());
 _RendererRegistry.registerStrategy(new MixedRendererStrategy());
 var RendererRegistry = _RendererRegistry;
-
-// src/exceptions/index.ts
-var RetrivoraError = class extends Error {
-  constructor(message, code, details) {
-    super(message);
-    this.name = new.target.name;
-    this.code = code;
-    this.details = details;
-  }
-};
-var ProviderNotFoundException = class extends RetrivoraError {
-  constructor(providerType, provider, details) {
-    super(`Unsupported ${providerType} provider: ${provider}`, "PROVIDER_NOT_FOUND", details);
-  }
-};
-var EmbeddingFailedException = class extends RetrivoraError {
-  constructor(message = "Embedding generation failed", details) {
-    super(message, "EMBEDDING_FAILED", details);
-  }
-};
-var RetrievalException = class extends RetrivoraError {
-  constructor(message = "Retrieval failed", details) {
-    super(message, "RETRIEVAL_FAILED", details);
-  }
-};
-var RateLimitException = class extends RetrivoraError {
-  constructor(message = "Provider rate limit exceeded", details) {
-    super(message, "RATE_LIMITED", details);
-  }
-};
-var ConfigurationException = class extends RetrivoraError {
-  constructor(message, details) {
-    super(message, "CONFIGURATION_ERROR", details);
-  }
-};
-var AuthenticationException = class extends RetrivoraError {
-  constructor(message = "Provider authentication failed", details) {
-    super(message, "AUTHENTICATION_ERROR", details);
-  }
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthenticationException,
@@ -5931,6 +6022,8 @@ var AuthenticationException = class extends RetrivoraError {
   DocumentUpload,
   EmbeddingFailedException,
   IntentClassifier,
+  LicenseValidationError,
+  LicenseValidator,
   MessageBubble,
   ObservabilityPanel,
   ProductCard,
@@ -5941,6 +6034,7 @@ var AuthenticationException = class extends RetrivoraError {
   RetrievalException,
   RetrivoraError,
   RuleEngine,
+  SDKVersionUnsupportedError,
   SDK_VERSION,
   SourceCard,
   VisualizationDecisionEngine,