grafeo-ogm 1.0.0

package/dist/cjs/testing/cypher-assert.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CypherAssert = void 0;
+/**
+ * Structural Cypher comparison utility that normalizes whitespace
+ * and parameter names for deterministic test assertions.
+ */
+class CypherAssert {
+    /**
+     * Normalize a Cypher string for structural comparison:
+     * - Collapse all whitespace sequences to a single space
+     * - Trim leading/trailing whitespace
+     * - Rename params to canonical $p0, $p1, etc. (in order of appearance)
+     */
+    static normalize(cypher) {
+        const collapsed = cypher.replace(/\s+/g, ' ').trim();
+        const seen = new Map();
+        let counter = 0;
+        const normalized = collapsed.replace(/\$[a-zA-Z_][a-zA-Z0-9_]*/g, (match) => {
+            if (!seen.has(match))
+                seen.set(match, `$p${counter++}`);
+            return seen.get(match);
+        });
+        return normalized;
+    }
+    /**
+     * Assert two Cypher strings are structurally equal after normalization.
+     * Throws an Error if they differ.
+     */
+    static assertStructurallyEqual(actual, expected) {
+        const normalizedActual = CypherAssert.normalize(actual);
+        const normalizedExpected = CypherAssert.normalize(expected);
+        if (normalizedActual !== normalizedExpected)
+            throw new Error(`Cypher mismatch:\n  Actual:   ${normalizedActual}\n  Expected: ${normalizedExpected}`);
+    }
+    /**
+     * Assert that a Cypher string contains a specific clause.
+     * @param cypher - The full Cypher string
+     * @param clauseType - e.g., 'WHERE', 'MATCH', 'RETURN', 'SET'
+     * @param pattern - Substring to search for within the clause
+     */
+    static assertContainsClause(cypher, clauseType, pattern) {
+        if (!cypher.toUpperCase().includes(clauseType.toUpperCase()))
+            throw new Error(`Cypher does not contain clause '${clauseType}':\n  ${cypher}`);
+        if (!cypher.includes(pattern))
+            throw new Error(`Cypher does not contain pattern '${pattern}':\n  ${cypher}`);
+    }
+    /**
+     * Assert that a Cypher string does NOT contain a specific clause/pattern.
+     */
+    static assertNotContainsClause(cypher, clauseTypeOrPattern, pattern) {
+        const effectivePattern = pattern ?? clauseTypeOrPattern;
+        if (cypher.includes(effectivePattern))
+            throw new Error(`Cypher unexpectedly contains pattern '${effectivePattern}':\n  ${cypher}`);
+    }
+    /**
+     * Assert parameter values match expected.
+     * Only checks the keys present in expected (doesn't require exact match on all params).
+     */
+    static assertParams(actual, expected) {
+        for (const key of Object.keys(expected)) {
+            if (!(key in actual))
+                throw new Error(`Missing param key '${key}' in actual params: ${JSON.stringify(actual)}`);
+            const actualVal = JSON.stringify(actual[key]);
+            const expectedVal = JSON.stringify(expected[key]);
+            if (actualVal !== expectedVal)
+                throw new Error(`Param '${key}' mismatch:\n  Actual:   ${actualVal}\n  Expected: ${expectedVal}`);
+        }
+    }
+}
+exports.CypherAssert = CypherAssert;
+//# sourceMappingURL=cypher-assert.js.map

package/dist/cjs/testing/cypher-assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cypher-assert.js","sourceRoot":"","sources":["../../../src/testing/cypher-assert.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,MAAc;QAC7B,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAErD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;QACvC,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,MAAM,UAAU,GAAG,SAAS,CAAC,OAAO,CAClC,2BAA2B,EAC3B,CAAC,KAAK,EAAE,EAAE;YACR,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,OAAO,EAAE,EAAE,CAAC,CAAC;YAExD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;QAC1B,CAAC,CACF,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAAc,EAAE,QAAgB;QAC7D,MAAM,gBAAgB,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,kBAAkB,GAAG,YAAY,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC5D,IAAI,gBAAgB,KAAK,kBAAkB;YACzC,MAAM,IAAI,KAAK,CACb,iCAAiC,gBAAgB,iBAAiB,kBAAkB,EAAE,CACvF,CAAC;IACN,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CACzB,MAAc,EACd,UAAkB,EAClB,OAAe;QAEf,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;YAC1D,MAAM,IAAI,KAAK,CACb,mCAAmC,UAAU,SAAS,MAAM,EAAE,CAC/D,CAAC;QAEJ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC3B,MAAM,IAAI,KAAK,CACb,oCAAoC,OAAO,SAAS,MAAM,EAAE,CAC7D,CAAC;IACN,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC5B,MAAc,EACd,mBAA2B,EAC3B,OAAgB;QAEhB,MAAM,gBAAgB,GAAG,OAAO,IAAI,mBAAmB,CAAC;QACxD,IAAI,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,yCAAyC,gBAAgB,SAAS,MAAM,EAAE,CAC3E,CAAC;IACN,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY,CACjB,MAA+B,EAC/B,QAAiC;QAEjC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC;gBAClB,MAAM,IAAI,KAAK,CACb,sBAAsB,GAAG,uBAAuB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CACzE,CAAC;YAEJ,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9C,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YAClD,IAAI,SAAS,KAAK,WAAW;gBAC3B,MAAM,IAAI,KAAK,CACb,UAAU,GAAG,4BAA4B,SAAS,iBAAiB,WAAW,EAAE,CACjF,CAAC;QACN,CAAC;IACH,CAAC;CACF;AAjGD,oCAiGC"}

package/dist/cjs/testing/index.d.ts

@@ -0,0 +1,4 @@
+export { CypherAssert } from './cypher-assert';
+export { Neo4jRecordFactory } from './neo4j-record-factory';
+export { SelectionSetFactory } from './selection-set-factory';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/cjs/testing/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SelectionSetFactory = exports.Neo4jRecordFactory = exports.CypherAssert = void 0;
+var cypher_assert_1 = require("./cypher-assert");
+Object.defineProperty(exports, "CypherAssert", { enumerable: true, get: function () { return cypher_assert_1.CypherAssert; } });
+var neo4j_record_factory_1 = require("./neo4j-record-factory");
+Object.defineProperty(exports, "Neo4jRecordFactory", { enumerable: true, get: function () { return neo4j_record_factory_1.Neo4jRecordFactory; } });
+var selection_set_factory_1 = require("./selection-set-factory");
+Object.defineProperty(exports, "SelectionSetFactory", { enumerable: true, get: function () { return selection_set_factory_1.SelectionSetFactory; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,6GAAA,YAAY,OAAA;AACrB,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAC3B,iEAA8D;AAArD,4HAAA,mBAAmB,OAAA"}

package/dist/cjs/testing/neo4j-record-factory.d.ts

@@ -0,0 +1,25 @@
+import { Integer, Record as Neo4jRecord } from 'neo4j-driver';
+/**
+ * Factory for creating mock Neo4j Record objects for testing.
+ */
+export declare class Neo4jRecordFactory {
+    /**
+     * Create a Neo4j Record from a plain object.
+     * @param data - Object with keys as field names and values as properties
+     * @returns A Neo4j Record instance with get(), toObject(), and keys
+     */
+    static create(data: Record<string, unknown>): Neo4jRecord;
+    /**
+     * Create a Neo4j Integer value.
+     */
+    static integer(value: number): Integer;
+    /**
+     * Create a Neo4j DateTime value from an ISO string.
+     */
+    static dateTime(isoString: string): unknown;
+    /**
+     * Create a mock Neo4j Node.
+     */
+    static node(labels: string[], properties: Record<string, unknown>): unknown;
+}
+//# sourceMappingURL=neo4j-record-factory.d.ts.map

package/dist/cjs/testing/neo4j-record-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j-record-factory.d.ts","sourceRoot":"","sources":["../../../src/testing/neo4j-record-factory.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,OAAO,EAAE,MAAM,IAAI,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE;;GAEG;AACH,qBAAa,kBAAkB;IAC7B;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW;IAMzD;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAc3C;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;CAG5E"}

package/dist/cjs/testing/neo4j-record-factory.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Neo4jRecordFactory = void 0;
+const neo4j_driver_1 = __importDefault(require("neo4j-driver"));
+/**
+ * Factory for creating mock Neo4j Record objects for testing.
+ */
+class Neo4jRecordFactory {
+    /**
+     * Create a Neo4j Record from a plain object.
+     * @param data - Object with keys as field names and values as properties
+     * @returns A Neo4j Record instance with get(), toObject(), and keys
+     */
+    static create(data) {
+        const keys = Object.keys(data);
+        const values = keys.map((k) => data[k]);
+        return new neo4j_driver_1.default.types.Record(keys, values);
+    }
+    /**
+     * Create a Neo4j Integer value.
+     */
+    static integer(value) {
+        return neo4j_driver_1.default.int(value);
+    }
+    /**
+     * Create a Neo4j DateTime value from an ISO string.
+     */
+    static dateTime(isoString) {
+        const d = new Date(isoString);
+        return new neo4j_driver_1.default.types.DateTime(d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate(), d.getUTCHours(), d.getUTCMinutes(), d.getUTCSeconds(), d.getUTCMilliseconds() * 1000000, 0);
+    }
+    /**
+     * Create a mock Neo4j Node.
+     */
+    static node(labels, properties) {
+        return new neo4j_driver_1.default.types.Node(neo4j_driver_1.default.int(0), labels, properties);
+    }
+}
+exports.Neo4jRecordFactory = Neo4jRecordFactory;
+//# sourceMappingURL=neo4j-record-factory.js.map

package/dist/cjs/testing/neo4j-record-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"neo4j-record-factory.js","sourceRoot":"","sources":["../../../src/testing/neo4j-record-factory.ts"],"names":[],"mappings":";;;;;;AAAA,gEAAqE;AAErE;;GAEG;AACH,MAAa,kBAAkB;IAC7B;;;;OAIG;IACH,MAAM,CAAC,MAAM,CAAC,IAA6B;QACzC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO,IAAI,sBAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAA2B,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,sBAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,SAAiB;QAC/B,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC;QAC9B,OAAO,IAAI,sBAAK,CAAC,KAAK,CAAC,QAAQ,CAC7B,CAAC,CAAC,cAAc,EAAE,EAClB,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EACnB,CAAC,CAAC,UAAU,EAAE,EACd,CAAC,CAAC,WAAW,EAAE,EACf,CAAC,CAAC,aAAa,EAAE,EACjB,CAAC,CAAC,aAAa,EAAE,EACjB,CAAC,CAAC,kBAAkB,EAAE,GAAG,OAAS,EAClC,CAAC,CACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,MAAgB,EAAE,UAAmC;QAC/D,OAAO,IAAI,sBAAK,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;IAChE,CAAC;CACF;AA1CD,gDA0CC"}

package/dist/cjs/testing/selection-set-factory.d.ts

@@ -0,0 +1,24 @@
+type FieldSpec = string | Record<string, FieldSpec[]>;
+/**
+ * Convenience factory for building GraphQL selection sets in tests.
+ */
+export declare class SelectionSetFactory {
+    /**
+     * Build a GraphQL selection set string from a simplified spec.
+     *
+     * @example
+     *   SelectionSetFactory.gql(['id', 'name', { drugs: ['id', 'drugName'] }])
+     *   // => '{ id name drugs { id drugName } }'
+     */
+    static gql(fields: FieldSpec[]): string;
+    /**
+     * Build a select object from a simplified spec.
+     *
+     * @example
+     *   SelectionSetFactory.select(['id', 'name', { drugs: ['id', 'drugName'] }])
+     *   // => { id: true, name: true, drugs: { select: { id: true, drugName: true } } }
+     */
+    static select(fields: FieldSpec[]): Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=selection-set-factory.d.ts.map

package/dist/cjs/testing/selection-set-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-set-factory.d.ts","sourceRoot":"","sources":["../../../src/testing/selection-set-factory.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AAEtD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM;IAYvC;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAW5D"}

package/dist/cjs/testing/selection-set-factory.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SelectionSetFactory = void 0;
+/**
+ * Convenience factory for building GraphQL selection sets in tests.
+ */
+class SelectionSetFactory {
+    /**
+     * Build a GraphQL selection set string from a simplified spec.
+     *
+     * @example
+     *   SelectionSetFactory.gql(['id', 'name', { drugs: ['id', 'drugName'] }])
+     *   // => '{ id name drugs { id drugName } }'
+     */
+    static gql(fields) {
+        const parts = [];
+        for (const field of fields)
+            if (typeof field === 'string')
+                parts.push(field);
+            else
+                for (const [key, nested] of Object.entries(field))
+                    parts.push(`${key} ${SelectionSetFactory.gql(nested)}`);
+        return `{ ${parts.join(' ')} }`;
+    }
+    /**
+     * Build a select object from a simplified spec.
+     *
+     * @example
+     *   SelectionSetFactory.select(['id', 'name', { drugs: ['id', 'drugName'] }])
+     *   // => { id: true, name: true, drugs: { select: { id: true, drugName: true } } }
+     */
+    static select(fields) {
+        const result = {};
+        for (const field of fields)
+            if (typeof field === 'string')
+                result[field] = true;
+            else
+                for (const [key, nested] of Object.entries(field))
+                    result[key] = { select: SelectionSetFactory.select(nested) };
+        return result;
+    }
+}
+exports.SelectionSetFactory = SelectionSetFactory;
+//# sourceMappingURL=selection-set-factory.js.map

package/dist/cjs/testing/selection-set-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection-set-factory.js","sourceRoot":"","sources":["../../../src/testing/selection-set-factory.ts"],"names":[],"mappings":";;;AAEA;;GAEG;AACH,MAAa,mBAAmB;IAC9B;;;;;;OAMG;IACH,MAAM,CAAC,GAAG,CAAC,MAAmB;QAC5B,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,KAAK,IAAI,MAAM;YACxB,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;;gBAE/C,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;oBAC/C,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAE9D,OAAO,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;IAClC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,MAAmB;QAC/B,MAAM,MAAM,GAA4B,EAAE,CAAC;QAE3C,KAAK,MAAM,KAAK,IAAI,MAAM;YACxB,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;;gBAElD,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;oBAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAEnE,OAAO,MAAM,CAAC;IAChB,CAAC;CACF;AAtCD,kDAsCC"}

package/dist/cjs/utils/lucene.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Escapes special Lucene characters in a query string.
+ * Special characters: + - && || ! ( ) { } [ ] ^ " ~ * ? : \ /
+ *
+ * Handles multi-character operators (&&, ||) as atomic units,
+ * then escapes remaining individual special characters.
+ */
+export declare function sanitizeLuceneQuery(query: string): string;
+//# sourceMappingURL=lucene.d.ts.map

package/dist/cjs/utils/lucene.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucene.d.ts","sourceRoot":"","sources":["../../../src/utils/lucene.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgBzD"}

package/dist/cjs/utils/lucene.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeLuceneQuery = sanitizeLuceneQuery;
+/**
+ * Escapes special Lucene characters in a query string.
+ * Special characters: + - && || ! ( ) { } [ ] ^ " ~ * ? : \ /
+ *
+ * Handles multi-character operators (&&, ||) as atomic units,
+ * then escapes remaining individual special characters.
+ */
+function sanitizeLuceneQuery(query) {
+    // First pass: escape multi-char operators as atomic units
+    // Use placeholders to prevent double-escaping by the second pass
+    let result = query
+        .replace(/&&/g, '\u0000AND\u0000')
+        .replace(/\|\|/g, '\u0000OR\u0000');
+    // Second pass: escape individual special characters (& and | individually)
+    result = result.replace(/([+\-&|!(){}[\]^"~*?:\\/])/g, '\\$1');
+    // Restore multi-char operators with proper escaping
+    result = result
+        .replace(/\u0000AND\u0000/g, '\\&\\&')
+        .replace(/\u0000OR\u0000/g, '\\|\\|');
+    return result;
+}
+//# sourceMappingURL=lucene.js.map

package/dist/cjs/utils/lucene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucene.js","sourceRoot":"","sources":["../../../src/utils/lucene.ts"],"names":[],"mappings":";;AAOA,kDAgBC;AAvBD;;;;;;GAMG;AACH,SAAgB,mBAAmB,CAAC,KAAa;IAC/C,0DAA0D;IAC1D,iEAAiE;IACjE,IAAI,MAAM,GAAG,KAAK;SACf,OAAO,CAAC,KAAK,EAAE,iBAAiB,CAAC;SACjC,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IAEtC,2EAA2E;IAC3E,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;IAE/D,oDAAoD;IACpD,MAAM,GAAG,MAAM;SACZ,OAAO,CAAC,kBAAkB,EAAE,QAAQ,CAAC;SACrC,OAAO,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAExC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/cjs/utils/validation.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Assert that a key is not a prototype pollution vector.
+ */
+export declare function assertSafeKey(key: string, context: string): void;
+/**
+ * Validate that a string is a safe Cypher identifier.
+ * Throws if the identifier contains characters that could enable Cypher injection.
+ */
+export declare function assertSafeIdentifier(value: string, context: string): void;
+/**
+ * Escape an identifier for safe interpolation into Cypher queries.
+ * Wraps in backticks and doubles any existing backticks inside.
+ * This handles Cypher reserved words (ORDER, MATCH, SET, CALL, etc.)
+ * since backtick-quoted identifiers bypass keyword interpretation.
+ */
+export declare function escapeIdentifier(identifier: string): string;
+/**
+ * Validate a label name is a safe identifier and return it backtick-escaped.
+ */
+export declare function assertSafeLabel(label: string): string;
+/**
+ * Validate sort direction is strictly ASC or DESC.
+ */
+export declare function assertSortDirection(direction: string): 'ASC' | 'DESC';
+//# sourceMappingURL=validation.d.ts.map

package/dist/cjs/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKhE;AAKD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKzE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAG3D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,CAMrE"}

package/dist/cjs/utils/validation.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertSafeKey = assertSafeKey;
+exports.assertSafeIdentifier = assertSafeIdentifier;
+exports.escapeIdentifier = escapeIdentifier;
+exports.assertSafeLabel = assertSafeLabel;
+exports.assertSortDirection = assertSortDirection;
+const errors_1 = require("../errors");
+/** Dangerous property names that could indicate prototype pollution */
+const BLOCKED_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
+/**
+ * Assert that a key is not a prototype pollution vector.
+ */
+function assertSafeKey(key, context) {
+    if (BLOCKED_KEYS.has(key))
+        throw new errors_1.OGMError(`Potentially dangerous key "${key}" in ${context}. This key is not allowed.`);
+}
+/** Regex for valid Cypher identifiers */
+const SAFE_IDENTIFIER = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+/**
+ * Validate that a string is a safe Cypher identifier.
+ * Throws if the identifier contains characters that could enable Cypher injection.
+ */
+function assertSafeIdentifier(value, context) {
+    if (!SAFE_IDENTIFIER.test(value))
+        throw new errors_1.OGMError(`Invalid identifier "${value}" in ${context}. Identifiers must match /^[a-zA-Z_][a-zA-Z0-9_]*$/.`);
+}
+/**
+ * Escape an identifier for safe interpolation into Cypher queries.
+ * Wraps in backticks and doubles any existing backticks inside.
+ * This handles Cypher reserved words (ORDER, MATCH, SET, CALL, etc.)
+ * since backtick-quoted identifiers bypass keyword interpretation.
+ */
+function escapeIdentifier(identifier) {
+    const sanitized = identifier.replace(/`/g, '``');
+    return `\`${sanitized}\``;
+}
+/**
+ * Validate a label name is a safe identifier and return it backtick-escaped.
+ */
+function assertSafeLabel(label) {
+    assertSafeIdentifier(label, 'label');
+    return escapeIdentifier(label);
+}
+/**
+ * Validate sort direction is strictly ASC or DESC.
+ */
+function assertSortDirection(direction) {
+    if (direction !== 'ASC' && direction !== 'DESC')
+        throw new errors_1.OGMError(`Invalid sort direction "${direction}". Must be "ASC" or "DESC".`);
+    return direction;
+}
+//# sourceMappingURL=validation.js.map

package/dist/cjs/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":";;AAQA,sCAKC;AASD,oDAKC;AAQD,4CAGC;AAKD,0CAGC;AAKD,kDAMC;AAzDD,sCAAqC;AAErC,uEAAuE;AACvE,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC,CAAC;AAExE;;GAEG;AACH,SAAgB,aAAa,CAAC,GAAW,EAAE,OAAe;IACxD,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;QACvB,MAAM,IAAI,iBAAQ,CAChB,8BAA8B,GAAG,QAAQ,OAAO,4BAA4B,CAC7E,CAAC;AACN,CAAC;AAED,yCAAyC;AACzC,MAAM,eAAe,GAAG,0BAA0B,CAAC;AAEnD;;;GAGG;AACH,SAAgB,oBAAoB,CAAC,KAAa,EAAE,OAAe;IACjE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9B,MAAM,IAAI,iBAAQ,CAChB,uBAAuB,KAAK,QAAQ,OAAO,sDAAsD,CAClG,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,SAAgB,gBAAgB,CAAC,UAAkB;IACjD,MAAM,SAAS,GAAG,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,OAAO,KAAK,SAAS,IAAI,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,SAAgB,eAAe,CAAC,KAAa;IAC3C,oBAAoB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,SAAiB;IACnD,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,MAAM;QAC7C,MAAM,IAAI,iBAAQ,CAChB,2BAA2B,SAAS,6BAA6B,CAClE,CAAC;IACJ,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/esm/compilers/fulltext.compiler.d.ts

@@ -0,0 +1,67 @@
+import { FulltextInput } from '../model';
+import { FulltextIndex, NodeDefinition, SchemaMetadata } from '../schema/types';
+export interface FulltextResult {
+    cypher: string;
+    params: Record<string, unknown>;
+    scoreThreshold?: number;
+}
+/**
+ * Compiles fulltext search input into Cypher CALL clauses using
+ * db.index.fulltext.queryNodes and db.index.fulltext.queryRelationships.
+ *
+ * Supports logical operators:
+ * - **Leaf (node index)**: `{ IndexName: { phrase, score? } }` → `queryNodes`
+ * - **Leaf (relationship index)**: `{ relField: { IndexName: { phrase, score? } } }` → `queryRelationships`
+ * - **OR**: `CALL { ... UNION ... }` combining multiple branches
+ * - **AND**: Sequential correlated subqueries with node identity matching
+ * - **NOT**: `WHERE NOT EXISTS { ... }` exclusion pattern (Neo4j 5+)
+ */
+export declare class FulltextCompiler {
+    private schema;
+    constructor(schema: SchemaMetadata);
+    /**
+     * Compile fulltext input to Cypher CALL clause(s).
+     * Handles flat leaves AND recursive OR/AND/NOT expressions.
+     */
+    compile(fulltext: FulltextInput, nodeDef: NodeDefinition, nodeVar?: string): FulltextResult;
+    /**
+     * Compile fulltext input for a relationship index into a Cypher CALL clause.
+     * Uses db.index.fulltext.queryRelationships.
+     */
+    compileRelationship(fulltext: Record<string, {
+        phrase: string;
+        score?: number;
+    }>, relIndex: FulltextIndex, relVar?: string): FulltextResult;
+    private compileNode;
+    /**
+     * Compile a leaf entry. Two shapes:
+     * - Node index: `{ IndexName: { phrase, score? } }` — value has `phrase`
+     * - Relationship index: `{ relField: { IndexName: { phrase, score? } } }` — value is nested
+     */
+    private compileLeaf;
+    /** Compile a node-level fulltext index: `{ IndexName: { phrase, score? } }` */
+    private compileNodeIndex;
+    /**
+     * Compile a relationship fulltext index:
+     * `{ relFieldName: { IndexName: { phrase, score? } } }`
+     *
+     * Validates that the relationship field exists on the node and that the
+     * index belongs to its @relationshipProperties type.
+     */
+    private compileRelationshipIndex;
+    /**
+     * OR: wrap branches in `CALL { ... UNION ... }` with max(score) deduplication.
+     */
+    private compileOr;
+    /**
+     * AND: sequential correlated subqueries.
+     * First branch yields nodes, subsequent branches filter to matching nodes.
+     */
+    private compileAnd;
+    /**
+     * NOT: produces a WHERE NOT EXISTS { ... } clause.
+     * When used standalone, wraps in a MATCH-all then filters out.
+     */
+    private compileNot;
+}
+//# sourceMappingURL=fulltext.compiler.d.ts.map

package/dist/esm/compilers/fulltext.compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulltext.compiler.d.ts","sourceRoot":"","sources":["../../../src/compilers/fulltext.compiler.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,aAAa,EAEd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAMhF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE1C;;;OAGG;IACH,OAAO,CACL,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,cAAc,EACvB,OAAO,SAAM,GACZ,cAAc;IAqBjB;;;OAGG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,EAC5D,QAAQ,EAAE,aAAa,EACvB,MAAM,SAAM,GACX,cAAc;IA4CjB,OAAO,CAAC,WAAW;IA4CnB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAgCnB,+EAA+E;IAC/E,OAAO,CAAC,gBAAgB;IAqCxB;;;;;;OAMG;IACH,OAAO,CAAC,wBAAwB;IAmEhC;;OAEG;IACH,OAAO,CAAC,SAAS;IAiDjB;;;OAGG;IACH,OAAO,CAAC,UAAU;IA8DlB;;;OAGG;IACH,OAAO,CAAC,UAAU;CA2BnB"}