flowquery 1.0.5 → 1.0.6

package/dist/parsing/functions/function_metadata.js

@@ -1,159 +1,109 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BUILTIN_FUNCTION_METADATA = void 0;
+exports.FunctionDef = FunctionDef;
+exports.getRegisteredFunctionMetadata = getRegisteredFunctionMetadata;
+exports.getRegisteredFunctionFactory = getRegisteredFunctionFactory;
+exports.getFunctionMetadata = getFunctionMetadata;
 /**
- * Built-in function metadata definitions.
+ * Registry for function metadata collected via decorators.
  */
-exports.BUILTIN_FUNCTION_METADATA = [
-    {
-        name: "sum",
-        description: "Calculates the sum of numeric values across grouped rows",
-        category: "aggregation",
-        parameters: [
-            { name: "value", description: "Numeric value to sum", type: "number" }
-        ],
-        output: { description: "Sum of all values", type: "number", example: 150 },
-        examples: ["WITH [1, 2, 3] AS nums UNWIND nums AS n RETURN sum(n)"]
-    },
-    {
-        name: "avg",
-        description: "Calculates the average of numeric values across grouped rows",
-        category: "aggregation",
-        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)"]
-    },
-    {
-        name: "collect",
-        description: "Collects values into an array across grouped rows",
-        category: "aggregation",
-        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)"]
-    },
-    {
-        name: "range",
-        description: "Generates an array of sequential integers",
-        category: "generator",
-        parameters: [
-            { name: "start", description: "Starting number (inclusive)", type: "number" },
-            { name: "end", description: "Ending number (inclusive)", type: "number" }
-        ],
-        output: { description: "Array of integers from start to end", type: "array", items: { type: "number" }, example: [1, 2, 3, 4, 5] },
-        examples: ["WITH range(1, 5) AS nums RETURN nums"]
-    },
-    {
-        name: "rand",
-        description: "Generates a random number between 0 and 1",
-        category: "generator",
-        parameters: [],
-        output: { description: "Random number between 0 and 1", type: "number", example: 0.7234 },
-        examples: ["WITH rand() AS r RETURN r"]
-    },
-    {
-        name: "round",
-        description: "Rounds a number to the nearest integer",
-        category: "math",
-        parameters: [
-            { name: "value", description: "Number to round", type: "number" }
-        ],
-        output: { description: "Rounded integer", type: "number", example: 4 },
-        examples: ["WITH 3.7 AS n RETURN round(n)"]
-    },
-    {
-        name: "split",
-        description: "Splits a string into an array by a delimiter",
-        category: "string",
-        parameters: [
-            { name: "text", description: "String to split", type: "string" },
-            { name: "delimiter", description: "Delimiter to split by", type: "string" }
-        ],
-        output: { description: "Array of string parts", type: "array", items: { type: "string" }, example: ["a", "b", "c"] },
-        examples: ["WITH 'a,b,c' AS s RETURN split(s, ',')"]
-    },
-    {
-        name: "join",
-        description: "Joins an array of strings with a delimiter",
-        category: "string",
-        parameters: [
-            { name: "array", description: "Array of values to join", type: "array" },
-            { name: "delimiter", description: "Delimiter to join with", type: "string" }
-        ],
-        output: { description: "Joined string", type: "string", example: "a,b,c" },
-        examples: ["WITH ['a', 'b', 'c'] AS arr RETURN join(arr, ',')"]
-    },
-    {
-        name: "replace",
-        description: "Replaces occurrences of a pattern in a string",
-        category: "string",
-        parameters: [
-            { name: "text", description: "Source string", type: "string" },
-            { name: "pattern", description: "Pattern to find", type: "string" },
-            { name: "replacement", description: "Replacement string", type: "string" }
-        ],
-        output: { description: "String with replacements", type: "string", example: "hello world" },
-        examples: ["WITH 'hello there' AS s RETURN replace(s, 'there', 'world')"]
-    },
-    {
-        name: "stringify",
-        description: "Converts a value to its JSON string representation",
-        category: "conversion",
-        parameters: [
-            { name: "value", description: "Value to stringify", type: "any" }
-        ],
-        output: { description: "JSON string", type: "string", example: "{\"a\":1}" },
-        examples: ["WITH {a: 1} AS obj RETURN stringify(obj)"]
-    },
-    {
-        name: "tojson",
-        description: "Parses a JSON string into an object",
-        category: "conversion",
-        parameters: [
-            { name: "text", description: "JSON string to parse", type: "string" }
-        ],
-        output: { description: "Parsed object or array", type: "object", example: { a: 1 } },
-        examples: ["WITH '{\"a\": 1}' AS s RETURN tojson(s)"]
-    },
-    {
-        name: "size",
-        description: "Returns the length of an array or string",
-        category: "utility",
-        parameters: [
-            { name: "value", description: "Array or string to measure", type: "array" }
-        ],
-        output: { description: "Length of the input", type: "number", example: 3 },
-        examples: ["WITH [1, 2, 3] AS arr RETURN size(arr)"]
-    },
-    {
-        name: "functions",
-        description: "Lists all registered functions with their metadata. Useful for discovering available functions and their documentation. Results include name, description, parameters, output schema, and usage examples.",
-        category: "introspection",
-        parameters: [
-            { name: "category", description: "Optional category to filter by (e.g., 'aggregation', 'string', 'math')", type: "string", required: false }
-        ],
-        output: {
-            description: "Array of function metadata objects",
-            type: "array",
-            items: {
-                type: "object",
-                properties: {
-                    name: { description: "Function name", type: "string" },
-                    description: { description: "What the function does", type: "string" },
-                    category: { description: "Function category", type: "string" },
-                    parameters: { description: "Array of parameter definitions", type: "array" },
-                    output: { description: "Output schema", type: "object" },
-                    examples: { description: "Usage examples", type: "array" }
-                }
-            }
-        },
-        examples: [
-            "WITH functions() AS funcs RETURN funcs",
-            "WITH functions('aggregation') AS funcs UNWIND funcs AS f RETURN f.name, f.description"
-        ]
+const functionMetadataRegistry = new Map();
+/**
+ * Registry for function factories collected via decorators.
+ * Allows @FunctionDef to automatically register functions for instantiation.
+ */
+const functionFactoryRegistry = new Map();
+/**
+ * Class decorator that registers function metadata.
+ * The function name is derived from the class's constructor call to super().
+ *
+ * @param options - Function metadata (excluding name)
+ * @returns Class decorator
+ *
+ * @example
+ * ```typescript
+ * @FunctionDef({
+ *     description: "Calculates the sum of numeric values",
+ *     category: "aggregate",
+ *     parameters: [{ name: "value", description: "Numeric value to sum", type: "number" }],
+ *     output: { description: "Sum of all values", type: "number", example: 150 },
+ *     examples: ["WITH [1, 2, 3] AS nums UNWIND nums AS n RETURN sum(n)"]
+ * })
+ * class Sum extends AggregateFunction { ... }
+ * ```
+ */
+function FunctionDef(options) {
+    return function (constructor) {
+        var _a;
+        // Create an instance to get the function name from super() call
+        const instance = new constructor();
+        const baseName = ((_a = instance.name) === null || _a === void 0 ? void 0 : _a.toLowerCase()) || constructor.name.toLowerCase();
+        // Use category-qualified key to avoid collisions (e.g., sum vs sum:predicate)
+        // but store the display name without the qualifier
+        const displayName = baseName.includes(':') ? baseName.split(':')[0] : baseName;
+        const registryKey = options.category ? `${displayName}:${options.category}` : displayName;
+        // Register metadata with display name but category-qualified key
+        const metadata = Object.assign({ name: displayName }, options);
+        functionMetadataRegistry.set(registryKey, metadata);
+        // Register factory function for automatic instantiation
+        // Only register to the simple name if no collision exists (predicate functions use qualified keys)
+        if (options.category !== 'predicate') {
+            functionFactoryRegistry.set(displayName, () => new constructor());
+        }
+        functionFactoryRegistry.set(registryKey, () => new constructor());
+        return constructor;
+    };
+}
+/**
+ * Gets all registered function metadata from decorators.
+ *
+ * @returns Array of function metadata
+ */
+function getRegisteredFunctionMetadata() {
+    return Array.from(functionMetadataRegistry.values());
+}
+/**
+ * Gets a registered function factory by name.
+ * Used by FunctionFactory to instantiate decorator-registered functions.
+ *
+ * @param name - Function name (case-insensitive)
+ * @param category - Optional category to disambiguate (e.g., 'predicate')
+ * @returns Factory function or undefined
+ */
+function getRegisteredFunctionFactory(name, category) {
+    const lowerName = name.toLowerCase();
+    // If category specified, look for exact match
+    if (category) {
+        return functionFactoryRegistry.get(`${lowerName}:${category}`);
+    }
+    // Try direct match first
+    if (functionFactoryRegistry.has(lowerName)) {
+        return functionFactoryRegistry.get(lowerName);
+    }
+    return undefined;
+}
+/**
+ * Gets metadata for a specific function by name.
+ * If multiple functions share the same name (e.g., aggregate vs predicate),
+ * optionally specify the category to get the specific one.
+ *
+ * @param name - Function name (case-insensitive)
+ * @param category - Optional category to disambiguate
+ * @returns Function metadata or undefined
+ */
+function getFunctionMetadata(name, category) {
+    const lowerName = name.toLowerCase();
+    // If category specified, look for exact match
+    if (category) {
+        return functionMetadataRegistry.get(`${lowerName}:${category}`);
+    }
+    // Otherwise, first try direct match (for functions without category conflicts)
+    // Then search for any function with matching name
+    for (const [key, meta] of functionMetadataRegistry) {
+        if (meta.name === lowerName) {
+            return meta;
+        }
     }
-];
+    return undefined;
+}
 //# sourceMappingURL=function_metadata.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"function_metadata.js","sourceRoot":"","sources":["../../../src/parsing/functions/function_metadata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"function_metadata.js","sourceRoot":"","sources":["../../../src/parsing/functions/function_metadata.ts"],"names":[],"mappings":";;AA6HA,kCA2BC;AAOD,sEAEC;AAUD,oEAcC;AAWD,kDAiBC;AA3HD;;GAEG;AACH,MAAM,wBAAwB,GAAkC,IAAI,GAAG,EAAE,CAAC;AAE1E;;;GAGG;AACH,MAAM,uBAAuB,GAA2B,IAAI,GAAG,EAAE,CAAC;AAOlE;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,WAAW,CAAC,OAA2B;IACnD,OAAO,UAAiD,WAAc;;QAClE,gEAAgE;QAChE,MAAM,QAAQ,GAAG,IAAI,WAAW,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,CAAA,MAAA,QAAQ,CAAC,IAAI,0CAAE,WAAW,EAAE,KAAI,WAAW,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;QAEhF,8EAA8E;QAC9E,mDAAmD;QACnD,MAAM,WAAW,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/E,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,WAAW,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;QAE1F,iEAAiE;QACjE,MAAM,QAAQ,mBACV,IAAI,EAAE,WAAW,IACd,OAAO,CACb,CAAC;QACF,wBAAwB,CAAC,GAAG,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QAEpD,wDAAwD;QACxD,mGAAmG;QACnG,IAAI,OAAO,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YACnC,uBAAuB,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,uBAAuB,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC;QAElE,OAAO,WAAW,CAAC;IACvB,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,6BAA6B;IACzC,OAAO,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,MAAM,EAAE,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,4BAA4B,CAAC,IAAY,EAAE,QAAiB;IACxE,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAErC,8CAA8C;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACX,OAAO,uBAAuB,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,yBAAyB;IACzB,IAAI,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,OAAO,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,IAAY,EAAE,QAAiB;IAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAErC,8CAA8C;IAC9C,IAAI,QAAQ,EAAE,CAAC;QACX,OAAO,wBAAwB,CAAC,GAAG,CAAC,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,+EAA+E;IAC/E,kDAAkD;IAClD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,wBAAwB,EAAE,CAAC;QACjD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/functions.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAGlC;;;;;;;;;;;;;GAaG;AACH,cAAM,SAAU,SAAQ,QAAQ;;IAMrB,KAAK,IAAI,GAAG;CAiBtB;AAED,eAAe,SAAS,CAAC"}
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/functions.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAIlC;;;;;;;;;;;;;GAaG;AACH,cA0BM,SAAU,SAAQ,QAAQ;;IAMrB,KAAK,IAAI,GAAG;CAiBtB;AAED,eAAe,SAAS,CAAC"}

package/dist/parsing/functions/functions.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 function_1 = __importDefault(require("./function"));
 const function_factory_1 = __importDefault(require("./function_factory"));
+const function_metadata_1 = require("./function_metadata");
 /**
  * Built-in function that lists all registered functions with their metadata.
  *
@@ -19,7 +26,7 @@ const function_factory_1 = __importDefault(require("./function_factory"));
  * RETURN func.name, func.description
  * ```
  */
-class Functions extends function_1.default {
+let Functions = class Functions extends function_1.default {
     constructor() {
         super("functions");
         this._expectedParameterCount = null; // 0 or 1 parameter
@@ -42,6 +49,34 @@ class Functions extends function_1.default {
             throw new Error("functions() takes 0 or 1 parameters");
         }
     }
-}
+};
+Functions = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Lists all registered functions with their metadata. Useful for discovering available functions and their documentation. Results include name, description, parameters, output schema, and usage examples.",
+        category: "scalar",
+        parameters: [
+            { name: "category", description: "Optional category to filter by (e.g., 'aggregation', 'string', 'math')", type: "string", required: false }
+        ],
+        output: {
+            description: "Array of function metadata objects",
+            type: "array",
+            items: {
+                type: "object",
+                properties: {
+                    name: { description: "Function name", type: "string" },
+                    description: { description: "What the function does", type: "string" },
+                    category: { description: "Function category", type: "string" },
+                    parameters: { description: "Array of parameter definitions", type: "array" },
+                    output: { description: "Output schema", type: "object" },
+                    examples: { description: "Usage examples", type: "array" }
+                }
+            }
+        },
+        examples: [
+            "WITH functions() AS funcs RETURN funcs",
+            "WITH functions('aggregation') AS funcs UNWIND funcs AS f RETURN f.name, f.description"
+        ]
+    })
+], Functions);
 exports.default = Functions;
 //# sourceMappingURL=functions.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../src/parsing/functions/functions.ts"],"names":[],"mappings":";;;;;AAAA,0DAAkC;AAClC,0EAAiD;AAEjD;;;;;;;;;;;;;GAaG;AACH,MAAM,SAAU,SAAQ,kBAAQ;IAC5B;QACI,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC,mBAAmB;IAC5D,CAAC;IAEM,KAAK;QACR,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,uBAAuB;YACvB,OAAO,0BAAe,CAAC,aAAa,EAAE,CAAC;QAC3C,CAAC;aAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,qBAAqB;YACrB,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,0BAAe,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC;CACJ;AAED,kBAAe,SAAS,CAAC"}
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../src/parsing/functions/functions.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,0DAAkC;AAClC,0EAAiD;AACjD,2DAAkD;AAElD;;;;;;;;;;;;;GAaG;AA2BH,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,kBAAQ;IAC5B;QACI,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC,mBAAmB;IAC5D,CAAC;IAEM,KAAK;QACR,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEpC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxB,uBAAuB;YACvB,OAAO,0BAAe,CAAC,aAAa,EAAE,CAAC;QAC3C,CAAC;aAAM,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,qBAAqB;YACrB,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC/B,OAAO,0BAAe,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACJ,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC3D,CAAC;IACL,CAAC;CACJ,CAAA;AAvBK,SAAS;IA1Bd,IAAA,+BAAW,EAAC;QACT,WAAW,EAAE,2MAA2M;QACxN,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE;YACR,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,wEAAwE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE;SAC/I;QACD,MAAM,EAAE;YACJ,WAAW,EAAE,oCAAoC;YACjD,IAAI,EAAE,OAAO;YACb,KAAK,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,IAAI,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACtD,WAAW,EAAE,EAAE,WAAW,EAAE,wBAAwB,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACtE,QAAQ,EAAE,EAAE,WAAW,EAAE,mBAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE;oBAC9D,UAAU,EAAE,EAAE,WAAW,EAAE,gCAAgC,EAAE,IAAI,EAAE,OAAO,EAAE;oBAC5E,MAAM,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE;oBACxD,QAAQ,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE;iBAC7D;aACJ;SACJ;QACD,QAAQ,EAAE;YACN,wCAAwC;YACxC,uFAAuF;SAC1F;KACJ,CAAC;GACI,SAAS,CAuBd;AAED,kBAAe,SAAS,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/join.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,QAAQ,MAAM,YAAY,CAAC;AAGlC,cAAM,IAAK,SAAQ,QAAQ;;IAKvB,IAAW,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,EAKrC;IACM,KAAK,IAAI,GAAG;CAQtB;AAED,eAAe,IAAI,CAAC"}
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/join.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,QAAQ,MAAM,YAAY,CAAC;AAIlC,cAUM,IAAK,SAAQ,QAAQ;;IAKvB,IAAW,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,EAKrC;IACM,KAAK,IAAI,GAAG;CAQtB;AAED,eAAe,IAAI,CAAC"}

package/dist/parsing/functions/join.js

@@ -1,11 +1,18 @@
 "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 function_1 = __importDefault(require("./function"));
 const string_1 = __importDefault(require("../expressions/string"));
-class Join extends function_1.default {
+const function_metadata_1 = require("./function_metadata");
+let Join = class Join extends function_1.default {
     constructor() {
         super("join");
         this._expectedParameterCount = 2;
@@ -24,6 +31,18 @@ class Join extends function_1.default {
         }
         return array.join(delimiter);
     }
-}
+};
+Join = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Joins an array of strings with a delimiter",
+        category: "scalar",
+        parameters: [
+            { name: "array", description: "Array of values to join", type: "array" },
+            { name: "delimiter", description: "Delimiter to join with", type: "string" }
+        ],
+        output: { description: "Joined string", type: "string", example: "a,b,c" },
+        examples: ["WITH ['a', 'b', 'c'] AS arr RETURN join(arr, ',')"]
+    })
+], Join);
 exports.default = Join;
 //# sourceMappingURL=join.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"join.js","sourceRoot":"","sources":["../../../src/parsing/functions/join.ts"],"names":[],"mappings":";;;;;AACA,0DAAkC;AAClC,mEAA2C;AAE3C,MAAM,IAAK,SAAQ,kBAAQ;IACvB;QACI,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAW,UAAU,CAAC,KAAgB;QAClC,IAAG,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,IAAI,gBAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;IAC7B,CAAC;IACM,KAAK;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;CACJ;AAED,kBAAe,IAAI,CAAC"}
+{"version":3,"file":"join.js","sourceRoot":"","sources":["../../../src/parsing/functions/join.ts"],"names":[],"mappings":";;;;;;;;;;;AACA,0DAAkC;AAClC,mEAA2C;AAC3C,2DAAkD;AAYlD,IAAM,IAAI,GAAV,MAAM,IAAK,SAAQ,kBAAQ;IACvB;QACI,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC;IACrC,CAAC;IACD,IAAW,UAAU,CAAC,KAAgB;QAClC,IAAG,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,IAAI,gBAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;IAC7B,CAAC;IACM,KAAK;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAChD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YACzD,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;CACJ,CAAA;AAnBK,IAAI;IAVT,IAAA,+BAAW,EAAC;QACT,WAAW,EAAE,4CAA4C;QACzD,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE;YACR,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,yBAAyB,EAAE,IAAI,EAAE,OAAO,EAAE;YACxE,EAAE,IAAI,EAAE,WAAW,EAAE,WAAW,EAAE,wBAAwB,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC/E;QACD,MAAM,EAAE,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE;QAC1E,QAAQ,EAAE,CAAC,mDAAmD,CAAC;KAClE,CAAC;GACI,IAAI,CAmBT;AAED,kBAAe,IAAI,CAAC"}

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

@@ -7,6 +7,7 @@ declare class PredicateFunction extends ASTNode {
     private _name;
     protected _valueHolder: ValueHolder;
     constructor(name: string);
+    get name(): string;
     protected get reference(): Reference;
     protected get array(): ASTNode;
     protected get _return(): Expression;

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

@@ -1 +1 @@
-{"version":3,"file":"predicate_function.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/predicate_function.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,UAAU,MAAM,2BAA2B,CAAC;AACnD,OAAO,SAAS,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,MAAM,qBAAqB,CAAC;AACxC,OAAO,WAAW,MAAM,gBAAgB,CAAC;AAEzC,cAAM,iBAAkB,SAAQ,OAAO;IACnC,OAAO,CAAC,KAAK,CAAS;IACtB,SAAS,CAAC,YAAY,EAAE,WAAW,CAAqB;gBAE5C,IAAI,EAAE,MAAM;IAKxB,SAAS,KAAK,SAAS,IAAI,SAAS,CAEnC;IAED,SAAS,KAAK,KAAK,IAAI,OAAO,CAE7B;IAED,SAAS,KAAK,OAAO,IAAI,UAAU,CAElC;IAED,SAAS,KAAK,KAAK,IAAI,KAAK,GAAG,IAAI,CAKlC;IAEM,KAAK,IAAI,GAAG;IAIZ,QAAQ,IAAI,MAAM;CAG5B;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"predicate_function.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/predicate_function.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,aAAa,CAAC;AAClC,OAAO,UAAU,MAAM,2BAA2B,CAAC;AACnD,OAAO,SAAS,MAAM,0BAA0B,CAAC;AACjD,OAAO,KAAK,MAAM,qBAAqB,CAAC;AACxC,OAAO,WAAW,MAAM,gBAAgB,CAAC;AAEzC,cAAM,iBAAkB,SAAQ,OAAO;IACnC,OAAO,CAAC,KAAK,CAAS;IACtB,SAAS,CAAC,YAAY,EAAE,WAAW,CAAqB;gBAE5C,IAAI,EAAE,MAAM;IAKxB,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,SAAS,KAAK,SAAS,IAAI,SAAS,CAEnC;IAED,SAAS,KAAK,KAAK,IAAI,OAAO,CAE7B;IAED,SAAS,KAAK,OAAO,IAAI,UAAU,CAElC;IAED,SAAS,KAAK,KAAK,IAAI,KAAK,GAAG,IAAI,CAKlC;IAEM,KAAK,IAAI,GAAG;IAIZ,QAAQ,IAAI,MAAM;CAG5B;AAED,eAAe,iBAAiB,CAAC"}

package/dist/parsing/functions/predicate_function.js

@@ -11,6 +11,9 @@ class PredicateFunction extends ast_node_1.default {
         this._valueHolder = new value_holder_1.default();
         this._name = name;
     }
+    get name() {
+        return this._name;
+    }
     get reference() {
         return this.firstChild();
     }

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

@@ -1 +1 @@
-{"version":3,"file":"predicate_function.js","sourceRoot":"","sources":["../../../src/parsing/functions/predicate_function.ts"],"names":[],"mappings":";;;;;AAAA,2DAAkC;AAIlC,kEAAyC;AAEzC,MAAM,iBAAkB,SAAQ,kBAAO;IAInC,YAAY,IAAY;QACpB,KAAK,EAAE,CAAC;QAHF,iBAAY,GAAgB,IAAI,sBAAW,EAAE,CAAC;QAIpD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,IAAc,SAAS;QACnB,OAAO,IAAI,CAAC,UAAU,EAAe,CAAC;IAC1C,CAAC;IAED,IAAc,KAAK;QACf,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IAC9C,CAAC;IAED,IAAc,OAAO;QACjB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAe,CAAC;IAC/C,CAAC;IAED,IAAc,KAAK;QACf,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAU,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,KAAK;QACR,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;IAEM,QAAQ;QACX,OAAO,sBAAsB,IAAI,CAAC,KAAK,GAAG,CAAC;IAC/C,CAAC;CACJ;AAED,kBAAe,iBAAiB,CAAC"}
+{"version":3,"file":"predicate_function.js","sourceRoot":"","sources":["../../../src/parsing/functions/predicate_function.ts"],"names":[],"mappings":";;;;;AAAA,2DAAkC;AAIlC,kEAAyC;AAEzC,MAAM,iBAAkB,SAAQ,kBAAO;IAInC,YAAY,IAAY;QACpB,KAAK,EAAE,CAAC;QAHF,iBAAY,GAAgB,IAAI,sBAAW,EAAE,CAAC;QAIpD,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACtB,CAAC;IAED,IAAW,IAAI;QACX,OAAO,IAAI,CAAC,KAAK,CAAC;IACtB,CAAC;IAED,IAAc,SAAS;QACnB,OAAO,IAAI,CAAC,UAAU,EAAe,CAAC;IAC1C,CAAC;IAED,IAAc,KAAK;QACf,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;IAC9C,CAAC;IAED,IAAc,OAAO;QACjB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAe,CAAC;IAC/C,CAAC;IAED,IAAc,KAAK;QACf,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAU,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;IAEM,KAAK;QACR,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC/C,CAAC;IAEM,QAAQ;QACX,OAAO,sBAAsB,IAAI,CAAC,KAAK,GAAG,CAAC;IAC/C,CAAC;CACJ;AAED,kBAAe,iBAAiB,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"predicate_sum.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/predicate_sum.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AAErD,cAAM,YAAa,SAAQ,iBAAiB;;IAKjC,KAAK,IAAI,GAAG;CAmBtB;AAED,eAAe,YAAY,CAAC"}
+{"version":3,"file":"predicate_sum.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/predicate_sum.ts"],"names":[],"mappings":"AAAA,OAAO,iBAAiB,MAAM,sBAAsB,CAAC;AAGrD,cAYM,YAAa,SAAQ,iBAAiB;;IAKjC,KAAK,IAAI,GAAG;CAmBtB;AAED,eAAe,YAAY,CAAC"}

package/dist/parsing/functions/predicate_sum.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 predicate_function_1 = __importDefault(require("./predicate_function"));
-class PredicateSum extends predicate_function_1.default {
+const function_metadata_1 = require("./function_metadata");
+let PredicateSum = class PredicateSum extends predicate_function_1.default {
     constructor() {
         super("sum");
     }
@@ -28,6 +35,20 @@ class PredicateSum extends predicate_function_1.default {
         }
         return _sum;
     }
-}
+};
+PredicateSum = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Calculates the sum of values in an array with optional filtering. Uses list comprehension syntax: sum(variable IN array [WHERE condition] | expression)",
+        category: "predicate",
+        parameters: [
+            { name: "variable", description: "Variable name to bind each element", type: "string" },
+            { name: "array", description: "Array to iterate over", type: "array" },
+            { name: "expression", description: "Expression to sum for each element", type: "any" },
+            { name: "where", description: "Optional filter condition", type: "boolean", required: false }
+        ],
+        output: { description: "Sum of the evaluated expressions", type: "number", example: 6 },
+        examples: ["WITH [1, 2, 3] AS nums RETURN sum(n IN nums | n)", "WITH [1, 2, 3, 4] AS nums RETURN sum(n IN nums WHERE n > 1 | n * 2)"]
+    })
+], PredicateSum);
 exports.default = PredicateSum;
 //# sourceMappingURL=predicate_sum.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"predicate_sum.js","sourceRoot":"","sources":["../../../src/parsing/functions/predicate_sum.ts"],"names":[],"mappings":";;;;;AAAA,8EAAqD;AAErD,MAAM,YAAa,SAAQ,4BAAiB;IACxC;QACI,KAAK,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,IAAI,GAAe,IAAI,CAAC;QAC5B,KAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC5C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAChB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACJ,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACjC,CAAC;YACL,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ;AAED,kBAAe,YAAY,CAAC"}
+{"version":3,"file":"predicate_sum.js","sourceRoot":"","sources":["../../../src/parsing/functions/predicate_sum.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,8EAAqD;AACrD,2DAAkD;AAclD,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,4BAAiB;IACxC;QACI,KAAK,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IAEM,KAAK;QACR,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC;QAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,IAAI,GAAe,IAAI,CAAC;QAC5B,KAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACpC,IAAI,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC5C,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;oBAChB,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACJ,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;gBACjC,CAAC;YACL,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ,CAAA;AAxBK,YAAY;IAZjB,IAAA,+BAAW,EAAC;QACT,WAAW,EAAE,yJAAyJ;QACtK,QAAQ,EAAE,WAAW;QACrB,UAAU,EAAE;YACR,EAAE,IAAI,EAAE,UAAU,EAAE,WAAW,EAAE,oCAAoC,EAAE,IAAI,EAAE,QAAQ,EAAE;YACvF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,uBAAuB,EAAE,IAAI,EAAE,OAAO,EAAE;YACtE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,oCAAoC,EAAE,IAAI,EAAE,KAAK,EAAE;YACtF,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,2BAA2B,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE;SAChG;QACD,MAAM,EAAE,EAAE,WAAW,EAAE,kCAAkC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE;QACvF,QAAQ,EAAE,CAAC,kDAAkD,EAAE,qEAAqE,CAAC;KACxI,CAAC;GACI,YAAY,CAwBjB;AAED,kBAAe,YAAY,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"rand.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/rand.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAElC,cAAM,IAAK,SAAQ,QAAQ;;IAKhB,KAAK,IAAI,GAAG;CAGtB;AAED,eAAe,IAAI,CAAC"}
+{"version":3,"file":"rand.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/rand.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAGlC,cAOM,IAAK,SAAQ,QAAQ;;IAKhB,KAAK,IAAI,GAAG;CAGtB;AAED,eAAe,IAAI,CAAC"}

package/dist/parsing/functions/rand.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 function_1 = __importDefault(require("./function"));
-class Rand extends function_1.default {
+const function_metadata_1 = require("./function_metadata");
+let Rand = class Rand extends function_1.default {
     constructor() {
         super("rand");
         this._expectedParameterCount = 0;
@@ -12,6 +19,15 @@ class Rand extends function_1.default {
     value() {
         return Math.random();
     }
-}
+};
+Rand = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Generates a random number between 0 and 1",
+        category: "scalar",
+        parameters: [],
+        output: { description: "Random number between 0 and 1", type: "number", example: 0.7234 },
+        examples: ["WITH rand() AS r RETURN r"]
+    })
+], Rand);
 exports.default = Rand;
 //# sourceMappingURL=rand.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"rand.js","sourceRoot":"","sources":["../../../src/parsing/functions/rand.ts"],"names":[],"mappings":";;;;;AAAA,0DAAkC;AAElC,MAAM,IAAK,SAAQ,kBAAQ;IACvB;QACI,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC;IACrC,CAAC;IACM,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC;CACJ;AAED,kBAAe,IAAI,CAAC"}
+{"version":3,"file":"rand.js","sourceRoot":"","sources":["../../../src/parsing/functions/rand.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,0DAAkC;AAClC,2DAAkD;AASlD,IAAM,IAAI,GAAV,MAAM,IAAK,SAAQ,kBAAQ;IACvB;QACI,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC;IACrC,CAAC;IACM,KAAK;QACR,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC;CACJ,CAAA;AARK,IAAI;IAPT,IAAA,+BAAW,EAAC;QACT,WAAW,EAAE,2CAA2C;QACxD,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE,EAAE;QACd,MAAM,EAAE,EAAE,WAAW,EAAE,+BAA+B,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE;QACzF,QAAQ,EAAE,CAAC,2BAA2B,CAAC;KAC1C,CAAC;GACI,IAAI,CAQT;AAED,kBAAe,IAAI,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/range.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAElC,cAAM,KAAM,SAAQ,QAAQ;;IAKjB,KAAK,IAAI,GAAG;CAQtB;AAED,eAAe,KAAK,CAAC"}
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/range.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAGlC,cAUM,KAAM,SAAQ,QAAQ;;IAKjB,KAAK,IAAI,GAAG;CAQtB;AAED,eAAe,KAAK,CAAC"}

package/dist/parsing/functions/range.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 function_1 = __importDefault(require("./function"));
-class Range extends function_1.default {
+const function_metadata_1 = require("./function_metadata");
+let Range = class Range extends function_1.default {
     constructor() {
         super("range");
         this._expectedParameterCount = 2;
@@ -17,6 +24,18 @@ class Range extends function_1.default {
         }
         return Array.from({ length: end - start + 1 }, (_, i) => start + i);
     }
-}
+};
+Range = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Generates an array of sequential integers",
+        category: "scalar",
+        parameters: [
+            { name: "start", description: "Starting number (inclusive)", type: "number" },
+            { name: "end", description: "Ending number (inclusive)", type: "number" }
+        ],
+        output: { description: "Array of integers from start to end", type: "array", items: { type: "number" }, example: [1, 2, 3, 4, 5] },
+        examples: ["WITH range(1, 5) AS nums RETURN nums"]
+    })
+], Range);
 exports.default = Range;
 //# sourceMappingURL=range.js.map