@eucoder/rag 0.2.0 → 0.3.0

package/README.md

@@ -98,20 +98,100 @@ console.log(result.graphContext); // Contesto formattato dal grafo
 - Contesto arricchito con entità connesse
 - Citazioni con path e line numbers
 
-**Implementazione custom del grafo:**
+#### Knowledge Graph Persistente con Neo4j
+
+Per uso in produzione, è disponibile un'implementazione persistente basata su Neo4j:
+
 ```typescript
-import type { KnowledgeGraph, Entity, Relation } from "@eucode/rag";
+import { Neo4jKnowledgeGraph } from "@eucode/rag";
 
-class MyCustomGraph implements KnowledgeGraph {
-  entities: Map<string, Entity> = new Map();
-  relations: Relation[] = [];
+const graph = new Neo4jKnowledgeGraph({
+  uri: "bolt://localhost:7687",
+  username: "neo4j",
+  password: "your-password",
+  database: "neo4j", // opzionale, default "neo4j"
+});
 
-  addEntity(entity: Entity): void { /* ... */ }
-  addRelation(relation: Relation): void { /* ... */ }
-  getEntity(id: string): Entity | undefined { /* ... */ }
-  getRelations(entityId: string): Relation[] { /* ... */ }
-  getConnectedEntities(entityId: string, depth?: number): Entity[] { /* ... */ }
+// Verifica connessione
+const connected = await graph.verifyConnectivity();
+if (!connected) {
+  throw new Error("Neo4j non raggiungibile");
 }
+
+// Inizializza schema (indici e vincoli)
+await graph.initializeSchema();
+
+// Aggiungi entità
+await graph.addEntity({
+  id: "user-1",
+  name: "Alice",
+  type: "User",
+  properties: { age: 30, role: "developer" },
+});
+
+// Aggiungi relazione
+await graph.addRelation({
+  id: "rel-1",
+  source: "user-1",
+  target: "user-2",
+  type: "KNOWS",
+  properties: { since: 2020 },
+});
+
+// Recupera entità
+const user = await graph.getEntity("user-1");
+
+// Recupera relazioni
+const relations = await graph.getRelations("user-1");
+
+// Recupera entità connesse (fino a profondità 2)
+const connected = await graph.getConnectedEntities("user-1", 2);
+
+// Cerca entità
+const users = await graph.searchEntities({ type: "User" });
+const alices = await graph.searchEntities({ name: "Alice" });
+
+// Statistiche del grafo
+const stats = await graph.getStats();
+console.log(`Entities: ${stats.entityCount}, Relations: ${stats.relationCount}`);
+
+// Elimina entità (e tutte le sue relazioni)
+await graph.deleteEntity("user-1");
+
+// Elimina relazione
+await graph.deleteRelation("rel-1");
+
+// Pulisci completamente il grafo
+await graph.clear();
+
+// Chiudi connessione
+await graph.close();
+```
+
+**Caratteristiche Neo4j:**
+- Persistenza su database Neo4j
+- Indici automatici per query veloci
+- Supporto transazioni
+- Query Cypher per operazioni complesse
+- Scalabilità orizzontale
+- Backup e recovery integrati
+
+**Requisiti:**
+- Neo4j 5.x o superiore
+- Driver `neo4j-driver` (incluso nelle dipendenze)
+
+**Setup Neo4j:**
+```bash
+# Docker
+docker run -d \
+  --name neo4j \
+  -p 7474:7474 -p 7687:7687 \
+  -e NEO4J_AUTH=neo4j/your-password \
+  -e NEO4J_PLUGINS='["apoc"]' \
+  neo4j:latest
+
+# Verifica connessione
+curl http://localhost:7474
 ```
 
 ### 4. Agentic RAG

package/dist/index.d.ts

@@ -8,8 +8,10 @@ export { MetricsCalculator } from "./metrics.js";
 export { ABTestFramework } from "./ab-testing.js";
 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 type { LlmProvider } from "./llm-grader.js";
-export type { Retriever, KeywordRetriever, Grader, GraderResult, QueryRewriter, CorrectiveRagOptions, RagAnswer, RagCitation, HybridSearchOptions, HybridSearchResult, Entity, Relation, KnowledgeGraph, EntityExtractor, RelationExtractor, KnowledgeGraphRagOptions, KnowledgeGraphRagResult, ReasoningStep, AgenticRagOptions, AgenticRagResult, } from "./types.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";
 export type { RagStrategyConfig, } from "./ab-testing.js";
 export type { OptimizableParams, } from "./optimizer.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;AAEvD,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,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,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

@@ -9,4 +9,6 @@ export { MetricsCalculator } from "./metrics.js";
 export { ABTestFramework } from "./ab-testing.js";
 export { ParameterOptimizer } from "./optimizer.js";
 export { SelfImprovingRag } from "./self-improving.js";
+// Fase 5: Knowledge Graph Persistente
+export { Neo4jKnowledgeGraph } from "./neo4j-knowledge-graph.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"}
+{"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"}

package/dist/neo4j-knowledge-graph.d.ts

@@ -0,0 +1,78 @@
+import type { Entity, Relation, AsyncKnowledgeGraph } from "./types.js";
+export interface Neo4jConfig {
+    uri: string;
+    username: string;
+    password: string;
+    database?: string;
+}
+/**
+ * Knowledge Graph persistente con Neo4j
+ *
+ * Implementa un grafo di conoscenza persistente usando Neo4j come database.
+ * Supporta operazioni CRUD per entità e relazioni, query per trovare entità connesse,
+ * e gestione delle transazioni.
+ */
+export declare class Neo4jKnowledgeGraph implements AsyncKnowledgeGraph {
+    private driver;
+    private database;
+    constructor(config: Neo4jConfig);
+    /**
+     * Chiude la connessione al database
+     */
+    close(): Promise<void>;
+    /**
+     * Verifica la connessione al database
+     */
+    verifyConnectivity(): Promise<boolean>;
+    /**
+     * Inizializza gli indici e i vincoli del database
+     */
+    initializeSchema(): Promise<void>;
+    /**
+     * Aggiunge un'entità al grafo
+     */
+    addEntity(entity: Entity): Promise<void>;
+    /**
+     * Aggiunge una relazione al grafo
+     */
+    addRelation(relation: Relation): Promise<void>;
+    /**
+     * Recupera un'entità per ID
+     */
+    getEntity(id: string): Promise<Entity | undefined>;
+    /**
+     * Recupera tutte le relazioni di un'entità
+     */
+    getRelations(entityId: string): Promise<Relation[]>;
+    /**
+     * Recupera tutte le entità connesse a un'entità fino a una certa profondità
+     */
+    getConnectedEntities(entityId: string, depth?: number): Promise<Entity[]>;
+    /**
+     * Cerca entità per nome o tipo
+     */
+    searchEntities(query: {
+        name?: string;
+        type?: string;
+    }): Promise<Entity[]>;
+    /**
+     * Elimina un'entità e tutte le sue relazioni
+     */
+    deleteEntity(entityId: string): Promise<void>;
+    /**
+     * Elimina una relazione per ID
+     */
+    deleteRelation(relationId: string): Promise<void>;
+    /**
+     * Recupera statistiche del grafo
+     */
+    getStats(): Promise<{
+        entityCount: number;
+        relationCount: number;
+    }>;
+    /**
+     * Pulisce completamente il grafo (elimina tutte le entità e relazioni)
+     */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=neo4j-knowledge-graph.d.ts.map

package/dist/neo4j-knowledge-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j-knowledge-graph.d.ts","sourceRoot":"","sources":["../src/neo4j-knowledge-graph.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,mBAAmB;IAC7D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,WAAW;IAQ/B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAU5C;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IA+BvC;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB9C;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BpD;;OAEG;IACG,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA6BxD;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA6BzD;;OAEG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA4BlF;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAyChF;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnD;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBvD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAoBzE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAU7B"}

package/dist/neo4j-knowledge-graph.js

@@ -0,0 +1,307 @@
+import neo4j from "neo4j-driver";
+/**
+ * Knowledge Graph persistente con Neo4j
+ *
+ * Implementa un grafo di conoscenza persistente usando Neo4j come database.
+ * Supporta operazioni CRUD per entità e relazioni, query per trovare entità connesse,
+ * e gestione delle transazioni.
+ */
+export class Neo4jKnowledgeGraph {
+    driver;
+    database;
+    constructor(config) {
+        this.driver = neo4j.driver(config.uri, neo4j.auth.basic(config.username, config.password));
+        this.database = config.database || "neo4j";
+    }
+    /**
+     * Chiude la connessione al database
+     */
+    async close() {
+        await this.driver.close();
+    }
+    /**
+     * Verifica la connessione al database
+     */
+    async verifyConnectivity() {
+        try {
+            await this.driver.verifyConnectivity();
+            return true;
+        }
+        catch (error) {
+            console.error("Neo4j connectivity check failed:", error);
+            return false;
+        }
+    }
+    /**
+     * Inizializza gli indici e i vincoli del database
+     */
+    async initializeSchema() {
+        const session = this.driver.session({ database: this.database });
+        try {
+            // Crea indice univoco per Entity.id
+            await session.executeWrite(async (tx) => {
+                await tx.run(`
+          CREATE INDEX entity_id_index IF NOT EXISTS
+          FOR (e:Entity) ON (e.id)
+        `);
+            });
+            // Crea indice per Entity.type
+            await session.executeWrite(async (tx) => {
+                await tx.run(`
+          CREATE INDEX entity_type_index IF NOT EXISTS
+          FOR (e:Entity) ON (e.type)
+        `);
+            });
+            // Crea indice per Relation.type
+            await session.executeWrite(async (tx) => {
+                await tx.run(`
+          CREATE INDEX relation_type_index IF NOT EXISTS
+          FOR ()-[r:RELATES_TO]-() ON (r.type)
+        `);
+            });
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Aggiunge un'entità al grafo
+     */
+    async addEntity(entity) {
+        const session = this.driver.session({ database: this.database });
+        try {
+            await session.executeWrite(async (tx) => {
+                await tx.run(`
+          MERGE (e:Entity {id: $id})
+          SET e.name = $name,
+              e.type = $type,
+              e.properties = $properties,
+              e.updatedAt = datetime()
+          `, {
+                    id: entity.id,
+                    name: entity.name,
+                    type: entity.type,
+                    properties: JSON.stringify(entity.properties || {}),
+                });
+            });
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Aggiunge una relazione al grafo
+     */
+    async addRelation(relation) {
+        const session = this.driver.session({ database: this.database });
+        try {
+            await session.executeWrite(async (tx) => {
+                await tx.run(`
+          MATCH (source:Entity {id: $sourceId})
+          MATCH (target:Entity {id: $targetId})
+          MERGE (source)-[r:RELATES_TO {id: $id}]->(target)
+          SET r.type = $type,
+              r.properties = $properties,
+              r.updatedAt = datetime()
+          `, {
+                    id: relation.id,
+                    sourceId: relation.source,
+                    targetId: relation.target,
+                    type: relation.type,
+                    properties: JSON.stringify(relation.properties || {}),
+                });
+            });
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Recupera un'entità per ID
+     */
+    async getEntity(id) {
+        const session = this.driver.session({ database: this.database });
+        try {
+            const result = await session.executeRead(async (tx) => {
+                return await tx.run(`
+          MATCH (e:Entity {id: $id})
+          RETURN e.id AS id, e.name AS name, e.type AS type, e.properties AS properties
+          `, { id });
+            });
+            if (result.records.length === 0) {
+                return undefined;
+            }
+            const record = result.records[0];
+            return {
+                id: record.get("id"),
+                name: record.get("name"),
+                type: record.get("type"),
+                properties: JSON.parse(record.get("properties") || "{}"),
+            };
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Recupera tutte le relazioni di un'entità
+     */
+    async getRelations(entityId) {
+        const session = this.driver.session({ database: this.database });
+        try {
+            const result = await session.executeRead(async (tx) => {
+                return await tx.run(`
+          MATCH (e:Entity {id: $entityId})-[r:RELATES_TO]-(other:Entity)
+          RETURN r.id AS id, 
+                 r.type AS type, 
+                 r.properties AS properties,
+                 startNode(r).id AS source,
+                 endNode(r).id AS target
+          `, { entityId });
+            });
+            return result.records.map((record) => ({
+                id: record.get("id"),
+                type: record.get("type"),
+                properties: JSON.parse(record.get("properties") || "{}"),
+                source: record.get("source"),
+                target: record.get("target"),
+            }));
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Recupera tutte le entità connesse a un'entità fino a una certa profondità
+     */
+    async getConnectedEntities(entityId, depth = 1) {
+        const session = this.driver.session({ database: this.database });
+        try {
+            const result = await session.executeRead(async (tx) => {
+                return await tx.run(`
+          MATCH path = (start:Entity {id: $entityId})-[:RELATES_TO*1..${depth}]-(connected:Entity)
+          WHERE connected.id <> $entityId
+          RETURN DISTINCT connected.id AS id, 
+                          connected.name AS name, 
+                          connected.type AS type, 
+                          connected.properties AS properties
+          `, { entityId });
+            });
+            return result.records.map((record) => ({
+                id: record.get("id"),
+                name: record.get("name"),
+                type: record.get("type"),
+                properties: JSON.parse(record.get("properties") || "{}"),
+            }));
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Cerca entità per nome o tipo
+     */
+    async searchEntities(query) {
+        const session = this.driver.session({ database: this.database });
+        try {
+            const conditions = [];
+            const params = {};
+            if (query.name) {
+                conditions.push("e.name CONTAINS $name");
+                params.name = query.name;
+            }
+            if (query.type) {
+                conditions.push("e.type = $type");
+                params.type = query.type;
+            }
+            const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+            const result = await session.executeRead(async (tx) => {
+                return await tx.run(`
+          MATCH (e:Entity)
+          ${whereClause}
+          RETURN e.id AS id, e.name AS name, e.type AS type, e.properties AS properties
+          LIMIT 100
+          `, params);
+            });
+            return result.records.map((record) => ({
+                id: record.get("id"),
+                name: record.get("name"),
+                type: record.get("type"),
+                properties: JSON.parse(record.get("properties") || "{}"),
+            }));
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Elimina un'entità e tutte le sue relazioni
+     */
+    async deleteEntity(entityId) {
+        const session = this.driver.session({ database: this.database });
+        try {
+            await session.executeWrite(async (tx) => {
+                await tx.run(`
+          MATCH (e:Entity {id: $entityId})
+          DETACH DELETE e
+          `, { entityId });
+            });
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Elimina una relazione per ID
+     */
+    async deleteRelation(relationId) {
+        const session = this.driver.session({ database: this.database });
+        try {
+            await session.executeWrite(async (tx) => {
+                await tx.run(`
+          MATCH ()-[r:RELATES_TO {id: $relationId}]-()
+          DELETE r
+          `, { relationId });
+            });
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Recupera statistiche del grafo
+     */
+    async getStats() {
+        const session = this.driver.session({ database: this.database });
+        try {
+            const entityResult = await session.executeRead(async (tx) => {
+                return await tx.run(`MATCH (e:Entity) RETURN count(e) AS count`);
+            });
+            const relationResult = await session.executeRead(async (tx) => {
+                return await tx.run(`MATCH ()-[r:RELATES_TO]-() RETURN count(r) AS count`);
+            });
+            return {
+                entityCount: entityResult.records[0].get("count").toNumber(),
+                relationCount: relationResult.records[0].get("count").toNumber(),
+            };
+        }
+        finally {
+            await session.close();
+        }
+    }
+    /**
+     * Pulisce completamente il grafo (elimina tutte le entità e relazioni)
+     */
+    async clear() {
+        const session = this.driver.session({ database: this.database });
+        try {
+            await session.executeWrite(async (tx) => {
+                await tx.run(`MATCH (n) DETACH DELETE n`);
+            });
+        }
+        finally {
+            await session.close();
+        }
+    }
+}
+//# sourceMappingURL=neo4j-knowledge-graph.js.map

package/dist/neo4j-knowledge-graph.js.map

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

package/dist/neo4j-knowledge-graph.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=neo4j-knowledge-graph.test.d.ts.map

package/dist/neo4j-knowledge-graph.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j-knowledge-graph.test.d.ts","sourceRoot":"","sources":["../src/neo4j-knowledge-graph.test.ts"],"names":[],"mappings":""}