flowquery 1.0.35 → 1.0.37

package/dist/parsing/functions/nodes.js

@@ -0,0 +1,63 @@
+"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_metadata_1 = require("./function_metadata");
+let Nodes = class Nodes extends function_1.default {
+    constructor() {
+        super("nodes");
+        this._expectedParameterCount = 1;
+    }
+    value() {
+        const path = this.getChildren()[0].value();
+        if (path === null || path === undefined) {
+            return [];
+        }
+        if (!Array.isArray(path)) {
+            throw new Error("nodes() expects a path (array)");
+        }
+        // A path is an array of alternating node and relationship objects:
+        // [node, rel, node, rel, node, ...]
+        // Nodes are plain NodeRecords (have 'id' but not 'type'/'startNode'/'endNode')
+        // Relationships are RelationshipMatchRecords (have 'type', 'startNode', 'endNode', 'properties')
+        return path.filter((element) => {
+            if (element === null || element === undefined || typeof element !== "object") {
+                return false;
+            }
+            // A RelationshipMatchRecord has type, startNode, endNode, properties
+            return !("type" in element &&
+                "startNode" in element &&
+                "endNode" in element &&
+                "properties" in element);
+        });
+    }
+};
+Nodes = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Returns all nodes in a path as an array",
+        category: "scalar",
+        parameters: [
+            {
+                name: "path",
+                description: "A path value returned from a graph pattern match",
+                type: "array",
+            },
+        ],
+        output: {
+            description: "Array of node records",
+            type: "array",
+            example: "[{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]",
+        },
+        examples: ["MATCH p=(:Person)-[:KNOWS]-(:Person) RETURN nodes(p)"],
+    })
+], Nodes);
+exports.default = Nodes;
+//# sourceMappingURL=nodes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nodes.js","sourceRoot":"","sources":["../../../src/parsing/functions/nodes.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,0DAAkC;AAClC,2DAAkD;AAmBlD,IAAM,KAAK,GAAX,MAAM,KAAM,SAAQ,kBAAQ;IACxB;QACI,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC;IACrC,CAAC;IAEM,KAAK;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3C,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,EAAE,CAAC;QACd,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACtD,CAAC;QACD,mEAAmE;QACnE,oCAAoC;QACpC,+EAA+E;QAC/E,iGAAiG;QACjG,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,OAAY,EAAE,EAAE;YAChC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC3E,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,qEAAqE;YACrE,OAAO,CAAC,CACJ,MAAM,IAAI,OAAO;gBACjB,WAAW,IAAI,OAAO;gBACtB,SAAS,IAAI,OAAO;gBACpB,YAAY,IAAI,OAAO,CAC1B,CAAC;QACN,CAAC,CAAC,CAAC;IACP,CAAC;CACJ,CAAA;AA/BK,KAAK;IAjBV,IAAA,+BAAW,EAAC;QACT,WAAW,EAAE,yCAAyC;QACtD,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE;YACR;gBACI,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,kDAAkD;gBAC/D,IAAI,EAAE,OAAO;aAChB;SACJ;QACD,MAAM,EAAE;YACJ,WAAW,EAAE,uBAAuB;YACpC,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,oDAAoD;SAChE;QACD,QAAQ,EAAE,CAAC,sDAAsD,CAAC;KACrE,CAAC;GACI,KAAK,CA+BV;AAED,kBAAe,KAAK,CAAC"}

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

@@ -0,0 +1,7 @@
+import Function from "./function";
+declare class Properties extends Function {
+    constructor();
+    value(): any;
+}
+export default Properties;
+//# sourceMappingURL=properties.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"properties.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/properties.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAGlC,cAqBM,UAAW,SAAQ,QAAQ;;IAMtB,KAAK,IAAI,GAAG;CAuBtB;AAED,eAAe,UAAU,CAAC"}

package/dist/parsing/functions/properties.js

@@ -0,0 +1,74 @@
+"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 __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+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_metadata_1 = require("./function_metadata");
+let Properties = class Properties extends function_1.default {
+    constructor() {
+        super("properties");
+        this._expectedParameterCount = 1;
+    }
+    value() {
+        const obj = this.getChildren()[0].value();
+        if (obj === null || obj === undefined) {
+            return null;
+        }
+        if (typeof obj !== "object" || Array.isArray(obj)) {
+            throw new Error("properties() expects a node, relationship, or map");
+        }
+        // If it's a RelationshipMatchRecord (has type, startNode, endNode, properties)
+        if ("type" in obj && "startNode" in obj && "endNode" in obj && "properties" in obj) {
+            return obj.properties;
+        }
+        // If it's a node record (has id field), exclude id
+        if ("id" in obj) {
+            const { id } = obj, props = __rest(obj, ["id"]);
+            return props;
+        }
+        // Otherwise, treat as a plain map and return a copy
+        return Object.assign({}, obj);
+    }
+};
+Properties = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Returns a map containing all the properties of a node, relationship, or map. For nodes and relationships, internal identifiers are excluded.",
+        category: "scalar",
+        parameters: [
+            {
+                name: "entity",
+                description: "A node, relationship, or map to extract properties from",
+                type: "object",
+            },
+        ],
+        output: {
+            description: "Map of properties",
+            type: "object",
+            example: "{ name: 'Alice', age: 30 }",
+        },
+        examples: [
+            "MATCH (n:Person) RETURN properties(n)",
+            "WITH { name: 'Alice', age: 30 } AS obj RETURN properties(obj)",
+        ],
+    })
+], Properties);
+exports.default = Properties;
+//# sourceMappingURL=properties.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"properties.js","sourceRoot":"","sources":["../../../src/parsing/functions/properties.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA,0DAAkC;AAClC,2DAAkD;AAuBlD,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,kBAAQ;IAC7B;QACI,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC;IACrC,CAAC;IAEM,KAAK;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAC1C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACzE,CAAC;QAED,+EAA+E;QAC/E,IAAI,MAAM,IAAI,GAAG,IAAI,WAAW,IAAI,GAAG,IAAI,SAAS,IAAI,GAAG,IAAI,YAAY,IAAI,GAAG,EAAE,CAAC;YACjF,OAAO,GAAG,CAAC,UAAU,CAAC;QAC1B,CAAC;QAED,mDAAmD;QACnD,IAAI,IAAI,IAAI,GAAG,EAAE,CAAC;YACd,MAAM,EAAE,EAAE,KAAe,GAAG,EAAb,KAAK,UAAK,GAAG,EAAtB,MAAgB,CAAM,CAAC;YAC7B,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,oDAAoD;QACpD,yBAAY,GAAG,EAAG;IACtB,CAAC;CACJ,CAAA;AA7BK,UAAU;IArBf,IAAA,+BAAW,EAAC;QACT,WAAW,EACP,8IAA8I;QAClJ,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE;YACR;gBACI,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yDAAyD;gBACtE,IAAI,EAAE,QAAQ;aACjB;SACJ;QACD,MAAM,EAAE;YACJ,WAAW,EAAE,mBAAmB;YAChC,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,4BAA4B;SACxC;QACD,QAAQ,EAAE;YACN,uCAAuC;YACvC,+DAA+D;SAClE;KACJ,CAAC;GACI,UAAU,CA6Bf;AAED,kBAAe,UAAU,CAAC"}

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

@@ -0,0 +1,7 @@
+import Function from "./function";
+declare class Relationships extends Function {
+    constructor();
+    value(): any;
+}
+export default Relationships;
+//# sourceMappingURL=relationships.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/relationships.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAGlC,cAiBM,aAAc,SAAQ,QAAQ;;IAMzB,KAAK,IAAI,GAAG;CAuBtB;AAED,eAAe,aAAa,CAAC"}

package/dist/parsing/functions/relationships.js

@@ -0,0 +1,61 @@
+"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_metadata_1 = require("./function_metadata");
+let Relationships = class Relationships extends function_1.default {
+    constructor() {
+        super("relationships");
+        this._expectedParameterCount = 1;
+    }
+    value() {
+        const path = this.getChildren()[0].value();
+        if (path === null || path === undefined) {
+            return [];
+        }
+        if (!Array.isArray(path)) {
+            throw new Error("relationships() expects a path (array)");
+        }
+        // A path is an array of alternating node and relationship objects:
+        // [node, rel, node, rel, node, ...]
+        // Relationships are RelationshipMatchRecords (have 'type', 'startNode', 'endNode', 'properties')
+        return path.filter((element) => {
+            if (element === null || element === undefined || typeof element !== "object") {
+                return false;
+            }
+            return ("type" in element &&
+                "startNode" in element &&
+                "endNode" in element &&
+                "properties" in element);
+        });
+    }
+};
+Relationships = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Returns all relationships in a path as an array",
+        category: "scalar",
+        parameters: [
+            {
+                name: "path",
+                description: "A path value returned from a graph pattern match",
+                type: "array",
+            },
+        ],
+        output: {
+            description: "Array of relationship records",
+            type: "array",
+            example: "[{ type: 'KNOWS', properties: { since: '2020' } }]",
+        },
+        examples: ["MATCH p=(:Person)-[:KNOWS]-(:Person) RETURN relationships(p)"],
+    })
+], Relationships);
+exports.default = Relationships;
+//# sourceMappingURL=relationships.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"relationships.js","sourceRoot":"","sources":["../../../src/parsing/functions/relationships.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,0DAAkC;AAClC,2DAAkD;AAmBlD,IAAM,aAAa,GAAnB,MAAM,aAAc,SAAQ,kBAAQ;IAChC;QACI,KAAK,CAAC,eAAe,CAAC,CAAC;QACvB,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC;IACrC,CAAC;IAEM,KAAK;QACR,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAC3C,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,EAAE,CAAC;QACd,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC9D,CAAC;QACD,mEAAmE;QACnE,oCAAoC;QACpC,iGAAiG;QACjG,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,OAAY,EAAE,EAAE;YAChC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC3E,OAAO,KAAK,CAAC;YACjB,CAAC;YACD,OAAO,CACH,MAAM,IAAI,OAAO;gBACjB,WAAW,IAAI,OAAO;gBACtB,SAAS,IAAI,OAAO;gBACpB,YAAY,IAAI,OAAO,CAC1B,CAAC;QACN,CAAC,CAAC,CAAC;IACP,CAAC;CACJ,CAAA;AA7BK,aAAa;IAjBlB,IAAA,+BAAW,EAAC;QACT,WAAW,EAAE,iDAAiD;QAC9D,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE;YACR;gBACI,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,kDAAkD;gBAC/D,IAAI,EAAE,OAAO;aAChB;SACJ;QACD,MAAM,EAAE;YACJ,WAAW,EAAE,+BAA+B;YAC5C,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,oDAAoD;SAChE;QACD,QAAQ,EAAE,CAAC,8DAA8D,CAAC;KAC7E,CAAC;GACI,aAAa,CA6BlB;AAED,kBAAe,aAAa,CAAC"}

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

@@ -0,0 +1,7 @@
+import Function from "./function";
+declare class Tail extends Function {
+    constructor();
+    value(): any;
+}
+export default Tail;
+//# sourceMappingURL=tail.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tail.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/tail.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAGlC,cAiBM,IAAK,SAAQ,QAAQ;;IAMhB,KAAK,IAAI,GAAG;CAUtB;AAED,eAAe,IAAI,CAAC"}

package/dist/parsing/functions/tail.js

@@ -0,0 +1,50 @@
+"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_metadata_1 = require("./function_metadata");
+let Tail = class Tail extends function_1.default {
+    constructor() {
+        super("tail");
+        this._expectedParameterCount = 1;
+    }
+    value() {
+        const val = this.getChildren()[0].value();
+        if (val === null || val === undefined) {
+            return null;
+        }
+        if (!Array.isArray(val)) {
+            throw new Error("tail() expects a list");
+        }
+        return val.slice(1);
+    }
+};
+Tail = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Returns all elements of a list except the first",
+        category: "scalar",
+        parameters: [
+            {
+                name: "list",
+                description: "The list to get all but the first element from",
+                type: "array",
+            },
+        ],
+        output: {
+            description: "All elements except the first",
+            type: "array",
+            example: "[2, 3]",
+        },
+        examples: ["RETURN tail([1, 2, 3])", "WITH ['a', 'b', 'c'] AS items RETURN tail(items)"],
+    })
+], Tail);
+exports.default = Tail;
+//# sourceMappingURL=tail.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tail.js","sourceRoot":"","sources":["../../../src/parsing/functions/tail.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,0DAAkC;AAClC,2DAAkD;AAmBlD,IAAM,IAAI,GAAV,MAAM,IAAK,SAAQ,kBAAQ;IACvB;QACI,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,uBAAuB,GAAG,CAAC,CAAC;IACrC,CAAC;IAEM,KAAK;QACR,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAC1C,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;CACJ,CAAA;AAhBK,IAAI;IAjBT,IAAA,+BAAW,EAAC;QACT,WAAW,EAAE,iDAAiD;QAC9D,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE;YACR;gBACI,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,gDAAgD;gBAC7D,IAAI,EAAE,OAAO;aAChB;SACJ;QACD,MAAM,EAAE;YACJ,WAAW,EAAE,+BAA+B;YAC5C,IAAI,EAAE,OAAO;YACb,OAAO,EAAE,QAAQ;SACpB;QACD,QAAQ,EAAE,CAAC,wBAAwB,EAAE,kDAAkD,CAAC;KAC3F,CAAC;GACI,IAAI,CAgBT;AAED,kBAAe,IAAI,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Shared utility functions for temporal (date/time) operations.
+ *
+ * These helpers are used by the datetime, date, time, localdatetime,
+ * localtime, and timestamp functions.
+ */
+/**
+ * Parses a temporal argument (string or map) into a Date object.
+ *
+ * @param arg - The argument to parse (string or object with year/month/day/hour/minute/second/millisecond)
+ * @param fnName - The calling function name for error messages
+ * @returns A Date object
+ */
+export declare function parseTemporalArg(arg: any, fnName: string): Date;
+/**
+ * Builds a datetime result object with full temporal properties.
+ *
+ * @param d - The Date object
+ * @param utc - If true, use UTC values; if false, use local values
+ * @returns An object with year, month, day, hour, minute, second, millisecond,
+ *          epochMillis, epochSeconds, dayOfWeek, dayOfYear, quarter, formatted
+ */
+export declare function buildDatetimeObject(d: Date, utc: boolean): Record<string, any>;
+/**
+ * Builds a date result object (no time component).
+ *
+ * @param d - The Date object
+ * @returns An object with year, month, day, epochMillis, dayOfWeek, dayOfYear, quarter, formatted
+ */
+export declare function buildDateObject(d: Date): Record<string, any>;
+/**
+ * Builds a time result object (no date component).
+ *
+ * @param d - The Date object
+ * @param utc - If true, use UTC values; if false, use local values
+ * @returns An object with hour, minute, second, millisecond, formatted
+ */
+export declare function buildTimeObject(d: Date, utc: boolean): Record<string, any>;
+//# sourceMappingURL=temporal_utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"temporal_utils.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/temporal_utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+CH;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CA6B/D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CA8B9E;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAkB5D;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAgB1E"}

package/dist/parsing/functions/temporal_utils.js

@@ -0,0 +1,168 @@
+"use strict";
+/**
+ * Shared utility functions for temporal (date/time) operations.
+ *
+ * These helpers are used by the datetime, date, time, localdatetime,
+ * localtime, and timestamp functions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseTemporalArg = parseTemporalArg;
+exports.buildDatetimeObject = buildDatetimeObject;
+exports.buildDateObject = buildDateObject;
+exports.buildTimeObject = buildTimeObject;
+/**
+ * Computes the ISO day of the week (1 = Monday, 7 = Sunday).
+ */
+function isoDayOfWeek(d) {
+    const jsDay = d.getDay(); // 0 = Sunday, 6 = Saturday
+    return jsDay === 0 ? 7 : jsDay;
+}
+/**
+ * Computes the day of the year (1-based).
+ */
+function dayOfYear(d) {
+    const start = new Date(d.getFullYear(), 0, 0);
+    const diff = d.getTime() - start.getTime();
+    const oneDay = 1000 * 60 * 60 * 24;
+    return Math.floor(diff / oneDay);
+}
+/**
+ * Computes the quarter (1-4) from a month (0-11).
+ */
+function quarter(month) {
+    return Math.floor(month / 3) + 1;
+}
+/**
+ * Pads a number to a given width with leading zeros.
+ */
+function pad(n, width = 2) {
+    return String(n).padStart(width, "0");
+}
+/**
+ * Formats a timezone offset in ±HH:MM format.
+ */
+function formatTimezoneOffset(d) {
+    const offset = -d.getTimezoneOffset();
+    if (offset === 0)
+        return "Z";
+    const sign = offset > 0 ? "+" : "-";
+    const absOffset = Math.abs(offset);
+    const hours = Math.floor(absOffset / 60);
+    const minutes = absOffset % 60;
+    return `${sign}${pad(hours)}:${pad(minutes)}`;
+}
+/**
+ * Parses a temporal argument (string or map) into a Date object.
+ *
+ * @param arg - The argument to parse (string or object with year/month/day/hour/minute/second/millisecond)
+ * @param fnName - The calling function name for error messages
+ * @returns A Date object
+ */
+function parseTemporalArg(arg, fnName) {
+    var _a, _b, _c, _d, _e, _f, _g;
+    if (typeof arg === "string") {
+        const d = new Date(arg);
+        if (isNaN(d.getTime())) {
+            throw new Error(`${fnName}(): Invalid temporal string: '${arg}'`);
+        }
+        return d;
+    }
+    if (typeof arg === "number") {
+        // Treat as epoch milliseconds
+        return new Date(arg);
+    }
+    if (typeof arg === "object" && arg !== null && !Array.isArray(arg)) {
+        // Map-style construction: {year, month, day, hour, minute, second, millisecond}
+        const year = (_a = arg.year) !== null && _a !== void 0 ? _a : new Date().getFullYear();
+        const month = ((_b = arg.month) !== null && _b !== void 0 ? _b : 1) - 1; // JS months are 0-based
+        const day = (_c = arg.day) !== null && _c !== void 0 ? _c : 1;
+        const hour = (_d = arg.hour) !== null && _d !== void 0 ? _d : 0;
+        const minute = (_e = arg.minute) !== null && _e !== void 0 ? _e : 0;
+        const second = (_f = arg.second) !== null && _f !== void 0 ? _f : 0;
+        const millisecond = (_g = arg.millisecond) !== null && _g !== void 0 ? _g : 0;
+        return new Date(year, month, day, hour, minute, second, millisecond);
+    }
+    throw new Error(`${fnName}(): Expected a string, number (epoch millis), or map argument, got ${typeof arg}`);
+}
+/**
+ * Builds a datetime result object with full temporal properties.
+ *
+ * @param d - The Date object
+ * @param utc - If true, use UTC values; if false, use local values
+ * @returns An object with year, month, day, hour, minute, second, millisecond,
+ *          epochMillis, epochSeconds, dayOfWeek, dayOfYear, quarter, formatted
+ */
+function buildDatetimeObject(d, utc) {
+    const year = utc ? d.getUTCFullYear() : d.getFullYear();
+    const month = utc ? d.getUTCMonth() + 1 : d.getMonth() + 1;
+    const day = utc ? d.getUTCDate() : d.getDate();
+    const hour = utc ? d.getUTCHours() : d.getHours();
+    const minute = utc ? d.getUTCMinutes() : d.getMinutes();
+    const second = utc ? d.getUTCSeconds() : d.getSeconds();
+    const millisecond = utc ? d.getUTCMilliseconds() : d.getMilliseconds();
+    const datePart = new Date(year, month - 1, day);
+    const formatted = utc
+        ? d.toISOString()
+        : `${year}-${pad(month)}-${pad(day)}T${pad(hour)}:${pad(minute)}:${pad(second)}.${pad(millisecond, 3)}`;
+    return {
+        year,
+        month,
+        day,
+        hour,
+        minute,
+        second,
+        millisecond,
+        epochMillis: d.getTime(),
+        epochSeconds: Math.floor(d.getTime() / 1000),
+        dayOfWeek: isoDayOfWeek(datePart),
+        dayOfYear: dayOfYear(datePart),
+        quarter: quarter(month - 1),
+        formatted,
+    };
+}
+/**
+ * Builds a date result object (no time component).
+ *
+ * @param d - The Date object
+ * @returns An object with year, month, day, epochMillis, dayOfWeek, dayOfYear, quarter, formatted
+ */
+function buildDateObject(d) {
+    const year = d.getFullYear();
+    const month = d.getMonth() + 1;
+    const day = d.getDate();
+    // Strip time component for epoch calculation
+    const dateOnly = new Date(year, month - 1, day);
+    return {
+        year,
+        month,
+        day,
+        epochMillis: dateOnly.getTime(),
+        dayOfWeek: isoDayOfWeek(dateOnly),
+        dayOfYear: dayOfYear(dateOnly),
+        quarter: quarter(month - 1),
+        formatted: `${year}-${pad(month)}-${pad(day)}`,
+    };
+}
+/**
+ * Builds a time result object (no date component).
+ *
+ * @param d - The Date object
+ * @param utc - If true, use UTC values; if false, use local values
+ * @returns An object with hour, minute, second, millisecond, formatted
+ */
+function buildTimeObject(d, utc) {
+    const hour = utc ? d.getUTCHours() : d.getHours();
+    const minute = utc ? d.getUTCMinutes() : d.getMinutes();
+    const second = utc ? d.getUTCSeconds() : d.getSeconds();
+    const millisecond = utc ? d.getUTCMilliseconds() : d.getMilliseconds();
+    const timePart = `${pad(hour)}:${pad(minute)}:${pad(second)}.${pad(millisecond, 3)}`;
+    const formatted = utc ? `${timePart}Z` : timePart;
+    return {
+        hour,
+        minute,
+        second,
+        millisecond,
+        formatted,
+    };
+}
+//# sourceMappingURL=temporal_utils.js.map

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

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

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

@@ -0,0 +1,18 @@
+import Function from "./function";
+/**
+ * Returns a time value (with timezone offset awareness).
+ * When called with no arguments, returns the current UTC time.
+ * When called with a string argument, parses it as an ISO 8601 time.
+ *
+ * @example
+ * ```
+ * RETURN time() AS now
+ * RETURN time('12:30:00') AS t
+ * ```
+ */
+declare class Time extends Function {
+    constructor();
+    value(): any;
+}
+export default Time;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../../src/parsing/functions/time.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,YAAY,CAAC;AAIlC;;;;;;;;;;GAUG;AACH,cAuBM,IAAK,SAAQ,QAAQ;;IAMhB,KAAK,IAAI,GAAG;CAWtB;AAED,eAAe,IAAI,CAAC"}

package/dist/parsing/functions/time.js

@@ -0,0 +1,65 @@
+"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_metadata_1 = require("./function_metadata");
+const temporal_utils_1 = require("./temporal_utils");
+/**
+ * Returns a time value (with timezone offset awareness).
+ * When called with no arguments, returns the current UTC time.
+ * When called with a string argument, parses it as an ISO 8601 time.
+ *
+ * @example
+ * ```
+ * RETURN time() AS now
+ * RETURN time('12:30:00') AS t
+ * ```
+ */
+let Time = class Time extends function_1.default {
+    constructor() {
+        super("time");
+        this._expectedParameterCount = null;
+    }
+    value() {
+        const children = this.getChildren();
+        if (children.length > 1) {
+            throw new Error("time() accepts at most one argument");
+        }
+        const d = children.length === 1 ? (0, temporal_utils_1.parseTemporalArg)(children[0].value(), "time") : new Date();
+        return (0, temporal_utils_1.buildTimeObject)(d, true);
+    }
+};
+Time = __decorate([
+    (0, function_metadata_1.FunctionDef)({
+        description: "Returns a time value. With no arguments returns the current UTC time. " +
+            "Accepts an ISO 8601 time string or a map of components (hour, minute, second, millisecond).",
+        category: "scalar",
+        parameters: [
+            {
+                name: "input",
+                description: "Optional. An ISO 8601 time string (HH:MM:SS) or a map of components.",
+                type: "string",
+                required: false,
+            },
+        ],
+        output: {
+            description: "A time object with properties: hour, minute, second, millisecond, formatted",
+            type: "object",
+        },
+        examples: [
+            "RETURN time() AS now",
+            "RETURN time('12:30:00') AS t",
+            "WITH time() AS t RETURN t.hour, t.minute",
+        ],
+    })
+], Time);
+exports.default = Time;
+//# sourceMappingURL=time.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../../src/parsing/functions/time.ts"],"names":[],"mappings":";;;;;;;;;;;AAAA,0DAAkC;AAClC,2DAAkD;AAClD,qDAAqE;AAErE;;;;;;;;;;GAUG;AAwBH,IAAM,IAAI,GAAV,MAAM,IAAK,SAAQ,kBAAQ;IACvB;QACI,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,uBAAuB,GAAG,IAAI,CAAC;IACxC,CAAC;IAEM,KAAK;QACR,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACpC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,CAAC,GACH,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAA,iCAAgB,EAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAEvF,OAAO,IAAA,gCAAe,EAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;CACJ,CAAA;AAjBK,IAAI;IAvBT,IAAA,+BAAW,EAAC;QACT,WAAW,EACP,wEAAwE;YACxE,6FAA6F;QACjG,QAAQ,EAAE,QAAQ;QAClB,UAAU,EAAE;YACR;gBACI,IAAI,EAAE,OAAO;gBACb,WAAW,EAAE,sEAAsE;gBACnF,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;aAClB;SACJ;QACD,MAAM,EAAE;YACJ,WAAW,EAAE,6EAA6E;YAC1F,IAAI,EAAE,QAAQ;SACjB;QACD,QAAQ,EAAE;YACN,sBAAsB;YACtB,8BAA8B;YAC9B,0CAA0C;SAC7C;KACJ,CAAC;GACI,IAAI,CAiBT;AAED,kBAAe,IAAI,CAAC"}

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

@@ -0,0 +1,15 @@
+import Function from "./function";
+/**
+ * Returns the number of milliseconds since the Unix epoch (1970-01-01T00:00:00Z).
+ *
+ * @example
+ * ```
+ * RETURN timestamp() AS ts
+ * ```
+ */
+declare class Timestamp extends Function {
+    constructor();
+    value(): any;
+}
+export default Timestamp;
+//# sourceMappingURL=timestamp.d.ts.map

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

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