Function parseFields

api/src/database/get-ast-from-query/lib/parse-fields.ts:33–344

(
	options: ParseFieldsOptions,
	context: ParseFieldsContext,
)

}

export async function parseFields(
	options: ParseFieldsOptions,
	context: ParseFieldsContext,
): Promise<[] | (NestedCollectionNode | FieldNode | FunctionFieldNode)[]> {
	let { fields } = options;
	if (!fields) return [];

	fields = await convertWildcards(
		{
			fields,
			collection: options.parentCollection,
			alias: options.query.alias,
			accountability: options.accountability,
			backlink: options.query.backlink,
		},
		context,
	);

	if (!fields || !Array.isArray(fields)) return [];

	const children: (NestedCollectionNode | FieldNode | FunctionFieldNode)[] = [];

	const policies =
		options.accountability && options.accountability.admin === false
			? await fetchPolicies(options.accountability, context)
			: null;

	const relationalStructure: Record<string, string[] | CollectionScope> = Object.create(null);

	for (const fieldKey of fields) {
		let alias = false;
		let name = fieldKey;

		if (options.query.alias) {
			// check for field alias (is one of the key)
			if (name in options.query.alias) {
				alias = true;
				name = options.query.alias[fieldKey]!;
			}
		}

		// Normalize function calls to move relational prefixes outside the function.
		// e.g., json(m2m.data, color) → m2m.json(data, color)
		// This allows the standard relational handling below to process the traversal
		// uniformly for all functions (json, count, year, etc.).
		name = parseFilterFunctionPath(name);

		const isFunctionCall = name.includes('(') && name.includes(')');

		if (isFunctionCall) {
			const functionName = name.split('(')[0]!;
			const columnName = name.match(REGEX_BETWEEN_PARENS)![1]!;

			const foundField = context.schema.collections[options.parentCollection]!.fields[columnName];

			// Create a FunctionFieldNode for relational count functions (count(related_items))
			if (functionName === 'count' && foundField && foundField.type === 'alias') {
				const foundRelation = context.schema.relations.find(