@warlock.js/cascade 4.0.162 → 4.0.164

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

@@ -0,0 +1,252 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,386 @@
+'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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,30 @@
+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