@kelpie/schemas 0.7.0 → 0.9.0

package/src/index.ts

@@ -24,8 +24,20 @@ export {
   CANDIDATE_STATUS_LABELS,
   CANDIDATE_STATUSES,
   COMPANY_STAGES,
+  CONSENT_PURPOSE_STATUS_LABELS,
+  CONSENT_PURPOSE_STATUSES,
+  CONSENT_SOURCE_KINDS,
+  CONSENT_STATUS_LABELS,
+  CONSENT_STATUSES,
+  CUSTOM_FIELD_OBJECT_TYPE_LABELS,
+  CUSTOM_FIELD_OBJECT_TYPES,
+  CUSTOM_FIELD_TYPE_LABELS,
+  CUSTOM_FIELD_TYPES,
+  CUSTOM_FIELD_TYPES_WITH_OPTIONS,
   EXTENSIBLE_RECORD_TYPES,
   FIRST_INTERVIEW_STAGE,
+  FORM_ACTION_STATUSES,
+  FORM_BOOLEAN_FIELD_TYPES,
   FORM_FIELD_MAP_TARGET_LABELS,
   FORM_FIELD_MAP_TARGETS,
   FORM_FIELD_TYPES,
@@ -40,12 +52,14 @@ export {
   INVITE_STATUSES,
   MEMBER_ROLES,
   OPEN_PLAN_ITEM_STATUSES,
+  PERSON_CONSENT_TARGET,
   PERSON_EMAIL_TARGET,
   PIPELINE_KIND_LABELS,
   PIPELINE_KINDS,
   PLAN_ITEM_STATUS_LABELS,
   PLAN_ITEM_STATUSES,
   PREFERRED_CHANNELS,
+  RECORD_TARGET_TYPE_LABELS,
   RECORD_TARGET_TYPES,
   RELATIONSHIP_LEVELS,
   ROLE_STATUS_LABELS,
@@ -70,7 +84,15 @@ export type {
   ApiKeyKind,
   CandidateStatus,
   CompanyStage,
+  ConsentPurposeStatus,
+  ConsentSourceKind,
+  ConsentStatus,
+  CustomFieldObjectType,
+  CustomFieldType,
+  CustomFieldTypeWithOptions,
   ExtensibleRecordType,
+  FormActionStatus,
+  FormBooleanFieldType,
   FormFieldMapTarget,
   FormFieldType,
   FormOptionValueType,
@@ -100,6 +122,38 @@ export type {
 export { definedFields, idSchema, nullableTimestampSchema, timestampSchema } from './wire.ts'
 export type { RecordTimestamps } from './wire.ts'
 
+export {
+  consentPurposeBody,
+  consentPurposeSchema,
+  createConsentPurposeBody,
+} from './consentPurpose.ts'
+export type {
+  ConsentPurpose,
+  ConsentPurposeInput,
+  CreateConsentPurposeInput,
+} from './consentPurpose.ts'
+
+export { personConsentSchema, personConsentWriteBody } from './personConsent.ts'
+export type { PersonConsent, PersonConsentInput } from './personConsent.ts'
+
+export {
+  createCustomFieldDefinitionBody,
+  customFieldDefinitionBody,
+  customFieldDefinitionSchema,
+  customFieldValuesBody,
+  customFieldValuesSchema,
+  customFieldWireValue,
+  customFieldsPatchShape,
+} from './customField.ts'
+export type {
+  CreateCustomFieldDefinitionInput,
+  CustomFieldDefinition,
+  CustomFieldDefinitionInput,
+  CustomFieldValue,
+  CustomFieldValues,
+  CustomFieldWireValue,
+} from './customField.ts'
+
 export {
   eventActorSchema,
   eventEnvelopeSchema,
@@ -108,6 +162,8 @@ export {
 } from './events.ts'
 export type { EventActor, EventTarget, KelpieEvent, UpdateEventData } from './events.ts'
 
+export { composeName } from './names.ts'
+export type { NameParts } from './names.ts'
 export { personBody, personSchema } from './person.ts'
 export type { Person, PersonInput, SocialProfile } from './person.ts'
 
@@ -123,6 +179,9 @@ export type { Deal, DealInput } from './deal.ts'
 export { opportunityBody, opportunitySchema } from './opportunity.ts'
 export type { Opportunity, OpportunityInput } from './opportunity.ts'
 
+export { enquiryBody, enquirySchema } from './enquiry.ts'
+export type { Enquiry, EnquiryInput } from './enquiry.ts'
+
 export { partnershipBody, partnershipSchema } from './partnership.ts'
 export type { Partnership, PartnershipInput } from './partnership.ts'
 
@@ -149,6 +208,15 @@ export type {
 export { createNoteBody, noteBody, noteSchema } from './note.ts'
 export type { CreateNoteInput, Note, NoteInput } from './note.ts'
 
+export { createListBody, listBody, listSchema } from './list.ts'
+export type { CreateListInput, List, ListInput } from './list.ts'
+
+export { addListMemberBody, listMemberSchema } from './listMember.ts'
+export type { AddListMemberInput, ListMember } from './listMember.ts'
+
+export { listMembershipSchema } from './listMembership.ts'
+export type { ListMembership } from './listMembership.ts'
+
 export { createPlanItemBody, planItemBody, planItemSchema } from './planItem.ts'
 export type { CreatePlanItemInput, PlanItem, PlanItemInput } from './planItem.ts'
 
@@ -171,6 +239,7 @@ export { createFormBody, formBody, formSchema } from './form.ts'
 export type {
   CreateFormInput,
   Form,
+  FormAttachTarget,
   FormField,
   FormFieldInput,
   FormFieldOption,
@@ -178,8 +247,17 @@ export type {
   FormInput,
 } from './form.ts'
 
-export { formSubmissionSchema, formSubmitResultSchema } from './formSubmission.ts'
-export type { FormSubmission, FormSubmitResult } from './formSubmission.ts'
+export {
+  FORM_SUBMISSION_LINK_TARGETS,
+  formSubmissionSchema,
+  formSubmitResultSchema,
+} from './formSubmission.ts'
+export type {
+  FormSubmission,
+  FormSubmissionActionEntry,
+  FormSubmissionLinkTarget,
+  FormSubmitResult,
+} from './formSubmission.ts'
 
 export {
   CONFLICT_MODE_LABELS,
@@ -291,6 +369,10 @@ export type { Member, UpdateMemberRoleInput } from './member.ts'
 
 export { moduleSettingSchema, updateModuleSettingBody } from './moduleSetting.ts'
 export type { ModuleSetting, UpdateModuleSettingInput } from './moduleSetting.ts'
+export { sampleDataCountsSchema } from './sampleData.ts'
+export type { SampleDataCounts } from './sampleData.ts'
+export { relinkEmailDomainsCountsSchema } from './emailDomainLinker.ts'
+export type { RelinkEmailDomainsCounts } from './emailDomainLinker.ts'
 
 export { mcpToolSchema } from './mcpTool.ts'
 export type { McpTool } from './mcpTool.ts'
@@ -329,6 +411,7 @@ export {
   accountSchema,
   accountSessionSchema,
   changePasswordBody,
+  listViewPreferenceSchema,
   updateAccountBody,
   updateAccountPreferencesBody,
 } from './account.ts'
@@ -337,6 +420,7 @@ export type {
   AccountPreferences,
   AccountSession,
   ChangePasswordInput,
+  ListViewPreference,
   UpdateAccountInput,
   UpdateAccountPreferencesInput,
 } from './account.ts'

package/src/list.ts

@@ -0,0 +1,89 @@
+import { z } from 'zod'
+
+import { RECORD_TARGET_TYPES } from './values.ts'
+import type { RecordTargetType } from './values.ts'
+import { definedFields, idSchema, recordTimestamps } from './wire.ts'
+import type { RecordTimestamps } from './wire.ts'
+
+/**
+ * Wire and write shapes for `/v1/lists`.
+ *
+ * A list holds records of one type. The type is chosen at creation and never
+ * changes; a member added to it must match, and the database rejects a mismatch
+ * with a composite foreign key rather than trusting the service to check.
+ *
+ * `memberCount` is a read-only rollup returned on list responses so an index
+ * page can render totals without a follow-up call per row.
+ */
+
+export interface List extends RecordTimestamps {
+  readonly id: string
+  readonly name: string
+  readonly description: string | null
+  readonly targetType: RecordTargetType
+  readonly memberCount: number
+  /**
+   * The consent purpose captured when a form submit adds a person to this
+   * list. Person lists only. Manual and API list adds capture nothing.
+   */
+  readonly consentPurposeId: string | null
+  /** The named purpose's slug, denormalised so a reader needs no second call. */
+  readonly consentPurposeSlug: string | null
+}
+
+export const listSchema: z.ZodType<List, unknown> = z
+  .object({
+    id: idSchema,
+    name: z.string(),
+    description: z.string().nullable(),
+    target_type: z.enum(RECORD_TARGET_TYPES),
+    member_count: z.number().int().nonnegative(),
+    consent_purpose_id: idSchema.nullable(),
+    consent_purpose_slug: z.string().nullable(),
+    ...recordTimestamps,
+  })
+  .transform(
+    (wire): List => ({
+      id: wire.id,
+      name: wire.name,
+      description: wire.description,
+      targetType: wire.target_type,
+      memberCount: wire.member_count,
+      consentPurposeId: wire.consent_purpose_id,
+      consentPurposeSlug: wire.consent_purpose_slug,
+      createdAt: wire.created_at,
+      updatedAt: wire.updated_at,
+    }),
+  )
+
+export interface CreateListInput {
+  readonly name: string
+  readonly targetType: RecordTargetType
+  readonly description?: string | null
+  /** Person lists only. `null` on a company list is fine; a non-null value is `422`. */
+  readonly consentPurposeId?: string | null
+}
+
+export function createListBody(input: CreateListInput): Record<string, unknown> {
+  return definedFields({
+    name: input.name,
+    target_type: input.targetType,
+    description: input.description,
+    consent_purpose_id: input.consentPurposeId,
+  })
+}
+
+/** `targetType` is fixed for the life of a list, so it is not editable here. */
+export interface ListInput {
+  readonly name?: string
+  readonly description?: string | null
+  readonly consentPurposeId?: string | null
+}
+
+export function listBody(input: ListInput): Record<string, unknown> {
+  return definedFields({
+    name: input.name,
+    description: input.description,
+    consent_purpose_id: input.consentPurposeId,
+  })
+}

package/src/listMember.ts

@@ -0,0 +1,54 @@
+import { z } from 'zod'
+
+import { RECORD_TARGET_TYPES } from './values.ts'
+import type { RecordTargetType } from './values.ts'
+import { definedFields, idSchema, timestampSchema } from './wire.ts'
+
+/**
+ * Wire and write shapes for `/v1/lists/:id/members`.
+ *
+ * A membership carries no state of its own: adding or removing a record is the
+ * only edit. `targetName` is resolved server-side via `resolveTargetNames` so a
+ * heterogeneous members table can render without an N+1.
+ */
+
+export interface ListMember {
+  readonly id: string
+  readonly listId: string
+  readonly targetType: RecordTargetType
+  readonly targetId: string
+  readonly targetName: string | null
+  readonly addedAt: Date
+}
+
+export const listMemberSchema: z.ZodType<ListMember, unknown> = z
+  .object({
+    id: idSchema,
+    list_id: idSchema,
+    target_type: z.enum(RECORD_TARGET_TYPES),
+    target_id: idSchema,
+    target_name: z.string().nullable(),
+    added_at: timestampSchema,
+  })
+  .transform(
+    (wire): ListMember => ({
+      id: wire.id,
+      listId: wire.list_id,
+      targetType: wire.target_type,
+      targetId: wire.target_id,
+      targetName: wire.target_name,
+      addedAt: wire.added_at,
+    }),
+  )
+
+export interface AddListMemberInput {
+  readonly targetType: RecordTargetType
+  readonly targetId: string
+}
+
+export function addListMemberBody(input: AddListMemberInput): Record<string, unknown> {
+  return definedFields({
+    target_type: input.targetType,
+    target_id: input.targetId,
+  })
+}

package/src/listMembership.ts

@@ -0,0 +1,45 @@
+import { z } from 'zod'
+
+import { RECORD_TARGET_TYPES } from './values.ts'
+import type { RecordTargetType } from './values.ts'
+import { idSchema, timestampSchema } from './wire.ts'
+
+/**
+ * "Which lists is this record on?" — a membership joined with its list.
+ *
+ * Returned by `GET /v1/list-memberships?target_type=X&target_id=Y`. The joined
+ * list fields (`listName`, `listTargetType`) come along because a record's
+ * detail page wants to render its chips without a follow-up call per list.
+ */
+
+export interface ListMembership {
+  readonly id: string
+  readonly listId: string
+  readonly listName: string
+  readonly listTargetType: RecordTargetType
+  readonly targetType: RecordTargetType
+  readonly targetId: string
+  readonly addedAt: Date
+}
+
+export const listMembershipSchema: z.ZodType<ListMembership, unknown> = z
+  .object({
+    id: idSchema,
+    list_id: idSchema,
+    list_name: z.string(),
+    list_target_type: z.enum(RECORD_TARGET_TYPES),
+    target_type: z.enum(RECORD_TARGET_TYPES),
+    target_id: idSchema,
+    added_at: timestampSchema,
+  })
+  .transform(
+    (wire): ListMembership => ({
+      id: wire.id,
+      listId: wire.list_id,
+      listName: wire.list_name,
+      listTargetType: wire.list_target_type,
+      targetType: wire.target_type,
+      targetId: wire.target_id,
+      addedAt: wire.added_at,
+    }),
+  )

package/src/names.ts

@@ -0,0 +1,49 @@
+/**
+ * Building a person's display name out of its parts.
+ *
+ * One direction only. A name is composed when a caller supplied parts and no
+ * name; parts are never derived by splitting a name. Splitting is a guess, and a
+ * stored guess is indistinguishable from something a person typed: "van der
+ * Berg" is one surname written as three words, "Ursula K. Le Guin" is four
+ * tokens over two names, a mononym is neither a first nor a last name, and half
+ * the world writes the family name first. `name` stays the record's canonical
+ * display string, which is why every consumer that renders a person keeps
+ * reading it and nothing else.
+ */
+
+/**
+ * The parts a display name is built from, in the order they are written.
+ *
+ * Each accepts `undefined` as well as `null` so that a caller holding either
+ * shape — a nullable column, an absent CSV cell, an omitted request field — can
+ * pass what it has without first flattening the two. Both mean the same thing
+ * here: nothing to contribute.
+ */
+export interface NameParts {
+  readonly firstName?: string | null | undefined
+  readonly lastName?: string | null | undefined
+  readonly suffix?: string | null | undefined
+}
+
+/**
+ * The parts joined, single-spaced.
+ *
+ * `salutation` is deliberately not a parameter. "Mr" is a form of address rather
+ * than part of the name, and a list of people reading "Mr John Smith" is a list
+ * nobody asked for. vCard draws the same line: honorific prefixes sit in `N`,
+ * away from the `FN` a client displays.
+ *
+ * The order is fixed rather than per-locale, because this composes a *fallback*
+ * for a record that arrived without a display name. A workspace that writes the
+ * family name first sets `name` itself, which is the whole reason that field is
+ * the canonical one.
+ *
+ * @returns The composed name, or `''` when no part carried anything. An empty
+ *   answer is the caller's signal that there is nothing here to fall back to.
+ */
+export function composeName(parts: NameParts): string {
+  return [parts.firstName, parts.lastName, parts.suffix]
+    .map((part) => (part ?? '').trim())
+    .filter((part) => part.length > 0)
+    .join(' ')
+}

package/src/opportunity.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod'
 
+import { customFieldValuesBody, customFieldValuesSchema } from './customField.ts'
+import type { CustomFieldValue, CustomFieldValues } from './customField.ts'
 import { definedFields, idSchema, recordTimestamps } from './wire.ts'
 import type { RecordTimestamps } from './wire.ts'
 
@@ -16,8 +18,11 @@ export interface Opportunity extends RecordTimestamps {
   readonly ownerId: string | null
   /** `YYYY-MM-DD`, per `api.md` date-only fields. */
   readonly expectedClose: string | null
+  readonly personIds: readonly string[]
   readonly summary: string
   readonly tags: readonly string[]
+  /** Workspace-defined fields, keyed by definition key. Always present (default `{}`). */
+  readonly customFields: CustomFieldValues
 }
 
 export const opportunitySchema: z.ZodType<Opportunity, unknown> = z
@@ -29,8 +34,10 @@ export const opportunitySchema: z.ZodType<Opportunity, unknown> = z
     company_id: idSchema.nullable(),
     owner_id: idSchema.nullable(),
     expected_close: z.string().nullable(),
+    person_ids: z.array(idSchema),
     summary: z.string(),
     tags: z.array(z.string()),
+    custom_fields: customFieldValuesSchema,
     ...recordTimestamps,
   })
   .transform(
@@ -42,8 +49,10 @@ export const opportunitySchema: z.ZodType<Opportunity, unknown> = z
       companyId: wire.company_id,
       ownerId: wire.owner_id,
       expectedClose: wire.expected_close,
+      personIds: wire.person_ids,
       summary: wire.summary,
       tags: wire.tags,
+      customFields: wire.custom_fields,
       createdAt: wire.created_at,
       updatedAt: wire.updated_at,
     }),
@@ -56,8 +65,14 @@ export interface OpportunityInput {
   readonly companyId?: string | null
   readonly ownerId?: string | null
   readonly expectedClose?: string | null
+  readonly personIds?: readonly string[]
   readonly summary?: string
   readonly tags?: readonly string[]
+  /**
+   * Partial merge patch: sent keys change, `null` clears a key, absent keys are
+   * left alone. Unknown keys are rejected at `422`.
+   */
+  readonly customFields?: Readonly<Record<string, CustomFieldValue | null>>
 }
 
 export function opportunityBody(input: OpportunityInput): Record<string, unknown> {
@@ -68,7 +83,10 @@ export function opportunityBody(input: OpportunityInput): Record<string, unknown
     company_id: input.companyId,
     owner_id: input.ownerId,
     expected_close: input.expectedClose,
+    person_ids: input.personIds,
     summary: input.summary,
     tags: input.tags,
+    custom_fields:
+      input.customFields === undefined ? undefined : customFieldValuesBody(input.customFields),
   })
 }

package/src/partnership.ts

@@ -1,5 +1,7 @@
 import { z } from 'zod'
 
+import { customFieldValuesBody, customFieldValuesSchema } from './customField.ts'
+import type { CustomFieldValue, CustomFieldValues } from './customField.ts'
 import { definedFields, idSchema, recordTimestamps } from './wire.ts'
 import type { RecordTimestamps } from './wire.ts'
 
@@ -21,6 +23,8 @@ export interface Partnership extends RecordTimestamps {
   readonly personIds: readonly string[]
   readonly summary: string
   readonly tags: readonly string[]
+  /** Workspace-defined fields, keyed by definition key. Always present (default `{}`). */
+  readonly customFields: CustomFieldValues
 }
 
 export const partnershipSchema: z.ZodType<Partnership, unknown> = z
@@ -37,6 +41,7 @@ export const partnershipSchema: z.ZodType<Partnership, unknown> = z
     person_ids: z.array(idSchema),
     summary: z.string(),
     tags: z.array(z.string()),
+    custom_fields: customFieldValuesSchema,
     ...recordTimestamps,
   })
   .transform(
@@ -53,6 +58,7 @@ export const partnershipSchema: z.ZodType<Partnership, unknown> = z
       personIds: wire.person_ids,
       summary: wire.summary,
       tags: wire.tags,
+      customFields: wire.custom_fields,
       createdAt: wire.created_at,
       updatedAt: wire.updated_at,
     }),
@@ -70,6 +76,11 @@ export interface PartnershipInput {
   readonly personIds?: readonly string[]
   readonly summary?: string
   readonly tags?: readonly string[]
+  /**
+   * Partial merge patch: sent keys change, `null` clears a key, absent keys are
+   * left alone. Unknown keys are rejected at `422`.
+   */
+  readonly customFields?: Readonly<Record<string, CustomFieldValue | null>>
 }
 
 export function partnershipBody(input: PartnershipInput): Record<string, unknown> {
@@ -85,5 +96,7 @@ export function partnershipBody(input: PartnershipInput): Record<string, unknown
     person_ids: input.personIds,
     summary: input.summary,
     tags: input.tags,
+    custom_fields:
+      input.customFields === undefined ? undefined : customFieldValuesBody(input.customFields),
   })
 }

package/src/person.ts

@@ -1,5 +1,12 @@
 import { z } from 'zod'
 
+import {
+  customFieldValuesBody,
+  customFieldValuesSchema,
+} from './customField.ts'
+import type { CustomFieldValue, CustomFieldValues } from './customField.ts'
+import { personConsentSchema, personConsentWriteBody } from './personConsent.ts'
+import type { PersonConsent, PersonConsentInput } from './personConsent.ts'
 import {
   INFLUENCE_LEVELS,
   PREFERRED_CHANNELS,
@@ -19,7 +26,19 @@ export interface SocialProfile {
 
 export interface Person extends RecordTimestamps {
   readonly id: string
+  /**
+   * What to call this person: the canonical display string, and the only name
+   * field every consumer reads. The parts below are optional detail beside it,
+   * never a replacement for it, so a mononym and a four-part name are both just
+   * a `name`.
+   */
   readonly name: string
+  /** A form of address — "Dr", "Ms". Not a job title: that is on Position. */
+  readonly salutation: string | null
+  readonly firstName: string | null
+  readonly lastName: string | null
+  /** A generational or post-nominal suffix — "Jr", "III", "PhD". */
+  readonly suffix: string | null
   readonly email: string | null
   readonly phones: readonly string[]
   readonly socialProfiles: readonly SocialProfile[]
@@ -31,6 +50,16 @@ export interface Person extends RecordTimestamps {
   readonly summary: string
   readonly tags: readonly string[]
   readonly lastContactedAt: Date | null
+  /** The Article 21 objection. Global, independent of consent purposes. */
+  readonly doNotContact: boolean
+  /**
+   * One entry per workspace consent purpose, with the effective status
+   * (an explicit `person_consents` row if one exists, else the purpose's
+   * `default_status`). Ordered by the purpose's `sort_order`.
+   */
+  readonly consents: readonly PersonConsent[]
+  /** Workspace-defined fields, keyed by definition key. Always present (default `{}`). */
+  readonly customFields: CustomFieldValues
 }
 
 const socialProfileSchema = z.object({
@@ -42,6 +71,10 @@ export const personSchema: z.ZodType<Person, unknown> = z
   .object({
     id: idSchema,
     name: z.string(),
+    salutation: z.string().nullable(),
+    first_name: z.string().nullable(),
+    last_name: z.string().nullable(),
+    suffix: z.string().nullable(),
     email: z.string().nullable(),
     phones: z.array(z.string()),
     social_profiles: z.array(socialProfileSchema),
@@ -53,12 +86,19 @@ export const personSchema: z.ZodType<Person, unknown> = z
     summary: z.string(),
     tags: z.array(z.string()),
     last_contacted_at: nullableTimestampSchema,
+    do_not_contact: z.boolean(),
+    consents: z.array(personConsentSchema),
+    custom_fields: customFieldValuesSchema,
     ...recordTimestamps,
   })
   .transform(
     (wire): Person => ({
       id: wire.id,
       name: wire.name,
+      salutation: wire.salutation,
+      firstName: wire.first_name,
+      lastName: wire.last_name,
+      suffix: wire.suffix,
       email: wire.email,
       phones: wire.phones,
       socialProfiles: wire.social_profiles,
@@ -70,6 +110,9 @@ export const personSchema: z.ZodType<Person, unknown> = z
       summary: wire.summary,
       tags: wire.tags,
       lastContactedAt: wire.last_contacted_at,
+      doNotContact: wire.do_not_contact,
+      consents: wire.consents,
+      customFields: wire.custom_fields,
       createdAt: wire.created_at,
       updatedAt: wire.updated_at,
     }),
@@ -78,10 +121,15 @@ export const personSchema: z.ZodType<Person, unknown> = z
 /**
  * A create or update body. Every field is optional because `POST` defaults all
  * but `name` server-side and `PATCH` sends only what changed; `name` is required
- * on create by the route, not by this type.
+ * on create by the route, not by this type — and a create may send `first_name`
+ * and `last_name` instead, which the route composes a `name` from.
  */
 export interface PersonInput {
   readonly name?: string
+  readonly salutation?: string | null
+  readonly firstName?: string | null
+  readonly lastName?: string | null
+  readonly suffix?: string | null
   readonly email?: string | null
   readonly phones?: readonly string[]
   readonly socialProfiles?: readonly SocialProfile[]
@@ -93,11 +141,27 @@ export interface PersonInput {
   readonly summary?: string
   readonly tags?: readonly string[]
   readonly lastContactedAt?: Date | null
+  readonly doNotContact?: boolean
+  /**
+   * Manual override of one or more consent purposes. Each entry upserts a
+   * `person_consents` row (`source: manual`); `status: null` clears the row
+   * and inherits the purpose's default. Absent purposes are left alone.
+   */
+  readonly consents?: readonly PersonConsentInput[]
+  /**
+   * Partial merge patch: sent keys change, `null` clears a key, absent keys are
+   * left alone. Unknown keys are rejected at `422`.
+   */
+  readonly customFields?: Readonly<Record<string, CustomFieldValue | null>>
 }
 
 export function personBody(input: PersonInput): Record<string, unknown> {
   return definedFields({
     name: input.name,
+    salutation: input.salutation,
+    first_name: input.firstName,
+    last_name: input.lastName,
+    suffix: input.suffix,
     email: input.email,
     phones: input.phones,
     social_profiles: input.socialProfiles,
@@ -112,5 +176,9 @@ export function personBody(input: PersonInput): Record<string, unknown> {
       input.lastContactedAt === undefined || input.lastContactedAt === null
         ? input.lastContactedAt
         : input.lastContactedAt.toISOString(),
+    do_not_contact: input.doNotContact,
+    consents: input.consents?.map(personConsentWriteBody),
+    custom_fields:
+      input.customFields === undefined ? undefined : customFieldValuesBody(input.customFields),
   })
 }