@warlock.js/cascade 4.0.135 → 4.0.137

package/esm/model/model.js

@@ -1,12 +1,4 @@
-import {get,only,set,unset,merge}from'@mongez/reinforcements';import {dataSourceRegistry}from'../data-source/data-source-registry.js';import {DatabaseDirtyTracker}from'../database-dirty-tracker.js';import {ModelEvents,globalModelEvents}from'../events/model-events.js';import {RelationLoader}from'../relations/relation-loader.js';import {DatabaseRemover}from'../remover/database-remover.js';import {DatabaseRestorer}from'../restorer/database-restorer.js';import {modelSync}from'../sync/model-sync.js';import {DatabaseWriter}from'../writer/database-writer.js';import {getModelFromRegistry,getAllModelsFromRegistry,removeModelFromRegistery}from'./register-model.js';/**
- * Sentinel value used to distinguish between undefined and missing fields.
- */
-const MISSING_VALUE = Symbol("missing");
-/**
- * WeakMap registry that associates each model constructor with its own event emitter.
- */
-const modelEventsRegistry = new WeakMap();
-/**
+import {ModelEvents}from'../events/model-events.js';import {RelationLoader}from'../relations/relation-loader.js';import {modelSync}from'../sync/model-sync.js';import {getFieldValue,getOnlyFields,getStringField,getNumberField,getBooleanField,setFieldValue,hasField,incrementField,decrementField,unsetFields,mergeFields}from'./methods/accessor-methods.js';import {destroyModel,deleteRecords,deleteOneRecord}from'./methods/delete-methods.js';import {checkHasChanges,checkIsDirty,getDirtyColumnsWithValues,getRemovedColumns,getDirtyColumns}from'./methods/dirty-methods.js';import {cloneModel,deepFreezeObject,replaceModelData,serializeModel,modelToSnapshot,modelFromSnapshot,hydrateModel}from'./methods/hydration-methods.js';import {emitModelEvent,onModelEvent,onceModelEvent,offModelEvent}from'./methods/instance-event-methods.js';import {performAtomicUpdate,performAtomicIncrement,performAtomicDecrement,generateModelNextId,applyDefaultsToModel}from'./methods/meta-methods.js';import {resolveDataSource,buildQuery,buildNewQueryBuilder,findFirst,findLast,countRecords,findById,findAll,paginateRecords,findLatest,increaseField,decreaseField,performAtomic,updateById,findAndUpdateRecords,findOneAndUpdateRecord,findAndReplaceRecord,findOneAndDeleteRecord}from'./methods/query-methods.js';import {restoreRecord,restoreAllRecords}from'./methods/restore-methods.js';import {addGlobalModelScope,removeGlobalModelScope,addLocalModelScope,removeLocalModelScope}from'./methods/scope-methods.js';import {modelToJSON}from'./methods/serialization-methods.js';import {cleanupModelEvents,getModelEvents,onStaticEvent,onceStaticEvent,offStaticEvent,getGlobalEvents}from'./methods/static-event-methods.js';import {createRecord,createManyRecords,findOrCreateRecord,upsertRecord,saveModel}from'./methods/write-methods.js';import {getModelFromRegistry,getAllModelsFromRegistry}from'./register-model.js';/**
  * Base class that powers all Cascade models.
  *
  * Provides:
@@ -261,11 +253,11 @@ class Model {
     /**
      * Created at column name.
      */
-    static createdAtColumn = "createdAt";
+    static createdAtColumn;
     /**
      * Updated at column name.
      */
-    static updatedAtColumn = "updatedAt";
+    static updatedAtColumn;
     /**
      * Delete strategy for this model.
      *
@@ -404,6 +396,22 @@ class Model {
      * Column name for active status.
      */
     isActiveColumn = "isActive";
+    /**
+     * Constructs a new model instance with optional initial data.
+     *
+     * Initializes the dirty tracker with a snapshot of the provided data.
+     *
+     * @param initialData - Partial data to populate the model
+     *
+     * @example
+     * ```typescript
+     * const user = new User({ name: "Alice", email: "alice@example.com" });
+     * ```
+     */
+    constructor(initialData = {}) {
+        this.data = initialData;
+        this.dirtyTracker = this.self().getDriver().getDirtyTracker(this.data);
+    }
     /**
      * Lazily load one or more relations for this model instance.
      *
@@ -472,22 +480,6 @@ class Model {
     getRelation(relationName) {
         return this.loadedRelations.get(relationName);
     }
-    /**
-     * Constructs a new model instance with optional initial data.
-     *
-     * Initializes the dirty tracker with a snapshot of the provided data.
-     *
-     * @param initialData - Partial data to populate the model
-     *
-     * @example
-     * ```typescript
-     * const user = new User({ name: "Alice", email: "alice@example.com" });
-     * ```
-     */
-    constructor(initialData = {}) {
-        this.data = initialData;
-        this.dirtyTracker = new DatabaseDirtyTracker(this.data);
-    }
     /**
      * Get a model class by its name from the global registry.
      *
@@ -572,60 +564,53 @@ class Model {
     get id() {
         return this.get("id");
     }
+    /**
+     * Get uuid
+     */
+    get uuid() {
+        return this.get("id");
+    }
     get(field, defaultValue) {
-        return get(this.data, field, defaultValue);
+        return getFieldValue(this, field, defaultValue);
     }
     only(fields) {
-        return only(this.data, fields);
+        return getOnlyFields(this, fields);
     }
     /**
      * Get a string value
      */
     string(key, defaultValue) {
-        return this.get(key, defaultValue);
+        return getStringField(this, key, defaultValue);
     }
     /**
      * Get a number value
      */
     number(key, defaultValue) {
-        return this.get(key, defaultValue);
+        return getNumberField(this, key, defaultValue);
     }
     /**
      * Get a boolean value
      */
     boolean(key, defaultValue) {
-        return this.get(key, defaultValue);
+        return getBooleanField(this, key, defaultValue);
     }
     set(field, value) {
-        const path = String(field);
-        set(this.data, path, value);
-        const partial = {};
-        set(partial, path, value);
-        this.dirtyTracker.mergeChanges(partial);
-        return this;
+        return setFieldValue(this, field, value);
     }
     has(field) {
-        return get(this.data, field, MISSING_VALUE) !== MISSING_VALUE;
+        return hasField(this, field);
     }
     increment(field, amount) {
-        const value = this.get(field, 0);
-        const incrementedValue = value + (amount ?? 1);
-        return this.set(field, incrementedValue);
+        return incrementField(this, field, amount);
     }
     decrement(field, amount) {
-        const value = this.get(field, 0);
-        const decrementedValue = value - (amount ?? 1);
-        return this.set(field, decrementedValue);
+        return decrementField(this, field, amount);
     }
     unset(...fields) {
-        this.data = unset(this.data, fields);
-        this.dirtyTracker.unset(fields);
-        return this;
+        return unsetFields(this, ...fields);
     }
     merge(values) {
-        this.data = merge(this.data, values);
-        this.dirtyTracker.mergeChanges(values);
-        return this;
+        return mergeFields(this, values);
     }
     /**
      * Perform atomoic update from current model instance
@@ -634,7 +619,7 @@ class Model {
      * @returns number of affected records
      */
     async atomicUpdate(operations) {
-        return this.self().atomic({ id: this.id }, operations);
+        return performAtomicUpdate(this, operations);
     }
     /**
      * Perform atomic increment
@@ -642,12 +627,7 @@ class Model {
      * saving the model
      */
     async atomicIncrement(field, amount = 1) {
-        this.increment(field, amount);
-        return this.atomicUpdate({
-            $inc: {
-                [field]: amount,
-            },
-        });
+        return performAtomicIncrement(this, field, amount);
     }
     /**
      * Perform atomic decrement
@@ -655,12 +635,7 @@ class Model {
      * saving the model
      */
     async atomicDecrement(field, amount = 1) {
-        this.decrement(field, amount);
-        return this.atomicUpdate({
-            $inc: {
-                [field]: -amount,
-            },
-        });
+        return performAtomicDecrement(this, field, amount);
     }
     /**
      * Determine if current model is active
@@ -706,7 +681,7 @@ class Model {
      * ```
      */
     hasChanges() {
-        return this.dirtyTracker.hasChanges();
+        return checkHasChanges(this);
     }
     /**
      * Check if the given column has been modified.
@@ -721,7 +696,7 @@ class Model {
      * ```
      */
     isDirty(column) {
-        return this.dirtyTracker.isDirty(column);
+        return checkIsDirty(this, column);
     }
     /**
      * Retrieves all dirty columns with their old and new values.
@@ -736,7 +711,7 @@ class Model {
      * ```
      */
     getDirtyColumnsWithValues() {
-        return this.dirtyTracker.getDirtyColumnsWithValues();
+        return getDirtyColumnsWithValues(this);
     }
     /**
      * Lists all columns that have been removed from the model's data.
@@ -750,7 +725,7 @@ class Model {
      * ```
      */
     getRemovedColumns() {
-        return this.dirtyTracker.getRemovedColumns();
+        return getRemovedColumns(this);
     }
     /**
      * Lists all columns that have been modified since instantiation or last reset.
@@ -764,7 +739,7 @@ class Model {
      * ```
      */
     getDirtyColumns() {
-        return this.dirtyTracker.getDirtyColumns();
+        return getDirtyColumns(this);
     }
     /**
      * Emits a lifecycle event to both per-model and global listeners.
@@ -782,13 +757,7 @@ class Model {
      * ```
      */
     async emitEvent(event, context) {
-        const ctor = this.constructor;
-        // Trigger instance events
-        await this.events.emit(event, this, context);
-        // Trigger static events
-        await ctor.events().emit(event, this, context);
-        // Trigger global events
-        await globalModelEvents.emit(event, this, context);
+        return emitModelEvent(this, event, context);
     }
     /**
      * Register a listener for a model lifecycle event on this instance.
@@ -798,7 +767,7 @@ class Model {
      * @returns Unsubscribe function
      */
     on(event, listener) {
-        return this.events.on(event, listener);
+        return onModelEvent(this, event, listener);
     }
     /**
      * Register a one-time listener for a model lifecycle event on this instance.
@@ -808,7 +777,7 @@ class Model {
      * @returns Unsubscribe function
      */
     once(event, listener) {
-        return this.events.once(event, listener);
+        return onceModelEvent(this, event, listener);
     }
     /**
      * Remove a listener from this instance.
@@ -817,7 +786,7 @@ class Model {
      * @param listener - Callback function to remove
      */
     off(event, listener) {
-        this.events.off(event, listener);
+        offModelEvent(this, event, listener);
     }
     /**
      * Resolves the data source associated with this model.
@@ -840,42 +809,19 @@ class Model {
      * ```
      */
     static getDataSource() {
-        const ref = this.dataSource;
-        let dataSource;
-        if (typeof ref === "string") {
-            dataSource = dataSourceRegistry.get(ref);
-        }
-        else if (ref) {
-            dataSource = ref;
-        }
-        else {
-            dataSource = dataSourceRegistry.get();
-        }
-        // Apply model defaults from data source (only once per model class)
-        if (!this.hasOwnProperty("_defaultsApplied")) {
-            // Merge defaults hierarchy: driver defaults < dataSource modelDefaults
-            const driverDefaults = dataSource.driver.modelDefaults || {};
-            const dataSourceDefaults = dataSource.modelDefaults || {};
-            // Merge with dataSource modelDefaults taking priority over driver defaults
-            const mergedDefaults = {
-                ...driverDefaults,
-                ...dataSourceDefaults,
-            };
-            // Apply merged defaults to model
-            if (Object.keys(mergedDefaults).length > 0) {
-                this.applyModelDefaults(mergedDefaults);
-            }
-            this._defaultsApplied = true;
-        }
-        return dataSource;
+        return resolveDataSource(this);
+    }
+    /**
+     * Get driver instance
+     */
+    static getDriver() {
+        return this.getDataSource().driver;
     }
     /**
      * Generate next id and set it to current model's id
      */
     async generateNextId() {
-        const writer = new DatabaseWriter(this);
-        await writer.generateNextId();
-        return this.id;
+        return generateModelNextId(this);
     }
     /**
      * Apply model defaults from data source configuration.
@@ -893,58 +839,7 @@ class Model {
      * @param defaults - Model default configuration from data source
      */
     static applyModelDefaults(defaults) {
-        // Only apply defaults if model doesn't have its own value
-        // ============================================================================
-        // ID Generation
-        // ============================================================================
-        if (defaults.autoGenerateId !== undefined && this.autoGenerateId === undefined) {
-            this.autoGenerateId = defaults.autoGenerateId;
-        }
-        if (defaults.initialId !== undefined && this.initialId === undefined) {
-            this.initialId = defaults.initialId;
-        }
-        if (defaults.randomInitialId !== undefined && this.randomInitialId === undefined) {
-            this.randomInitialId = defaults.randomInitialId;
-        }
-        if (defaults.incrementIdBy !== undefined && this.incrementIdBy === undefined) {
-            this.incrementIdBy = defaults.incrementIdBy;
-        }
-        if (defaults.randomIncrement !== undefined && this.randomIncrement === undefined) {
-            this.randomIncrement = defaults.randomIncrement;
-        }
-        // ============================================================================
-        // Timestamps
-        // ============================================================================
-        if (defaults.createdAtColumn !== undefined && this.createdAtColumn === undefined) {
-            this.createdAtColumn = defaults.createdAtColumn;
-        }
-        if (defaults.updatedAtColumn !== undefined && this.updatedAtColumn === undefined) {
-            this.updatedAtColumn = defaults.updatedAtColumn;
-        }
-        // ============================================================================
-        // Deletion
-        // ============================================================================
-        if (defaults.deleteStrategy !== undefined && this.deleteStrategy === undefined) {
-            this.deleteStrategy = defaults.deleteStrategy;
-        }
-        if (defaults.deletedAtColumn !== undefined && this.deletedAtColumn === undefined) {
-            this.deletedAtColumn = defaults.deletedAtColumn;
-        }
-        if (defaults.trashTable !== undefined && this.trashTable === undefined) {
-            // Handle function-based trash table
-            if (typeof defaults.trashTable === "function") {
-                this.trashTable = defaults.trashTable(this.table);
-            }
-            else {
-                this.trashTable = defaults.trashTable;
-            }
-        }
-        // ============================================================================
-        // Validation
-        // ============================================================================
-        if (defaults.strictMode !== undefined && this.strictMode === undefined) {
-            this.strictMode = defaults.strictMode;
-        }
+        applyDefaultsToModel(this, defaults);
     }
     /**
      * Add a global scope that is automatically applied to all queries.
@@ -970,10 +865,7 @@ class Model {
      * ```
      */
     static addGlobalScope(name, callback, options = {}) {
-        this.globalScopes.set(name, {
-            callback,
-            timing: options.timing || "before",
-        });
+        addGlobalModelScope(this, name, callback, options);
     }
     /**
      * Remove a global scope by name.
@@ -986,7 +878,7 @@ class Model {
      * ```
      */
     static removeGlobalScope(name) {
-        this.globalScopes.delete(name);
+        removeGlobalModelScope(this, name);
     }
     /**
      * Add a local scope that can be manually applied to queries.
@@ -1014,7 +906,7 @@ class Model {
      * ```
      */
     static addScope(name, callback) {
-        this.localScopes.set(name, callback);
+        addLocalModelScope(this, name, callback);
     }
     /**
      * Remove a local scope by name.
@@ -1027,51 +919,13 @@ class Model {
      * ```
      */
     static removeScope(name) {
-        this.localScopes.delete(name);
+        removeLocalModelScope(this, name);
     }
     /**
      * Create a new query builder for this model
      */
     static query() {
-        // Call newQueryBuilder as a static method (may be overridden in child classes)
-        const queryBuilder = this.newQueryBuilder();
-        const ModelClass = this;
-        const qb = queryBuilder; // Capture for closure access
-        // Collect global scopes from base Model and child model
-        const allGlobalScopes = new Map([
-            ...Model.globalScopes,
-            ...this.globalScopes,
-        ]);
-        // Pass scopes to query builder
-        queryBuilder.pendingGlobalScopes = allGlobalScopes;
-        queryBuilder.availableLocalScopes = this.localScopes;
-        queryBuilder.disabledGlobalScopes = new Set();
-        // Pass relation definitions for joinWith() support
-        queryBuilder.relationDefinitions = this.relations;
-        queryBuilder.modelClass = ModelClass;
-        // Emit fetching event
-        this.events().emitFetching(queryBuilder, { table: this.table, modelClass: this });
-        queryBuilder.hydrate((data) => {
-            return this.readFrom(data);
-        });
-        // Wire up onFetched callback to load relations and emit model-level event
-        queryBuilder.onFetched(async (models) => {
-            // Load eager relations if any were requested
-            const eagerRelations = qb.eagerLoadRelations;
-            if (eagerRelations && eagerRelations.size > 0 && models.length > 0) {
-                // Build constraints object from the Map
-                const constraints = {};
-                for (const [name, constraint] of eagerRelations) {
-                    if (typeof constraint === "function") {
-                        constraints[name] = constraint;
-                    }
-                }
-                const loader = new RelationLoader(models, ModelClass);
-                await loader.load([...eagerRelations.keys()], constraints);
-            }
-            await this.events().emit("fetched", models, {});
-        });
-        return queryBuilder;
+        return buildQuery(this, Model);
     }
     static with(...args) {
         return this.query().with(...args);
@@ -1124,35 +978,19 @@ class Model {
      * ```
      */
     static newQueryBuilder() {
-        const dataSource = this.getDataSource();
-        // Check if model has a custom builder class
-        if (this.builder) {
-            const BuilderClass = this.builder;
-            return new BuilderClass(this.table, dataSource);
-        }
-        // Use default driver query builder
-        const queryBuilder = dataSource.driver.queryBuilder(this.table);
-        return queryBuilder;
+        return buildNewQueryBuilder(this);
     }
     /**
      * Get First matched record for the given filter
      */
     static async first(filter) {
-        const query = this.query();
-        if (filter) {
-            query.where(filter);
-        }
-        return query.first();
+        return findFirst(this, filter);
     }
     /**
      * Get last matched record for the given filter
      */
     static async last(filter) {
-        const query = this.query();
-        if (filter) {
-            query.where(filter);
-        }
-        return query.last();
+        return findLast(this, filter);
     }
     static where(...args) {
         return this.query().where(...args);
@@ -1162,18 +1000,13 @@ class Model {
      * @param filter - The filter to apply to the query
      */
     static count(filter) {
-        const query = this.query();
-        if (filter) {
-            query.where(filter);
-        }
-        return query.count();
+        return countRecords(this, filter);
     }
     /**
      * Find record by id
      */
     static async find(id) {
-        const query = this.query();
-        return query.where(this.primaryKey, id).first();
+        return findById(this, id);
     }
     /**
      * Get all records from the table
@@ -1182,24 +1015,13 @@ class Model {
      * @returns All records from the table
      */
     static async all(filter) {
-        const query = this.query();
-        if (filter) {
-            query.where(filter);
-        }
-        return query.get();
+        return findAll(this, filter);
     }
     /**
      * Perform pagination
      */
-    static async paginate({ page, limit, filter, } = {}) {
-        const query = this.query();
-        if (filter) {
-            query.where(filter);
-        }
-        return query.paginate({
-            limit: limit,
-            page: page,
-        });
+    static async paginate(options = {}) {
+        return paginateRecords(this, options);
     }
     /**
      * Get latest records from the table
@@ -1207,14 +1029,10 @@ class Model {
      * @param filter - The filter to apply to the query
      */
     static async latest(filter) {
-        const query = this.query();
-        if (filter) {
-            query.where(filter);
-        }
-        return (await query.latest());
+        return findLatest(this, filter);
     }
     /**
-     * Increment the given field by the given amount
+     * Increment the given field by the given amount using atomic update
      *
      * @example ```typescript
      * // Increase age by 1 for user id 1
@@ -1224,11 +1042,10 @@ class Model {
      * ```
      */
     static increase(filter, field, amount) {
-        const query = this.query().where(filter);
-        return query.increment(field, amount);
+        return increaseField(this, filter, field, amount);
     }
     /**
-     * Decrement the given field by the given amount
+     * Decrement the given field by the given amount using atomic update
      * @example ```typescript
      * // Decrease age by 1 for user id 1
      * User.decrement({id: 1}, "age", 1);
@@ -1237,16 +1054,7 @@ class Model {
      * ```
      */
     static decrease(filter, field, amount) {
-        const query = this.query().where(filter);
-        return query.decrement(field, amount);
-    }
-    /**
-     * Create a new instance from the given data
-     */
-    static readFrom(data) {
-        const model = new this(data);
-        model.isNew = false;
-        return model;
+        return decreaseField(this, filter, field, amount);
     }
     /**
      * Perform atomic operation
@@ -1257,9 +1065,13 @@ class Model {
      * Returns user model with updated age
      */
     static async atomic(filter, operations) {
-        const dataSource = this.getDataSource();
-        const result = await dataSource.driver.atomic(this.table, filter, operations);
-        return result.modifiedCount;
+        return performAtomic(this, filter, operations);
+    }
+    /**
+     * Perform a direct update $set for the given id
+     */
+    static async update(id, data) {
+        return updateById(this, id, data);
     }
     /**
      * Find one and update multiple records that matches the provided filter and return the updated record
@@ -1268,8 +1080,7 @@ class Model {
      * @returns The updated records
      */
     static async findAndUpdate(filter, update) {
-        await this.atomic(filter, update);
-        return await this.query().where(filter).get();
+        return findAndUpdateRecords(this, filter, update);
     }
     /**
      * Find one and update a single record that matches the provided filter and return the updated record
@@ -1278,17 +1089,13 @@ class Model {
      * @returns The updated record or null
      */
     static async findOneAndUpdate(filter, update) {
-        const dataSource = this.getDataSource();
-        const result = await dataSource.driver.findOneAndUpdate(this.table, filter, update);
-        return result ? new this(result) : null;
+        return findOneAndUpdateRecord(this, filter, update);
     }
     /**
      * Find and replace the entire document that matches the provided filter and return the replaced document
      */
     static async findAndReplace(filter, document) {
-        const dataSource = this.getDataSource();
-        const result = await dataSource.driver.replace(this.table, filter, document);
-        return result ? new this(result) : null;
+        return findAndReplaceRecord(this, filter, document);
     }
     /**
      * Destroy (delete) the current model instance from the database.
@@ -1309,8 +1116,7 @@ class Model {
      * ```
      */
     async destroy(options) {
-        const remover = new DatabaseRemover(this);
-        return await remover.destroy(options);
+        return destroyModel(this, options);
     }
     /**
      * Get the class constructor from an instance.
@@ -1365,21 +1171,7 @@ class Model {
      * ```
      */
     clone() {
-        // Deep copy the current data using JSON serialization
-        // This ensures nested objects are also copied
-        const clonedData = JSON.parse(JSON.stringify(this.data));
-        // Create a new instance of the same model class
-        const ModelClass = this.self();
-        const clonedModel = new ModelClass(clonedData);
-        // Preserve the isNew state
-        clonedModel.isNew = this.isNew;
-        // Freeze the data to make it immutable
-        // This recursively freezes all nested objects
-        this.deepFreeze(clonedModel.data);
-        // Reset the dirty tracker to have no changes
-        // The clone represents a clean snapshot
-        clonedModel.dirtyTracker.reset();
-        return clonedModel;
+        return cloneModel(this);
     }
     /**
      * Recursively freezes an object and all its nested properties.
@@ -1388,19 +1180,7 @@ class Model {
      * @returns The frozen object
      */
     deepFreeze(obj) {
-        // Freeze the object itself
-        Object.freeze(obj);
-        // Recursively freeze all properties
-        Object.getOwnPropertyNames(obj).forEach((prop) => {
-            const value = obj[prop];
-            // Only freeze objects and arrays, skip primitives and null
-            if (value !== null &&
-                (typeof value === "object" || typeof value === "function") &&
-                !Object.isFrozen(value)) {
-                this.deepFreeze(value);
-            }
-        });
-        return obj;
+        return deepFreezeObject(obj);
     }
     /**
      * Get table name
@@ -1442,13 +1222,13 @@ class Model {
      * Delete all matching documents from the table.
      */
     static async delete(filter) {
-        return await this.getDataSource().driver.deleteMany(this.table, filter);
+        return deleteRecords(this, filter);
     }
     /**
      * Delete a single matching document from the table.
      */
     static async deleteOne(filter) {
-        return await this.getDataSource().driver.delete(this.table, filter);
+        return deleteOneRecord(this, filter);
     }
     /**
      * Restore a single deleted record by its ID.
@@ -1476,12 +1256,7 @@ class Model {
      * ```
      */
     static async restore(id, options) {
-        const restorer = new DatabaseRestorer(this);
-        const result = await restorer.restore(id, options);
-        if (!result.restoredRecord) {
-            throw new Error(`Failed to restore ${this.name} with ${this.primaryKey} ${id}: no record returned.`);
-        }
-        return result.restoredRecord;
+        return restoreRecord(this, id, options);
     }
     /**
      * Restore all deleted records for the model's table.
@@ -1502,12 +1277,7 @@ class Model {
      * ```
      */
     static async restoreAll(options) {
-        const restorer = new DatabaseRestorer(this);
-        const result = await restorer.restoreAll(options);
-        if (result.restoredCount === 0) {
-            return [];
-        }
-        return result.restoredRecords;
+        return restoreAllRecords(this, options);
     }
     /**
      * Create a new record in database and return the model instance.
@@ -1529,15 +1299,13 @@ class Model {
      * ```
      */
     static async create(data) {
-        const model = new this(data);
-        await model.save();
-        return model;
+        return createRecord(this, data);
     }
     /**
      * Create many documents and return an array of created models
      */
     static async createMany(data) {
-        return await Promise.all(data.map((data) => this.create(data)));
+        return createManyRecords(this, data);
     }
     /**
      * Find a record or create it if not found.
@@ -1561,13 +1329,7 @@ class Model {
      * ```
      */
     static async findOrCreate(filter, data) {
-        // Try to find existing record
-        const existing = await this.first(filter);
-        if (existing) {
-            return existing; // Return as-is, no update
-        }
-        // Create new record with merged data
-        return await this.create({ ...filter, ...data });
+        return findOrCreateRecord(this, filter, data);
     }
     /**
      * Upsert (insert or update) a record atomically.
@@ -1612,42 +1374,7 @@ class Model {
      * ```
      */
     static async upsert(filter, data, options) {
-        const dataSource = this.getDataSource();
-        const mergedData = { ...filter, ...data };
-        // Create a temporary model instance for validation and data preparation
-        const tempModel = new this(mergedData);
-        tempModel.isNew = true;
-        // Emit saving event for validation context
-        await tempModel.emitEvent("saving", {
-            isInsert: true,
-            options,
-            mode: "upsert",
-        });
-        // Add timestamps
-        const createdAtColumn = this.createdAtColumn;
-        const updatedAtColumn = this.updatedAtColumn;
-        if (createdAtColumn !== false && createdAtColumn !== undefined) {
-            // Only set createdAt if not already set (for new records)
-            const createdAtKey = createdAtColumn;
-            if (!mergedData[createdAtKey]) {
-                mergedData[createdAtKey] = new Date();
-            }
-        }
-        if (updatedAtColumn !== false && updatedAtColumn !== undefined) {
-            const updatedAtKey = updatedAtColumn;
-            mergedData[updatedAtKey] = new Date();
-        }
-        // Emit saving event (using existing event name)
-        await tempModel.emitEvent("saving", { filter, data: mergedData, options, mode: "upsert" });
-        // Perform upsert via driver
-        const result = await dataSource.driver.upsert(this.table, filter, mergedData, options);
-        // Create model instance from result
-        const model = new this(result);
-        model.isNew = false;
-        model.dirtyTracker.reset();
-        // Emit saved event (using existing event name)
-        await model.emitEvent("saved", { filter, data: result, options, mode: "upsert" });
-        return model;
+        return upsertRecord(this, filter, data, options);
     }
     /**
      * Update a record or create it if not found (upsert).
@@ -1679,15 +1406,7 @@ class Model {
      * ```
      */
     static async findOneAndDelete(filter, options) {
-        const dataSource = this.getDataSource();
-        const result = await dataSource.driver.findOneAndDelete(this.table, filter, options);
-        if (!result) {
-            return null;
-        }
-        const model = new this(result);
-        model.isNew = false;
-        model.dirtyTracker.reset();
-        return model;
+        return findOneAndDeleteRecord(this, filter, options);
     }
     /**
      * Returns embedded data for sync operations.
@@ -1706,6 +1425,12 @@ class Model {
     get embedData() {
         return this.self().embed ? this.only(this.self().embed) : this.data;
     }
+    /**
+     * Cleanup model events
+     */
+    static $cleanup() {
+        cleanupModelEvents(this);
+    }
     /**
      * Accesses the event emitter dedicated to this model constructor.
      *
@@ -1722,19 +1447,7 @@ class Model {
      * ```
      */
     static events() {
-        let events = modelEventsRegistry.get(this);
-        if (!events) {
-            events = new ModelEvents();
-            modelEventsRegistry.set(this, events);
-        }
-        return events;
-    }
-    /**
-     * Cleanup model events
-     */
-    static $cleanup() {
-        modelEventsRegistry.delete(this);
-        removeModelFromRegistery(this.name);
+        return getModelEvents(this);
     }
     /**
      * Registers an event listener for this model constructor.
@@ -1753,7 +1466,7 @@ class Model {
      * ```
      */
     static on(event, listener) {
-        return this.events().on(event, listener);
+        return onStaticEvent(this, event, listener);
     }
     /**
      * Registers a one-time event listener for this model constructor.
@@ -1773,7 +1486,7 @@ class Model {
      * ```
      */
     static once(event, listener) {
-        return this.events().once(event, listener);
+        return onceStaticEvent(this, event, listener);
     }
     /**
      * Removes an event listener from this model constructor.
@@ -1791,7 +1504,7 @@ class Model {
      * ```
      */
     static off(event, listener) {
-        this.events().off(event, listener);
+        offStaticEvent(this, event, listener);
     }
     /**
      * Accesses the global event emitter shared by all model instances.
@@ -1809,7 +1522,7 @@ class Model {
      * ```
      */
     static globalEvents() {
-        return globalModelEvents;
+        return getGlobalEvents();
     }
     /**
      * Replace the model's data entirely.
@@ -1829,8 +1542,7 @@ class Model {
      * ```
      */
     replaceData(data) {
-        this.data = data;
-        this.dirtyTracker.replaceCurrentData(data);
+        replaceModelData(this, data);
     }
     /**
      * Save the model to the database.
@@ -1872,44 +1584,74 @@ class Model {
      * ```
      */
     async save(options) {
-        if (options?.merge) {
-            this.merge(options.merge);
-        }
-        const writer = new DatabaseWriter(this);
-        await writer.save(options);
-        return this;
+        return saveModel(this, options);
     }
     /**
-     * Serialize the model data for storage in database
+     * Serialize the model data for storage in the database.
+     *
+     * Uses the driver's `serialize` to apply driver-specific type transformations
+     * (e.g. Date → ISO string, BigInt → string for Postgres).
+     *
+     * **Not** the same as `toSnapshot` — this is a DB write concern, not a cache concern.
      */
     serialize() {
-        return this.self().getDataSource().driver.serialize(this.data);
+        return serializeModel(this);
     }
     /**
-     * Deseriaze the given data
+     * Produce a plain-object snapshot of this model suitable for cache storage.
+     *
+     * - `data`: The model's own fields, serialized via the driver (handles Dates, BigInt, ObjectId).
+     * - `relations`: Each entry in `loadedRelations` recursively snapshotted via `toSnapshot`.
+     *   A relation that was loaded but resolved to `null` is stored as `null` (not omitted),
+     *   so that `fromSnapshot` can distinguish "loaded + null" from "never loaded".
+     *
+     * Use `Model.fromSnapshot(snapshot)` to reconstruct.
+     *
+     * @example
+     * ```typescript
+     * await cache.set(key, chat.toSnapshot());
+     * ```
+     */
+    toSnapshot() {
+        return modelToSnapshot(this);
+    }
+    /**
+     * Reconstruct a model instance (with relations) from a cache snapshot.
+     *
+     * Counterpart to `toSnapshot`. Applies driver deserialization (e.g. ISO string → Date)
+     * and recursively hydrates any nested relation snapshots via `RelationHydrator`.
+     *
+     * @example
+     * ```typescript
+     * const snapshot = await cache.get(key);
+     * const chat = Chat.fromSnapshot(snapshot);
+     * chat.unit; // Unit model instance, fully hydrated
+     * ```
+     */
+    static fromSnapshot(snapshot) {
+        return modelFromSnapshot(this, snapshot);
+    }
+    /**
+     * Create a model instance from raw data (no relations).
+     *
+     * This is the data-only hydration path, used by the query builder when
+     * converting a raw DB row into a model instance. Relations are NOT restored
+     * here — use `fromSnapshot` when restoring from a cache snapshot that
+     * includes relation data.
+     *
+     * @example
+     * ```typescript
+     * // Query builder internals:
+     * const user = User.hydrate(rawRow);
+     * ```
      */
-    static deserialize(data) {
-        const deserializedData = this.getDataSource().driver.deserialize(data);
-        const model = new this(deserializedData);
-        model.isNew = false;
-        return model;
+    static hydrate(data) {
+        return hydrateModel(this, data);
     }
     /**
      * Convert the model into JSON
      */
     toJSON() {
-        const resource = this.self().resource;
-        if (!resource) {
-            const toJsonColumns = this.self().toJsonColumns;
-            if (toJsonColumns && toJsonColumns.length > 0) {
-                return this.only(toJsonColumns);
-            }
-            return this.data;
-        }
-        const resourceColumns = this.self().resourceColumns;
-        const data = resourceColumns !== undefined && resourceColumns.length > 0
-            ? this.only(resourceColumns)
-            : this.data;
-        return new resource(data).toJSON();
+        return modelToJSON(this);
     }
 }export{Model};//# sourceMappingURL=model.js.map