readme

Author: IgorRozani

README.md

@@ -1,6 +1,6 @@
 # Cypher.ScriptGenerator
 
-A .NET library for generating [Cypher](https://neo4j.com/docs/cypher-manual/current/) scripts for Neo4j — supporting **CREATE**, **MERGE**, **DELETE**, **indexes**, and **constraints**.
+A .NET library for generating [Cypher](https://neo4j.com/docs/cypher-manual/current/) scripts for Neo4j — supporting **CREATE**, **MERGE**, **DELETE**, **UNWIND**, **indexes**, and **constraints**.
 
 ## Installation
 
@@ -25,6 +25,7 @@ services.AddSingleton<INodeGenerator, NodeGenerator>();
 services.AddSingleton<IRelationshipGenerator, RelationshipGenerator>();
 services.AddSingleton<IIndexGenerator, IndexGenerator>();
 services.AddSingleton<IConstraintGenerator, ConstraintGenerator>();
+services.AddSingleton<IUnwindGenerator, UnwindGenerator>();
 ```
 
 | Class                   | Interface               |
@@ -33,6 +34,7 @@ services.AddSingleton<IConstraintGenerator, ConstraintGenerator>();
 | `RelationshipGenerator` | `IRelationshipGenerator`|
 | `IndexGenerator`        | `IIndexGenerator`       |
 | `ConstraintGenerator`   | `IConstraintGenerator`  |
+| `UnwindGenerator`       | `IUnwindGenerator`      |
 
 ---
 
@@ -354,6 +356,83 @@ generator.Drop("person_name_unique");
 
 ---
 
+## UNWIND
+
+Use `UnwindGenerator` (or `IUnwindGenerator`) para operações em lote — itera sobre uma lista e aplica `MERGE` em cada elemento. Ideal para importações de dados.
+
+### UnwindDefinition model
+
+| Property    | Type     | Description                                                        |
+|-------------|----------|--------------------------------------------------------------------|
+| `Parameter` | `string` | Lista a iterar: parâmetro (`"$nodes"`) ou literal (`"[1, 2, 3]"`) |
+| `Alias`     | `string` | Nome da variável para cada elemento (`"row"`, `"item"`, `"node"`)  |
+
+### UNWIND + MERGE nodes
+
+```csharp
+var generator = new UnwindGenerator();
+
+// Merge simples com SET
+generator.MergeNodes(
+    new UnwindDefinition { Parameter = "$nodes", Alias = "row" },
+    label:         "Person",
+    matchProperty: "id",
+    setProperties: new List<string> { "name", "age" }
+);
+// → UNWIND $nodes AS row
+//   MERGE (n:Person {id: row.id})
+//   SET n.name = row.name, n.age = row.age
+
+// Com ON CREATE SET e ON MATCH SET
+generator.MergeNodes(
+    new UnwindDefinition { Parameter = "$nodes", Alias = "row" },
+    label:              "Person",
+    matchProperty:      "id",
+    setProperties:      new List<string> { "name" },
+    onCreateProperties: new List<string> { "createdAt" },
+    onMatchProperties:  new List<string> { "updatedAt" }
+);
+// → UNWIND $nodes AS row
+//   MERGE (n:Person {id: row.id})
+//   SET n.name = row.name
+//   ON CREATE SET n.createdAt = row.createdAt
+//   ON MATCH SET n.updatedAt = row.updatedAt
+```
+
+### UNWIND + MERGE relationships
+
+```csharp
+// Merge simples de relacionamentos
+generator.MergeRelationships(
+    new UnwindDefinition { Parameter = "$rows", Alias = "row" },
+    leftLabel:         "Person",  leftMatchProperty:  "id",
+    rightLabel:        "Company", rightMatchProperty: "id",
+    relationshipLabel: "WORKS_AT"
+);
+// → UNWIND $rows AS row
+//   MATCH (a:Person {id: row.id})
+//   MATCH (b:Company {id: row.id})
+//   MERGE (a)-[:WORKS_AT]->(b)
+
+// Com ON CREATE SET e ON MATCH SET
+generator.MergeRelationships(
+    new UnwindDefinition { Parameter = "$rows", Alias = "row" },
+    leftLabel:          "Person",  leftMatchProperty:  "id",
+    rightLabel:         "Company", rightMatchProperty: "id",
+    relationshipLabel:  "WORKS_AT",
+    onCreateProperties: new List<string> { "since" },
+    onMatchProperties:  new List<string> { "updatedAt" }
+);
+// → UNWIND $rows AS row
+//   MATCH (a:Person {id: row.id})
+//   MATCH (b:Company {id: row.id})
+//   MERGE (a)-[r:WORKS_AT]->(b)
+//   ON CREATE SET r.since = row.since
+//   ON MATCH SET r.updatedAt = row.updatedAt
+```
+
+---
+
 ## Supported property types
 
 The following C# types are supported as property values:
@@ -379,3 +458,4 @@ The project has full unit test coverage. See the test files for all scenarios:
 - [RelationshipGeneratorTest.cs](https://github.com/IgorRozani/Cypher.ScriptGenerator/blob/master/Cypher.ScriptGenerator.Test/Generators/RelationshipGeneratorTest.cs)
 - [IndexGeneratorTest.cs](https://github.com/IgorRozani/Cypher.ScriptGenerator/blob/master/Cypher.ScriptGenerator.Test/Generators/IndexGeneratorTest.cs)
 - [ConstraintGeneratorTest.cs](https://github.com/IgorRozani/Cypher.ScriptGenerator/blob/master/Cypher.ScriptGenerator.Test/Generators/ConstraintGeneratorTest.cs)
+- [UnwindGeneratorTest.cs](https://github.com/IgorRozani/Cypher.ScriptGenerator/blob/master/Cypher.ScriptGenerator.Test/Generators/UnwindGeneratorTest.cs)