Method findOne

packages/mongodb/src/MongoDriver.ts:229–264

(
    entityName: EntityName<T>,
    where: FilterQuery<T>,
    options: FindOneOptions<T, P, F, E> = { populate: [], orderBy: {} },
  )

  }

  async findOne<T extends object, P extends string = never, F extends string = never, E extends string = never>(
    entityName: EntityName<T>,
    where: FilterQuery<T>,
    options: FindOneOptions<T, P, F, E> = { populate: [], orderBy: {} },
  ): Promise<EntityData<T> | null> {
    if (this.metadata.find(entityName)?.virtual) {
      const [item] = await this.findVirtual(entityName, where, options as FindOptions<T, any, any, any>);
      /* v8 ignore next */
      return item ?? null;
    }

    if (Utils.isPrimaryKey(where)) {
      where = this.buildFilterById(entityName, where as string);
    }

    const fields = this.buildFields(
      entityName,
      (options.populate as unknown as PopulateOptions<T>[]) || [],
      options.fields,
      options.exclude as any[],
    );
    where = this.renameFields(entityName, where as T, true);
    const orderBy = Utils.asArray(options.orderBy).map(orderBy => this.renameFields(entityName, orderBy as T, true));
    const res = await this.rethrow(
      this.getConnection('read').find(entityName, where, {
        orderBy,
        limit: 1,
        fields,
        ctx: options.ctx,
        loggerContext: options.logging,
        ...this.buildQueryOptions(options),
      }),
    );

    return this.mapResult<T>(res[0], this.metadata.find(entityName));
  }

  override async findVirtual<T extends object>(
    entityName: EntityName<T>,