@forklaunch/core 0.8.8 → 0.9.2

package/lib/src/mappers/index.d.mts

@@ -130,16 +130,16 @@ declare abstract class RequestDtoMapper<Entity, SV extends AnySchemaValidator> e
      *
      * @abstract
      * @param {...unknown[]} additionalArgs - Additional arguments.
-     * @returns {Entity} - The entity.
+     * @returns {Promise<Entity>} - The entity.
      */
-    abstract toEntity(...additionalArgs: unknown[]): Entity;
+    abstract toEntity(...additionalArgs: unknown[]): Promise<Entity>;
     /**
      * Populates the DTO with data from a JSON object.
      *
      * @param {this['_dto']} json - The JSON object.
-     * @returns {this} - The instance of the RequestDtoMapper.
+     * @returns {Promise<this>} - The instance of the RequestDtoMapper.
      */
-    fromDto(json: this['_dto']): this;
+    fromDto(json: this['_dto']): Promise<this>;
     /**
      * Deserializes a JSON object to an entity.
      *
@@ -147,7 +147,7 @@ declare abstract class RequestDtoMapper<Entity, SV extends AnySchemaValidator> e
      * @param {...unknown[]} additionalArgs - Additional arguments.
      * @returns {Entity} - The entity.
      */
-    deserializeDtoToEntity(json: this['_dto'], ...additionalArgs: Parameters<this['toEntity']>): Entity;
+    deserializeDtoToEntity(json: this['_dto'], ...additionalArgs: Parameters<this['toEntity']>): Promise<Entity>;
     /**
      * Creates an instance of a RequestDtoMapper from a JSON object.
      *
@@ -159,7 +159,7 @@ declare abstract class RequestDtoMapper<Entity, SV extends AnySchemaValidator> e
      * @param {JsonType} json - The JSON object.
      * @returns {T} - An instance of the T.
      */
-    static fromDto<T extends RequestDtoMapper<unknown, SV>, SV extends AnySchemaValidator, JsonType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType): T;
+    static fromDto<T extends RequestDtoMapper<unknown, SV>, SV extends AnySchemaValidator, JsonType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType): Promise<T>;
     /**
      * Deserializes a JSON object to an entity.
      *
@@ -172,7 +172,7 @@ declare abstract class RequestDtoMapper<Entity, SV extends AnySchemaValidator> e
      * @param {...unknown[]} additionalArgs - Additional arguments.
      * @returns {T['_Entity']} - The entity.
      */
-    static deserializeDtoToEntity<T extends RequestDtoMapper<unknown, SV>, SV extends AnySchemaValidator, JsonType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType, ...additionalArgs: Parameters<T['toEntity']>): T['_Entity'];
+    static deserializeDtoToEntity<T extends RequestDtoMapper<unknown, SV>, SV extends AnySchemaValidator, JsonType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType, ...additionalArgs: Parameters<T['toEntity']>): Promise<T['_Entity']>;
 }
 
 /**
@@ -197,14 +197,14 @@ declare abstract class ResponseDtoMapper<Entity, SV extends AnySchemaValidator>
      * @param {...unknown[]} additionalArgs - Additional arguments.
      * @returns {this} - The instance of the ResponseDtoMapper.
      */
-    abstract fromEntity(entity: Entity, ...additionalArgs: unknown[]): this;
+    abstract fromEntity(entity: Entity, ...additionalArgs: unknown[]): Promise<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.
      */
-    toDto(): this['_dto'];
+    toDto(): Promise<this['_dto']>;
     /**
      * Serializes an entity to a JSON object.
      *
@@ -212,7 +212,7 @@ declare abstract class ResponseDtoMapper<Entity, SV extends AnySchemaValidator>
      * @returns {this['_dto']} - The JSON object.
      * @throws {Error} - Throws an error if the DTO is invalid.
      */
-    serializeEntityToDto(...[entity, ...additionalArgs]: Parameters<this['fromEntity']>): this['_dto'];
+    serializeEntityToDto(...[entity, ...additionalArgs]: Parameters<this['fromEntity']>): Promise<this['_dto']>;
     /**
      * Populates entity mapper with DTO from an entity.
      *
@@ -223,7 +223,7 @@ declare abstract class ResponseDtoMapper<Entity, SV extends AnySchemaValidator>
      * @param {T['_Entity']} entity - The entity to convert.
      * @returns {T} - An instance of the T.
      */
-    static fromEntity<T extends ResponseDtoMapper<unknown, SV>, SV extends AnySchemaValidator>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>): T;
+    static fromEntity<T extends ResponseDtoMapper<unknown, SV>, SV extends AnySchemaValidator>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>): Promise<T>;
     /**
      * Serializes an entity to a JSON object.
      *
@@ -235,7 +235,7 @@ declare abstract class ResponseDtoMapper<Entity, SV extends AnySchemaValidator>
      * @returns {T['_dto']} - The JSON object.
      * @throws {Error} - Throws an error if the DTO is invalid.
      */
-    static serializeEntityToDto<T extends ResponseDtoMapper<unknown, SV>, SV extends AnySchemaValidator, DtoType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>): DtoType;
+    static serializeEntityToDto<T extends ResponseDtoMapper<unknown, SV>, SV extends AnySchemaValidator, DtoType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>): Promise<DtoType>;
 }
 
 type SchemasByValidator<T extends AnySchemaValidator, TypeBoxSchemas extends (...args: never[]) => unknown, ZodSchemas extends (...args: never[]) => unknown> = T extends TypeboxSchemaValidator ? ReturnType<TypeBoxSchemas> : T extends ZodSchemaValidator ? ReturnType<ZodSchemas> : never;
@@ -259,13 +259,13 @@ type InternalDtoMapper<DtoMapper extends Record<string, {
         _Entity: unknown;
         serializeEntityToDto: unknown;
     } ? {
-        serializeEntityToDto: (entity: Entities[K], ...additionalArgs: AllAfterFirstParameters<DtoMapper[K]['serializeEntityToDto']>) => Dto[K];
+        serializeEntityToDto: (entity: Entities[K], ...additionalArgs: AllAfterFirstParameters<DtoMapper[K]['serializeEntityToDto']>) => Promise<Dto[K]>;
     } : DtoMapper[K] extends {
         dto: unknown;
         _Entity: unknown;
         deserializeDtoToEntity: unknown;
     } ? {
-        deserializeDtoToEntity: (dto: Dto[K], ...additionalArgs: AllAfterFirstParameters<DtoMapper[K]['deserializeDtoToEntity']>) => Entities[K];
+        deserializeDtoToEntity: (dto: Dto[K], ...additionalArgs: AllAfterFirstParameters<DtoMapper[K]['deserializeDtoToEntity']>) => Promise<Entities[K]>;
     } : never;
 };
 

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

@@ -130,16 +130,16 @@ declare abstract class RequestDtoMapper<Entity, SV extends AnySchemaValidator> e
      *
      * @abstract
      * @param {...unknown[]} additionalArgs - Additional arguments.
-     * @returns {Entity} - The entity.
+     * @returns {Promise<Entity>} - The entity.
      */
-    abstract toEntity(...additionalArgs: unknown[]): Entity;
+    abstract toEntity(...additionalArgs: unknown[]): Promise<Entity>;
     /**
      * Populates the DTO with data from a JSON object.
      *
      * @param {this['_dto']} json - The JSON object.
-     * @returns {this} - The instance of the RequestDtoMapper.
+     * @returns {Promise<this>} - The instance of the RequestDtoMapper.
      */
-    fromDto(json: this['_dto']): this;
+    fromDto(json: this['_dto']): Promise<this>;
     /**
      * Deserializes a JSON object to an entity.
      *
@@ -147,7 +147,7 @@ declare abstract class RequestDtoMapper<Entity, SV extends AnySchemaValidator> e
      * @param {...unknown[]} additionalArgs - Additional arguments.
      * @returns {Entity} - The entity.
      */
-    deserializeDtoToEntity(json: this['_dto'], ...additionalArgs: Parameters<this['toEntity']>): Entity;
+    deserializeDtoToEntity(json: this['_dto'], ...additionalArgs: Parameters<this['toEntity']>): Promise<Entity>;
     /**
      * Creates an instance of a RequestDtoMapper from a JSON object.
      *
@@ -159,7 +159,7 @@ declare abstract class RequestDtoMapper<Entity, SV extends AnySchemaValidator> e
      * @param {JsonType} json - The JSON object.
      * @returns {T} - An instance of the T.
      */
-    static fromDto<T extends RequestDtoMapper<unknown, SV>, SV extends AnySchemaValidator, JsonType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType): T;
+    static fromDto<T extends RequestDtoMapper<unknown, SV>, SV extends AnySchemaValidator, JsonType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType): Promise<T>;
     /**
      * Deserializes a JSON object to an entity.
      *
@@ -172,7 +172,7 @@ declare abstract class RequestDtoMapper<Entity, SV extends AnySchemaValidator> e
      * @param {...unknown[]} additionalArgs - Additional arguments.
      * @returns {T['_Entity']} - The entity.
      */
-    static deserializeDtoToEntity<T extends RequestDtoMapper<unknown, SV>, SV extends AnySchemaValidator, JsonType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType, ...additionalArgs: Parameters<T['toEntity']>): T['_Entity'];
+    static deserializeDtoToEntity<T extends RequestDtoMapper<unknown, SV>, SV extends AnySchemaValidator, JsonType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType, ...additionalArgs: Parameters<T['toEntity']>): Promise<T['_Entity']>;
 }
 
 /**
@@ -197,14 +197,14 @@ declare abstract class ResponseDtoMapper<Entity, SV extends AnySchemaValidator>
      * @param {...unknown[]} additionalArgs - Additional arguments.
      * @returns {this} - The instance of the ResponseDtoMapper.
      */
-    abstract fromEntity(entity: Entity, ...additionalArgs: unknown[]): this;
+    abstract fromEntity(entity: Entity, ...additionalArgs: unknown[]): Promise<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.
      */
-    toDto(): this['_dto'];
+    toDto(): Promise<this['_dto']>;
     /**
      * Serializes an entity to a JSON object.
      *
@@ -212,7 +212,7 @@ declare abstract class ResponseDtoMapper<Entity, SV extends AnySchemaValidator>
      * @returns {this['_dto']} - The JSON object.
      * @throws {Error} - Throws an error if the DTO is invalid.
      */
-    serializeEntityToDto(...[entity, ...additionalArgs]: Parameters<this['fromEntity']>): this['_dto'];
+    serializeEntityToDto(...[entity, ...additionalArgs]: Parameters<this['fromEntity']>): Promise<this['_dto']>;
     /**
      * Populates entity mapper with DTO from an entity.
      *
@@ -223,7 +223,7 @@ declare abstract class ResponseDtoMapper<Entity, SV extends AnySchemaValidator>
      * @param {T['_Entity']} entity - The entity to convert.
      * @returns {T} - An instance of the T.
      */
-    static fromEntity<T extends ResponseDtoMapper<unknown, SV>, SV extends AnySchemaValidator>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>): T;
+    static fromEntity<T extends ResponseDtoMapper<unknown, SV>, SV extends AnySchemaValidator>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>): Promise<T>;
     /**
      * Serializes an entity to a JSON object.
      *
@@ -235,7 +235,7 @@ declare abstract class ResponseDtoMapper<Entity, SV extends AnySchemaValidator>
      * @returns {T['_dto']} - The JSON object.
      * @throws {Error} - Throws an error if the DTO is invalid.
      */
-    static serializeEntityToDto<T extends ResponseDtoMapper<unknown, SV>, SV extends AnySchemaValidator, DtoType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>): DtoType;
+    static serializeEntityToDto<T extends ResponseDtoMapper<unknown, SV>, SV extends AnySchemaValidator, DtoType extends T['_dto']>(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>): Promise<DtoType>;
 }
 
 type SchemasByValidator<T extends AnySchemaValidator, TypeBoxSchemas extends (...args: never[]) => unknown, ZodSchemas extends (...args: never[]) => unknown> = T extends TypeboxSchemaValidator ? ReturnType<TypeBoxSchemas> : T extends ZodSchemaValidator ? ReturnType<ZodSchemas> : never;
@@ -259,13 +259,13 @@ type InternalDtoMapper<DtoMapper extends Record<string, {
         _Entity: unknown;
         serializeEntityToDto: unknown;
     } ? {
-        serializeEntityToDto: (entity: Entities[K], ...additionalArgs: AllAfterFirstParameters<DtoMapper[K]['serializeEntityToDto']>) => Dto[K];
+        serializeEntityToDto: (entity: Entities[K], ...additionalArgs: AllAfterFirstParameters<DtoMapper[K]['serializeEntityToDto']>) => Promise<Dto[K]>;
     } : DtoMapper[K] extends {
         dto: unknown;
         _Entity: unknown;
         deserializeDtoToEntity: unknown;
     } ? {
-        deserializeDtoToEntity: (dto: Dto[K], ...additionalArgs: AllAfterFirstParameters<DtoMapper[K]['deserializeDtoToEntity']>) => Entities[K];
+        deserializeDtoToEntity: (dto: Dto[K], ...additionalArgs: AllAfterFirstParameters<DtoMapper[K]['deserializeDtoToEntity']>) => Promise<Entities[K]>;
     } : never;
 };
 

package/lib/src/mappers/index.js

@@ -52,7 +52,7 @@ var BaseDtoMapper = class {
    * The Data Transfer Object (DTO).
    * @type {Schema<this['schema'], SV>}
    */
-  _dto = {};
+  _dto;
   /**
    * Creates an instance of BaseDtoMapper.
    *
@@ -110,7 +110,7 @@ var RequestDtoMapper = class extends BaseDtoMapper {
    * Populates the DTO with data from a JSON object.
    *
    * @param {this['_dto']} json - The JSON object.
-   * @returns {this} - The instance of the RequestDtoMapper.
+   * @returns {Promise<this>} - The instance of the RequestDtoMapper.
    */
   fromDto(json) {
     const parsedSchema = this.schemaValidator.parse(
@@ -121,7 +121,7 @@ var RequestDtoMapper = class extends BaseDtoMapper {
       throw new Error((0, import_validator2.prettyPrintParseErrors)(parsedSchema.errors, "DTO"));
     }
     this.dto = json;
-    return this;
+    return Promise.resolve(this);
   }
   /**
    * Deserializes a JSON object to an entity.
@@ -131,7 +131,8 @@ var RequestDtoMapper = class extends BaseDtoMapper {
    * @returns {Entity} - The entity.
    */
   deserializeDtoToEntity(json, ...additionalArgs) {
-    return this.fromDto(json).toEntity(...additionalArgs);
+    const result = this.fromDto(json);
+    return result.then((r) => r.toEntity(...additionalArgs));
   }
   /**
    * Creates an instance of a RequestDtoMapper from a JSON object.
@@ -160,7 +161,8 @@ var RequestDtoMapper = class extends BaseDtoMapper {
    * @returns {T['_Entity']} - The entity.
    */
   static deserializeDtoToEntity(schemaValidator, json, ...additionalArgs) {
-    return construct(this, schemaValidator).fromDto(json).toEntity(...additionalArgs);
+    const result = construct(this, schemaValidator).fromDto(json);
+    return result.then((r) => r.toEntity(...additionalArgs));
   }
 };
 
@@ -187,7 +189,7 @@ var ResponseDtoMapper = class extends BaseDtoMapper {
     if (!parsedSchema.ok) {
       throw new Error((0, import_validator3.prettyPrintParseErrors)(parsedSchema.errors, "DTO"));
     }
-    return this.dto;
+    return Promise.resolve(this.dto);
   }
   /**
    * Serializes an entity to a JSON object.
@@ -197,7 +199,8 @@ var ResponseDtoMapper = class extends BaseDtoMapper {
    * @throws {Error} - Throws an error if the DTO is invalid.
    */
   serializeEntityToDto(...[entity, ...additionalArgs]) {
-    return this.fromEntity(entity, ...additionalArgs).toDto();
+    const result = this.fromEntity(entity, ...additionalArgs);
+    return result.then((r) => r.toDto());
   }
   /**
    * Populates entity mapper with DTO from an entity.
@@ -227,7 +230,11 @@ var ResponseDtoMapper = class extends BaseDtoMapper {
    * @throws {Error} - Throws an error if the DTO is invalid.
    */
   static serializeEntityToDto(schemaValidator, ...[entity, ...additionalArgs]) {
-    return construct(this, schemaValidator).fromEntity(entity, ...additionalArgs).toDto();
+    const result = construct(this, schemaValidator).fromEntity(
+      entity,
+      ...additionalArgs
+    );
+    return result.then((r) => r.toDto());
   }
 };
 

package/lib/src/mappers/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/mappers/index.ts","../../../src/mappers/models/requestDtoMapper.model.ts","../../../src/mappers/models/baseDtoMapper.model.ts","../../../src/mappers/models/responseDtoMapper.model.ts","../../../src/mappers/serviceSchemaResolver.ts","../../../src/mappers/transformIntoInternalDtoMapper.ts"],"sourcesContent":["export * from './models/requestDtoMapper.model';\nexport * from './models/responseDtoMapper.model';\nexport * from './serviceSchemaResolver';\nexport * from './transformIntoInternalDtoMapper';\nexport * from './types/mappers.types';\nexport * from './types/internalDtoMapper.types';\nexport * from './types/serviceSchemaResolver.types';\n","import {\n  AnySchemaValidator,\n  prettyPrintParseErrors\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { BaseDtoMapper, construct } from './baseDtoMapper.model';\n\n/**\n * Abstract class representing a request entity mapper.\n *\n * @template Entity - A type that extends SqlBaseEntity.\n * @template SV - A type that extends AnySchemaValidator.\n * @extends {BaseDtoMapper<SV>}\n */\nexport abstract class RequestDtoMapper<\n  Entity,\n  SV extends AnySchemaValidator\n> extends BaseDtoMapper<SV> {\n  /**\n   * The entity type.\n   * @type {Entity}\n   * @protected\n   */\n  _Entity!: Entity;\n\n  /**\n   * Converts the underlying DTO to an entity.\n   *\n   * @abstract\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {Entity} - The entity.\n   */\n  abstract toEntity(...additionalArgs: unknown[]): Entity;\n\n  /**\n   * Populates the DTO with data from a JSON object.\n   *\n   * @param {this['_dto']} json - The JSON object.\n   * @returns {this} - The instance of the RequestDtoMapper.\n   */\n  fromDto(json: this['_dto']): this {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      json\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    this.dto = json;\n    return this;\n  }\n\n  /**\n   * Deserializes a JSON object to an entity.\n   *\n   * @param {this['_dto']} json - The JSON object.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {Entity} - The entity.\n   */\n  deserializeDtoToEntity(\n    json: this['_dto'],\n    ...additionalArgs: Parameters<this['toEntity']>\n  ): Entity {\n    return this.fromDto(json).toEntity(...additionalArgs);\n  }\n\n  /**\n   * Creates an instance of a RequestDtoMapper from a JSON object.\n   *\n   * @template T - A type that extends RequestDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @template JsonType - The type of the JSON object.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {JsonType} json - The JSON object.\n   * @returns {T} - An instance of the T.\n   */\n  static fromDto<\n    T extends RequestDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    JsonType extends T['_dto']\n  >(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType): T {\n    return construct(this, schemaValidator).fromDto(json);\n  }\n\n  /**\n   * Deserializes a JSON object to an entity.\n   *\n   * @template T - A type that extends RequestDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @template JsonType - The type of the JSON object.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {JsonType} json - The JSON object.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {T['_Entity']} - The entity.\n   */\n  static deserializeDtoToEntity<\n    T extends RequestDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    JsonType extends T['_dto']\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    json: JsonType,\n    ...additionalArgs: Parameters<T['toEntity']>\n  ): T['_Entity'] {\n    return construct(this, schemaValidator)\n      .fromDto(json)\n      .toEntity(...additionalArgs);\n  }\n}\n","import {\n  AnySchemaValidator,\n  prettyPrintParseErrors,\n  Schema,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { DtoMapperSchemaValidatorObject } from '../types/mappers.types';\n\n/**\n * Constructs an instance of a T.\n *\n * @template T - A type that extends BaseDtoMapper.\n * @template SV - A type that extends AnySchemaValidator.\n * @param {DtoMapperConstructor<T, SV>} self - The constructor of the T.\n * @param {SV} [schemaValidator] - The optional schema validator.\n * @returns {T} - An instance of the T.\n */\nexport function construct<T, SV extends AnySchemaValidator>(\n  self: DtoMapperConstructor<T, SV>,\n  schemaValidator?: SV\n): T {\n  return new self(schemaValidator || ({} as SV));\n}\n\n/**\n * Abstract class representing a base entity mapper.\n *\n * @template SV - A type that extends AnySchemaValidator.\n */\nexport abstract class BaseDtoMapper<SV extends AnySchemaValidator> {\n  /**\n   * The schema validator exact type.\n   * @type {SV}\n   * @protected\n   */\n  _SV!: SV;\n\n  /**\n   * The schema validator as a general type.\n   * @type {SchemaValidator}\n   * @protected\n   */\n  protected schemaValidator: SchemaValidator;\n\n  /**\n   * The schema definition.\n   * @type {DtoMapperSchemaValidatorObject<SV>}\n   * @abstract\n   */\n  abstract schema: DtoMapperSchemaValidatorObject<SV>;\n\n  /**\n   * The Data Transfer Object (DTO).\n   * @type {Schema<this['schema'], SV>}\n   */\n  _dto: Schema<this['schema'], SV> = {} as unknown as Schema<\n    this['schema'],\n    SV\n  >;\n\n  /**\n   * Creates an instance of BaseDtoMapper.\n   *\n   * @param {SV} schemaValidator - The schema provider.\n   */\n  constructor(schemaValidator: SV) {\n    this.schemaValidator = schemaValidator as unknown as SchemaValidator;\n  }\n\n  /**\n   * Validates and sets the Data Transfer Object (DTO).\n   *\n   * @param {this['_dto']} dto - The Data Transfer Object (DTO).\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  set dto(_dto: this['_dto']) {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      _dto\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    this._dto = _dto as unknown as Schema<this['schema'], SV>;\n  }\n\n  /**\n   * Validates and gets the Data Transfer Object (DTO).\n   *\n   * @returns {this['_dto']} - The Data Transfer Object (DTO).\n   */\n  get dto(): this['_dto'] {\n    return this._dto as unknown as this['_dto'];\n  }\n\n  /**\n   * Gets the schema of a T.\n   *\n   * @template T - A type that extends BaseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @returns {T['schema']} - The schema of the T.\n   */\n  static schema<T extends BaseDtoMapper<SV>, SV extends AnySchemaValidator>(\n    this: DtoMapperConstructor<T, SV>\n  ): T['schema'] {\n    return construct(this).schema;\n  }\n}\n","import {\n  AnySchemaValidator,\n  prettyPrintParseErrors\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { BaseDtoMapper, construct } from './baseDtoMapper.model';\n\n/**\n * Abstract class representing a response entity mapper.\n *\n * @template Entity - A type that extends SqlBaseEntity.\n * @template SV - A type that extends AnySchemaValidator.\n * @extends {BaseDtoMapper<SV>}\n */\nexport abstract class ResponseDtoMapper<\n  Entity,\n  SV extends AnySchemaValidator\n> extends BaseDtoMapper<SV> {\n  /**\n   * The entity type.\n   * @type {Entity}\n   * @protected\n   */\n  _Entity!: Entity;\n\n  /**\n   * Populates entity mapper with DTO from an entity.\n   *\n   * @abstract\n   * @param {Entity} entity - The entity to convert.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {this} - The instance of the ResponseDtoMapper.\n   */\n  abstract fromEntity(entity: Entity, ...additionalArgs: unknown[]): this;\n\n  /**\n   * Converts the underlying DTO to a JSON object.\n   *\n   * @returns {this['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  toDto(): this['_dto'] {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      this.dto\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    return this.dto;\n  }\n\n  /**\n   * Serializes an entity to a JSON object.\n   *\n   * @param {Entity} entity - The entity to serialize.\n   * @returns {this['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  serializeEntityToDto(\n    ...[entity, ...additionalArgs]: Parameters<this['fromEntity']>\n  ): this['_dto'] {\n    return this.fromEntity(entity, ...additionalArgs).toDto();\n  }\n\n  /**\n   * Populates entity mapper with DTO from an entity.\n   *\n   * @template T - A type that extends ResponseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {T['_Entity']} entity - The entity to convert.\n   * @returns {T} - An instance of the T.\n   */\n  static fromEntity<\n    T extends ResponseDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>\n  ): T {\n    return construct(this, schemaValidator).fromEntity(\n      entity,\n      ...additionalArgs\n    );\n  }\n\n  /**\n   * Serializes an entity to a JSON object.\n   *\n   * @template T - A type that extends ResponseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {T['_Entity']} entity - The entity to serialize.\n   * @returns {T['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  static serializeEntityToDto<\n    T extends ResponseDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    DtoType extends T['_dto']\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>\n  ): DtoType {\n    return construct(this, schemaValidator)\n      .fromEntity(entity, ...additionalArgs)\n      .toDto() as DtoType;\n  }\n}\n","import { isNever } from '@forklaunch/common';\nimport { AnySchemaValidator } from '@forklaunch/validator';\nimport { SchemasByValidator } from './types/serviceSchemaResolver.types';\n\nexport function serviceSchemaResolver<\n  Options extends Record<string, unknown>,\n  TypeBoxSchemas,\n  ZodSchemas\n>(\n  TypeBoxSchemas: (options: Options) => TypeBoxSchemas,\n  ZodSchemas: (options: Options) => ZodSchemas\n) {\n  return <SchemaValidator extends AnySchemaValidator>(\n    options: Options & { validator: SchemaValidator }\n  ): SchemasByValidator<\n    SchemaValidator,\n    (options: Options) => TypeBoxSchemas,\n    (options: Options) => ZodSchemas\n  > => {\n    switch (options.validator._Type) {\n      case 'TypeBox':\n        return TypeBoxSchemas(options) as SchemasByValidator<\n          SchemaValidator,\n          (options: Options) => TypeBoxSchemas,\n          (options: Options) => ZodSchemas\n        >;\n      case 'Zod':\n        return ZodSchemas(options) as SchemasByValidator<\n          SchemaValidator,\n          (options: Options) => TypeBoxSchemas,\n          (options: Options) => ZodSchemas\n        >;\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-ignore\n      case 'Mock':\n        throw new Error('Mock schema validator not supported');\n      default:\n        isNever(options.validator._Type);\n        throw new Error('Invalid schema validator');\n    }\n  };\n}\n","import { InstanceTypeRecord } from '@forklaunch/common';\nimport { AnySchemaValidator } from '@forklaunch/validator';\nimport { InternalDtoMapper } from './types/internalDtoMapper.types';\n\nexport function transformIntoInternalDtoMapper<\n  SchemaValidator extends AnySchemaValidator,\n  DtoMapper extends Record<\n    string,\n    new (schemaValidator: SchemaValidator) =>\n      | {\n          dto: unknown;\n          _Entity: unknown;\n          serializeEntityToDto: unknown;\n        }\n      | {\n          dto: unknown;\n          _Entity: unknown;\n          deserializeDtoToEntity: unknown;\n        }\n  >,\n  Entities extends Record<keyof DtoMapper, unknown>,\n  Dto extends Record<keyof DtoMapper, unknown>\n>(\n  mapperss: DtoMapper,\n  schemaValidator: SchemaValidator\n): InternalDtoMapper<InstanceTypeRecord<DtoMapper>, Entities, Dto> {\n  return Object.fromEntries(\n    Object.entries(mapperss).map(([key, value]) => [\n      key,\n      new value(schemaValidator)\n    ])\n  ) as unknown as InternalDtoMapper<\n    InstanceTypeRecord<DtoMapper>,\n    Entities,\n    Dto\n  >;\n}\n"],"mappings":"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","names":["import_validator","import_validator"]}
+{"version":3,"sources":["../../../src/mappers/index.ts","../../../src/mappers/models/requestDtoMapper.model.ts","../../../src/mappers/models/baseDtoMapper.model.ts","../../../src/mappers/models/responseDtoMapper.model.ts","../../../src/mappers/serviceSchemaResolver.ts","../../../src/mappers/transformIntoInternalDtoMapper.ts"],"sourcesContent":["export * from './models/requestDtoMapper.model';\nexport * from './models/responseDtoMapper.model';\nexport * from './serviceSchemaResolver';\nexport * from './transformIntoInternalDtoMapper';\nexport * from './types/mappers.types';\nexport * from './types/internalDtoMapper.types';\nexport * from './types/serviceSchemaResolver.types';\n","import {\n  AnySchemaValidator,\n  prettyPrintParseErrors\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { BaseDtoMapper, construct } from './baseDtoMapper.model';\n\n/**\n * Abstract class representing a request entity mapper.\n *\n * @template Entity - A type that extends SqlBaseEntity.\n * @template SV - A type that extends AnySchemaValidator.\n * @extends {BaseDtoMapper<SV>}\n */\nexport abstract class RequestDtoMapper<\n  Entity,\n  SV extends AnySchemaValidator\n> extends BaseDtoMapper<SV> {\n  /**\n   * The entity type.\n   * @type {Entity}\n   * @protected\n   */\n  _Entity!: Entity;\n\n  /**\n   * Converts the underlying DTO to an entity.\n   *\n   * @abstract\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {Promise<Entity>} - The entity.\n   */\n  abstract toEntity(...additionalArgs: unknown[]): Promise<Entity>;\n\n  /**\n   * Populates the DTO with data from a JSON object.\n   *\n   * @param {this['_dto']} json - The JSON object.\n   * @returns {Promise<this>} - The instance of the RequestDtoMapper.\n   */\n  fromDto(json: this['_dto']): Promise<this> {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      json\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    this.dto = json;\n    return Promise.resolve(this);\n  }\n\n  /**\n   * Deserializes a JSON object to an entity.\n   *\n   * @param {this['_dto']} json - The JSON object.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {Entity} - The entity.\n   */\n  deserializeDtoToEntity(\n    json: this['_dto'],\n    ...additionalArgs: Parameters<this['toEntity']>\n  ): Promise<Entity> {\n    const result = this.fromDto(json);\n    return result.then((r) => r.toEntity(...additionalArgs));\n  }\n\n  /**\n   * Creates an instance of a RequestDtoMapper from a JSON object.\n   *\n   * @template T - A type that extends RequestDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @template JsonType - The type of the JSON object.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {JsonType} json - The JSON object.\n   * @returns {T} - An instance of the T.\n   */\n  static fromDto<\n    T extends RequestDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    JsonType extends T['_dto']\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    json: JsonType\n  ): Promise<T> {\n    return construct(this, schemaValidator).fromDto(json);\n  }\n\n  /**\n   * Deserializes a JSON object to an entity.\n   *\n   * @template T - A type that extends RequestDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @template JsonType - The type of the JSON object.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {JsonType} json - The JSON object.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {T['_Entity']} - The entity.\n   */\n  static deserializeDtoToEntity<\n    T extends RequestDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    JsonType extends T['_dto']\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    json: JsonType,\n    ...additionalArgs: Parameters<T['toEntity']>\n  ): Promise<T['_Entity']> {\n    const result = construct(this, schemaValidator).fromDto(json);\n    return result.then((r) => r.toEntity(...additionalArgs));\n  }\n}\n","import {\n  AnySchemaValidator,\n  prettyPrintParseErrors,\n  Schema,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { DtoMapperSchemaValidatorObject } from '../types/mappers.types';\n\n/**\n * Constructs an instance of a T.\n *\n * @template T - A type that extends BaseDtoMapper.\n * @template SV - A type that extends AnySchemaValidator.\n * @param {DtoMapperConstructor<T, SV>} self - The constructor of the T.\n * @param {SV} [schemaValidator] - The optional schema validator.\n * @returns {T} - An instance of the T.\n */\nexport function construct<T, SV extends AnySchemaValidator>(\n  self: DtoMapperConstructor<T, SV>,\n  schemaValidator?: SV\n): T {\n  return new self(schemaValidator || ({} as SV));\n}\n\n/**\n * Abstract class representing a base entity mapper.\n *\n * @template SV - A type that extends AnySchemaValidator.\n */\nexport abstract class BaseDtoMapper<SV extends AnySchemaValidator> {\n  /**\n   * The schema validator exact type.\n   * @type {SV}\n   * @protected\n   */\n  _SV!: SV;\n\n  /**\n   * The schema validator as a general type.\n   * @type {SchemaValidator}\n   * @protected\n   */\n  protected schemaValidator: SchemaValidator;\n\n  /**\n   * The schema definition.\n   * @type {DtoMapperSchemaValidatorObject<SV>}\n   * @abstract\n   */\n  abstract schema: DtoMapperSchemaValidatorObject<SV>;\n\n  /**\n   * The Data Transfer Object (DTO).\n   * @type {Schema<this['schema'], SV>}\n   */\n  _dto!: Schema<this['schema'], SV>;\n\n  /**\n   * Creates an instance of BaseDtoMapper.\n   *\n   * @param {SV} schemaValidator - The schema provider.\n   */\n  constructor(schemaValidator: SV) {\n    this.schemaValidator = schemaValidator as unknown as SchemaValidator;\n  }\n\n  /**\n   * Validates and sets the Data Transfer Object (DTO).\n   *\n   * @param {this['_dto']} dto - The Data Transfer Object (DTO).\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  set dto(_dto: this['_dto']) {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      _dto\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    this._dto = _dto as unknown as Schema<this['schema'], SV>;\n  }\n\n  /**\n   * Validates and gets the Data Transfer Object (DTO).\n   *\n   * @returns {this['_dto']} - The Data Transfer Object (DTO).\n   */\n  get dto(): this['_dto'] {\n    return this._dto as unknown as this['_dto'];\n  }\n\n  /**\n   * Gets the schema of a T.\n   *\n   * @template T - A type that extends BaseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @returns {T['schema']} - The schema of the T.\n   */\n  static schema<T extends BaseDtoMapper<SV>, SV extends AnySchemaValidator>(\n    this: DtoMapperConstructor<T, SV>\n  ): T['schema'] {\n    return construct(this).schema;\n  }\n}\n","import {\n  AnySchemaValidator,\n  prettyPrintParseErrors\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { BaseDtoMapper, construct } from './baseDtoMapper.model';\n\n/**\n * Abstract class representing a response entity mapper.\n *\n * @template Entity - A type that extends SqlBaseEntity.\n * @template SV - A type that extends AnySchemaValidator.\n * @extends {BaseDtoMapper<SV>}\n */\nexport abstract class ResponseDtoMapper<\n  Entity,\n  SV extends AnySchemaValidator\n> extends BaseDtoMapper<SV> {\n  /**\n   * The entity type.\n   * @type {Entity}\n   * @protected\n   */\n  _Entity!: Entity;\n\n  /**\n   * Populates entity mapper with DTO from an entity.\n   *\n   * @abstract\n   * @param {Entity} entity - The entity to convert.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {this} - The instance of the ResponseDtoMapper.\n   */\n  abstract fromEntity(\n    entity: Entity,\n    ...additionalArgs: unknown[]\n  ): Promise<this>;\n\n  /**\n   * Converts the underlying DTO to a JSON object.\n   *\n   * @returns {this['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  toDto(): Promise<this['_dto']> {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      this.dto\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    return Promise.resolve(this.dto) as unknown as Promise<this['_dto']>;\n  }\n\n  /**\n   * Serializes an entity to a JSON object.\n   *\n   * @param {Entity} entity - The entity to serialize.\n   * @returns {this['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  serializeEntityToDto(\n    ...[entity, ...additionalArgs]: Parameters<this['fromEntity']>\n  ): Promise<this['_dto']> {\n    const result = this.fromEntity(entity, ...additionalArgs);\n    return result.then((r) => r.toDto());\n  }\n\n  /**\n   * Populates entity mapper with DTO from an entity.\n   *\n   * @template T - A type that extends ResponseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {T['_Entity']} entity - The entity to convert.\n   * @returns {T} - An instance of the T.\n   */\n  static fromEntity<\n    T extends ResponseDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>\n  ): Promise<T> {\n    return construct(this, schemaValidator).fromEntity(\n      entity,\n      ...additionalArgs\n    );\n  }\n\n  /**\n   * Serializes an entity to a JSON object.\n   *\n   * @template T - A type that extends ResponseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {T['_Entity']} entity - The entity to serialize.\n   * @returns {T['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  static serializeEntityToDto<\n    T extends ResponseDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    DtoType extends T['_dto']\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>\n  ): Promise<DtoType> {\n    const result = construct(this, schemaValidator).fromEntity(\n      entity,\n      ...additionalArgs\n    );\n    return result.then((r) => r.toDto()) as Promise<DtoType>;\n  }\n}\n","import { isNever } from '@forklaunch/common';\nimport { AnySchemaValidator } from '@forklaunch/validator';\nimport { SchemasByValidator } from './types/serviceSchemaResolver.types';\n\nexport function serviceSchemaResolver<\n  Options extends Record<string, unknown>,\n  TypeBoxSchemas,\n  ZodSchemas\n>(\n  TypeBoxSchemas: (options: Options) => TypeBoxSchemas,\n  ZodSchemas: (options: Options) => ZodSchemas\n) {\n  return <SchemaValidator extends AnySchemaValidator>(\n    options: Options & { validator: SchemaValidator }\n  ): SchemasByValidator<\n    SchemaValidator,\n    (options: Options) => TypeBoxSchemas,\n    (options: Options) => ZodSchemas\n  > => {\n    switch (options.validator._Type) {\n      case 'TypeBox':\n        return TypeBoxSchemas(options) as SchemasByValidator<\n          SchemaValidator,\n          (options: Options) => TypeBoxSchemas,\n          (options: Options) => ZodSchemas\n        >;\n      case 'Zod':\n        return ZodSchemas(options) as SchemasByValidator<\n          SchemaValidator,\n          (options: Options) => TypeBoxSchemas,\n          (options: Options) => ZodSchemas\n        >;\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-ignore\n      case 'Mock':\n        throw new Error('Mock schema validator not supported');\n      default:\n        isNever(options.validator._Type);\n        throw new Error('Invalid schema validator');\n    }\n  };\n}\n","import { InstanceTypeRecord } from '@forklaunch/common';\nimport { AnySchemaValidator } from '@forklaunch/validator';\nimport { InternalDtoMapper } from './types/internalDtoMapper.types';\n\nexport function transformIntoInternalDtoMapper<\n  SchemaValidator extends AnySchemaValidator,\n  DtoMapper extends Record<\n    string,\n    new (schemaValidator: SchemaValidator) =>\n      | {\n          dto: unknown;\n          _Entity: unknown;\n          serializeEntityToDto: unknown;\n        }\n      | {\n          dto: unknown;\n          _Entity: unknown;\n          deserializeDtoToEntity: unknown;\n        }\n  >,\n  Entities extends Record<keyof DtoMapper, unknown>,\n  Dto extends Record<keyof DtoMapper, unknown>\n>(\n  mapperss: DtoMapper,\n  schemaValidator: SchemaValidator\n): InternalDtoMapper<InstanceTypeRecord<DtoMapper>, Entities, Dto> {\n  return Object.fromEntries(\n    Object.entries(mapperss).map(([key, value]) => [\n      key,\n      new value(schemaValidator)\n    ])\n  ) as unknown as InternalDtoMapper<\n    InstanceTypeRecord<DtoMapper>,\n    Entities,\n    Dto\n  >;\n}\n"],"mappings":"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","names":["import_validator","import_validator"]}

package/lib/src/mappers/index.mjs

@@ -27,7 +27,7 @@ var BaseDtoMapper = class {
    * The Data Transfer Object (DTO).
    * @type {Schema<this['schema'], SV>}
    */
-  _dto = {};
+  _dto;
   /**
    * Creates an instance of BaseDtoMapper.
    *
@@ -85,7 +85,7 @@ var RequestDtoMapper = class extends BaseDtoMapper {
    * Populates the DTO with data from a JSON object.
    *
    * @param {this['_dto']} json - The JSON object.
-   * @returns {this} - The instance of the RequestDtoMapper.
+   * @returns {Promise<this>} - The instance of the RequestDtoMapper.
    */
   fromDto(json) {
     const parsedSchema = this.schemaValidator.parse(
@@ -96,7 +96,7 @@ var RequestDtoMapper = class extends BaseDtoMapper {
       throw new Error(prettyPrintParseErrors2(parsedSchema.errors, "DTO"));
     }
     this.dto = json;
-    return this;
+    return Promise.resolve(this);
   }
   /**
    * Deserializes a JSON object to an entity.
@@ -106,7 +106,8 @@ var RequestDtoMapper = class extends BaseDtoMapper {
    * @returns {Entity} - The entity.
    */
   deserializeDtoToEntity(json, ...additionalArgs) {
-    return this.fromDto(json).toEntity(...additionalArgs);
+    const result = this.fromDto(json);
+    return result.then((r) => r.toEntity(...additionalArgs));
   }
   /**
    * Creates an instance of a RequestDtoMapper from a JSON object.
@@ -135,7 +136,8 @@ var RequestDtoMapper = class extends BaseDtoMapper {
    * @returns {T['_Entity']} - The entity.
    */
   static deserializeDtoToEntity(schemaValidator, json, ...additionalArgs) {
-    return construct(this, schemaValidator).fromDto(json).toEntity(...additionalArgs);
+    const result = construct(this, schemaValidator).fromDto(json);
+    return result.then((r) => r.toEntity(...additionalArgs));
   }
 };
 
@@ -164,7 +166,7 @@ var ResponseDtoMapper = class extends BaseDtoMapper {
     if (!parsedSchema.ok) {
       throw new Error(prettyPrintParseErrors3(parsedSchema.errors, "DTO"));
     }
-    return this.dto;
+    return Promise.resolve(this.dto);
   }
   /**
    * Serializes an entity to a JSON object.
@@ -174,7 +176,8 @@ var ResponseDtoMapper = class extends BaseDtoMapper {
    * @throws {Error} - Throws an error if the DTO is invalid.
    */
   serializeEntityToDto(...[entity, ...additionalArgs]) {
-    return this.fromEntity(entity, ...additionalArgs).toDto();
+    const result = this.fromEntity(entity, ...additionalArgs);
+    return result.then((r) => r.toDto());
   }
   /**
    * Populates entity mapper with DTO from an entity.
@@ -204,7 +207,11 @@ var ResponseDtoMapper = class extends BaseDtoMapper {
    * @throws {Error} - Throws an error if the DTO is invalid.
    */
   static serializeEntityToDto(schemaValidator, ...[entity, ...additionalArgs]) {
-    return construct(this, schemaValidator).fromEntity(entity, ...additionalArgs).toDto();
+    const result = construct(this, schemaValidator).fromEntity(
+      entity,
+      ...additionalArgs
+    );
+    return result.then((r) => r.toDto());
   }
 };
 

package/lib/src/mappers/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/mappers/models/requestDtoMapper.model.ts","../../../src/mappers/models/baseDtoMapper.model.ts","../../../src/mappers/models/responseDtoMapper.model.ts","../../../src/mappers/serviceSchemaResolver.ts","../../../src/mappers/transformIntoInternalDtoMapper.ts"],"sourcesContent":["import {\n  AnySchemaValidator,\n  prettyPrintParseErrors\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { BaseDtoMapper, construct } from './baseDtoMapper.model';\n\n/**\n * Abstract class representing a request entity mapper.\n *\n * @template Entity - A type that extends SqlBaseEntity.\n * @template SV - A type that extends AnySchemaValidator.\n * @extends {BaseDtoMapper<SV>}\n */\nexport abstract class RequestDtoMapper<\n  Entity,\n  SV extends AnySchemaValidator\n> extends BaseDtoMapper<SV> {\n  /**\n   * The entity type.\n   * @type {Entity}\n   * @protected\n   */\n  _Entity!: Entity;\n\n  /**\n   * Converts the underlying DTO to an entity.\n   *\n   * @abstract\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {Entity} - The entity.\n   */\n  abstract toEntity(...additionalArgs: unknown[]): Entity;\n\n  /**\n   * Populates the DTO with data from a JSON object.\n   *\n   * @param {this['_dto']} json - The JSON object.\n   * @returns {this} - The instance of the RequestDtoMapper.\n   */\n  fromDto(json: this['_dto']): this {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      json\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    this.dto = json;\n    return this;\n  }\n\n  /**\n   * Deserializes a JSON object to an entity.\n   *\n   * @param {this['_dto']} json - The JSON object.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {Entity} - The entity.\n   */\n  deserializeDtoToEntity(\n    json: this['_dto'],\n    ...additionalArgs: Parameters<this['toEntity']>\n  ): Entity {\n    return this.fromDto(json).toEntity(...additionalArgs);\n  }\n\n  /**\n   * Creates an instance of a RequestDtoMapper from a JSON object.\n   *\n   * @template T - A type that extends RequestDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @template JsonType - The type of the JSON object.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {JsonType} json - The JSON object.\n   * @returns {T} - An instance of the T.\n   */\n  static fromDto<\n    T extends RequestDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    JsonType extends T['_dto']\n  >(this: DtoMapperConstructor<T, SV>, schemaValidator: SV, json: JsonType): T {\n    return construct(this, schemaValidator).fromDto(json);\n  }\n\n  /**\n   * Deserializes a JSON object to an entity.\n   *\n   * @template T - A type that extends RequestDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @template JsonType - The type of the JSON object.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {JsonType} json - The JSON object.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {T['_Entity']} - The entity.\n   */\n  static deserializeDtoToEntity<\n    T extends RequestDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    JsonType extends T['_dto']\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    json: JsonType,\n    ...additionalArgs: Parameters<T['toEntity']>\n  ): T['_Entity'] {\n    return construct(this, schemaValidator)\n      .fromDto(json)\n      .toEntity(...additionalArgs);\n  }\n}\n","import {\n  AnySchemaValidator,\n  prettyPrintParseErrors,\n  Schema,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { DtoMapperSchemaValidatorObject } from '../types/mappers.types';\n\n/**\n * Constructs an instance of a T.\n *\n * @template T - A type that extends BaseDtoMapper.\n * @template SV - A type that extends AnySchemaValidator.\n * @param {DtoMapperConstructor<T, SV>} self - The constructor of the T.\n * @param {SV} [schemaValidator] - The optional schema validator.\n * @returns {T} - An instance of the T.\n */\nexport function construct<T, SV extends AnySchemaValidator>(\n  self: DtoMapperConstructor<T, SV>,\n  schemaValidator?: SV\n): T {\n  return new self(schemaValidator || ({} as SV));\n}\n\n/**\n * Abstract class representing a base entity mapper.\n *\n * @template SV - A type that extends AnySchemaValidator.\n */\nexport abstract class BaseDtoMapper<SV extends AnySchemaValidator> {\n  /**\n   * The schema validator exact type.\n   * @type {SV}\n   * @protected\n   */\n  _SV!: SV;\n\n  /**\n   * The schema validator as a general type.\n   * @type {SchemaValidator}\n   * @protected\n   */\n  protected schemaValidator: SchemaValidator;\n\n  /**\n   * The schema definition.\n   * @type {DtoMapperSchemaValidatorObject<SV>}\n   * @abstract\n   */\n  abstract schema: DtoMapperSchemaValidatorObject<SV>;\n\n  /**\n   * The Data Transfer Object (DTO).\n   * @type {Schema<this['schema'], SV>}\n   */\n  _dto: Schema<this['schema'], SV> = {} as unknown as Schema<\n    this['schema'],\n    SV\n  >;\n\n  /**\n   * Creates an instance of BaseDtoMapper.\n   *\n   * @param {SV} schemaValidator - The schema provider.\n   */\n  constructor(schemaValidator: SV) {\n    this.schemaValidator = schemaValidator as unknown as SchemaValidator;\n  }\n\n  /**\n   * Validates and sets the Data Transfer Object (DTO).\n   *\n   * @param {this['_dto']} dto - The Data Transfer Object (DTO).\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  set dto(_dto: this['_dto']) {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      _dto\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    this._dto = _dto as unknown as Schema<this['schema'], SV>;\n  }\n\n  /**\n   * Validates and gets the Data Transfer Object (DTO).\n   *\n   * @returns {this['_dto']} - The Data Transfer Object (DTO).\n   */\n  get dto(): this['_dto'] {\n    return this._dto as unknown as this['_dto'];\n  }\n\n  /**\n   * Gets the schema of a T.\n   *\n   * @template T - A type that extends BaseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @returns {T['schema']} - The schema of the T.\n   */\n  static schema<T extends BaseDtoMapper<SV>, SV extends AnySchemaValidator>(\n    this: DtoMapperConstructor<T, SV>\n  ): T['schema'] {\n    return construct(this).schema;\n  }\n}\n","import {\n  AnySchemaValidator,\n  prettyPrintParseErrors\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { BaseDtoMapper, construct } from './baseDtoMapper.model';\n\n/**\n * Abstract class representing a response entity mapper.\n *\n * @template Entity - A type that extends SqlBaseEntity.\n * @template SV - A type that extends AnySchemaValidator.\n * @extends {BaseDtoMapper<SV>}\n */\nexport abstract class ResponseDtoMapper<\n  Entity,\n  SV extends AnySchemaValidator\n> extends BaseDtoMapper<SV> {\n  /**\n   * The entity type.\n   * @type {Entity}\n   * @protected\n   */\n  _Entity!: Entity;\n\n  /**\n   * Populates entity mapper with DTO from an entity.\n   *\n   * @abstract\n   * @param {Entity} entity - The entity to convert.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {this} - The instance of the ResponseDtoMapper.\n   */\n  abstract fromEntity(entity: Entity, ...additionalArgs: unknown[]): this;\n\n  /**\n   * Converts the underlying DTO to a JSON object.\n   *\n   * @returns {this['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  toDto(): this['_dto'] {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      this.dto\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    return this.dto;\n  }\n\n  /**\n   * Serializes an entity to a JSON object.\n   *\n   * @param {Entity} entity - The entity to serialize.\n   * @returns {this['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  serializeEntityToDto(\n    ...[entity, ...additionalArgs]: Parameters<this['fromEntity']>\n  ): this['_dto'] {\n    return this.fromEntity(entity, ...additionalArgs).toDto();\n  }\n\n  /**\n   * Populates entity mapper with DTO from an entity.\n   *\n   * @template T - A type that extends ResponseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {T['_Entity']} entity - The entity to convert.\n   * @returns {T} - An instance of the T.\n   */\n  static fromEntity<\n    T extends ResponseDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>\n  ): T {\n    return construct(this, schemaValidator).fromEntity(\n      entity,\n      ...additionalArgs\n    );\n  }\n\n  /**\n   * Serializes an entity to a JSON object.\n   *\n   * @template T - A type that extends ResponseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {T['_Entity']} entity - The entity to serialize.\n   * @returns {T['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  static serializeEntityToDto<\n    T extends ResponseDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    DtoType extends T['_dto']\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>\n  ): DtoType {\n    return construct(this, schemaValidator)\n      .fromEntity(entity, ...additionalArgs)\n      .toDto() as DtoType;\n  }\n}\n","import { isNever } from '@forklaunch/common';\nimport { AnySchemaValidator } from '@forklaunch/validator';\nimport { SchemasByValidator } from './types/serviceSchemaResolver.types';\n\nexport function serviceSchemaResolver<\n  Options extends Record<string, unknown>,\n  TypeBoxSchemas,\n  ZodSchemas\n>(\n  TypeBoxSchemas: (options: Options) => TypeBoxSchemas,\n  ZodSchemas: (options: Options) => ZodSchemas\n) {\n  return <SchemaValidator extends AnySchemaValidator>(\n    options: Options & { validator: SchemaValidator }\n  ): SchemasByValidator<\n    SchemaValidator,\n    (options: Options) => TypeBoxSchemas,\n    (options: Options) => ZodSchemas\n  > => {\n    switch (options.validator._Type) {\n      case 'TypeBox':\n        return TypeBoxSchemas(options) as SchemasByValidator<\n          SchemaValidator,\n          (options: Options) => TypeBoxSchemas,\n          (options: Options) => ZodSchemas\n        >;\n      case 'Zod':\n        return ZodSchemas(options) as SchemasByValidator<\n          SchemaValidator,\n          (options: Options) => TypeBoxSchemas,\n          (options: Options) => ZodSchemas\n        >;\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-ignore\n      case 'Mock':\n        throw new Error('Mock schema validator not supported');\n      default:\n        isNever(options.validator._Type);\n        throw new Error('Invalid schema validator');\n    }\n  };\n}\n","import { InstanceTypeRecord } from '@forklaunch/common';\nimport { AnySchemaValidator } from '@forklaunch/validator';\nimport { InternalDtoMapper } from './types/internalDtoMapper.types';\n\nexport function transformIntoInternalDtoMapper<\n  SchemaValidator extends AnySchemaValidator,\n  DtoMapper extends Record<\n    string,\n    new (schemaValidator: SchemaValidator) =>\n      | {\n          dto: unknown;\n          _Entity: unknown;\n          serializeEntityToDto: unknown;\n        }\n      | {\n          dto: unknown;\n          _Entity: unknown;\n          deserializeDtoToEntity: unknown;\n        }\n  >,\n  Entities extends Record<keyof DtoMapper, unknown>,\n  Dto extends Record<keyof DtoMapper, unknown>\n>(\n  mapperss: DtoMapper,\n  schemaValidator: SchemaValidator\n): InternalDtoMapper<InstanceTypeRecord<DtoMapper>, Entities, Dto> {\n  return Object.fromEntries(\n    Object.entries(mapperss).map(([key, value]) => [\n      key,\n      new value(schemaValidator)\n    ])\n  ) as unknown as InternalDtoMapper<\n    InstanceTypeRecord<DtoMapper>,\n    Entities,\n    Dto\n  >;\n}\n"],"mappings":"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","names":["prettyPrintParseErrors","prettyPrintParseErrors","prettyPrintParseErrors","prettyPrintParseErrors"]}
+{"version":3,"sources":["../../../src/mappers/models/requestDtoMapper.model.ts","../../../src/mappers/models/baseDtoMapper.model.ts","../../../src/mappers/models/responseDtoMapper.model.ts","../../../src/mappers/serviceSchemaResolver.ts","../../../src/mappers/transformIntoInternalDtoMapper.ts"],"sourcesContent":["import {\n  AnySchemaValidator,\n  prettyPrintParseErrors\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { BaseDtoMapper, construct } from './baseDtoMapper.model';\n\n/**\n * Abstract class representing a request entity mapper.\n *\n * @template Entity - A type that extends SqlBaseEntity.\n * @template SV - A type that extends AnySchemaValidator.\n * @extends {BaseDtoMapper<SV>}\n */\nexport abstract class RequestDtoMapper<\n  Entity,\n  SV extends AnySchemaValidator\n> extends BaseDtoMapper<SV> {\n  /**\n   * The entity type.\n   * @type {Entity}\n   * @protected\n   */\n  _Entity!: Entity;\n\n  /**\n   * Converts the underlying DTO to an entity.\n   *\n   * @abstract\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {Promise<Entity>} - The entity.\n   */\n  abstract toEntity(...additionalArgs: unknown[]): Promise<Entity>;\n\n  /**\n   * Populates the DTO with data from a JSON object.\n   *\n   * @param {this['_dto']} json - The JSON object.\n   * @returns {Promise<this>} - The instance of the RequestDtoMapper.\n   */\n  fromDto(json: this['_dto']): Promise<this> {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      json\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    this.dto = json;\n    return Promise.resolve(this);\n  }\n\n  /**\n   * Deserializes a JSON object to an entity.\n   *\n   * @param {this['_dto']} json - The JSON object.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {Entity} - The entity.\n   */\n  deserializeDtoToEntity(\n    json: this['_dto'],\n    ...additionalArgs: Parameters<this['toEntity']>\n  ): Promise<Entity> {\n    const result = this.fromDto(json);\n    return result.then((r) => r.toEntity(...additionalArgs));\n  }\n\n  /**\n   * Creates an instance of a RequestDtoMapper from a JSON object.\n   *\n   * @template T - A type that extends RequestDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @template JsonType - The type of the JSON object.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {JsonType} json - The JSON object.\n   * @returns {T} - An instance of the T.\n   */\n  static fromDto<\n    T extends RequestDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    JsonType extends T['_dto']\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    json: JsonType\n  ): Promise<T> {\n    return construct(this, schemaValidator).fromDto(json);\n  }\n\n  /**\n   * Deserializes a JSON object to an entity.\n   *\n   * @template T - A type that extends RequestDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @template JsonType - The type of the JSON object.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {JsonType} json - The JSON object.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {T['_Entity']} - The entity.\n   */\n  static deserializeDtoToEntity<\n    T extends RequestDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    JsonType extends T['_dto']\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    json: JsonType,\n    ...additionalArgs: Parameters<T['toEntity']>\n  ): Promise<T['_Entity']> {\n    const result = construct(this, schemaValidator).fromDto(json);\n    return result.then((r) => r.toEntity(...additionalArgs));\n  }\n}\n","import {\n  AnySchemaValidator,\n  prettyPrintParseErrors,\n  Schema,\n  SchemaValidator\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { DtoMapperSchemaValidatorObject } from '../types/mappers.types';\n\n/**\n * Constructs an instance of a T.\n *\n * @template T - A type that extends BaseDtoMapper.\n * @template SV - A type that extends AnySchemaValidator.\n * @param {DtoMapperConstructor<T, SV>} self - The constructor of the T.\n * @param {SV} [schemaValidator] - The optional schema validator.\n * @returns {T} - An instance of the T.\n */\nexport function construct<T, SV extends AnySchemaValidator>(\n  self: DtoMapperConstructor<T, SV>,\n  schemaValidator?: SV\n): T {\n  return new self(schemaValidator || ({} as SV));\n}\n\n/**\n * Abstract class representing a base entity mapper.\n *\n * @template SV - A type that extends AnySchemaValidator.\n */\nexport abstract class BaseDtoMapper<SV extends AnySchemaValidator> {\n  /**\n   * The schema validator exact type.\n   * @type {SV}\n   * @protected\n   */\n  _SV!: SV;\n\n  /**\n   * The schema validator as a general type.\n   * @type {SchemaValidator}\n   * @protected\n   */\n  protected schemaValidator: SchemaValidator;\n\n  /**\n   * The schema definition.\n   * @type {DtoMapperSchemaValidatorObject<SV>}\n   * @abstract\n   */\n  abstract schema: DtoMapperSchemaValidatorObject<SV>;\n\n  /**\n   * The Data Transfer Object (DTO).\n   * @type {Schema<this['schema'], SV>}\n   */\n  _dto!: Schema<this['schema'], SV>;\n\n  /**\n   * Creates an instance of BaseDtoMapper.\n   *\n   * @param {SV} schemaValidator - The schema provider.\n   */\n  constructor(schemaValidator: SV) {\n    this.schemaValidator = schemaValidator as unknown as SchemaValidator;\n  }\n\n  /**\n   * Validates and sets the Data Transfer Object (DTO).\n   *\n   * @param {this['_dto']} dto - The Data Transfer Object (DTO).\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  set dto(_dto: this['_dto']) {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      _dto\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    this._dto = _dto as unknown as Schema<this['schema'], SV>;\n  }\n\n  /**\n   * Validates and gets the Data Transfer Object (DTO).\n   *\n   * @returns {this['_dto']} - The Data Transfer Object (DTO).\n   */\n  get dto(): this['_dto'] {\n    return this._dto as unknown as this['_dto'];\n  }\n\n  /**\n   * Gets the schema of a T.\n   *\n   * @template T - A type that extends BaseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @returns {T['schema']} - The schema of the T.\n   */\n  static schema<T extends BaseDtoMapper<SV>, SV extends AnySchemaValidator>(\n    this: DtoMapperConstructor<T, SV>\n  ): T['schema'] {\n    return construct(this).schema;\n  }\n}\n","import {\n  AnySchemaValidator,\n  prettyPrintParseErrors\n} from '@forklaunch/validator';\nimport { DtoMapperConstructor } from '../interfaces/mappers.interface';\nimport { BaseDtoMapper, construct } from './baseDtoMapper.model';\n\n/**\n * Abstract class representing a response entity mapper.\n *\n * @template Entity - A type that extends SqlBaseEntity.\n * @template SV - A type that extends AnySchemaValidator.\n * @extends {BaseDtoMapper<SV>}\n */\nexport abstract class ResponseDtoMapper<\n  Entity,\n  SV extends AnySchemaValidator\n> extends BaseDtoMapper<SV> {\n  /**\n   * The entity type.\n   * @type {Entity}\n   * @protected\n   */\n  _Entity!: Entity;\n\n  /**\n   * Populates entity mapper with DTO from an entity.\n   *\n   * @abstract\n   * @param {Entity} entity - The entity to convert.\n   * @param {...unknown[]} additionalArgs - Additional arguments.\n   * @returns {this} - The instance of the ResponseDtoMapper.\n   */\n  abstract fromEntity(\n    entity: Entity,\n    ...additionalArgs: unknown[]\n  ): Promise<this>;\n\n  /**\n   * Converts the underlying DTO to a JSON object.\n   *\n   * @returns {this['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  toDto(): Promise<this['_dto']> {\n    const parsedSchema = this.schemaValidator.parse(\n      this.schemaValidator.schemify(this.schema),\n      this.dto\n    );\n    if (!parsedSchema.ok) {\n      throw new Error(prettyPrintParseErrors(parsedSchema.errors, 'DTO'));\n    }\n    return Promise.resolve(this.dto) as unknown as Promise<this['_dto']>;\n  }\n\n  /**\n   * Serializes an entity to a JSON object.\n   *\n   * @param {Entity} entity - The entity to serialize.\n   * @returns {this['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  serializeEntityToDto(\n    ...[entity, ...additionalArgs]: Parameters<this['fromEntity']>\n  ): Promise<this['_dto']> {\n    const result = this.fromEntity(entity, ...additionalArgs);\n    return result.then((r) => r.toDto());\n  }\n\n  /**\n   * Populates entity mapper with DTO from an entity.\n   *\n   * @template T - A type that extends ResponseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {T['_Entity']} entity - The entity to convert.\n   * @returns {T} - An instance of the T.\n   */\n  static fromEntity<\n    T extends ResponseDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>\n  ): Promise<T> {\n    return construct(this, schemaValidator).fromEntity(\n      entity,\n      ...additionalArgs\n    );\n  }\n\n  /**\n   * Serializes an entity to a JSON object.\n   *\n   * @template T - A type that extends ResponseDtoMapper.\n   * @template SV - A type that extends AnySchemaValidator.\n   * @param {DtoMapperConstructor<T, SV>} this - The constructor of the T.\n   * @param {SV} schemaValidator - The schema provider.\n   * @param {T['_Entity']} entity - The entity to serialize.\n   * @returns {T['_dto']} - The JSON object.\n   * @throws {Error} - Throws an error if the DTO is invalid.\n   */\n  static serializeEntityToDto<\n    T extends ResponseDtoMapper<unknown, SV>,\n    SV extends AnySchemaValidator,\n    DtoType extends T['_dto']\n  >(\n    this: DtoMapperConstructor<T, SV>,\n    schemaValidator: SV,\n    ...[entity, ...additionalArgs]: Parameters<T['fromEntity']>\n  ): Promise<DtoType> {\n    const result = construct(this, schemaValidator).fromEntity(\n      entity,\n      ...additionalArgs\n    );\n    return result.then((r) => r.toDto()) as Promise<DtoType>;\n  }\n}\n","import { isNever } from '@forklaunch/common';\nimport { AnySchemaValidator } from '@forklaunch/validator';\nimport { SchemasByValidator } from './types/serviceSchemaResolver.types';\n\nexport function serviceSchemaResolver<\n  Options extends Record<string, unknown>,\n  TypeBoxSchemas,\n  ZodSchemas\n>(\n  TypeBoxSchemas: (options: Options) => TypeBoxSchemas,\n  ZodSchemas: (options: Options) => ZodSchemas\n) {\n  return <SchemaValidator extends AnySchemaValidator>(\n    options: Options & { validator: SchemaValidator }\n  ): SchemasByValidator<\n    SchemaValidator,\n    (options: Options) => TypeBoxSchemas,\n    (options: Options) => ZodSchemas\n  > => {\n    switch (options.validator._Type) {\n      case 'TypeBox':\n        return TypeBoxSchemas(options) as SchemasByValidator<\n          SchemaValidator,\n          (options: Options) => TypeBoxSchemas,\n          (options: Options) => ZodSchemas\n        >;\n      case 'Zod':\n        return ZodSchemas(options) as SchemasByValidator<\n          SchemaValidator,\n          (options: Options) => TypeBoxSchemas,\n          (options: Options) => ZodSchemas\n        >;\n      // eslint-disable-next-line @typescript-eslint/ban-ts-comment\n      // @ts-ignore\n      case 'Mock':\n        throw new Error('Mock schema validator not supported');\n      default:\n        isNever(options.validator._Type);\n        throw new Error('Invalid schema validator');\n    }\n  };\n}\n","import { InstanceTypeRecord } from '@forklaunch/common';\nimport { AnySchemaValidator } from '@forklaunch/validator';\nimport { InternalDtoMapper } from './types/internalDtoMapper.types';\n\nexport function transformIntoInternalDtoMapper<\n  SchemaValidator extends AnySchemaValidator,\n  DtoMapper extends Record<\n    string,\n    new (schemaValidator: SchemaValidator) =>\n      | {\n          dto: unknown;\n          _Entity: unknown;\n          serializeEntityToDto: unknown;\n        }\n      | {\n          dto: unknown;\n          _Entity: unknown;\n          deserializeDtoToEntity: unknown;\n        }\n  >,\n  Entities extends Record<keyof DtoMapper, unknown>,\n  Dto extends Record<keyof DtoMapper, unknown>\n>(\n  mapperss: DtoMapper,\n  schemaValidator: SchemaValidator\n): InternalDtoMapper<InstanceTypeRecord<DtoMapper>, Entities, Dto> {\n  return Object.fromEntries(\n    Object.entries(mapperss).map(([key, value]) => [\n      key,\n      new value(schemaValidator)\n    ])\n  ) as unknown as InternalDtoMapper<\n    InstanceTypeRecord<DtoMapper>,\n    Entities,\n    Dto\n  >;\n}\n"],"mappings":"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","names":["prettyPrintParseErrors","prettyPrintParseErrors","prettyPrintParseErrors","prettyPrintParseErrors"]}

package/lib/src/persistence/index.d.mts

@@ -57,7 +57,7 @@ declare abstract class BaseEntity extends BaseEntity$1 {
      * @param {...Parameters<Entity['create']>} args - Arguments for entity creation
      * @returns {Entity} A new entity instance
      */
-    static create<Entity extends BaseEntityWithId>(this: Constructor<Entity>, ...args: Parameters<Entity['create']>): Entity;
+    static create<Entity extends BaseEntityWithId>(this: Constructor<Entity>, ...args: Parameters<Entity['create']>): Promise<Entity>;
     /**
      * Static method to update an entity instance.
      *
@@ -66,7 +66,7 @@ declare abstract class BaseEntity extends BaseEntity$1 {
      * @param {...Parameters<Entity['update']>} args - Arguments for entity update
      * @returns {Entity} The updated entity instance
      */
-    static update<Entity extends BaseEntityWithId>(this: Constructor<Entity>, ...args: Parameters<Entity['update']>): Entity;
+    static update<Entity extends BaseEntityWithId>(this: Constructor<Entity>, ...args: Parameters<Entity['update']>): Promise<Entity>;
     /**
      * Static method to map data to an entity instance.
      *
@@ -75,34 +75,34 @@ declare abstract class BaseEntity extends BaseEntity$1 {
      * @param {Partial<EntityDTO<FromEntityType<Entity>>>} data - The data to map
      * @returns {Entity} A new entity instance with mapped data
      */
-    static map<Entity extends BaseEntity>(this: Constructor<Entity>, data: Partial<EntityDTO<FromEntityType<Entity>>>): Entity;
+    static map<Entity extends BaseEntity>(this: Constructor<Entity>, data: Partial<EntityDTO<FromEntityType<Entity>>>): Promise<Entity>;
     /**
      * Creates a new entity instance with the provided data.
      *
      * @param {CreateShape<BaseEntityWithId, this>} data - The data to create the entity with
      * @returns {this} The created entity instance
      */
-    create(data: CreateShape<BaseEntityWithId, this>): this;
+    create(data: CreateShape<BaseEntityWithId, this>): Promise<EntityDTO<this>>;
     /**
      * Updates the entity instance with the provided data.
      *
      * @param {UpdateShape<BaseEntityWithId, this>} data - The data to update the entity with
      * @returns {this} The updated entity instance
      */
-    update(data: UpdateShape<BaseEntityWithId, this>): this;
+    update(data: UpdateShape<BaseEntityWithId, this>): Promise<EntityDTO<this>>;
     /**
      * Reads the entity data as a plain object.
      *
      * @returns {EntityDTO<this> | this} The entity data as a plain object
      */
-    read(): EntityDTO<this> | this;
+    read(): Promise<EntityDTO<this>>;
     /**
      * Maps data to the entity instance.
      *
      * @param {Partial<EntityDTO<FromEntityType<this>>>} data - The data to map
      * @returns {this} The entity instance with mapped data
      */
-    map(data: Partial<EntityDTO<FromEntityType<this>>>): this;
+    map(data: Partial<EntityDTO<FromEntityType<this>>>): Promise<this>;
 }
 
 /**

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

@@ -57,7 +57,7 @@ declare abstract class BaseEntity extends BaseEntity$1 {
      * @param {...Parameters<Entity['create']>} args - Arguments for entity creation
      * @returns {Entity} A new entity instance
      */
-    static create<Entity extends BaseEntityWithId>(this: Constructor<Entity>, ...args: Parameters<Entity['create']>): Entity;
+    static create<Entity extends BaseEntityWithId>(this: Constructor<Entity>, ...args: Parameters<Entity['create']>): Promise<Entity>;
     /**
      * Static method to update an entity instance.
      *
@@ -66,7 +66,7 @@ declare abstract class BaseEntity extends BaseEntity$1 {
      * @param {...Parameters<Entity['update']>} args - Arguments for entity update
      * @returns {Entity} The updated entity instance
      */
-    static update<Entity extends BaseEntityWithId>(this: Constructor<Entity>, ...args: Parameters<Entity['update']>): Entity;
+    static update<Entity extends BaseEntityWithId>(this: Constructor<Entity>, ...args: Parameters<Entity['update']>): Promise<Entity>;
     /**
      * Static method to map data to an entity instance.
      *
@@ -75,34 +75,34 @@ declare abstract class BaseEntity extends BaseEntity$1 {
      * @param {Partial<EntityDTO<FromEntityType<Entity>>>} data - The data to map
      * @returns {Entity} A new entity instance with mapped data
      */
-    static map<Entity extends BaseEntity>(this: Constructor<Entity>, data: Partial<EntityDTO<FromEntityType<Entity>>>): Entity;
+    static map<Entity extends BaseEntity>(this: Constructor<Entity>, data: Partial<EntityDTO<FromEntityType<Entity>>>): Promise<Entity>;
     /**
      * Creates a new entity instance with the provided data.
      *
      * @param {CreateShape<BaseEntityWithId, this>} data - The data to create the entity with
      * @returns {this} The created entity instance
      */
-    create(data: CreateShape<BaseEntityWithId, this>): this;
+    create(data: CreateShape<BaseEntityWithId, this>): Promise<EntityDTO<this>>;
     /**
      * Updates the entity instance with the provided data.
      *
      * @param {UpdateShape<BaseEntityWithId, this>} data - The data to update the entity with
      * @returns {this} The updated entity instance
      */
-    update(data: UpdateShape<BaseEntityWithId, this>): this;
+    update(data: UpdateShape<BaseEntityWithId, this>): Promise<EntityDTO<this>>;
     /**
      * Reads the entity data as a plain object.
      *
      * @returns {EntityDTO<this> | this} The entity data as a plain object
      */
-    read(): EntityDTO<this> | this;
+    read(): Promise<EntityDTO<this>>;
     /**
      * Maps data to the entity instance.
      *
      * @param {Partial<EntityDTO<FromEntityType<this>>>} data - The data to map
      * @returns {this} The entity instance with mapped data
      */
-    map(data: Partial<EntityDTO<FromEntityType<this>>>): this;
+    map(data: Partial<EntityDTO<FromEntityType<this>>>): Promise<this>;
 }
 
 /**

package/lib/src/persistence/index.js

@@ -60,12 +60,14 @@ var BaseEntity2 = class extends import_core2.BaseEntity {
    * @param {...Parameters<Entity['create']>} args - Arguments for entity creation
    * @returns {Entity} A new entity instance
    */
-  static create(...args) {
+  static async create(...args) {
     const [data, ...additionalArgs] = args;
-    return new this().create(
+    const entity = new this();
+    await entity.create(
       data,
       ...additionalArgs
     );
+    return entity;
   }
   /**
    * Static method to update an entity instance.
@@ -75,12 +77,14 @@ var BaseEntity2 = class extends import_core2.BaseEntity {
    * @param {...Parameters<Entity['update']>} args - Arguments for entity update
    * @returns {Entity} The updated entity instance
    */
-  static update(...args) {
+  static async update(...args) {
     const [data, ...additionalArgs] = args;
-    return new this().update(
+    const entity = new this();
+    await entity.update(
       data,
       ...additionalArgs
     );
+    return entity;
   }
   /**
    * Static method to map data to an entity instance.
@@ -90,8 +94,10 @@ var BaseEntity2 = class extends import_core2.BaseEntity {
    * @param {Partial<EntityDTO<FromEntityType<Entity>>>} data - The data to map
    * @returns {Entity} A new entity instance with mapped data
    */
-  static map(data) {
-    return new this().map(data);
+  static async map(data) {
+    const entity = new this();
+    await entity.map(data);
+    return entity;
   }
   /**
    * Creates a new entity instance with the provided data.
@@ -99,8 +105,13 @@ var BaseEntity2 = class extends import_core2.BaseEntity {
    * @param {CreateShape<BaseEntityWithId, this>} data - The data to create the entity with
    * @returns {this} The created entity instance
    */
-  create(data) {
-    return Object.assign(this, transformRawDto(data, this));
+  async create(data) {
+    Object.assign(this, transformRawDto(data, this));
+    const entity = await (0, import_core2.wrap)(this).init();
+    if (!entity) {
+      throw new Error("Entity not initialized");
+    }
+    return entity.toObject();
   }
   /**
    * Updates the entity instance with the provided data.
@@ -108,22 +119,24 @@ var BaseEntity2 = class extends import_core2.BaseEntity {
    * @param {UpdateShape<BaseEntityWithId, this>} data - The data to update the entity with
    * @returns {this} The updated entity instance
    */
-  update(data) {
-    (0, import_core2.wrap)(this).assign(
+  async update(data) {
+    const entity = (0, import_core2.wrap)(this);
+    entity.assign(
       (0, import_common.stripUndefinedProperties)(transformRawDto(data, this))
     );
-    return this;
+    return entity.toObject();
   }
   /**
    * Reads the entity data as a plain object.
    *
    * @returns {EntityDTO<this> | this} The entity data as a plain object
    */
-  read() {
-    if (typeof (0, import_core2.wrap)(this).toPOJO === "function") {
-      return (0, import_core2.wrap)(this).toPOJO();
+  async read() {
+    const entity = await (0, import_core2.wrap)(this).init();
+    if (!entity) {
+      throw new Error("Entity not initialized");
     }
-    return this;
+    return entity.toObject();
   }
   /**
    * Maps data to the entity instance.
@@ -131,9 +144,13 @@ var BaseEntity2 = class extends import_core2.BaseEntity {
    * @param {Partial<EntityDTO<FromEntityType<this>>>} data - The data to map
    * @returns {this} The entity instance with mapped data
    */
-  map(data) {
-    (0, import_core2.wrap)(this).assign(data);
-    return this;
+  async map(data) {
+    const entity = await (0, import_core2.wrap)(this).init();
+    if (!entity) {
+      throw new Error("Entity not initialized");
+    }
+    entity.assign(data);
+    return entity;
   }
 };
 

package/lib/src/persistence/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/persistence/index.ts","../../../src/persistence/base.entity.ts","../../../src/persistence/transformRawDto.ts","../../../src/persistence/guards/isMarkedCollection.ts","../../../src/persistence/collection.ts"],"sourcesContent":["export * from './base.entity';\nexport * from './collection';\n","import { stripUndefinedProperties } from '@forklaunch/common';\nimport {\n  Constructor,\n  EntityDTO,\n  FromEntityType,\n  BaseEntity as MikroOrmBaseEntity,\n  wrap\n} from '@mikro-orm/core';\nimport { transformRawDto } from './transformRawDto';\nimport { CreateShape, UpdateShape } from './types/shapes.types';\n\n/**\n * Type representing a base entity with common fields.\n * Extends BaseEntity with optional id, _id, createdAt, and updatedAt fields.\n */\ntype BaseEntityWithId = BaseEntity & {\n  id?: unknown;\n  _id?: unknown;\n  createdAt?: unknown;\n  updatedAt?: unknown;\n};\n\n/**\n * Abstract base class for all entities in the system.\n * Extends MikroORM's BaseEntity and provides common CRUD operations.\n */\nexport abstract class BaseEntity extends MikroOrmBaseEntity {\n  /**\n   * Static factory method to create a new entity instance.\n   *\n   * @template Entity - The type of entity being created\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {...Parameters<Entity['create']>} args - Arguments for entity creation\n   * @returns {Entity} A new entity instance\n   */\n  static create<Entity extends BaseEntityWithId>(\n    this: Constructor<Entity>,\n    ...args: Parameters<Entity['create']>\n  ): Entity {\n    const [data, ...additionalArgs] = args;\n    return new this().create(\n      data as CreateShape<BaseEntityWithId, Entity>,\n      ...additionalArgs\n    );\n  }\n\n  /**\n   * Static method to update an entity instance.\n   *\n   * @template Entity - The type of entity being updated\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {...Parameters<Entity['update']>} args - Arguments for entity update\n   * @returns {Entity} The updated entity instance\n   */\n  static update<Entity extends BaseEntityWithId>(\n    this: Constructor<Entity>,\n    ...args: Parameters<Entity['update']>\n  ): Entity {\n    const [data, ...additionalArgs] = args;\n    return new this().update(\n      data as UpdateShape<BaseEntity, Entity>,\n      ...additionalArgs\n    );\n  }\n\n  /**\n   * Static method to map data to an entity instance.\n   *\n   * @template Entity - The type of entity being mapped\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {Partial<EntityDTO<FromEntityType<Entity>>>} data - The data to map\n   * @returns {Entity} A new entity instance with mapped data\n   */\n  static map<Entity extends BaseEntity>(\n    this: Constructor<Entity>,\n    data: Partial<EntityDTO<FromEntityType<Entity>>>\n  ): Entity {\n    return new this().map(data);\n  }\n\n  /**\n   * Creates a new entity instance with the provided data.\n   *\n   * @param {CreateShape<BaseEntityWithId, this>} data - The data to create the entity with\n   * @returns {this} The created entity instance\n   */\n  create(data: CreateShape<BaseEntityWithId, this>): this {\n    return Object.assign(this, transformRawDto(data, this));\n  }\n\n  /**\n   * Updates the entity instance with the provided data.\n   *\n   * @param {UpdateShape<BaseEntityWithId, this>} data - The data to update the entity with\n   * @returns {this} The updated entity instance\n   */\n  update(data: UpdateShape<BaseEntityWithId, this>): this {\n    wrap(this).assign(\n      stripUndefinedProperties(transformRawDto(data, this)) as Partial<\n        EntityDTO<FromEntityType<this>>\n      >\n    );\n    return this;\n  }\n\n  /**\n   * Reads the entity data as a plain object.\n   *\n   * @returns {EntityDTO<this> | this} The entity data as a plain object\n   */\n  read(): EntityDTO<this> | this {\n    if (typeof wrap(this).toPOJO === 'function') {\n      return wrap(this).toPOJO();\n    }\n    return this;\n  }\n\n  /**\n   * Maps data to the entity instance.\n   *\n   * @param {Partial<EntityDTO<FromEntityType<this>>>} data - The data to map\n   * @returns {this} The entity instance with mapped data\n   */\n  map(data: Partial<EntityDTO<FromEntityType<this>>>): this {\n    wrap(this).assign(data);\n    return this;\n  }\n}\n","import { BaseEntity, Collection } from '@mikro-orm/core';\nimport { isMarkedCollection } from './guards/isMarkedCollection';\n\n/**\n * Transforms a raw DTO (Data Transfer Object) by converting marked collections into MikroORM collections.\n * This function is used to properly handle collections when converting between DTOs and entities.\n *\n * @template T - The type of the DTO being transformed\n * @template U - The type of the entity being transformed into\n * @param {T} data - The raw DTO data to transform\n * @param {U} entity - The entity instance to associate collections with\n * @returns {T} The transformed DTO with collections properly initialized\n * @example\n * const dto = { users: { _collection: true, items: [{ id: 1 }] } };\n * const entity = new UserEntity();\n * const transformed = transformRawDto(dto, entity);\n * // transformed.users is now a MikroORM Collection\n */\nexport function transformRawDto<\n  T extends Record<string, unknown>,\n  U extends BaseEntity\n>(data: T, entity: U): T {\n  const transformedObject: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (isMarkedCollection<object>(value)) {\n      transformedObject[key] = new Collection(entity, value.items);\n    } else {\n      transformedObject[key] = value;\n    }\n  }\n  return transformedObject as T;\n}\n","import { MarkedCollection } from '../types/markedCollection.types';\n\n/**\n * Type guard function that checks if a value is a marked collection.\n *\n * @template T - The type of items in the collection\n * @param {unknown} value - The value to check\n * @returns {value is MarkedCollection<T>} True if the value is a marked collection, false otherwise\n * @example\n * const value = { _collection: true, items: [1, 2, 3] };\n * if (isMarkedCollection<number>(value)) {\n *   // value is now typed as MarkedCollection<number>\n *   console.log(value.items); // [1, 2, 3]\n * }\n */\nexport function isMarkedCollection<T>(\n  value: unknown\n): value is MarkedCollection<T> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '_collection' in value &&\n    typeof value._collection === 'boolean' &&\n    value._collection\n  );\n}\n","import { MarkedCollection } from './types/markedCollection.types';\n\n/**\n * Creates a marked collection from an array of items.\n * A marked collection is a wrapper around an array that indicates it should be treated as a collection.\n *\n * @template T - The type of items in the collection\n * @param {T[]} items - The array of items to wrap in a collection\n * @returns {MarkedCollection<T>} A marked collection containing the provided items\n * @example\n * const users = collection([{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }]);\n */\nexport function collection<T>(items: T[]): MarkedCollection<T> {\n  return {\n    _collection: true,\n    items\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,oBAAAA;AAAA,EAAA;AAAA;AAAA;;;ACAA,oBAAyC;AACzC,IAAAC,eAMO;;;ACPP,kBAAuC;;;ACehC,SAAS,mBACd,OAC8B;AAC9B,SACE,OAAO,UAAU,YACjB,UAAU,QACV,iBAAiB,SACjB,OAAO,MAAM,gBAAgB,aAC7B,MAAM;AAEV;;;ADPO,SAAS,gBAGd,MAAS,QAAc;AACvB,QAAM,oBAA6C,CAAC;AACpD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,QAAI,mBAA2B,KAAK,GAAG;AACrC,wBAAkB,GAAG,IAAI,IAAI,uBAAW,QAAQ,MAAM,KAAK;AAAA,IAC7D,OAAO;AACL,wBAAkB,GAAG,IAAI;AAAA,IAC3B;AAAA,EACF;AACA,SAAO;AACT;;;ADLO,IAAeC,cAAf,cAAkC,aAAAC,WAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS1D,OAAO,UAEF,MACK;AACR,UAAM,CAAC,MAAM,GAAG,cAAc,IAAI;AAClC,WAAO,IAAI,KAAK,EAAE;AAAA,MAChB;AAAA,MACA,GAAG;AAAA,IACL;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,UAEF,MACK;AACR,UAAM,CAAC,MAAM,GAAG,cAAc,IAAI;AAClC,WAAO,IAAI,KAAK,EAAE;AAAA,MAChB;AAAA,MACA,GAAG;AAAA,IACL;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,IAEL,MACQ;AACR,WAAO,IAAI,KAAK,EAAE,IAAI,IAAI;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,MAAiD;AACtD,WAAO,OAAO,OAAO,MAAM,gBAAgB,MAAM,IAAI,CAAC;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,MAAiD;AACtD,2BAAK,IAAI,EAAE;AAAA,UACT,wCAAyB,gBAAgB,MAAM,IAAI,CAAC;AAAA,IAGtD;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAA+B;AAC7B,QAAI,WAAO,mBAAK,IAAI,EAAE,WAAW,YAAY;AAC3C,iBAAO,mBAAK,IAAI,EAAE,OAAO;AAAA,IAC3B;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,MAAsD;AACxD,2BAAK,IAAI,EAAE,OAAO,IAAI;AACtB,WAAO;AAAA,EACT;AACF;;;AGnHO,SAAS,WAAc,OAAiC;AAC7D,SAAO;AAAA,IACL,aAAa;AAAA,IACb;AAAA,EACF;AACF;","names":["BaseEntity","import_core","BaseEntity","MikroOrmBaseEntity"]}
+{"version":3,"sources":["../../../src/persistence/index.ts","../../../src/persistence/base.entity.ts","../../../src/persistence/transformRawDto.ts","../../../src/persistence/guards/isMarkedCollection.ts","../../../src/persistence/collection.ts"],"sourcesContent":["export * from './base.entity';\nexport * from './collection';\n","import { stripUndefinedProperties } from '@forklaunch/common';\nimport {\n  Constructor,\n  EntityDTO,\n  FromEntityType,\n  BaseEntity as MikroOrmBaseEntity,\n  wrap\n} from '@mikro-orm/core';\nimport { transformRawDto } from './transformRawDto';\nimport { CreateShape, UpdateShape } from './types/shapes.types';\n\n/**\n * Type representing a base entity with common fields.\n * Extends BaseEntity with optional id, _id, createdAt, and updatedAt fields.\n */\ntype BaseEntityWithId = BaseEntity & {\n  id?: unknown;\n  _id?: unknown;\n  createdAt?: unknown;\n  updatedAt?: unknown;\n};\n\n/**\n * Abstract base class for all entities in the system.\n * Extends MikroORM's BaseEntity and provides common CRUD operations.\n */\nexport abstract class BaseEntity extends MikroOrmBaseEntity {\n  /**\n   * Static factory method to create a new entity instance.\n   *\n   * @template Entity - The type of entity being created\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {...Parameters<Entity['create']>} args - Arguments for entity creation\n   * @returns {Entity} A new entity instance\n   */\n  static async create<Entity extends BaseEntityWithId>(\n    this: Constructor<Entity>,\n    ...args: Parameters<Entity['create']>\n  ): Promise<Entity> {\n    const [data, ...additionalArgs] = args;\n    const entity = new this();\n    await entity.create(\n      data as CreateShape<BaseEntityWithId, Entity>,\n      ...additionalArgs\n    );\n    return entity;\n  }\n\n  /**\n   * Static method to update an entity instance.\n   *\n   * @template Entity - The type of entity being updated\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {...Parameters<Entity['update']>} args - Arguments for entity update\n   * @returns {Entity} The updated entity instance\n   */\n  static async update<Entity extends BaseEntityWithId>(\n    this: Constructor<Entity>,\n    ...args: Parameters<Entity['update']>\n  ): Promise<Entity> {\n    const [data, ...additionalArgs] = args;\n    const entity = new this();\n    await entity.update(\n      data as UpdateShape<BaseEntity, Entity>,\n      ...additionalArgs\n    );\n    return entity;\n  }\n\n  /**\n   * Static method to map data to an entity instance.\n   *\n   * @template Entity - The type of entity being mapped\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {Partial<EntityDTO<FromEntityType<Entity>>>} data - The data to map\n   * @returns {Entity} A new entity instance with mapped data\n   */\n  static async map<Entity extends BaseEntity>(\n    this: Constructor<Entity>,\n    data: Partial<EntityDTO<FromEntityType<Entity>>>\n  ): Promise<Entity> {\n    const entity = new this();\n    await entity.map(data);\n    return entity;\n  }\n\n  /**\n   * Creates a new entity instance with the provided data.\n   *\n   * @param {CreateShape<BaseEntityWithId, this>} data - The data to create the entity with\n   * @returns {this} The created entity instance\n   */\n  async create(\n    data: CreateShape<BaseEntityWithId, this>\n  ): Promise<EntityDTO<this>> {\n    Object.assign(this, transformRawDto(data, this));\n    const entity = await wrap(this).init();\n    if (!entity) {\n      throw new Error('Entity not initialized');\n    }\n    return entity.toObject();\n  }\n\n  /**\n   * Updates the entity instance with the provided data.\n   *\n   * @param {UpdateShape<BaseEntityWithId, this>} data - The data to update the entity with\n   * @returns {this} The updated entity instance\n   */\n  async update(\n    data: UpdateShape<BaseEntityWithId, this>\n  ): Promise<EntityDTO<this>> {\n    const entity = wrap(this);\n    entity.assign(\n      stripUndefinedProperties(transformRawDto(data, this)) as Partial<\n        EntityDTO<FromEntityType<this>>\n      >\n    );\n    return entity.toObject();\n  }\n\n  /**\n   * Reads the entity data as a plain object.\n   *\n   * @returns {EntityDTO<this> | this} The entity data as a plain object\n   */\n  async read(): Promise<EntityDTO<this>> {\n    const entity = await wrap(this).init();\n    if (!entity) {\n      throw new Error('Entity not initialized');\n    }\n    return entity.toObject();\n  }\n\n  /**\n   * Maps data to the entity instance.\n   *\n   * @param {Partial<EntityDTO<FromEntityType<this>>>} data - The data to map\n   * @returns {this} The entity instance with mapped data\n   */\n  async map(data: Partial<EntityDTO<FromEntityType<this>>>): Promise<this> {\n    const entity = await wrap(this).init();\n\n    if (!entity) {\n      throw new Error('Entity not initialized');\n    }\n    entity.assign(data);\n    return entity;\n  }\n}\n","import { BaseEntity, Collection } from '@mikro-orm/core';\nimport { isMarkedCollection } from './guards/isMarkedCollection';\n\n/**\n * Transforms a raw DTO (Data Transfer Object) by converting marked collections into MikroORM collections.\n * This function is used to properly handle collections when converting between DTOs and entities.\n *\n * @template T - The type of the DTO being transformed\n * @template U - The type of the entity being transformed into\n * @param {T} data - The raw DTO data to transform\n * @param {U} entity - The entity instance to associate collections with\n * @returns {T} The transformed DTO with collections properly initialized\n * @example\n * const dto = { users: { _collection: true, items: [{ id: 1 }] } };\n * const entity = new UserEntity();\n * const transformed = transformRawDto(dto, entity);\n * // transformed.users is now a MikroORM Collection\n */\nexport function transformRawDto<\n  T extends Record<string, unknown>,\n  U extends BaseEntity\n>(data: T, entity: U): T {\n  const transformedObject: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (isMarkedCollection<object>(value)) {\n      transformedObject[key] = new Collection(entity, value.items);\n    } else {\n      transformedObject[key] = value;\n    }\n  }\n  return transformedObject as T;\n}\n","import { MarkedCollection } from '../types/markedCollection.types';\n\n/**\n * Type guard function that checks if a value is a marked collection.\n *\n * @template T - The type of items in the collection\n * @param {unknown} value - The value to check\n * @returns {value is MarkedCollection<T>} True if the value is a marked collection, false otherwise\n * @example\n * const value = { _collection: true, items: [1, 2, 3] };\n * if (isMarkedCollection<number>(value)) {\n *   // value is now typed as MarkedCollection<number>\n *   console.log(value.items); // [1, 2, 3]\n * }\n */\nexport function isMarkedCollection<T>(\n  value: unknown\n): value is MarkedCollection<T> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '_collection' in value &&\n    typeof value._collection === 'boolean' &&\n    value._collection\n  );\n}\n","import { MarkedCollection } from './types/markedCollection.types';\n\n/**\n * Creates a marked collection from an array of items.\n * A marked collection is a wrapper around an array that indicates it should be treated as a collection.\n *\n * @template T - The type of items in the collection\n * @param {T[]} items - The array of items to wrap in a collection\n * @returns {MarkedCollection<T>} A marked collection containing the provided items\n * @example\n * const users = collection([{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }]);\n */\nexport function collection<T>(items: T[]): MarkedCollection<T> {\n  return {\n    _collection: true,\n    items\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,oBAAAA;AAAA,EAAA;AAAA;AAAA;;;ACAA,oBAAyC;AACzC,IAAAC,eAMO;;;ACPP,kBAAuC;;;ACehC,SAAS,mBACd,OAC8B;AAC9B,SACE,OAAO,UAAU,YACjB,UAAU,QACV,iBAAiB,SACjB,OAAO,MAAM,gBAAgB,aAC7B,MAAM;AAEV;;;ADPO,SAAS,gBAGd,MAAS,QAAc;AACvB,QAAM,oBAA6C,CAAC;AACpD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,QAAI,mBAA2B,KAAK,GAAG;AACrC,wBAAkB,GAAG,IAAI,IAAI,uBAAW,QAAQ,MAAM,KAAK;AAAA,IAC7D,OAAO;AACL,wBAAkB,GAAG,IAAI;AAAA,IAC3B;AAAA,EACF;AACA,SAAO;AACT;;;ADLO,IAAeC,cAAf,cAAkC,aAAAC,WAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS1D,aAAa,UAER,MACc;AACjB,UAAM,CAAC,MAAM,GAAG,cAAc,IAAI;AAClC,UAAM,SAAS,IAAI,KAAK;AACxB,UAAM,OAAO;AAAA,MACX;AAAA,MACA,GAAG;AAAA,IACL;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,aAAa,UAER,MACc;AACjB,UAAM,CAAC,MAAM,GAAG,cAAc,IAAI;AAClC,UAAM,SAAS,IAAI,KAAK;AACxB,UAAM,OAAO;AAAA,MACX;AAAA,MACA,GAAG;AAAA,IACL;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,aAAa,IAEX,MACiB;AACjB,UAAM,SAAS,IAAI,KAAK;AACxB,UAAM,OAAO,IAAI,IAAI;AACrB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OACJ,MAC0B;AAC1B,WAAO,OAAO,MAAM,gBAAgB,MAAM,IAAI,CAAC;AAC/C,UAAM,SAAS,UAAM,mBAAK,IAAI,EAAE,KAAK;AACrC,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AACA,WAAO,OAAO,SAAS;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OACJ,MAC0B;AAC1B,UAAM,aAAS,mBAAK,IAAI;AACxB,WAAO;AAAA,UACL,wCAAyB,gBAAgB,MAAM,IAAI,CAAC;AAAA,IAGtD;AACA,WAAO,OAAO,SAAS;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAiC;AACrC,UAAM,SAAS,UAAM,mBAAK,IAAI,EAAE,KAAK;AACrC,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AACA,WAAO,OAAO,SAAS;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,MAA+D;AACvE,UAAM,SAAS,UAAM,mBAAK,IAAI,EAAE,KAAK;AAErC,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AACA,WAAO,OAAO,IAAI;AAClB,WAAO;AAAA,EACT;AACF;;;AGzIO,SAAS,WAAc,OAAiC;AAC7D,SAAO;AAAA,IACL,aAAa;AAAA,IACb;AAAA,EACF;AACF;","names":["BaseEntity","import_core","BaseEntity","MikroOrmBaseEntity"]}

package/lib/src/persistence/index.mjs

@@ -36,12 +36,14 @@ var BaseEntity2 = class extends MikroOrmBaseEntity {
    * @param {...Parameters<Entity['create']>} args - Arguments for entity creation
    * @returns {Entity} A new entity instance
    */
-  static create(...args) {
+  static async create(...args) {
     const [data, ...additionalArgs] = args;
-    return new this().create(
+    const entity = new this();
+    await entity.create(
       data,
       ...additionalArgs
     );
+    return entity;
   }
   /**
    * Static method to update an entity instance.
@@ -51,12 +53,14 @@ var BaseEntity2 = class extends MikroOrmBaseEntity {
    * @param {...Parameters<Entity['update']>} args - Arguments for entity update
    * @returns {Entity} The updated entity instance
    */
-  static update(...args) {
+  static async update(...args) {
     const [data, ...additionalArgs] = args;
-    return new this().update(
+    const entity = new this();
+    await entity.update(
       data,
       ...additionalArgs
     );
+    return entity;
   }
   /**
    * Static method to map data to an entity instance.
@@ -66,8 +70,10 @@ var BaseEntity2 = class extends MikroOrmBaseEntity {
    * @param {Partial<EntityDTO<FromEntityType<Entity>>>} data - The data to map
    * @returns {Entity} A new entity instance with mapped data
    */
-  static map(data) {
-    return new this().map(data);
+  static async map(data) {
+    const entity = new this();
+    await entity.map(data);
+    return entity;
   }
   /**
    * Creates a new entity instance with the provided data.
@@ -75,8 +81,13 @@ var BaseEntity2 = class extends MikroOrmBaseEntity {
    * @param {CreateShape<BaseEntityWithId, this>} data - The data to create the entity with
    * @returns {this} The created entity instance
    */
-  create(data) {
-    return Object.assign(this, transformRawDto(data, this));
+  async create(data) {
+    Object.assign(this, transformRawDto(data, this));
+    const entity = await wrap(this).init();
+    if (!entity) {
+      throw new Error("Entity not initialized");
+    }
+    return entity.toObject();
   }
   /**
    * Updates the entity instance with the provided data.
@@ -84,22 +95,24 @@ var BaseEntity2 = class extends MikroOrmBaseEntity {
    * @param {UpdateShape<BaseEntityWithId, this>} data - The data to update the entity with
    * @returns {this} The updated entity instance
    */
-  update(data) {
-    wrap(this).assign(
+  async update(data) {
+    const entity = wrap(this);
+    entity.assign(
       stripUndefinedProperties(transformRawDto(data, this))
     );
-    return this;
+    return entity.toObject();
   }
   /**
    * Reads the entity data as a plain object.
    *
    * @returns {EntityDTO<this> | this} The entity data as a plain object
    */
-  read() {
-    if (typeof wrap(this).toPOJO === "function") {
-      return wrap(this).toPOJO();
+  async read() {
+    const entity = await wrap(this).init();
+    if (!entity) {
+      throw new Error("Entity not initialized");
     }
-    return this;
+    return entity.toObject();
   }
   /**
    * Maps data to the entity instance.
@@ -107,9 +120,13 @@ var BaseEntity2 = class extends MikroOrmBaseEntity {
    * @param {Partial<EntityDTO<FromEntityType<this>>>} data - The data to map
    * @returns {this} The entity instance with mapped data
    */
-  map(data) {
-    wrap(this).assign(data);
-    return this;
+  async map(data) {
+    const entity = await wrap(this).init();
+    if (!entity) {
+      throw new Error("Entity not initialized");
+    }
+    entity.assign(data);
+    return entity;
   }
 };
 

package/lib/src/persistence/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/persistence/base.entity.ts","../../../src/persistence/transformRawDto.ts","../../../src/persistence/guards/isMarkedCollection.ts","../../../src/persistence/collection.ts"],"sourcesContent":["import { stripUndefinedProperties } from '@forklaunch/common';\nimport {\n  Constructor,\n  EntityDTO,\n  FromEntityType,\n  BaseEntity as MikroOrmBaseEntity,\n  wrap\n} from '@mikro-orm/core';\nimport { transformRawDto } from './transformRawDto';\nimport { CreateShape, UpdateShape } from './types/shapes.types';\n\n/**\n * Type representing a base entity with common fields.\n * Extends BaseEntity with optional id, _id, createdAt, and updatedAt fields.\n */\ntype BaseEntityWithId = BaseEntity & {\n  id?: unknown;\n  _id?: unknown;\n  createdAt?: unknown;\n  updatedAt?: unknown;\n};\n\n/**\n * Abstract base class for all entities in the system.\n * Extends MikroORM's BaseEntity and provides common CRUD operations.\n */\nexport abstract class BaseEntity extends MikroOrmBaseEntity {\n  /**\n   * Static factory method to create a new entity instance.\n   *\n   * @template Entity - The type of entity being created\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {...Parameters<Entity['create']>} args - Arguments for entity creation\n   * @returns {Entity} A new entity instance\n   */\n  static create<Entity extends BaseEntityWithId>(\n    this: Constructor<Entity>,\n    ...args: Parameters<Entity['create']>\n  ): Entity {\n    const [data, ...additionalArgs] = args;\n    return new this().create(\n      data as CreateShape<BaseEntityWithId, Entity>,\n      ...additionalArgs\n    );\n  }\n\n  /**\n   * Static method to update an entity instance.\n   *\n   * @template Entity - The type of entity being updated\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {...Parameters<Entity['update']>} args - Arguments for entity update\n   * @returns {Entity} The updated entity instance\n   */\n  static update<Entity extends BaseEntityWithId>(\n    this: Constructor<Entity>,\n    ...args: Parameters<Entity['update']>\n  ): Entity {\n    const [data, ...additionalArgs] = args;\n    return new this().update(\n      data as UpdateShape<BaseEntity, Entity>,\n      ...additionalArgs\n    );\n  }\n\n  /**\n   * Static method to map data to an entity instance.\n   *\n   * @template Entity - The type of entity being mapped\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {Partial<EntityDTO<FromEntityType<Entity>>>} data - The data to map\n   * @returns {Entity} A new entity instance with mapped data\n   */\n  static map<Entity extends BaseEntity>(\n    this: Constructor<Entity>,\n    data: Partial<EntityDTO<FromEntityType<Entity>>>\n  ): Entity {\n    return new this().map(data);\n  }\n\n  /**\n   * Creates a new entity instance with the provided data.\n   *\n   * @param {CreateShape<BaseEntityWithId, this>} data - The data to create the entity with\n   * @returns {this} The created entity instance\n   */\n  create(data: CreateShape<BaseEntityWithId, this>): this {\n    return Object.assign(this, transformRawDto(data, this));\n  }\n\n  /**\n   * Updates the entity instance with the provided data.\n   *\n   * @param {UpdateShape<BaseEntityWithId, this>} data - The data to update the entity with\n   * @returns {this} The updated entity instance\n   */\n  update(data: UpdateShape<BaseEntityWithId, this>): this {\n    wrap(this).assign(\n      stripUndefinedProperties(transformRawDto(data, this)) as Partial<\n        EntityDTO<FromEntityType<this>>\n      >\n    );\n    return this;\n  }\n\n  /**\n   * Reads the entity data as a plain object.\n   *\n   * @returns {EntityDTO<this> | this} The entity data as a plain object\n   */\n  read(): EntityDTO<this> | this {\n    if (typeof wrap(this).toPOJO === 'function') {\n      return wrap(this).toPOJO();\n    }\n    return this;\n  }\n\n  /**\n   * Maps data to the entity instance.\n   *\n   * @param {Partial<EntityDTO<FromEntityType<this>>>} data - The data to map\n   * @returns {this} The entity instance with mapped data\n   */\n  map(data: Partial<EntityDTO<FromEntityType<this>>>): this {\n    wrap(this).assign(data);\n    return this;\n  }\n}\n","import { BaseEntity, Collection } from '@mikro-orm/core';\nimport { isMarkedCollection } from './guards/isMarkedCollection';\n\n/**\n * Transforms a raw DTO (Data Transfer Object) by converting marked collections into MikroORM collections.\n * This function is used to properly handle collections when converting between DTOs and entities.\n *\n * @template T - The type of the DTO being transformed\n * @template U - The type of the entity being transformed into\n * @param {T} data - The raw DTO data to transform\n * @param {U} entity - The entity instance to associate collections with\n * @returns {T} The transformed DTO with collections properly initialized\n * @example\n * const dto = { users: { _collection: true, items: [{ id: 1 }] } };\n * const entity = new UserEntity();\n * const transformed = transformRawDto(dto, entity);\n * // transformed.users is now a MikroORM Collection\n */\nexport function transformRawDto<\n  T extends Record<string, unknown>,\n  U extends BaseEntity\n>(data: T, entity: U): T {\n  const transformedObject: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (isMarkedCollection<object>(value)) {\n      transformedObject[key] = new Collection(entity, value.items);\n    } else {\n      transformedObject[key] = value;\n    }\n  }\n  return transformedObject as T;\n}\n","import { MarkedCollection } from '../types/markedCollection.types';\n\n/**\n * Type guard function that checks if a value is a marked collection.\n *\n * @template T - The type of items in the collection\n * @param {unknown} value - The value to check\n * @returns {value is MarkedCollection<T>} True if the value is a marked collection, false otherwise\n * @example\n * const value = { _collection: true, items: [1, 2, 3] };\n * if (isMarkedCollection<number>(value)) {\n *   // value is now typed as MarkedCollection<number>\n *   console.log(value.items); // [1, 2, 3]\n * }\n */\nexport function isMarkedCollection<T>(\n  value: unknown\n): value is MarkedCollection<T> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '_collection' in value &&\n    typeof value._collection === 'boolean' &&\n    value._collection\n  );\n}\n","import { MarkedCollection } from './types/markedCollection.types';\n\n/**\n * Creates a marked collection from an array of items.\n * A marked collection is a wrapper around an array that indicates it should be treated as a collection.\n *\n * @template T - The type of items in the collection\n * @param {T[]} items - The array of items to wrap in a collection\n * @returns {MarkedCollection<T>} A marked collection containing the provided items\n * @example\n * const users = collection([{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }]);\n */\nexport function collection<T>(items: T[]): MarkedCollection<T> {\n  return {\n    _collection: true,\n    items\n  };\n}\n"],"mappings":";AAAA,SAAS,gCAAgC;AACzC;AAAA,EAIE,cAAc;AAAA,EACd;AAAA,OACK;;;ACPP,SAAqB,kBAAkB;;;ACehC,SAAS,mBACd,OAC8B;AAC9B,SACE,OAAO,UAAU,YACjB,UAAU,QACV,iBAAiB,SACjB,OAAO,MAAM,gBAAgB,aAC7B,MAAM;AAEV;;;ADPO,SAAS,gBAGd,MAAS,QAAc;AACvB,QAAM,oBAA6C,CAAC;AACpD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,QAAI,mBAA2B,KAAK,GAAG;AACrC,wBAAkB,GAAG,IAAI,IAAI,WAAW,QAAQ,MAAM,KAAK;AAAA,IAC7D,OAAO;AACL,wBAAkB,GAAG,IAAI;AAAA,IAC3B;AAAA,EACF;AACA,SAAO;AACT;;;ADLO,IAAeA,cAAf,cAAkC,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS1D,OAAO,UAEF,MACK;AACR,UAAM,CAAC,MAAM,GAAG,cAAc,IAAI;AAClC,WAAO,IAAI,KAAK,EAAE;AAAA,MAChB;AAAA,MACA,GAAG;AAAA,IACL;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,UAEF,MACK;AACR,UAAM,CAAC,MAAM,GAAG,cAAc,IAAI;AAClC,WAAO,IAAI,KAAK,EAAE;AAAA,MAChB;AAAA,MACA,GAAG;AAAA,IACL;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,IAEL,MACQ;AACR,WAAO,IAAI,KAAK,EAAE,IAAI,IAAI;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,MAAiD;AACtD,WAAO,OAAO,OAAO,MAAM,gBAAgB,MAAM,IAAI,CAAC;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,MAAiD;AACtD,SAAK,IAAI,EAAE;AAAA,MACT,yBAAyB,gBAAgB,MAAM,IAAI,CAAC;AAAA,IAGtD;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,OAA+B;AAC7B,QAAI,OAAO,KAAK,IAAI,EAAE,WAAW,YAAY;AAC3C,aAAO,KAAK,IAAI,EAAE,OAAO;AAAA,IAC3B;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAI,MAAsD;AACxD,SAAK,IAAI,EAAE,OAAO,IAAI;AACtB,WAAO;AAAA,EACT;AACF;;;AGnHO,SAAS,WAAc,OAAiC;AAC7D,SAAO;AAAA,IACL,aAAa;AAAA,IACb;AAAA,EACF;AACF;","names":["BaseEntity"]}
+{"version":3,"sources":["../../../src/persistence/base.entity.ts","../../../src/persistence/transformRawDto.ts","../../../src/persistence/guards/isMarkedCollection.ts","../../../src/persistence/collection.ts"],"sourcesContent":["import { stripUndefinedProperties } from '@forklaunch/common';\nimport {\n  Constructor,\n  EntityDTO,\n  FromEntityType,\n  BaseEntity as MikroOrmBaseEntity,\n  wrap\n} from '@mikro-orm/core';\nimport { transformRawDto } from './transformRawDto';\nimport { CreateShape, UpdateShape } from './types/shapes.types';\n\n/**\n * Type representing a base entity with common fields.\n * Extends BaseEntity with optional id, _id, createdAt, and updatedAt fields.\n */\ntype BaseEntityWithId = BaseEntity & {\n  id?: unknown;\n  _id?: unknown;\n  createdAt?: unknown;\n  updatedAt?: unknown;\n};\n\n/**\n * Abstract base class for all entities in the system.\n * Extends MikroORM's BaseEntity and provides common CRUD operations.\n */\nexport abstract class BaseEntity extends MikroOrmBaseEntity {\n  /**\n   * Static factory method to create a new entity instance.\n   *\n   * @template Entity - The type of entity being created\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {...Parameters<Entity['create']>} args - Arguments for entity creation\n   * @returns {Entity} A new entity instance\n   */\n  static async create<Entity extends BaseEntityWithId>(\n    this: Constructor<Entity>,\n    ...args: Parameters<Entity['create']>\n  ): Promise<Entity> {\n    const [data, ...additionalArgs] = args;\n    const entity = new this();\n    await entity.create(\n      data as CreateShape<BaseEntityWithId, Entity>,\n      ...additionalArgs\n    );\n    return entity;\n  }\n\n  /**\n   * Static method to update an entity instance.\n   *\n   * @template Entity - The type of entity being updated\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {...Parameters<Entity['update']>} args - Arguments for entity update\n   * @returns {Entity} The updated entity instance\n   */\n  static async update<Entity extends BaseEntityWithId>(\n    this: Constructor<Entity>,\n    ...args: Parameters<Entity['update']>\n  ): Promise<Entity> {\n    const [data, ...additionalArgs] = args;\n    const entity = new this();\n    await entity.update(\n      data as UpdateShape<BaseEntity, Entity>,\n      ...additionalArgs\n    );\n    return entity;\n  }\n\n  /**\n   * Static method to map data to an entity instance.\n   *\n   * @template Entity - The type of entity being mapped\n   * @param {Constructor<Entity>} this - The entity constructor\n   * @param {Partial<EntityDTO<FromEntityType<Entity>>>} data - The data to map\n   * @returns {Entity} A new entity instance with mapped data\n   */\n  static async map<Entity extends BaseEntity>(\n    this: Constructor<Entity>,\n    data: Partial<EntityDTO<FromEntityType<Entity>>>\n  ): Promise<Entity> {\n    const entity = new this();\n    await entity.map(data);\n    return entity;\n  }\n\n  /**\n   * Creates a new entity instance with the provided data.\n   *\n   * @param {CreateShape<BaseEntityWithId, this>} data - The data to create the entity with\n   * @returns {this} The created entity instance\n   */\n  async create(\n    data: CreateShape<BaseEntityWithId, this>\n  ): Promise<EntityDTO<this>> {\n    Object.assign(this, transformRawDto(data, this));\n    const entity = await wrap(this).init();\n    if (!entity) {\n      throw new Error('Entity not initialized');\n    }\n    return entity.toObject();\n  }\n\n  /**\n   * Updates the entity instance with the provided data.\n   *\n   * @param {UpdateShape<BaseEntityWithId, this>} data - The data to update the entity with\n   * @returns {this} The updated entity instance\n   */\n  async update(\n    data: UpdateShape<BaseEntityWithId, this>\n  ): Promise<EntityDTO<this>> {\n    const entity = wrap(this);\n    entity.assign(\n      stripUndefinedProperties(transformRawDto(data, this)) as Partial<\n        EntityDTO<FromEntityType<this>>\n      >\n    );\n    return entity.toObject();\n  }\n\n  /**\n   * Reads the entity data as a plain object.\n   *\n   * @returns {EntityDTO<this> | this} The entity data as a plain object\n   */\n  async read(): Promise<EntityDTO<this>> {\n    const entity = await wrap(this).init();\n    if (!entity) {\n      throw new Error('Entity not initialized');\n    }\n    return entity.toObject();\n  }\n\n  /**\n   * Maps data to the entity instance.\n   *\n   * @param {Partial<EntityDTO<FromEntityType<this>>>} data - The data to map\n   * @returns {this} The entity instance with mapped data\n   */\n  async map(data: Partial<EntityDTO<FromEntityType<this>>>): Promise<this> {\n    const entity = await wrap(this).init();\n\n    if (!entity) {\n      throw new Error('Entity not initialized');\n    }\n    entity.assign(data);\n    return entity;\n  }\n}\n","import { BaseEntity, Collection } from '@mikro-orm/core';\nimport { isMarkedCollection } from './guards/isMarkedCollection';\n\n/**\n * Transforms a raw DTO (Data Transfer Object) by converting marked collections into MikroORM collections.\n * This function is used to properly handle collections when converting between DTOs and entities.\n *\n * @template T - The type of the DTO being transformed\n * @template U - The type of the entity being transformed into\n * @param {T} data - The raw DTO data to transform\n * @param {U} entity - The entity instance to associate collections with\n * @returns {T} The transformed DTO with collections properly initialized\n * @example\n * const dto = { users: { _collection: true, items: [{ id: 1 }] } };\n * const entity = new UserEntity();\n * const transformed = transformRawDto(dto, entity);\n * // transformed.users is now a MikroORM Collection\n */\nexport function transformRawDto<\n  T extends Record<string, unknown>,\n  U extends BaseEntity\n>(data: T, entity: U): T {\n  const transformedObject: Record<string, unknown> = {};\n  for (const [key, value] of Object.entries(data)) {\n    if (isMarkedCollection<object>(value)) {\n      transformedObject[key] = new Collection(entity, value.items);\n    } else {\n      transformedObject[key] = value;\n    }\n  }\n  return transformedObject as T;\n}\n","import { MarkedCollection } from '../types/markedCollection.types';\n\n/**\n * Type guard function that checks if a value is a marked collection.\n *\n * @template T - The type of items in the collection\n * @param {unknown} value - The value to check\n * @returns {value is MarkedCollection<T>} True if the value is a marked collection, false otherwise\n * @example\n * const value = { _collection: true, items: [1, 2, 3] };\n * if (isMarkedCollection<number>(value)) {\n *   // value is now typed as MarkedCollection<number>\n *   console.log(value.items); // [1, 2, 3]\n * }\n */\nexport function isMarkedCollection<T>(\n  value: unknown\n): value is MarkedCollection<T> {\n  return (\n    typeof value === 'object' &&\n    value !== null &&\n    '_collection' in value &&\n    typeof value._collection === 'boolean' &&\n    value._collection\n  );\n}\n","import { MarkedCollection } from './types/markedCollection.types';\n\n/**\n * Creates a marked collection from an array of items.\n * A marked collection is a wrapper around an array that indicates it should be treated as a collection.\n *\n * @template T - The type of items in the collection\n * @param {T[]} items - The array of items to wrap in a collection\n * @returns {MarkedCollection<T>} A marked collection containing the provided items\n * @example\n * const users = collection([{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }]);\n */\nexport function collection<T>(items: T[]): MarkedCollection<T> {\n  return {\n    _collection: true,\n    items\n  };\n}\n"],"mappings":";AAAA,SAAS,gCAAgC;AACzC;AAAA,EAIE,cAAc;AAAA,EACd;AAAA,OACK;;;ACPP,SAAqB,kBAAkB;;;ACehC,SAAS,mBACd,OAC8B;AAC9B,SACE,OAAO,UAAU,YACjB,UAAU,QACV,iBAAiB,SACjB,OAAO,MAAM,gBAAgB,aAC7B,MAAM;AAEV;;;ADPO,SAAS,gBAGd,MAAS,QAAc;AACvB,QAAM,oBAA6C,CAAC;AACpD,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,IAAI,GAAG;AAC/C,QAAI,mBAA2B,KAAK,GAAG;AACrC,wBAAkB,GAAG,IAAI,IAAI,WAAW,QAAQ,MAAM,KAAK;AAAA,IAC7D,OAAO;AACL,wBAAkB,GAAG,IAAI;AAAA,IAC3B;AAAA,EACF;AACA,SAAO;AACT;;;ADLO,IAAeA,cAAf,cAAkC,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAS1D,aAAa,UAER,MACc;AACjB,UAAM,CAAC,MAAM,GAAG,cAAc,IAAI;AAClC,UAAM,SAAS,IAAI,KAAK;AACxB,UAAM,OAAO;AAAA,MACX;AAAA,MACA,GAAG;AAAA,IACL;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,aAAa,UAER,MACc;AACjB,UAAM,CAAC,MAAM,GAAG,cAAc,IAAI;AAClC,UAAM,SAAS,IAAI,KAAK;AACxB,UAAM,OAAO;AAAA,MACX;AAAA,MACA,GAAG;AAAA,IACL;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,aAAa,IAEX,MACiB;AACjB,UAAM,SAAS,IAAI,KAAK;AACxB,UAAM,OAAO,IAAI,IAAI;AACrB,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OACJ,MAC0B;AAC1B,WAAO,OAAO,MAAM,gBAAgB,MAAM,IAAI,CAAC;AAC/C,UAAM,SAAS,MAAM,KAAK,IAAI,EAAE,KAAK;AACrC,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AACA,WAAO,OAAO,SAAS;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,OACJ,MAC0B;AAC1B,UAAM,SAAS,KAAK,IAAI;AACxB,WAAO;AAAA,MACL,yBAAyB,gBAAgB,MAAM,IAAI,CAAC;AAAA,IAGtD;AACA,WAAO,OAAO,SAAS;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAiC;AACrC,UAAM,SAAS,MAAM,KAAK,IAAI,EAAE,KAAK;AACrC,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AACA,WAAO,OAAO,SAAS;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,IAAI,MAA+D;AACvE,UAAM,SAAS,MAAM,KAAK,IAAI,EAAE,KAAK;AAErC,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI,MAAM,wBAAwB;AAAA,IAC1C;AACA,WAAO,OAAO,IAAI;AAClB,WAAO;AAAA,EACT;AACF;;;AGzIO,SAAS,WAAc,OAAiC;AAC7D,SAAO;AAAA,IACL,aAAa;AAAA,IACb;AAAA,EACF;AACF;","names":["BaseEntity"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/core",
-  "version": "0.8.8",
+  "version": "0.9.2",
   "description": "forklaunch-js core package. Contains useful building blocks.",
   "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
   "bugs": {
@@ -96,12 +96,12 @@
     "pino-pretty": "^13.0.0",
     "redis": "^5.5.5",
     "uuid": "^11.1.0",
-    "@forklaunch/common": "0.3.6",
-    "@forklaunch/validator": "0.6.6"
+    "@forklaunch/common": "0.3.7",
+    "@forklaunch/validator": "0.6.7"
   },
   "devDependencies": {
     "@eslint/js": "^9.28.0",
-    "@scalar/express-api-reference": "^0.8.2",
+    "@scalar/express-api-reference": "^0.8.3",
     "@types/cors": "^2.8.18",
     "@types/jest": "^29.5.14",
     "@types/qs": "^6.14.0",