arkormx 1.0.0 → 1.1.0

package/dist/index.cjs

@@ -5127,8 +5127,14 @@ var Model = class Model {
 	visible = [];
 	appends = [];
 	attributes;
+	original;
+	changes;
+	touchedAttributes;
 	constructor(attributes = {}) {
 		this.attributes = {};
+		this.original = {};
+		this.changes = {};
+		this.touchedAttributes = /* @__PURE__ */ new Set();
 		this.fill(attributes);
 		return new Proxy(this, {
 			get: (target, key, receiver) => {
@@ -5428,7 +5434,10 @@ var Model = class Model {
 	* @returns 
 	*/
 	static hydrate(attributes) {
-		return new this(attributes);
+		const model = new this(attributes);
+		model.syncOriginal();
+		model.syncChanges({});
+		return model;
 	}
 	/**
 	* Hydrate multiple model instances from an array of plain objects of attributes.
@@ -5495,6 +5504,7 @@ var Model = class Model {
 		else if (mutator) resolved = mutator.call(this, resolved);
 		if (cast) resolved = resolveCast(cast).set(resolved);
 		this.attributes[key] = resolved;
+		this.touchedAttributes.add(key);
 		return this;
 	}
 	/**
@@ -5507,12 +5517,15 @@ var Model = class Model {
 	async save() {
 		const identifier = this.getAttribute("id");
 		const payload = this.getRawAttributes();
+		const previousOriginal = this.getOriginal();
 		const constructor = this.constructor;
 		if (identifier == null) {
 			await Model.dispatchEvent(constructor, "saving", this);
 			await Model.dispatchEvent(constructor, "creating", this);
 			const model = await constructor.query().create(payload);
 			this.fill(model.getRawAttributes());
+			this.syncChanges(previousOriginal);
+			this.syncOriginal();
 			await Model.dispatchEvent(constructor, "created", this);
 			await Model.dispatchEvent(constructor, "saved", this);
 			return this;
@@ -5521,6 +5534,8 @@ var Model = class Model {
 		await Model.dispatchEvent(constructor, "updating", this);
 		const model = await constructor.query().where({ id: identifier }).update(payload);
 		this.fill(model.getRawAttributes());
+		this.syncChanges(previousOriginal);
+		this.syncOriginal();
 		await Model.dispatchEvent(constructor, "updated", this);
 		await Model.dispatchEvent(constructor, "saved", this);
 		return this;
@@ -5544,17 +5559,22 @@ var Model = class Model {
 	async delete() {
 		const identifier = this.getAttribute("id");
 		if (identifier == null) throw new ArkormException("Cannot delete a model without an id.");
+		const previousOriginal = this.getOriginal();
 		const constructor = this.constructor;
 		await Model.dispatchEvent(constructor, "deleting", this);
 		const softDeleteConfig = constructor.getSoftDeleteConfig();
 		if (softDeleteConfig.enabled) {
 			const model = await constructor.query().where({ id: identifier }).update({ [softDeleteConfig.column]: /* @__PURE__ */ new Date() });
 			this.fill(model.getRawAttributes());
+			this.syncChanges(previousOriginal);
+			this.syncOriginal();
 			await Model.dispatchEvent(constructor, "deleted", this);
 			return this;
 		}
 		const deleted = await constructor.query().where({ id: identifier }).delete();
 		this.fill(deleted.getRawAttributes());
+		this.syncChanges(previousOriginal);
+		this.syncOriginal();
 		await Model.dispatchEvent(constructor, "deleted", this);
 		return this;
 	}
@@ -5575,11 +5595,14 @@ var Model = class Model {
 	async forceDelete() {
 		const identifier = this.getAttribute("id");
 		if (identifier == null) throw new ArkormException("Cannot force delete a model without an id.");
+		const previousOriginal = this.getOriginal();
 		const constructor = this.constructor;
 		await Model.dispatchEvent(constructor, "forceDeleting", this);
 		await Model.dispatchEvent(constructor, "deleting", this);
 		const deleted = await constructor.query().withTrashed().where({ id: identifier }).delete();
 		this.fill(deleted.getRawAttributes());
+		this.syncChanges(previousOriginal);
+		this.syncOriginal();
 		await Model.dispatchEvent(constructor, "deleted", this);
 		await Model.dispatchEvent(constructor, "forceDeleted", this);
 		return this;
@@ -5603,9 +5626,12 @@ var Model = class Model {
 		const constructor = this.constructor;
 		const softDeleteConfig = constructor.getSoftDeleteConfig();
 		if (!softDeleteConfig.enabled) return this;
+		const previousOriginal = this.getOriginal();
 		await Model.dispatchEvent(constructor, "restoring", this);
 		const model = await constructor.query().withTrashed().where({ id: identifier }).update({ [softDeleteConfig.column]: null });
 		this.fill(model.getRawAttributes());
+		this.syncChanges(previousOriginal);
+		this.syncOriginal();
 		await Model.dispatchEvent(constructor, "restored", this);
 		return this;
 	}
@@ -5643,6 +5669,42 @@ var Model = class Model {
 	getRawAttributes() {
 		return { ...this.attributes };
 	}
+	getOriginal(key) {
+		if (typeof key === "string") return Model.cloneAttributeValue(this.original[key]);
+		return Object.entries(this.original).reduce((all, [originalKey, value]) => {
+			all[originalKey] = Model.cloneAttributeValue(value);
+			return all;
+		}, {});
+	}
+	/**
+	* Determine whether the model has unsaved attribute changes.
+	*
+	* @param keys
+	* @returns
+	*/
+	isDirty(keys) {
+		return Object.keys(this.getDirtyAttributes(keys)).length > 0;
+	}
+	/**
+	* Determine whether the model has no unsaved attribute changes.
+	*
+	* @param keys
+	* @returns
+	*/
+	isClean(keys) {
+		return !this.isDirty(keys);
+	}
+	/**
+	* Determine whether the model changed during the last successful persistence operation.
+	*
+	* @param keys
+	* @returns
+	*/
+	wasChanged(keys) {
+		const keyList = this.normalizeAttributeKeys(keys);
+		if (keyList.length === 0) return Object.keys(this.changes).length > 0;
+		return keyList.some((key) => Object.prototype.hasOwnProperty.call(this.changes, key));
+	}
 	/**
 	* Convert the model instance to a plain object, applying visibility 
 	* rules, appends, and mutators.
@@ -5833,6 +5895,34 @@ var Model = class Model {
 		return typeof method === "function" ? method : null;
 	}
 	/**
+	* Build a map of dirty attributes, optionally limited to specific keys.
+	*
+	* @param keys
+	* @returns
+	*/
+	getDirtyAttributes(keys) {
+		const requestedKeys = this.normalizeAttributeKeys(keys);
+		return (requestedKeys.length > 0 ? requestedKeys : Array.from(new Set([...Object.keys(this.original), ...this.touchedAttributes]))).reduce((dirty, key) => {
+			const currentValue = this.attributes[key];
+			const originalValue = this.original[key];
+			const hasCurrent = Object.prototype.hasOwnProperty.call(this.attributes, key);
+			const hasOriginal = Object.prototype.hasOwnProperty.call(this.original, key);
+			if (!hasCurrent && !hasOriginal) return dirty;
+			if (hasCurrent !== hasOriginal || !Model.areAttributeValuesEqual(currentValue, originalValue)) dirty[key] = Model.cloneAttributeValue(currentValue);
+			return dirty;
+		}, {});
+	}
+	/**
+	* Normalize a key or key list for dirty/change lookups.
+	*
+	* @param keys
+	* @returns
+	*/
+	normalizeAttributeKeys(keys) {
+		if (typeof keys === "undefined") return [];
+		return Array.isArray(keys) ? keys : [keys];
+	}
+	/**
 	* Resolve an Attribute object mutator method for a given key, if it exists.
 	*
 	* @param key
@@ -5874,6 +5964,66 @@ var Model = class Model {
 		if (!Object.prototype.hasOwnProperty.call(this, "eventListeners")) this.eventListeners = { ...this.eventListeners || {} };
 	}
 	/**
+	* Clone an attribute value to keep snapshot state isolated from live mutations.
+	*
+	* @param value
+	* @returns
+	*/
+	static cloneAttributeValue(value) {
+		if (value instanceof Date) return new Date(value.getTime());
+		if (Array.isArray(value)) return value.map((item) => Model.cloneAttributeValue(item));
+		if (value && typeof value === "object") return Object.entries(value).reduce((all, [key, nestedValue]) => {
+			all[key] = Model.cloneAttributeValue(nestedValue);
+			return all;
+		}, {});
+		return value;
+	}
+	/**
+	* Compare attribute values for dirty/change detection.
+	*
+	* @param left
+	* @param right
+	* @returns
+	*/
+	static areAttributeValuesEqual(left, right) {
+		if (left === right) return true;
+		if (left instanceof Date && right instanceof Date) return left.getTime() === right.getTime();
+		if (Array.isArray(left) && Array.isArray(right)) {
+			if (left.length !== right.length) return false;
+			return left.every((value, index) => Model.areAttributeValuesEqual(value, right[index]));
+		}
+		if (left && right && typeof left === "object" && typeof right === "object") {
+			const leftEntries = Object.entries(left);
+			const rightEntries = Object.entries(right);
+			if (leftEntries.length !== rightEntries.length) return false;
+			return leftEntries.every(([key, value]) => {
+				return Object.prototype.hasOwnProperty.call(right, key) && Model.areAttributeValuesEqual(value, right[key]);
+			});
+		}
+		return false;
+	}
+	/**
+	* Sync the original snapshot to the model's current raw attributes.
+	*/
+	syncOriginal() {
+		this.original = Object.entries(this.attributes).reduce((all, [key, value]) => {
+			all[key] = Model.cloneAttributeValue(value);
+			return all;
+		}, {});
+		this.touchedAttributes.clear();
+	}
+	/**
+	* Sync the last-changed snapshot from a previous original state.
+	*
+	* @param previousOriginal
+	*/
+	syncChanges(previousOriginal) {
+		this.changes = Object.entries(this.getDirtyAttributes()).reduce((all, [key, value]) => {
+			if (!Object.prototype.hasOwnProperty.call(previousOriginal, key) || !Model.areAttributeValuesEqual(value, previousOriginal[key])) all[key] = Model.cloneAttributeValue(value);
+			return all;
+		}, {});
+	}
+	/**
 	* Resolve lifecycle state for the provided model class.
 	*
 	* @param modelClass

package/dist/index.d.cts

@@ -594,6 +594,9 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
   protected visible: string[];
   protected appends: string[];
   protected readonly attributes: Record<string, unknown>;
+  protected original: Record<string, unknown>;
+  protected changes: Record<string, unknown>;
+  protected readonly touchedAttributes: Set<string>;
   constructor(attributes?: Record<string, unknown>);
   /**
    * Set the Prisma client delegates for all models.
@@ -863,6 +866,37 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @returns
    */
   getRawAttributes(): Partial<TAttributes>;
+  /**
+   * Get the model's original persisted attributes.
+   *
+   * @returns
+   */
+  getOriginal(): Partial<TAttributes>;
+  /**
+   * @param key The attribute key to retrieve the original value for.
+   */
+  getOriginal<TKey extends keyof TAttributes & string>(key: TKey): TAttributes[TKey] | undefined;
+  /**
+   * Determine whether the model has unsaved attribute changes.
+   *
+   * @param keys
+   * @returns
+   */
+  isDirty(keys?: string | string[]): boolean;
+  /**
+   * Determine whether the model has no unsaved attribute changes.
+   *
+   * @param keys
+   * @returns
+   */
+  isClean(keys?: string | string[]): boolean;
+  /**
+   * Determine whether the model changed during the last successful persistence operation.
+   *
+   * @param keys
+   * @returns
+   */
+  wasChanged(keys?: string | string[]): boolean;
   /**
    * Convert the model instance to a plain object, applying visibility
    * rules, appends, and mutators.
@@ -1004,6 +1038,20 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @returns
    */
   private resolveGetMutator;
+  /**
+   * Build a map of dirty attributes, optionally limited to specific keys.
+   *
+   * @param keys
+   * @returns
+   */
+  private getDirtyAttributes;
+  /**
+   * Normalize a key or key list for dirty/change lookups.
+   *
+   * @param keys
+   * @returns
+   */
+  private normalizeAttributeKeys;
   /**
    * Resolve an Attribute object mutator method for a given key, if it exists.
    *
@@ -1026,6 +1074,31 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * Ensures event listeners are own properties on subclass constructors.
    */
   private static ensureOwnEventListeners;
+  /**
+   * Clone an attribute value to keep snapshot state isolated from live mutations.
+   *
+   * @param value
+   * @returns
+   */
+  private static cloneAttributeValue;
+  /**
+   * Compare attribute values for dirty/change detection.
+   *
+   * @param left
+   * @param right
+   * @returns
+   */
+  private static areAttributeValuesEqual;
+  /**
+   * Sync the original snapshot to the model's current raw attributes.
+   */
+  private syncOriginal;
+  /**
+   * Sync the last-changed snapshot from a previous original state.
+   *
+   * @param previousOriginal
+   */
+  private syncChanges;
   /**
    * Resolve lifecycle state for the provided model class.
    *

package/dist/index.d.mts

@@ -594,6 +594,9 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
   protected visible: string[];
   protected appends: string[];
   protected readonly attributes: Record<string, unknown>;
+  protected original: Record<string, unknown>;
+  protected changes: Record<string, unknown>;
+  protected readonly touchedAttributes: Set<string>;
   constructor(attributes?: Record<string, unknown>);
   /**
    * Set the Prisma client delegates for all models.
@@ -863,6 +866,37 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @returns
    */
   getRawAttributes(): Partial<TAttributes>;
+  /**
+   * Get the model's original persisted attributes.
+   *
+   * @returns
+   */
+  getOriginal(): Partial<TAttributes>;
+  /**
+   * @param key The attribute key to retrieve the original value for.
+   */
+  getOriginal<TKey extends keyof TAttributes & string>(key: TKey): TAttributes[TKey] | undefined;
+  /**
+   * Determine whether the model has unsaved attribute changes.
+   *
+   * @param keys
+   * @returns
+   */
+  isDirty(keys?: string | string[]): boolean;
+  /**
+   * Determine whether the model has no unsaved attribute changes.
+   *
+   * @param keys
+   * @returns
+   */
+  isClean(keys?: string | string[]): boolean;
+  /**
+   * Determine whether the model changed during the last successful persistence operation.
+   *
+   * @param keys
+   * @returns
+   */
+  wasChanged(keys?: string | string[]): boolean;
   /**
    * Convert the model instance to a plain object, applying visibility
    * rules, appends, and mutators.
@@ -1004,6 +1038,20 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * @returns
    */
   private resolveGetMutator;
+  /**
+   * Build a map of dirty attributes, optionally limited to specific keys.
+   *
+   * @param keys
+   * @returns
+   */
+  private getDirtyAttributes;
+  /**
+   * Normalize a key or key list for dirty/change lookups.
+   *
+   * @param keys
+   * @returns
+   */
+  private normalizeAttributeKeys;
   /**
    * Resolve an Attribute object mutator method for a given key, if it exists.
    *
@@ -1026,6 +1074,31 @@ declare abstract class Model<TSchema extends PrismaDelegateLike | Record<string,
    * Ensures event listeners are own properties on subclass constructors.
    */
   private static ensureOwnEventListeners;
+  /**
+   * Clone an attribute value to keep snapshot state isolated from live mutations.
+   *
+   * @param value
+   * @returns
+   */
+  private static cloneAttributeValue;
+  /**
+   * Compare attribute values for dirty/change detection.
+   *
+   * @param left
+   * @param right
+   * @returns
+   */
+  private static areAttributeValuesEqual;
+  /**
+   * Sync the original snapshot to the model's current raw attributes.
+   */
+  private syncOriginal;
+  /**
+   * Sync the last-changed snapshot from a previous original state.
+   *
+   * @param previousOriginal
+   */
+  private syncChanges;
   /**
    * Resolve lifecycle state for the provided model class.
    *

package/dist/index.mjs

@@ -5098,8 +5098,14 @@ var Model = class Model {
 	visible = [];
 	appends = [];
 	attributes;
+	original;
+	changes;
+	touchedAttributes;
 	constructor(attributes = {}) {
 		this.attributes = {};
+		this.original = {};
+		this.changes = {};
+		this.touchedAttributes = /* @__PURE__ */ new Set();
 		this.fill(attributes);
 		return new Proxy(this, {
 			get: (target, key, receiver) => {
@@ -5399,7 +5405,10 @@ var Model = class Model {
 	* @returns 
 	*/
 	static hydrate(attributes) {
-		return new this(attributes);
+		const model = new this(attributes);
+		model.syncOriginal();
+		model.syncChanges({});
+		return model;
 	}
 	/**
 	* Hydrate multiple model instances from an array of plain objects of attributes.
@@ -5466,6 +5475,7 @@ var Model = class Model {
 		else if (mutator) resolved = mutator.call(this, resolved);
 		if (cast) resolved = resolveCast(cast).set(resolved);
 		this.attributes[key] = resolved;
+		this.touchedAttributes.add(key);
 		return this;
 	}
 	/**
@@ -5478,12 +5488,15 @@ var Model = class Model {
 	async save() {
 		const identifier = this.getAttribute("id");
 		const payload = this.getRawAttributes();
+		const previousOriginal = this.getOriginal();
 		const constructor = this.constructor;
 		if (identifier == null) {
 			await Model.dispatchEvent(constructor, "saving", this);
 			await Model.dispatchEvent(constructor, "creating", this);
 			const model = await constructor.query().create(payload);
 			this.fill(model.getRawAttributes());
+			this.syncChanges(previousOriginal);
+			this.syncOriginal();
 			await Model.dispatchEvent(constructor, "created", this);
 			await Model.dispatchEvent(constructor, "saved", this);
 			return this;
@@ -5492,6 +5505,8 @@ var Model = class Model {
 		await Model.dispatchEvent(constructor, "updating", this);
 		const model = await constructor.query().where({ id: identifier }).update(payload);
 		this.fill(model.getRawAttributes());
+		this.syncChanges(previousOriginal);
+		this.syncOriginal();
 		await Model.dispatchEvent(constructor, "updated", this);
 		await Model.dispatchEvent(constructor, "saved", this);
 		return this;
@@ -5515,17 +5530,22 @@ var Model = class Model {
 	async delete() {
 		const identifier = this.getAttribute("id");
 		if (identifier == null) throw new ArkormException("Cannot delete a model without an id.");
+		const previousOriginal = this.getOriginal();
 		const constructor = this.constructor;
 		await Model.dispatchEvent(constructor, "deleting", this);
 		const softDeleteConfig = constructor.getSoftDeleteConfig();
 		if (softDeleteConfig.enabled) {
 			const model = await constructor.query().where({ id: identifier }).update({ [softDeleteConfig.column]: /* @__PURE__ */ new Date() });
 			this.fill(model.getRawAttributes());
+			this.syncChanges(previousOriginal);
+			this.syncOriginal();
 			await Model.dispatchEvent(constructor, "deleted", this);
 			return this;
 		}
 		const deleted = await constructor.query().where({ id: identifier }).delete();
 		this.fill(deleted.getRawAttributes());
+		this.syncChanges(previousOriginal);
+		this.syncOriginal();
 		await Model.dispatchEvent(constructor, "deleted", this);
 		return this;
 	}
@@ -5546,11 +5566,14 @@ var Model = class Model {
 	async forceDelete() {
 		const identifier = this.getAttribute("id");
 		if (identifier == null) throw new ArkormException("Cannot force delete a model without an id.");
+		const previousOriginal = this.getOriginal();
 		const constructor = this.constructor;
 		await Model.dispatchEvent(constructor, "forceDeleting", this);
 		await Model.dispatchEvent(constructor, "deleting", this);
 		const deleted = await constructor.query().withTrashed().where({ id: identifier }).delete();
 		this.fill(deleted.getRawAttributes());
+		this.syncChanges(previousOriginal);
+		this.syncOriginal();
 		await Model.dispatchEvent(constructor, "deleted", this);
 		await Model.dispatchEvent(constructor, "forceDeleted", this);
 		return this;
@@ -5574,9 +5597,12 @@ var Model = class Model {
 		const constructor = this.constructor;
 		const softDeleteConfig = constructor.getSoftDeleteConfig();
 		if (!softDeleteConfig.enabled) return this;
+		const previousOriginal = this.getOriginal();
 		await Model.dispatchEvent(constructor, "restoring", this);
 		const model = await constructor.query().withTrashed().where({ id: identifier }).update({ [softDeleteConfig.column]: null });
 		this.fill(model.getRawAttributes());
+		this.syncChanges(previousOriginal);
+		this.syncOriginal();
 		await Model.dispatchEvent(constructor, "restored", this);
 		return this;
 	}
@@ -5614,6 +5640,42 @@ var Model = class Model {
 	getRawAttributes() {
 		return { ...this.attributes };
 	}
+	getOriginal(key) {
+		if (typeof key === "string") return Model.cloneAttributeValue(this.original[key]);
+		return Object.entries(this.original).reduce((all, [originalKey, value]) => {
+			all[originalKey] = Model.cloneAttributeValue(value);
+			return all;
+		}, {});
+	}
+	/**
+	* Determine whether the model has unsaved attribute changes.
+	*
+	* @param keys
+	* @returns
+	*/
+	isDirty(keys) {
+		return Object.keys(this.getDirtyAttributes(keys)).length > 0;
+	}
+	/**
+	* Determine whether the model has no unsaved attribute changes.
+	*
+	* @param keys
+	* @returns
+	*/
+	isClean(keys) {
+		return !this.isDirty(keys);
+	}
+	/**
+	* Determine whether the model changed during the last successful persistence operation.
+	*
+	* @param keys
+	* @returns
+	*/
+	wasChanged(keys) {
+		const keyList = this.normalizeAttributeKeys(keys);
+		if (keyList.length === 0) return Object.keys(this.changes).length > 0;
+		return keyList.some((key) => Object.prototype.hasOwnProperty.call(this.changes, key));
+	}
 	/**
 	* Convert the model instance to a plain object, applying visibility 
 	* rules, appends, and mutators.
@@ -5804,6 +5866,34 @@ var Model = class Model {
 		return typeof method === "function" ? method : null;
 	}
 	/**
+	* Build a map of dirty attributes, optionally limited to specific keys.
+	*
+	* @param keys
+	* @returns
+	*/
+	getDirtyAttributes(keys) {
+		const requestedKeys = this.normalizeAttributeKeys(keys);
+		return (requestedKeys.length > 0 ? requestedKeys : Array.from(new Set([...Object.keys(this.original), ...this.touchedAttributes]))).reduce((dirty, key) => {
+			const currentValue = this.attributes[key];
+			const originalValue = this.original[key];
+			const hasCurrent = Object.prototype.hasOwnProperty.call(this.attributes, key);
+			const hasOriginal = Object.prototype.hasOwnProperty.call(this.original, key);
+			if (!hasCurrent && !hasOriginal) return dirty;
+			if (hasCurrent !== hasOriginal || !Model.areAttributeValuesEqual(currentValue, originalValue)) dirty[key] = Model.cloneAttributeValue(currentValue);
+			return dirty;
+		}, {});
+	}
+	/**
+	* Normalize a key or key list for dirty/change lookups.
+	*
+	* @param keys
+	* @returns
+	*/
+	normalizeAttributeKeys(keys) {
+		if (typeof keys === "undefined") return [];
+		return Array.isArray(keys) ? keys : [keys];
+	}
+	/**
 	* Resolve an Attribute object mutator method for a given key, if it exists.
 	*
 	* @param key
@@ -5845,6 +5935,66 @@ var Model = class Model {
 		if (!Object.prototype.hasOwnProperty.call(this, "eventListeners")) this.eventListeners = { ...this.eventListeners || {} };
 	}
 	/**
+	* Clone an attribute value to keep snapshot state isolated from live mutations.
+	*
+	* @param value
+	* @returns
+	*/
+	static cloneAttributeValue(value) {
+		if (value instanceof Date) return new Date(value.getTime());
+		if (Array.isArray(value)) return value.map((item) => Model.cloneAttributeValue(item));
+		if (value && typeof value === "object") return Object.entries(value).reduce((all, [key, nestedValue]) => {
+			all[key] = Model.cloneAttributeValue(nestedValue);
+			return all;
+		}, {});
+		return value;
+	}
+	/**
+	* Compare attribute values for dirty/change detection.
+	*
+	* @param left
+	* @param right
+	* @returns
+	*/
+	static areAttributeValuesEqual(left, right) {
+		if (left === right) return true;
+		if (left instanceof Date && right instanceof Date) return left.getTime() === right.getTime();
+		if (Array.isArray(left) && Array.isArray(right)) {
+			if (left.length !== right.length) return false;
+			return left.every((value, index) => Model.areAttributeValuesEqual(value, right[index]));
+		}
+		if (left && right && typeof left === "object" && typeof right === "object") {
+			const leftEntries = Object.entries(left);
+			const rightEntries = Object.entries(right);
+			if (leftEntries.length !== rightEntries.length) return false;
+			return leftEntries.every(([key, value]) => {
+				return Object.prototype.hasOwnProperty.call(right, key) && Model.areAttributeValuesEqual(value, right[key]);
+			});
+		}
+		return false;
+	}
+	/**
+	* Sync the original snapshot to the model's current raw attributes.
+	*/
+	syncOriginal() {
+		this.original = Object.entries(this.attributes).reduce((all, [key, value]) => {
+			all[key] = Model.cloneAttributeValue(value);
+			return all;
+		}, {});
+		this.touchedAttributes.clear();
+	}
+	/**
+	* Sync the last-changed snapshot from a previous original state.
+	*
+	* @param previousOriginal
+	*/
+	syncChanges(previousOriginal) {
+		this.changes = Object.entries(this.getDirtyAttributes()).reduce((all, [key, value]) => {
+			if (!Object.prototype.hasOwnProperty.call(previousOriginal, key) || !Model.areAttributeValuesEqual(value, previousOriginal[key])) all[key] = Model.cloneAttributeValue(value);
+			return all;
+		}, {});
+	}
+	/**
 	* Resolve lifecycle state for the provided model class.
 	*
 	* @param modelClass

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arkormx",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Modern TypeScript-first ORM for Node.js.",
   "keywords": [
     "orm",