Method init

packages/core/src/entity/Collection.ts:369–435

Initializes the collection by loading its items from the database.

(
    options: InitCollectionOptions<TT, P> = {},
  )

  /** Initializes the collection by loading its items from the database. */
  async init<TT extends T, P extends string = never>(
    options: InitCollectionOptions<TT, P> = {},
  ): Promise<LoadedCollection<Loaded<TT, P>>> {
    if (this.#dirty) {
      const items = [...this.#items];
      this.#dirty = false;
      await this.init(options);
      items.forEach(i => this.add(i));

      return this as unknown as LoadedCollection<Loaded<TT, P>>;
    }

    const em = this.getEntityManager()!;
    options = { ...options, filters: QueryHelper.mergePropertyFilters(this.property.filters, options.filters)! };

    if (options.dataloader ?? [DataloaderType.ALL, DataloaderType.COLLECTION].includes(em.config.getDataloaderType())) {
      const order = [...this.#items]; // copy order of references
      const orderBy = QueryHelper.mergeOrderBy(
        options.orderBy,
        this.property.orderBy,
        this.property.targetMeta?.orderBy,
      );
      const customOrder = orderBy.length > 0;
      const pivotTable = this.property.kind === ReferenceKind.MANY_TO_MANY && em.getPlatform().usesPivotTable();
      const loader = await em.getDataLoader(pivotTable ? 'm:n' : '1:m');
      const items: TT[] = await loader.load([this, { ...options, orderBy }]);

      if (this.property.kind === ReferenceKind.MANY_TO_MANY) {
        this.#initialized = true;
        this.#dirty = false;

        if (!customOrder) {
          this.reorderItems(items, order);
        }

        return this as unknown as LoadedCollection<Loaded<TT, P>>;
      }

      this.#items.clear();
      let i = 0;

      for (const item of items) {
        this.#items.add(item);
        this[i++] = item;
      }

      this.#initialized = true;
      this.#dirty = false;

      return this as unknown as LoadedCollection<Loaded<TT, P>>;
    }

    const populate = Array.isArray(options.populate)
      ? options.populate.map(f => (f === '*' ? f : `${this.property.name}.${f}`))
      : [`${this.property.name}${options.ref ? ':ref' : ''}`];
    const schema = this.property.targetMeta!.schema === '*' ? helper(this.owner).__schema : undefined;
    await em.populate(this.owner as TT[], populate, {
      refresh: true,