@retrivora-ai/rag-engine 0.4.4 → 1.0.0

package/dist/handlers/index.mjs

@@ -3,9 +3,9 @@ import {
   createHealthHandler,
   createIngestHandler,
   createUploadHandler
-} from "../chunk-OKY5P6RA.mjs";
-import "../chunk-EDLTMSNY.mjs";
-import "../chunk-FWCSY2DS.mjs";
+} from "../chunk-P4HAQ7KB.mjs";
+import "../chunk-67AJ6SMD.mjs";
+import "../chunk-QMIKLALV.mjs";
 export {
   createChatHandler,
   createHealthHandler,

package/dist/index-CrGMwXfO.d.ts

@@ -0,0 +1,112 @@
+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>>;
+/**
+ * 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 };

package/dist/index-v669iV-k.d.mts

@@ -0,0 +1,112 @@
+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>>;
+/**
+ * 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 };

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 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. */
@@ -27,7 +27,7 @@ interface DocumentUploadProps {
     /** Optional namespace for the upload */
     namespace?: string;
     /** Callback when upload completes */
-    onUploadComplete?: (results: any) => void;
+    onUploadComplete?: (results: unknown) => void;
     /** Additional className */
     className?: string;
 }

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 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. */
@@ -27,7 +27,7 @@ interface DocumentUploadProps {
     /** Optional namespace for the upload */
     namespace?: string;
     /** Callback when upload completes */
-    onUploadComplete?: (results: any) => void;
+    onUploadComplete?: (results: unknown) => void;
     /** Additional className */
     className?: string;
 }

package/dist/index.mjs

@@ -1,10 +1,10 @@
 import {
   mergeDefined
-} from "./chunk-EDLTMSNY.mjs";
+} from "./chunk-67AJ6SMD.mjs";
 import {
   __spreadProps,
   __spreadValues
-} from "./chunk-FWCSY2DS.mjs";
+} from "./chunk-QMIKLALV.mjs";
 
 // src/components/ChatWidget.tsx
 import { useState as useState4 } from "react";