@decaf-ts/decorator-validation 1.6.2 → 1.6.4

package/lib/constants/index.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./validation.cjs"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY29uc3RhbnRzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSwrQ0FBNkIiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgKiBmcm9tIFwiLi92YWxpZGF0aW9uXCI7XG4iXX0=

package/lib/constants/index.d.ts

@@ -0,0 +1 @@
+export * from "./validation";

package/lib/constants/validation.cjs

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VALIDATION_PARENT_KEY = void 0;
+/**
+ * Symbol used to internally track the parent object during nested validation.
+ *
+ * This key is attached to child objects to provide context about their parent
+ * in the object hierarchy, enabling validations that depend on parent values.
+ *
+ * @constant VALIDATION_PARENT_KEY
+ * @memberOf module:decorator-validation.Model
+ */
+exports.VALIDATION_PARENT_KEY = Symbol("_validationParentRef");
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb25zdGFudHMvdmFsaWRhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQTs7Ozs7Ozs7R0FRRztBQUNVLFFBQUEscUJBQXFCLEdBQUcsTUFBTSxDQUFDLHNCQUFzQixDQUFDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIFN5bWJvbCB1c2VkIHRvIGludGVybmFsbHkgdHJhY2sgdGhlIHBhcmVudCBvYmplY3QgZHVyaW5nIG5lc3RlZCB2YWxpZGF0aW9uLlxuICpcbiAqIFRoaXMga2V5IGlzIGF0dGFjaGVkIHRvIGNoaWxkIG9iamVjdHMgdG8gcHJvdmlkZSBjb250ZXh0IGFib3V0IHRoZWlyIHBhcmVudFxuICogaW4gdGhlIG9iamVjdCBoaWVyYXJjaHksIGVuYWJsaW5nIHZhbGlkYXRpb25zIHRoYXQgZGVwZW5kIG9uIHBhcmVudCB2YWx1ZXMuXG4gKlxuICogQGNvbnN0YW50IFZBTElEQVRJT05fUEFSRU5UX0tFWVxuICogQG1lbWJlck9mIG1vZHVsZTpkZWNvcmF0b3ItdmFsaWRhdGlvbi5Nb2RlbFxuICovXG5leHBvcnQgY29uc3QgVkFMSURBVElPTl9QQVJFTlRfS0VZID0gU3ltYm9sKFwiX3ZhbGlkYXRpb25QYXJlbnRSZWZcIik7XG4iXX0=

package/lib/constants/validation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Symbol used to internally track the parent object during nested validation.
+ *
+ * This key is attached to child objects to provide context about their parent
+ * in the object hierarchy, enabling validations that depend on parent values.
+ *
+ * @constant VALIDATION_PARENT_KEY
+ * @memberOf module:decorator-validation.Model
+ */
+export declare const VALIDATION_PARENT_KEY: unique symbol;

package/lib/esm/constants/index.d.ts

@@ -0,0 +1 @@
+export * from "./validation";

package/lib/esm/constants/index.js

@@ -0,0 +1,2 @@
+export * from "./validation";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY29uc3RhbnRzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLGNBQWMsY0FBYyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiZXhwb3J0ICogZnJvbSBcIi4vdmFsaWRhdGlvblwiO1xuIl19

package/lib/esm/constants/validation.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Symbol used to internally track the parent object during nested validation.
+ *
+ * This key is attached to child objects to provide context about their parent
+ * in the object hierarchy, enabling validations that depend on parent values.
+ *
+ * @constant VALIDATION_PARENT_KEY
+ * @memberOf module:decorator-validation.Model
+ */
+export declare const VALIDATION_PARENT_KEY: unique symbol;

package/lib/esm/constants/validation.js

@@ -0,0 +1,11 @@
+/**
+ * Symbol used to internally track the parent object during nested validation.
+ *
+ * This key is attached to child objects to provide context about their parent
+ * in the object hierarchy, enabling validations that depend on parent values.
+ *
+ * @constant VALIDATION_PARENT_KEY
+ * @memberOf module:decorator-validation.Model
+ */
+export const VALIDATION_PARENT_KEY = Symbol("_validationParentRef");
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidmFsaWRhdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jb25zdGFudHMvdmFsaWRhdGlvbi50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7R0FRRztBQUNILE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLE1BQU0sQ0FBQyxzQkFBc0IsQ0FBQyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBTeW1ib2wgdXNlZCB0byBpbnRlcm5hbGx5IHRyYWNrIHRoZSBwYXJlbnQgb2JqZWN0IGR1cmluZyBuZXN0ZWQgdmFsaWRhdGlvbi5cbiAqXG4gKiBUaGlzIGtleSBpcyBhdHRhY2hlZCB0byBjaGlsZCBvYmplY3RzIHRvIHByb3ZpZGUgY29udGV4dCBhYm91dCB0aGVpciBwYXJlbnRcbiAqIGluIHRoZSBvYmplY3QgaGllcmFyY2h5LCBlbmFibGluZyB2YWxpZGF0aW9ucyB0aGF0IGRlcGVuZCBvbiBwYXJlbnQgdmFsdWVzLlxuICpcbiAqIEBjb25zdGFudCBWQUxJREFUSU9OX1BBUkVOVF9LRVlcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdG9yLXZhbGlkYXRpb24uTW9kZWxcbiAqL1xuZXhwb3J0IGNvbnN0IFZBTElEQVRJT05fUEFSRU5UX0tFWSA9IFN5bWJvbChcIl92YWxpZGF0aW9uUGFyZW50UmVmXCIpO1xuIl19

package/lib/esm/index.d.ts

@@ -1,11 +1,43 @@
 /**
  * @module decorator-validation
- * @description TypeScript decorator-based validation library
- * @summary This module provides a comprehensive validation framework using TypeScript decorators.
- * It exposes utility functions, validation decorators, and model-related functionality for
- * implementing type-safe, declarative validation in TypeScript applications.
  */
+/**
+ * @summary Model definition functionality
+ * @description defines the base class and related functionality
+ *
+ * @namespace Model
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @summary Holds all the supported decorators
+ * @namespace Decorators
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @summary Validation related functionality
+ * @description Defines the Model validation apis and base classes for validators
+ *
+ * @namespace Validation
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @namespace Dates
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @namespace Hashing
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @namespace Serialization
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @namespace Format
+ * @memberOf module:decorator-validation
+ */
+export * from "./constants";
 export * from "./utils";
 export * from "./validation";
 export * from "./model";
-export declare const VERSION = "1.6.2";
+export declare const VERSION = "1.6.4";

package/lib/esm/index.js

@@ -1,12 +1,44 @@
 /**
  * @module decorator-validation
- * @description TypeScript decorator-based validation library
- * @summary This module provides a comprehensive validation framework using TypeScript decorators.
- * It exposes utility functions, validation decorators, and model-related functionality for
- * implementing type-safe, declarative validation in TypeScript applications.
  */
+/**
+ * @summary Model definition functionality
+ * @description defines the base class and related functionality
+ *
+ * @namespace Model
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @summary Holds all the supported decorators
+ * @namespace Decorators
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @summary Validation related functionality
+ * @description Defines the Model validation apis and base classes for validators
+ *
+ * @namespace Validation
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @namespace Dates
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @namespace Hashing
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @namespace Serialization
+ * @memberOf module:decorator-validation
+ */
+/**
+ * @namespace Format
+ * @memberOf module:decorator-validation
+ */
+export * from "./constants";
 export * from "./utils";
 export * from "./validation";
 export * from "./model";
-export const VERSION = "1.6.2";
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7OztHQU1HO0FBQ0gsY0FBYyxTQUFTLENBQUM7QUFDeEIsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyxTQUFTLENBQUM7QUFFeEIsTUFBTSxDQUFDLE1BQU0sT0FBTyxHQUFHLGFBQWEsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQG1vZHVsZSBkZWNvcmF0b3ItdmFsaWRhdGlvblxuICogQGRlc2NyaXB0aW9uIFR5cGVTY3JpcHQgZGVjb3JhdG9yLWJhc2VkIHZhbGlkYXRpb24gbGlicmFyeVxuICogQHN1bW1hcnkgVGhpcyBtb2R1bGUgcHJvdmlkZXMgYSBjb21wcmVoZW5zaXZlIHZhbGlkYXRpb24gZnJhbWV3b3JrIHVzaW5nIFR5cGVTY3JpcHQgZGVjb3JhdG9ycy5cbiAqIEl0IGV4cG9zZXMgdXRpbGl0eSBmdW5jdGlvbnMsIHZhbGlkYXRpb24gZGVjb3JhdG9ycywgYW5kIG1vZGVsLXJlbGF0ZWQgZnVuY3Rpb25hbGl0eSBmb3JcbiAqIGltcGxlbWVudGluZyB0eXBlLXNhZmUsIGRlY2xhcmF0aXZlIHZhbGlkYXRpb24gaW4gVHlwZVNjcmlwdCBhcHBsaWNhdGlvbnMuXG4gKi9cbmV4cG9ydCAqIGZyb20gXCIuL3V0aWxzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi92YWxpZGF0aW9uXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9tb2RlbFwiO1xuXG5leHBvcnQgY29uc3QgVkVSU0lPTiA9IFwiIyNWRVJTSU9OIyNcIjtcbiJdfQ==
+export const VERSION = "1.6.4";
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFFSDs7Ozs7O0dBTUc7QUFFSDs7OztHQUlHO0FBRUg7Ozs7OztHQU1HO0FBRUg7OztHQUdHO0FBRUg7OztHQUdHO0FBRUg7OztHQUdHO0FBRUg7OztHQUdHO0FBRUgsY0FBYyxhQUFhLENBQUM7QUFDNUIsY0FBYyxTQUFTLENBQUM7QUFDeEIsY0FBYyxjQUFjLENBQUM7QUFDN0IsY0FBYyxTQUFTLENBQUM7QUFFeEIsTUFBTSxDQUFDLE1BQU0sT0FBTyxHQUFHLGFBQWEsQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQG1vZHVsZSBkZWNvcmF0b3ItdmFsaWRhdGlvblxuICovXG5cbi8qKlxuICogQHN1bW1hcnkgTW9kZWwgZGVmaW5pdGlvbiBmdW5jdGlvbmFsaXR5XG4gKiBAZGVzY3JpcHRpb24gZGVmaW5lcyB0aGUgYmFzZSBjbGFzcyBhbmQgcmVsYXRlZCBmdW5jdGlvbmFsaXR5XG4gKlxuICogQG5hbWVzcGFjZSBNb2RlbFxuICogQG1lbWJlck9mIG1vZHVsZTpkZWNvcmF0b3ItdmFsaWRhdGlvblxuICovXG5cbi8qKlxuICogQHN1bW1hcnkgSG9sZHMgYWxsIHRoZSBzdXBwb3J0ZWQgZGVjb3JhdG9yc1xuICogQG5hbWVzcGFjZSBEZWNvcmF0b3JzXG4gKiBAbWVtYmVyT2YgbW9kdWxlOmRlY29yYXRvci12YWxpZGF0aW9uXG4gKi9cblxuLyoqXG4gKiBAc3VtbWFyeSBWYWxpZGF0aW9uIHJlbGF0ZWQgZnVuY3Rpb25hbGl0eVxuICogQGRlc2NyaXB0aW9uIERlZmluZXMgdGhlIE1vZGVsIHZhbGlkYXRpb24gYXBpcyBhbmQgYmFzZSBjbGFzc2VzIGZvciB2YWxpZGF0b3JzXG4gKlxuICogQG5hbWVzcGFjZSBWYWxpZGF0aW9uXG4gKiBAbWVtYmVyT2YgbW9kdWxlOmRlY29yYXRvci12YWxpZGF0aW9uXG4gKi9cblxuLyoqXG4gKiBAbmFtZXNwYWNlIERhdGVzXG4gKiBAbWVtYmVyT2YgbW9kdWxlOmRlY29yYXRvci12YWxpZGF0aW9uXG4gKi9cblxuLyoqXG4gKiBAbmFtZXNwYWNlIEhhc2hpbmdcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdG9yLXZhbGlkYXRpb25cbiAqL1xuXG4vKipcbiAqIEBuYW1lc3BhY2UgU2VyaWFsaXphdGlvblxuICogQG1lbWJlck9mIG1vZHVsZTpkZWNvcmF0b3ItdmFsaWRhdGlvblxuICovXG5cbi8qKlxuICogQG5hbWVzcGFjZSBGb3JtYXRcbiAqIEBtZW1iZXJPZiBtb2R1bGU6ZGVjb3JhdG9yLXZhbGlkYXRpb25cbiAqL1xuXG5leHBvcnQgKiBmcm9tIFwiLi9jb25zdGFudHNcIjtcbmV4cG9ydCAqIGZyb20gXCIuL3V0aWxzXCI7XG5leHBvcnQgKiBmcm9tIFwiLi92YWxpZGF0aW9uXCI7XG5leHBvcnQgKiBmcm9tIFwiLi9tb2RlbFwiO1xuXG5leHBvcnQgY29uc3QgVkVSU0lPTiA9IFwiIyNWRVJTSU9OIyNcIjtcbiJdfQ==

package/lib/esm/model/Model.d.ts

@@ -1,94 +1,58 @@
 import { BuilderRegistry } from "../utils/registry";
 import { ModelErrorDefinition } from "./ModelErrorDefinition";
 import { Comparable, Constructor, Hashable, ModelArg, ModelBuilderFunction, ModelConstructor, Serializable, Validatable } from "./types";
+export declare function isPropertyModel<M extends Model>(target: M, attribute: string): boolean | string | undefined;
 /**
- * @description Registry type for storing and retrieving model constructors
- * @summary The ModelRegistry type defines a registry for model constructors that extends
- * the BuilderRegistry interface. It provides a standardized way to register, retrieve,
- * and build model instances, enabling the model system to work with different types of models.
+ * @summary For Serialization/deserialization purposes.
+ * @description Reads the {@link ModelKeys.ANCHOR} property of a {@link Model} to discover the class to instantiate
+ *
+ * @function isModel
+ * @memberOf module:decorator-validation.Validation
+ * @category Validation
+ */
+export declare function isModel(target: Record<string, any>): boolean;
+/**
+ * @summary ModelRegistry Interface
  *
  * @interface ModelRegistry
- * @template T Type of model that can be registered, must extend Model
- * @extends BuilderRegistry<T>
- * @memberOf module:decorator-validation
+ * @extends BuilderRegistry<Model>
+ *
  * @category Model
  */
 export type ModelRegistry<T extends Model> = BuilderRegistry<T>;
 /**
- * @description Registry manager for model constructors that enables serialization and rebuilding
- * @summary The ModelRegistryManager implements the ModelRegistry interface and provides
- * functionality for registering, retrieving, and building model instances. It maintains
- * a cache of model constructors indexed by name, allowing for efficient lookup and instantiation.
- * This class is essential for the serialization and deserialization of model objects.
+ * @summary Util class to enable serialization and correct rebuilding
  *
- * @param {function(Record<string, any>): boolean} [testFunction] - Function to test if an object is a model, defaults to {@link isModel}
+ * @param {string} anchorKey defaults to {@link ModelKeys.ANCHOR}. The property name where the registered class name is stored;
+ * @param {function(Record<string, any>): boolean} [testFunction] method to test if the provided object is a Model Object. defaults to {@link isModel}
  *
  * @class ModelRegistryManager
- * @template M Type of model that can be registered, must extend Model
- * @implements ModelRegistry<M>
- * @category Model
- *
- * @example
- * ```typescript
- * // Create a model registry
- * const registry = new ModelRegistryManager();
- *
- * // Register a model class
- * registry.register(User);
- *
- * // Retrieve a model constructor by name
- * const UserClass = registry.get("User");
+ * @implements ModelRegistry
  *
- * // Build a model instance from a plain object
- * const userData = { name: "John", age: 30 };
- * const user = registry.build(userData, "User");
- * ```
- *
- * @mermaid
- * sequenceDiagram
- *   participant C as Client
- *   participant R as ModelRegistryManager
- *   participant M as Model Class
- *
- *   C->>R: new ModelRegistryManager(testFunction)
- *   C->>R: register(ModelClass)
- *   R->>R: Store in cache
- *   C->>R: get("ModelName")
- *   R-->>C: ModelClass constructor
- *   C->>R: build(data, "ModelName")
- *   R->>R: Get constructor from cache
- *   R->>M: new ModelClass(data)
- *   M-->>R: Model instance
- *   R-->>C: Model instance
+ * @category Model
  */
-export declare class ModelRegistryManager<M extends Model> implements ModelRegistry<M> {
+export declare class ModelRegistryManager<T extends Model> implements ModelRegistry<T> {
     private cache;
     private readonly testFunction;
     constructor(testFunction?: (obj: Record<string, any>) => boolean);
     /**
-     * @description Registers a model constructor with the registry
-     * @summary Adds a model constructor to the registry cache, making it available for
-     * later retrieval and instantiation. If no name is provided, the constructor's name
-     * property is used as the key in the registry.
-     *
-     * @param {ModelConstructor<M>} constructor - The model constructor to register
-     * @param {string} [name] - Optional name to register the constructor under, defaults to constructor.name
-     * @return {void}
-     * @throws {Error} If the constructor is not a function
+     * @summary register new Models
+     * @param {any} constructor
+     * @param {string} [name] when not defined, the name of the constructor will be used
      */
-    register(constructor: ModelConstructor<M>, name?: string): void;
+    register(constructor: ModelConstructor<T>, name?: string): void;
     /**
      * @summary Gets a registered Model {@link ModelConstructor}
      * @param {string} name
      */
-    get(name: string): ModelConstructor<M> | undefined;
+    get(name: string): ModelConstructor<T> | undefined;
     /**
      * @param {Record<string, any>} obj
      * @param {string} [clazz] when provided, it will attempt to find the matching constructor
      *
      * @throws Error If clazz is not found, or obj is not a {@link Model} meaning it has no {@link ModelKeys.ANCHOR} property
      */
-    build(obj?: Record<string, any>, clazz?: string): M;
+    build(obj?: Record<string, any>, clazz?: string): T;
 }
 /**
  * @summary Bulk Registers Models
@@ -96,12 +60,12 @@ export declare class ModelRegistryManager<M extends Model> implements ModelRegis
  *
  * @param {Array<Constructor<T>> | Array<{name: string, constructor: Constructor<T>}>} [models]
  *
- * @memberOf module:decorator-validation
+ * @memberOf module:decorator-validation.Model
  * @category Model
  */
-export declare function bulkModelRegister<M extends Model>(...models: (Constructor<M> | {
+export declare function bulkModelRegister<T extends Model>(...models: (Constructor<T> | {
     name: string;
-    constructor: Constructor<M>;
+    constructor: Constructor<T>;
 })[]): void;
 /**
  * @summary Abstract class representing a Validatable Model object
@@ -111,10 +75,9 @@ export declare function bulkModelRegister<M extends Model>(...models: (Construct
  *  - Have all their required properties marked with '!';
  *  - Have all their optional properties marked as '?':
  *
- * @param {ModelArg<Model>} model base object from which to populate properties from
+ * @param {Model | {}} model base object from which to populate properties from
  *
  * @class Model
- * @category Model
  * @abstract
  * @implements Validatable
  * @implements Serializable
@@ -238,38 +201,4 @@ export declare abstract class Model implements Validatable, Serializable, Hashab
      * @param {string} str
      */
     static key(str: string): string;
-    /**
-     * @description Determines if an object is a model instance or has model metadata
-     * @summary Checks whether a given object is either an instance of the Model class or
-     * has model metadata attached to it. This function is essential for serialization and
-     * deserialization processes, as it helps identify model objects that need special handling.
-     * It safely handles potential errors during metadata retrieval.
-     *
-     * @param {Record<string, any>} target - The object to check
-     * @return {boolean} True if the object is a model instance or has model metadata, false otherwise
-     *
-     * @example
-     * ```typescript
-     * // Check if an object is a model
-     * const user = new User({ name: "John" });
-     * const isUserModel = isModel(user); // true
-     *
-     * // Check a plain object
-     * const plainObject = { name: "John" };
-     * const isPlainObjectModel = isModel(plainObject); // false
-     * ```
-     */
-    static isModel(target: Record<string, any>): boolean;
-    /**
-     * @description Checks if a property of a model is itself a model or has a model type
-     * @summary Determines whether a specific property of a model instance is either a model instance
-     * or has a type that is registered as a model. This function is used for model serialization
-     * and deserialization to properly handle nested models.
-     * @template M extends {@link Model}
-     * @param {M} target - The model instance to check
-     * @param {string} attribute - The property name to check
-     * @return {boolean | string | undefined} Returns true if the property is a model instance,
-     * the model name if the property has a model type, or undefined if not a model
-     */
-    static isPropertyModel<M extends Model>(target: M, attribute: string): boolean | string | undefined;
 }