Function resetUntouchedCollections

packages/core/src/utils/upsert-utils.ts:210–231

(meta: EntityMetadata<Entity>, entity: Entity)

/** @internal */
export function resetUntouchedCollections<Entity extends object>(meta: EntityMetadata<Entity>, entity: Entity): void {
  // for entities passed in via `em.create()` and then upserted, collection-kind relations
  // were initialized as empty-but-initialized by the hydrator (newEntity=true). once the
  // upsert resolves the entity to a possibly existing row, that state is stale and would
  // cause `em.populate()` to skip those collections. replace them with a fresh
  // uninitialized collection so populate can load them.
  if (helper(entity).__originalEntityData) {
    return;
  }

  for (const prop of meta.relations) {
    if (prop.kind !== ReferenceKind.MANY_TO_MANY && prop.kind !== ReferenceKind.ONE_TO_MANY) {
      continue;
    }

    const collection = entity[prop.name];

    if (Utils.isCollection(collection) && collection.isInitialized() && !collection.isDirty()) {
      Collection.create(entity, prop.name, undefined, false);
    }
  }
}