@kelpie/server 0.12.0 → 0.13.0

package/src/modules/import-export/presets.ts

@@ -22,8 +22,12 @@ export const SOURCE_PRESETS: Readonly<Record<ImportSource, SourcePreset>> = {
       name: 'Name',
       domain: 'Company Domain Name',
       industry: 'Industry',
-      website: 'Website URL',
-      hq: 'City',
+      hq_line1: 'Address',
+      hq_line2: 'Address 2',
+      hq_city: 'City',
+      hq_region: 'State/Region',
+      hq_postal_code: 'Postal Code',
+      hq_country: 'Country',
       description: 'Description',
     },
     people: {
@@ -35,7 +39,12 @@ export const SOURCE_PRESETS: Readonly<Record<ImportSource, SourcePreset>> = {
       last_name: 'Last Name',
       email: 'Email',
       phones: 'Phone Number',
-      location: 'City',
+      mailing_line1: 'Address',
+      mailing_line2: 'Address 2',
+      mailing_city: 'City',
+      mailing_region: 'State/Region',
+      mailing_postal_code: 'Postal Code',
+      mailing_country: 'Country',
       company_domain: 'Company Domain Name',
       title: 'Job Title',
     },
@@ -59,7 +68,16 @@ export const SOURCE_PRESETS: Readonly<Record<ImportSource, SourcePreset>> = {
       name: 'Account Name',
       domain: 'Website',
       industry: 'Industry',
-      hq: 'Billing City',
+      billing_line1: 'Billing Street',
+      billing_city: 'Billing City',
+      billing_region: 'Billing State/Province',
+      billing_postal_code: 'Billing Zip/Postal Code',
+      billing_country: 'Billing Country',
+      shipping_line1: 'Shipping Street',
+      shipping_city: 'Shipping City',
+      shipping_region: 'Shipping State/Province',
+      shipping_postal_code: 'Shipping Zip/Postal Code',
+      shipping_country: 'Shipping Country',
       description: 'Description',
     },
     people: {
@@ -69,7 +87,16 @@ export const SOURCE_PRESETS: Readonly<Record<ImportSource, SourcePreset>> = {
       last_name: 'Last Name',
       email: 'Email',
       phones: 'Phone',
-      location: 'Mailing City',
+      mailing_line1: 'Mailing Street',
+      mailing_city: 'Mailing City',
+      mailing_region: 'Mailing State/Province',
+      mailing_postal_code: 'Mailing Zip/Postal Code',
+      mailing_country: 'Mailing Country',
+      other_line1: 'Other Street',
+      other_city: 'Other City',
+      other_region: 'Other State/Province',
+      other_postal_code: 'Other Zip/Postal Code',
+      other_country: 'Other Country',
       company_name: 'Account Name',
       // Salesforce's Contact.Title is the job title, and a job title is a
       // Position. It is not this object's `suffix`, which stays unmapped.
@@ -101,12 +128,22 @@ export const SOURCE_PRESETS: Readonly<Record<ImportSource, SourcePreset>> = {
       domain: 'Domains',
       industry: 'Categories',
       description: 'Description',
-      hq: 'Primary location > Country',
+      hq_line1: 'Primary location > Line 1',
+      hq_line2: 'Primary location > Line 2',
+      hq_city: 'Primary location > Locality',
+      hq_region: 'Primary location > Region',
+      hq_postal_code: 'Primary location > Postcode',
+      hq_country: 'Primary location > Country',
     },
     people: {
       name: 'Record',
       email: 'Email addresses',
-      location: 'Primary location > Country',
+      mailing_line1: 'Primary location > Line 1',
+      mailing_line2: 'Primary location > Line 2',
+      mailing_city: 'Primary location > Locality',
+      mailing_region: 'Primary location > Region',
+      mailing_postal_code: 'Primary location > Postcode',
+      mailing_country: 'Primary location > Country',
       company_name: 'Company > Name',
       title: 'Job title',
     },
@@ -184,6 +221,9 @@ export function aliasedStageSlug(raw: string): string | undefined {
   return ALIASES_BY_SQUASHED_NAME.get(squash(raw))
 }
 
+/** A file that names a website but not a domain still has a homepage. */
+const DOMAIN_HEADER_ALIASES = new Set(['website', 'website url', 'url'])
+
 /**
  * The column map to use when a request sends none.
  *
@@ -214,5 +254,13 @@ export function defaultColumnMap(
       headers.find((header) => header.toLowerCase() === column.key.toLowerCase()) ?? null
   }
 
+  if (object === 'companies' && map.domain === null) {
+    const alias = headers.find((header) => DOMAIN_HEADER_ALIASES.has(header.toLowerCase()))
+
+    if (alias !== undefined) {
+      map.domain = alias
+    }
+  }
+
   return map
 }

package/src/modules/import-export/repository.ts

@@ -1,6 +1,6 @@
 import { and, asc, eq, gt, inArray, sql } from 'drizzle-orm'
 
-import type { CustomFieldValue } from '@kelpie/schemas'
+import type { CompanyAddress, CustomFieldValue, PersonAddress } from '@kelpie/schemas'
 import type { Queryable } from '../../runtime/transaction.ts'
 import { users } from '../auth/schema.ts'
 import { companies } from '../companies/schema.ts'
@@ -614,8 +614,7 @@ export interface ExportCompanyRow {
   readonly description: string
   readonly summary: string
   readonly tags: readonly string[]
-  readonly website: string | null
-  readonly hq: string | null
+  readonly addresses: readonly CompanyAddress[]
   readonly customFields: Readonly<Record<string, CustomFieldValue>>
 }
 
@@ -637,8 +636,7 @@ export function readCompanies(
       description: companies.description,
       summary: companies.summary,
       tags: companies.tags,
-      website: companies.website,
-      hq: companies.hq,
+      addresses: companies.addresses,
       customFields: companies.customFields,
     })
     .from(companies)
@@ -656,7 +654,7 @@ export interface ExportPersonRow {
   readonly suffix: string | null
   readonly email: string | null
   readonly timezone: string | null
-  readonly location: string | null
+  readonly addresses: readonly PersonAddress[]
   readonly preferredChannel: string
   readonly influence: string
   readonly relationship: string
@@ -687,7 +685,7 @@ export async function readPeople(
       suffix: people.suffix,
       email: people.email,
       timezone: people.timezone,
-      location: people.location,
+      addresses: people.addresses,
       preferredChannel: people.preferredChannel,
       influence: people.influence,
       relationship: people.relationship,

package/src/modules/import-export/writes.ts

@@ -148,11 +148,12 @@ async function writeCompany(
       'company',
       write.draft.customFields,
     )
-    const { customFields: _draftCustomFields, tags, ...rest } = write.draft
+    const { customFields: _draftCustomFields, tags, addresses, ...rest } = write.draft
     const created = await companyRepository.insertCompany(tx, {
       ...NEW_COMPANY_DEFAULTS,
       ...rest,
       tags: tags === undefined ? undefined : [...tags],
+      addresses: addresses === undefined ? undefined : [...addresses],
       ...(customFields === undefined ? {} : { customFields }),
       id: dependencies.createId('company'),
       workspaceId,
@@ -169,7 +170,7 @@ async function writeCompany(
     throw AppError.notFound('Company not found')
   }
 
-  const { customFields: draftCustomFields, tags, ...rest } = write.draft
+  const { customFields: draftCustomFields, tags, addresses, ...rest } = write.draft
   const customMerge = await validatedCustomFieldsForUpdate(
     tx,
     workspaceId,
@@ -180,6 +181,7 @@ async function writeCompany(
   const columns = {
     ...rest,
     tags: tags === undefined ? undefined : [...tags],
+    addresses: addresses === undefined ? undefined : [...addresses],
     ...(customMerge === undefined ? {} : { customFields: customMerge.merged }),
   }
   const changedFields = [
@@ -298,12 +300,13 @@ async function writePerson(
       'person',
       write.draft.customFields,
     )
-    const { customFields: _draftCustomFields, phones, tags, ...rest } = write.draft
+    const { customFields: _draftCustomFields, phones, tags, addresses, ...rest } = write.draft
     const created = await peopleRepository.insertPerson(tx, {
       ...NEW_PERSON_DEFAULTS,
       ...rest,
       phones: phones === undefined ? undefined : [...phones],
       tags: tags === undefined ? undefined : [...tags],
+      addresses: addresses === undefined ? undefined : [...addresses],
       ...(customFields === undefined ? {} : { customFields }),
       id: dependencies.createId('person'),
       workspaceId,
@@ -332,7 +335,7 @@ async function writePerson(
     throw AppError.notFound('Person not found')
   }
 
-  const { customFields: draftCustomFields, phones, tags, ...rest } = write.draft
+  const { customFields: draftCustomFields, phones, tags, addresses, ...rest } = write.draft
   const customMerge = await validatedCustomFieldsForUpdate(
     tx,
     workspaceId,
@@ -344,6 +347,7 @@ async function writePerson(
     ...rest,
     phones: phones === undefined ? undefined : [...phones],
     tags: tags === undefined ? undefined : [...tags],
+    addresses: addresses === undefined ? undefined : [...addresses],
     ...(customMerge === undefined ? {} : { customFields: customMerge.merged }),
   }
   const changedFields = [

package/src/modules/people/repository.ts

@@ -74,6 +74,7 @@ function matchesTerm(term: string): SQL | undefined {
     ilike(people.email, pattern),
     ilike(people.summary, pattern),
     arrayContainsPattern(people.tags, pattern),
+    sql`kelpie_addresses_search_text(${people.addresses}) ilike ${pattern}`,
     heldPositionMatches(pattern),
   )
 }

package/src/modules/people/routes.ts

@@ -1,4 +1,4 @@
-import { CONSENT_STATUSES, composeName, customFieldsPatchShape } from '@kelpie/schemas'
+import { CONSENT_STATUSES, composeName, customFieldsPatchShape, personAddressesSchema, addressBody } from '@kelpie/schemas'
 import type { NameParts } from '@kelpie/schemas'
 import type { Context, Hono } from 'hono'
 import { z } from 'zod'
@@ -60,7 +60,7 @@ const personShape = {
   phones: z.array(z.string().min(1)),
   social_profiles: z.array(socialProfileBody),
   timezone: z.string().nullable(),
-  location: z.string().nullable(),
+  addresses: personAddressesSchema,
   preferred_channel: z.enum(PREFERRED_CHANNELS),
   influence: z.enum(INFLUENCE_LEVELS),
   relationship: z.enum(RELATIONSHIP_LEVELS),
@@ -95,7 +95,7 @@ export const createBody = z
     phones: personShape.phones.default([]),
     social_profiles: personShape.social_profiles.default([]),
     timezone: personShape.timezone.default(null),
-    location: personShape.location.default(null),
+    addresses: personShape.addresses.default([]),
     preferred_channel: personShape.preferred_channel.default('email'),
     influence: personShape.influence.default('influencer'),
     relationship: personShape.relationship.default('cold'),
@@ -137,7 +137,7 @@ export function toCreateInput(body: z.infer<typeof createBody>): CreatePersonInp
     phones: body.phones,
     socialProfiles: body.social_profiles,
     timezone: body.timezone,
-    location: body.location,
+    addresses: body.addresses,
     preferredChannel: body.preferred_channel,
     influence: body.influence,
     relationship: body.relationship,
@@ -173,7 +173,7 @@ export function toUpdateInput(body: z.infer<typeof updateBody>): UpdatePersonInp
     ...(body.phones === undefined ? {} : { phones: body.phones }),
     ...(body.social_profiles === undefined ? {} : { socialProfiles: body.social_profiles }),
     ...(body.timezone === undefined ? {} : { timezone: body.timezone }),
-    ...(body.location === undefined ? {} : { location: body.location }),
+    ...(body.addresses === undefined ? {} : { addresses: body.addresses }),
     ...(body.preferred_channel === undefined ? {} : { preferredChannel: body.preferred_channel }),
     ...(body.influence === undefined ? {} : { influence: body.influence }),
     ...(body.relationship === undefined ? {} : { relationship: body.relationship }),
@@ -221,7 +221,7 @@ export function personResponse(person: PersonView): Record<string, unknown> {
     phones: person.phones,
     social_profiles: person.socialProfiles,
     timezone: person.timezone,
-    location: person.location,
+    addresses: person.addresses.map(addressBody),
     preferred_channel: person.preferredChannel,
     influence: person.influence,
     relationship: person.relationship,

package/src/modules/people/schema.ts

@@ -5,7 +5,7 @@ import {
   PREFERRED_CHANNELS,
   RELATIONSHIP_LEVELS,
 } from '@kelpie/schemas'
-import type { CustomFieldValue, SocialProfile } from '@kelpie/schemas'
+import type { CustomFieldValue, PersonAddress, SocialProfile } from '@kelpie/schemas'
 import { boolean, index, jsonb, pgTable, primaryKey, text, unique } from 'drizzle-orm/pg-core'
 
 import {
@@ -48,9 +48,10 @@ export type { SocialProfile }
  * Who you know. Job title is not here: it lives on Position, because a person can
  * hold titles at more than one company.
  *
- * `phones` and `social_profiles` are jsonb because nothing queries into them.
- * They are typed rather than left as `unknown`, and the route layer parses what
- * goes in, so a row read back is the shape it claims to be.
+ * `phones`, `social_profiles`, and `addresses` are jsonb because nothing
+ * queries into them. They are typed rather than left as `unknown`, and the
+ * route layer parses what goes in, so a row read back is the shape it claims
+ * to be.
  */
 export const people = pgTable(
   'people',
@@ -75,7 +76,7 @@ export const people = pgTable(
       .notNull()
       .default([]),
     timezone: text('timezone'),
-    location: text('location'),
+    addresses: jsonb('addresses').$type<readonly PersonAddress[]>().notNull().default([]),
     preferredChannel: text('preferred_channel').notNull(),
     influence: text('influence').notNull(),
     relationship: text('relationship').notNull(),
@@ -110,6 +111,7 @@ export const people = pgTable(
       { column: people.email, weight: 'B' },
       { column: people.summary, weight: 'B' },
       { column: people.tags, weight: 'C', array: true },
+      { column: people.addresses, weight: 'C', addresses: true },
     ]),
   },
   (table) => [

package/src/modules/people/service.ts

@@ -1,4 +1,4 @@
-import type { ConsentStatus, CustomFieldWireValue } from '@kelpie/schemas'
+import type { ConsentStatus, CustomFieldWireValue, PersonAddress } from '@kelpie/schemas'
 
 import { changedKeys } from '../../lib/changes.ts'
 import { UNIQUE_VIOLATION, isReferenceViolation, postgresErrorCode } from '../../lib/database.ts'
@@ -19,6 +19,7 @@ import { requireWorkspaceId } from '../auth/actor.ts'
 import './events.ts'
 import {
   deleteRecordsAttachedTo,
+  deleteRecordsAttachedToAttendancesOf,
   deleteRecordsAttachedToCandidaciesOf,
 } from '../attachedRecords.ts'
 import type { CustomFieldValuesValidator } from '../custom-fields/values.ts'
@@ -69,7 +70,7 @@ const PERSON_FIELD_LABELS: FieldLabels = {
   phones: 'Phone numbers',
   socialProfiles: 'Social profiles',
   timezone: 'Timezone',
-  location: 'Location',
+  addresses: 'Addresses',
   preferredChannel: 'Preferred channel',
   influence: 'Influence',
   relationship: 'Relationship',
@@ -110,7 +111,7 @@ export interface CreatePersonInput {
   readonly phones: readonly string[]
   readonly socialProfiles: readonly SocialProfile[]
   readonly timezone: string | null
-  readonly location: string | null
+  readonly addresses: readonly PersonAddress[]
   readonly preferredChannel: PreferredChannel
   readonly influence: Influence
   readonly relationship: Relationship
@@ -161,7 +162,7 @@ function toStoredColumns(input: UpdatePersonInput): Partial<repository.PersonCol
     ...(input.phones === undefined ? {} : { phones: input.phones }),
     ...(input.socialProfiles === undefined ? {} : { socialProfiles: input.socialProfiles }),
     ...(input.timezone === undefined ? {} : { timezone: input.timezone }),
-    ...(input.location === undefined ? {} : { location: input.location }),
+    ...(input.addresses === undefined ? {} : { addresses: input.addresses }),
     ...(input.preferredChannel === undefined ? {} : { preferredChannel: input.preferredChannel }),
     ...(input.influence === undefined ? {} : { influence: input.influence }),
     ...(input.relationship === undefined ? {} : { relationship: input.relationship }),
@@ -241,7 +242,7 @@ export function createPeopleService(dependencies: PeopleDependencies): PeopleSer
               phones: input.phones,
               socialProfiles: input.socialProfiles,
               timezone: input.timezone,
-              location: input.location,
+              addresses: input.addresses,
               preferredChannel: input.preferredChannel,
               influence: input.influence,
               relationship: input.relationship,
@@ -421,6 +422,7 @@ export function createPeopleService(dependencies: PeopleDependencies): PeopleSer
           // The candidacy rows themselves cascade, which is why their interview
           // notes have to be taken here: no hiring service sees that delete.
           await deleteRecordsAttachedToCandidaciesOf(tx, workspaceId, id)
+          await deleteRecordsAttachedToAttendancesOf(tx, workspaceId, { personId: id })
 
           // A person delete failing on a foreign key aborts the enclosing
           // transaction, so the follow-up read that names the referring pipeline

package/src/modules/plans/repository.ts

@@ -11,7 +11,7 @@ import type { ListWindow, SortableFields } from '../../lib/pagination.ts'
 import type { Queryable } from '../../runtime/transaction.ts'
 import { workspaceMembers } from '../workspace/schema.ts'
 import { planItems } from './schema.ts'
-import type { PipelineKind, PlanItemStatus } from './schema.ts'
+import type { PlanItemStatus, PlanItemTargetType } from './schema.ts'
 
 export type PlanItemRecord = typeof planItems.$inferSelect
 
@@ -39,7 +39,7 @@ export const DEFAULT_PLAN_ITEM_SORT = 'date'
 
 export interface PlanItemFilters {
   /** `?target_type=`: one pipeline. The Planning page's type filter. */
-  readonly targetType?: PipelineKind | undefined
+  readonly targetType?: PlanItemTargetType | undefined
   /** `?target_id=`, repeatable: one record's panel, or a page of records' next steps. */
   readonly targetIds?: readonly string[] | undefined
   /** `?status=`, repeatable. Naming the two open ones is how a caller asks for outstanding work. */

package/src/modules/plans/routes.ts

@@ -8,8 +8,8 @@ import type { Actor } from '../auth/actor.ts'
 import { resolveActorFrom } from '../auth/credentials.ts'
 import type { CredentialDependencies } from '../auth/credentials.ts'
 import type { PlanItemFilters } from './repository.ts'
-import { PIPELINE_KINDS, PLAN_ITEM_STATUSES } from './schema.ts'
-import type { PipelineKind, PlanItemStatus } from './schema.ts'
+import { PLAN_ITEM_STATUSES, PLAN_ITEM_TARGET_TYPES } from './schema.ts'
+import type { PlanItemStatus, PlanItemTargetType } from './schema.ts'
 import type {
   CreatePlanItemInput,
   PlanItemView,
@@ -40,7 +40,7 @@ const planItemShape = {
  */
 export const createBody = z.strictObject({
   ...planItemShape,
-  target_type: z.enum(PIPELINE_KINDS),
+  target_type: z.enum(PLAN_ITEM_TARGET_TYPES),
   target_id: z.string().min(1),
   owner_id: planItemShape.owner_id.default(null),
   status: planItemShape.status.default('todo'),
@@ -94,18 +94,18 @@ export function toUpdateInput(body: z.infer<typeof updateBody>): UpdatePlanItemI
  *   cannot attach to a Person, so answering the person question with an empty
  *   list would read as "none yet" instead of "that is not a thing".
  */
-function readTargetType(context: Context): PipelineKind | undefined {
+function readTargetType(context: Context): PlanItemTargetType | undefined {
   const raw = context.req.query('target_type')
 
   if (raw === undefined) {
     return undefined
   }
 
-  const parsed = z.enum(PIPELINE_KINDS).safeParse(raw)
+  const parsed = z.enum(PLAN_ITEM_TARGET_TYPES).safeParse(raw)
 
   if (!parsed.success) {
     throw AppError.validationFailed('That is not a record type a plan item attaches to', [
-      { field: 'target_type', message: `Use one of: ${PIPELINE_KINDS.join(', ')}` },
+      { field: 'target_type', message: `Use one of: ${PLAN_ITEM_TARGET_TYPES.join(', ')}` },
     ])
   }
 

package/src/modules/plans/schema.ts

@@ -1,4 +1,4 @@
-import { PIPELINE_KINDS, PLAN_ITEM_STATUSES } from '@kelpie/schemas'
+import { PLAN_ITEM_STATUSES, PLAN_ITEM_TARGET_TYPES } from '@kelpie/schemas'
 import { date, index, pgTable, text } from 'drizzle-orm/pg-core'
 
 import { checkOneOf, createdAt, primaryId, searchVector, updatedAt } from '../../lib/columns.ts'
@@ -6,8 +6,8 @@ import type { SearchVectorPart } from '../../lib/columns.ts'
 import { workspaceMembers, workspaces } from '../workspace/schema.ts'
 
 /** Re-exported for the routes and service that constrain themselves to this table. */
-export { PIPELINE_KINDS, PLAN_ITEM_STATUSES } from '@kelpie/schemas'
-export type { PipelineKind, PlanItemStatus } from '@kelpie/schemas'
+export { PLAN_ITEM_STATUSES, PLAN_ITEM_TARGET_TYPES } from '@kelpie/schemas'
+export type { PlanItemStatus, PlanItemTargetType } from '@kelpie/schemas'
 
 /**
  * Dated action items on the four pipelines. These replace any next-step text
@@ -39,7 +39,7 @@ export const planItems = pgTable(
     index('plan_items_target_idx').on(table.workspaceId, table.targetType, table.targetId),
     index('plan_items_date_idx').on(table.workspaceId, table.date),
     index('plan_items_search_idx').using('gin', table.searchVector),
-    checkOneOf('plan_items_target_type_check', table.targetType, PIPELINE_KINDS),
+    checkOneOf('plan_items_target_type_check', table.targetType, PLAN_ITEM_TARGET_TYPES),
     checkOneOf('plan_items_status_check', table.status, PLAN_ITEM_STATUSES),
   ],
 )

package/src/modules/plans/service.ts

@@ -13,7 +13,7 @@ import { targetExists } from '../recordTargets.ts'
 import * as repository from './repository.ts'
 import { DEFAULT_PLAN_ITEM_SORT, PLAN_ITEM_SORTS } from './repository.ts'
 import type { PlanItemFilters, PlanItemRecord } from './repository.ts'
-import type { PipelineKind, PlanItemStatus } from './schema.ts'
+import type { PlanItemStatus, PlanItemTargetType } from './schema.ts'
 
 /**
  * Plan items: the dated next steps on a Deal, Opportunity, Raise or Partnership.
@@ -39,7 +39,7 @@ export interface PlansDependencies {
 export type PlanItemView = Omit<PlanItemRecord, 'workspaceId'>
 
 export interface CreatePlanItemInput {
-  readonly targetType: PipelineKind
+  readonly targetType: PlanItemTargetType
   readonly targetId: string
   /** `YYYY-MM-DD`. Validated as a real calendar date at the boundary. */
   readonly date: string
@@ -94,7 +94,7 @@ export function createPlansService(dependencies: PlansDependencies): PlansServic
 
   async function requireTarget(
     workspaceId: string,
-    targetType: PipelineKind,
+    targetType: PlanItemTargetType,
     targetId: string,
   ): Promise<void> {
     if (!(await targetExists(dependencies.db, workspaceId, targetType, targetId))) {

package/src/modules/plans/tools.ts

@@ -1,4 +1,4 @@
-import { PIPELINE_KINDS, PLAN_ITEM_STATUSES } from '@kelpie/schemas'
+import { PLAN_ITEM_STATUSES, PLAN_ITEM_TARGET_TYPES } from '@kelpie/schemas'
 import { isoDateSchema } from '../../lib/dates.ts'
 import { z } from 'zod'
 
@@ -11,7 +11,7 @@ import type { PlansService } from './service.ts'
 
 const listArgs = z.strictObject({
   ...listWindowShape,
-  target_type: z.enum(PIPELINE_KINDS).optional().describe('One pipeline\'s plan items.'),
+  target_type: z.enum(PLAN_ITEM_TARGET_TYPES).optional().describe("One target type's plan items."),
   target_id: idSetArg.optional().describe('The plan items on these records.'),
   status: enumSetArg(PLAN_ITEM_STATUSES)
     .optional()

package/src/modules/recordTargets.ts

@@ -5,6 +5,7 @@ import type { Queryable } from '../runtime/transaction.ts'
 import { companies } from './companies/schema.ts'
 import { deals } from './deals/schema.ts'
 import { enquiries } from './enquiries/schema.ts'
+import { attendances, events } from './events/schema.ts'
 import { candidates } from './hiring/schema.ts'
 import { RECORD_TARGET_TYPES } from './notes/schema.ts'
 import { opportunities } from './opportunities/schema.ts'
@@ -67,6 +68,8 @@ const TABLES: Readonly<Record<RecordTargetType, TargetTable>> = {
   raise: targetTable(raises, raises.id, raises.workspaceId, raises.name),
   enquiry: targetTable(enquiries, enquiries.id, enquiries.workspaceId, enquiries.name),
   candidate: targetTable(candidates, candidates.id, candidates.workspaceId),
+  event: targetTable(events, events.id, events.workspaceId, events.name),
+  attendance: targetTable(attendances, attendances.id, attendances.workspaceId),
 }
 
 export function isRecordTargetType(value: string): value is RecordTargetType {
@@ -141,7 +144,18 @@ async function namesOfType(
   // A Candidate's label is the person's name. The role it is for is the other
   // half of the answer, but a timeline row already says which record it is on,
   // so repeating the title in the name would read as "Ada Lovelace" twice over.
+  // An Attendance is the same shape: Person↔Event, labelled by the person.
   if (target.name === undefined) {
+    if (targetType === 'attendance') {
+      return db
+        .select({ id: attendances.id, name: people.name })
+        .from(attendances)
+        .innerJoin(people, eq(attendances.personId, people.id))
+        .where(
+          and(eq(attendances.workspaceId, workspaceId), inArray(attendances.id, [...targetIds])),
+        )
+    }
+
     return db
       .select({ id: candidates.id, name: people.name })
       .from(candidates)

package/src/modules/references.ts

@@ -23,6 +23,8 @@ import { AppError } from '../lib/errors.ts'
  */
 const REFERENCING_TYPE_BY_TABLE: Readonly<Record<string, string>> = {
   candidates: 'candidate',
+  events: 'event',
+  attendances: 'attendance',
   deals: 'deal',
   enquiries: 'enquiry',
   form_submissions: 'form submission',