flowquery 1.0.48 → 1.0.51

package/dist/compute/runner.d.ts

@@ -15,13 +15,17 @@ import ASTNode from "../parsing/ast_node";
 declare class Runner {
     private first;
     private last;
+    private _args;
+    private _ast;
     /**
      * Creates a new Runner instance and parses the FlowQuery statement.
      *
      * @param statement - The FlowQuery statement to execute
+     * @param ast - An optional pre-parsed AST to use instead of parsing the statement
+     * @param args - Optional parameters to inject into $-prefixed parameter references
      * @throws {Error} If the statement is null, empty, or contains syntax errors
      */
-    constructor(statement?: string | null, ast?: ASTNode | null);
+    constructor(statement?: string | null, ast?: ASTNode | null, args?: Record<string, any> | null);
     /**
      * Executes the parsed FlowQuery statement.
      *
@@ -29,6 +33,13 @@ declare class Runner {
      * @throws {Error} If an error occurs during execution
      */
     run(): Promise<void>;
+    /**
+     * Recursively walks the AST to bind ParameterReference nodes
+     * to the args provided to this Runner.
+     * - $args resolves to the entire args map (for use with $args.key lookups)
+     * - $name resolves to args["name"] (shorthand for individual properties)
+     */
+    private bindParameters;
     /**
      * Gets the results from the executed statement.
      *

package/dist/compute/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/compute/runner.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAI1C;;;;;;;;;;;;GAYG;AACH,cAAM,MAAM;IACR,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,IAAI,CAAY;IAExB;;;;;OAKG;gBACS,SAAS,GAAE,MAAM,GAAG,IAAW,EAAE,GAAG,GAAE,OAAO,GAAG,IAAW;IASvE;;;;;OAKG;IACU,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAajC;;;;OAIG;IACH,IAAW,OAAO,IAAI,GAAG,CAExB;CACJ;AAED,eAAe,MAAM,CAAC"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/compute/runner.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,qBAAqB,CAAC;AAK1C;;;;;;;;;;;;GAYG;AACH,cAAM,MAAM;IACR,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,IAAI,CAAY;IACxB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,IAAI,CAAU;IAEtB;;;;;;;OAOG;gBAEC,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,GAAG,GAAE,OAAO,GAAG,IAAW,EAC1B,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAW;IAW3C;;;;;OAKG;IACU,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IAcjC;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAetB;;;;OAIG;IACH,IAAW,OAAO,IAAI,GAAG,CAExB;CACJ;AAED,eAAe,MAAM,CAAC"}

package/dist/compute/runner.js

@@ -12,6 +12,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const parameter_reference_1 = __importDefault(require("../parsing/expressions/parameter_reference"));
 const parser_1 = __importDefault(require("../parsing/parser"));
 /**
  * Executes a FlowQuery statement and retrieves the results.
@@ -31,15 +32,19 @@ class Runner {
      * Creates a new Runner instance and parses the FlowQuery statement.
      *
      * @param statement - The FlowQuery statement to execute
+     * @param ast - An optional pre-parsed AST to use instead of parsing the statement
+     * @param args - Optional parameters to inject into $-prefixed parameter references
      * @throws {Error} If the statement is null, empty, or contains syntax errors
      */
-    constructor(statement = null, ast = null) {
+    constructor(statement = null, ast = null, args = null) {
+        this._args = null;
         if ((statement === null || statement === "") && ast === null) {
             throw new Error("Either statement or AST must be provided");
         }
-        const _ast = ast !== null ? ast : new parser_1.default().parse(statement);
-        this.first = _ast.firstChild();
-        this.last = _ast.lastChild();
+        this._ast = ast !== null ? ast : new parser_1.default().parse(statement);
+        this._args = args;
+        this.first = this._ast.firstChild();
+        this.last = this._ast.lastChild();
     }
     /**
      * Executes the parsed FlowQuery statement.
@@ -51,6 +56,7 @@ class Runner {
         return __awaiter(this, void 0, void 0, function* () {
             return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
                 try {
+                    this.bindParameters(this._ast);
                     yield this.first.initialize();
                     yield this.first.run();
                     yield this.first.finish();
@@ -62,6 +68,28 @@ class Runner {
             }));
         });
     }
+    /**
+     * Recursively walks the AST to bind ParameterReference nodes
+     * to the args provided to this Runner.
+     * - $args resolves to the entire args map (for use with $args.key lookups)
+     * - $name resolves to args["name"] (shorthand for individual properties)
+     */
+    bindParameters(node) {
+        var _a;
+        if (node instanceof parameter_reference_1.default) {
+            const args = (_a = this._args) !== null && _a !== void 0 ? _a : {};
+            const key = node.name.startsWith("$") ? node.name.substring(1) : node.name;
+            if (key === "args") {
+                node.parameterValue = args;
+            }
+            else {
+                node.parameterValue = key in args ? args[key] : null;
+            }
+        }
+        for (const child of node.getChildren()) {
+            this.bindParameters(child);
+        }
+    }
     /**
      * Gets the results from the executed statement.
      *

package/dist/compute/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/compute/runner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AAEA,+DAAuC;AAEvC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM;IAIR;;;;;OAKG;IACH,YAAY,YAA2B,IAAI,EAAE,MAAsB,IAAI;QACnE,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,EAAE,CAAC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,gBAAM,EAAE,CAAC,KAAK,CAAC,SAAU,CAAC,CAAC;QACjE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,EAAe,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,EAAe,CAAC;IAC9C,CAAC;IAED;;;;;OAKG;IACU,GAAG;;YACZ,OAAO,IAAI,OAAO,CAAO,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC/C,IAAI,CAAC;oBACD,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;oBAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;oBACvB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBAC1B,OAAO,EAAE,CAAC;gBACd,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACT,MAAM,CAAC,CAAC,CAAC,CAAC;gBACd,CAAC;YACL,CAAC,CAAA,CAAC,CAAC;QACP,CAAC;KAAA;IAED;;;;OAIG;IACH,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAC7B,CAAC;CACJ;AAED,kBAAe,MAAM,CAAC"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/compute/runner.ts"],"names":[],"mappings":";;;;;;;;;;;;;;AACA,qGAA4E;AAE5E,+DAAuC;AAEvC;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM;IAMR;;;;;;;OAOG;IACH,YACI,YAA2B,IAAI,EAC/B,MAAsB,IAAI,EAC1B,OAAmC,IAAI;QAdnC,UAAK,GAA+B,IAAI,CAAC;QAgB7C,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,EAAE,CAAC,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,CAAC,IAAI,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,gBAAM,EAAE,CAAC,KAAK,CAAC,SAAU,CAAC,CAAC;QAChE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAe,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAe,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACU,GAAG;;YACZ,OAAO,IAAI,OAAO,CAAO,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC/C,IAAI,CAAC;oBACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBAC/B,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;oBAC9B,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;oBACvB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;oBAC1B,OAAO,EAAE,CAAC;gBACd,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACT,MAAM,CAAC,CAAC,CAAC,CAAC;gBACd,CAAC;YACL,CAAC,CAAA,CAAC,CAAC;QACP,CAAC;KAAA;IAED;;;;;OAKG;IACK,cAAc,CAAC,IAAa;;QAChC,IAAI,IAAI,YAAY,6BAAkB,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,MAAA,IAAI,CAAC,KAAK,mCAAI,EAAE,CAAC;YAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3E,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;gBACjB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,cAAc,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACzD,CAAC;QACL,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACrC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,IAAW,OAAO;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAC7B,CAAC;CACJ;AAED,kBAAe,MAAM,CAAC"}