teqo/src/utilities/advisorData.ts

import 'server-only'

import type { Payload } from 'payload'

import type { Contact } from '@/payload-types'

import { phoneValuesOf } from '@/lib/phone'
import { relationshipId } from '@/lib/relationship'
import {
  advisorListHrefForPage,
  parseAdvisorListParams,
  type AdvisorListState,
} from '@/utilities/advisor/advisorListUrl'

export { advisorListHrefForPage, parseAdvisorListParams }
export type { AdvisorListState }

type AdvisorMunicipalityViewModel = {
  id: number
  name: string
  slug: string
}

type AdvisorAccountViewModel = {
  id: number
  name: string
  email: string | null
  phone: string | null
}

/**
 * Ids only: the list renders the portfolio as chips, which resolve their own
 * labels from the static catalog. Names here would ship a second copy of them.
 */
export type AdvisorRowViewModel = AdvisorAccountViewModel & {
  municipalityIDs: number[]
}

/** The detail page renders real names and links, so it keeps the labels. */
export type AdvisorDetailViewModel = AdvisorAccountViewModel & {
  /** The advisor's normalized ficha (C99) — target of the ficha phones editor. */
  contactID: number | null
  /** Every number of the ficha, order = priority (C112) — primary first. */
  fichaPhones: string[]
  municipalities: AdvisorMunicipalityViewModel[]
}

const advisorPageSize = 25

/** Union of advisors linked on any of the given municipalities (OR semantics). */
const advisorIdsForMunicipalityFilter = async (
  payload: Payload,
  municipalityIds: number[],
): Promise<number[]> => {
  if (municipalityIds.length === 0) return []

  // Intentional admin bypass: same rationale as `municipalityIdsByAdvisorIds` — the
  // unrestricted route gate already asserted staff; this read only resolves filter ids.
  const municipalities = await payload.find({
    collection: 'municipality',
    where: { id: { in: municipalityIds } },
    depth: 0,
    limit: 0,
    pagination: false,
    select: { advisors: true },
    overrideAccess: true,
  })

  const advisorIds = new Set<number>()
  for (const municipality of municipalities.docs) {
    for (const advisor of municipality.advisors ?? []) {
      const id = relationshipId(advisor)
      if (id !== null) advisorIds.add(id)
    }
  }

  return [...advisorIds]
}

/** Fan a município out to each of the advisors the caller asked about. */
const collectByAdvisor = <T>(
  advisors: readonly unknown[] | null | undefined,
  advisorIdSet: ReadonlySet<number>,
  byAdvisor: Map<number, T[]>,
  value: T,
) => {
  for (const advisor of advisors ?? []) {
    const id = relationshipId(advisor)
    if (id === null || !advisorIdSet.has(id)) continue
    const list = byAdvisor.get(id)
    if (list) list.push(value)
    else byAdvisor.set(id, [value])
  }
}

/**
 * Portfolio ids for the LIST, which renders chips that resolve their own labels
 * from the static catalog — sending names here would ship a second copy of them.
 *
 * Intentional admin bypass: advisor rows already resolved after the unrestricted
 * route gate.
 */
export const municipalityIdsByAdvisorIds = async (
  payload: Payload,
  advisorIDs: number[],
): Promise<Map<number, number[]>> => {
  const byAdvisor = new Map<number, number[]>()
  if (advisorIDs.length === 0) return byAdvisor

  const advisorIdSet = new Set(advisorIDs)
  const municipalities = await payload.find({
    collection: 'municipality',
    where: { advisors: { in: advisorIDs } },
    depth: 0,
    limit: 0,
    pagination: false,
    sort: 'name',
    select: { advisors: true },
    overrideAccess: true,
  })

  for (const municipality of municipalities.docs) {
    collectByAdvisor(municipality.advisors, advisorIdSet, byAdvisor, municipality.id)
  }

  return byAdvisor
}

/** Same portfolio with labels, for the DETAIL page, which renders real links. */
const municipalitiesByAdvisorIds = async (
  payload: Payload,
  advisorIDs: number[],
): Promise<Map<number, AdvisorMunicipalityViewModel[]>> => {
  const byAdvisor = new Map<number, AdvisorMunicipalityViewModel[]>()
  if (advisorIDs.length === 0) return byAdvisor

  const advisorIdSet = new Set(advisorIDs)
  // Intentional admin bypass — same rationale as the sibling above.
  const municipalities = await payload.find({
    collection: 'municipality',
    where: { advisors: { in: advisorIDs } },
    depth: 0,
    limit: 0,
    pagination: false,
    sort: 'name',
    select: { name: true, slug: true, advisors: true },
    overrideAccess: true,
  })

  for (const municipality of municipalities.docs) {
    collectByAdvisor(municipality.advisors, advisorIdSet, byAdvisor, {
      id: municipality.id,
      name: municipality.name,
      slug: municipality.slug,
    })
  }

  return byAdvisor
}

/**
 * Lists advisor accounts for the unrestricted management UI.
 *
 * Intentional admin bypass (no `user`): `email`/`username` are stripped by
 * `removePrivateAuthFields` and gated by self-only field access — the page
 * gate already asserted `isCampaignUnrestricted`, and the job is to surface
 * placeholder `@planilha.invalid` emails so staff can activate accounts.
 */
export const loadAdvisorListPageData = async (
  payload: Payload,
  state: AdvisorListState,
): Promise<{ rows: AdvisorRowViewModel[]; totalDocs: number; totalPages: number }> => {
  const municipalityAdvisorIds = state.municipalities?.length
    ? await advisorIdsForMunicipalityFilter(payload, state.municipalities)
    : undefined

  if (municipalityAdvisorIds && municipalityAdvisorIds.length === 0) {
    return { rows: [], totalDocs: 0, totalPages: 0 }
  }

  const result = await payload.find({
    collection: 'campaignUser',
    where: {
      and: [
        { role: { equals: 'advisor' } },
        ...(municipalityAdvisorIds ? [{ id: { in: municipalityAdvisorIds } }] : []),
        ...(state.q
          ? [
              {
                or: [{ name: { contains: state.q } }, { email: { contains: state.q } }],
              },
            ]
          : []),
      ],
    },
    depth: 0,
    limit: advisorPageSize,
    page: state.page,
    sort: 'name',
    select: { name: true, email: true, phone: true, role: true },
    overrideAccess: true,
  })

  const advisorIDs = result.docs.map((doc) => doc.id)
  const municipalityIdsByAdvisor = await municipalityIdsByAdvisorIds(payload, advisorIDs)

  return {
    rows: result.docs.map((doc) => ({
      id: doc.id,
      name: doc.name,
      email: doc.email ?? null,
      phone: doc.phone ?? null,
      municipalityIDs: municipalityIdsByAdvisor.get(doc.id) ?? [],
    })),
    totalDocs: result.totalDocs,
    totalPages: result.totalPages,
  }
}

export const loadAdvisorDetail = async (
  payload: Payload,
  advisorId: number,
): Promise<AdvisorDetailViewModel | null> => {
  if (!Number.isInteger(advisorId) || advisorId <= 0) return null

  let advisor: {
    id: number
    name: string
    email?: string | null
    phone?: string | null
    role: string
    contact?: number | Contact | null
  }
  try {
    // Intentional admin bypass — same rationale as `loadAdvisorListPageData`.
    advisor = await payload.findByID({
      collection: 'campaignUser',
      id: advisorId,
      depth: 0,
      select: { name: true, email: true, phone: true, role: true, contact: true },
      overrideAccess: true,
    })
  } catch {
    return null
  }

  if (advisor.role !== 'advisor') return null

  const contactID = typeof advisor.contact === 'number' ? advisor.contact : null
  const fichaPhones =
    contactID === null
      ? []
      : await payload
          .findByID({
            collection: 'contact',
            id: contactID,
            depth: 0,
            select: { phones: { value: true } },
            // Intentional admin bypass: same staff-scoped read rationale.
            overrideAccess: true,
          })
          .then((contact) => phoneValuesOf(contact.phones))
          .catch(() => [])

  const municipalitiesByAdvisor = await municipalitiesByAdvisorIds(payload, [advisor.id])
  return {
    id: advisor.id,
    name: advisor.name,
    email: advisor.email ?? null,
    phone: advisor.phone ?? null,
    contactID,
    fichaPhones,
    municipalities: municipalitiesByAdvisor.get(advisor.id) ?? [],
  }
}