Method readOne

api/src/services/items.ts:613–628

* Get single item by primary key. * * Uses `this.readByQuery` under the hood.

(key: PrimaryKey, query: Query = {}, opts?: QueryOptions)

	 * Uses `this.readByQuery` under the hood.
	 */
	async readOne(key: PrimaryKey, query: Query = {}, opts?: QueryOptions): Promise<Item> {
		const primaryKeyField = this.schema.collections[this.collection]!.primary;

		validateKeys(this.schema, this.collection, primaryKeyField, key);

		const filterWithKey = assign({}, query.filter, { [primaryKeyField]: { _eq: key } });
		const queryWithKey = assign({}, query, { filter: filterWithKey });

		const results: Item[] = await this.readByQuery(queryWithKey, { ...opts, key });

		if (results.length === 0) {
			throw new ForbiddenError();
		}

		return results[0]!;
	}

	/**
	 * Get multiple items by primary keys.