grafeo-ogm 1.0.0

package/dist/cjs/compilers/where.compiler.js

@@ -0,0 +1,456 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhereCompiler = void 0;
+const errors_1 = require("../errors");
+const utils_1 = require("../schema/utils");
+const validation_1 = require("../utils/validation");
+const MAX_DEPTH = 10;
+/** Ordered longest-first so greedy matching works */
+const OPERATOR_SUFFIXES = [
+    '_NOT_STARTS_WITH',
+    '_NOT_ENDS_WITH',
+    '_NOT_CONTAINS',
+    '_NOT_IN',
+    '_STARTS_WITH',
+    '_ENDS_WITH',
+    '_CONTAINS',
+    '_MATCHES',
+    '_GTE',
+    '_LTE',
+    '_NOT',
+    '_GT',
+    '_LT',
+    '_IN',
+];
+const RELATIONSHIP_SUFFIXES = ['_SOME', '_NONE', '_ALL', '_SINGLE'];
+const CONNECTION_SUFFIXES = [
+    'Connection_SOME',
+    'Connection_NONE',
+    'Connection_ALL',
+    'Connection_SINGLE',
+    'Connection_NOT',
+    'Connection',
+];
+/**
+ * Compiles a Where input object into a Cypher WHERE clause fragment + params.
+ */
+class WhereCompiler {
+    constructor(schema, options) {
+        this.schema = schema;
+        this.disabledOperators = options?.disabledOperators ?? new Set();
+    }
+    compile(where, nodeVar, nodeDef, paramCounter = { count: 0 }) {
+        if (where == null || Object.keys(where).length === 0)
+            return { cypher: '', params: {} };
+        return this.compileConditions(where, nodeVar, nodeDef, paramCounter, 0);
+    }
+    compileConditions(where, nodeVar, nodeDef, counter, depth) {
+        if (depth > MAX_DEPTH)
+            throw new errors_1.OGMError(`WHERE clause nesting depth exceeds maximum (${MAX_DEPTH})`);
+        if (where == null)
+            return { cypher: '', params: {} };
+        const clauses = [];
+        const params = {};
+        for (const [key, value] of Object.entries(where)) {
+            if (value === undefined)
+                continue;
+            (0, validation_1.assertSafeKey)(key, 'where input');
+            // Logical operators (check before null handling so NOT with null value is handled correctly)
+            if (key === 'AND' || key === 'OR') {
+                const items = value;
+                const subResults = items.map((item) => this.compileConditions(item, nodeVar, nodeDef, counter, depth + 1));
+                const subClauses = subResults.map((r) => r.cypher).filter(Boolean);
+                if (subClauses.length > 0) {
+                    clauses.push(`(${subClauses.join(` ${key} `)})`);
+                    for (const r of subResults)
+                        Object.assign(params, r.params);
+                }
+                continue;
+            }
+            if (key === 'NOT') {
+                if (value === null)
+                    // NOT: null inside a relationship context is a no-op (handled by bare relationship _SOME)
+                    continue;
+                const sub = this.compileConditions(value, nodeVar, nodeDef, counter, depth + 1);
+                if (sub.cypher) {
+                    clauses.push(`NOT (${sub.cypher})`);
+                    Object.assign(params, sub.params);
+                }
+                continue;
+            }
+            // Handle null values: relationship null → NOT EXISTS, scalar null → IS NULL
+            if (value === null) {
+                const relDef = nodeDef.relationships.get(key);
+                if (relDef) {
+                    // Relationship null means "no such relationship exists"
+                    const targetNodeDef = (0, utils_1.resolveTargetDef)(relDef.target, this.schema);
+                    if (targetNodeDef) {
+                        const relVar = `r${counter.count}`;
+                        counter.count++;
+                        const pattern = this.buildRelPattern(nodeVar, relDef, relVar);
+                        clauses.push(`NOT EXISTS { MATCH ${pattern} }`);
+                    }
+                }
+                else {
+                    // Scalar null means "property IS NULL"
+                    (0, validation_1.assertSafeIdentifier)(key, 'where clause');
+                    clauses.push(`${nodeVar}.${(0, validation_1.escapeIdentifier)(key)} IS NULL`);
+                }
+                continue;
+            }
+            // Connection operators (e.g. hasStatusConnection_SOME)
+            const connResult = this.tryCompileConnection(key, value, nodeVar, nodeDef, counter, depth);
+            if (connResult) {
+                clauses.push(connResult.cypher);
+                Object.assign(params, connResult.params);
+                continue;
+            }
+            // Relationship operators (e.g. drugs_SOME, drugs_NONE)
+            const relResult = this.tryCompileRelationship(key, value, nodeVar, nodeDef, counter, depth);
+            if (relResult) {
+                clauses.push(relResult.cypher);
+                Object.assign(params, relResult.params);
+                continue;
+            }
+            // Scalar property operators
+            const scalarResult = this.compileScalarCondition(key, value, nodeVar, counter);
+            clauses.push(scalarResult.cypher);
+            Object.assign(params, scalarResult.params);
+        }
+        return {
+            cypher: clauses.join(' AND '),
+            params,
+        };
+    }
+    tryCompileConnection(key, value, nodeVar, nodeDef, counter, depth) {
+        let connSuffix = null;
+        let fieldName = '';
+        for (const suffix of CONNECTION_SUFFIXES)
+            if (key.endsWith(suffix)) {
+                connSuffix = suffix;
+                fieldName = key.slice(0, -suffix.length);
+                break;
+            }
+        if (!connSuffix)
+            return null;
+        (0, validation_1.assertSafeIdentifier)(fieldName, 'connection field');
+        const relDef = nodeDef.relationships.get(fieldName);
+        if (!relDef)
+            return null;
+        const targetNodeDef = (0, utils_1.resolveTargetDef)(relDef.target, this.schema);
+        if (!targetNodeDef)
+            throw new errors_1.OGMError(`Target node "${relDef.target}" not found in schema for connection "${key}"`);
+        const relVar = `r${counter.count}`;
+        const edgeVar = `e${counter.count}`;
+        counter.count++;
+        const pattern = this.buildRelPattern(nodeVar, relDef, relVar, edgeVar);
+        const innerClauses = [];
+        const innerParams = {};
+        // node conditions
+        if (value.node) {
+            const nodeResult = this.compileConditions(value.node, relVar, targetNodeDef, counter, depth + 1);
+            if (nodeResult.cypher) {
+                innerClauses.push(nodeResult.cypher);
+                Object.assign(innerParams, nodeResult.params);
+            }
+        }
+        // edge conditions
+        if (value.edge && relDef.properties) {
+            const propsDef = this.schema.relationshipProperties.get(relDef.properties);
+            if (propsDef) {
+                // Build a pseudo NodeDefinition for edge property compilation
+                const edgeResult = this.compileEdgeConditions(value.edge, edgeVar, counter);
+                if (edgeResult.cypher) {
+                    innerClauses.push(edgeResult.cypher);
+                    Object.assign(innerParams, edgeResult.params);
+                }
+            }
+        }
+        const whereClause = innerClauses.length > 0 ? ` WHERE ${innerClauses.join(' AND ')}` : '';
+        switch (connSuffix) {
+            case 'Connection':
+            case 'Connection_SOME':
+                return {
+                    cypher: `EXISTS { MATCH ${pattern}${whereClause} }`,
+                    params: innerParams,
+                };
+            case 'Connection_NOT':
+            case 'Connection_NONE':
+                return {
+                    cypher: `NOT EXISTS { MATCH ${pattern}${whereClause} }`,
+                    params: innerParams,
+                };
+            case 'Connection_ALL':
+                if (innerClauses.length > 0)
+                    return {
+                        cypher: `NOT EXISTS { MATCH ${pattern} WHERE NOT (${innerClauses.join(' AND ')}) }`,
+                        params: innerParams,
+                    };
+                return { cypher: '', params: {} };
+            case 'Connection_SINGLE':
+                return {
+                    cypher: `size([(${pattern}${whereClause} | 1)]) = 1`,
+                    params: innerParams,
+                };
+            default:
+                return null;
+        }
+    }
+    tryCompileRelationship(key, value, nodeVar, nodeDef, counter, depth) {
+        let suffix = null;
+        let fieldName = key;
+        for (const s of RELATIONSHIP_SUFFIXES)
+            if (key.endsWith(s)) {
+                suffix = s;
+                fieldName = key.slice(0, -s.length);
+                break;
+            }
+        // Bare relationship key (no suffix) — treat as _SOME
+        if (!suffix) {
+            const bareRelDef = nodeDef.relationships.get(key);
+            if (bareRelDef) {
+                suffix = '_SOME';
+                fieldName = key;
+            }
+            else
+                return null;
+        }
+        (0, validation_1.assertSafeIdentifier)(fieldName, 'relationship field');
+        const relDef = nodeDef.relationships.get(fieldName);
+        if (!relDef)
+            return null;
+        // Check if the relationship target is a union type
+        const isUnionTarget = !this.schema.nodes.has(relDef.target) &&
+            this.schema.unions?.has(relDef.target);
+        if (isUnionTarget)
+            return this.compileUnionRelationship(suffix, value, nodeVar, relDef, counter, depth);
+        const targetNodeDef = (0, utils_1.resolveTargetDef)(relDef.target, this.schema);
+        if (!targetNodeDef)
+            throw new errors_1.OGMError(`Target node "${relDef.target}" not found in schema for relationship "${key}"`);
+        const relVar = `r${counter.count}`;
+        counter.count++;
+        const pattern = this.buildRelPattern(nodeVar, relDef, relVar);
+        const innerResult = this.compileConditions(value, relVar, targetNodeDef, counter, depth + 1);
+        const whereClause = innerResult.cypher
+            ? ` WHERE ${innerResult.cypher}`
+            : '';
+        switch (suffix) {
+            case '_SOME':
+                return {
+                    cypher: `EXISTS { MATCH ${pattern}${whereClause} }`,
+                    params: innerResult.params,
+                };
+            case '_NONE':
+                return {
+                    cypher: `NOT EXISTS { MATCH ${pattern}${whereClause} }`,
+                    params: innerResult.params,
+                };
+            case '_ALL':
+                // All matching rels must satisfy: NOT EXISTS { MATCH pattern WHERE NOT (inner) }
+                if (innerResult.cypher)
+                    return {
+                        cypher: `NOT EXISTS { MATCH ${pattern} WHERE NOT (${innerResult.cypher}) }`,
+                        params: innerResult.params,
+                    };
+                return { cypher: '', params: {} };
+            case '_SINGLE': {
+                // Exactly one relationship satisfies
+                counter.count++;
+                return {
+                    cypher: `size([${relVar} IN [(${pattern}${whereClause} | ${relVar})] | ${relVar}]) = 1`,
+                    params: innerResult.params,
+                };
+            }
+            default:
+                return null;
+        }
+    }
+    /**
+     * Compiles a relationship WHERE clause targeting a union type.
+     * Union WHERE inputs use member names as keys (e.g., `{ StandardDose: {} }`).
+     * Each member generates a separate EXISTS pattern using the member's labels.
+     * Multiple members are combined with OR.
+     */
+    compileUnionRelationship(suffix, value, nodeVar, relDef, counter, depth) {
+        const unionMembers = this.schema.unions.get(relDef.target);
+        const memberClauses = [];
+        const allParams = {};
+        for (const [memberKey, memberValue] of Object.entries(value)) {
+            if (!unionMembers.includes(memberKey))
+                continue;
+            const memberDef = this.schema.nodes.get(memberKey);
+            if (!memberDef)
+                continue;
+            const relVar = `r${counter.count}`;
+            counter.count++;
+            const labelStr = (0, utils_1.getTargetLabelString)(memberDef);
+            const pattern = this.buildRelPatternWithLabel(nodeVar, relDef, relVar, labelStr);
+            // Compile inner WHERE conditions for this member (if any properties specified)
+            const memberWhere = memberValue;
+            let whereClause = '';
+            if (memberWhere && Object.keys(memberWhere).length > 0) {
+                const innerResult = this.compileConditions(memberWhere, relVar, memberDef, counter, depth + 1);
+                if (innerResult.cypher) {
+                    whereClause = ` WHERE ${innerResult.cypher}`;
+                    Object.assign(allParams, innerResult.params);
+                }
+            }
+            memberClauses.push(`EXISTS { MATCH ${pattern}${whereClause} }`);
+        }
+        if (memberClauses.length === 0)
+            return { cypher: '', params: {} };
+        // Combine member clauses — for _SOME/_ALL, any member match counts
+        const combined = memberClauses.length === 1
+            ? memberClauses[0]
+            : `(${memberClauses.join(' OR ')})`;
+        switch (suffix) {
+            case '_SOME':
+                return { cypher: combined, params: allParams };
+            case '_NONE':
+                return {
+                    cypher: `NOT ${combined}`,
+                    params: allParams,
+                };
+            case '_ALL':
+                return { cypher: combined, params: allParams };
+            case '_SINGLE': {
+                // For union _SINGLE, exactly one member should have exactly one match
+                return { cypher: combined, params: allParams };
+            }
+            default:
+                return null;
+        }
+    }
+    buildRelPattern(nodeVar, relDef, targetVar, edgeVar) {
+        const escapedType = (0, validation_1.escapeIdentifier)(relDef.type);
+        const edgePart = edgeVar
+            ? `[${edgeVar}:${escapedType}]`
+            : `[:${escapedType}]`;
+        const escapedTarget = (0, validation_1.escapeIdentifier)(relDef.target);
+        if (relDef.direction === 'OUT')
+            return `(${nodeVar})-${edgePart}->(${targetVar}:${escapedTarget})`;
+        return `(${nodeVar})<-${edgePart}-(${targetVar}:${escapedTarget})`;
+    }
+    buildRelPatternWithLabel(nodeVar, relDef, targetVar, labelStr, edgeVar) {
+        const escapedType = (0, validation_1.escapeIdentifier)(relDef.type);
+        const edgePart = edgeVar
+            ? `[${edgeVar}:${escapedType}]`
+            : `[:${escapedType}]`;
+        if (relDef.direction === 'OUT')
+            return `(${nodeVar})-${edgePart}->(${targetVar}:${labelStr})`;
+        return `(${nodeVar})<-${edgePart}-(${targetVar}:${labelStr})`;
+    }
+    compileEdgeConditions(edgeWhere, edgeVar, counter) {
+        const clauses = [];
+        const params = {};
+        for (const [key, value] of Object.entries(edgeWhere)) {
+            (0, validation_1.assertSafeKey)(key, 'edge where input');
+            const result = this.compileScalarCondition(key, value, edgeVar, counter);
+            clauses.push(result.cypher);
+            Object.assign(params, result.params);
+        }
+        return {
+            cypher: clauses.join(' AND '),
+            params,
+        };
+    }
+    compileScalarCondition(key, value, nodeVar, counter) {
+        // Detect operator suffix
+        let operator = null;
+        let fieldName = key;
+        for (const suffix of OPERATOR_SUFFIXES)
+            if (key.endsWith(suffix)) {
+                operator = suffix;
+                fieldName = key.slice(0, -suffix.length);
+                break;
+            }
+        (0, validation_1.assertSafeIdentifier)(fieldName, 'where clause');
+        if (operator && this.disabledOperators.has(operator))
+            throw new errors_1.OGMError(`Operator "${operator}" is disabled. To enable it, set features.filters.String.MATCHES = true in your OGM config.`);
+        const paramName = `param${counter.count}`;
+        counter.count++;
+        const fieldRef = `${nodeVar}.${(0, validation_1.escapeIdentifier)(fieldName)}`;
+        if (operator === null)
+            // Exact match
+            return {
+                cypher: `${fieldRef} = $${paramName}`,
+                params: { [paramName]: value },
+            };
+        switch (operator) {
+            case '_IN':
+                return {
+                    cypher: `${fieldRef} IN $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_NOT':
+                return {
+                    cypher: `${fieldRef} <> $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_NOT_IN':
+                return {
+                    cypher: `NOT ${fieldRef} IN $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_CONTAINS':
+                return {
+                    cypher: `${fieldRef} CONTAINS $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_GTE':
+                return {
+                    cypher: `${fieldRef} >= $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_LTE':
+                return {
+                    cypher: `${fieldRef} <= $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_GT':
+                return {
+                    cypher: `${fieldRef} > $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_LT':
+                return {
+                    cypher: `${fieldRef} < $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_MATCHES':
+                return {
+                    cypher: `${fieldRef} =~ $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_STARTS_WITH':
+                return {
+                    cypher: `${fieldRef} STARTS WITH $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_ENDS_WITH':
+                return {
+                    cypher: `${fieldRef} ENDS WITH $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_NOT_CONTAINS':
+                return {
+                    cypher: `NOT ${fieldRef} CONTAINS $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_NOT_STARTS_WITH':
+                return {
+                    cypher: `NOT ${fieldRef} STARTS WITH $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            case '_NOT_ENDS_WITH':
+                return {
+                    cypher: `NOT ${fieldRef} ENDS WITH $${paramName}`,
+                    params: { [paramName]: value },
+                };
+            default:
+                throw new errors_1.OGMError(`Unknown operator: ${operator}`);
+        }
+    }
+}
+exports.WhereCompiler = WhereCompiler;
+//# sourceMappingURL=where.compiler.js.map

package/dist/cjs/compilers/where.compiler.js.map

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

package/dist/cjs/errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Base error class for all OGM errors.
+ * Provides consistent error identification across the package.
+ */
+export declare class OGMError extends Error {
+    constructor(message: string);
+}
+/**
+ * Thrown by `cloneSubgraph` / `deleteSubgraph` when an APOC subgraph operation fails.
+ * Wraps the underlying Neo4j/APOC error with operation context.
+ */
+export declare class SubgraphOperationError extends OGMError {
+    readonly operation: 'clone' | 'delete';
+    readonly rootId: string;
+    readonly cause?: Error;
+    constructor(operation: 'clone' | 'delete', rootId: string, message: string, cause?: Error);
+}
+/**
+ * Thrown by `findFirstOrThrow` / `findUniqueOrThrow` when no matching record exists.
+ */
+export declare class RecordNotFoundError extends OGMError {
+    /** The model (node type) that was queried */
+    readonly model: string;
+    /** The where clause that produced zero results */
+    readonly where: Record<string, unknown> | undefined;
+    constructor(model: string, where?: Record<string, unknown>);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/cjs/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,QAAQ;IAClD,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAGrB,SAAS,EAAE,OAAO,GAAG,QAAQ,EAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK;CAQhB;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;gBAExC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAO3D"}

package/dist/cjs/errors.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RecordNotFoundError = exports.SubgraphOperationError = exports.OGMError = void 0;
+/**
+ * Base error class for all OGM errors.
+ * Provides consistent error identification across the package.
+ */
+class OGMError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'OGMError';
+    }
+}
+exports.OGMError = OGMError;
+/**
+ * Thrown by `cloneSubgraph` / `deleteSubgraph` when an APOC subgraph operation fails.
+ * Wraps the underlying Neo4j/APOC error with operation context.
+ */
+class SubgraphOperationError extends OGMError {
+    constructor(operation, rootId, message, cause) {
+        super(`Subgraph ${operation} failed for root=${rootId}: ${message}`);
+        this.name = 'SubgraphOperationError';
+        this.operation = operation;
+        this.rootId = rootId;
+        this.cause = cause;
+    }
+}
+exports.SubgraphOperationError = SubgraphOperationError;
+/**
+ * Thrown by `findFirstOrThrow` / `findUniqueOrThrow` when no matching record exists.
+ */
+class RecordNotFoundError extends OGMError {
+    constructor(model, where) {
+        const whereStr = where ? ` with where ${JSON.stringify(where)}` : '';
+        super(`No ${model} record found${whereStr}`);
+        this.name = 'RecordNotFoundError';
+        this.model = model;
+        this.where = where;
+    }
+}
+exports.RecordNotFoundError = RecordNotFoundError;
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,MAAa,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AALD,4BAKC;AAED;;;GAGG;AACH,MAAa,sBAAuB,SAAQ,QAAQ;IAKlD,YACE,SAA6B,EAC7B,MAAc,EACd,OAAe,EACf,KAAa;QAEb,KAAK,CAAC,YAAY,SAAS,oBAAoB,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAjBD,wDAiBC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,QAAQ;IAM/C,YAAY,KAAa,EAAE,KAA+B;QACxD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrE,KAAK,CAAC,MAAM,KAAK,gBAAgB,QAAQ,EAAE,CAAC,CAAC;QAC7C,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAbD,kDAaC"}

package/dist/cjs/execution/executor.d.ts

@@ -0,0 +1,38 @@
+import { Driver, Session, Transaction, ManagedTransaction, QueryResult } from 'neo4j-driver';
+/**
+ * Minimal logger interface. Compatible with NestJS Logger, console, pino, etc.
+ */
+export interface OGMLogger {
+    debug(message: string, ...args: unknown[]): void;
+}
+/**
+ * Execution context for running queries within an existing transaction or session.
+ *
+ * Supports both legacy pattern (`executionContext`) and new explicit pattern (`transaction`/`session`).
+ * When both are provided, `executionContext` takes precedence for backward compatibility.
+ */
+export interface ExecutionContext {
+    /** @deprecated Use `transaction` instead. Kept for backward compatibility with @neo4j/graphql-ogm. */
+    executionContext?: Transaction | ManagedTransaction;
+    /** Explicit transaction to run the query within. */
+    transaction?: Transaction | ManagedTransaction;
+    /** Explicit session to use (auto-committed). */
+    session?: Session;
+}
+/**
+ * Executes Cypher queries against Neo4j, using either a provided
+ * transaction or an auto-commit session.
+ */
+export declare class Executor {
+    private driver;
+    /** Set to true to enable debug logging. */
+    static debug: boolean;
+    private logger;
+    constructor(driver: Driver, logger?: OGMLogger);
+    /**
+     * Execute a Cypher query, using either the provided transaction
+     * or a new auto-commit session.
+     */
+    execute(cypher: string, params: Record<string, unknown>, context?: ExecutionContext): Promise<QueryResult>;
+}
+//# sourceMappingURL=executor.d.ts.map

package/dist/cjs/execution/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../../src/execution/executor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,WAAW,EACZ,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAKD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sGAAsG;IACtG,gBAAgB,CAAC,EAAE,WAAW,GAAG,kBAAkB,CAAC;IACpD,oDAAoD;IACpD,WAAW,CAAC,EAAE,WAAW,GAAG,kBAAkB,CAAC;IAC/C,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,qBAAa,QAAQ;IAOjB,OAAO,CAAC,MAAM;IANhB,2CAA2C;IAC3C,MAAM,CAAC,KAAK,UAAS;IAErB,OAAO,CAAC,MAAM,CAAY;gBAGhB,MAAM,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,SAAS;IAKpB;;;OAGG;IACG,OAAO,CACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,WAAW,CAAC;CA8BxB"}

package/dist/cjs/execution/executor.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Executor = void 0;
+/** No-op logger used when no logger is provided and debug is off. */
+const NOOP_LOGGER = { debug: () => { } };
+/**
+ * Executes Cypher queries against Neo4j, using either a provided
+ * transaction or an auto-commit session.
+ */
+class Executor {
+    constructor(driver, logger) {
+        this.driver = driver;
+        this.logger = logger ?? NOOP_LOGGER;
+    }
+    /**
+     * Execute a Cypher query, using either the provided transaction
+     * or a new auto-commit session.
+     */
+    async execute(cypher, params, context) {
+        if (Executor.debug) {
+            this.logger.debug('[OGM] Cypher: %s', cypher);
+            this.logger.debug('[OGM] Params: %s', JSON.stringify(params, null, 2));
+        }
+        // Legacy backward compatibility
+        const tx = context?.executionContext ?? context?.transaction;
+        if (tx)
+            return tx.run(cypher, params);
+        // Explicit session
+        if (context?.session)
+            return context.session.run(cypher, params);
+        // Auto-commit session
+        const session = this.driver.session();
+        try {
+            const result = await session.run(cypher, params);
+            if (Executor.debug) {
+                this.logger.debug('[OGM] Records returned: %d', result.records.length);
+                if (result.records.length > 0 && result.records.length <= 5)
+                    this.logger.debug('[OGM] First record keys: %o', result.records[0].keys);
+            }
+            return result;
+        }
+        finally {
+            await session.close();
+        }
+    }
+}
+exports.Executor = Executor;
+/** Set to true to enable debug logging. */
+Executor.debug = false;
+//# sourceMappingURL=executor.js.map

package/dist/cjs/execution/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../../src/execution/executor.ts"],"names":[],"mappings":";;;AAeA,qEAAqE;AACrE,MAAM,WAAW,GAAc,EAAE,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;AAiBnD;;;GAGG;AACH,MAAa,QAAQ;IAMnB,YACU,MAAc,EACtB,MAAkB;QADV,WAAM,GAAN,MAAM,CAAQ;QAGtB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,WAAW,CAAC;IACtC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CACX,MAAc,EACd,MAA+B,EAC/B,OAA0B;QAE1B,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACzE,CAAC;QAED,gCAAgC;QAChC,MAAM,EAAE,GAAG,OAAO,EAAE,gBAAgB,IAAI,OAAO,EAAE,WAAW,CAAC;QAC7D,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEtC,mBAAmB;QACnB,IAAI,OAAO,EAAE,OAAO;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAEjE,sBAAsB;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YACjD,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;gBACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACvE,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC;oBACzD,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,6BAA6B,EAC7B,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CACvB,CAAC;YACN,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;gBAAS,CAAC;YACT,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;;AAlDH,4BAmDC;AAlDC,2CAA2C;AACpC,cAAK,GAAG,KAAK,CAAC"}