Method map

packages/core/src/EntityManager.ts:2021–2049

* Maps raw database result to an entity and merges it to this EntityManager.

(
    entityName: EntityName<Entity>,
    result: EntityDictionary<Entity>,
    options: { schema?: string; mapped?: boolean } = {},
  )

   * Maps raw database result to an entity and merges it to this EntityManager.
   */
  map<Entity extends object>(
    entityName: EntityName<Entity>,
    result: EntityDictionary<Entity>,
    options: { schema?: string; mapped?: boolean } = {},
  ): Entity {
    const { mapped, ...rest } = options;
    const meta = this.metadata.get(entityName);
    const data = (mapped ? result : this.driver.mapResult(result, meta)) as Dictionary;

    for (const k of Object.keys(data)) {
      const prop = meta.properties[k as EntityKey<Entity>];

      if (
        prop?.kind === ReferenceKind.SCALAR &&
        SCALAR_TYPES.has(prop.runtimeType) &&
        !prop.customType &&
        (prop.setter || !prop.getter)
      ) {
        validateProperty(prop, data[k], data);
      }
    }

    return this.merge<Entity>(entityName, data as EntityData<Entity>, {
      convertCustomTypes: true,
      refresh: true,
      validate: false,
      ...rest,
    });
  }

  /**
   * Merges given entity to this EntityManager so it becomes managed. You can force refreshing of existing entities