@forklaunch/core 0.9.2 → 0.9.4

package/lib/src/persistence/index.js

@@ -1,169 +0,0 @@
-"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 async create(...args) {
-    const [data, ...additionalArgs] = args;
-    const entity = new this();
-    await entity.create(
-      data,
-      ...additionalArgs
-    );
-    return 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 async update(...args) {
-    const [data, ...additionalArgs] = args;
-    const entity = new this();
-    await entity.update(
-      data,
-      ...additionalArgs
-    );
-    return 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 async map(data) {
-    const entity = new this();
-    await entity.map(data);
-    return 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
-   */
-  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.
-   *
-   * @param {UpdateShape<BaseEntityWithId, this>} data - The data to update the entity with
-   * @returns {this} The updated entity instance
-   */
-  async update(data) {
-    const entity = (0, import_core2.wrap)(this);
-    entity.assign(
-      (0, import_common.stripUndefinedProperties)(transformRawDto(data, this))
-    );
-    return entity.toObject();
-  }
-  /**
-   * Reads the entity data as a plain object.
-   *
-   * @returns {EntityDTO<this> | this} The entity data as a plain object
-   */
-  async read() {
-    const entity = await (0, import_core2.wrap)(this).init();
-    if (!entity) {
-      throw new Error("Entity not initialized");
-    }
-    return entity.toObject();
-  }
-  /**
-   * Maps data to the entity instance.
-   *
-   * @param {Partial<EntityDTO<FromEntityType<this>>>} data - The data to map
-   * @returns {this} The entity instance with mapped data
-   */
-  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;
-  }
-};
-
-// 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

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

@@ -1 +0,0 @@
-{"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

@@ -1,144 +0,0 @@
-// src/persistence/base.entity.ts
-import { stripUndefinedProperties } from "@forklaunch/common";
-import {
-  BaseEntity as MikroOrmBaseEntity,
-  wrap
-} from "@mikro-orm/core";
-
-// src/persistence/transformRawDto.ts
-import { Collection } from "@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 Collection(entity, value.items);
-    } else {
-      transformedObject[key] = value;
-    }
-  }
-  return transformedObject;
-}
-
-// src/persistence/base.entity.ts
-var BaseEntity2 = class extends MikroOrmBaseEntity {
-  /**
-   * 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 async create(...args) {
-    const [data, ...additionalArgs] = args;
-    const entity = new this();
-    await entity.create(
-      data,
-      ...additionalArgs
-    );
-    return 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 async update(...args) {
-    const [data, ...additionalArgs] = args;
-    const entity = new this();
-    await entity.update(
-      data,
-      ...additionalArgs
-    );
-    return 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 async map(data) {
-    const entity = new this();
-    await entity.map(data);
-    return 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
-   */
-  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.
-   *
-   * @param {UpdateShape<BaseEntityWithId, this>} data - The data to update the entity with
-   * @returns {this} The updated entity instance
-   */
-  async update(data) {
-    const entity = wrap(this);
-    entity.assign(
-      stripUndefinedProperties(transformRawDto(data, this))
-    );
-    return entity.toObject();
-  }
-  /**
-   * Reads the entity data as a plain object.
-   *
-   * @returns {EntityDTO<this> | this} The entity data as a plain object
-   */
-  async read() {
-    const entity = await wrap(this).init();
-    if (!entity) {
-      throw new Error("Entity not initialized");
-    }
-    return entity.toObject();
-  }
-  /**
-   * Maps data to the entity instance.
-   *
-   * @param {Partial<EntityDTO<FromEntityType<this>>>} data - The data to map
-   * @returns {this} The entity instance with mapped data
-   */
-  async map(data) {
-    const entity = await wrap(this).init();
-    if (!entity) {
-      throw new Error("Entity not initialized");
-    }
-    entity.assign(data);
-    return entity;
-  }
-};
-
-// src/persistence/collection.ts
-function collection(items) {
-  return {
-    _collection: true,
-    items
-  };
-}
-export {
-  BaseEntity2 as BaseEntity,
-  collection
-};
-//# sourceMappingURL=index.mjs.map

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

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