@retrivora-ai/rag-engine 2.6.0 → 2.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.md +8 -6
  2. package/dist/ChromaDBProvider-NDA2IBOH.mjs +8 -0
  3. package/dist/{ILLMProvider-DUCL1r75.d.mts → ILLMProvider-CzXcTA6d.d.mts} +21 -3
  4. package/dist/{ILLMProvider-DUCL1r75.d.ts → ILLMProvider-CzXcTA6d.d.ts} +21 -3
  5. package/dist/MilvusProvider-H6GGL5FQ.mjs +8 -0
  6. package/dist/MongoDBProvider-KC3GF3FH.mjs +8 -0
  7. package/dist/MultiTablePostgresProvider-6LJBFZL2.mjs +9 -0
  8. package/dist/PineconeProvider-22RF2QPF.mjs +10 -0
  9. package/dist/PineconeProvider-HBBIXLT3.mjs +10 -0
  10. package/dist/PostgreSQLProvider-VWFL4OIP.mjs +8 -0
  11. package/dist/QdrantProvider-UU7RGXBI.mjs +8 -0
  12. package/dist/RedisProvider-MIIPSAAE.mjs +8 -0
  13. package/dist/SimpleGraphProvider-HJIS4S7Y.mjs +70 -0
  14. package/dist/UniversalVectorProvider-NO3L255G.mjs +9 -0
  15. package/dist/WeaviateProvider-YRZDZFAC.mjs +8 -0
  16. package/dist/chunk-23PFNEBF.mjs +107 -0
  17. package/dist/chunk-3E4GZGDX.mjs +10851 -0
  18. package/dist/chunk-3SQ4DODU.mjs +238 -0
  19. package/dist/chunk-AHMMUZ4W.mjs +152 -0
  20. package/dist/chunk-ASBNNEVI.mjs +81 -0
  21. package/dist/chunk-AT4TFUQN.mjs +219 -0
  22. package/dist/chunk-BEPLYQBS.mjs +89 -0
  23. package/dist/chunk-G7MJRFCO.mjs +340 -0
  24. package/dist/chunk-IHWKVAUR.mjs +112 -0
  25. package/dist/chunk-IMP6FUCY.mjs +30 -0
  26. package/dist/chunk-LFNV6DEL.mjs +281 -0
  27. package/dist/chunk-MAXMVO7B.mjs +211 -0
  28. package/dist/chunk-MGJ6V2IT.mjs +203 -0
  29. package/dist/chunk-N3TI27LG.mjs +334 -0
  30. package/dist/chunk-NWYE4Q7B.mjs +334 -0
  31. package/dist/chunk-OJMAT4EG.mjs +219 -0
  32. package/dist/chunk-QKZM3RSJ.mjs +10851 -0
  33. package/dist/chunk-QUY3E6HJ.mjs +168 -0
  34. package/dist/chunk-SG6XYLQE.mjs +53 -0
  35. package/dist/chunk-UT6SZZEC.mjs +69 -0
  36. package/dist/chunk-VW3U4MMX.mjs +157 -0
  37. package/dist/chunk-WOJCOTXI.mjs +281 -0
  38. package/dist/chunk-XP6NJMX4.mjs +168 -0
  39. package/dist/chunk-XYBKDJDW.mjs +696 -0
  40. package/dist/handlers/index.d.mts +2 -2
  41. package/dist/handlers/index.d.ts +2 -2
  42. package/dist/handlers/index.js +9736 -9354
  43. package/dist/handlers/index.mjs +24 -13686
  44. package/dist/{index-CsBcqng1.d.ts → index-BBbt5A2y.d.mts} +61 -47
  45. package/dist/{index-BVSHblli.d.mts → index-BST9Gzsv.d.mts} +8 -7
  46. package/dist/{index-D6Oq2zyc.d.mts → index-BZ_rR6V8.d.ts} +61 -47
  47. package/dist/{index-DGW0NNmR.d.ts → index-qLvtMUr-.d.ts} +8 -7
  48. package/dist/index.css +23 -0
  49. package/dist/index.d.mts +4 -4
  50. package/dist/index.d.ts +4 -4
  51. package/dist/index.js +278 -190
  52. package/dist/index.min.css +1 -1
  53. package/dist/index.mjs +218 -1558
  54. package/dist/server.d.mts +58 -12
  55. package/dist/server.d.ts +58 -12
  56. package/dist/server.js +968 -577
  57. package/dist/server.mjs +395 -14244
  58. package/package.json +1 -1
@@ -0,0 +1,334 @@
1
+ import {
2
+ SDK_VERSION
3
+ } from "./chunk-XP6NJMX4.mjs";
4
+ import {
5
+ __spreadValues
6
+ } from "./chunk-UT6SZZEC.mjs";
7
+
8
+ // src/core/ProjectSettings.ts
9
+ var DEFAULT_LIFECYCLE_HOOKS = [
10
+ "beforeInitialize",
11
+ "afterInitialize",
12
+ "beforeSend",
13
+ "afterResponse",
14
+ "onMessage",
15
+ "onCitationClick",
16
+ "onFeedback",
17
+ "onError",
18
+ "onReconnect",
19
+ "onFileUpload"
20
+ ];
21
+ var DEFAULT_CONVERSATION_FEATURES = [
22
+ "History",
23
+ "Resume",
24
+ "Search",
25
+ "Export",
26
+ "Rename",
27
+ "Delete",
28
+ "Tags",
29
+ "Pinned",
30
+ "Unread",
31
+ "Ratings"
32
+ ];
33
+ function createDefaultProjectSettings(projectId) {
34
+ return {
35
+ projectId,
36
+ branding: {
37
+ companyName: "Retrivora AI",
38
+ botName: "Retrivora Assistant",
39
+ welcomeMessage: "Hi, I can help you search your knowledge base.",
40
+ primaryColor: "#6366f1",
41
+ secondaryColor: "#8b5cf6",
42
+ fontFamily: "Inter",
43
+ borderRadius: 14,
44
+ logoUrl: "",
45
+ avatarUrl: "",
46
+ customCss: ""
47
+ },
48
+ ai: {
49
+ defaultModel: "llama-3.1-8b-instant",
50
+ embeddingModel: "text-embedding-3-small",
51
+ systemPrompt: "Answer using the connected knowledge base. Cite sources when available.",
52
+ memoryEnabled: true,
53
+ multiModelEnabled: true,
54
+ citationsEnabled: true,
55
+ fileUploadEnabled: true
56
+ },
57
+ auth: {
58
+ mode: "public",
59
+ allowedOrigins: [],
60
+ requireVerifiedEmail: false,
61
+ sessionTtlMinutes: 1440
62
+ },
63
+ widget: {
64
+ position: "bottom-right",
65
+ theme: "light",
66
+ lazyLoad: true,
67
+ autoReconnect: true,
68
+ persistConversations: true,
69
+ showRetrivoraBranding: false
70
+ },
71
+ telemetry: {
72
+ enabled: true,
73
+ collectBrowser: true,
74
+ collectCountry: false,
75
+ redactPii: true,
76
+ retentionDays: 30
77
+ },
78
+ lifecycleHooks: DEFAULT_LIFECYCLE_HOOKS,
79
+ conversationFeatures: DEFAULT_CONVERSATION_FEATURES
80
+ };
81
+ }
82
+ function cleanString(value, fallback, maxLength = 2e3) {
83
+ if (typeof value !== "string") return fallback;
84
+ return value.trim().slice(0, maxLength);
85
+ }
86
+ function cleanBoolean(value, fallback) {
87
+ return typeof value === "boolean" ? value : fallback;
88
+ }
89
+ function cleanNumber(value, fallback, min, max) {
90
+ const num = typeof value === "number" ? value : Number(value);
91
+ if (!Number.isFinite(num)) return fallback;
92
+ return Math.min(Math.max(Math.round(num), min), max);
93
+ }
94
+ function cleanEnum(value, fallback, allowed) {
95
+ return typeof value === "string" && allowed.includes(value) ? value : fallback;
96
+ }
97
+ function cleanStringList(value, fallback, maxItems = 20) {
98
+ if (!Array.isArray(value)) return fallback;
99
+ const cleaned = value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean).slice(0, maxItems);
100
+ return cleaned.length > 0 ? Array.from(new Set(cleaned)) : fallback;
101
+ }
102
+ function normalizeProjectSettings(projectId, input) {
103
+ const defaults = createDefaultProjectSettings(projectId);
104
+ const branding = (input == null ? void 0 : input.branding) || {};
105
+ const ai = (input == null ? void 0 : input.ai) || {};
106
+ const auth = (input == null ? void 0 : input.auth) || {};
107
+ const widget = (input == null ? void 0 : input.widget) || {};
108
+ const telemetry = (input == null ? void 0 : input.telemetry) || {};
109
+ return {
110
+ projectId,
111
+ branding: {
112
+ companyName: cleanString(branding.companyName, defaults.branding.companyName, 120),
113
+ botName: cleanString(branding.botName, defaults.branding.botName, 120),
114
+ welcomeMessage: cleanString(branding.welcomeMessage, defaults.branding.welcomeMessage, 500),
115
+ primaryColor: cleanString(branding.primaryColor, defaults.branding.primaryColor, 32),
116
+ secondaryColor: cleanString(branding.secondaryColor, defaults.branding.secondaryColor, 32),
117
+ fontFamily: cleanString(branding.fontFamily, defaults.branding.fontFamily, 80),
118
+ borderRadius: cleanNumber(branding.borderRadius, defaults.branding.borderRadius, 0, 32),
119
+ logoUrl: cleanString(branding.logoUrl, defaults.branding.logoUrl, 500),
120
+ avatarUrl: cleanString(branding.avatarUrl, defaults.branding.avatarUrl, 500),
121
+ customCss: cleanString(branding.customCss, defaults.branding.customCss, 5e3)
122
+ },
123
+ ai: {
124
+ defaultModel: cleanString(ai.defaultModel, defaults.ai.defaultModel, 120),
125
+ embeddingModel: cleanString(ai.embeddingModel, defaults.ai.embeddingModel, 120),
126
+ systemPrompt: cleanString(ai.systemPrompt, defaults.ai.systemPrompt, 5e3),
127
+ memoryEnabled: cleanBoolean(ai.memoryEnabled, defaults.ai.memoryEnabled),
128
+ multiModelEnabled: cleanBoolean(ai.multiModelEnabled, defaults.ai.multiModelEnabled),
129
+ citationsEnabled: cleanBoolean(ai.citationsEnabled, defaults.ai.citationsEnabled),
130
+ fileUploadEnabled: cleanBoolean(ai.fileUploadEnabled, defaults.ai.fileUploadEnabled)
131
+ },
132
+ auth: {
133
+ mode: cleanEnum(auth.mode, defaults.auth.mode, ["public", "anonymous", "jwt", "oauth", "okta", "auth0", "supabase", "firebase", "sso", "custom_token"]),
134
+ allowedOrigins: cleanStringList(auth.allowedOrigins, defaults.auth.allowedOrigins, 25),
135
+ requireVerifiedEmail: cleanBoolean(auth.requireVerifiedEmail, defaults.auth.requireVerifiedEmail),
136
+ sessionTtlMinutes: cleanNumber(auth.sessionTtlMinutes, defaults.auth.sessionTtlMinutes, 15, 43200)
137
+ },
138
+ widget: {
139
+ position: cleanEnum(widget.position, defaults.widget.position, ["bottom-right", "bottom-left", "top-right", "top-left"]),
140
+ theme: cleanEnum(widget.theme, defaults.widget.theme, ["light", "dark", "system"]),
141
+ lazyLoad: cleanBoolean(widget.lazyLoad, defaults.widget.lazyLoad),
142
+ autoReconnect: cleanBoolean(widget.autoReconnect, defaults.widget.autoReconnect),
143
+ persistConversations: cleanBoolean(widget.persistConversations, defaults.widget.persistConversations),
144
+ showRetrivoraBranding: cleanBoolean(widget.showRetrivoraBranding, defaults.widget.showRetrivoraBranding)
145
+ },
146
+ telemetry: {
147
+ enabled: cleanBoolean(telemetry.enabled, defaults.telemetry.enabled),
148
+ collectBrowser: cleanBoolean(telemetry.collectBrowser, defaults.telemetry.collectBrowser),
149
+ collectCountry: cleanBoolean(telemetry.collectCountry, defaults.telemetry.collectCountry),
150
+ redactPii: cleanBoolean(telemetry.redactPii, defaults.telemetry.redactPii),
151
+ retentionDays: cleanNumber(telemetry.retentionDays, defaults.telemetry.retentionDays, 1, 365)
152
+ },
153
+ lifecycleHooks: cleanStringList(input == null ? void 0 : input.lifecycleHooks, defaults.lifecycleHooks, 30),
154
+ conversationFeatures: cleanStringList(input == null ? void 0 : input.conversationFeatures, defaults.conversationFeatures, 30),
155
+ updatedAt: input == null ? void 0 : input.updatedAt
156
+ };
157
+ }
158
+ function projectSettingsToUiConfig(settings) {
159
+ return {
160
+ title: settings.branding.botName,
161
+ subtitle: settings.branding.companyName,
162
+ primaryColor: settings.branding.primaryColor,
163
+ accentColor: settings.branding.secondaryColor,
164
+ logoUrl: settings.branding.logoUrl || settings.branding.avatarUrl,
165
+ welcomeMessage: settings.branding.welcomeMessage,
166
+ poweredBy: settings.widget.showRetrivoraBranding ? "Retrivora AI" : "",
167
+ allowUpload: settings.ai.fileUploadEnabled,
168
+ showSources: settings.ai.citationsEnabled,
169
+ borderRadius: settings.branding.borderRadius <= 4 ? "sm" : settings.branding.borderRadius <= 8 ? "md" : settings.branding.borderRadius <= 16 ? "xl" : "full"
170
+ };
171
+ }
172
+
173
+ // src/core/ConfigFetcher.ts
174
+ var CONTROL_PLANE_URL = "https://www.retrivora.com";
175
+ var LLM_PROXY_BASE_URL = "https://llm.retrivora.com/api/v1";
176
+ var ConfigFetcher = class {
177
+ // 5-minute in-memory session cache
178
+ /**
179
+ * Fetch full project configuration (vectorDb + embedding + llm + workspace) from Retrivora Control Plane.
180
+ *
181
+ * The SDK calls https://www.retrivora.com/api/v1/config with the project ID and license key.
182
+ * The server validates the license against the database and returns:
183
+ * - validity (tier, isActive, expiresAt)
184
+ * - LLM model info
185
+ * - embedding model info
186
+ * - Pinecone index name and workspace/namespace
187
+ *
188
+ * The Pinecone API key is NOT returned (server-only). The SDK uses local
189
+ * PINECONE_API_KEY if available, or vector operations are handled server-side.
190
+ */
191
+ static async fetchRemoteConfig(projectId, licenseKey) {
192
+ const cacheKey = `${projectId}:${licenseKey || ""}`;
193
+ const now = Date.now();
194
+ const cached = this.cache.get(cacheKey);
195
+ if (cached && now - cached.cachedAt < this.TTL_MS) {
196
+ return cached.config;
197
+ }
198
+ const existingInflight = this.inflight.get(cacheKey);
199
+ if (existingInflight) {
200
+ return existingInflight;
201
+ }
202
+ const promise = this._doFetch(projectId, licenseKey, cacheKey, now);
203
+ this.inflight.set(cacheKey, promise);
204
+ try {
205
+ return await promise;
206
+ } finally {
207
+ this.inflight.delete(cacheKey);
208
+ }
209
+ }
210
+ /** Internal: performs the actual HTTP fetch. Shared by all callers via inflight dedup. */
211
+ static async _doFetch(projectId, licenseKey, cacheKey, now) {
212
+ var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
213
+ const controlPlaneUrls = [
214
+ process.env.RETRIVORA_CONTROL_PLANE_URL,
215
+ process.env.NEXT_PUBLIC_RETRIVORA_CONTROL_PLANE_URL,
216
+ CONTROL_PLANE_URL
217
+ ].filter((url) => {
218
+ if (!url) return false;
219
+ const isEnvVar = url === process.env.RETRIVORA_CONTROL_PLANE_URL || url === process.env.NEXT_PUBLIC_RETRIVORA_CONTROL_PLANE_URL;
220
+ if (!isEnvVar && (url.includes("localhost") || url.includes("127.0.0.1"))) return false;
221
+ return true;
222
+ }).map((url) => url.replace(/\/$/, ""));
223
+ for (const baseUrl of controlPlaneUrls) {
224
+ try {
225
+ const url = `${baseUrl}/api/v1/config?projectId=${encodeURIComponent(projectId)}`;
226
+ const res = await fetch(url, {
227
+ method: "GET",
228
+ headers: __spreadValues(__spreadValues({
229
+ "Content-Type": "application/json",
230
+ "x-sdk-version": SDK_VERSION
231
+ }, licenseKey ? { "x-license-key": licenseKey } : {}), projectId ? { "x-project-id": projectId } : {})
232
+ });
233
+ if (!res.ok) {
234
+ console.warn(`[ConfigFetcher] Error text: ${await res.text()}`);
235
+ }
236
+ if (res.ok) {
237
+ const data = await res.json();
238
+ if ((data == null ? void 0 : data.success) && (data == null ? void 0 : data.vectorDb)) {
239
+ const fetchedProjectId = data.projectId || projectId;
240
+ const config = {
241
+ projectId: fetchedProjectId,
242
+ tier: data.tier,
243
+ isActive: data.isActive,
244
+ expiresAt: data.expiresAt,
245
+ vectorDb: {
246
+ // Fetch apiKey from credentials API if available, else fallback to empty
247
+ apiKey: data.vectorDb.apiKey || "",
248
+ indexName: data.vectorDb.indexName || "retrivora-free",
249
+ provider: data.vectorDb.provider || "pinecone",
250
+ projectId: fetchedProjectId,
251
+ namespace: ((_a = data.workspace) == null ? void 0 : _a.namespace) || data.vectorDb.namespace || fetchedProjectId
252
+ },
253
+ embedding: {
254
+ provider: ((_b = data.embedding) == null ? void 0 : _b.provider) || "universal_rest",
255
+ model: ((_c = data.embedding) == null ? void 0 : _c.model) || "text-embedding-004",
256
+ // Route through www.retrivora.com proxy, not llm.retrivora.com directly.
257
+ baseUrl: ((_d = data.embedding) == null ? void 0 : _d.baseUrl) || LLM_PROXY_BASE_URL,
258
+ apiKey: ((_e = data.embedding) == null ? void 0 : _e.apiKey) || licenseKey || "",
259
+ profile: ((_f = data.embedding) == null ? void 0 : _f.profile) || "litellm"
260
+ },
261
+ llm: {
262
+ provider: ((_g = data.llm) == null ? void 0 : _g.provider) || "universal_rest",
263
+ model: ((_h = data.llm) == null ? void 0 : _h.model) || "llama-3.1-8b-instant",
264
+ // Route through www.retrivora.com proxy, not llm.retrivora.com directly.
265
+ baseUrl: ((_i = data.llm) == null ? void 0 : _i.baseUrl) || LLM_PROXY_BASE_URL,
266
+ apiKey: ((_j = data.llm) == null ? void 0 : _j.apiKey) || licenseKey || "",
267
+ profile: ((_k = data.llm) == null ? void 0 : _k.profile) || "litellm"
268
+ },
269
+ workspace: data.workspace || {
270
+ namespace: fetchedProjectId,
271
+ indexName: data.vectorDb.indexName || "retrivora-free"
272
+ },
273
+ projectSettings: normalizeProjectSettings(
274
+ fetchedProjectId,
275
+ data.projectSettings || data.settings
276
+ )
277
+ };
278
+ if (licenseKey) {
279
+ try {
280
+ const credUrl = `${baseUrl}/api/v1/credentials`;
281
+ const credRes = await fetch(credUrl, {
282
+ method: "POST",
283
+ headers: __spreadValues(__spreadValues({
284
+ "Content-Type": "application/json"
285
+ }, licenseKey ? { "x-license-key": licenseKey } : {}), fetchedProjectId ? { "x-project-id": fetchedProjectId } : {}),
286
+ body: JSON.stringify({ licenseKey, projectId: fetchedProjectId })
287
+ });
288
+ if (credRes.ok) {
289
+ const credData = await credRes.json();
290
+ if ((credData == null ? void 0 : credData.success) && (credData == null ? void 0 : credData.credentials)) {
291
+ if (credData.credentials.pineconeApiKey && !config.vectorDb.apiKey) {
292
+ config.vectorDb.apiKey = credData.credentials.pineconeApiKey;
293
+ }
294
+ if (credData.credentials.litellmApiKey) {
295
+ config.llm.apiKey = credData.credentials.litellmApiKey;
296
+ config.embedding.apiKey = credData.credentials.litellmApiKey;
297
+ }
298
+ }
299
+ }
300
+ } catch (e) {
301
+ console.warn("[ConfigFetcher] Failed to fetch credentials:", e);
302
+ }
303
+ }
304
+ this.cache.set(cacheKey, { config, cachedAt: now });
305
+ return config;
306
+ }
307
+ }
308
+ } catch (err) {
309
+ console.warn(
310
+ `[ConfigFetcher] Failed to fetch config from ${baseUrl}:`,
311
+ err instanceof Error ? err.message : String(err)
312
+ );
313
+ }
314
+ }
315
+ return null;
316
+ }
317
+ /** Convenience: fetch only vector DB config (backwards compat). */
318
+ static async fetchRemoteVectorConfig(projectId, licenseKey) {
319
+ var _a;
320
+ const config = await this.fetchRemoteConfig(projectId, licenseKey);
321
+ return (_a = config == null ? void 0 : config.vectorDb) != null ? _a : null;
322
+ }
323
+ };
324
+ ConfigFetcher.cache = /* @__PURE__ */ new Map();
325
+ /** In-flight deduplication: concurrent callers for the same key share one network request */
326
+ ConfigFetcher.inflight = /* @__PURE__ */ new Map();
327
+ ConfigFetcher.TTL_MS = 5 * 60 * 1e3;
328
+
329
+ export {
330
+ createDefaultProjectSettings,
331
+ normalizeProjectSettings,
332
+ projectSettingsToUiConfig,
333
+ ConfigFetcher
334
+ };
@@ -0,0 +1,334 @@
1
+ import {
2
+ SDK_VERSION
3
+ } from "./chunk-QUY3E6HJ.mjs";
4
+ import {
5
+ __spreadValues
6
+ } from "./chunk-UT6SZZEC.mjs";
7
+
8
+ // src/core/ProjectSettings.ts
9
+ var DEFAULT_LIFECYCLE_HOOKS = [
10
+ "beforeInitialize",
11
+ "afterInitialize",
12
+ "beforeSend",
13
+ "afterResponse",
14
+ "onMessage",
15
+ "onCitationClick",
16
+ "onFeedback",
17
+ "onError",
18
+ "onReconnect",
19
+ "onFileUpload"
20
+ ];
21
+ var DEFAULT_CONVERSATION_FEATURES = [
22
+ "History",
23
+ "Resume",
24
+ "Search",
25
+ "Export",
26
+ "Rename",
27
+ "Delete",
28
+ "Tags",
29
+ "Pinned",
30
+ "Unread",
31
+ "Ratings"
32
+ ];
33
+ function createDefaultProjectSettings(projectId) {
34
+ return {
35
+ projectId,
36
+ branding: {
37
+ companyName: "Retrivora AI",
38
+ botName: "Retrivora Assistant",
39
+ welcomeMessage: "Hi, I can help you search your knowledge base.",
40
+ primaryColor: "#6366f1",
41
+ secondaryColor: "#8b5cf6",
42
+ fontFamily: "Inter",
43
+ borderRadius: 14,
44
+ logoUrl: "",
45
+ avatarUrl: "",
46
+ customCss: ""
47
+ },
48
+ ai: {
49
+ defaultModel: "llama-3.1-8b-instant",
50
+ embeddingModel: "text-embedding-3-small",
51
+ systemPrompt: "Answer using the connected knowledge base. Cite sources when available.",
52
+ memoryEnabled: true,
53
+ multiModelEnabled: true,
54
+ citationsEnabled: true,
55
+ fileUploadEnabled: true
56
+ },
57
+ auth: {
58
+ mode: "public",
59
+ allowedOrigins: [],
60
+ requireVerifiedEmail: false,
61
+ sessionTtlMinutes: 1440
62
+ },
63
+ widget: {
64
+ position: "bottom-right",
65
+ theme: "light",
66
+ lazyLoad: true,
67
+ autoReconnect: true,
68
+ persistConversations: true,
69
+ showRetrivoraBranding: false
70
+ },
71
+ telemetry: {
72
+ enabled: true,
73
+ collectBrowser: true,
74
+ collectCountry: false,
75
+ redactPii: true,
76
+ retentionDays: 30
77
+ },
78
+ lifecycleHooks: DEFAULT_LIFECYCLE_HOOKS,
79
+ conversationFeatures: DEFAULT_CONVERSATION_FEATURES
80
+ };
81
+ }
82
+ function cleanString(value, fallback, maxLength = 2e3) {
83
+ if (typeof value !== "string") return fallback;
84
+ return value.trim().slice(0, maxLength);
85
+ }
86
+ function cleanBoolean(value, fallback) {
87
+ return typeof value === "boolean" ? value : fallback;
88
+ }
89
+ function cleanNumber(value, fallback, min, max) {
90
+ const num = typeof value === "number" ? value : Number(value);
91
+ if (!Number.isFinite(num)) return fallback;
92
+ return Math.min(Math.max(Math.round(num), min), max);
93
+ }
94
+ function cleanEnum(value, fallback, allowed) {
95
+ return typeof value === "string" && allowed.includes(value) ? value : fallback;
96
+ }
97
+ function cleanStringList(value, fallback, maxItems = 20) {
98
+ if (!Array.isArray(value)) return fallback;
99
+ const cleaned = value.filter((item) => typeof item === "string").map((item) => item.trim()).filter(Boolean).slice(0, maxItems);
100
+ return cleaned.length > 0 ? Array.from(new Set(cleaned)) : fallback;
101
+ }
102
+ function normalizeProjectSettings(projectId, input) {
103
+ const defaults = createDefaultProjectSettings(projectId);
104
+ const branding = (input == null ? void 0 : input.branding) || {};
105
+ const ai = (input == null ? void 0 : input.ai) || {};
106
+ const auth = (input == null ? void 0 : input.auth) || {};
107
+ const widget = (input == null ? void 0 : input.widget) || {};
108
+ const telemetry = (input == null ? void 0 : input.telemetry) || {};
109
+ return {
110
+ projectId,
111
+ branding: {
112
+ companyName: cleanString(branding.companyName, defaults.branding.companyName, 120),
113
+ botName: cleanString(branding.botName, defaults.branding.botName, 120),
114
+ welcomeMessage: cleanString(branding.welcomeMessage, defaults.branding.welcomeMessage, 500),
115
+ primaryColor: cleanString(branding.primaryColor, defaults.branding.primaryColor, 32),
116
+ secondaryColor: cleanString(branding.secondaryColor, defaults.branding.secondaryColor, 32),
117
+ fontFamily: cleanString(branding.fontFamily, defaults.branding.fontFamily, 80),
118
+ borderRadius: cleanNumber(branding.borderRadius, defaults.branding.borderRadius, 0, 32),
119
+ logoUrl: cleanString(branding.logoUrl, defaults.branding.logoUrl, 500),
120
+ avatarUrl: cleanString(branding.avatarUrl, defaults.branding.avatarUrl, 500),
121
+ customCss: cleanString(branding.customCss, defaults.branding.customCss, 5e3)
122
+ },
123
+ ai: {
124
+ defaultModel: cleanString(ai.defaultModel, defaults.ai.defaultModel, 120),
125
+ embeddingModel: cleanString(ai.embeddingModel, defaults.ai.embeddingModel, 120),
126
+ systemPrompt: cleanString(ai.systemPrompt, defaults.ai.systemPrompt, 5e3),
127
+ memoryEnabled: cleanBoolean(ai.memoryEnabled, defaults.ai.memoryEnabled),
128
+ multiModelEnabled: cleanBoolean(ai.multiModelEnabled, defaults.ai.multiModelEnabled),
129
+ citationsEnabled: cleanBoolean(ai.citationsEnabled, defaults.ai.citationsEnabled),
130
+ fileUploadEnabled: cleanBoolean(ai.fileUploadEnabled, defaults.ai.fileUploadEnabled)
131
+ },
132
+ auth: {
133
+ mode: cleanEnum(auth.mode, defaults.auth.mode, ["public", "anonymous", "jwt", "oauth", "okta", "auth0", "supabase", "firebase", "sso", "custom_token"]),
134
+ allowedOrigins: cleanStringList(auth.allowedOrigins, defaults.auth.allowedOrigins, 25),
135
+ requireVerifiedEmail: cleanBoolean(auth.requireVerifiedEmail, defaults.auth.requireVerifiedEmail),
136
+ sessionTtlMinutes: cleanNumber(auth.sessionTtlMinutes, defaults.auth.sessionTtlMinutes, 15, 43200)
137
+ },
138
+ widget: {
139
+ position: cleanEnum(widget.position, defaults.widget.position, ["bottom-right", "bottom-left", "top-right", "top-left"]),
140
+ theme: cleanEnum(widget.theme, defaults.widget.theme, ["light", "dark", "system"]),
141
+ lazyLoad: cleanBoolean(widget.lazyLoad, defaults.widget.lazyLoad),
142
+ autoReconnect: cleanBoolean(widget.autoReconnect, defaults.widget.autoReconnect),
143
+ persistConversations: cleanBoolean(widget.persistConversations, defaults.widget.persistConversations),
144
+ showRetrivoraBranding: cleanBoolean(widget.showRetrivoraBranding, defaults.widget.showRetrivoraBranding)
145
+ },
146
+ telemetry: {
147
+ enabled: cleanBoolean(telemetry.enabled, defaults.telemetry.enabled),
148
+ collectBrowser: cleanBoolean(telemetry.collectBrowser, defaults.telemetry.collectBrowser),
149
+ collectCountry: cleanBoolean(telemetry.collectCountry, defaults.telemetry.collectCountry),
150
+ redactPii: cleanBoolean(telemetry.redactPii, defaults.telemetry.redactPii),
151
+ retentionDays: cleanNumber(telemetry.retentionDays, defaults.telemetry.retentionDays, 1, 365)
152
+ },
153
+ lifecycleHooks: cleanStringList(input == null ? void 0 : input.lifecycleHooks, defaults.lifecycleHooks, 30),
154
+ conversationFeatures: cleanStringList(input == null ? void 0 : input.conversationFeatures, defaults.conversationFeatures, 30),
155
+ updatedAt: input == null ? void 0 : input.updatedAt
156
+ };
157
+ }
158
+ function projectSettingsToUiConfig(settings) {
159
+ return {
160
+ title: settings.branding.botName,
161
+ subtitle: settings.branding.companyName,
162
+ primaryColor: settings.branding.primaryColor,
163
+ accentColor: settings.branding.secondaryColor,
164
+ logoUrl: settings.branding.logoUrl || settings.branding.avatarUrl,
165
+ welcomeMessage: settings.branding.welcomeMessage,
166
+ poweredBy: settings.widget.showRetrivoraBranding ? "Retrivora AI" : "",
167
+ allowUpload: settings.ai.fileUploadEnabled,
168
+ showSources: settings.ai.citationsEnabled,
169
+ borderRadius: settings.branding.borderRadius <= 4 ? "sm" : settings.branding.borderRadius <= 8 ? "md" : settings.branding.borderRadius <= 16 ? "xl" : "full"
170
+ };
171
+ }
172
+
173
+ // src/core/ConfigFetcher.ts
174
+ var CONTROL_PLANE_URL = "https://www.retrivora.com";
175
+ var LLM_PROXY_BASE_URL = "https://llm.retrivora.com/api/v1";
176
+ var ConfigFetcher = class {
177
+ // 5-minute in-memory session cache
178
+ /**
179
+ * Fetch full project configuration (vectorDb + embedding + llm + workspace) from Retrivora Control Plane.
180
+ *
181
+ * The SDK calls https://www.retrivora.com/api/v1/config with the project ID and license key.
182
+ * The server validates the license against the database and returns:
183
+ * - validity (tier, isActive, expiresAt)
184
+ * - LLM model info
185
+ * - embedding model info
186
+ * - Pinecone index name and workspace/namespace
187
+ *
188
+ * The Pinecone API key is NOT returned (server-only). The SDK uses local
189
+ * PINECONE_API_KEY if available, or vector operations are handled server-side.
190
+ */
191
+ static async fetchRemoteConfig(projectId, licenseKey) {
192
+ const cacheKey = `${projectId}:${licenseKey || ""}`;
193
+ const now = Date.now();
194
+ const cached = this.cache.get(cacheKey);
195
+ if (cached && now - cached.cachedAt < this.TTL_MS) {
196
+ return cached.config;
197
+ }
198
+ const existingInflight = this.inflight.get(cacheKey);
199
+ if (existingInflight) {
200
+ return existingInflight;
201
+ }
202
+ const promise = this._doFetch(projectId, licenseKey, cacheKey, now);
203
+ this.inflight.set(cacheKey, promise);
204
+ try {
205
+ return await promise;
206
+ } finally {
207
+ this.inflight.delete(cacheKey);
208
+ }
209
+ }
210
+ /** Internal: performs the actual HTTP fetch. Shared by all callers via inflight dedup. */
211
+ static async _doFetch(projectId, licenseKey, cacheKey, now) {
212
+ var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k;
213
+ const controlPlaneUrls = [
214
+ process.env.RETRIVORA_CONTROL_PLANE_URL,
215
+ process.env.NEXT_PUBLIC_RETRIVORA_CONTROL_PLANE_URL,
216
+ CONTROL_PLANE_URL
217
+ ].filter((url) => {
218
+ if (!url) return false;
219
+ const isEnvVar = url === process.env.RETRIVORA_CONTROL_PLANE_URL || url === process.env.NEXT_PUBLIC_RETRIVORA_CONTROL_PLANE_URL;
220
+ if (!isEnvVar && (url.includes("localhost") || url.includes("127.0.0.1"))) return false;
221
+ return true;
222
+ }).map((url) => url.replace(/\/$/, ""));
223
+ for (const baseUrl of controlPlaneUrls) {
224
+ try {
225
+ const url = `${baseUrl}/api/v1/config?projectId=${encodeURIComponent(projectId)}`;
226
+ const res = await fetch(url, {
227
+ method: "GET",
228
+ headers: __spreadValues(__spreadValues({
229
+ "Content-Type": "application/json",
230
+ "x-sdk-version": SDK_VERSION
231
+ }, licenseKey ? { "x-license-key": licenseKey } : {}), projectId ? { "x-project-id": projectId } : {})
232
+ });
233
+ if (!res.ok) {
234
+ console.warn(`[ConfigFetcher] Error text: ${await res.text()}`);
235
+ }
236
+ if (res.ok) {
237
+ const data = await res.json();
238
+ if ((data == null ? void 0 : data.success) && (data == null ? void 0 : data.vectorDb)) {
239
+ const fetchedProjectId = data.projectId || projectId;
240
+ const config = {
241
+ projectId: fetchedProjectId,
242
+ tier: data.tier,
243
+ isActive: data.isActive,
244
+ expiresAt: data.expiresAt,
245
+ vectorDb: {
246
+ // Fetch apiKey from credentials API if available, else fallback to empty
247
+ apiKey: data.vectorDb.apiKey || "",
248
+ indexName: data.vectorDb.indexName || "retrivora-free",
249
+ provider: data.vectorDb.provider || "pinecone",
250
+ projectId: fetchedProjectId,
251
+ namespace: ((_a = data.workspace) == null ? void 0 : _a.namespace) || data.vectorDb.namespace || fetchedProjectId
252
+ },
253
+ embedding: {
254
+ provider: ((_b = data.embedding) == null ? void 0 : _b.provider) || "universal_rest",
255
+ model: ((_c = data.embedding) == null ? void 0 : _c.model) || "text-embedding-004",
256
+ // Route through www.retrivora.com proxy, not llm.retrivora.com directly.
257
+ baseUrl: ((_d = data.embedding) == null ? void 0 : _d.baseUrl) || LLM_PROXY_BASE_URL,
258
+ apiKey: ((_e = data.embedding) == null ? void 0 : _e.apiKey) || licenseKey || "",
259
+ profile: ((_f = data.embedding) == null ? void 0 : _f.profile) || "litellm"
260
+ },
261
+ llm: {
262
+ provider: ((_g = data.llm) == null ? void 0 : _g.provider) || "universal_rest",
263
+ model: ((_h = data.llm) == null ? void 0 : _h.model) || "llama-3.1-8b-instant",
264
+ // Route through www.retrivora.com proxy, not llm.retrivora.com directly.
265
+ baseUrl: ((_i = data.llm) == null ? void 0 : _i.baseUrl) || LLM_PROXY_BASE_URL,
266
+ apiKey: ((_j = data.llm) == null ? void 0 : _j.apiKey) || licenseKey || "",
267
+ profile: ((_k = data.llm) == null ? void 0 : _k.profile) || "litellm"
268
+ },
269
+ workspace: data.workspace || {
270
+ namespace: fetchedProjectId,
271
+ indexName: data.vectorDb.indexName || "retrivora-free"
272
+ },
273
+ projectSettings: normalizeProjectSettings(
274
+ fetchedProjectId,
275
+ data.projectSettings || data.settings
276
+ )
277
+ };
278
+ if (licenseKey) {
279
+ try {
280
+ const credUrl = `${baseUrl}/api/v1/credentials`;
281
+ const credRes = await fetch(credUrl, {
282
+ method: "POST",
283
+ headers: __spreadValues(__spreadValues({
284
+ "Content-Type": "application/json"
285
+ }, licenseKey ? { "x-license-key": licenseKey } : {}), fetchedProjectId ? { "x-project-id": fetchedProjectId } : {}),
286
+ body: JSON.stringify({ licenseKey, projectId: fetchedProjectId })
287
+ });
288
+ if (credRes.ok) {
289
+ const credData = await credRes.json();
290
+ if ((credData == null ? void 0 : credData.success) && (credData == null ? void 0 : credData.credentials)) {
291
+ if (credData.credentials.pineconeApiKey && !config.vectorDb.apiKey) {
292
+ config.vectorDb.apiKey = credData.credentials.pineconeApiKey;
293
+ }
294
+ if (credData.credentials.litellmApiKey) {
295
+ config.llm.apiKey = credData.credentials.litellmApiKey;
296
+ config.embedding.apiKey = credData.credentials.litellmApiKey;
297
+ }
298
+ }
299
+ }
300
+ } catch (e) {
301
+ console.warn("[ConfigFetcher] Failed to fetch credentials:", e);
302
+ }
303
+ }
304
+ this.cache.set(cacheKey, { config, cachedAt: now });
305
+ return config;
306
+ }
307
+ }
308
+ } catch (err) {
309
+ console.warn(
310
+ `[ConfigFetcher] Failed to fetch config from ${baseUrl}:`,
311
+ err instanceof Error ? err.message : String(err)
312
+ );
313
+ }
314
+ }
315
+ return null;
316
+ }
317
+ /** Convenience: fetch only vector DB config (backwards compat). */
318
+ static async fetchRemoteVectorConfig(projectId, licenseKey) {
319
+ var _a;
320
+ const config = await this.fetchRemoteConfig(projectId, licenseKey);
321
+ return (_a = config == null ? void 0 : config.vectorDb) != null ? _a : null;
322
+ }
323
+ };
324
+ ConfigFetcher.cache = /* @__PURE__ */ new Map();
325
+ /** In-flight deduplication: concurrent callers for the same key share one network request */
326
+ ConfigFetcher.inflight = /* @__PURE__ */ new Map();
327
+ ConfigFetcher.TTL_MS = 5 * 60 * 1e3;
328
+
329
+ export {
330
+ createDefaultProjectSettings,
331
+ normalizeProjectSettings,
332
+ projectSettingsToUiConfig,
333
+ ConfigFetcher
334
+ };