flowquery 1.0.0 → 1.0.2

package/dist/parsing/operations/operation.js

@@ -0,0 +1,81 @@
+"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 ast_node_1 = __importDefault(require("../ast_node"));
+/**
+ * Base class for all FlowQuery operations.
+ *
+ * Operations represent the main statements in FlowQuery (WITH, UNWIND, RETURN, LOAD, WHERE).
+ * They form a linked list structure and can be executed sequentially.
+ *
+ * @abstract
+ */
+class Operation extends ast_node_1.default {
+    /**
+     * Creates a new Operation instance.
+     */
+    constructor() {
+        super();
+        this._previous = null;
+        this._next = null;
+    }
+    get previous() {
+        return this._previous;
+    }
+    set previous(value) {
+        this._previous = value;
+    }
+    get next() {
+        return this._next;
+    }
+    set next(value) {
+        this._next = value;
+    }
+    addSibling(operation) {
+        var _a;
+        (_a = this._parent) === null || _a === void 0 ? void 0 : _a.addChild(operation);
+        operation.previous = this;
+        this.next = operation;
+    }
+    /**
+     * Executes this operation. Must be implemented by subclasses.
+     *
+     * @returns A promise that resolves when the operation completes
+     * @throws {Error} If not implemented by subclass
+     */
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new Error('Not implemented');
+        });
+    }
+    /**
+     * Finishes execution by calling finish on the next operation in the chain.
+     *
+     * @returns A promise that resolves when all operations finish
+     */
+    finish() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            yield ((_a = this.next) === null || _a === void 0 ? void 0 : _a.finish());
+        });
+    }
+    reset() {
+        ;
+    }
+    get results() {
+        throw new Error('Not implemented');
+    }
+}
+exports.default = Operation;
+//# sourceMappingURL=operation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operation.js","sourceRoot":"","sources":["../../../src/parsing/operations/operation.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,2DAAkC;AAElC;;;;;;;GAOG;AACH,MAAe,SAAU,SAAQ,kBAAO;IAIpC;;OAEG;IACH;QACI,KAAK,EAAE,CAAC;QAPJ,cAAS,GAAqB,IAAI,CAAC;QACnC,UAAK,GAAqB,IAAI,CAAC;IAOvC,CAAC;IACD,IAAW,QAAQ;QACf,OAAO,IAAI,CAAC,SAAS,CAAC;IAC1B,CAAC;IACD,IAAW,QAAQ,CAAC,KAAuB;QACvC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IAC3B,CAAC;IACD,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IACD,IAAW,IAAI,CAAC,KAAuB;QACnC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IACM,UAAU,CAAC,SAAoB;;QAClC,MAAA,IAAI,CAAC,OAAO,0CAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAClC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACU,GAAG;;YACZ,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACvC,CAAC;KAAA;IAED;;;;OAIG;IACU,MAAM;;;YACf,MAAM,CAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,MAAM,EAAE,CAAA,CAAC;QAC9B,CAAC;KAAA;IACM,KAAK;QACR,CAAC;IACL,CAAC;IACD,IAAW,OAAO;QACd,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACvC,CAAC;CACJ;AAED,kBAAe,SAAS,CAAC"}

package/dist/parsing/operations/projection.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const operation_1 = __importDefault(require("./operation"));
+class Projection extends operation_1.default {
+    constructor(expressions) {
+        super();
+        this.children = expressions;
+    }
+    *expressions() {
+        for (let i = 0; i < this.children.length; i++) {
+            const expression = this.children[i];
+            const alias = expression.alias || `expr${i}`;
+            yield [expression, alias];
+        }
+    }
+}
+exports.default = Projection;
+//# sourceMappingURL=projection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../../src/parsing/operations/projection.ts"],"names":[],"mappings":";;;;;AAAA,4DAAoC;AAGpC,MAAM,UAAW,SAAQ,mBAAS;IAC9B,YAAY,WAAyB;QACjC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC;IAChC,CAAC;IACS,CAAC,WAAW;QAClB,KAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,UAAU,GAAe,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAe,CAAC;YAC9D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,OAAO,CAAC,EAAE,CAAC;YAC7C,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC;CACJ;AAED,kBAAe,UAAU,CAAC"}

package/dist/parsing/operations/return.js

@@ -0,0 +1,60 @@
+"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 projection_1 = __importDefault(require("./projection"));
+/**
+ * Represents a RETURN operation that produces the final query results.
+ *
+ * The RETURN operation evaluates expressions and collects them into result records.
+ * It can optionally have a WHERE clause to filter results.
+ *
+ * @example
+ * ```typescript
+ * // RETURN x, y WHERE x > 0
+ * ```
+ */
+class Return extends projection_1.default {
+    constructor() {
+        super(...arguments);
+        this._where = null;
+        this._results = [];
+    }
+    set where(where) {
+        this._where = where;
+    }
+    get where() {
+        if (this._where === null) {
+            return true;
+        }
+        return this._where.value();
+    }
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!this.where) {
+                return;
+            }
+            const record = new Map();
+            for (const [expression, alias] of this.expressions()) {
+                const value = expression.value();
+                record.set(alias, value);
+            }
+            this._results.push(Object.fromEntries(record));
+        });
+    }
+    get results() {
+        return this._results;
+    }
+}
+exports.default = Return;
+//# sourceMappingURL=return.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"return.js","sourceRoot":"","sources":["../../../src/parsing/operations/return.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,8DAAsC;AAGtC;;;;;;;;;;GAUG;AACH,MAAM,MAAO,SAAQ,oBAAU;IAA/B;;QACc,WAAM,GAAiB,IAAI,CAAC;QAC5B,aAAQ,GAA0B,EAAE,CAAC;IAwBnD,CAAC;IAvBG,IAAW,KAAK,CAAC,KAAY;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IACD,IAAW,KAAK;QACZ,IAAG,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IACY,GAAG;;YACZ,IAAG,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,OAAO;YACX,CAAC;YACD,MAAM,MAAM,GAAqB,IAAI,GAAG,EAAE,CAAC;YAC3C,KAAI,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;gBAClD,MAAM,KAAK,GAAQ,UAAU,CAAC,KAAK,EAAE,CAAC;gBACtC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAC7B,CAAC;YACD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,CAAC;KAAA;IACD,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;CACJ;AAED,kBAAe,MAAM,CAAC"}

package/dist/parsing/operations/unwind.js

@@ -0,0 +1,46 @@
+"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 operation_1 = __importDefault(require("./operation"));
+class Unwind extends operation_1.default {
+    constructor(expression) {
+        super();
+        this.addChild(expression);
+    }
+    get expression() {
+        return this.children[0];
+    }
+    get as() {
+        return this.children[1].value;
+    }
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            const expression = this.expression.value();
+            if (!(Array.isArray(expression))) {
+                throw new Error('Expected array');
+            }
+            for (let i = 0; i < expression.length; i++) {
+                this._value = expression[i];
+                yield ((_a = this.next) === null || _a === void 0 ? void 0 : _a.run());
+            }
+            (_b = this.next) === null || _b === void 0 ? void 0 : _b.reset();
+        });
+    }
+    value() {
+        return this._value;
+    }
+}
+exports.default = Unwind;
+//# sourceMappingURL=unwind.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unwind.js","sourceRoot":"","sources":["../../../src/parsing/operations/unwind.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,4DAAoC;AAGpC,MAAM,MAAO,SAAQ,mBAAS;IAE1B,YAAY,UAAsB;QAC9B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IACD,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAe,CAAC;IAC1C,CAAC;IACD,IAAW,EAAE;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAA0B,CAAC;IACvD,CAAC;IACY,GAAG;;;YACZ,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;YAC3C,IAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;gBAC9B,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;YACtC,CAAC;YACD,KAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;gBAC5B,MAAM,CAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,GAAG,EAAE,CAAA,CAAC;YAC3B,CAAC;YACD,MAAA,IAAI,CAAC,IAAI,0CAAE,KAAK,EAAE,CAAC;QACvB,CAAC;KAAA;IACM,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CACJ;AAED,kBAAe,MAAM,CAAC"}

package/dist/parsing/operations/where.js

@@ -0,0 +1,53 @@
+"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 operation_1 = __importDefault(require("./operation"));
+/**
+ * Represents a WHERE operation that filters data based on a condition.
+ *
+ * The WHERE operation evaluates a boolean expression and only continues
+ * execution to the next operation if the condition is true.
+ *
+ * @example
+ * ```typescript
+ * // RETURN x WHERE x > 0
+ * ```
+ */
+class Where extends operation_1.default {
+    /**
+     * Creates a new WHERE operation with the given condition.
+     *
+     * @param expression - The boolean expression to evaluate
+     */
+    constructor(expression) {
+        super();
+        this.addChild(expression);
+    }
+    get expression() {
+        return this.children[0];
+    }
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            if (this.expression.value()) {
+                yield ((_a = this.next) === null || _a === void 0 ? void 0 : _a.run());
+            }
+        });
+    }
+    value() {
+        return this.expression.value();
+    }
+}
+exports.default = Where;
+//# sourceMappingURL=where.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"where.js","sourceRoot":"","sources":["../../../src/parsing/operations/where.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,4DAAoC;AAGpC;;;;;;;;;;GAUG;AACH,MAAM,KAAM,SAAQ,mBAAS;IACzB;;;;OAIG;IACH,YAAY,UAAsB;QAC9B,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC9B,CAAC;IACD,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAe,CAAC;IAC1C,CAAC;IACY,GAAG;;;YACZ,IAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,CAAC;gBACzB,MAAM,CAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,GAAG,EAAE,CAAA,CAAC;YAC3B,CAAC;QACL,CAAC;KAAA;IACM,KAAK;QACR,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACnC,CAAC;CACJ;AAED,kBAAe,KAAK,CAAC"}

package/dist/parsing/operations/with.js

@@ -0,0 +1,36 @@
+"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 projection_1 = __importDefault(require("./projection"));
+/**
+ * Represents a WITH operation that defines variables or intermediate results.
+ *
+ * The WITH operation creates named expressions that can be referenced later in the query.
+ * It passes control to the next operation in the chain.
+ *
+ * @example
+ * ```typescript
+ * // WITH x = 1, y = 2 RETURN x + y
+ * ```
+ */
+class With extends projection_1.default {
+    run() {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            yield ((_a = this.next) === null || _a === void 0 ? void 0 : _a.run());
+        });
+    }
+}
+exports.default = With;
+//# sourceMappingURL=with.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"with.js","sourceRoot":"","sources":["../../../src/parsing/operations/with.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAAA,8DAAsC;AAEtC;;;;;;;;;;GAUG;AACH,MAAM,IAAK,SAAQ,oBAAU;IACZ,GAAG;;;YACZ,MAAM,CAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,GAAG,EAAE,CAAA,CAAC;QAC3B,CAAC;KAAA;CACJ;AAED,kBAAe,IAAI,CAAC"}