@eucoder/rag 0.3.0 → 0.3.1

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export { ParameterOptimizer } from "./optimizer.js";
 export { SelfImprovingRag } from "./self-improving.js";
 export { Neo4jKnowledgeGraph } from "./neo4j-knowledge-graph.js";
 export type { Neo4jConfig } from "./neo4j-knowledge-graph.js";
+export { QdrantVectorStore } from "./qdrant-store.js";
+export type { QdrantFilter, QdrantSearchResult } from "./qdrant-store.js";
 export type { LlmProvider } from "./llm-grader.js";
 export type { Retriever, KeywordRetriever, Grader, GraderResult, QueryRewriter, CorrectiveRagOptions, RagAnswer, RagCitation, HybridSearchOptions, HybridSearchResult, Entity, Relation, KnowledgeGraph, AsyncKnowledgeGraph, EntityExtractor, RelationExtractor, KnowledgeGraphRagOptions, KnowledgeGraphRagResult, ReasoningStep, AgenticRagOptions, AgenticRagResult, } from "./types.js";
 export type { RagFeedback, RagMetrics, ABTestResult, OptimizationSuggestion, FeedbackStorage, } from "./feedback.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,EACN,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAE9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE1E,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,MAAM,EACN,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,SAAS,EACT,WAAW,EACX,mBAAmB,EACnB,kBAAkB,EAClB,MAAM,EACN,QAAQ,EACR,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,YAAY,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,sBAAsB,EACtB,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,iBAAiB,GAClB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,mBAAmB,GACpB,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -11,4 +11,5 @@ export { ParameterOptimizer } from "./optimizer.js";
 export { SelfImprovingRag } from "./self-improving.js";
 // Fase 5: Knowledge Graph Persistente
 export { Neo4jKnowledgeGraph } from "./neo4j-knowledge-graph.js";
+export { QdrantVectorStore } from "./qdrant-store.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,yBAAyB;AACzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,sCAAsC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,yBAAyB;AACzB,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,sCAAsC;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/qdrant-store.d.ts

@@ -0,0 +1,19 @@
+export interface QdrantFilter {
+    [key: string]: unknown;
+}
+export interface QdrantSearchResult {
+    id: string;
+    score: number;
+    payload?: Record<string, unknown>;
+}
+export declare class QdrantVectorStore {
+    private baseUrl;
+    private apiKey?;
+    connect(url: string, apiKey?: string): void;
+    private headers;
+    private request;
+    addVectors(ids: string[], vectors: number[][], payloads: Record<string, unknown>[]): Promise<void>;
+    search(vector: number[], topK: number, filter?: QdrantFilter): Promise<QdrantSearchResult[]>;
+    deleteCollection(name: string): Promise<void>;
+}
+//# sourceMappingURL=qdrant-store.d.ts.map

package/dist/qdrant-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-store.d.ts","sourceRoot":"","sources":["../src/qdrant-store.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAc;IAC7B,OAAO,CAAC,MAAM,CAAC,CAAS;IAExB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAK3C,OAAO,CAAC,OAAO;YAMD,OAAO;IAaf,UAAU,CACd,GAAG,EAAE,MAAM,EAAE,EACb,OAAO,EAAE,MAAM,EAAE,EAAE,EACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAClC,OAAO,CAAC,IAAI,CAAC;IAmCV,MAAM,CACV,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IA6B1B,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGpD"}

package/dist/qdrant-store.js

@@ -0,0 +1,84 @@
+export class QdrantVectorStore {
+    baseUrl = "";
+    apiKey;
+    connect(url, apiKey) {
+        this.baseUrl = url.replace(/\/$/, "");
+        this.apiKey = apiKey;
+    }
+    headers() {
+        const h = { "Content-Type": "application/json" };
+        if (this.apiKey)
+            h["api-key"] = this.apiKey;
+        return h;
+    }
+    async request(path, init) {
+        const res = await fetch(`${this.baseUrl}${path}`, {
+            ...init,
+            headers: { ...this.headers(), ...(init?.headers || {}) },
+        });
+        if (!res.ok) {
+            const text = await res.text().catch(() => "unknown error");
+            throw new Error(`Qdrant error ${res.status}: ${text}`);
+        }
+        if (res.status === 204)
+            return undefined;
+        return res.json();
+    }
+    async addVectors(ids, vectors, payloads) {
+        const dims = vectors[0]?.length ?? 0;
+        if (!dims || ids.length !== vectors.length || vectors.length !== payloads.length) {
+            throw new Error("Invalid addVectors arguments: mismatched lengths or empty vectors");
+        }
+        const collection = "eucode_chunks";
+        try {
+            await this.request(`/collections/${collection}`);
+        }
+        catch (e) {
+            if (e.message?.includes("404") || e.message?.includes("Not found")) {
+                await this.request(`/collections/${collection}`, {
+                    method: "PUT",
+                    body: JSON.stringify({
+                        vectors: { size: dims, distance: "Cosine" },
+                    }),
+                });
+            }
+            else {
+                throw e;
+            }
+        }
+        await this.request(`/collections/${collection}/points?wait=true`, {
+            method: "PUT",
+            body: JSON.stringify({
+                points: ids.map((id, i) => ({
+                    id,
+                    vector: vectors[i],
+                    payload: payloads[i],
+                })),
+            }),
+        });
+    }
+    async search(vector, topK, filter) {
+        const collection = "eucode_chunks";
+        const body = {
+            vector,
+            limit: topK,
+            with_payload: true,
+        };
+        if (filter) {
+            body.filter = filter;
+        }
+        const result = (await this.request(`/collections/${collection}/points/search`, {
+            method: "POST",
+            body: JSON.stringify(body),
+        }));
+        return (result.result ?? []).map((r) => ({
+            id: String(r.id),
+            score: r.score,
+            payload: r.payload,
+        }));
+    }
+    async deleteCollection(name) {
+        await this.request(`/collections/${name}`, { method: "DELETE" });
+    }
+}
+//# sourceMappingURL=qdrant-store.js.map

package/dist/qdrant-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qdrant-store.js","sourceRoot":"","sources":["../src/qdrant-store.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eucoder/rag",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "Advanced RAG module with Corrective RAG, Hybrid Search, Knowledge Graph, Agentic RAG, and Self-Improving capabilities",
   "type": "module",
   "main": "./dist/index.js",

package/src/index.ts

@@ -15,6 +15,9 @@ export { SelfImprovingRag } from "./self-improving.js";
 export { Neo4jKnowledgeGraph } from "./neo4j-knowledge-graph.js";
 export type { Neo4jConfig } from "./neo4j-knowledge-graph.js";
 
+export { QdrantVectorStore } from "./qdrant-store.js";
+export type { QdrantFilter, QdrantSearchResult } from "./qdrant-store.js";
+
 export type { LlmProvider } from "./llm-grader.js";
 export type {
   Retriever,

package/src/qdrant-store.ts

@@ -0,0 +1,114 @@
+export interface QdrantFilter {
+  [key: string]: unknown;
+}
+
+export interface QdrantSearchResult {
+  id: string;
+  score: number;
+  payload?: Record<string, unknown>;
+}
+
+export class QdrantVectorStore {
+  private baseUrl: string = "";
+  private apiKey?: string;
+
+  connect(url: string, apiKey?: string): void {
+    this.baseUrl = url.replace(/\/$/, "");
+    this.apiKey = apiKey;
+  }
+
+  private headers(): Record<string, string> {
+    const h: Record<string, string> = { "Content-Type": "application/json" };
+    if (this.apiKey) h["api-key"] = this.apiKey;
+    return h;
+  }
+
+  private async request(path: string, init?: RequestInit): Promise<unknown> {
+    const res = await fetch(`${this.baseUrl}${path}`, {
+      ...init,
+      headers: { ...this.headers(), ...((init?.headers as Record<string, string>) || {}) },
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => "unknown error");
+      throw new Error(`Qdrant error ${res.status}: ${text}`);
+    }
+    if (res.status === 204) return undefined;
+    return res.json();
+  }
+
+  async addVectors(
+    ids: string[],
+    vectors: number[][],
+    payloads: Record<string, unknown>[]
+  ): Promise<void> {
+    const dims = vectors[0]?.length ?? 0;
+    if (!dims || ids.length !== vectors.length || vectors.length !== payloads.length) {
+      throw new Error("Invalid addVectors arguments: mismatched lengths or empty vectors");
+    }
+
+    const collection = "eucode_chunks";
+
+    try {
+      await this.request(`/collections/${collection}`);
+    } catch (e: any) {
+      if (e.message?.includes("404") || e.message?.includes("Not found")) {
+        await this.request(`/collections/${collection}`, {
+          method: "PUT",
+          body: JSON.stringify({
+            vectors: { size: dims, distance: "Cosine" },
+          }),
+        });
+      } else {
+        throw e;
+      }
+    }
+
+    await this.request(`/collections/${collection}/points?wait=true`, {
+      method: "PUT",
+      body: JSON.stringify({
+        points: ids.map((id, i) => ({
+          id,
+          vector: vectors[i],
+          payload: payloads[i],
+        })),
+      }),
+    });
+  }
+
+  async search(
+    vector: number[],
+    topK: number,
+    filter?: QdrantFilter
+  ): Promise<QdrantSearchResult[]> {
+    const collection = "eucode_chunks";
+    const body: Record<string, unknown> = {
+      vector,
+      limit: topK,
+      with_payload: true,
+    };
+    if (filter) {
+      body.filter = filter;
+    }
+
+    const result = (await this.request(`/collections/${collection}/points/search`, {
+      method: "POST",
+      body: JSON.stringify(body),
+    })) as {
+      result?: Array<{
+        id: string | number;
+        score: number;
+        payload?: Record<string, unknown>;
+      }>;
+    };
+
+    return (result.result ?? []).map((r) => ({
+      id: String(r.id),
+      score: r.score,
+      payload: r.payload,
+    }));
+  }
+
+  async deleteCollection(name: string): Promise<void> {
+    await this.request(`/collections/${name}`, { method: "DELETE" });
+  }
+}