@nexo-labs/payload-typesense 1.9.0 → 1.9.2

package/dist/index.d.mts

@@ -5,10 +5,7 @@ import { CollectionSlug, Config, Payload, PayloadHandler, PayloadRequest } from
 import { Agent } from "http";
 import { Agent as Agent$1 } from "https";
 import { ReadStream } from "fs";
-import { ReadStream as ReadStream$1 } from "node:fs";
 
-//#region rolldown:runtime
-//#endregion
 //#region src/shared/types/plugin-types.d.ts
 /**
  * Hybrid search configuration for combining semantic and keyword search
@@ -254,7 +251,7 @@ interface RAGFeatureConfig extends RAGConfig {
   callbacks?: RAGCallbacks;
   agents: AgentConfig[] | AgentProvider;
 }
-type TypesenseProtocol = "http" | "https";
+type TypesenseProtocol = 'http' | 'https';
 type TypesenseNode = {
   host: string;
   port: number;
@@ -420,6 +417,8 @@ interface TypesenseRAGPluginConfig<TSlug extends CollectionSlug> {
   hnsw?: HNSWConfig;
   /** Advanced search configuration */
   advanced?: AdvancedSearchConfig;
+  /** Resolve document type from Typesense collection name (e.g. 'posts_chunk' → 'post') */
+  documentTypeResolver?: (collectionName: string) => string;
 }
 //#endregion
 //#region src/plugin/create-rag-plugin.d.ts
@@ -1829,80 +1828,12 @@ declare class Client {
   nlSearchModels(id: string): NLSearchModel;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/SearchOnlyCollection.d.ts
-declare class SearchOnlyCollection<T extends DocumentSchema> {
-  private readonly name;
-  private readonly apiCall;
-  private readonly configuration;
-  private readonly _documents;
-  constructor(name: string, apiCall: ApiCall, configuration: any);
-  documents(): SearchableDocuments<T>;
-}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/SearchClient.d.ts
-declare class SearchClient {
-  readonly multiSearch: MultiSearch;
-  private readonly configuration;
-  private readonly apiCall;
-  private readonly individualCollections;
-  constructor(options: ConfigurationOptions);
-  clearCache(): void;
-  collections<TDocumentSchema extends DocumentSchema>(collectionName: string): SearchOnlyCollection<TDocumentSchema>;
-}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/HTTPError.d.ts
-declare class HTTPError extends TypesenseError {}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/MissingConfigurationError.d.ts
-declare class MissingConfigurationError extends TypesenseError {}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/ObjectAlreadyExists.d.ts
-declare class ObjectAlreadyExists extends TypesenseError {}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/ObjectNotFound.d.ts
-declare class ObjectNotFound extends TypesenseError {}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/ObjectUnprocessable.d.ts
-declare class ObjectUnprocessable extends TypesenseError {}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/RequestMalformed.d.ts
-declare class RequestMalformed extends TypesenseError {}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/RequestUnauthorized.d.ts
-declare class RequestUnauthorized extends TypesenseError {}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/ServerError.d.ts
-declare class ServerError extends TypesenseError {}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense/Errors/ImportError.d.ts
-interface ImportErrorPayload {
-  documentsInJSONLFormat: string | ReadStream$1;
-  options: DocumentImportParameters;
-  failedItems: ImportResponse[];
-  successCount: number;
-}
-declare class ImportError extends TypesenseError {
-  payload: ImportErrorPayload;
-  importResults: ImportResponse[];
-  constructor(message: string, importResults: ImportResponse[], payload: ImportErrorPayload);
-}
-declare namespace index_d_exports {
-  export { HTTPError, ImportError, MissingConfigurationError, ObjectAlreadyExists, ObjectNotFound, ObjectUnprocessable, RequestMalformed, RequestUnauthorized, ServerError, TypesenseError };
-}
-//#endregion
-//#region ../../node_modules/.pnpm/typesense@2.1.0_@babel+runtime@7.28.6/node_modules/typesense/lib/Typesense.d.ts
-declare const _default: {
-  Client: typeof Client;
-  SearchClient: typeof SearchClient;
-  Errors: typeof index_d_exports;
-};
-//#endregion
 //#region src/adapter/types.d.ts
 /**
  * All valid Typesense field types
  * @see https://typesense.org/docs/latest/api/collections.html#schema-parameters
  */
-type TypesenseFieldType = "string" | "int32" | "int64" | "float" | "bool" | "string[]" | "float[]" | "int32[]" | "int64[]" | "bool[]" | "object" | "object[]" | "geopoint" | "geopoint[]" | "auto";
+type TypesenseFieldType = 'string' | 'int32' | 'int64' | 'float' | 'bool' | 'string[]' | 'float[]' | 'int32[]' | 'int64[]' | 'bool[]' | 'object' | 'object[]' | 'geopoint' | 'geopoint[]' | 'auto';
 /**
  * Typesense-specific field mapping
  * Extends the base FieldMapping with Typesense-specific properties
@@ -2080,6 +2011,63 @@ declare function createTypesenseAdapter(config: TypesenseConnectionConfig): Type
  */
 declare function createTypesenseAdapterFromClient(client: Client): TypesenseAdapter;
 //#endregion
+//#region src/core/config/types.d.ts
+type SearchMode = 'semantic' | 'keyword' | 'hybrid';
+interface SearchDefaults {
+  mode?: SearchMode;
+  perPage?: number;
+  tables?: string[];
+}
+interface SearchFeatureConfig {
+  enabled: boolean;
+  defaults?: SearchDefaults;
+}
+interface SyncFeatureConfig {
+  enabled: boolean;
+  autoSync?: boolean;
+  batchSize?: number;
+}
+interface FeatureFlags {
+  embedding?: EmbeddingProviderConfig$1;
+  search?: SearchFeatureConfig;
+  rag?: RAGFeatureConfig;
+  sync?: SyncFeatureConfig;
+}
+interface ModularPluginConfig {
+  typesense: TypesenseConnectionConfig;
+  features: FeatureFlags;
+  collections: Record<CollectionSlug | string, TableConfig[]>;
+  /** Resolve document type from Typesense collection name */
+  documentTypeResolver?: (collectionName: string) => string;
+}
+//#endregion
+//#region src/features/embedding/embeddings.d.ts
+/**
+ * Generates an embedding for the given text using OpenAI or Gemini API
+ * @param text - The text to generate an embedding for
+ * @param config - Optional embedding configuration (provider, model, dimensions, apiKey)
+ * @returns The embedding vector as an array of numbers, or null if generation fails
+ */
+declare const generateEmbedding: (text: string, config?: EmbeddingProviderConfig$1) => Promise<number[] | null>;
+/**
+ * Generate embedding with usage tracking
+ *
+ * This function returns both the embedding and usage information (tokens used)
+ *
+ * @param text - The text to generate an embedding for
+ * @param config - Optional embedding configuration
+ * @returns Embedding with usage information, or null if generation fails
+ */
+declare const generateEmbeddingWithUsage: (text: string, config?: EmbeddingProviderConfig$1) => Promise<EmbeddingWithUsage | null>;
+/**
+ * Generate embeddings for multiple texts with usage tracking (batch)
+ *
+ * @param texts - Array of texts to generate embeddings for
+ * @param config - Optional embedding configuration
+ * @returns Embeddings with total usage information, or null if generation fails
+ */
+declare const generateEmbeddingsBatchWithUsage: (texts: string[], config?: EmbeddingProviderConfig$1) => Promise<BatchEmbeddingWithUsage | null>;
+//#endregion
 //#region src/shared/types/types.d.ts
 interface TypesenseDocument {
   id: string;
@@ -2247,206 +2235,120 @@ interface ApiResponse<T = unknown> {
   success: boolean;
 }
 //#endregion
-//#region src/features/embedding/embeddings.d.ts
+//#region src/features/rag/chat-session-repository.d.ts
 /**
- * Generates an embedding for the given text using OpenAI or Gemini API
- * @param text - The text to generate an embedding for
- * @param config - Optional embedding configuration (provider, model, dimensions, apiKey)
- * @returns The embedding vector as an array of numbers, or null if generation fails
+ * Chat message format with optional sources
  */
-declare const generateEmbedding: (text: string, config?: EmbeddingProviderConfig$1) => Promise<number[] | null>;
+interface ChatMessageWithSources {
+  role: 'user' | 'assistant';
+  content: string;
+  timestamp: string;
+  sources?: Array<{
+    id: string;
+    title: string;
+    type: string;
+    chunk_index: number;
+    slug?: string;
+  }>;
+}
 /**
- * Generate embedding with usage tracking
- *
- * This function returns both the embedding and usage information (tokens used)
+ * Save or update chat session in PayloadCMS
  *
- * @param text - The text to generate an embedding for
- * @param config - Optional embedding configuration
- * @returns Embedding with usage information, or null if generation fails
+ * @param payload - Payload CMS instance
+ * @param userId - User ID
+ * @param conversationId - Conversation ID from Typesense
+ * @param userMessage - User's message
+ * @param assistantMessage - Assistant's response
+ * @param sources - Source chunks used for the response
+ * @param spending - Token spending entries
+ * @param collectionName - Collection name for sessions (default: 'chat-sessions')
+ * @param agentSlug - Slug of the agent used in this conversation (optional)
  */
-declare const generateEmbeddingWithUsage: (text: string, config?: EmbeddingProviderConfig$1) => Promise<EmbeddingWithUsage | null>;
+declare function saveChatSession(payload: Payload, userId: string | number, conversationId: string, userMessage: string, assistantMessage: string, sources: ChunkSource[], spending: SpendingEntry[], collectionName: CollectionSlug, agentSlug?: string): Promise<void>;
+//#endregion
+//#region src/features/rag/endpoints/chat/validators/request-validator.d.ts
 /**
- * Generate embeddings for multiple texts with usage tracking (batch)
- *
- * @param texts - Array of texts to generate embeddings for
- * @param config - Optional embedding configuration
- * @returns Embeddings with total usage information, or null if generation fails
+ * JSON Response helper
  */
-declare const generateEmbeddingsBatchWithUsage: (texts: string[], config?: EmbeddingProviderConfig$1) => Promise<BatchEmbeddingWithUsage | null>;
+declare const jsonResponse: (data: unknown, options?: ResponseInit) => Response;
 //#endregion
-//#region src/features/rag/query-builder.d.ts
+//#region src/features/rag/endpoints/types.d.ts
 /**
- * Typesense search request object
+ * Framework-agnostic types for API handlers
+ * These types provide compatibility with Next.js without requiring it as a direct dependency
  */
-interface TypesenseSearchRequest {
-  collection: string;
-  query_by: string;
-  vector_query: string;
-  exclude_fields: string;
-  filter_by?: string;
-  typo_tokens_threshold?: number;
-  num_typos?: number;
-  prefix?: boolean;
-  drop_tokens_threshold?: number;
-  enable_stemming?: boolean;
-}
 /**
- * Build the Typesense conversational search URL with all necessary parameters
- *
- * @param config - Query configuration
- * @param config.userMessage - The user's message/query
- * @param config.chatId - Optional conversation ID for follow-up questions
- * @param conversationModelId - The conversation model ID in Typesense
- * @param typesenseConfig - Typesense connection config
- * @returns URL for the Typesense multi_search endpoint with conversation parameters
+ * Context for dynamic route parameters (Next.js App Router style)
  */
-declare function buildConversationalUrl(config: {
-  userMessage: string;
-  chatId?: string;
-}, conversationModelId: string, typesenseConfig: TypesenseConnectionConfig): URL;
+type ApiContext<T = Record<string, string>> = {
+  params: Promise<T>;
+};
+type AuthenticateMethod = (options?: {
+  depth?: number;
+}) => Promise<{
+  id: string | number;
+  email?: string;
+} | {
+  error: string;
+  status: number;
+}>;
+//#endregion
+//#region src/features/rag/handlers/chunk-fetch-handler.d.ts
 /**
- * Build multi-search requests for Typesense with hybrid search configuration
- *
- * @param config - Query configuration including embedding, collections, and filters
- * @returns Array of search requests for Typesense multi_search
+ * Configuration for fetching a chunk by ID
  */
-declare function buildMultiSearchRequests(config: TypesenseQueryConfig): TypesenseSearchRequest[];
+type ChunkFetchConfig = {
+  /** Chunk document ID */
+  chunkId: string;
+  /** Collection name */
+  collectionName: string;
+  /** Valid collection names for validation */
+  validCollections?: string[];
+};
 /**
- * Build the complete Typesense request body for multi-search
- *
- * @param config - Query configuration
- * @returns Request body for Typesense multi_search endpoint
+ * Result of fetching a chunk
  */
-declare function buildMultiSearchRequestBody(config: TypesenseQueryConfig): {
-  searches: TypesenseSearchRequest[];
+type ChunkFetchResult = {
+  id: string;
+  chunk_text: string;
+  title?: string;
+  slug?: string;
+  chunk_index?: number;
+  collection: string;
 };
 /**
- * Build hybrid search parameters for combining semantic and keyword search
+ * Fetch a chunk document by ID from Typesense
  *
- * @param alpha - Weight between semantic (1.0) and keyword (0.0) search
- * @param rerankMatches - Whether to rerank hybrid search results
- * @param queryFields - Fields to use for keyword search
- * @returns Object with hybrid search parameters
+ * @param client - Typesense client instance
+ * @param config - Chunk fetch configuration
+ * @returns Promise with chunk data
+ * @throws Error if chunk not found or collection is invalid
  */
-declare function buildHybridSearchParams(alpha?: number, rerankMatches?: boolean, queryFields?: string): {
-  alpha: number;
-  rerank_hybrid_matches: boolean;
-  query_fields: string;
-};
+declare function fetchChunkById(client: Client, config: ChunkFetchConfig): Promise<ChunkFetchResult>;
 //#endregion
-//#region src/features/rag/stream-handler.d.ts
+//#region src/features/rag/handlers/rag-search-handler.d.ts
 /**
- * Parsed conversation event from Typesense SSE stream
+ * Configuration for RAG search
  */
-interface ConversationEvent {
-  /** Conversation ID */
-  conversationId?: string;
-  /** Message token/chunk */
-  message?: string;
-  /** Search results (only in first event) */
-  results?: TypesenseRAGSearchResult[];
-  /** Raw parsed data */
-  raw?: unknown;
-}
+type RAGSearchConfig = {
+  /** Collections to search in */
+  searchCollections: string[];
+  /** Conversation model ID */
+  modelId: string;
+  /** Number of results to retrieve */
+  kResults?: number;
+  /** Advanced search configuration */
+  advancedConfig?: {
+    typoTokensThreshold?: number;
+    numTypos?: number;
+    prefix?: boolean;
+    dropTokensThreshold?: number;
+  };
+  /** Taxonomy slugs to filter RAG content */
+  taxonomySlugs?: string[];
+};
 /**
- * Stream processing result
- */
-interface StreamProcessingResult {
-  /** Full assistant message */
-  fullMessage: string;
-  /** Conversation ID */
-  conversationId: string | null;
-  /** Extracted sources */
-  sources: ChunkSource[];
-  /** Context text (for token estimation) */
-  contextText: string;
-}
-/**
- * Parse a single SSE event from Typesense conversation stream
- *
- * @param line - Raw SSE event line
- * @returns Parsed conversation event or null if not parseable
- */
-declare function parseConversationEvent(line: string): ConversationEvent | null;
-/**
- * Extract sources from Typesense search results
- *
- * @param results - Typesense multi-search results array
- * @param documentTypeResolver - Optional function to resolve document type from collection name
- * @returns Array of chunk sources with metadata
- */
-declare function extractSourcesFromResults(results: TypesenseRAGSearchResult[], documentTypeResolver?: (collectionName: string) => string): ChunkSource[];
-/**
- * Build context text from results (useful for token estimation)
- *
- * @param results - Typesense multi-search results array
- * @returns Combined context text from all chunks
- */
-declare function buildContextText(results: TypesenseRAGSearchResult[]): string;
-/**
- * Process a Typesense conversation stream
- *
- * @param response - Fetch Response with SSE stream
- * @param onEvent - Callback for each parsed event
- * @param documentTypeResolver - Optional function to resolve document type
- * @returns Processing result with full message, ID, and sources
- */
-declare function processConversationStream(response: Response, onEvent?: (event: ConversationEvent) => void, documentTypeResolver?: (collectionName: string) => string): Promise<StreamProcessingResult>;
-/**
- * Create a ReadableStream that forwards SSE events
- *
- * @param response - Fetch Response with SSE stream
- * @param onData - Callback for processing each event before forwarding
- * @returns ReadableStream for SSE events
- */
-declare function createSSEForwardStream(response: Response, onData?: (event: ConversationEvent) => void): ReadableStream<Uint8Array>;
-//#endregion
-//#region src/features/rag/setup.d.ts
-/**
- * Ensure conversation history collection exists
- *
- * @param client - Typesense client
- * @param collectionName - Name of the conversation history collection
- * @returns true if collection exists or was created successfully
- */
-declare function ensureConversationCollection(client: Client, collectionName?: string): Promise<boolean>;
-/**
- * Get default RAG configuration values
- *
- * @returns Default RAG configuration
- */
-declare function getDefaultRAGConfig(): Required<Omit<RAGConfig, 'agents'>>;
-/**
- * Merge user RAG config with defaults
- *
- * @param userConfig - User-provided RAG configuration
- * @returns Merged configuration with defaults
- */
-declare function mergeRAGConfigWithDefaults(userConfig?: RAGConfig): RAGConfig;
-//#endregion
-//#region src/features/rag/handlers/rag-search-handler.d.ts
-/**
- * Configuration for RAG search
- */
-type RAGSearchConfig = {
-  /** Collections to search in */
-  searchCollections: string[];
-  /** Conversation model ID */
-  modelId: string;
-  /** Number of results to retrieve */
-  kResults?: number;
-  /** Advanced search configuration */
-  advancedConfig?: {
-    typoTokensThreshold?: number;
-    numTypos?: number;
-    prefix?: boolean;
-    dropTokensThreshold?: number;
-  };
-  /** Taxonomy slugs to filter RAG content */
-  taxonomySlugs?: string[];
-};
-/**
- * Request parameters for RAG chat
+ * Request parameters for RAG chat
  */
 type RAGChatRequest = {
   /** User's message */
@@ -2489,39 +2391,6 @@ type RAGSearchResult = {
  */
 declare function executeRAGSearch(typesenseConfig: TypesenseConnectionConfig, searchConfig: RAGSearchConfig, request: RAGChatRequest): Promise<RAGSearchResult>;
 //#endregion
-//#region src/features/rag/handlers/chunk-fetch-handler.d.ts
-/**
- * Configuration for fetching a chunk by ID
- */
-type ChunkFetchConfig = {
-  /** Chunk document ID */
-  chunkId: string;
-  /** Collection name */
-  collectionName: string;
-  /** Valid collection names for validation */
-  validCollections?: string[];
-};
-/**
- * Result of fetching a chunk
- */
-type ChunkFetchResult = {
-  id: string;
-  chunk_text: string;
-  title?: string;
-  slug?: string;
-  chunk_index?: number;
-  collection: string;
-};
-/**
- * Fetch a chunk document by ID from Typesense
- *
- * @param client - Typesense client instance
- * @param config - Chunk fetch configuration
- * @returns Promise with chunk data
- * @throws Error if chunk not found or collection is invalid
- */
-declare function fetchChunkById(client: Client, config: ChunkFetchConfig): Promise<ChunkFetchResult>;
-//#endregion
 //#region src/features/rag/handlers/session-handlers.d.ts
 /**
  * Session data structure
@@ -2574,111 +2443,175 @@ declare function getSessionByConversationId<TSlug extends CollectionSlug>(payloa
  */
 declare function closeSession<TSlug extends CollectionSlug>(payload: Payload, userId: string | number, conversationId: string, config?: SessionConfig<TSlug>): Promise<ChatSessionData | null>;
 //#endregion
-//#region src/features/rag/utils/sse-utils.d.ts
+//#region src/features/rag/query-builder.d.ts
 /**
- * Helper to create an SSE event string
+ * Typesense search request object
+ */
+interface TypesenseSearchRequest {
+  collection: string;
+  query_by: string;
+  vector_query: string;
+  exclude_fields: string;
+  filter_by?: string;
+  typo_tokens_threshold?: number;
+  num_typos?: number;
+  prefix?: boolean;
+  drop_tokens_threshold?: number;
+  enable_stemming?: boolean;
+}
+/**
+ * Build the Typesense conversational search URL with all necessary parameters
  *
- * @param event - SSE event object
- * @returns Formatted SSE event string
+ * @param config - Query configuration
+ * @param config.userMessage - The user's message/query
+ * @param config.chatId - Optional conversation ID for follow-up questions
+ * @param conversationModelId - The conversation model ID in Typesense
+ * @param typesenseConfig - Typesense connection config
+ * @returns URL for the Typesense multi_search endpoint with conversation parameters
  */
-declare function formatSSEEvent(event: SSEEvent): string;
+declare function buildConversationalUrl(config: {
+  userMessage: string;
+  chatId?: string;
+}, conversationModelId: string, typesenseConfig: TypesenseConnectionConfig): URL;
 /**
- * Helper to send an SSE event through a controller
+ * Build multi-search requests for Typesense with hybrid search configuration
  *
- * @param controller - ReadableStreamDefaultController
- * @param encoder - TextEncoder instance
- * @param event - SSE event to send
+ * @param config - Query configuration including embedding, collections, and filters
+ * @returns Array of search requests for Typesense multi_search
  */
-declare function sendSSEEvent(controller: ReadableStreamDefaultController<Uint8Array>, encoder: TextEncoder, event: SSEEvent): void;
-//#endregion
-//#region src/features/rag/chat-session-repository.d.ts
+declare function buildMultiSearchRequests(config: TypesenseQueryConfig): TypesenseSearchRequest[];
 /**
- * Chat message format with optional sources
+ * Build the complete Typesense request body for multi-search
+ *
+ * @param config - Query configuration
+ * @returns Request body for Typesense multi_search endpoint
  */
-interface ChatMessageWithSources {
-  role: 'user' | 'assistant';
-  content: string;
-  timestamp: string;
-  sources?: Array<{
-    id: string;
-    title: string;
-    type: string;
-    chunk_index: number;
-    slug?: string;
-  }>;
-}
+declare function buildMultiSearchRequestBody(config: TypesenseQueryConfig): {
+  searches: TypesenseSearchRequest[];
+};
 /**
- * Save or update chat session in PayloadCMS
+ * Build hybrid search parameters for combining semantic and keyword search
  *
- * @param payload - Payload CMS instance
- * @param userId - User ID
- * @param conversationId - Conversation ID from Typesense
- * @param userMessage - User's message
- * @param assistantMessage - Assistant's response
- * @param sources - Source chunks used for the response
- * @param spending - Token spending entries
- * @param collectionName - Collection name for sessions (default: 'chat-sessions')
- * @param agentSlug - Slug of the agent used in this conversation (optional)
+ * @param alpha - Weight between semantic (1.0) and keyword (0.0) search
+ * @param rerankMatches - Whether to rerank hybrid search results
+ * @param queryFields - Fields to use for keyword search
+ * @returns Object with hybrid search parameters
  */
-declare function saveChatSession(payload: Payload, userId: string | number, conversationId: string, userMessage: string, assistantMessage: string, sources: ChunkSource[], spending: SpendingEntry[], collectionName: CollectionSlug, agentSlug?: string): Promise<void>;
+declare function buildHybridSearchParams(alpha?: number, rerankMatches?: boolean, queryFields?: string): {
+  alpha: number;
+  rerank_hybrid_matches: boolean;
+  query_fields: string;
+};
 //#endregion
-//#region src/features/rag/endpoints/types.d.ts
+//#region src/features/rag/setup.d.ts
 /**
- * Framework-agnostic types for API handlers
- * These types provide compatibility with Next.js without requiring it as a direct dependency
+ * Ensure conversation history collection exists
+ *
+ * @param client - Typesense client
+ * @param collectionName - Name of the conversation history collection
+ * @returns true if collection exists or was created successfully
  */
+declare function ensureConversationCollection(client: Client, collectionName?: string): Promise<boolean>;
 /**
- * Context for dynamic route parameters (Next.js App Router style)
+ * Get default RAG configuration values
+ *
+ * @returns Default RAG configuration
  */
-type ApiContext<T = Record<string, string>> = {
-  params: Promise<T>;
-};
-type AuthenticateMethod = (options?: {
-  depth?: number;
-}) => Promise<{
-  id: string | number;
-  email?: string;
-} | {
-  error: string;
-  status: number;
-}>;
-//#endregion
-//#region src/features/rag/endpoints/chat/validators/request-validator.d.ts
+declare function getDefaultRAGConfig(): Required<Omit<RAGConfig, 'agents'>>;
 /**
- * JSON Response helper
+ * Merge user RAG config with defaults
+ *
+ * @param userConfig - User-provided RAG configuration
+ * @returns Merged configuration with defaults
  */
-declare const jsonResponse: (data: any, options?: ResponseInit) => Response;
+declare function mergeRAGConfigWithDefaults(userConfig?: RAGConfig): RAGConfig;
 //#endregion
-//#region src/core/config/types.d.ts
-type SearchMode = "semantic" | "keyword" | "hybrid";
-interface SearchDefaults {
-  mode?: SearchMode;
-  perPage?: number;
-  tables?: string[];
-}
-interface SearchFeatureConfig {
-  enabled: boolean;
-  defaults?: SearchDefaults;
-}
-interface SyncFeatureConfig {
-  enabled: boolean;
-  autoSync?: boolean;
-  batchSize?: number;
-}
-interface FeatureFlags {
-  embedding?: EmbeddingProviderConfig$1;
-  search?: SearchFeatureConfig;
-  rag?: RAGFeatureConfig;
-  sync?: SyncFeatureConfig;
+//#region src/features/rag/stream-handler.d.ts
+/**
+ * Parsed conversation event from Typesense SSE stream
+ */
+interface ConversationEvent {
+  /** Conversation ID */
+  conversationId?: string;
+  /** Message token/chunk */
+  message?: string;
+  /** Search results (only in first event) */
+  results?: TypesenseRAGSearchResult[];
+  /** Raw parsed data */
+  raw?: unknown;
 }
-interface ModularPluginConfig {
-  typesense: TypesenseConnectionConfig;
-  features: FeatureFlags;
-  collections: Record<CollectionSlug | string, TableConfig[]>;
+/**
+ * Stream processing result
+ */
+interface StreamProcessingResult {
+  /** Full assistant message */
+  fullMessage: string;
+  /** Conversation ID */
+  conversationId: string | null;
+  /** Extracted sources */
+  sources: ChunkSource[];
+  /** Context text (for token estimation) */
+  contextText: string;
 }
+/**
+ * Parse a single SSE event from Typesense conversation stream
+ *
+ * @param line - Raw SSE event line
+ * @returns Parsed conversation event or null if not parseable
+ */
+declare function parseConversationEvent(line: string): ConversationEvent | null;
+/**
+ * Extract sources from Typesense search results
+ *
+ * @param results - Typesense multi-search results array
+ * @param documentTypeResolver - Optional function to resolve document type from collection name
+ * @returns Array of chunk sources with metadata
+ */
+declare function extractSourcesFromResults(results: TypesenseRAGSearchResult[], documentTypeResolver?: (collectionName: string) => string): ChunkSource[];
+/**
+ * Build context text from results (useful for token estimation)
+ *
+ * @param results - Typesense multi-search results array
+ * @returns Combined context text from all chunks
+ */
+declare function buildContextText(results: TypesenseRAGSearchResult[]): string;
+/**
+ * Process a Typesense conversation stream
+ *
+ * @param response - Fetch Response with SSE stream
+ * @param onEvent - Callback for each parsed event
+ * @param documentTypeResolver - Optional function to resolve document type
+ * @returns Processing result with full message, ID, and sources
+ */
+declare function processConversationStream(response: Response, onEvent?: (event: ConversationEvent) => void, documentTypeResolver?: (collectionName: string) => string): Promise<StreamProcessingResult>;
+/**
+ * Create a ReadableStream that forwards SSE events
+ *
+ * @param response - Fetch Response with SSE stream
+ * @param onData - Callback for processing each event before forwarding
+ * @returns ReadableStream for SSE events
+ */
+declare function createSSEForwardStream(response: Response, onData?: (event: ConversationEvent) => void): ReadableStream<Uint8Array>;
+//#endregion
+//#region src/features/rag/utils/sse-utils.d.ts
+/**
+ * Helper to create an SSE event string
+ *
+ * @param event - SSE event object
+ * @returns Formatted SSE event string
+ */
+declare function formatSSEEvent(event: SSEEvent): string;
+/**
+ * Helper to send an SSE event through a controller
+ *
+ * @param controller - ReadableStreamDefaultController
+ * @param encoder - TextEncoder instance
+ * @param event - SSE event to send
+ */
+declare function sendSSEEvent(controller: ReadableStreamDefaultController<Uint8Array>, encoder: TextEncoder, event: SSEEvent): void;
 //#endregion
 //#region src/core/client/typesense-client.d.ts
-declare const createTypesenseClient: (typesenseConfig: TypesenseConnectionConfig) => _default.Client;
+declare const createTypesenseClient: (typesenseConfig: TypesenseConnectionConfig) => Client;
 declare const testTypesenseConnection: (client: Client) => Promise<boolean>;
 //#endregion
 //#region src/features/sync/services/document-delete.d.ts
@@ -2688,13 +2621,6 @@ declare const testTypesenseConnection: (client: Client) => Promise<boolean>;
  */
 declare const deleteDocumentFromTypesense: (typesenseClient: Client, collectionSlug: string, docId: string, tableConfig: TableConfig) => Promise<void>;
 //#endregion
-//#region src/features/search/endpoints.d.ts
-declare const createSearchEndpoints: (typesenseClient: Client, pluginOptions: ModularPluginConfig) => {
-  handler: payload0.PayloadHandler;
-  method: "get";
-  path: string;
-}[];
-//#endregion
 //#region src/features/rag/endpoints.d.ts
 /**
  * Creates Payload handlers for RAG endpoints
@@ -2707,6 +2633,13 @@ declare function createRAGPayloadHandlers<TSlug extends CollectionSlug>(config:
   handler: PayloadHandler;
 }>;
 //#endregion
+//#region src/features/search/endpoints.d.ts
+declare const createSearchEndpoints: (typesenseClient: Client, pluginOptions: ModularPluginConfig) => {
+  handler: payload0.PayloadHandler;
+  method: "get";
+  path: string;
+}[];
+//#endregion
 //#region src/core/config/constants.d.ts
 /**
  * Constants for payload-typesense plugin