flowquery 1.0.36 → 1.0.38

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowquery",
-  "version": "1.0.36",
+  "version": "1.0.38",
   "description": "A declarative query language for data processing pipelines.",
   "main": "dist/index.node.js",
   "types": "dist/index.node.d.ts",

package/src/parsing/functions/coalesce.ts

@@ -3,7 +3,6 @@ import { FunctionDef } from "./function_metadata";
 
 /**
  * Returns the first non-null value from a list of expressions.
- * Equivalent to Neo4j's coalesce() function.
  *
  * @example
  * ```

package/src/parsing/functions/date.ts

@@ -8,8 +8,6 @@ import { buildDateObject, parseTemporalArg } from "./temporal_utils";
  * When called with a string argument, parses it as an ISO 8601 date.
  * When called with a map argument, constructs a date from components.
  *
- * Equivalent to Neo4j's date() function.
- *
  * @example
  * ```
  * RETURN date() AS today

package/src/parsing/functions/datetime.ts

@@ -8,8 +8,6 @@ import { buildDatetimeObject, parseTemporalArg } from "./temporal_utils";
  * When called with a string argument, parses it as an ISO 8601 datetime.
  * When called with a map argument, constructs a datetime from components.
  *
- * Equivalent to Neo4j's datetime() function.
- *
  * @example
  * ```
  * RETURN datetime() AS now

package/src/parsing/functions/localdatetime.ts

@@ -8,8 +8,6 @@ import { buildDatetimeObject, parseTemporalArg } from "./temporal_utils";
  * When called with a string argument, parses it as an ISO 8601 datetime.
  * When called with a map argument, constructs a datetime from components.
  *
- * Equivalent to Neo4j's localdatetime() function.
- *
  * @example
  * ```
  * RETURN localdatetime() AS now

package/src/parsing/functions/localtime.ts

@@ -7,8 +7,6 @@ import { buildTimeObject, parseTemporalArg } from "./temporal_utils";
  * When called with no arguments, returns the current local time.
  * When called with a string argument, parses it.
  *
- * Equivalent to Neo4j's localtime() function.
- *
  * @example
  * ```
  * RETURN localtime() AS now

package/src/parsing/functions/temporal_utils.ts

@@ -6,7 +6,7 @@
  */
 
 /**
- * Computes the ISO day of the week (1 = Monday, 7 = Sunday) matching Neo4j convention.
+ * Computes the ISO day of the week (1 = Monday, 7 = Sunday).
  */
 function isoDayOfWeek(d: Date): number {
     const jsDay = d.getDay(); // 0 = Sunday, 6 = Saturday

package/src/parsing/functions/time.ts

@@ -7,8 +7,6 @@ import { buildTimeObject, parseTemporalArg } from "./temporal_utils";
  * When called with no arguments, returns the current UTC time.
  * When called with a string argument, parses it as an ISO 8601 time.
  *
- * Equivalent to Neo4j's time() function.
- *
  * @example
  * ```
  * RETURN time() AS now

package/src/parsing/functions/timestamp.ts

@@ -4,17 +4,13 @@ import { FunctionDef } from "./function_metadata";
 /**
  * Returns the number of milliseconds since the Unix epoch (1970-01-01T00:00:00Z).
  *
- * Equivalent to Neo4j's timestamp() function.
- *
  * @example
  * ```
  * RETURN timestamp() AS ts
  * ```
  */
 @FunctionDef({
-    description:
-        "Returns the number of milliseconds since the Unix epoch (1970-01-01T00:00:00Z). " +
-        "Equivalent to Neo4j's timestamp() function.",
+    description: "Returns the number of milliseconds since the Unix epoch (1970-01-01T00:00:00Z).",
     category: "scalar",
     parameters: [],
     output: {

package/src/parsing/operations/group_by.ts

@@ -52,10 +52,12 @@ class GroupBy extends Projection {
         let node: Node = this.current;
         for (const mapper of this.mappers) {
             const value: any = mapper.value();
-            let child: Node | undefined = node.children.get(value);
+            const key: string =
+                typeof value === "object" && value !== null ? JSON.stringify(value) : String(value);
+            let child: Node | undefined = node.children.get(key);
             if (child === undefined) {
                 child = new Node(value);
-                node.children.set(value, child);
+                node.children.set(key, child);
             }
             node = child;
         }

package/src/parsing/operations/limit.ts

@@ -7,6 +7,12 @@ class Limit extends Operation {
         super();
         this.limit = limit;
     }
+    public get isLimitReached(): boolean {
+        return this.count >= this.limit;
+    }
+    public increment(): void {
+        this.count++;
+    }
     public async run(): Promise<void> {
         if (this.count >= this.limit) {
             return;
@@ -19,4 +25,4 @@ class Limit extends Operation {
     }
 }
 
-export default Limit;
+export default Limit;

package/src/parsing/operations/return.ts

@@ -1,3 +1,4 @@
+import Limit from "./limit";
 import Projection from "./projection";
 import Where from "./where";
 
@@ -15,6 +16,7 @@ import Where from "./where";
 class Return extends Projection {
     protected _where: Where | null = null;
     protected _results: Record<string, any>[] = [];
+    private _limit: Limit | null = null;
     public set where(where: Where) {
         this._where = where;
     }
@@ -24,10 +26,16 @@ class Return extends Projection {
         }
         return this._where.value();
     }
+    public set limit(limit: Limit) {
+        this._limit = limit;
+    }
     public async run(): Promise<void> {
         if (!this.where) {
             return;
         }
+        if (this._limit !== null && this._limit.isLimitReached) {
+            return;
+        }
         const record: Map<string, any> = new Map();
         for (const [expression, alias] of this.expressions()) {
             const raw = expression.value();
@@ -35,6 +43,9 @@ class Return extends Projection {
             record.set(alias, value);
         }
         this._results.push(Object.fromEntries(record));
+        if (this._limit !== null) {
+            this._limit.increment();
+        }
     }
     public async initialize(): Promise<void> {
         this._results = [];

package/src/parsing/parser.ts

@@ -112,6 +112,9 @@ class Parser extends BaseParser {
             if (this.token.isUnion()) {
                 break;
             }
+            if (this.token.isEOF()) {
+                break;
+            }
             operation = this.parseOperation();
             if (operation === null && !isSubQuery) {
                 throw new Error("Expected one of WITH, UNWIND, RETURN, LOAD, OR CALL");
@@ -142,8 +145,12 @@ class Parser extends BaseParser {
             }
             const limit = this.parseLimit();
             if (limit !== null) {
-                operation!.addSibling(limit);
-                operation = limit;
+                if (operation instanceof Return) {
+                    (operation as Return).limit = limit;
+                } else {
+                    operation!.addSibling(limit);
+                    operation = limit;
+                }
             }
             previous = operation;
         }
@@ -494,16 +501,11 @@ class Parser extends BaseParser {
         node.label = label!;
         if (identifier !== null && this._state.variables.has(identifier)) {
             let reference = this._state.variables.get(identifier);
-            // Resolve through Expression -> Reference -> Node (e.g., after WITH)
-            if (reference instanceof Expression && reference.firstChild() instanceof Reference) {
-                const inner = (reference.firstChild() as Reference).referred;
-                if (inner instanceof Node) {
-                    reference = inner;
-                }
-            }
             if (
                 reference === undefined ||
-                (!(reference instanceof Node) && !(reference instanceof Unwind))
+                (!(reference instanceof Node) &&
+                    !(reference instanceof Unwind) &&
+                    !(reference instanceof Expression))
             ) {
                 throw new Error(`Undefined node reference: ${identifier}`);
             }

package/tests/compute/runner.test.ts

@@ -842,6 +842,19 @@ test("Test limit", async () => {
     expect(results.length).toBe(50);
 });
 
+test("Test limit as last operation", async () => {
+    const runner = new Runner(
+        `
+        unwind range(1, 10) as i
+        return i
+        limit 5
+        `
+    );
+    await runner.run();
+    const results = runner.results;
+    expect(results.length).toBe(5);
+});
+
 test("Test range lookup", async () => {
     const runner = new Runner(
         `
@@ -1327,6 +1340,60 @@ test("Test match with referenced to previous variable", async () => {
     expect(results[1]).toEqual({ name1: "Person 2", name2: "Person 3", name3: "Person 4" });
 });
 
+test("Test match with aggregated with and subsequent match", async () => {
+    await new Runner(`
+        CREATE VIRTUAL (:User) AS {
+            unwind [
+                {id: 1, name: 'Alice'},
+                {id: 2, name: 'Bob'},
+                {id: 3, name: 'Carol'}
+            ] as record
+            RETURN record.id as id, record.name as name
+        }
+    `).run();
+    await new Runner(`
+        CREATE VIRTUAL (:User)-[:KNOWS]-(:User) AS {
+            unwind [
+                {left_id: 1, right_id: 2},
+                {left_id: 1, right_id: 3}
+            ] as record
+            RETURN record.left_id as left_id, record.right_id as right_id
+        }
+    `).run();
+    await new Runner(`
+        CREATE VIRTUAL (:Project) AS {
+            unwind [
+                {id: 1, name: 'Project A'},
+                {id: 2, name: 'Project B'}
+            ] as record
+            RETURN record.id as id, record.name as name
+        }
+    `).run();
+    await new Runner(`
+        CREATE VIRTUAL (:User)-[:WORKS_ON]-(:Project) AS {
+            unwind [
+                {left_id: 1, right_id: 1},
+                {left_id: 1, right_id: 2}
+            ] as record
+            RETURN record.left_id as left_id, record.right_id as right_id
+        }
+    `).run();
+    const match = new Runner(`
+        MATCH (u:User)-[:KNOWS]->(s:User)
+        WITH u, count(s) as acquaintances
+        MATCH (u)-[:WORKS_ON]->(p:Project)
+        RETURN u.name as name, acquaintances, collect(p.name) as projects
+    `);
+    await match.run();
+    const results = match.results;
+    expect(results.length).toBe(1);
+    expect(results[0]).toEqual({
+        name: "Alice",
+        acquaintances: 2,
+        projects: ["Project A", "Project B"],
+    });
+});
+
 test("Test match and return full node", async () => {
     await new Runner(`
         CREATE VIRTUAL (:Person) AS {
@@ -2039,7 +2106,7 @@ test("Test optional match property access on null node returns null", async () =
             RETURN record.left_id as left_id, record.right_id as right_id
         }
     `).run();
-    // When accessing b.name and b is null (no match), should return null like Neo4j
+    // When accessing b.name and b is null (no match), should return null
     const match = new Runner(`
         MATCH (a:Person)
         OPTIONAL MATCH (a)-[:KNOWS]->(b:Person)
@@ -3246,7 +3313,7 @@ test("Test coalesce with property access", async () => {
 });
 
 // ============================================================
-// Temporal / Time Functions (Neo4j-style)
+// Temporal / Time Functions
 // ============================================================
 
 test("Test datetime() returns current datetime object", async () => {