@retrivora-ai/rag-engine 1.9.7 → 1.9.8

package/src/server.ts

@@ -25,6 +25,7 @@ export type { ILLMProvider, EmbedOptions } from './llm/ILLMProvider';
 export type { Chunk, ChunkOptions } from './rag/DocumentChunker';
 export type { HealthCheckResult, IProviderValidator, IProviderHealthChecker } from './core/ProviderInterfaces';
 export type { ValidationError } from './core/ConfigValidator';
+export type { LicensePayload } from './core/LicenseVerifier';
 export type { BatchOptions, BatchResult } from './core/BatchProcessor';
 
 // ── Core Orchestration ─────────────────────────────────────────
@@ -34,6 +35,7 @@ export { Pipeline } from './core/Pipeline';
 export { ConfigResolver } from './core/ConfigResolver';
 export { ProviderRegistry } from './core/ProviderRegistry';
 export { ConfigValidator } from './core/ConfigValidator';
+export { LicenseVerifier } from './core/LicenseVerifier';
 export { ProviderHealthCheck } from './core/ProviderHealthCheck';
 export { BatchProcessor } from './core/BatchProcessor';
 
@@ -65,6 +67,8 @@ export { LLMFactory } from './llm/LLMFactory';
 export { OpenAIProvider } from './llm/providers/OpenAIProvider';
 export { AnthropicProvider } from './llm/providers/AnthropicProvider';
 export { OllamaProvider } from './llm/providers/OllamaProvider';
+export { GroqProvider } from './llm/providers/GroqProvider';
+export { QwenProvider } from './llm/providers/QwenProvider';
 export { UniversalLLMAdapter } from './llm/providers/UniversalLLMAdapter';
 
 // ── Next.js Route Handler Factories ───────────────────────────
@@ -74,6 +78,9 @@ export {
   createIngestHandler,
   createHealthHandler,
   createUploadHandler,
+  createHistoryHandler,
+  createFeedbackHandler,
+  createSessionsHandler,
   createRagHandler,
   sseFrame,
   sseTextFrame,

package/src/types/chat.ts

@@ -41,6 +41,12 @@ export interface ChatOptions {
 export interface UseRagChatOptions {
   /** Override the chat API endpoint (default: /api/chat) */
   apiUrl?: string;
+  /**
+   * Base URL for the Retrivora SDK catch-all route used for history, feedback,
+   * and sessions endpoints. Defaults to '/api/retrivora'.
+   * e.g. if your catch-all is at /api/retrivora/[[...retrivora]], set this to '/api/retrivora'.
+   */
+  retrivoraApiBase?: string;
   /** Override project namespace */
   namespace?: string;
   /** Persist chat history to localStorage (default: true) */
@@ -51,6 +57,8 @@ export interface UseRagChatOptions {
   onError?: (error: string) => void;
   /** Optional custom headers to send with the chat request */
   headers?: Record<string, string>;
+  /** Session ID for history and feedback tracking (default: 'default') */
+  sessionId?: string;
 }
 
 export interface UseRagChatReturn {
@@ -70,4 +78,10 @@ export interface UseRagChatReturn {
   setMessages: React.Dispatch<React.SetStateAction<RagMessage[]>>;
   /** Abort the current active stream request */
   stop: () => void;
+  /** Load message history from database storage */
+  loadHistory: (sessionId: string) => Promise<void>;
+  /** Clear conversation history from database and locally */
+  clearHistory: (sessionId: string) => Promise<void>;
+  /** Submit rating and optional comment for a specific assistant message */
+  submitFeedback: (messageId: string, rating: 'thumbs_up' | 'thumbs_down', comment?: string) => Promise<void>;
 }

package/src/types/props.ts

@@ -57,6 +57,11 @@ export interface ChatWindowProps {
   onAddToCart?: (product: Product) => void;
   /** Optional custom API URL to send chat messages to */
   apiUrl?: string;
+  /**
+   * Base URL for Retrivora SDK history/feedback/sessions endpoints.
+   * Defaults to '/api/retrivora'. Set this to match your catch-all route location.
+   */
+  retrivoraApiBase?: string;
   /** Optional custom headers to send with the chat request */
   headers?: Record<string, string>;
 }
@@ -68,6 +73,11 @@ export interface ChatWidgetProps {
   onAddToCart?: (product: Product) => void;
   /** Optional custom API URL to send chat messages to */
   apiUrl?: string;
+  /**
+   * Base URL for Retrivora SDK history/feedback/sessions endpoints.
+   * Defaults to '/api/retrivora'.
+   */
+  retrivoraApiBase?: string;
   /** Optional custom headers to send with the chat request */
   headers?: Record<string, string>;
 }
@@ -80,6 +90,8 @@ export interface MessageBubbleProps {
   accentColor: string;
   onAddToCart?: (product: Product) => void;
   viewportSize?: ChatViewportSize;
+  /** Called when the user clicks thumbs up or thumbs down on an assistant message */
+  onFeedback?: (messageId: string, rating: 'thumbs_up' | 'thumbs_down') => void;
 }
 
 export interface ProductCardProps {

package/.env.example

@@ -1,80 +0,0 @@
-# ─── Project ─────────────────────────────────────────────────
-RAG_PROJECT_ID=my-project
-
-# ─── Vector Database ──────────────────────────────────────────
-# Choose: pinecone | pgvector | rest | universal_rest
-VECTOR_DB_PROVIDER=pinecone
-VECTOR_DB_INDEX=rag-index
-
-# Pinecone (if provider=pinecone)
-PINECONE_API_KEY=your-pinecone-api-key
-PINECONE_ENVIRONMENT=us-east-1
-
-# pgVector (if provider=pgvector)
-PGVECTOR_CONNECTION_STRING=postgresql://user:password@localhost:5432/StagVectorDB
-
-# Generic REST (if provider=rest)
-VECTOR_DB_REST_URL=http://localhost:8080
-VECTOR_DB_REST_API_KEY=your-rest-api-key
-# VECTOR_DB_QUERY_PATH=/query
-# VECTOR_DB_UPSERT_PATH=/upsert
-
-# ─── LLM ──────────────────────────────────────────────────────
-# Choose: openai | anthropic | ollama | gemini | universal_rest
-LLM_PROVIDER=openai
-LLM_MODEL=gpt-4o
-LLM_MAX_TOKENS=1024
-LLM_TEMPERATURE=0.7
-LLM_SYSTEM_PROMPT=You are a helpful assistant. Use the provided context to answer questions accurately.
-
-# OpenAI (if provider=openai)
-OPENAI_API_KEY=sk-...
-
-# Anthropic (if provider=anthropic)
-ANTHROPIC_API_KEY=sk-ant-...
-
-# Gemini (if provider=gemini)
-GEMINI_API_KEY=AIza...
-
-# Ollama (if provider=ollama)
-LLM_BASE_URL=http://localhost:11434
-
-# ── Master Universal Provider (LiteLLM, Qdrant, etc.) ─────────
-# Use 'universal_rest' for ANY model or DB via pre-set profiles.
-LLM_PROVIDER=universal_rest
-LLM_MODEL=gpt-4o
-# Profile: litellm | ollama-standard | openai-compatible
-LLM_UNIVERSAL_PROFILE=litellm
-LLM_BASE_URL=https://proxy.example.com/api
-LLM_API_KEY=your-key
-
-VECTOR_DB_PROVIDER=universal_rest
-# Profile: qdrant | chromadb
-VECTOR_UNIVERSAL_PROFILE=qdrant
-VECTOR_BASE_URL=http://localhost:6333
-VECTOR_DB_INDEX=my-index
-
-# ─── Embedding ────────────────────────────────────────────────
-# Choose: openai | ollama | gemini | custom
-EMBEDDING_PROVIDER=openai
-EMBEDDING_MODEL=text-embedding-3-small
-EMBEDDING_DIMENSIONS=1536
-# EMBEDDING_BASE_URL=http://localhost:11434  # for ollama
-# EMBEDDING_API_KEY=your-embedding-key       # for custom embedding endpoints
-
-# ─── RAG Pipeline Tuning ──────────────────────────────────────
-RAG_TOP_K=5
-RAG_SCORE_THRESHOLD=0.0
-RAG_CHUNK_SIZE=1000
-RAG_CHUNK_OVERLAP=200
-
-# ─── UI Branding (NEXT_PUBLIC_ = safe to expose to browser) ───
-NEXT_PUBLIC_PROJECT_ID=my-project
-NEXT_PUBLIC_UI_TITLE=AI Assistant
-NEXT_PUBLIC_UI_SUBTITLE=Powered by RAG
-NEXT_PUBLIC_PRIMARY_COLOR=#6366f1
-NEXT_PUBLIC_ACCENT_COLOR=#8b5cf6
-NEXT_PUBLIC_PLACEHOLDER=Ask me anything…
-NEXT_PUBLIC_SHOW_SOURCES=true
-NEXT_PUBLIC_WELCOME_MESSAGE=Hello! I'm your AI assistant. Ask me anything about your documents.
-# NEXT_PUBLIC_LOGO_URL=https://your-domain.com/logo.png

package/LICENSE.txt

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) [2026] [Abhinav Alkuchi]
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.