flowquery 1.0.68 → 1.0.70

package/dist/graph/bindings.d.ts

@@ -0,0 +1,78 @@
+import type ASTNode from "../parsing/ast_node";
+/**
+ * One entry in the {@link Bindings} singleton.  Plain bindings store
+ * their materialised `value` directly; refreshable bindings (created
+ * by `LET name = { ... } REFRESH EVERY n unit`) additionally store
+ * the backing `statement` and TTL so the value can be re-evaluated on
+ * read once stale.
+ */
+declare class BindingEntry {
+    value: any;
+    statement: ASTNode | null;
+    isRefreshable: boolean;
+    refreshEveryMs: number | null;
+    cachedAt: number;
+    primed: boolean;
+}
+/**
+ * Singleton store for `LET`-bound values.
+ *
+ * Bindings live alongside virtual node/relationship definitions in
+ * {@link Database}: they are persistent across `Runner` invocations
+ * for the lifetime of the process.
+ *
+ * A binding's value may be any JSON-serialisable value: a primitive, an
+ * array, or a map.  Bindings are referenced by name inside virtual
+ * definitions and inside `LOAD JSON FROM <name>` expressions; the
+ * `UPDATE` statement replaces an existing binding wholesale, while
+ * `MERGE INTO ... USING ...` upserts per row.
+ *
+ * `LET name = { ... } REFRESH EVERY n unit` registers a refreshable
+ * binding: the sub-query is evaluated eagerly and the result is
+ * cached, but the TTL causes the next read after expiry to re-execute
+ * the sub-query.  Refreshable bindings cannot be silently overwritten
+ * by another `LET`, `UPDATE`, or `MERGE`; callers must `DROP BINDING`
+ * first.
+ */
+declare class Bindings {
+    private static instance;
+    private _entries;
+    private _materializing;
+    static getInstance(): Bindings;
+    /**
+     * Eager set, used by plain `LET`, `UPDATE`, and `MERGE INTO`.
+     * Throws if the name is currently bound to a refreshable binding;
+     * the caller must `DROP BINDING` first.
+     */
+    set(name: string, value: any): void;
+    get(name: string): any;
+    has(name: string): boolean;
+    delete(name: string): void;
+    /** Replace all entries (test/teardown helper). */
+    clear(): void;
+    /** Inspect the underlying entry without materialising it. */
+    getEntry(name: string): BindingEntry | undefined;
+    isRefreshable(name: string): boolean;
+    /**
+     * Register a refreshable binding with an eagerly evaluated value
+     * and a backing sub-query that is re-executed when the TTL has
+     * elapsed.  Throws if a binding with the same name already exists;
+     * callers must `DROP BINDING` first.
+     */
+    registerRefreshable(name: string, value: any, statement: ASTNode, refreshEveryMs: number): void;
+    /**
+     * Clear the cached value of a refreshable binding so the next
+     * {@link materialize} call re-executes the backing sub-query.
+     * No-op for plain bindings.
+     */
+    invalidate(name: string): void;
+    /**
+     * Re-evaluate a refreshable binding's backing sub-query if the
+     * cached value is stale (TTL elapsed or invalidated).  No-op for
+     * plain bindings or for refreshable bindings that are still fresh.
+     */
+    materialize(name: string): Promise<void>;
+}
+export default Bindings;
+export { BindingEntry };
+//# sourceMappingURL=bindings.d.ts.map

package/dist/graph/bindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bindings.d.ts","sourceRoot":"","sources":["../../src/graph/bindings.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC;AAE/C;;;;;;GAMG;AACH,cAAM,YAAY;IACP,KAAK,EAAE,GAAG,CAAa;IACvB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAQ;IACjC,aAAa,EAAE,OAAO,CAAS;IAC/B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAQ;IACrC,QAAQ,EAAE,MAAM,CAAK;IACrB,MAAM,EAAE,OAAO,CAAS;CAClC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAM,QAAQ;IACV,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,cAAc,CAA0B;WAElC,WAAW,IAAI,QAAQ;IAOrC;;;;OAIG;IACI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAkBnC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG;IAKtB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIjC,kDAAkD;IAC3C,KAAK,IAAI,IAAI;IAIpB,6DAA6D;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIhD,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;;OAKG;IACI,mBAAmB,CACtB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,GAAG,EACV,SAAS,EAAE,OAAO,EAClB,cAAc,EAAE,MAAM,GACvB,IAAI;IAcP;;;;OAIG;IACI,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAUrC;;;;OAIG;IACU,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA+BxD;AAED,eAAe,QAAQ,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/graph/bindings.js

@@ -0,0 +1,210 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BindingEntry = void 0;
+/**
+ * One entry in the {@link Bindings} singleton.  Plain bindings store
+ * their materialised `value` directly; refreshable bindings (created
+ * by `LET name = { ... } REFRESH EVERY n unit`) additionally store
+ * the backing `statement` and TTL so the value can be re-evaluated on
+ * read once stale.
+ */
+class BindingEntry {
+    constructor() {
+        this.value = undefined;
+        this.statement = null;
+        this.isRefreshable = false;
+        this.refreshEveryMs = null;
+        this.cachedAt = 0;
+        this.primed = false;
+    }
+}
+exports.BindingEntry = BindingEntry;
+/**
+ * Singleton store for `LET`-bound values.
+ *
+ * Bindings live alongside virtual node/relationship definitions in
+ * {@link Database}: they are persistent across `Runner` invocations
+ * for the lifetime of the process.
+ *
+ * A binding's value may be any JSON-serialisable value: a primitive, an
+ * array, or a map.  Bindings are referenced by name inside virtual
+ * definitions and inside `LOAD JSON FROM <name>` expressions; the
+ * `UPDATE` statement replaces an existing binding wholesale, while
+ * `MERGE INTO ... USING ...` upserts per row.
+ *
+ * `LET name = { ... } REFRESH EVERY n unit` registers a refreshable
+ * binding: the sub-query is evaluated eagerly and the result is
+ * cached, but the TTL causes the next read after expiry to re-execute
+ * the sub-query.  Refreshable bindings cannot be silently overwritten
+ * by another `LET`, `UPDATE`, or `MERGE`; callers must `DROP BINDING`
+ * first.
+ */
+class Bindings {
+    constructor() {
+        this._entries = new Map();
+        this._materializing = new Set();
+    }
+    static getInstance() {
+        if (!Bindings.instance) {
+            Bindings.instance = new Bindings();
+        }
+        return Bindings.instance;
+    }
+    /**
+     * Eager set, used by plain `LET`, `UPDATE`, and `MERGE INTO`.
+     * Throws if the name is currently bound to a refreshable binding;
+     * the caller must `DROP BINDING` first.
+     */
+    set(name, value) {
+        const existing = this._entries.get(name);
+        if (existing !== undefined && existing.isRefreshable) {
+            throw new Error(`Binding '${name}' is refreshable; DROP BINDING ${name} first`);
+        }
+        let entry = existing;
+        if (entry === undefined) {
+            entry = new BindingEntry();
+            this._entries.set(name, entry);
+        }
+        entry.value = value;
+        entry.statement = null;
+        entry.isRefreshable = false;
+        entry.refreshEveryMs = null;
+        entry.cachedAt = Date.now();
+        entry.primed = true;
+    }
+    get(name) {
+        const entry = this._entries.get(name);
+        return entry === undefined ? undefined : entry.value;
+    }
+    has(name) {
+        return this._entries.has(name);
+    }
+    delete(name) {
+        this._entries.delete(name);
+    }
+    /** Replace all entries (test/teardown helper). */
+    clear() {
+        this._entries.clear();
+    }
+    /** Inspect the underlying entry without materialising it. */
+    getEntry(name) {
+        return this._entries.get(name);
+    }
+    isRefreshable(name) {
+        var _a;
+        return ((_a = this._entries.get(name)) === null || _a === void 0 ? void 0 : _a.isRefreshable) === true;
+    }
+    /**
+     * Register a refreshable binding with an eagerly evaluated value
+     * and a backing sub-query that is re-executed when the TTL has
+     * elapsed.  Throws if a binding with the same name already exists;
+     * callers must `DROP BINDING` first.
+     */
+    registerRefreshable(name, value, statement, refreshEveryMs) {
+        if (this._entries.has(name)) {
+            throw new Error(`Binding '${name}' already exists; DROP BINDING ${name} first`);
+        }
+        const entry = new BindingEntry();
+        entry.value = value;
+        entry.statement = statement;
+        entry.isRefreshable = true;
+        entry.refreshEveryMs = refreshEveryMs;
+        entry.primed = true;
+        entry.cachedAt = Date.now();
+        this._entries.set(name, entry);
+    }
+    /**
+     * Clear the cached value of a refreshable binding so the next
+     * {@link materialize} call re-executes the backing sub-query.
+     * No-op for plain bindings.
+     */
+    invalidate(name) {
+        const entry = this._entries.get(name);
+        if (entry === undefined || !entry.isRefreshable) {
+            return;
+        }
+        entry.value = undefined;
+        entry.primed = false;
+        entry.cachedAt = 0;
+    }
+    /**
+     * Re-evaluate a refreshable binding's backing sub-query if the
+     * cached value is stale (TTL elapsed or invalidated).  No-op for
+     * plain bindings or for refreshable bindings that are still fresh.
+     */
+    materialize(name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const entry = this._entries.get(name);
+            if (entry === undefined || !entry.isRefreshable || entry.statement === null) {
+                return;
+            }
+            const isFresh = entry.primed &&
+                entry.refreshEveryMs !== null &&
+                Date.now() - entry.cachedAt < entry.refreshEveryMs;
+            if (isFresh) {
+                return;
+            }
+            if (this._materializing.has(name)) {
+                throw new Error(`Cyclic refreshable binding dependency detected while materialising '${name}'`);
+            }
+            this._materializing.add(name);
+            try {
+                // Lazy dynamic import to avoid a load-time cycle:
+                // bindings -> runner -> parsing -> graph (back to here).
+                const RunnerCtor = (yield Promise.resolve().then(() => __importStar(require("../compute/runner")))).default;
+                const runner = new RunnerCtor(null, entry.statement, null);
+                yield runner.run();
+                entry.value = runner.results;
+                entry.primed = true;
+                entry.cachedAt = Date.now();
+            }
+            finally {
+                this._materializing.delete(name);
+            }
+        });
+    }
+}
+exports.default = Bindings;
+//# sourceMappingURL=bindings.js.map

package/dist/graph/bindings.js.map

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

package/dist/graph/database.d.ts

@@ -12,13 +12,15 @@ declare class Database {
     get nodes(): Map<string, PhysicalNode>;
     /** Read-only access to registered relationships (type → endpoint-key → physical). */
     get relationships(): Map<string, Map<string, PhysicalRelationship>>;
-    addNode(node: Node, statement: ASTNode): void;
+    addNode(node: Node, statement: ASTNode, isStatic?: boolean, refreshEveryMs?: number | null): void;
     removeNode(node: Node): void;
+    refreshNode(node: Node): void;
     getNode(node: Node): PhysicalNode | null;
     /** Endpoint-only key: "Source:Target" */
     private static endpointKey;
-    addRelationship(relationship: Relationship, statement: ASTNode): void;
+    addRelationship(relationship: Relationship, statement: ASTNode, isStatic?: boolean, refreshEveryMs?: number | null): void;
     removeRelationship(relationship: Relationship): void;
+    refreshRelationship(relationship: Relationship): void;
     getRelationship(relationship: Relationship): PhysicalRelationship | null;
 }
 export default Database;

package/dist/graph/database.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/graph/database.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAC1C,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1B,OAAO,YAAY,MAAM,iBAAiB,CAAC;AAC3C,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C,cAAM,QAAQ;IACV,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAW;IAClC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAwC;IAC7D,OAAO,CAAC,MAAM,CAAC,cAAc,CAA6D;WAE5E,WAAW,IAAI,QAAQ;IAMrC,4CAA4C;IAC5C,IAAW,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAE5C;IACD,qFAAqF;IACrF,IAAW,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAEzE;IACM,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAQ7C,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAM5B,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,GAAG,IAAI;IAG/C,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAAC,WAAW;IAGnB,eAAe,CAAC,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI;IAmBrE,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAepD,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,oBAAoB,GAAG,IAAI;CAclF;AAED,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/graph/database.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAC1C,OAAO,IAAI,MAAM,QAAQ,CAAC;AAC1B,OAAO,YAAY,MAAM,iBAAiB,CAAC;AAC3C,OAAO,oBAAoB,MAAM,yBAAyB,CAAC;AAC3D,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C,cAAM,QAAQ;IACV,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAW;IAClC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAwC;IAC7D,OAAO,CAAC,MAAM,CAAC,cAAc,CAA6D;WAE5E,WAAW,IAAI,QAAQ;IAMrC,4CAA4C;IAC5C,IAAW,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAE5C;IACD,qFAAqF;IACrF,IAAW,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAEzE;IACM,OAAO,CACV,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE,OAAe,EACzB,cAAc,GAAE,MAAM,GAAG,IAAW,GACrC,IAAI;IAgBA,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAM5B,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAU7B,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,YAAY,GAAG,IAAI;IAG/C,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAAC,WAAW;IAGnB,eAAe,CAClB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,OAAO,EAClB,QAAQ,GAAE,OAAe,EACzB,cAAc,GAAE,MAAM,GAAG,IAAW,GACrC,IAAI;IA4BA,kBAAkB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAepD,mBAAmB,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI;IAiBrD,eAAe,CAAC,YAAY,EAAE,YAAY,GAAG,oBAAoB,GAAG,IAAI;CAclF;AAED,eAAe,QAAQ,CAAC"}

package/dist/graph/database.js

@@ -20,12 +20,18 @@ class Database {
     get relationships() {
         return Database._relationships;
     }
-    addNode(node, statement) {
+    addNode(node, statement, isStatic = false, refreshEveryMs = null) {
         if (node.label === null) {
             throw new Error("Node label is null");
         }
+        const existing = Database._nodes.get(node.label);
+        if (existing !== undefined && (existing.isStatic || isStatic)) {
+            throw new Error(`Virtual node (:${node.label}) already exists; DROP VIRTUAL (:${node.label}) first`);
+        }
         const physical = new physical_node_1.default(null, node.label);
         physical.statement = statement;
+        physical.isStatic = isStatic;
+        physical.refreshEveryMs = refreshEveryMs;
         Database._nodes.set(node.label, physical);
     }
     removeNode(node) {
@@ -34,6 +40,16 @@ class Database {
         }
         Database._nodes.delete(node.label);
     }
+    refreshNode(node) {
+        if (node.label === null) {
+            throw new Error("Node label is null");
+        }
+        const physical = Database._nodes.get(node.label);
+        if (physical === undefined) {
+            throw new Error(`Virtual node (:${node.label}) does not exist`);
+        }
+        physical.invalidateCache();
+    }
     getNode(node) {
         return Database._nodes.get(node.label) || null;
     }
@@ -41,22 +57,29 @@ class Database {
     static endpointKey(sourceLabel, targetLabel) {
         return `${sourceLabel !== null && sourceLabel !== void 0 ? sourceLabel : ""}:${targetLabel !== null && targetLabel !== void 0 ? targetLabel : ""}`;
     }
-    addRelationship(relationship, statement) {
-        var _a, _b, _c, _d;
+    addRelationship(relationship, statement, isStatic = false, refreshEveryMs = null) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
         if (relationship.type === null) {
             throw new Error("Relationship type is null");
         }
+        const key = Database.endpointKey((_b = (_a = relationship.source) === null || _a === void 0 ? void 0 : _a.label) !== null && _b !== void 0 ? _b : null, (_d = (_c = relationship.target) === null || _c === void 0 ? void 0 : _c.label) !== null && _d !== void 0 ? _d : null);
+        const typeMap = Database._relationships.get(relationship.type);
+        const existing = typeMap === null || typeMap === void 0 ? void 0 : typeMap.get(key);
+        if (existing !== undefined && (existing.isStatic || isStatic)) {
+            throw new Error(`Virtual relationship [:${relationship.type}] between (:${(_f = (_e = relationship.source) === null || _e === void 0 ? void 0 : _e.label) !== null && _f !== void 0 ? _f : ""}) and (:${(_h = (_g = relationship.target) === null || _g === void 0 ? void 0 : _g.label) !== null && _h !== void 0 ? _h : ""}) already exists; DROP VIRTUAL ...-[:${relationship.type}]-... first`);
+        }
         const physical = new physical_relationship_1.default(null, relationship.type);
         physical.statement = statement;
         physical.source = relationship.source;
         physical.target = relationship.target;
-        const key = Database.endpointKey((_b = (_a = relationship.source) === null || _a === void 0 ? void 0 : _a.label) !== null && _b !== void 0 ? _b : null, (_d = (_c = relationship.target) === null || _c === void 0 ? void 0 : _c.label) !== null && _d !== void 0 ? _d : null);
-        let typeMap = Database._relationships.get(relationship.type);
-        if (!typeMap) {
-            typeMap = new Map();
-            Database._relationships.set(relationship.type, typeMap);
+        physical.isStatic = isStatic;
+        physical.refreshEveryMs = refreshEveryMs;
+        let map = typeMap;
+        if (!map) {
+            map = new Map();
+            Database._relationships.set(relationship.type, map);
         }
-        typeMap.set(key, physical);
+        map.set(key, physical);
     }
     removeRelationship(relationship) {
         var _a, _b, _c, _d;
@@ -72,6 +95,19 @@ class Database {
             Database._relationships.delete(relationship.type);
         }
     }
+    refreshRelationship(relationship) {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        if (relationship.type === null) {
+            throw new Error("Relationship type is null");
+        }
+        const typeMap = Database._relationships.get(relationship.type);
+        const key = Database.endpointKey((_b = (_a = relationship.source) === null || _a === void 0 ? void 0 : _a.label) !== null && _b !== void 0 ? _b : null, (_d = (_c = relationship.target) === null || _c === void 0 ? void 0 : _c.label) !== null && _d !== void 0 ? _d : null);
+        const physical = typeMap === null || typeMap === void 0 ? void 0 : typeMap.get(key);
+        if (physical === undefined) {
+            throw new Error(`Virtual relationship [:${relationship.type}] between (:${(_f = (_e = relationship.source) === null || _e === void 0 ? void 0 : _e.label) !== null && _f !== void 0 ? _f : ""}) and (:${(_h = (_g = relationship.target) === null || _g === void 0 ? void 0 : _g.label) !== null && _h !== void 0 ? _h : ""}) does not exist`);
+        }
+        physical.invalidateCache();
+    }
     getRelationship(relationship) {
         var _a, _b, _c, _d, _e;
         const typeMap = Database._relationships.get(relationship.type);

package/dist/graph/database.js.map

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

package/dist/graph/physical_node.d.ts

@@ -2,8 +2,17 @@ import ASTNode from "../parsing/ast_node";
 import Node from "./node";
 declare class PhysicalNode extends Node {
     private _statement;
+    private _isStatic;
+    private _refreshEveryMs;
+    private _cache;
+    private _cachedAt;
     set statement(statement: ASTNode | null);
     get statement(): ASTNode | null;
+    get isStatic(): boolean;
+    set isStatic(value: boolean);
+    get refreshEveryMs(): number | null;
+    set refreshEveryMs(value: number | null);
+    invalidateCache(): void;
     data(args?: Record<string, any> | null): Promise<Record<string, any>[]>;
 }
 export default PhysicalNode;

package/dist/graph/physical_node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"physical_node.d.ts","sourceRoot":"","sources":["../../src/graph/physical_node.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAC1C,OAAO,IAAI,MAAM,QAAQ,CAAC;AAE1B,cAAM,YAAa,SAAQ,IAAI;IAC3B,OAAO,CAAC,UAAU,CAAwB;IAC1C,IAAW,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,EAE7C;IACD,IAAW,SAAS,IAAI,OAAO,GAAG,IAAI,CAErC;IACY,IAAI,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;CAY7F;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"physical_node.d.ts","sourceRoot":"","sources":["../../src/graph/physical_node.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAC1C,OAAO,IAAI,MAAM,QAAQ,CAAC;AAE1B,cAAM,YAAa,SAAQ,IAAI;IAC3B,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,SAAS,CAAa;IAE9B,IAAW,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,EAG7C;IACD,IAAW,SAAS,IAAI,OAAO,GAAG,IAAI,CAErC;IACD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IACD,IAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAEjC;IACD,IAAW,cAAc,IAAI,MAAM,GAAG,IAAI,CAEzC;IACD,IAAW,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAE7C;IACM,eAAe,IAAI,IAAI;IAIjB,IAAI,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;CA0B7F;AAED,eAAe,YAAY,CAAC"}

package/dist/graph/physical_node.js

@@ -1,4 +1,37 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 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) {
@@ -17,25 +50,59 @@ class PhysicalNode extends node_1.default {
     constructor() {
         super(...arguments);
         this._statement = null;
+        this._isStatic = false;
+        this._refreshEveryMs = null;
+        this._cache = null;
+        this._cachedAt = 0;
     }
     set statement(statement) {
         this._statement = statement;
+        this.invalidateCache();
     }
     get statement() {
         return this._statement;
     }
+    get isStatic() {
+        return this._isStatic;
+    }
+    set isStatic(value) {
+        this._isStatic = value;
+    }
+    get refreshEveryMs() {
+        return this._refreshEveryMs;
+    }
+    set refreshEveryMs(value) {
+        this._refreshEveryMs = value;
+    }
+    invalidateCache() {
+        this._cache = null;
+        this._cachedAt = 0;
+    }
     data() {
         return __awaiter(this, arguments, void 0, function* (args = null) {
             if (this._statement === null) {
                 throw new Error("Statement is null");
             }
-            // Lazy require to avoid a load-time cycle:
+            // Filter pass-down queries (with args) bypass the persistent cache
+            // because results depend on runtime parameter values.
+            if (args === null && this._isStatic && this._cache !== null) {
+                const isFresh = this._refreshEveryMs === null || Date.now() - this._cachedAt < this._refreshEveryMs;
+                if (isFresh) {
+                    return this._cache;
+                }
+            }
+            // Lazy dynamic import to avoid a load-time cycle:
             // physical_node -> runner -> parsing -> graph (back to here).
             // Python uses the same idiom (function-local import).
-            const RunnerCtor = require("../compute/runner").default;
+            const RunnerCtor = (yield Promise.resolve().then(() => __importStar(require("../compute/runner")))).default;
             const runner = new RunnerCtor(null, this._statement, args);
             yield runner.run();
-            return runner.results;
+            const result = runner.results;
+            if (args === null && this._isStatic) {
+                this._cache = result;
+                this._cachedAt = Date.now();
+            }
+            return result;
         });
     }
 }

package/dist/graph/physical_node.js.map

@@ -1 +1 @@
-{"version":3,"file":"physical_node.js","sourceRoot":"","sources":["../../src/graph/physical_node.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAEA,kDAA0B;AAE1B,MAAM,YAAa,SAAQ,cAAI;IAA/B;;QACY,eAAU,GAAmB,IAAI,CAAC;IAmB9C,CAAC;IAlBG,IAAW,SAAS,CAAC,SAAyB;QAC1C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;IAChC,CAAC;IACD,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IACY,IAAI;6DAAC,OAAmC,IAAI;YACrD,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACzC,CAAC;YACD,2CAA2C;YAC3C,8DAA8D;YAC9D,sDAAsD;YACtD,MAAM,UAAU,GAAkB,OAAO,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC;YACvE,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC3D,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC,OAAO,CAAC;QAC1B,CAAC;KAAA;CACJ;AAED,kBAAe,YAAY,CAAC"}
+{"version":3,"file":"physical_node.js","sourceRoot":"","sources":["../../src/graph/physical_node.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,kDAA0B;AAE1B,MAAM,YAAa,SAAQ,cAAI;IAA/B;;QACY,eAAU,GAAmB,IAAI,CAAC;QAClC,cAAS,GAAY,KAAK,CAAC;QAC3B,oBAAe,GAAkB,IAAI,CAAC;QACtC,WAAM,GAAiC,IAAI,CAAC;QAC5C,cAAS,GAAW,CAAC,CAAC;IAmDlC,CAAC;IAjDG,IAAW,SAAS,CAAC,SAAyB;QAC1C,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,eAAe,EAAE,CAAC;IAC3B,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,QAAQ,CAAC,KAAc;QAC9B,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IAC3B,CAAC;IACD,IAAW,cAAc;QACrB,OAAO,IAAI,CAAC,eAAe,CAAC;IAChC,CAAC;IACD,IAAW,cAAc,CAAC,KAAoB;QAC1C,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;IACjC,CAAC;IACM,eAAe;QAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACvB,CAAC;IACY,IAAI;6DAAC,OAAmC,IAAI;YACrD,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACzC,CAAC;YACD,mEAAmE;YACnE,sDAAsD;YACtD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBAC1D,MAAM,OAAO,GACT,IAAI,CAAC,eAAe,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC;gBACxF,IAAI,OAAO,EAAE,CAAC;oBACV,OAAO,IAAI,CAAC,MAAM,CAAC;gBACvB,CAAC;YACL,CAAC;YACD,kDAAkD;YAClD,8DAA8D;YAC9D,sDAAsD;YACtD,MAAM,UAAU,GAAkB,CAAC,wDAAa,mBAAmB,GAAC,CAAC,CAAC,OAAO,CAAC;YAC9E,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;YAC3D,MAAM,MAAM,CAAC,GAAG,EAAE,CAAC;YACnB,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC;YAC9B,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;gBACrB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAChC,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC;KAAA;CACJ;AAED,kBAAe,YAAY,CAAC"}

package/dist/graph/physical_relationship.d.ts

@@ -2,8 +2,17 @@ import ASTNode from "../parsing/ast_node";
 import Relationship from "./relationship";
 declare class PhysicalRelationship extends Relationship {
     private _statement;
+    private _isStatic;
+    private _refreshEveryMs;
+    private _cache;
+    private _cachedAt;
     set statement(statement: ASTNode | null);
     get statement(): ASTNode | null;
+    get isStatic(): boolean;
+    set isStatic(value: boolean);
+    get refreshEveryMs(): number | null;
+    set refreshEveryMs(value: number | null);
+    invalidateCache(): void;
     data(args?: Record<string, any> | null): Promise<Record<string, any>[]>;
 }
 export default PhysicalRelationship;

package/dist/graph/physical_relationship.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"physical_relationship.d.ts","sourceRoot":"","sources":["../../src/graph/physical_relationship.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAC1C,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C,cAAM,oBAAqB,SAAQ,YAAY;IAC3C,OAAO,CAAC,UAAU,CAAwB;IAC1C,IAAW,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,EAE7C;IACD,IAAW,SAAS,IAAI,OAAO,GAAG,IAAI,CAErC;IACY,IAAI,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;CAY7F;AAED,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"physical_relationship.d.ts","sourceRoot":"","sources":["../../src/graph/physical_relationship.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAC1C,OAAO,YAAY,MAAM,gBAAgB,CAAC;AAE1C,cAAM,oBAAqB,SAAQ,YAAY;IAC3C,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,SAAS,CAAa;IAE9B,IAAW,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,EAG7C;IACD,IAAW,SAAS,IAAI,OAAO,GAAG,IAAI,CAErC;IACD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IACD,IAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAEjC;IACD,IAAW,cAAc,IAAI,MAAM,GAAG,IAAI,CAEzC;IACD,IAAW,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAE7C;IACM,eAAe,IAAI,IAAI;IAIjB,IAAI,CAAC,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;CA0B7F;AAED,eAAe,oBAAoB,CAAC"}