@retrivora-ai/rag-engine 2.2.9 → 2.3.1

package/src/index.css

@@ -1869,6 +1869,9 @@
   .opacity-30 {
     opacity: 30%;
   }
+  .opacity-60 {
+    opacity: 60%;
+  }
   .opacity-100 {
     opacity: 100%;
   }
@@ -1928,6 +1931,10 @@
     --tw-drop-shadow: drop-shadow(var(--drop-shadow-2xl));
     filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
   }
+  .grayscale {
+    --tw-grayscale: grayscale(100%);
+    filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
+  }
   .filter {
     filter: var(--tw-blur,) var(--tw-brightness,) var(--tw-contrast,) var(--tw-grayscale,) var(--tw-hue-rotate,) var(--tw-invert,) var(--tw-saturate,) var(--tw-sepia,) var(--tw-drop-shadow,);
   }
@@ -2354,6 +2361,11 @@
       opacity: 30%;
     }
   }
+  .disabled\:opacity-40 {
+    &:disabled {
+      opacity: 40%;
+    }
+  }
   .disabled\:opacity-50 {
     &:disabled {
       opacity: 50%;
@@ -2371,6 +2383,24 @@
       }
     }
   }
+  .disabled\:hover\:text-slate-400 {
+    &:disabled {
+      &:hover {
+        @media (hover: hover) {
+          color: var(--color-slate-400);
+        }
+      }
+    }
+  }
+  .disabled\:hover\:text-slate-600 {
+    &:disabled {
+      &:hover {
+        @media (hover: hover) {
+          color: var(--color-slate-600);
+        }
+      }
+    }
+  }
   .disabled\:active\:scale-100 {
     &:disabled {
       &:active {
@@ -3549,6 +3579,34 @@
       }
     }
   }
+  .dark\:disabled\:hover\:text-white\/40 {
+    @media (prefers-color-scheme: dark) {
+      &:disabled {
+        &:hover {
+          @media (hover: hover) {
+            color: color-mix(in srgb, #fff 40%, transparent);
+            @supports (color: color-mix(in lab, red, red)) {
+              color: color-mix(in oklab, var(--color-white) 40%, transparent);
+            }
+          }
+        }
+      }
+    }
+  }
+  .dark\:disabled\:hover\:text-white\/60 {
+    @media (prefers-color-scheme: dark) {
+      &:disabled {
+        &:hover {
+          @media (hover: hover) {
+            color: color-mix(in srgb, #fff 60%, transparent);
+            @supports (color: color-mix(in lab, red, red)) {
+              color: color-mix(in oklab, var(--color-white) 60%, transparent);
+            }
+          }
+        }
+      }
+    }
+  }
 }
 @layer base {
   :root {

package/src/index.ts

@@ -65,6 +65,10 @@ export type { Retrivora } from './core/Retrivora';
 export type { RetrivoraErrorCode } from './exceptions';
 export { LicenseValidator } from './core/LicenseValidator';
 export type { LicenseValidationRequest, LicenseValidationResponse } from './core/LicenseValidator';
+export { CircuitBreaker } from './core/CircuitBreaker';
+export type { CircuitBreakerOptions } from './core/CircuitBreaker';
+export { BatchProcessor, isTransientError } from './core/BatchProcessor';
+export type { BatchOptions, BatchResult } from './core/BatchProcessor';
 export {
   RetrivoraError,
   ProviderNotFoundException,

package/src/server.ts

@@ -27,6 +27,7 @@ export type { HealthCheckResult, IProviderValidator, IProviderHealthChecker } fr
 export type { ValidationError } from './core/ConfigValidator';
 export type { LicensePayload } from './core/LicenseVerifier';
 export type { BatchOptions, BatchResult } from './core/BatchProcessor';
+export type { HandlerOptions } from './handlers';
 
 // ── Core Orchestration ─────────────────────────────────────────
 export { Retrivora } from './core/Retrivora';

package/dist/index-BPJ3KDYI.d.ts

@@ -1,195 +0,0 @@
-import { NextRequest } from 'next/server';
-import { i as RagConfig, I as ILLMProvider, C as ChatMessage, c as ChatResponse, f as IngestDocument } from './ILLMProvider-teTNQ1lh.js';
-
-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>;
-}
-
-/**
- * VectorPlugin — main orchestrator class.
- * This is the primary interface for host applications.
- *
- * Features:
- * - Configuration resolution from host + environment
- * - Configuration validation with detailed error messages
- * - Provider health checks before initialization
- * - Multi-provider support (Vector DBs & LLMs)
- * - Per-tenant data isolation via namespacing
- */
-declare class VectorPlugin {
-    private config;
-    private pipeline;
-    private validationPromise;
-    constructor(hostConfig?: Partial<RagConfig>);
-    /**
-     * Get the current resolved configuration.
-     */
-    getConfig(): RagConfig;
-    /**
-     * Get the initialized LLM provider (available after the first request).
-     * Used by handlers to pass to UITransformer.analyzeAndDecide() for
-     * LLM-driven visualization decisions.
-     */
-    getLLMProvider(): ILLMProvider | undefined;
-    /**
-     * Perform pre-flight health checks on all configured providers.
-     * Useful to verify connectivity before running operations.
-     *
-     * @returns Health status for vector DB, LLM, and embedding providers
-     */
-    checkHealth(): Promise<{
-        vectorDb: HealthCheckResult;
-        llm: HealthCheckResult;
-        embedding?: HealthCheckResult;
-        allHealthy: boolean;
-    }>;
-    /**
-     * Run a chat query.
-     */
-    chat(message: string, history?: ChatMessage[], namespace?: string): Promise<ChatResponse>;
-    /**
-     * Run a streaming chat query.
-     */
-    chatStream(message: string, history?: ChatMessage[], namespace?: string): AsyncGenerator<string | ChatResponse, void, unknown>;
-    /**
-     * Ingest documents into the vector database.
-     */
-    ingest(documents: IngestDocument[], namespace?: string): Promise<Array<{
-        docId: string | number;
-        chunksIngested: number;
-    }>>;
-    /**
-     * Get auto-suggestions based on a query prefix.
-     */
-    getSuggestions(query: string, namespace?: string): Promise<string[]>;
-}
-
-interface HandlerOptions {
-    onAuthorize?: (req: NextRequest) => boolean | Promise<boolean> | Response | Promise<Response>;
-}
-/**
- * Encode a payload as a Server-Sent Events frame.
- *   data: <json>\n\n
- */
-declare function sseFrame(payload: unknown): string;
-/** Encode a plain text chunk as an SSE frame. */
-declare function sseTextFrame(text: string): string;
-/** Encode the retrieval metadata with UI transformation as an SSE frame. */
-declare function sseMetaFrame(meta: unknown): string;
-/** Encode the UI transformation result as an SSE frame. */
-declare function sseUIFrame(uiTransformation: unknown): string;
-/** Encode the observability trace as an SSE frame. */
-declare function sseObservabilityFrame(trace: unknown): string;
-/** Encode a stream error as an SSE frame. */
-declare function sseErrorFrame(message: string): string;
-/**
- * createChatHandler — factory that returns a Next.js App Router POST handler.
- */
-declare function createChatHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: any, context?: any) => Promise<any>;
-/**
- * createStreamHandler — factory for a streaming SSE Next.js App Router POST handler.
- */
-declare function createStreamHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: any, context?: any) => Promise<any>;
-/**
- * createIngestHandler — factory for the document ingestion endpoint.
- */
-declare function createIngestHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: any, context?: any) => Promise<any>;
-/**
- * createHealthHandler — factory for the health-check endpoint.
- */
-declare function createHealthHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req?: NextRequest) => Promise<any>;
-/**
- * createLicenseHandler — factory for the license validation endpoint (/v1/license/validate).
- */
-declare function createLicenseHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
-/**
- * createUploadHandler — factory for the file upload ingestion endpoint.
- */
-declare function createUploadHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: any, context?: any) => Promise<any>;
-/**
- * createSuggestionsHandler — factory for the auto-suggestions endpoint.
- * Supports both POST (JSON body) and GET (URL search parameters).
- */
-declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
-/**
- * createHistoryHandler — factory for GET /api/retrivora/history and POST /api/retrivora/history/clear.
- */
-declare function createHistoryHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
-/**
- * createFeedbackHandler — factory for POST /api/retrivora/feedback.
- */
-declare function createFeedbackHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
-/**
- * createSessionsHandler — factory for GET /api/retrivora/sessions.
- */
-declare function createSessionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req?: NextRequest) => Promise<any>;
-/**
- * createRagHandler — factory that returns GET and POST handlers for a catch-all route
- * (e.g. `src/app/api/retrivora/[[...retrivora]]/route.ts`).
- */
-declare function createRagHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): {
-    GET: (req: any, context?: any) => Promise<any>;
-    POST: (req: any, context?: any) => Promise<any>;
-};
-
-export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, VectorPlugin as b, createChatHandler as c, createFeedbackHandler as d, createHealthHandler as e, createHistoryHandler as f, createIngestHandler as g, createRagHandler as h, createSessionsHandler as i, createStreamHandler as j, createUploadHandler as k, sseFrame as l, sseMetaFrame as m, sseTextFrame as n, type HandlerOptions as o, createLicenseHandler as p, createSuggestionsHandler as q, sseObservabilityFrame as r, sseErrorFrame as s, sseUIFrame as t };

package/dist/index-Dmq5lH0j.d.mts

@@ -1,195 +0,0 @@
-import { NextRequest } from 'next/server';
-import { i as RagConfig, I as ILLMProvider, C as ChatMessage, c as ChatResponse, f as IngestDocument } from './ILLMProvider-teTNQ1lh.mjs';
-
-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>;
-}
-
-/**
- * VectorPlugin — main orchestrator class.
- * This is the primary interface for host applications.
- *
- * Features:
- * - Configuration resolution from host + environment
- * - Configuration validation with detailed error messages
- * - Provider health checks before initialization
- * - Multi-provider support (Vector DBs & LLMs)
- * - Per-tenant data isolation via namespacing
- */
-declare class VectorPlugin {
-    private config;
-    private pipeline;
-    private validationPromise;
-    constructor(hostConfig?: Partial<RagConfig>);
-    /**
-     * Get the current resolved configuration.
-     */
-    getConfig(): RagConfig;
-    /**
-     * Get the initialized LLM provider (available after the first request).
-     * Used by handlers to pass to UITransformer.analyzeAndDecide() for
-     * LLM-driven visualization decisions.
-     */
-    getLLMProvider(): ILLMProvider | undefined;
-    /**
-     * Perform pre-flight health checks on all configured providers.
-     * Useful to verify connectivity before running operations.
-     *
-     * @returns Health status for vector DB, LLM, and embedding providers
-     */
-    checkHealth(): Promise<{
-        vectorDb: HealthCheckResult;
-        llm: HealthCheckResult;
-        embedding?: HealthCheckResult;
-        allHealthy: boolean;
-    }>;
-    /**
-     * Run a chat query.
-     */
-    chat(message: string, history?: ChatMessage[], namespace?: string): Promise<ChatResponse>;
-    /**
-     * Run a streaming chat query.
-     */
-    chatStream(message: string, history?: ChatMessage[], namespace?: string): AsyncGenerator<string | ChatResponse, void, unknown>;
-    /**
-     * Ingest documents into the vector database.
-     */
-    ingest(documents: IngestDocument[], namespace?: string): Promise<Array<{
-        docId: string | number;
-        chunksIngested: number;
-    }>>;
-    /**
-     * Get auto-suggestions based on a query prefix.
-     */
-    getSuggestions(query: string, namespace?: string): Promise<string[]>;
-}
-
-interface HandlerOptions {
-    onAuthorize?: (req: NextRequest) => boolean | Promise<boolean> | Response | Promise<Response>;
-}
-/**
- * Encode a payload as a Server-Sent Events frame.
- *   data: <json>\n\n
- */
-declare function sseFrame(payload: unknown): string;
-/** Encode a plain text chunk as an SSE frame. */
-declare function sseTextFrame(text: string): string;
-/** Encode the retrieval metadata with UI transformation as an SSE frame. */
-declare function sseMetaFrame(meta: unknown): string;
-/** Encode the UI transformation result as an SSE frame. */
-declare function sseUIFrame(uiTransformation: unknown): string;
-/** Encode the observability trace as an SSE frame. */
-declare function sseObservabilityFrame(trace: unknown): string;
-/** Encode a stream error as an SSE frame. */
-declare function sseErrorFrame(message: string): string;
-/**
- * createChatHandler — factory that returns a Next.js App Router POST handler.
- */
-declare function createChatHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: any, context?: any) => Promise<any>;
-/**
- * createStreamHandler — factory for a streaming SSE Next.js App Router POST handler.
- */
-declare function createStreamHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: any, context?: any) => Promise<any>;
-/**
- * createIngestHandler — factory for the document ingestion endpoint.
- */
-declare function createIngestHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: any, context?: any) => Promise<any>;
-/**
- * createHealthHandler — factory for the health-check endpoint.
- */
-declare function createHealthHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req?: NextRequest) => Promise<any>;
-/**
- * createLicenseHandler — factory for the license validation endpoint (/v1/license/validate).
- */
-declare function createLicenseHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
-/**
- * createUploadHandler — factory for the file upload ingestion endpoint.
- */
-declare function createUploadHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: any, context?: any) => Promise<any>;
-/**
- * createSuggestionsHandler — factory for the auto-suggestions endpoint.
- * Supports both POST (JSON body) and GET (URL search parameters).
- */
-declare function createSuggestionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
-/**
- * createHistoryHandler — factory for GET /api/retrivora/history and POST /api/retrivora/history/clear.
- */
-declare function createHistoryHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
-/**
- * createFeedbackHandler — factory for POST /api/retrivora/feedback.
- */
-declare function createFeedbackHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req: NextRequest) => Promise<any>;
-/**
- * createSessionsHandler — factory for GET /api/retrivora/sessions.
- */
-declare function createSessionsHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): (req?: NextRequest) => Promise<any>;
-/**
- * createRagHandler — factory that returns GET and POST handlers for a catch-all route
- * (e.g. `src/app/api/retrivora/[[...retrivora]]/route.ts`).
- */
-declare function createRagHandler(configOrPlugin?: Partial<RagConfig> | VectorPlugin, options?: HandlerOptions): {
-    GET: (req: any, context?: any) => Promise<any>;
-    POST: (req: any, context?: any) => Promise<any>;
-};
-
-export { ConfigValidator as C, type HealthCheckResult as H, type IProviderValidator as I, type ValidationError as V, type IProviderHealthChecker as a, VectorPlugin as b, createChatHandler as c, createFeedbackHandler as d, createHealthHandler as e, createHistoryHandler as f, createIngestHandler as g, createRagHandler as h, createSessionsHandler as i, createStreamHandler as j, createUploadHandler as k, sseFrame as l, sseMetaFrame as m, sseTextFrame as n, type HandlerOptions as o, createLicenseHandler as p, createSuggestionsHandler as q, sseObservabilityFrame as r, sseErrorFrame as s, sseUIFrame as t };