@forklaunch/core 0.2.3 → 0.2.6

package/lib/src/domainMapper/models/requestDtoMapper.model.js

@@ -0,0 +1,70 @@
+import { BaseDtoMapper, construct } from './baseDtoMapper.model';
+/**
+ * Abstract class representing a request entity mapper.
+ *
+ * @template Entity - A type that extends BaseEntity.
+ * @template SV - A type that extends AnySchemaValidator.
+ * @extends {BaseDtoMapper<SV>}
+ */
+export class RequestDtoMapper extends BaseDtoMapper {
+    /**
+     * The entity type.
+     * @type {Entity}
+     * @protected
+     */
+    _Entity;
+    /**
+     * Populates the DTO with data from a JSON object.
+     *
+     * @param {this['_dto']} json - The JSON object.
+     * @returns {this} - The instance of the RequestDtoMapper.
+     */
+    fromJson(json) {
+        if (!this.schemaValidator.validate(this.schemaValidator.schemify(this.schema), json)) {
+            throw new Error('Invalid DTO');
+        }
+        this.dto = json;
+        return this;
+    }
+    /**
+     * Deserializes a JSON object to an entity.
+     *
+     * @param {this['_dto']} json - The JSON object.
+     * @param {...unknown[]} additionalArgs - Additional arguments.
+     * @returns {Entity} - The entity.
+     */
+    deserializeJsonToEntity(json, ...additionalArgs) {
+        return this.fromJson(json).toEntity(...additionalArgs);
+    }
+    /**
+     * Creates an instance of a RequestDtoMapper from a JSON object.
+     *
+     * @template T - A type that extends RequestDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @template JsonType - The type of the JSON object.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {SV} schemaValidator - The schema provider.
+     * @param {JsonType} json - The JSON object.
+     * @returns {T} - An instance of the T.
+     */
+    static fromJson(schemaValidator, json) {
+        return construct(this, schemaValidator).fromJson(json);
+    }
+    /**
+     * Deserializes a JSON object to an entity.
+     *
+     * @template T - A type that extends RequestDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @template JsonType - The type of the JSON object.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {SV} schemaValidator - The schema provider.
+     * @param {JsonType} json - The JSON object.
+     * @param {...unknown[]} additionalArgs - Additional arguments.
+     * @returns {T['_Entity']} - The entity.
+     */
+    static deserializeJsonToEntity(schemaValidator, json, ...additionalArgs) {
+        return construct(this, schemaValidator)
+            .fromJson(json)
+            .toEntity(...additionalArgs);
+    }
+}

package/{dist/entityMapper/models/responseEntityMapper.model.d.ts → lib/src/domainMapper/models/responseDtoMapper.model.d.ts}

@@ -1,15 +1,15 @@
 import { AnySchemaValidator } from '@forklaunch/validator';
 import { BaseEntity } from '../../database/mikro/models/entities/base.entity';
-import { EntityMapperConstructor } from '../interfaces/entityMapper.interface';
-import { BaseEntityMapper } from './baseEntityMapper.model';
+import { DtoMapperConstructor } from '../interfaces/dtoMapper.interface';
+import { BaseDtoMapper } from './baseDtoMapper.model';
 /**
  * Abstract class representing a response entity mapper.
  *
  * @template Entity - A type that extends BaseEntity.
  * @template SV - A type that extends AnySchemaValidator.
- * @extends {BaseEntityMapper<SV>}
+ * @extends {BaseDtoMapper<SV>}
  */
-export declare abstract class ResponseEntityMapper<Entity extends BaseEntity, SV extends AnySchemaValidator> extends BaseEntityMapper<SV> {
+export declare abstract class ResponseDtoMapper<Entity extends BaseEntity, SV extends AnySchemaValidator> extends BaseDtoMapper<SV> {
     /**
      * The entity type.
      * @type {Entity}
@@ -22,7 +22,7 @@ export declare abstract class ResponseEntityMapper<Entity extends BaseEntity, SV
      * @abstract
      * @param {Entity} entity - The entity to convert.
      * @param {...unknown[]} additionalArgs - Additional arguments.
-     * @returns {this} - The instance of the ResponseEntityMapper.
+     * @returns {this} - The instance of the ResponseDtoMapper.
      */
     abstract fromEntity(entity: Entity, ...additionalArgs: unknown[]): this;
     /**
@@ -43,25 +43,25 @@ export declare abstract class ResponseEntityMapper<Entity extends BaseEntity, SV
     /**
      * Populates entity mapper with DTO from an entity.
      *
-     * @template T - A type that extends ResponseEntityMapper.
+     * @template T - A type that extends ResponseDtoMapper.
      * @template SV - A type that extends AnySchemaValidator.
-     * @param {EntityMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
      * @param {SV} schemaValidator - The schema provider.
      * @param {T['_Entity']} entity - The entity to convert.
      * @returns {T} - An instance of the T.
      */
-    static fromEntity<T extends ResponseEntityMapper<BaseEntity, SV>, SV extends AnySchemaValidator>(this: EntityMapperConstructor<T, SV>, schemaValidator: SV, entity: T['_Entity']): T;
+    static fromEntity<T extends ResponseDtoMapper<BaseEntity, SV>, SV extends AnySchemaValidator>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, entity: T['_Entity']): T;
     /**
      * Serializes an entity to a JSON object.
      *
-     * @template T - A type that extends ResponseEntityMapper.
+     * @template T - A type that extends ResponseDtoMapper.
      * @template SV - A type that extends AnySchemaValidator.
-     * @param {EntityMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
      * @param {SV} schemaValidator - The schema provider.
      * @param {T['_Entity']} entity - The entity to serialize.
      * @returns {T['_dto']} - The JSON object.
      * @throws {Error} - Throws an error if the DTO is invalid.
      */
-    static serializeEntityToJson<T extends ResponseEntityMapper<BaseEntity, SV>, SV extends AnySchemaValidator>(this: EntityMapperConstructor<T, SV>, schemaValidator: SV, entity: T['_Entity']): T['_dto'];
+    static serializeEntityToJson<T extends ResponseDtoMapper<BaseEntity, SV>, SV extends AnySchemaValidator>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, entity: T['_Entity']): T['_dto'];
 }
-//# sourceMappingURL=responseEntityMapper.model.d.ts.map
+//# sourceMappingURL=responseDtoMapper.model.d.ts.map

package/lib/src/domainMapper/models/responseDtoMapper.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseDtoMapper.model.d.ts","sourceRoot":"","sources":["../../../../src/domainMapper/models/responseDtoMapper.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAa,MAAM,uBAAuB,CAAC;AAEjE;;;;;;GAMG;AACH,8BAAsB,iBAAiB,CACrC,MAAM,SAAS,UAAU,EACzB,EAAE,SAAS,kBAAkB,CAC7B,SAAQ,aAAa,CAAC,EAAE,CAAC;IACzB;;;;OAIG;IACH,OAAO,EAAG,MAAM,CAAC;IAEjB;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAEvE;;;;;OAKG;IACH,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IAYtB;;;;;;OAMG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAInD;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU,CACf,CAAC,SAAS,iBAAiB,CAAC,UAAU,EAAE,EAAE,CAAC,EAC3C,EAAE,SAAS,kBAAkB,EAE7B,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,EAAE,CAAC,EACjC,eAAe,EAAE,EAAE,EACnB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GACnB,CAAC;IAIJ;;;;;;;;;;OAUG;IACH,MAAM,CAAC,qBAAqB,CAC1B,CAAC,SAAS,iBAAiB,CAAC,UAAU,EAAE,EAAE,CAAC,EAC3C,EAAE,SAAS,kBAAkB,EAE7B,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,EAAE,CAAC,EACjC,eAAe,EAAE,EAAE,EACnB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GACnB,CAAC,CAAC,MAAM,CAAC;CAGb"}

package/lib/src/domainMapper/models/responseDtoMapper.model.js

@@ -0,0 +1,65 @@
+import { BaseDtoMapper, construct } from './baseDtoMapper.model';
+/**
+ * Abstract class representing a response entity mapper.
+ *
+ * @template Entity - A type that extends BaseEntity.
+ * @template SV - A type that extends AnySchemaValidator.
+ * @extends {BaseDtoMapper<SV>}
+ */
+export class ResponseDtoMapper extends BaseDtoMapper {
+    /**
+     * The entity type.
+     * @type {Entity}
+     * @protected
+     */
+    _Entity;
+    /**
+     * Converts the underlying DTO to a JSON object.
+     *
+     * @returns {this['_dto']} - The JSON object.
+     * @throws {Error} - Throws an error if the DTO is invalid.
+     */
+    toJson() {
+        if (!this.schemaValidator.validate(this.schemaValidator.schemify(this.schema), this.dto)) {
+            throw new Error('Invalid DTO');
+        }
+        return this.dto;
+    }
+    /**
+     * Serializes an entity to a JSON object.
+     *
+     * @param {Entity} entity - The entity to serialize.
+     * @returns {this['_dto']} - The JSON object.
+     * @throws {Error} - Throws an error if the DTO is invalid.
+     */
+    serializeEntityToJson(entity) {
+        return this.fromEntity(entity).toJson();
+    }
+    /**
+     * Populates entity mapper with DTO from an entity.
+     *
+     * @template T - A type that extends ResponseDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {SV} schemaValidator - The schema provider.
+     * @param {T['_Entity']} entity - The entity to convert.
+     * @returns {T} - An instance of the T.
+     */
+    static fromEntity(schemaValidator, entity) {
+        return construct(this, schemaValidator).fromEntity(entity);
+    }
+    /**
+     * Serializes an entity to a JSON object.
+     *
+     * @template T - A type that extends ResponseDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {SV} schemaValidator - The schema provider.
+     * @param {T['_Entity']} entity - The entity to serialize.
+     * @returns {T['_dto']} - The JSON object.
+     * @throws {Error} - Throws an error if the DTO is invalid.
+     */
+    static serializeEntityToJson(schemaValidator, entity) {
+        return construct(this, schemaValidator).serializeEntityToJson(entity);
+    }
+}

package/lib/src/domainMapper/types/dtoMapper.types.d.ts

@@ -0,0 +1,9 @@
+import { AnySchemaValidator, UnboxedObjectSchema } from '@forklaunch/validator';
+/**
+ * Type representing a schema validator object for an entity mapper.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ * @typedef {SV['_ValidSchemaObject'] | UnboxedObjectSchema<SV>} DtoMapperSchemaValidatorObject
+ */
+export type DtoMapperSchemaValidatorObject<SV extends AnySchemaValidator> = SV['_ValidSchemaObject'] | UnboxedObjectSchema<SV>;
+//# sourceMappingURL=dtoMapper.types.d.ts.map

package/lib/src/domainMapper/types/dtoMapper.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtoMapper.types.d.ts","sourceRoot":"","sources":["../../../../src/domainMapper/types/dtoMapper.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEhF;;;;;GAKG;AACH,MAAM,MAAM,8BAA8B,CAAC,EAAE,SAAS,kBAAkB,IACpE,EAAE,CAAC,oBAAoB,CAAC,GACxB,mBAAmB,CAAC,EAAE,CAAC,CAAC"}

package/lib/src/domainMapper/types/dtoMapper.types.js

@@ -0,0 +1 @@
+export {};

package/lib/src/dtoMapper/index.d.ts

@@ -0,0 +1,3 @@
+export * from './models/requestDtoMapper.model';
+export * from './models/responseDtoMapper.model';
+//# sourceMappingURL=index.d.ts.map

package/lib/src/dtoMapper/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dtoMapper/index.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC"}

package/lib/src/dtoMapper/index.js

@@ -0,0 +1,2 @@
+export * from './models/requestDtoMapper.model';
+export * from './models/responseDtoMapper.model';

package/lib/src/dtoMapper/interfaces/dtoMapper.interface.d.ts

@@ -0,0 +1,18 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+/**
+ * Interface representing a constructor for an entity mapper.
+ *
+ * @template T - The type of the entity mapper.
+ * @template SV - The type of the schema validator.
+ * @interface DtoMapperConstructor
+ */
+export interface DtoMapperConstructor<T, SV extends AnySchemaValidator> {
+    /**
+     * Creates a new instance of the entity mapper.
+     *
+     * @param {AnySchemaValidator} schemaValidator - The arguments to pass to the constructor.
+     * @returns {T} - A new instance of the entity mapper.
+     */
+    new (schemaValidator: SV): T;
+}
+//# sourceMappingURL=dtoMapper.interface.d.ts.map

package/lib/src/dtoMapper/interfaces/dtoMapper.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dtoMapper.interface.d.ts","sourceRoot":"","sources":["../../../../src/dtoMapper/interfaces/dtoMapper.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,EAAE,EAAE,SAAS,kBAAkB;IACpE;;;;;OAKG;IACH,KAAK,eAAe,EAAE,EAAE,GAAG,CAAC,CAAC;CAC9B"}

package/lib/src/dtoMapper/interfaces/dtoMapper.interface.js

@@ -0,0 +1 @@
+export {};

package/lib/src/dtoMapper/models/baseDtoMapper.model.d.ts

@@ -0,0 +1,72 @@
+import { AnySchemaValidator, Schema, SchemaValidator } from '@forklaunch/validator';
+import { DtoMapperConstructor } from '../interfaces/dtoMapper.interface';
+import { DtoMapperSchemaValidatorObject } from '../types/dtoMapper.types';
+/**
+ * Constructs an instance of a T.
+ *
+ * @template T - A type that extends BaseDtoMapper.
+ * @template SV - A type that extends AnySchemaValidator.
+ * @param {DtoMapperConstructor<T, SV>} self - The constructor of the T.
+ * @param {SV} [schemaValidator] - The optional schema validator.
+ * @returns {T} - An instance of the T.
+ */
+export declare function construct<T, SV extends AnySchemaValidator>(self: DtoMapperConstructor<T, SV>, schemaValidator?: SV): T;
+/**
+ * Abstract class representing a base entity mapper.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ */
+export declare abstract class BaseDtoMapper<SV extends AnySchemaValidator> {
+    /**
+     * The schema validator exact type.
+     * @type {SV}
+     * @protected
+     */
+    _SV: SV;
+    /**
+     * The schema validator as a general type.
+     * @type {SchemaValidator}
+     * @protected
+     */
+    protected schemaValidator: SchemaValidator;
+    /**
+     * The schema definition.
+     * @type {DtoMapperSchemaValidatorObject<SV>}
+     * @abstract
+     */
+    abstract schema: DtoMapperSchemaValidatorObject<SV>;
+    /**
+     * The Data Transfer Object (DTO).
+     * @type {Schema<this['schema'], SV>}
+     */
+    _dto: Schema<this['schema'], SV>;
+    /**
+     * Creates an instance of BaseDtoMapper.
+     *
+     * @param {SV} schemaValidator - The schema provider.
+     */
+    constructor(schemaValidator: SV);
+    /**
+     * Validates and sets the Data Transfer Object (DTO).
+     *
+     * @param {this['_dto']} dto - The Data Transfer Object (DTO).
+     * @throws {Error} - Throws an error if the DTO is invalid.
+     */
+    set dto(_dto: this['_dto']);
+    /**
+     * Validates and gets the Data Transfer Object (DTO).
+     *
+     * @returns {this['_dto']} - The Data Transfer Object (DTO).
+     */
+    get dto(): this['_dto'];
+    /**
+     * Gets the schema of a T.
+     *
+     * @template T - A type that extends BaseDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @returns {T['schema']} - The schema of the T.
+     */
+    static schema<T extends BaseDtoMapper<SV>, SV extends AnySchemaValidator>(this: DtoMapperConstructor<T, SV>): T['schema'];
+}
+//# sourceMappingURL=baseDtoMapper.model.d.ts.map

package/lib/src/dtoMapper/models/baseDtoMapper.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseDtoMapper.model.d.ts","sourceRoot":"","sources":["../../../../src/dtoMapper/models/baseDtoMapper.model.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,MAAM,EACN,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAE1E;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,EAAE,SAAS,kBAAkB,EACxD,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,EAAE,CAAC,EACjC,eAAe,CAAC,EAAE,EAAE,GACnB,CAAC,CAEH;AAED;;;;GAIG;AACH,8BAAsB,aAAa,CAAC,EAAE,SAAS,kBAAkB;IAC/D;;;;OAIG;IACH,GAAG,EAAG,EAAE,CAAC;IAET;;;;OAIG;IACH,SAAS,CAAC,eAAe,EAAE,eAAe,CAAC;IAE3C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,8BAA8B,CAAC,EAAE,CAAC,CAAC;IAEpD;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC,CAG9B;IAEF;;;;OAIG;gBACS,eAAe,EAAE,EAAE;IAI/B;;;;;OAKG;IACH,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAUzB;IAED;;;;OAIG;IACH,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAEtB;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,aAAa,CAAC,EAAE,CAAC,EAAE,EAAE,SAAS,kBAAkB,EACtE,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,EAAE,CAAC,GAChC,CAAC,CAAC,QAAQ,CAAC;CAGf"}

package/lib/src/dtoMapper/models/baseDtoMapper.model.js

@@ -0,0 +1,75 @@
+/**
+ * Constructs an instance of a T.
+ *
+ * @template T - A type that extends BaseDtoMapper.
+ * @template SV - A type that extends AnySchemaValidator.
+ * @param {DtoMapperConstructor<T, SV>} self - The constructor of the T.
+ * @param {SV} [schemaValidator] - The optional schema validator.
+ * @returns {T} - An instance of the T.
+ */
+export function construct(self, schemaValidator) {
+    return new self(schemaValidator || {});
+}
+/**
+ * Abstract class representing a base entity mapper.
+ *
+ * @template SV - A type that extends AnySchemaValidator.
+ */
+export class BaseDtoMapper {
+    /**
+     * The schema validator exact type.
+     * @type {SV}
+     * @protected
+     */
+    _SV;
+    /**
+     * The schema validator as a general type.
+     * @type {SchemaValidator}
+     * @protected
+     */
+    schemaValidator;
+    /**
+     * The Data Transfer Object (DTO).
+     * @type {Schema<this['schema'], SV>}
+     */
+    _dto = {};
+    /**
+     * Creates an instance of BaseDtoMapper.
+     *
+     * @param {SV} schemaValidator - The schema provider.
+     */
+    constructor(schemaValidator) {
+        this.schemaValidator = schemaValidator;
+    }
+    /**
+     * Validates and sets the Data Transfer Object (DTO).
+     *
+     * @param {this['_dto']} dto - The Data Transfer Object (DTO).
+     * @throws {Error} - Throws an error if the DTO is invalid.
+     */
+    set dto(_dto) {
+        if (!this.schemaValidator.validate(this.schemaValidator.schemify(this.schema), _dto)) {
+            throw new Error('Invalid DTO');
+        }
+        this._dto = _dto;
+    }
+    /**
+     * Validates and gets the Data Transfer Object (DTO).
+     *
+     * @returns {this['_dto']} - The Data Transfer Object (DTO).
+     */
+    get dto() {
+        return this._dto;
+    }
+    /**
+     * Gets the schema of a T.
+     *
+     * @template T - A type that extends BaseDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @returns {T['schema']} - The schema of the T.
+     */
+    static schema() {
+        return construct(this).schema;
+    }
+}

package/lib/src/dtoMapper/models/requestDtoMapper.model.d.ts

@@ -0,0 +1,68 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { BaseEntity } from '../../database/mikro/models/entities/base.entity';
+import { DtoMapperConstructor } from '../interfaces/dtoMapper.interface';
+import { BaseDtoMapper } from './baseDtoMapper.model';
+/**
+ * Abstract class representing a request entity mapper.
+ *
+ * @template Entity - A type that extends BaseEntity.
+ * @template SV - A type that extends AnySchemaValidator.
+ * @extends {BaseDtoMapper<SV>}
+ */
+export declare abstract class RequestDtoMapper<Entity extends BaseEntity, SV extends AnySchemaValidator> extends BaseDtoMapper<SV> {
+    /**
+     * The entity type.
+     * @type {Entity}
+     * @protected
+     */
+    _Entity: Entity;
+    /**
+     * Converts the underlying DTO to an entity.
+     *
+     * @abstract
+     * @param {...unknown[]} additionalArgs - Additional arguments.
+     * @returns {Entity} - The entity.
+     */
+    abstract toEntity(...additionalArgs: unknown[]): Entity;
+    /**
+     * Populates the DTO with data from a JSON object.
+     *
+     * @param {this['_dto']} json - The JSON object.
+     * @returns {this} - The instance of the RequestDtoMapper.
+     */
+    fromJson(json: this['_dto']): this;
+    /**
+     * Deserializes a JSON object to an entity.
+     *
+     * @param {this['_dto']} json - The JSON object.
+     * @param {...unknown[]} additionalArgs - Additional arguments.
+     * @returns {Entity} - The entity.
+     */
+    deserializeJsonToEntity(json: this['_dto'], ...additionalArgs: unknown[]): Entity;
+    /**
+     * Creates an instance of a RequestDtoMapper from a JSON object.
+     *
+     * @template T - A type that extends RequestDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @template JsonType - The type of the JSON object.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {SV} schemaValidator - The schema provider.
+     * @param {JsonType} json - The JSON object.
+     * @returns {T} - An instance of the T.
+     */
+    static fromJson<T extends RequestDtoMapper<BaseEntity, SV>, SV extends AnySchemaValidator, JsonType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType): T;
+    /**
+     * Deserializes a JSON object to an entity.
+     *
+     * @template T - A type that extends RequestDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @template JsonType - The type of the JSON object.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {SV} schemaValidator - The schema provider.
+     * @param {JsonType} json - The JSON object.
+     * @param {...unknown[]} additionalArgs - Additional arguments.
+     * @returns {T['_Entity']} - The entity.
+     */
+    static deserializeJsonToEntity<T extends RequestDtoMapper<BaseEntity, SV>, SV extends AnySchemaValidator, JsonType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType, ...additionalArgs: unknown[]): T['_Entity'];
+}
+//# sourceMappingURL=requestDtoMapper.model.d.ts.map

package/lib/src/dtoMapper/models/requestDtoMapper.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requestDtoMapper.model.d.ts","sourceRoot":"","sources":["../../../../src/dtoMapper/models/requestDtoMapper.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAa,MAAM,uBAAuB,CAAC;AAEjE;;;;;;GAMG;AACH,8BAAsB,gBAAgB,CACpC,MAAM,SAAS,UAAU,EACzB,EAAE,SAAS,kBAAkB,CAC7B,SAAQ,aAAa,CAAC,EAAE,CAAC;IACzB;;;;OAIG;IACH,OAAO,EAAG,MAAM,CAAC;IAEjB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,MAAM;IAEvD;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI;IAalC;;;;;;OAMG;IACH,uBAAuB,CACrB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAClB,GAAG,cAAc,EAAE,OAAO,EAAE,GAC3B,MAAM;IAIT;;;;;;;;;;OAUG;IACH,MAAM,CAAC,QAAQ,CACb,CAAC,SAAS,gBAAgB,CAAC,UAAU,EAAE,EAAE,CAAC,EAC1C,EAAE,SAAS,kBAAkB,EAC7B,QAAQ,SAAS,CAAC,CAAC,MAAM,CAAC,EAE1B,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,EAAE,CAAC,EACjC,eAAe,EAAE,EAAE,EACnB,IAAI,EAAE,QAAQ,GACb,CAAC;IAIJ;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,uBAAuB,CAC5B,CAAC,SAAS,gBAAgB,CAAC,UAAU,EAAE,EAAE,CAAC,EAC1C,EAAE,SAAS,kBAAkB,EAC7B,QAAQ,SAAS,CAAC,CAAC,MAAM,CAAC,EAE1B,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,EAAE,CAAC,EACjC,eAAe,EAAE,EAAE,EACnB,IAAI,EAAE,QAAQ,EACd,GAAG,cAAc,EAAE,OAAO,EAAE,GAC3B,CAAC,CAAC,SAAS,CAAC;CAKhB"}

package/lib/src/dtoMapper/models/requestDtoMapper.model.js

@@ -0,0 +1,70 @@
+import { BaseDtoMapper, construct } from './baseDtoMapper.model';
+/**
+ * Abstract class representing a request entity mapper.
+ *
+ * @template Entity - A type that extends BaseEntity.
+ * @template SV - A type that extends AnySchemaValidator.
+ * @extends {BaseDtoMapper<SV>}
+ */
+export class RequestDtoMapper extends BaseDtoMapper {
+    /**
+     * The entity type.
+     * @type {Entity}
+     * @protected
+     */
+    _Entity;
+    /**
+     * Populates the DTO with data from a JSON object.
+     *
+     * @param {this['_dto']} json - The JSON object.
+     * @returns {this} - The instance of the RequestDtoMapper.
+     */
+    fromJson(json) {
+        if (!this.schemaValidator.validate(this.schemaValidator.schemify(this.schema), json)) {
+            throw new Error('Invalid DTO');
+        }
+        this.dto = json;
+        return this;
+    }
+    /**
+     * Deserializes a JSON object to an entity.
+     *
+     * @param {this['_dto']} json - The JSON object.
+     * @param {...unknown[]} additionalArgs - Additional arguments.
+     * @returns {Entity} - The entity.
+     */
+    deserializeJsonToEntity(json, ...additionalArgs) {
+        return this.fromJson(json).toEntity(...additionalArgs);
+    }
+    /**
+     * Creates an instance of a RequestDtoMapper from a JSON object.
+     *
+     * @template T - A type that extends RequestDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @template JsonType - The type of the JSON object.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {SV} schemaValidator - The schema provider.
+     * @param {JsonType} json - The JSON object.
+     * @returns {T} - An instance of the T.
+     */
+    static fromJson(schemaValidator, json) {
+        return construct(this, schemaValidator).fromJson(json);
+    }
+    /**
+     * Deserializes a JSON object to an entity.
+     *
+     * @template T - A type that extends RequestDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @template JsonType - The type of the JSON object.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {SV} schemaValidator - The schema provider.
+     * @param {JsonType} json - The JSON object.
+     * @param {...unknown[]} additionalArgs - Additional arguments.
+     * @returns {T['_Entity']} - The entity.
+     */
+    static deserializeJsonToEntity(schemaValidator, json, ...additionalArgs) {
+        return construct(this, schemaValidator)
+            .fromJson(json)
+            .toEntity(...additionalArgs);
+    }
+}

package/lib/src/dtoMapper/models/responseDtoMapper.model.d.ts

@@ -0,0 +1,67 @@
+import { AnySchemaValidator } from '@forklaunch/validator';
+import { BaseEntity } from '../../database/mikro/models/entities/base.entity';
+import { DtoMapperConstructor } from '../interfaces/dtoMapper.interface';
+import { BaseDtoMapper } from './baseDtoMapper.model';
+/**
+ * Abstract class representing a response entity mapper.
+ *
+ * @template Entity - A type that extends BaseEntity.
+ * @template SV - A type that extends AnySchemaValidator.
+ * @extends {BaseDtoMapper<SV>}
+ */
+export declare abstract class ResponseDtoMapper<Entity extends BaseEntity, SV extends AnySchemaValidator> extends BaseDtoMapper<SV> {
+    /**
+     * The entity type.
+     * @type {Entity}
+     * @protected
+     */
+    _Entity: Entity;
+    /**
+     * Populates entity mapper with DTO from an entity.
+     *
+     * @abstract
+     * @param {Entity} entity - The entity to convert.
+     * @param {...unknown[]} additionalArgs - Additional arguments.
+     * @returns {this} - The instance of the ResponseDtoMapper.
+     */
+    abstract fromEntity(entity: Entity, ...additionalArgs: unknown[]): this;
+    /**
+     * Converts the underlying DTO to a JSON object.
+     *
+     * @returns {this['_dto']} - The JSON object.
+     * @throws {Error} - Throws an error if the DTO is invalid.
+     */
+    toJson(): this['_dto'];
+    /**
+     * Serializes an entity to a JSON object.
+     *
+     * @param {Entity} entity - The entity to serialize.
+     * @returns {this['_dto']} - The JSON object.
+     * @throws {Error} - Throws an error if the DTO is invalid.
+     */
+    serializeEntityToJson(entity: Entity): this['_dto'];
+    /**
+     * Populates entity mapper with DTO from an entity.
+     *
+     * @template T - A type that extends ResponseDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {SV} schemaValidator - The schema provider.
+     * @param {T['_Entity']} entity - The entity to convert.
+     * @returns {T} - An instance of the T.
+     */
+    static fromEntity<T extends ResponseDtoMapper<BaseEntity, SV>, SV extends AnySchemaValidator>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, entity: T['_Entity']): T;
+    /**
+     * Serializes an entity to a JSON object.
+     *
+     * @template T - A type that extends ResponseDtoMapper.
+     * @template SV - A type that extends AnySchemaValidator.
+     * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.
+     * @param {SV} schemaValidator - The schema provider.
+     * @param {T['_Entity']} entity - The entity to serialize.
+     * @returns {T['_dto']} - The JSON object.
+     * @throws {Error} - Throws an error if the DTO is invalid.
+     */
+    static serializeEntityToJson<T extends ResponseDtoMapper<BaseEntity, SV>, SV extends AnySchemaValidator>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, entity: T['_Entity']): T['_dto'];
+}
+//# sourceMappingURL=responseDtoMapper.model.d.ts.map

package/lib/src/dtoMapper/models/responseDtoMapper.model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responseDtoMapper.model.d.ts","sourceRoot":"","sources":["../../../../src/dtoMapper/models/responseDtoMapper.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,kDAAkD,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAa,MAAM,uBAAuB,CAAC;AAEjE;;;;;;GAMG;AACH,8BAAsB,iBAAiB,CACrC,MAAM,SAAS,UAAU,EACzB,EAAE,SAAS,kBAAkB,CAC7B,SAAQ,aAAa,CAAC,EAAE,CAAC;IACzB;;;;OAIG;IACH,OAAO,EAAG,MAAM,CAAC;IAEjB;;;;;;;OAOG;IACH,QAAQ,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,EAAE,OAAO,EAAE,GAAG,IAAI;IAEvE;;;;;OAKG;IACH,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC;IAYtB;;;;;;OAMG;IACH,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAInD;;;;;;;;;OASG;IACH,MAAM,CAAC,UAAU,CACf,CAAC,SAAS,iBAAiB,CAAC,UAAU,EAAE,EAAE,CAAC,EAC3C,EAAE,SAAS,kBAAkB,EAE7B,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,EAAE,CAAC,EACjC,eAAe,EAAE,EAAE,EACnB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GACnB,CAAC;IAIJ;;;;;;;;;;OAUG;IACH,MAAM,CAAC,qBAAqB,CAC1B,CAAC,SAAS,iBAAiB,CAAC,UAAU,EAAE,EAAE,CAAC,EAC3C,EAAE,SAAS,kBAAkB,EAE7B,IAAI,EAAE,oBAAoB,CAAC,CAAC,EAAE,EAAE,CAAC,EACjC,eAAe,EAAE,EAAE,EACnB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GACnB,CAAC,CAAC,MAAM,CAAC;CAGb"}