@retrivora-ai/rag-engine 0.4.5 → 1.0.1

package/dist/handlers/index.mjs

@@ -2,13 +2,15 @@ import {
   createChatHandler,
   createHealthHandler,
   createIngestHandler,
+  createStreamHandler,
   createUploadHandler
-} from "../chunk-PRC5CZIZ.mjs";
-import "../chunk-EDLTMSNY.mjs";
-import "../chunk-FWCSY2DS.mjs";
+} from "../chunk-5W2YWFT3.mjs";
+import "../chunk-YLTMFW4M.mjs";
+import "../chunk-X4TOT24V.mjs";
 export {
   createChatHandler,
   createHealthHandler,
   createIngestHandler,
+  createStreamHandler,
   createUploadHandler
 };

package/dist/index-B2mutkgp.d.ts

@@ -0,0 +1,116 @@
+import { c as RagConfig, C as ChatResponse } from './RagConfig-DRJO4hGU.js';
+import { NextRequest, NextResponse } from 'next/server';
+
+interface ValidationError {
+    field: string;
+    message: string;
+    suggestion?: string;
+    severity: 'error' | 'warning';
+}
+/**
+ * ConfigValidator.ts — Comprehensive configuration validation.
+ * Uses a pluggable architecture to delegate provider-specific checks.
+ */
+declare class ConfigValidator {
+    /**
+     * Validates the entire RagConfig object.
+     */
+    static validate(config: RagConfig): Promise<ValidationError[]>;
+    private static validateVectorDbConfig;
+    private static validateLLMConfig;
+    private static validateEmbeddingConfig;
+    /**
+     * Temporary fallbacks for providers not yet migrated to the pluggable architecture.
+     */
+    private static fallbackVectorValidation;
+    private static fallbackLLMValidation;
+    private static fallbackEmbeddingValidation;
+    private static validateUIConfig;
+    private static validateRAGConfig;
+    private static isValidCSSColor;
+    static validateAndThrow(config: RagConfig): Promise<void>;
+}
+
+/**
+ * Interface for provider-specific configuration validation logic.
+ */
+interface IProviderValidator {
+    /**
+     * Validates the configuration for a specific provider.
+     * @param config - The configuration object to validate.
+     * @returns An array of validation errors (empty if valid).
+     */
+    validate(config: Record<string, unknown>): ValidationError[];
+}
+/**
+ * Result of a provider health check.
+ */
+interface HealthCheckResult {
+    healthy: boolean;
+    provider: string;
+    version?: string;
+    capabilities?: Record<string, unknown>;
+    error?: string;
+    timestamp: number;
+}
+/**
+ * Interface for provider-specific health checking logic.
+ */
+interface IProviderHealthChecker {
+    /**
+     * Performs a health check for a specific provider.
+     * @param config - The configuration object used to connect to the provider.
+     * @returns A promise that resolves to the health check result.
+     */
+    check(config: Record<string, unknown>): Promise<HealthCheckResult>;
+}
+
+/**
+ * createChatHandler — factory that returns a Next.js App Router POST handler
+ */
+declare function createChatHandler(config?: Partial<RagConfig>): (req: NextRequest) => Promise<NextResponse<{
+    error: string;
+}> | NextResponse<ChatResponse>>;
+/**
+ * createStreamHandler — factory that returns a streaming Next.js App Router POST handler
+ */
+declare function createStreamHandler(config?: Partial<RagConfig>): (req: NextRequest) => Promise<Response>;
+/**
+ * createIngestHandler — factory for the document ingestion endpoint.
+ */
+declare function createIngestHandler(config?: Partial<RagConfig>): (req: NextRequest) => Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    results: {
+        docId: string | number;
+        chunksIngested: number;
+    }[];
+}>>;
+/**
+ * createHealthHandler — factory for the health-check endpoint.
+ */
+declare function createHealthHandler(config?: Partial<RagConfig>): () => Promise<NextResponse<{
+    timestamp: string;
+    vectorDb: HealthCheckResult;
+    llm: HealthCheckResult;
+    embedding?: HealthCheckResult;
+    allHealthy: boolean;
+    status: string;
+}> | NextResponse<{
+    status: string;
+    error: string;
+}>>;
+/**
+ * createUploadHandler — factory for the file upload ingestion endpoint.
+ */
+declare function createUploadHandler(config?: Partial<RagConfig>): (req: NextRequest) => Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    message: string;
+    results: {
+        docId: string | number;
+        chunksIngested: number;
+    }[];
+}>>;
+
+export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, createHealthHandler as b, createChatHandler as c, createIngestHandler as d, createUploadHandler as e, createStreamHandler as f };

package/dist/index-Bjy0es5a.d.mts

@@ -0,0 +1,116 @@
+import { c as RagConfig, C as ChatResponse } from './RagConfig-DRJO4hGU.mjs';
+import { NextRequest, NextResponse } from 'next/server';
+
+interface ValidationError {
+    field: string;
+    message: string;
+    suggestion?: string;
+    severity: 'error' | 'warning';
+}
+/**
+ * ConfigValidator.ts — Comprehensive configuration validation.
+ * Uses a pluggable architecture to delegate provider-specific checks.
+ */
+declare class ConfigValidator {
+    /**
+     * Validates the entire RagConfig object.
+     */
+    static validate(config: RagConfig): Promise<ValidationError[]>;
+    private static validateVectorDbConfig;
+    private static validateLLMConfig;
+    private static validateEmbeddingConfig;
+    /**
+     * Temporary fallbacks for providers not yet migrated to the pluggable architecture.
+     */
+    private static fallbackVectorValidation;
+    private static fallbackLLMValidation;
+    private static fallbackEmbeddingValidation;
+    private static validateUIConfig;
+    private static validateRAGConfig;
+    private static isValidCSSColor;
+    static validateAndThrow(config: RagConfig): Promise<void>;
+}
+
+/**
+ * Interface for provider-specific configuration validation logic.
+ */
+interface IProviderValidator {
+    /**
+     * Validates the configuration for a specific provider.
+     * @param config - The configuration object to validate.
+     * @returns An array of validation errors (empty if valid).
+     */
+    validate(config: Record<string, unknown>): ValidationError[];
+}
+/**
+ * Result of a provider health check.
+ */
+interface HealthCheckResult {
+    healthy: boolean;
+    provider: string;
+    version?: string;
+    capabilities?: Record<string, unknown>;
+    error?: string;
+    timestamp: number;
+}
+/**
+ * Interface for provider-specific health checking logic.
+ */
+interface IProviderHealthChecker {
+    /**
+     * Performs a health check for a specific provider.
+     * @param config - The configuration object used to connect to the provider.
+     * @returns A promise that resolves to the health check result.
+     */
+    check(config: Record<string, unknown>): Promise<HealthCheckResult>;
+}
+
+/**
+ * createChatHandler — factory that returns a Next.js App Router POST handler
+ */
+declare function createChatHandler(config?: Partial<RagConfig>): (req: NextRequest) => Promise<NextResponse<{
+    error: string;
+}> | NextResponse<ChatResponse>>;
+/**
+ * createStreamHandler — factory that returns a streaming Next.js App Router POST handler
+ */
+declare function createStreamHandler(config?: Partial<RagConfig>): (req: NextRequest) => Promise<Response>;
+/**
+ * createIngestHandler — factory for the document ingestion endpoint.
+ */
+declare function createIngestHandler(config?: Partial<RagConfig>): (req: NextRequest) => Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    results: {
+        docId: string | number;
+        chunksIngested: number;
+    }[];
+}>>;
+/**
+ * createHealthHandler — factory for the health-check endpoint.
+ */
+declare function createHealthHandler(config?: Partial<RagConfig>): () => Promise<NextResponse<{
+    timestamp: string;
+    vectorDb: HealthCheckResult;
+    llm: HealthCheckResult;
+    embedding?: HealthCheckResult;
+    allHealthy: boolean;
+    status: string;
+}> | NextResponse<{
+    status: string;
+    error: string;
+}>>;
+/**
+ * createUploadHandler — factory for the file upload ingestion endpoint.
+ */
+declare function createUploadHandler(config?: Partial<RagConfig>): (req: NextRequest) => Promise<NextResponse<{
+    error: string;
+}> | NextResponse<{
+    message: string;
+    results: {
+        docId: string | number;
+        chunksIngested: number;
+    }[];
+}>>;
+
+export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, createHealthHandler as b, createChatHandler as c, createIngestHandler as d, createUploadHandler as e, createStreamHandler as f };

package/dist/index.d.mts

@@ -1,15 +1,14 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import React$1, { ReactNode } from 'react';
-import { C as ChatMessage } from './DocumentChunker-3yElxTO3.mjs';
-export { a as ChatOptions, b as Chunk, c as ChunkOptions, E as EmbedOptions, I as ILLMProvider } from './DocumentChunker-3yElxTO3.mjs';
-import { V as VectorMatch, U as UIConfig } from './RagConfig-BgRDL9Vy.mjs';
-export { C as ChatResponse, E as EmbeddingConfig, a as EmbeddingProvider, I as IngestDocument, L as LLMConfig, b as LLMProvider, R as RAGConfig, c as RagConfig, d as UpsertDocument, e as VectorDBConfig, f as VectorDBProvider } from './RagConfig-BgRDL9Vy.mjs';
+import { C as ChatMessage } from './DocumentChunker-C-sCZPhi.mjs';
+export { a as ChatOptions, b as Chunk, c as ChunkOptions, E as EmbedOptions, I as ILLMProvider } from './DocumentChunker-C-sCZPhi.mjs';
+import { V as VectorMatch, U as UIConfig } from './RagConfig-DRJO4hGU.mjs';
+export { C as ChatResponse, E as EmbeddingConfig, a as EmbeddingProvider, I as IngestDocument, L as LLMConfig, b as LLMProvider, R as RAGConfig, c as RagConfig, d as UpsertDocument, e as VectorDBConfig, f as VectorDBProvider } from './RagConfig-DRJO4hGU.mjs';
 
 interface ChatWidgetProps {
     /** Position of the floating button. Defaults to bottom-right. */
     position?: 'bottom-right' | 'bottom-left';
 }
-declare function ChatWidget({ position }: ChatWidgetProps): react_jsx_runtime.JSX.Element | null;
+declare function ChatWidget({ position }: ChatWidgetProps): React$1.JSX.Element | null;
 
 interface ChatWindowProps {
     /** Additional className for the wrapper div */
@@ -21,7 +20,7 @@ interface ChatWindowProps {
     /** Whether to show a close (X) button in the header */
     showClose?: boolean;
 }
-declare function ChatWindow({ className, style, onClose, showClose }: ChatWindowProps): react_jsx_runtime.JSX.Element;
+declare function ChatWindow({ className, style, onClose, showClose }: ChatWindowProps): React$1.JSX.Element;
 
 interface DocumentUploadProps {
     /** Optional namespace for the upload */
@@ -31,7 +30,7 @@ interface DocumentUploadProps {
     /** Additional className */
     className?: string;
 }
-declare function DocumentUpload({ namespace, onUploadComplete, className }: DocumentUploadProps): react_jsx_runtime.JSX.Element;
+declare function DocumentUpload({ namespace, onUploadComplete, className }: DocumentUploadProps): React$1.JSX.Element;
 
 interface MessageBubbleProps {
     message: ChatMessage;
@@ -40,13 +39,20 @@ interface MessageBubbleProps {
     primaryColor?: string;
     accentColor?: string;
 }
-declare function MessageBubble({ message, sources, isStreaming, primaryColor, accentColor, }: MessageBubbleProps): react_jsx_runtime.JSX.Element;
+declare function MessageBubble({ message, sources, isStreaming, primaryColor, accentColor, }: MessageBubbleProps): React$1.JSX.Element;
 
 interface SourceCardProps {
     source: VectorMatch;
     index: number;
 }
-declare function SourceCard({ source, index }: SourceCardProps): react_jsx_runtime.JSX.Element;
+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;
@@ -58,7 +64,7 @@ declare function ConfigProvider({ config, children, }: {
         ui?: Partial<UIConfig>;
     };
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): React$1.JSX.Element;
 declare function useConfig(): ClientConfig;
 
 type MessageRole = 'user' | 'assistant';

package/dist/index.d.ts

@@ -1,15 +1,14 @@
-import * as react_jsx_runtime from 'react/jsx-runtime';
 import React$1, { ReactNode } from 'react';
-import { C as ChatMessage } from './DocumentChunker-3yElxTO3.js';
-export { a as ChatOptions, b as Chunk, c as ChunkOptions, E as EmbedOptions, I as ILLMProvider } from './DocumentChunker-3yElxTO3.js';
-import { V as VectorMatch, U as UIConfig } from './RagConfig-BgRDL9Vy.js';
-export { C as ChatResponse, E as EmbeddingConfig, a as EmbeddingProvider, I as IngestDocument, L as LLMConfig, b as LLMProvider, R as RAGConfig, c as RagConfig, d as UpsertDocument, e as VectorDBConfig, f as VectorDBProvider } from './RagConfig-BgRDL9Vy.js';
+import { C as ChatMessage } from './DocumentChunker-C-sCZPhi.js';
+export { a as ChatOptions, b as Chunk, c as ChunkOptions, E as EmbedOptions, I as ILLMProvider } from './DocumentChunker-C-sCZPhi.js';
+import { V as VectorMatch, U as UIConfig } from './RagConfig-DRJO4hGU.js';
+export { C as ChatResponse, E as EmbeddingConfig, a as EmbeddingProvider, I as IngestDocument, L as LLMConfig, b as LLMProvider, R as RAGConfig, c as RagConfig, d as UpsertDocument, e as VectorDBConfig, f as VectorDBProvider } from './RagConfig-DRJO4hGU.js';
 
 interface ChatWidgetProps {
     /** Position of the floating button. Defaults to bottom-right. */
     position?: 'bottom-right' | 'bottom-left';
 }
-declare function ChatWidget({ position }: ChatWidgetProps): react_jsx_runtime.JSX.Element | null;
+declare function ChatWidget({ position }: ChatWidgetProps): React$1.JSX.Element | null;
 
 interface ChatWindowProps {
     /** Additional className for the wrapper div */
@@ -21,7 +20,7 @@ interface ChatWindowProps {
     /** Whether to show a close (X) button in the header */
     showClose?: boolean;
 }
-declare function ChatWindow({ className, style, onClose, showClose }: ChatWindowProps): react_jsx_runtime.JSX.Element;
+declare function ChatWindow({ className, style, onClose, showClose }: ChatWindowProps): React$1.JSX.Element;
 
 interface DocumentUploadProps {
     /** Optional namespace for the upload */
@@ -31,7 +30,7 @@ interface DocumentUploadProps {
     /** Additional className */
     className?: string;
 }
-declare function DocumentUpload({ namespace, onUploadComplete, className }: DocumentUploadProps): react_jsx_runtime.JSX.Element;
+declare function DocumentUpload({ namespace, onUploadComplete, className }: DocumentUploadProps): React$1.JSX.Element;
 
 interface MessageBubbleProps {
     message: ChatMessage;
@@ -40,13 +39,20 @@ interface MessageBubbleProps {
     primaryColor?: string;
     accentColor?: string;
 }
-declare function MessageBubble({ message, sources, isStreaming, primaryColor, accentColor, }: MessageBubbleProps): react_jsx_runtime.JSX.Element;
+declare function MessageBubble({ message, sources, isStreaming, primaryColor, accentColor, }: MessageBubbleProps): React$1.JSX.Element;
 
 interface SourceCardProps {
     source: VectorMatch;
     index: number;
 }
-declare function SourceCard({ source, index }: SourceCardProps): react_jsx_runtime.JSX.Element;
+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;
@@ -58,7 +64,7 @@ declare function ConfigProvider({ config, children, }: {
         ui?: Partial<UIConfig>;
     };
     children: ReactNode;
-}): react_jsx_runtime.JSX.Element;
+}): React$1.JSX.Element;
 declare function useConfig(): ClientConfig;
 
 type MessageRole = 'user' | 'assistant';