@woltz/rich-domain 1.2.0 → 1.2.1

package/dist/history-tracker.js

@@ -0,0 +1,805 @@
+import { Id } from "./id";
+import { Entity } from "./entity";
+import { ValueObject } from "./value-object";
+import { AggregateChanges } from "./aggregate-changes";
+/**
+ * Tracks changes in Aggregates using Proxy.
+ *
+ * Features:
+ * - Tracks changes in primitive properties
+ * - Tracks changes in nested entities (1:1)
+ * - Tracks changes in collections (1:N)
+ * - Supports Value Objects with identityKey
+ * - Calculates depth automatically
+ * - Generates AggregateChanges for persistence
+ * - Supports validation on change via onChangeValidator
+ */
+export class HistoryTracker {
+    constructor(target, rootEntityName, path = "", depth = 0, parentId, parentEntity, rootTracker) {
+        this.target = target;
+        this.rootEntityName = rootEntityName;
+        this.path = path;
+        this.depth = depth;
+        this.parentId = parentId;
+        this.parentEntity = parentEntity;
+        this.rootTracker = rootTracker;
+        this.history = [];
+        this.originalValues = new Map();
+        this.trackedArrays = new Map();
+        this.trackedEntities = new Map();
+        if (!rootTracker) {
+            this.rootTracker = this;
+        }
+        this.captureInitialState();
+    }
+    /**
+     * Sets a validator callback that will be called on every property change.
+     * The validator can:
+     * - Return false to reject the change (value will be reverted)
+     * - Throw an error to reject the change with an error
+     * - Return true/undefined to accept the change
+     */
+    setOnChangeValidator(validator) {
+        this.getRootTracker().onChangeValidator = validator;
+    }
+    // ============================================================================
+    // Initial State Capture
+    // ============================================================================
+    captureInitialState() {
+        if (this.depth > 0)
+            return;
+        this.captureEntityState(this.target, this.rootEntityName, "", 0);
+    }
+    captureEntityState(obj, entityName, path, depth, parentId, parentEntity) {
+        if (!obj || typeof obj !== "object")
+            return;
+        const id = this.getEntityId(obj);
+        const key = path || "root";
+        this.trackedEntities.set(key, {
+            entity: obj,
+            metadata: {
+                entityName,
+                depth,
+                parentId,
+                parentEntity,
+                path,
+            },
+            originalState: this.deepClone(obj),
+        });
+        const propsToScan = obj.props || obj;
+        for (const [propName, value] of Object.entries(propsToScan)) {
+            if (propName === "id")
+                continue;
+            const propPath = path ? `${path}.${propName}` : propName;
+            if (Array.isArray(value)) {
+                this.captureArrayState(value, propPath, depth + 1, id, entityName);
+            }
+            else if (this.isEntityOrVO(value)) {
+                const nestedName = this.getEntityName(value);
+                this.captureEntityState(value, nestedName, propPath, depth + 1, id, entityName);
+            }
+        }
+    }
+    captureArrayState(arr, path, depth, parentId, parentEntity) {
+        const entityName = arr.length > 0 ? this.getEntityName(arr[0]) : "Unknown";
+        this.trackedArrays.set(path, {
+            cloned: this.cloneArray(arr),
+            original: arr.slice(),
+            metadata: {
+                entityName,
+                depth,
+                parentId,
+                parentEntity,
+                path,
+            },
+        });
+        arr.forEach((item, index) => {
+            if (this.isEntityOrVO(item)) {
+                const itemPath = `${path}[${index}]`;
+                this.captureEntityState(item, this.getEntityName(item), itemPath, depth, parentId, parentEntity);
+            }
+        });
+    }
+    // ============================================================================
+    // Proxy Creation
+    // ============================================================================
+    createProxy() {
+        const handler = {
+            get: (target, prop, receiver) => {
+                const value = Reflect.get(target, prop, receiver);
+                if (this.shouldSkipProperty(prop)) {
+                    return value;
+                }
+                if (typeof value === "function") {
+                    return value.bind(target);
+                }
+                const currentPath = this.buildPath(String(prop));
+                if (Array.isArray(value)) {
+                    return this.createArrayProxy(value, currentPath);
+                }
+                if (this.isEntityOrVO(value)) {
+                    const nestedTracker = new HistoryTracker(value, this.getEntityName(value), currentPath, this.depth + 1, this.getEntityId(this.target), this.rootEntityName, this.rootTracker);
+                    return nestedTracker.createProxy();
+                }
+                return value;
+            },
+            set: (target, prop, newValue, receiver) => {
+                const currentPath = this.buildPath(String(prop));
+                const oldValue = Reflect.get(target, prop, receiver);
+                if (!Array.isArray(newValue) && oldValue === newValue) {
+                    return true;
+                }
+                // Call validator before making the change
+                const rootTracker = this.getRootTracker();
+                if (rootTracker.onChangeValidator) {
+                    try {
+                        const result = rootTracker.onChangeValidator(currentPath, oldValue, newValue);
+                        if (result === false) {
+                            // Validator rejected the change
+                            return true; // Return true to not throw, but don't apply change
+                        }
+                    }
+                    catch (error) {
+                        // Validator threw an error - propagate it
+                        throw error;
+                    }
+                }
+                // Store original value
+                if (!rootTracker.originalValues.has(currentPath)) {
+                    rootTracker.originalValues.set(currentPath, oldValue);
+                }
+                // Record in history
+                rootTracker.history.push({
+                    path: currentPath,
+                    previousValue: oldValue,
+                    currentValue: newValue,
+                    timestamp: Date.now(),
+                });
+                const result = Reflect.set(target, prop, newValue, receiver);
+                // Handle special cases
+                if (Array.isArray(newValue)) {
+                    this.handleArrayAssignment(currentPath, oldValue);
+                }
+                else if (this.isEntityOrVO(newValue) || this.isEntityOrVO(oldValue)) {
+                    this.handleEntityChange(currentPath, oldValue, newValue);
+                }
+                return result;
+            },
+        };
+        const proxy = new Proxy(this.target, handler);
+        Object.defineProperty(proxy, "__isProxy", { value: true, writable: false });
+        return proxy;
+    }
+    createArrayProxy(array, path) {
+        const tracker = this;
+        const rootTracker = this.getRootTracker();
+        if (!rootTracker.trackedArrays.has(path)) {
+            const parentId = this.getEntityId(this.target);
+            rootTracker.captureArrayState(array, path, this.depth + 1, parentId, this.rootEntityName);
+        }
+        return new Proxy(array, {
+            get(target, prop, receiver) {
+                const value = Reflect.get(target, prop, receiver);
+                if (typeof value === "function") {
+                    const mutatingMethods = [
+                        "push",
+                        "pop",
+                        "shift",
+                        "unshift",
+                        "splice",
+                        "sort",
+                        "reverse",
+                    ];
+                    if (mutatingMethods.includes(String(prop))) {
+                        return function (...args) {
+                            const oldArray = target.slice();
+                            // Call validator before array mutation
+                            if (rootTracker.onChangeValidator) {
+                                try {
+                                    const result = rootTracker.onChangeValidator(path, oldArray, [...oldArray, ...args] // Preview of change
+                                    );
+                                    if (result === false) {
+                                        return undefined;
+                                    }
+                                }
+                                catch (error) {
+                                    throw error;
+                                }
+                            }
+                            const result = value.apply(target, args);
+                            rootTracker.history.push({
+                                path,
+                                previousValue: oldArray,
+                                currentValue: target.slice(),
+                                timestamp: Date.now(),
+                            });
+                            return result;
+                        };
+                    }
+                    return value.bind(target);
+                }
+                if (!isNaN(Number(prop)) && tracker.isEntityOrVO(value)) {
+                    const nestedPath = `${path}[${String(prop)}]`;
+                    const nestedTracker = new HistoryTracker(value, tracker.getEntityName(value), nestedPath, tracker.depth + 1, tracker.getEntityId(tracker.target), tracker.rootEntityName, rootTracker);
+                    return nestedTracker.createProxy();
+                }
+                return value;
+            },
+            set(target, prop, newValue, receiver) {
+                if (!isNaN(Number(prop))) {
+                    const oldArray = target.slice();
+                    // Call validator before array item change
+                    if (rootTracker.onChangeValidator) {
+                        try {
+                            const result = rootTracker.onChangeValidator(path, oldArray, newValue);
+                            if (result === false) {
+                                return true;
+                            }
+                        }
+                        catch (error) {
+                            throw error;
+                        }
+                    }
+                    const result = Reflect.set(target, prop, newValue, receiver);
+                    rootTracker.history.push({
+                        path,
+                        previousValue: oldArray,
+                        currentValue: target.slice(),
+                        timestamp: Date.now(),
+                    });
+                    return result;
+                }
+                return Reflect.set(target, prop, newValue, receiver);
+            },
+        });
+    }
+    // ============================================================================
+    // getChanges() - Main Method
+    // ============================================================================
+    /**
+     * Returns all detected changes as AggregateChanges.
+     */
+    getChanges() {
+        const changes = new AggregateChanges();
+        const rootTracker = this.getRootTracker();
+        this.analyzeRootChanges(changes, rootTracker);
+        this.analyzeCollectionChanges(changes, rootTracker);
+        this.analyzeEntityChanges(changes, rootTracker);
+        return changes;
+    }
+    analyzeRootChanges(changes, rootTracker) {
+        const changedFields = {};
+        let hasChanges = false;
+        for (const [path, originalValue] of rootTracker.originalValues) {
+            if (path.includes(".") || path.includes("["))
+                continue;
+            const currentValue = this.target[path];
+            if (!this.isEqual(originalValue, currentValue)) {
+                changedFields[path] = currentValue;
+                hasChanges = true;
+            }
+        }
+        if (hasChanges) {
+            const id = this.getEntityId(this.target);
+            if (id) {
+                changes.addUpdate(this.rootEntityName, id, this.target, changedFields, 0);
+            }
+        }
+    }
+    analyzeCollectionChanges(changes, rootTracker) {
+        const allTrackedArrays = new Map();
+        const processedArrays = new Set();
+        for (const [path, arrayState] of rootTracker.trackedArrays) {
+            const currentArray = this.getValueAtPath(this.target, path);
+            if (Array.isArray(currentArray) && !processedArrays.has(currentArray)) {
+                allTrackedArrays.set(path, arrayState);
+                processedArrays.add(currentArray);
+            }
+        }
+        this.collectNestedArrays(this.target, "", allTrackedArrays, processedArrays);
+        for (const [path, arrayState] of allTrackedArrays) {
+            const currentArray = this.getValueAtPath(this.target, path);
+            if (!Array.isArray(currentArray))
+                continue;
+            const { created, updated, deleted } = this.detectArrayChanges(arrayState.cloned, arrayState.original, currentArray);
+            const { depth, parentId, parentEntity } = arrayState.metadata;
+            for (const item of created) {
+                const itemEntityName = this.getEntityName(item);
+                changes.addCreate(itemEntityName, item, depth, parentId, parentEntity);
+                // Recursively mark nested items as created
+                this.markNestedItemsAsCreated(item, depth, changes);
+            }
+            for (const item of updated) {
+                const id = this.getEntityId(item);
+                if (id) {
+                    const original = arrayState.cloned.find((o) => this.getEntityId(o) === id);
+                    const changedFields = this.detectChangedFields(original, item);
+                    if (Object.keys(changedFields).length > 0) {
+                        const itemEntityName = this.getEntityName(item);
+                        changes.addUpdate(itemEntityName, id, item, changedFields, depth);
+                    }
+                }
+            }
+            for (const item of deleted) {
+                const id = this.getEntityId(item);
+                const key = this.getItemKey(item);
+                if (id || key) {
+                    const itemEntityName = this.getEntityName(item);
+                    const deleteId = id || key;
+                    changes.addDelete(itemEntityName, deleteId, item, depth);
+                    // Recursively mark nested items as deleted using ORIGINAL state
+                    this.markNestedItemsAsDeleted(item, depth, changes, rootTracker);
+                }
+            }
+        }
+    }
+    /**
+     * Recursively marks all nested items as created when a parent is created.
+     */
+    markNestedItemsAsCreated(item, parentDepth, changes) {
+        if (!item || typeof item !== "object")
+            return;
+        const itemId = this.getEntityId(item);
+        if (!itemId)
+            return;
+        const props = item.props || item;
+        for (const [propName, value] of Object.entries(props)) {
+            if (propName === "id")
+                continue;
+            if (Array.isArray(value)) {
+                // Process all items in the array
+                for (const nestedItem of value) {
+                    if (this.isEntityOrVO(nestedItem)) {
+                        const nestedId = this.getEntityId(nestedItem);
+                        const nestedKey = this.getItemKey(nestedItem);
+                        if (nestedId || nestedKey) {
+                            const entityName = this.getEntityName(nestedItem);
+                            changes.addCreate(entityName, nestedItem, parentDepth + 1, itemId, this.getEntityName(item));
+                            // Recursively process nested items
+                            this.markNestedItemsAsCreated(nestedItem, parentDepth + 1, changes);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Recursively marks all nested items as deleted when a parent is deleted.
+     * Uses the original captured state to find nested items.
+     */
+    markNestedItemsAsDeleted(item, parentDepth, changes, rootTracker) {
+        if (!item || typeof item !== "object")
+            return;
+        // Get the ID to look up the original state
+        const itemId = this.getEntityId(item);
+        if (!itemId)
+            return;
+        // Look through all tracked arrays to find nested items
+        for (const [, arrayState] of rootTracker.trackedArrays) {
+            // Check if this array belongs to our deleted item
+            if (arrayState.metadata.parentId === itemId) {
+                // Use the CLONED (original) state to get the items
+                // Note: cloned items are JSON objects, not Entity/VO instances
+                for (const nestedItem of arrayState.cloned) {
+                    // Cloned items are JSON objects with an 'id' property
+                    const id = typeof nestedItem === "object" && nestedItem !== null
+                        ? nestedItem.id
+                        : undefined;
+                    if (id) {
+                        const entityName = arrayState.metadata.entityName;
+                        changes.addDelete(entityName, id, nestedItem, parentDepth + 1);
+                        // Recursively process this item's nested arrays
+                        this.markNestedJsonItemAsDeleted(id, parentDepth + 1, changes, rootTracker);
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Recursively marks nested items as deleted from a JSON object.
+     * This is used when processing cloned (JSON) state.
+     */
+    markNestedJsonItemAsDeleted(itemId, parentDepth, changes, rootTracker) {
+        // Look through all tracked arrays to find nested items of this parent
+        for (const [, arrayState] of rootTracker.trackedArrays) {
+            if (arrayState.metadata.parentId === itemId) {
+                // Process all items in this nested array
+                for (const nestedJsonItem of arrayState.cloned) {
+                    if (typeof nestedJsonItem !== "object" || nestedJsonItem === null)
+                        continue;
+                    const nestedId = nestedJsonItem.id;
+                    const entityName = arrayState.metadata.entityName;
+                    if (nestedId) {
+                        changes.addDelete(entityName, nestedId, nestedJsonItem, parentDepth + 1);
+                        // Recursively process further nesting
+                        this.markNestedJsonItemAsDeleted(nestedId, parentDepth + 1, changes, rootTracker);
+                    }
+                    else {
+                        // Value object - try to extract identity key
+                        const key = this.extractIdentityKeyFromJson(nestedJsonItem, arrayState.original);
+                        if (key) {
+                            changes.addDelete(entityName, key, nestedJsonItem, parentDepth + 1);
+                        }
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Extracts identity key from a JSON object by looking at the original ValueObject instances.
+     */
+    extractIdentityKeyFromJson(jsonItem, originalArray) {
+        // Try to find the original ValueObject to get its identity key
+        for (const originalItem of originalArray) {
+            if (this.isEntityOrVO(originalItem)) {
+                const originalJson = this.deepClone(originalItem);
+                // Check if this matches our JSON item (rough comparison)
+                if (JSON.stringify(originalJson) === JSON.stringify(jsonItem)) {
+                    // Found the matching original item - extract its identity key
+                    const key = this.getItemKey(originalItem);
+                    if (key)
+                        return key;
+                }
+            }
+        }
+        // Fallback: if it has an id, use that
+        if (jsonItem.id)
+            return jsonItem.id;
+        return undefined;
+    }
+    collectNestedArrays(obj, basePath, allArrays, processedArrays) {
+        if (!obj || typeof obj !== "object")
+            return;
+        for (const [propName, value] of Object.entries(obj)) {
+            if (propName === "id" || propName === "proxy" || propName === "_props")
+                continue;
+            const propPath = basePath ? `${basePath}.${propName}` : propName;
+            if (Array.isArray(value)) {
+                value.forEach((item, index) => {
+                    if (this.isEntityOrVO(item)) {
+                        this.collectNestedArrays(item, `${propPath}[${index}]`, allArrays, processedArrays);
+                    }
+                });
+            }
+            else if (this.isEntityOrVO(value)) {
+                this.collectNestedArrays(value, propPath, allArrays, processedArrays);
+            }
+        }
+    }
+    analyzeEntityChanges(changes, rootTracker) {
+        for (const [path, trackedItem] of rootTracker.trackedEntities) {
+            if (path === "root")
+                continue;
+            if (path.includes("["))
+                continue;
+            const currentValue = this.getValueAtPath(this.target, path);
+            const originalValue = trackedItem.originalState;
+            const originalEntity = trackedItem.entity;
+            const { entityName, depth, parentId, parentEntity } = trackedItem.metadata;
+            const state = this.detectEntityChangeState(originalValue, currentValue);
+            switch (state) {
+                case "created":
+                    changes.addCreate(entityName, currentValue, depth, parentId, parentEntity);
+                    break;
+                case "deleted":
+                    const id = this.getEntityId(originalValue);
+                    if (id) {
+                        // Use originalEntity instead of originalValue to preserve entity instance
+                        changes.addDelete(entityName, id, originalEntity, depth);
+                    }
+                    break;
+                case "replaced":
+                    const oldId = this.getEntityId(originalValue);
+                    if (oldId) {
+                        // Use originalEntity instead of originalValue to preserve entity instance
+                        changes.addDelete(entityName, oldId, originalEntity, depth);
+                    }
+                    changes.addCreate(entityName, currentValue, depth, parentId, parentEntity);
+                    break;
+                case "updated":
+                    const updateId = this.getEntityId(currentValue);
+                    if (updateId) {
+                        const changedFields = this.detectChangedFields(originalValue, currentValue);
+                        if (Object.keys(changedFields).length > 0) {
+                            changes.addUpdate(entityName, updateId, currentValue, changedFields, depth);
+                        }
+                    }
+                    break;
+            }
+        }
+    }
+    // ============================================================================
+    // Change Detection Helpers
+    // ============================================================================
+    detectEntityChangeState(previous, current) {
+        if (previous === null && current !== null) {
+            return "created";
+        }
+        if (previous !== null && current === null) {
+            return "deleted";
+        }
+        if (previous !== null && current !== null) {
+            const prevId = this.getEntityId(previous);
+            const currId = this.getEntityId(current);
+            if (prevId && currId && prevId === currId) {
+                return this.hasChanged(previous, current) ? "updated" : "unchanged";
+            }
+            else {
+                return "replaced";
+            }
+        }
+        return "unchanged";
+    }
+    detectArrayChanges(oldCloned, oldOriginal, newArray) {
+        const created = [];
+        const updated = [];
+        const deleted = [];
+        const oldMap = new Map();
+        const newMap = new Map();
+        oldCloned.forEach((item) => {
+            const key = this.getItemKey(item);
+            if (key)
+                oldMap.set(key, item);
+        });
+        newArray.forEach((item) => {
+            const key = this.getItemKey(item);
+            if (key)
+                newMap.set(key, item);
+        });
+        newArray.forEach((item) => {
+            const key = this.getItemKey(item);
+            if (!key) {
+                created.push(item);
+            }
+            else if (!oldMap.has(key)) {
+                created.push(item);
+            }
+            else if (this.hasChanged(oldMap.get(key), item)) {
+                updated.push(item);
+            }
+        });
+        oldOriginal.forEach((item) => {
+            const key = this.getItemKey(item);
+            if (key && !newMap.has(key)) {
+                deleted.push(item);
+            }
+        });
+        return { created, updated, deleted };
+    }
+    detectChangedFields(original, current) {
+        const changes = {};
+        if (!original || !current)
+            return changes;
+        const origProps = original.props || original;
+        const currProps = current.props || current;
+        for (const key of Object.keys(currProps)) {
+            if (key === "id")
+                continue;
+            const origValue = origProps[key];
+            const currValue = currProps[key];
+            if (Array.isArray(currValue) || this.isEntityOrVO(currValue)) {
+                continue;
+            }
+            if (!this.isEqual(origValue, currValue)) {
+                changes[key] = currValue;
+            }
+        }
+        return changes;
+    }
+    // ============================================================================
+    // Internal Handlers
+    // ============================================================================
+    handleArrayAssignment(path, oldValue) {
+        const rootTracker = this.getRootTracker();
+        if (!rootTracker.trackedArrays.has(path)) {
+            const parentId = this.getEntityId(this.target);
+            rootTracker.captureArrayState(Array.isArray(oldValue) ? oldValue : [], path, this.depth + 1, parentId, this.rootEntityName);
+        }
+    }
+    handleEntityChange(path, oldValue, newValue) {
+        const rootTracker = this.getRootTracker();
+        const entityName = newValue
+            ? this.getEntityName(newValue)
+            : this.getEntityName(oldValue);
+        const existingTracked = rootTracker.trackedEntities.get(path);
+        rootTracker.trackedEntities.set(path, {
+            // Preserve original entity, or use oldValue if this is the first change
+            entity: existingTracked?.entity || oldValue,
+            metadata: {
+                entityName,
+                depth: this.depth + 1,
+                parentId: this.getEntityId(this.target),
+                parentEntity: this.rootEntityName,
+                path,
+            },
+            // Preserve original state
+            originalState: existingTracked?.originalState,
+        });
+    }
+    // ============================================================================
+    // Utility Methods
+    // ============================================================================
+    getRootTracker() {
+        return this.rootTracker || this;
+    }
+    buildPath(prop) {
+        return this.path ? `${this.path}.${prop}` : prop;
+    }
+    shouldSkipProperty(prop) {
+        const skipProps = [
+            "__isProxy",
+            "__tracker",
+            "__originalTarget",
+            "__path",
+            "constructor",
+            "prototype",
+        ];
+        return skipProps.includes(String(prop));
+    }
+    getValueAtPath(obj, path) {
+        if (!path)
+            return obj;
+        const parts = path.split(/[.\[\]]+/).filter(Boolean);
+        let current = obj;
+        for (const part of parts) {
+            if (current === null || current === undefined)
+                return undefined;
+            current = current[part];
+        }
+        return current;
+    }
+    getItemKey(item) {
+        const id = this.getEntityId(item);
+        if (id)
+            return id;
+        if (item instanceof ValueObject && item.hasIdentityKey()) {
+            return item.getIdentityKey() || undefined;
+        }
+        return undefined;
+    }
+    getEntityId(item) {
+        if (!item)
+            return undefined;
+        if (item.id instanceof Id)
+            return item.id.value;
+        if (item.id !== undefined)
+            return String(item.id);
+        return undefined;
+    }
+    getEntityName(item) {
+        if (!item)
+            return "Unknown";
+        return item.constructor?.name || "Unknown";
+    }
+    isEntityOrVO(value) {
+        if (value === null || value === undefined)
+            return false;
+        return value instanceof Entity || value instanceof ValueObject;
+    }
+    isEqual(a, b) {
+        if (a === b)
+            return true;
+        if (a instanceof Id && b instanceof Id)
+            return a.value === b.value;
+        if (a instanceof Date && b instanceof Date)
+            return a.getTime() === b.getTime();
+        try {
+            return this.hasChanged(a, b) === false;
+        }
+        catch {
+            return this.deepEqual(a, b);
+        }
+    }
+    deepEqual(a, b) {
+        if (a === b)
+            return true;
+        if (a == null || b == null)
+            return a === b;
+        if (typeof a !== typeof b)
+            return false;
+        if (typeof a !== "object")
+            return a === b;
+        if (Array.isArray(a) !== Array.isArray(b))
+            return false;
+        if (Array.isArray(a)) {
+            if (a.length !== b.length)
+                return false;
+            for (let i = 0; i < a.length; i++) {
+                if (!this.deepEqual(a[i], b[i]))
+                    return false;
+            }
+            return true;
+        }
+        const keysA = Object.keys(a).filter((key) => {
+            const value = a[key];
+            return (typeof value !== "object" ||
+                value instanceof Date ||
+                value instanceof Id ||
+                value === null);
+        });
+        const keysB = Object.keys(b).filter((key) => {
+            const value = b[key];
+            return (typeof value !== "object" ||
+                value instanceof Date ||
+                value instanceof Id ||
+                value === null);
+        });
+        if (keysA.length !== keysB.length)
+            return false;
+        for (const key of keysA) {
+            if (!keysB.includes(key))
+                return false;
+            if (!this.isEqual(a[key], b[key]))
+                return false;
+        }
+        return true;
+    }
+    hasChanged(obj1, obj2) {
+        const json1 = this.normalizeAndStringify(this.deepClone(obj1));
+        const json2 = this.normalizeAndStringify(this.deepClone(obj2));
+        return json1 !== json2;
+    }
+    cloneArray(arr) {
+        return arr.map((item) => this.deepClone(item));
+    }
+    deepClone(obj) {
+        if (obj === null || obj === undefined || typeof obj !== "object") {
+            return obj;
+        }
+        if (obj instanceof Id) {
+            return obj.value;
+        }
+        if (typeof obj.toJson === "function") {
+            return obj.toJson();
+        }
+        if (Array.isArray(obj)) {
+            return obj.map((item) => this.deepClone(item));
+        }
+        if (obj instanceof Date) {
+            return new Date(obj.getTime());
+        }
+        try {
+            return structuredClone(obj);
+        }
+        catch {
+            const cloned = {};
+            for (const key in obj) {
+                if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                    cloned[key] = this.deepClone(obj[key]);
+                }
+            }
+            return cloned;
+        }
+    }
+    normalizeAndStringify(obj) {
+        if (obj === null || typeof obj !== "object") {
+            return JSON.stringify(obj);
+        }
+        if (Array.isArray(obj)) {
+            return `[${obj
+                .map((item) => this.normalizeAndStringify(item))
+                .join(",")}]`;
+        }
+        const keys = Object.keys(obj).sort();
+        const parts = keys.map((key) => `"${key}":${this.normalizeAndStringify(obj[key])}`);
+        return `{${parts.join(",")}}`;
+    }
+    getHistory() {
+        return [...this.getRootTracker().history];
+    }
+    clearHistory() {
+        const rootTracker = this.getRootTracker();
+        rootTracker.history = [];
+        rootTracker.originalValues.clear();
+        rootTracker.trackedArrays.clear();
+        rootTracker.trackedEntities.clear();
+        this.captureInitialState();
+    }
+    markAsClean() {
+        this.clearHistory();
+    }
+    getTarget() {
+        return this.target;
+    }
+}
+//# sourceMappingURL=history-tracker.js.map