@forklaunch/core 0.8.7 → 0.8.9

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

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

@@ -1,152 +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 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

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 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"]}

package/lib/src/persistence/index.mjs

@@ -1,127 +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 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) {
-    wrap(this).assign(
-      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 wrap(this).toPOJO === "function") {
-      return 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) {
-    wrap(this).assign(data);
-    return this;
-  }
-};
-
-// 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 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"]}