@mikro-orm/core 7.0.4-dev.8 → 7.0.4

package/entity/EntityAssigner.js

@@ -8,243 +8,244 @@ import { EntityHelper } from './EntityHelper.js';
 import { ValidationError } from '../errors.js';
 /** Handles assigning data to entities, resolving relations, and propagating changes. */
 export class EntityAssigner {
-    /** Assigns the given data to the entity, resolving relations and handling custom types. */
-    static assign(entity, data, options = {}) {
-        let opts = options;
-        if (opts.visited?.has(entity)) {
-            return entity;
-        }
-        EntityHelper.ensurePropagation(entity);
-        opts.visited ??= new Set();
-        opts.visited.add(entity);
-        const wrapped = helper(entity);
-        opts = {
-            ...wrapped.__config.get('assign'),
-            schema: wrapped.__schema,
-            ...opts, // allow overriding the defaults
-        };
-        const meta = wrapped.__meta;
-        const props = meta.properties;
-        Object.keys(data).forEach(prop => {
-            return EntityAssigner.assignProperty(entity, prop, props, data, {
-                ...opts,
-                em: opts.em || wrapped.__em,
-                platform: wrapped.__platform,
-            });
-        });
-        return entity;
-    }
-    static assignProperty(entity, propName, props, data, options) {
-        let value = data[propName];
-        const onlyProperties = options.onlyProperties && !(propName in props);
-        const ignoreUndefined = options.ignoreUndefined === true && value === undefined;
-        if (onlyProperties || ignoreUndefined) {
-            return;
-        }
-        const prop = { ...props[propName], name: propName };
-        if (prop && options.onlyOwnProperties) {
-            if ([ReferenceKind.ONE_TO_MANY].includes(prop.kind)) {
-                return;
-            }
-            if ([ReferenceKind.MANY_TO_MANY].includes(prop.kind)) {
-                if (!prop.owner) {
-                    return;
-                }
-                else if (value?.map) {
-                    value = value.map((v) => Utils.extractPK(v, prop.targetMeta));
-                }
-            }
-            if ([ReferenceKind.MANY_TO_ONE, ReferenceKind.ONE_TO_ONE].includes(prop.kind)) {
-                value = Utils.extractPK(value, prop.targetMeta);
-            }
-        }
-        if (propName in props && !prop.nullable && value == null) {
-            throw new Error(`You must pass a non-${value} value to the property ${propName} of entity ${entity.constructor.name}.`);
-        }
-        // create collection instance if its missing so old items can be deleted with orphan removal
-        if ([ReferenceKind.MANY_TO_MANY, ReferenceKind.ONE_TO_MANY].includes(prop?.kind) && entity[prop.name] == null) {
-            entity[prop.name] = Collection.create(entity, prop.name, undefined, helper(entity).isInitialized());
-        }
-        if (prop && Utils.isCollection(entity[prop.name])) {
-            return EntityAssigner.assignCollection(entity, entity[prop.name], value, prop, options.em, options);
-        }
-        const customType = prop?.customType;
-        if (options.convertCustomTypes && customType && prop.kind === ReferenceKind.SCALAR && !Utils.isEntity(data)) {
-            value = customType.convertToJSValue(value, options.platform);
-        }
-        if ([ReferenceKind.MANY_TO_ONE, ReferenceKind.ONE_TO_ONE].includes(prop?.kind) && value != null) {
-            if (options.updateNestedEntities &&
-                Object.hasOwn(entity, propName) &&
-                Utils.isEntity(entity[propName], true) &&
-                Utils.isPlainObject(value)) {
-                const unwrappedEntity = Reference.unwrapReference(entity[propName]);
-                const wrapped = helper(unwrappedEntity);
-                if (options.updateByPrimaryKey) {
-                    const pk = Utils.extractPK(value, prop.targetMeta);
-                    if (pk) {
-                        const ref = options.em.getReference(prop.targetMeta.class, pk, options);
-                        // if the PK differs, we want to change the target entity, not update it
-                        const wrappedChild = helper(ref);
-                        const sameTarget = wrappedChild.getSerializedPrimaryKey() === wrapped.getSerializedPrimaryKey();
-                        if (wrappedChild.__managed && wrappedChild.isInitialized() && sameTarget) {
-                            return EntityAssigner.assign(ref, value, options);
-                        }
-                    }
-                    return EntityAssigner.assignReference(entity, value, prop, options.em, options);
-                }
-                if (wrapped.__managed && wrap(unwrappedEntity).isInitialized()) {
-                    return EntityAssigner.assign(unwrappedEntity, value, options);
-                }
-            }
-            return EntityAssigner.assignReference(entity, value, prop, options.em, options);
-        }
-        if (prop.kind === ReferenceKind.SCALAR && SCALAR_TYPES.has(prop.runtimeType) && (prop.setter || !prop.getter)) {
-            validateProperty(prop, value, entity);
-            return (entity[prop.name] = value);
-        }
-        if (prop.kind === ReferenceKind.EMBEDDED && EntityAssigner.validateEM(options.em)) {
-            return EntityAssigner.assignEmbeddable(entity, value, prop, options.em, options);
-        }
-        if (options.mergeObjectProperties &&
-            Utils.isPlainObject(entity[propName]) &&
-            Utils.isPlainObject(value)) {
-            entity[propName] ??= {};
-            entity[propName] = Utils.merge({}, entity[propName], value);
-        }
-        else if (!prop || prop.setter || !prop.getter) {
-            entity[propName] = value;
-        }
+  /** Assigns the given data to the entity, resolving relations and handling custom types. */
+  static assign(entity, data, options = {}) {
+    let opts = options;
+    if (opts.visited?.has(entity)) {
+      return entity;
     }
-    /**
-     * auto-wire 1:1 inverse side with owner as in no-sql drivers it can't be joined
-     * also makes sure the link is bidirectional when creating new entities from nested structures
-     * @internal
-     */
-    static autoWireOneToOne(prop, entity) {
-        const ref = entity[prop.name];
-        if (prop.kind !== ReferenceKind.ONE_TO_ONE || !Utils.isEntity(ref)) {
-            return;
-        }
-        const meta2 = helper(ref).__meta;
-        const prop2 = meta2.properties[prop.inversedBy || prop.mappedBy];
-        /* v8 ignore next */
-        if (prop2 && !ref[prop2.name]) {
-            if (Reference.isReference(ref)) {
-                ref.unwrap()[prop2.name] = Reference.wrapReference(entity, prop2);
-            }
-            else {
-                ref[prop2.name] = Reference.wrapReference(entity, prop2);
-            }
-        }
+    EntityHelper.ensurePropagation(entity);
+    opts.visited ??= new Set();
+    opts.visited.add(entity);
+    const wrapped = helper(entity);
+    opts = {
+      ...wrapped.__config.get('assign'),
+      schema: wrapped.__schema,
+      ...opts, // allow overriding the defaults
+    };
+    const meta = wrapped.__meta;
+    const props = meta.properties;
+    Object.keys(data).forEach(prop => {
+      return EntityAssigner.assignProperty(entity, prop, props, data, {
+        ...opts,
+        em: opts.em || wrapped.__em,
+        platform: wrapped.__platform,
+      });
+    });
+    return entity;
+  }
+  static assignProperty(entity, propName, props, data, options) {
+    let value = data[propName];
+    const onlyProperties = options.onlyProperties && !(propName in props);
+    const ignoreUndefined = options.ignoreUndefined === true && value === undefined;
+    if (onlyProperties || ignoreUndefined) {
+      return;
     }
-    static validateEM(em) {
-        if (!em) {
-            throw new Error(`To use assign() on not managed entities, explicitly provide EM instance: wrap(entity).assign(data, { em: orm.em })`);
-        }
-        return true;
+    const prop = { ...props[propName], name: propName };
+    if (prop && options.onlyOwnProperties) {
+      if ([ReferenceKind.ONE_TO_MANY].includes(prop.kind)) {
+        return;
+      }
+      if ([ReferenceKind.MANY_TO_MANY].includes(prop.kind)) {
+        if (!prop.owner) {
+          return;
+        } else if (value?.map) {
+          value = value.map(v => Utils.extractPK(v, prop.targetMeta));
+        }
+      }
+      if ([ReferenceKind.MANY_TO_ONE, ReferenceKind.ONE_TO_ONE].includes(prop.kind)) {
+        value = Utils.extractPK(value, prop.targetMeta);
+      }
     }
-    static assignReference(entity, value, prop, em, options) {
-        if (Utils.isEntity(value, true)) {
-            entity[prop.name] = Reference.wrapReference(value, prop);
-        }
-        else if (Utils.isPrimaryKey(value, true) && EntityAssigner.validateEM(em)) {
-            entity[prop.name] = prop.mapToPk
-                ? value
-                : Reference.wrapReference(em.getReference(prop.targetMeta.class, value, options), prop);
-        }
-        else if (Utils.isPlainObject(value) && options.merge && EntityAssigner.validateEM(em)) {
-            entity[prop.name] = Reference.wrapReference(em.merge(prop.targetMeta.class, value, options), prop);
-        }
-        else if (Utils.isPlainObject(value) && EntityAssigner.validateEM(em)) {
-            entity[prop.name] = Reference.wrapReference(em.create(prop.targetMeta.class, value, options), prop);
-        }
-        else {
-            const name = entity.constructor.name;
-            throw new Error(`Invalid reference value provided for '${name}.${prop.name}' in ${name}.assign(): ${JSON.stringify(value)}`);
-        }
-        EntityAssigner.autoWireOneToOne(prop, entity);
-    }
-    static assignCollection(entity, collection, value, prop, em, options) {
-        const invalid = [];
-        const items = Utils.asArray(value).map((item, idx) => {
-            // try to propagate missing owning side reference to the payload first
-            const prop2 = prop.targetMeta?.properties[prop.mappedBy];
-            if (Utils.isPlainObject(item) && prop2 && item[prop2.name] == null) {
-                item = { ...item, [prop2.name]: Reference.wrapReference(entity, prop2) };
-            }
-            if (options.updateNestedEntities && options.updateByPrimaryKey && Utils.isPlainObject(item)) {
-                const pk = Utils.extractPK(item, prop.targetMeta);
-                if (pk && EntityAssigner.validateEM(em)) {
-                    const ref = em.getUnitOfWork().getById(prop.targetMeta.class, pk, options.schema);
-                    if (ref) {
-                        return EntityAssigner.assign(ref, item, options);
-                    }
-                }
-                return this.createCollectionItem(item, em, prop, invalid, options);
-            }
-            /* v8 ignore next */
-            if (options.updateNestedEntities &&
-                !options.updateByPrimaryKey &&
-                collection[idx] &&
-                helper(collection[idx])?.isInitialized()) {
-                return EntityAssigner.assign(collection[idx], item, options);
+    if (propName in props && !prop.nullable && value == null) {
+      throw new Error(
+        `You must pass a non-${value} value to the property ${propName} of entity ${entity.constructor.name}.`,
+      );
+    }
+    // create collection instance if its missing so old items can be deleted with orphan removal
+    if ([ReferenceKind.MANY_TO_MANY, ReferenceKind.ONE_TO_MANY].includes(prop?.kind) && entity[prop.name] == null) {
+      entity[prop.name] = Collection.create(entity, prop.name, undefined, helper(entity).isInitialized());
+    }
+    if (prop && Utils.isCollection(entity[prop.name])) {
+      return EntityAssigner.assignCollection(entity, entity[prop.name], value, prop, options.em, options);
+    }
+    const customType = prop?.customType;
+    if (options.convertCustomTypes && customType && prop.kind === ReferenceKind.SCALAR && !Utils.isEntity(data)) {
+      value = customType.convertToJSValue(value, options.platform);
+    }
+    if ([ReferenceKind.MANY_TO_ONE, ReferenceKind.ONE_TO_ONE].includes(prop?.kind) && value != null) {
+      if (
+        options.updateNestedEntities &&
+        Object.hasOwn(entity, propName) &&
+        Utils.isEntity(entity[propName], true) &&
+        Utils.isPlainObject(value)
+      ) {
+        const unwrappedEntity = Reference.unwrapReference(entity[propName]);
+        const wrapped = helper(unwrappedEntity);
+        if (options.updateByPrimaryKey) {
+          const pk = Utils.extractPK(value, prop.targetMeta);
+          if (pk) {
+            const ref = options.em.getReference(prop.targetMeta.class, pk, options);
+            // if the PK differs, we want to change the target entity, not update it
+            const wrappedChild = helper(ref);
+            const sameTarget = wrappedChild.getSerializedPrimaryKey() === wrapped.getSerializedPrimaryKey();
+            if (wrappedChild.__managed && wrappedChild.isInitialized() && sameTarget) {
+              return EntityAssigner.assign(ref, value, options);
             }
-            return this.createCollectionItem(item, em, prop, invalid, options);
-        });
-        if (invalid.length > 0) {
-            const name = entity.constructor.name;
-            throw ValidationError.invalidCollectionValues(name, prop.name, invalid);
+          }
+          return EntityAssigner.assignReference(entity, value, prop, options.em, options);
         }
-        if (Array.isArray(value)) {
-            collection.set(items);
-        }
-        else {
-            // append to the collection in case of assigning a single value instead of array
-            collection.add(items);
+        if (wrapped.__managed && wrap(unwrappedEntity).isInitialized()) {
+          return EntityAssigner.assign(unwrappedEntity, value, options);
         }
+      }
+      return EntityAssigner.assignReference(entity, value, prop, options.em, options);
     }
-    static assignEmbeddable(entity, value, prop, em, options) {
-        const propName = prop.embedded ? prop.embedded[1] : prop.name;
-        if (value == null) {
-            entity[propName] = value;
-            return;
-        }
-        // if the value is not an array, we just push, otherwise we replace the array
-        if (prop.array && (Array.isArray(value) || entity[propName] == null)) {
-            entity[propName] = [];
-        }
-        if (prop.array) {
-            return Utils.asArray(value).forEach(item => {
-                const tmp = {};
-                this.assignEmbeddable(tmp, item, { ...prop, array: false }, em, options);
-                entity[propName].push(...Object.values(tmp));
-            });
-        }
-        const create = () => EntityAssigner.validateEM(em) &&
-            em.getEntityFactory().createEmbeddable(prop.targetMeta.class, value, {
-                convertCustomTypes: options.convertCustomTypes,
-                newEntity: options.mergeEmbeddedProperties ? !('propName' in entity) : true,
-            });
-        entity[propName] = (options.mergeEmbeddedProperties ? entity[propName] || create() : create());
-        Object.keys(value).forEach(key => {
-            EntityAssigner.assignProperty(entity[propName], key, prop.embeddedProps, value, options);
-        });
-    }
-    static createCollectionItem(item, em, prop, invalid, options) {
-        if (Utils.isEntity(item)) {
-            return item;
-        }
-        if (Utils.isPrimaryKey(item) && EntityAssigner.validateEM(em)) {
-            return em.getReference(prop.targetMeta.class, item, options);
-        }
-        if (Utils.isPlainObject(item) && options.merge && EntityAssigner.validateEM(em)) {
-            return em.merge(prop.targetMeta.class, item, options);
-        }
-        if (Utils.isPlainObject(item) && EntityAssigner.validateEM(em)) {
-            return em.create(prop.targetMeta.class, item, options);
-        }
-        invalid.push(item);
-        return item;
+    if (prop.kind === ReferenceKind.SCALAR && SCALAR_TYPES.has(prop.runtimeType) && (prop.setter || !prop.getter)) {
+      validateProperty(prop, value, entity);
+      return (entity[prop.name] = value);
+    }
+    if (prop.kind === ReferenceKind.EMBEDDED && EntityAssigner.validateEM(options.em)) {
+      return EntityAssigner.assignEmbeddable(entity, value, prop, options.em, options);
+    }
+    if (options.mergeObjectProperties && Utils.isPlainObject(entity[propName]) && Utils.isPlainObject(value)) {
+      entity[propName] ??= {};
+      entity[propName] = Utils.merge({}, entity[propName], value);
+    } else if (!prop || prop.setter || !prop.getter) {
+      entity[propName] = value;
+    }
+  }
+  /**
+   * auto-wire 1:1 inverse side with owner as in no-sql drivers it can't be joined
+   * also makes sure the link is bidirectional when creating new entities from nested structures
+   * @internal
+   */
+  static autoWireOneToOne(prop, entity) {
+    const ref = entity[prop.name];
+    if (prop.kind !== ReferenceKind.ONE_TO_ONE || !Utils.isEntity(ref)) {
+      return;
+    }
+    const meta2 = helper(ref).__meta;
+    const prop2 = meta2.properties[prop.inversedBy || prop.mappedBy];
+    /* v8 ignore next */
+    if (prop2 && !ref[prop2.name]) {
+      if (Reference.isReference(ref)) {
+        ref.unwrap()[prop2.name] = Reference.wrapReference(entity, prop2);
+      } else {
+        ref[prop2.name] = Reference.wrapReference(entity, prop2);
+      }
+    }
+  }
+  static validateEM(em) {
+    if (!em) {
+      throw new Error(
+        `To use assign() on not managed entities, explicitly provide EM instance: wrap(entity).assign(data, { em: orm.em })`,
+      );
+    }
+    return true;
+  }
+  static assignReference(entity, value, prop, em, options) {
+    if (Utils.isEntity(value, true)) {
+      entity[prop.name] = Reference.wrapReference(value, prop);
+    } else if (Utils.isPrimaryKey(value, true) && EntityAssigner.validateEM(em)) {
+      entity[prop.name] = prop.mapToPk
+        ? value
+        : Reference.wrapReference(em.getReference(prop.targetMeta.class, value, options), prop);
+    } else if (Utils.isPlainObject(value) && options.merge && EntityAssigner.validateEM(em)) {
+      entity[prop.name] = Reference.wrapReference(em.merge(prop.targetMeta.class, value, options), prop);
+    } else if (Utils.isPlainObject(value) && EntityAssigner.validateEM(em)) {
+      entity[prop.name] = Reference.wrapReference(em.create(prop.targetMeta.class, value, options), prop);
+    } else {
+      const name = entity.constructor.name;
+      throw new Error(
+        `Invalid reference value provided for '${name}.${prop.name}' in ${name}.assign(): ${JSON.stringify(value)}`,
+      );
+    }
+    EntityAssigner.autoWireOneToOne(prop, entity);
+  }
+  static assignCollection(entity, collection, value, prop, em, options) {
+    const invalid = [];
+    const items = Utils.asArray(value).map((item, idx) => {
+      // try to propagate missing owning side reference to the payload first
+      const prop2 = prop.targetMeta?.properties[prop.mappedBy];
+      if (Utils.isPlainObject(item) && prop2 && item[prop2.name] == null) {
+        item = { ...item, [prop2.name]: Reference.wrapReference(entity, prop2) };
+      }
+      if (options.updateNestedEntities && options.updateByPrimaryKey && Utils.isPlainObject(item)) {
+        const pk = Utils.extractPK(item, prop.targetMeta);
+        if (pk && EntityAssigner.validateEM(em)) {
+          const ref = em.getUnitOfWork().getById(prop.targetMeta.class, pk, options.schema);
+          if (ref) {
+            return EntityAssigner.assign(ref, item, options);
+          }
+        }
+        return this.createCollectionItem(item, em, prop, invalid, options);
+      }
+      /* v8 ignore next */
+      if (
+        options.updateNestedEntities &&
+        !options.updateByPrimaryKey &&
+        collection[idx] &&
+        helper(collection[idx])?.isInitialized()
+      ) {
+        return EntityAssigner.assign(collection[idx], item, options);
+      }
+      return this.createCollectionItem(item, em, prop, invalid, options);
+    });
+    if (invalid.length > 0) {
+      const name = entity.constructor.name;
+      throw ValidationError.invalidCollectionValues(name, prop.name, invalid);
+    }
+    if (Array.isArray(value)) {
+      collection.set(items);
+    } else {
+      // append to the collection in case of assigning a single value instead of array
+      collection.add(items);
+    }
+  }
+  static assignEmbeddable(entity, value, prop, em, options) {
+    const propName = prop.embedded ? prop.embedded[1] : prop.name;
+    if (value == null) {
+      entity[propName] = value;
+      return;
+    }
+    // if the value is not an array, we just push, otherwise we replace the array
+    if (prop.array && (Array.isArray(value) || entity[propName] == null)) {
+      entity[propName] = [];
+    }
+    if (prop.array) {
+      return Utils.asArray(value).forEach(item => {
+        const tmp = {};
+        this.assignEmbeddable(tmp, item, { ...prop, array: false }, em, options);
+        entity[propName].push(...Object.values(tmp));
+      });
+    }
+    const create = () =>
+      EntityAssigner.validateEM(em) &&
+      em.getEntityFactory().createEmbeddable(prop.targetMeta.class, value, {
+        convertCustomTypes: options.convertCustomTypes,
+        newEntity: options.mergeEmbeddedProperties ? !('propName' in entity) : true,
+      });
+    entity[propName] = options.mergeEmbeddedProperties ? entity[propName] || create() : create();
+    Object.keys(value).forEach(key => {
+      EntityAssigner.assignProperty(entity[propName], key, prop.embeddedProps, value, options);
+    });
+  }
+  static createCollectionItem(item, em, prop, invalid, options) {
+    if (Utils.isEntity(item)) {
+      return item;
+    }
+    if (Utils.isPrimaryKey(item) && EntityAssigner.validateEM(em)) {
+      return em.getReference(prop.targetMeta.class, item, options);
+    }
+    if (Utils.isPlainObject(item) && options.merge && EntityAssigner.validateEM(em)) {
+      return em.merge(prop.targetMeta.class, item, options);
+    }
+    if (Utils.isPlainObject(item) && EntityAssigner.validateEM(em)) {
+      return em.create(prop.targetMeta.class, item, options);
     }
+    invalid.push(item);
+    return item;
+  }
 }
 export const assign = EntityAssigner.assign;

package/entity/EntityFactory.d.ts

@@ -3,61 +3,73 @@ import type { EntityManager } from '../EntityManager.js';
 import type { EntityComparator } from '../utils/EntityComparator.js';
 /** @internal Options for creating and merging entities via the EntityFactory. */
 export interface FactoryOptions {
-    /** Whether the entity should be marked as initialized. */
-    initialized?: boolean;
-    /** Whether the entity is being newly created (uses constructor). */
-    newEntity?: boolean;
-    /**
-     * Property `onCreate` hooks are normally executed during `flush` operation.
-     * With this option, they will be processed early inside `em.create()` method.
-     */
-    processOnCreateHooksEarly?: boolean;
-    /** Whether to merge the entity into the identity map. */
-    merge?: boolean;
-    /** Whether to refresh an already loaded entity with new data. */
-    refresh?: boolean;
-    /** Whether to convert custom types during hydration. */
-    convertCustomTypes?: boolean;
-    /** Whether to recompute the entity snapshot after creation. */
-    recomputeSnapshot?: boolean;
-    /** Schema from FindOptions, overrides default schema. */
-    schema?: string;
-    /** Parent entity schema for nested entity creation. */
-    parentSchema?: string;
-    /** Whether to normalize accessors to the correct property names (normally handled via result mapper). */
-    normalizeAccessors?: boolean;
-    /**
-     * Property name to use for identity map lookup instead of the primary key.
-     * This is useful for creating references by unique non-PK properties.
-     */
-    key?: string;
+  /** Whether the entity should be marked as initialized. */
+  initialized?: boolean;
+  /** Whether the entity is being newly created (uses constructor). */
+  newEntity?: boolean;
+  /**
+   * Property `onCreate` hooks are normally executed during `flush` operation.
+   * With this option, they will be processed early inside `em.create()` method.
+   */
+  processOnCreateHooksEarly?: boolean;
+  /** Whether to merge the entity into the identity map. */
+  merge?: boolean;
+  /** Whether to refresh an already loaded entity with new data. */
+  refresh?: boolean;
+  /** Whether to convert custom types during hydration. */
+  convertCustomTypes?: boolean;
+  /** Whether to recompute the entity snapshot after creation. */
+  recomputeSnapshot?: boolean;
+  /** Schema from FindOptions, overrides default schema. */
+  schema?: string;
+  /** Parent entity schema for nested entity creation. */
+  parentSchema?: string;
+  /** Whether to normalize accessors to the correct property names (normally handled via result mapper). */
+  normalizeAccessors?: boolean;
+  /**
+   * Property name to use for identity map lookup instead of the primary key.
+   * This is useful for creating references by unique non-PK properties.
+   */
+  key?: string;
 }
 /** @internal Factory responsible for creating, merging, and hydrating entity instances. */
 export declare class EntityFactory {
-    #private;
-    constructor(em: EntityManager);
-    /** Creates a new entity instance or returns an existing one from the identity map, hydrating it with the provided data. */
-    create<T extends object, P extends string = string>(entityName: EntityName<T>, data: EntityData<T>, options?: FactoryOptions): New<T, P>;
-    /** Merges new data into an existing entity, preserving user-modified properties. */
-    mergeData<T extends object>(meta: EntityMetadata<T>, entity: T, data: EntityData<T>, options?: FactoryOptions): void;
-    /** Creates or retrieves an uninitialized entity reference by its primary key or alternate key. */
-    createReference<T extends object>(entityName: EntityName<T>, id: Primary<T> | Primary<T>[] | Record<string, Primary<T>>, options?: Pick<FactoryOptions, 'merge' | 'convertCustomTypes' | 'schema' | 'key'>): T;
-    /** Creates an embeddable entity instance from the provided data. */
-    createEmbeddable<T extends object>(entityName: EntityName<T>, data: EntityData<T>, options?: Pick<FactoryOptions, 'newEntity' | 'convertCustomTypes'>): T;
-    /** Returns the EntityComparator instance used for diffing entities. */
-    getComparator(): EntityComparator;
-    private createEntity;
-    private assignDefaultValues;
-    private hydrate;
-    private findEntity;
-    private processDiscriminatorColumn;
-    /**
-     * denormalize PK to value required by driver (e.g. ObjectId)
-     */
-    private denormalizePrimaryKey;
-    /**
-     * returns parameters for entity constructor, creating references from plain ids
-     */
-    private extractConstructorParams;
-    private get unitOfWork();
+  #private;
+  constructor(em: EntityManager);
+  /** Creates a new entity instance or returns an existing one from the identity map, hydrating it with the provided data. */
+  create<T extends object, P extends string = string>(
+    entityName: EntityName<T>,
+    data: EntityData<T>,
+    options?: FactoryOptions,
+  ): New<T, P>;
+  /** Merges new data into an existing entity, preserving user-modified properties. */
+  mergeData<T extends object>(meta: EntityMetadata<T>, entity: T, data: EntityData<T>, options?: FactoryOptions): void;
+  /** Creates or retrieves an uninitialized entity reference by its primary key or alternate key. */
+  createReference<T extends object>(
+    entityName: EntityName<T>,
+    id: Primary<T> | Primary<T>[] | Record<string, Primary<T>>,
+    options?: Pick<FactoryOptions, 'merge' | 'convertCustomTypes' | 'schema' | 'key'>,
+  ): T;
+  /** Creates an embeddable entity instance from the provided data. */
+  createEmbeddable<T extends object>(
+    entityName: EntityName<T>,
+    data: EntityData<T>,
+    options?: Pick<FactoryOptions, 'newEntity' | 'convertCustomTypes'>,
+  ): T;
+  /** Returns the EntityComparator instance used for diffing entities. */
+  getComparator(): EntityComparator;
+  private createEntity;
+  private assignDefaultValues;
+  private hydrate;
+  private findEntity;
+  private processDiscriminatorColumn;
+  /**
+   * denormalize PK to value required by driver (e.g. ObjectId)
+   */
+  private denormalizePrimaryKey;
+  /**
+   * returns parameters for entity constructor, creating references from plain ids
+   */
+  private extractConstructorParams;
+  private get unitOfWork();
 }