teqo-backup/src/utilities/campaignStubEmail.ts
Francisco Solla c0645067f1 feat(C128): ciclo de vida das capacidades pelas células de /campanha/pessoas (Closes #695)
Qualquer pessoa visível ganha/perde Assessora, Lidera e Aliada em pela
lista: a primeira cidade cria a entidade (conta staff sem credenciais
utilizáveis / liderança / dobradinha), a última remove da tabela com
confirmação destrutiva (manifest: votos+convites da liderança, conta+
autorias+assessorado da assessora; dobradinha sem diálogo). Saída
destrutiva por escopo: assessor encerra Lidera/Aliada com a capacidade
inteira na carteira; Assessora segue coordenação/candidato. Escritas
person-centric por contactId com extração dos deltas B34/B37 e da
cascata de conta (deleteCampaignUserAccount, nextFreeStubCampaignEmail,
matchers de conflito) — sem twin. commitGuard/commitWithNullOwner/
extraFormFields como opt-ins no RelationChipCell. Corrige bug latente
C116 (célula Assessora nunca salvava — contactId faltava no FormData).
Sem migration. Int: 28, unit: 6, e2e: +2.
2026-08-12 15:29:56 -03:00

40 lines
1.6 KiB
TypeScript

import 'server-only'
import { stubCampaignUserEmailFor } from '@/lib/schemas/advisor'
import { MUNICIPALITY_ADVISOR_STUB_EMAIL_MESSAGE } from '@/lib/schemas/municipality'
import type { PayloadTransactionRequest } from '@/utilities/payloadTransaction'
import type { Payload } from 'payload'
/**
* C128 — the next free `<slug>@criado.invalid` stub for an account created
* without usable credentials (the "login is provisioned later" contract). Was
* private to `actions/municipality.ts` (B154); the person lifecycle
* (`setPersonAssessoraMembershipRecord`) creates staff accounts too, and the
* unique-email probe must never diverge between the two surfaces.
*
* Bounded exact-match probes on the unique `email` index (no LIKE semantics).
* Collisions only happen when two names slugify identically, so the first
* probe usually succeeds. The read bypasses access control on purpose: the
* caller's gate (unrestricted role) already ran in its transaction, and the
* probe only looks at placeholder e-mails.
*/
export const nextFreeStubCampaignEmail = async (
payload: Pick<Payload, 'find'>,
req: PayloadTransactionRequest,
name: string,
): Promise<string> => {
for (let occurrence = 1; occurrence <= 50; occurrence += 1) {
const candidate = stubCampaignUserEmailFor(name, occurrence)
const existing = await payload.find({
collection: 'campaignUser',
where: { email: { equals: candidate } },
depth: 0,
limit: 1,
select: { email: true },
overrideAccess: true,
req,
})
if (existing.totalDocs === 0) return candidate
}
throw new Error(MUNICIPALITY_ADVISOR_STUB_EMAIL_MESSAGE)
}