flowquery 1.0.3 → 1.0.5

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

@@ -0,0 +1,53 @@
+import ASTNode from "../ast_node";
+import AggregateFunction from "../functions/aggregate_function";
+/**
+ * Represents an expression in the FlowQuery AST.
+ *
+ * Expressions are built using the Shunting Yard algorithm to handle operator
+ * precedence and associativity. They can contain operands (numbers, strings, identifiers)
+ * and operators (arithmetic, logical, comparison).
+ *
+ * @example
+ * ```typescript
+ * const expr = new Expression();
+ * expr.addNode(numberNode);
+ * expr.addNode(plusOperator);
+ * expr.addNode(anotherNumberNode);
+ * expr.finish();
+ * ```
+ */
+declare class Expression extends ASTNode {
+    private operators;
+    private output;
+    private _alias;
+    private _overridden;
+    private _reducers;
+    /**
+     * Adds a node (operand or operator) to the expression.
+     *
+     * Uses the Shunting Yard algorithm to maintain correct operator precedence.
+     *
+     * @param node - The AST node to add (operand or operator)
+     */
+    addNode(node: ASTNode): void;
+    /**
+     * Finalizes the expression by converting it to a tree structure.
+     *
+     * Should be called after all nodes have been added.
+     */
+    finish(): void;
+    private toTree;
+    nodesAdded(): boolean;
+    value(): any;
+    setAlias(alias: string): void;
+    set alias(alias: string);
+    get alias(): string | null;
+    toString(): string;
+    reducers(): AggregateFunction[];
+    private _extract_reducers;
+    mappable(): boolean;
+    has_reducers(): boolean;
+    set overridden(value: any);
+}
+export default Expression;
+//# sourceMappingURL=expression.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expression.d.ts","sourceRoot":"","sources":["../../../src/parsing/expressions/expression.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,iBAAiB,MAAM,iCAAiC,CAAC;AAGhE;;;;;;;;;;;;;;;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,CAAoB;IACvC,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;IAMtC,OAAO,CAAE,iBAAiB;IAQnB,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/f_string.d.ts

@@ -0,0 +1,21 @@
+import ASTNode from "../ast_node";
+/**
+ * Represents a formatted string (f-string) in the AST.
+ *
+ * F-strings allow embedding expressions within string literals.
+ * Child nodes represent the parts of the f-string (literal strings and expressions).
+ *
+ * @example
+ * ```typescript
+ * // For f"Hello {name}!"
+ * const fstr = new FString();
+ * fstr.addChild(new String("Hello "));
+ * fstr.addChild(nameExpression);
+ * fstr.addChild(new String("!"));
+ * ```
+ */
+declare class FString extends ASTNode {
+    value(): string;
+}
+export default FString;
+//# sourceMappingURL=f_string.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"f_string.d.ts","sourceRoot":"","sources":["../../../src/parsing/expressions/f_string.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAGlC;;;;;;;;;;;;;;GAcG;AACH,cAAM,OAAQ,SAAQ,OAAO;IAClB,KAAK,IAAI,MAAM;CAIzB;AAED,eAAe,OAAO,CAAC"}

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

@@ -0,0 +1,17 @@
+import String from "./string";
+/**
+ * Represents an identifier in the AST.
+ *
+ * Identifiers are used for variable names, property names, and similar constructs.
+ *
+ * @example
+ * ```typescript
+ * const id = new Identifier("myVariable");
+ * ```
+ */
+declare class Identifier extends String {
+    toString(): string;
+    value(): any;
+}
+export default Identifier;
+//# sourceMappingURL=identifier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.d.ts","sourceRoot":"","sources":["../../../src/parsing/expressions/identifier.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,UAAU,CAAC;AAE9B;;;;;;;;;GASG;AACH,cAAM,UAAW,SAAQ,MAAM;IACpB,QAAQ,IAAI,MAAM;IAGlB,KAAK,IAAI,GAAG;CAGtB;AAED,eAAe,UAAU,CAAC"}

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

@@ -0,0 +1,25 @@
+import ASTNode from "../ast_node";
+/**
+ * Represents a numeric literal in the AST.
+ *
+ * Parses string representations of numbers into integer or float values.
+ *
+ * @example
+ * ```typescript
+ * const num = new Number("42");
+ * console.log(num.value()); // 42
+ * ```
+ */
+declare class Number extends ASTNode {
+    private _value;
+    /**
+     * Creates a new Number node by parsing the string value.
+     *
+     * @param value - The string representation of the number
+     */
+    constructor(value: string);
+    value(): number;
+    protected toString(): string;
+}
+export default Number;
+//# sourceMappingURL=number.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../src/parsing/expressions/number.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAElC;;;;;;;;;;GAUG;AACH,cAAM,MAAO,SAAQ,OAAO;IACxB,OAAO,CAAC,MAAM,CAAS;IAEvB;;;;OAIG;gBACS,KAAK,EAAE,MAAM;IASlB,KAAK,IAAI,MAAM;IAItB,SAAS,CAAC,QAAQ,IAAI,MAAM;CAG/B;AAED,eAAe,MAAM,CAAC"}

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

@@ -0,0 +1,79 @@
+import ASTNode from "../ast_node";
+declare abstract class Operator extends ASTNode {
+    private _precedence;
+    private _leftAssociative;
+    constructor(precedence: number, leftAssociative: boolean);
+    isOperator(): boolean;
+    get precedence(): number;
+    get leftAssociative(): boolean;
+    abstract value(): number;
+    get lhs(): ASTNode;
+    get rhs(): ASTNode;
+}
+declare class Add extends Operator {
+    constructor();
+    value(): number;
+}
+declare class Subtract extends Operator {
+    constructor();
+    value(): number;
+}
+declare class Multiply extends Operator {
+    constructor();
+    value(): number;
+}
+declare class Divide extends Operator {
+    constructor();
+    value(): number;
+}
+declare class Modulo extends Operator {
+    constructor();
+    value(): number;
+}
+declare class Power extends Operator {
+    constructor();
+    value(): number;
+}
+declare class Equals extends Operator {
+    constructor();
+    value(): number;
+}
+declare class NotEquals extends Operator {
+    constructor();
+    value(): number;
+}
+declare class GreaterThan extends Operator {
+    constructor();
+    value(): number;
+}
+declare class LessThan extends Operator {
+    constructor();
+    value(): number;
+}
+declare class GreaterThanOrEqual extends Operator {
+    constructor();
+    value(): number;
+}
+declare class LessThanOrEqual extends Operator {
+    constructor();
+    value(): number;
+}
+declare class And extends Operator {
+    constructor();
+    value(): number;
+}
+declare class Or extends Operator {
+    constructor();
+    value(): number;
+}
+declare class Not extends Operator {
+    constructor();
+    isOperator(): boolean;
+    value(): number;
+}
+declare class Is extends Operator {
+    constructor();
+    value(): number;
+}
+export { Operator, Add, Subtract, Multiply, Divide, Modulo, Power, Equals, NotEquals, GreaterThan, LessThan, GreaterThanOrEqual, LessThanOrEqual, And, Or, Not, Is };
+//# sourceMappingURL=operator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operator.d.ts","sourceRoot":"","sources":["../../../src/parsing/expressions/operator.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAElC,uBAAe,QAAS,SAAQ,OAAO;IACnC,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,gBAAgB,CAAiB;gBAE7B,UAAU,EAAE,MAAM,EAAE,eAAe,EAAE,OAAO;IAMjD,UAAU,IAAI,OAAO;IAI5B,IAAW,UAAU,IAAI,MAAM,CAE9B;IACD,IAAW,eAAe,IAAI,OAAO,CAEpC;aACe,KAAK,IAAI,MAAM;IAC/B,IAAW,GAAG,IAAI,OAAO,CAExB;IACD,IAAW,GAAG,IAAI,OAAO,CAExB;CACJ;AAED,cAAM,GAAI,SAAQ,QAAQ;;IAIf,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,QAAS,SAAQ,QAAQ;;IAIpB,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,QAAS,SAAQ,QAAQ;;IAIpB,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,MAAO,SAAQ,QAAQ;;IAIlB,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,MAAO,SAAQ,QAAQ;;IAIlB,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,KAAM,SAAQ,QAAQ;;IAIjB,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,MAAO,SAAQ,QAAQ;;IAIlB,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,SAAU,SAAQ,QAAQ;;IAIrB,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,WAAY,SAAQ,QAAQ;;IAIvB,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,QAAS,SAAQ,QAAQ;;IAIpB,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,kBAAmB,SAAQ,QAAQ;;IAI9B,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,eAAgB,SAAQ,QAAQ;;IAI3B,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,GAAI,SAAQ,QAAQ;;IAIf,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,EAAG,SAAQ,QAAQ;;IAId,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,GAAI,SAAQ,QAAQ;;IAIf,UAAU,IAAI,OAAO;IAGrB,KAAK,IAAI,MAAM;CAGzB;AAED,cAAM,EAAG,SAAQ,QAAQ;;IAId,KAAK,IAAI,MAAM;CAGzB;AAED,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,eAAe,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC"}

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

@@ -0,0 +1,29 @@
+import ASTNode from "../ast_node";
+import Identifier from "./identifier";
+/**
+ * Represents a reference to a previously defined variable or expression.
+ *
+ * References point to values defined earlier in the query (e.g., in WITH or LOAD statements).
+ *
+ * @example
+ * ```typescript
+ * const ref = new Reference("myVar", previousNode);
+ * console.log(ref.value()); // Gets value from referred node
+ * ```
+ */
+declare class Reference extends Identifier {
+    private _referred;
+    /**
+     * Creates a new Reference to a variable.
+     *
+     * @param value - The identifier name
+     * @param referred - The node this reference points to (optional)
+     */
+    constructor(value: string, referred?: ASTNode | undefined);
+    set referred(node: ASTNode);
+    toString(): string;
+    value(): any;
+    get identifier(): string;
+}
+export default Reference;
+//# sourceMappingURL=reference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../../../src/parsing/expressions/reference.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,cAAM,SAAU,SAAQ,UAAU;IAC9B,OAAO,CAAC,SAAS,CAAkC;IAEnD;;;;;OAKG;gBACS,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAO,GAAG,SAAqB;IAIpE,IAAW,QAAQ,CAAC,IAAI,EAAE,OAAO,EAEhC;IACM,QAAQ,IAAI,MAAM;IAGlB,KAAK,IAAI,GAAG;IAGnB,IAAW,UAAU,IAAI,MAAM,CAE9B;CACJ;AAED,eAAe,SAAS,CAAC"}

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

@@ -0,0 +1,23 @@
+import ASTNode from "../ast_node";
+/**
+ * Represents a string literal in the AST.
+ *
+ * @example
+ * ```typescript
+ * const str = new String("hello");
+ * console.log(str.value()); // "hello"
+ * ```
+ */
+declare class String extends ASTNode {
+    protected _value: string;
+    /**
+     * Creates a new String node with the given value.
+     *
+     * @param value - The string value
+     */
+    constructor(value: string);
+    value(): string;
+    toString(): string;
+}
+export default String;
+//# sourceMappingURL=string.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"string.d.ts","sourceRoot":"","sources":["../../../src/parsing/expressions/string.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAElC;;;;;;;;GAQG;AACH,cAAM,MAAO,SAAQ,OAAO;IACxB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IAEzB;;;;OAIG;gBACS,KAAK,EAAE,MAAM;IAKlB,KAAK,IAAI,MAAM;IAIf,QAAQ,IAAI,MAAM;CAG5B;AAED,eAAe,MAAM,CAAC"}

package/dist/parsing/functions/aggregate_function.d.ts

@@ -0,0 +1,42 @@
+import Function from "./function";
+import ReducerElement from "./reducer_element";
+/**
+ * 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)
+ * ```
+ */
+declare class AggregateFunction extends Function {
+    private _overridden;
+    /**
+     * Creates a new AggregateFunction with the given name.
+     *
+     * @param name - The function name
+     */
+    constructor(name: string);
+    /**
+     * Processes a value during the aggregation phase.
+     *
+     * @param value - The element to aggregate
+     * @throws {Error} If not implemented by subclass
+     */
+    reduce(value: ReducerElement): void;
+    /**
+     * Creates a reducer element for this aggregate function.
+     *
+     * @returns A ReducerElement instance
+     * @throws {Error} If not implemented by subclass
+     */
+    element(): ReducerElement;
+    get overridden(): any | null;
+    set overridden(value: any | null);
+    value(): any;
+}
+export default AggregateFunction;
+//# sourceMappingURL=aggregate_function.d.ts.map

package/dist/parsing/functions/aggregate_function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate_function.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/aggregate_function.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAClC,OAAO,cAAc,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;;;GAWG;AACH,cAAM,iBAAkB,SAAQ,QAAQ;IACpC,OAAO,CAAC,WAAW,CAAoB;IAEvC;;;;OAIG;gBACS,IAAI,EAAE,MAAM;IAIxB;;;;;OAKG;IACI,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAI1C;;;;;OAKG;IACI,OAAO,IAAI,cAAc;IAGhC,IAAW,UAAU,IAAI,GAAG,GAAG,IAAI,CAElC;IACD,IAAW,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI,EAEtC;IACM,KAAK,IAAI,GAAG;CAGtB;AAED,eAAe,iBAAiB,CAAC"}

package/dist/parsing/functions/async_function.d.ts

@@ -0,0 +1,52 @@
+import ASTNode from "../ast_node";
+/**
+ * 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);
+ * }
+ * ```
+ */
+declare class AsyncFunction extends ASTNode {
+    private _name;
+    /**
+     * Creates a new AsyncFunction with the given name.
+     *
+     * @param name - The function name (must be registered as an async provider)
+     */
+    constructor(name: string);
+    /**
+     * Gets the function name.
+     */
+    get name(): string;
+    /**
+     * Sets the function parameters.
+     *
+     * @param nodes - Array of AST nodes representing the function arguments
+     */
+    set parameters(nodes: ASTNode[]);
+    /**
+     * Evaluates all parameters and returns their values.
+     *
+     * @returns Array of parameter values
+     */
+    private getArguments;
+    /**
+     * 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(): AsyncGenerator<any, void, unknown>;
+    toString(): string;
+}
+export default AsyncFunction;
+//# sourceMappingURL=async_function.d.ts.map

package/dist/parsing/functions/async_function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async_function.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/async_function.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAGlC;;;;;;;;;;;;;;;GAeG;AACH,cAAM,aAAc,SAAQ,OAAO;IAC/B,OAAO,CAAC,KAAK,CAAS;IAEtB;;;;OAIG;gBACS,IAAI,EAAE,MAAM;IAKxB;;OAEG;IACH,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;;OAIG;IACH,IAAW,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,EAErC;IAED;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;OAKG;IACW,OAAO,IAAI,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC;IA0BpD,QAAQ,IAAI,MAAM;CAG5B;AAED,eAAe,aAAa,CAAC"}

package/dist/parsing/functions/avg.d.ts

@@ -0,0 +1,15 @@
+import AggregateFunction from "./aggregate_function";
+import ReducerElement from "./reducer_element";
+declare class AvgReducerElement extends ReducerElement {
+    private _count;
+    private _sum;
+    get value(): number | null;
+    set value(value: number);
+}
+declare class Avg extends AggregateFunction {
+    constructor();
+    reduce(element: AvgReducerElement): void;
+    element(): AvgReducerElement;
+}
+export default Avg;
+//# sourceMappingURL=avg.d.ts.map

package/dist/parsing/functions/avg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"avg.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/avg.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AAErD,OAAO,cAAc,MAAM,mBAAmB,CAAC;AAE/C,cAAM,iBAAkB,SAAQ,cAAc;IAC1C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,IAAI,CAAuB;IACnC,IAAW,KAAK,IAAI,MAAM,GAAG,IAAI,CAKhC;IACD,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAO7B;CACJ;AAED,cAAM,GAAI,SAAQ,iBAAiB;;IAKxB,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAGxC,OAAO,IAAI,iBAAiB;CAGtC;AAED,eAAe,GAAG,CAAC"}

package/dist/parsing/functions/collect.d.ts

@@ -0,0 +1,21 @@
+import AggregateFunction from "./aggregate_function";
+import ReducerElement from "./reducer_element";
+declare class CollectReducerElement extends ReducerElement {
+    private _value;
+    get value(): any;
+    set value(value: any);
+}
+declare class DistinctCollectReducerElement extends ReducerElement {
+    private _value;
+    get value(): any;
+    set value(value: any);
+}
+declare class Collect extends AggregateFunction {
+    private _distinct;
+    constructor();
+    reduce(element: CollectReducerElement): void;
+    element(): CollectReducerElement | DistinctCollectReducerElement;
+    set distinct(distinct: boolean);
+}
+export default Collect;
+//# sourceMappingURL=collect.d.ts.map

package/dist/parsing/functions/collect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collect.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/collect.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AACrD,OAAO,cAAc,MAAM,mBAAmB,CAAC;AAE/C,cAAM,qBAAsB,SAAQ,cAAc;IAC9C,OAAO,CAAC,MAAM,CAAa;IAC3B,IAAW,KAAK,IAAI,GAAG,CAEtB;IACD,IAAW,KAAK,CAAC,KAAK,EAAE,GAAG,EAE1B;CACJ;AAED,cAAM,6BAA8B,SAAQ,cAAc;IACtD,OAAO,CAAC,MAAM,CAA4B;IAC1C,IAAW,KAAK,IAAI,GAAG,CAEtB;IACD,IAAW,KAAK,CAAC,KAAK,EAAE,GAAG,EAK1B;CACJ;AAED,cAAM,OAAQ,SAAQ,iBAAiB;IACnC,OAAO,CAAC,SAAS,CAAkB;;IAK5B,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAG5C,OAAO,IAAI,qBAAqB,GAAG,6BAA6B;IAGvE,IAAW,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAEpC;CACJ;AAED,eAAe,OAAO,CAAC"}

package/dist/parsing/functions/function.d.ts

@@ -0,0 +1,36 @@
+import ASTNode from "../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];
+ * ```
+ */
+declare class Function extends ASTNode {
+    protected _name: string;
+    protected _expectedParameterCount: number | null;
+    protected _supports_distinct: boolean;
+    /**
+     * Creates a new Function with the given name.
+     *
+     * @param name - The function name
+     */
+    constructor(name: string);
+    /**
+     * 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: ASTNode[]);
+    get name(): string;
+    toString(): string;
+    set distinct(distinct: boolean);
+}
+export default Function;
+//# sourceMappingURL=function.d.ts.map

package/dist/parsing/functions/function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/function.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAElC;;;;;;;;;;;GAWG;AACH,cAAM,QAAS,SAAQ,OAAO;IAC1B,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAQ;IACxD,SAAS,CAAC,kBAAkB,EAAE,OAAO,CAAS;IAE9C;;;;OAIG;gBACS,IAAI,EAAE,MAAM;IAKxB;;;;;OAKG;IACH,IAAW,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,EAKrC;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAEM,QAAQ,IAAI,MAAM;IAIzB,IAAW,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAMpC;CACJ;AAED,eAAe,QAAQ,CAAC"}

package/dist/parsing/functions/function_factory.d.ts

@@ -0,0 +1,151 @@
+import Function from "./function";
+import { FunctionMetadata, RegisterFunctionOptions, RegisterAsyncProviderOptions } from "./function_metadata";
+/**
+ * Type for synchronous function factories.
+ */
+export type FunctionCreator = () => Function;
+/**
+ * Type for async data provider functions used in LOAD operations.
+ * These functions can yield data asynchronously.
+ */
+export type AsyncDataProvider = (...args: any[]) => AsyncGenerator<any, void, unknown> | Promise<any>;
+/**
+ * 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");
+ * ```
+ */
+declare class FunctionFactory {
+    /**
+     * Registry for plugin functions (synchronous).
+     */
+    private static plugins;
+    /**
+     * Registry for async data provider functions used in LOAD operations.
+     */
+    private static asyncProviders;
+    /**
+     * Registry for function metadata (both sync and async).
+     */
+    private static metadata;
+    /**
+     * 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: string, factoryOrOptions: FunctionCreator | RegisterFunctionOptions): void;
+    /**
+     * Unregisters a synchronous plugin function.
+     *
+     * @param name - The function name to unregister
+     */
+    static unregister(name: string): void;
+    /**
+     * 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: string, providerOrOptions: AsyncDataProvider | RegisterAsyncProviderOptions): void;
+    /**
+     * Unregisters an async data provider function.
+     *
+     * @param name - The function name to unregister
+     */
+    static unregisterAsyncProvider(name: string): void;
+    /**
+     * 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: string): AsyncDataProvider | undefined;
+    /**
+     * 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: string): boolean;
+    /**
+     * 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: string): FunctionMetadata | undefined;
+    /**
+     * 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?: {
+        category?: string;
+        includeBuiltins?: boolean;
+        asyncOnly?: boolean;
+        syncOnly?: boolean;
+    }): FunctionMetadata[];
+    /**
+     * Lists all registered function names.
+     *
+     * @returns Array of function names
+     */
+    static listFunctionNames(): string[];
+    /**
+     * Gets all function metadata as a JSON-serializable object for LLM consumption.
+     *
+     * @returns Object with functions grouped by category
+     */
+    static toJSON(): {
+        functions: FunctionMetadata[];
+        categories: string[];
+    };
+    /**
+     * Creates a function instance by name.
+     *
+     * @param name - The function name (case-insensitive)
+     * @returns A Function instance of the appropriate type
+     */
+    static create(name: string): Function;
+}
+export default FunctionFactory;
+//# sourceMappingURL=function_factory.d.ts.map

package/dist/parsing/functions/function_factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"function_factory.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/function_factory.ts"],"names":[],"mappings":"AAaA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAClC,OAAO,EACH,gBAAgB,EAChB,uBAAuB,EACvB,4BAA4B,EAE/B,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,QAAQ,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;AAEtG;;;;;;;;;;;GAWG;AACH,cAAM,eAAe;IACjB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,OAAO,CAA2C;IAEjE;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc,CAA6C;IAE1E;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA4C;IAEnE;;;;;OAKG;WACW,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe,GAAG,uBAAuB,GAAG,IAAI;IAcvG;;;;OAIG;WACW,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAM5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;WACW,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,4BAA4B,GAAG,IAAI;IAc5H;;;;OAIG;WACW,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMzD;;;;;OAKG;WACW,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAI3E;;;;;OAKG;WACW,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpD;;;;;OAKG;WACW,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAUrE;;;;;;OAMG;WACW,aAAa,CAAC,OAAO,CAAC,EAAE;QAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,gBAAgB,EAAE;IAwBtB;;;;OAIG;WACW,iBAAiB,IAAI,MAAM,EAAE;IAO3C;;;;OAIG;WACW,MAAM,IAAI;QAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE;IAM/E;;;;;OAKG;WACW,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ;CAuC/C;AAED,eAAe,eAAe,CAAC"}