/** * Leadership list URL contract: state, param parse/canonicalize, Payload * `where`, sort and hrefs. Own module (same shape as `stateDeputyListUrl`) — * does not import municipality/territory list modules. */ import type { Where } from 'payload' import { leadershipSectors, leadershipSupportStatuses, type SupportStatus, } from '@/lib/schemas/leadership' import { allParamValues, buildListHref, firstValue, normalizedText, parseExhaustiveEnumParam, resolveListUrl, strictDecimalInteger, type RawSearchParams, } from '@/utilities/campaignListUrl' export const leadershipPageSize = 25 export type LeadershipListSortKey = 'name' | 'supportStatus' | 'sector' | 'updatedAt' export type LeadershipListSortDirection = 'asc' | 'desc' /** Acesso ao app — exclusive filter (com | sem), same shape as municipality coverage. */ export type LeadershipListAccessFilter = 'com' | 'sem' type LeadershipSector = (typeof leadershipSectors)[number] export type LeadershipListState = { page: number q?: string statuses?: SupportStatus[] sectors?: LeadershipSector[] municipalities?: number[] access?: LeadershipListAccessFilter sort?: LeadershipListSortKey dir?: LeadershipListSortDirection } export type LeadershipListSearchParams = RawSearchParams const leadershipListParamNames = [ 'q', 'status', 'sector', 'municipality', 'access', 'sort', 'dir', 'page', ] as const const leadershipListParamNameSet = new Set(leadershipListParamNames) const DEFAULT_LEADERSHIP_LIST_SORT_KEY: LeadershipListSortKey = 'updatedAt' const DEFAULT_LEADERSHIP_LIST_SORT_DIR: LeadershipListSortDirection = 'desc' export const leadershipListSortLabels: Record = { name: 'Nome', supportStatus: 'Status', sector: 'Setor', updatedAt: 'Última atualização', } const leadershipListSortKeySet = new Set(Object.keys(leadershipListSortLabels)) const leadershipListSortDirSet = new Set(['asc', 'desc']) const supportStatusSet = new Set(leadershipSupportStatuses) const sectorSet = new Set(leadershipSectors) const accessFilterSet = new Set(['com', 'sem']) /** Temporal = newest first; categorical/name = A–Z. */ export const defaultLeadershipListSortDir = ( key: LeadershipListSortKey, ): LeadershipListSortDirection => (key === 'updatedAt' ? 'desc' : 'asc') export const resolveLeadershipListSort = ( state: LeadershipListState, ): { sort: LeadershipListSortKey; dir: LeadershipListSortDirection } => { const sort = state.sort ?? DEFAULT_LEADERSHIP_LIST_SORT_KEY return { sort, dir: state.dir ?? defaultLeadershipListSortDir(sort) } } /** Dotted path for Contact name join; `-` prefix for descending. */ export const resolveLeadershipListPayloadSort = ( sort: LeadershipListSortKey, dir: LeadershipListSortDirection, ): string => { const path = sort === 'name' ? 'contact.name' : sort return dir === 'desc' ? `-${path}` : path } export const formatLeadershipListSortSummary = ( sort: LeadershipListSortKey, dir: LeadershipListSortDirection, ): string => { const label = leadershipListSortLabels[sort] if (sort === 'updatedAt') { return dir === 'desc' ? `Ordenado por ${label} (mais recente)` : `Ordenado por ${label} (mais antigo)` } return dir === 'asc' ? `Ordenado por ${label} (A–Z)` : `Ordenado por ${label} (Z–A)` } export const leadershipListStateToRawParams = ( state: LeadershipListState, page = state.page, ): LeadershipListSearchParams => ({ page: String(page), q: state.q, status: state.statuses, sector: state.sectors, municipality: state.municipalities?.map(String), access: state.access, sort: state.sort, dir: state.dir, }) export const parseLeadershipListParams = ( params: LeadershipListSearchParams, ): LeadershipListState => { const rawPage = strictDecimalInteger(firstValue(params.page)) const q = normalizedText(firstValue(params.q)) const statuses = parseExhaustiveEnumParam(params.status, supportStatusSet) const sectors = parseExhaustiveEnumParam(params.sector, sectorSet) const municipalities = allParamValues(params.municipality) .map((token) => strictDecimalInteger(token)) .filter((id): id is number => typeof id === 'number' && id > 0) const rawAccess = firstValue(params.access) const access = rawAccess && accessFilterSet.has(rawAccess as LeadershipListAccessFilter) ? (rawAccess as LeadershipListAccessFilter) : undefined const rawSort = firstValue(params.sort) const sort = rawSort && leadershipListSortKeySet.has(rawSort) ? (rawSort as LeadershipListSortKey) : undefined const rawDir = firstValue(params.dir) const dir = rawDir && leadershipListSortDirSet.has(rawDir as LeadershipListSortDirection) ? (rawDir as LeadershipListSortDirection) : undefined return { page: rawPage ?? 1, ...(q ? { q } : {}), ...(statuses.length ? { statuses } : {}), ...(sectors.length ? { sectors } : {}), ...(municipalities.length ? { municipalities } : {}), ...(access ? { access } : {}), ...(sort ? { sort } : {}), ...(dir ? { dir } : {}), } } export const buildLeadershipListWhere = (state: LeadershipListState): Where => { const filters: Where[] = [] if (state.q) filters.push({ 'contact.name': { contains: state.q } }) if (state.statuses?.length) filters.push({ supportStatus: { in: state.statuses } }) if (state.sectors?.length) filters.push({ sector: { in: state.sectors } }) if (state.municipalities?.length) { filters.push({ municipalities: { in: state.municipalities } }) } if (state.access) { filters.push({ user: { exists: state.access === 'com' } }) } return filters.length ? { and: filters } : {} } /** Expects already-canonical state (from parse or a rule-preserving toggle). */ export const serializeCanonicalLeadershipListSearchParams = ( canonicalState: LeadershipListState, ): URLSearchParams => { const params = new URLSearchParams() const resolvedSort = canonicalState.sort ?? DEFAULT_LEADERSHIP_LIST_SORT_KEY const resolvedDir = canonicalState.dir ?? defaultLeadershipListSortDir(resolvedSort) const isSortDefault = resolvedSort === DEFAULT_LEADERSHIP_LIST_SORT_KEY && resolvedDir === DEFAULT_LEADERSHIP_LIST_SORT_DIR if (canonicalState.q) params.set('q', canonicalState.q) for (const status of canonicalState.statuses ?? []) params.append('status', status) for (const sector of canonicalState.sectors ?? []) params.append('sector', sector) for (const municipality of canonicalState.municipalities ?? []) { params.append('municipality', String(municipality)) } if (canonicalState.access) params.set('access', canonicalState.access) if (!isSortDefault) { params.set('sort', resolvedSort) if (resolvedDir !== defaultLeadershipListSortDir(resolvedSort)) { params.set('dir', resolvedDir) } } if (canonicalState.page > 1) params.set('page', String(canonicalState.page)) return params } const buildLeadershipListSearchParams = ( state: LeadershipListState, page = state.page, ): URLSearchParams => serializeCanonicalLeadershipListSearchParams( parseLeadershipListParams(leadershipListStateToRawParams(state, page)), ) export const buildLeadershipListHref = (state: LeadershipListState, page: number): string => buildListHref(state, buildLeadershipListSearchParams, '/campanha/liderancas', page) export const buildLeadershipSortHref = ( state: LeadershipListState, nextKey: LeadershipListSortKey, ): string => { const current = resolveLeadershipListSort(state) const dir = current.sort === nextKey ? current.dir === 'asc' ? 'desc' : 'asc' : defaultLeadershipListSortDir(nextKey) return buildLeadershipListHref({ ...state, sort: nextKey, dir, page: 1 }, 1) } export const resolveLeadershipListUrl = ( params: LeadershipListSearchParams, totalPages?: number, ): { state: LeadershipListState href: string redirectHref?: string } => resolveListUrl({ params, paramNameSet: leadershipListParamNameSet, parse: parseLeadershipListParams, buildSearchParams: buildLeadershipListSearchParams, basePath: '/campanha/liderancas', totalPages, })