@forklaunch/core 0.6.5 → 0.7.0

package/lib/src/{dtoMapper → mappers}/index.d.mts

@@ -114,7 +114,7 @@ declare abstract class BaseDtoMapper<SV extends AnySchemaValidator> {
 /**
  * Abstract class representing a request entity mapper.
  *
- * @template Entity - A type that extends BaseEntity.
+ * @template Entity - A type that extends SqlBaseEntity.
  * @template SV - A type that extends AnySchemaValidator.
  * @extends {BaseDtoMapper<SV>}
  */
@@ -178,7 +178,7 @@ declare abstract class RequestDtoMapper<Entity, SV extends AnySchemaValidator> e
 /**
  * Abstract class representing a response entity mapper.
  *
- * @template Entity - A type that extends BaseEntity.
+ * @template Entity - A type that extends SqlBaseEntity.
  * @template SV - A type that extends AnySchemaValidator.
  * @extends {BaseDtoMapper<SV>}
  */
@@ -277,6 +277,6 @@ declare function transformIntoInternalDtoMapper<SchemaValidator extends AnySchem
     dto: unknown;
     _Entity: unknown;
     deserializeDtoToEntity: unknown;
-}>, Entities extends Record<keyof DtoMapper, unknown>, Dto extends Record<keyof DtoMapper, unknown>>(dtoMappers: DtoMapper, schemaValidator: SchemaValidator): InternalDtoMapper<InstanceTypeRecord<DtoMapper>, Entities, Dto>;
+}>, Entities extends Record<keyof DtoMapper, unknown>, Dto extends Record<keyof DtoMapper, unknown>>(mapperss: DtoMapper, schemaValidator: SchemaValidator): InternalDtoMapper<InstanceTypeRecord<DtoMapper>, Entities, Dto>;
 
 export { type DtoMapperSchemaValidatorObject, type InternalDtoMapper, RequestDtoMapper, type RequestDtoMapperConstructor, ResponseDtoMapper, type ResponseDtoMapperConstructor, type SchemasByValidator, serviceSchemaResolver, transformIntoInternalDtoMapper };

package/lib/src/{dtoMapper → mappers}/index.d.ts

@@ -114,7 +114,7 @@ declare abstract class BaseDtoMapper<SV extends AnySchemaValidator> {
 /**
  * Abstract class representing a request entity mapper.
  *
- * @template Entity - A type that extends BaseEntity.
+ * @template Entity - A type that extends SqlBaseEntity.
  * @template SV - A type that extends AnySchemaValidator.
  * @extends {BaseDtoMapper<SV>}
  */
@@ -178,7 +178,7 @@ declare abstract class RequestDtoMapper<Entity, SV extends AnySchemaValidator> e
 /**
  * Abstract class representing a response entity mapper.
  *
- * @template Entity - A type that extends BaseEntity.
+ * @template Entity - A type that extends SqlBaseEntity.
  * @template SV - A type that extends AnySchemaValidator.
  * @extends {BaseDtoMapper<SV>}
  */
@@ -277,6 +277,6 @@ declare function transformIntoInternalDtoMapper<SchemaValidator extends AnySchem
     dto: unknown;
     _Entity: unknown;
     deserializeDtoToEntity: unknown;
-}>, Entities extends Record<keyof DtoMapper, unknown>, Dto extends Record<keyof DtoMapper, unknown>>(dtoMappers: DtoMapper, schemaValidator: SchemaValidator): InternalDtoMapper<InstanceTypeRecord<DtoMapper>, Entities, Dto>;
+}>, Entities extends Record<keyof DtoMapper, unknown>, Dto extends Record<keyof DtoMapper, unknown>>(mapperss: DtoMapper, schemaValidator: SchemaValidator): InternalDtoMapper<InstanceTypeRecord<DtoMapper>, Entities, Dto>;
 
 export { type DtoMapperSchemaValidatorObject, type InternalDtoMapper, RequestDtoMapper, type RequestDtoMapperConstructor, ResponseDtoMapper, type ResponseDtoMapperConstructor, type SchemasByValidator, serviceSchemaResolver, transformIntoInternalDtoMapper };

package/lib/src/{dtoMapper → mappers}/index.js

@@ -17,20 +17,20 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/dtoMapper/index.ts
-var dtoMapper_exports = {};
-__export(dtoMapper_exports, {
+// src/mappers/index.ts
+var mappers_exports = {};
+__export(mappers_exports, {
   RequestDtoMapper: () => RequestDtoMapper,
   ResponseDtoMapper: () => ResponseDtoMapper,
   serviceSchemaResolver: () => serviceSchemaResolver,
   transformIntoInternalDtoMapper: () => transformIntoInternalDtoMapper
 });
-module.exports = __toCommonJS(dtoMapper_exports);
+module.exports = __toCommonJS(mappers_exports);
 
-// src/dtoMapper/models/requestDtoMapper.model.ts
+// src/mappers/models/requestDtoMapper.model.ts
 var import_validator2 = require("@forklaunch/validator");
 
-// src/dtoMapper/models/baseDtoMapper.model.ts
+// src/mappers/models/baseDtoMapper.model.ts
 var import_validator = require("@forklaunch/validator");
 function construct(self, schemaValidator) {
   return new self(schemaValidator || {});
@@ -98,7 +98,7 @@ var BaseDtoMapper = class {
   }
 };
 
-// src/dtoMapper/models/requestDtoMapper.model.ts
+// src/mappers/models/requestDtoMapper.model.ts
 var RequestDtoMapper = class extends BaseDtoMapper {
   /**
    * The entity type.
@@ -164,7 +164,7 @@ var RequestDtoMapper = class extends BaseDtoMapper {
   }
 };
 
-// src/dtoMapper/models/responseDtoMapper.model.ts
+// src/mappers/models/responseDtoMapper.model.ts
 var import_validator3 = require("@forklaunch/validator");
 var ResponseDtoMapper = class extends BaseDtoMapper {
   /**
@@ -231,7 +231,7 @@ var ResponseDtoMapper = class extends BaseDtoMapper {
   }
 };
 
-// src/dtoMapper/serviceSchemaResolver.ts
+// src/mappers/serviceSchemaResolver.ts
 var import_common = require("@forklaunch/common");
 function serviceSchemaResolver(TypeBoxSchemas, ZodSchemas) {
   return (options) => {
@@ -251,10 +251,10 @@ function serviceSchemaResolver(TypeBoxSchemas, ZodSchemas) {
   };
 }
 
-// src/dtoMapper/transformIntoInternalDtoMappers.ts
-function transformIntoInternalDtoMapper(dtoMappers, schemaValidator) {
+// src/mappers/transformIntoInternalDtoMapper.ts
+function transformIntoInternalDtoMapper(mapperss, schemaValidator) {
   return Object.fromEntries(
-    Object.entries(dtoMappers).map(([key, value]) => [
+    Object.entries(mapperss).map(([key, value]) => [
       key,
       new value(schemaValidator)
     ])

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

@@ -0,0 +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"]}

package/lib/src/{dtoMapper → mappers}/index.mjs

@@ -1,9 +1,9 @@
-// src/dtoMapper/models/requestDtoMapper.model.ts
+// src/mappers/models/requestDtoMapper.model.ts
 import {
   prettyPrintParseErrors as prettyPrintParseErrors2
 } from "@forklaunch/validator";
 
-// src/dtoMapper/models/baseDtoMapper.model.ts
+// src/mappers/models/baseDtoMapper.model.ts
 import {
   prettyPrintParseErrors
 } from "@forklaunch/validator";
@@ -73,7 +73,7 @@ var BaseDtoMapper = class {
   }
 };
 
-// src/dtoMapper/models/requestDtoMapper.model.ts
+// src/mappers/models/requestDtoMapper.model.ts
 var RequestDtoMapper = class extends BaseDtoMapper {
   /**
    * The entity type.
@@ -139,7 +139,7 @@ var RequestDtoMapper = class extends BaseDtoMapper {
   }
 };
 
-// src/dtoMapper/models/responseDtoMapper.model.ts
+// src/mappers/models/responseDtoMapper.model.ts
 import {
   prettyPrintParseErrors as prettyPrintParseErrors3
 } from "@forklaunch/validator";
@@ -208,7 +208,7 @@ var ResponseDtoMapper = class extends BaseDtoMapper {
   }
 };
 
-// src/dtoMapper/serviceSchemaResolver.ts
+// src/mappers/serviceSchemaResolver.ts
 import { isNever } from "@forklaunch/common";
 function serviceSchemaResolver(TypeBoxSchemas, ZodSchemas) {
   return (options) => {
@@ -228,10 +228,10 @@ function serviceSchemaResolver(TypeBoxSchemas, ZodSchemas) {
   };
 }
 
-// src/dtoMapper/transformIntoInternalDtoMappers.ts
-function transformIntoInternalDtoMapper(dtoMappers, schemaValidator) {
+// src/mappers/transformIntoInternalDtoMapper.ts
+function transformIntoInternalDtoMapper(mapperss, schemaValidator) {
   return Object.fromEntries(
-    Object.entries(dtoMappers).map(([key, value]) => [
+    Object.entries(mapperss).map(([key, value]) => [
       key,
       new value(schemaValidator)
     ])

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,120 @@
+import { Collection, BaseEntity as BaseEntity$1, Constructor, EntityDTO, FromEntityType } from '@mikro-orm/core';
+
+/**
+ * Type representing a marked collection of items.
+ * A marked collection is a wrapper around an array that indicates it should be treated as a collection.
+ *
+ * @template T - The type of items in the collection
+ * @property {true} _collection - Marker indicating this is a collection
+ * @property {T[]} items - The array of items in the collection
+ */
+type MarkedCollection<T> = {
+    _collection: true;
+    items: T[];
+};
+
+/**
+ * Type representing the shape of data used to create an entity.
+ * Converts MikroORM collections to marked collections and omits entity properties.
+ *
+ * @template Entity - The base entity type
+ * @template T - The type being created
+ */
+type CreateShape<Entity, T> = {
+    [K in keyof Omit<T, keyof Entity>]: T[K] extends Collection<infer U> ? MarkedCollection<U> : T[K];
+};
+/**
+ * Type representing the shape of data used to update an entity.
+ * Similar to CreateShape but makes all properties optional and includes an id field.
+ *
+ * @template Entity - The base entity type
+ * @template T - The type being updated
+ */
+type UpdateShape<Entity, T> = Partial<CreateShape<Entity, T> & {
+    id: string;
+}>;
+
+/**
+ * Type representing a base entity with common fields.
+ * Extends BaseEntity with optional id, _id, createdAt, and updatedAt fields.
+ */
+type BaseEntityWithId = BaseEntity & {
+    id?: unknown;
+    _id?: unknown;
+    createdAt?: unknown;
+    updatedAt?: unknown;
+};
+/**
+ * Abstract base class for all entities in the system.
+ * Extends MikroORM's BaseEntity and provides common CRUD operations.
+ */
+declare abstract class BaseEntity extends BaseEntity$1 {
+    /**
+     * Static factory method to create a new entity instance.
+     *
+     * @template Entity - The type of entity being created
+     * @param {Constructor<Entity>} this - The entity constructor
+     * @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 method to update an entity instance.
+     *
+     * @template Entity - The type of entity being updated
+     * @param {Constructor<Entity>} this - The entity constructor
+     * @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 method to map data to an entity instance.
+     *
+     * @template Entity - The type of entity being mapped
+     * @param {Constructor<Entity>} this - The entity constructor
+     * @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;
+    /**
+     * 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;
+    /**
+     * 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;
+    /**
+     * Reads the entity data as a plain object.
+     *
+     * @returns {EntityDTO<this> | this} The entity data as a plain object
+     */
+    read(): EntityDTO<this> | 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;
+}
+
+/**
+ * Creates a marked collection from an array of items.
+ * A marked collection is a wrapper around an array that indicates it should be treated as a collection.
+ *
+ * @template T - The type of items in the collection
+ * @param {T[]} items - The array of items to wrap in a collection
+ * @returns {MarkedCollection<T>} A marked collection containing the provided items
+ * @example
+ * const users = collection([{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }]);
+ */
+declare function collection<T>(items: T[]): MarkedCollection<T>;
+
+export { BaseEntity, collection };

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

@@ -0,0 +1,120 @@
+import { Collection, BaseEntity as BaseEntity$1, Constructor, EntityDTO, FromEntityType } from '@mikro-orm/core';
+
+/**
+ * Type representing a marked collection of items.
+ * A marked collection is a wrapper around an array that indicates it should be treated as a collection.
+ *
+ * @template T - The type of items in the collection
+ * @property {true} _collection - Marker indicating this is a collection
+ * @property {T[]} items - The array of items in the collection
+ */
+type MarkedCollection<T> = {
+    _collection: true;
+    items: T[];
+};
+
+/**
+ * Type representing the shape of data used to create an entity.
+ * Converts MikroORM collections to marked collections and omits entity properties.
+ *
+ * @template Entity - The base entity type
+ * @template T - The type being created
+ */
+type CreateShape<Entity, T> = {
+    [K in keyof Omit<T, keyof Entity>]: T[K] extends Collection<infer U> ? MarkedCollection<U> : T[K];
+};
+/**
+ * Type representing the shape of data used to update an entity.
+ * Similar to CreateShape but makes all properties optional and includes an id field.
+ *
+ * @template Entity - The base entity type
+ * @template T - The type being updated
+ */
+type UpdateShape<Entity, T> = Partial<CreateShape<Entity, T> & {
+    id: string;
+}>;
+
+/**
+ * Type representing a base entity with common fields.
+ * Extends BaseEntity with optional id, _id, createdAt, and updatedAt fields.
+ */
+type BaseEntityWithId = BaseEntity & {
+    id?: unknown;
+    _id?: unknown;
+    createdAt?: unknown;
+    updatedAt?: unknown;
+};
+/**
+ * Abstract base class for all entities in the system.
+ * Extends MikroORM's BaseEntity and provides common CRUD operations.
+ */
+declare abstract class BaseEntity extends BaseEntity$1 {
+    /**
+     * Static factory method to create a new entity instance.
+     *
+     * @template Entity - The type of entity being created
+     * @param {Constructor<Entity>} this - The entity constructor
+     * @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 method to update an entity instance.
+     *
+     * @template Entity - The type of entity being updated
+     * @param {Constructor<Entity>} this - The entity constructor
+     * @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 method to map data to an entity instance.
+     *
+     * @template Entity - The type of entity being mapped
+     * @param {Constructor<Entity>} this - The entity constructor
+     * @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;
+    /**
+     * 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;
+    /**
+     * 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;
+    /**
+     * Reads the entity data as a plain object.
+     *
+     * @returns {EntityDTO<this> | this} The entity data as a plain object
+     */
+    read(): EntityDTO<this> | 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;
+}
+
+/**
+ * Creates a marked collection from an array of items.
+ * A marked collection is a wrapper around an array that indicates it should be treated as a collection.
+ *
+ * @template T - The type of items in the collection
+ * @param {T[]} items - The array of items to wrap in a collection
+ * @returns {MarkedCollection<T>} A marked collection containing the provided items
+ * @example
+ * const users = collection([{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }]);
+ */
+declare function collection<T>(items: T[]): MarkedCollection<T>;
+
+export { BaseEntity, collection };

package/lib/src/persistence/index.js

@@ -0,0 +1,152 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/persistence/index.ts
+var persistence_exports = {};
+__export(persistence_exports, {
+  BaseEntity: () => BaseEntity2,
+  collection: () => collection
+});
+module.exports = __toCommonJS(persistence_exports);
+
+// src/persistence/base.entity.ts
+var import_common = require("@forklaunch/common");
+var import_core2 = require("@mikro-orm/core");
+
+// src/persistence/transformRawDto.ts
+var import_core = require("@mikro-orm/core");
+
+// src/persistence/guards/isMarkedCollection.ts
+function isMarkedCollection(value) {
+  return typeof value === "object" && value !== null && "_collection" in value && typeof value._collection === "boolean" && value._collection;
+}
+
+// src/persistence/transformRawDto.ts
+function transformRawDto(data, entity) {
+  const transformedObject = {};
+  for (const [key, value] of Object.entries(data)) {
+    if (isMarkedCollection(value)) {
+      transformedObject[key] = new import_core.Collection(entity, value.items);
+    } else {
+      transformedObject[key] = value;
+    }
+  }
+  return transformedObject;
+}
+
+// src/persistence/base.entity.ts
+var BaseEntity2 = class extends import_core2.BaseEntity {
+  /**
+   * Static factory method to create a new entity instance.
+   *
+   * @template Entity - The type of entity being created
+   * @param {Constructor<Entity>} this - The entity constructor
+   * @param {...Parameters<Entity['create']>} args - Arguments for entity creation
+   * @returns {Entity} A new entity instance
+   */
+  static create(...args) {
+    const [data, ...additionalArgs] = args;
+    return new this().create(
+      data,
+      ...additionalArgs
+    );
+  }
+  /**
+   * Static method to update an entity instance.
+   *
+   * @template Entity - The type of entity being updated
+   * @param {Constructor<Entity>} this - The entity constructor
+   * @param {...Parameters<Entity['update']>} args - Arguments for entity update
+   * @returns {Entity} The updated entity instance
+   */
+  static update(...args) {
+    const [data, ...additionalArgs] = args;
+    return new this().update(
+      data,
+      ...additionalArgs
+    );
+  }
+  /**
+   * Static method to map data to an entity instance.
+   *
+   * @template Entity - The type of entity being mapped
+   * @param {Constructor<Entity>} this - The entity constructor
+   * @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);
+  }
+  /**
+   * 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) {
+    return Object.assign(this, transformRawDto(data, 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) {
+    (0, import_core2.wrap)(this).assign(
+      (0, import_common.stripUndefinedProperties)(transformRawDto(data, this))
+    );
+    return this;
+  }
+  /**
+   * 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();
+    }
+    return 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) {
+    (0, import_core2.wrap)(this).assign(data);
+    return this;
+  }
+};
+
+// src/persistence/collection.ts
+function collection(items) {
+  return {
+    _collection: true,
+    items
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseEntity,
+  collection
+});
+//# sourceMappingURL=index.js.map