@warlock.js/cascade 4.0.171 → 4.1.1

package/cjs/database-dirty-tracker.d.ts

@@ -1,252 +0,0 @@
-/**
- * Flattened record type representing dot-notation paths mapped to their values.
- */
-type FlatRecord = Record<string, unknown>;
-/**
- * Represents the old and new values of a dirty column.
- */
-type DirtyColumnValues = {
-    oldValue: unknown;
-    newValue: unknown;
-};
-/**
- * Tracks changes to model data by maintaining snapshots of initial and current state.
- *
- * The tracker stores both raw (nested) and flattened (dot-notation) versions of the data
- * to accurately detect modifications, additions, and removals at any nesting level.
- *
- * @example
- * ```typescript
- * const tracker = new DatabaseDirtyTracker({ name: "Alice", age: 30 });
- * tracker.mergeChanges({ age: 31 });
- * console.log(tracker.hasChanges()); // true
- * console.log(tracker.getDirtyColumns()); // ["age"]
- * console.log(tracker.getDirtyColumnsWithValues());
- * // { age: { oldValue: 30, newValue: 31 } }
- * ```
- */
-export declare class DatabaseDirtyTracker {
-    /**
-     * The initial raw data snapshot taken at construction or last reset.
-     * Used as the baseline for comparison.
-     */
-    protected initialRaw: Record<string, unknown>;
-    /**
-     * The current raw data snapshot reflecting all changes made via merge/unset.
-     */
-    protected currentRaw: Record<string, unknown>;
-    /**
-     * Flattened version of the initial data using dot-notation keys.
-     * Example: { "address.city": "NYC" }
-     */
-    protected initialFlattened: FlatRecord;
-    /**
-     * Flattened version of the current data using dot-notation keys.
-     */
-    protected currentFlattened: FlatRecord;
-    /**
-     * Set of column names (dot-notation paths) that have been modified.
-     */
-    protected readonly dirtyColumns: Set<string>;
-    /**
-     * Set of column names (dot-notation paths) that existed initially but have been removed.
-     */
-    protected readonly removedColumns: Set<string>;
-    constructor(data: Record<string, unknown>);
-    /**
-     * Returns the list of dirty columns using dot-notation.
-     *
-     * A column is considered dirty if its value has changed compared to the initial snapshot.
-     *
-     * @returns An array of column names (dot-notation paths) that have been modified
-     *
-     * @example
-     * ```typescript
-     * tracker.mergeChanges({ name: "Bob", "address.city": "LA" });
-     * tracker.getDirtyColumns(); // ["name", "address.city"]
-     * ```
-     */
-    getDirtyColumns(): string[];
-    /**
-     * Determines whether there are any tracked changes.
-     *
-     * Returns `true` if any columns have been modified or removed since the initial snapshot.
-     *
-     * @returns `true` if there are changes, `false` otherwise
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice" });
-     * tracker.hasChanges(); // false
-     * tracker.mergeChanges({ name: "Bob" });
-     * tracker.hasChanges(); // true
-     * tracker.unset("name");
-     * tracker.hasChanges(); // true (removed column counts as a change)
-     * ```
-     */
-    hasChanges(): boolean;
-    /**
-     * Check if the given column is dirty (changed)
-     */
-    isDirty(column: string): boolean;
-    /**
-     * Returns the set of columns that have been removed compared to the baseline.
-     *
-     * A column is considered removed if it existed in the initial snapshot but has been
-     * explicitly unset or deleted from the current data.
-     *
-     * @returns An array of column names (dot-notation paths) that have been removed
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice", temp: "value" });
-     * tracker.unset("temp");
-     * tracker.getRemovedColumns(); // ["temp"]
-     * ```
-     */
-    getRemovedColumns(): string[];
-    /**
-     * Provides a mapping of dirty columns to their previous and current values.
-     *
-     * This is useful for generating audit logs, building partial update payloads,
-     * or displaying change summaries to users.
-     *
-     * @returns A record mapping each dirty column to an object containing oldValue and newValue
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice", age: 30 });
-     * tracker.mergeChanges({ age: 31 });
-     * tracker.getDirtyColumnsWithValues();
-     * // { age: { oldValue: 30, newValue: 31 } }
-     * ```
-     */
-    getDirtyColumnsWithValues(): Record<string, DirtyColumnValues>;
-    /**
-     * Replaces the current data snapshot entirely and recomputes the diff.
-     *
-     * This is useful when you want to replace all current data with a new set,
-     * while keeping the initial baseline for comparison.
-     *
-     * @param data - The new data to set as the current snapshot
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice" });
-     * tracker.replaceCurrentData({ name: "Bob", email: "bob@example.com" });
-     * tracker.getDirtyColumns(); // ["name", "email"]
-     * ```
-     */
-    replaceCurrentData(data: Record<string, unknown>): void;
-    /**
-     * Merges a partial payload into the current snapshot and recomputes the diff.
-     *
-     * This performs a deep merge, preserving existing nested structures while
-     * updating only the specified fields.
-     *
-     * @param partial - Partial data to merge into the current snapshot
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice", address: { city: "NYC" } });
-     * tracker.mergeChanges({ address: { zip: "10001" } });
-     * // Current data: { name: "Alice", address: { city: "NYC", zip: "10001" } }
-     * tracker.getDirtyColumns(); // ["address.zip"]
-     * ```
-     */
-    mergeChanges(partial: Record<string, unknown>): void;
-    /**
-     * Explicitly removes one or more columns from the current data.
-     *
-     * Supports both single column names and arrays of column names.
-     * Columns can be specified using dot-notation for nested paths.
-     *
-     * @param columns - A single column name or an array of column names to remove
-     *
-     * @example
-     * ```typescript
-     * tracker.unset("tempField");
-     * tracker.unset(["field1", "field2", "nested.field"]);
-     * tracker.getRemovedColumns(); // ["tempField", "field1", "field2", "nested.field"]
-     * ```
-     */
-    unset(columns: string | string[]): void;
-    /**
-     * Resets both the initial and current snapshots to the provided data.
-     *
-     * If no data is provided, the current snapshot becomes the new baseline.
-     * This clears all tracked changes and removed columns.
-     *
-     * @param data - Optional new data to use as the baseline. If omitted, uses current data.
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice" });
-     * tracker.mergeChanges({ name: "Bob" });
-     * tracker.hasChanges(); // true
-     * tracker.reset(); // Make current state the new baseline
-     * tracker.hasChanges(); // false
-     *
-     * // Or reset to entirely new data:
-     * tracker.reset({ name: "Charlie", age: 25 });
-     * ```
-     */
-    reset(data?: Record<string, unknown>): void;
-    /**
-     * Flattens the given data object.
-     * Can be overridden by subclasses to change flattening behavior.
-     */
-    protected flattenData(data: Record<string, unknown>): FlatRecord;
-    /**
-     * Recomputes the dirty and removed column sets by comparing initial and current snapshots.
-     *
-     * This method is called internally after any operation that modifies the current data.
-     * It iterates through all keys in both flattened snapshots and determines which columns
-     * have been modified or removed.
-     *
-     * @protected
-     */
-    protected updateDirtyState(): void;
-    /**
-     * Recursively merges source object into target object, performing a deep merge.
-     *
-     * For nested objects, the merge is recursive. For arrays and primitives, the source
-     * value replaces the target value. All values are cloned to prevent reference sharing.
-     *
-     * @param target - The object to merge into
-     * @param source - The object to merge from
-     * @private
-     */
-    protected mergeIntoRaw(target: Record<string, unknown>, source: Record<string, unknown>): void;
-    /**
-     * Deletes a field from the current raw data using a dot-notation path.
-     *
-     * Supports nested paths (e.g., "address.city") and array indices (e.g., "items.0").
-     * If any segment in the path doesn't exist, the operation is a no-op.
-     *
-     * @param path - The dot-notation path to the field to delete
-     * @private
-     */
-    protected deleteFromRaw(path: string): void;
-    /**
-     * Resolves a single segment of a dot-notation path within a container.
-     *
-     * Handles both object property access and array index access.
-     *
-     * @param container - The object or array to access
-     * @param segment - The property name or array index as a string
-     * @returns The value at the specified segment, or undefined if not found
-     * @private
-     */
-    protected resolveSegment(container: unknown, segment: string): unknown;
-    /**
-     * Creates a deep clone of the provided data.
-     *
-     * @param data - The data to clone
-     * @returns A deep clone of the data
-     * @private
-     */
-    protected cloneData<T>(data: T): T;
-}
-export {};
-//# sourceMappingURL=database-dirty-tracker.d.ts.map

package/cjs/database-dirty-tracker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-dirty-tracker.d.ts","sourceRoot":"","sources":["../src/database-dirty-tracker.ts"],"names":[],"mappings":"AA4CA;;GAEG;AACH,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1C;;GAEG;AACH,KAAK,iBAAiB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAElE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAoB;IAC/B;;;OAGG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9C;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9C;;;OAGG;IACH,SAAS,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAEvC;;OAEG;IACH,SAAS,CAAC,gBAAgB,EAAE,UAAU,CAAC;IAEvC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,YAAY,cAAqB;IAEpD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,cAAc,cAAqB;gBAEnC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAUhD;;;;;;;;;;;;OAYG;IACI,eAAe,IAAI,MAAM,EAAE;IAIlC;;;;;;;;;;;;;;;;OAgBG;IACI,UAAU,IAAI,OAAO;IAI5B;;OAEG;IACI,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIvC;;;;;;;;;;;;;;OAcG;IACI,iBAAiB,IAAI,MAAM,EAAE;IAIpC;;;;;;;;;;;;;;;OAeG;IACI,yBAAyB,IAAI,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAgBrE;;;;;;;;;;;;;;OAcG;IACI,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM9D;;;;;;;;;;;;;;;OAeG;IACI,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAM3D;;;;;;;;;;;;;;OAcG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAW9C;;;;;;;;;;;;;;;;;;;OAmBG;IACI,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAYlD;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU;IAIhE;;;;;;;;OAQG;IACH,SAAS,CAAC,gBAAgB,IAAI,IAAI;IA0BlC;;;;;;;;;OASG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAkB9F;;;;;;;;OAQG;IACH,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IA8B3C;;;;;;;;;OASG;IACH,SAAS,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAiBtE;;;;;;OAMG;IACH,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC;CAGnC"}

package/cjs/database-dirty-tracker.js

@@ -1,386 +0,0 @@
-'use strict';var reinforcements=require('@mongez/reinforcements'),supportiveIs=require('@mongez/supportive-is');function canBeFlatten(object) {
-    return supportiveIs.isPlainObject(object);
-}
-/**
- * A fix for flatten as non-plain object is being flatten as well which it should not be
- */
-function flatten(object, separator = ".", keepNestedOriginalObject = false, parent, root = {}) {
-    if (canBeFlatten(object) === false) {
-        return object;
-    }
-    // object = toPlainObject(object);
-    for (const key of Object.keys(object)) {
-        const value = object[key];
-        const keyChain = parent ? parent + separator + key : key;
-        if ((Array.isArray(value) && value.length === 0) || typeof value === "function") {
-            root[keyChain] = value;
-        }
-        else if (canBeFlatten(value)) {
-            if (keepNestedOriginalObject) {
-                root[keyChain] = value;
-            }
-            flatten(value, separator, keepNestedOriginalObject, keyChain, root);
-        }
-        else {
-            root[keyChain] = value;
-        }
-    }
-    return root;
-}
-/**
- * Tracks changes to model data by maintaining snapshots of initial and current state.
- *
- * The tracker stores both raw (nested) and flattened (dot-notation) versions of the data
- * to accurately detect modifications, additions, and removals at any nesting level.
- *
- * @example
- * ```typescript
- * const tracker = new DatabaseDirtyTracker({ name: "Alice", age: 30 });
- * tracker.mergeChanges({ age: 31 });
- * console.log(tracker.hasChanges()); // true
- * console.log(tracker.getDirtyColumns()); // ["age"]
- * console.log(tracker.getDirtyColumnsWithValues());
- * // { age: { oldValue: 30, newValue: 31 } }
- * ```
- */
-class DatabaseDirtyTracker {
-    /**
-     * The initial raw data snapshot taken at construction or last reset.
-     * Used as the baseline for comparison.
-     */
-    initialRaw;
-    /**
-     * The current raw data snapshot reflecting all changes made via merge/unset.
-     */
-    currentRaw;
-    /**
-     * Flattened version of the initial data using dot-notation keys.
-     * Example: { "address.city": "NYC" }
-     */
-    initialFlattened;
-    /**
-     * Flattened version of the current data using dot-notation keys.
-     */
-    currentFlattened;
-    /**
-     * Set of column names (dot-notation paths) that have been modified.
-     */
-    dirtyColumns = new Set();
-    /**
-     * Set of column names (dot-notation paths) that existed initially but have been removed.
-     */
-    removedColumns = new Set();
-    constructor(data) {
-        this.initialRaw = this.cloneData(data);
-        this.currentRaw = this.cloneData(data);
-        this.initialFlattened = this.flattenData(this.initialRaw);
-        this.currentFlattened = { ...this.initialFlattened };
-        this.updateDirtyState();
-    }
-    /**
-     * Returns the list of dirty columns using dot-notation.
-     *
-     * A column is considered dirty if its value has changed compared to the initial snapshot.
-     *
-     * @returns An array of column names (dot-notation paths) that have been modified
-     *
-     * @example
-     * ```typescript
-     * tracker.mergeChanges({ name: "Bob", "address.city": "LA" });
-     * tracker.getDirtyColumns(); // ["name", "address.city"]
-     * ```
-     */
-    getDirtyColumns() {
-        return Array.from(this.dirtyColumns);
-    }
-    /**
-     * Determines whether there are any tracked changes.
-     *
-     * Returns `true` if any columns have been modified or removed since the initial snapshot.
-     *
-     * @returns `true` if there are changes, `false` otherwise
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice" });
-     * tracker.hasChanges(); // false
-     * tracker.mergeChanges({ name: "Bob" });
-     * tracker.hasChanges(); // true
-     * tracker.unset("name");
-     * tracker.hasChanges(); // true (removed column counts as a change)
-     * ```
-     */
-    hasChanges() {
-        return this.dirtyColumns.size > 0 || this.removedColumns.size > 0;
-    }
-    /**
-     * Check if the given column is dirty (changed)
-     */
-    isDirty(column) {
-        return this.dirtyColumns.has(column);
-    }
-    /**
-     * Returns the set of columns that have been removed compared to the baseline.
-     *
-     * A column is considered removed if it existed in the initial snapshot but has been
-     * explicitly unset or deleted from the current data.
-     *
-     * @returns An array of column names (dot-notation paths) that have been removed
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice", temp: "value" });
-     * tracker.unset("temp");
-     * tracker.getRemovedColumns(); // ["temp"]
-     * ```
-     */
-    getRemovedColumns() {
-        return Array.from(this.removedColumns);
-    }
-    /**
-     * Provides a mapping of dirty columns to their previous and current values.
-     *
-     * This is useful for generating audit logs, building partial update payloads,
-     * or displaying change summaries to users.
-     *
-     * @returns A record mapping each dirty column to an object containing oldValue and newValue
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice", age: 30 });
-     * tracker.mergeChanges({ age: 31 });
-     * tracker.getDirtyColumnsWithValues();
-     * // { age: { oldValue: 30, newValue: 31 } }
-     * ```
-     */
-    getDirtyColumnsWithValues() {
-        const result = {};
-        for (const column of this.dirtyColumns) {
-            const hasCurrent = this.currentFlattened[column] !== undefined || column in this.currentFlattened;
-            result[column] = {
-                oldValue: this.initialFlattened[column],
-                newValue: hasCurrent ? this.currentFlattened[column] : undefined,
-            };
-        }
-        return result;
-    }
-    /**
-     * Replaces the current data snapshot entirely and recomputes the diff.
-     *
-     * This is useful when you want to replace all current data with a new set,
-     * while keeping the initial baseline for comparison.
-     *
-     * @param data - The new data to set as the current snapshot
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice" });
-     * tracker.replaceCurrentData({ name: "Bob", email: "bob@example.com" });
-     * tracker.getDirtyColumns(); // ["name", "email"]
-     * ```
-     */
-    replaceCurrentData(data) {
-        this.currentRaw = this.cloneData(data);
-        this.currentFlattened = this.flattenData(this.currentRaw);
-        this.updateDirtyState();
-    }
-    /**
-     * Merges a partial payload into the current snapshot and recomputes the diff.
-     *
-     * This performs a deep merge, preserving existing nested structures while
-     * updating only the specified fields.
-     *
-     * @param partial - Partial data to merge into the current snapshot
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice", address: { city: "NYC" } });
-     * tracker.mergeChanges({ address: { zip: "10001" } });
-     * // Current data: { name: "Alice", address: { city: "NYC", zip: "10001" } }
-     * tracker.getDirtyColumns(); // ["address.zip"]
-     * ```
-     */
-    mergeChanges(partial) {
-        this.mergeIntoRaw(this.currentRaw, partial);
-        this.currentFlattened = this.flattenData(this.currentRaw);
-        this.updateDirtyState();
-    }
-    /**
-     * Explicitly removes one or more columns from the current data.
-     *
-     * Supports both single column names and arrays of column names.
-     * Columns can be specified using dot-notation for nested paths.
-     *
-     * @param columns - A single column name or an array of column names to remove
-     *
-     * @example
-     * ```typescript
-     * tracker.unset("tempField");
-     * tracker.unset(["field1", "field2", "nested.field"]);
-     * tracker.getRemovedColumns(); // ["tempField", "field1", "field2", "nested.field"]
-     * ```
-     */
-    unset(columns) {
-        const targets = Array.isArray(columns) ? columns : [columns];
-        for (const path of targets) {
-            this.deleteFromRaw(path);
-        }
-        this.currentFlattened = this.flattenData(this.currentRaw);
-        this.updateDirtyState();
-    }
-    /**
-     * Resets both the initial and current snapshots to the provided data.
-     *
-     * If no data is provided, the current snapshot becomes the new baseline.
-     * This clears all tracked changes and removed columns.
-     *
-     * @param data - Optional new data to use as the baseline. If omitted, uses current data.
-     *
-     * @example
-     * ```typescript
-     * const tracker = new DatabaseDirtyTracker({ name: "Alice" });
-     * tracker.mergeChanges({ name: "Bob" });
-     * tracker.hasChanges(); // true
-     * tracker.reset(); // Make current state the new baseline
-     * tracker.hasChanges(); // false
-     *
-     * // Or reset to entirely new data:
-     * tracker.reset({ name: "Charlie", age: 25 });
-     * ```
-     */
-    reset(data) {
-        const source = data ?? this.currentRaw;
-        this.initialRaw = this.cloneData(source);
-        this.currentRaw = this.cloneData(source);
-        this.initialFlattened = this.flattenData(this.initialRaw);
-        this.currentFlattened = this.flattenData(this.currentRaw);
-        this.dirtyColumns.clear();
-        this.removedColumns.clear();
-    }
-    /**
-     * Flattens the given data object.
-     * Can be overridden by subclasses to change flattening behavior.
-     */
-    flattenData(data) {
-        return flatten(data);
-    }
-    /**
-     * Recomputes the dirty and removed column sets by comparing initial and current snapshots.
-     *
-     * This method is called internally after any operation that modifies the current data.
-     * It iterates through all keys in both flattened snapshots and determines which columns
-     * have been modified or removed.
-     *
-     * @protected
-     */
-    updateDirtyState() {
-        this.dirtyColumns.clear();
-        this.removedColumns.clear();
-        const keys = new Set([
-            ...Object.keys(this.initialFlattened),
-            ...Object.keys(this.currentFlattened),
-        ]);
-        for (const key of keys) {
-            const hasCurrent = this.currentFlattened[key] !== undefined || key in this.currentFlattened;
-            const hasInitial = this.initialFlattened[key] !== undefined || key in this.initialFlattened;
-            if (!hasCurrent && hasInitial) {
-                this.removedColumns.add(key);
-            }
-            const initialValue = this.initialFlattened[key];
-            const currentValue = hasCurrent ? this.currentFlattened[key] : undefined;
-            if (!reinforcements.areEqual(initialValue, currentValue)) {
-                this.dirtyColumns.add(key);
-            }
-        }
-    }
-    /**
-     * Recursively merges source object into target object, performing a deep merge.
-     *
-     * For nested objects, the merge is recursive. For arrays and primitives, the source
-     * value replaces the target value. All values are cloned to prevent reference sharing.
-     *
-     * @param target - The object to merge into
-     * @param source - The object to merge from
-     * @private
-     */
-    mergeIntoRaw(target, source) {
-        for (const [key, value] of Object.entries(source)) {
-            if (value &&
-                typeof value === "object" &&
-                !Array.isArray(value) &&
-                target[key] &&
-                typeof target[key] === "object" &&
-                !Array.isArray(target[key])) {
-                this.mergeIntoRaw(target[key], value);
-                continue;
-            }
-            target[key] = this.cloneData(value);
-        }
-    }
-    /**
-     * Deletes a field from the current raw data using a dot-notation path.
-     *
-     * Supports nested paths (e.g., "address.city") and array indices (e.g., "items.0").
-     * If any segment in the path doesn't exist, the operation is a no-op.
-     *
-     * @param path - The dot-notation path to the field to delete
-     * @private
-     */
-    deleteFromRaw(path) {
-        const segments = path.split(".");
-        let container = this.currentRaw;
-        for (let index = 0; index < segments.length - 1; index += 1) {
-            if (container === undefined || container === null) {
-                return;
-            }
-            container = this.resolveSegment(container, segments[index]);
-        }
-        if (container === undefined || container === null) {
-            return;
-        }
-        const lastSegment = segments[segments.length - 1];
-        if (Array.isArray(container)) {
-            const numericIndex = Number(lastSegment);
-            if (!Number.isNaN(numericIndex)) {
-                container.splice(numericIndex, 1);
-            }
-            return;
-        }
-        if (typeof container === "object") {
-            delete container[lastSegment];
-        }
-    }
-    /**
-     * Resolves a single segment of a dot-notation path within a container.
-     *
-     * Handles both object property access and array index access.
-     *
-     * @param container - The object or array to access
-     * @param segment - The property name or array index as a string
-     * @returns The value at the specified segment, or undefined if not found
-     * @private
-     */
-    resolveSegment(container, segment) {
-        if (Array.isArray(container)) {
-            const numericIndex = Number(segment);
-            if (Number.isNaN(numericIndex)) {
-                return undefined;
-            }
-            return container[numericIndex];
-        }
-        if (container && typeof container === "object") {
-            return container[segment];
-        }
-        return undefined;
-    }
-    /**
-     * Creates a deep clone of the provided data.
-     *
-     * @param data - The data to clone
-     * @returns A deep clone of the data
-     * @private
-     */
-    cloneData(data) {
-        return reinforcements.clone(data);
-    }
-}exports.DatabaseDirtyTracker=DatabaseDirtyTracker;//# sourceMappingURL=database-dirty-tracker.js.map

package/cjs/database-dirty-tracker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-dirty-tracker.js","sources":["../src/database-dirty-tracker.ts"],"sourcesContent":[null],"names":["isPlainObject","areEqual","clone"],"mappings":"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"}

package/cjs/drivers/mongodb/mongodb-blueprint.d.ts

@@ -1,30 +0,0 @@
-import type { Db, IndexDescriptionInfo } from "mongodb";
-import { DriverBlueprintContract, TableIndexInformation } from "../../contracts/driver-blueprint.contract";
-export declare class MongoDBBlueprint implements DriverBlueprintContract {
-    protected database: Db;
-    /**
-     * Constructor
-     */
-    constructor(database: Db);
-    /**
-     * List all tables in the database
-     */
-    listTables(): Promise<string[]>;
-    /**
-     * List all indexes for a specific table
-     */
-    listIndexes(table: string): Promise<TableIndexInformation[]>;
-    /**
-     * Build index information
-     */
-    protected buildIndexInformation(index: IndexDescriptionInfo): TableIndexInformation;
-    /**
-     * List all columns for a specific table
-     */
-    listColumns(table: string): Promise<string[]>;
-    /**
-     * Check if the given table exists
-     */
-    tableExists(table: string): Promise<boolean>;
-}
-//# sourceMappingURL=mongodb-blueprint.d.ts.map