EpicNext-Cms/src/lib/admin-list.ts

import { redirect } from "next/navigation";
import { calcPagination, parseListParams } from "./admin-helpers";
import { canAccess, getAdminContext, type PermissionSet } from "./permissions";
import { prisma } from "./prisma";

// biome-ignore lint/suspicious/noExplicitAny: explicitly chosen here, see surrounding code
type PrismaModel = any;

interface AdminListConfig<TRow> {
	/** Permission slug required to view this page */
	permission: string;
	/** Prisma model name (e.g. 'user', 'ban', 'room') */
	model: string;
	/** Search field paths for OR filter. Use dot notation for nested relations (e.g. 'owner.username') */
	searchFields: string[];
	/** Default sort when no sort param provided. Default: { id: 'desc' } */
	defaultSort?: Record<string, "asc" | "desc">;
	/** Default items per page. Default: 20 */
	defaultPerPage?: number;
	/** Prisma include clause for relations */
	include?: Record<string, unknown>;
	/** Prisma select clause (mutually exclusive with include) */
	select?: Record<string, unknown>;
	/** Fixed WHERE conditions merged with search (e.g. { online: '1' }) */
	baseWhere?: Record<string, unknown>;
	/**
	 * Map URL ?filter_* params to Prisma WHERE conditions. Each entry receives
	 * the raw string value from the URL and returns the WHERE fragment to merge.
	 * Returning null/undefined drops the filter.
	 *
	 * @example
	 * filterMap: {
	 *   filter_rank: (v) => ({ rank: { gte: Number(v) } }),
	 *   filter_online: (v) => ({ online: v }),
	 * }
	 */
	filterMap?: Record<
		string,
		(value: string) => Record<string, unknown> | null | undefined
	>;
	/** Transform raw Prisma row to the shape needed by the table component */
	mapRow?: (row: PrismaModel) => TRow;
}

interface AdminListResult<TRow> {
	rows: TRow[];
	total: number;
	page: number;
	perPage: number;
	lastPage: number;
	locale: string;
	permissions: PermissionSet;
	rank: number;
}

/**
 * Build a nested Prisma WHERE condition from a dot-notation field path.
 * e.g. 'owner.username' => { owner: { username: { contains: search } } }
 * e.g. 'username' => { username: { contains: search } }
 */
function buildFieldCondition(
	fieldPath: string,
	search: string,
): Record<string, unknown> {
	const parts = fieldPath.split(".");
	if (parts.length === 1) {
		return { [parts[0]]: { contains: search } };
	}
	// Build nested object from right to left
	let result: Record<string, unknown> = {
		[parts[parts.length - 1]]: { contains: search },
	};
	for (let i = parts.length - 2; i >= 0; i--) {
		result = { [parts[i]]: result };
	}
	return result;
}

/**
 * Generic admin list data fetcher.
 * Centralizes the common pattern: auth check, param parsing, WHERE/orderBy construction,
 * Prisma query with pagination, and row mapping.
 */
export async function fetchAdminList<TRow = PrismaModel>(
	config: AdminListConfig<TRow>,
	paramsPromise: Promise<{ locale: string }>,
	searchParamsPromise: Promise<Record<string, string>>,
): Promise<AdminListResult<TRow>> {
	const { locale } = await paramsPromise;
	const { session, permissions } = await getAdminContext();

	if (!canAccess(permissions, config.permission, session.user.rank)) {
		redirect("/admin");
	}

	const rawParams = await searchParamsPromise;
	const sp = new URLSearchParams(rawParams);
	const parsed = parseListParams(sp);
	const perPage = config.defaultPerPage
		? Number(rawParams.perPage) || config.defaultPerPage
		: parsed.perPage;
	const { search, page, sort, order } = parsed;

	// Build WHERE clause
	const searchWhere =
		search && config.searchFields.length > 0
			? {
					OR: config.searchFields.map((field) =>
						buildFieldCondition(field, search),
					),
				}
			: {};

	// Apply URL filter_* params via filterMap
	const filterWhere: Record<string, unknown> = {};
	if (config.filterMap) {
		for (const [paramKey, build] of Object.entries(config.filterMap)) {
			const value = rawParams[paramKey];
			if (!value) continue;
			const fragment = build(value);
			if (fragment) Object.assign(filterWhere, fragment);
		}
	}

	const where = {
		...(config.baseWhere ?? {}),
		...filterWhere,
		...searchWhere,
	};

	// Build orderBy
	const orderBy = sort
		? { [sort]: order }
		: (config.defaultSort ?? { id: "desc" as const });

	// Access Prisma model dynamically
	const delegate = (prisma as PrismaModel)[config.model];

	const queryArgs: PrismaModel = {
		where,
		orderBy,
		skip: (page - 1) * perPage,
		take: perPage,
	};

	if (config.include) queryArgs.include = config.include;
	if (config.select) queryArgs.select = config.select;

	const [rawRows, total] = await Promise.all([
		delegate.findMany(queryArgs),
		delegate.count({ where }),
	]);

	const pagination = calcPagination(total, page, perPage);
	const rows = config.mapRow ? rawRows.map(config.mapRow) : rawRows;

	return {
		rows,
		...pagination,
		locale,
		permissions,
		rank: session.user.rank,
	};
}