teqo-backup/src/collections/StateDeputy.ts

import type { CollectionBeforeValidateHook, CollectionConfig } from 'payload'
import { APIError } from 'payload'

import { relationshipId } from '@/lib/relationship'
import { STATE_DEPUTY_NAME_REQUIRED_MESSAGE } from '@/lib/schemas/stateDeputy'
import { slugify } from '@/lib/slug'
import { trimmedText } from '@/lib/text'
import { validateEligibleCampaignStaffAdvisors } from '@/utilities/access/campaignStaffAdvisors'
import {
  canAssignCampaignStaffAdvisors,
  canCreateStateDeputy,
  canDeleteStateDeputy,
  canManageCampaignStaffAdvisors,
  canManageStateDeputy,
  canReadStateDeputy,
  canSetCampaignSystemField,
  eligibleCampaignStaffWhere,
} from '@/utilities/campaignAccess'
import { stampCampaignCreatedBy, systemStampedActorField } from '@/utilities/campaignAuditFields'
import { assertStateDeputyNameAvailable } from '@/utilities/stateDeputy/nameInvariant'

const setCanonicalStateDeputySlug: CollectionBeforeValidateHook = async ({
  data,
  operation,
  originalDoc,
  req,
}) => {
  if (!data) return data

  if (operation === 'update') {
    const contactID = relationshipId(data.contact ?? originalDoc?.contact)
    if (contactID !== null) {
      const contact = await req.payload.findByID({
        collection: 'contact',
        id: contactID,
        depth: 0,
        select: { name: true },
        // Intentional bypass: this read derives the invariant name after the
        // authorized StateDeputy relation update.
        overrideAccess: true,
        req,
      })
      await assertStateDeputyNameAvailable(req.payload, req, contact.name, originalDoc?.id)
    }
    data.slug = originalDoc?.slug ?? data.slug
    return data
  }

  const contactID = relationshipId(data.contact)
  if (contactID === null) {
    throw new APIError('O contato da dobradinha é obrigatório.', 400)
  }

  return req.payload
    .findByID({
      collection: 'contact',
      id: contactID,
      depth: 0,
      select: { name: true },
      // Intentional bypass: the create action has already authorized the staff
      // actor; this lookup only derives the immutable legacy alias from Contact.
      overrideAccess: true,
      req,
    })
    .then((contact) => {
      const name = trimmedText(contact.name)
      const slug = slugify(name)
      if (!slug) {
        throw new APIError(STATE_DEPUTY_NAME_REQUIRED_MESSAGE, 400)
      }

      return assertStateDeputyNameAvailable(req.payload, req, name).then(() => {
        data.slug = slug
        return data
      })
    })
}

export const StateDeputy: CollectionConfig = {
  slug: 'stateDeputy',
  labels: {
    singular: 'Dobradinha',
    plural: 'Dobradinhas',
  },
  admin: {
    group: 'Campanha',
    useAsTitle: 'contact',
    defaultColumns: ['contact', 'party', 'updatedAt'],
    description:
      'Deputados estaduais com quem a campanha dobra. Vincule a municípios e lideranças nas fichas correspondentes.',
  },
  access: {
    create: canCreateStateDeputy,
    read: canReadStateDeputy,
    update: canManageStateDeputy,
    delete: canDeleteStateDeputy,
  },
  hooks: {
    beforeValidate: [setCanonicalStateDeputySlug, validateEligibleCampaignStaffAdvisors],
    beforeChange: [stampCampaignCreatedBy],
  },
  fields: [
    {
      name: 'contact',
      type: 'relationship',
      relationTo: 'contact',
      label: 'Contato',
      required: true,
      unique: true,
      index: true,
      access: {
        update: canSetCampaignSystemField,
      },
    },
    {
      name: 'slug',
      type: 'text',
      label: 'Slug',
      required: true,
      unique: true,
      index: true,
      admin: {
        readOnly: true,
      },
      access: {
        create: canSetCampaignSystemField,
        update: canSetCampaignSystemField,
      },
    },
    {
      name: 'party',
      type: 'text',
      label: 'Partido',
      maxLength: 32,
      index: true,
    },
    {
      // C129 — the ballot name ("nome de legenda") the campaign will use on the
      // urna. Optional identity text, never a search/sort/facet key: the real
      // name stays the person's key everywhere. No index — nothing queries it.
      name: 'ballotName',
      type: 'text',
      label: 'Nome de legenda',
      maxLength: 30,
      admin: {
        description:
          'Como o nome da dobradinha deve aparecer na urna (ex.: apelido ou abreviação).',
      },
    },
    {
      name: 'notes',
      type: 'textarea',
      label: 'Observações',
      maxLength: 4000,
    },
    {
      name: 'advisors',
      type: 'relationship',
      relationTo: 'campaignUser',
      label: 'Assessores',
      hasMany: true,
      index: true,
      access: {
        create: canAssignCampaignStaffAdvisors,
        update: canManageCampaignStaffAdvisors,
      },
      filterOptions: eligibleCampaignStaffWhere,
    },
    systemStampedActorField({ setAccess: canSetCampaignSystemField }),
  ],
}