teqo/src/utilities/campaignConsent.ts
Francisco Ignácio Fontoura Solla b079daa9bb Add C2 nominal supporter registry for /campanha.
Ship the supporter join collection, consent-keyed create/import/remove actions, and apoiadores UI so staff can build a phone-required nominal base before mass field ops.
2026-07-18 20:32:54 -03:00

142 lines
4.2 KiB
TypeScript

import 'server-only'
import type { Payload } from 'payload'
import type { Consent } from '@/payload-types'
import { CAMPAIGN_INVITE_CONSENT_KEY } from '@/utilities/campaignInvite'
import { hashConsentContent } from '@/utilities/consentContentHash'
export const SUPPORTER_REGISTRATION_CONSENT_KEY = 'apoiador-cadastro'
export const SUPPORTER_VOTE_INTENTION_CONSENT_KEY = 'apoiador-intencao-voto'
export type ConsentDescriptor = {
id: number
text: Consent['text']
contentHash: string
key: string
}
/** @deprecated Prefer ConsentDescriptor — kept for leadership call sites. */
export type LeadershipConsentDescriptor = Omit<ConsentDescriptor, 'key'>
type ConsentRequest = { transactionID?: number | string }
export type InviteConsentResolution =
| { shouldUpdate: false }
| {
shouldUpdate: true
consentID: number
consentContentHash: string
consentedAt: string
}
export const resolveInviteConsent = ({
existingConsentID,
existingConsentContentHash,
configuredConsentID,
configuredConsentContentHash,
consentAccepted,
}: {
existingConsentID: number | null
existingConsentContentHash?: string | null
configuredConsentID: number
configuredConsentContentHash: string
consentAccepted?: boolean
}): InviteConsentResolution => {
if (
existingConsentID === configuredConsentID &&
existingConsentContentHash === configuredConsentContentHash
) {
return { shouldUpdate: false }
}
if (!consentAccepted) {
throw new Error('É necessário aceitar o consentimento.')
}
return {
shouldUpdate: true,
consentID: configuredConsentID,
consentContentHash: configuredConsentContentHash,
consentedAt: new Date().toISOString(),
}
}
export const getConsentByKey = async (
payload: Payload,
key: string,
req?: ConsentRequest,
): Promise<ConsentDescriptor | null> => {
const result = await payload.find({
collection: 'consent',
where: { key: { equals: key } },
depth: 0,
limit: 1,
pagination: false,
select: { text: true, key: true },
overrideAccess: true,
req,
})
const consent = result.docs[0]
if (!consent) return null
return {
id: consent.id,
text: consent.text,
contentHash: hashConsentContent(consent.text ?? null),
key,
}
}
export const requireConsentByKey = async (
payload: Payload,
key: string,
req?: ConsentRequest,
message = 'Consentimento ainda não configurado.',
): Promise<ConsentDescriptor> => {
const consent = await getConsentByKey(payload, key, req)
if (!consent) throw new Error(message)
return consent
}
export const getLeadershipConsent = async (
payload: Payload,
req?: ConsentRequest,
): Promise<LeadershipConsentDescriptor | null> => {
const consent = await getConsentByKey(payload, CAMPAIGN_INVITE_CONSENT_KEY, req)
if (!consent) return null
return { id: consent.id, text: consent.text, contentHash: consent.contentHash }
}
export const requireLeadershipConsent = async (
payload: Payload,
req?: ConsentRequest,
message = 'Consentimento ainda não configurado.',
): Promise<LeadershipConsentDescriptor> => {
const consent = await requireConsentByKey(payload, CAMPAIGN_INVITE_CONSENT_KEY, req, message)
return { id: consent.id, text: consent.text, contentHash: consent.contentHash }
}
export const getSupporterRegistrationConsent = (
payload: Payload,
req?: ConsentRequest,
): Promise<ConsentDescriptor | null> =>
getConsentByKey(payload, SUPPORTER_REGISTRATION_CONSENT_KEY, req)
export const requireSupporterRegistrationConsent = (
payload: Payload,
req?: ConsentRequest,
message = 'Consentimento de cadastro de apoiador ainda não configurado.',
): Promise<ConsentDescriptor> =>
requireConsentByKey(payload, SUPPORTER_REGISTRATION_CONSENT_KEY, req, message)
export const getSupporterVoteIntentionConsent = (
payload: Payload,
req?: ConsentRequest,
): Promise<ConsentDescriptor | null> =>
getConsentByKey(payload, SUPPORTER_VOTE_INTENTION_CONSENT_KEY, req)
export const requireSupporterVoteIntentionConsent = (
payload: Payload,
req?: ConsentRequest,
message = 'Consentimento de intenção de voto ainda não configurado.',
): Promise<ConsentDescriptor> =>
requireConsentByKey(payload, SUPPORTER_VOTE_INTENTION_CONSENT_KEY, req, message)