flowquery 1.0.85 → 1.0.87

package/dist/graph/statement_source.js

@@ -0,0 +1,117 @@
+"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());
+    });
+};
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatementSourceProvider = void 0;
+exports.materializeScan = materializeScan;
+const source_context_1 = __importStar(require("./source_context"));
+/**
+ * Adapts a `CREATE VIRTUAL` definition to the source provider contract.
+ *
+ * The definition is opted in with explicit capabilities; every request
+ * runs the inner statement with `$request` bound to the request envelope
+ * (`operation`, `label`/`type`, `ids`, `side`, `predicate`, `pageSize`)
+ * while `$args` keeps its legacy meaning.  Statements that ignore part
+ * of the request remain correct because FlowQuery re-checks every row.
+ */
+class StatementSourceProvider {
+    constructor(_virtual, capabilities) {
+        this._virtual = _virtual;
+        this.capabilities = capabilities;
+    }
+    _run(request, context) {
+        return this._virtual.request(request, this.capabilities.streaming === true, (0, source_context_1.contextOf)(context));
+    }
+    scan(request, context) {
+        return this._run(request, context);
+    }
+    lookup(request, context) {
+        return this._run(request, context);
+    }
+    expand(request, context) {
+        return this._run(request, context);
+    }
+}
+exports.StatementSourceProvider = StatementSourceProvider;
+/**
+ * Fully read a provider's scan (legacy eager paths: schema
+ * introspection, pattern expressions and mixed legacy/provider patterns).
+ */
+function materializeScan(provider, kind, name, base, args, ctx) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, e_1, _b, _c;
+        const context = ctx !== null && ctx !== void 0 ? ctx : new source_context_1.default();
+        try {
+            context.stats.materializations++;
+            const rows = [];
+            try {
+                for (var _d = true, _e = __asyncValues(context.call(provider, "scan", name, kind, Object.assign(Object.assign({ operation: "scan" }, base), { predicate: null, args, pageSize: context.options.pageSize }))), _f; _f = yield _e.next(), _a = _f.done, !_a; _d = true) {
+                    _c = _f.value;
+                    _d = false;
+                    const page = _c;
+                    rows.push(...page);
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (!_d && !_a && (_b = _e.return)) yield _b.call(_e);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            return rows;
+        }
+        finally {
+            if (ctx === null)
+                yield context.close();
+        }
+    });
+}
+//# sourceMappingURL=statement_source.js.map

package/dist/graph/statement_source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statement_source.js","sourceRoot":"","sources":["../../src/graph/statement_source.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,0CAyBC;AAtED,mEAA4D;AAS5D;;;;;;;;GAQG;AACH,MAAa,uBAAuB;IAChC,YACqB,QAA0B,EAC3B,YAAqE;QADpE,aAAQ,GAAR,QAAQ,CAAkB;QAC3B,iBAAY,GAAZ,YAAY,CAAyD;IACtF,CAAC;IACI,IAAI,CAAC,OAA4B,EAAE,OAA0B;QACjE,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CACxB,OAAO,EACP,IAAI,CAAC,YAAY,CAAC,SAAS,KAAK,IAAI,EACpC,IAAA,0BAAS,EAAC,OAAO,CAAC,CACrB,CAAC;IACN,CAAC;IACM,IAAI,CAAC,OAAY,EAAE,OAA0B;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IACM,MAAM,CAAC,OAAY,EAAE,OAA0B;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IACM,MAAM,CAAC,OAAY,EAAE,OAA0B;QAClD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;CACJ;AArBD,0DAqBC;AAED;;;GAGG;AACH,SAAsB,eAAe,CACjC,QAAa,EACb,IAA6B,EAC7B,IAAY,EACZ,IAAyB,EACzB,IAAgC,EAChC,GAAyB;;;QAEzB,MAAM,OAAO,GAAG,GAAG,aAAH,GAAG,cAAH,GAAG,GAAI,IAAI,wBAAa,EAAE,CAAC;QAC3C,IAAI,CAAC;YACD,OAAO,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC;YACjC,MAAM,IAAI,GAAgB,EAAE,CAAC;;gBAC7B,KAAyB,eAAA,KAAA,cAAA,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,gCAC9D,SAAS,EAAE,MAAM,IACd,IAAI,KACP,SAAS,EAAE,IAAI,EACf,IAAI,EACJ,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,QAAQ,IACpC,CAAA,IAAA,sDAAE,CAAC;oBANoB,cAMvB;oBANuB,WAMvB;oBANS,MAAM,IAAI,KAAA,CAAA;oBAOjB,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;gBACvB,CAAC;;;;;;;;;YACD,OAAO,IAAI,CAAC;QAChB,CAAC;gBAAS,CAAC;YACP,IAAI,GAAG,KAAK,IAAI;gBAAE,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QAC5C,CAAC;IACL,CAAC;CAAA"}

package/dist/graph/virtual_statement.d.ts

@@ -1,4 +1,5 @@
 import ASTNode from "../parsing/ast_node";
+import type SourceContext from "./source_context";
 /**
  * Backing statement of a virtual node or relationship: owns the AST that
  * synthesises the records and the optional in-memory cache around its
@@ -14,6 +15,7 @@ declare class VirtualStatement {
     private _refreshEveryMs;
     private _cache;
     private _cachedAt;
+    private _active;
     set statement(statement: ASTNode | null);
     get statement(): ASTNode | null;
     set isStatic(value: boolean);
@@ -34,8 +36,24 @@ declare class VirtualStatement {
      *                    cache (the weak-map binding must be re-established
      *                    each call).
      */
-    data(args?: Record<string, any> | null, provenance?: boolean): Promise<Record<string, any>[]>;
+    data(args?: Record<string, any> | null, provenance?: boolean, sourceContext?: SourceContext | null): Promise<Record<string, any>[]>;
     private runInner;
+    /**
+     * Wait until no streamed execution of this statement is in progress.
+     * A suspended stream is switched to unbounded buffering and run to
+     * completion first, because executions share the statement's AST.
+     */
+    private quiesce;
+    /** True when the statement can stream rows (single plain RETURN without ORDER BY). */
+    get streamable(): boolean;
+    /**
+     * Serve a source request by running the statement with `$request`
+     * bound to the request envelope (and `$args` to the legacy args).
+     */
+    request(request: Record<string, any>, streaming: boolean, sourceContext: SourceContext | null): Promise<Record<string, any>[]> | AsyncGenerator<Record<string, any>[]>;
+    private stream;
 }
+/** @internal Runner option key carrying the parent query's source context. */
+export declare const INNER_SOURCE_CONTEXT = "__sourceContext";
 export default VirtualStatement;
 //# sourceMappingURL=virtual_statement.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"virtual_statement.d.ts","sourceRoot":"","sources":["../../src/graph/virtual_statement.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAG1C;;;;;;;;GAQG;AACH,cAAM,gBAAgB;IAClB,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;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAEjC;IACD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAE7C;IACD,IAAW,cAAc,IAAI,MAAM,GAAG,IAAI,CAEzC;IAEM,eAAe,IAAI,IAAI;IAK9B,8EAA8E;IAC9E,OAAO,CAAC,YAAY;IAIpB;;;;;;;;;;OAUG;IACU,IAAI,CACb,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW,EACvC,UAAU,GAAE,OAAe,GAC5B,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAoBnB,QAAQ;CAoBzB;AAED,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"virtual_statement.d.ts","sourceRoot":"","sources":["../../src/graph/virtual_statement.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAC1C,OAAO,KAAK,aAAa,MAAM,kBAAkB,CAAC;AAIlD;;;;;;;;GAQG;AACH,cAAM,gBAAgB;IAClB,OAAO,CAAC,UAAU,CAAwB;IAC1C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,OAAO,CAA6D;IAE5E,IAAW,SAAS,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,EAG7C;IACD,IAAW,SAAS,IAAI,OAAO,GAAG,IAAI,CAErC;IAED,IAAW,QAAQ,CAAC,KAAK,EAAE,OAAO,EAEjC;IACD,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED,IAAW,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAE7C;IACD,IAAW,cAAc,IAAI,MAAM,GAAG,IAAI,CAEzC;IAEM,eAAe,IAAI,IAAI;IAK9B,8EAA8E;IAC9E,OAAO,CAAC,YAAY;IAIpB;;;;;;;;;;OAUG;IACU,IAAI,CACb,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW,EACvC,UAAU,GAAE,OAAe,EAC3B,aAAa,GAAE,aAAa,GAAG,IAAW,GAC3C,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAoBnB,QAAQ;IA4BtB;;;;OAIG;YACW,OAAO;IASrB,sFAAsF;IACtF,IAAW,UAAU,IAAI,OAAO,CAQ/B;IAED;;;OAGG;IACI,OAAO,CACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,SAAS,EAAE,OAAO,EAClB,aAAa,EAAE,aAAa,GAAG,IAAI,GACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC,GAAG,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YAY1D,MAAM;CA8BxB;AAED,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,oBAAoB,CAAC;AAuFtD,eAAe,gBAAgB,CAAC"}

package/dist/graph/virtual_statement.js

@@ -41,7 +41,34 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __asyncDelegator = (this && this.__asyncDelegator) || function (o) {
+    var i, p;
+    return i = {}, verb("next"), verb("throw", function (e) { throw e; }), verb("return"), i[Symbol.iterator] = function () { return this; }, i;
+    function verb(n, f) { i[n] = o[n] ? function (v) { return (p = !p) ? { value: __await(o[n](v)), done: false } : f ? f(v) : v; } : f; }
+};
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb("next"), verb("throw"), verb("return", awaitReturn), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function awaitReturn(f) { return function (v) { return Promise.resolve(v).then(f, reject); }; }
+    function verb(n, f) { if (g[n]) { i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; if (f) i[n] = f(i[n]); } }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.INNER_SOURCE_CONTEXT = void 0;
+const source_provider_1 = require("./source_provider");
 const virtual_sources_1 = require("./virtual_sources");
 /**
  * Backing statement of a virtual node or relationship: owns the AST that
@@ -59,6 +86,7 @@ class VirtualStatement {
         this._refreshEveryMs = null;
         this._cache = null;
         this._cachedAt = 0;
+        this._active = null;
     }
     set statement(statement) {
         this._statement = statement;
@@ -99,7 +127,7 @@ class VirtualStatement {
      *                    each call).
      */
     data() {
-        return __awaiter(this, arguments, void 0, function* (args = null, provenance = false) {
+        return __awaiter(this, arguments, void 0, function* (args = null, provenance = false, sourceContext = null) {
             if (this._statement === null) {
                 throw new Error("Statement is null");
             }
@@ -111,7 +139,7 @@ class VirtualStatement {
             if (cacheable && this._cache !== null && this.isCacheFresh()) {
                 return this._cache;
             }
-            const result = yield this.runInner(args, provenance);
+            const result = yield this.runInner(args, provenance, sourceContext);
             if (cacheable) {
                 this._cache = result;
                 this._cachedAt = Date.now();
@@ -119,13 +147,18 @@ class VirtualStatement {
             return result;
         });
     }
-    runInner(args, provenance) {
-        return __awaiter(this, void 0, void 0, function* () {
+    runInner(args_1, provenance_1) {
+        return __awaiter(this, arguments, void 0, function* (args, provenance, sourceContext = null, parameters = null) {
+            yield this.quiesce();
             // Lazy dynamic import to avoid a load-time cycle:
             // virtual_statement -> runner -> parsing -> graph (back to here).
             // Python uses the same idiom (function-local import).
             const RunnerCtor = (yield Promise.resolve().then(() => __importStar(require("../compute/runner")))).default;
-            const runner = new RunnerCtor(null, this._statement, args, { provenance });
+            const runner = new RunnerCtor(null, this._statement, args, {
+                provenance,
+                parameters: parameters !== null && parameters !== void 0 ? parameters : undefined,
+                [exports.INNER_SOURCE_CONTEXT]: sourceContext,
+            });
             yield runner.run();
             const result = runner.results;
             if (provenance) {
@@ -138,6 +171,165 @@ class VirtualStatement {
             return result;
         });
     }
+    /**
+     * Wait until no streamed execution of this statement is in progress.
+     * A suspended stream is switched to unbounded buffering and run to
+     * completion first, because executions share the statement's AST.
+     */
+    quiesce() {
+        return __awaiter(this, void 0, void 0, function* () {
+            while (this._active !== null) {
+                const active = this._active;
+                active.channel.drain();
+                yield active.done;
+                if (this._active === active)
+                    this._active = null;
+            }
+        });
+    }
+    /** True when the statement can stream rows (single plain RETURN without ORDER BY). */
+    get streamable() {
+        var _a;
+        const last = (_a = this._statement) === null || _a === void 0 ? void 0 : _a.lastChild();
+        return (last !== null &&
+            last !== undefined &&
+            typeof last.setRowSink === "function" &&
+            last.supportsRowSink === true);
+    }
+    /**
+     * Serve a source request by running the statement with `$request`
+     * bound to the request envelope (and `$args` to the legacy args).
+     */
+    request(request, streaming, sourceContext) {
+        var _a;
+        if (this._statement === null) {
+            throw new Error("Statement is null");
+        }
+        const parameters = { request };
+        if (!streaming || !this.streamable) {
+            if (sourceContext !== null)
+                sourceContext.stats.materializations++;
+            return this.runInner((_a = request.args) !== null && _a !== void 0 ? _a : null, false, sourceContext, parameters);
+        }
+        return this.stream(request, parameters, sourceContext);
+    }
+    stream(request, parameters, sourceContext) {
+        return __asyncGenerator(this, arguments, function* stream_1() {
+            var _a, _b;
+            yield __await(this.quiesce());
+            const RunnerCtor = (yield __await(Promise.resolve().then(() => __importStar(require("../compute/runner"))))).default;
+            const channel = new RowChannel(Math.max(1, (_a = request.pageSize) !== null && _a !== void 0 ? _a : 256));
+            const runner = new RunnerCtor(null, this._statement, (_b = request.args) !== null && _b !== void 0 ? _b : null, {
+                parameters,
+                rowSink: (row) => channel.push(row),
+                [exports.INNER_SOURCE_CONTEXT]: sourceContext,
+            });
+            const done = runner.run().then(() => channel.close(), (e) => channel.fail(e));
+            const active = { channel, done };
+            this._active = active;
+            const onAbort = () => channel.cancel();
+            sourceContext === null || sourceContext === void 0 ? void 0 : sourceContext.signal.addEventListener("abort", onAbort, { once: true });
+            try {
+                yield __await(yield* __asyncDelegator(__asyncValues(channel.pages())));
+            }
+            finally {
+                sourceContext === null || sourceContext === void 0 ? void 0 : sourceContext.signal.removeEventListener("abort", onAbort);
+                channel.cancel();
+                yield __await(done);
+                if (this._active === active)
+                    this._active = null;
+            }
+        });
+    }
+}
+/** @internal Runner option key carrying the parent query's source context. */
+exports.INNER_SOURCE_CONTEXT = "__sourceContext";
+/**
+ * Bounded hand-off between a streaming inner statement (producer) and
+ * the traversal consuming its rows.  The producer blocks once
+ * `capacity` full pages are waiting.
+ */
+class RowChannel {
+    constructor(_pageSize, _capacity = 2) {
+        this._pageSize = _pageSize;
+        this._capacity = _capacity;
+        this._pages = [];
+        this._current = [];
+        this._done = false;
+        this._error = null;
+        this._cancelled = false;
+        this._unbounded = false;
+        this._consumerWaiter = null;
+        this._producerWaiter = null;
+    }
+    push(row) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this._cancelled)
+                throw new source_provider_1.QueryCancelledError("Source stream closed");
+            this._current.push(row);
+            if (this._current.length < this._pageSize)
+                return;
+            this._pages.push(this._current);
+            this._current = [];
+            this._wakeConsumer();
+            while (!this._unbounded && !this._cancelled && this._pages.length >= this._capacity) {
+                yield new Promise((resolve) => (this._producerWaiter = resolve));
+            }
+            if (this._cancelled)
+                throw new source_provider_1.QueryCancelledError("Source stream closed");
+        });
+    }
+    close() {
+        if (this._current.length > 0) {
+            this._pages.push(this._current);
+            this._current = [];
+        }
+        this._done = true;
+        this._wakeConsumer();
+    }
+    fail(error) {
+        this._error = error;
+        this._done = true;
+        this._wakeConsumer();
+    }
+    cancel() {
+        this._cancelled = true;
+        this._wakeProducer();
+    }
+    drain() {
+        this._unbounded = true;
+        this._wakeProducer();
+    }
+    pages() {
+        return __asyncGenerator(this, arguments, function* pages_1() {
+            while (true) {
+                if (this._pages.length > 0) {
+                    const page = this._pages.shift();
+                    this._wakeProducer();
+                    yield yield __await(page);
+                    continue;
+                }
+                if (this._done) {
+                    if (this._error !== null &&
+                        !(this._cancelled && this._error instanceof source_provider_1.QueryCancelledError)) {
+                        throw this._error;
+                    }
+                    return yield __await(void 0);
+                }
+                yield __await(new Promise((resolve) => (this._consumerWaiter = resolve)));
+            }
+        });
+    }
+    _wakeConsumer() {
+        const w = this._consumerWaiter;
+        this._consumerWaiter = null;
+        w === null || w === void 0 ? void 0 : w();
+    }
+    _wakeProducer() {
+        const w = this._producerWaiter;
+        this._producerWaiter = null;
+        w === null || w === void 0 ? void 0 : w();
+    }
 }
 exports.default = VirtualStatement;
 //# sourceMappingURL=virtual_statement.js.map

package/dist/graph/virtual_statement.js.map

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

package/dist/index.browser.d.ts

@@ -10,4 +10,7 @@ import type { CellBindingTrace, CellTrace, LineageReport, NodeBinding, Relations
 import type { ColumnLineage, ColumnReference, NodeInfo, RelationshipInfo, StatementInfo } from "./parsing/statement_info_crawler";
 export default FlowQuery;
 export type { CellBindingTrace, CellTrace, ColumnLineage, ColumnReference, LineageReport, NodeBinding, NodeInfo, RelationshipBinding, RelationshipHop, RelationshipInfo, RowProvenance, RunnerMetadata, RunnerOptions, StatementInfo, };
+export { SOURCE_CONTRACT_VERSION, PREDICATE_OPERATORS, SourceError, SourceCapabilityError, SourceResponseError, SourceUnsupportedError, QueryCancelledError, cursorPages, matchesPredicate, inMemoryNodeSource, inMemoryRelationshipSource, } from "./graph/source_provider";
+export type { SourceRow, InMemorySourceOptions, PredicateOperator, SourcePredicate, PredicateCapabilities, NodeSourceCapabilities, RelationshipSourceCapabilities, NodeScanRequest, NodeLookupRequest, RelationshipScanRequest, RelationshipExpandRequest, NodeSourceRequest, RelationshipSourceRequest, SourceReadContext, SourceResult, NodeSourceProvider, RelationshipSourceProvider, } from "./graph/source_provider";
+export type { SourceOptions, SourceStats, SourcePlan } from "./graph/source_context";
 //# sourceMappingURL=index.browser.d.ts.map

package/dist/index.browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EACR,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EAChB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,KAAK,EACR,aAAa,EACb,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,aAAa,EAChB,MAAM,kCAAkC,CAAC;AA+B1C,eAAe,SAAS,CAAC;AACzB,YAAY,EACR,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,eAAe,EACf,aAAa,EACb,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,GAChB,CAAC"}
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EACR,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,WAAW,EACX,mBAAmB,EACnB,eAAe,EACf,aAAa,EACb,cAAc,EACd,aAAa,EAChB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,KAAK,EACR,aAAa,EACb,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,aAAa,EAChB,MAAM,kCAAkC,CAAC;AA+B1C,eAAe,SAAS,CAAC;AACzB,YAAY,EACR,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,eAAe,EACf,aAAa,EACb,WAAW,EACX,QAAQ,EACR,mBAAmB,EACnB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,GAChB,CAAC;AAGF,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACR,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,0BAA0B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.browser.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.inMemoryRelationshipSource = exports.inMemoryNodeSource = exports.matchesPredicate = exports.cursorPages = exports.QueryCancelledError = exports.SourceUnsupportedError = exports.SourceResponseError = exports.SourceCapabilityError = exports.SourceError = exports.PREDICATE_OPERATORS = exports.SOURCE_CONTRACT_VERSION = void 0;
 /**
  * FlowQuery - A declarative query language for data processing pipelines.
  *
@@ -36,4 +37,17 @@ flowquery_1.default.getFunctionMetadata = function (name) {
  */
 flowquery_1.default.Function = function_1.default;
 exports.default = flowquery_1.default;
+// Backend-aware virtual source contract
+var source_provider_1 = require("./graph/source_provider");
+Object.defineProperty(exports, "SOURCE_CONTRACT_VERSION", { enumerable: true, get: function () { return source_provider_1.SOURCE_CONTRACT_VERSION; } });
+Object.defineProperty(exports, "PREDICATE_OPERATORS", { enumerable: true, get: function () { return source_provider_1.PREDICATE_OPERATORS; } });
+Object.defineProperty(exports, "SourceError", { enumerable: true, get: function () { return source_provider_1.SourceError; } });
+Object.defineProperty(exports, "SourceCapabilityError", { enumerable: true, get: function () { return source_provider_1.SourceCapabilityError; } });
+Object.defineProperty(exports, "SourceResponseError", { enumerable: true, get: function () { return source_provider_1.SourceResponseError; } });
+Object.defineProperty(exports, "SourceUnsupportedError", { enumerable: true, get: function () { return source_provider_1.SourceUnsupportedError; } });
+Object.defineProperty(exports, "QueryCancelledError", { enumerable: true, get: function () { return source_provider_1.QueryCancelledError; } });
+Object.defineProperty(exports, "cursorPages", { enumerable: true, get: function () { return source_provider_1.cursorPages; } });
+Object.defineProperty(exports, "matchesPredicate", { enumerable: true, get: function () { return source_provider_1.matchesPredicate; } });
+Object.defineProperty(exports, "inMemoryNodeSource", { enumerable: true, get: function () { return source_provider_1.inMemoryNodeSource; } });
+Object.defineProperty(exports, "inMemoryRelationshipSource", { enumerable: true, get: function () { return source_provider_1.inMemoryRelationshipSource; } });
 //# sourceMappingURL=index.browser.js.map

package/dist/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":";;;;;AAAA;;;;;;GAMG;AACH,oEAA2D;AAY3D,4EAAoD;AACpD,4FAAmE;AAcnE;;;;;GAKG;AACH,mBAAS,CAAC,aAAa,GAAG,UAAU,OAInC;IACG,OAAO,0BAAe,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,mBAAS,CAAC,mBAAmB,GAAG,UAAU,IAAY;IAClD,OAAO,0BAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF;;GAEG;AACH,mBAAS,CAAC,QAAQ,GAAG,kBAAQ,CAAC;AAE9B,kBAAe,mBAAS,CAAC"}
+{"version":3,"file":"index.browser.js","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;GAMG;AACH,oEAA2D;AAY3D,4EAAoD;AACpD,4FAAmE;AAcnE;;;;;GAKG;AACH,mBAAS,CAAC,aAAa,GAAG,UAAU,OAInC;IACG,OAAO,0BAAe,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,mBAAS,CAAC,mBAAmB,GAAG,UAAU,IAAY;IAClD,OAAO,0BAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF;;GAEG;AACH,mBAAS,CAAC,QAAQ,GAAG,kBAAQ,CAAC;AAE9B,kBAAe,mBAAS,CAAC;AAkBzB,wCAAwC;AACxC,2DAYiC;AAX7B,0HAAA,uBAAuB,OAAA;AACvB,sHAAA,mBAAmB,OAAA;AACnB,8GAAA,WAAW,OAAA;AACX,wHAAA,qBAAqB,OAAA;AACrB,sHAAA,mBAAmB,OAAA;AACnB,yHAAA,sBAAsB,OAAA;AACtB,sHAAA,mBAAmB,OAAA;AACnB,8GAAA,WAAW,OAAA;AACX,mHAAA,gBAAgB,OAAA;AAChB,qHAAA,kBAAkB,OAAA;AAClB,6HAAA,0BAA0B,OAAA"}

package/dist/index.node.d.ts

@@ -13,4 +13,7 @@ import { FunctionMetadata, OutputSchema, ParameterSchema } from "./parsing/funct
 import { ColumnLineage, ColumnReference, NodeInfo, RelationshipInfo, StatementInfo } from "./parsing/statement_info_crawler";
 export default FlowQuery;
 export { FlowQuery, Function, FunctionFactory, AsyncDataProvider, FunctionMetadata, ParameterSchema, OutputSchema, RunnerMetadata, StatementInfo, NodeInfo, RelationshipInfo, ColumnLineage, ColumnReference, CellTrace, CellBindingTrace, LineageReport, };
+export { SOURCE_CONTRACT_VERSION, PREDICATE_OPERATORS, SourceError, SourceCapabilityError, SourceResponseError, SourceUnsupportedError, QueryCancelledError, cursorPages, matchesPredicate, inMemoryNodeSource, inMemoryRelationshipSource, } from "./graph/source_provider";
+export type { SourceRow, InMemorySourceOptions, PredicateOperator, SourcePredicate, PredicateCapabilities, NodeSourceCapabilities, RelationshipSourceCapabilities, NodeScanRequest, NodeLookupRequest, RelationshipScanRequest, RelationshipExpandRequest, NodeSourceRequest, RelationshipSourceRequest, SourceReadContext, SourceResult, NodeSourceProvider, RelationshipSourceProvider, } from "./graph/source_provider";
+export type { SourceOptions, SourceStats, SourcePlan } from "./graph/source_context";
 //# sourceMappingURL=index.node.d.ts.map

package/dist/index.node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.node.d.ts","sourceRoot":"","sources":["../src/index.node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,QAAQ,MAAM,8BAA8B,CAAC;AACpD,OAAO,eAAe,EAAE,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EACH,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAClB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACH,aAAa,EACb,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,aAAa,EAChB,MAAM,kCAAkC,CAAC;AA+B1C,eAAe,SAAS,CAAC;AACzB,OAAO,EACH,SAAS,EACT,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,aAAa,GAChB,CAAC"}
+{"version":3,"file":"index.node.d.ts","sourceRoot":"","sources":["../src/index.node.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9F,OAAO,QAAQ,MAAM,8BAA8B,CAAC;AACpD,OAAO,eAAe,EAAE,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC1F,OAAO,EACH,gBAAgB,EAChB,YAAY,EACZ,eAAe,EAClB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACH,aAAa,EACb,eAAe,EACf,QAAQ,EACR,gBAAgB,EAChB,aAAa,EAChB,MAAM,kCAAkC,CAAC;AA+B1C,eAAe,SAAS,CAAC;AACzB,OAAO,EACH,SAAS,EACT,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,aAAa,EACb,QAAQ,EACR,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,SAAS,EACT,gBAAgB,EAChB,aAAa,GAChB,CAAC;AAGF,OAAO,EACH,uBAAuB,EACvB,mBAAmB,EACnB,WAAW,EACX,qBAAqB,EACrB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,0BAA0B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACR,SAAS,EACT,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,eAAe,EACf,iBAAiB,EACjB,uBAAuB,EACvB,yBAAyB,EACzB,iBAAiB,EACjB,yBAAyB,EACzB,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,0BAA0B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/index.node.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FunctionFactory = exports.Function = exports.FlowQuery = void 0;
+exports.inMemoryRelationshipSource = exports.inMemoryNodeSource = exports.matchesPredicate = exports.cursorPages = exports.QueryCancelledError = exports.SourceUnsupportedError = exports.SourceResponseError = exports.SourceCapabilityError = exports.SourceError = exports.PREDICATE_OPERATORS = exports.SOURCE_CONTRACT_VERSION = exports.FunctionFactory = exports.Function = exports.FlowQuery = void 0;
 /**
  * FlowQuery - A declarative query language for data processing pipelines.
  *
@@ -40,4 +40,17 @@ flowquery_1.default.getFunctionMetadata = function (name) {
  */
 flowquery_1.default.Function = function_1.default;
 exports.default = flowquery_1.default;
+// Backend-aware virtual source contract
+var source_provider_1 = require("./graph/source_provider");
+Object.defineProperty(exports, "SOURCE_CONTRACT_VERSION", { enumerable: true, get: function () { return source_provider_1.SOURCE_CONTRACT_VERSION; } });
+Object.defineProperty(exports, "PREDICATE_OPERATORS", { enumerable: true, get: function () { return source_provider_1.PREDICATE_OPERATORS; } });
+Object.defineProperty(exports, "SourceError", { enumerable: true, get: function () { return source_provider_1.SourceError; } });
+Object.defineProperty(exports, "SourceCapabilityError", { enumerable: true, get: function () { return source_provider_1.SourceCapabilityError; } });
+Object.defineProperty(exports, "SourceResponseError", { enumerable: true, get: function () { return source_provider_1.SourceResponseError; } });
+Object.defineProperty(exports, "SourceUnsupportedError", { enumerable: true, get: function () { return source_provider_1.SourceUnsupportedError; } });
+Object.defineProperty(exports, "QueryCancelledError", { enumerable: true, get: function () { return source_provider_1.QueryCancelledError; } });
+Object.defineProperty(exports, "cursorPages", { enumerable: true, get: function () { return source_provider_1.cursorPages; } });
+Object.defineProperty(exports, "matchesPredicate", { enumerable: true, get: function () { return source_provider_1.matchesPredicate; } });
+Object.defineProperty(exports, "inMemoryNodeSource", { enumerable: true, get: function () { return source_provider_1.inMemoryNodeSource; } });
+Object.defineProperty(exports, "inMemoryRelationshipSource", { enumerable: true, get: function () { return source_provider_1.inMemoryRelationshipSource; } });
 //# sourceMappingURL=index.node.js.map

package/dist/index.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.node.js","sourceRoot":"","sources":["../src/index.node.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;GAMG;AACH,oEAA2D;AAgDvD,0FAhDgB,mBAAS,OAgDhB;AA9Cb,4EAAoD;AA+ChD,mBA/CG,kBAAQ,CA+CH;AA9CZ,4FAA0F;AA+CtF,0BA/CG,0BAAe,CA+CH;AAjCnB;;;;;GAKG;AACH,mBAAS,CAAC,aAAa,GAAG,UAAU,OAInC;IACG,OAAO,0BAAe,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,mBAAS,CAAC,mBAAmB,GAAG,UAAU,IAAY;IAClD,OAAO,0BAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF;;GAEG;AACH,mBAAS,CAAC,QAAQ,GAAG,kBAAQ,CAAC;AAE9B,kBAAe,mBAAS,CAAC"}
+{"version":3,"file":"index.node.js","sourceRoot":"","sources":["../src/index.node.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;GAMG;AACH,oEAA2D;AAgDvD,0FAhDgB,mBAAS,OAgDhB;AA9Cb,4EAAoD;AA+ChD,mBA/CG,kBAAQ,CA+CH;AA9CZ,4FAA0F;AA+CtF,0BA/CG,0BAAe,CA+CH;AAjCnB;;;;;GAKG;AACH,mBAAS,CAAC,aAAa,GAAG,UAAU,OAInC;IACG,OAAO,0BAAe,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,mBAAS,CAAC,mBAAmB,GAAG,UAAU,IAAY;IAClD,OAAO,0BAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF;;GAEG;AACH,mBAAS,CAAC,QAAQ,GAAG,kBAAQ,CAAC;AAE9B,kBAAe,mBAAS,CAAC;AAoBzB,wCAAwC;AACxC,2DAYiC;AAX7B,0HAAA,uBAAuB,OAAA;AACvB,sHAAA,mBAAmB,OAAA;AACnB,8GAAA,WAAW,OAAA;AACX,wHAAA,qBAAqB,OAAA;AACrB,sHAAA,mBAAmB,OAAA;AACnB,yHAAA,sBAAsB,OAAA;AACtB,sHAAA,mBAAmB,OAAA;AACnB,8GAAA,WAAW,OAAA;AACX,mHAAA,gBAAgB,OAAA;AAChB,qHAAA,kBAAkB,OAAA;AAClB,6HAAA,0BAA0B,OAAA"}

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

@@ -45,6 +45,12 @@ declare class Expression extends ASTNode {
     setAlias(alias: string): void;
     set alias(alias: string);
     get alias(): string | null;
+    /**
+     * Names an un-aliased dot lookup after its source text (`u.displayName`)
+     * so projected columns keep a readable key.  Returns null for anything
+     * else, leaving the caller to fall back to `expr<n>`.
+     */
+    private static propertyPath;
     toString(): string;
     reducers(): AggregateFunction[];
     patterns(): PatternExpression[];

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

@@ -1 +1 @@
-{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../../src/parsing/expressions/expression.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,gCAAgC,CAAC;AAC/D,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,iBAAiB,MAAM,iCAAiC,CAAC;AAEhE,OAAO,kBAAkB,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,cAAM,UAAW,SAAQ,OAAO;IAC5B,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,SAAS,CAAoC;IAErD;;;;;;OAMG;IACI,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAsBnC;;;;OAIG;IACI,MAAM,IAAI,IAAI;IAQrB,OAAO,CAAC,MAAM;IAWP,UAAU,IAAI,OAAO;IAIrB,KAAK,IAAI,GAAG;IAUZ,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED,IAAW,KAAK,IAAI,MAAM,GAAG,IAAI,CAKhC;IAEM,QAAQ,IAAI,MAAM;IAOlB,QAAQ,IAAI,iBAAiB,EAAE;IAM/B,QAAQ,IAAI,iBAAiB,EAAE;IAMtC,OAAO,CAAC,WAAW,CAAqC;IACjD,UAAU,IAAI,kBAAkB,EAAE;IAMzC,OAAO,CAAE,QAAQ;IAQV,QAAQ,IAAI,OAAO;IAGnB,YAAY,IAAI,OAAO;IAG9B,IAAW,UAAU,CAAC,KAAK,EAAE,GAAG,EAE/B;CACJ;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../../src/parsing/expressions/expression.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,gCAAgC,CAAC;AAC/D,OAAO,OAAO,MAAM,aAAa,CAAC;AAElC,OAAO,iBAAiB,MAAM,iCAAiC,CAAC;AAGhE,OAAO,kBAAkB,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;;;;;;;GAeG;AACH,cAAM,UAAW,SAAQ,OAAO;IAC5B,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,SAAS,CAAoC;IACrD,OAAO,CAAC,SAAS,CAAoC;IAErD;;;;;;OAMG;IACI,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAsBnC;;;;OAIG;IACI,MAAM,IAAI,IAAI;IAQrB,OAAO,CAAC,MAAM;IAWP,UAAU,IAAI,OAAO;IAIrB,KAAK,IAAI,GAAG;IAUZ,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED,IAAW,KAAK,IAAI,MAAM,GAAG,IAAI,CAShC;IAED;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAkBpB,QAAQ,IAAI,MAAM;IAOlB,QAAQ,IAAI,iBAAiB,EAAE;IAM/B,QAAQ,IAAI,iBAAiB,EAAE;IAMtC,OAAO,CAAC,WAAW,CAAqC;IACjD,UAAU,IAAI,kBAAkB,EAAE;IAMzC,OAAO,CAAE,QAAQ;IAQV,QAAQ,IAAI,OAAO;IAGnB,YAAY,IAAI,OAAO;IAG9B,IAAW,UAAU,CAAC,KAAK,EAAE,GAAG,EAE/B;CACJ;AAED,eAAe,UAAU,CAAC"}

package/dist/parsing/expressions/expression.js

@@ -5,7 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 const pattern_expression_1 = __importDefault(require("../../graph/pattern_expression"));
 const ast_node_1 = __importDefault(require("../ast_node"));
+const lookup_1 = __importDefault(require("../data_structures/lookup"));
 const aggregate_function_1 = __importDefault(require("../functions/aggregate_function"));
+const identifier_1 = __importDefault(require("./identifier"));
 const reference_1 = __importDefault(require("./reference"));
 const subquery_expression_1 = __importDefault(require("./subquery_expression"));
 /**
@@ -104,10 +106,35 @@ class Expression extends ast_node_1.default {
         this._alias = alias;
     }
     get alias() {
-        if (this.firstChild() instanceof reference_1.default && this._alias === null) {
-            return this.firstChild().identifier;
+        if (this._alias !== null) {
+            return this._alias;
+        }
+        const first = this.firstChild();
+        if (first instanceof reference_1.default) {
+            return first.identifier;
+        }
+        return Expression.propertyPath(first);
+    }
+    /**
+     * Names an un-aliased dot lookup after its source text (`u.displayName`)
+     * so projected columns keep a readable key.  Returns null for anything
+     * else, leaving the caller to fall back to `expr<n>`.
+     */
+    static propertyPath(node) {
+        if (!(node instanceof lookup_1.default)) {
+            return null;
+        }
+        const index = node.index;
+        // Bracket lookups carry an Expression index; only dot access has a bare
+        // Identifier, and Reference extends Identifier so it must be excluded.
+        if (!(index instanceof identifier_1.default) || index instanceof reference_1.default) {
+            return null;
         }
-        return this._alias;
+        const variable = node.variable;
+        const prefix = variable instanceof reference_1.default
+            ? variable.identifier
+            : Expression.propertyPath(variable);
+        return prefix === null ? null : `${prefix}.${index.value()}`;
     }
     toString() {
         if (this._alias !== null) {