flowquery 1.0.5 → 1.0.7

package/dist/index.node.js

@@ -17,86 +17,6 @@ const function_factory_1 = __importDefault(require("./parsing/functions/function
 exports.FunctionFactory = function_factory_1.default;
 const function_1 = __importDefault(require("./parsing/functions/function"));
 exports.Function = function_1.default;
-/**
- * Register a synchronous plugin function.
- *
- * @param name - The function name
- * @param factoryOrOptions - Factory function or options object with metadata
- *
- * @example
- * ```javascript
- * // Simple registration
- * FlowQuery.registerFunction("uppercase", () => new MyUpperCaseFunction());
- *
- * // Registration with metadata for LLM consumption
- * FlowQuery.registerFunction("uppercase", {
- *     factory: () => new MyUpperCaseFunction(),
- *     metadata: {
- *         name: "uppercase",
- *         description: "Converts a string to uppercase",
- *         category: "string",
- *         parameters: [{ name: "text", description: "String to convert", type: "string" }],
- *         output: { description: "Uppercase string", type: "string" },
- *         examples: ["WITH 'hello' AS s RETURN uppercase(s)"]
- *     }
- * });
- * ```
- */
-runner_1.default.registerFunction = function (name, factoryOrOptions) {
-    function_factory_1.default.register(name, factoryOrOptions);
-};
-/**
- * Unregister a synchronous plugin function.
- *
- * @param name - The function name
- */
-runner_1.default.unregisterFunction = function (name) {
-    function_factory_1.default.unregister(name);
-};
-/**
- * Register an async data provider function for use in LOAD operations.
- *
- * @param name - The function name
- * @param providerOrOptions - Async provider or options object with metadata
- *
- * @example
- * ```javascript
- * // Registration with metadata for LLM consumption
- * FlowQuery.registerAsyncProvider("fetchUsers", {
- *     provider: async function* (endpoint) {
- *         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",
- *         category: "data",
- *         parameters: [{ name: "endpoint", description: "API URL", type: "string" }],
- *         output: {
- *             description: "User object",
- *             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"]
- *     }
- * });
- * ```
- */
-runner_1.default.registerAsyncProvider = function (name, providerOrOptions) {
-    function_factory_1.default.registerAsyncProvider(name, providerOrOptions);
-};
-/**
- * Unregister an async data provider function.
- *
- * @param name - The function name
- */
-runner_1.default.unregisterAsyncProvider = function (name) {
-    function_factory_1.default.unregisterAsyncProvider(name);
-};
 /**
  * List all registered functions with their metadata.
  *

package/dist/index.node.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.node.js","sourceRoot":"","sources":["../src/index.node.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;AAEH,8DAAsD;AA0HlD,0FA1He,gBAAS,OA0Hf;AAzHb,4FAA2G;AA2HvG,0BA3HG,0BAAe,CA2HH;AAnHnB,4EAAoD;AAkHhD,mBAlHG,kBAAQ,CAkHH;AAhHZ;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,gBAAS,CAAC,gBAAgB,GAAG,UAAS,IAAY,EAAE,gBAA2D;IAC3G,0BAAe,CAAC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC;AACrD,CAAC,CAAC;AAEF;;;;GAIG;AACH,gBAAS,CAAC,kBAAkB,GAAG,UAAS,IAAY;IAChD,0BAAe,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,gBAAS,CAAC,qBAAqB,GAAG,UAAS,IAAY,EAAE,iBAAmE;IACxH,0BAAe,CAAC,qBAAqB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;AACnE,CAAC,CAAC;AAEF;;;;GAIG;AACH,gBAAS,CAAC,uBAAuB,GAAG,UAAS,IAAY;IACrD,0BAAe,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,gBAAS,CAAC,aAAa,GAAG,UAAS,OAAwE;IACvG,OAAO,0BAAe,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,gBAAS,CAAC,mBAAmB,GAAG,UAAS,IAAY;IACjD,OAAO,0BAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF;;GAEG;AACH,gBAAS,CAAC,QAAQ,GAAG,kBAAQ,CAAC;AAE9B,kBAAe,gBAAS,CAAC"}
+{"version":3,"file":"index.node.js","sourceRoot":"","sources":["../src/index.node.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;AAEH,8DAAsD;AAoClD,0FApCe,gBAAS,OAoCf;AAnCb,4FAA0F;AAqCtF,0BArCG,0BAAe,CAqCH;AA/BnB,4EAAoD;AA8BhD,mBA9BG,kBAAQ,CA8BH;AA5BZ;;;;;GAKG;AACH,gBAAS,CAAC,aAAa,GAAG,UAAS,OAAwE;IACvG,OAAO,0BAAe,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,gBAAS,CAAC,mBAAmB,GAAG,UAAS,IAAY;IACjD,OAAO,0BAAe,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF;;GAEG;AACH,gBAAS,CAAC,QAAQ,GAAG,kBAAQ,CAAC;AAE9B,kBAAe,gBAAS,CAAC"}

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

@@ -1 +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"}
+{"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;AAG/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,cASM,GAAI,SAAQ,iBAAiB;;IAKxB,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAGxC,OAAO,IAAI,iBAAiB;CAGtC;AAED,eAAe,GAAG,CAAC"}

package/dist/parsing/functions/avg.js

@@ -1,10 +1,17 @@
 "use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
 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"));
+const function_metadata_1 = require("./function_metadata");
 class AvgReducerElement extends reducer_element_1.default {
     constructor() {
         super(...arguments);
@@ -27,7 +34,7 @@ class AvgReducerElement extends reducer_element_1.default {
         }
     }
 }
-class Avg extends aggregate_function_1.default {
+let Avg = class Avg extends aggregate_function_1.default {
     constructor() {
         super("avg");
         this._expectedParameterCount = 1;
@@ -38,6 +45,17 @@ class Avg extends aggregate_function_1.default {
     element() {
         return new AvgReducerElement();
     }
-}
+};
+Avg = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Calculates the average of numeric values across grouped rows",
+        category: "aggregate",
+        parameters: [
+            { name: "value", description: "Numeric value to average", type: "number" }
+        ],
+        output: { description: "Average of all values", type: "number", example: 50 },
+        examples: ["WITH [10, 20, 30] AS nums UNWIND nums AS n RETURN avg(n)"]
+    })
+], Avg);
 exports.default = Avg;
 //# sourceMappingURL=avg.js.map

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

@@ -1 +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"}
+{"version":3,"file":"avg.js","sourceRoot":"","sources":["../../../src/parsing/functions/avg.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,8EAAqD;AAErD,wEAA+C;AAC/C,2DAAkD;AAElD,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;AAWD,IAAM,GAAG,GAAT,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,CAAA;AAXK,GAAG;IATR,IAAA,+BAAW,EAAC;QACT,WAAW,EAAE,8DAA8D;QAC3E,QAAQ,EAAE,WAAW;QACrB,UAAU,EAAE;YACR,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC7E;QACD,MAAM,EAAE,EAAE,WAAW,EAAE,uBAAuB,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE;QAC7E,QAAQ,EAAE,CAAC,0DAA0D,CAAC;KACzE,CAAC;GACI,GAAG,CAWR;AAED,kBAAe,GAAG,CAAC"}

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

@@ -1 +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"}
+{"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;AAG/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,cASM,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/collect.js

@@ -1,10 +1,17 @@
 "use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
 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"));
+const function_metadata_1 = require("./function_metadata");
 class CollectReducerElement extends reducer_element_1.default {
     constructor() {
         super(...arguments);
@@ -32,7 +39,7 @@ class DistinctCollectReducerElement extends reducer_element_1.default {
         }
     }
 }
-class Collect extends aggregate_function_1.default {
+let Collect = class Collect extends aggregate_function_1.default {
     constructor() {
         super("collect");
         this._distinct = false;
@@ -47,6 +54,17 @@ class Collect extends aggregate_function_1.default {
     set distinct(distinct) {
         this._distinct = distinct;
     }
-}
+};
+Collect = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Collects values into an array across grouped rows",
+        category: "aggregate",
+        parameters: [
+            { name: "value", description: "Value to collect", type: "any" }
+        ],
+        output: { description: "Array of collected values", type: "array", example: [1, 2, 3] },
+        examples: ["WITH [1, 2, 3] AS nums UNWIND nums AS n RETURN collect(n)"]
+    })
+], Collect);
 exports.default = Collect;
 //# sourceMappingURL=collect.js.map

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

@@ -1 +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"}
+{"version":3,"file":"collect.js","sourceRoot":"","sources":["../../../src/parsing/functions/collect.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,8EAAqD;AACrD,wEAA+C;AAC/C,2DAAkD;AAElD,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;AAWD,IAAM,OAAO,GAAb,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,CAAA;AAfK,OAAO;IATZ,IAAA,+BAAW,EAAC;QACT,WAAW,EAAE,mDAAmD;QAChE,QAAQ,EAAE,WAAW;QACrB,UAAU,EAAE;YACR,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,IAAI,EAAE,KAAK,EAAE;SAClE;QACD,MAAM,EAAE,EAAE,WAAW,EAAE,2BAA2B,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;QACvF,QAAQ,EAAE,CAAC,2DAA2D,CAAC;KAC1E,CAAC;GACI,OAAO,CAeZ;AAED,kBAAe,OAAO,CAAC"}

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

@@ -1,17 +1,25 @@
 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>;
+import PredicateFunction from "./predicate_function";
+import "./sum";
+import "./collect";
+import "./avg";
+import "./range";
+import "./rand";
+import "./round";
+import "./split";
+import "./join";
+import "./to_json";
+import "./replace";
+import "./stringify";
+import "./size";
+import "./functions";
+import "./predicate_sum";
+import { FunctionMetadata, AsyncDataProvider } from "./function_metadata";
+export { AsyncDataProvider };
 /**
  * Factory for creating function instances by name.
  *
+ * All functions are registered via the @FunctionDef decorator.
  * Maps function names (case-insensitive) to their corresponding implementation classes.
  * Supports built-in functions like sum, avg, collect, range, split, join, etc.
  *
@@ -22,74 +30,6 @@ export type AsyncDataProvider = (...args: any[]) => AsyncGenerator<any, void, un
  * ```
  */
 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.
      *
@@ -113,14 +53,12 @@ declare class FunctionFactory {
     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[];
@@ -146,6 +84,14 @@ declare class FunctionFactory {
      * @returns A Function instance of the appropriate type
      */
     static create(name: string): Function;
+    /**
+     * Creates a predicate function instance by name.
+     * Predicate functions are used in WHERE clauses with quantifiers (e.g., ANY, ALL).
+     *
+     * @param name - The function name (case-insensitive)
+     * @returns A PredicateFunction instance of the appropriate type
+     */
+    static createPredicate(name: string): PredicateFunction;
 }
 export default FunctionFactory;
 //# sourceMappingURL=function_factory.d.ts.map

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

@@ -1 +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"}
+{"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,iBAAiB,MAAM,sBAAsB,CAAC;AAErD,OAAO,OAAO,CAAC;AACf,OAAO,WAAW,CAAC;AACnB,OAAO,OAAO,CAAC;AACf,OAAO,SAAS,CAAC;AACjB,OAAO,QAAQ,CAAC;AAChB,OAAO,SAAS,CAAC;AACjB,OAAO,SAAS,CAAC;AACjB,OAAO,QAAQ,CAAC;AAChB,OAAO,WAAW,CAAC;AACnB,OAAO,WAAW,CAAC;AACnB,OAAO,aAAa,CAAC;AACrB,OAAO,QAAQ,CAAC;AAChB,OAAO,aAAa,CAAC;AACrB,OAAO,iBAAiB,CAAC;AACzB,OAAO,EACH,gBAAgB,EAKhB,iBAAiB,EACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,CAAC;AAE7B;;;;;;;;;;;;GAYG;AACH,cAAM,eAAe;IACjB;;;;;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;IAIrE;;;;;OAKG;WACW,aAAa,CAAC,OAAO,CAAC,EAAE;QAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACtB,GAAG,gBAAgB,EAAE;IAatB;;;;OAIG;WACW,iBAAiB,IAAI,MAAM,EAAE;IAI3C;;;;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;IAa5C;;;;;;OAMG;WACW,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;CAYjE;AAED,eAAe,eAAe,CAAC"}

package/dist/parsing/functions/function_factory.js

@@ -3,24 +3,28 @@ 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 predicate_function_1 = __importDefault(require("./predicate_function"));
+// Import built-in functions to ensure their @FunctionDef decorators run
+require("./sum");
+require("./collect");
+require("./avg");
+require("./range");
+require("./rand");
+require("./round");
+require("./split");
+require("./join");
+require("./to_json");
+require("./replace");
+require("./stringify");
+require("./size");
+require("./functions");
+require("./predicate_sum");
 const function_metadata_1 = require("./function_metadata");
 /**
  * Factory for creating function instances by name.
  *
+ * All functions are registered via the @FunctionDef decorator.
  * Maps function names (case-insensitive) to their corresponding implementation classes.
  * Supports built-in functions like sum, avg, collect, range, split, join, etc.
  *
@@ -31,88 +35,6 @@ const function_metadata_1 = require("./function_metadata");
  * ```
  */
 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.
      *
@@ -120,7 +42,7 @@ class FunctionFactory {
      * @returns The async data provider, or undefined if not found
      */
     static getAsyncProvider(name) {
-        return FunctionFactory.asyncProviders.get(name.toLowerCase());
+        return (0, function_metadata_1.getRegisteredAsyncProvider)(name.toLowerCase());
     }
     /**
      * Checks if a function name is registered as an async data provider.
@@ -129,7 +51,7 @@ class FunctionFactory {
      * @returns True if the function is an async data provider
      */
     static isAsyncProvider(name) {
-        return FunctionFactory.asyncProviders.has(name.toLowerCase());
+        return (0, function_metadata_1.getRegisteredAsyncProvider)(name.toLowerCase()) !== undefined;
     }
     /**
      * Gets metadata for a specific function.
@@ -138,41 +60,22 @@ class FunctionFactory {
      * @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);
+        return (0, function_metadata_1.getFunctionMetadata)(name.toLowerCase());
     }
     /**
      * 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) {
+        for (const meta of (0, function_metadata_1.getRegisteredFunctionMetadata)()) {
             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)
+            if ((options === null || options === void 0 ? void 0 : options.asyncOnly) && meta.category !== 'async')
                 continue;
-            if ((options === null || options === void 0 ? void 0 : options.syncOnly) && meta.isAsyncProvider)
+            if ((options === null || options === void 0 ? void 0 : options.syncOnly) && meta.category === 'async')
                 continue;
             result.push(meta);
         }
@@ -184,10 +87,7 @@ class FunctionFactory {
      * @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])];
+        return (0, function_metadata_1.getRegisteredFunctionMetadata)().map(m => m.name);
     }
     /**
      * Gets all function metadata as a JSON-serializable object for LLM consumption.
@@ -207,53 +107,31 @@ class FunctionFactory {
      */
     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)();
+        // Check decorator-registered functions (built-ins use @FunctionDef)
+        const decoratorFactory = (0, function_metadata_1.getRegisteredFunctionFactory)(lowerName);
+        if (decoratorFactory) {
+            return decoratorFactory();
         }
-        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);
+        // Unknown function - return generic Function instance
+        return new function_1.default(name);
+    }
+    /**
+     * Creates a predicate function instance by name.
+     * Predicate functions are used in WHERE clauses with quantifiers (e.g., ANY, ALL).
+     *
+     * @param name - The function name (case-insensitive)
+     * @returns A PredicateFunction instance of the appropriate type
+     */
+    static createPredicate(name) {
+        const lowerName = name.toLowerCase();
+        // Check decorator-registered predicate functions
+        const decoratorFactory = (0, function_metadata_1.getRegisteredFunctionFactory)(lowerName, 'predicate');
+        if (decoratorFactory) {
+            return decoratorFactory();
         }
+        // Unknown predicate function - return generic PredicateFunction instance
+        return new predicate_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