@kelpie/schemas 0.8.0 → 0.10.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,6 +52,7 @@ export {
   INVITE_STATUSES,
   MEMBER_ROLES,
   OPEN_PLAN_ITEM_STATUSES,
+  PERSON_CONSENT_TARGET,
   PERSON_EMAIL_TARGET,
   PIPELINE_KIND_LABELS,
   PIPELINE_KINDS,
@@ -71,7 +84,15 @@ export type {
   ApiKeyKind,
   CandidateStatus,
   CompanyStage,
+  ConsentPurposeStatus,
+  ConsentSourceKind,
+  ConsentStatus,
+  CustomFieldObjectType,
+  CustomFieldType,
+  CustomFieldTypeWithOptions,
   ExtensibleRecordType,
+  FormActionStatus,
+  FormBooleanFieldType,
   FormFieldMapTarget,
   FormFieldType,
   FormOptionValueType,
@@ -101,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,
@@ -109,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'
 
@@ -124,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'
 
@@ -181,6 +239,7 @@ export { createFormBody, formBody, formSchema } from './form.ts'
 export type {
   CreateFormInput,
   Form,
+  FormAttachTarget,
   FormField,
   FormFieldInput,
   FormFieldOption,
@@ -188,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,

package/src/list.ts

@@ -22,6 +22,13 @@ export interface List extends RecordTimestamps {
   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
@@ -31,6 +38,8 @@ export const listSchema: z.ZodType<List, unknown> = z
     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(
@@ -40,6 +49,8 @@ export const listSchema: z.ZodType<List, unknown> = z
       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,
     }),
@@ -49,6 +60,8 @@ 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> {
@@ -56,6 +69,7 @@ export function createListBody(input: CreateListInput): Record<string, unknown>
     name: input.name,
     target_type: input.targetType,
     description: input.description,
+    consent_purpose_id: input.consentPurposeId,
   })
 }
 
@@ -63,11 +77,13 @@ export function createListBody(input: CreateListInput): Record<string, unknown>
 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/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),
   })
 }

package/src/personConsent.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod'
+
+import { CONSENT_PURPOSE_STATUSES } from './values.ts'
+import type { ConsentPurposeStatus, ConsentStatus } from './values.ts'
+import { definedFields, nullableTimestampSchema } from './wire.ts'
+
+/**
+ * The effective consent status for a (person, purpose) pair.
+ *
+ * `inherited: true` means the person has no explicit `person_consents` row for
+ * the purpose and the reader is looking at the purpose's `default_status`. In
+ * that case `source` and `notedAt` are null. `inherited: false` means the row
+ * exists and carries its own `granted | withdrawn`, `source`, and `notedAt`.
+ */
+export interface PersonConsent {
+  /** The purpose's slug — the identity that survives a rename of its label. */
+  readonly purposeSlug: string
+  readonly purposeLabel: string
+  readonly status: ConsentPurposeStatus
+  readonly source: string | null
+  readonly notedAt: Date | null
+  readonly inherited: boolean
+}
+
+export const personConsentSchema: z.ZodType<PersonConsent, unknown> = z
+  .object({
+    purpose_slug: z.string(),
+    purpose_label: z.string(),
+    status: z.enum(CONSENT_PURPOSE_STATUSES),
+    source: z.string().nullable(),
+    noted_at: nullableTimestampSchema,
+    inherited: z.boolean(),
+  })
+  .transform(
+    (wire): PersonConsent => ({
+      purposeSlug: wire.purpose_slug,
+      purposeLabel: wire.purpose_label,
+      status: wire.status,
+      source: wire.source,
+      notedAt: wire.noted_at,
+      inherited: wire.inherited,
+    }),
+  )
+
+/**
+ * What a manual override writes for one (person, purpose) pair. A `status` of
+ * `granted` or `withdrawn` upserts the row (`source: manual`); a `null` status
+ * clears the row and falls the pair back to the purpose's default.
+ */
+export interface PersonConsentInput {
+  readonly purposeSlug: string
+  readonly status: ConsentStatus | null
+}
+
+export function personConsentWriteBody(input: PersonConsentInput): Record<string, unknown> {
+  return definedFields({
+    purpose_slug: input.purposeSlug,
+    status: input.status,
+  })
+}

package/src/raise.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'
 
@@ -22,6 +24,8 @@ export interface Raise 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 raiseSchema: z.ZodType<Raise, unknown> = z
@@ -39,6 +43,7 @@ export const raiseSchema: z.ZodType<Raise, unknown> = z
     person_ids: z.array(idSchema),
     summary: z.string(),
     tags: z.array(z.string()),
+    custom_fields: customFieldValuesSchema,
     ...recordTimestamps,
   })
   .transform(
@@ -56,6 +61,7 @@ export const raiseSchema: z.ZodType<Raise, unknown> = z
       personIds: wire.person_ids,
       summary: wire.summary,
       tags: wire.tags,
+      customFields: wire.custom_fields,
       createdAt: wire.created_at,
       updatedAt: wire.updated_at,
     }),
@@ -74,6 +80,11 @@ export interface RaiseInput {
   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 raiseBody(input: RaiseInput): Record<string, unknown> {
@@ -90,5 +101,7 @@ export function raiseBody(input: RaiseInput): Record<string, unknown> {
     person_ids: input.personIds,
     summary: input.summary,
     tags: input.tags,
+    custom_fields:
+      input.customFields === undefined ? undefined : customFieldValuesBody(input.customFields),
   })
 }

package/src/sampleData.ts

@@ -17,6 +17,7 @@ export interface SampleDataCounts {
   readonly opportunities: number
   readonly raises: number
   readonly partnerships: number
+  readonly enquiries: number
   readonly roles: number
   readonly candidates: number
 }
@@ -32,6 +33,7 @@ export const sampleDataCountsSchema: z.ZodType<SampleDataCounts, unknown> = z
     opportunities: z.number().int().nonnegative(),
     raises: z.number().int().nonnegative(),
     partnerships: z.number().int().nonnegative(),
+    enquiries: z.number().int().nonnegative(),
     roles: z.number().int().nonnegative(),
     candidates: z.number().int().nonnegative(),
   })
@@ -46,6 +48,7 @@ export const sampleDataCountsSchema: z.ZodType<SampleDataCounts, unknown> = z
       opportunities: wire.opportunities,
       raises: wire.raises,
       partnerships: wire.partnerships,
+      enquiries: wire.enquiries,
       roles: wire.roles,
       candidates: wire.candidates,
     }),