flowquery 1.0.0 → 1.0.2

package/dist/parsing/expressions/string.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ast_node_1 = __importDefault(require("../ast_node"));
+/**
+ * Represents a string literal in the AST.
+ *
+ * @example
+ * ```typescript
+ * const str = new String("hello");
+ * console.log(str.value()); // "hello"
+ * ```
+ */
+class String extends ast_node_1.default {
+    /**
+     * Creates a new String node with the given value.
+     *
+     * @param value - The string value
+     */
+    constructor(value) {
+        super();
+        this._value = value;
+    }
+    value() {
+        return this._value;
+    }
+    toString() {
+        return `String (${this._value})`;
+    }
+}
+exports.default = String;
+//# sourceMappingURL=string.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","sourceRoot":"","sources":["../../../src/parsing/expressions/string.ts"],"names":[],"mappings":";;;;;AAAA,2DAAkC;AAElC;;;;;;;;GAQG;AACH,MAAM,MAAO,SAAQ,kBAAO;IAGxB;;;;OAIG;IACH,YAAY,KAAa;QACrB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAEM,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAEM,QAAQ;QACX,OAAO,WAAW,IAAI,CAAC,MAAM,GAAG,CAAC;IACrC,CAAC;CACJ;AAED,kBAAe,MAAM,CAAC"}

package/dist/parsing/functions/aggregate_function.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const function_1 = __importDefault(require("./function"));
+/**
+ * Base class for aggregate functions that reduce multiple values to a single value.
+ *
+ * Aggregate functions like SUM, AVG, and COLLECT process multiple input values
+ * and produce a single output. They cannot be nested within other aggregate functions.
+ *
+ * @example
+ * ```typescript
+ * const sumFunc = new Sum();
+ * // Used in: RETURN SUM(values)
+ * ```
+ */
+class AggregateFunction extends function_1.default {
+    /**
+     * Creates a new AggregateFunction with the given name.
+     *
+     * @param name - The function name
+     */
+    constructor(name) {
+        super(name);
+        this._overridden = null;
+    }
+    /**
+     * Processes a value during the aggregation phase.
+     *
+     * @param value - The element to aggregate
+     * @throws {Error} If not implemented by subclass
+     */
+    reduce(value) {
+        throw new Error("Method not implemented.");
+    }
+    /**
+     * Creates a reducer element for this aggregate function.
+     *
+     * @returns A ReducerElement instance
+     * @throws {Error} If not implemented by subclass
+     */
+    element() {
+        throw new Error("Method not implemented.");
+    }
+    get overridden() {
+        return this._overridden;
+    }
+    set overridden(value) {
+        this._overridden = value;
+    }
+    value() {
+        return this._overridden;
+    }
+}
+exports.default = AggregateFunction;
+//# sourceMappingURL=aggregate_function.js.map

package/dist/parsing/functions/aggregate_function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate_function.js","sourceRoot":"","sources":["../../../src/parsing/functions/aggregate_function.ts"],"names":[],"mappings":";;;;;AAAA,0DAAkC;AAGlC;;;;;;;;;;;GAWG;AACH,MAAM,iBAAkB,SAAQ,kBAAQ;IAGpC;;;;OAIG;IACH,YAAY,IAAY;QACpB,KAAK,CAAC,IAAI,CAAC,CAAC;QARR,gBAAW,GAAe,IAAI,CAAC;IASvC,CAAC;IAED;;;;;OAKG;IACI,MAAM,CAAC,KAAqB;QAC/B,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACI,OAAO;QACV,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;IACD,IAAW,UAAU;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;IACD,IAAW,UAAU,CAAC,KAAiB;QACnC,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC7B,CAAC;IACM,KAAK;QACR,OAAO,IAAI,CAAC,WAAW,CAAC;IAC5B,CAAC;CACJ;AAED,kBAAe,iBAAiB,CAAC"}

package/dist/parsing/functions/async_function.js

@@ -0,0 +1,119 @@
+"use strict";
+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 __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+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]); }
+};
+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"));
+const function_factory_1 = __importDefault(require("./function_factory"));
+/**
+ * Represents an async data provider function call for use in LOAD operations.
+ *
+ * This class holds the function name and arguments, and provides async iteration
+ * over the results from a registered async data provider.
+ *
+ * @example
+ * ```typescript
+ * // Used in: LOAD JSON FROM myDataSource('arg1', 'arg2') AS data
+ * const asyncFunc = new AsyncFunction("myDataSource");
+ * asyncFunc.parameters = [arg1Node, arg2Node];
+ * for await (const item of asyncFunc.execute()) {
+ *     console.log(item);
+ * }
+ * ```
+ */
+class AsyncFunction extends ast_node_1.default {
+    /**
+     * Creates a new AsyncFunction with the given name.
+     *
+     * @param name - The function name (must be registered as an async provider)
+     */
+    constructor(name) {
+        super();
+        this._name = name;
+    }
+    /**
+     * Gets the function name.
+     */
+    get name() {
+        return this._name;
+    }
+    /**
+     * Sets the function parameters.
+     *
+     * @param nodes - Array of AST nodes representing the function arguments
+     */
+    set parameters(nodes) {
+        this.children = nodes;
+    }
+    /**
+     * Evaluates all parameters and returns their values.
+     *
+     * @returns Array of parameter values
+     */
+    getArguments() {
+        return this.children.map(child => child.value());
+    }
+    /**
+     * Executes the async data provider function and yields results.
+     *
+     * @yields Data items from the async provider
+     * @throws {Error} If the function is not registered as an async provider
+     */
+    execute() {
+        return __asyncGenerator(this, arguments, function* execute_1() {
+            const provider = function_factory_1.default.getAsyncProvider(this._name);
+            if (!provider) {
+                throw new Error(`Async data provider '${this._name}' is not registered`);
+            }
+            const args = this.getArguments();
+            const result = provider(...args);
+            // Check if result is an async generator or a promise
+            if (result && typeof result.next === 'function') {
+                // It's an async generator
+                yield __await(yield* __asyncDelegator(__asyncValues(result)));
+            }
+            else {
+                // It's a promise - await and yield the result
+                const data = yield __await(result);
+                if (Array.isArray(data)) {
+                    for (const item of data) {
+                        yield yield __await(item);
+                    }
+                }
+                else {
+                    yield yield __await(data);
+                }
+            }
+        });
+    }
+    toString() {
+        return `AsyncFunction (${this._name})`;
+    }
+}
+exports.default = AsyncFunction;
+//# sourceMappingURL=async_function.js.map

package/dist/parsing/functions/async_function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async_function.js","sourceRoot":"","sources":["../../../src/parsing/functions/async_function.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,2DAAkC;AAClC,0EAAiD;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,aAAc,SAAQ,kBAAO;IAG/B;;;;OAIG;IACH,YAAY,IAAY;QACpB,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;;;OAIG;IACH,IAAW,UAAU,CAAC,KAAgB;QAClC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACK,YAAY;QAChB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;IACrD,CAAC;IAED;;;;;OAKG;IACW,OAAO;;YACjB,MAAM,QAAQ,GAAG,0BAAe,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,KAAK,qBAAqB,CAAC,CAAC;YAC7E,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC;YAEjC,qDAAqD;YACrD,IAAI,MAAM,IAAI,OAAQ,MAAyB,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBAClE,0BAA0B;gBAC1B,cAAA,KAAK,CAAC,CAAC,iBAAA,cAAA,MAA4C,CAAA,CAAA,CAAA,CAAC;YACxD,CAAC;iBAAM,CAAC;gBACJ,8CAA8C;gBAC9C,MAAM,IAAI,GAAG,cAAM,MAAM,CAAA,CAAC;gBAC1B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;oBACtB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;wBACtB,oBAAM,IAAI,CAAA,CAAC;oBACf,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACJ,oBAAM,IAAI,CAAA,CAAC;gBACf,CAAC;YACL,CAAC;QACL,CAAC;KAAA;IAEM,QAAQ;QACX,OAAO,kBAAkB,IAAI,CAAC,KAAK,GAAG,CAAC;IAC3C,CAAC;CACJ;AAED,kBAAe,aAAa,CAAC"}

package/dist/parsing/functions/avg.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const aggregate_function_1 = __importDefault(require("./aggregate_function"));
+const reducer_element_1 = __importDefault(require("./reducer_element"));
+class AvgReducerElement extends reducer_element_1.default {
+    constructor() {
+        super(...arguments);
+        this._count = 0;
+        this._sum = null;
+    }
+    get value() {
+        if (this._sum === null) {
+            return null;
+        }
+        return this._sum / this._count;
+    }
+    set value(value) {
+        this._count += 1;
+        if (this._sum !== null) {
+            this._sum += value;
+        }
+        else {
+            this._sum = value;
+        }
+    }
+}
+class Avg extends aggregate_function_1.default {
+    constructor() {
+        super("avg");
+        this._expectedParameterCount = 1;
+    }
+    reduce(element) {
+        element.value = this.firstChild().value();
+    }
+    element() {
+        return new AvgReducerElement();
+    }
+}
+exports.default = Avg;
+//# sourceMappingURL=avg.js.map

package/dist/parsing/functions/avg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"avg.js","sourceRoot":"","sources":["../../../src/parsing/functions/avg.ts"],"names":[],"mappings":";;;;;AAAA,8EAAqD;AAErD,wEAA+C;AAE/C,MAAM,iBAAkB,SAAQ,yBAAc;IAA9C;;QACY,WAAM,GAAW,CAAC,CAAC;QACnB,SAAI,GAAkB,IAAI,CAAC;IAevC,CAAC;IAdG,IAAW,KAAK;QACZ,IAAG,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;IACnC,CAAC;IACD,IAAW,KAAK,CAAC,KAAa;QAC1B,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC;QACjB,IAAG,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YACpB,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC;QACvB,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC;QACtB,CAAC;IACL,CAAC;CACJ;AAED,MAAM,GAAI,SAAQ,4BAAiB;IAC/B;QACI,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC;IACrC,CAAC;IACM,MAAM,CAAC,OAA0B;QACpC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC;IAC9C,CAAC;IACM,OAAO;QACV,OAAO,IAAI,iBAAiB,EAAE,CAAC;IACnC,CAAC;CACJ;AAED,kBAAe,GAAG,CAAC"}

package/dist/parsing/functions/collect.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const aggregate_function_1 = __importDefault(require("./aggregate_function"));
+const reducer_element_1 = __importDefault(require("./reducer_element"));
+class CollectReducerElement extends reducer_element_1.default {
+    constructor() {
+        super(...arguments);
+        this._value = [];
+    }
+    get value() {
+        return this._value;
+    }
+    set value(value) {
+        this._value.push(value);
+    }
+}
+class DistinctCollectReducerElement extends reducer_element_1.default {
+    constructor() {
+        super(...arguments);
+        this._value = new Map();
+    }
+    get value() {
+        return Array.from(this._value.values());
+    }
+    set value(value) {
+        const key = JSON.stringify(value);
+        if (!this._value.has(key)) {
+            this._value.set(key, value);
+        }
+    }
+}
+class Collect extends aggregate_function_1.default {
+    constructor() {
+        super("collect");
+        this._distinct = false;
+        this._expectedParameterCount = 1;
+    }
+    reduce(element) {
+        element.value = this.firstChild().value();
+    }
+    element() {
+        return this._distinct ? new DistinctCollectReducerElement() : new CollectReducerElement();
+    }
+    set distinct(distinct) {
+        this._distinct = distinct;
+    }
+}
+exports.default = Collect;
+//# sourceMappingURL=collect.js.map

package/dist/parsing/functions/collect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../../../src/parsing/functions/collect.ts"],"names":[],"mappings":";;;;;AAAA,8EAAqD;AACrD,wEAA+C;AAE/C,MAAM,qBAAsB,SAAQ,yBAAc;IAAlD;;QACY,WAAM,GAAU,EAAE,CAAC;IAO/B,CAAC;IANG,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IACD,IAAW,KAAK,CAAC,KAAU;QACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;CACJ;AAED,MAAM,6BAA8B,SAAQ,yBAAc;IAA1D;;QACY,WAAM,GAAkB,IAAI,GAAG,EAAE,CAAC;IAU9C,CAAC;IATG,IAAW,KAAK;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,IAAW,KAAK,CAAC,KAAU;QACvB,MAAM,GAAG,GAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAChC,CAAC;IACL,CAAC;CACJ;AAED,MAAM,OAAQ,SAAQ,4BAAiB;IAEnC;QACI,KAAK,CAAC,SAAS,CAAC,CAAC;QAFb,cAAS,GAAY,KAAK,CAAC;QAG/B,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC;IACrC,CAAC;IACM,MAAM,CAAC,OAA8B;QACxC,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC;IAC9C,CAAC;IACM,OAAO;QACV,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,6BAA6B,EAAE,CAAC,CAAC,CAAC,IAAI,qBAAqB,EAAE,CAAC;IAC9F,CAAC;IACD,IAAW,QAAQ,CAAC,QAAiB;QACjC,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;IAC9B,CAAC;CACJ;AAED,kBAAe,OAAO,CAAC"}

package/dist/parsing/functions/function.js

@@ -0,0 +1,59 @@
+"use strict";
+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 functions in FlowQuery.
+ *
+ * Functions can have parameters and may support the DISTINCT modifier.
+ * Subclasses implement specific function logic.
+ *
+ * @example
+ * ```typescript
+ * const func = FunctionFactory.create("sum");
+ * func.parameters = [expression1, expression2];
+ * ```
+ */
+class Function extends ast_node_1.default {
+    /**
+     * Creates a new Function with the given name.
+     *
+     * @param name - The function name
+     */
+    constructor(name) {
+        super();
+        this._expectedParameterCount = null;
+        this._supports_distinct = false;
+        this._name = name;
+    }
+    /**
+     * Sets the function parameters.
+     *
+     * @param nodes - Array of AST nodes representing the function arguments
+     * @throws {Error} If the number of parameters doesn't match expected count
+     */
+    set parameters(nodes) {
+        if (this._expectedParameterCount !== null && this._expectedParameterCount !== nodes.length) {
+            throw new Error(`Function ${this._name} expected ${this._expectedParameterCount} parameters, but got ${nodes.length}`);
+        }
+        this.children = nodes;
+    }
+    get name() {
+        return this._name;
+    }
+    toString() {
+        return `Function (${this._name})`;
+    }
+    set distinct(distinct) {
+        if (this._supports_distinct) {
+            this._supports_distinct = distinct;
+        }
+        else {
+            throw new Error(`Function ${this._name} does not support distinct`);
+        }
+    }
+}
+exports.default = Function;
+//# sourceMappingURL=function.js.map

package/dist/parsing/functions/function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.js","sourceRoot":"","sources":["../../../src/parsing/functions/function.ts"],"names":[],"mappings":";;;;;AAAA,2DAAkC;AAElC;;;;;;;;;;;GAWG;AACH,MAAM,QAAS,SAAQ,kBAAO;IAK1B;;;;OAIG;IACH,YAAY,IAAY;QACpB,KAAK,EAAE,CAAC;QATF,4BAAuB,GAAkB,IAAI,CAAC;QAC9C,uBAAkB,GAAY,KAAK,CAAC;QAS1C,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED;;;;;OAKG;IACH,IAAW,UAAU,CAAC,KAAgB;QAClC,IAAI,IAAI,CAAC,uBAAuB,KAAK,IAAI,IAAI,IAAI,CAAC,uBAAuB,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;YACzF,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,aAAa,IAAI,CAAC,uBAAuB,wBAAwB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3H,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IAC1B,CAAC;IAED,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAEM,QAAQ;QACX,OAAO,aAAa,IAAI,CAAC,KAAK,GAAG,CAAC;IACtC,CAAC;IAED,IAAW,QAAQ,CAAC,QAAiB;QACjC,IAAI,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC1B,IAAI,CAAC,kBAAkB,GAAG,QAAQ,CAAC;QACvC,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,KAAK,4BAA4B,CAAC,CAAC;QACxE,CAAC;IACL,CAAC;CACJ;AAED,kBAAe,QAAQ,CAAC"}

package/dist/parsing/functions/function_factory.js

@@ -0,0 +1,259 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const sum_1 = __importDefault(require("./sum"));
+const collect_1 = __importDefault(require("./collect"));
+const avg_1 = __importDefault(require("./avg"));
+const range_1 = __importDefault(require("./range"));
+const rand_1 = __importDefault(require("./rand"));
+const round_1 = __importDefault(require("./round"));
+const split_1 = __importDefault(require("./split"));
+const join_1 = __importDefault(require("./join"));
+const to_json_1 = __importDefault(require("./to_json"));
+const replace_1 = __importDefault(require("./replace"));
+const stringify_1 = __importDefault(require("./stringify"));
+const size_1 = __importDefault(require("./size"));
+const functions_1 = __importDefault(require("./functions"));
+const function_1 = __importDefault(require("./function"));
+const function_metadata_1 = require("./function_metadata");
+/**
+ * Factory for creating function instances by name.
+ *
+ * Maps function names (case-insensitive) to their corresponding implementation classes.
+ * Supports built-in functions like sum, avg, collect, range, split, join, etc.
+ *
+ * @example
+ * ```typescript
+ * const sumFunc = FunctionFactory.create("sum");
+ * const avgFunc = FunctionFactory.create("AVG");
+ * ```
+ */
+class FunctionFactory {
+    /**
+     * Registers a synchronous plugin function.
+     *
+     * @param name - The function name (will be lowercased)
+     * @param factoryOrOptions - Factory function or options object with metadata
+     */
+    static register(name, factoryOrOptions) {
+        const lowerName = name.toLowerCase();
+        if (typeof factoryOrOptions === 'function') {
+            FunctionFactory.plugins.set(lowerName, factoryOrOptions);
+        }
+        else {
+            FunctionFactory.plugins.set(lowerName, factoryOrOptions.factory);
+            FunctionFactory.metadata.set(lowerName, Object.assign(Object.assign({}, factoryOrOptions.metadata), { name: lowerName, isAsyncProvider: false }));
+        }
+    }
+    /**
+     * Unregisters a synchronous plugin function.
+     *
+     * @param name - The function name to unregister
+     */
+    static unregister(name) {
+        const lowerName = name.toLowerCase();
+        FunctionFactory.plugins.delete(lowerName);
+        FunctionFactory.metadata.delete(lowerName);
+    }
+    /**
+     * Registers an async data provider function for use in LOAD operations.
+     *
+     * @param name - The function name (will be lowercased)
+     * @param providerOrOptions - Async provider or options object with metadata
+     *
+     * @example
+     * ```typescript
+     * // Register with metadata for LLM consumption
+     * FunctionFactory.registerAsyncProvider("fetchUsers", {
+     *     provider: async function* (endpoint: string) {
+     *         const response = await fetch(endpoint);
+     *         const data = await response.json();
+     *         for (const item of data) {
+     *             yield item;
+     *         }
+     *     },
+     *     metadata: {
+     *         name: "fetchUsers",
+     *         description: "Fetches user data from an API endpoint",
+     *         parameters: [
+     *             { name: "endpoint", description: "API endpoint URL", type: "string" }
+     *         ],
+     *         output: {
+     *             description: "User objects",
+     *             type: "object",
+     *             properties: {
+     *                 id: { description: "User ID", type: "number" },
+     *                 name: { description: "User name", type: "string" }
+     *             }
+     *         },
+     *         examples: ["LOAD JSON FROM fetchUsers('https://api.example.com/users') AS user"]
+     *     }
+     * });
+     * ```
+     */
+    static registerAsyncProvider(name, providerOrOptions) {
+        const lowerName = name.toLowerCase();
+        if (typeof providerOrOptions === 'function') {
+            FunctionFactory.asyncProviders.set(lowerName, providerOrOptions);
+        }
+        else {
+            FunctionFactory.asyncProviders.set(lowerName, providerOrOptions.provider);
+            FunctionFactory.metadata.set(lowerName, Object.assign(Object.assign({}, providerOrOptions.metadata), { name: lowerName, isAsyncProvider: true }));
+        }
+    }
+    /**
+     * Unregisters an async data provider function.
+     *
+     * @param name - The function name to unregister
+     */
+    static unregisterAsyncProvider(name) {
+        const lowerName = name.toLowerCase();
+        FunctionFactory.asyncProviders.delete(lowerName);
+        FunctionFactory.metadata.delete(lowerName);
+    }
+    /**
+     * Gets an async data provider by name.
+     *
+     * @param name - The function name (case-insensitive)
+     * @returns The async data provider, or undefined if not found
+     */
+    static getAsyncProvider(name) {
+        return FunctionFactory.asyncProviders.get(name.toLowerCase());
+    }
+    /**
+     * Checks if a function name is registered as an async data provider.
+     *
+     * @param name - The function name (case-insensitive)
+     * @returns True if the function is an async data provider
+     */
+    static isAsyncProvider(name) {
+        return FunctionFactory.asyncProviders.has(name.toLowerCase());
+    }
+    /**
+     * Gets metadata for a specific function.
+     *
+     * @param name - The function name (case-insensitive)
+     * @returns The function metadata, or undefined if not found
+     */
+    static getMetadata(name) {
+        const lowerName = name.toLowerCase();
+        // Check plugin metadata first
+        if (FunctionFactory.metadata.has(lowerName)) {
+            return FunctionFactory.metadata.get(lowerName);
+        }
+        // Fall back to built-in metadata
+        return function_metadata_1.BUILTIN_FUNCTION_METADATA.find(m => m.name === lowerName);
+    }
+    /**
+     * Lists all registered functions with their metadata.
+     * Includes both built-in and plugin functions.
+     *
+     * @param options - Optional filter options
+     * @returns Array of function metadata
+     */
+    static listFunctions(options) {
+        const result = [];
+        const includeBuiltins = (options === null || options === void 0 ? void 0 : options.includeBuiltins) !== false;
+        // Add built-in functions
+        if (includeBuiltins) {
+            for (const meta of function_metadata_1.BUILTIN_FUNCTION_METADATA) {
+                if ((options === null || options === void 0 ? void 0 : options.category) && meta.category !== options.category)
+                    continue;
+                if (options === null || options === void 0 ? void 0 : options.asyncOnly)
+                    continue; // Built-ins are sync
+                result.push(meta);
+            }
+        }
+        // Add plugin functions
+        for (const [name, meta] of FunctionFactory.metadata) {
+            if ((options === null || options === void 0 ? void 0 : options.category) && meta.category !== options.category)
+                continue;
+            if ((options === null || options === void 0 ? void 0 : options.asyncOnly) && !meta.isAsyncProvider)
+                continue;
+            if ((options === null || options === void 0 ? void 0 : options.syncOnly) && meta.isAsyncProvider)
+                continue;
+            result.push(meta);
+        }
+        return result;
+    }
+    /**
+     * Lists all registered function names.
+     *
+     * @returns Array of function names
+     */
+    static listFunctionNames() {
+        const builtinNames = function_metadata_1.BUILTIN_FUNCTION_METADATA.map(m => m.name);
+        const pluginNames = Array.from(FunctionFactory.plugins.keys());
+        const asyncNames = Array.from(FunctionFactory.asyncProviders.keys());
+        return [...new Set([...builtinNames, ...pluginNames, ...asyncNames])];
+    }
+    /**
+     * Gets all function metadata as a JSON-serializable object for LLM consumption.
+     *
+     * @returns Object with functions grouped by category
+     */
+    static toJSON() {
+        const functions = FunctionFactory.listFunctions();
+        const categories = [...new Set(functions.map(f => f.category).filter(Boolean))];
+        return { functions, categories };
+    }
+    /**
+     * Creates a function instance by name.
+     *
+     * @param name - The function name (case-insensitive)
+     * @returns A Function instance of the appropriate type
+     */
+    static create(name) {
+        const lowerName = name.toLowerCase();
+        // Check plugin registry first (allows overriding built-ins)
+        if (FunctionFactory.plugins.has(lowerName)) {
+            return FunctionFactory.plugins.get(lowerName)();
+        }
+        switch (lowerName) {
+            case "sum":
+                return new sum_1.default();
+            case "collect":
+                return new collect_1.default();
+            case "avg":
+                return new avg_1.default();
+            case "range":
+                return new range_1.default();
+            case "rand":
+                return new rand_1.default();
+            case "round":
+                return new round_1.default();
+            case "split":
+                return new split_1.default();
+            case "join":
+                return new join_1.default();
+            case "tojson":
+                return new to_json_1.default();
+            case "replace":
+                return new replace_1.default();
+            case "stringify":
+                return new stringify_1.default();
+            case "size":
+                return new size_1.default();
+            case "functions":
+                return new functions_1.default();
+            default:
+                return new function_1.default(name);
+        }
+    }
+}
+/**
+ * Registry for plugin functions (synchronous).
+ */
+FunctionFactory.plugins = new Map();
+/**
+ * Registry for async data provider functions used in LOAD operations.
+ */
+FunctionFactory.asyncProviders = new Map();
+/**
+ * Registry for function metadata (both sync and async).
+ */
+FunctionFactory.metadata = new Map();
+exports.default = FunctionFactory;
+//# sourceMappingURL=function_factory.js.map

package/dist/parsing/functions/function_factory.js.map

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