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

package/utils/DataloaderUtils.js

@@ -3,15 +3,15 @@ import { helper } from '../entity/wrap.js';
 import { Reference } from '../entity/Reference.js';
 import { Utils } from './Utils.js';
 export class DataloaderUtils {
-    static DataLoader;
-    /**
-     * Groups identified references by entity and returns a Map with the
-     * class name as the index and the corresponding primary keys as the value.
-     */
-    static groupPrimaryKeysByEntityAndOpts(refsWithOpts) {
-        const map = new Map();
-        for (const [ref, opts] of refsWithOpts) {
-            /* The key is a combination of the uniqueName (a unique table name based identifier) and a stringified version if the load options because we want
+  static DataLoader;
+  /**
+   * Groups identified references by entity and returns a Map with the
+   * class name as the index and the corresponding primary keys as the value.
+   */
+  static groupPrimaryKeysByEntityAndOpts(refsWithOpts) {
+    const map = new Map();
+    for (const [ref, opts] of refsWithOpts) {
+      /* The key is a combination of the uniqueName (a unique table name based identifier) and a stringified version if the load options because we want
                to map each combination of entities/options into separate find queries in order to return accurate results.
                This could be further optimized finding the "lowest common denominator" among the different options
                for each Entity and firing a single query for each Entity instead of Entity+options combination.
@@ -24,210 +24,215 @@ export class DataloaderUtils {
                Thus such approach should probably be configurable, if not opt-in.
                NOTE: meta + opts multi maps (https://github.com/martian17/ds-js) might be a more elegant way
                to implement this but not necessarily faster.  */
-            const key = `${helper(ref).__meta.uniqueName}|${JSON.stringify(opts ?? {})}`;
-            let primaryKeysSet = map.get(key);
-            if (primaryKeysSet == null) {
-                primaryKeysSet = new Set();
-                map.set(key, primaryKeysSet);
-            }
-            primaryKeysSet.add(helper(ref).getPrimaryKey());
-        }
-        return map;
+      const key = `${helper(ref).__meta.uniqueName}|${JSON.stringify(opts ?? {})}`;
+      let primaryKeysSet = map.get(key);
+      if (primaryKeysSet == null) {
+        primaryKeysSet = new Set();
+        map.set(key, primaryKeysSet);
+      }
+      primaryKeysSet.add(helper(ref).getPrimaryKey());
     }
-    /**
-     * Returns the reference dataloader batchLoadFn, which aggregates references by entity,
-     * makes one query per entity and maps each input reference to the corresponding result.
-     */
-    static getRefBatchLoadFn(em) {
-        return async (refsWithOpts) => {
-            const groupedIdsMap = DataloaderUtils.groupPrimaryKeysByEntityAndOpts(refsWithOpts);
-            const promises = Array.from(groupedIdsMap).map(([key, idsSet]) => {
-                const uniqueName = key.substring(0, key.indexOf('|'));
-                const opts = JSON.parse(key.substring(key.indexOf('|') + 1));
-                const meta = em.getMetadata().getByUniqueName(uniqueName);
-                return em.find(meta.class, Array.from(idsSet), opts);
-            });
-            await Promise.all(promises);
-            /* Instead of assigning each find result to the original reference we use a shortcut
+    return map;
+  }
+  /**
+   * Returns the reference dataloader batchLoadFn, which aggregates references by entity,
+   * makes one query per entity and maps each input reference to the corresponding result.
+   */
+  static getRefBatchLoadFn(em) {
+    return async refsWithOpts => {
+      const groupedIdsMap = DataloaderUtils.groupPrimaryKeysByEntityAndOpts(refsWithOpts);
+      const promises = Array.from(groupedIdsMap).map(([key, idsSet]) => {
+        const uniqueName = key.substring(0, key.indexOf('|'));
+        const opts = JSON.parse(key.substring(key.indexOf('|') + 1));
+        const meta = em.getMetadata().getByUniqueName(uniqueName);
+        return em.find(meta.class, Array.from(idsSet), opts);
+      });
+      await Promise.all(promises);
+      /* Instead of assigning each find result to the original reference we use a shortcut
               which takes advantage of the already existing Mikro-ORM caching mechanism:
               when it calls ref.unwrap it will automatically retrieve the entity
               from the cache (it will hit the cache because of the previous find query).
               This trick won't be possible for collections where we will be forced to map the results. */
-            return refsWithOpts.map(([ref]) => ref.unwrap());
-        };
-    }
-    /**
-     * Groups collections by entity and returns a Map whose keys are the entity names and whose values are filter Maps
-     * which we can use to narrow down the find query to return just the items of the collections that have been dataloaded.
-     * The entries of the filter Map will be used as the values of an $or operator so we end up with a query per entity.
-     */
-    static groupInversedOrMappedKeysByEntityAndOpts(collsWithOpts) {
-        const entitiesMap = new Map();
-        for (const [col, opts] of collsWithOpts) {
-            /*
+      return refsWithOpts.map(([ref]) => ref.unwrap());
+    };
+  }
+  /**
+   * Groups collections by entity and returns a Map whose keys are the entity names and whose values are filter Maps
+   * which we can use to narrow down the find query to return just the items of the collections that have been dataloaded.
+   * The entries of the filter Map will be used as the values of an $or operator so we end up with a query per entity.
+   */
+  static groupInversedOrMappedKeysByEntityAndOpts(collsWithOpts) {
+    const entitiesMap = new Map();
+    for (const [col, opts] of collsWithOpts) {
+      /*
             We first get the entity name of the Collection and together with its options (see groupPrimaryKeysByEntityAndOpts
             for a full explanation) we use it as the key of the first Map.
             With that we know that we have to look for entities of this type (and with the same options) in order to fulfill the collection.
             The value is another Map which we can use to filter the find query to get results pertaining to the collections that have been dataloaded:
             its keys are the props we are going to filter to and its values are the corresponding PKs.
             */
-            const key = `${col.property.targetMeta.uniqueName}|${JSON.stringify(opts ?? {})}`;
-            let filterMap = entitiesMap.get(key); // We are going to use this map to filter the entities pertaining to the collections that have been dataloaded.
-            if (filterMap == null) {
-                filterMap = new Map();
-                entitiesMap.set(key, filterMap);
-            }
-            // The Collection dataloader relies on the inverse side of the relationship (inversedBy/mappedBy), which is going to be
-            // the key of the filter Map and it's the prop that we use to filter the results pertaining to the Collection.
-            const inversedProp = col.property.inversedBy ?? col.property.mappedBy; // Many to Many vs One to Many
-            let primaryKeys = filterMap.get(inversedProp);
-            if (primaryKeys == null) {
-                primaryKeys = new Set();
-                filterMap.set(inversedProp, primaryKeys);
-            }
-            // This is the PK that in conjunction with the filter Map key (the prop) will lead to this specific Collection
-            primaryKeys.add(helper(col.owner).getPrimaryKey());
-        }
-        return entitiesMap;
-    }
-    /**
-     * Turn the entity+options map into actual queries.
-     * The keys are the entity names + a stringified version of the options and the values are filter Maps which will be used as the values of an $or operator so we end up with a query per entity+opts.
-     * We must populate the inverse side of the relationship in order to be able to later retrieve the PK(s) from its item(s).
-     * Together with the query the promises will also return the key which can be used to narrow down the results pertaining to a certain set of options.
-     */
-    static entitiesAndOptsMapToQueries(entitiesAndOptsMap, em) {
-        return Array.from(entitiesAndOptsMap, async ([key, filterMap]) => {
-            const uniqueName = key.substring(0, key.indexOf('|'));
-            const opts = JSON.parse(key.substring(key.indexOf('|') + 1));
-            const meta = em.getMetadata().getByUniqueName(uniqueName);
-            const res = await em.find(meta.class, opts?.where != null && Object.keys(opts.where).length > 0
-                ? {
-                    $and: [
-                        {
-                            $or: Array.from(filterMap.entries()).map(([prop, pks]) => {
-                                return { [prop]: Array.from(pks) };
-                            }),
-                        },
-                        opts.where,
-                    ],
-                }
-                : {
-                    // The entries of the filter Map will be used as the values of the $or operator
-                    $or: Array.from(filterMap.entries()).map(([prop, pks]) => {
-                        return { [prop]: Array.from(pks) };
-                    }),
-                }, {
-                ...opts,
-                // We need to populate the inverse side of the relationship in order to be able to later retrieve the PK(s) from its item(s)
-                populate: [
-                    ...(opts.populate === false ? [] : (opts.populate ?? [])),
-                    ...Array.from(filterMap.keys()).filter(
-                    // We need to do so only if the inverse side is a collection, because we can already retrieve the PK from a reference without having to load it
-                    prop => meta.properties[prop]?.ref !== true),
-                ],
-            });
-            return [key, res];
-        });
+      const key = `${col.property.targetMeta.uniqueName}|${JSON.stringify(opts ?? {})}`;
+      let filterMap = entitiesMap.get(key); // We are going to use this map to filter the entities pertaining to the collections that have been dataloaded.
+      if (filterMap == null) {
+        filterMap = new Map();
+        entitiesMap.set(key, filterMap);
+      }
+      // The Collection dataloader relies on the inverse side of the relationship (inversedBy/mappedBy), which is going to be
+      // the key of the filter Map and it's the prop that we use to filter the results pertaining to the Collection.
+      const inversedProp = col.property.inversedBy ?? col.property.mappedBy; // Many to Many vs One to Many
+      let primaryKeys = filterMap.get(inversedProp);
+      if (primaryKeys == null) {
+        primaryKeys = new Set();
+        filterMap.set(inversedProp, primaryKeys);
+      }
+      // This is the PK that in conjunction with the filter Map key (the prop) will lead to this specific Collection
+      primaryKeys.add(helper(col.owner).getPrimaryKey());
     }
-    /**
-     * Creates a filter which returns the results pertaining to a certain collection.
-     * First checks if the Entity type matches, then retrieves the inverse side of the relationship
-     * where the filtering will be done in order to match the target collection.
-     */
-    static getColFilter(collection) {
-        return (result) => {
-            // There is no need to check if Entity matches because we already matched the key which is entity+options.
-            // This is the inverse side of the relationship where the filtering will be done in order to match the target collection
-            // Either inversedBy or mappedBy exist because we already checked in groupInversedOrMappedKeysByEntity
-            const inverseProp = collection.property.inversedBy ?? collection.property.mappedBy;
-            const target = Reference.unwrapReference(result[inverseProp]);
-            if (target instanceof Collection) {
-                for (const item of target) {
-                    if (item === collection.owner) {
-                        return true;
-                    }
-                }
+    return entitiesMap;
+  }
+  /**
+   * Turn the entity+options map into actual queries.
+   * The keys are the entity names + a stringified version of the options and the values are filter Maps which will be used as the values of an $or operator so we end up with a query per entity+opts.
+   * We must populate the inverse side of the relationship in order to be able to later retrieve the PK(s) from its item(s).
+   * Together with the query the promises will also return the key which can be used to narrow down the results pertaining to a certain set of options.
+   */
+  static entitiesAndOptsMapToQueries(entitiesAndOptsMap, em) {
+    return Array.from(entitiesAndOptsMap, async ([key, filterMap]) => {
+      const uniqueName = key.substring(0, key.indexOf('|'));
+      const opts = JSON.parse(key.substring(key.indexOf('|') + 1));
+      const meta = em.getMetadata().getByUniqueName(uniqueName);
+      const res = await em.find(
+        meta.class,
+        opts?.where != null && Object.keys(opts.where).length > 0
+          ? {
+              $and: [
+                {
+                  $or: Array.from(filterMap.entries()).map(([prop, pks]) => {
+                    return { [prop]: Array.from(pks) };
+                  }),
+                },
+                opts.where,
+              ],
             }
-            else if (target) {
-                return target === collection.owner;
-            }
-            return false;
-        };
-    }
-    /**
-     * Returns the 1:M collection dataloader batchLoadFn, which aggregates collections by entity,
-     * makes one query per entity and maps each input collection to the corresponding result.
-     */
-    static getColBatchLoadFn(em) {
-        return async (collsWithOpts) => {
-            const entitiesAndOptsMap = DataloaderUtils.groupInversedOrMappedKeysByEntityAndOpts(collsWithOpts);
-            const promises = DataloaderUtils.entitiesAndOptsMapToQueries(entitiesAndOptsMap, em);
-            const resultsMap = new Map(await Promise.all(promises));
-            // We need to filter the results in order to map each input collection
-            // to a subset of each query matching the collection items.
-            return collsWithOpts.map(([col, opts]) => {
-                const key = `${col.property.targetMeta.uniqueName}|${JSON.stringify(opts ?? {})}`;
-                const entities = resultsMap.get(key);
-                if (entities == null) {
-                    // Should never happen
-                    /* v8 ignore next */
-                    throw new Error('Cannot match results');
-                }
-                return entities.filter(DataloaderUtils.getColFilter(col));
-            });
-        };
-    }
-    /**
-     * Returns the M:N collection dataloader batchLoadFn, which aggregates collections by entity,
-     * makes one query per entity and maps each input collection to the corresponding result.
-     */
-    static getManyToManyColBatchLoadFn(em) {
-        return async (collsWithOpts) => {
-            const groups = new Map();
-            for (const [col, opts] of collsWithOpts) {
-                const key = `${col.property.targetMeta.uniqueName}.${col.property.name}|${JSON.stringify(opts ?? {})}`;
-                const value = groups.get(key) ?? [];
-                value.push([col, opts ?? {}]);
-                groups.set(key, value);
-            }
-            const ret = [];
-            for (const group of groups.values()) {
-                const prop = group[0][0].property;
-                const options = {};
-                const wrap = (cond) => ({ [prop.name]: cond });
-                const orderBy = Utils.asArray(group[0][1]?.orderBy).map(o => wrap(o));
-                const populate = wrap(group[0][1]?.populate);
-                const owners = group.map(c => c[0].owner);
-                const $or = [];
-                // a bit of a hack, but we need to prefix the key, since we have only a column name, not a property name
-                const alias = em.config.getNamingStrategy().aliasName(Utils.className(prop.pivotEntity), 0);
-                const fk = `${alias}.${Utils.getPrimaryKeyHash(prop.joinColumns)}`;
-                for (const c of group) {
-                    $or.push({ $and: [c[1]?.where ?? {}, { [fk]: c[0].owner }] });
-                    options.refresh ??= c[1]?.refresh;
-                }
-                options.where = wrap({ $or });
-                const r = await em
-                    .getEntityLoader()
-                    .findChildrenFromPivotTable(owners, prop, options, orderBy, populate, group[0][1]?.ref);
-                ret.push(...r);
-            }
-            return ret;
-        };
-    }
-    static async getDataLoader() {
-        if (this.DataLoader) {
-            return this.DataLoader;
+          : {
+              // The entries of the filter Map will be used as the values of the $or operator
+              $or: Array.from(filterMap.entries()).map(([prop, pks]) => {
+                return { [prop]: Array.from(pks) };
+              }),
+            },
+        {
+          ...opts,
+          // We need to populate the inverse side of the relationship in order to be able to later retrieve the PK(s) from its item(s)
+          populate: [
+            ...(opts.populate === false ? [] : (opts.populate ?? [])),
+            ...Array.from(filterMap.keys()).filter(
+              // We need to do so only if the inverse side is a collection, because we can already retrieve the PK from a reference without having to load it
+              prop => meta.properties[prop]?.ref !== true,
+            ),
+          ],
+        },
+      );
+      return [key, res];
+    });
+  }
+  /**
+   * Creates a filter which returns the results pertaining to a certain collection.
+   * First checks if the Entity type matches, then retrieves the inverse side of the relationship
+   * where the filtering will be done in order to match the target collection.
+   */
+  static getColFilter(collection) {
+    return result => {
+      // There is no need to check if Entity matches because we already matched the key which is entity+options.
+      // This is the inverse side of the relationship where the filtering will be done in order to match the target collection
+      // Either inversedBy or mappedBy exist because we already checked in groupInversedOrMappedKeysByEntity
+      const inverseProp = collection.property.inversedBy ?? collection.property.mappedBy;
+      const target = Reference.unwrapReference(result[inverseProp]);
+      if (target instanceof Collection) {
+        for (const item of target) {
+          if (item === collection.owner) {
+            return true;
+          }
         }
-        try {
-            const mod = await import('dataloader');
-            const DataLoader = mod.default;
-            return (this.DataLoader ??= DataLoader);
+      } else if (target) {
+        return target === collection.owner;
+      }
+      return false;
+    };
+  }
+  /**
+   * Returns the 1:M collection dataloader batchLoadFn, which aggregates collections by entity,
+   * makes one query per entity and maps each input collection to the corresponding result.
+   */
+  static getColBatchLoadFn(em) {
+    return async collsWithOpts => {
+      const entitiesAndOptsMap = DataloaderUtils.groupInversedOrMappedKeysByEntityAndOpts(collsWithOpts);
+      const promises = DataloaderUtils.entitiesAndOptsMapToQueries(entitiesAndOptsMap, em);
+      const resultsMap = new Map(await Promise.all(promises));
+      // We need to filter the results in order to map each input collection
+      // to a subset of each query matching the collection items.
+      return collsWithOpts.map(([col, opts]) => {
+        const key = `${col.property.targetMeta.uniqueName}|${JSON.stringify(opts ?? {})}`;
+        const entities = resultsMap.get(key);
+        if (entities == null) {
+          // Should never happen
+          /* v8 ignore next */
+          throw new Error('Cannot match results');
         }
-        catch {
-            /* v8 ignore next */
-            throw new Error("DataLoader is not found, make sure `dataloader` package is installed in your project's dependencies.");
+        return entities.filter(DataloaderUtils.getColFilter(col));
+      });
+    };
+  }
+  /**
+   * Returns the M:N collection dataloader batchLoadFn, which aggregates collections by entity,
+   * makes one query per entity and maps each input collection to the corresponding result.
+   */
+  static getManyToManyColBatchLoadFn(em) {
+    return async collsWithOpts => {
+      const groups = new Map();
+      for (const [col, opts] of collsWithOpts) {
+        const key = `${col.property.targetMeta.uniqueName}.${col.property.name}|${JSON.stringify(opts ?? {})}`;
+        const value = groups.get(key) ?? [];
+        value.push([col, opts ?? {}]);
+        groups.set(key, value);
+      }
+      const ret = [];
+      for (const group of groups.values()) {
+        const prop = group[0][0].property;
+        const options = {};
+        const wrap = cond => ({ [prop.name]: cond });
+        const orderBy = Utils.asArray(group[0][1]?.orderBy).map(o => wrap(o));
+        const populate = wrap(group[0][1]?.populate);
+        const owners = group.map(c => c[0].owner);
+        const $or = [];
+        // a bit of a hack, but we need to prefix the key, since we have only a column name, not a property name
+        const alias = em.config.getNamingStrategy().aliasName(Utils.className(prop.pivotEntity), 0);
+        const fk = `${alias}.${Utils.getPrimaryKeyHash(prop.joinColumns)}`;
+        for (const c of group) {
+          $or.push({ $and: [c[1]?.where ?? {}, { [fk]: c[0].owner }] });
+          options.refresh ??= c[1]?.refresh;
         }
+        options.where = wrap({ $or });
+        const r = await em
+          .getEntityLoader()
+          .findChildrenFromPivotTable(owners, prop, options, orderBy, populate, group[0][1]?.ref);
+        ret.push(...r);
+      }
+      return ret;
+    };
+  }
+  static async getDataLoader() {
+    if (this.DataLoader) {
+      return this.DataLoader;
+    }
+    try {
+      const mod = await import('dataloader');
+      const DataLoader = mod.default;
+      return (this.DataLoader ??= DataLoader);
+    } catch {
+      /* v8 ignore next */
+      throw new Error(
+        "DataLoader is not found, make sure `dataloader` package is installed in your project's dependencies.",
+      );
     }
+  }
 }

package/utils/EntityComparator.d.ts

@@ -1,9 +1,21 @@
-import type { EntityData, EntityDictionary, EntityMetadata, EntityName, EntityProperty, IMetadataStorage, Primary } from '../typings.js';
+import type {
+  EntityData,
+  EntityDictionary,
+  EntityMetadata,
+  EntityName,
+  EntityProperty,
+  IMetadataStorage,
+  Primary,
+} from '../typings.js';
 import type { Platform } from '../platforms/Platform.js';
 import type { Configuration } from './Configuration.js';
-type Comparator<T> = (a: T, b: T, options?: {
+type Comparator<T> = (
+  a: T,
+  b: T,
+  options?: {
     includeInverseSides?: boolean;
-}) => EntityData<T>;
+  },
+) => EntityData<T>;
 type ResultMapper<T> = (result: EntityData<T>) => EntityData<T> | null;
 type SnapshotGenerator<T> = (entity: T) => EntityData<T>;
 type PkGetter<T> = (entity: T) => Primary<T>;
@@ -11,83 +23,88 @@ type PkSerializer<T> = (entity: T) => string;
 type CompositeKeyPart = string | CompositeKeyPart[];
 /** @internal Generates and caches JIT-compiled functions for comparing, snapshotting, and mapping entity data. */
 export declare class EntityComparator {
-    #private;
-    constructor(metadata: IMetadataStorage, platform: Platform, config?: Configuration);
-    /**
-     * Computes difference between two entities.
-     */
-    diffEntities<T extends object>(entityName: EntityName<T>, a: EntityData<T>, b: EntityData<T>, options?: {
-        includeInverseSides?: boolean;
-    }): EntityData<T>;
-    /** Returns true if two entity snapshots are identical (no differences). */
-    matching<T extends object>(entityName: EntityName<T>, a: EntityData<T>, b: EntityData<T>): boolean;
-    /**
-     * Removes ORM specific code from entities and prepares it for serializing. Used before change set computation.
-     * References will be mapped to primary keys, collections to arrays of primary keys.
-     */
-    prepareEntity<T extends object>(entity: T): EntityData<T>;
-    /**
-     * Maps database columns to properties.
-     */
-    mapResult<T>(meta: EntityMetadata<T>, result: EntityDictionary<T>): EntityData<T>;
-    /**
-     * @internal Highly performance-sensitive method.
-     */
-    getPkGetter<T>(meta: EntityMetadata<T>): PkGetter<T>;
-    /**
-     * @internal Highly performance-sensitive method.
-     */
-    getPkGetterConverted<T>(meta: EntityMetadata<T>): PkGetter<T>;
-    /**
-     * @internal Highly performance-sensitive method.
-     */
-    getPkSerializer<T>(meta: EntityMetadata<T>): PkSerializer<T>;
-    /**
-     * @internal Highly performance-sensitive method.
-     */
-    getSnapshotGenerator<T>(entityName: EntityName<T>): SnapshotGenerator<T>;
-    /**
-     * @internal
-     */
-    propName(name: string, parent?: string): string;
-    /**
-     * @internal respects nested composite keys, e.g. `[1, [2, 3]]`
-     */
-    createCompositeKeyArray(prop: EntityProperty, parents?: EntityProperty[]): string;
-    /**
-     * @internal
-     */
-    formatCompositeKeyPart(part: CompositeKeyPart): string;
-    /**
-     * @internal Highly performance-sensitive method.
-     */
-    getResultMapper<T>(meta: EntityMetadata<T>): ResultMapper<T>;
-    private getPropertyCondition;
-    private getEmbeddedArrayPropertySnapshot;
-    /**
-     * we need to serialize only object embeddables, and only the top level ones, so root object embeddable
-     * properties and first child nested object embeddables with inlined parent
-     */
-    private shouldSerialize;
-    private getEmbeddedPropertySnapshot;
-    private registerCustomType;
-    private getPropertySnapshot;
-    /**
-     * @internal Highly performance-sensitive method.
-     */
-    getEntityComparator<T extends object>(entityName: EntityName<T>): Comparator<T>;
-    private getGenericComparator;
-    private getPropertyComparator;
-    private wrap;
-    private safeKey;
-    /**
-     * Sets the toArray helper in the context if not already set.
-     * Used for converting composite PKs to arrays.
-     */
-    private setToArrayHelper;
-    /**
-     * perf: used to generate list of comparable properties during discovery, so we speed up the runtime comparison
-     */
-    static isComparable<T>(prop: EntityProperty<T>, root: EntityMetadata): boolean;
+  #private;
+  constructor(metadata: IMetadataStorage, platform: Platform, config?: Configuration);
+  /**
+   * Computes difference between two entities.
+   */
+  diffEntities<T extends object>(
+    entityName: EntityName<T>,
+    a: EntityData<T>,
+    b: EntityData<T>,
+    options?: {
+      includeInverseSides?: boolean;
+    },
+  ): EntityData<T>;
+  /** Returns true if two entity snapshots are identical (no differences). */
+  matching<T extends object>(entityName: EntityName<T>, a: EntityData<T>, b: EntityData<T>): boolean;
+  /**
+   * Removes ORM specific code from entities and prepares it for serializing. Used before change set computation.
+   * References will be mapped to primary keys, collections to arrays of primary keys.
+   */
+  prepareEntity<T extends object>(entity: T): EntityData<T>;
+  /**
+   * Maps database columns to properties.
+   */
+  mapResult<T>(meta: EntityMetadata<T>, result: EntityDictionary<T>): EntityData<T>;
+  /**
+   * @internal Highly performance-sensitive method.
+   */
+  getPkGetter<T>(meta: EntityMetadata<T>): PkGetter<T>;
+  /**
+   * @internal Highly performance-sensitive method.
+   */
+  getPkGetterConverted<T>(meta: EntityMetadata<T>): PkGetter<T>;
+  /**
+   * @internal Highly performance-sensitive method.
+   */
+  getPkSerializer<T>(meta: EntityMetadata<T>): PkSerializer<T>;
+  /**
+   * @internal Highly performance-sensitive method.
+   */
+  getSnapshotGenerator<T>(entityName: EntityName<T>): SnapshotGenerator<T>;
+  /**
+   * @internal
+   */
+  propName(name: string, parent?: string): string;
+  /**
+   * @internal respects nested composite keys, e.g. `[1, [2, 3]]`
+   */
+  createCompositeKeyArray(prop: EntityProperty, parents?: EntityProperty[]): string;
+  /**
+   * @internal
+   */
+  formatCompositeKeyPart(part: CompositeKeyPart): string;
+  /**
+   * @internal Highly performance-sensitive method.
+   */
+  getResultMapper<T>(meta: EntityMetadata<T>): ResultMapper<T>;
+  private getPropertyCondition;
+  private getEmbeddedArrayPropertySnapshot;
+  /**
+   * we need to serialize only object embeddables, and only the top level ones, so root object embeddable
+   * properties and first child nested object embeddables with inlined parent
+   */
+  private shouldSerialize;
+  private getEmbeddedPropertySnapshot;
+  private registerCustomType;
+  private getPropertySnapshot;
+  /**
+   * @internal Highly performance-sensitive method.
+   */
+  getEntityComparator<T extends object>(entityName: EntityName<T>): Comparator<T>;
+  private getGenericComparator;
+  private getPropertyComparator;
+  private wrap;
+  private safeKey;
+  /**
+   * Sets the toArray helper in the context if not already set.
+   * Used for converting composite PKs to arrays.
+   */
+  private setToArrayHelper;
+  /**
+   * perf: used to generate list of comparable properties during discovery, so we speed up the runtime comparison
+   */
+  static isComparable<T>(prop: EntityProperty<T>, root: EntityMetadata): boolean;
 }
 export {};