grafeo-ogm 1.0.0

package/dist/esm/schema/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/schema/types.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,MAAM,MAAM,UAAU,GAClB,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,UAAU,EAAE,GACZ;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;CAAE,CAAC;AAElC,6BAA6B;AAC7B,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,EAAE,CAAC;CACvD;AACD,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,EAAE,CAAC;CAC7D;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,GAAG,KAAK,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACnD,eAAe,EAAE,aAAa,EAAE,CAAC;IACjC,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5C,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;IACnD,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC5C,eAAe,CAAC,EAAE,aAAa,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC7C,sBAAsB,EAAE,GAAG,CAAC,MAAM,EAAE,gCAAgC,CAAC,CAAC;IACtE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC/B"}

package/dist/esm/schema/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/schema/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/schema/types.ts"],"names":[],"mappings":""}

package/dist/esm/schema/utils.d.ts

@@ -0,0 +1,23 @@
+import type { NodeDefinition, SchemaMetadata } from './types';
+/**
+ * Clear the module-level resolve cache.
+ * Useful in tests to prevent cross-test state pollution.
+ */
+export declare function clearResolveTargetDefCache(): void;
+/**
+ * Resolve a target type name to a NodeDefinition, handling union targets
+ * by merging all member nodes' properties and relationships.
+ *
+ * Results are memoized per (schema identity + target) to avoid repeated
+ * O(members × properties) merges for the same union type.
+ */
+export declare function resolveTargetDef(target: string, schema: SchemaMetadata): NodeDefinition | null;
+/**
+ * Compute the validated label string for a NodeDefinition.
+ * Deduplicates labels, validates each, and joins with ':'.
+ *
+ * Callers that need caching should maintain their own cache (e.g., per MutationCompiler instance)
+ * to avoid cross-test pollution from module-level state.
+ */
+export declare function getTargetLabelString(nodeDef: NodeDefinition): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/esm/schema/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/schema/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAEd,cAAc,EACf,MAAM,SAAS,CAAC;AAUjB;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,GACrB,cAAc,GAAG,IAAI,CA0DvB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAKpE"}

package/dist/esm/schema/utils.js

@@ -0,0 +1,87 @@
+import { assertSafeLabel } from '../utils/validation';
+/**
+ * Module-level cache for resolved union/interface target definitions.
+ * Bounded by the number of unique type names in the schema (~50-100 entries).
+ * Use `clearResolveTargetDefCache()` to reset (e.g., between tests).
+ */
+const resolveTargetDefCache = new Map();
+/**
+ * Clear the module-level resolve cache.
+ * Useful in tests to prevent cross-test state pollution.
+ */
+export function clearResolveTargetDefCache() {
+    resolveTargetDefCache.clear();
+}
+/**
+ * Resolve a target type name to a NodeDefinition, handling union targets
+ * by merging all member nodes' properties and relationships.
+ *
+ * Results are memoized per (schema identity + target) to avoid repeated
+ * O(members × properties) merges for the same union type.
+ */
+export function resolveTargetDef(target, schema) {
+    const direct = schema.nodes.get(target);
+    if (direct)
+        return direct;
+    const cached = resolveTargetDefCache.get(target);
+    if (cached !== undefined)
+        return cached;
+    // Check interfaces — build a NodeDefinition from the interface definition
+    const interfaceDef = schema.interfaces?.get(target);
+    if (interfaceDef) {
+        const result = {
+            typeName: interfaceDef.name,
+            label: interfaceDef.label,
+            labels: [interfaceDef.label],
+            pluralName: interfaceDef.name.toLowerCase() + 's',
+            properties: interfaceDef.properties,
+            relationships: interfaceDef.relationships,
+            fulltextIndexes: [],
+            implementsInterfaces: [],
+        };
+        resolveTargetDefCache.set(target, result);
+        return result;
+    }
+    const unionMembers = schema.unions?.get(target);
+    if (!unionMembers || unionMembers.length === 0) {
+        resolveTargetDefCache.set(target, null);
+        return null;
+    }
+    const mergedProperties = new Map();
+    const mergedRelationships = new Map();
+    for (const memberName of unionMembers) {
+        const memberDef = schema.nodes.get(memberName);
+        if (!memberDef)
+            continue;
+        for (const [k, v] of memberDef.properties)
+            if (!mergedProperties.has(k))
+                mergedProperties.set(k, v);
+        for (const [k, v] of memberDef.relationships)
+            if (!mergedRelationships.has(k))
+                mergedRelationships.set(k, v);
+    }
+    const result = {
+        typeName: target,
+        label: target,
+        labels: [target],
+        pluralName: target.toLowerCase() + 's',
+        properties: mergedProperties,
+        relationships: mergedRelationships,
+        fulltextIndexes: [],
+        implementsInterfaces: [],
+    };
+    resolveTargetDefCache.set(target, result);
+    return result;
+}
+/**
+ * Compute the validated label string for a NodeDefinition.
+ * Deduplicates labels, validates each, and joins with ':'.
+ *
+ * Callers that need caching should maintain their own cache (e.g., per MutationCompiler instance)
+ * to avoid cross-test pollution from module-level state.
+ */
+export function getTargetLabelString(nodeDef) {
+    const allLabels = [...new Set([nodeDef.label, ...nodeDef.labels])].map((l) => assertSafeLabel(l));
+    return allLabels.join(':');
+}
+//# sourceMappingURL=utils.js.map

package/dist/esm/schema/utils.js.map

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

package/dist/esm/subgraph/index.d.ts

@@ -0,0 +1,3 @@
+export { cloneSubgraph, deleteSubgraph } from './subgraph-operations';
+export type { SubgraphCloneResult, SubgraphConfig, SubgraphDeleteResult, SubgraphReferenceRelationship, } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/subgraph/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/subgraph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACtE,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,SAAS,CAAC"}

package/dist/esm/subgraph/index.js

@@ -0,0 +1,2 @@
+export { cloneSubgraph, deleteSubgraph } from './subgraph-operations';
+//# sourceMappingURL=index.js.map

package/dist/esm/subgraph/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/subgraph/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/esm/subgraph/subgraph-operations.d.ts

@@ -0,0 +1,34 @@
+import { Transaction } from 'neo4j-driver';
+import { OGMLogger } from '../execution/executor';
+import { SubgraphCloneResult, SubgraphConfig, SubgraphDeleteResult } from './types';
+/**
+ * Clones a content subgraph rooted at the given source node using APOC procedures.
+ *
+ * Phase 1: Collects the subgraph via `apoc.path.subgraphAll` and clones it
+ *          with `apoc.refactor.cloneSubgraph`. Generates new UUIDs for all cloned nodes
+ *          and sets `clonedFromId` on each clone pointing to the original.
+ *
+ * Phase 2: Re-attaches reference relationships from cloned nodes to shared/lookup nodes
+ *          (e.g., Language, Status, MeasurementUnit) that were outside the clone scope.
+ *
+ * @param sourceRootId - The `id` property of the root node to clone
+ * @param config - Defines which nodes to clone vs reference
+ * @param transaction - Caller-managed Neo4j transaction
+ * @param logger - Optional logger for debug output
+ * @returns The cloned root node id and a mapping of original→cloned node ids
+ */
+export declare function cloneSubgraph(sourceRootId: string, config: SubgraphConfig, transaction: Transaction, logger?: OGMLogger): Promise<SubgraphCloneResult>;
+/**
+ * Deletes a content subgraph rooted at the given node using APOC procedures.
+ *
+ * Uses `apoc.path.subgraphAll` to collect all owned nodes within the configured
+ * labels and relationships, then `DETACH DELETE`s them.
+ *
+ * @param rootId - The `id` property of the subgraph root node to delete
+ * @param config - Defines which labels/relationships form the owned subgraph
+ * @param transaction - Caller-managed Neo4j transaction
+ * @param logger - Optional logger for debug output
+ * @returns The count of deleted nodes
+ */
+export declare function deleteSubgraph(rootId: string, config: SubgraphConfig, transaction: Transaction, logger?: OGMLogger): Promise<SubgraphDeleteResult>;
+//# sourceMappingURL=subgraph-operations.d.ts.map

package/dist/esm/subgraph/subgraph-operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subgraph-operations.d.ts","sourceRoot":"","sources":["../../../src/subgraph/subgraph-operations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAMlD,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACrB,MAAM,SAAS,CAAC;AA4BjB;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,WAAW,EACxB,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,mBAAmB,CAAC,CA+B9B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,WAAW,EACxB,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,oBAAoB,CAAC,CAkD/B"}

package/dist/esm/subgraph/subgraph-operations.js

@@ -0,0 +1,221 @@
+import { SubgraphOperationError } from '../errors';
+import { assertSafeIdentifier, assertSafeLabel, escapeIdentifier, } from '../utils/validation';
+/** No-op logger used when no logger is provided. */
+const NOOP_LOGGER = { debug: () => { } };
+/**
+ * Validates all labels and relationship types in a SubgraphConfig
+ * to prevent Cypher injection (these values are string-interpolated).
+ */
+function validateConfig(config) {
+    for (const label of config.ownedLabels)
+        assertSafeLabel(label);
+    for (const rel of config.ownedRelationships)
+        assertSafeIdentifier(rel, 'owned relationship type');
+    for (const ref of config.referenceRelationships) {
+        assertSafeLabel(ref.fromLabel);
+        assertSafeIdentifier(ref.relationshipType, 'reference relationship type');
+        if (ref.direction !== 'OUT' && ref.direction !== 'IN')
+            throw new SubgraphOperationError('clone', '', `Invalid direction "${ref.direction}" for reference relationship ${ref.relationshipType}`);
+    }
+}
+/**
+ * Clones a content subgraph rooted at the given source node using APOC procedures.
+ *
+ * Phase 1: Collects the subgraph via `apoc.path.subgraphAll` and clones it
+ *          with `apoc.refactor.cloneSubgraph`. Generates new UUIDs for all cloned nodes
+ *          and sets `clonedFromId` on each clone pointing to the original.
+ *
+ * Phase 2: Re-attaches reference relationships from cloned nodes to shared/lookup nodes
+ *          (e.g., Language, Status, MeasurementUnit) that were outside the clone scope.
+ *
+ * @param sourceRootId - The `id` property of the root node to clone
+ * @param config - Defines which nodes to clone vs reference
+ * @param transaction - Caller-managed Neo4j transaction
+ * @param logger - Optional logger for debug output
+ * @returns The cloned root node id and a mapping of original→cloned node ids
+ */
+export async function cloneSubgraph(sourceRootId, config, transaction, logger) {
+    const log = logger ?? NOOP_LOGGER;
+    validateConfig(config);
+    try {
+        const cloneResult = await executeApocClone(sourceRootId, config, transaction, log);
+        log.debug('[OGM $cloneSubgraph] Cloned %d nodes from root %s', cloneResult.nodeMapping.size, sourceRootId);
+        await reattachReferenceRelationships(config, cloneResult, transaction, log);
+        return cloneResult;
+    }
+    catch (error) {
+        if (error instanceof SubgraphOperationError)
+            throw error;
+        throw new SubgraphOperationError('clone', sourceRootId, error instanceof Error ? error.message : String(error), error instanceof Error ? error : undefined);
+    }
+}
+/**
+ * Deletes a content subgraph rooted at the given node using APOC procedures.
+ *
+ * Uses `apoc.path.subgraphAll` to collect all owned nodes within the configured
+ * labels and relationships, then `DETACH DELETE`s them.
+ *
+ * @param rootId - The `id` property of the subgraph root node to delete
+ * @param config - Defines which labels/relationships form the owned subgraph
+ * @param transaction - Caller-managed Neo4j transaction
+ * @param logger - Optional logger for debug output
+ * @returns The count of deleted nodes
+ */
+export async function deleteSubgraph(rootId, config, transaction, logger) {
+    const log = logger ?? NOOP_LOGGER;
+    validateConfig(config);
+    const relFilter = config.ownedRelationships.join('|');
+    const labelFilter = config.ownedLabels.map((l) => `+${l}`).join('|');
+    try {
+        const result = await transaction.run(`
+      MATCH (source {id: $rootId})
+      CALL apoc.path.subgraphAll(source, {
+        relationshipFilter: $relFilter,
+        labelFilter: $labelFilter,
+        maxLevel: $maxLevel
+      }) YIELD nodes
+      UNWIND nodes AS n
+      DETACH DELETE n
+      RETURN count(*) AS deletedCount
+      `, {
+            rootId,
+            relFilter,
+            labelFilter,
+            maxLevel: config.maxLevel,
+        });
+        const deletedCount = result.records[0]?.get('deletedCount')?.toNumber?.() ??
+            result.records[0]?.get('deletedCount') ??
+            0;
+        log.debug('[OGM $deleteSubgraph] Deleted %d nodes from root %s', deletedCount, rootId);
+        return { deletedCount };
+    }
+    catch (error) {
+        if (error instanceof SubgraphOperationError)
+            throw error;
+        throw new SubgraphOperationError('delete', rootId, error instanceof Error ? error.message : String(error), error instanceof Error ? error : undefined);
+    }
+}
+/**
+ * Executes the APOC subgraph clone and generates new UUIDs for cloned nodes.
+ */
+async function executeApocClone(sourceRootId, config, transaction, logger) {
+    const relFilter = config.ownedRelationships.join('|');
+    const labelFilter = config.ownedLabels.map((l) => `+${l}`).join('|');
+    // Step 1: Collect subgraph and clone it
+    // APOC cloneSubgraph returns: input=INTEGER (original internal ID), output=NODE (clone).
+    // skipProperties: ['id'] avoids unique constraint violations during clone.
+    // We use `input` (internal ID) to match back to the original's app-level id.
+    const result = await transaction.run(`
+    MATCH (source {id: $sourceId})
+    CALL apoc.path.subgraphAll(source, {
+      relationshipFilter: $relFilter,
+      labelFilter: $labelFilter,
+      maxLevel: $maxLevel
+    }) YIELD nodes, relationships
+    CALL apoc.refactor.cloneSubgraph(nodes, relationships, {skipProperties: ['id']})
+    YIELD input, output, error
+    WHERE output IS NOT NULL
+    WITH input, output
+    MATCH (original) WHERE id(original) = input
+    SET output.clonedFromId = original.id
+    RETURN original.id AS originalId, elementId(output) AS cloneElementId
+    `, {
+        sourceId: sourceRootId,
+        relFilter,
+        labelFilter,
+        maxLevel: config.maxLevel,
+    });
+    // Build nodeMapping from result records
+    const nodeMapping = new Map();
+    let clonedRootElementId;
+    for (const record of result.records) {
+        const originalId = record.get('originalId');
+        const cloneElementId = record.get('cloneElementId');
+        nodeMapping.set(originalId, cloneElementId);
+        if (originalId === sourceRootId)
+            clonedRootElementId = cloneElementId;
+    }
+    if (!clonedRootElementId)
+        throw new SubgraphOperationError('clone', sourceRootId, 'Clone did not produce a root node');
+    // Step 2: Generate new UUIDs for cloned nodes
+    // clonedFromId was already set in Step 1 via the APOC clone query
+    const uuidResult = await transaction.run(`
+    UNWIND $elementIds AS elemId
+    MATCH (n) WHERE elementId(n) = elemId
+    WITH n, elementId(n) AS elemId, randomUUID() AS newId
+    SET n.id = newId
+    RETURN elemId, newId
+    `, {
+        elementIds: Array.from(nodeMapping.values()),
+    });
+    // Rebuild mapping with new UUIDs: originalId → newUUID
+    const elementIdToNewUuid = new Map();
+    for (const record of uuidResult.records)
+        elementIdToNewUuid.set(record.get('elemId'), record.get('newId'));
+    const finalMapping = new Map();
+    for (const [originalId, elementId] of nodeMapping) {
+        const newUuid = elementIdToNewUuid.get(elementId);
+        if (newUuid)
+            finalMapping.set(originalId, newUuid);
+    }
+    const finalClonedRootId = elementIdToNewUuid.get(clonedRootElementId);
+    if (!finalClonedRootId)
+        throw new SubgraphOperationError('clone', sourceRootId, 'Failed to assign new UUID to cloned root node');
+    logger.debug('[OGM $cloneSubgraph] APOC clone complete: %d nodes, root %s → %s', finalMapping.size, sourceRootId, finalClonedRootId);
+    return {
+        clonedRootId: finalClonedRootId,
+        nodeMapping: finalMapping,
+    };
+}
+/**
+ * Re-attaches reference relationships from cloned nodes to shared/lookup nodes.
+ *
+ * After APOC cloning, cloned nodes lose their relationships to shared nodes
+ * (e.g., Language, Status, MeasurementUnit) because those were outside the clone scope.
+ * This queries the original nodes for their reference relationships and re-creates
+ * them on the cloned nodes.
+ *
+ * NOTE: `properties(r)` is materialized into a map variable (`relProps`) BEFORE
+ * the CREATE to ensure relationship properties are preserved. Accessing
+ * `properties(r)` after a WITH boundary inside CALL {} can silently return
+ * an empty map in some Neo4j versions.
+ */
+async function reattachReferenceRelationships(config, cloneResult, transaction, logger) {
+    if (!config.referenceRelationships.length)
+        return;
+    const mappings = Array.from(cloneResult.nodeMapping.entries()).map(([originalId, cloneId]) => ({ originalId, cloneId }));
+    for (const refRel of config.referenceRelationships) {
+        const escapedRelType = escapeIdentifier(refRel.relationshipType);
+        const escapedLabel = assertSafeLabel(refRel.fromLabel);
+        const matchPattern = refRel.direction === 'OUT'
+            ? `-[r:${escapedRelType}]->(target)`
+            : `<-[r:${escapedRelType}]-(target)`;
+        const createPattern = refRel.direction === 'OUT'
+            ? `CREATE (clone)-[newR:${escapedRelType}]->(target)`
+            : `CREATE (clone)<-[newR:${escapedRelType}]-(target)`;
+        const result = await transaction.run(`
+      UNWIND $mappings AS mapping
+      MATCH (original {id: mapping.originalId})
+      WHERE original:${escapedLabel}
+      MATCH (clone {id: mapping.cloneId})
+      WHERE clone:${escapedLabel}
+      WITH original, clone
+      CALL {
+        WITH original, clone
+        MATCH (original)${matchPattern}
+        WITH clone, target, properties(r) AS relProps
+        ${createPattern}
+        SET newR = relProps
+        RETURN count(*) AS created
+      }
+      RETURN sum(created) AS totalCreated
+      `, { mappings });
+        const totalCreated = result.records[0]?.get('totalCreated')?.toNumber?.() ??
+            result.records[0]?.get('totalCreated') ??
+            0;
+        if (totalCreated > 0)
+            logger.debug('[OGM $cloneSubgraph] Reattached %d %s relationships (%s)', totalCreated, refRel.relationshipType, refRel.fromLabel);
+    }
+    logger.debug('[OGM $cloneSubgraph] Reattached %d reference relationship types', config.referenceRelationships.length);
+}
+//# sourceMappingURL=subgraph-operations.js.map

package/dist/esm/subgraph/subgraph-operations.js.map

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

package/dist/esm/subgraph/types.d.ts

@@ -0,0 +1,23 @@
+/** Reference relationship from a cloned node to a shared/lookup node. */
+export interface SubgraphReferenceRelationship {
+    fromLabel: string;
+    relationshipType: string;
+    direction: 'OUT' | 'IN';
+}
+/** Configuration for clone/delete operations — domain-agnostic blueprint. */
+export interface SubgraphConfig {
+    ownedLabels: string[];
+    ownedRelationships: string[];
+    maxLevel: number;
+    referenceRelationships: SubgraphReferenceRelationship[];
+}
+/** Clone result. */
+export interface SubgraphCloneResult {
+    clonedRootId: string;
+    nodeMapping: Map<string, string>;
+}
+/** Delete result. */
+export interface SubgraphDeleteResult {
+    deletedCount: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/subgraph/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/subgraph/types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,MAAM,WAAW,6BAA6B;IAC5C,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,KAAK,GAAG,IAAI,CAAC;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB,EAAE,6BAA6B,EAAE,CAAC;CACzD;AAED,oBAAoB;AACpB,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAqB;AACrB,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/esm/subgraph/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/subgraph/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/subgraph/types.ts"],"names":[],"mappings":""}

package/dist/esm/testing/cypher-assert.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Structural Cypher comparison utility that normalizes whitespace
+ * and parameter names for deterministic test assertions.
+ */
+export declare 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: string): string;
+    /**
+     * Assert two Cypher strings are structurally equal after normalization.
+     * Throws an Error if they differ.
+     */
+    static assertStructurallyEqual(actual: string, expected: string): void;
+    /**
+     * 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: string, clauseType: string, pattern: string): void;
+    /**
+     * Assert that a Cypher string does NOT contain a specific clause/pattern.
+     */
+    static assertNotContainsClause(cypher: string, clauseTypeOrPattern: string, pattern?: string): void;
+    /**
+     * Assert parameter values match expected.
+     * Only checks the keys present in expected (doesn't require exact match on all params).
+     */
+    static assertParams(actual: Record<string, unknown>, expected: Record<string, unknown>): void;
+}
+//# sourceMappingURL=cypher-assert.d.ts.map

package/dist/esm/testing/cypher-assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cypher-assert.d.ts","sourceRoot":"","sources":["../../../src/testing/cypher-assert.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,YAAY;IACvB;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAkBxC;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAStE;;;;;OAKG;IACH,MAAM,CAAC,oBAAoB,CACzB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GACd,IAAI;IAYP;;OAEG;IACH,MAAM,CAAC,uBAAuB,CAC5B,MAAM,EAAE,MAAM,EACd,mBAAmB,EAAE,MAAM,EAC3B,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;IAQP;;;OAGG;IACH,MAAM,CAAC,YAAY,CACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI;CAeR"}

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

@@ -0,0 +1,68 @@
+/**
+ * Structural Cypher comparison utility that normalizes whitespace
+ * and parameter names for deterministic test assertions.
+ */
+export 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}`);
+        }
+    }
+}
+//# sourceMappingURL=cypher-assert.js.map

package/dist/esm/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,MAAM,OAAO,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"}

package/dist/esm/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/esm/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/esm/testing/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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/esm/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/esm/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"}