@elsium-ai/rag 0.2.3 → 0.4.0

package/README.md

@@ -660,6 +660,198 @@ const reranked = mmrRerank(queryEmbedding, candidateResults, {
 })
 ```
 
+### `createPgVectorStore`
+
+Creates a vector store backed by PostgreSQL with the pgvector extension.
+
+```typescript
+function createPgVectorStore(config: {
+  connectionString: string
+  tableName?: string
+  dimensions?: number
+}): VectorStore
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `config.connectionString` | `string` | **(required)** | PostgreSQL connection string. |
+| `config.tableName` | `string` | `'embeddings'` | Table name for storing vectors. |
+| `config.dimensions` | `number` | `1536` | Vector dimensions (must match your embedding model). |
+
+**Returns:** A `VectorStore` with `name: 'pgvector'`.
+
+```typescript
+import { createPgVectorStore } from '@elsium-ai/rag'
+
+const store = createPgVectorStore({
+  connectionString: process.env.DATABASE_URL!,
+  tableName: 'document_embeddings',
+  dimensions: 1536,
+})
+
+await store.upsert(embeddedChunks)
+const results = await store.query(queryVector, { topK: 5 })
+```
+
+### `createQdrantStore`
+
+Creates a vector store backed by the Qdrant REST API.
+
+```typescript
+function createQdrantStore(config: {
+  url: string
+  apiKey?: string
+  collectionName: string
+  dimensions: number
+}): VectorStore
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `config.url` | `string` | **(required)** | Qdrant server URL. |
+| `config.apiKey` | `string` | `undefined` | Optional API key for authentication. |
+| `config.collectionName` | `string` | **(required)** | Name of the Qdrant collection. |
+| `config.dimensions` | `number` | **(required)** | Vector dimensions. |
+
+**Returns:** A `VectorStore` with `name: 'qdrant'`.
+
+```typescript
+import { createQdrantStore } from '@elsium-ai/rag'
+
+const store = createQdrantStore({
+  url: 'http://localhost:6333',
+  collectionName: 'documents',
+  dimensions: 1536,
+})
+```
+
+---
+
+## Additional Embedding Providers
+
+### `createGoogleEmbeddings`
+
+Creates an embedding provider backed by Google's text-embedding-004 model.
+
+```typescript
+function createGoogleEmbeddings(config: {
+  apiKey: string
+  model?: string
+  dimensions?: number
+}): EmbeddingProvider
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `config.apiKey` | `string` | **(required)** | Google API key. |
+| `config.model` | `string` | `'text-embedding-004'` | Model name. |
+| `config.dimensions` | `number` | `768` | Embedding dimensions. |
+
+**Returns:** An `EmbeddingProvider` with `name: 'google'`.
+
+```typescript
+import { createGoogleEmbeddings } from '@elsium-ai/rag'
+
+const embeddings = createGoogleEmbeddings({
+  apiKey: process.env.GOOGLE_API_KEY!,
+})
+
+const vector = await embeddings.embed('Hello, world!')
+```
+
+### `createCohereEmbeddings`
+
+Creates an embedding provider backed by Cohere's embed-v4.0 model.
+
+```typescript
+function createCohereEmbeddings(config: {
+  apiKey: string
+  model?: string
+  inputType?: string
+}): EmbeddingProvider
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `config.apiKey` | `string` | **(required)** | Cohere API key. |
+| `config.model` | `string` | `'embed-v4.0'` | Model name. |
+| `config.inputType` | `string` | `'search_document'` | Input type hint for the model. |
+
+**Returns:** An `EmbeddingProvider` with `name: 'cohere'`.
+
+```typescript
+import { createCohereEmbeddings } from '@elsium-ai/rag'
+
+const embeddings = createCohereEmbeddings({
+  apiKey: process.env.COHERE_API_KEY!,
+})
+
+const vector = await embeddings.embed('Hello, world!')
+```
+
+---
+
+## Keyword & Hybrid Search
+
+### `createBM25Index`
+
+Creates a BM25 keyword search index for term-frequency-based retrieval.
+
+```typescript
+function createBM25Index(): {
+  add(chunks: Chunk[]): void
+  search(query: string, topK?: number): RetrievalResult[]
+  clear(): void
+}
+```
+
+**Returns:** A BM25 index with `add`, `search`, and `clear` methods.
+
+```typescript
+import { createBM25Index } from '@elsium-ai/rag'
+
+const bm25 = createBM25Index()
+bm25.add(chunks)
+
+const results = bm25.search('machine learning', 5)
+```
+
+### `createHybridSearch`
+
+Combines a vector store with a BM25 index using Reciprocal Rank Fusion (RRF) to blend semantic and keyword search results.
+
+```typescript
+function createHybridSearch(
+  vectorStore: VectorStore,
+  bm25: ReturnType<typeof createBM25Index>,
+  config?: { vectorWeight?: number; bm25Weight?: number; topK?: number },
+): {
+  query(embedding: EmbeddingVector, text: string, options?: QueryOptions): Promise<RetrievalResult[]>
+}
+```
+
+| Parameter | Type | Default | Description |
+|---|---|---|---|
+| `vectorStore` | `VectorStore` | **(required)** | The vector store for semantic search. |
+| `bm25` | `BM25Index` | **(required)** | The BM25 index for keyword search. |
+| `config.vectorWeight` | `number` | `0.7` | Weight for vector search results in RRF. |
+| `config.bm25Weight` | `number` | `0.3` | Weight for BM25 results in RRF. |
+| `config.topK` | `number` | `5` | Number of results to return. |
+
+```typescript
+import { createInMemoryStore, createBM25Index, createHybridSearch } from '@elsium-ai/rag'
+
+const vectorStore = createInMemoryStore()
+const bm25 = createBM25Index()
+
+const hybrid = createHybridSearch(vectorStore, bm25, {
+  vectorWeight: 0.7,
+  bm25Weight: 0.3,
+})
+
+const results = await hybrid.query(queryEmbedding, 'search query', { topK: 10 })
+```
+
 ---
 
 ## Pipeline

package/dist/bm25.d.ts

@@ -0,0 +1,10 @@
+import type { Chunk, RetrievalResult } from './types';
+export interface BM25Index {
+    index(chunks: Chunk[]): void;
+    search(query: string, topK?: number): RetrievalResult[];
+}
+export declare function createBM25Index(options?: {
+    k1?: number;
+    b?: number;
+}): BM25Index;
+//# sourceMappingURL=bm25.d.ts.map

package/dist/bm25.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bm25.d.ts","sourceRoot":"","sources":["../src/bm25.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAErD,MAAM,WAAW,SAAS;IACzB,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAA;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAAA;CACvD;AAgBD,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAwFhF"}

package/dist/embeddings.d.ts

@@ -1,3 +1,4 @@
+import type { Registry } from '@elsium-ai/core';
 import type { EmbeddingConfig, EmbeddingVector } from './types';
 export interface EmbeddingProvider {
     readonly name: string;
@@ -7,5 +8,7 @@ export interface EmbeddingProvider {
 }
 export declare function createOpenAIEmbeddings(config: EmbeddingConfig): EmbeddingProvider;
 export declare function createMockEmbeddings(dims?: number): EmbeddingProvider;
+export type EmbeddingProviderFactory = (config: EmbeddingConfig) => EmbeddingProvider;
+export declare const embeddingProviderRegistry: Registry<EmbeddingProviderFactory>;
 export declare function getEmbeddingProvider(config: EmbeddingConfig): EmbeddingProvider;
 //# sourceMappingURL=embeddings.d.ts.map

package/dist/embeddings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE/D,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAE3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC7C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;CACvD;AAID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAyEjF;AAID,wBAAgB,oBAAoB,CAAC,IAAI,SAAM,GAAG,iBAAiB,CAgClE;AAID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAa/E"}
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../src/embeddings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE/D,MAAM,WAAW,iBAAiB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAE3B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAC7C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;CACvD;AAID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAyEjF;AAID,wBAAgB,oBAAoB,CAAC,IAAI,SAAM,GAAG,iBAAiB,CAgClE;AAID,MAAM,MAAM,wBAAwB,GAAG,CAAC,MAAM,EAAE,eAAe,KAAK,iBAAiB,CAAA;AAErF,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,wBAAwB,CACX,CAAA;AAI9D,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,eAAe,GAAG,iBAAiB,CAiB/E"}

package/dist/hybrid.d.ts

@@ -0,0 +1,14 @@
+import type { BM25Index } from './bm25';
+import type { EmbeddingVector, RetrievalResult } from './types';
+import type { VectorStore } from './vectorstore';
+export interface HybridSearchConfig {
+    k?: number;
+    vectorWeight?: number;
+    bm25Weight?: number;
+    topK?: number;
+}
+export interface HybridSearch {
+    search(query: string, queryEmbedding: EmbeddingVector, topK?: number): Promise<RetrievalResult[]>;
+}
+export declare function createHybridSearch(vectorStore: VectorStore, bm25Index: BM25Index, config?: HybridSearchConfig): HybridSearch;
+//# sourceMappingURL=hybrid.d.ts.map

package/dist/hybrid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hybrid.d.ts","sourceRoot":"","sources":["../src/hybrid.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,WAAW,kBAAkB;IAClC,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,YAAY;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;CACjG;AAsCD,wBAAgB,kBAAkB,CACjC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,EACpB,MAAM,CAAC,EAAE,kBAAkB,GACzB,YAAY,CAwBd"}

package/dist/index.d.ts

@@ -3,10 +3,22 @@ export { textLoader, markdownLoader, htmlLoader, jsonLoader, csvLoader, getLoade
 export type { DocumentLoader } from './loaders';
 export { fixedSizeChunker, recursiveChunker, sentenceChunker, getChunker, } from './chunkers';
 export type { Chunker } from './chunkers';
-export { createOpenAIEmbeddings, createMockEmbeddings, getEmbeddingProvider, } from './embeddings';
-export type { EmbeddingProvider } from './embeddings';
-export { createInMemoryStore, cosineSimilarity, mmrRerank, } from './vectorstore';
-export type { VectorStore } from './vectorstore';
+export { createOpenAIEmbeddings, createMockEmbeddings, getEmbeddingProvider, embeddingProviderRegistry, } from './embeddings';
+export type { EmbeddingProvider, EmbeddingProviderFactory } from './embeddings';
+export { createInMemoryStore, cosineSimilarity, mmrRerank, vectorStoreRegistry, } from './vectorstore';
+export type { VectorStore, VectorStoreFactory } from './vectorstore';
 export { rag } from './pipeline';
 export type { RAGPipeline, RAGPipelineConfig, IngestResult } from './pipeline';
+export { createPgVectorStore } from './stores/index';
+export type { PgVectorStoreConfig } from './stores/index';
+export { createQdrantStore } from './stores/index';
+export type { QdrantStoreConfig } from './stores/index';
+export { createGoogleEmbeddings } from './providers/google-embeddings';
+export type { GoogleEmbeddingsConfig } from './providers/google-embeddings';
+export { createCohereEmbeddings } from './providers/cohere-embeddings';
+export type { CohereEmbeddingsConfig } from './providers/cohere-embeddings';
+export { createBM25Index } from './bm25';
+export type { BM25Index } from './bm25';
+export { createHybridSearch } from './hybrid';
+export type { HybridSearch, HybridSearchConfig } from './hybrid';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACX,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,eAAe,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACN,UAAU,EACV,cAAc,EACd,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,GACT,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAG/C,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,UAAU,GACV,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAGzC,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,GACpB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAGrD,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,SAAS,GACT,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAChC,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACX,QAAQ,EACR,gBAAgB,EAChB,KAAK,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,eAAe,EACf,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,eAAe,GACf,MAAM,SAAS,CAAA;AAGhB,OAAO,EACN,UAAU,EACV,cAAc,EACd,UAAU,EACV,UAAU,EACV,SAAS,EACT,SAAS,GACT,MAAM,WAAW,CAAA;AAClB,YAAY,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAG/C,OAAO,EACN,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,UAAU,GACV,MAAM,YAAY,CAAA;AACnB,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAGzC,OAAO,EACN,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,yBAAyB,GACzB,MAAM,cAAc,CAAA;AACrB,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAA;AAG/E,OAAO,EACN,mBAAmB,EACnB,gBAAgB,EAChB,SAAS,EACT,mBAAmB,GACnB,MAAM,eAAe,CAAA;AACtB,YAAY,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAGpE,OAAO,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAChC,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACpD,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAA;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAClD,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AAGvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AACtE,YAAY,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAC3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AACtE,YAAY,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AAG3E,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAA;AACxC,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAGvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AAC7C,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA"}

package/dist/index.js

@@ -97,6 +97,89 @@ function generateId(prefix = "els") {
   const random = cryptoHex(4);
   return `${prefix}_${timestamp}_${random}`;
 }
+// ../core/src/logger.ts
+var LOG_LEVELS = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+function createLogger(options = {}) {
+  const { level = "info", pretty = false, context = {} } = options;
+  const minLevel = LOG_LEVELS[level];
+  function log(logLevel, message, data) {
+    if (LOG_LEVELS[logLevel] < minLevel)
+      return;
+    const entry = {
+      ...context,
+      level: logLevel,
+      message,
+      timestamp: new Date().toISOString(),
+      ...data ? { data } : {}
+    };
+    const output = pretty ? JSON.stringify(entry, null, 2) : JSON.stringify(entry);
+    if (logLevel === "error") {
+      console.error(output);
+    } else if (logLevel === "warn") {
+      console.warn(output);
+    } else {
+      console.log(output);
+    }
+  }
+  return {
+    debug: (msg, data) => log("debug", msg, data),
+    info: (msg, data) => log("info", msg, data),
+    warn: (msg, data) => log("warn", msg, data),
+    error: (msg, data) => log("error", msg, data),
+    child(childContext) {
+      return createLogger({
+        level,
+        pretty,
+        context: { ...context, ...childContext }
+      });
+    }
+  };
+}
+// ../core/src/schema.ts
+var log = createLogger();
+// ../core/src/registry.ts
+var log2 = createLogger();
+var BLOCKED_KEYS = new Set(["__proto__", "constructor", "prototype"]);
+function createRegistry(label) {
+  const entries = new Map;
+  return {
+    register(name, factory) {
+      if (BLOCKED_KEYS.has(name)) {
+        log2.warn(`Registry(${label}): rejected blocked key "${name}"`);
+        return;
+      }
+      entries.set(name, factory);
+      log2.debug(`Registry(${label}): registered "${name}"`);
+    },
+    get(name) {
+      if (BLOCKED_KEYS.has(name))
+        return;
+      return entries.get(name);
+    },
+    list() {
+      return Array.from(entries.keys());
+    },
+    has(name) {
+      if (BLOCKED_KEYS.has(name))
+        return false;
+      return entries.has(name);
+    },
+    unregister(name) {
+      if (BLOCKED_KEYS.has(name))
+        return false;
+      const deleted = entries.delete(name);
+      if (deleted) {
+        log2.debug(`Registry(${label}): unregistered "${name}"`);
+      }
+      return deleted;
+    }
+  };
+}
 // src/loaders.ts
 function createDocument(content, metadata) {
   return {
@@ -549,7 +632,11 @@ function createMockEmbeddings(dims = 128) {
     }
   };
 }
+var embeddingProviderRegistry = createRegistry("embeddingProvider");
 function getEmbeddingProvider(config) {
+  const registered = embeddingProviderRegistry.get(config.provider);
+  if (registered)
+    return registered(config);
   switch (config.provider) {
     case "openai":
       return createOpenAIEmbeddings(config);
@@ -558,12 +645,13 @@ function getEmbeddingProvider(config) {
     default:
       throw new ElsiumError({
         code: "CONFIG_ERROR",
-        message: `Unknown embedding provider: ${config.provider}`,
+        message: `Unknown embedding provider: ${config.provider}. Available: openai, mock${embeddingProviderRegistry.list().length ? `, ${embeddingProviderRegistry.list().join(", ")}` : ""}`,
         retryable: false
       });
   }
 }
 // src/vectorstore.ts
+var vectorStoreRegistry = createRegistry("vectorStore");
 function cosineSimilarity(a, b) {
   if (a.length !== b.length)
     return 0;
@@ -692,13 +780,19 @@ function rag(config) {
     minScore: 0,
     strategy: "similarity"
   };
-  if (config.store) {
-    throw new Error("External vector store not yet implemented. Use in-memory store.");
-  }
   const loader = getLoader(loaderType);
   const chunker = getChunker(chunkingConfig);
   const embeddingProvider = getEmbeddingProvider(config.embeddings);
-  const vectorStore = createInMemoryStore();
+  let vectorStore;
+  if (config.store) {
+    const factory = vectorStoreRegistry.get(config.store.provider);
+    if (!factory) {
+      throw new Error(`Unknown vector store provider: ${config.store.provider}. Register it with vectorStoreRegistry.register().`);
+    }
+    vectorStore = factory(config.store);
+  } else {
+    vectorStore = createInMemoryStore();
+  }
   async function embedChunks(chunks) {
     const texts = chunks.map((c) => c.content);
     const embeddings = await embeddingProvider.embedBatch(texts);
@@ -744,7 +838,442 @@ function rag(config) {
     }
   };
 }
+// src/stores/pgvector.ts
+import { createRequire } from "node:module";
+var require2 = createRequire(import.meta.url);
+var log3 = createLogger();
+var BLOCKED_KEYS2 = new Set(["__proto__", "constructor", "prototype"]);
+var TABLE_NAME_PATTERN = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+function createPgVectorStore(config) {
+  const { connectionString, tableName = "vector_chunks", dimensions = 1536 } = config;
+  if (BLOCKED_KEYS2.has(tableName)) {
+    throw new Error(`Invalid table name: ${tableName}`);
+  }
+  if (!TABLE_NAME_PATTERN.test(tableName)) {
+    throw new Error(`Invalid table name format: ${tableName}`);
+  }
+  let client = null;
+  let initialized = false;
+  async function getClient() {
+    if (client)
+      return client;
+    try {
+      const pg = require2("pg");
+      client = new pg.Client({ connectionString });
+      await client.connect();
+      if (!initialized) {
+        await client.query("CREATE EXTENSION IF NOT EXISTS vector");
+        await client.query(`
+					CREATE TABLE IF NOT EXISTS ${tableName} (
+						id TEXT PRIMARY KEY,
+						content TEXT NOT NULL,
+						document_id TEXT NOT NULL,
+						chunk_index INTEGER NOT NULL,
+						metadata JSONB DEFAULT '{}',
+						embedding vector(${dimensions})
+					)
+				`);
+        initialized = true;
+      }
+      return client;
+    } catch (err2) {
+      log3.error("Failed to initialize PgVector store", {
+        error: err2 instanceof Error ? err2.message : String(err2)
+      });
+      throw new Error("pg is required for PgVector store. Install it as a dependency.");
+    }
+  }
+  return {
+    name: "pgvector",
+    async upsert(chunks) {
+      const pg = await getClient();
+      for (const chunk of chunks) {
+        if (BLOCKED_KEYS2.has(chunk.id))
+          continue;
+        const embedding = `[${chunk.embedding.values.join(",")}]`;
+        await pg.query(`INSERT INTO ${tableName} (id, content, document_id, chunk_index, metadata, embedding)
+					 VALUES ($1, $2, $3, $4, $5, $6)
+					 ON CONFLICT (id) DO UPDATE SET
+						content = EXCLUDED.content,
+						document_id = EXCLUDED.document_id,
+						chunk_index = EXCLUDED.chunk_index,
+						metadata = EXCLUDED.metadata,
+						embedding = EXCLUDED.embedding`, [
+          chunk.id,
+          chunk.content,
+          chunk.documentId,
+          chunk.index,
+          JSON.stringify(chunk.metadata),
+          embedding
+        ]);
+      }
+    },
+    async query(embedding, options) {
+      const pg = await getClient();
+      const topK = options?.topK ?? 5;
+      const minScore = options?.minScore ?? 0;
+      const embeddingStr = `[${embedding.values.join(",")}]`;
+      const result = await pg.query(`SELECT id, content, document_id, chunk_index, metadata,
+								1 - (embedding <=> $1::vector) as score
+				 FROM ${tableName}
+				 WHERE 1 - (embedding <=> $1::vector) >= $2
+				 ORDER BY embedding <=> $1::vector
+				 LIMIT $3`, [embeddingStr, minScore, topK]);
+      return result.rows.map((row) => ({
+        chunk: {
+          id: row.id,
+          content: row.content,
+          documentId: row.document_id,
+          index: row.chunk_index,
+          metadata: {
+            startChar: 0,
+            endChar: 0,
+            tokenEstimate: 0,
+            ...row.metadata ?? {}
+          }
+        },
+        score: row.score,
+        distance: 1 - row.score
+      }));
+    },
+    async delete(ids) {
+      const pg = await getClient();
+      const filtered = ids.filter((id) => !BLOCKED_KEYS2.has(id));
+      if (filtered.length === 0)
+        return;
+      const placeholders = filtered.map((_, i) => `$${i + 1}`).join(", ");
+      await pg.query(`DELETE FROM ${tableName} WHERE id IN (${placeholders})`, filtered);
+    },
+    async clear() {
+      const pg = await getClient();
+      await pg.query(`DELETE FROM ${tableName}`);
+    },
+    async count() {
+      const pg = await getClient();
+      const result = await pg.query(`SELECT COUNT(*)::int as count FROM ${tableName}`);
+      return result.rows[0]?.count ?? 0;
+    }
+  };
+}
+// src/stores/qdrant.ts
+function createQdrantStore(config) {
+  const { url, apiKey, collectionName, dimensions } = config;
+  const headers = {
+    "Content-Type": "application/json"
+  };
+  if (apiKey) {
+    headers["api-key"] = apiKey;
+  }
+  async function request(method, path, body) {
+    const response = await fetch(`${url}${path}`, {
+      method,
+      headers,
+      ...body ? { body: JSON.stringify(body) } : {}
+    });
+    if (!response.ok) {
+      const text = await response.text().catch(() => "Unknown error");
+      throw ElsiumError.providerError(`Qdrant error ${response.status}: ${text}`, {
+        provider: "qdrant",
+        statusCode: response.status,
+        retryable: response.status >= 500
+      });
+    }
+    if (response.status === 204)
+      return null;
+    return response.json();
+  }
+  return {
+    name: "qdrant",
+    async upsert(chunks) {
+      const points = chunks.map((chunk) => ({
+        id: chunk.id,
+        vector: chunk.embedding.values,
+        payload: {
+          content: chunk.content,
+          documentId: chunk.documentId,
+          index: chunk.index,
+          metadata: chunk.metadata
+        }
+      }));
+      await request("PUT", `/collections/${collectionName}/points`, {
+        points
+      });
+    },
+    async query(embedding, options) {
+      const topK = options?.topK ?? 5;
+      const minScore = options?.minScore ?? 0;
+      const result = await request("POST", `/collections/${collectionName}/points/search`, {
+        vector: embedding.values,
+        limit: topK,
+        score_threshold: minScore,
+        with_payload: true
+      });
+      return (result.result ?? []).map((hit) => ({
+        chunk: {
+          id: String(hit.id),
+          content: hit.payload.content,
+          documentId: hit.payload.documentId,
+          index: hit.payload.index,
+          metadata: hit.payload.metadata
+        },
+        score: hit.score,
+        distance: 1 - hit.score
+      }));
+    },
+    async delete(ids) {
+      await request("POST", `/collections/${collectionName}/points/delete`, {
+        points: ids
+      });
+    },
+    async clear() {
+      try {
+        await request("DELETE", `/collections/${collectionName}`);
+      } catch {}
+      await request("PUT", `/collections/${collectionName}`, {
+        vectors: { size: dimensions, distance: "Cosine" }
+      });
+    },
+    async count() {
+      const result = await request("GET", `/collections/${collectionName}`);
+      return result.result?.points_count ?? 0;
+    }
+  };
+}
+vectorStoreRegistry.register("qdrant", (config) => createQdrantStore(config));
+// src/providers/google-embeddings.ts
+function createGoogleEmbeddings(config) {
+  const { apiKey, model = "text-embedding-004", dimensions = 768 } = config;
+  if (!apiKey) {
+    throw new ElsiumError({
+      code: "CONFIG_ERROR",
+      message: "Google API key is required for embeddings",
+      retryable: false
+    });
+  }
+  const baseUrl = "https://generativelanguage.googleapis.com/v1beta";
+  async function callAPI(texts) {
+    const results = [];
+    for (const text of texts) {
+      const url = `${baseUrl}/models/${model}:embedContent?key=${apiKey}`;
+      const response = await fetch(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          model: `models/${model}`,
+          content: { parts: [{ text }] },
+          ...dimensions ? { outputDimensionality: dimensions } : {}
+        })
+      });
+      if (!response.ok) {
+        const body = await response.text().catch(() => "Unknown error");
+        throw ElsiumError.providerError(`Google embeddings error ${response.status}: ${body}`, {
+          provider: "google",
+          statusCode: response.status,
+          retryable: response.status >= 500
+        });
+      }
+      const json = await response.json();
+      results.push(json.embedding.values);
+    }
+    return results;
+  }
+  return {
+    name: "google",
+    dimensions,
+    async embed(text) {
+      const [embedding] = await callAPI([text]);
+      return { values: embedding, dimensions: embedding.length };
+    },
+    async embedBatch(texts) {
+      const embeddings = await callAPI(texts);
+      return embeddings.map((values) => ({
+        values,
+        dimensions: values.length
+      }));
+    }
+  };
+}
+embeddingProviderRegistry.register("google", (config) => createGoogleEmbeddings({
+  apiKey: config.apiKey ?? "",
+  model: config.model,
+  dimensions: config.dimensions
+}));
+// src/providers/cohere-embeddings.ts
+function createCohereEmbeddings(config) {
+  const { apiKey, model = "embed-v4.0", inputType = "search_document" } = config;
+  if (!apiKey) {
+    throw new ElsiumError({
+      code: "CONFIG_ERROR",
+      message: "Cohere API key is required for embeddings",
+      retryable: false
+    });
+  }
+  async function callAPI(texts) {
+    const response = await fetch("https://api.cohere.com/v2/embed", {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${apiKey}`
+      },
+      body: JSON.stringify({
+        texts,
+        model,
+        input_type: inputType,
+        embedding_types: ["float"]
+      })
+    });
+    if (!response.ok) {
+      const body = await response.text().catch(() => "Unknown error");
+      throw ElsiumError.providerError(`Cohere embeddings error ${response.status}: ${body}`, {
+        provider: "cohere",
+        statusCode: response.status,
+        retryable: response.status >= 500
+      });
+    }
+    const json = await response.json();
+    return json.embeddings.float;
+  }
+  return {
+    name: "cohere",
+    dimensions: 1024,
+    async embed(text) {
+      const [embedding] = await callAPI([text]);
+      return { values: embedding, dimensions: embedding.length };
+    },
+    async embedBatch(texts) {
+      const embeddings = await callAPI(texts);
+      return embeddings.map((values) => ({
+        values,
+        dimensions: values.length
+      }));
+    }
+  };
+}
+embeddingProviderRegistry.register("cohere", (config) => createCohereEmbeddings({
+  apiKey: config.apiKey ?? "",
+  model: config.model
+}));
+// src/bm25.ts
+function tokenize(text) {
+  return text.toLowerCase().replace(/[^\w\s]/g, " ").split(/\s+/).filter((t) => t.length > 0);
+}
+function createBM25Index(options) {
+  const k1 = options?.k1 ?? 1.2;
+  const b = options?.b ?? 0.75;
+  const docs = [];
+  const docFreqs = new Map;
+  let avgDocLength = 0;
+  function addDoc(chunk) {
+    const tokens = tokenize(chunk.content);
+    const termFreqs = new Map;
+    for (const token of tokens) {
+      termFreqs.set(token, (termFreqs.get(token) ?? 0) + 1);
+    }
+    for (const term of termFreqs.keys()) {
+      docFreqs.set(term, (docFreqs.get(term) ?? 0) + 1);
+    }
+    docs.push({ chunk, termFreqs, length: tokens.length });
+  }
+  function recalcAvgLength() {
+    if (docs.length === 0) {
+      avgDocLength = 0;
+      return;
+    }
+    avgDocLength = docs.reduce((sum, d) => sum + d.length, 0) / docs.length;
+  }
+  function idf(term) {
+    const df = docFreqs.get(term) ?? 0;
+    const n = docs.length;
+    if (df === 0)
+      return 0;
+    return Math.log((n - df + 0.5) / (df + 0.5) + 1);
+  }
+  function scoreSingle(doc, queryTerms) {
+    let score = 0;
+    for (const term of queryTerms) {
+      const tf = doc.termFreqs.get(term) ?? 0;
+      if (tf === 0)
+        continue;
+      const termIdf = idf(term);
+      const numerator = tf * (k1 + 1);
+      const denominator = tf + k1 * (1 - b + b * (doc.length / avgDocLength));
+      score += termIdf * (numerator / denominator);
+    }
+    return score;
+  }
+  return {
+    index(chunks) {
+      for (const chunk of chunks) {
+        addDoc(chunk);
+      }
+      recalcAvgLength();
+    },
+    search(query, topK = 5) {
+      if (docs.length === 0)
+        return [];
+      const queryTerms = tokenize(query);
+      if (queryTerms.length === 0)
+        return [];
+      const scored = [];
+      for (const doc of docs) {
+        const score = scoreSingle(doc, queryTerms);
+        if (score > 0) {
+          scored.push({ chunk: doc.chunk, score });
+        }
+      }
+      scored.sort((a, b2) => b2.score - a.score);
+      return scored.slice(0, topK).map((s) => ({
+        chunk: s.chunk,
+        score: s.score,
+        distance: 0
+      }));
+    }
+  };
+}
+// src/hybrid.ts
+function reciprocalRankFusion(vectorResults, bm25Results, k, vectorWeight, bm25Weight) {
+  const scores = new Map;
+  for (let i = 0;i < vectorResults.length; i++) {
+    const result = vectorResults[i];
+    const rrfScore = vectorWeight / (k + i + 1);
+    const existing = scores.get(result.chunk.id);
+    if (existing) {
+      existing.score += rrfScore;
+    } else {
+      scores.set(result.chunk.id, { score: rrfScore, chunk: result.chunk });
+    }
+  }
+  for (let i = 0;i < bm25Results.length; i++) {
+    const result = bm25Results[i];
+    const rrfScore = bm25Weight / (k + i + 1);
+    const existing = scores.get(result.chunk.id);
+    if (existing) {
+      existing.score += rrfScore;
+    } else {
+      scores.set(result.chunk.id, { score: rrfScore, chunk: result.chunk });
+    }
+  }
+  return Array.from(scores.values()).sort((a, b) => b.score - a.score).map(({ score, chunk }) => ({ chunk, score, distance: 0 }));
+}
+function createHybridSearch(vectorStore, bm25Index, config) {
+  const k = config?.k ?? 60;
+  const vectorWeight = config?.vectorWeight ?? 1;
+  const bm25Weight = config?.bm25Weight ?? 1;
+  const defaultTopK = config?.topK ?? 10;
+  return {
+    async search(query, queryEmbedding, topK) {
+      const limit = topK ?? defaultTopK;
+      const [vectorResults, bm25Results] = await Promise.all([
+        vectorStore.query(queryEmbedding, { topK: limit }),
+        Promise.resolve(bm25Index.search(query, limit))
+      ]);
+      const fused = reciprocalRankFusion(vectorResults, bm25Results, k, vectorWeight, bm25Weight);
+      return fused.slice(0, limit);
+    }
+  };
+}
 export {
+  vectorStoreRegistry,
   textLoader,
   sentenceChunker,
   recursiveChunker,
@@ -757,9 +1286,16 @@ export {
   getEmbeddingProvider,
   getChunker,
   fixedSizeChunker,
+  embeddingProviderRegistry,
   csvLoader,
+  createQdrantStore,
+  createPgVectorStore,
   createOpenAIEmbeddings,
   createMockEmbeddings,
   createInMemoryStore,
+  createHybridSearch,
+  createGoogleEmbeddings,
+  createCohereEmbeddings,
+  createBM25Index,
   cosineSimilarity
 };

package/dist/pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,cAAc,CAAA;AAE3E,OAAO,KAAK,EAEX,cAAc,EACd,QAAQ,EAER,eAAe,EACf,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,KAAK,WAAW,EAAuB,MAAM,eAAe,CAAA;AAErE,MAAM,WAAW,iBAAiB;IACjC,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,UAAU,EAAE,eAAe,CAAA;IAC3B,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,SAAS,CAAC,EAAE,eAAe,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC9D,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACzD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;IAC7C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;CACjC;AAED,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CA8E1D"}
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../src/pipeline.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,iBAAiB,EAAwB,MAAM,cAAc,CAAA;AAE3E,OAAO,KAAK,EAEX,cAAc,EACd,QAAQ,EAER,eAAe,EACf,UAAU,EACV,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,MAAM,SAAS,CAAA;AAChB,OAAO,EAAE,KAAK,WAAW,EAA4C,MAAM,eAAe,CAAA;AAE1F,MAAM,WAAW,iBAAiB;IACjC,MAAM,CAAC,EAAE,UAAU,CAAA;IACnB,QAAQ,CAAC,EAAE,cAAc,CAAA;IACzB,UAAU,EAAE,eAAe,CAAA;IAC3B,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,SAAS,CAAC,EAAE,eAAe,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IAC3B,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC9D,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACzD,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACxB,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAA;IAC7C,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;CACjC;AAED,MAAM,WAAW,YAAY;IAC5B,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,GAAG,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CAsF1D"}

package/dist/providers/cohere-embeddings.d.ts

@@ -0,0 +1,8 @@
+import type { EmbeddingProvider } from '../embeddings';
+export interface CohereEmbeddingsConfig {
+    apiKey: string;
+    model?: string;
+    inputType?: string;
+}
+export declare function createCohereEmbeddings(config: CohereEmbeddingsConfig): EmbeddingProvider;
+//# sourceMappingURL=cohere-embeddings.d.ts.map

package/dist/providers/cohere-embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cohere-embeddings.d.ts","sourceRoot":"","sources":["../../src/providers/cohere-embeddings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAItD,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,iBAAiB,CA2DxF"}

package/dist/providers/google-embeddings.d.ts

@@ -0,0 +1,8 @@
+import type { EmbeddingProvider } from '../embeddings';
+export interface GoogleEmbeddingsConfig {
+    apiKey: string;
+    model?: string;
+    dimensions?: number;
+}
+export declare function createGoogleEmbeddings(config: GoogleEmbeddingsConfig): EmbeddingProvider;
+//# sourceMappingURL=google-embeddings.d.ts.map

package/dist/providers/google-embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"google-embeddings.d.ts","sourceRoot":"","sources":["../../src/providers/google-embeddings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAItD,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,iBAAiB,CAgExF"}

package/dist/stores/index.d.ts

@@ -0,0 +1,5 @@
+export { createPgVectorStore } from './pgvector';
+export type { PgVectorStoreConfig } from './pgvector';
+export { createQdrantStore } from './qdrant';
+export type { QdrantStoreConfig } from './qdrant';
+//# sourceMappingURL=index.d.ts.map

package/dist/stores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAChD,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErD,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAC5C,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA"}

package/dist/stores/pgvector.d.ts

@@ -0,0 +1,8 @@
+import type { VectorStore } from '../vectorstore';
+export interface PgVectorStoreConfig {
+    connectionString: string;
+    tableName?: string;
+    dimensions?: number;
+}
+export declare function createPgVectorStore(config: PgVectorStoreConfig): VectorStore;
+//# sourceMappingURL=pgvector.d.ts.map

package/dist/stores/pgvector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pgvector.d.ts","sourceRoot":"","sources":["../../src/stores/pgvector.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAOjD,MAAM,WAAW,mBAAmB;IACnC,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAOD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,mBAAmB,GAAG,WAAW,CAoI5E"}

package/dist/stores/qdrant.d.ts

@@ -0,0 +1,9 @@
+import type { VectorStore } from '../vectorstore';
+export interface QdrantStoreConfig {
+    url: string;
+    apiKey?: string;
+    collectionName: string;
+    dimensions: number;
+}
+export declare function createQdrantStore(config: QdrantStoreConfig): VectorStore;
+//# sourceMappingURL=qdrant.d.ts.map

package/dist/stores/qdrant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant.d.ts","sourceRoot":"","sources":["../../src/stores/qdrant.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGjD,MAAM,WAAW,iBAAiB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,iBAAiB,GAAG,WAAW,CA+GxE"}

package/dist/vectorstore.d.ts

@@ -1,3 +1,4 @@
+import type { Registry } from '@elsium-ai/core';
 import type { EmbeddedChunk, EmbeddingVector, QueryOptions, RetrievalResult } from './types';
 export interface VectorStore {
     readonly name: string;
@@ -7,6 +8,8 @@ export interface VectorStore {
     clear(): Promise<void>;
     count(): Promise<number>;
 }
+export type VectorStoreFactory = (config: Record<string, unknown>) => VectorStore;
+export declare const vectorStoreRegistry: Registry<VectorStoreFactory>;
 export declare function cosineSimilarity(a: number[], b: number[]): number;
 export declare function createInMemoryStore(options?: {
     maxChunks?: number;

package/dist/vectorstore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vectorstore.d.ts","sourceRoot":"","sources":["../src/vectorstore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE5F,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,KAAK,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACrF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CACxB;AAID,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAkBjE;AAID,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,WAAW,CA2Dd;AAmDD,wBAAgB,SAAS,CACxB,cAAc,EAAE,eAAe,EAC/B,OAAO,EAAE,KAAK,CAAC,eAAe,GAAG;IAAE,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC,EAChE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,eAAe,EAAE,CAqBnB"}
+{"version":3,"file":"vectorstore.d.ts","sourceRoot":"","sources":["../src/vectorstore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE5F,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAErB,MAAM,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,KAAK,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IACrF,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CACxB;AAID,MAAM,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,WAAW,CAAA;AAEjF,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,kBAAkB,CACX,CAAA;AAIlD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAkBjE;AAID,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB,GAAG,WAAW,CA2Dd;AAmDD,wBAAgB,SAAS,CACxB,cAAc,EAAE,eAAe,EAC/B,OAAO,EAAE,KAAK,CAAC,eAAe,GAAG;IAAE,SAAS,EAAE,eAAe,CAAA;CAAE,CAAC,EAChE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1C,eAAe,EAAE,CAqBnB"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@elsium-ai/rag",
-	"version": "0.2.3",
+	"version": "0.4.0",
 	"description": "RAG pipeline, document processing, embeddings, and vector stores for ElsiumAI",
 	"license": "MIT",
 	"author": "Eric Utrera <ebutrera9103@gmail.com>",
@@ -26,7 +26,7 @@
 		"dev": "bun --watch src/index.ts"
 	},
 	"dependencies": {
-		"@elsium-ai/core": "^0.2.3"
+		"@elsium-ai/core": "^0.4.0"
 	},
 	"devDependencies": {
 		"typescript": "^5.7.0"