@retrivora-ai/rag-engine 1.2.1 → 1.2.3

package/dist/{RagConfig-BOLOz0_O.d.ts → index-Cti1u0y1.d.ts}

@@ -1,62 +1,12 @@
-interface VectorMatch {
-    id: string | number;
-    score: number;
-    content: string;
-    metadata?: Record<string, unknown>;
-}
-interface UpsertDocument {
-    id: string | number;
-    vector: number[];
+type MessageRole = 'user' | 'assistant' | 'system';
+interface ChatMessage {
+    role: MessageRole;
     content: string;
-    metadata?: Record<string, unknown>;
 }
-interface IngestDocument {
-    docId: string | number;
-    content: string;
-    metadata?: Record<string, unknown>;
-}
-interface ChatResponse {
-    reply: string;
-    sources: VectorMatch[];
-    graphData?: GraphSearchResult;
-}
-interface GraphNode {
+interface RagMessage extends ChatMessage {
     id: string;
-    label: string;
-    properties?: Record<string, unknown>;
-}
-interface Edge {
-    source: string;
-    target: string;
-    type: string;
-    properties?: Record<string, unknown>;
-}
-interface GraphSearchResult {
-    nodes: GraphNode[];
-    edges: Edge[];
-}
-interface RetrievalResult {
-    sources: VectorMatch[];
-    graphData?: GraphSearchResult;
-}
-interface Product {
-    id: string | number;
-    name: string;
-    brand?: string;
-    price?: string | number;
-    image?: string;
-    link?: string;
-    description?: string;
-}
-
-/**
- * Generic LLM Provider interface.
- * Covers both chat completion and embedding generation so a single
- * provider can handle both responsibilities when appropriate.
- */
-interface ChatMessage {
-    role: 'user' | 'assistant' | 'system';
-    content: string;
+    sources?: VectorMatch[];
+    createdAt: string;
 }
 interface ChatOptions {
     /** Override max tokens for this specific call */
@@ -66,44 +16,33 @@ interface ChatOptions {
     /** Stop sequences */
     stop?: string[];
 }
-interface EmbedOptions {
-    /** Override model for this specific embed call */
-    model?: string;
-    /** Specify the task type for models that require prefixes (e.g. nomic-embed-text) */
-    taskType?: 'query' | 'document';
+interface UseRagChatOptions {
+    /** Override the chat API endpoint (default: /api/chat) */
+    apiUrl?: string;
+    /** Override project namespace */
+    namespace?: string;
+    /** Persist chat history to localStorage (default: true) */
+    persist?: boolean;
+    /** Called after each successful assistant reply */
+    onReply?: (message: RagMessage) => void;
+    /** Called on error */
+    onError?: (error: string) => void;
 }
-interface ILLMProvider {
-    /**
-     * Send a chat completion request.
-     * @param messages – the full conversation history
-     * @param context  – retrieved RAG context to inject
-     * @param options  – optional per-call overrides
-     * @returns        – the assistant's reply text
-     */
-    chat(messages: ChatMessage[], context: string, options?: ChatOptions): Promise<string>;
-    /**
-     * Send a streaming chat completion request.
-     * @returns – an async iterable of text chunks
-     */
-    chatStream?(messages: ChatMessage[], context: string, options?: ChatOptions): AsyncIterable<string>;
-    /**
-     * Generate an embedding vector for the given text.
-     * @param text    – text to embed
-     * @param options – optional overrides
-     * @returns       – float array (the embedding)
-     */
-    embed(text: string, options?: EmbedOptions): Promise<number[]>;
-    /**
-     * Generate embedding vectors for multiple texts in a single batch.
-     * @param texts   – array of texts to embed
-     * @param options – optional overrides
-     * @returns       – array of float arrays
-     */
-    batchEmbed(texts: string[], options?: EmbedOptions): Promise<number[][]>;
-    /**
-     * Check if the provider endpoint is reachable.
-     */
-    ping(): Promise<boolean>;
+interface UseRagChatReturn {
+    /** All messages in the current conversation */
+    messages: RagMessage[];
+    /** Whether a response is in flight */
+    isLoading: boolean;
+    /** Current error message, or null */
+    error: string | null;
+    /** Send a user message */
+    send: (text: string) => Promise<void>;
+    /** Clear the conversation (and localStorage if persist=true) */
+    clear: () => void;
+    /** Retry the last failed send */
+    retry: () => Promise<void>;
+    /** Programmatically set the conversation (e.g. to restore from a DB) */
+    setMessages: React.Dispatch<React.SetStateAction<RagMessage[]>>;
 }
 
 /**
@@ -233,6 +172,8 @@ interface UIConfig {
     allowUpload?: boolean;
     /** Whether to allow manual resizing of the chat window. Defaults to true. */
     allowResize?: boolean;
+    /** Whether to enable voice search input. Defaults to true. */
+    enableVoiceInput?: boolean;
 }
 interface RAGConfig {
     /** Number of top-K chunks retrieved per query */
@@ -280,4 +221,55 @@ interface RagConfig {
     graphDb?: GraphDBConfig;
 }
 
-export type { ChatMessage as C, EmbedOptions as E, GraphDBConfig as G, ILLMProvider as I, LLMConfig as L, Product as P, RAGConfig as R, UIConfig as U, VectorMatch as V, ChatOptions as a, ChatResponse as b, EmbeddingConfig as c, EmbeddingProvider as d, IngestDocument as e, LLMProvider as f, RagConfig as g, UpsertDocument as h, VectorDBConfig as i, VectorDBProvider as j, RetrievalResult as k, GraphNode as l, Edge as m, GraphSearchResult as n };
+interface VectorMatch {
+    id: string | number;
+    score: number;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface UpsertDocument {
+    id: string | number;
+    vector: number[];
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface IngestDocument {
+    docId: string | number;
+    content: string;
+    metadata?: Record<string, unknown>;
+}
+interface ChatResponse {
+    reply: string;
+    sources: VectorMatch[];
+    graphData?: GraphSearchResult;
+}
+interface GraphNode {
+    id: string;
+    label: string;
+    properties?: Record<string, unknown>;
+}
+interface Edge {
+    source: string;
+    target: string;
+    type: string;
+    properties?: Record<string, unknown>;
+}
+interface GraphSearchResult {
+    nodes: GraphNode[];
+    edges: Edge[];
+}
+interface RetrievalResult {
+    sources: VectorMatch[];
+    graphData?: GraphSearchResult;
+}
+interface Product {
+    id: string | number;
+    name: string;
+    brand?: string;
+    price?: string | number;
+    image?: string;
+    link?: string;
+    description?: string;
+}
+
+export type { ChatMessage as C, EmbeddingConfig as E, GraphDBConfig as G, IngestDocument as I, LLMConfig as L, Product as P, RagMessage as R, UIConfig as U, VectorMatch as V, UseRagChatOptions as a, UseRagChatReturn as b, ChatOptions as c, ChatResponse as d, EmbeddingProvider as e, LLMProvider as f, RAGConfig as g, RagConfig as h, UpsertDocument as i, VectorDBConfig as j, VectorDBProvider as k, RetrievalResult as l, GraphNode as m, Edge as n, GraphSearchResult as o };

package/dist/{index-64BDupW3.d.mts → index-kUXnRvuI.d.mts}

@@ -1,4 +1,4 @@
-import { g as RagConfig, C as ChatMessage, b as ChatResponse, e as IngestDocument } from './RagConfig-BOLOz0_O.mjs';
+import { h as RagConfig, C as ChatMessage, d as ChatResponse, I as IngestDocument } from './index-Cti1u0y1.mjs';
 import { NextRequest, NextResponse } from 'next/server';
 
 interface ValidationError {

package/dist/index.d.mts

@@ -1,27 +1,19 @@
-import React$1, { ReactNode } from 'react';
-import { P as Product, C as ChatMessage, V as VectorMatch, U as UIConfig } from './RagConfig-BOLOz0_O.mjs';
-export { a as ChatOptions, b as ChatResponse, E as EmbedOptions, c as EmbeddingConfig, d as EmbeddingProvider, I as ILLMProvider, e as IngestDocument, L as LLMConfig, f as LLMProvider, R as RAGConfig, g as RagConfig, h as UpsertDocument, i as VectorDBConfig, j as VectorDBProvider } from './RagConfig-BOLOz0_O.mjs';
-export { C as Chunk, a as ChunkOptions } from './DocumentChunker-Dh9TvmGG.mjs';
-
-interface ChatWidgetProps {
-    /** Position of the floating button. Defaults to bottom-right. */
-    position?: 'bottom-right' | 'bottom-left';
-    /** Called when the user clicks 'Add to Cart' on a product */
-    onAddToCart?: (product: Product) => void;
-}
-declare function ChatWidget({ position, onAddToCart }: ChatWidgetProps): React$1.JSX.Element | null;
+import React, { CSSProperties, MouseEvent, ReactNode } from 'react';
+import { P as Product, U as UIConfig, R as RagMessage, V as VectorMatch, a as UseRagChatOptions, b as UseRagChatReturn } from './index-Cti1u0y1.mjs';
+export { C as ChatMessage, c as ChatOptions, d as ChatResponse, E as EmbeddingConfig, e as EmbeddingProvider, I as IngestDocument, L as LLMConfig, f as LLMProvider, g as RAGConfig, h as RagConfig, i as UpsertDocument, j as VectorDBConfig, k as VectorDBProvider } from './index-Cti1u0y1.mjs';
+export { C as Chunk, a as ChunkOptions, E as EmbedOptions, I as ILLMProvider } from './DocumentChunker-D1dg5iCi.mjs';
 
 interface ChatWindowProps {
     /** Additional className for the wrapper div */
     className?: string;
     /** Inline styles for the wrapper div */
-    style?: React$1.CSSProperties;
+    style?: CSSProperties;
     /** Called when the close button is clicked (for widget mode) */
     onClose?: () => void;
     /** Whether to show a close (X) button in the header */
     showClose?: boolean;
     /** Called when the user starts dragging the resize handle */
-    onResizeStart?: (e: React$1.MouseEvent) => void;
+    onResizeStart?: (e: MouseEvent) => void;
     /** Called when the user clicks the reset size button */
     onResetResize?: () => void;
     /** Whether the window has been resized from its default */
@@ -33,8 +25,30 @@ interface ChatWindowProps {
     /** Called when the user clicks 'Add to Cart' on a product */
     onAddToCart?: (product: Product) => void;
 }
-declare function ChatWindow({ className, style, onClose, showClose, onResizeStart, onResetResize, isResized, onMaximize, isMaximized, onAddToCart }: ChatWindowProps): React$1.JSX.Element;
-
+interface ChatWidgetProps {
+    /** Position of the floating button. Defaults to bottom-right. */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Called when the user clicks 'Add to Cart' on a product */
+    onAddToCart?: (product: Product) => void;
+}
+interface MessageBubbleProps {
+    message: RagMessage;
+    sources?: VectorMatch[];
+    isStreaming?: boolean;
+    primaryColor: string;
+    accentColor: string;
+    onAddToCart?: (product: Product) => void;
+}
+interface ProductCardProps {
+    product: Product;
+    primaryColor?: string;
+    onAddToCart?: (product: Product) => void;
+}
+interface ProductCarouselProps {
+    products: Product[];
+    primaryColor?: string;
+    onAddToCart?: (product: Product) => void;
+}
 interface DocumentUploadProps {
     /** Optional namespace for the upload */
     namespace?: string;
@@ -43,82 +57,42 @@ interface DocumentUploadProps {
     /** Additional className */
     className?: string;
 }
-declare function DocumentUpload({ namespace, onUploadComplete, className }: DocumentUploadProps): React$1.JSX.Element;
-
-interface MessageBubbleProps {
-    message: ChatMessage;
-    sources?: VectorMatch[];
-    isStreaming?: boolean;
-    primaryColor?: string;
-    accentColor?: string;
-    onAddToCart?: (product: Product) => void;
-}
-declare function MessageBubble({ message, sources, isStreaming, primaryColor, accentColor, onAddToCart, }: MessageBubbleProps): React$1.JSX.Element;
-
 interface SourceCardProps {
     source: VectorMatch;
     index: number;
 }
-declare function SourceCard({ source, index }: SourceCardProps): React$1.JSX.Element;
-
-/**
- * ConfigProvider — React Context that makes RagConfig (UI subset) available
- * to all child components without prop drilling.
- *
- * Only the UI-safe portions of RagConfig are exposed to the client.
- */
-
 interface ClientConfig {
     projectId: string;
     ui: Required<UIConfig>;
 }
-declare function ConfigProvider({ config, children, }: {
+interface ConfigProviderProps {
     config?: {
         projectId?: string;
         ui?: Partial<UIConfig>;
     };
     children: ReactNode;
-}): React$1.JSX.Element;
+}
+
+declare function ChatWidget({ position, onAddToCart }: ChatWidgetProps): React.JSX.Element | null;
+
+declare function ChatWindow({ className, style, onClose, showClose, onResizeStart, onResetResize, isResized, onMaximize, isMaximized, onAddToCart }: ChatWindowProps): React.JSX.Element;
+
+declare function DocumentUpload({ namespace, onUploadComplete, className }: DocumentUploadProps): React.JSX.Element;
+
+declare function MessageBubble({ message, sources, isStreaming, primaryColor, accentColor, onAddToCart, }: MessageBubbleProps): React.JSX.Element;
+
+declare function SourceCard({ source, index }: SourceCardProps): React.JSX.Element;
+
+/**
+ * ConfigProvider — React Context that makes RagConfig (UI subset) available
+ * to all child components without prop drilling.
+ *
+ * Only the UI-safe portions of RagConfig are exposed to the client.
+ */
+
+declare function ConfigProvider({ config, children, }: ConfigProviderProps): React.JSX.Element;
 declare function useConfig(): ClientConfig;
 
-type MessageRole = 'user' | 'assistant';
-interface RagMessage {
-    id: string;
-    role: MessageRole;
-    content: string;
-    /** Retrieved source chunks (assistant messages only) */
-    sources?: VectorMatch[];
-    /** ISO timestamp */
-    createdAt: string;
-}
-interface UseRagChatOptions {
-    /** Override the chat API endpoint (default: /api/chat) */
-    apiUrl?: string;
-    /** Override project namespace */
-    namespace?: string;
-    /** Persist chat history to localStorage (default: true) */
-    persist?: boolean;
-    /** Called after each successful assistant reply */
-    onReply?: (message: RagMessage) => void;
-    /** Called on error */
-    onError?: (error: string) => void;
-}
-interface UseRagChatReturn {
-    /** All messages in the current conversation */
-    messages: RagMessage[];
-    /** Whether a response is in flight */
-    isLoading: boolean;
-    /** Current error message, or null */
-    error: string | null;
-    /** Send a user message */
-    send: (text: string) => Promise<void>;
-    /** Clear the conversation (and localStorage if persist=true) */
-    clear: () => void;
-    /** Retry the last failed send */
-    retry: () => Promise<void>;
-    /** Programmatically set the conversation (e.g. to restore from a DB) */
-    setMessages: React.Dispatch<React.SetStateAction<RagMessage[]>>;
-}
 declare function useRagChat(projectId: string, options?: UseRagChatOptions): UseRagChatReturn;
 
-export { ChatMessage, ChatWidget, ChatWindow, type ClientConfig, ConfigProvider, DocumentUpload, MessageBubble, type RagMessage, SourceCard, UIConfig, type UseRagChatOptions, type UseRagChatReturn, VectorMatch, useConfig, useRagChat };
+export { ChatWidget, type ChatWidgetProps, ChatWindow, type ChatWindowProps, type ClientConfig, ConfigProvider, DocumentUpload, type DocumentUploadProps, MessageBubble, type MessageBubbleProps, type ProductCardProps, type ProductCarouselProps, RagMessage, SourceCard, type SourceCardProps, UIConfig, UseRagChatOptions, UseRagChatReturn, VectorMatch, useConfig, useRagChat };

package/dist/index.d.ts

@@ -1,27 +1,19 @@
-import React$1, { ReactNode } from 'react';
-import { P as Product, C as ChatMessage, V as VectorMatch, U as UIConfig } from './RagConfig-BOLOz0_O.js';
-export { a as ChatOptions, b as ChatResponse, E as EmbedOptions, c as EmbeddingConfig, d as EmbeddingProvider, I as ILLMProvider, e as IngestDocument, L as LLMConfig, f as LLMProvider, R as RAGConfig, g as RagConfig, h as UpsertDocument, i as VectorDBConfig, j as VectorDBProvider } from './RagConfig-BOLOz0_O.js';
-export { C as Chunk, a as ChunkOptions } from './DocumentChunker-Dh9TvmGG.js';
-
-interface ChatWidgetProps {
-    /** Position of the floating button. Defaults to bottom-right. */
-    position?: 'bottom-right' | 'bottom-left';
-    /** Called when the user clicks 'Add to Cart' on a product */
-    onAddToCart?: (product: Product) => void;
-}
-declare function ChatWidget({ position, onAddToCart }: ChatWidgetProps): React$1.JSX.Element | null;
+import React, { CSSProperties, MouseEvent, ReactNode } from 'react';
+import { P as Product, U as UIConfig, R as RagMessage, V as VectorMatch, a as UseRagChatOptions, b as UseRagChatReturn } from './index-Cti1u0y1.js';
+export { C as ChatMessage, c as ChatOptions, d as ChatResponse, E as EmbeddingConfig, e as EmbeddingProvider, I as IngestDocument, L as LLMConfig, f as LLMProvider, g as RAGConfig, h as RagConfig, i as UpsertDocument, j as VectorDBConfig, k as VectorDBProvider } from './index-Cti1u0y1.js';
+export { C as Chunk, a as ChunkOptions, E as EmbedOptions, I as ILLMProvider } from './DocumentChunker-BXOUMKoP.js';
 
 interface ChatWindowProps {
     /** Additional className for the wrapper div */
     className?: string;
     /** Inline styles for the wrapper div */
-    style?: React$1.CSSProperties;
+    style?: CSSProperties;
     /** Called when the close button is clicked (for widget mode) */
     onClose?: () => void;
     /** Whether to show a close (X) button in the header */
     showClose?: boolean;
     /** Called when the user starts dragging the resize handle */
-    onResizeStart?: (e: React$1.MouseEvent) => void;
+    onResizeStart?: (e: MouseEvent) => void;
     /** Called when the user clicks the reset size button */
     onResetResize?: () => void;
     /** Whether the window has been resized from its default */
@@ -33,8 +25,30 @@ interface ChatWindowProps {
     /** Called when the user clicks 'Add to Cart' on a product */
     onAddToCart?: (product: Product) => void;
 }
-declare function ChatWindow({ className, style, onClose, showClose, onResizeStart, onResetResize, isResized, onMaximize, isMaximized, onAddToCart }: ChatWindowProps): React$1.JSX.Element;
-
+interface ChatWidgetProps {
+    /** Position of the floating button. Defaults to bottom-right. */
+    position?: 'bottom-right' | 'bottom-left';
+    /** Called when the user clicks 'Add to Cart' on a product */
+    onAddToCart?: (product: Product) => void;
+}
+interface MessageBubbleProps {
+    message: RagMessage;
+    sources?: VectorMatch[];
+    isStreaming?: boolean;
+    primaryColor: string;
+    accentColor: string;
+    onAddToCart?: (product: Product) => void;
+}
+interface ProductCardProps {
+    product: Product;
+    primaryColor?: string;
+    onAddToCart?: (product: Product) => void;
+}
+interface ProductCarouselProps {
+    products: Product[];
+    primaryColor?: string;
+    onAddToCart?: (product: Product) => void;
+}
 interface DocumentUploadProps {
     /** Optional namespace for the upload */
     namespace?: string;
@@ -43,82 +57,42 @@ interface DocumentUploadProps {
     /** Additional className */
     className?: string;
 }
-declare function DocumentUpload({ namespace, onUploadComplete, className }: DocumentUploadProps): React$1.JSX.Element;
-
-interface MessageBubbleProps {
-    message: ChatMessage;
-    sources?: VectorMatch[];
-    isStreaming?: boolean;
-    primaryColor?: string;
-    accentColor?: string;
-    onAddToCart?: (product: Product) => void;
-}
-declare function MessageBubble({ message, sources, isStreaming, primaryColor, accentColor, onAddToCart, }: MessageBubbleProps): React$1.JSX.Element;
-
 interface SourceCardProps {
     source: VectorMatch;
     index: number;
 }
-declare function SourceCard({ source, index }: SourceCardProps): React$1.JSX.Element;
-
-/**
- * ConfigProvider — React Context that makes RagConfig (UI subset) available
- * to all child components without prop drilling.
- *
- * Only the UI-safe portions of RagConfig are exposed to the client.
- */
-
 interface ClientConfig {
     projectId: string;
     ui: Required<UIConfig>;
 }
-declare function ConfigProvider({ config, children, }: {
+interface ConfigProviderProps {
     config?: {
         projectId?: string;
         ui?: Partial<UIConfig>;
     };
     children: ReactNode;
-}): React$1.JSX.Element;
+}
+
+declare function ChatWidget({ position, onAddToCart }: ChatWidgetProps): React.JSX.Element | null;
+
+declare function ChatWindow({ className, style, onClose, showClose, onResizeStart, onResetResize, isResized, onMaximize, isMaximized, onAddToCart }: ChatWindowProps): React.JSX.Element;
+
+declare function DocumentUpload({ namespace, onUploadComplete, className }: DocumentUploadProps): React.JSX.Element;
+
+declare function MessageBubble({ message, sources, isStreaming, primaryColor, accentColor, onAddToCart, }: MessageBubbleProps): React.JSX.Element;
+
+declare function SourceCard({ source, index }: SourceCardProps): React.JSX.Element;
+
+/**
+ * ConfigProvider — React Context that makes RagConfig (UI subset) available
+ * to all child components without prop drilling.
+ *
+ * Only the UI-safe portions of RagConfig are exposed to the client.
+ */
+
+declare function ConfigProvider({ config, children, }: ConfigProviderProps): React.JSX.Element;
 declare function useConfig(): ClientConfig;
 
-type MessageRole = 'user' | 'assistant';
-interface RagMessage {
-    id: string;
-    role: MessageRole;
-    content: string;
-    /** Retrieved source chunks (assistant messages only) */
-    sources?: VectorMatch[];
-    /** ISO timestamp */
-    createdAt: string;
-}
-interface UseRagChatOptions {
-    /** Override the chat API endpoint (default: /api/chat) */
-    apiUrl?: string;
-    /** Override project namespace */
-    namespace?: string;
-    /** Persist chat history to localStorage (default: true) */
-    persist?: boolean;
-    /** Called after each successful assistant reply */
-    onReply?: (message: RagMessage) => void;
-    /** Called on error */
-    onError?: (error: string) => void;
-}
-interface UseRagChatReturn {
-    /** All messages in the current conversation */
-    messages: RagMessage[];
-    /** Whether a response is in flight */
-    isLoading: boolean;
-    /** Current error message, or null */
-    error: string | null;
-    /** Send a user message */
-    send: (text: string) => Promise<void>;
-    /** Clear the conversation (and localStorage if persist=true) */
-    clear: () => void;
-    /** Retry the last failed send */
-    retry: () => Promise<void>;
-    /** Programmatically set the conversation (e.g. to restore from a DB) */
-    setMessages: React.Dispatch<React.SetStateAction<RagMessage[]>>;
-}
 declare function useRagChat(projectId: string, options?: UseRagChatOptions): UseRagChatReturn;
 
-export { ChatMessage, ChatWidget, ChatWindow, type ClientConfig, ConfigProvider, DocumentUpload, MessageBubble, type RagMessage, SourceCard, UIConfig, type UseRagChatOptions, type UseRagChatReturn, VectorMatch, useConfig, useRagChat };
+export { ChatWidget, type ChatWidgetProps, ChatWindow, type ChatWindowProps, type ClientConfig, ConfigProvider, DocumentUpload, type DocumentUploadProps, MessageBubble, type MessageBubbleProps, type ProductCardProps, type ProductCarouselProps, RagMessage, SourceCard, type SourceCardProps, UIConfig, UseRagChatOptions, UseRagChatReturn, VectorMatch, useConfig, useRagChat };