@retrivora-ai/rag-engine 1.9.9 → 2.0.0

package/dist/handlers/index.mjs

@@ -2127,46 +2127,48 @@ function readEnum(env, name, fallback, allowed) {
   throw new Error(`[getRagConfig] ${name} must be one of: ${allowed.join(", ")}`);
 }
 function getEnvConfig(env = process.env, base) {
-  var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca, _da, _ea, _fa, _ga, _ha, _ia, _ja, _ka, _la, _ma, _na, _oa, _pa, _qa, _ra, _sa, _ta, _ua, _va, _wa, _xa, _ya, _za, _Aa, _Ba, _Ca, _Da, _Ea, _Fa, _Ga, _Ha, _Ia, _Ja, _Ka, _La, _Ma, _Na, _Oa, _Pa, _Qa;
+  var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C, _D, _E, _F, _G, _H, _I, _J, _K, _L, _M, _N, _O, _P, _Q, _R, _S, _T, _U, _V, _W, _X, _Y, _Z, __, _$, _aa, _ba, _ca, _da, _ea, _fa, _ga, _ha, _ia, _ja, _ka, _la, _ma, _na, _oa, _pa, _qa, _ra, _sa, _ta, _ua, _va, _wa, _xa, _ya, _za, _Aa, _Ba, _Ca, _Da, _Ea, _Fa, _Ga, _Ha, _Ia, _Ja, _Ka, _La, _Ma, _Na, _Oa, _Pa, _Qa, _Ra, _Sa, _Ta, _Ua;
   const projectId = (_c = (_b = (_a2 = readString(env, "RAG_PROJECT_ID")) != null ? _a2 : readString(env, "NEXT_PUBLIC_PROJECT_ID")) != null ? _b : base == null ? void 0 : base.projectId) != null ? _c : "__default__";
+  const licenseKey = (_g2 = (_f = (_e = (_d = readString(env, "RAG_LICENSE_KEY")) != null ? _d : readString(env, "RETRIVORA_LICENSE_KEY")) != null ? _e : readString(env, "NEXT_PUBLIC_RETRIVORA_LICENSE_KEY")) != null ? _f : readString(env, "LICENSE_KEY")) != null ? _g2 : base == null ? void 0 : base.licenseKey;
+  const telemetryEnabled = readString(env, "TELEMETRY_ENABLED") === "true" || readString(env, "NEXT_PUBLIC_TELEMETRY_ENABLED") === "true" || ((_h = base == null ? void 0 : base.telemetry) == null ? void 0 : _h.enabled) || Boolean(licenseKey);
   const vectorProvider = readEnum(env, "VECTOR_DB_PROVIDER", "pinecone", VECTOR_DB_PROVIDERS);
   const llmProvider = readEnum(env, "LLM_PROVIDER", "openai", LLM_PROVIDERS);
   const embeddingProvider = readEnum(env, "EMBEDDING_PROVIDER", "openai", EMBEDDING_PROVIDERS);
   const embeddingDimensions = readNumber(env, "EMBEDDING_DIMENSIONS", 1536);
   const vectorDbOptions = {};
   if (vectorProvider === "pinecone") {
-    vectorDbOptions.apiKey = (_g2 = (_f = readString(env, "PINECONE_API_KEY")) != null ? _f : (_e = (_d = base == null ? void 0 : base.vectorDb) == null ? void 0 : _d.options) == null ? void 0 : _e.apiKey) != null ? _g2 : "";
-    vectorDbOptions.indexName = (_l = (_i = readString(env, "PINECONE_INDEX")) != null ? _i : (_h = base == null ? void 0 : base.vectorDb) == null ? void 0 : _h.indexName) != null ? _l : (_k = (_j = base == null ? void 0 : base.vectorDb) == null ? void 0 : _j.options) == null ? void 0 : _k.indexName;
+    vectorDbOptions.apiKey = (_l = (_k = readString(env, "PINECONE_API_KEY")) != null ? _k : (_j = (_i = base == null ? void 0 : base.vectorDb) == null ? void 0 : _i.options) == null ? void 0 : _j.apiKey) != null ? _l : "";
+    vectorDbOptions.indexName = (_q = (_n = readString(env, "PINECONE_INDEX")) != null ? _n : (_m = base == null ? void 0 : base.vectorDb) == null ? void 0 : _m.indexName) != null ? _q : (_p = (_o = base == null ? void 0 : base.vectorDb) == null ? void 0 : _o.options) == null ? void 0 : _p.indexName;
   } else if (vectorProvider === "pgvector" || vectorProvider === "postgresql") {
-    vectorDbOptions.connectionString = (_q = (_p = (_m = readString(env, "PGVECTOR_CONNECTION_STRING")) != null ? _m : readString(env, "POSTGRES_URL")) != null ? _p : (_o = (_n = base == null ? void 0 : base.vectorDb) == null ? void 0 : _n.options) == null ? void 0 : _o.connectionString) != null ? _q : "";
-    vectorDbOptions.tables = (_v = (_s = (_r = readString(env, "VECTOR_DB_TABLES")) != null ? _r : readString(env, "POSTGRES_TABLES")) == null ? void 0 : _s.split(",").map((t) => t.trim())) != null ? _v : (_u = (_t = base == null ? void 0 : base.vectorDb) == null ? void 0 : _t.options) == null ? void 0 : _u.tables;
-    vectorDbOptions.searchFields = (_z = (_w = readString(env, "POSTGRES_SEARCH_FIELDS")) == null ? void 0 : _w.split(",").map((f) => f.trim())) != null ? _z : (_y = (_x = base == null ? void 0 : base.vectorDb) == null ? void 0 : _x.options) == null ? void 0 : _y.searchFields;
+    vectorDbOptions.connectionString = (_v = (_u = (_r = readString(env, "PGVECTOR_CONNECTION_STRING")) != null ? _r : readString(env, "POSTGRES_URL")) != null ? _u : (_t = (_s = base == null ? void 0 : base.vectorDb) == null ? void 0 : _s.options) == null ? void 0 : _t.connectionString) != null ? _v : "";
+    vectorDbOptions.tables = (_A = (_x = (_w = readString(env, "VECTOR_DB_TABLES")) != null ? _w : readString(env, "POSTGRES_TABLES")) == null ? void 0 : _x.split(",").map((t) => t.trim())) != null ? _A : (_z = (_y = base == null ? void 0 : base.vectorDb) == null ? void 0 : _y.options) == null ? void 0 : _z.tables;
+    vectorDbOptions.searchFields = (_E = (_B = readString(env, "POSTGRES_SEARCH_FIELDS")) == null ? void 0 : _B.split(",").map((f) => f.trim())) != null ? _E : (_D = (_C = base == null ? void 0 : base.vectorDb) == null ? void 0 : _C.options) == null ? void 0 : _D.searchFields;
     vectorDbOptions.dimensions = embeddingDimensions;
   } else if (vectorProvider === "mongodb") {
-    vectorDbOptions.uri = (_D = (_C = readString(env, "MONGODB_URI")) != null ? _C : (_B = (_A = base == null ? void 0 : base.vectorDb) == null ? void 0 : _A.options) == null ? void 0 : _B.uri) != null ? _D : "";
-    vectorDbOptions.database = (_H = (_G = readString(env, "MONGODB_DB")) != null ? _G : (_F = (_E = base == null ? void 0 : base.vectorDb) == null ? void 0 : _E.options) == null ? void 0 : _F.database) != null ? _H : "";
-    vectorDbOptions.collection = (_L = (_K = readString(env, "MONGODB_COLLECTION")) != null ? _K : (_J = (_I = base == null ? void 0 : base.vectorDb) == null ? void 0 : _I.options) == null ? void 0 : _J.collection) != null ? _L : "";
-    vectorDbOptions.indexName = (_R = (_Q = (_N = readString(env, "MONGODB_INDEX_NAME")) != null ? _N : (_M = base == null ? void 0 : base.vectorDb) == null ? void 0 : _M.indexName) != null ? _Q : (_P = (_O = base == null ? void 0 : base.vectorDb) == null ? void 0 : _O.options) == null ? void 0 : _P.indexName) != null ? _R : "vector_index";
+    vectorDbOptions.uri = (_I = (_H = readString(env, "MONGODB_URI")) != null ? _H : (_G = (_F = base == null ? void 0 : base.vectorDb) == null ? void 0 : _F.options) == null ? void 0 : _G.uri) != null ? _I : "";
+    vectorDbOptions.database = (_M = (_L = readString(env, "MONGODB_DB")) != null ? _L : (_K = (_J = base == null ? void 0 : base.vectorDb) == null ? void 0 : _J.options) == null ? void 0 : _K.database) != null ? _M : "";
+    vectorDbOptions.collection = (_Q = (_P = readString(env, "MONGODB_COLLECTION")) != null ? _P : (_O = (_N = base == null ? void 0 : base.vectorDb) == null ? void 0 : _N.options) == null ? void 0 : _O.collection) != null ? _Q : "";
+    vectorDbOptions.indexName = (_W = (_V = (_S = readString(env, "MONGODB_INDEX_NAME")) != null ? _S : (_R = base == null ? void 0 : base.vectorDb) == null ? void 0 : _R.indexName) != null ? _V : (_U = (_T = base == null ? void 0 : base.vectorDb) == null ? void 0 : _T.options) == null ? void 0 : _U.indexName) != null ? _W : "vector_index";
   } else if (vectorProvider === "qdrant") {
-    vectorDbOptions.baseUrl = (_V = (_U = readString(env, "QDRANT_URL")) != null ? _U : (_T = (_S = base == null ? void 0 : base.vectorDb) == null ? void 0 : _S.options) == null ? void 0 : _T.baseUrl) != null ? _V : "http://localhost:6333";
-    vectorDbOptions.apiKey = (_Y = readString(env, "QDRANT_API_KEY")) != null ? _Y : (_X = (_W = base == null ? void 0 : base.vectorDb) == null ? void 0 : _W.options) == null ? void 0 : _X.apiKey;
+    vectorDbOptions.baseUrl = (__ = (_Z = readString(env, "QDRANT_URL")) != null ? _Z : (_Y = (_X = base == null ? void 0 : base.vectorDb) == null ? void 0 : _X.options) == null ? void 0 : _Y.baseUrl) != null ? __ : "http://localhost:6333";
+    vectorDbOptions.apiKey = (_ba = readString(env, "QDRANT_API_KEY")) != null ? _ba : (_aa = (_$ = base == null ? void 0 : base.vectorDb) == null ? void 0 : _$.options) == null ? void 0 : _aa.apiKey;
     vectorDbOptions.dimensions = embeddingDimensions;
   } else if (vectorProvider === "milvus") {
-    vectorDbOptions.baseUrl = (_Z = readString(env, "MILVUS_URL")) != null ? _Z : "http://localhost:19530";
+    vectorDbOptions.baseUrl = (_ca = readString(env, "MILVUS_URL")) != null ? _ca : "http://localhost:19530";
     vectorDbOptions.apiKey = readString(env, "MILVUS_API_KEY");
   } else if (vectorProvider === "chromadb") {
-    vectorDbOptions.baseUrl = (__ = readString(env, "CHROMADB_URL")) != null ? __ : "http://localhost:8000";
+    vectorDbOptions.baseUrl = (_da = readString(env, "CHROMADB_URL")) != null ? _da : "http://localhost:8000";
   } else if (vectorProvider === "weaviate") {
-    vectorDbOptions.baseUrl = (_$ = readString(env, "WEAVIATE_URL")) != null ? _$ : "http://localhost:8080";
+    vectorDbOptions.baseUrl = (_ea = readString(env, "WEAVIATE_URL")) != null ? _ea : "http://localhost:8080";
     vectorDbOptions.apiKey = readString(env, "WEAVIATE_API_KEY");
   } else if (vectorProvider === "redis") {
-    vectorDbOptions.baseUrl = (_aa = readString(env, "REDIS_URL")) != null ? _aa : "";
+    vectorDbOptions.baseUrl = (_fa = readString(env, "REDIS_URL")) != null ? _fa : "";
     vectorDbOptions.apiKey = readString(env, "REDIS_API_KEY");
   } else if (vectorProvider === "rest") {
-    vectorDbOptions.baseUrl = (_ba = readString(env, "VECTOR_DB_REST_URL")) != null ? _ba : "";
+    vectorDbOptions.baseUrl = (_ga = readString(env, "VECTOR_DB_REST_URL")) != null ? _ga : "";
     vectorDbOptions.headers = readString(env, "VECTOR_DB_REST_API_KEY") ? { "api-key": readString(env, "VECTOR_DB_REST_API_KEY") } : {};
   } else if (vectorProvider === "universal_rest") {
-    vectorDbOptions.baseUrl = (_da = (_ca = readString(env, "VECTOR_BASE_URL")) != null ? _ca : readString(env, "VECTOR_DB_REST_URL")) != null ? _da : "";
+    vectorDbOptions.baseUrl = (_ia = (_ha = readString(env, "VECTOR_BASE_URL")) != null ? _ha : readString(env, "VECTOR_DB_REST_URL")) != null ? _ia : "";
     vectorDbOptions.profile = readString(env, "VECTOR_UNIVERSAL_PROFILE");
     vectorDbOptions.headers = readString(env, "VECTOR_DB_REST_API_KEY") ? { Authorization: `Bearer ${readString(env, "VECTOR_DB_REST_API_KEY")}` } : {};
   }
@@ -2185,8 +2187,8 @@ function getEnvConfig(env = process.env, base) {
     // Anthropic needs a separate embedding provider; key kept for completeness
     gemini: readString(env, "GEMINI_API_KEY"),
     ollama: void 0,
-    universal_rest: (_ea = readString(env, "EMBEDDING_API_KEY")) != null ? _ea : readString(env, "OPENAI_API_KEY"),
-    custom: (_fa = readString(env, "EMBEDDING_API_KEY")) != null ? _fa : readString(env, "OPENAI_API_KEY")
+    universal_rest: (_ja = readString(env, "EMBEDDING_API_KEY")) != null ? _ja : readString(env, "OPENAI_API_KEY"),
+    custom: (_ka = readString(env, "EMBEDDING_API_KEY")) != null ? _ka : readString(env, "OPENAI_API_KEY")
   };
   const DEFAULT_MODEL_BY_PROVIDER = {
     openai: "gpt-4o",
@@ -2199,16 +2201,16 @@ function getEnvConfig(env = process.env, base) {
   };
   return __spreadProps(__spreadValues({
     projectId,
-    licenseKey: (_ha = (_ga = readString(env, "RETRIVORA_LICENSE_KEY")) != null ? _ga : readString(env, "LICENSE_KEY")) != null ? _ha : base == null ? void 0 : base.licenseKey,
+    licenseKey: (_ma = (_la = readString(env, "RETRIVORA_LICENSE_KEY")) != null ? _la : readString(env, "LICENSE_KEY")) != null ? _ma : base == null ? void 0 : base.licenseKey,
     vectorDb: {
       provider: vectorProvider,
-      indexName: (_ja = (_ia = readString(env, "VECTOR_DB_INDEX")) != null ? _ia : vectorDbOptions.indexName) != null ? _ja : "rag-index",
+      indexName: (_oa = (_na = readString(env, "VECTOR_DB_INDEX")) != null ? _na : vectorDbOptions.indexName) != null ? _oa : "rag-index",
       options: vectorDbOptions
     },
     llm: {
       provider: llmProvider,
-      model: (_la = (_ka = readString(env, "LLM_MODEL")) != null ? _ka : DEFAULT_MODEL_BY_PROVIDER[llmProvider]) != null ? _la : "gpt-4o",
-      apiKey: (_ma = llmApiKeyByProvider[llmProvider]) != null ? _ma : "",
+      model: (_qa = (_pa = readString(env, "LLM_MODEL")) != null ? _pa : DEFAULT_MODEL_BY_PROVIDER[llmProvider]) != null ? _qa : "gpt-4o",
+      apiKey: (_ra = llmApiKeyByProvider[llmProvider]) != null ? _ra : "",
       baseUrl: readString(env, "LLM_BASE_URL"),
       systemPrompt: readString(env, "LLM_SYSTEM_PROMPT"),
       maxTokens: readNumber(env, "LLM_MAX_TOKENS", 4096),
@@ -2221,7 +2223,7 @@ function getEnvConfig(env = process.env, base) {
     },
     embedding: {
       provider: embeddingProvider,
-      model: (_na = readString(env, "EMBEDDING_MODEL")) != null ? _na : "text-embedding-3-small",
+      model: (_sa = readString(env, "EMBEDDING_MODEL")) != null ? _sa : "text-embedding-3-small",
       apiKey: embeddingApiKeyByProvider[embeddingProvider],
       baseUrl: readString(env, "EMBEDDING_BASE_URL"),
       dimensions: embeddingDimensions,
@@ -2232,30 +2234,30 @@ function getEnvConfig(env = process.env, base) {
       }
     },
     ui: {
-      title: (_pa = (_oa = readString(env, "NEXT_PUBLIC_UI_TITLE")) != null ? _oa : readString(env, "UI_TITLE")) != null ? _pa : "AI Assistant",
-      subtitle: (_ra = (_qa = readString(env, "NEXT_PUBLIC_UI_SUBTITLE")) != null ? _qa : readString(env, "UI_SUBTITLE")) != null ? _ra : "Powered by RAG",
-      primaryColor: (_ta = (_sa = readString(env, "NEXT_PUBLIC_PRIMARY_COLOR")) != null ? _sa : readString(env, "UI_PRIMARY_COLOR")) != null ? _ta : "#10b981",
-      accentColor: (_va = (_ua = readString(env, "NEXT_PUBLIC_ACCENT_COLOR")) != null ? _ua : readString(env, "UI_ACCENT_COLOR")) != null ? _va : "#3b82f6",
-      logoUrl: (_wa = readString(env, "NEXT_PUBLIC_LOGO_URL")) != null ? _wa : readString(env, "UI_LOGO_URL"),
-      placeholder: (_ya = (_xa = readString(env, "NEXT_PUBLIC_PLACEHOLDER")) != null ? _xa : readString(env, "UI_PLACEHOLDER")) != null ? _ya : "Ask me anything\u2026",
-      showSources: ((_Aa = (_za = readString(env, "NEXT_PUBLIC_SHOW_SOURCES")) != null ? _za : readString(env, "UI_SHOW_SOURCES")) != null ? _Aa : "true") !== "false",
-      welcomeMessage: (_Ca = (_Ba = readString(env, "NEXT_PUBLIC_WELCOME_MESSAGE")) != null ? _Ba : readString(env, "UI_WELCOME_MESSAGE")) != null ? _Ca : "Hello! I'm your AI assistant. Ask me anything about your documents.",
-      visualStyle: (_Ea = (_Da = readString(env, "NEXT_PUBLIC_UI_VISUAL_STYLE")) != null ? _Da : readString(env, "UI_VISUAL_STYLE")) != null ? _Ea : "glass",
-      borderRadius: (_Ga = (_Fa = readString(env, "NEXT_PUBLIC_UI_BORDER_RADIUS")) != null ? _Fa : readString(env, "UI_BORDER_RADIUS")) != null ? _Ga : "xl",
-      allowUpload: ((_Ia = (_Ha = readString(env, "NEXT_PUBLIC_ALLOW_UPLOAD")) != null ? _Ha : readString(env, "UI_ALLOW_UPLOAD")) != null ? _Ia : "false") === "true"
+      title: (_ua = (_ta = readString(env, "NEXT_PUBLIC_UI_TITLE")) != null ? _ta : readString(env, "UI_TITLE")) != null ? _ua : "AI Assistant",
+      subtitle: (_wa = (_va = readString(env, "NEXT_PUBLIC_UI_SUBTITLE")) != null ? _va : readString(env, "UI_SUBTITLE")) != null ? _wa : "Powered by RAG",
+      primaryColor: (_ya = (_xa = readString(env, "NEXT_PUBLIC_PRIMARY_COLOR")) != null ? _xa : readString(env, "UI_PRIMARY_COLOR")) != null ? _ya : "#10b981",
+      accentColor: (_Aa = (_za = readString(env, "NEXT_PUBLIC_ACCENT_COLOR")) != null ? _za : readString(env, "UI_ACCENT_COLOR")) != null ? _Aa : "#3b82f6",
+      logoUrl: (_Ba = readString(env, "NEXT_PUBLIC_LOGO_URL")) != null ? _Ba : readString(env, "UI_LOGO_URL"),
+      placeholder: (_Da = (_Ca = readString(env, "NEXT_PUBLIC_PLACEHOLDER")) != null ? _Ca : readString(env, "UI_PLACEHOLDER")) != null ? _Da : "Ask me anything\u2026",
+      showSources: ((_Fa = (_Ea = readString(env, "NEXT_PUBLIC_SHOW_SOURCES")) != null ? _Ea : readString(env, "UI_SHOW_SOURCES")) != null ? _Fa : "true") !== "false",
+      welcomeMessage: (_Ha = (_Ga = readString(env, "NEXT_PUBLIC_WELCOME_MESSAGE")) != null ? _Ga : readString(env, "UI_WELCOME_MESSAGE")) != null ? _Ha : "Hello! I'm your AI assistant. Ask me anything about your documents.",
+      visualStyle: (_Ja = (_Ia = readString(env, "NEXT_PUBLIC_UI_VISUAL_STYLE")) != null ? _Ia : readString(env, "UI_VISUAL_STYLE")) != null ? _Ja : "glass",
+      borderRadius: (_La = (_Ka = readString(env, "NEXT_PUBLIC_UI_BORDER_RADIUS")) != null ? _Ka : readString(env, "UI_BORDER_RADIUS")) != null ? _La : "xl",
+      allowUpload: ((_Na = (_Ma = readString(env, "NEXT_PUBLIC_ALLOW_UPLOAD")) != null ? _Ma : readString(env, "UI_ALLOW_UPLOAD")) != null ? _Na : "false") === "true"
     },
     rag: {
       topK: readNumber(env, "RAG_TOP_K", 5),
       scoreThreshold: readNumber(env, "RAG_SCORE_THRESHOLD", 0),
       chunkSize: readNumber(env, "RAG_CHUNK_SIZE", 1e3),
       chunkOverlap: readNumber(env, "RAG_CHUNK_OVERLAP", 200),
-      filterableFields: (_Ja = readString(env, "RAG_FILTERABLE_FIELDS")) == null ? void 0 : _Ja.split(",").map((f) => f.trim()),
+      filterableFields: (_Oa = readString(env, "RAG_FILTERABLE_FIELDS")) == null ? void 0 : _Oa.split(",").map((f) => f.trim()),
       // Query pipeline toggles — read from .env.local
       useQueryTransformation: readString(env, "RAG_USE_QUERY_TRANSFORMATION") === "true",
       useReranking: readString(env, "RAG_USE_RERANKING") === "true",
       useGraphRetrieval: readString(env, "RAG_USE_GRAPH_RETRIEVAL") === "true",
-      architecture: (_Ka = readString(env, "RAG_ARCHITECTURE")) != null ? _Ka : "simple",
-      chunkingStrategy: (_La = readString(env, "RAG_CHUNKING_STRATEGY")) != null ? _La : "recursive",
+      architecture: (_Pa = readString(env, "RAG_ARCHITECTURE")) != null ? _Pa : "simple",
+      chunkingStrategy: (_Qa = readString(env, "RAG_CHUNKING_STRATEGY")) != null ? _Qa : "recursive",
       uiMapping: (() => {
         const raw = readString(env, "RAG_UI_MAPPING");
         if (!raw) return void 0;
@@ -2267,8 +2269,8 @@ function getEnvConfig(env = process.env, base) {
       })()
     },
     telemetry: {
-      enabled: readString(env, "TELEMETRY_ENABLED") === "true" || readString(env, "NEXT_PUBLIC_TELEMETRY_ENABLED") === "true" || ((_Ma = base == null ? void 0 : base.telemetry) == null ? void 0 : _Ma.enabled) || false,
-      url: (_Qa = (_Pa = (_Na = readString(env, "TELEMETRY_URL")) != null ? _Na : readString(env, "NEXT_PUBLIC_TELEMETRY_URL")) != null ? _Pa : (_Oa = base == null ? void 0 : base.telemetry) == null ? void 0 : _Oa.url) != null ? _Qa : "/api/telemetry"
+      enabled: telemetryEnabled,
+      url: (_Ua = (_Ta = (_Ra = readString(env, "TELEMETRY_URL")) != null ? _Ra : readString(env, "NEXT_PUBLIC_TELEMETRY_URL")) != null ? _Ta : (_Sa = base == null ? void 0 : base.telemetry) == null ? void 0 : _Sa.url) != null ? _Ua : "/api/telemetry"
     }
   }, readString(env, "GRAPH_DB_PROVIDER") ? {
     graphDb: {
@@ -7447,7 +7449,7 @@ ${m.content}`).join("\n\n---\n\n");
    */
   askStreamInternal(_0) {
     return __asyncGenerator(this, arguments, function* (question, history = [], namespace) {
-      var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A;
+      var _a2, _b, _c, _d, _e, _f, _g2, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _A, _B, _C;
       yield new __await(this.initialize());
       const ns = namespace != null ? namespace : this.config.projectId;
       const topK = (_b = (_a2 = this.config.rag) == null ? void 0 : _a2.topK) != null ? _b : 5;
@@ -7757,8 +7759,9 @@ ${context}`;
           hallucinationReason: hScore.reason
         } : {});
         const trace = buildTrace(hallucinationResult);
-        if ((_A = this.config.telemetry) == null ? void 0 : _A.enabled) {
-          const telemetryUrl = this.config.telemetry.url || "/api/telemetry";
+        const isTelemetryActive = (_B = (_A = this.config.telemetry) == null ? void 0 : _A.enabled) != null ? _B : Boolean(this.config.licenseKey);
+        if (isTelemetryActive) {
+          const telemetryUrl = ((_C = this.config.telemetry) == null ? void 0 : _C.url) || "/api/telemetry";
           const absoluteUrl = telemetryUrl.startsWith("http") ? telemetryUrl : (process.env.NEXT_PUBLIC_APP_URL || `http://localhost:${process.env.PORT || 3e3}`) + telemetryUrl;
           (async () => {
             try {
@@ -9014,6 +9017,43 @@ function getOrCreatePlugin(configOrPlugin) {
   }
   return _g[cacheKey];
 }
+function reportTelemetry(req, plugin, action, status, details, trace) {
+  var _a2;
+  try {
+    const config = plugin.getConfig();
+    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 = (_a2 = telemetryConfig == null ? void 0 : telemetryConfig.enabled) != null ? _a2 : Boolean(licenseKey);
+    if (!enabled) return;
+    const telemetryUrl = (telemetryConfig == null ? void 0 : telemetryConfig.url) || process.env.TELEMETRY_URL || process.env.NEXT_PUBLIC_TELEMETRY_URL || "/api/telemetry";
+    const host = req.headers.get("host") || "localhost";
+    let absoluteUrl = telemetryUrl;
+    if (!telemetryUrl.startsWith("http")) {
+      const proto = req.headers.get("x-forwarded-proto") || "http";
+      absoluteUrl = `${proto}://${host}${telemetryUrl}`;
+    }
+    const projectId = config.projectId || "default";
+    fetch(absoluteUrl, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-forwarded-for": req.headers.get("x-forwarded-for") || "",
+        "x-real-ip": req.headers.get("x-real-ip") || ""
+      },
+      body: JSON.stringify({
+        trace,
+        licenseKey,
+        projectId,
+        action,
+        status,
+        details
+      })
+    }).catch((err) => {
+      console.warn("[Retrivora Telemetry] Async report warning:", err.message);
+    });
+  } catch (e) {
+  }
+}
 function sseFrame(payload) {
   return `data: ${JSON.stringify(payload)}
 
@@ -9056,6 +9096,7 @@ function createChatHandler(configOrPlugin, options) {
   const storage = new DatabaseStorage(plugin.getConfig());
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
   return async function POST(req) {
+    var _a2, _b, _c, _d;
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult;
     const rateLimited = checkRateLimit(req);
@@ -9084,12 +9125,14 @@ function createChatHandler(configOrPlugin, options) {
         uiTransformation: result.ui_transformation,
         trace: result.trace
       }).catch((err) => console.warn("[createChatHandler] Failed to save assistant message:", err));
+      reportTelemetry(req, plugin, "QUERY_GENERATION", "success", `Tokens: ${((_b = (_a2 = result.trace) == null ? void 0 : _a2.tokens) == null ? void 0 : _b.totalTokens) || 0}, Latency: ${((_d = (_c = result.trace) == null ? void 0 : _c.latency) == null ? void 0 : _d.totalMs) || 0}ms`, result.trace);
       return NextResponse.json(__spreadProps(__spreadValues({}, result), {
         messageId: assistantMsgId,
         userMessageId: userMsgId
       }));
     } catch (err) {
       const message = err instanceof Error ? err.message : "Internal server error";
+      reportTelemetry(req, plugin, "QUERY_GENERATION", "error", message);
       return NextResponse.json({ error: message }, { status: 500 });
     }
   };
@@ -9132,7 +9175,7 @@ function createStreamHandler(configOrPlugin, options) {
     let isActive = true;
     const stream = new ReadableStream({
       async start(controller) {
-        var _a2;
+        var _a2, _b, _c, _d, _e;
         const enqueue = (text) => {
           if (!isActive) return;
           try {
@@ -9189,6 +9232,7 @@ function createStreamHandler(configOrPlugin, options) {
                   uiTransformation,
                   trace: responseChunk == null ? void 0 : responseChunk.trace
                 }).catch((err) => console.warn("[createStreamHandler] Failed to save assistant message:", err));
+                reportTelemetry(req, plugin, "QUERY_GENERATION", "success", `Tokens: ${((_c = (_b = responseChunk == null ? void 0 : responseChunk.trace) == null ? void 0 : _b.tokens) == null ? void 0 : _c.totalTokens) || 0}, Latency: ${((_e = (_d = responseChunk == null ? void 0 : responseChunk.trace) == null ? void 0 : _d.latency) == null ? void 0 : _e.totalMs) || 0}ms`, responseChunk == null ? void 0 : responseChunk.trace);
               }
             }
           } catch (temp) {
@@ -9205,6 +9249,7 @@ function createStreamHandler(configOrPlugin, options) {
           if (isActive) {
             const errorMessage = streamError instanceof Error ? streamError.message : String(streamError);
             console.error("[createStreamHandler] Stream error:", streamError);
+            reportTelemetry(req, plugin, "QUERY_GENERATION", "error", errorMessage);
             try {
               enqueue(sseErrorFrame(errorMessage));
             } catch (e) {
@@ -9241,9 +9286,11 @@ function createIngestHandler(configOrPlugin, options) {
         return NextResponse.json({ error: "documents array is required" }, { status: 400 });
       }
       const results = await plugin.ingest(documents, namespace);
+      reportTelemetry(req, plugin, "DOCUMENT_INGESTION", "success", `Ingested ${documents.length} document(s)`);
       return NextResponse.json({ results });
     } catch (err) {
       const message = err instanceof Error ? err.message : "Internal server error";
+      reportTelemetry(req, plugin, "DOCUMENT_INGESTION", "error", message);
       return NextResponse.json({ error: message }, { status: 500 });
     }
   };
@@ -9342,9 +9389,11 @@ function createUploadHandler(configOrPlugin, options) {
         }
       }
       const results = await plugin.ingest(documents, namespace);
+      reportTelemetry(req, plugin, "DOCUMENT_INGESTION", "success", `Uploaded & ingested ${files.length} file(s)`);
       return NextResponse.json({ message: "Upload successful", results });
     } catch (err) {
       const message = err instanceof Error ? err.message : "Upload failed";
+      reportTelemetry(req, plugin, "DOCUMENT_INGESTION", "error", message);
       return NextResponse.json({ error: message }, { status: 500 });
     }
   };
@@ -9352,19 +9401,30 @@ function createUploadHandler(configOrPlugin, options) {
 function createSuggestionsHandler(configOrPlugin, options) {
   const plugin = getOrCreatePlugin(configOrPlugin);
   const onAuthorize = options == null ? void 0 : options.onAuthorize;
-  return async function POST(req) {
+  return async function handler(req) {
     const authResult = await checkAuth(req, onAuthorize);
     if (authResult) return authResult;
     try {
-      const body = await req.json();
-      const { query, namespace } = body;
+      let query = "";
+      let namespace = void 0;
+      if (req.method === "POST") {
+        const body = await req.json().catch(() => ({}));
+        query = body.query || "";
+        namespace = body.namespace;
+      } else {
+        const url = new URL(req.url);
+        query = url.searchParams.get("query") || "";
+        namespace = url.searchParams.get("namespace") || void 0;
+      }
       if (typeof query !== "string") {
         return NextResponse.json({ error: "query is required" }, { status: 400 });
       }
       const suggestions = await plugin.getSuggestions(query, namespace);
+      reportTelemetry(req, plugin, "AUTO_SUGGESTIONS", "success", `Fetched ${suggestions.length} suggestions for: ${query.slice(0, 30)}`);
       return NextResponse.json({ suggestions });
     } catch (err) {
       const message = err instanceof Error ? err.message : "Internal server error";
+      reportTelemetry(req, plugin, "AUTO_SUGGESTIONS", "error", message);
       return NextResponse.json({ error: message }, { status: 500 });
     }
   };
@@ -9496,6 +9556,8 @@ function createRagHandler(configOrPlugin, options) {
     switch (segment) {
       case "health":
         return healthHandler(req);
+      case "suggestions":
+        return suggestionsHandler(req);
       case "history":
         return historyHandler(req);
       case "feedback":

package/dist/{index-DXd29KMq.d.mts → index-DHsFLJXQ.d.mts}

@@ -144,40 +144,10 @@ declare function sseObservabilityFrame(trace: unknown): string;
 declare function sseErrorFrame(message: string): string;
 /**
  * createChatHandler — factory that returns a Next.js App Router POST handler.
- *
- * Accepts either a full/partial `RagConfig` **or** a pre-built `VectorPlugin`
- * instance (preferred for singleton/multi-tenant setups).
- *
- * @example
- * // Option A — pass config (plugin created once at module load time)
- * export const POST = createChatHandler(getRagConfig());
- *
- * // Option B — pass a pre-built plugin (most flexible)
- * const plugin = new VectorPlugin(getRagConfig());
- * export const POST = createChatHandler(plugin);
  */
 declare function createChatHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createStreamHandler — factory for a streaming SSE Next.js App Router POST handler.
- *
- * Streams the assistant response as Server-Sent Events (SSE). Each frame is a
- * JSON object with a `type` discriminant:
- *   - `{ type: "text",     text: "..." }`       — incremental text chunk
- *   - `{ type: "metadata", sources: [...] }`    — retrieval metadata (last frame)
- *   - `{ type: "error",    error: "..." }`       — stream-level error
- *
- * @example
- * // src/app/api/chat/route.ts
- * export const POST = createStreamHandler(getRagConfig());
- *
- * // Client-side parsing in useRagChat.ts:
- * // const lines = chunk.split('\n');
- * // for (const line of lines) {
- * //   if (line.startsWith('data: ')) {
- * //     const frame = JSON.parse(line.slice(6));
- * //     if (frame.type === 'text') { ... }
- * //   }
- * // }
  */
 declare function createStreamHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
@@ -194,6 +164,7 @@ declare function createHealthHandler(configOrPlugin?: Partial<RagConfig> | Vecto
 declare function createUploadHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createSuggestionsHandler — factory for the auto-suggestions endpoint.
+ * Supports both POST (JSON body) and GET (URL search parameters).
  */
 declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**

package/dist/{index-D_bOdJML.d.ts → index-tzwc7UhY.d.ts}

@@ -144,40 +144,10 @@ declare function sseObservabilityFrame(trace: unknown): string;
 declare function sseErrorFrame(message: string): string;
 /**
  * createChatHandler — factory that returns a Next.js App Router POST handler.
- *
- * Accepts either a full/partial `RagConfig` **or** a pre-built `VectorPlugin`
- * instance (preferred for singleton/multi-tenant setups).
- *
- * @example
- * // Option A — pass config (plugin created once at module load time)
- * export const POST = createChatHandler(getRagConfig());
- *
- * // Option B — pass a pre-built plugin (most flexible)
- * const plugin = new VectorPlugin(getRagConfig());
- * export const POST = createChatHandler(plugin);
  */
 declare function createChatHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createStreamHandler — factory for a streaming SSE Next.js App Router POST handler.
- *
- * Streams the assistant response as Server-Sent Events (SSE). Each frame is a
- * JSON object with a `type` discriminant:
- *   - `{ type: "text",     text: "..." }`       — incremental text chunk
- *   - `{ type: "metadata", sources: [...] }`    — retrieval metadata (last frame)
- *   - `{ type: "error",    error: "..." }`       — stream-level error
- *
- * @example
- * // src/app/api/chat/route.ts
- * export const POST = createStreamHandler(getRagConfig());
- *
- * // Client-side parsing in useRagChat.ts:
- * // const lines = chunk.split('\n');
- * // for (const line of lines) {
- * //   if (line.startsWith('data: ')) {
- * //     const frame = JSON.parse(line.slice(6));
- * //     if (frame.type === 'text') { ... }
- * //   }
- * // }
  */
 declare function createStreamHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
@@ -194,6 +164,7 @@ declare function createHealthHandler(configOrPlugin?: Partial<RagConfig> | Vecto
 declare function createUploadHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**
  * createSuggestionsHandler — factory for the auto-suggestions endpoint.
+ * Supports both POST (JSON body) and GET (URL search parameters).
  */
 declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
 /**

package/dist/index.js

@@ -3070,11 +3070,20 @@ function ChatWindow({
     const timer = setTimeout(async () => {
       setIsSuggesting(true);
       try {
-        const response = await fetch("/api/suggestions", {
+        const base = retrivoraApiBase || "/api/retrivora";
+        const primaryUrl = `${base}/suggestions`;
+        let response = await fetch(primaryUrl, {
           method: "POST",
-          headers: { "Content-Type": "application/json" },
+          headers: __spreadValues({ "Content-Type": "application/json" }, headers || {}),
           body: JSON.stringify({ query: input, namespace: projectId })
         });
+        if (!response.ok && response.status === 404) {
+          response = await fetch("/api/suggestions", {
+            method: "POST",
+            headers: __spreadValues({ "Content-Type": "application/json" }, headers || {}),
+            body: JSON.stringify({ query: input, namespace: projectId })
+          });
+        }
         const data = await response.json();
         if (data.suggestions) {
           setSuggestions(data.suggestions);
@@ -3086,7 +3095,7 @@ function ChatWindow({
       }
     }, 800);
     return () => clearTimeout(timer);
-  }, [input, projectId]);
+  }, [input, projectId, retrivoraApiBase, headers]);
   return /* @__PURE__ */ (0, import_jsx_runtime13.jsxs)(
     "div",
     {

package/dist/index.mjs

@@ -3077,11 +3077,20 @@ function ChatWindow({
     const timer = setTimeout(async () => {
       setIsSuggesting(true);
       try {
-        const response = await fetch("/api/suggestions", {
+        const base = retrivoraApiBase || "/api/retrivora";
+        const primaryUrl = `${base}/suggestions`;
+        let response = await fetch(primaryUrl, {
           method: "POST",
-          headers: { "Content-Type": "application/json" },
+          headers: __spreadValues({ "Content-Type": "application/json" }, headers || {}),
           body: JSON.stringify({ query: input, namespace: projectId })
         });
+        if (!response.ok && response.status === 404) {
+          response = await fetch("/api/suggestions", {
+            method: "POST",
+            headers: __spreadValues({ "Content-Type": "application/json" }, headers || {}),
+            body: JSON.stringify({ query: input, namespace: projectId })
+          });
+        }
         const data = await response.json();
         if (data.suggestions) {
           setSuggestions(data.suggestions);
@@ -3093,7 +3102,7 @@ function ChatWindow({
       }
     }, 800);
     return () => clearTimeout(timer);
-  }, [input, projectId]);
+  }, [input, projectId, retrivoraApiBase, headers]);
   return /* @__PURE__ */ jsxs12(
     "div",
     {

package/dist/server.d.mts

@@ -1,8 +1,8 @@
 import { p as VectorDBConfig, L as LLMConfig, e as EmbeddingConfig, k as RagConfig, n as UniversalRagConfig, o as UpsertDocument, V as VectorMatch, G as GraphDBConfig, r as GraphNode, s as Edge, t as GraphSearchResult, I as ILLMProvider, q as VectorDBProvider, h as LLMProvider, f as EmbeddingProvider, j as RAGConfig, U as UIConfig, C as ChatMessage, c as ChatOptions, E as EmbedOptions } from './ILLMProvider-DMxLyTdq.mjs';
 export { d as ChatResponse, g as IngestDocument, l as RetrievalConfig, W as WorkflowConfig } from './ILLMProvider-DMxLyTdq.mjs';
 export { A as AuthenticationException, C as Chunk, a as ChunkOptions, b as ConfigurationException, D as DocumentChunker, E as EmbeddingFailedException, g as Pipeline, P as ProviderNotFoundException, R as RateLimitException, c as RetrievalException, d as Retrivora, e as RetrivoraError, f as RetrivoraErrorCode, w as wrapError } from './index-xygonxpW.mjs';
-import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-DXd29KMq.mjs';
-export { C as ConfigValidator, V as ValidationError, b as VectorPlugin, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, n as sseTextFrame } from './index-DXd29KMq.mjs';
+import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-DHsFLJXQ.mjs';
+export { C as ConfigValidator, V as ValidationError, b as VectorPlugin, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, n as sseTextFrame } from './index-DHsFLJXQ.mjs';
 import 'next/server';
 
 interface LicensePayload {

package/dist/server.d.ts

@@ -1,8 +1,8 @@
 import { p as VectorDBConfig, L as LLMConfig, e as EmbeddingConfig, k as RagConfig, n as UniversalRagConfig, o as UpsertDocument, V as VectorMatch, G as GraphDBConfig, r as GraphNode, s as Edge, t as GraphSearchResult, I as ILLMProvider, q as VectorDBProvider, h as LLMProvider, f as EmbeddingProvider, j as RAGConfig, U as UIConfig, C as ChatMessage, c as ChatOptions, E as EmbedOptions } from './ILLMProvider-DMxLyTdq.js';
 export { d as ChatResponse, g as IngestDocument, l as RetrievalConfig, W as WorkflowConfig } from './ILLMProvider-DMxLyTdq.js';
 export { A as AuthenticationException, C as Chunk, a as ChunkOptions, b as ConfigurationException, D as DocumentChunker, E as EmbeddingFailedException, g as Pipeline, P as ProviderNotFoundException, R as RateLimitException, c as RetrievalException, d as Retrivora, e as RetrivoraError, f as RetrivoraErrorCode, w as wrapError } from './index-CfkqZd2Y.js';
-import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-D_bOdJML.js';
-export { C as ConfigValidator, V as ValidationError, b as VectorPlugin, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, n as sseTextFrame } from './index-D_bOdJML.js';
+import { H as HealthCheckResult, I as IProviderValidator, a as IProviderHealthChecker } from './index-tzwc7UhY.js';
+export { C as ConfigValidator, V as ValidationError, b as VectorPlugin, c as createChatHandler, d as createFeedbackHandler, e as createHealthHandler, f as createHistoryHandler, g as createIngestHandler, h as createRagHandler, i as createSessionsHandler, j as createStreamHandler, k as createUploadHandler, s as sseErrorFrame, l as sseFrame, m as sseMetaFrame, n as sseTextFrame } from './index-tzwc7UhY.js';
 import 'next/server';
 
 interface LicensePayload {