@retrivora-ai/rag-engine 0.1.5 → 0.1.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/dist/{DocumentChunker-cfaMidtA.d.mts → DocumentChunker-BEyzadsv.d.mts} +2 -2
  2. package/dist/{DocumentChunker-cfaMidtA.d.ts → DocumentChunker-BEyzadsv.d.ts} +2 -2
  3. package/dist/{PineconeProvider-NJ675H7U.mjs → PineconeProvider-ZRAFNFEC.mjs} +1 -1
  4. package/dist/{PostgreSQLProvider-ISNMD3BE.mjs → PostgreSQLProvider-ZNXA67IM.mjs} +1 -1
  5. package/dist/{QdrantProvider-LJWOIGES.mjs → QdrantProvider-NYGHAA7C.mjs} +1 -1
  6. package/dist/{RagConfig-DG_0f8ka.d.mts → RagConfig-hBGXJmSx.d.mts} +3 -3
  7. package/dist/{RagConfig-DG_0f8ka.d.ts → RagConfig-hBGXJmSx.d.ts} +3 -3
  8. package/dist/{chunk-6FODXNUF.mjs → chunk-5K23H7JL.mjs} +27 -1
  9. package/dist/chunk-HSBXE2WV.mjs +1758 -0
  10. package/dist/{chunk-S5DRHETN.mjs → chunk-IUTAZ7QR.mjs} +31 -2
  11. package/dist/{chunk-AALIF3AL.mjs → chunk-ZM6TYIDH.mjs} +3 -3
  12. package/dist/handlers/index.d.mts +3 -44
  13. package/dist/handlers/index.d.ts +3 -44
  14. package/dist/handlers/index.js +1322 -57
  15. package/dist/handlers/index.mjs +1 -1
  16. package/dist/index-Bx182KKn.d.ts +64 -0
  17. package/dist/index-Ck2pt7-8.d.mts +64 -0
  18. package/dist/index.d.mts +4 -4
  19. package/dist/index.d.ts +4 -4
  20. package/dist/server.d.mts +65 -18
  21. package/dist/server.d.ts +65 -18
  22. package/dist/server.js +1322 -57
  23. package/dist/server.mjs +4 -4
  24. package/package.json +2 -1
  25. package/src/config/serverConfig.ts +3 -0
  26. package/src/core/BatchProcessor.ts +347 -0
  27. package/src/core/ConfigValidator.ts +560 -0
  28. package/src/core/Pipeline.ts +89 -39
  29. package/src/core/ProviderHealthCheck.ts +565 -0
  30. package/src/core/VectorPlugin.ts +49 -8
  31. package/src/handlers/index.ts +2 -2
  32. package/src/providers/vectordb/BaseVectorProvider.ts +1 -1
  33. package/src/providers/vectordb/MilvusProvider.ts +1 -1
  34. package/src/providers/vectordb/MongoDBProvider.ts +1 -1
  35. package/src/providers/vectordb/PineconeProvider.ts +4 -4
  36. package/src/providers/vectordb/PostgreSQLProvider.ts +35 -3
  37. package/src/providers/vectordb/QdrantProvider.ts +32 -2
  38. package/src/rag/DocumentChunker.ts +2 -2
  39. package/src/types/index.ts +3 -3
  40. package/dist/chunk-BP4U4TT5.mjs +0 -548
@@ -31,7 +31,7 @@ export class PineconeProvider extends BaseVectorProvider {
31
31
  async upsert(doc: UpsertDocument, namespace?: string): Promise<void> {
32
32
  await this.index(namespace).upsert({
33
33
  records: [{
34
- id: doc.id,
34
+ id: String(doc.id),
35
35
  values: doc.vector,
36
36
  metadata: { content: doc.content, ...(doc.metadata ?? {}) } as RecordMetadata,
37
37
  }],
@@ -42,7 +42,7 @@ export class PineconeProvider extends BaseVectorProvider {
42
42
  const BATCH = 100;
43
43
  for (let i = 0; i < docs.length; i += BATCH) {
44
44
  const records = docs.slice(i, i + BATCH).map((d) => ({
45
- id: d.id,
45
+ id: String(d.id),
46
46
  values: d.vector,
47
47
  metadata: { content: d.content, ...(d.metadata ?? {}) } as RecordMetadata,
48
48
  }));
@@ -65,8 +65,8 @@ export class PineconeProvider extends BaseVectorProvider {
65
65
  }));
66
66
  }
67
67
 
68
- async delete(id: string, namespace?: string): Promise<void> {
69
- await this.index(namespace).deleteOne({ id });
68
+ async delete(id: string | number, namespace?: string): Promise<void> {
69
+ await this.index(namespace).deleteOne({ id: String(id) });
70
70
  }
71
71
 
72
72
  async deleteNamespace(namespace: string): Promise<void> {
@@ -60,8 +60,40 @@ export class PostgreSQLProvider extends BaseVectorProvider {
60
60
  }
61
61
 
62
62
  async batchUpsert(docs: UpsertDocument[], namespace = ''): Promise<void> {
63
- for (const doc of docs) {
64
- await this.upsert(doc, namespace);
63
+ if (docs.length === 0) return;
64
+
65
+ const client = await this.pool.connect();
66
+ try {
67
+ await client.query('BEGIN');
68
+
69
+ const BATCH_SIZE = 50;
70
+ for (let i = 0; i < docs.length; i += BATCH_SIZE) {
71
+ const batch = docs.slice(i, i + BATCH_SIZE);
72
+ const values: unknown[] = [];
73
+ const valuePlaceholders = batch.map((doc, idx) => {
74
+ const offset = idx * 5;
75
+ values.push(doc.id, namespace, doc.content, JSON.stringify(doc.metadata ?? {}), `[${doc.vector.join(',')}]`);
76
+ return `($${offset + 1}, $${offset + 2}, $${offset + 3}, $${offset + 4}, $${offset + 5}::vector)`;
77
+ }).join(', ');
78
+
79
+ const query = `
80
+ INSERT INTO ${this.tableName} (id, namespace, content, metadata, embedding)
81
+ VALUES ${valuePlaceholders}
82
+ ON CONFLICT (id) DO UPDATE
83
+ SET namespace = EXCLUDED.namespace,
84
+ content = EXCLUDED.content,
85
+ metadata = EXCLUDED.metadata,
86
+ embedding = EXCLUDED.embedding
87
+ `;
88
+ await client.query(query, values);
89
+ }
90
+
91
+ await client.query('COMMIT');
92
+ } catch (error) {
93
+ await client.query('ROLLBACK');
94
+ throw error;
95
+ } finally {
96
+ client.release();
65
97
  }
66
98
  }
67
99
 
@@ -99,7 +131,7 @@ export class PostgreSQLProvider extends BaseVectorProvider {
99
131
  }));
100
132
  }
101
133
 
102
- async delete(id: string, namespace?: string): Promise<void> {
134
+ async delete(id: string | number, namespace?: string): Promise<void> {
103
135
  const where = namespace ? 'WHERE id = $1 AND namespace = $2' : 'WHERE id = $1';
104
136
  const params = namespace ? [id, namespace] : [id];
105
137
  await this.pool.query(`DELETE FROM ${this.tableName} ${where}`, params);
@@ -26,6 +26,37 @@ export class QdrantProvider extends BaseVectorProvider {
26
26
 
27
27
  async initialize(): Promise<void> {
28
28
  await this.ping();
29
+ await this.ensureIndex();
30
+ }
31
+
32
+ /**
33
+ * Ensures that the 'namespace' field has a keyword index for efficient filtering.
34
+ * Qdrant requires this for search filters to work in many configurations.
35
+ */
36
+ private async ensureIndex(): Promise<void> {
37
+ try {
38
+ await this.http.put(`/collections/${this.indexName}/index`, {
39
+ field_name: 'namespace',
40
+ field_schema: 'keyword',
41
+ });
42
+ console.log(`[QdrantProvider] ✅ Ensured keyword index for "namespace" on collection "${this.indexName}"`);
43
+ } catch (err) {
44
+ let status: number | undefined;
45
+ let data: unknown;
46
+
47
+ if (axios.isAxiosError(err)) {
48
+ status = err.response?.status;
49
+ data = err.response?.data;
50
+ }
51
+
52
+ // 409 means it already exists, which is fine.
53
+ if (status === 409) {
54
+ return;
55
+ }
56
+
57
+ const errorMessage = err instanceof Error ? err.message : String(err);
58
+ console.warn(`[QdrantProvider] ⚠️ Could not ensure namespace index (Status: ${status}):`, JSON.stringify(data || errorMessage));
59
+ }
29
60
  }
30
61
 
31
62
  async upsert(doc: UpsertDocument, namespace?: string): Promise<void> {
@@ -67,13 +98,12 @@ export class QdrantProvider extends BaseVectorProvider {
67
98
  }
68
99
 
69
100
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
70
- async delete(id: string, _namespace?: string): Promise<void> {
101
+ async delete(id: string | number, _namespace?: string): Promise<void> {
71
102
  await this.http.post(`/collections/${this.indexName}/points/delete`, {
72
103
  points: [id],
73
104
  });
74
105
  }
75
106
 
76
- // eslint-disable-next-line @typescript-eslint/no-unused-vars
77
107
  async deleteNamespace(_namespace: string): Promise<void> {
78
108
  await this.http.post(`/collections/${this.indexName}/points/delete`, {
79
109
  filter: {
@@ -20,7 +20,7 @@ export interface ChunkOptions {
20
20
  /** Overlap between consecutive chunks in characters (default 200) */
21
21
  chunkOverlap?: number;
22
22
  /** Source document identifier used as ID prefix */
23
- docId?: string;
23
+ docId?: string | number;
24
24
  /** Extra metadata to attach to every chunk */
25
25
  metadata?: Record<string, unknown>;
26
26
  }
@@ -96,7 +96,7 @@ export class DocumentChunker {
96
96
  * Chunk multiple documents at once.
97
97
  */
98
98
  chunkMany(
99
- documents: Array<{ content: string; docId?: string; metadata?: Record<string, unknown> }>
99
+ documents: Array<{ content: string; docId?: string | number; metadata?: Record<string, unknown> }>
100
100
  ): Chunk[] {
101
101
  return documents.flatMap((doc) =>
102
102
  this.chunk(doc.content, { docId: doc.docId, metadata: doc.metadata })
@@ -1,19 +1,19 @@
1
1
  export interface VectorMatch {
2
- id: string;
2
+ id: string | number;
3
3
  score: number;
4
4
  content: string;
5
5
  metadata?: Record<string, unknown>;
6
6
  }
7
7
 
8
8
  export interface UpsertDocument {
9
- id: string;
9
+ id: string | number;
10
10
  vector: number[];
11
11
  content: string;
12
12
  metadata?: Record<string, unknown>;
13
13
  }
14
14
 
15
15
  export interface IngestDocument {
16
- docId: string;
16
+ docId: string | number;
17
17
  content: string;
18
18
  metadata?: Record<string, unknown>;
19
19
  }