flowquery 1.0.69 → 1.0.71

package/dist/parsing/ast_node.js

@@ -27,6 +27,23 @@ class ASTNode {
         child._parent = this;
         this.children.push(child);
     }
+    /**
+     * Replaces an existing child node with a new node in-place.  The
+     * new node takes the old node's position and parent reference.
+     *
+     * @param oldChild - The existing child to replace
+     * @param newChild - The replacement node
+     * @returns True if the replacement was performed, false otherwise
+     */
+    replaceChild(oldChild, newChild) {
+        const idx = this.children.indexOf(oldChild);
+        if (idx === -1) {
+            return false;
+        }
+        newChild._parent = this;
+        this.children[idx] = newChild;
+        return true;
+    }
     /**
      * Returns the first child node.
      *
@@ -35,7 +52,7 @@ class ASTNode {
      */
     firstChild() {
         if (this.children.length === 0) {
-            throw new Error('Expected child');
+            throw new Error("Expected child");
         }
         return this.children[0];
     }
@@ -47,7 +64,7 @@ class ASTNode {
      */
     lastChild() {
         if (this.children.length === 0) {
-            throw new Error('Expected child');
+            throw new Error("Expected child");
         }
         return this.children[this.children.length - 1];
     }
@@ -113,7 +130,7 @@ class ASTNode {
      * @returns A formatted string showing the tree structure
      */
     print() {
-        return Array.from(this._print(0)).join('\n');
+        return Array.from(this._print(0)).join("\n");
     }
     /**
      * Generator function for recursively printing the tree structure.
@@ -126,7 +143,7 @@ class ASTNode {
             yield this.constructor.name;
         }
         else if (indent > 0) {
-            yield '-'.repeat(indent) + ` ${this.toString()}`;
+            yield "-".repeat(indent) + ` ${this.toString()}`;
         }
         for (const child of this.children) {
             yield* child._print(indent + 1);

package/dist/parsing/ast_node.js.map

@@ -1 +1 @@
-{"version":3,"file":"ast_node.js","sourceRoot":"","sources":["../../src/parsing/ast_node.ts"],"names":[],"mappings":";;AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO;IAAb;QACc,YAAO,GAAmB,IAAI,CAAC;QAC/B,aAAQ,GAAc,EAAE,CAAC;IAuIvC,CAAC;IArIG;;;;OAIG;IACI,QAAQ,CAAC,KAAc;QAC1B,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACI,UAAU;QACb,IAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;OAKG;IACI,SAAS;QACZ,IAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAED;;;;OAIG;IACI,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACI,UAAU;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACI,KAAK;QACR,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACI,UAAU;QACb,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACI,SAAS;QACZ,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACH,IAAW,UAAU;QACjB,OAAO,CAAC,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,IAAW,eAAe;QACtB,OAAO,KAAK,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACI,KAAK;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IAED;;;;;OAKG;IACK,CAAC,MAAM,CAAC,MAAc;QAC1B,IAAG,MAAM,KAAK,CAAC,EAAE,CAAC;YACd,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAChC,CAAC;aAAM,IAAG,MAAM,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QACrD,CAAC;QACD,KAAI,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACpC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACO,QAAQ;QACd,OAAO,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACjC,CAAC;CACJ;AAED,kBAAe,OAAO,CAAC"}
+{"version":3,"file":"ast_node.js","sourceRoot":"","sources":["../../src/parsing/ast_node.ts"],"names":[],"mappings":"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"}

package/dist/parsing/expressions/binding_reference.d.ts

@@ -0,0 +1,16 @@
+import Identifier from "./identifier";
+/**
+ * Reference to a `LET`-bound binding by name.
+ *
+ * Distinct from {@link Reference} (which points to a scope-local
+ * variable in the parser state) — a `BindingReference` is resolved
+ * against the global {@link Bindings} singleton at execution time.
+ */
+declare class BindingReference extends Identifier {
+    constructor(value: string);
+    get name(): string;
+    toString(): string;
+    value(): any;
+}
+export default BindingReference;
+//# sourceMappingURL=binding_reference.d.ts.map

package/dist/parsing/expressions/binding_reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding_reference.d.ts","sourceRoot":"","sources":["../../../src/parsing/expressions/binding_reference.ts"],"names":[],"mappings":"AACA,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC;;;;;;GAMG;AACH,cAAM,gBAAiB,SAAQ,UAAU;gBACzB,KAAK,EAAE,MAAM;IAIzB,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,QAAQ,IAAI,MAAM;IAIlB,KAAK,IAAI,GAAG;CAOtB;AAED,eAAe,gBAAgB,CAAC"}

package/dist/parsing/expressions/binding_reference.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const bindings_1 = __importDefault(require("../../graph/bindings"));
+const identifier_1 = __importDefault(require("./identifier"));
+/**
+ * Reference to a `LET`-bound binding by name.
+ *
+ * Distinct from {@link Reference} (which points to a scope-local
+ * variable in the parser state) — a `BindingReference` is resolved
+ * against the global {@link Bindings} singleton at execution time.
+ */
+class BindingReference extends identifier_1.default {
+    constructor(value) {
+        super(value);
+    }
+    get name() {
+        return this._value;
+    }
+    toString() {
+        return `BindingReference (${this._value})`;
+    }
+    value() {
+        const bindings = bindings_1.default.getInstance();
+        if (!bindings.has(this._value)) {
+            throw new Error(`Binding '${this._value}' is not defined`);
+        }
+        return bindings.get(this._value);
+    }
+}
+exports.default = BindingReference;
+//# sourceMappingURL=binding_reference.js.map

package/dist/parsing/expressions/binding_reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding_reference.js","sourceRoot":"","sources":["../../../src/parsing/expressions/binding_reference.ts"],"names":[],"mappings":";;;;;AAAA,oEAA4C;AAC5C,8DAAsC;AAEtC;;;;;;GAMG;AACH,MAAM,gBAAiB,SAAQ,oBAAU;IACrC,YAAY,KAAa;QACrB,KAAK,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAED,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAEM,QAAQ;QACX,OAAO,qBAAqB,IAAI,CAAC,MAAM,GAAG,CAAC;IAC/C,CAAC;IAEM,KAAK;QACR,MAAM,QAAQ,GAAG,kBAAQ,CAAC,WAAW,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,MAAM,kBAAkB,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACJ;AAED,kBAAe,gBAAgB,CAAC"}

package/dist/parsing/operations/aggregated_return.d.ts

@@ -1,8 +1,18 @@
+import { ProvenanceSource } from "../../compute/provenance";
 import Return from "./return";
 declare class AggregatedReturn extends Return {
     private _group_by;
     run(): Promise<void>;
+    /**
+     * Provenance sources registered on an aggregate RETURN are folded
+     * into the active group's dedup maps rather than snapshotted per
+     * row, because each output row corresponds to a *group* of upstream
+     * matches.  Override to route through the embedded `GroupBy`.
+     */
+    addProvenanceSource(source: ProvenanceSource): void;
     get results(): Record<string, any>[];
+    finish(): Promise<void>;
+    private _buildAggregateOutput;
 }
 export default AggregatedReturn;
 //# sourceMappingURL=aggregated_return.d.ts.map

package/dist/parsing/operations/aggregated_return.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregated_return.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/aggregated_return.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,cAAM,gBAAiB,SAAQ,MAAM;IACjC,OAAO,CAAC,SAAS,CAAuD;IAC3D,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAGjC,IAAW,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAS1C;CACJ;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"aggregated_return.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/aggregated_return.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAiB,MAAM,0BAA0B,CAAC;AAI3E,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B,cAAM,gBAAiB,SAAQ,MAAM;IACjC,OAAO,CAAC,SAAS,CAAuD;IAC3D,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAGjC;;;;;OAKG;IACI,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAG1D,IAAW,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAG1C;IACY,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAWpC,OAAO,CAAC,qBAAqB;CAmChC;AAED,eAAe,gBAAgB,CAAC"}

package/dist/parsing/operations/aggregated_return.js

@@ -13,6 +13,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const group_by_1 = __importDefault(require("./group_by"));
+const operation_1 = __importDefault(require("./operation"));
 const return_1 = __importDefault(require("./return"));
 class AggregatedReturn extends return_1.default {
     constructor() {
@@ -24,15 +25,67 @@ class AggregatedReturn extends return_1.default {
             yield this._group_by.run();
         });
     }
+    /**
+     * Provenance sources registered on an aggregate RETURN are folded
+     * into the active group's dedup maps rather than snapshotted per
+     * row, because each output row corresponds to a *group* of upstream
+     * matches.  Override to route through the embedded `GroupBy`.
+     */
+    addProvenanceSource(source) {
+        this._group_by.addProvenanceSource(source);
+    }
     get results() {
+        const { results } = this._buildAggregateOutput();
+        return results;
+    }
+    finish() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._provenanceSink !== null) {
+                const { provenance } = this._buildAggregateOutput();
+                this._provenanceSink.length = 0;
+                for (const p of provenance)
+                    this._provenanceSink.push(p);
+            }
+            // Skip Return.finish() because it would re-materialise provenance
+            // from the empty per-row `_results` array; chain straight to the
+            // next operation instead.
+            yield operation_1.default.prototype.finish.call(this);
+        });
+    }
+    _buildAggregateOutput() {
         if (this._where !== null) {
             this._group_by.where = this._where;
         }
-        const results = Array.from(this._group_by.generate_results());
+        const results = [];
+        const provenance = [];
+        // Emit a provenance entry per result row whenever a sink is
+        // registered, even if no provenance sources were attached (e.g.
+        // `RETURN count(*)` over no MATCH).  This keeps
+        // `runner.provenance.length === runner.results.length`.
+        const wantProvenance = this._provenanceSink !== null;
+        if (wantProvenance) {
+            const recordIter = this._group_by.generate_results();
+            const provIter = this._group_by.generate_provenance();
+            while (true) {
+                const r = recordIter.next();
+                const p = provIter.next();
+                if (r.done || p.done)
+                    break;
+                results.push(r.value);
+                provenance.push(p.value);
+            }
+        }
+        else {
+            for (const r of this._group_by.generate_results())
+                results.push(r);
+        }
         if (this._orderBy !== null) {
-            return this._orderBy.sort(results);
+            const indices = this._orderBy.sortIndices(results);
+            const sorted = indices.map((i) => results[i]);
+            const sortedProv = wantProvenance ? indices.map((i) => provenance[i]) : provenance;
+            return { results: sorted, provenance: sortedProv };
         }
-        return results;
+        return { results, provenance };
     }
 }
 exports.default = AggregatedReturn;

package/dist/parsing/operations/aggregated_return.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregated_return.js","sourceRoot":"","sources":["../../../src/parsing/operations/aggregated_return.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AACA,0DAAiC;AACjC,sDAA8B;AAE9B,MAAM,gBAAiB,SAAQ,gBAAM;IAArC;;QACY,cAAS,GAAY,IAAI,kBAAO,CAAC,IAAI,CAAC,QAAwB,CAAC,CAAC;IAc5E,CAAC;IAbgB,GAAG;;YACZ,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QAC/B,CAAC;KAAA;IACD,IAAW,OAAO;QACd,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,SAAS,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QACvC,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC;CACJ;AAED,kBAAe,gBAAgB,CAAC"}
+{"version":3,"file":"aggregated_return.js","sourceRoot":"","sources":["../../../src/parsing/operations/aggregated_return.ts"],"names":[],"mappings":"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"}

package/dist/parsing/operations/aggregated_with.d.ts

@@ -1,7 +1,27 @@
+import { ProvenanceSource } from "../../compute/provenance";
 import With from "./return";
 declare class AggregatedWith extends With {
     private _group_by;
+    /**
+     * Iterator over the per-group provenance produced by `_group_by`.
+     * Advanced in lockstep with `generate_results()` inside `finish()` so
+     * that `_currentGroupProvenance` always reflects the group whose row
+     * the downstream pipeline is about to project.
+     */
+    private _currentGroupProvenance;
     run(): Promise<void>;
+    /**
+     * Forward upstream provenance sources into the embedded `GroupBy`
+     * so each group accumulates the union of contributing bindings.
+     */
+    addProvenanceSource(source: ProvenanceSource): void;
+    /**
+     * Expose this aggregation as a downstream provenance source.  When
+     * the downstream pipeline projects a row, it snapshots us and
+     * receives the pre-computed provenance for the group currently being
+     * flushed by `finish()`.
+     */
+    asProvenanceSource(): ProvenanceSource;
     finish(): Promise<void>;
 }
 export default AggregatedWith;

package/dist/parsing/operations/aggregated_with.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregated_with.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/aggregated_with.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,UAAU,CAAC;AAI5B,cAAM,cAAe,SAAQ,IAAI;IAC7B,OAAO,CAAC,SAAS,CAAuD;IAC3D,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAGpB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAMvC;AAED,eAAe,cAAc,CAAC"}
+{"version":3,"file":"aggregated_with.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/aggregated_with.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAiB,MAAM,0BAA0B,CAAC;AAG3E,OAAO,IAAI,MAAM,UAAU,CAAC;AAE5B,cAAM,cAAe,SAAQ,IAAI;IAC7B,OAAO,CAAC,SAAS,CAAuD;IACxE;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB,CAA8B;IAChD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAGjC;;;OAGG;IACI,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAG1D;;;;;OAKG;IACI,kBAAkB,IAAI,gBAAgB;IAMhC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAavC;AAED,eAAe,cAAc,CAAC"}

package/dist/parsing/operations/aggregated_with.js

@@ -12,27 +12,59 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-const return_1 = __importDefault(require("./return"));
 const group_by_1 = __importDefault(require("./group_by"));
+const return_1 = __importDefault(require("./return"));
 class AggregatedWith extends return_1.default {
     constructor() {
         super(...arguments);
         this._group_by = new group_by_1.default(this.children);
+        /**
+         * Iterator over the per-group provenance produced by `_group_by`.
+         * Advanced in lockstep with `generate_results()` inside `finish()` so
+         * that `_currentGroupProvenance` always reflects the group whose row
+         * the downstream pipeline is about to project.
+         */
+        this._currentGroupProvenance = null;
     }
     run() {
         return __awaiter(this, void 0, void 0, function* () {
             yield this._group_by.run();
         });
     }
+    /**
+     * Forward upstream provenance sources into the embedded `GroupBy`
+     * so each group accumulates the union of contributing bindings.
+     */
+    addProvenanceSource(source) {
+        this._group_by.addProvenanceSource(source);
+    }
+    /**
+     * Expose this aggregation as a downstream provenance source.  When
+     * the downstream pipeline projects a row, it snapshots us and
+     * receives the pre-computed provenance for the group currently being
+     * flushed by `finish()`.
+     */
+    asProvenanceSource() {
+        return {
+            snapshot: () => { var _a; return (_a = this._currentGroupProvenance) !== null && _a !== void 0 ? _a : { nodes: [], relationships: [], rows: [] }; },
+        };
+    }
     finish() {
         const _super = Object.create(null, {
             finish: { get: () => super.finish }
         });
         return __awaiter(this, void 0, void 0, function* () {
             var _a;
+            const wantProvenance = this._group_by.provenanceEnabled;
+            const provIter = wantProvenance ? this._group_by.generate_provenance() : null;
             for (const _ of this._group_by.generate_results()) {
+                if (provIter !== null) {
+                    const next = provIter.next();
+                    this._currentGroupProvenance = next.done ? null : next.value;
+                }
                 yield ((_a = this.next) === null || _a === void 0 ? void 0 : _a.run());
             }
+            this._currentGroupProvenance = null;
             yield _super.finish.call(this);
         });
     }

package/dist/parsing/operations/aggregated_with.js.map

@@ -1 +1 @@
-{"version":3,"file":"aggregated_with.js","sourceRoot":"","sources":["../../../src/parsing/operations/aggregated_with.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,sDAA4B;AAC5B,0DAAiC;AAGjC,MAAM,cAAe,SAAQ,gBAAI;IAAjC;;QACY,cAAS,GAAY,IAAI,kBAAO,CAAC,IAAI,CAAC,QAAwB,CAAC,CAAC;IAU5E,CAAC;IATgB,GAAG;;YACZ,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QAC/B,CAAC;KAAA;IACY,MAAM;;;;;;YACf,KAAI,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,EAAE,CAAC;gBAC/C,MAAM,CAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,GAAG,EAAE,CAAA,CAAC;YAC3B,CAAC;YACD,MAAM,OAAM,MAAM,WAAE,CAAC;QACzB,CAAC;KAAA;CACJ;AAED,kBAAe,cAAc,CAAC"}
+{"version":3,"file":"aggregated_with.js","sourceRoot":"","sources":["../../../src/parsing/operations/aggregated_with.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAEA,0DAAiC;AACjC,sDAA4B;AAE5B,MAAM,cAAe,SAAQ,gBAAI;IAAjC;;QACY,cAAS,GAAY,IAAI,kBAAO,CAAC,IAAI,CAAC,QAAwB,CAAC,CAAC;QACxE;;;;;WAKG;QACK,4BAAuB,GAAyB,IAAI,CAAC;IAoCjE,CAAC;IAnCgB,GAAG;;YACZ,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;QAC/B,CAAC;KAAA;IACD;;;OAGG;IACI,mBAAmB,CAAC,MAAwB;QAC/C,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IACD;;;;;OAKG;IACI,kBAAkB;QACrB,OAAO;YACH,QAAQ,EAAE,GAAkB,EAAE,WAC1B,OAAA,MAAA,IAAI,CAAC,uBAAuB,mCAAI,EAAE,KAAK,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAA,EAAA;SACjF,CAAC;IACN,CAAC;IACY,MAAM;;;;;;YACf,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;YACxD,MAAM,QAAQ,GAAG,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YAC9E,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE,EAAE,CAAC;gBAChD,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;oBACpB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;oBAC7B,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;gBACjE,CAAC;gBACD,MAAM,CAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,GAAG,EAAE,CAAA,CAAC;YAC3B,CAAC;YACD,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;YACpC,MAAM,OAAM,MAAM,WAAE,CAAC;QACzB,CAAC;KAAA;CACJ;AAED,kBAAe,cAAc,CAAC"}

package/dist/parsing/operations/create_node.d.ts

@@ -4,9 +4,13 @@ import Operation from "./operation";
 declare class CreateNode extends Operation {
     private _node;
     private _statement;
-    constructor(node: Node, statement: ASTNode);
+    private _isStatic;
+    private _refreshEveryMs;
+    constructor(node: Node, statement: ASTNode, isStatic?: boolean, refreshEveryMs?: number | null);
     get node(): Node | null;
     get statement(): ASTNode | null;
+    get isStatic(): boolean;
+    get refreshEveryMs(): number | null;
     run(): Promise<void>;
     get results(): Record<string, any>[];
 }

package/dist/parsing/operations/create_node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create_node.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/create_node.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,kBAAkB,CAAC;AACpC,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,cAAM,UAAW,SAAQ,SAAS;IAC9B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,UAAU,CAAwB;gBAC9B,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO;IAK1C,IAAW,IAAI,IAAI,IAAI,GAAG,IAAI,CAE7B;IACD,IAAW,SAAS,IAAI,OAAO,GAAG,IAAI,CAErC;IACM,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,IAAW,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAE1C;CACJ;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"create_node.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/create_node.ts"],"names":[],"mappings":"AACA,OAAO,IAAI,MAAM,kBAAkB,CAAC;AACpC,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,cAAM,UAAW,SAAQ,SAAS;IAC9B,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAuB;gBAE1C,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE,OAAe,EACzB,cAAc,GAAE,MAAM,GAAG,IAAW;IAQxC,IAAW,IAAI,IAAI,IAAI,GAAG,IAAI,CAE7B;IACD,IAAW,SAAS,IAAI,OAAO,GAAG,IAAI,CAErC;IACD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IACD,IAAW,cAAc,IAAI,MAAM,GAAG,IAAI,CAEzC;IACM,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,IAAW,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAE1C;CACJ;AAED,eAAe,UAAU,CAAC"}

package/dist/parsing/operations/create_node.js

@@ -15,12 +15,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const database_1 = __importDefault(require("../../graph/database"));
 const operation_1 = __importDefault(require("./operation"));
 class CreateNode extends operation_1.default {
-    constructor(node, statement) {
+    constructor(node, statement, isStatic = false, refreshEveryMs = null) {
         super();
         this._node = null;
         this._statement = null;
+        this._isStatic = false;
+        this._refreshEveryMs = null;
         this._node = node;
         this._statement = statement;
+        this._isStatic = isStatic;
+        this._refreshEveryMs = refreshEveryMs;
     }
     get node() {
         return this._node;
@@ -28,6 +32,12 @@ class CreateNode extends operation_1.default {
     get statement() {
         return this._statement;
     }
+    get isStatic() {
+        return this._isStatic;
+    }
+    get refreshEveryMs() {
+        return this._refreshEveryMs;
+    }
     run() {
         return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
             try {
@@ -35,7 +45,7 @@ class CreateNode extends operation_1.default {
                     throw new Error("Node is null");
                 }
                 const db = database_1.default.getInstance();
-                db.addNode(this._node, this._statement);
+                db.addNode(this._node, this._statement, this._isStatic, this._refreshEveryMs);
                 resolve();
             }
             catch (error) {

package/dist/parsing/operations/create_node.js.map

@@ -1 +1 @@
-{"version":3,"file":"create_node.js","sourceRoot":"","sources":["../../../src/parsing/operations/create_node.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,oEAA4C;AAG5C,4DAAoC;AAEpC,MAAM,UAAW,SAAQ,mBAAS;IAG9B,YAAY,IAAU,EAAE,SAAkB;QACtC,KAAK,EAAE,CAAC;QAHJ,UAAK,GAAgB,IAAI,CAAC;QAC1B,eAAU,GAAmB,IAAI,CAAC;QAGtC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IACD,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACM,GAAG;QACN,OAAO,IAAI,OAAO,CAAC,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,IAAI,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;gBACpC,CAAC;gBACD,MAAM,EAAE,GAAa,kBAAQ,CAAC,WAAW,EAAE,CAAC;gBAC5C,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAW,CAAC,CAAC;gBACzC,OAAO,EAAE,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;IACP,CAAC;IACD,IAAW,OAAO;QACd,OAAO,EAAE,CAAC;IACd,CAAC;CACJ;AAED,kBAAe,UAAU,CAAC"}
+{"version":3,"file":"create_node.js","sourceRoot":"","sources":["../../../src/parsing/operations/create_node.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,oEAA4C;AAG5C,4DAAoC;AAEpC,MAAM,UAAW,SAAQ,mBAAS;IAK9B,YACI,IAAU,EACV,SAAkB,EAClB,WAAoB,KAAK,EACzB,iBAAgC,IAAI;QAEpC,KAAK,EAAE,CAAC;QAVJ,UAAK,GAAgB,IAAI,CAAC;QAC1B,eAAU,GAAmB,IAAI,CAAC;QAClC,cAAS,GAAY,KAAK,CAAC;QAC3B,oBAAe,GAAkB,IAAI,CAAC;QAQ1C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;IAC1C,CAAC;IACD,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IACD,IAAW,cAAc;QACrB,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IACM,GAAG;QACN,OAAO,IAAI,OAAO,CAAC,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,IAAI,CAAC;gBACD,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;oBACtB,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;gBACpC,CAAC;gBACD,MAAM,EAAE,GAAa,kBAAQ,CAAC,WAAW,EAAE,CAAC;gBAC5C,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAW,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;gBAC/E,OAAO,EAAE,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;IACP,CAAC;IACD,IAAW,OAAO;QACd,OAAO,EAAE,CAAC;IACd,CAAC;CACJ;AAED,kBAAe,UAAU,CAAC"}

package/dist/parsing/operations/create_relationship.d.ts

@@ -4,9 +4,13 @@ import Operation from "./operation";
 declare class CreateRelationship extends Operation {
     private _relationship;
     private _statement;
-    constructor(relationship: Relationship, statement: ASTNode);
+    private _isStatic;
+    private _refreshEveryMs;
+    constructor(relationship: Relationship, statement: ASTNode, isStatic?: boolean, refreshEveryMs?: number | null);
     get relationship(): Relationship | null;
     get statement(): ASTNode | null;
+    get isStatic(): boolean;
+    get refreshEveryMs(): number | null;
     run(): Promise<void>;
     get results(): Record<string, any>[];
 }

package/dist/parsing/operations/create_relationship.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create_relationship.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/create_relationship.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,0BAA0B,CAAC;AACpD,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,cAAM,kBAAmB,SAAQ,SAAS;IACtC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAAwB;gBAC9B,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO;IAK1D,IAAW,YAAY,IAAI,YAAY,GAAG,IAAI,CAE7C;IACD,IAAW,SAAS,IAAI,OAAO,GAAG,IAAI,CAErC;IACM,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAc3B,IAAW,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAE1C;CACJ;AACD,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"create_relationship.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/create_relationship.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,0BAA0B,CAAC;AACpD,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC,cAAM,kBAAmB,SAAQ,SAAS;IACtC,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAuB;gBAE1C,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE,OAAe,EACzB,cAAc,GAAE,MAAM,GAAG,IAAW;IAQxC,IAAW,YAAY,IAAI,YAAY,GAAG,IAAI,CAE7C;IACD,IAAW,SAAS,IAAI,OAAO,GAAG,IAAI,CAErC;IACD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IACD,IAAW,cAAc,IAAI,MAAM,GAAG,IAAI,CAEzC;IACM,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB3B,IAAW,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAE1C;CACJ;AACD,eAAe,kBAAkB,CAAC"}

package/dist/parsing/operations/create_relationship.js

@@ -15,12 +15,16 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const database_1 = __importDefault(require("../../graph/database"));
 const operation_1 = __importDefault(require("./operation"));
 class CreateRelationship extends operation_1.default {
-    constructor(relationship, statement) {
+    constructor(relationship, statement, isStatic = false, refreshEveryMs = null) {
         super();
         this._relationship = null;
         this._statement = null;
+        this._isStatic = false;
+        this._refreshEveryMs = null;
         this._relationship = relationship;
         this._statement = statement;
+        this._isStatic = isStatic;
+        this._refreshEveryMs = refreshEveryMs;
     }
     get relationship() {
         return this._relationship;
@@ -28,6 +32,12 @@ class CreateRelationship extends operation_1.default {
     get statement() {
         return this._statement;
     }
+    get isStatic() {
+        return this._isStatic;
+    }
+    get refreshEveryMs() {
+        return this._refreshEveryMs;
+    }
     run() {
         return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
             try {
@@ -35,7 +45,7 @@ class CreateRelationship extends operation_1.default {
                     throw new Error("Relationship is null");
                 }
                 const db = database_1.default.getInstance();
-                db.addRelationship(this._relationship, this._statement);
+                db.addRelationship(this._relationship, this._statement, this._isStatic, this._refreshEveryMs);
                 resolve();
             }
             catch (error) {

package/dist/parsing/operations/create_relationship.js.map

@@ -1 +1 @@
-{"version":3,"file":"create_relationship.js","sourceRoot":"","sources":["../../../src/parsing/operations/create_relationship.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,oEAA4C;AAG5C,4DAAoC;AAEpC,MAAM,kBAAmB,SAAQ,mBAAS;IAGtC,YAAY,YAA0B,EAAE,SAAkB;QACtD,KAAK,EAAE,CAAC;QAHJ,kBAAa,GAAwB,IAAI,CAAC;QAC1C,eAAU,GAAmB,IAAI,CAAC;QAGtC,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IACD,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IACD,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACM,GAAG;QACN,OAAO,IAAI,OAAO,CAAC,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,IAAI,CAAC;gBACD,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;gBAC5C,CAAC;gBACD,MAAM,EAAE,GAAG,kBAAQ,CAAC,WAAW,EAAE,CAAC;gBAClC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,UAAW,CAAC,CAAC;gBACzD,OAAO,EAAE,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;IACP,CAAC;IACD,IAAW,OAAO;QACd,OAAO,EAAE,CAAC;IACd,CAAC;CACJ;AACD,kBAAe,kBAAkB,CAAC"}
+{"version":3,"file":"create_relationship.js","sourceRoot":"","sources":["../../../src/parsing/operations/create_relationship.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,oEAA4C;AAG5C,4DAAoC;AAEpC,MAAM,kBAAmB,SAAQ,mBAAS;IAKtC,YACI,YAA0B,EAC1B,SAAkB,EAClB,WAAoB,KAAK,EACzB,iBAAgC,IAAI;QAEpC,KAAK,EAAE,CAAC;QAVJ,kBAAa,GAAwB,IAAI,CAAC;QAC1C,eAAU,GAAmB,IAAI,CAAC;QAClC,cAAS,GAAY,KAAK,CAAC;QAC3B,oBAAe,GAAkB,IAAI,CAAC;QAQ1C,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;IAC1C,CAAC;IACD,IAAW,YAAY;QACnB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;IACD,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IACD,IAAW,cAAc;QACrB,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IACM,GAAG;QACN,OAAO,IAAI,OAAO,CAAC,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;YACzC,IAAI,CAAC;gBACD,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;oBAC9B,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;gBAC5C,CAAC;gBACD,MAAM,EAAE,GAAG,kBAAQ,CAAC,WAAW,EAAE,CAAC;gBAClC,EAAE,CAAC,eAAe,CACd,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,UAAW,EAChB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,eAAe,CACvB,CAAC;gBACF,OAAO,EAAE,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,MAAM,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC;QACL,CAAC,CAAA,CAAC,CAAC;IACP,CAAC;IACD,IAAW,OAAO;QACd,OAAO,EAAE,CAAC;IACd,CAAC;CACJ;AACD,kBAAe,kBAAkB,CAAC"}

package/dist/parsing/operations/drop_binding.d.ts

@@ -0,0 +1,15 @@
+import Operation from "./operation";
+/**
+ * `DROP BINDING name`: remove a `LET`-bound entry (plain or
+ * refreshable) from the {@link Bindings} singleton.  No-op if the
+ * binding does not exist.
+ */
+declare class DropBinding extends Operation {
+    private _name;
+    constructor(name: string);
+    get name(): string;
+    run(): Promise<void>;
+    get results(): Record<string, any>[];
+}
+export default DropBinding;
+//# sourceMappingURL=drop_binding.d.ts.map

package/dist/parsing/operations/drop_binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop_binding.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/drop_binding.ts"],"names":[],"mappings":"AACA,OAAO,SAAS,MAAM,aAAa,CAAC;AAEpC;;;;GAIG;AACH,cAAM,WAAY,SAAQ,SAAS;IAC/B,OAAO,CAAC,KAAK,CAAS;gBAEV,IAAI,EAAE,MAAM;IAKxB,IAAW,IAAI,IAAI,MAAM,CAExB;IAEY,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,IAAW,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAE1C;CACJ;AAED,eAAe,WAAW,CAAC"}

package/dist/parsing/operations/drop_binding.js

@@ -0,0 +1,42 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const bindings_1 = __importDefault(require("../../graph/bindings"));
+const operation_1 = __importDefault(require("./operation"));
+/**
+ * `DROP BINDING name`: remove a `LET`-bound entry (plain or
+ * refreshable) from the {@link Bindings} singleton.  No-op if the
+ * binding does not exist.
+ */
+class DropBinding extends operation_1.default {
+    constructor(name) {
+        super();
+        this._name = name;
+    }
+    get name() {
+        return this._name;
+    }
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            bindings_1.default.getInstance().delete(this._name);
+            yield ((_a = this.next) === null || _a === void 0 ? void 0 : _a.run());
+        });
+    }
+    get results() {
+        return [];
+    }
+}
+exports.default = DropBinding;
+//# sourceMappingURL=drop_binding.js.map

package/dist/parsing/operations/drop_binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop_binding.js","sourceRoot":"","sources":["../../../src/parsing/operations/drop_binding.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,oEAA4C;AAC5C,4DAAoC;AAEpC;;;;GAIG;AACH,MAAM,WAAY,SAAQ,mBAAS;IAG/B,YAAY,IAAY;QACpB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAEY,GAAG;;;YACZ,kBAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,CAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,GAAG,EAAE,CAAA,CAAC;QAC3B,CAAC;KAAA;IAED,IAAW,OAAO;QACd,OAAO,EAAE,CAAC;IACd,CAAC;CACJ;AAED,kBAAe,WAAW,CAAC"}

package/dist/parsing/operations/group_by.d.ts

@@ -1,3 +1,4 @@
+import { NodeBinding, ProvenanceSource, RelationshipBinding, RowProvenance, RowSegment } from "../../compute/provenance";
 import AggregationElement from "../functions/reducer_element";
 import Projection from "./projection";
 import Where from "./where";
@@ -5,11 +6,25 @@ declare class Node {
     private _value;
     private _children;
     private _elements;
+    private _provenanceNodes;
+    private _provenanceRels;
+    private _provenanceRows;
     constructor(value?: any);
     get value(): any;
     get children(): Map<string, Node>;
     get elements(): AggregationElement[] | null;
     set elements(elements: AggregationElement[]);
+    /** Per-group dedup map for contributing node bindings (lazy). */
+    get provenanceNodes(): Map<string, NodeBinding>;
+    /** Per-group dedup map for contributing relationship bindings (lazy). */
+    get provenanceRelationships(): Map<string, RelationshipBinding>;
+    /**
+     * Per-input-row contribution segments in arrival order.  One entry is
+     * appended per `GroupBy.run()` call that lands in this group, so an
+     * aggregate row's `provenance.rows` aligns positionally with
+     * `collect(...)` outputs from the same group.
+     */
+    get provenanceRows(): RowSegment[];
 }
 declare class GroupBy extends Projection {
     private _root;
@@ -17,7 +32,17 @@ declare class GroupBy extends Projection {
     private _mappers;
     private _reducers;
     protected _where: Where | null;
+    private _provenanceSources;
     run(): Promise<void>;
+    /**
+     * Register a provenance source whose snapshot is folded into the
+     * currently active group on every `run()`.  May be called multiple
+     * times to compose contributions from several upstream MATCHes or
+     * upstream aggregation boundaries.
+     */
+    addProvenanceSource(source: ProvenanceSource): void;
+    get provenanceEnabled(): boolean;
+    private recordProvenance;
     private get root();
     private get current();
     private set current(value);
@@ -28,6 +53,13 @@ declare class GroupBy extends Projection {
     private _generate_mappers;
     private get reducers();
     generate_results(mapperIndex?: number, node?: Node): Generator<Record<string, any>>;
+    /**
+     * Walks the group tree in the same traversal order as
+     * {@link generate_results}, yielding the materialised {@link
+     * RowProvenance} for each emitted group.  When provenance is
+     * disabled, yields empty entries so callers can still zip cleanly.
+     */
+    generate_provenance(mapperIndex?: number, node?: Node): Generator<RowProvenance>;
     set where(where: Where);
     get where(): boolean;
 }

package/dist/parsing/operations/group_by.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"group_by.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/group_by.ts"],"names":[],"mappings":"AAEA,OAAO,kBAAkB,MAAM,8BAA8B,CAAC;AAC9D,OAAO,UAAU,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,cAAM,IAAI;IACN,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,SAAS,CAAqC;gBAC1C,KAAK,GAAE,GAAU;IAG7B,IAAW,KAAK,IAAI,GAAG,CAEtB;IACD,IAAW,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAEvC;IACD,IAAW,QAAQ,IAAI,kBAAkB,EAAE,GAAG,IAAI,CAEjD;IACD,IAAW,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,EAEjD;CACJ;AAED,cAAM,OAAQ,SAAQ,UAAU;IAC5B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,SAAS,CAAoC;IACrD,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,CAAQ;IACzB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC,OAAO,KAAK,IAAI,GAEf;IACD,OAAO,KAAK,OAAO,GAElB;IACD,OAAO,KAAK,OAAO,QAElB;IACD,OAAO,CAAC,SAAS;IAGjB,OAAO,CAAC,GAAG;IAeX,OAAO,CAAC,MAAM;IASd,OAAO,KAAK,OAAO,GAKlB;IACD,OAAO,CAAE,iBAAiB;IAO1B,OAAO,KAAK,QAAQ,GASnB;IACO,gBAAgB,CACpB,WAAW,GAAE,MAAU,EACvB,IAAI,GAAE,IAAgB,GACvB,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAyBjC,IAAW,KAAK,CAAC,KAAK,EAAE,KAAK,EAE5B;IACD,IAAW,KAAK,IAAI,OAAO,CAK1B;CACJ;AAED,eAAe,OAAO,CAAC"}
+{"version":3,"file":"group_by.d.ts","sourceRoot":"","sources":["../../../src/parsing/operations/group_by.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,WAAW,EACX,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACb,UAAU,EAGb,MAAM,0BAA0B,CAAC;AAGlC,OAAO,kBAAkB,MAAM,8BAA8B,CAAC;AAC9D,OAAO,UAAU,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,SAAS,CAAC;AAE5B,cAAM,IAAI;IACN,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,SAAS,CAAgC;IACjD,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,gBAAgB,CAAyC;IACjE,OAAO,CAAC,eAAe,CAAiD;IACxE,OAAO,CAAC,eAAe,CAA6B;gBACxC,KAAK,GAAE,GAAU;IAG7B,IAAW,KAAK,IAAI,GAAG,CAEtB;IACD,IAAW,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAEvC;IACD,IAAW,QAAQ,IAAI,kBAAkB,EAAE,GAAG,IAAI,CAEjD;IACD,IAAW,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,EAEjD;IACD,iEAAiE;IACjE,IAAW,eAAe,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAKrD;IACD,yEAAyE;IACzE,IAAW,uBAAuB,IAAI,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAKrE;IACD;;;;;OAKG;IACH,IAAW,cAAc,IAAI,UAAU,EAAE,CAKxC;CACJ;AAED,cAAM,OAAQ,SAAQ,UAAU;IAC5B,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,QAAQ,CAA6B;IAC7C,OAAO,CAAC,SAAS,CAAoC;IACrD,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,CAAQ;IACtC,OAAO,CAAC,kBAAkB,CAAmC;IAChD,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;;;OAKG;IACI,mBAAmB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAM1D,IAAW,iBAAiB,IAAI,OAAO,CAEtC;IACD,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,KAAK,IAAI,GAEf;IACD,OAAO,KAAK,OAAO,GAElB;IACD,OAAO,KAAK,OAAO,QAElB;IACD,OAAO,CAAC,SAAS;IAGjB,OAAO,CAAC,GAAG;IAeX,OAAO,CAAC,MAAM;IASd,OAAO,KAAK,OAAO,GAKlB;IACD,OAAO,CAAE,iBAAiB;IAO1B,OAAO,KAAK,QAAQ,GASnB;IACO,gBAAgB,CACpB,WAAW,GAAE,MAAU,EACvB,IAAI,GAAE,IAAgB,GACvB,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAyBjC;;;;;OAKG;IACK,mBAAmB,CACvB,WAAW,GAAE,MAAU,EACvB,IAAI,GAAE,IAAgB,GACvB,SAAS,CAAC,aAAa,CAAC;IAwB3B,IAAW,KAAK,CAAC,KAAK,EAAE,KAAK,EAE5B;IACD,IAAW,KAAK,IAAI,OAAO,CAK1B;CACJ;AAED,eAAe,OAAO,CAAC"}