@kelpie/server 0.1.0

package/dist/modules/raises/service.js

@@ -0,0 +1,275 @@
+import { changedKeys } from '../../lib/changes.js';
+import { AppError } from '../../lib/errors.js';
+import { readListWindow, toPage } from '../../lib/pagination.js';
+import { describeCreation, describeLink, describeStageChange, describeUnlink, describeUpdate, } from '../activities/wording.js';
+import { actorMemberId, requireWorkspaceId } from '../auth/actor.js';
+import { deleteRecordsAttachedTo } from '../attachedRecords.js';
+import * as companyRepository from '../companies/repository.js';
+import * as pipelineRepository from '../pipelines/repository.js';
+import * as repository from './repository.js';
+import { DEFAULT_RAISE_SORT, RAISE_SORTS } from './repository.js';
+/** What a changed column is called on a timeline. The mockup says Firm and Target close, not Company and Expected close. */
+const RAISE_FIELD_LABELS = {
+    name: 'Name',
+    companyId: 'Firm',
+    checkSizeCents: 'Check size',
+    currency: 'Currency',
+    thesisFit: 'Thesis fit',
+    passReason: 'Pass reason',
+    ownerId: 'Owner',
+    expectedClose: 'Target close',
+    summary: 'Summary',
+    tags: 'Tags',
+};
+function toView(record, personIds) {
+    const { workspaceId: _workspaceId, ...view } = record;
+    return { ...view, personIds };
+}
+function toStoredColumns(input) {
+    return {
+        ...(input.name === undefined ? {} : { name: input.name }),
+        ...(input.companyId === undefined ? {} : { companyId: input.companyId }),
+        ...(input.stageId === undefined ? {} : { stageId: input.stageId }),
+        ...(input.checkSizeCents === undefined ? {} : { checkSizeCents: input.checkSizeCents }),
+        ...(input.currency === undefined ? {} : { currency: input.currency }),
+        ...(input.thesisFit === undefined ? {} : { thesisFit: input.thesisFit }),
+        ...(input.passReason === undefined ? {} : { passReason: input.passReason }),
+        ...(input.ownerId === undefined ? {} : { ownerId: input.ownerId }),
+        ...(input.expectedClose === undefined ? {} : { expectedClose: input.expectedClose }),
+        ...(input.summary === undefined ? {} : { summary: input.summary }),
+        ...(input.tags === undefined ? {} : { tags: [...input.tags] }),
+    };
+}
+export function createRaisesService(dependencies) {
+    async function require(workspaceId, id) {
+        const raise = await repository.findRaise(dependencies.db, workspaceId, id);
+        if (raise === undefined) {
+            throw AppError.notFound('Raise not found');
+        }
+        return raise;
+    }
+    async function requireCompany(workspaceId, companyId) {
+        const company = await companyRepository.findCompany(dependencies.db, workspaceId, companyId);
+        if (company === undefined) {
+            throw AppError.notFound('Company not found');
+        }
+    }
+    /**
+     * A stage a raise may sit in: exists in this workspace and belongs to the
+     * raise pipeline. The wrong-workspace case reads as missing, per `api.md`;
+     * the wrong-pipeline case is a request naming a real stage that can never
+     * hold a raise, which is a validation error rather than a missing record.
+     */
+    async function requireRaiseStage(workspaceId, stageId) {
+        const stage = await pipelineRepository.findStage(dependencies.db, workspaceId, stageId);
+        if (stage === undefined) {
+            throw AppError.notFound('Pipeline stage not found');
+        }
+        if (stage.kind !== 'raise') {
+            throw AppError.validationFailed('That stage is not part of the raise pipeline', [
+                { field: 'stage_id', message: `It belongs to the ${stage.kind} pipeline` },
+            ]);
+        }
+        return stage;
+    }
+    /** The default stage for a new raise: the first open one, or the first if none are open. */
+    async function defaultRaiseStage(workspaceId) {
+        const rows = await pipelineRepository.listStagesOfKind(dependencies.db, workspaceId, 'raise');
+        const first = rows.find((row) => row.open) ?? rows[0];
+        if (first === undefined) {
+            // Unreachable through the API: workspaces seed stages and the last stage
+            // of a pipeline cannot be removed.
+            throw AppError.conflict('This workspace has no raise stages');
+        }
+        return first;
+    }
+    async function requireOwner(workspaceId, ownerId) {
+        if (!(await repository.memberExists(dependencies.db, workspaceId, ownerId))) {
+            throw AppError.notFound('Team member not found');
+        }
+    }
+    /** @returns Each person's name, for the link activities. Any id missing here is a 404. */
+    async function requirePeople(workspaceId, personIds) {
+        const named = await repository.findPeopleNamed(dependencies.db, workspaceId, personIds);
+        const missing = personIds.filter((id) => !named.has(id));
+        if (missing.length > 0) {
+            throw new AppError('not_found', 'Person not found', missing.map((id) => ({ field: 'person_ids', message: `No person ${id} here` })));
+        }
+        return named;
+    }
+    /** @returns The page's views, with every raise's people fetched in one query. */
+    async function toViews(records) {
+        const peopleByRaise = await repository.listPersonIdsFor(dependencies.db, records.map((record) => record.id));
+        return records.map((record) => toView(record, peopleByRaise.get(record.id) ?? []));
+    }
+    return {
+        async list(actor, filters, query) {
+            const workspaceId = requireWorkspaceId(actor);
+            const window = readListWindow(query, RAISE_SORTS, DEFAULT_RAISE_SORT);
+            const rows = await repository.listRaises(dependencies.db, workspaceId, filters, window);
+            const page = toPage(rows, window, (raise) => raise.id);
+            return { items: await toViews(page.items), nextCursor: page.nextCursor };
+        },
+        async get(actor, id) {
+            const workspaceId = requireWorkspaceId(actor);
+            const raise = await require(workspaceId, id);
+            return toView(raise, await repository.listPersonIds(dependencies.db, id));
+        },
+        async create(actor, input) {
+            const workspaceId = requireWorkspaceId(actor);
+            await requireCompany(workspaceId, input.companyId);
+            const stage = input.stageId === undefined
+                ? await defaultRaiseStage(workspaceId)
+                : await requireRaiseStage(workspaceId, input.stageId);
+            const ownerId = input.ownerId === undefined ? actorMemberId(actor) : input.ownerId;
+            if (ownerId !== null) {
+                await requireOwner(workspaceId, ownerId);
+            }
+            const personIds = [...new Set(input.personIds)];
+            const named = await requirePeople(workspaceId, personIds);
+            const id = dependencies.createId('raise');
+            return dependencies.transaction(async ({ tx, events }) => {
+                const created = await repository.insertRaise(tx, {
+                    id,
+                    workspaceId,
+                    name: input.name,
+                    companyId: input.companyId,
+                    stageId: stage.id,
+                    checkSizeCents: input.checkSizeCents,
+                    currency: input.currency,
+                    thesisFit: input.thesisFit,
+                    passReason: input.passReason,
+                    ownerId,
+                    expectedClose: input.expectedClose,
+                    summary: input.summary,
+                    tags: [...input.tags],
+                });
+                await repository.insertRaisePeople(tx, id, personIds);
+                await dependencies.recordActivity(tx, workspaceId, actor, {
+                    targetType: 'raise',
+                    targetId: id,
+                    kind: 'created',
+                    ...describeCreation('Raise'),
+                });
+                // One row per person, so the timeline names who was on it from day one.
+                for (const personId of personIds) {
+                    await dependencies.recordActivity(tx, workspaceId, actor, {
+                        targetType: 'raise',
+                        targetId: id,
+                        kind: 'linked',
+                        ...describeLink('person', named.get(personId) ?? personId),
+                    });
+                }
+                events.emit('record.created', { workspaceId, objectType: 'raise', recordId: id });
+                return toView(created, personIds);
+            });
+        },
+        async update(actor, id, changes) {
+            const workspaceId = requireWorkspaceId(actor);
+            const existing = await require(workspaceId, id);
+            if (changes.companyId !== undefined && changes.companyId !== existing.companyId) {
+                await requireCompany(workspaceId, changes.companyId);
+            }
+            const stageMove = changes.stageId === undefined || changes.stageId === existing.stageId
+                ? undefined
+                : {
+                    from: await requireRaiseStage(workspaceId, existing.stageId),
+                    to: await requireRaiseStage(workspaceId, changes.stageId),
+                };
+            if (typeof changes.ownerId === 'string' && changes.ownerId !== existing.ownerId) {
+                await requireOwner(workspaceId, changes.ownerId);
+            }
+            const currentPeople = await repository.listPersonIds(dependencies.db, id);
+            const nextPeople = changes.personIds === undefined ? undefined : [...new Set(changes.personIds)];
+            const added = nextPeople === undefined
+                ? []
+                : nextPeople.filter((personId) => !currentPeople.includes(personId));
+            const removed = nextPeople === undefined
+                ? []
+                : currentPeople.filter((personId) => !nextPeople.includes(personId));
+            const named = await requirePeople(workspaceId, [...added, ...removed]);
+            const columns = toStoredColumns(changes);
+            const changed = changedKeys(existing, columns);
+            const linksChanged = added.length > 0 || removed.length > 0;
+            if (changed.length === 0 && !linksChanged) {
+                return toView(existing, currentPeople);
+            }
+            return dependencies.transaction(async ({ tx, events }) => {
+                const updated = await repository.updateRaise(tx, workspaceId, id, {
+                    ...columns,
+                    updatedAt: dependencies.now(),
+                });
+                if (updated === undefined) {
+                    throw AppError.notFound('Raise not found');
+                }
+                await repository.insertRaisePeople(tx, id, added);
+                await repository.deleteRaisePeople(tx, id, removed);
+                if (stageMove !== undefined) {
+                    await dependencies.recordActivity(tx, workspaceId, actor, {
+                        targetType: 'raise',
+                        targetId: id,
+                        kind: 'stage_changed',
+                        ...describeStageChange(stageMove.from.label, stageMove.to.label),
+                    });
+                }
+                const otherChanged = changed.filter((field) => field !== 'stageId');
+                if (otherChanged.length > 0) {
+                    await dependencies.recordActivity(tx, workspaceId, actor, {
+                        targetType: 'raise',
+                        targetId: id,
+                        kind: 'updated',
+                        ...describeUpdate(otherChanged, RAISE_FIELD_LABELS, existing, columns),
+                    });
+                }
+                // Links land on the raise's timeline only. A person's page does not roll
+                // up raise activity — the mockup's roll-up for a person is deals and
+                // partnerships — so this is where the row is read from a related page too.
+                for (const personId of added) {
+                    await dependencies.recordActivity(tx, workspaceId, actor, {
+                        targetType: 'raise',
+                        targetId: id,
+                        kind: 'linked',
+                        ...describeLink('person', named.get(personId) ?? personId),
+                    });
+                }
+                for (const personId of removed) {
+                    await dependencies.recordActivity(tx, workspaceId, actor, {
+                        targetType: 'raise',
+                        targetId: id,
+                        kind: 'unlinked',
+                        ...describeUnlink('person', named.get(personId) ?? personId),
+                    });
+                }
+                events.emit('record.updated', {
+                    workspaceId,
+                    objectType: 'raise',
+                    recordId: id,
+                    changedFields: linksChanged ? [...changed, 'personIds'] : changed,
+                });
+                if (stageMove !== undefined) {
+                    events.emit('stage.changed', {
+                        workspaceId,
+                        objectType: 'raise',
+                        recordId: id,
+                        fromStageId: stageMove.from.id,
+                        toStageId: stageMove.to.id,
+                    });
+                }
+                return toView(updated, nextPeople ?? currentPeople);
+            });
+        },
+        async remove(actor, id) {
+            const workspaceId = requireWorkspaceId(actor);
+            await dependencies.transaction(async ({ tx, events }) => {
+                await require(workspaceId, id);
+                // `raise_people` dies with the raise through its foreign key; notes,
+                // activities, decisions and plan items have no key, so they are removed
+                // here, in the same transaction.
+                await deleteRecordsAttachedTo(tx, workspaceId, 'raise', id);
+                await repository.deleteRaise(tx, workspaceId, id);
+                events.emit('record.deleted', { workspaceId, objectType: 'raise', recordId: id });
+            });
+        },
+    };
+}
+//# sourceMappingURL=service.js.map

package/dist/modules/raises/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../../../src/modules/raises/service.ts"],"names":[],"mappings":"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"}

package/dist/modules/raises/tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpToolRegistry } from '../../runtime/module.ts';
+import type { RaisesService } from './service.ts';
+export declare function registerRaisesTools(mcp: McpToolRegistry, service: RaisesService): void;
+//# sourceMappingURL=tools.d.ts.map

package/dist/modules/raises/tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/modules/raises/tools.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAG9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAYjD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CAqBtF"}

package/dist/modules/raises/tools.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { idArg, idSetArg, listWindowShape, registerCrudTools, termArg, toSet } from '../crudTools.js';
+import { createBody, raiseResponse, toCreateInput, toUpdateInput, updateBody } from './routes.js';
+/** `raises_*`. Same schemas and mappers as `/v1/raises`. */
+const listArgs = z.strictObject({
+    ...listWindowShape,
+    q: termArg,
+    company_id: idSetArg.optional().describe('Only raises with these firms.'),
+    stage_id: idSetArg.optional().describe('Only raises in these pipeline stages.'),
+    person_id: idSetArg.optional().describe('Only raises one of these people is key on.'),
+});
+export function registerRaisesTools(mcp, service) {
+    registerCrudTools(mcp, {
+        resource: 'raises',
+        subject: 'raise',
+        about: 'One firm\'s progress through one funding round: thesis fit, check size, pass reason. ' +
+            'The standing relationship with that firm is a partnership.',
+        service,
+        render: raiseResponse,
+        listArgs,
+        toFilters: (args) => ({
+            term: args.q,
+            companyIds: toSet(args.company_id),
+            stageIds: toSet(args.stage_id),
+            personIds: toSet(args.person_id),
+        }),
+        createArgs: createBody,
+        toCreateInput,
+        updateArgs: updateBody.extend({ id: idArg }),
+        toUpdateInput,
+    });
+}
+//# sourceMappingURL=tools.js.map

package/dist/modules/raises/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../../src/modules/raises/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAA;AACrG,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAGjG,4DAA4D;AAE5D,MAAM,QAAQ,GAAG,CAAC,CAAC,YAAY,CAAC;IAC9B,GAAG,eAAe;IAClB,CAAC,EAAE,OAAO;IACV,UAAU,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IACzE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uCAAuC,CAAC;IAC/E,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;CACtF,CAAC,CAAA;AAEF,MAAM,UAAU,mBAAmB,CAAC,GAAoB,EAAE,OAAsB;IAC9E,iBAAiB,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,OAAO;QAChB,KAAK,EACH,uFAAuF;YACvF,4DAA4D;QAC9D,OAAO;QACP,MAAM,EAAE,aAAa;QACrB,QAAQ;QACR,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpB,IAAI,EAAE,IAAI,CAAC,CAAC;YACZ,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;YAClC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;YAC9B,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SACjC,CAAC;QACF,UAAU,EAAE,UAAU;QACtB,aAAa;QACb,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAC5C,aAAa;KACd,CAAC,CAAA;AACJ,CAAC"}

package/dist/modules/recordTargets.d.ts

@@ -0,0 +1,55 @@
+import type { Queryable } from '../runtime/transaction.ts';
+import { RECORD_TARGET_TYPES } from './notes/schema.ts';
+/**
+ * Resolving a polymorphic `target_type` + `target_id` to the record it names.
+ *
+ * Notes and activities carry no foreign key to their target, so nothing in the
+ * database refuses a note attached to an id that does not exist, or to one that
+ * belongs to another workspace. This is where that is refused instead.
+ *
+ * Reading seven modules' tables rather than composing seven repositories is the
+ * rule already set for a filter that spans a relation (`architecture.md`): the
+ * alternative here is a switch that imports seven services to ask each of them
+ * one boolean.
+ */
+export type RecordTargetType = (typeof RECORD_TARGET_TYPES)[number];
+export declare function isRecordTargetType(value: string): value is RecordTargetType;
+/**
+ * Which of `targetIds` do not name a record of `targetType` in this workspace.
+ *
+ * One query however many ids are asked about, which is what lets a list filtered
+ * by a set of targets validate them without a round trip per id.
+ *
+ * @returns The ids that resolved to nothing, in the order they were given. An id
+ *   in another workspace is indistinguishable from one that never existed, so it
+ *   comes back here too and the caller turns either into the same 404.
+ */
+export declare function missingTargets(db: Queryable, workspaceId: string, targetType: RecordTargetType, targetIds: readonly string[]): Promise<readonly string[]>;
+/**
+ * Whether a target exists inside one workspace.
+ *
+ * @returns false both for a target that never existed and for one in another
+ *   workspace. The caller turns either into the same 404, per `api.md`.
+ */
+export declare function targetExists(db: Queryable, workspaceId: string, targetType: RecordTargetType, targetId: string): Promise<boolean>;
+/** A polymorphic reference, as notes, activities, decisions and plan items carry one. */
+export interface RecordTarget {
+    readonly targetType: RecordTargetType;
+    readonly targetId: string;
+}
+/** The key `resolveTargetNames` returns names under. Type and id together, because ids are unique only within a type. */
+export declare function targetKey(target: RecordTarget): string;
+/**
+ * What to call each of a mixed set of records.
+ *
+ * One query per distinct type however many ids are asked about, which is what
+ * lets a cross-record list name its rows without a request per row. A page
+ * showing one record's own notes has no use for this; a workspace-wide feed,
+ * where every row points somewhere different, cannot render without it.
+ *
+ * @returns Names keyed by `targetKey`. A target that resolved to nothing is
+ *   absent rather than present as a placeholder, so a caller decides for itself
+ *   whether to render the type alone or drop the row.
+ */
+export declare function resolveTargetNames(db: Queryable, workspaceId: string, targets: readonly RecordTarget[]): Promise<ReadonlyMap<string, string>>;
+//# sourceMappingURL=recordTargets.d.ts.map

package/dist/modules/recordTargets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordTargets.d.ts","sourceRoot":"","sources":["../../src/modules/recordTargets.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAI1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAMvD;;;;;;;;;;;GAWG;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AA2CnE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,gBAAgB,CAE3E;AAED;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,gBAAgB,EAC5B,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC,CAc5B;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAChC,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAElB;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,yHAAyH;AACzH,wBAAgB,SAAS,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAEtD;AA8BD;;;;;;;;;;;GAWG;AACH,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmBtC"}

package/dist/modules/recordTargets.js

@@ -0,0 +1,107 @@
+import { and, eq, inArray, sql } from 'drizzle-orm';
+import { companies } from './companies/schema.js';
+import { deals } from './deals/schema.js';
+import { candidates } from './hiring/schema.js';
+import { RECORD_TARGET_TYPES } from './notes/schema.js';
+import { opportunities } from './opportunities/schema.js';
+import { partnerships } from './partnerships/schema.js';
+import { people } from './people/schema.js';
+import { raises } from './raises/schema.js';
+function targetTable(table, id, workspaceId, name) {
+    return { table, id, workspaceId, ...(name === undefined ? {} : { name }) };
+}
+const TABLES = {
+    person: targetTable(people, people.id, people.workspaceId, people.name),
+    company: targetTable(companies, companies.id, companies.workspaceId, companies.name),
+    deal: targetTable(deals, deals.id, deals.workspaceId, deals.name),
+    opportunity: targetTable(opportunities, opportunities.id, opportunities.workspaceId, opportunities.name),
+    partnership: targetTable(partnerships, partnerships.id, partnerships.workspaceId, partnerships.name),
+    raise: targetTable(raises, raises.id, raises.workspaceId, raises.name),
+    candidate: targetTable(candidates, candidates.id, candidates.workspaceId),
+};
+export function isRecordTargetType(value) {
+    return Object.hasOwn(TABLES, value);
+}
+/**
+ * Which of `targetIds` do not name a record of `targetType` in this workspace.
+ *
+ * One query however many ids are asked about, which is what lets a list filtered
+ * by a set of targets validate them without a round trip per id.
+ *
+ * @returns The ids that resolved to nothing, in the order they were given. An id
+ *   in another workspace is indistinguishable from one that never existed, so it
+ *   comes back here too and the caller turns either into the same 404.
+ */
+export async function missingTargets(db, workspaceId, targetType, targetIds) {
+    if (targetIds.length === 0) {
+        return [];
+    }
+    const target = TABLES[targetType];
+    const found = await db
+        .select({ id: target.id })
+        .from(target.table)
+        .where(and(eq(target.workspaceId, workspaceId), inArray(target.id, [...targetIds])));
+    const existing = new Set(found.map((row) => row.id));
+    return targetIds.filter((id) => !existing.has(id));
+}
+/**
+ * Whether a target exists inside one workspace.
+ *
+ * @returns false both for a target that never existed and for one in another
+ *   workspace. The caller turns either into the same 404, per `api.md`.
+ */
+export async function targetExists(db, workspaceId, targetType, targetId) {
+    return (await missingTargets(db, workspaceId, targetType, [targetId])).length === 0;
+}
+/** The key `resolveTargetNames` returns names under. Type and id together, because ids are unique only within a type. */
+export function targetKey(target) {
+    return `${target.targetType}:${target.targetId}`;
+}
+async function namesOfType(db, workspaceId, targetType, targetIds) {
+    const target = TABLES[targetType];
+    // 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.
+    if (target.name === undefined) {
+        return db
+            .select({ id: candidates.id, name: people.name })
+            .from(candidates)
+            .innerJoin(people, eq(candidates.personId, people.id))
+            .where(and(eq(candidates.workspaceId, workspaceId), inArray(candidates.id, [...targetIds])));
+    }
+    // `sql<string>` rather than the columns alone: `TargetTable` holds them as the
+    // generic `PgColumn`, whose data type is `unknown`, so a plain select of one
+    // widens the result. Both are `text` columns in every table above.
+    return db
+        .select({ id: sql `${target.id}`, name: sql `${target.name}` })
+        .from(target.table)
+        .where(and(eq(target.workspaceId, workspaceId), inArray(target.id, [...targetIds])));
+}
+/**
+ * What to call each of a mixed set of records.
+ *
+ * One query per distinct type however many ids are asked about, which is what
+ * lets a cross-record list name its rows without a request per row. A page
+ * showing one record's own notes has no use for this; a workspace-wide feed,
+ * where every row points somewhere different, cannot render without it.
+ *
+ * @returns Names keyed by `targetKey`. A target that resolved to nothing is
+ *   absent rather than present as a placeholder, so a caller decides for itself
+ *   whether to render the type alone or drop the row.
+ */
+export async function resolveTargetNames(db, workspaceId, targets) {
+    const idsByType = new Map();
+    for (const target of targets) {
+        const ids = idsByType.get(target.targetType) ?? new Set();
+        ids.add(target.targetId);
+        idsByType.set(target.targetType, ids);
+    }
+    const names = new Map();
+    for (const [targetType, ids] of idsByType) {
+        for (const row of await namesOfType(db, workspaceId, targetType, [...ids])) {
+            names.set(targetKey({ targetType, targetId: row.id }), row.name);
+        }
+    }
+    return names;
+}
+//# sourceMappingURL=recordTargets.js.map

package/dist/modules/recordTargets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recordTargets.js","sourceRoot":"","sources":["../../src/modules/recordTargets.ts"],"names":[],"mappings":"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"}

package/dist/modules/references.d.ts

@@ -0,0 +1,8 @@
+import { AppError } from '../lib/errors.ts';
+/**
+ * @param subject The record being deleted, e.g. `person`. Appears in the message.
+ * @returns A 409. The referencing type is omitted when the driver did not report
+ *   a table, which is a worse message but still the right status.
+ */
+export declare function referencedElsewhere(error: unknown, subject: string): AppError;
+//# sourceMappingURL=references.d.ts.map

package/dist/modules/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/modules/references.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AA0B3C;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAW7E"}

package/dist/modules/references.js

@@ -0,0 +1,40 @@
+import { referenceViolationTable } from '../lib/database.js';
+import { AppError } from '../lib/errors.js';
+/**
+ * Roadmap decision 2: a delete blocked by an independent reference is a 409 that
+ * names what is still pointing at the record, so the caller knows what to detach.
+ *
+ * The database refuses first. This turns its refusal into the wire shape rather
+ * than trying to predict it: a pre-flight count would still race a concurrent
+ * insert, and would need updating every time a table gains a foreign key.
+ */
+/** Referencing tables, as the domain names a user of the API would recognise. */
+const REFERENCING_TYPE_BY_TABLE = {
+    candidates: 'candidate',
+    deal_people: 'deal',
+    deals: 'deal',
+    form_submissions: 'form submission',
+    forms: 'form',
+    opportunities: 'opportunity',
+    partnership_people: 'partnership',
+    partnerships: 'partnership',
+    raise_people: 'raise',
+    raises: 'raise',
+    workspace_members: 'team member',
+};
+/**
+ * @param subject The record being deleted, e.g. `person`. Appears in the message.
+ * @returns A 409. The referencing type is omitted when the driver did not report
+ *   a table, which is a worse message but still the right status.
+ */
+export function referencedElsewhere(error, subject) {
+    const table = referenceViolationTable(error);
+    const type = table === undefined ? undefined : (REFERENCING_TYPE_BY_TABLE[table] ?? table);
+    if (type === undefined) {
+        return AppError.conflict(`This ${subject} is still referenced by another record`);
+    }
+    return AppError.conflict(`This ${subject} is still referenced by a ${type}`, [
+        { field: 'id', message: `Referenced by ${type}` },
+    ]);
+}
+//# sourceMappingURL=references.js.map

package/dist/modules/references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.js","sourceRoot":"","sources":["../../src/modules/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAA;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C;;;;;;;GAOG;AAEH,iFAAiF;AACjF,MAAM,yBAAyB,GAAqC;IAClE,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,MAAM;IACnB,KAAK,EAAE,MAAM;IACb,gBAAgB,EAAE,iBAAiB;IACnC,KAAK,EAAE,MAAM;IACb,aAAa,EAAE,aAAa;IAC5B,kBAAkB,EAAE,aAAa;IACjC,YAAY,EAAE,aAAa;IAC3B,YAAY,EAAE,OAAO;IACrB,MAAM,EAAE,OAAO;IACf,iBAAiB,EAAE,aAAa;CACjC,CAAA;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc,EAAE,OAAe;IACjE,MAAM,KAAK,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAA;IAC5C,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,yBAAyB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAA;IAE1F,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,OAAO,wCAAwC,CAAC,CAAA;IACnF,CAAC;IAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,OAAO,6BAA6B,IAAI,EAAE,EAAE;QAC3E,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,iBAAiB,IAAI,EAAE,EAAE;KAClD,CAAC,CAAA;AACJ,CAAC"}

package/dist/modules/reseal.d.ts

@@ -0,0 +1,33 @@
+import type { Database } from '../lib/database.ts';
+import type { SecretCipher } from '../lib/secrets.ts';
+/** The columns this pass covers. Exported for the test that checks none is missing. */
+export declare const RESEALED_COLUMNS: readonly string[];
+/** What one column's pass did. */
+export interface ResealColumnOutcome {
+    /** `table.column`, for a report an operator can act on. */
+    readonly label: string;
+    readonly examined: number;
+    readonly resealed: number;
+    /**
+     * Rows that opened under neither key. Sealed under a third key, or altered.
+     * Named by id rather than counted: nothing here can recover them, so the only
+     * useful output is which rows an operator has to deal with by hand.
+     */
+    readonly unreadable: readonly string[];
+}
+export interface ResealOutcome {
+    readonly columns: readonly ResealColumnOutcome[];
+    readonly examined: number;
+    readonly resealed: number;
+    readonly unreadable: number;
+}
+/**
+ * Reads every sealed column, and rewrites anything not already under the
+ * current key.
+ *
+ * Does not throw for a row it cannot open. One unreadable row must not stop the
+ * pass from fixing every other one, so it is reported and the caller decides
+ * what a non-empty `unreadable` means.
+ */
+export declare function resealStoredSecrets(db: Database, cipher: SecretCipher): Promise<ResealOutcome>;
+//# sourceMappingURL=reseal.d.ts.map

package/dist/modules/reseal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reseal.d.ts","sourceRoot":"","sources":["../../src/modules/reseal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AA4FrD,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAAiD,CAAA;AAE/F,kCAAkC;AAClC,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,CAAA;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,YAAY,GACnB,OAAO,CAAC,aAAa,CAAC,CA8CxB"}