mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-16 11:15:22 +00:00
92 lines
2.9 KiB
TypeScript
92 lines
2.9 KiB
TypeScript
import 'server-only'
|
|
|
|
import type { Payload, PayloadRequest } from 'payload'
|
|
|
|
import type { Contact } from '@/payload-types'
|
|
import {
|
|
acquireContactPhoneLocks,
|
|
CONTACT_PHONE_AMBIGUOUS_MESSAGE,
|
|
} from '@/utilities/contactPhoneInvariant'
|
|
import type { PayloadTransactionRequest } from '@/utilities/payloadTransaction'
|
|
|
|
type ContactIdentityRequest = PayloadTransactionRequest | PayloadRequest
|
|
|
|
/**
|
|
* Find-or-create the normalized `Contact` ficha for a person, inside the
|
|
* caller's transaction. With a phone, the advisory lock is acquired HERE and
|
|
* an existing ficha with that phone is reused (ambiguous phone fails
|
|
* closed) — the same critical section the supporter flows used to build
|
|
* around `upsertContactByPhone`. Without a phone, a fresh name-only ficha is
|
|
* created. Every "cria ou vincula a ficha" path shares one owner for the
|
|
* "BA default + ambiguous-phone fail-closed" policy.
|
|
*
|
|
* Callers must already be inside an active Payload transaction (the advisory
|
|
* lock requires it) and authorized to own the write (staff creation flows run
|
|
* with the operation already gated; the intentional admin bypass mirrors
|
|
* `createStateDeputyWithContact`).
|
|
*/
|
|
export const findOrCreateContactByPhone = async ({
|
|
payload,
|
|
req,
|
|
phone,
|
|
name,
|
|
email,
|
|
city,
|
|
gender,
|
|
}: {
|
|
payload: Payload
|
|
req: ContactIdentityRequest
|
|
phone: string | null
|
|
name: string
|
|
email?: string | null
|
|
city?: string | null
|
|
gender?: Contact['gender'] | null
|
|
}): Promise<{ contactID: number; reused: boolean }> => {
|
|
if (phone) {
|
|
await acquireContactPhoneLocks(payload, req, [phone])
|
|
|
|
const contacts = await payload.find({
|
|
collection: 'contact',
|
|
where: { phone: { equals: phone } },
|
|
depth: 0,
|
|
limit: 2,
|
|
pagination: false,
|
|
// Intentional admin bypass: the phone invariant must see every ficha,
|
|
// including ones outside the actor's campaign scope.
|
|
overrideAccess: true,
|
|
req,
|
|
})
|
|
|
|
if (contacts.totalDocs > 1) {
|
|
throw new Error(CONTACT_PHONE_AMBIGUOUS_MESSAGE)
|
|
}
|
|
|
|
const existing = contacts.docs[0]
|
|
if (existing) {
|
|
return { contactID: existing.id, reused: true }
|
|
}
|
|
}
|
|
|
|
const contact = await payload.create({
|
|
collection: 'contact',
|
|
data: {
|
|
name,
|
|
phone,
|
|
email: email ?? null,
|
|
state: 'BA' as Contact['state'],
|
|
city: city ?? null,
|
|
gender,
|
|
},
|
|
depth: 0,
|
|
overrideAccess: true,
|
|
// With a phone, the advisory lock is held for this transaction and the
|
|
// find above already proved the phone is free — the Contact
|
|
// phone-invariant hook can skip its redundant lock+availability check
|
|
// (same contract as the C6 bulk-import path, fail-closed on a missing
|
|
// transaction). Without a phone there is no uniqueness to enforce.
|
|
...(phone ? { context: { skipContactPhoneInvariant: true as const } } : {}),
|
|
req,
|
|
})
|
|
|
|
return { contactID: contact.id, reused: false }
|
|
}
|