Comp AI CRM is an open source, CRM designed for AI agents. Agentic-first CRM.
TypeScript
feat(agent): scope field backfill tasks to records missing values (#163)
github-actions[bot]3be7bbd69fe8
diff --git a/apps/agent/agent/instructions/task.ts b/apps/agent/agent/instructions/task.tsindex 36a15096..045eba56 100644--- a/apps/agent/agent/instructions/task.ts+++ b/apps/agent/agent/instructions/task.ts@@ -34,6 +34,8 @@ export default defineDynamic({if (budget) setBudget(budget);+ const fieldKeys = attributeText.parse(attributes.fieldKeys);+const { markdown, focus } = await sessionPreamble({contactId: attributeText.parse(attributes.contactId),@@ -45,10 +47,11 @@ export default defineDynamic({kind,reason: attributeText.parse(attributes.reason),budget,+ fieldKeys: fieldKeys ? fieldKeys.split(",") : null,},);- focusOn({ ...focus, sessionId: ctx.session.id });+ focusOn({ ...focus, sessionId: ctx.session.id, taskKind: kind });return defineInstructions({markdown: `${RESEARCH_INSTRUCTIONS}\n\n${markdown}`,diff --git a/apps/agent/agent/lib/blank-facts.ts b/apps/agent/agent/lib/blank-facts.tsindex f2088c01..1923c0a9 100644--- a/apps/agent/agent/lib/blank-facts.ts+++ b/apps/agent/agent/lib/blank-facts.ts@@ -18,6 +18,8 @@ const CONTACT_SELECT = {firstName: true,lastName: true,title: true,+ seniority: true,+ function: true,linkedinUrl: true,twitterUrl: true,githubUrl: true,@@ -137,6 +139,8 @@ type Proposal = {firstName: string;lastName: string | null;title: string | null;+ seniority: string | null;+ function: string | null;linkedinUrl: string | null;twitterUrl: string | null;githubUrl: string | null;diff --git a/apps/agent/agent/lib/dispatch.ts b/apps/agent/agent/lib/dispatch.tsindex 029dbd15..c2157b00 100644--- a/apps/agent/agent/lib/dispatch.ts+++ b/apps/agent/agent/lib/dispatch.ts@@ -1,4 +1,5 @@import { EnrichmentStatus } from "@crm/db";+import { fieldBackfillPayload } from "@crm/validation/field-backfill";import { APP_AUTH, type AppAuth } from "./app-auth";import { brandOutcome, runBrand } from "./brand";import { queueEventAgentRuns } from "./custom-agent-dispatch";@@ -243,6 +244,11 @@ export function taskAuth(task: LeasedTask, base: AppAuth = APP_AUTH): AppAuth {if (task.companyId) records.companyId = task.companyId;if (task.dealId) records.dealId = task.dealId;+ if (task.kind === "field-backfill") {+ const parsed = fieldBackfillPayload.safeParse(task.payload);+ if (parsed.success) records.fieldKeys = parsed.data.keys.join(",");+ }+return {...base,attributes: {@@ -388,10 +394,14 @@ export function brief(task: LeasedTask): string {? `This is attempt ${task.attempts}; the earlier one did not finish. Carry on from what is already in this thread rather than starting again. `: "";- return again + work(task.kind, task.reason);+ return again + work(task.kind, task.reason, task.payload);}-function work(kind: string, reason: string): string {+function work(+ kind: string,+ reason: string,+ payload: LeasedTask["payload"],+): string {switch (kind) {case "identify":return "Work out who this contact actually is, and record what you find. Read what we already have before spending anything.";@@ -404,6 +414,11 @@ function work(kind: string, reason: string): string {return "This company's brand, industry, location and links are filled in separately and may already be there. Read the account, fill anything still missing, and write a brief if there is something worth saying.";case "workspace-profile":return "Write the profile of the company you work for, so that every other session knows who we are. Read our own site and keep it short.";+ case "field-backfill": {+ const parsed = fieldBackfillPayload.safeParse(payload);+ const keys = parsed.success ? parsed.data.keys.join(", ") : reason;+ return `This record is missing a value for the custom field(s) ${keys}. Call list_fields for this record's type, read each field's brief, and call set_field_value only where you find real evidence — leave it blank rather than guess.`;+ }default:return `Handle this: ${reason}`;}diff --git a/apps/agent/agent/lib/facts.ts b/apps/agent/agent/lib/facts.tsindex 10eef699..ff92b1a3 100644--- a/apps/agent/agent/lib/facts.ts+++ b/apps/agent/agent/lib/facts.ts@@ -10,8 +10,8 @@ const FIELDS = {twitterUrl: { column: "twitterUrl" },githubUrl: { column: "githubUrl" },employer: { column: null },- seniority: { column: null },- function: { column: null },+ seniority: { column: "seniority" },+ function: { column: "function" },location: { column: null },tenure: { column: null },} as const;@@ -96,6 +96,8 @@ export async function recordFact(firstName: true,lastName: true,title: true,+ seniority: true,+ function: true,linkedinUrl: true,twitterUrl: true,githubUrl: true,diff --git a/apps/agent/agent/lib/fields.ts b/apps/agent/agent/lib/fields.tsindex 39d2b97d..8f0b45f7 100644--- a/apps/agent/agent/lib/fields.ts+++ b/apps/agent/agent/lib/fields.ts@@ -6,12 +6,15 @@ import {FieldValueError,fieldKeyFromLabel,type RecordField,+ readValue,recordColumn,type SerializedField,serializeField,usesOptions,writeValues,} from "@crm/db/fields";+import { lockIdempotencyKey } from "@crm/db/idempotency";+import { currentFocus } from "./focus";const WITH_OPTIONS = { options: { orderBy: { position: "asc" } } } as const;@@ -75,9 +78,34 @@ export async function writeField(input: {};}+ const isBackfill = currentFocus().taskKind === "field-backfill";+try {- await writeValues(db, input.entity, input.recordId, definitions, {- [input.key]: input.value,+ return await db.$transaction(async (tx) => {+ if (isBackfill) {+ const column = recordColumn(input.entity);+ await lockIdempotencyKey(+ tx,+ `field-value:${definition.id}:${input.recordId}`,+ );++ const row = await tx.fieldValue.findFirst({+ where: { fieldId: definition.id, [column]: input.recordId },+ });++ if (readValue(definition, row ?? undefined) !== null) {+ return {+ written: false,+ reason: `"${input.key}" already has a value on this record. Someone filled it since this task was queued — leave it as is.`,+ };+ }+ }++ await writeValues(tx, input.entity, input.recordId, definitions, {+ [input.key]: input.value,+ });++ return { written: true, key: input.key, value: input.value };});} catch (error) {if (error instanceof FieldValueError) {@@ -86,8 +114,6 @@ export async function writeField(input: {throw error;}-- return { written: true, key: input.key, value: input.value };}export async function createField(input: {diff --git a/apps/agent/agent/lib/focus.ts b/apps/agent/agent/lib/focus.tsindex 2217c237..f3f39dc5 100644--- a/apps/agent/agent/lib/focus.ts+++ b/apps/agent/agent/lib/focus.ts@@ -5,6 +5,7 @@ export const focus = defineState("crm.focus", () => ({contactId: null as string | null,companyId: null as string | null,sessionId: null as string | null,+ taskKind: null as string | null,spent: 0,budget: 4,exhausted: false,@@ -13,14 +14,19 @@ export const focus = defineState("crm.focus", () => ({export type CurrentFocus = {contactId: string | null;sessionId: string | null;+ taskKind: string | null;};export function currentFocus(): CurrentFocus {try {const state = focus.get();- return { contactId: state.contactId, sessionId: state.sessionId };+ return {+ contactId: state.contactId,+ sessionId: state.sessionId,+ taskKind: state.taskKind,+ };} catch {- return { contactId: null, sessionId: null };+ return { contactId: null, sessionId: null, taskKind: null };}}@@ -28,12 +34,14 @@ export function focusOn(input: {contactId?: string | null;companyId?: string | null;sessionId?: string | null;+ taskKind?: string | null;}): void {focus.update((current) => ({...current,contactId: input.contactId ?? current.contactId,companyId: input.companyId ?? current.companyId,sessionId: input.sessionId ?? current.sessionId,+ taskKind: input.taskKind ?? current.taskKind,}));}diff --git a/apps/agent/agent/lib/preamble.ts b/apps/agent/agent/lib/preamble.tsindex 10afea4a..1b93f383 100644--- a/apps/agent/agent/lib/preamble.ts+++ b/apps/agent/agent/lib/preamble.ts@@ -8,6 +8,8 @@ export type Opened = {kind?: string | null;reason?: string | null;budget?: number | null;+ /** Set only for a `field-backfill` task — the custom field key(s) still blank on this record. */+ fieldKeys?: string[] | null;};export type Preamble = {@@ -42,6 +44,19 @@ async function closing(): Promise<string> {return composeClosing(await identity());}+function fieldBackfillLine(opened: Opened): string {+ if (!opened.fieldKeys || opened.fieldKeys.length === 0) return "";++ return [+ `**This is a field-backfill task.** This record is missing a value for`,+ `the custom field key(s) ${opened.fieldKeys.map((key) => `\`${key}\``).join(", ")}.`,+ "Call `list_fields` for this record's entity type to read each field's",+ "label, options and brief (what counts as an answer), then call",+ "`set_field_value` with this record's id for any you find real evidence",+ "for. Leave one blank rather than guess.",+ ].join(" ");+}+function opening(opened: Opened, questions: string): string {if (opened.dispatched) {return [@@ -113,6 +128,7 @@ export async function contactPreamble(opened.budget? `Budget: **${opened.budget}** vendor calls. Spend them where they matter.`: "",+ fieldBackfillLine(opened),"",opening(opened,@@ -197,6 +213,7 @@ export async function companyPreamble(`You are working on **${company.name}**${company.domain ? ` (${company.domain})` : ""}${company.industry ? `, ${company.industry}` : ""} — company id \`${companyId}\`.`,+ fieldBackfillLine(opened),"",opening(opened,@@ -285,6 +302,7 @@ export async function dealPreamble(? [`The rep's own description of it: "${deal.description}"`]: []),people ? `People on it: ${people}` : "Nobody is attached to it yet.",+ fieldBackfillLine(opened),"",opening(opened,@@ -293,10 +311,14 @@ export async function dealPreamble("","Start with `read_deal_history` on this deal id. It returns the stage clock, every stage this deal has moved through, the last reply from their side and the next meeting — which is how you answer *where does this stand* rather than reciting the stage field back.","",- "You can research the people and the company behind it with the usual tools — a deal itself has no fields to enrich, so anything you learn is recorded against them.",+ opened.fieldKeys && opened.fieldKeys.length > 0+ ? "You can research the people and the company behind it with the usual tools too — most of what you learn about them is recorded against them, not the deal."+ : "You can research the people and the company behind it with the usual tools — a deal itself has no fields to enrich, so anything you learn is recorded against them.","",await closing(),- ].join("\n");+ ]+ .filter(Boolean)+ .join("\n");return { markdown, focus: { companyId: deal.company?.id ?? null } };}diff --git a/apps/agent/agent/lib/stale-tasks.ts b/apps/agent/agent/lib/stale-tasks.tsindex 1d2ade28..e43dab47 100644--- a/apps/agent/agent/lib/stale-tasks.ts+++ b/apps/agent/agent/lib/stale-tasks.ts@@ -12,6 +12,9 @@ const LANDED_OUTCOME =const RETIRED_ERROR ="Research was attempted several times and never completed.";+const UNTARGETED_OUTCOME =+ "No record was ever attached to this task, so it can never be worked. Retired.";+export type StaleTaskSweep = {scanned: number;closed: number;@@ -27,6 +30,7 @@ type OpenTask = {kind: string;contactId: string | null;companyId: string | null;+ dealId: string | null;attempts: number;leasedUntil: Date | null;startedAt: Date | null;@@ -96,6 +100,7 @@ async function runSweep(sweep: StaleTaskSweep): Promise<void> {kind: true,contactId: true,companyId: true,+ dealId: true,attempts: true,leasedUntil: true,startedAt: true,@@ -109,9 +114,15 @@ async function runSweep(sweep: StaleTaskSweep): Promise<void> {const completed = await completedSubjects(tasks);const landed: string[] = [];+ const untargeted: string[] = [];const dead: string[] = [];for (const task of tasks) {+ if (isUntargetedFieldBackfill(task)) {+ untargeted.push(task.id);+ continue;+ }+if (finishedElsewhere(task, completed)) {landed.push(task.id);continue;@@ -136,6 +147,19 @@ async function runSweep(sweep: StaleTaskSweep): Promise<void> {sweep.closed = count;}+ if (untargeted.length > 0) {+ const { count } = await db.agentTask.updateMany({+ where: {+ id: { in: untargeted },+ finishedAt: null,+ OR: [{ leasedUntil: null }, { leasedUntil: { lt: now } }],+ },+ data: { finishedAt: now, outcome: UNTARGETED_OUTCOME },+ });++ sweep.closed += count;+ }+sweep.retired = (await retireAbandoned()).length;if (dead.length > 0) {@@ -202,6 +226,15 @@ function finishedElsewhere(return enrichedAt.getTime() >= task.startedAt.getTime();}+function isUntargetedFieldBackfill(task: OpenTask): boolean {+ return (+ task.kind === "field-backfill" &&+ !task.contactId &&+ !task.companyId &&+ !task.dealId+ );+}+function unique(ids: readonly (string | null)[]): string[] {return [...new Set(ids.filter((id): id is string => id !== null))];}diff --git a/apps/api/package.json b/apps/api/package.jsonindex 73076b5f..151aec0f 100644--- a/apps/api/package.json+++ b/apps/api/package.json@@ -34,6 +34,7 @@"@nestjs/config": "^4.0.4","@nestjs/core": "^11.0.1","@nestjs/platform-express": "^11.0.1",+ "@nestjs/swagger": "^11.4.7","@thallesp/nestjs-better-auth": "^2.7.0","@trpc/server": "^11.18.0","@vercel/blob": "^2.6.1",@@ -46,6 +47,7 @@"nestjs-trpc": "^2.13.0","reflect-metadata": "^0.2.2","rxjs": "^7.8.1",+ "trpc-to-openapi": "^3.3.0","zod": "^4.4.3"},"devDependencies": {diff --git a/apps/api/src/activities/activities.contracts.ts b/apps/api/src/activities/activities.contracts.tsindex a7a19f19..ad984fde 100644--- a/apps/api/src/activities/activities.contracts.ts+++ b/apps/api/src/activities/activities.contracts.ts@@ -1,4 +1,5 @@import { ActivityType } from "@crm/db";+import { activityMeta } from "@crm/validation/activity-meta";import { z } from "zod";const COMPOSABLE_TYPES = [@@ -11,6 +12,18 @@ const COMPOSABLE_TYPES = [const composableEnum = z.enum(COMPOSABLE_TYPES);+const ALL_ACTIVITY_TYPES = [+ ActivityType.NOTE,+ ActivityType.CALL,+ ActivityType.EMAIL,+ ActivityType.MEETING,+ ActivityType.TASK,+ ActivityType.STAGE_CHANGE,+ ActivityType.ENRICHMENT,+] as const;++const activityTypeOutput = z.enum(ALL_ACTIVITY_TYPES);+const TIMELINE_FILTERS = ["all","history",@@ -75,3 +88,96 @@ export const myTasksInput = z.object({});export type MyTasksInput = z.infer<typeof myTasksInput>;++const activityAuthorOutput = z.object({+ id: z.string(),+ name: z.string(),+ email: z.string(),+ image: z.string().nullable(),+});++const activityCompanyRefOutput = z+ .object({+ id: z.string(),+ name: z.string(),+ })+ .nullable();++const activityContactRefOutput = z+ .object({+ id: z.string(),+ firstName: z.string(),+ lastName: z.string().nullable(),+ })+ .nullable();++const activityDealRefOutput = z+ .object({+ id: z.string(),+ name: z.string(),+ })+ .nullable();++const activityEmailThreadOutput = z+ .object({+ id: z.string(),+ messageCount: z.number(),+ lastMessageAt: z.string(),+ })+ .nullable();++const activityCalendarEventOutput = z+ .object({+ id: z.string(),+ startsAt: z.string(),+ endsAt: z.string(),+ isAllDay: z.boolean(),+ location: z.string().nullable(),+ conferenceUrl: z.string().nullable(),+ attendeeCount: z.number(),+ })+ .nullable();++export const activityEntryOutput = z.object({+ id: z.string(),+ type: activityTypeOutput,+ subject: z.string().nullable(),+ body: z.string().nullable(),+ occurredAt: z.string().nullable(),+ dueAt: z.string().nullable(),+ completedAt: z.string().nullable(),+ meta: activityMeta,+ createdAt: z.string(),+ createdBy: activityAuthorOutput,+ company: activityCompanyRefOutput,+ contact: activityContactRefOutput,+ deal: activityDealRefOutput,+ emailThread: activityEmailThreadOutput,+ calendarEvent: activityCalendarEventOutput,+});++export type ActivityEntry = z.infer<typeof activityEntryOutput>;++export const timelineOutput = z.object({+ entries: z.array(activityEntryOutput),+ nextCursor: z.string().nullable(),+});++export type TimelineResult = z.infer<typeof timelineOutput>;++export const timelineCountsOutput = z.object({+ all: z.number(),+ notes: z.number(),+ upcoming: z.number(),+ done: z.number(),+ email: z.number(),+ meetings: z.number(),+});++export type TimelineCounts = z.infer<typeof timelineCountsOutput>;++export const myTasksOutput = z.array(activityEntryOutput);++export const activityCreateOutput = activityEntryOutput;++export const completeOutput = activityEntryOutput;diff --git a/apps/api/src/activities/activities.router.ts b/apps/api/src/activities/activities.router.tsindex d75f6218..6b1fd81b 100644--- a/apps/api/src/activities/activities.router.ts+++ b/apps/api/src/activities/activities.router.ts@@ -10,12 +10,18 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import {activityCreateInput,+ activityCreateOutput,completeInput,+ completeOutput,myTasksInput,+ myTasksOutput,timelineCountsInput,+ timelineCountsOutput,timelineInput,+ timelineOutput,} from "./activities.contracts";import { ActivitiesService } from "./activities.service";@@ -26,17 +32,29 @@ export class ActivitiesRouter {@Inject(ActivitiesService) private readonly activities: ActivitiesService,) {}- @Query({ input: timelineInput })+ @Query({+ input: timelineInput,+ output: timelineOutput,+ meta: restMeta("GET", "/activities", ["Activities"]),+ })async timeline(@Input() input: z.infer<typeof timelineInput>) {return this.activities.timeline(input);}- @Query({ input: timelineCountsInput })+ @Query({+ input: timelineCountsInput,+ output: timelineCountsOutput,+ meta: restMeta("GET", "/activities/counts", ["Activities"]),+ })async timelineCounts(@Input() input: z.infer<typeof timelineCountsInput>) {return this.activities.timelineCounts(input);}- @Query({ input: myTasksInput })+ @Query({+ input: myTasksInput,+ output: myTasksOutput,+ meta: restMeta("GET", "/activities/my-tasks", ["Activities"]),+ })async myTasks(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof myTasksInput>,@@ -44,7 +62,11 @@ export class ActivitiesRouter {return this.activities.myTasks(input, ctx.user.id);}- @Mutation({ input: activityCreateInput })+ @Mutation({+ input: activityCreateInput,+ output: activityCreateOutput,+ meta: restMeta("POST", "/activities", ["Activities"]),+ })async create(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof activityCreateInput>,@@ -52,7 +74,11 @@ export class ActivitiesRouter {return this.activities.create(input, ctx.user.id);}- @Mutation({ input: completeInput })+ @Mutation({+ input: completeInput,+ output: completeOutput,+ meta: restMeta("PATCH", "/activities/{id}/complete", ["Activities"]),+ })async complete(@Input() input: z.infer<typeof completeInput>) {return this.activities.complete(input.id, input.completed);}diff --git a/apps/api/src/activities/activities.service.ts b/apps/api/src/activities/activities.service.tsindex 5fc2353b..50439fcb 100644--- a/apps/api/src/activities/activities.service.ts+++ b/apps/api/src/activities/activities.service.ts@@ -11,9 +11,12 @@ import { blankToNull } from "../crm/values";import { InjectDatabase } from "../database/database.constants";import type {ActivityCreateInput,+ ActivityEntry,MyTasksInput,+ TimelineCounts,TimelineFilter,TimelineInput,+ TimelineResult,} from "./activities.contracts";const AUTHOR_SELECT = {@@ -74,7 +77,7 @@ export class ActivitiesService {private readonly stamp: ActivityStampService,) {}- async timeline(input: TimelineInput) {+ async timeline(input: TimelineInput): Promise<TimelineResult> {const where = this.anchor(input);Object.assign(where, filterClause(input.filter));@@ -101,7 +104,7 @@ export class ActivitiesService {async timelineCounts(input: Pick<TimelineInput, "companyId" | "contactId" | "dealId">,- ) {+ ): Promise<TimelineCounts> {const anchor = this.anchor(input);const [all, notes, upcoming, done, email, meetings] = await Promise.all([@@ -124,7 +127,10 @@ export class ActivitiesService {return { all, notes, upcoming, done, email, meetings };}- async create(input: ActivityCreateInput, actingUserId: string) {+ async create(+ input: ActivityCreateInput,+ actingUserId: string,+ ): Promise<ActivityEntry> {const companyId = await this.resolveCompanyId(input);const isTask = input.type === ActivityType.TASK;@@ -158,7 +164,7 @@ export class ActivitiesService {return serializeEntry(activity);}- async complete(id: string, completed: boolean) {+ async complete(id: string, completed: boolean): Promise<ActivityEntry> {const activity = await this.db.activity.findUnique({where: { id },select: { type: true },@@ -181,7 +187,10 @@ export class ActivitiesService {return serializeEntry(updated);}- async myTasks(input: MyTasksInput, actingUserId: string) {+ async myTasks(+ input: MyTasksInput,+ actingUserId: string,+ ): Promise<ActivityEntry[]> {const now = new Date();const where: Prisma.ActivityWhereInput = {type: ActivityType.TASK,diff --git a/apps/api/src/agent/agent-dispatch.config.ts b/apps/api/src/agent/agent-dispatch.config.tsindex 9861a2e6..82c8f1f7 100644--- a/apps/api/src/agent/agent-dispatch.config.ts+++ b/apps/api/src/agent/agent-dispatch.config.ts@@ -10,4 +10,5 @@ export const AGENT_DISPATCH = {redeliverWithinMs: 10 * MINUTE_MS,redeliverBatch: 20,},+ fieldBackfill: { concurrency: 8 },} as const;diff --git a/apps/api/src/agent/agent-trigger.service.ts b/apps/api/src/agent/agent-trigger.service.tsindex 4b800513..4ef47b0f 100644--- a/apps/api/src/agent/agent-trigger.service.ts+++ b/apps/api/src/agent/agent-trigger.service.ts@@ -1,7 +1,9 @@import { type Db, type FieldEntity, Prisma } from "@crm/db";import { PRIORITY } from "@crm/db/agent-tasks";import { CRM_EVENT_CATALOG, type CrmEventType } from "@crm/db/crm-events";+import { RECORD_ID_COLUMNS } from "@crm/db/fields";import { lockIdempotencyKey } from "@crm/db/idempotency";+import { fieldBackfillPayload } from "@crm/validation/field-backfill";import { Injectable, Logger } from "@nestjs/common";import { InjectDatabase } from "../database/database.constants";import { AGENT_DISPATCH } from "./agent-dispatch.config";@@ -26,6 +28,21 @@ export type AgentTaskQueue = {) => Promise<void>;};+async function runWithConcurrency<T>(+ items: readonly T[],+ concurrency: number,+ run: (item: T) => Promise<void>,+): Promise<void> {+ const queue = items[Symbol.iterator]();+ const width = Math.max(1, Math.min(concurrency, items.length));++ await Promise.all(+ Array.from({ length: width }, async () => {+ for (const item of queue) await run(item);+ }),+ );+}+@Injectable()export class AgentTriggerService {private readonly logger = new Logger(AgentTriggerService.name);@@ -186,54 +203,103 @@ export class AgentTriggerService {return result;}- async fieldBackfill(+ async fieldBackfillRecords(entity: FieldEntity,- key: string,+ keys: string[],+ ids: string[],reason: string,- ): Promise<void> {- const subject = `${entity.toLowerCase()}.${key}`;+ ): Promise<{ queued: number; merged: number }> {+ if (ids.length === 0 || keys.length === 0) {+ return { queued: 0, merged: 0 };+ }- try {- const pending = await this.db.agentTask.findFirst({- where: {- kind: "field-backfill",- finishedAt: null,- reason: { startsWith: `${subject}: ` },- },- select: { id: true },- });+ const column = RECORD_ID_COLUMNS[entity];+ let queued = 0;+ let merged = 0;- if (pending) return;+ const queueOne = async (id: string): Promise<void> => {+ try {+ const outcome = await this.db.$transaction(async (tx) => {+ await lockIdempotencyKey(+ tx,+ `agent-task:field-backfill:${entity}:${id}`,+ );- await this.db.agentTask.create({- data: {- kind: "field-backfill",- reason: `${subject}: ${reason}`,- priority: PRIORITY.fieldBackfill,- budget: 8,- dueAt: new Date(),- },- });+ const pending = await tx.agentTask.findFirst({+ where: {+ kind: "field-backfill",+ finishedAt: null,+ [column]: id,+ } as Prisma.AgentTaskWhereInput,+ select: { id: true, payload: true },+ });++ if (!pending) {+ await tx.agentTask.create({+ data: {+ [column]: id,+ kind: "field-backfill",+ reason,+ priority: PRIORITY.fieldBackfill,+ budget: 8,+ dueAt: new Date(),+ payload: { entity, keys } satisfies Prisma.InputJsonValue,+ },+ });+ return "queued" as const;+ }++ const parsed = fieldBackfillPayload.safeParse(pending.payload);+ const priorKeys = parsed.success ? parsed.data.keys : [];+ const nextKeys = [...new Set([...priorKeys, ...keys])];+ if (nextKeys.length === priorKeys.length) return "unchanged" as const;++ await tx.agentTask.update({+ where: { id: pending.id },+ data: {+ payload: {+ entity,+ keys: nextKeys,+ } satisfies Prisma.InputJsonValue,+ },+ });+ return "merged" as const;+ });- this.logger.log({- message: "Agent task queued",- kind: "field-backfill",- entity,- key,- });+ if (outcome === "queued") queued += 1;+ if (outcome === "merged") merged += 1;+ } catch (error) {+ this.logger.error(+ {+ message: "Could not queue agent task",+ kind: "field-backfill",+ entity,+ keys,+ recordId: id,+ },+ error instanceof Error ? error.stack : String(error),+ );+ }+ };- this.poke();- } catch (error) {- this.logger.error(- {- message: "Could not queue agent task",- kind: "field-backfill",- entity,- key,- },- error instanceof Error ? error.stack : String(error),- );- }+ await runWithConcurrency(+ ids,+ AGENT_DISPATCH.fieldBackfill.concurrency,+ queueOne,+ );++ this.logger.log({+ message: "Agent task queued",+ kind: "field-backfill",+ entity,+ keys,+ queued,+ merged,+ });++ if (queued > 0 || merged > 0) this.poke();++ return { queued, merged };}async meetingSoon(contactId: string, when: Date): Promise<void> {diff --git a/apps/api/src/agent/agents.contracts.ts b/apps/api/src/agent/agents.contracts.tsindex 606904a7..844e16dc 100644--- a/apps/api/src/agent/agents.contracts.ts+++ b/apps/api/src/agent/agents.contracts.ts@@ -3,6 +3,64 @@ import { z } from "zod";export const agentManifest = schemas.agents.capabilities.loose();+const agentManifestSummaryOutput = z.object({+ name: z.string().optional(),+ description: z.string().optional(),+ access: z.array(z.string()),+ triggers: z.array(+ z.object({ type: z.string().optional(), summary: z.string().optional() }),+ ),+ actions: z.array(z.object({ summary: z.string().optional() })),+ dataScope: z.object({ summary: z.string().optional() }),+});++const agentDefinitionStatus = z.enum([+ "DRAFT",+ "DEPLOYING",+ "LIVE",+ "PAUSED",+ "ARCHIVED",+ "DELETED",+]);++const agentVersionStatus = z.enum([+ "DRAFT",+ "VALIDATING",+ "READY",+ "DEPLOYED",+ "REJECTED",+]);++const agentRunStatus = z.enum([+ "QUEUED",+ "RUNNING",+ "WAITING_FOR_APPROVAL",+ "SUCCEEDED",+ "FAILED",+ "CANCELLED",+]);++const agentActionStatus = z.enum([+ "PLANNED",+ "RUNNING",+ "SUCCEEDED",+ "FAILED",+ "CANCELLED",+]);++const agentTriggerType = z.enum(["MANUAL", "SCHEDULE", "EVENT", "WEBHOOK"]);++const agentUserSummaryOutput = z.object({+ id: z.string(),+ name: z.string(),+ image: z.string().nullable(),+});++const agentVersionRefOutput = z.object({+ id: z.string(),+ number: z.number(),+});+export const agentIdInput = z.object({ id: z.string().min(1) });export const agentHistoryInput = agentIdInput.extend({@@ -72,3 +130,251 @@ export const agentSaveFileInput = agentIdInput.extend({});export type AgentSaveFileInput = z.infer<typeof agentSaveFileInput>;++const agentListItemOutput = z.object({+ id: z.string(),+ name: z.string(),+ description: z.string().nullable(),+ status: agentDefinitionStatus,+ createdAt: z.string(),+ updatedAt: z.string(),+ createdBy: agentUserSummaryOutput,+ currentVersion: z+ .object({+ id: z.string(),+ number: z.number(),+ deployedAt: z.string().nullable(),+ })+ .nullable(),+ triggers: z.array(+ z.object({+ id: z.string(),+ type: agentTriggerType,+ name: z.string(),+ nextRunAt: z.string().nullable(),+ }),+ ),+ runCount: z.number(),+});++export const agentListOutput = z.array(agentListItemOutput);++export type AgentListItem = z.infer<typeof agentListItemOutput>;++export const agentReviseOutput = z.object({ versionId: z.string() });++export const agentFilesOutput = z.object({+ versionId: z.string().nullable(),+ files: z.array(+ z.object({+ path: z.string(),+ language: z.string(),+ content: z.string(),+ previousContent: z.string().nullable(),+ revision: z.number(),+ }),+ ),+});++export const agentSaveFileOutput = z.object({+ saved: z.boolean(),+ versionId: z.string().nullable(),+});++const agentCapabilitiesResultOutput = z.discriminatedUnion("readable", [+ z.object({+ readable: z.literal(false),+ problem: z.string(),+ actions: z.array(schemas.agents.capabilityAction),+ dataScope: z.null(),+ channel: z.null(),+ }),+ z.object({+ readable: z.literal(true),+ problem: z.null(),+ actions: z.array(schemas.agents.capabilityAction),+ dataScope: schemas.agents.capabilities.shape.dataScope,+ channel: schemas.agents.capabilityDestination.nullable(),+ }),+]);++export const agentByIdOutput = z.object({+ id: z.string(),+ name: z.string(),+ description: z.string().nullable(),+ status: agentDefinitionStatus,+ createdById: z.string(),+ createdBy: agentUserSummaryOutput,+ canManage: z.boolean(),+ createdAt: z.string(),+ updatedAt: z.string(),+ currentVersion: z+ .object({+ id: z.string(),+ number: z.number(),+ status: agentVersionStatus,+ manifest: z.unknown(),+ modelId: z.string(),+ sandboxPolicy: z.unknown(),+ approvedAt: z.string().nullable(),+ deployedAt: z.string().nullable(),+ })+ .nullable(),+ reviewVersion: z+ .object({+ id: z.string(),+ number: z.number(),+ status: z.enum(["DRAFT", "READY"]),+ manifest: agentManifestSummaryOutput,+ modelId: z.string(),+ sandboxPolicy: z.unknown(),+ sourceConversationId: z.string().nullable(),+ })+ .nullable(),+ triggers: z.array(+ z.object({+ id: z.string(),+ type: agentTriggerType,+ name: z.string(),+ config: z.unknown(),+ enabled: z.boolean(),+ nextRunAt: z.string().nullable(),+ lastRunAt: z.string().nullable(),+ }),+ ),+ runCount: z.number(),+ capabilities: agentCapabilitiesResultOutput,+});++export type AgentDetail = z.infer<typeof agentByIdOutput>;++const agentRunEventOutput = z.object({+ id: z.string(),+ sequence: z.number(),+ type: z.string(),+ data: z.unknown(),+ emittedAt: z.string(),+});++const agentRunActionOutput = z.object({+ id: z.string(),+ type: z.string(),+ provider: z.string(),+ targetType: z.string().nullable(),+ targetId: z.string().nullable(),+ targetLabel: z.string().nullable(),+ summary: z.string(),+ status: agentActionStatus,+ externalId: z.string().nullable(),+ attemptCount: z.number(),+ errorCode: z.string().nullable(),+ errorMessage: z.string().nullable(),+ plannedAt: z.string(),+ startedAt: z.string().nullable(),+ completedAt: z.string().nullable(),+});++const agentRunSummaryOutput = z.object({+ id: z.string(),+ status: agentRunStatus,+ triggerType: agentTriggerType,+ summary: z.string().nullable(),+ modelId: z.string().nullable(),+ inputTokens: z.number().nullable(),+ outputTokens: z.number().nullable(),+ costUsd: z.string().nullable(),+ errorCode: z.string().nullable(),+ errorMessage: z.string().nullable(),+ createdAt: z.string(),+ startedAt: z.string().nullable(),+ finishedAt: z.string().nullable(),+ initiatedBy: agentUserSummaryOutput.nullable(),+ version: agentVersionRefOutput,+ totalEvents: z.number(),+ eventsTruncated: z.boolean(),+ canCancel: z.boolean(),+ events: z.array(agentRunEventOutput),+ actions: z.array(agentRunActionOutput),+});++export const agentHistoryOutput = z.array(agentRunSummaryOutput);++export type AgentRunSummary = z.infer<typeof agentRunSummaryOutput>;++const agentAuditEventOutput = z.object({+ id: z.string(),+ type: z.string(),+ summary: z.string(),+ before: z.unknown().nullable(),+ after: z.unknown().nullable(),+ requestId: z.string().nullable(),+ emittedAt: z.string(),+ actorType: z.string(),+ actorId: z.string().nullable(),+ actorUser: agentUserSummaryOutput.nullable(),+ version: agentVersionRefOutput.nullable(),+});++export const agentActivityOutput = z.array(agentAuditEventOutput);++export type AgentAuditEventSummary = z.infer<typeof agentAuditEventOutput>;++export const agentUpdateOutput = z.object({+ id: z.string(),+ name: z.string(),+ description: z.string().nullable(),+ status: agentDefinitionStatus,+});++export const agentDeployOutput = z.object({+ id: z.string(),+ versionId: z.string(),+ status: z.literal("LIVE"),+});++export const agentPauseOutput = z.object({+ id: z.string(),+ name: z.string(),+ status: z.literal("PAUSED"),+ updatedAt: z.string(),+});++export const agentResumeOutput = z.object({+ id: z.string(),+ name: z.string(),+ status: z.literal("LIVE"),+ updatedAt: z.string(),+});++export const agentArchiveOutput = z.object({+ id: z.string(),+ name: z.string(),+ status: z.literal("ARCHIVED"),+ updatedAt: z.string(),+});++export const agentRestoreOutput = z.object({+ id: z.string(),+ name: z.string(),+ status: z.literal("PAUSED"),+ updatedAt: z.string(),+});++export const agentRemoveOutput = z.object({+ id: z.string(),+ name: z.string(),+ status: z.literal("DELETED"),+ updatedAt: z.string(),+ disabledTriggers: z.number(),+ cancelledRuns: z.number(),+});++export const agentRunNowOutput = z.object({ id: z.string() });++export const agentRetryRunOutput = z.object({ id: z.string() });++export const agentCancelRunOutput = z.object({+ id: z.string(),+ status: agentRunStatus,+ cancelled: z.boolean(),+});diff --git a/apps/api/src/agent/agents.router.ts b/apps/api/src/agent/agents.router.tsindex 6e4f3785..fdec1ec9 100644--- a/apps/api/src/agent/agents.router.ts+++ b/apps/api/src/agent/agents.router.ts@@ -10,18 +10,36 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import { AgentDefinitionsService } from "./agent-definitions.service";import { AgentRunsService } from "./agent-runs.service";import {+ agentActivityOutput,+ agentArchiveOutput,+ agentByIdOutput,agentCancelRunInput,+ agentCancelRunOutput,agentDeployInput,+ agentDeployOutput,+ agentFilesOutput,agentHistoryInput,+ agentHistoryOutput,agentIdInput,+ agentListOutput,+ agentPauseOutput,+ agentRemoveOutput,+ agentRestoreOutput,+ agentResumeOutput,agentRetryRunInput,+ agentRetryRunOutput,agentReviseInput,+ agentReviseOutput,agentRunNowInput,+ agentRunNowOutput,agentSaveFileInput,+ agentSaveFileOutput,agentUpdateInput,+ agentUpdateOutput,} from "./agents.contracts";@Router({ alias: "agents" })@@ -34,12 +52,19 @@ export class AgentsRouter {private readonly runs: AgentRunsService,) {}- @Query()+ @Query({+ output: agentListOutput,+ meta: restMeta("GET", "/agents", ["Agents"]),+ })async list(@Ctx() ctx: AuthedTrpcContext) {return this.agents.list(ctx.user.id);}- @Mutation({ input: agentReviseInput })+ @Mutation({+ input: agentReviseInput,+ output: agentReviseOutput,+ meta: restMeta("POST", "/agents/{id}/revise", ["Agents"]),+ })async revise(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof agentReviseInput>,@@ -47,12 +72,20 @@ export class AgentsRouter {return this.agents.revise(input, ctx.user.id);}- @Query({ input: agentIdInput })+ @Query({+ input: agentIdInput,+ output: agentFilesOutput,+ meta: restMeta("GET", "/agents/{id}/files", ["Agents"]),+ })async files(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.agents.files(id, ctx.user.id);}- @Mutation({ input: agentSaveFileInput })+ @Mutation({+ input: agentSaveFileInput,+ output: agentSaveFileOutput,+ meta: restMeta("POST", "/agents/{id}/save-file", ["Agents"]),+ })async saveFile(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof agentSaveFileInput>,@@ -60,12 +93,20 @@ export class AgentsRouter {return this.agents.saveFile(input, ctx.user.id);}- @Query({ input: agentIdInput })+ @Query({+ input: agentIdInput,+ output: agentByIdOutput,+ meta: restMeta("GET", "/agents/{id}", ["Agents"]),+ })async byId(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.agents.byId(id, ctx.user.id);}- @Query({ input: agentHistoryInput })+ @Query({+ input: agentHistoryInput,+ output: agentHistoryOutput,+ meta: restMeta("GET", "/agents/{id}/history", ["Agents"]),+ })async history(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof agentHistoryInput>,@@ -73,7 +114,11 @@ export class AgentsRouter {return this.runs.list(input.id, input.limit, ctx.user.id);}- @Query({ input: agentHistoryInput })+ @Query({+ input: agentHistoryInput,+ output: agentActivityOutput,+ meta: restMeta("GET", "/agents/{id}/activity", ["Agents"]),+ })async activity(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof agentHistoryInput>,@@ -81,7 +126,11 @@ export class AgentsRouter {return this.runs.activity(input.id, input.limit, ctx.user.id);}- @Mutation({ input: agentUpdateInput })+ @Mutation({+ input: agentUpdateInput,+ output: agentUpdateOutput,+ meta: restMeta("PATCH", "/agents/{id}", ["Agents"]),+ })async update(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof agentUpdateInput>,@@ -89,7 +138,11 @@ export class AgentsRouter {return this.agents.update(input, ctx.user.id);}- @Mutation({ input: agentDeployInput })+ @Mutation({+ input: agentDeployInput,+ output: agentDeployOutput,+ meta: restMeta("POST", "/agents/{id}/deploy", ["Agents"]),+ })async deploy(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof agentDeployInput>,@@ -97,32 +150,56 @@ export class AgentsRouter {return this.agents.deploy(input, ctx.user.id);}- @Mutation({ input: agentIdInput })+ @Mutation({+ input: agentIdInput,+ output: agentPauseOutput,+ meta: restMeta("POST", "/agents/{id}/pause", ["Agents"]),+ })async pause(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.agents.pause(id, ctx.user.id);}- @Mutation({ input: agentIdInput })+ @Mutation({+ input: agentIdInput,+ output: agentResumeOutput,+ meta: restMeta("POST", "/agents/{id}/resume", ["Agents"]),+ })async resume(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.agents.resume(id, ctx.user.id);}- @Mutation({ input: agentIdInput })+ @Mutation({+ input: agentIdInput,+ output: agentArchiveOutput,+ meta: restMeta("POST", "/agents/{id}/archive", ["Agents"]),+ })async archive(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.agents.archive(id, ctx.user.id);}- @Mutation({ input: agentIdInput })+ @Mutation({+ input: agentIdInput,+ output: agentRestoreOutput,+ meta: restMeta("POST", "/agents/{id}/restore", ["Agents"]),+ })async restore(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.agents.restore(id, ctx.user.id);}- @Mutation({ input: agentIdInput })+ @Mutation({+ input: agentIdInput,+ output: agentRemoveOutput,+ meta: restMeta("DELETE", "/agents/{id}", ["Agents"]),+ })async remove(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.agents.remove(id, ctx.user.id);}- @Mutation({ input: agentRunNowInput })+ @Mutation({+ input: agentRunNowInput,+ output: agentRunNowOutput,+ meta: restMeta("POST", "/agents/{id}/run", ["Agents"]),+ })async runNow(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof agentRunNowInput>,@@ -130,7 +207,11 @@ export class AgentsRouter {return this.runs.runNow(input, ctx.user.id);}- @Mutation({ input: agentRetryRunInput })+ @Mutation({+ input: agentRetryRunInput,+ output: agentRetryRunOutput,+ meta: restMeta("POST", "/agents/{id}/runs/{runId}/retry", ["Agents"]),+ })async retryRun(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof agentRetryRunInput>,@@ -138,7 +219,11 @@ export class AgentsRouter {return this.runs.retryRun(input, ctx.user.id);}- @Mutation({ input: agentCancelRunInput })+ @Mutation({+ input: agentCancelRunInput,+ output: agentCancelRunOutput,+ meta: restMeta("POST", "/agents/{id}/runs/{runId}/cancel", ["Agents"]),+ })async cancelRun(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof agentCancelRunInput>,diff --git a/apps/api/src/api-keys/api-keys.contracts.ts b/apps/api/src/api-keys/api-keys.contracts.tsnew file mode 100644index 00000000..6c6dad49--- /dev/null+++ b/apps/api/src/api-keys/api-keys.contracts.ts@@ -0,0 +1,47 @@+import { API_KEY_EXPIRATION } from "@crm/auth";+import { z } from "zod";+import { listInput } from "../trpc/list-input";++export const apiKeyListInput = listInput;++export const createApiKeyInput = z.object({+ name: z.string().trim().min(1).max(64),+ expiresInDays: z+ .number()+ .int()+ .min(API_KEY_EXPIRATION.minDays)+ .max(API_KEY_EXPIRATION.maxDays)+ .nullable(),+});++export const revokeApiKeyInput = z.object({+ id: z.string().trim().min(1),+});++export const apiKeySummaryOutput = z.object({+ id: z.string(),+ name: z.string().nullable(),+ start: z.string().nullable(),+ enabled: z.boolean(),+ createdAt: z.string(),+ lastRequest: z.string().nullable(),+ expiresAt: z.string().nullable(),+});++export const apiKeyListOutput = z.object({+ rows: z.array(apiKeySummaryOutput),+ total: z.number(),+ facetCounts: z.record(z.string(), z.record(z.string(), z.number())),+});++export const createApiKeyOutput = apiKeySummaryOutput.extend({+ key: z.string(),+});++export const revokeApiKeyOutput = z.object({ id: z.string() });++export type ApiKeyListInput = z.infer<typeof apiKeyListInput>;+export type CreateApiKeyInput = z.infer<typeof createApiKeyInput>;+export type RevokeApiKeyInput = z.infer<typeof revokeApiKeyInput>;+export type ApiKeySummary = z.infer<typeof apiKeySummaryOutput>;+export type CreatedApiKey = z.infer<typeof createApiKeyOutput>;diff --git a/apps/api/src/api-keys/api-keys.module.ts b/apps/api/src/api-keys/api-keys.module.tsnew file mode 100644index 00000000..7110404f--- /dev/null+++ b/apps/api/src/api-keys/api-keys.module.ts@@ -0,0 +1,11 @@+import { Module } from "@nestjs/common";+import { TrpcModule } from "../trpc/trpc.module";+import { ApiKeysRouter } from "./api-keys.router";+import { ApiKeysService } from "./api-keys.service";++@Module({+ imports: [TrpcModule],+ providers: [ApiKeysService, ApiKeysRouter],+ exports: [ApiKeysService],+})+export class ApiKeysModule {}diff --git a/apps/api/src/api-keys/api-keys.router.ts b/apps/api/src/api-keys/api-keys.router.tsnew file mode 100644index 00000000..190ee60b--- /dev/null+++ b/apps/api/src/api-keys/api-keys.router.ts@@ -0,0 +1,72 @@+import { Inject } from "@nestjs/common";+import { fromNodeHeaders } from "better-auth/node";+import {+ Ctx,+ Input,+ Mutation,+ Query,+ Router,+ UseMiddlewares,+} from "nestjs-trpc";+import type { z } from "zod";+import type { AuthedTrpcContext, BaseTrpcContext } from "../trpc/context.types";+import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { SessionOnlyMiddleware } from "../trpc/middlewares/session-only.middleware";+import { restMeta } from "../trpc/openapi";+import {+ apiKeyListInput,+ apiKeyListOutput,+ createApiKeyInput,+ createApiKeyOutput,+ revokeApiKeyInput,+ revokeApiKeyOutput,+} from "./api-keys.contracts";+import { ApiKeysService } from "./api-keys.service";++function headersOf(ctx: BaseTrpcContext): Headers {+ return fromNodeHeaders(ctx.req?.headers ?? {});+}++@Router({ alias: "apiKeys" })+@UseMiddlewares(AuthMiddleware, SessionOnlyMiddleware)+export class ApiKeysRouter {+ constructor(+ @Inject(ApiKeysService) private readonly apiKeys: ApiKeysService,+ ) {}++ @Query({+ input: apiKeyListInput,+ output: apiKeyListOutput,+ meta: restMeta("GET", "/api-keys", ["API Keys"]),+ })+ async list(+ @Ctx() ctx: AuthedTrpcContext,+ @Input() input: z.infer<typeof apiKeyListInput>,+ ) {+ return this.apiKeys.list(ctx.user.id, input);+ }++ @Mutation({+ input: createApiKeyInput,+ output: createApiKeyOutput,+ meta: restMeta("POST", "/api-keys", ["API Keys"]),+ })+ async create(+ @Ctx() ctx: AuthedTrpcContext,+ @Input() input: z.infer<typeof createApiKeyInput>,+ ) {+ return this.apiKeys.create(ctx.user.id, headersOf(ctx), input);+ }++ @Mutation({+ input: revokeApiKeyInput,+ output: revokeApiKeyOutput,+ meta: restMeta("DELETE", "/api-keys/{id}", ["API Keys"]),+ })+ async revoke(+ @Ctx() ctx: AuthedTrpcContext,+ @Input() input: z.infer<typeof revokeApiKeyInput>,+ ) {+ return this.apiKeys.revoke(ctx.user.id, headersOf(ctx), input);+ }+}diff --git a/apps/api/src/api-keys/api-keys.service.ts b/apps/api/src/api-keys/api-keys.service.tsnew file mode 100644index 00000000..6266368d--- /dev/null+++ b/apps/api/src/api-keys/api-keys.service.ts@@ -0,0 +1,181 @@+import { auth, DAY_SECONDS } from "@crm/auth";+import type { Db, Prisma } from "@crm/db";+import {+ HttpException,+ Injectable,+ InternalServerErrorException,+ Logger,+} from "@nestjs/common";+import { APIError } from "better-auth/api";+import { InjectDatabase } from "../database/database.constants";+import {+ type ListResult,+ type OrderByColumns,+ paginate,+ resolveOrderBy,+} from "../trpc/list-input";+import type {+ ApiKeyListInput,+ ApiKeySummary,+ CreateApiKeyInput,+ CreatedApiKey,+ RevokeApiKeyInput,+} from "./api-keys.contracts";++const KEY_SELECT = {+ id: true,+ name: true,+ start: true,+ enabled: true,+ createdAt: true,+ lastRequest: true,+ expiresAt: true,+} satisfies Prisma.ApikeySelect;++type KeyRow = Prisma.ApikeyGetPayload<{ select: typeof KEY_SELECT }>;++const SORTABLE: OrderByColumns<Prisma.ApikeyOrderByWithRelationInput> = {+ name: (dir) => ({ name: dir }),+ createdAt: (dir) => ({ createdAt: dir }),+ lastRequest: (dir) => ({ lastRequest: dir }),+ expiresAt: (dir) => ({ expiresAt: dir }),+};++const STATUS_BY_CODE = new Map<string, number>([+ ["BAD_REQUEST", 400],+ ["UNAUTHORIZED", 401],+ ["FORBIDDEN", 403],+ ["NOT_FOUND", 404],+ ["CONFLICT", 409],+ ["UNPROCESSABLE_ENTITY", 400],+]);++function toSummary(row: KeyRow): ApiKeySummary {+ return {+ id: row.id,+ name: row.name,+ start: row.start,+ enabled: row.enabled ?? true,+ createdAt: row.createdAt.toISOString(),+ lastRequest: row.lastRequest?.toISOString() ?? null,+ expiresAt: row.expiresAt?.toISOString() ?? null,+ };+}++@Injectable()+export class ApiKeysService {+ private readonly logger = new Logger(ApiKeysService.name);++ constructor(@InjectDatabase() private readonly db: Db) {}++ async list(+ userId: string,+ input: ApiKeyListInput,+ ): Promise<ListResult<ApiKeySummary>> {+ const where = this.searchWhere(userId, input.q);+ const { skip, take } = paginate(input);++ const [rows, total] = await Promise.all([+ this.db.apikey.findMany({+ where,+ skip,+ take,+ select: KEY_SELECT,+ orderBy: resolveOrderBy(input, SORTABLE, { createdAt: "desc" }),+ }),+ this.db.apikey.count({ where }),+ ]);++ return { rows: rows.map(toSummary), total, facetCounts: {} };+ }++ async create(+ userId: string,+ headers: Headers,+ input: CreateApiKeyInput,+ ): Promise<CreatedApiKey> {+ const created = await this.call(() =>+ auth.api.createApiKey({+ headers,+ body: {+ name: input.name,+ expiresIn:+ input.expiresInDays === null+ ? null+ : input.expiresInDays * DAY_SECONDS,+ },+ }),+ );++ this.logger.log({+ message: "API key created",+ userId,+ apiKeyId: created.id,+ });++ return {+ id: created.id,+ name: created.name,+ start: created.start,+ enabled: created.enabled,+ createdAt: created.createdAt.toISOString(),+ lastRequest: created.lastRequest?.toISOString() ?? null,+ expiresAt: created.expiresAt?.toISOString() ?? null,+ key: created.key,+ };+ }++ async revoke(+ userId: string,+ headers: Headers,+ input: RevokeApiKeyInput,+ ): Promise<{ id: string }> {+ await this.call(() =>+ auth.api.deleteApiKey({ headers, body: { keyId: input.id } }),+ );++ this.logger.log({+ message: "API key revoked",+ userId,+ apiKeyId: input.id,+ });++ return { id: input.id };+ }++ private searchWhere(userId: string, q: string): Prisma.ApikeyWhereInput {+ const where: Prisma.ApikeyWhereInput = { referenceId: userId };+ const term = q.trim();++ if (term) {+ where.name = { contains: term, mode: "insensitive" };+ }++ return where;+ }++ private async call<T>(run: () => Promise<T>): Promise<T> {+ try {+ return await run();+ } catch (error) {+ if (error instanceof APIError) {+ const status =+ STATUS_BY_CODE.get(error.body?.code ?? "") ?? error.statusCode;++ throw new HttpException(+ error.body?.message ?? "The API key could not be saved.",+ status,+ );+ }++ this.logger.error(+ { message: "API key call failed" },+ error instanceof Error ? error.stack : String(error),+ );++ throw new InternalServerErrorException(+ "Could not reach the auth service.",+ );+ }+ }+}diff --git a/apps/api/src/app.module.ts b/apps/api/src/app.module.tsindex 74acf8de..82a345df 100644--- a/apps/api/src/app.module.ts+++ b/apps/api/src/app.module.ts@@ -4,6 +4,8 @@ import { ConfigModule } from "@nestjs/config";import { AuthModule as BetterAuthModule } from "@thallesp/nestjs-better-auth";import { ActivitiesModule } from "./activities/activities.module";import { AgentModule } from "./agent/agent.module";+import { ApiKeysModule } from "./api-keys/api-keys.module";+import { ArchiveModule } from "./archive/archive.module";import { AuthModule } from "./auth/auth.module";import { BackfillModule } from "./backfill/backfill.module";import { AppCacheModule } from "./cache/cache.module";@@ -24,6 +26,7 @@ import { LoggingModule } from "./logging/logging.module";import { logAuthRoute } from "./logging/request-logger.middleware";import { MailboxModule } from "./mailbox/mailbox.module";import { MicrosoftModule } from "./microsoft/microsoft.module";+import { SavedViewsModule } from "./saved-views/saved-views.module";import { SearchModule } from "./search/search.module";import { SettingsModule } from "./settings/settings.module";import { SlackModule } from "./slack/slack.module";@@ -51,6 +54,7 @@ import { WorkspaceModule } from "./workspace/workspace.module";HealthModule,TrpcModule,UsersModule,+ ApiKeysModule,CompaniesModule,ContactsModule,ConversationsModule,@@ -73,6 +77,8 @@ import { WorkspaceModule } from "./workspace/workspace.module";BackfillModule,TelemetryModule,TrackingModule,+ ArchiveModule,+ SavedViewsModule,],})export class AppModule {}diff --git a/apps/api/src/archive/archive-config.ts b/apps/api/src/archive/archive-config.tsnew file mode 100644index 00000000..41829546--- /dev/null+++ b/apps/api/src/archive/archive-config.ts@@ -0,0 +1,5 @@+export const ARCHIVE = {+ prune: {+ maxBatch: 500,+ },+} as const;diff --git a/apps/api/src/archive/archive-retention.controller.ts b/apps/api/src/archive/archive-retention.controller.tsnew file mode 100644index 00000000..5050b43d--- /dev/null+++ b/apps/api/src/archive/archive-retention.controller.ts@@ -0,0 +1,116 @@+import type { Db } from "@crm/db";+import { readArchiveRetentionDays } from "@crm/db/settings";+import {+ Controller,+ ForbiddenException,+ Get,+ Headers,+ Logger,+ Post,+ ServiceUnavailableException,+} from "@nestjs/common";+import { ConfigService } from "@nestjs/config";+import {+ ApiExcludeEndpoint,+ ApiForbiddenResponse,+ ApiHeader,+ ApiOkResponse,+ ApiOperation,+ ApiServiceUnavailableResponse,+ ApiTags,+} from "@nestjs/swagger";+import { AllowAnonymous } from "@thallesp/nestjs-better-auth";+import { CompaniesService } from "../companies/companies.service";+import type { EnvironmentVariables } from "../config/env.validation";+import { ContactsService } from "../contacts/contacts.service";+import { InjectDatabase } from "../database/database.constants";+import { DealsService } from "../deals/deals.service";++const DAY_MS = 24 * 60 * 60_000;++@ApiTags("Internal — Cron")+@ApiHeader({+ name: "authorization",+ description: "`Bearer <CRON_SECRET>`",+ required: true,+})+@ApiForbiddenResponse({ description: "CRON_SECRET did not match." })+@ApiServiceUnavailableResponse({ description: "CRON_SECRET is not set." })+@Controller("internal/archive")+export class ArchiveRetentionController {+ private readonly logger = new Logger(ArchiveRetentionController.name);+ private readonly secret: string | undefined;++ constructor(+ @InjectDatabase() private readonly db: Db,+ private readonly companies: CompaniesService,+ private readonly contacts: ContactsService,+ private readonly deals: DealsService,+ config: ConfigService<EnvironmentVariables, true>,+ ) {+ this.secret = config.get("CRON_SECRET", { infer: true });+ }++ @Get("prune")+ @AllowAnonymous()+ @ApiOperation({+ summary: "Purge companies, contacts and deals past the archive window",+ })+ @ApiOkResponse({ description: "The prune ran; per-record-type counts." })+ async pruneViaGet(@Headers("authorization") authorization?: string) {+ return this.run(authorization);+ }++ @Post("prune")+ @AllowAnonymous()+ @ApiExcludeEndpoint()+ async pruneViaPost(@Headers("authorization") authorization?: string) {+ return this.run(authorization);+ }++ private async run(authorization?: string) {+ if (!this.secret) {+ this.logger.error({+ message: "CRON_SECRET is not set — refusing to run archive pruning.",+ });+ throw new ServiceUnavailableException("Pruning is not configured.");+ }++ if (!timingSafeEquals(authorization ?? "", `Bearer ${this.secret}`)) {+ throw new ForbiddenException();+ }++ const retentionDays = await readArchiveRetentionDays(this.db);+ const before = new Date(Date.now() - retentionDays * DAY_MS);++ const [companies, contacts, deals] = await Promise.all([+ this.companies.purgeExpired(before),+ this.contacts.purgeExpired(before),+ this.deals.purgeExpired(before),+ ]);++ this.logger.log({+ message: "Archive retention swept",+ retentionDays,+ companies: companies.succeeded,+ companiesSkipped: companies.skipped,+ contacts: contacts.succeeded,+ contactsSkipped: contacts.skipped,+ deals: deals.succeeded,+ dealsSkipped: deals.skipped,+ });++ return { retentionDays, companies, contacts, deals };+ }+}++function timingSafeEquals(a: string, b: string): boolean {+ if (a.length !== b.length) return false;++ let mismatch = 0;+ for (let index = 0; index < a.length; index += 1) {+ mismatch |= a.charCodeAt(index) ^ b.charCodeAt(index);+ }++ return mismatch === 0;+}diff --git a/apps/api/src/archive/archive.module.ts b/apps/api/src/archive/archive.module.tsnew file mode 100644index 00000000..4e8feb6a--- /dev/null+++ b/apps/api/src/archive/archive.module.ts@@ -0,0 +1,11 @@+import { Module } from "@nestjs/common";+import { CompaniesModule } from "../companies/companies.module";+import { ContactsModule } from "../contacts/contacts.module";+import { DealsModule } from "../deals/deals.module";+import { ArchiveRetentionController } from "./archive-retention.controller";++@Module({+ imports: [CompaniesModule, ContactsModule, DealsModule],+ controllers: [ArchiveRetentionController],+})+export class ArchiveModule {}diff --git a/apps/api/src/auth/auth.controller.ts b/apps/api/src/auth/auth.controller.tsindex 3bc5f516..dc283ca7 100644--- a/apps/api/src/auth/auth.controller.ts+++ b/apps/api/src/auth/auth.controller.ts@@ -1,5 +1,12 @@-import type { auth } from "@crm/auth";+import { type auth, SESSION_COOKIE_NAME } from "@crm/auth";import { Controller, Get } from "@nestjs/common";+import {+ ApiCookieAuth,+ ApiOkResponse,+ ApiOperation,+ ApiTags,+ ApiUnauthorizedResponse,+} from "@nestjs/swagger";import {OptionalAuth,Session,@@ -9,17 +16,28 @@ import { AuthService } from "./auth.service";type CrmSession = UserSession<typeof auth>;+@ApiTags("Auth")+@ApiCookieAuth(SESSION_COOKIE_NAME)@Controller("auth")export class AuthController {constructor(private readonly authService: AuthService) {}@Get("me")+ @ApiOperation({ summary: "Get the signed-in user's profile" })+ @ApiOkResponse({ description: "The signed-in user's profile." })+ @ApiUnauthorizedResponse({ description: "No valid session." })async getMe(@Session() session: CrmSession) {return { user: await this.authService.getProfile(session.user.id) };}@Get("session")@OptionalAuth()+ @ApiOperation({+ summary: "Check whether the current request carries a valid session",+ })+ @ApiOkResponse({+ description: "Whether the request is authenticated, and as whom.",+ })getSession(@Session() session?: CrmSession) {if (!session) {return { authenticated: false, user: null };diff --git a/apps/api/src/companies/companies.contracts.ts b/apps/api/src/companies/companies.contracts.tsindex bbd3b67b..d90faf42 100644--- a/apps/api/src/companies/companies.contracts.ts+++ b/apps/api/src/companies/companies.contracts.ts@@ -1,13 +1,18 @@+import { DealStage, EnrichmentStatus, RecordSource } from "@crm/db";+import { FIELD_TYPES } from "@crm/db/fields";import { z } from "zod";import { bulkIdsInput } from "../crm/bulk";-import { recordFieldValues } from "../fields/fields.contracts";-import { listInput } from "../trpc/list-input";+import { fieldEntity, recordFieldValues } from "../fields/fields.contracts";+import { activityFacetInput, listInput } from "../trpc/list-input";export const companyListInput = listInput.extend({- owner: z.string().default("all"),- industry: z.string().default("all"),- enrichment: z.string().default("all"),- source: z.string().default("all"),+ owner: z.array(z.string()).default([]),+ industry: z.array(z.string()).default([]),+ enrichment: z.array(z.string()).default([]),+ source: z.array(z.string()).default([]),+ activity: activityFacetInput.default([]),+ fields: z.record(z.string(), z.array(z.string())).default({}),+ archived: z.boolean().default(false),});export type CompanyListInput = z.infer<typeof companyListInput>;@@ -61,3 +66,192 @@ export const companyBulkOwnerInput = bulkIdsInput.extend({});export type CompanyBulkOwnerInput = z.infer<typeof companyBulkOwnerInput>;++const companyEnrichmentStatus = z.enum(+ Object.values(EnrichmentStatus) as [EnrichmentStatus, ...EnrichmentStatus[]],+);++const companyRecordSource = z.enum(+ Object.values(RecordSource) as [RecordSource, ...RecordSource[]],+);++const companyDealStage = z.enum(+ Object.values(DealStage) as [DealStage, ...DealStage[]],+);++const companyFieldType = z.enum(FIELD_TYPES);++const ownerSummaryOutput = z.object({+ id: z.string(),+ name: z.string(),+ email: z.string(),+ image: z.string().nullable(),+});++const companyFieldOptionOutput = z.object({+ id: z.string(),+ label: z.string(),+ position: z.number(),+});++const companyRecordFieldOutput = z.object({+ id: z.string(),+ entity: fieldEntity,+ key: z.string(),+ label: z.string(),+ type: companyFieldType,+ typeLabel: z.string(),+ agentFilled: z.boolean(),+ agentBrief: z.string().nullable(),+ required: z.boolean(),+ showOnSheet: z.boolean(),+ showOnTable: z.boolean(),+ showOnFilter: z.boolean(),+ position: z.number(),+ archived: z.boolean(),+ options: z.array(companyFieldOptionOutput),+ value: z.union([z.string(), z.number(), z.boolean(), z.null()]),+});++export const companyRowOutput = z.object({+ id: z.string(),+ name: z.string(),+ domain: z.string().nullable(),+ iconUrl: z.string().nullable(),+ iconDarkUrl: z.string().nullable(),+ iconTone: z.string().nullable(),+ logoUrl: z.string().nullable(),+ brandColor: z.string().nullable(),+ industry: z.string().nullable(),+ enrichmentStatus: companyEnrichmentStatus,+ queued: z.boolean(),+ source: companyRecordSource,+ owner: ownerSummaryOutput.nullable(),+ contactCount: z.number(),+ openDealCount: z.number(),+ lastActivityAt: z.string().nullable(),+ createdAt: z.string(),+ archivedAt: z.string().nullable(),+ fields: recordFieldValues,+});++export type CompanyRow = z.infer<typeof companyRowOutput>;++export const companyListOutput = z.object({+ rows: z.array(companyRowOutput),+ total: z.number(),+ facetCounts: z.record(z.string(), z.record(z.string(), z.number())),+});++const companyDetailContactOutput = z.object({+ id: z.string(),+ firstName: z.string(),+ lastName: z.string().nullable(),+ email: z.string().nullable(),+ title: z.string().nullable(),+ imageUrl: z.string().nullable(),+ owner: ownerSummaryOutput.nullable(),+});++const companyDetailDealOutput = z.object({+ id: z.string(),+ name: z.string(),+ stage: companyDealStage,+ currency: z.string(),+ expectedCloseDate: z.string().nullable(),+ owner: ownerSummaryOutput.nullable(),+ amountCents: z.number().nullable(),+ baseAmountCents: z.number().nullable(),+});++const companyDetailPrimaryContactOutput = z.object({+ id: z.string(),+ firstName: z.string(),+ lastName: z.string().nullable(),+ email: z.string().nullable(),+ phone: z.string().nullable(),+ title: z.string().nullable(),+});++export const companyDetailOutput = z.object({+ id: z.string(),+ name: z.string(),+ domain: z.string().nullable(),+ website: z.string().nullable(),+ description: z.string().nullable(),+ logoUrl: z.string().nullable(),+ logoDarkUrl: z.string().nullable(),+ iconUrl: z.string().nullable(),+ iconDarkUrl: z.string().nullable(),+ iconTone: z.string().nullable(),+ brandColor: z.string().nullable(),+ industry: z.string().nullable(),+ subIndustry: z.string().nullable(),+ city: z.string().nullable(),+ stateCode: z.string().nullable(),+ country: z.string().nullable(),+ countryCode: z.string().nullable(),+ phone: z.string().nullable(),+ email: z.string().nullable(),+ linkedinUrl: z.string().nullable(),+ twitterUrl: z.string().nullable(),+ githubUrl: z.string().nullable(),+ pricingUrl: z.string().nullable(),+ careersUrl: z.string().nullable(),+ enrichmentStatus: companyEnrichmentStatus,+ enrichmentError: z.string().nullable(),+ source: companyRecordSource,+ owner: ownerSummaryOutput.nullable(),+ contacts: z.array(companyDetailContactOutput),+ fields: z.array(companyRecordFieldOutput),+ queued: z.boolean(),+ createdAt: z.string(),+ archivedAt: z.string().nullable(),+ enrichedAt: z.string().nullable(),+ primaryContactId: z.string().nullable(),+ primaryContact: companyDetailPrimaryContactOutput.nullable(),+ reportingCurrency: z.string(),+ deals: z.array(companyDetailDealOutput),+});++export const companyOptionOutput = z.array(+ z.object({+ id: z.string(),+ name: z.string(),+ domain: z.string().nullable(),+ iconUrl: z.string().nullable(),+ }),+);++export const companySummaryOutput = z.object({+ id: z.string(),+ name: z.string(),+ domain: z.string().nullable(),+});++export const companyArchiveResultOutput = z.object({+ id: z.string(),+ name: z.string(),+});++export const companyBulkResultOutput = z.object({+ requested: z.number(),+ succeeded: z.number(),+ failed: z.number(),+ message: z.string().nullable(),+});++export const companyEnrichOutput = z.object({+ id: z.string(),+ queued: z.boolean(),+});++export const companyResearchOutput = z.object({+ ok: z.literal(true),+ queued: z.literal(true),+});++export const companySetPrimaryContactOutput = z.object({+ id: z.string(),+ primaryContactId: z.string().nullable(),+});diff --git a/apps/api/src/companies/companies.router.ts b/apps/api/src/companies/companies.router.tsindex 42f0c68f..ac11ccd3 100644--- a/apps/api/src/companies/companies.router.ts+++ b/apps/api/src/companies/companies.router.ts@@ -10,13 +10,23 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import {+ companyArchiveResultOutput,companyBulkInput,companyBulkOwnerInput,+ companyBulkResultOutput,companyCreateInput,+ companyDetailOutput,+ companyEnrichOutput,companyIdInput,companyListInput,+ companyListOutput,+ companyOptionOutput,companyOptionsInput,+ companyResearchOutput,+ companySetPrimaryContactOutput,+ companySummaryOutput,companyUpdateArgs,setPrimaryContactInput,} from "./companies.contracts";@@ -29,62 +39,148 @@ export class CompaniesRouter {@Inject(CompaniesService) private readonly companies: CompaniesService,) {}- @Query({ input: companyListInput })+ @Query({+ input: companyListInput,+ output: companyListOutput,+ meta: restMeta("POST", "/companies/search", ["Companies"]),+ })async list(@Input() input: z.infer<typeof companyListInput>) {return this.companies.list(input);}- @Query({ input: companyIdInput })+ @Query({+ input: companyIdInput,+ output: companyDetailOutput,+ meta: restMeta("GET", "/companies/{id}", ["Companies"]),+ })async byId(@Input("id") id: string) {return this.companies.byId(id);}- @Query({ input: companyOptionsInput })+ @Query({+ input: companyOptionsInput,+ output: companyOptionOutput,+ meta: restMeta("GET", "/companies/options", ["Companies"]),+ })async options(@Input("q") q: string) {return this.companies.options(q);}- @Mutation({ input: companyCreateInput })+ @Mutation({+ input: companyCreateInput,+ output: companySummaryOutput,+ meta: restMeta("POST", "/companies", ["Companies"]),+ })async create(@Input() input: z.infer<typeof companyCreateInput>) {return this.companies.create(input);}- @Mutation({ input: companyUpdateArgs })+ @Mutation({+ input: companyUpdateArgs,+ output: companySummaryOutput,+ meta: restMeta("PATCH", "/companies/{id}", ["Companies"]),+ })async update(@Input() input: z.infer<typeof companyUpdateArgs>) {return this.companies.update(input.id, input.data);}- @Mutation({ input: companyIdInput })- async delete(@Input("id") id: string) {- return this.companies.delete(id);+ @Mutation({+ input: companyIdInput,+ output: companyArchiveResultOutput,+ meta: restMeta("POST", "/companies/{id}/archive", ["Companies"]),+ })+ async archive(@Input("id") id: string) {+ return this.companies.archive(id);}- @Mutation({ input: companyBulkOwnerInput })+ @Mutation({+ input: companyIdInput,+ output: companyArchiveResultOutput,+ meta: restMeta("POST", "/companies/{id}/restore", ["Companies"]),+ })+ async restore(@Input("id") id: string) {+ return this.companies.restore(id);+ }++ @Mutation({+ input: companyIdInput,+ output: companyArchiveResultOutput,+ meta: restMeta("DELETE", "/companies/{id}", ["Companies"]),+ })+ async purge(@Input("id") id: string) {+ return this.companies.purge(id);+ }++ @Mutation({+ input: companyBulkOwnerInput,+ output: companyBulkResultOutput,+ meta: restMeta("POST", "/companies/bulk-assign-owner", ["Companies"]),+ })async bulkAssignOwner(@Input() input: z.infer<typeof companyBulkOwnerInput>) {return this.companies.bulkAssignOwner(input);}- @Mutation({ input: companyBulkInput })+ @Mutation({+ input: companyBulkInput,+ output: companyBulkResultOutput,+ meta: restMeta("POST", "/companies/bulk-enrich", ["Companies"]),+ })async bulkEnrich(@Input("ids") ids: string[]) {return this.companies.bulkEnrich(ids);}- @Mutation({ input: companyBulkInput })- async bulkDelete(@Input("ids") ids: string[]) {- return this.companies.bulkDelete(ids);+ @Mutation({+ input: companyBulkInput,+ output: companyBulkResultOutput,+ meta: restMeta("POST", "/companies/bulk-archive", ["Companies"]),+ })+ async bulkArchive(@Input("ids") ids: string[]) {+ return this.companies.bulkArchive(ids);+ }++ @Mutation({+ input: companyBulkInput,+ output: companyBulkResultOutput,+ meta: restMeta("POST", "/companies/bulk-restore", ["Companies"]),+ })+ async bulkRestore(@Input("ids") ids: string[]) {+ return this.companies.bulkRestore(ids);+ }++ @Mutation({+ input: companyBulkInput,+ output: companyBulkResultOutput,+ meta: restMeta("POST", "/companies/bulk-purge", ["Companies"]),+ })+ async bulkPurge(@Input("ids") ids: string[]) {+ return this.companies.bulkPurge(ids);}- @Mutation({ input: companyIdInput })+ @Mutation({+ input: companyIdInput,+ output: companyEnrichOutput,+ meta: restMeta("POST", "/companies/{id}/enrich", ["Companies"]),+ })async enrich(@Input("id") id: string) {return this.companies.enrich(id);}- @Mutation({ input: companyIdInput })+ @Mutation({+ input: companyIdInput,+ output: companyResearchOutput,+ meta: restMeta("POST", "/companies/{id}/research", ["Companies"]),+ })async research(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.companies.research(id, ctx.user.id);}- @Mutation({ input: setPrimaryContactInput })+ @Mutation({+ input: setPrimaryContactInput,+ output: companySetPrimaryContactOutput,+ meta: restMeta("POST", "/companies/{companyId}/set-primary-contact", [+ "Companies",+ ]),+ })async setPrimaryContact(@Input() input: z.infer<typeof setPrimaryContactInput>,) {diff --git a/apps/api/src/companies/companies.service.ts b/apps/api/src/companies/companies.service.tsindex cc70757f..e9ec9d89 100644--- a/apps/api/src/companies/companies.service.ts+++ b/apps/api/src/companies/companies.service.ts@@ -6,6 +6,7 @@ import {type RecordSource,} from "@crm/db";import { OPEN_DEAL_STAGES } from "@crm/db/deal-stage";+import type { FieldDefinitionWithOptions } from "@crm/db/fields";import {BadRequestException,ConflictException,@@ -15,6 +16,7 @@ import {} from "@nestjs/common";import { AgentQueueService } from "../agent/agent-queue.service";import { AgentTriggerService } from "../agent/agent-trigger.service";+import { ARCHIVE } from "../archive/archive-config";import {ActivityStampService,type StampTargets,@@ -25,8 +27,10 @@ import { ConversionService } from "../currency/conversion.service";import { InjectDatabase } from "../database/database.constants";import { FieldsService } from "../fields/fields.service";import {+ activityFacetCounts,+ activityFilter,+ archivedFilter,countsByKey,- FACET_ALL,FACET_UNASSIGNED,type ListResult,type OrderByColumns,@@ -38,6 +42,7 @@ import type {CompanyBulkOwnerInput,CompanyCreateInput,CompanyListInput,+ CompanyRow,CompanyUpdateInput,} from "./companies.contracts";import { normalizeDomain } from "./domain";@@ -50,32 +55,6 @@ const OWNER_SELECT = {image: true,} as const;-export type CompanyRow = {- id: string;- name: string;- domain: string | null;- iconUrl: string | null;- iconDarkUrl: string | null;- iconTone: string | null;- logoUrl: string | null;- brandColor: string | null;- industry: string | null;- enrichmentStatus: EnrichmentStatus;- queued: boolean;- source: RecordSource;- owner: {- id: string;- name: string;- email: string;- image: string | null;- } | null;- contactCount: number;- openDealCount: number;- lastActivityAt: string | null;- createdAt: string;- fields: Record<string, string | number | boolean | null>;-};-const SORTABLE: OrderByColumns<Prisma.CompanyOrderByWithRelationInput> = {name: (dir) => ({ name: dir }),domain: (dir) => ({ domain: dir }),@@ -85,6 +64,7 @@ const SORTABLE: OrderByColumns<Prisma.CompanyOrderByWithRelationInput> = {deals: (dir) => ({ deals: { _count: dir } }),owner: (dir) => ({ owner: { name: dir } }),lastActivity: (dir) => ({ lastActivityAt: { sort: dir, nulls: "last" } }),+ archivedAt: (dir) => ({ archivedAt: { sort: dir, nulls: "last" } }),};@Injectable()@@ -102,7 +82,8 @@ export class CompaniesService {) {}async list(input: CompanyListInput): Promise<ListResult<CompanyRow>> {- const where = this.buildWhere(input);+ const filterableFields = await this.fields.filterableFieldsFor("COMPANY");+ const where = this.buildWhere(input, filterableFields);const { skip, take } = paginate(input);const [rows, total, facetCounts] = await Promise.all([@@ -134,10 +115,11 @@ export class CompaniesService {},lastActivityAt: true,createdAt: true,+ archivedAt: true,},}),this.db.company.count({ where }),- this.facetCounts(input),+ this.facetCounts(input, filterableFields),]);const ids = rows.map((row) => row.id);@@ -165,6 +147,7 @@ export class CompaniesService {openDealCount: row._count.deals,lastActivityAt: row.lastActivityAt?.toISOString() ?? null,createdAt: row.createdAt.toISOString(),+ archivedAt: row.archivedAt?.toISOString() ?? null,fields: tableFields.get(row.id) ?? {},})),total,@@ -205,6 +188,7 @@ export class CompaniesService {enrichmentError: true,source: true,createdAt: true,+ archivedAt: true,owner: { select: OWNER_SELECT },primaryContact: {select: {@@ -248,13 +232,21 @@ export class CompaniesService {throw new NotFoundException(`No company with id ${id}.`);}- const { deals, primaryContact, enrichedAt, createdAt, ...rest } = company;+ const {+ deals,+ primaryContact,+ enrichedAt,+ createdAt,+ archivedAt,+ ...rest+ } = company;return {...rest,fields: await this.fields.valuesFor("COMPANY", id),queued: await this.queue.isQueued({ companyId: id }),createdAt: createdAt.toISOString(),+ archivedAt: archivedAt?.toISOString() ?? null,enrichedAt: enrichedAt?.toISOString() ?? null,primaryContactId: primaryContact?.id ?? null,primaryContact,@@ -283,8 +275,8 @@ export class CompaniesService {const domain = normalizeDomain(input.domain);if (domain) {- const existing = await this.db.company.findUnique({- where: { domain },+ const existing = await this.db.company.findFirst({+ where: { domain, archivedAt: null },select: { id: true, name: true },});if (existing) {@@ -322,6 +314,7 @@ export class CompaniesService {await this.agent.companyCreated(company.id);void this.favicon.backfill(company.id, company.domain);+ void this.fields.queueBackfillForNewRecord("COMPANY", company.id);return { id: company.id, name: company.name, domain: company.domain };}@@ -400,17 +393,84 @@ export class CompaniesService {}}- async delete(id: string): Promise<{ id: string; name: string }> {- let deleted: { targets: StampTargets; name: string };+ async archive(id: string): Promise<{ id: string; name: string }> {+ try {+ const company = await this.db.company.update({+ where: { id },+ data: { archivedAt: new Date() },+ select: { name: true },+ });++ this.logger.log({ message: "Company archived", companyId: id });++ return { id, name: company.name };+ } catch (error) {+ throw this.translate(error, id);+ }+ }++ async restore(id: string): Promise<{ id: string; name: string }> {+ try {+ const company = await this.db.company.update({+ where: { id },+ data: { archivedAt: null },+ select: { name: true },+ });++ this.logger.log({ message: "Company restored", companyId: id });++ return { id, name: company.name };+ } catch (error) {+ throw this.translate(error, id);+ }+ }++ async purge(id: string): Promise<{ id: string; name: string }>;+ async purge(+ id: string,+ guard: { archivedBefore: Date },+ ): Promise<{ id: string; name: string } | null>;+ async purge(+ id: string,+ guard?: { archivedBefore: Date },+ ): Promise<{ id: string; name: string } | null> {+ let deleted: { targets: StampTargets; name: string } | null;try {deleted = await this.db.$transaction(async (tx) => {+ const [row] = await tx.$queryRaw<Array<{ archivedAt: Date | null }>>`+ SELECT "archivedAt" FROM company WHERE id = ${id} FOR UPDATE+ `;++ if (!row) {+ if (guard) return null;+ throw new NotFoundException(`No company with id ${id}.`);+ }+ if (+ guard &&+ (!row.archivedAt || row.archivedAt > guard.archivedBefore)+ ) {+ return null;+ }+const targets = await this.stamp.targetsOf({ OR: [{ companyId: id }, { deal: { companyId: id } }] },tx,);- await tx.agentTask.deleteMany({ where: { companyId: id } });+ const deals = await tx.deal.findMany({+ where: { companyId: id },+ select: { id: true },+ });++ await tx.agentTask.deleteMany({+ where: {+ OR: [+ { companyId: id },+ { dealId: { in: deals.map((deal) => deal.id) } },+ ],+ },+ });const company = await tx.company.delete({where: { id },@@ -423,10 +483,12 @@ export class CompaniesService {throw this.translate(error, id);}+ if (!deleted) return null;+await this.stamp.recomputeAfterDelete(deleted.targets, { companyId: id });this.logger.log({- message: "Company deleted",+ message: "Company purged",companyId: id,name: deleted.name,});@@ -434,6 +496,19 @@ export class CompaniesService {return { id, name: deleted.name };}+ async purgeExpired(before: Date): Promise<BulkResult> {+ const expired = await this.db.company.findMany({+ where: { archivedAt: { lte: before } },+ select: { id: true },+ take: ARCHIVE.prune.maxBatch,+ });++ return runBulk(+ expired.map((row) => row.id),+ (id) => this.purge(id, { archivedBefore: before }),+ );+ }+async bulkAssignOwner(input: CompanyBulkOwnerInput): Promise<BulkResult> {const ownerId = input.ownerId || null;@@ -454,6 +529,7 @@ export class CompaniesService {return {requested: ids.length,succeeded: count,+ skipped: 0,failed: ids.length - count,message: null,};@@ -463,8 +539,16 @@ export class CompaniesService {return runBulk(ids, (id) => this.enrich(id));}- async bulkDelete(ids: string[]): Promise<BulkResult> {- return runBulk(ids, (id) => this.delete(id));+ async bulkArchive(ids: string[]): Promise<BulkResult> {+ return runBulk(ids, (id) => this.archive(id));+ }++ async bulkRestore(ids: string[]): Promise<BulkResult> {+ return runBulk(ids, (id) => this.restore(id));+ }++ async bulkPurge(ids: string[]): Promise<BulkResult> {+ return runBulk(ids, (id) => this.purge(id));}async enrich(id: string): Promise<{ id: string; queued: boolean }> {@@ -549,58 +633,84 @@ export class CompaniesService {};}- private buildWhere(input: CompanyListInput): Prisma.CompanyWhereInput {- const where: Prisma.CompanyWhereInput = {- ...this.searchFilter(input.q),- ...ownerFilter(input.owner),- };-- if (input.industry !== FACET_ALL) {- where.industry = input.industry;+ private buildWhere(+ input: CompanyListInput,+ filterableFields: FieldDefinitionWithOptions[],+ ): Prisma.CompanyWhereInput {+ const and: Prisma.CompanyWhereInput[] = [+ this.searchFilter(input.q),+ archivedFilter(input.archived),+ ...this.fields.fieldFilters(filterableFields, input.fields),+ ];++ const owner = ownerFilter<Prisma.CompanyWhereInput>(input.owner);+ if (owner) and.push(owner);++ if (input.industry.length > 0)+ and.push({ industry: { in: input.industry } });+ if (input.enrichment.length > 0) {+ and.push({+ enrichmentStatus: { in: input.enrichment as EnrichmentStatus[] },+ });}-- if (input.enrichment !== FACET_ALL) {- where.enrichmentStatus = input.enrichment as EnrichmentStatus;+ if (input.source.length > 0) {+ and.push({ source: { in: input.source as RecordSource[] } });}- if (input.source !== FACET_ALL) {- where.source = input.source as RecordSource;- }+ const activity = activityFilter(input.activity);+ if (activity) and.push(activity);- return where;+ return { AND: and };}- private async facetCounts(input: CompanyListInput) {- const where = this.searchFilter(input.q);+ private async facetCounts(+ input: CompanyListInput,+ filterableFields: FieldDefinitionWithOptions[],+ ) {+ const where = {+ AND: [this.searchFilter(input.q), archivedFilter(input.archived)],+ };- const [owners, industries, enrichment, sources] = await Promise.all([- this.db.company.groupBy({- by: ["ownerId"],- where,- _count: { _all: true },- }),- this.db.company.groupBy({- by: ["industry"],- where,- _count: { _all: true },- }),- this.db.company.groupBy({- by: ["enrichmentStatus"],- where,- _count: { _all: true },- }),- this.db.company.groupBy({- by: ["source"],- where,- _count: { _all: true },- }),- ]);+ const [owners, industries, enrichment, sources, activity, fieldFacets] =+ await Promise.all([+ this.db.company.groupBy({+ by: ["ownerId"],+ where,+ _count: { _all: true },+ }),+ this.db.company.groupBy({+ by: ["industry"],+ where,+ _count: { _all: true },+ }),+ this.db.company.groupBy({+ by: ["enrichmentStatus"],+ where,+ _count: { _all: true },+ }),+ this.db.company.groupBy({+ by: ["source"],+ where,+ _count: { _all: true },+ }),+ activityFacetCounts((activityWhere) =>+ this.db.company.count({ where: { AND: [where, activityWhere] } }),+ ),+ this.fields.filterFacetCounts("COMPANY", where, filterableFields),+ ]);return {owner: countsByKey(owners, "ownerId", FACET_UNASSIGNED),industry: countsByKey(industries, "industry"),enrichment: countsByKey(enrichment, "enrichmentStatus"),source: countsByKey(sources, "source"),+ activity,+ ...Object.fromEntries(+ Object.entries(fieldFacets).map(([key, counts]) => [+ `field:${key}`,+ counts,+ ]),+ ),};}diff --git a/apps/api/src/companies/company-directory.service.ts b/apps/api/src/companies/company-directory.service.tsindex abb3e97e..b60f09f1 100644--- a/apps/api/src/companies/company-directory.service.ts+++ b/apps/api/src/companies/company-directory.service.ts@@ -19,8 +19,8 @@ export class CompanyDirectoryService {const outcome = await this.agent.withCrmEvents(async (tx, emit) => {await lockIdempotencyKey(tx, `company-directory:${domain}`);- const existing = await tx.company.findUnique({- where: { domain },+ const existing = await tx.company.findFirst({+ where: { domain, archivedAt: null },select: { id: true },});if (existing) return { id: existing.id, created: false as const };diff --git a/apps/api/src/contacts/contacts.contracts.ts b/apps/api/src/contacts/contacts.contracts.tsindex 295dce93..c0d81ff8 100644--- a/apps/api/src/contacts/contacts.contracts.ts+++ b/apps/api/src/contacts/contacts.contracts.ts@@ -1,12 +1,26 @@+import {+ DealStage,+ EnrichmentStatus,+ FactBand,+ FactStatus,+ RecordSource,+} from "@crm/db";+import { FIELD_ENTITIES, FIELD_TYPES } from "@crm/db/fields";import { z } from "zod";import { bulkIdsInput } from "../crm/bulk";import { recordFieldValues } from "../fields/fields.contracts";-import { listInput } from "../trpc/list-input";+import { activityFacetInput, listInput } from "../trpc/list-input";export const contactListInput = listInput.extend({- owner: z.string().default("all"),- company: z.string().default("all"),- source: z.string().default("all"),+ owner: z.array(z.string()).default([]),+ company: z.array(z.string()).default([]),+ source: z.array(z.string()).default([]),+ title: z.array(z.string()).default([]),+ seniority: z.array(z.string()).default([]),+ persona: z.array(z.string()).default([]),+ activity: activityFacetInput.default([]),+ fields: z.record(z.string(), z.array(z.string())).default({}),+ archived: z.boolean().default(false),});export type ContactListInput = z.infer<typeof contactListInput>;@@ -66,3 +80,210 @@ export const factDecisionInput = z.object({});export type FactDecisionInput = z.infer<typeof factDecisionInput>;++const fieldValueOutput = z.union([+ z.string(),+ z.number(),+ z.boolean(),+ z.null(),+]);++const fieldOptionOutput = z.object({+ id: z.string(),+ label: z.string(),+ position: z.number(),+});++const recordFieldOutput = z.object({+ id: z.string(),+ entity: z.enum(FIELD_ENTITIES),+ key: z.string(),+ label: z.string(),+ type: z.enum(FIELD_TYPES),+ typeLabel: z.string(),+ agentFilled: z.boolean(),+ agentBrief: z.string().nullable(),+ required: z.boolean(),+ showOnSheet: z.boolean(),+ showOnTable: z.boolean(),+ showOnFilter: z.boolean(),+ position: z.number(),+ archived: z.boolean(),+ options: z.array(fieldOptionOutput),+ value: fieldValueOutput,+});++const contactCompanyOutput = z.object({+ id: z.string(),+ name: z.string(),+ domain: z.string().nullable(),+ iconUrl: z.string().nullable(),+ iconDarkUrl: z.string().nullable(),+ iconTone: z.string().nullable(),+ logoUrl: z.string().nullable(),+});++const contactOwnerOutput = z.object({+ id: z.string(),+ name: z.string(),+ email: z.string(),+ image: z.string().nullable(),+});++export const contactRowOutput = z.object({+ id: z.string(),+ firstName: z.string(),+ lastName: z.string().nullable(),+ email: z.string().nullable(),+ title: z.string().nullable(),+ imageUrl: z.string().nullable(),+ source: z.enum(+ Object.values(RecordSource) as [RecordSource, ...RecordSource[]],+ ),+ company: contactCompanyOutput.nullable(),+ owner: contactOwnerOutput.nullable(),+ lastActivityAt: z.string().nullable(),+ createdAt: z.string(),+ archivedAt: z.string().nullable(),+ fields: z.record(z.string(), fieldValueOutput),+});++export type ContactRow = z.infer<typeof contactRowOutput>;++export const contactListOutput = z.object({+ rows: z.array(contactRowOutput),+ total: z.number(),+ facetCounts: z.record(z.string(), z.record(z.string(), z.number())),+});++const contactBriefSectionsOutput = z.object({+ currentRole: z.string().optional(),+ tenure: z.string().optional(),+ previousRoles: z.array(z.string()).optional(),+ seniority: z.string().optional(),+ function: z.string().optional(),+ location: z.string().optional(),+});++const contactBriefOutput = z.object({+ narrative: z.string(),+ sections: contactBriefSectionsOutput,+ score: z.number(),+ sourceUrl: z.string().nullable(),+ refreshedAt: z.string(),+});++const contactFactEvidenceOutput = z.object({+ kind: z.string(),+ detail: z.string(),+ sourceUrl: z.string().optional(),+});++const contactFactOutput = z.object({+ id: z.string(),+ field: z.string(),+ value: z.string(),+ score: z.number(),+ band: z.enum(Object.values(FactBand) as [FactBand, ...FactBand[]]),+ evidence: z.array(contactFactEvidenceOutput),+ method: z.string(),+ sourceUrl: z.string().nullable(),+ status: z.enum(Object.values(FactStatus) as [FactStatus, ...FactStatus[]]),+ observedAt: z.string(),+});++const contactRelationshipMeetingOutput = z.object({+ title: z.string(),+ startsAt: z.string(),+});++const contactRelationshipColleagueOutput = z.object({+ id: z.string(),+ name: z.string(),+ title: z.string().nullable(),+});++const contactRelationshipOutput = z.object({+ emails: z.number(),+ threads: z.number(),+ lastReplyAt: z.string().nullable(),+ meetings: z.number(),+ nextMeeting: contactRelationshipMeetingOutput.nullable(),+ colleagues: z.array(contactRelationshipColleagueOutput),+});++const contactDealOutput = z.object({+ id: z.string(),+ name: z.string(),+ stage: z.enum(Object.values(DealStage) as [DealStage, ...DealStage[]]),+ currency: z.string(),+ expectedCloseDate: z.string().nullable(),+ owner: contactOwnerOutput,+ role: z.string().nullable(),+ amountCents: z.number().nullable(),+});++export const contactByIdOutput = z.object({+ id: z.string(),+ firstName: z.string(),+ lastName: z.string().nullable(),+ email: z.string().nullable(),+ phone: z.string().nullable(),+ title: z.string().nullable(),+ linkedinUrl: z.string().nullable(),+ twitterUrl: z.string().nullable(),+ githubUrl: z.string().nullable(),+ imageUrl: z.string().nullable(),+ enrichmentStatus: z.enum(+ Object.values(EnrichmentStatus) as [+ EnrichmentStatus,+ ...EnrichmentStatus[],+ ],+ ),+ enrichmentError: z.string().nullable(),+ owner: contactOwnerOutput.nullable(),+ company: contactCompanyOutput+ .extend({+ industry: z.string().nullable(),+ primaryContactId: z.string().nullable(),+ })+ .nullable(),+ fields: z.array(recordFieldOutput),+ queued: z.boolean(),+ createdAt: z.string(),+ archivedAt: z.string().nullable(),+ brief: contactBriefOutput.nullable(),+ facts: z.array(contactFactOutput),+ relationship: contactRelationshipOutput,+ isPrimaryContact: z.boolean(),+ deals: z.array(contactDealOutput),+});++export const contactBasicOutput = z.object({+ id: z.string(),+ firstName: z.string(),+ lastName: z.string().nullable(),+});++export const contactNameOutput = z.object({+ id: z.string(),+ name: z.string(),+});++export const contactEnrichOutput = z.object({+ id: z.string(),+ queued: z.literal(true),+});++export const bulkResultOutput = z.object({+ requested: z.number(),+ succeeded: z.number(),+ failed: z.number(),+ message: z.string().nullable(),+});++export const decideFactOutput = z.object({+ contactId: z.string(),+ field: z.string(),+ applied: z.boolean(),+});diff --git a/apps/api/src/contacts/contacts.router.ts b/apps/api/src/contacts/contacts.router.tsindex d87f5a81..025ff671 100644--- a/apps/api/src/contacts/contacts.router.ts+++ b/apps/api/src/contacts/contacts.router.ts@@ -10,14 +10,22 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import {+ bulkResultOutput,+ contactBasicOutput,contactBulkCompanyInput,contactBulkInput,contactBulkOwnerInput,+ contactByIdOutput,contactCreateInput,+ contactEnrichOutput,contactIdInput,contactListInput,+ contactListOutput,+ contactNameOutput,contactUpdateArgs,+ decideFactOutput,factDecisionInput,} from "./contacts.contracts";import { ContactsService } from "./contacts.service";@@ -29,59 +37,139 @@ export class ContactsRouter {@Inject(ContactsService) private readonly contacts: ContactsService,) {}- @Query({ input: contactListInput })+ @Query({+ input: contactListInput,+ output: contactListOutput,+ meta: restMeta("POST", "/contacts/search", ["Contacts"]),+ })async list(@Input() input: z.infer<typeof contactListInput>) {return this.contacts.list(input);}- @Query({ input: contactIdInput })+ @Query({+ input: contactIdInput,+ output: contactByIdOutput,+ meta: restMeta("GET", "/contacts/{id}", ["Contacts"]),+ })async byId(@Input("id") id: string) {return this.contacts.byId(id);}- @Mutation({ input: contactCreateInput })+ @Mutation({+ input: contactCreateInput,+ output: contactBasicOutput,+ meta: restMeta("POST", "/contacts", ["Contacts"]),+ })async create(@Input() input: z.infer<typeof contactCreateInput>) {return this.contacts.create(input);}- @Mutation({ input: contactUpdateArgs })+ @Mutation({+ input: contactUpdateArgs,+ output: contactBasicOutput,+ meta: restMeta("PATCH", "/contacts/{id}", ["Contacts"]),+ })async update(@Input() input: z.infer<typeof contactUpdateArgs>) {return this.contacts.update(input.id, input.data);}- @Mutation({ input: contactIdInput })- async delete(@Input("id") id: string) {- return this.contacts.delete(id);+ @Mutation({+ input: contactIdInput,+ output: contactNameOutput,+ meta: restMeta("POST", "/contacts/{id}/archive", ["Contacts"]),+ })+ async archive(@Input("id") id: string) {+ return this.contacts.archive(id);}- @Mutation({ input: contactIdInput })+ @Mutation({+ input: contactIdInput,+ output: contactNameOutput,+ meta: restMeta("POST", "/contacts/{id}/restore", ["Contacts"]),+ })+ async restore(@Input("id") id: string) {+ return this.contacts.restore(id);+ }++ @Mutation({+ input: contactIdInput,+ output: contactNameOutput,+ meta: restMeta("DELETE", "/contacts/{id}", ["Contacts"]),+ })+ async purge(@Input("id") id: string) {+ return this.contacts.purge(id);+ }++ @Mutation({+ input: contactIdInput,+ output: contactEnrichOutput,+ meta: restMeta("POST", "/contacts/{id}/enrich", ["Contacts"]),+ })async enrich(@Input("id") id: string) {return this.contacts.enrich(id);}- @Mutation({ input: contactBulkOwnerInput })+ @Mutation({+ input: contactBulkOwnerInput,+ output: bulkResultOutput,+ meta: restMeta("POST", "/contacts/bulk-assign-owner", ["Contacts"]),+ })async bulkAssignOwner(@Input() input: z.infer<typeof contactBulkOwnerInput>) {return this.contacts.bulkAssignOwner(input);}- @Mutation({ input: contactBulkCompanyInput })+ @Mutation({+ input: contactBulkCompanyInput,+ output: bulkResultOutput,+ meta: restMeta("POST", "/contacts/bulk-set-company", ["Contacts"]),+ })async bulkSetCompany(@Input() input: z.infer<typeof contactBulkCompanyInput>,) {return this.contacts.bulkSetCompany(input);}- @Mutation({ input: contactBulkInput })+ @Mutation({+ input: contactBulkInput,+ output: bulkResultOutput,+ meta: restMeta("POST", "/contacts/bulk-enrich", ["Contacts"]),+ })async bulkEnrich(@Input("ids") ids: string[]) {return this.contacts.bulkEnrich(ids);}- @Mutation({ input: contactBulkInput })- async bulkDelete(@Input("ids") ids: string[]) {- return this.contacts.bulkDelete(ids);+ @Mutation({+ input: contactBulkInput,+ output: bulkResultOutput,+ meta: restMeta("POST", "/contacts/bulk-archive", ["Contacts"]),+ })+ async bulkArchive(@Input("ids") ids: string[]) {+ return this.contacts.bulkArchive(ids);+ }++ @Mutation({+ input: contactBulkInput,+ output: bulkResultOutput,+ meta: restMeta("POST", "/contacts/bulk-restore", ["Contacts"]),+ })+ async bulkRestore(@Input("ids") ids: string[]) {+ return this.contacts.bulkRestore(ids);+ }++ @Mutation({+ input: contactBulkInput,+ output: bulkResultOutput,+ meta: restMeta("POST", "/contacts/bulk-purge", ["Contacts"]),+ })+ async bulkPurge(@Input("ids") ids: string[]) {+ return this.contacts.bulkPurge(ids);}- @Mutation({ input: factDecisionInput })+ @Mutation({+ input: factDecisionInput,+ output: decideFactOutput,+ meta: restMeta("POST", "/contacts/decide-fact", ["Contacts"]),+ })async decideFact(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof factDecisionInput>,diff --git a/apps/api/src/contacts/contacts.service.ts b/apps/api/src/contacts/contacts.service.tsindex fabdbd56..3e1565f4 100644--- a/apps/api/src/contacts/contacts.service.ts+++ b/apps/api/src/contacts/contacts.service.ts@@ -7,6 +7,7 @@ import {Prisma as PrismaNamespace,type RecordSource,} from "@crm/db";+import type { FieldDefinitionWithOptions } from "@crm/db/fields";import {ConflictException,Injectable,@@ -15,6 +16,7 @@ import {} from "@nestjs/common";import { AgentQueueService } from "../agent/agent-queue.service";import { AgentTriggerService } from "../agent/agent-trigger.service";+import { ARCHIVE } from "../archive/archive-config";import { CompanyDirectoryService } from "../companies/company-directory.service";import {ActivityStampService,@@ -25,20 +27,24 @@ import { blankToNull, normalizeEmail, toCents } from "../crm/values";import { InjectDatabase } from "../database/database.constants";import { FieldsService } from "../fields/fields.service";import {+ activityFacetCounts,+ activityFilter,+ archivedFilter,countsByKey,- FACET_ALL,FACET_UNASSIGNED,type ListResult,type OrderByColumns,ownerFilter,paginate,resolveOrderBy,+ splitSentinel,} from "../trpc/list-input";import type {ContactBulkCompanyInput,ContactBulkOwnerInput,ContactCreateInput,ContactListInput,+ ContactRow,ContactUpdateInput,FactDecisionInput,} from "./contacts.contracts";@@ -66,38 +72,13 @@ type FactColumns = Record<string, string | undefined>;const FACT_COLUMNS: FactColumns = {title: "title",+ seniority: "seniority",+ function: "function",linkedinUrl: "linkedinUrl",twitterUrl: "twitterUrl",githubUrl: "githubUrl",};-export type ContactRow = {- id: string;- firstName: string;- lastName: string | null;- email: string | null;- title: string | null;- imageUrl: string | null;- company: {- id: string;- name: string;- domain: string | null;- iconUrl: string | null;- iconDarkUrl: string | null;- iconTone: string | null;- logoUrl: string | null;- } | null;- owner: {- id: string;- name: string;- email: string;- image: string | null;- } | null;- lastActivityAt: string | null;- createdAt: string;- fields: Record<string, string | number | boolean | null>;-};-const SORTABLE: OrderByColumns<Prisma.ContactOrderByWithRelationInput[]> = {name: (dir) => [{ lastName: dir }, { firstName: dir }],email: (dir) => [{ email: dir }],@@ -106,6 +87,7 @@ const SORTABLE: OrderByColumns<Prisma.ContactOrderByWithRelationInput[]> = {createdAt: (dir) => [{ createdAt: dir }],owner: (dir) => [{ owner: { name: dir } }, { lastName: "asc" }],lastActivity: (dir) => [{ lastActivityAt: { sort: dir, nulls: "last" } }],+ archivedAt: (dir) => [{ archivedAt: { sort: dir, nulls: "last" } }],};@Injectable()@@ -122,7 +104,8 @@ export class ContactsService {) {}async list(input: ContactListInput): Promise<ListResult<ContactRow>> {- const where = this.buildWhere(input);+ const filterableFields = await this.fields.filterableFieldsFor("CONTACT");+ const where = this.buildWhere(input, filterableFields);const { skip, take } = paginate(input);const [rows, total, facetCounts] = await Promise.all([@@ -143,10 +126,11 @@ export class ContactsService {owner: { select: OWNER_SELECT },lastActivityAt: true,createdAt: true,+ archivedAt: true,},}),this.db.contact.count({ where }),- this.facetCounts(input),+ this.facetCounts(input, filterableFields),]);const tableFields = await this.fields.tableValuesFor(@@ -159,6 +143,7 @@ export class ContactsService {...row,lastActivityAt: row.lastActivityAt?.toISOString() ?? null,createdAt: row.createdAt.toISOString(),+ archivedAt: row.archivedAt?.toISOString() ?? null,fields: tableFields.get(row.id) ?? {},})),total,@@ -183,6 +168,7 @@ export class ContactsService {enrichmentStatus: true,enrichmentError: true,createdAt: true,+ archivedAt: true,brief: {select: {narrative: true,@@ -240,7 +226,8 @@ export class ContactsService {contact.company?.id ?? null,);- const { deals, createdAt, brief, facts, company, ...rest } = contact;+ const { deals, createdAt, archivedAt, brief, facts, company, ...rest } =+ contact;return {...rest,@@ -248,6 +235,7 @@ export class ContactsService {fields: await this.fields.valuesFor("CONTACT", id),queued: await this.queue.isQueued({ contactId: id }),createdAt: createdAt.toISOString(),+ archivedAt: archivedAt?.toISOString() ?? null,brief: brief? {...brief,@@ -277,7 +265,10 @@ export class ContactsService {if (email) {const existing = await this.db.contact.findFirst({- where: { email: { equals: email, mode: "insensitive" } },+ where: {+ email: { equals: email, mode: "insensitive" },+ archivedAt: null,+ },select: { id: true, firstName: true, lastName: true },});if (existing) {@@ -337,6 +328,17 @@ export class ContactsService {contact.id,"Added by a rep, with nothing on the record yet",);+ this.fields+ .queueBackfillForNewRecord("CONTACT", contact.id)+ .catch((error: Error) => {+ this.logger.error(+ {+ message: "Contact backfill queueing failed",+ contactId: contact.id,+ },+ error.stack,+ );+ });return {id: contact.id,@@ -345,15 +347,70 @@ export class ContactsService {};}- async delete(id: string): Promise<{ id: string; name: string }> {+ async archive(id: string): Promise<{ id: string; name: string }> {+ try {+ const contact = await this.db.contact.update({+ where: { id },+ data: { archivedAt: new Date() },+ select: { firstName: true, lastName: true },+ });++ this.logger.log({ message: "Contact archived", contactId: id });++ return { id, name: nameOf(contact) };+ } catch (error) {+ throw this.translate(error, id);+ }+ }++ async restore(id: string): Promise<{ id: string; name: string }> {+ try {+ const contact = await this.db.contact.update({+ where: { id },+ data: { archivedAt: null },+ select: { firstName: true, lastName: true },+ });++ this.logger.log({ message: "Contact restored", contactId: id });++ return { id, name: nameOf(contact) };+ } catch (error) {+ throw this.translate(error, id);+ }+ }++ async purge(id: string): Promise<{ id: string; name: string }>;+ async purge(+ id: string,+ guard: { archivedBefore: Date },+ ): Promise<{ id: string; name: string } | null>;+ async purge(+ id: string,+ guard?: { archivedBefore: Date },+ ): Promise<{ id: string; name: string } | null> {let deleted: {targets: StampTargets;name: string;suppressed: boolean;- };+ } | null;try {deleted = await this.db.$transaction(async (tx) => {+ const [row] = await tx.$queryRaw<Array<{ archivedAt: Date | null }>>`+ SELECT "archivedAt" FROM contact WHERE id = ${id} FOR UPDATE+ `;++ if (!row) {+ if (guard) return null;+ throw new NotFoundException(`No contact with id ${id}.`);+ }+ if (+ guard &&+ (!row.archivedAt || row.archivedAt > guard.archivedBefore)+ ) {+ return null;+ }+const targets = await this.stamp.targetsOf({ contactId: id }, tx);await tx.agentTask.deleteMany({ where: { contactId: id } });@@ -364,9 +421,7 @@ export class ContactsService {select: { firstName: true, lastName: true, email: true },});- const name = [contact.firstName, contact.lastName]- .filter(Boolean)- .join(" ");+ const name = nameOf(contact);const suppress = normalizeEmail(contact.email ?? "");if (suppress) {@@ -386,10 +441,12 @@ export class ContactsService {throw this.translate(error, id);}+ if (!deleted) return null;+await this.stamp.recomputeAfterDelete(deleted.targets, { contactId: id });this.logger.log({- message: "Contact deleted",+ message: "Contact purged",contactId: id,suppressed: deleted.suppressed,});@@ -397,6 +454,19 @@ export class ContactsService {return { id, name: deleted.name };}+ async purgeExpired(before: Date): Promise<BulkResult> {+ const expired = await this.db.contact.findMany({+ where: { archivedAt: { lte: before } },+ select: { id: true },+ take: ARCHIVE.prune.maxBatch,+ });++ return runBulk(+ expired.map((row) => row.id),+ (id) => this.purge(id, { archivedBefore: before }),+ );+ }+async update(id: string, input: ContactUpdateInput) {const data: Prisma.ContactUpdateInput = {};@@ -471,6 +541,7 @@ export class ContactsService {return {requested: ids.length,succeeded: count,+ skipped: 0,failed: ids.length - count,message: null,};@@ -504,6 +575,7 @@ export class ContactsService {return {requested: ids.length,succeeded: count,+ skipped: 0,failed: ids.length - count,message: null,};@@ -513,8 +585,16 @@ export class ContactsService {return runBulk(ids, (id) => this.enrich(id));}- async bulkDelete(ids: string[]): Promise<BulkResult> {- return runBulk(ids, (id) => this.delete(id));+ async bulkArchive(ids: string[]): Promise<BulkResult> {+ return runBulk(ids, (id) => this.archive(id));+ }++ async bulkRestore(ids: string[]): Promise<BulkResult> {+ return runBulk(ids, (id) => this.restore(id));+ }++ async bulkPurge(ids: string[]): Promise<BulkResult> {+ return runBulk(ids, (id) => this.purge(id));}private async allowAgain(@@ -710,27 +790,66 @@ export class ContactsService {};}- private buildWhere(input: ContactListInput): Prisma.ContactWhereInput {- const where: Prisma.ContactWhereInput = {- ...this.searchFilter(input.q),- ...ownerFilter(input.owner),- };+ private companyFilter(+ values: string[],+ ): Prisma.ContactWhereInput | undefined {+ if (values.length === 0) return undefined;- if (input.company !== FACET_ALL) {- where.companyId = input.company === NO_COMPANY ? null : input.company;- }+ const { ids, includesSentinel } = splitSentinel(values, NO_COMPANY);+ if (includesSentinel && ids.length === 0) return { companyId: null };+ if (!includesSentinel) return { companyId: { in: ids } };+ return { OR: [{ companyId: { in: ids } }, { companyId: null }] };+ }++ private buildWhere(+ input: ContactListInput,+ filterableFields: FieldDefinitionWithOptions[],+ ): Prisma.ContactWhereInput {+ const and: Prisma.ContactWhereInput[] = [+ this.searchFilter(input.q),+ archivedFilter(input.archived),+ ...this.fields.fieldFilters(filterableFields, input.fields),+ ];++ const owner = ownerFilter<Prisma.ContactWhereInput>(input.owner);+ if (owner) and.push(owner);- if (input.source !== FACET_ALL) {- where.source = input.source as RecordSource;+ const company = this.companyFilter(input.company);+ if (company) and.push(company);++ if (input.source.length > 0) {+ and.push({ source: { in: input.source as RecordSource[] } });+ }+ if (input.title.length > 0) and.push({ title: { in: input.title } });+ if (input.seniority.length > 0) {+ and.push({ seniority: { in: input.seniority } });}+ if (input.persona.length > 0) and.push({ function: { in: input.persona } });- return where;+ const activity = activityFilter(input.activity);+ if (activity) and.push(activity);++ return { AND: and };}- private async facetCounts(input: ContactListInput) {- const where = this.searchFilter(input.q);+ private async facetCounts(+ input: ContactListInput,+ filterableFields: FieldDefinitionWithOptions[],+ ) {+ const where = {+ AND: [this.searchFilter(input.q), archivedFilter(input.archived)],+ };- const [owners, companies, sources] = await Promise.all([+ const [+ owners,+ companies,+ sources,+ titles,+ seniorities,+ personas,+ activity,+ fieldFacets,+ ] = await Promise.all([this.db.contact.groupBy({by: ["ownerId"],where,@@ -746,12 +865,41 @@ export class ContactsService {where,_count: { _all: true },}),+ this.db.contact.groupBy({+ by: ["title"],+ where,+ _count: { _all: true },+ }),+ this.db.contact.groupBy({+ by: ["seniority"],+ where,+ _count: { _all: true },+ }),+ this.db.contact.groupBy({+ by: ["function"],+ where,+ _count: { _all: true },+ }),+ activityFacetCounts((activityWhere) =>+ this.db.contact.count({ where: { AND: [where, activityWhere] } }),+ ),+ this.fields.filterFacetCounts("CONTACT", where, filterableFields),]);return {owner: countsByKey(owners, "ownerId", FACET_UNASSIGNED),company: countsByKey(companies, "companyId", NO_COMPANY),source: countsByKey(sources, "source"),+ title: countsByKey(titles, "title"),+ seniority: countsByKey(seniorities, "seniority"),+ persona: countsByKey(personas, "function"),+ activity,+ ...Object.fromEntries(+ Object.entries(fieldFacets).map(([key, counts]) => [+ `field:${key}`,+ counts,+ ]),+ ),};}@@ -769,3 +917,10 @@ export class ContactsService {throw cause;}}++function nameOf(contact: {+ firstName: string;+ lastName: string | null;+}): string {+ return [contact.firstName, contact.lastName].filter(Boolean).join(" ");+}diff --git a/apps/api/src/conversations/conversation-attachments.controller.ts b/apps/api/src/conversations/conversation-attachments.controller.tsindex 1da698f7..fe1d0860 100644--- a/apps/api/src/conversations/conversation-attachments.controller.ts+++ b/apps/api/src/conversations/conversation-attachments.controller.ts@@ -1,4 +1,4 @@-import type { auth } from "@crm/auth";+import { type auth, SESSION_COOKIE_NAME } from "@crm/auth";import {Controller,Get,@@ -7,17 +7,35 @@ import {Res,StreamableFile,} from "@nestjs/common";+import {+ ApiCookieAuth,+ ApiOkResponse,+ ApiOperation,+ ApiParam,+ ApiQuery,+ ApiTags,+} from "@nestjs/swagger";import { Session, type UserSession } from "@thallesp/nestjs-better-auth";import type { Response } from "express";import { ConversationsService } from "./conversations.service";type CrmSession = UserSession<typeof auth>;+@ApiTags("Conversations")+@ApiCookieAuth(SESSION_COOKIE_NAME)@Controller("api/conversations/attachments")export class ConversationAttachmentsController {constructor(private readonly conversations: ConversationsService) {}@Get(":id")+ @ApiOperation({ summary: "Download a conversation attachment" })+ @ApiParam({ name: "id", description: "Attachment id." })+ @ApiQuery({+ name: "share",+ required: false,+ description: "Share token, for a link opened outside a session.",+ })+ @ApiOkResponse({ description: "The attachment's raw bytes." })async read(@Param("id") id: string,@Query("share") shareToken: string | undefined,diff --git a/apps/api/src/conversations/conversations.contracts.ts b/apps/api/src/conversations/conversations.contracts.tsindex 1e8e9ad0..80c81003 100644--- a/apps/api/src/conversations/conversations.contracts.ts+++ b/apps/api/src/conversations/conversations.contracts.ts@@ -1,5 +1,43 @@+import {+ AgentBuilderArtifactStatus,+ AgentConversationCommandType,+ AgentConversationSubmissionStatus,+ AgentDefinitionStatus,+ AgentResponseRating,+ AgentTriggerType,+ AgentVersionStatus,+} from "@crm/db";import { z } from "zod";+const agentManifestSummaryOutput = z.object({+ name: z.string().optional(),+ description: z.string().optional(),+ access: z.array(z.string()),+ triggers: z.array(+ z.object({ type: z.string().optional(), summary: z.string().optional() }),+ ),+ actions: z.array(z.object({ summary: z.string().optional() })),+ dataScope: z.object({ summary: z.string().optional() }),+});++const builderQuestionOutput = z+ .object({+ kind: z.literal("question"),+ requestId: z.string(),+ prompt: z.string(),+ display: z.enum(["confirmation", "select", "text"]).optional(),+ options: z.array(+ z.object({+ id: z.string(),+ label: z.string(),+ description: z.string().optional(),+ style: z.enum(["danger", "default", "primary"]).optional(),+ }),+ ),+ allowFreeform: z.boolean().optional(),+ })+ .nullable();+const recordShape = {contactId: z.string().trim().min(1).optional(),companyId: z.string().trim().min(1).optional(),@@ -142,3 +180,237 @@ function decodedBase64Size(value: string): number {const padding = value.endsWith("==") ? 2 : value.endsWith("=") ? 1 : 0;return (value.length / 4) * 3 - padding;}++const agentDefinitionStatusOutput = z.enum(+ Object.values(AgentDefinitionStatus) as [+ AgentDefinitionStatus,+ ...AgentDefinitionStatus[],+ ],+);++const agentVersionStatusOutput = z.enum(+ Object.values(AgentVersionStatus) as [+ AgentVersionStatus,+ ...AgentVersionStatus[],+ ],+);++const agentBuilderArtifactStatusOutput = z.enum(+ Object.values(AgentBuilderArtifactStatus) as [+ AgentBuilderArtifactStatus,+ ...AgentBuilderArtifactStatus[],+ ],+);++const agentTriggerTypeOutput = z.enum(+ Object.values(AgentTriggerType) as [AgentTriggerType, ...AgentTriggerType[]],+);++const agentConversationCommandTypeOutput = z.enum(+ Object.values(AgentConversationCommandType) as [+ AgentConversationCommandType,+ ...AgentConversationCommandType[],+ ],+);++const agentConversationSubmissionStatusOutput = z.enum(+ Object.values(AgentConversationSubmissionStatus) as [+ AgentConversationSubmissionStatus,+ ...AgentConversationSubmissionStatus[],+ ],+);++const agentResponseRatingOutput = z.enum(+ Object.values(AgentResponseRating) as [+ AgentResponseRating,+ ...AgentResponseRating[],+ ],+);++export const conversationIdOutput = z.object({ id: z.string() });++export const conversationSummaryOutput = z.object({+ id: z.string(),+ sessionId: z.string(),+ continuationToken: z.string().nullable(),+ streamIndex: z.number(),+ title: z.string().nullable(),+ messageCount: z.number(),+ lastMessageAt: z.string(),+});++export const conversationListOutput = z.array(conversationSummaryOutput);++export type ConversationSummary = z.infer<typeof conversationSummaryOutput>;++const builderConversationAgentSummaryOutput = z.object({+ id: z.string(),+ name: z.string(),+ status: agentDefinitionStatusOutput,+});++export const builderConversationSummaryOutput = z.object({+ id: z.string(),+ sessionId: z.string().nullable(),+ continuationToken: z.string().nullable(),+ streamIndex: z.number(),+ title: z.string().nullable(),+ messageCount: z.number(),+ lastMessageAt: z.string(),+ lastAssistantAt: z.string().nullable(),+ unread: z.boolean(),+ state: z.enum(["working", "unread", "deployed", "idle"]),+ agent: builderConversationAgentSummaryOutput.nullable(),+});++export const builderListOutput = z.array(builderConversationSummaryOutput);++export type BuilderConversationSummary = z.infer<+ typeof builderConversationSummaryOutput+>;++export const builderResourceOutput = z.object({+ kind: z.enum(["integration", "company", "contact", "deal"]),+ id: z.string(),+ label: z.string(),+ detail: z.string().nullable(),+ imageUrl: z.string().nullable(),+});++export const builderResourcesOutput = z.array(builderResourceOutput);++export const agentBuilderArtifactOutput = z.object({+ id: z.string(),+ versionId: z.string().nullable(),+ path: z.string(),+ language: z.string(),+ content: z.string(),+ previousContent: z.string().nullable(),+ revision: z.number(),+ status: agentBuilderArtifactStatusOutput,+ createdAt: z.string(),+});++const agentTriggerSummaryOutput = z.object({+ id: z.string(),+ type: agentTriggerTypeOutput,+ name: z.string(),+ config: z.unknown(),+ enabled: z.boolean(),+ nextRunAt: z.string().nullable(),+});++const agentCurrentVersionSummaryOutput = z.object({+ id: z.string(),+ number: z.number(),+ status: agentVersionStatusOutput,+ manifest: z.unknown(),+ modelId: z.string(),+ sandboxPolicy: z.unknown(),+ deployedAt: z.string().nullable(),+});++const builderAgentDetailOutput = z.object({+ id: z.string(),+ name: z.string(),+ description: z.string().nullable(),+ status: agentDefinitionStatusOutput,+ createdBy: z.object({ id: z.string(), name: z.string() }),+ currentVersion: agentCurrentVersionSummaryOutput.nullable(),+ triggers: z.array(agentTriggerSummaryOutput),+});++const builderCreatedVersionOutput = z.object({+ id: z.string(),+ number: z.number(),+ status: agentVersionStatusOutput,+ instructions: z.string(),+ manifest: agentManifestSummaryOutput,+ modelId: z.string(),+ sandboxPolicy: z.unknown(),+ validation: z.unknown().nullable(),+ createdAt: z.string(),+});++const builderFeedbackOutput = z.object({+ messageId: z.string(),+ rating: agentResponseRatingOutput,+});++const builderSubmissionOutput = z.object({+ id: z.string(),+ clientRequestId: z.string(),+ commandType: agentConversationCommandTypeOutput,+ message: z.record(z.string(), z.unknown()),+ status: agentConversationSubmissionStatusOutput,+ errorCode: z.string().nullable(),+ errorMessage: z.string().nullable(),+ createdAt: z.string(),+ sentAt: z.string().nullable(),+ acceptedAt: z.string().nullable(),+});++export const builderConversationDetailOutput = z.object({+ id: z.string(),+ sessionId: z.string().nullable(),+ continuationToken: z.string().nullable(),+ streamIndex: z.number(),+ title: z.string().nullable(),+ messageCount: z.number(),+ lastMessageAt: z.string(),+ lastAssistantAt: z.string().nullable(),+ lastReadAt: z.string().nullable(),+ pendingQuestion: builderQuestionOutput,+ agent: builderAgentDetailOutput.nullable(),+ createdVersions: z.array(builderCreatedVersionOutput),+ builderArtifacts: z.array(agentBuilderArtifactOutput),+ feedback: z.array(builderFeedbackOutput),+ submissions: z.array(builderSubmissionOutput),+});++export const conversationEventOutput = z.object({+ type: z.string(),+ data: z.unknown(),+ meta: z.object({ id: z.string(), at: z.string() }),+});++export const conversationEventsOutput = z.array(conversationEventOutput);++export const builderResponseRatingOutput = z.object({+ id: z.string(),+ rating: agentResponseRatingOutput.nullable(),+});++export const conversationShareStatusOutput = z.object({+ enabled: z.boolean(),+ createdAt: z.string().nullable(),+ expiresAt: z.string().nullable(),+});++export const conversationShareTokenOutput = z.object({ token: z.string() });++const sharedConversationAgentOutput = z.object({+ id: z.string(),+ name: z.string(),+ status: agentDefinitionStatusOutput,+});++const sharedConversationSubmissionOutput = z.object({+ id: z.string(),+ commandType: agentConversationCommandTypeOutput,+ message: z.record(z.string(), z.unknown()),+ status: agentConversationSubmissionStatusOutput,+ errorMessage: z.string().nullable(),+ createdAt: z.string(),+});++export const sharedConversationOutput = z.object({+ id: z.string(),+ title: z.string().nullable(),+ ownerName: z.string(),+ lastMessageAt: z.string(),+ agent: sharedConversationAgentOutput.nullable(),+ builderArtifacts: z.array(agentBuilderArtifactOutput),+ submissions: z.array(sharedConversationSubmissionOutput),+ events: conversationEventsOutput,+});diff --git a/apps/api/src/conversations/conversations.router.ts b/apps/api/src/conversations/conversations.router.tsindex e65987ee..6307e046 100644--- a/apps/api/src/conversations/conversations.router.ts+++ b/apps/api/src/conversations/conversations.router.ts@@ -10,18 +10,29 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import { ConversationSharingService } from "./conversation-sharing.service";import {builderConversationCreateInput,+ builderConversationDetailOutput,builderConversationSubmitInput,+ builderListOutput,builderQuestionResponseInput,builderResourceSearchInput,+ builderResourcesOutput,builderResponseRatingInput,+ builderResponseRatingOutput,conversationEventsInput,+ conversationEventsOutput,conversationIdInput,+ conversationIdOutput,conversationListInput,+ conversationListOutput,conversationSaveInput,+ conversationShareStatusOutput,+ conversationShareTokenOutput,sharedConversationInput,+ sharedConversationOutput,} from "./conversations.contracts";import { ConversationsService } from "./conversations.service";@@ -35,7 +46,11 @@ export class ConversationsRouter {private readonly sharing: ConversationSharingService,) {}- @Query({ input: conversationListInput })+ @Query({+ input: conversationListInput,+ output: conversationListOutput,+ meta: restMeta("GET", "/conversations", ["Conversations"]),+ })async list(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof conversationListInput>,@@ -43,22 +58,39 @@ export class ConversationsRouter {return this.conversations.list(input, ctx.user.id);}- @Query()+ @Query({+ output: builderListOutput,+ meta: restMeta("GET", "/conversations/builder", ["Conversations"]),+ })async builderList(@Ctx() ctx: AuthedTrpcContext) {return this.conversations.listBuilder(ctx.user.id);}- @Query({ input: builderResourceSearchInput })+ @Query({+ input: builderResourceSearchInput,+ output: builderResourcesOutput,+ meta: restMeta("GET", "/conversations/builder-resources", [+ "Conversations",+ ]),+ })async builderResources(@Ctx() ctx: AuthedTrpcContext, @Input("q") q: string) {return this.conversations.builderResources(q, ctx.user.id);}- @Query({ input: conversationIdInput })+ @Query({+ input: conversationIdInput,+ output: builderConversationDetailOutput,+ meta: restMeta("GET", "/conversations/builder/{id}", ["Conversations"]),+ })async builderById(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.conversations.builderById(id, ctx.user.id);}- @Query({ input: conversationEventsInput })+ @Query({+ input: conversationEventsInput,+ output: conversationEventsOutput,+ meta: restMeta("GET", "/conversations/{id}/events", ["Conversations"]),+ })async events(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof conversationEventsInput>,@@ -66,7 +98,11 @@ export class ConversationsRouter {return this.conversations.events(input, ctx.user.id);}- @Mutation({ input: conversationSaveInput })+ @Mutation({+ input: conversationSaveInput,+ output: conversationIdOutput,+ meta: restMeta("POST", "/conversations", ["Conversations"]),+ })async save(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof conversationSaveInput>,@@ -74,7 +110,11 @@ export class ConversationsRouter {return this.conversations.save(input, ctx.user.id);}- @Mutation({ input: builderConversationCreateInput })+ @Mutation({+ input: builderConversationCreateInput,+ output: conversationIdOutput,+ meta: restMeta("POST", "/conversations/builder", ["Conversations"]),+ })async createBuilder(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof builderConversationCreateInput>,@@ -82,7 +122,13 @@ export class ConversationsRouter {return this.conversations.createBuilder(input, ctx.user.id);}- @Mutation({ input: builderConversationSubmitInput })+ @Mutation({+ input: builderConversationSubmitInput,+ output: conversationIdOutput,+ meta: restMeta("POST", "/conversations/{id}/submit-builder", [+ "Conversations",+ ]),+ })async submitBuilder(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof builderConversationSubmitInput>,@@ -90,7 +136,13 @@ export class ConversationsRouter {return this.conversations.submitBuilder(input, ctx.user.id);}- @Mutation({ input: builderQuestionResponseInput })+ @Mutation({+ input: builderQuestionResponseInput,+ output: conversationIdOutput,+ meta: restMeta("POST", "/conversations/{id}/answer-builder-question", [+ "Conversations",+ ]),+ })async answerBuilderQuestion(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof builderQuestionResponseInput>,@@ -98,7 +150,13 @@ export class ConversationsRouter {return this.conversations.answerBuilderQuestion(input, ctx.user.id);}- @Mutation({ input: builderResponseRatingInput })+ @Mutation({+ input: builderResponseRatingInput,+ output: builderResponseRatingOutput,+ meta: restMeta("POST", "/conversations/{id}/rate-builder-response", [+ "Conversations",+ ]),+ })async rateBuilderResponse(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof builderResponseRatingInput>,@@ -106,32 +164,56 @@ export class ConversationsRouter {return this.conversations.rateBuilderResponse(input, ctx.user.id);}- @Mutation({ input: conversationIdInput })+ @Mutation({+ input: conversationIdInput,+ output: conversationIdOutput,+ meta: restMeta("PATCH", "/conversations/{id}/read", ["Conversations"]),+ })async markRead(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.conversations.markRead(id, ctx.user.id);}- @Query({ input: conversationIdInput })+ @Query({+ input: conversationIdInput,+ output: conversationShareStatusOutput,+ meta: restMeta("GET", "/conversations/{id}/share", ["Conversations"]),+ })async shareStatus(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.sharing.status(id, ctx.user.id);}- @Mutation({ input: conversationIdInput })+ @Mutation({+ input: conversationIdInput,+ output: conversationShareTokenOutput,+ meta: restMeta("POST", "/conversations/{id}/share", ["Conversations"]),+ })async createShare(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.sharing.create(id, ctx.user.id);}- @Mutation({ input: conversationIdInput })+ @Mutation({+ input: conversationIdInput,+ output: conversationIdOutput,+ meta: restMeta("DELETE", "/conversations/{id}/share", ["Conversations"]),+ })async revokeShare(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.sharing.revoke(id, ctx.user.id);}- @Query({ input: sharedConversationInput })+ @Query({+ input: sharedConversationInput,+ output: sharedConversationOutput,+ meta: restMeta("GET", "/conversations/shared/{token}", ["Conversations"]),+ })async shared(@Ctx() ctx: AuthedTrpcContext, @Input("token") token: string) {return this.sharing.resolve(token, ctx.user.id);}- @Mutation({ input: conversationIdInput })+ @Mutation({+ input: conversationIdInput,+ output: conversationIdOutput,+ meta: restMeta("DELETE", "/conversations/{id}", ["Conversations"]),+ })async remove(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {return this.conversations.remove(id, ctx.user.id);}diff --git a/apps/api/src/conversations/conversations.service.ts b/apps/api/src/conversations/conversations.service.tsindex 7ee80a4c..d025c9e2 100644--- a/apps/api/src/conversations/conversations.service.ts+++ b/apps/api/src/conversations/conversations.service.ts@@ -22,40 +22,14 @@ import { conversationShareTokenHash } from "./conversation-share-token";import type {BuilderConversationCreateInput,BuilderConversationSubmitInput,+ BuilderConversationSummary,BuilderQuestionResponseInput,ConversationEventsInput,ConversationListInput,ConversationSaveInput,+ ConversationSummary,} from "./conversations.contracts";-export interface ConversationSummary {- id: string;- sessionId: string;- continuationToken: string | null;- streamIndex: number;- title: string | null;- messageCount: number;- lastMessageAt: string;-}--export interface BuilderConversationSummary {- id: string;- sessionId: string | null;- continuationToken: string | null;- streamIndex: number;- title: string | null;- messageCount: number;- lastMessageAt: string;- lastAssistantAt: string | null;- unread: boolean;- state: "working" | "unread" | "deployed" | "idle";- agent: {- id: string;- name: string;- status: string;- } | null;-}-type ReplayedRequest = {id: string;};diff --git a/apps/api/src/create-app.ts b/apps/api/src/create-app.tsindex 98cee688..c14a57bd 100644--- a/apps/api/src/create-app.ts+++ b/apps/api/src/create-app.ts@@ -1,12 +1,22 @@+import { API_KEY_HEADER, apiUrl, SESSION_COOKIE_NAME } from "@crm/auth";import { ValidationPipe } from "@nestjs/common";import { NestFactory } from "@nestjs/core";import {ExpressAdapter,type NestExpressApplication,} from "@nestjs/platform-express";+import { DocumentBuilder, SwaggerModule } from "@nestjs/swagger";+import type { NextFunction, Request, Response } from "express";import helmet from "helmet";+import { AppRouterHost } from "nestjs-trpc";+import {+ createOpenApiExpressMiddleware,+ generateOpenApiDocument,+} from "trpc-to-openapi";import { AppModule } from "./app.module";import { ContextLogger } from "./logging/context-logger";+import { REST_BRIDGE_PATH } from "./trpc/openapi";+import { createBaseTrpcContext } from "./trpc/trpc.context";export async function createApp(): Promise<NestExpressApplication> {const app = await NestFactory.create<NestExpressApplication>(@@ -25,5 +35,77 @@ export async function createApp(): Promise<NestExpressApplication> {}),);+ let restBridge: ((req: Request, res: Response) => Promise<void>) | undefined;+ app.use(+ REST_BRIDGE_PATH,+ (req: Request, res: Response, next: NextFunction) => {+ if (!restBridge) {+ next();+ return;+ }+ void restBridge(req, res);+ },+ );++ const apiKeySecurityScheme = {+ type: "apiKey",+ in: "header",+ name: API_KEY_HEADER,+ } as const;++ // SwaggerModule.setup() registers its Express routes synchronously, so it must+ // happen before app.init() the same way the REST bridge does — Nest's own+ // routing (wired up during init) otherwise shadows anything registered after+ // it. The factory form defers building the document (which needs the tRPC+ // router, only available post-init) to first request instead.+ SwaggerModule.setup("", app, () => {+ const { appRouter } = app.get(AppRouterHost);++ const trpcDocument = generateOpenApiDocument(appRouter, {+ title: "CRM API — tRPC bridge",+ description:+ "Every tRPC procedure, reachable over REST for tooling that cannot speak tRPC. Same validation, same middlewares, same services as the tRPC transport — this only translates the wire format.",+ version: "1.0",+ baseUrl: `${apiUrl}${REST_BRIDGE_PATH}`,+ securitySchemes: { apiKey: apiKeySecurityScheme },+ });++ const swaggerConfig = new DocumentBuilder()+ .setTitle("CRM API")+ .setDescription(+ `REST surface of the CRM API — auth, health, the internal cron routes, and a generated REST bridge (under ${REST_BRIDGE_PATH}) for every tRPC procedure.`,+ )+ .setVersion("1.0")+ .addCookieAuth(SESSION_COOKIE_NAME)+ .addApiKey(apiKeySecurityScheme, "apiKey")+ .build();+ const swaggerDocument = SwaggerModule.createDocument(app, swaggerConfig);++ swaggerDocument.paths = {+ ...swaggerDocument.paths,+ ...(trpcDocument.paths as typeof swaggerDocument.paths),+ };+ swaggerDocument.components = {+ ...swaggerDocument.components,+ schemas: {+ ...swaggerDocument.components?.schemas,+ ...(trpcDocument.components?.schemas as NonNullable<+ typeof swaggerDocument.components+ >["schemas"]),+ },+ };++ return swaggerDocument;+ });++ await app.init();++ const { appRouter } = app.get(AppRouterHost);++ restBridge = createOpenApiExpressMiddleware({+ router: appRouter,+ createContext: ({ req }) => createBaseTrpcContext(req),+ });+return app;}diff --git a/apps/api/src/crm/bulk.ts b/apps/api/src/crm/bulk.tsindex 086da599..d5b7b898 100644--- a/apps/api/src/crm/bulk.ts+++ b/apps/api/src/crm/bulk.ts@@ -14,6 +14,7 @@ export const bulkIdsInput = z.object({export type BulkResult = {requested: number;succeeded: number;+ skipped: number;failed: number;message: string | null;};@@ -40,12 +41,17 @@ export async function runBulk(): Promise<BulkResult> {const unique = [...new Set(ids)];let succeeded = 0;+ let skipped = 0;let message: string | null = null;for (const id of unique) {try {- await act(id);- succeeded += 1;+ const outcome = await act(id);+ if (outcome === null) {+ skipped += 1;+ } else {+ succeeded += 1;+ }} catch (error) {message ??=error instanceof Error ? error.message : "Something went wrong.";@@ -55,7 +61,8 @@ export async function runBulk(return {requested: unique.length,succeeded,- failed: unique.length - succeeded,+ skipped,+ failed: unique.length - succeeded - skipped,message,};}diff --git a/apps/api/src/currency/currency.contracts.ts b/apps/api/src/currency/currency.contracts.tsindex 8530d966..ae2c1b95 100644--- a/apps/api/src/currency/currency.contracts.ts+++ b/apps/api/src/currency/currency.contracts.ts@@ -1,3 +1,4 @@+import { RateSource } from "@crm/db";import { isCurrencyCode } from "@crm/db/currency";import { z } from "zod";@@ -30,3 +31,47 @@ export const removeManualRateInput = z.object({});export type RemoveManualRateInput = z.infer<typeof removeManualRateInput>;++const rateSourceOutput = z.enum([RateSource.FETCHED, RateSource.MANUAL]);++export const currencyRateOutput = z.object({+ currency: z.string(),+ name: z.string().nullable(),+ rate: z.number(),+ asOf: z.string(),+ source: rateSourceOutput,+ provider: z.string().nullable(),+ overriding: z.boolean(),+});++export const currencyInUseOutput = z.object({+ currency: z.string(),+ name: z.string().nullable(),+ deals: z.number(),+ convertible: z.boolean(),+});++export const unconvertedOutput = z.object({+ count: z.number(),+ currencies: z.array(z.string()),+});++export const currencyMetaOutput = z.object({+ code: z.string(),+ name: z.string(),+ minorUnits: z.number(),+});++export const currencySettingsOutput = z.object({+ reportingCurrency: z.string(),+ refreshedAt: z.string().nullable(),+ rates: z.array(currencyRateOutput),+ inUse: z.array(currencyInUseOutput),+ unconverted: unconvertedOutput,+ catalog: z.array(currencyMetaOutput),+ canManage: z.boolean(),+});++export type CurrencyRate = z.infer<typeof currencyRateOutput>;+export type CurrencyInUse = z.infer<typeof currencyInUseOutput>;+export type CurrencySettings = z.infer<typeof currencySettingsOutput>;diff --git a/apps/api/src/currency/currency.router.ts b/apps/api/src/currency/currency.router.tsindex e0a7cc0b..a1b36bea 100644--- a/apps/api/src/currency/currency.router.ts+++ b/apps/api/src/currency/currency.router.ts@@ -10,7 +10,9 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import {+ currencySettingsOutput,removeManualRateInput,setManualRateInput,setReportingCurrencyInput,@@ -24,12 +26,19 @@ export class CurrencyRouter {@Inject(CurrencyService) private readonly currency: CurrencyService,) {}- @Query()+ @Query({+ output: currencySettingsOutput,+ meta: restMeta("GET", "/currency/settings", ["Currency"]),+ })async settings(@Ctx() ctx: AuthedTrpcContext) {return this.currency.settings(ctx.user.id);}- @Mutation({ input: setReportingCurrencyInput })+ @Mutation({+ input: setReportingCurrencyInput,+ output: currencySettingsOutput,+ meta: restMeta("PATCH", "/currency/reporting-currency", ["Currency"]),+ })async setReportingCurrency(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof setReportingCurrencyInput>,@@ -37,7 +46,11 @@ export class CurrencyRouter {return this.currency.setReportingCurrency(ctx.user.id, input.currency);}- @Mutation({ input: setManualRateInput })+ @Mutation({+ input: setManualRateInput,+ output: currencySettingsOutput,+ meta: restMeta("PUT", "/currency/rates/{currency}", ["Currency"]),+ })async setManualRate(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof setManualRateInput>,@@ -45,7 +58,11 @@ export class CurrencyRouter {return this.currency.setManualRate(ctx.user.id, input.currency, input.rate);}- @Mutation({ input: removeManualRateInput })+ @Mutation({+ input: removeManualRateInput,+ output: currencySettingsOutput,+ meta: restMeta("DELETE", "/currency/rates/{currency}", ["Currency"]),+ })async removeManualRate(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof removeManualRateInput>,@@ -53,7 +70,10 @@ export class CurrencyRouter {return this.currency.removeManualRate(ctx.user.id, input.currency);}- @Mutation()+ @Mutation({+ output: currencySettingsOutput,+ meta: restMeta("POST", "/currency/rates/refresh", ["Currency"]),+ })async refreshRates(@Ctx() ctx: AuthedTrpcContext) {return this.currency.refresh(ctx.user.id);}diff --git a/apps/api/src/currency/currency.service.ts b/apps/api/src/currency/currency.service.tsindex 20bd74a3..5dae1d1b 100644--- a/apps/api/src/currency/currency.service.ts+++ b/apps/api/src/currency/currency.service.ts@@ -1,12 +1,7 @@import { canManageCurrency, workspaceRoleOf } from "@crm/auth";import type { Db } from "@crm/db";import { Prisma, RateSource } from "@crm/db";-import {- CURRENCIES,- type CurrencyMeta,- currencyName,- normalizeCurrency,-} from "@crm/db/currency";+import { CURRENCIES, currencyName, normalizeCurrency } from "@crm/db/currency";import { writeReportingCurrency } from "@crm/db/settings";import {BadRequestException,@@ -15,36 +10,10 @@ import {Logger,} from "@nestjs/common";import { InjectDatabase } from "../database/database.constants";-import { ConversionService, type Unconverted } from "./conversion.service";+import { ConversionService } from "./conversion.service";+import type { CurrencyRate, CurrencySettings } from "./currency.contracts";import { RatesService } from "./rates.service";-export interface CurrencyRate {- currency: string;- name: string | null;- rate: number;- asOf: string;- source: RateSource;- provider: string | null;- overriding: boolean;-}--export interface CurrencyInUse {- currency: string;- name: string | null;- deals: number;- convertible: boolean;-}--export interface CurrencySettings {- reportingCurrency: string;- refreshedAt: string | null;- rates: CurrencyRate[];- inUse: CurrencyInUse[];- unconverted: Unconverted;- catalog: CurrencyMeta[];- canManage: boolean;-}-@Injectable()export class CurrencyService {private readonly logger = new Logger(CurrencyService.name);diff --git a/apps/api/src/currency/rates.controller.ts b/apps/api/src/currency/rates.controller.tsindex 2ac65291..1f99af8f 100644--- a/apps/api/src/currency/rates.controller.ts+++ b/apps/api/src/currency/rates.controller.ts@@ -8,11 +8,28 @@ import {ServiceUnavailableException,} from "@nestjs/common";import { ConfigService } from "@nestjs/config";+import {+ ApiExcludeEndpoint,+ ApiForbiddenResponse,+ ApiHeader,+ ApiOkResponse,+ ApiOperation,+ ApiServiceUnavailableResponse,+ ApiTags,+} from "@nestjs/swagger";import { AllowAnonymous } from "@thallesp/nestjs-better-auth";import type { EnvironmentVariables } from "../config/env.validation";import { ConversionService } from "./conversion.service";import { RatesService } from "./rates.service";+@ApiTags("Internal — Cron")+@ApiHeader({+ name: "authorization",+ description: "`Bearer <CRON_SECRET>`",+ required: true,+})+@ApiForbiddenResponse({ description: "CRON_SECRET did not match." })+@ApiServiceUnavailableResponse({ description: "CRON_SECRET is not set." })@Controller("internal/sync")export class RatesController {private readonly logger = new Logger(RatesController.name);@@ -28,12 +45,17 @@ export class RatesController {@Get("rates")@AllowAnonymous()+ @ApiOperation({+ summary: "Refresh exchange rates and convert amounts left pending",+ })+ @ApiOkResponse({ description: "Rates refreshed; conversion counts." })async ratesViaGet(@Headers("authorization") authorization?: string) {return this.run(authorization);}@Post("rates")@AllowAnonymous()+ @ApiExcludeEndpoint()async ratesViaPost(@Headers("authorization") authorization?: string) {return this.run(authorization);}diff --git a/apps/api/src/dashboard/dashboard.contracts.ts b/apps/api/src/dashboard/dashboard.contracts.tsindex 3cc8ac4a..be4331b4 100644--- a/apps/api/src/dashboard/dashboard.contracts.ts+++ b/apps/api/src/dashboard/dashboard.contracts.ts@@ -1,3 +1,5 @@+import { ActivityType, DealStage } from "@crm/db";+import { activityMeta } from "@crm/validation/activity-meta";import { z } from "zod";const DASHBOARD_SCOPES = ["me", "everyone"] as const;@@ -7,3 +9,105 @@ export const dashboardSummaryInput = z.object({});export type DashboardSummaryInput = z.infer<typeof dashboardSummaryInput>;++const stageEnum = z.enum(+ Object.values(DealStage) as [DealStage, ...DealStage[]],+);++const ownerOutput = z.object({+ id: z.string(),+ name: z.string(),+ email: z.string(),+ image: z.string().nullable(),+});++const companyBriefOutput = z.object({+ id: z.string(),+ name: z.string(),+ iconUrl: z.string().nullable(),+ iconDarkUrl: z.string().nullable(),+ iconTone: z.string().nullable(),+});++const linkedRecordOutput = z.object({ id: z.string(), name: z.string() });++const monthlyTotalOutput = z.object({+ count: z.number(),+ valueCents: z.number(),+});++const stageBucketOutput = z.object({+ stage: stageEnum,+ count: z.number(),+ valueCents: z.number(),+});++const trendPointOutput = z.object({+ month: z.string(),+ won: z.number(),+ created: z.number(),+});++const unconvertedOutput = z.object({+ count: z.number(),+ currencies: z.array(z.string()),+});++const biggestOpenDealOutput = z.object({+ id: z.string(),+ name: z.string(),+ stage: stageEnum,+ currency: z.string(),+ company: companyBriefOutput,+ owner: ownerOutput,+ amountCents: z.number().nullable(),+ baseAmountCents: z.number().nullable(),+ expectedCloseDate: z.string().nullable(),+ stageChangedAt: z.string(),+});++const overdueTaskOutput = z.object({+ id: z.string(),+ subject: z.string().nullable(),+ company: linkedRecordOutput.nullable(),+ deal: linkedRecordOutput.nullable(),+ dueAt: z.string().nullable(),+});++const recentActivityOutput = z.object({+ id: z.string(),+ type: z.nativeEnum(ActivityType),+ subject: z.string().nullable(),+ body: z.string().nullable(),+ createdBy: ownerOutput,+ company: linkedRecordOutput.nullable(),+ deal: linkedRecordOutput.nullable(),+ createdAt: z.string(),+ meta: activityMeta,+});++export const dashboardSummaryOutput = z.object({+ scope: z.enum(DASHBOARD_SCOPES),+ reportingCurrency: z.string(),+ unconverted: unconvertedOutput,+ pipeline: z.object({+ stages: z.array(stageBucketOutput),+ totalCents: z.number(),+ totalDeals: z.number(),+ }),+ wonThisMonth: monthlyTotalOutput,+ wonPrevMonth: monthlyTotalOutput,+ performance: z.object({+ windowDays: z.number(),+ wins: z.number(),+ losses: z.number(),+ winRate: z.number().nullable(),+ avgDealCents: z.number().nullable(),+ avgCycleDays: z.number().nullable(),+ }),+ trend: z.array(trendPointOutput),+ closingThisMonthTotal: monthlyTotalOutput,+ biggestOpen: z.array(biggestOpenDealOutput),+ overdueTasks: z.array(overdueTaskOutput),+ recentActivity: z.array(recentActivityOutput),+});diff --git a/apps/api/src/dashboard/dashboard.router.ts b/apps/api/src/dashboard/dashboard.router.tsindex ae7aa3fa..1fce4ab5 100644--- a/apps/api/src/dashboard/dashboard.router.ts+++ b/apps/api/src/dashboard/dashboard.router.ts@@ -3,7 +3,11 @@ import { Ctx, Input, Query, Router, UseMiddlewares } from "nestjs-trpc";import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";-import { dashboardSummaryInput } from "./dashboard.contracts";+import { restMeta } from "../trpc/openapi";+import {+ dashboardSummaryInput,+ dashboardSummaryOutput,+} from "./dashboard.contracts";import { DashboardService } from "./dashboard.service";@Router({ alias: "dashboard" })@@ -13,7 +17,11 @@ export class DashboardRouter {@Inject(DashboardService) private readonly dashboard: DashboardService,) {}- @Query({ input: dashboardSummaryInput })+ @Query({+ input: dashboardSummaryInput,+ output: dashboardSummaryOutput,+ meta: restMeta("GET", "/dashboard/summary", ["Dashboard"]),+ })async summary(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof dashboardSummaryInput>,diff --git a/apps/api/src/deals/deals.contracts.ts b/apps/api/src/deals/deals.contracts.tsindex ef8ee432..a80b38b5 100644--- a/apps/api/src/deals/deals.contracts.ts+++ b/apps/api/src/deals/deals.contracts.ts@@ -1,4 +1,5 @@import { DealStage } from "@crm/db";+import { FIELD_ENTITIES, FIELD_TYPES } from "@crm/db/fields";import { z } from "zod";import { bulkIdsInput } from "../crm/bulk";import { currencyCode } from "../currency/currency.contracts";@@ -27,9 +28,11 @@ export type ClosingWindow = (typeof CLOSING_WINDOWS)[number];export const dealListInput = listInput.extend({status: z.string().default("all"),- owner: z.string().default("all"),- stage: z.string().default("all"),- closing: z.string().default("all"),+ owner: z.array(z.string()).default([]),+ stage: z.array(z.string()).default([]),+ closing: z.array(z.string()).default([]),+ fields: z.record(z.string(), z.array(z.string())).default({}),+ archived: z.boolean().default(false),});export type DealListInput = z.infer<typeof dealListInput>;@@ -123,3 +126,176 @@ export const dealBulkStageInput = bulkIdsInput.extend({});export type DealBulkStageInput = z.infer<typeof dealBulkStageInput>;++const fieldValueOutput = z.union([+ z.string(),+ z.number(),+ z.boolean(),+ z.null(),+]);++const fieldOptionOutput = z.object({+ id: z.string(),+ label: z.string(),+ position: z.number(),+});++const recordFieldOutput = z.object({+ id: z.string(),+ entity: z.enum(FIELD_ENTITIES),+ key: z.string(),+ label: z.string(),+ type: z.enum(FIELD_TYPES),+ typeLabel: z.string(),+ agentFilled: z.boolean(),+ agentBrief: z.string().nullable(),+ required: z.boolean(),+ showOnSheet: z.boolean(),+ showOnTable: z.boolean(),+ showOnFilter: z.boolean(),+ position: z.number(),+ archived: z.boolean(),+ options: z.array(fieldOptionOutput),+ value: fieldValueOutput,+});++const dealOwnerOutput = z.object({+ id: z.string(),+ name: z.string(),+ email: z.string(),+ image: z.string().nullable(),+});++const dealCompanyOutput = z.object({+ id: z.string(),+ name: z.string(),+ domain: z.string().nullable(),+ iconUrl: z.string().nullable(),+ iconDarkUrl: z.string().nullable(),+ iconTone: z.string().nullable(),+ logoUrl: z.string().nullable(),+});++const dealCompanyDetailOutput = dealCompanyOutput.extend({+ industry: z.string().nullable(),+});++const dealContactSummaryOutput = z.object({+ id: z.string(),+ firstName: z.string(),+ lastName: z.string().nullable(),+ email: z.string().nullable(),+ title: z.string().nullable(),+ imageUrl: z.string().nullable(),+});++const dealContactOutput = dealContactSummaryOutput.extend({+ role: z.string().nullable(),+});++const dealListRowOutput = z.object({+ id: z.string(),+ name: z.string(),+ stage: stageEnum,+ currency: z.string(),+ company: dealCompanyOutput,+ owner: dealOwnerOutput,+ amountCents: z.number().nullable(),+ baseAmountCents: z.number().nullable(),+ expectedCloseDate: z.string().nullable(),+ closedAt: z.string().nullable(),+ lastActivityAt: z.string().nullable(),+ createdAt: z.string(),+ archivedAt: z.string().nullable(),+ fields: z.record(z.string(), fieldValueOutput),+});++export const dealListOutput = z.object({+ rows: z.array(dealListRowOutput),+ total: z.number(),+ facetCounts: z.record(z.string(), z.record(z.string(), z.number())),+ openValueCents: z.number().nullable(),+ reportingCurrency: z.string(),+ unconverted: z.object({+ count: z.number(),+ currencies: z.array(z.string()),+ }),+});++export type DealListResult = z.infer<typeof dealListOutput>;++export const dealDetailOutput = z.object({+ id: z.string(),+ name: z.string(),+ description: z.string().nullable(),+ stage: stageEnum,+ currency: z.string(),+ closedReason: z.string().nullable(),+ company: dealCompanyDetailOutput,+ owner: dealOwnerOutput,+ fields: z.array(recordFieldOutput),+ amountCents: z.number().nullable(),+ baseAmountCents: z.number().nullable(),+ reportingCurrency: z.string(),+ fxRate: z.number().nullable(),+ fxRateAt: z.string().nullable(),+ stageChangedAt: z.string(),+ expectedCloseDate: z.string().nullable(),+ closedAt: z.string().nullable(),+ createdAt: z.string(),+ archivedAt: z.string().nullable(),+ contacts: z.array(dealContactOutput),+});++export type DealDetail = z.infer<typeof dealDetailOutput>;++export const dealCreateOutput = z.object({+ id: z.string(),+ name: z.string(),+ companyId: z.string(),+});++export type DealCreated = z.infer<typeof dealCreateOutput>;++export const dealMutateOutput = z.object({+ id: z.string(),+ name: z.string(),+});++export type DealMutated = z.infer<typeof dealMutateOutput>;++export const dealSetStageOutput = z.object({+ id: z.string(),+ stage: stageEnum,+ changed: z.boolean(),+});++export type DealSetStageResult = z.infer<typeof dealSetStageOutput>;++export const dealContactOptionsOutput = z.array(dealContactSummaryOutput);++export type DealContactOption = z.infer<typeof dealContactSummaryOutput>;++export const dealContactLinkOutput = z.object({+ dealId: z.string(),+ contactId: z.string(),+});++export type DealContactLink = z.infer<typeof dealContactLinkOutput>;++export const dealContactRoleOutput = z.object({+ dealId: z.string(),+ contactId: z.string(),+ role: z.string().nullable(),+});++export type DealContactRoleResult = z.infer<typeof dealContactRoleOutput>;++export const dealBulkResultOutput = z.object({+ requested: z.number(),+ succeeded: z.number(),+ failed: z.number(),+ message: z.string().nullable(),+});++export type DealBulkResult = z.infer<typeof dealBulkResultOutput>;diff --git a/apps/api/src/deals/deals.router.ts b/apps/api/src/deals/deals.router.tsindex ccb3f850..8494f10a 100644--- a/apps/api/src/deals/deals.router.ts+++ b/apps/api/src/deals/deals.router.ts@@ -10,17 +10,27 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import {dealAttachContactInput,dealBulkInput,dealBulkOwnerInput,+ dealBulkResultOutput,dealBulkStageInput,+ dealContactLinkOutput,+ dealContactOptionsOutput,dealContactRoleInput,+ dealContactRoleOutput,dealContactsInput,dealCreateInput,+ dealCreateOutput,dealDetachContactInput,+ dealDetailOutput,dealIdInput,dealListInput,+ dealListOutput,+ dealMutateOutput,+ dealSetStageOutput,dealUpdateArgs,setStageInput,} from "./deals.contracts";@@ -31,32 +41,74 @@ import { DealsService } from "./deals.service";export class DealsRouter {constructor(@Inject(DealsService) private readonly deals: DealsService) {}- @Query({ input: dealListInput })+ @Query({+ input: dealListInput,+ output: dealListOutput,+ meta: restMeta("POST", "/deals/search", ["Deals"]),+ })async list(@Input() input: z.infer<typeof dealListInput>) {return this.deals.list(input);}- @Query({ input: dealIdInput })+ @Query({+ input: dealIdInput,+ output: dealDetailOutput,+ meta: restMeta("GET", "/deals/{id}", ["Deals"]),+ })async byId(@Input("id") id: string) {return this.deals.byId(id);}- @Mutation({ input: dealCreateInput })+ @Mutation({+ input: dealCreateInput,+ output: dealCreateOutput,+ meta: restMeta("POST", "/deals", ["Deals"]),+ })async create(@Input() input: z.infer<typeof dealCreateInput>) {return this.deals.create(input);}- @Mutation({ input: dealUpdateArgs })+ @Mutation({+ input: dealUpdateArgs,+ output: dealMutateOutput,+ meta: restMeta("PATCH", "/deals/{id}", ["Deals"]),+ })async update(@Input() input: z.infer<typeof dealUpdateArgs>) {return this.deals.update(input.id, input.data);}- @Mutation({ input: dealIdInput })- async delete(@Input("id") id: string) {- return this.deals.delete(id);+ @Mutation({+ input: dealIdInput,+ output: dealMutateOutput,+ meta: restMeta("POST", "/deals/{id}/archive", ["Deals"]),+ })+ async archive(@Input("id") id: string) {+ return this.deals.archive(id);}- @Mutation({ input: setStageInput })+ @Mutation({+ input: dealIdInput,+ output: dealMutateOutput,+ meta: restMeta("POST", "/deals/{id}/restore", ["Deals"]),+ })+ async restore(@Input("id") id: string) {+ return this.deals.restore(id);+ }++ @Mutation({+ input: dealIdInput,+ output: dealMutateOutput,+ meta: restMeta("DELETE", "/deals/{id}", ["Deals"]),+ })+ async purge(@Input("id") id: string) {+ return this.deals.purge(id);+ }++ @Mutation({+ input: setStageInput,+ output: dealSetStageOutput,+ meta: restMeta("PATCH", "/deals/{id}/stage", ["Deals"]),+ })async setStage(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof setStageInput>,@@ -64,32 +116,58 @@ export class DealsRouter {return this.deals.setStage(input, ctx.user.id);}- @Query({ input: dealContactsInput })+ @Query({+ input: dealContactsInput,+ output: dealContactOptionsOutput,+ meta: restMeta("GET", "/deals/{dealId}/contact-options", ["Deals"]),+ })async contactOptions(@Input("dealId") dealId: string) {return this.deals.contactOptions(dealId);}- @Mutation({ input: dealAttachContactInput })+ @Mutation({+ input: dealAttachContactInput,+ output: dealContactLinkOutput,+ meta: restMeta("POST", "/deals/{dealId}/contacts", ["Deals"]),+ })async attachContact(@Input() input: z.infer<typeof dealAttachContactInput>) {return this.deals.attachContact(input);}- @Mutation({ input: dealDetachContactInput })+ @Mutation({+ input: dealDetachContactInput,+ output: dealContactLinkOutput,+ meta: restMeta("DELETE", "/deals/{dealId}/contacts/{contactId}", ["Deals"]),+ })async detachContact(@Input() input: z.infer<typeof dealDetachContactInput>) {return this.deals.detachContact(input);}- @Mutation({ input: dealContactRoleInput })+ @Mutation({+ input: dealContactRoleInput,+ output: dealContactRoleOutput,+ meta: restMeta("PATCH", "/deals/{dealId}/contacts/{contactId}/role", [+ "Deals",+ ]),+ })async setContactRole(@Input() input: z.infer<typeof dealContactRoleInput>) {return this.deals.setContactRole(input);}- @Mutation({ input: dealBulkOwnerInput })+ @Mutation({+ input: dealBulkOwnerInput,+ output: dealBulkResultOutput,+ meta: restMeta("POST", "/deals/bulk-assign-owner", ["Deals"]),+ })async bulkAssignOwner(@Input() input: z.infer<typeof dealBulkOwnerInput>) {return this.deals.bulkAssignOwner(input);}- @Mutation({ input: dealBulkStageInput })+ @Mutation({+ input: dealBulkStageInput,+ output: dealBulkResultOutput,+ meta: restMeta("POST", "/deals/bulk-set-stage", ["Deals"]),+ })async bulkSetStage(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof dealBulkStageInput>,@@ -97,8 +175,30 @@ export class DealsRouter {return this.deals.bulkSetStage(input, ctx.user.id);}- @Mutation({ input: dealBulkInput })- async bulkDelete(@Input("ids") ids: string[]) {- return this.deals.bulkDelete(ids);+ @Mutation({+ input: dealBulkInput,+ output: dealBulkResultOutput,+ meta: restMeta("POST", "/deals/bulk-archive", ["Deals"]),+ })+ async bulkArchive(@Input("ids") ids: string[]) {+ return this.deals.bulkArchive(ids);+ }++ @Mutation({+ input: dealBulkInput,+ output: dealBulkResultOutput,+ meta: restMeta("POST", "/deals/bulk-restore", ["Deals"]),+ })+ async bulkRestore(@Input("ids") ids: string[]) {+ return this.deals.bulkRestore(ids);+ }++ @Mutation({+ input: dealBulkInput,+ output: dealBulkResultOutput,+ meta: restMeta("POST", "/deals/bulk-purge", ["Deals"]),+ })+ async bulkPurge(@Input("ids") ids: string[]) {+ return this.deals.bulkPurge(ids);}}diff --git a/apps/api/src/deals/deals.service.ts b/apps/api/src/deals/deals.service.tsindex 3f5b23d0..4a4d01c8 100644--- a/apps/api/src/deals/deals.service.ts+++ b/apps/api/src/deals/deals.service.ts@@ -12,6 +12,7 @@ import {LOSING_DEAL_STAGES,OPEN_DEAL_STAGES,} from "@crm/db/deal-stage";+import type { FieldDefinitionWithOptions } from "@crm/db/fields";import {BadRequestException,Injectable,@@ -19,6 +20,7 @@ import {NotFoundException,} from "@nestjs/common";import { AgentTriggerService } from "../agent/agent-trigger.service";+import { ARCHIVE } from "../archive/archive-config";import {ActivityStampService,type StampTargets,@@ -34,11 +36,12 @@ import { ConversionService } from "../currency/conversion.service";import { InjectDatabase } from "../database/database.constants";import { FieldsService } from "../fields/fields.service";import {+ archivedFilter,countsByKey,- FACET_ALL,FACET_UNASSIGNED,type ListResult,type OrderByColumns,+ ownerFilter,paginate,resolveOrderBy,} from "../trpc/list-input";@@ -93,6 +96,7 @@ const SORTABLE: OrderByColumns<Prisma.DealOrderByWithRelationInput[]> = {createdAt: (dir) => [{ createdAt: dir }],owner: (dir) => [{ owner: { name: dir } }, { name: "asc" }],lastActivity: (dir) => [{ lastActivityAt: { sort: dir, nulls: "last" } }],+ archivedAt: (dir) => [{ archivedAt: { sort: dir, nulls: "last" } }],};@Injectable()@@ -108,7 +112,8 @@ export class DealsService {) {}async list(input: DealListInput) {- const where = this.buildWhere(input);+ const filterableFields = await this.fields.filterableFieldsFor("DEAL");+ const where = this.buildWhere(input, filterableFields);const { skip, take } = paginate(input);const openWhere = { ...where, stage: { in: [...OPEN_DEAL_STAGES] } };@@ -134,10 +139,11 @@ export class DealsService {owner: { select: OWNER_SELECT },lastActivityAt: true,createdAt: true,+ archivedAt: true,},}),this.db.deal.count({ where }),- this.facetCounts(input),+ this.facetCounts(input, filterableFields),this.db.deal.aggregate({where: { AND: [openWhere, this.conversion.countedWhere(base)] },_sum: { baseAmount: true },@@ -159,6 +165,7 @@ export class DealsService {closedAt,lastActivityAt,createdAt,+ archivedAt,...row}) => ({...row,@@ -168,6 +175,7 @@ export class DealsService {closedAt: closedAt?.toISOString() ?? null,lastActivityAt: lastActivityAt?.toISOString() ?? null,createdAt: createdAt.toISOString(),+ archivedAt: archivedAt?.toISOString() ?? null,fields: tableFields.get(row.id) ?? {},}),),@@ -201,6 +209,7 @@ export class DealsService {closedAt: true,closedReason: true,createdAt: true,+ archivedAt: true,company: { select: { ...COMPANY_SELECT, industry: true } },owner: { select: OWNER_SELECT },contacts: {@@ -214,7 +223,15 @@ export class DealsService {throw new NotFoundException(`No deal with id ${id}.`);}- const { contacts, amount, baseAmount, fxRate, fxRateAt, ...rest } = deal;+ const {+ contacts,+ amount,+ baseAmount,+ fxRate,+ fxRateAt,+ archivedAt,+ ...rest+ } = deal;return {...rest,@@ -228,6 +245,7 @@ export class DealsService {expectedCloseDate: deal.expectedCloseDate?.toISOString() ?? null,closedAt: deal.closedAt?.toISOString() ?? null,createdAt: deal.createdAt.toISOString(),+ archivedAt: archivedAt?.toISOString() ?? null,contacts: contacts.map(({ role, contact }) => ({ ...contact, role })),};}@@ -281,6 +299,8 @@ export class DealsService {this.logger.log({ message: "Deal created", dealId: deal.id, stage });+ void this.fields.queueBackfillForNewRecord("DEAL", deal.id);+return deal;} catch (error) {throw this.translateRelations(error);@@ -350,11 +370,66 @@ export class DealsService {}}- async delete(id: string): Promise<{ id: string; name: string }> {- let deleted: { targets: StampTargets; name: string };+ async archive(id: string): Promise<{ id: string; name: string }> {+ try {+ const deal = await this.db.deal.update({+ where: { id },+ data: { archivedAt: new Date() },+ select: { name: true },+ });++ this.logger.log({ message: "Deal archived", dealId: id });++ return { id, name: deal.name };+ } catch (error) {+ throw this.translate(error, id);+ }+ }++ async restore(id: string): Promise<{ id: string; name: string }> {+ try {+ const deal = await this.db.deal.update({+ where: { id },+ data: { archivedAt: null },+ select: { name: true },+ });++ this.logger.log({ message: "Deal restored", dealId: id });++ return { id, name: deal.name };+ } catch (error) {+ throw this.translate(error, id);+ }+ }++ async purge(id: string): Promise<{ id: string; name: string }>;+ async purge(+ id: string,+ guard: { archivedBefore: Date },+ ): Promise<{ id: string; name: string } | null>;+ async purge(+ id: string,+ guard?: { archivedBefore: Date },+ ): Promise<{ id: string; name: string } | null> {+ let deleted: { targets: StampTargets; name: string } | null;try {deleted = await this.db.$transaction(async (tx) => {+ const [row] = await tx.$queryRaw<Array<{ archivedAt: Date | null }>>`+ SELECT "archivedAt" FROM deal WHERE id = ${id} FOR UPDATE+ `;++ if (!row) {+ if (guard) return null;+ throw new NotFoundException(`No deal with id ${id}.`);+ }+ if (+ guard &&+ (!row.archivedAt || row.archivedAt > guard.archivedBefore)+ ) {+ return null;+ }+const targets = await this.stamp.targetsOf({ dealId: id }, tx);await tx.agentTask.deleteMany({ where: { dealId: id } });@@ -369,10 +444,12 @@ export class DealsService {throw this.translate(error, id);}+ if (!deleted) return null;+await this.stamp.recomputeAfterDelete(deleted.targets, { dealId: id });this.logger.log({- message: "Deal deleted",+ message: "Deal purged",dealId: id,name: deleted.name,});@@ -380,6 +457,19 @@ export class DealsService {return { id, name: deleted.name };}+ async purgeExpired(before: Date): Promise<BulkResult> {+ const expired = await this.db.deal.findMany({+ where: { archivedAt: { lte: before } },+ select: { id: true },+ take: ARCHIVE.prune.maxBatch,+ });++ return runBulk(+ expired.map((row) => row.id),+ (id) => this.purge(id, { archivedBefore: before }),+ );+ }+async setStage(input: SetStageInput, actingUserId: string) {const closedReason = input.closedReason?.trim();const closed = isClosedStage(input.stage);@@ -597,6 +687,7 @@ export class DealsService {return {requested: ids.length,succeeded: count,+ skipped: 0,failed: ids.length - count,message: null,};@@ -619,8 +710,16 @@ export class DealsService {);}- async bulkDelete(ids: string[]): Promise<BulkResult> {- return runBulk(ids, (id) => this.delete(id));+ async bulkArchive(ids: string[]): Promise<BulkResult> {+ return runBulk(ids, (id) => this.archive(id));+ }++ async bulkRestore(ids: string[]): Promise<BulkResult> {+ return runBulk(ids, (id) => this.restore(id));+ }++ async bulkPurge(ids: string[]): Promise<BulkResult> {+ return runBulk(ids, (id) => this.purge(id));}private async companyOf(dealId: string) {@@ -648,39 +747,54 @@ export class DealsService {};}- private buildWhere(input: DealListInput): Prisma.DealWhereInput {- const where: Prisma.DealWhereInput = this.searchFilter(input.q);+ private buildWhere(+ input: DealListInput,+ filterableFields: FieldDefinitionWithOptions[],+ ): Prisma.DealWhereInput {+ const and: Prisma.DealWhereInput[] = [+ this.searchFilter(input.q),+ archivedFilter(input.archived),+ ...this.fields.fieldFilters(filterableFields, input.fields),+ ];- if (input.owner !== FACET_ALL) {- where.ownerId =- input.owner === FACET_UNASSIGNED ? { in: [] } : input.owner;- }+ const owner = ownerFilter<Prisma.DealWhereInput>(input.owner);+ if (owner) and.push(owner);if (input.status === "open") {- where.stage = { in: [...OPEN_DEAL_STAGES] };+ and.push({ stage: { in: [...OPEN_DEAL_STAGES] } });} else if (input.status === "closed") {- where.stage = { in: [...CLOSED_DEAL_STAGES] };+ and.push({ stage: { in: [...CLOSED_DEAL_STAGES] } });}- if (input.stage !== FACET_ALL) {- where.stage = input.stage as DealStage;+ if (input.stage.length > 0) {+ and.push({ stage: { in: input.stage as DealStage[] } });}- if (input.closing !== FACET_ALL) {- Object.assign(where, closingFilter(input.closing as ClosingWindow));+ if (input.closing.length > 0) {+ and.push({+ OR: input.closing.map((window) =>+ closingFilter(window as ClosingWindow),+ ),+ });}- return where;+ return { AND: and };}- private async facetCounts(input: DealListInput) {- const where = this.searchFilter(input.q);+ private async facetCounts(+ input: DealListInput,+ filterableFields: FieldDefinitionWithOptions[],+ ) {+ const where: Prisma.DealWhereInput = {+ AND: [this.searchFilter(input.q), archivedFilter(input.archived)],+ };- const [owners, stages, ...closingCounts] = await Promise.all([+ const [owners, stages, fieldFacets, ...closingCounts] = await Promise.all([this.db.deal.groupBy({ by: ["ownerId"], where, _count: { _all: true } }),this.db.deal.groupBy({ by: ["stage"], where, _count: { _all: true } }),+ this.fields.filterFacetCounts("DEAL", where, filterableFields),...CLOSING_WINDOWS.map((window) =>- this.db.deal.count({ where: { ...where, ...closingFilter(window) } }),+ this.db.deal.count({ where: { AND: [where, closingFilter(window)] } }),),]);@@ -704,6 +818,12 @@ export class DealsService {closingCounts[index] ?? 0,]),),+ ...Object.fromEntries(+ Object.entries(fieldFacets).map(([key, counts]) => [+ `field:${key}`,+ counts,+ ]),+ ),};}diff --git a/apps/api/src/enrichment/enrichment.router.ts b/apps/api/src/enrichment/enrichment.router.tsindex 9d1e2fae..e5e48893 100644--- a/apps/api/src/enrichment/enrichment.router.ts+++ b/apps/api/src/enrichment/enrichment.router.ts@@ -1,10 +1,54 @@import { enrichmentQueueInput } from "@crm/validation/enrichment-queue";import { Inject } from "@nestjs/common";import { Input, Query, Router, UseMiddlewares } from "nestjs-trpc";-import type { z } from "zod";+import { z } from "zod";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import { EnrichmentService } from "./enrichment.service";+const enrichmentContactSubjectOutput = z.object({+ kind: z.literal("contact"),+ id: z.string(),+ name: z.string(),+ email: z.string().nullable(),+ imageUrl: z.string().nullable(),+});++const enrichmentCompanySubjectOutput = z.object({+ kind: z.literal("company"),+ id: z.string(),+ name: z.string(),+ logoUrl: z.string().nullable(),+ logoDarkUrl: z.string().nullable(),+ logoTone: z.string().nullable(),+});++const enrichmentQueueSubjectOutput = z.discriminatedUnion("kind", [+ enrichmentContactSubjectOutput,+ enrichmentCompanySubjectOutput,+]);++const enrichmentQueueRowOutput = z.object({+ id: z.string(),+ state: z.enum(["running", "queued", "failed"]),+ line: z.string(),+ startedAt: z.string().nullable(),+ subject: enrichmentQueueSubjectOutput,+});++const enrichmentScheduledRowOutput = z.object({+ id: z.string(),+ due: z.string(),+ subject: enrichmentQueueSubjectOutput,+});++const enrichmentQueueOutput = z.object({+ rows: z.array(enrichmentQueueRowOutput),+ total: z.number(),+ scheduled: z.array(enrichmentScheduledRowOutput),+ scheduledTotal: z.number(),+});+@Router({ alias: "enrichment" })@UseMiddlewares(AuthMiddleware)export class EnrichmentRouter {@@ -12,7 +56,11 @@ export class EnrichmentRouter {@Inject(EnrichmentService) private readonly enrichment: EnrichmentService,) {}- @Query({ input: enrichmentQueueInput })+ @Query({+ input: enrichmentQueueInput,+ output: enrichmentQueueOutput,+ meta: restMeta("GET", "/enrichment/queue", ["Enrichment"]),+ })async queue(@Input() input: z.infer<typeof enrichmentQueueInput>) {return this.enrichment.queue(input.limit);}diff --git a/apps/api/src/fields/fields-config.ts b/apps/api/src/fields/fields-config.tsnew file mode 100644index 00000000..493bf998--- /dev/null+++ b/apps/api/src/fields/fields-config.ts@@ -0,0 +1,5 @@+export const FIELDS_CONFIG = {+ backfill: {+ maxRecordsPerRun: 500,+ },+} as const;diff --git a/apps/api/src/fields/fields.contracts.ts b/apps/api/src/fields/fields.contracts.tsindex babdff01..9335d355 100644--- a/apps/api/src/fields/fields.contracts.ts+++ b/apps/api/src/fields/fields.contracts.ts@@ -15,6 +15,10 @@ export const fieldByKeyInput = z.object({key: z.string().trim().min(1),});+export const fieldEntityInput = z.object({+ entity: fieldEntity,+});+const fieldOptionInput = z.object({id: z.string().optional(),label: z.string().trim().min(1, "An option needs a label."),@@ -30,6 +34,7 @@ export const fieldCreateInput = z.object({required: z.boolean().default(false),showOnSheet: z.boolean().default(true),showOnTable: z.boolean().default(false),+ showOnFilter: z.boolean().default(false),});export type FieldCreateInput = z.infer<typeof fieldCreateInput>;@@ -43,6 +48,7 @@ const fieldUpdateData = z.object({required: z.boolean().optional(),showOnSheet: z.boolean().optional(),showOnTable: z.boolean().optional(),+ showOnFilter: z.boolean().optional(),});export type FieldUpdateData = z.infer<typeof fieldUpdateData>;@@ -67,3 +73,42 @@ const recordFieldValue = z.union();export const recordFieldValues = z.record(z.string(), recordFieldValue);++const fieldOptionOutput = z.object({+ id: z.string(),+ label: z.string(),+ position: z.number(),+});++export const serializedFieldOutput = z.object({+ id: z.string(),+ entity: fieldEntity,+ key: z.string(),+ label: z.string(),+ type: z.enum(FIELD_TYPES),+ typeLabel: z.string(),+ agentFilled: z.boolean(),+ agentBrief: z.string().nullable(),+ required: z.boolean(),+ showOnSheet: z.boolean(),+ showOnTable: z.boolean(),+ showOnFilter: z.boolean(),+ position: z.number(),+ archived: z.boolean(),+ options: z.array(fieldOptionOutput),+});++export const fieldListOutput = z.array(serializedFieldOutput);++export const fieldFiltersOutput = z.array(serializedFieldOutput);++export const fieldReorderOutput = z.array(serializedFieldOutput);++export const fieldCoverageOutput = z.object({+ filled: z.number(),+ total: z.number(),+});++export const fieldDeleteOutput = z.object({ id: z.string() });++export const fieldBackfillOutput = z.object({ queued: z.boolean() });diff --git a/apps/api/src/fields/fields.router.ts b/apps/api/src/fields/fields.router.tsindex a92ae4e6..c3d4baac 100644--- a/apps/api/src/fields/fields.router.ts+++ b/apps/api/src/fields/fields.router.ts@@ -2,13 +2,22 @@ import { Inject } from "@nestjs/common";import { Input, Mutation, Query, Router, UseMiddlewares } from "nestjs-trpc";import type { z } from "zod";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import {+ fieldBackfillOutput,fieldByKeyInput,+ fieldCoverageOutput,fieldCreateInput,+ fieldDeleteOutput,+ fieldEntityInput,+ fieldFiltersOutput,fieldIdInput,fieldListInput,+ fieldListOutput,fieldReorderInput,+ fieldReorderOutput,fieldUpdateArgs,+ serializedFieldOutput,} from "./fields.contracts";import { FieldsService } from "./fields.service";@@ -17,52 +26,101 @@ import { FieldsService } from "./fields.service";export class FieldsRouter {constructor(@Inject(FieldsService) private readonly fields: FieldsService) {}- @Query({ input: fieldListInput })+ @Query({+ input: fieldListInput,+ output: fieldListOutput,+ meta: restMeta("GET", "/fields", ["Fields"]),+ })async list(@Input() input: z.infer<typeof fieldListInput>) {return this.fields.list(input.entity, input.includeArchived);}- @Query({ input: fieldByKeyInput })+ @Query({+ input: fieldByKeyInput,+ output: serializedFieldOutput,+ meta: restMeta("GET", "/fields/{entity}/{key}", ["Fields"]),+ })async byKey(@Input() input: z.infer<typeof fieldByKeyInput>) {return this.fields.byKey(input.entity, input.key);}- @Query({ input: fieldIdInput })+ @Query({+ input: fieldEntityInput,+ output: fieldFiltersOutput,+ meta: restMeta("GET", "/fields/{entity}/filterable", ["Fields"]),+ })+ async filters(@Input() input: z.infer<typeof fieldEntityInput>) {+ return this.fields.filters(input.entity);+ }++ @Query({+ input: fieldIdInput,+ output: fieldCoverageOutput,+ meta: restMeta("GET", "/fields/{id}/coverage", ["Fields"]),+ })async coverage(@Input("id") id: string) {return this.fields.coverage(id);}- @Mutation({ input: fieldCreateInput })+ @Mutation({+ input: fieldCreateInput,+ output: serializedFieldOutput,+ meta: restMeta("POST", "/fields", ["Fields"]),+ })async create(@Input() input: z.infer<typeof fieldCreateInput>) {return this.fields.create(input);}- @Mutation({ input: fieldUpdateArgs })+ @Mutation({+ input: fieldUpdateArgs,+ output: serializedFieldOutput,+ meta: restMeta("PATCH", "/fields/{id}", ["Fields"]),+ })async update(@Input() input: z.infer<typeof fieldUpdateArgs>) {return this.fields.update(input.id, input.data);}- @Mutation({ input: fieldReorderInput })+ @Mutation({+ input: fieldReorderInput,+ output: fieldReorderOutput,+ meta: restMeta("POST", "/fields/reorder", ["Fields"]),+ })async reorder(@Input() input: z.infer<typeof fieldReorderInput>) {return this.fields.reorder(input);}- @Mutation({ input: fieldIdInput })+ @Mutation({+ input: fieldIdInput,+ output: serializedFieldOutput,+ meta: restMeta("POST", "/fields/{id}/archive", ["Fields"]),+ })async archive(@Input("id") id: string) {return this.fields.archive(id);}- @Mutation({ input: fieldIdInput })+ @Mutation({+ input: fieldIdInput,+ output: serializedFieldOutput,+ meta: restMeta("POST", "/fields/{id}/restore", ["Fields"]),+ })async restore(@Input("id") id: string) {return this.fields.restore(id);}- @Mutation({ input: fieldIdInput })+ @Mutation({+ input: fieldIdInput,+ output: fieldDeleteOutput,+ meta: restMeta("DELETE", "/fields/{id}", ["Fields"]),+ })async delete(@Input("id") id: string) {return this.fields.delete(id);}- @Mutation({ input: fieldIdInput })+ @Mutation({+ input: fieldIdInput,+ output: fieldBackfillOutput,+ meta: restMeta("POST", "/fields/{id}/backfill", ["Fields"]),+ })async backfill(@Input("id") id: string) {return this.fields.backfill(id);}diff --git a/apps/api/src/fields/fields.service.ts b/apps/api/src/fields/fields.service.tsindex 0f589dfb..be1855ff 100644--- a/apps/api/src/fields/fields.service.ts+++ b/apps/api/src/fields/fields.service.ts@@ -31,11 +31,18 @@ import type {FieldReorderInput,FieldUpdateData,} from "./fields.contracts";+import { FIELDS_CONFIG } from "./fields-config";const WITH_OPTIONS = {options: { orderBy: { position: "asc" } },} as const satisfies Prisma.FieldDefinitionInclude;+const RELATIONS = {+ COMPANY: "company",+ CONTACT: "contact",+ DEAL: "deal",+} as const satisfies Record<FieldEntity, string>;+@Injectable()export class FieldsService {constructor(@@ -104,6 +111,7 @@ export class FieldsService {required: input.required,showOnSheet: input.showOnSheet,showOnTable: input.showOnTable,+ showOnFilter: input.showOnFilter,position: (last?.position ?? -1) + 1,options: usesOptions(input.type)? {@@ -118,10 +126,16 @@ export class FieldsService {});if (definition.agentFilled) {- await this.agent.fieldBackfill(+ const ids = await this.missingRecordIds(+ definition.entity,+ definition.id,+ FIELDS_CONFIG.backfill.maxRecordsPerRun,+ );+ await this.agent.fieldBackfillRecords(definition.entity,- definition.key,- "New field",+ [definition.key],+ ids,+ `New field: ${definition.label}`,);}@@ -196,6 +210,7 @@ export class FieldsService {required: data.required,showOnSheet: data.showOnSheet,showOnTable: data.showOnTable,+ showOnFilter: data.showOnFilter,},include: WITH_OPTIONS,});@@ -206,10 +221,18 @@ export class FieldsService {const turnedOn = data.agentFilled === true && !existing.agentFilled;if (definition.agentFilled && (briefChanged || turnedOn)) {- await this.agent.fieldBackfill(+ const ids = await this.missingRecordIds(definition.entity,- definition.key,- "Brief changed",+ definition.id,+ FIELDS_CONFIG.backfill.maxRecordsPerRun,+ );+ await this.agent.fieldBackfillRecords(+ definition.entity,+ [definition.key],+ ids,+ briefChanged+ ? `Brief changed: ${definition.label}`+ : `Turned on: ${definition.label}`,);}@@ -284,6 +307,7 @@ export class FieldsService {select: {entity: true,key: true,+ label: true,agentFilled: true,archivedAt: true,},@@ -297,13 +321,68 @@ export class FieldsService {);}- await this.agent.fieldBackfill(+ const ids = await this.missingRecordIds(+ definition.entity,+ id,+ FIELDS_CONFIG.backfill.maxRecordsPerRun,+ );+ const result = await this.agent.fieldBackfillRecords(definition.entity,- definition.key,+ [definition.key],+ ids,"Asked to fill the rest",);- return { queued: true };+ return { queued: result.queued > 0 || result.merged > 0 };+ }++ /** Every agent-filled field is inherently blank on a record that was just created. */+ async queueBackfillForNewRecord(+ entity: FieldEntity,+ recordId: string,+ ): Promise<void> {+ const definitions = await this.db.fieldDefinition.findMany({+ where: { entity, archivedAt: null, agentFilled: true },+ select: { key: true },+ });++ if (definitions.length === 0) return;++ await this.agent.fieldBackfillRecords(+ entity,+ definitions.map((definition) => definition.key),+ [recordId],+ "New record",+ );+ }++ private async missingRecordIds(+ entity: FieldEntity,+ fieldId: string,+ cap: number,+ ): Promise<string[]> {+ const where = { fieldValues: { none: { fieldId } } };++ const rows =+ entity === "COMPANY"+ ? await this.db.company.findMany({+ where,+ select: { id: true },+ take: cap,+ })+ : entity === "CONTACT"+ ? await this.db.contact.findMany({+ where,+ select: { id: true },+ take: cap,+ })+ : await this.db.deal.findMany({+ where,+ select: { id: true },+ take: cap,+ });++ return rows.map((row) => row.id);}async coverage(id: string): Promise<{ filled: number; total: number }> {@@ -400,6 +479,133 @@ export class FieldsService {return byRecord;}+ /**+ * SELECT and USER fields are the only types with a fixed, small+ * vocabulary a facet can count, but only the ones an admin turned on+ * (`showOnFilter`) actually render — same opt-in as `showOnTable`, so the+ * filter bar doesn't fill up with every field ever created.+ */+ async filters(entity: FieldEntity): Promise<SerializedField[]> {+ const definitions = await this.filterableFieldsFor(entity);+ return definitions.map(serializeField);+ }++ async filterableFieldsFor(+ entity: FieldEntity,+ ): Promise<FieldDefinitionWithOptions[]> {+ return this.db.fieldDefinition.findMany({+ where: {+ entity,+ archivedAt: null,+ showOnFilter: true,+ type: { in: ["SELECT", "USER"] },+ },+ include: WITH_OPTIONS,+ orderBy: { position: "asc" },+ });+ }++ /**+ * Counted by joining straight to the entity table through `FieldValue`'s+ * relation, filtered by the same search/archived condition as the rest of+ * that list's facets — never by first fetching every matching id, which+ * would not scale past a few thousand records.+ */+ async filterFacetCounts(+ entity: FieldEntity,+ relationWhere:+ | Prisma.CompanyWhereInput+ | Prisma.ContactWhereInput+ | Prisma.DealWhereInput,+ definitions: FieldDefinitionWithOptions[],+ ): Promise<Record<string, Record<string, number>>> {+ const facetCounts: Record<string, Record<string, number>> = {};+ if (definitions.length === 0) return facetCounts;++ const relation = RELATIONS[entity];+ const byId = new Map(+ definitions.map((definition) => [definition.id, definition]),+ );+ const selectIds = definitions+ .filter((definition) => definition.type === "SELECT")+ .map((definition) => definition.id);+ const userIds = definitions+ .filter((definition) => definition.type === "USER")+ .map((definition) => definition.id);++ const [selectGroups, userGroups] = await Promise.all([+ selectIds.length > 0+ ? this.db.fieldValue.groupBy({+ by: ["fieldId", "optionId"],+ where: {+ fieldId: { in: selectIds },+ optionId: { not: null },+ [relation]: relationWhere,+ } as Prisma.FieldValueWhereInput,+ _count: { _all: true },+ })+ : [],+ userIds.length > 0+ ? this.db.fieldValue.groupBy({+ by: ["fieldId", "userId"],+ where: {+ fieldId: { in: userIds },+ userId: { not: null },+ [relation]: relationWhere,+ } as Prisma.FieldValueWhereInput,+ _count: { _all: true },+ })+ : [],+ ]);++ for (const group of selectGroups) {+ const definition = byId.get(group.fieldId);+ if (!definition || !group.optionId) continue;+ const bucket = facetCounts[definition.key] ?? {};+ facetCounts[definition.key] = bucket;+ bucket[group.optionId] =+ (bucket[group.optionId] ?? 0) + group._count._all;+ }++ for (const group of userGroups) {+ const definition = byId.get(group.fieldId);+ if (!definition || !group.userId) continue;+ const bucket = facetCounts[definition.key] ?? {};+ facetCounts[definition.key] = bucket;+ bucket[group.userId] = (bucket[group.userId] ?? 0) + group._count._all;+ }++ return facetCounts;+ }++ /** Translates selected filter values (by field key) into `FieldValue` `AND` conditions. */+ fieldFilters(+ definitions: FieldDefinitionWithOptions[],+ selected: Record<string, string[]>,+ ): Array<{ fieldValues: { some: Prisma.FieldValueWhereInput } }> {+ const byKey = new Map(+ definitions.map((definition) => [definition.key, definition]),+ );++ return Object.entries(selected)+ .filter(([, values]) => values.length > 0)+ .flatMap(([key, values]) => {+ const definition = byKey.get(key);+ if (!definition) return [];++ return [+ {+ fieldValues: {+ some:+ definition.type === "USER"+ ? { fieldId: definition.id, userId: { in: values } }+ : { fieldId: definition.id, optionId: { in: values } },+ },+ },+ ];+ });+ }+async applyValues(tx: Prisma.TransactionClient,entity: FieldEntity,diff --git a/apps/api/src/generated/server.ts b/apps/api/src/generated/server.tsindex e4369caf..b77da400 100644--- a/apps/api/src/generated/server.ts+++ b/apps/api/src/generated/server.ts@@ -13,468 +13,743 @@ import { z } from "zod";const t = initTRPC.create();const publicProcedure = t.procedure;-import { timelineInput, timelineCountsInput, myTasksInput, activityCreateInput, completeInput } from "../activities/activities.contracts";-import { agentReviseInput, agentIdInput, agentSaveFileInput, agentHistoryInput, agentUpdateInput, agentDeployInput, agentRunNowInput, agentRetryRunInput, agentCancelRunInput } from "../agent/agents.contracts";-import { companyListInput, companyIdInput, companyOptionsInput, companyCreateInput, companyUpdateArgs, companyBulkOwnerInput, companyBulkInput, setPrimaryContactInput } from "../companies/companies.contracts";-import { contactListInput, contactIdInput, contactCreateInput, contactUpdateArgs, contactBulkOwnerInput, contactBulkCompanyInput, contactBulkInput, factDecisionInput } from "../contacts/contacts.contracts";-import { conversationListInput, builderResourceSearchInput, conversationIdInput, conversationEventsInput, conversationSaveInput, builderConversationCreateInput, builderConversationSubmitInput, builderQuestionResponseInput, builderResponseRatingInput, sharedConversationInput } from "../conversations/conversations.contracts";-import { setReportingCurrencyInput, setManualRateInput, removeManualRateInput } from "../currency/currency.contracts";-import { dashboardSummaryInput } from "../dashboard/dashboard.contracts";-import { dealListInput, dealIdInput, dealCreateInput, dealUpdateArgs, setStageInput, dealContactsInput, dealAttachContactInput, dealDetachContactInput, dealContactRoleInput, dealBulkOwnerInput, dealBulkStageInput, dealBulkInput } from "../deals/deals.contracts";+import { timelineInput, timelineOutput, timelineCountsInput, timelineCountsOutput, myTasksInput, myTasksOutput, activityCreateInput, activityCreateOutput, completeInput, completeOutput } from "../activities/activities.contracts";+import { agentListOutput, agentReviseInput, agentReviseOutput, agentIdInput, agentFilesOutput, agentSaveFileInput, agentSaveFileOutput, agentByIdOutput, agentHistoryInput, agentHistoryOutput, agentActivityOutput, agentUpdateInput, agentUpdateOutput, agentDeployInput, agentDeployOutput, agentPauseOutput, agentResumeOutput, agentArchiveOutput, agentRestoreOutput, agentRemoveOutput, agentRunNowInput, agentRunNowOutput, agentRetryRunInput, agentRetryRunOutput, agentCancelRunInput, agentCancelRunOutput } from "../agent/agents.contracts";+import { apiKeyListInput, apiKeyListOutput, createApiKeyInput, createApiKeyOutput, revokeApiKeyInput, revokeApiKeyOutput } from "../api-keys/api-keys.contracts";+import { companyListInput, companyListOutput, companyIdInput, companyDetailOutput, companyOptionsInput, companyOptionOutput, companyCreateInput, companySummaryOutput, companyUpdateArgs, companyArchiveResultOutput, companyBulkOwnerInput, companyBulkResultOutput, companyBulkInput, companyEnrichOutput, companyResearchOutput, setPrimaryContactInput, companySetPrimaryContactOutput } from "../companies/companies.contracts";+import { contactListInput, contactListOutput, contactIdInput, contactByIdOutput, contactCreateInput, contactBasicOutput, contactUpdateArgs, contactNameOutput, contactEnrichOutput, contactBulkOwnerInput, bulkResultOutput, contactBulkCompanyInput, contactBulkInput, factDecisionInput, decideFactOutput } from "../contacts/contacts.contracts";+import { conversationListInput, conversationListOutput, builderListOutput, builderResourceSearchInput, builderResourcesOutput, conversationIdInput, builderConversationDetailOutput, conversationEventsInput, conversationEventsOutput, conversationSaveInput, conversationIdOutput, builderConversationCreateInput, builderConversationSubmitInput, builderQuestionResponseInput, builderResponseRatingInput, builderResponseRatingOutput, conversationShareStatusOutput, conversationShareTokenOutput, sharedConversationInput, sharedConversationOutput } from "../conversations/conversations.contracts";+import { currencySettingsOutput, setReportingCurrencyInput, setManualRateInput, removeManualRateInput } from "../currency/currency.contracts";+import { dashboardSummaryInput, dashboardSummaryOutput } from "../dashboard/dashboard.contracts";+import { dealListInput, dealListOutput, dealIdInput, dealDetailOutput, dealCreateInput, dealCreateOutput, dealUpdateArgs, dealMutateOutput, setStageInput, dealSetStageOutput, dealContactsInput, dealContactOptionsOutput, dealAttachContactInput, dealContactLinkOutput, dealDetachContactInput, dealContactRoleInput, dealContactRoleOutput, dealBulkOwnerInput, dealBulkResultOutput, dealBulkStageInput, dealBulkInput } from "../deals/deals.contracts";import { enrichmentQueueInput } from "@crm/validation/enrichment-queue";-import { fieldListInput, fieldByKeyInput, fieldIdInput, fieldCreateInput, fieldUpdateArgs, fieldReorderInput } from "../fields/fields.contracts";-import { setAutoCreateInput, suppressDomainInput, threadInput, calendarEventInput } from "../google/google.contracts";-import { setOutlookAutoCreateInput } from "../microsoft/microsoft.contracts";-import { setAgentModelInput, setResearchKeyInput } from "../settings/settings.contracts";-import { slackChannelsInput, slackJoinChannelInput, slackCreateChannelInput } from "../slack/slack.contracts";-import { ssoProviderListInput, registerSsoProviderInput, deleteSsoProviderInput } from "../sso/sso.contracts";-import { trackingFlagInput, cookieLifetimeInput, addDomainInput, removeDomainInput, verifyInput, companyActivityInput, contactActivityInput } from "../tracking/tracking.contracts";-import { memberListInput, updateWorkspaceInput, setMemberRoleInput } from "../workspace/workspace.contracts";-import type { ActivitiesRouter } from "../activities/activities.router";-import type { AgentsRouter } from "../agent/agents.router";-import type { CompaniesRouter } from "../companies/companies.router";-import type { ContactsRouter } from "../contacts/contacts.router";-import type { ConversationsRouter } from "../conversations/conversations.router";-import type { CurrencyRouter } from "../currency/currency.router";-import type { DashboardRouter } from "../dashboard/dashboard.router";-import type { DealsRouter } from "../deals/deals.router";-import type { EnrichmentRouter } from "../enrichment/enrichment.router";-import type { FieldsRouter } from "../fields/fields.router";-import type { GoogleRouter } from "../google/google.router";-import type { MicrosoftRouter } from "../microsoft/microsoft.router";-import type { SearchRouter } from "../search/search.router";-import type { SettingsRouter } from "../settings/settings.router";-import type { SlackRouter } from "../slack/slack.router";-import type { SsoRouter } from "../sso/sso.router";-import type { TrackingRouter } from "../tracking/tracking.router";+import { fieldListInput, fieldListOutput, fieldByKeyInput, serializedFieldOutput, fieldEntityInput, fieldFiltersOutput, fieldIdInput, fieldCoverageOutput, fieldCreateInput, fieldUpdateArgs, fieldReorderInput, fieldReorderOutput, fieldDeleteOutput, fieldBackfillOutput } from "../fields/fields.contracts";+import { googleConnectionStatusOutput, setAutoCreateInput, suppressDomainInput, suppressDomainOutput, threadInput, emailThreadOutput, calendarEventInput, calendarEventOutput } from "../google/google.contracts";+import { purgeSyncedDataOutput, revokeAccessOutput, microsoftConnectionStatusOutput, setOutlookAutoCreateInput } from "../microsoft/microsoft.contracts";+import { savedViewListInput, savedViewListOutput, savedViewCreateInput, savedViewOutput, savedViewUpdateArgs, savedViewIdInput, savedViewDeleteOutput } from "../saved-views/saved-views.contracts";+import { agentModelOutput, modelCatalogOutput, setAgentModelInput, researchKeyOutput, setResearchKeyInput, archiveRetentionOutput, setArchiveRetentionDaysInput } from "../settings/settings.contracts";+import { slackStatusOutput, slackMatchesOutput, slackChannelsInput, slackChannelsOutput, slackJoinChannelInput, slackJoinChannelOutput, slackRefreshPeopleOutput, slackCreateChannelInput, slackCreateChannelOutput, slackDisconnectOutput } from "../slack/slack.contracts";+import { ssoSignInOptionsOutput, ssoSettingsOutput, ssoProviderListInput, ssoProviderListOutput, registerSsoProviderInput, ssoProviderOutput, deleteSsoProviderInput, deleteSsoProviderOutput } from "../sso/sso.contracts";+import { trackingSettingsOutput, trackingFlagInput, cookieLifetimeInput, addDomainInput, trackedDomainOutput, removeDomainInput, rotateSiteIdOutput, verifyInput, verifyOutput, sourcesOutput, companyActivityInput, websiteActivityOutput, contactActivityInput } from "../tracking/tracking.contracts";+import { workspaceOutput, memberListInput, memberListOutput, updateWorkspaceInput, setMemberRoleInput, workspaceMemberOutput } from "../workspace/workspace.contracts";import type { UsersRouter } from "../users/users.router";-import type { WorkspaceRouter } from "../workspace/workspace.router";const appRouter = t.router({activities: t.router({timeline: publicProcedure.input(timelineInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ActivitiesRouter["timeline"]>>),+ .output(timelineOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),timelineCounts: publicProcedure.input(timelineCountsInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ActivitiesRouter["timelineCounts"]>>),+ .output(timelineCountsOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),myTasks: publicProcedure.input(myTasksInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ActivitiesRouter["myTasks"]>>),+ .output(myTasksOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),create: publicProcedure.input(activityCreateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ActivitiesRouter["create"]>>),+ .output(activityCreateOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),complete: publicProcedure.input(completeInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ActivitiesRouter["complete"]>>)+ .output(completeOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),agents: t.router({list: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["list"]>>),+ .output(agentListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),revise: publicProcedure.input(agentReviseInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["revise"]>>),+ .output(agentReviseOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),files: publicProcedure.input(agentIdInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["files"]>>),+ .output(agentFilesOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),saveFile: publicProcedure.input(agentSaveFileInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["saveFile"]>>),+ .output(agentSaveFileOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),byId: publicProcedure.input(agentIdInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["byId"]>>),+ .output(agentByIdOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),history: publicProcedure.input(agentHistoryInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["history"]>>),+ .output(agentHistoryOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),activity: publicProcedure.input(agentHistoryInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["activity"]>>),+ .output(agentActivityOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),update: publicProcedure.input(agentUpdateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["update"]>>),+ .output(agentUpdateOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),deploy: publicProcedure.input(agentDeployInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["deploy"]>>),+ .output(agentDeployOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),pause: publicProcedure.input(agentIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["pause"]>>),+ .output(agentPauseOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),resume: publicProcedure.input(agentIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["resume"]>>),+ .output(agentResumeOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),archive: publicProcedure.input(agentIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["archive"]>>),+ .output(agentArchiveOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),restore: publicProcedure.input(agentIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["restore"]>>),+ .output(agentRestoreOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),remove: publicProcedure.input(agentIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["remove"]>>),+ .output(agentRemoveOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),runNow: publicProcedure.input(agentRunNowInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["runNow"]>>),+ .output(agentRunNowOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),retryRun: publicProcedure.input(agentRetryRunInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["retryRun"]>>),+ .output(agentRetryRunOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),cancelRun: publicProcedure.input(agentCancelRunInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<AgentsRouter["cancelRun"]>>)+ .output(agentCancelRunOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)+ }),+ apiKeys: t.router({+ list: publicProcedure+ .input(apiKeyListInput)+ .output(apiKeyListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ create: publicProcedure+ .input(createApiKeyInput)+ .output(createApiKeyOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ revoke: publicProcedure+ .input(revokeApiKeyInput)+ .output(revokeApiKeyOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),companies: t.router({list: publicProcedure.input(companyListInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["list"]>>),+ .output(companyListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),byId: publicProcedure.input(companyIdInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["byId"]>>),+ .output(companyDetailOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),options: publicProcedure.input(companyOptionsInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["options"]>>),+ .output(companyOptionOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),create: publicProcedure.input(companyCreateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["create"]>>),+ .output(companySummaryOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),update: publicProcedure.input(companyUpdateArgs)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["update"]>>),- delete: publicProcedure+ .output(companySummaryOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ archive: publicProcedure+ .input(companyIdInput)+ .output(companyArchiveResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ restore: publicProcedure+ .input(companyIdInput)+ .output(companyArchiveResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ purge: publicProcedure.input(companyIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["delete"]>>),+ .output(companyArchiveResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),bulkAssignOwner: publicProcedure.input(companyBulkOwnerInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["bulkAssignOwner"]>>),+ .output(companyBulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),bulkEnrich: publicProcedure.input(companyBulkInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["bulkEnrich"]>>),- bulkDelete: publicProcedure+ .output(companyBulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ bulkArchive: publicProcedure.input(companyBulkInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["bulkDelete"]>>),+ .output(companyBulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ bulkRestore: publicProcedure+ .input(companyBulkInput)+ .output(companyBulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ bulkPurge: publicProcedure+ .input(companyBulkInput)+ .output(companyBulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),enrich: publicProcedure.input(companyIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["enrich"]>>),+ .output(companyEnrichOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),research: publicProcedure.input(companyIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["research"]>>),+ .output(companyResearchOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setPrimaryContact: publicProcedure.input(setPrimaryContactInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CompaniesRouter["setPrimaryContact"]>>)+ .output(companySetPrimaryContactOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),contacts: t.router({list: publicProcedure.input(contactListInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["list"]>>),+ .output(contactListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),byId: publicProcedure.input(contactIdInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["byId"]>>),+ .output(contactByIdOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),create: publicProcedure.input(contactCreateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["create"]>>),+ .output(contactBasicOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),update: publicProcedure.input(contactUpdateArgs)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["update"]>>),- delete: publicProcedure+ .output(contactBasicOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ archive: publicProcedure+ .input(contactIdInput)+ .output(contactNameOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ restore: publicProcedure+ .input(contactIdInput)+ .output(contactNameOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ purge: publicProcedure.input(contactIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["delete"]>>),+ .output(contactNameOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),enrich: publicProcedure.input(contactIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["enrich"]>>),+ .output(contactEnrichOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),bulkAssignOwner: publicProcedure.input(contactBulkOwnerInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["bulkAssignOwner"]>>),+ .output(bulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),bulkSetCompany: publicProcedure.input(contactBulkCompanyInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["bulkSetCompany"]>>),+ .output(bulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),bulkEnrich: publicProcedure.input(contactBulkInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["bulkEnrich"]>>),- bulkDelete: publicProcedure+ .output(bulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ bulkArchive: publicProcedure.input(contactBulkInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["bulkDelete"]>>),+ .output(bulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ bulkRestore: publicProcedure+ .input(contactBulkInput)+ .output(bulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ bulkPurge: publicProcedure+ .input(contactBulkInput)+ .output(bulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),decideFact: publicProcedure.input(factDecisionInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ContactsRouter["decideFact"]>>)+ .output(decideFactOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),conversations: t.router({list: publicProcedure.input(conversationListInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["list"]>>),+ .output(conversationListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),builderList: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["builderList"]>>),+ .output(builderListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),builderResources: publicProcedure.input(builderResourceSearchInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["builderResources"]>>),+ .output(builderResourcesOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),builderById: publicProcedure.input(conversationIdInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["builderById"]>>),+ .output(builderConversationDetailOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),events: publicProcedure.input(conversationEventsInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["events"]>>),+ .output(conversationEventsOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),save: publicProcedure.input(conversationSaveInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["save"]>>),+ .output(conversationIdOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),createBuilder: publicProcedure.input(builderConversationCreateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["createBuilder"]>>),+ .output(conversationIdOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),submitBuilder: publicProcedure.input(builderConversationSubmitInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["submitBuilder"]>>),+ .output(conversationIdOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),answerBuilderQuestion: publicProcedure.input(builderQuestionResponseInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["answerBuilderQuestion"]>>),+ .output(conversationIdOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),rateBuilderResponse: publicProcedure.input(builderResponseRatingInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["rateBuilderResponse"]>>),+ .output(builderResponseRatingOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),markRead: publicProcedure.input(conversationIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["markRead"]>>),+ .output(conversationIdOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),shareStatus: publicProcedure.input(conversationIdInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["shareStatus"]>>),+ .output(conversationShareStatusOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),createShare: publicProcedure.input(conversationIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["createShare"]>>),+ .output(conversationShareTokenOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),revokeShare: publicProcedure.input(conversationIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["revokeShare"]>>),+ .output(conversationIdOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),shared: publicProcedure.input(sharedConversationInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["shared"]>>),+ .output(sharedConversationOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),remove: publicProcedure.input(conversationIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<ConversationsRouter["remove"]>>)+ .output(conversationIdOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),currency: t.router({settings: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CurrencyRouter["settings"]>>),+ .output(currencySettingsOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setReportingCurrency: publicProcedure.input(setReportingCurrencyInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CurrencyRouter["setReportingCurrency"]>>),+ .output(currencySettingsOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setManualRate: publicProcedure.input(setManualRateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CurrencyRouter["setManualRate"]>>),+ .output(currencySettingsOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),removeManualRate: publicProcedure.input(removeManualRateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CurrencyRouter["removeManualRate"]>>),+ .output(currencySettingsOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),refreshRates: publicProcedure- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<CurrencyRouter["refreshRates"]>>)+ .output(currencySettingsOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),dashboard: t.router({summary: publicProcedure.input(dashboardSummaryInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DashboardRouter["summary"]>>)+ .output(dashboardSummaryOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),deals: t.router({list: publicProcedure.input(dealListInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["list"]>>),+ .output(dealListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),byId: publicProcedure.input(dealIdInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["byId"]>>),+ .output(dealDetailOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),create: publicProcedure.input(dealCreateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["create"]>>),+ .output(dealCreateOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),update: publicProcedure.input(dealUpdateArgs)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["update"]>>),- delete: publicProcedure+ .output(dealMutateOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ archive: publicProcedure+ .input(dealIdInput)+ .output(dealMutateOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ restore: publicProcedure+ .input(dealIdInput)+ .output(dealMutateOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ purge: publicProcedure.input(dealIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["delete"]>>),+ .output(dealMutateOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setStage: publicProcedure.input(setStageInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["setStage"]>>),+ .output(dealSetStageOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),contactOptions: publicProcedure.input(dealContactsInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["contactOptions"]>>),+ .output(dealContactOptionsOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),attachContact: publicProcedure.input(dealAttachContactInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["attachContact"]>>),+ .output(dealContactLinkOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),detachContact: publicProcedure.input(dealDetachContactInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["detachContact"]>>),+ .output(dealContactLinkOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setContactRole: publicProcedure.input(dealContactRoleInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["setContactRole"]>>),+ .output(dealContactRoleOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),bulkAssignOwner: publicProcedure.input(dealBulkOwnerInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["bulkAssignOwner"]>>),+ .output(dealBulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),bulkSetStage: publicProcedure.input(dealBulkStageInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["bulkSetStage"]>>),- bulkDelete: publicProcedure+ .output(dealBulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ bulkArchive: publicProcedure.input(dealBulkInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<DealsRouter["bulkDelete"]>>)+ .output(dealBulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ bulkRestore: publicProcedure+ .input(dealBulkInput)+ .output(dealBulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ bulkPurge: publicProcedure+ .input(dealBulkInput)+ .output(dealBulkResultOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),enrichment: t.router({queue: publicProcedure.input(enrichmentQueueInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<EnrichmentRouter["queue"]>>)+ .output(z.object({+ rows: z.array(z.object({+ id: z.string(),+ state: z.enum(["running", "queued", "failed"]),+ line: z.string(),+ startedAt: z.string().nullable(),+ subject: z.discriminatedUnion("kind", [+ z.object({+ kind: z.literal("contact"),+ id: z.string(),+ name: z.string(),+ email: z.string().nullable(),+ imageUrl: z.string().nullable(),+}),+ z.object({+ kind: z.literal("company"),+ id: z.string(),+ name: z.string(),+ logoUrl: z.string().nullable(),+ logoDarkUrl: z.string().nullable(),+ logoTone: z.string().nullable(),+}),+]),+})),+ total: z.number(),+ scheduled: z.array(z.object({+ id: z.string(),+ due: z.string(),+ subject: z.discriminatedUnion("kind", [+ z.object({+ kind: z.literal("contact"),+ id: z.string(),+ name: z.string(),+ email: z.string().nullable(),+ imageUrl: z.string().nullable(),+}),+ z.object({+ kind: z.literal("company"),+ id: z.string(),+ name: z.string(),+ logoUrl: z.string().nullable(),+ logoDarkUrl: z.string().nullable(),+ logoTone: z.string().nullable(),+}),+]),+})),+ scheduledTotal: z.number(),+}))+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),fields: t.router({list: publicProcedure.input(fieldListInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<FieldsRouter["list"]>>),+ .output(fieldListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),byKey: publicProcedure.input(fieldByKeyInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<FieldsRouter["byKey"]>>),+ .output(serializedFieldOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ filters: publicProcedure+ .input(fieldEntityInput)+ .output(fieldFiltersOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),coverage: publicProcedure.input(fieldIdInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<FieldsRouter["coverage"]>>),+ .output(fieldCoverageOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),create: publicProcedure.input(fieldCreateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<FieldsRouter["create"]>>),+ .output(serializedFieldOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),update: publicProcedure.input(fieldUpdateArgs)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<FieldsRouter["update"]>>),+ .output(serializedFieldOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),reorder: publicProcedure.input(fieldReorderInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<FieldsRouter["reorder"]>>),+ .output(fieldReorderOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),archive: publicProcedure.input(fieldIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<FieldsRouter["archive"]>>),+ .output(serializedFieldOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),restore: publicProcedure.input(fieldIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<FieldsRouter["restore"]>>),+ .output(serializedFieldOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),delete: publicProcedure.input(fieldIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<FieldsRouter["delete"]>>),+ .output(fieldDeleteOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),backfill: publicProcedure.input(fieldIdInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<FieldsRouter["backfill"]>>)+ .output(fieldBackfillOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),google: t.router({status: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<GoogleRouter["status"]>>),+ .output(googleConnectionStatusOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),purgeSyncedData: publicProcedure- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<GoogleRouter["purgeSyncedData"]>>),+ .output(purgeSyncedDataOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),revokeAccess: publicProcedure- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<GoogleRouter["revokeAccess"]>>),+ .output(revokeAccessOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),syncNow: publicProcedure- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<GoogleRouter["syncNow"]>>),+ .output(googleConnectionStatusOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setAutoCreate: publicProcedure.input(setAutoCreateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<GoogleRouter["setAutoCreate"]>>),+ .output(googleConnectionStatusOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),suppressDomain: publicProcedure.input(suppressDomainInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<GoogleRouter["suppressDomain"]>>),+ .output(suppressDomainOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),thread: publicProcedure.input(threadInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<GoogleRouter["thread"]>>),+ .output(emailThreadOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),event: publicProcedure.input(calendarEventInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<GoogleRouter["event"]>>)+ .output(calendarEventOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),microsoft: t.router({status: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<MicrosoftRouter["status"]>>),+ .output(microsoftConnectionStatusOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),purgeSyncedData: publicProcedure- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<MicrosoftRouter["purgeSyncedData"]>>),+ .output(purgeSyncedDataOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),revokeAccess: publicProcedure- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<MicrosoftRouter["revokeAccess"]>>),+ .output(revokeAccessOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),syncNow: publicProcedure- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<MicrosoftRouter["syncNow"]>>),+ .output(microsoftConnectionStatusOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setAutoCreate: publicProcedure.input(setOutlookAutoCreateInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<MicrosoftRouter["setAutoCreate"]>>)+ .output(microsoftConnectionStatusOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)+ }),+ savedViews: t.router({+ list: publicProcedure+ .input(savedViewListInput)+ .output(savedViewListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ create: publicProcedure+ .input(savedViewCreateInput)+ .output(savedViewOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ update: publicProcedure+ .input(savedViewUpdateArgs)+ .output(savedViewOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ delete: publicProcedure+ .input(savedViewIdInput)+ .output(savedViewDeleteOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),search: t.router({quick: publicProcedure.input(z.object({ q: z.string().default("") }))- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SearchRouter["quick"]>>)+ .output(z.object({ hits: z.array(z.object({+ kind: z.enum(["company", "contact", "deal"]),+ id: z.string(),+ label: z.string(),+ detail: z.string().nullable(),+ iconUrl: z.string().nullable(),+ iconDarkUrl: z.string().nullable(),+ iconTone: z.string().nullable(),+ imageUrl: z.string().nullable(),+})) }))+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),settings: t.router({agentModel: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SettingsRouter["agentModel"]>>),+ .output(agentModelOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),modelCatalog: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SettingsRouter["modelCatalog"]>>),+ .output(modelCatalogOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setAgentModel: publicProcedure.input(setAgentModelInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SettingsRouter["setAgentModel"]>>),+ .output(agentModelOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),researchKey: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SettingsRouter["researchKey"]>>),+ .output(researchKeyOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setResearchKey: publicProcedure.input(setResearchKeyInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SettingsRouter["setResearchKey"]>>)+ .output(researchKeyOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ archiveRetention: publicProcedure+ .output(archiveRetentionOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),+ setArchiveRetention: publicProcedure+ .input(setArchiveRetentionDaysInput)+ .output(archiveRetentionOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),slack: t.router({status: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SlackRouter["status"]>>),+ .output(slackStatusOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),matches: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SlackRouter["matches"]>>),+ .output(slackMatchesOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),channels: publicProcedure.input(slackChannelsInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SlackRouter["channels"]>>),+ .output(slackChannelsOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),joinChannel: publicProcedure.input(slackJoinChannelInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SlackRouter["joinChannel"]>>),+ .output(slackJoinChannelOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),refreshPeople: publicProcedure- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SlackRouter["refreshPeople"]>>),+ .output(slackRefreshPeopleOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),createChannel: publicProcedure.input(slackCreateChannelInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SlackRouter["createChannel"]>>),+ .output(slackCreateChannelOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),disconnect: publicProcedure- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SlackRouter["disconnect"]>>)+ .output(slackDisconnectOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),sso: t.router({signInOptions: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SsoRouter["signInOptions"]>>),+ .output(ssoSignInOptionsOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),settings: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SsoRouter["settings"]>>),+ .output(ssoSettingsOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),list: publicProcedure.input(ssoProviderListInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SsoRouter["list"]>>),+ .output(ssoProviderListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),register: publicProcedure.input(registerSsoProviderInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SsoRouter["register"]>>),+ .output(ssoProviderOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),remove: publicProcedure.input(deleteSsoProviderInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<SsoRouter["remove"]>>)+ .output(deleteSsoProviderOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),tracking: t.router({settings: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<TrackingRouter["settings"]>>),+ .output(trackingSettingsOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setFlag: publicProcedure.input(trackingFlagInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<TrackingRouter["setFlag"]>>),+ .output(z.void())+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setCookieLifetime: publicProcedure.input(cookieLifetimeInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<TrackingRouter["setCookieLifetime"]>>),+ .output(z.void())+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),addDomain: publicProcedure.input(addDomainInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<TrackingRouter["addDomain"]>>),+ .output(trackedDomainOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),removeDomain: publicProcedure.input(removeDomainInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<TrackingRouter["removeDomain"]>>),+ .output(z.void())+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),rotateSiteId: publicProcedure- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<TrackingRouter["rotateSiteId"]>>),+ .output(rotateSiteIdOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),verify: publicProcedure.input(verifyInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<TrackingRouter["verify"]>>),+ .output(verifyOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),sources: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<TrackingRouter["sources"]>>),+ .output(sourcesOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),companyActivity: publicProcedure.input(companyActivityInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<TrackingRouter["companyActivity"]>>),+ .output(websiteActivityOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),contactActivity: publicProcedure.input(contactActivityInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<TrackingRouter["contactActivity"]>>)+ .output(websiteActivityOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),users: t.router({me: publicProcedure.query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<UsersRouter["me"]>>),list: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<UsersRouter["list"]>>)+ .output(z.array(+ z.object({+ id: z.string(),+ name: z.string(),+ email: z.string(),+ image: z.string().nullable(),+ }),+))+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)}),workspace: t.router({get: publicProcedure- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<WorkspaceRouter["get"]>>),+ .output(workspaceOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),members: publicProcedure.input(memberListInput)- .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<WorkspaceRouter["members"]>>),+ .output(memberListOutput)+ .query(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),update: publicProcedure.input(updateWorkspaceInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<WorkspaceRouter["update"]>>),+ .output(workspaceOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any),setMemberRole: publicProcedure.input(setMemberRoleInput)- .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as unknown as Awaited<ReturnType<WorkspaceRouter["setMemberRole"]>>)+ .output(workspaceMemberOutput)+ .mutation(async () => "PLACEHOLDER_DO_NOT_REMOVE" as any)})});diff --git a/apps/api/src/google/google-connection.service.ts b/apps/api/src/google/google-connection.service.tsindex 86c0d362..7c583b8e 100644--- a/apps/api/src/google/google-connection.service.ts+++ b/apps/api/src/google/google-connection.service.ts@@ -1,5 +1,5 @@import { isGoogleConfigured, signsInWithGoogle } from "@crm/auth";-import { type Db, GoogleSyncStatus, type Prisma } from "@crm/db";+import type { Db, Prisma } from "@crm/db";import { Injectable, Logger, NotFoundException } from "@nestjs/common";import { normalizeDomain } from "../companies/domain";import { ActivityStampService } from "../crm/activity-stamp.service";@@ -13,26 +13,16 @@ import {type GoogleSyncSource,SCOPE_FOR_SOURCE,} from "./google.constants";+import type {+ GoogleConnectionStatus,+ GoogleSourceStatus,+ PurgeSyncedDataOutput,+ RevokeAccessOutput,+ SuppressDomainOutput,+} from "./google.contracts";const PURGE_TIMEOUT_MS = 60_000;-export type SourceStatus = {- source: GoogleSyncSource;- connected: boolean;- status: GoogleSyncStatus | null;- lastSyncedAt: string | null;- lastError: string | null;- autoCreate: boolean;-};--export type ConnectionStatus = {- configured: boolean;- linked: boolean;- required: boolean;- hasRefreshToken: boolean;- sources: SourceStatus[];-};-@Injectable()export class GoogleConnectionService {private readonly logger = new Logger(GoogleConnectionService.name);@@ -45,7 +35,7 @@ export class GoogleConnectionService {private readonly stamp: ActivityStampService,) {}- async status(userId: string): Promise<ConnectionStatus> {+ async status(userId: string): Promise<GoogleConnectionStatus> {await this.onConnected(userId);const [granted, rows, hasRefreshToken, accounts] = await Promise.all([@@ -57,7 +47,7 @@ export class GoogleConnectionService {const bySource = new Map(rows.map((row) => [row.source, row]));- const sources = GOOGLE_SYNC_SOURCES.map((source): SourceStatus => {+ const sources = GOOGLE_SYNC_SOURCES.map((source): GoogleSourceStatus => {const row = bySource.get(source);const connected = granted.has(SCOPE_FOR_SOURCE[source]);@@ -124,7 +114,7 @@ export class GoogleConnectionService {}}- async purgeSyncedData(userId: string): Promise<{ purged: number }> {+ async purgeSyncedData(userId: string): Promise<PurgeSyncedDataOutput> {const mine: Prisma.EmailMessageWhereInput = {syncedByUserId: userId,gmailMessageId: { not: null },@@ -163,7 +153,7 @@ export class GoogleConnectionService {return { purged };}- async revoke(userId: string): Promise<{ revoked: boolean }> {+ async revoke(userId: string): Promise<RevokeAccessOutput> {for (const source of GOOGLE_SYNC_SOURCES) {await this.state.remove(userId, source);}@@ -188,7 +178,7 @@ export class GoogleConnectionService {async suppressDomain(domain: string,options: { reason?: string; purge: boolean },- ): Promise<{ domain: string; purged: number }> {+ ): Promise<SuppressDomainOutput> {const normalised = normalizeDomain(domain);if (!normalised) {throw new NotFoundException(`"${domain}" is not a domain.`);diff --git a/apps/api/src/google/google.contracts.ts b/apps/api/src/google/google.contracts.tsindex 672ac71b..4aea716d 100644--- a/apps/api/src/google/google.contracts.ts+++ b/apps/api/src/google/google.contracts.ts@@ -1,3 +1,4 @@+import { EmailDirection, GoogleSyncStatus } from "@crm/db";import { z } from "zod";import { GOOGLE_SYNC_SOURCES } from "./google.constants";@@ -22,3 +23,133 @@ export const calendarEventInput = z.object({export type SetAutoCreateInput = z.infer<typeof setAutoCreateInput>;export type SuppressDomainInput = z.infer<typeof suppressDomainInput>;++const googleSyncStatusOutput = z.enum(+ Object.values(GoogleSyncStatus) as [GoogleSyncStatus, ...GoogleSyncStatus[]],+);++export const googleSourceStatusOutput = z.object({+ source: z.enum(GOOGLE_SYNC_SOURCES),+ connected: z.boolean(),+ status: googleSyncStatusOutput.nullable(),+ lastSyncedAt: z.string().nullable(),+ lastError: z.string().nullable(),+ autoCreate: z.boolean(),+});++export const googleConnectionStatusOutput = z.object({+ configured: z.boolean(),+ linked: z.boolean(),+ required: z.boolean(),+ hasRefreshToken: z.boolean(),+ sources: z.array(googleSourceStatusOutput),+});++export const purgeSyncedDataOutput = z.object({+ purged: z.number(),+});++export const revokeAccessOutput = z.object({+ revoked: z.boolean(),+});++export const suppressDomainOutput = z.object({+ domain: z.string(),+ purged: z.number(),+});++const emailThreadCompanyOutput = z.object({+ id: z.string(),+ name: z.string(),+});++const emailThreadContactOutput = z.object({+ id: z.string(),+ firstName: z.string(),+ lastName: z.string().nullable(),+});++const emailThreadRecipientOutput = z.object({+ email: z.string(),+ name: z.string().nullable(),+ kind: z.string(),+});++const emailDirectionOutput = z.enum(+ Object.values(EmailDirection) as [EmailDirection, ...EmailDirection[]],+);++const emailThreadMessageOutput = z.object({+ id: z.string(),+ direction: emailDirectionOutput,+ fromEmail: z.string(),+ fromName: z.string().nullable(),+ recipients: z.array(emailThreadRecipientOutput),+ subject: z.string().nullable(),+ body: z.string().nullable(),+ snippet: z.string().nullable(),+ sentAt: z.string(),+ gmailMessageId: z.string().nullable(),+ outlookWebLink: z.string().nullable(),+ fromImageUrl: z.string().nullable(),+ mailboxUrl: z.string().nullable(),+ mailboxName: z.string().nullable(),+});++export const emailThreadOutput = z.object({+ id: z.string(),+ subject: z.string().nullable(),+ messageCount: z.number(),+ firstMessageAt: z.string(),+ lastMessageAt: z.string(),+ company: emailThreadCompanyOutput.nullable(),+ contact: emailThreadContactOutput.nullable(),+ messages: z.array(emailThreadMessageOutput),+});++const calendarEventCompanyOutput = z.object({+ id: z.string(),+ name: z.string(),+});++const calendarEventContactOutput = z.object({+ id: z.string(),+ firstName: z.string(),+ lastName: z.string().nullable(),+});++const calendarAttendeeOutput = z.object({+ id: z.string(),+ email: z.string(),+ name: z.string().nullable(),+ responseStatus: z.string().nullable(),+ isOrganizer: z.boolean(),+ contactId: z.string().nullable(),+ imageUrl: z.string().nullable(),+});++export const calendarEventOutput = z.object({+ id: z.string(),+ title: z.string().nullable(),+ description: z.string().nullable(),+ location: z.string().nullable(),+ conferenceUrl: z.string().nullable(),+ startsAt: z.string(),+ endsAt: z.string(),+ isAllDay: z.boolean(),+ status: z.string(),+ organizerEmail: z.string().nullable(),+ company: calendarEventCompanyOutput.nullable(),+ contact: calendarEventContactOutput.nullable(),+ attendees: z.array(calendarAttendeeOutput),+});++export type GoogleSourceStatus = z.infer<typeof googleSourceStatusOutput>;+export type GoogleConnectionStatus = z.infer<+ typeof googleConnectionStatusOutput+>;+export type PurgeSyncedDataOutput = z.infer<typeof purgeSyncedDataOutput>;+export type RevokeAccessOutput = z.infer<typeof revokeAccessOutput>;+export type SuppressDomainOutput = z.infer<typeof suppressDomainOutput>;+export type EmailThreadOutput = z.infer<typeof emailThreadOutput>;+export type CalendarEventOutput = z.infer<typeof calendarEventOutput>;diff --git a/apps/api/src/google/google.router.ts b/apps/api/src/google/google.router.tsindex b16cf15d..e038085a 100644--- a/apps/api/src/google/google.router.ts+++ b/apps/api/src/google/google.router.ts@@ -10,11 +10,18 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import { ConversationService } from "./conversation.service";import {calendarEventInput,+ calendarEventOutput,+ emailThreadOutput,+ googleConnectionStatusOutput,+ purgeSyncedDataOutput,+ revokeAccessOutput,setAutoCreateInput,suppressDomainInput,+ suppressDomainOutput,threadInput,} from "./google.contracts";import { GoogleConnectionService } from "./google-connection.service";@@ -31,28 +38,44 @@ export class GoogleRouter {private readonly conversations: ConversationService,) {}- @Query()+ @Query({+ output: googleConnectionStatusOutput,+ meta: restMeta("GET", "/google/status", ["Google"]),+ })async status(@Ctx() ctx: AuthedTrpcContext) {return this.connection.status(ctx.user.id);}- @Mutation()+ @Mutation({+ output: purgeSyncedDataOutput,+ meta: restMeta("POST", "/google/purge-synced-data", ["Google"]),+ })async purgeSyncedData(@Ctx() ctx: AuthedTrpcContext) {return this.connection.purgeSyncedData(ctx.user.id);}- @Mutation()+ @Mutation({+ output: revokeAccessOutput,+ meta: restMeta("POST", "/google/revoke", ["Google"]),+ })async revokeAccess(@Ctx() ctx: AuthedTrpcContext) {return this.connection.revoke(ctx.user.id);}- @Mutation()+ @Mutation({+ output: googleConnectionStatusOutput,+ meta: restMeta("POST", "/google/sync", ["Google"]),+ })async syncNow(@Ctx() ctx: AuthedTrpcContext) {await this.sync.runForUser(ctx.user.id);return this.connection.status(ctx.user.id);}- @Mutation({ input: setAutoCreateInput })+ @Mutation({+ input: setAutoCreateInput,+ output: googleConnectionStatusOutput,+ meta: restMeta("PATCH", "/google/auto-create", ["Google"]),+ })async setAutoCreate(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof setAutoCreateInput>,@@ -65,7 +88,11 @@ export class GoogleRouter {return this.connection.status(ctx.user.id);}- @Mutation({ input: suppressDomainInput })+ @Mutation({+ input: suppressDomainInput,+ output: suppressDomainOutput,+ meta: restMeta("POST", "/google/suppress-domain", ["Google"]),+ })async suppressDomain(@Input() input: z.infer<typeof suppressDomainInput>) {return this.connection.suppressDomain(input.domain, {reason: input.reason,@@ -73,12 +100,20 @@ export class GoogleRouter {});}- @Query({ input: threadInput })+ @Query({+ input: threadInput,+ output: emailThreadOutput,+ meta: restMeta("GET", "/google/threads/{threadId}", ["Google"]),+ })async thread(@Input("threadId") threadId: string) {return this.conversations.thread(threadId);}- @Query({ input: calendarEventInput })+ @Query({+ input: calendarEventInput,+ output: calendarEventOutput,+ meta: restMeta("GET", "/google/events/{eventId}", ["Google"]),+ })async event(@Input("eventId") eventId: string) {return this.conversations.event(eventId);}diff --git a/apps/api/src/health/health.controller.ts b/apps/api/src/health/health.controller.tsindex a9764222..32346a80 100644--- a/apps/api/src/health/health.controller.ts+++ b/apps/api/src/health/health.controller.ts@@ -5,11 +5,18 @@ import {Logger,ServiceUnavailableException,} from "@nestjs/common";+import {+ ApiOkResponse,+ ApiOperation,+ ApiServiceUnavailableResponse,+ ApiTags,+} from "@nestjs/swagger";import { AllowAnonymous } from "@thallesp/nestjs-better-auth";import { InjectDatabase } from "../database/database.constants";const SLOW_PROBE_MS = 250;+@ApiTags("Health")@Controller("health")export class HealthController {private readonly logger = new Logger(HealthController.name);@@ -18,6 +25,15 @@ export class HealthController {@Get()@AllowAnonymous()+ @ApiOperation({ summary: "Report API and database liveness" })+ @ApiOkResponse({+ description: "The API and its database are reachable.",+ schema: { example: { status: "ok", database: "up" } },+ })+ @ApiServiceUnavailableResponse({+ description: "The database did not respond.",+ schema: { example: { status: "error", database: "down" } },+ })async check() {const startedAt = process.hrtime.bigint();diff --git a/apps/api/src/microsoft/microsoft-connection.service.ts b/apps/api/src/microsoft/microsoft-connection.service.tsindex a531a86b..73b1c6e2 100644--- a/apps/api/src/microsoft/microsoft-connection.service.ts+++ b/apps/api/src/microsoft/microsoft-connection.service.ts@@ -1,5 +1,5 @@import { isMicrosoftConfigured, signsInWithMicrosoft } from "@crm/auth";-import { type Db, GoogleSyncStatus, type Prisma } from "@crm/db";+import type { Db, Prisma } from "@crm/db";import { Injectable, Logger, NotFoundException } from "@nestjs/common";import { ActivityStampService } from "../crm/activity-stamp.service";import { InjectDatabase } from "../database/database.constants";@@ -11,26 +11,15 @@ import {type MicrosoftSyncSource,SCOPE_FOR_SOURCE,} from "./microsoft.constants";+import type {+ MicrosoftConnectionStatus,+ MicrosoftSourceStatus,+ PurgeSyncedDataOutput,+ RevokeAccessOutput,+} from "./microsoft.contracts";const PURGE_TIMEOUT_MS = 60_000;-export type SourceStatus = {- source: MicrosoftSyncSource;- connected: boolean;- status: GoogleSyncStatus | null;- lastSyncedAt: string | null;- lastError: string | null;- autoCreate: boolean;-};--export type ConnectionStatus = {- configured: boolean;- linked: boolean;- required: boolean;- hasRefreshToken: boolean;- sources: SourceStatus[];-};-@Injectable()export class MicrosoftConnectionService {private readonly logger = new Logger(MicrosoftConnectionService.name);@@ -42,7 +31,7 @@ export class MicrosoftConnectionService {private readonly stamp: ActivityStampService,) {}- async status(userId: string): Promise<ConnectionStatus> {+ async status(userId: string): Promise<MicrosoftConnectionStatus> {await this.onConnected(userId);const [granted, rows, hasRefreshToken, accounts] = await Promise.all([@@ -54,18 +43,20 @@ export class MicrosoftConnectionService {const bySource = new Map(rows.map((row) => [row.source, row]));- const sources = MICROSOFT_SYNC_SOURCES.map((source): SourceStatus => {- const row = bySource.get(source);-- return {- source,- connected: granted.has(SCOPE_FOR_SOURCE[source]),- status: row?.status ?? null,- lastSyncedAt: row?.lastSyncedAt?.toISOString() ?? null,- lastError: row?.lastError ?? null,- autoCreate: row?.autoCreate ?? false,- };- });+ const sources = MICROSOFT_SYNC_SOURCES.map(+ (source): MicrosoftSourceStatus => {+ const row = bySource.get(source);++ return {+ source,+ connected: granted.has(SCOPE_FOR_SOURCE[source]),+ status: row?.status ?? null,+ lastSyncedAt: row?.lastSyncedAt?.toISOString() ?? null,+ lastError: row?.lastError ?? null,+ autoCreate: row?.autoCreate ?? false,+ };+ },+ );return {configured: isMicrosoftConfigured(),@@ -123,7 +114,7 @@ export class MicrosoftConnectionService {}}- async purgeSyncedData(userId: string): Promise<{ purged: number }> {+ async purgeSyncedData(userId: string): Promise<PurgeSyncedDataOutput> {const mine: Prisma.EmailMessageWhereInput = {syncedByUserId: userId,outlookMessageId: { not: null },@@ -158,7 +149,7 @@ export class MicrosoftConnectionService {return { purged };}- async revoke(userId: string): Promise<{ revoked: boolean }> {+ async revoke(userId: string): Promise<RevokeAccessOutput> {for (const source of MICROSOFT_SYNC_SOURCES) {await this.state.remove(userId, source);}diff --git a/apps/api/src/microsoft/microsoft.contracts.ts b/apps/api/src/microsoft/microsoft.contracts.tsindex 75b74b93..04357757 100644--- a/apps/api/src/microsoft/microsoft.contracts.ts+++ b/apps/api/src/microsoft/microsoft.contracts.ts@@ -1,3 +1,4 @@+import { GoogleSyncStatus } from "@crm/db";import { z } from "zod";import { MICROSOFT_SYNC_SOURCES } from "./microsoft.constants";@@ -9,3 +10,39 @@ export const setOutlookAutoCreateInput = z.object({export type SetOutlookAutoCreateInput = z.infer<typeof setOutlookAutoCreateInput>;++const microsoftSyncStatusOutput = z.enum(+ Object.values(GoogleSyncStatus) as [GoogleSyncStatus, ...GoogleSyncStatus[]],+);++export const microsoftSourceStatusOutput = z.object({+ source: z.enum(MICROSOFT_SYNC_SOURCES),+ connected: z.boolean(),+ status: microsoftSyncStatusOutput.nullable(),+ lastSyncedAt: z.string().nullable(),+ lastError: z.string().nullable(),+ autoCreate: z.boolean(),+});++export const microsoftConnectionStatusOutput = z.object({+ configured: z.boolean(),+ linked: z.boolean(),+ required: z.boolean(),+ hasRefreshToken: z.boolean(),+ sources: z.array(microsoftSourceStatusOutput),+});++export const purgeSyncedDataOutput = z.object({+ purged: z.number(),+});++export const revokeAccessOutput = z.object({+ revoked: z.boolean(),+});++export type MicrosoftSourceStatus = z.infer<typeof microsoftSourceStatusOutput>;+export type MicrosoftConnectionStatus = z.infer<+ typeof microsoftConnectionStatusOutput+>;+export type PurgeSyncedDataOutput = z.infer<typeof purgeSyncedDataOutput>;+export type RevokeAccessOutput = z.infer<typeof revokeAccessOutput>;diff --git a/apps/api/src/microsoft/microsoft.router.ts b/apps/api/src/microsoft/microsoft.router.tsindex f8da1ca8..b07afeb2 100644--- a/apps/api/src/microsoft/microsoft.router.ts+++ b/apps/api/src/microsoft/microsoft.router.ts@@ -10,7 +10,13 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";-import { setOutlookAutoCreateInput } from "./microsoft.contracts";+import { restMeta } from "../trpc/openapi";+import {+ microsoftConnectionStatusOutput,+ purgeSyncedDataOutput,+ revokeAccessOutput,+ setOutlookAutoCreateInput,+} from "./microsoft.contracts";import { MicrosoftConnectionService } from "./microsoft-connection.service";import { MicrosoftSyncService } from "./microsoft-sync.service";@@ -24,28 +30,44 @@ export class MicrosoftRouter {private readonly sync: MicrosoftSyncService,) {}- @Query()+ @Query({+ output: microsoftConnectionStatusOutput,+ meta: restMeta("GET", "/microsoft/status", ["Microsoft"]),+ })async status(@Ctx() ctx: AuthedTrpcContext) {return this.connection.status(ctx.user.id);}- @Mutation()+ @Mutation({+ output: purgeSyncedDataOutput,+ meta: restMeta("POST", "/microsoft/purge-synced-data", ["Microsoft"]),+ })async purgeSyncedData(@Ctx() ctx: AuthedTrpcContext) {return this.connection.purgeSyncedData(ctx.user.id);}- @Mutation()+ @Mutation({+ output: revokeAccessOutput,+ meta: restMeta("POST", "/microsoft/revoke", ["Microsoft"]),+ })async revokeAccess(@Ctx() ctx: AuthedTrpcContext) {return this.connection.revoke(ctx.user.id);}- @Mutation()+ @Mutation({+ output: microsoftConnectionStatusOutput,+ meta: restMeta("POST", "/microsoft/sync", ["Microsoft"]),+ })async syncNow(@Ctx() ctx: AuthedTrpcContext) {await this.sync.runForUser(ctx.user.id);return this.connection.status(ctx.user.id);}- @Mutation({ input: setOutlookAutoCreateInput })+ @Mutation({+ input: setOutlookAutoCreateInput,+ output: microsoftConnectionStatusOutput,+ meta: restMeta("PATCH", "/microsoft/auto-create", ["Microsoft"]),+ })async setAutoCreate(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof setOutlookAutoCreateInput>,diff --git a/apps/api/src/saved-views/saved-views.contracts.ts b/apps/api/src/saved-views/saved-views.contracts.tsnew file mode 100644index 00000000..963338b6--- /dev/null+++ b/apps/api/src/saved-views/saved-views.contracts.ts@@ -0,0 +1,52 @@+import { FIELD_ENTITIES } from "@crm/db/fields";+import { savedViewFilters } from "@crm/validation/saved-view";+import { z } from "zod";++export const savedViewEntity = z.enum(FIELD_ENTITIES);++export const savedViewListInput = z.object({+ entity: savedViewEntity,+});++export type SavedViewListInput = z.infer<typeof savedViewListInput>;++export const savedViewCreateInput = z.object({+ entity: savedViewEntity,+ name: z.string().trim().min(1, "A view needs a name.").max(120),+ shared: z.boolean().default(false),+ filters: savedViewFilters,+});++export type SavedViewCreateInput = z.infer<typeof savedViewCreateInput>;++const savedViewUpdateData = z.object({+ name: z.string().trim().min(1).max(120).optional(),+ shared: z.boolean().optional(),+ filters: savedViewFilters.optional(),+});++export type SavedViewUpdateData = z.infer<typeof savedViewUpdateData>;++export const savedViewUpdateArgs = z.object({+ id: z.string(),+ data: savedViewUpdateData,+});++export const savedViewIdInput = z.object({ id: z.string() });++export const savedViewOutput = z.object({+ id: z.string(),+ entity: savedViewEntity,+ name: z.string(),+ shared: z.boolean(),+ filters: savedViewFilters,+ mine: z.boolean(),+ createdAt: z.string(),+ updatedAt: z.string(),+});++export type SavedView = z.infer<typeof savedViewOutput>;++export const savedViewListOutput = z.array(savedViewOutput);++export const savedViewDeleteOutput = z.object({ id: z.string() });diff --git a/apps/api/src/saved-views/saved-views.module.ts b/apps/api/src/saved-views/saved-views.module.tsnew file mode 100644index 00000000..8d48ed70--- /dev/null+++ b/apps/api/src/saved-views/saved-views.module.ts@@ -0,0 +1,11 @@+import { Module } from "@nestjs/common";+import { TrpcModule } from "../trpc/trpc.module";+import { SavedViewsRouter } from "./saved-views.router";+import { SavedViewsService } from "./saved-views.service";++@Module({+ imports: [TrpcModule],+ providers: [SavedViewsService, SavedViewsRouter],+ exports: [SavedViewsService],+})+export class SavedViewsModule {}diff --git a/apps/api/src/saved-views/saved-views.router.ts b/apps/api/src/saved-views/saved-views.router.tsnew file mode 100644index 00000000..a6f8d221--- /dev/null+++ b/apps/api/src/saved-views/saved-views.router.ts@@ -0,0 +1,76 @@+import { Inject } from "@nestjs/common";+import {+ Ctx,+ Input,+ Mutation,+ Query,+ Router,+ UseMiddlewares,+} from "nestjs-trpc";+import type { z } from "zod";+import type { AuthedTrpcContext } from "../trpc/context.types";+import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";+import {+ savedViewCreateInput,+ savedViewDeleteOutput,+ savedViewIdInput,+ savedViewListInput,+ savedViewListOutput,+ savedViewOutput,+ savedViewUpdateArgs,+} from "./saved-views.contracts";+import { SavedViewsService } from "./saved-views.service";++@Router({ alias: "savedViews" })+@UseMiddlewares(AuthMiddleware)+export class SavedViewsRouter {+ constructor(+ @Inject(SavedViewsService) private readonly savedViews: SavedViewsService,+ ) {}++ @Query({+ input: savedViewListInput,+ output: savedViewListOutput,+ meta: restMeta("GET", "/saved-views", ["Saved Views"]),+ })+ async list(+ @Ctx() ctx: AuthedTrpcContext,+ @Input() input: z.infer<typeof savedViewListInput>,+ ) {+ return this.savedViews.list(input.entity, ctx.user.id);+ }++ @Mutation({+ input: savedViewCreateInput,+ output: savedViewOutput,+ meta: restMeta("POST", "/saved-views", ["Saved Views"]),+ })+ async create(+ @Ctx() ctx: AuthedTrpcContext,+ @Input() input: z.infer<typeof savedViewCreateInput>,+ ) {+ return this.savedViews.create(input, ctx.user.id);+ }++ @Mutation({+ input: savedViewUpdateArgs,+ output: savedViewOutput,+ meta: restMeta("PATCH", "/saved-views/{id}", ["Saved Views"]),+ })+ async update(+ @Ctx() ctx: AuthedTrpcContext,+ @Input() input: z.infer<typeof savedViewUpdateArgs>,+ ) {+ return this.savedViews.update(input.id, input.data, ctx.user.id);+ }++ @Mutation({+ input: savedViewIdInput,+ output: savedViewDeleteOutput,+ meta: restMeta("DELETE", "/saved-views/{id}", ["Saved Views"]),+ })+ async delete(@Ctx() ctx: AuthedTrpcContext, @Input("id") id: string) {+ return this.savedViews.delete(id, ctx.user.id);+ }+}diff --git a/apps/api/src/saved-views/saved-views.service.ts b/apps/api/src/saved-views/saved-views.service.tsnew file mode 100644index 00000000..afd87050--- /dev/null+++ b/apps/api/src/saved-views/saved-views.service.ts@@ -0,0 +1,126 @@+import { type Db, type FieldEntity, Prisma as PrismaNamespace } from "@crm/db";+import { parseSavedViewFilters } from "@crm/validation/saved-view";+import {+ ConflictException,+ Injectable,+ NotFoundException,+} from "@nestjs/common";+import { InjectDatabase } from "../database/database.constants";+import type {+ SavedView,+ SavedViewCreateInput,+ SavedViewUpdateData,+} from "./saved-views.contracts";++@Injectable()+export class SavedViewsService {+ constructor(@InjectDatabase() private readonly db: Db) {}++ async list(entity: FieldEntity, userId: string): Promise<SavedView[]> {+ const rows = await this.db.savedView.findMany({+ where: { entity, OR: [{ shared: true }, { ownerId: userId }] },+ orderBy: { name: "asc" },+ });++ return rows.map((row) => this.serialize(row, userId));+ }++ async create(+ input: SavedViewCreateInput,+ userId: string,+ ): Promise<SavedView> {+ try {+ const row = await this.db.savedView.create({+ data: {+ entity: input.entity,+ name: input.name,+ shared: input.shared,+ filters: input.filters,+ ownerId: userId,+ },+ });++ return this.serialize(row, userId);+ } catch (error) {+ throw this.translate(error);+ }+ }++ async update(+ id: string,+ data: SavedViewUpdateData,+ userId: string,+ ): Promise<SavedView> {+ const existing = await this.db.savedView.findUnique({ where: { id } });+ if (!existing || existing.ownerId !== userId) {+ throw new NotFoundException(`No saved view with id ${id}.`);+ }++ try {+ const row = await this.db.savedView.update({+ where: { id },+ data: {+ name: data.name,+ shared: data.shared,+ filters: data.filters,+ },+ });++ return this.serialize(row, userId);+ } catch (error) {+ throw this.translate(error, id);+ }+ }++ async delete(id: string, userId: string): Promise<{ id: string }> {+ const existing = await this.db.savedView.findUnique({ where: { id } });+ if (!existing || existing.ownerId !== userId) {+ throw new NotFoundException(`No saved view with id ${id}.`);+ }++ try {+ await this.db.savedView.delete({ where: { id } });+ } catch (error) {+ throw this.translate(error, id);+ }++ return { id };+ }++ private serialize(+ row: {+ id: string;+ entity: FieldEntity;+ name: string;+ shared: boolean;+ filters: unknown;+ ownerId: string;+ createdAt: Date;+ updatedAt: Date;+ },+ userId: string,+ ): SavedView {+ return {+ id: row.id,+ entity: row.entity,+ name: row.name,+ shared: row.shared,+ filters: parseSavedViewFilters(row.filters),+ mine: row.ownerId === userId,+ createdAt: row.createdAt.toISOString(),+ updatedAt: row.updatedAt.toISOString(),+ };+ }++ private translate(cause: unknown, id?: string): never {+ if (cause instanceof PrismaNamespace.PrismaClientKnownRequestError) {+ if (cause.code === "P2002") {+ throw new ConflictException("You already have a view with that name.");+ }+ if (cause.code === "P2025") {+ throw new NotFoundException(`No saved view with id ${id}.`);+ }+ }+ throw cause;+ }+}diff --git a/apps/api/src/search/search.router.ts b/apps/api/src/search/search.router.tsindex 1230a6d0..e4a7e9f1 100644--- a/apps/api/src/search/search.router.ts+++ b/apps/api/src/search/search.router.ts@@ -2,16 +2,34 @@ import { Inject } from "@nestjs/common";import { Input, Query, Router, UseMiddlewares } from "nestjs-trpc";import { z } from "zod";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import { SearchService } from "./search.service";const quickInput = z.object({ q: z.string().default("") });+const searchHitOutput = z.object({+ kind: z.enum(["company", "contact", "deal"]),+ id: z.string(),+ label: z.string(),+ detail: z.string().nullable(),+ iconUrl: z.string().nullable(),+ iconDarkUrl: z.string().nullable(),+ iconTone: z.string().nullable(),+ imageUrl: z.string().nullable(),+});++const quickOutput = z.object({ hits: z.array(searchHitOutput) });+@Router({ alias: "search" })@UseMiddlewares(AuthMiddleware)export class SearchRouter {constructor(@Inject(SearchService) private readonly search: SearchService) {}- @Query({ input: quickInput })+ @Query({+ input: quickInput,+ output: quickOutput,+ meta: restMeta("GET", "/search", ["Search"]),+ })async quick(@Input("q") q: string) {return this.search.quick(q);}diff --git a/apps/api/src/settings/settings.contracts.ts b/apps/api/src/settings/settings.contracts.tsindex b144f878..aa8c91ff 100644--- a/apps/api/src/settings/settings.contracts.ts+++ b/apps/api/src/settings/settings.contracts.ts@@ -1,5 +1,49 @@+import {+ MAX_ARCHIVE_RETENTION_DAYS,+ MIN_ARCHIVE_RETENTION_DAYS,+} from "@crm/db/settings";import { z } from "zod";+export const catalogModelOutput = z.object({+ id: z.string(),+ name: z.string(),+ provider: z.string(),+ contextWindowTokens: z.number(),+ pricing: z.object({ input: z.number(), output: z.number() }).nullable(),+});++export type CatalogModel = z.infer<typeof catalogModelOutput>;++export const agentModelOutput = z.object({+ selectedId: z.string().nullable(),+ effectiveId: z.string(),+ defaultId: z.string(),+ effective: catalogModelOutput.nullable(),+ updatedAt: z.string().nullable(),+});++export type AgentModelSettings = z.infer<typeof agentModelOutput>;++export const modelCatalogOutput = z.object({+ models: z.array(catalogModelOutput),+ available: z.boolean(),+});++export type ModelCatalogResult = z.infer<typeof modelCatalogOutput>;++export const researchKeyOutput = z.object({+ configured: z.boolean(),+ hint: z.string().nullable(),+});++export type ResearchKeySettings = z.infer<typeof researchKeyOutput>;++export const archiveRetentionOutput = z.object({+ days: z.number(),+});++export type ArchiveRetentionSettings = z.infer<typeof archiveRetentionOutput>;+export const setAgentModelInput = z.object({modelId: z.string().trim().min(1).max(200).nullable(),});@@ -19,3 +63,21 @@ export const setResearchKeyInput = z.object({});export type SetResearchKeyInput = z.infer<typeof setResearchKeyInput>;++export const setArchiveRetentionDaysInput = z.object({+ days: z+ .number()+ .int()+ .min(+ MIN_ARCHIVE_RETENTION_DAYS,+ `Retention has to be at least ${MIN_ARCHIVE_RETENTION_DAYS} day.`,+ )+ .max(+ MAX_ARCHIVE_RETENTION_DAYS,+ `Retention cannot be longer than ${MAX_ARCHIVE_RETENTION_DAYS} days.`,+ ),+});++export type SetArchiveRetentionDaysInput = z.infer<+ typeof setArchiveRetentionDaysInput+>;diff --git a/apps/api/src/settings/settings.router.ts b/apps/api/src/settings/settings.router.tsindex f4d56bf6..ca4e3130 100644--- a/apps/api/src/settings/settings.router.ts+++ b/apps/api/src/settings/settings.router.ts@@ -2,7 +2,16 @@ import { Inject } from "@nestjs/common";import { Input, Mutation, Query, Router, UseMiddlewares } from "nestjs-trpc";import type { z } from "zod";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";-import { setAgentModelInput, setResearchKeyInput } from "./settings.contracts";+import { restMeta } from "../trpc/openapi";+import {+ agentModelOutput,+ archiveRetentionOutput,+ modelCatalogOutput,+ researchKeyOutput,+ setAgentModelInput,+ setArchiveRetentionDaysInput,+ setResearchKeyInput,+} from "./settings.contracts";import { SettingsService } from "./settings.service";@Router({ alias: "settings" })@@ -12,28 +21,64 @@ export class SettingsRouter {@Inject(SettingsService) private readonly settings: SettingsService,) {}- @Query()+ @Query({+ output: agentModelOutput,+ meta: restMeta("GET", "/settings/agent-model", ["Settings"]),+ })async agentModel() {return this.settings.agentModel();}- @Query()+ @Query({+ output: modelCatalogOutput,+ meta: restMeta("GET", "/settings/model-catalog", ["Settings"]),+ })async modelCatalog() {return this.settings.modelCatalog();}- @Mutation({ input: setAgentModelInput })+ @Mutation({+ input: setAgentModelInput,+ output: agentModelOutput,+ meta: restMeta("PATCH", "/settings/agent-model", ["Settings"]),+ })async setAgentModel(@Input() input: z.infer<typeof setAgentModelInput>) {return this.settings.setAgentModel(input.modelId);}- @Query()+ @Query({+ output: researchKeyOutput,+ meta: restMeta("GET", "/settings/research-key", ["Settings"]),+ })async researchKey() {return this.settings.researchKey();}- @Mutation({ input: setResearchKeyInput })+ @Mutation({+ input: setResearchKeyInput,+ output: researchKeyOutput,+ meta: restMeta("PATCH", "/settings/research-key", ["Settings"]),+ })async setResearchKey(@Input() input: z.infer<typeof setResearchKeyInput>) {return this.settings.setResearchKey(input.apiKey);}++ @Query({+ output: archiveRetentionOutput,+ meta: restMeta("GET", "/settings/archive-retention", ["Settings"]),+ })+ async archiveRetention() {+ return this.settings.archiveRetention();+ }++ @Mutation({+ input: setArchiveRetentionDaysInput,+ output: archiveRetentionOutput,+ meta: restMeta("PATCH", "/settings/archive-retention", ["Settings"]),+ })+ async setArchiveRetention(+ @Input() input: z.infer<typeof setArchiveRetentionDaysInput>,+ ) {+ return this.settings.setArchiveRetention(input.days);+ }}diff --git a/apps/api/src/settings/settings.service.ts b/apps/api/src/settings/settings.service.tsindex 71c55e24..1e8cfe85 100644--- a/apps/api/src/settings/settings.service.ts+++ b/apps/api/src/settings/settings.service.ts@@ -3,36 +3,23 @@ import {DEFAULT_AGENT_MODEL,maskKey,readAgentModel,+ readArchiveRetentionDays,readContextDevKey,writeAgentModel,+ writeArchiveRetentionDays,writeContextDevKey,} from "@crm/db/settings";import { BadRequestException, Injectable, Logger } from "@nestjs/common";import { ResearchKeyService } from "../agent/research-key.service";import { BackfillService } from "../backfill/backfill.service";import { InjectDatabase } from "../database/database.constants";-import {- type CatalogModel,- ModelCatalogService,-} from "./model-catalog.service";--export interface AgentModelSettings {- selectedId: string | null;- effectiveId: string;- defaultId: string;- effective: CatalogModel | null;- updatedAt: string | null;-}--export interface ModelCatalogResult {- models: CatalogModel[];- available: boolean;-}--export interface ResearchKeySettings {- configured: boolean;- hint: string | null;-}+import { ModelCatalogService } from "./model-catalog.service";+import type {+ AgentModelSettings,+ ArchiveRetentionSettings,+ ModelCatalogResult,+ ResearchKeySettings,+} from "./settings.contracts";@Injectable()export class SettingsService {@@ -142,4 +129,19 @@ export class SettingsService {return this.researchKey();}++ async archiveRetention(): Promise<ArchiveRetentionSettings> {+ return { days: await readArchiveRetentionDays(this.db) };+ }++ async setArchiveRetention(days: number): Promise<ArchiveRetentionSettings> {+ const saved = await writeArchiveRetentionDays(this.db, days);++ this.logger.log({+ message: "Archive retention changed",+ days: saved,+ });++ return { days: saved };+ }}diff --git a/apps/api/src/slack/slack-connection.service.ts b/apps/api/src/slack/slack-connection.service.tsindex ab8d6321..a71492bb 100644--- a/apps/api/src/slack/slack-connection.service.ts+++ b/apps/api/src/slack/slack-connection.service.ts@@ -16,8 +16,15 @@ import { AgentTriggerService } from "../agent/agent-trigger.service";import { InjectDatabase } from "../database/database.constants";import type {SlackChannelsInput,+ SlackChannelsResult,SlackCreateChannelInput,+ SlackCreateChannelResult,+ SlackDisconnectResult,SlackJoinChannelInput,+ SlackJoinChannelResult,+ SlackMatches,+ SlackRefreshPeopleResult,+ SlackStatus,} from "./slack.contracts";import { SlackChannelsService } from "./slack-channels.service";import { SLACK, type SlackSyncState } from "./slack-config";@@ -34,7 +41,7 @@ export class SlackConnectionService {private readonly access: AgentAccessService,) {}- async status(userId: string) {+ async status(userId: string): Promise<SlackStatus> {const role = await this.access.assertMember(userId);const [account, agents, matches, memberCount, grant] = await Promise.all([this.db.account.findFirst({@@ -98,7 +105,7 @@ export class SlackConnectionService {};}- async matches(userId: string) {+ async matches(userId: string): Promise<SlackMatches> {await this.access.assertMember(userId);const [members, syncing] = await Promise.all([this.db.member.findMany({@@ -154,7 +161,7 @@ export class SlackConnectionService {: "stalled";}- async refreshPeople(userId: string) {+ async refreshPeople(userId: string): Promise<SlackRefreshPeopleResult> {await this.access.assertMember(userId);const account = await this.db.account.findFirst({where: { providerId: "slack", accessToken: { not: null } },@@ -171,7 +178,10 @@ export class SlackConnectionService {return { requested: true };}- async channels(input: SlackChannelsInput, userId: string) {+ async channels(+ input: SlackChannelsInput,+ userId: string,+ ): Promise<SlackChannelsResult> {await this.access.assertMember(userId);const take = input.limit ?? SLACK.channels.pageSize;@@ -215,7 +225,10 @@ export class SlackConnectionService {};}- async joinChannel(input: SlackJoinChannelInput, userId: string) {+ async joinChannel(+ input: SlackJoinChannelInput,+ userId: string,+ ): Promise<SlackJoinChannelResult> {await this.access.assertMember(userId);const channel = await this.db.slackChannel.findUnique({where: { id: input.channelId },@@ -239,7 +252,10 @@ export class SlackConnectionService {return { queued: true, alreadyJoined: false };}- async createChannel(input: SlackCreateChannelInput, userId: string) {+ async createChannel(+ input: SlackCreateChannelInput,+ userId: string,+ ): Promise<SlackCreateChannelResult> {await this.access.assertMember(userId);const existing = await this.db.slackChannel.findFirst({where: { name: input.name },@@ -252,7 +268,7 @@ export class SlackConnectionService {return this.slackChannels.create(input.name, input.isPrivate);}- async disconnect(userId: string) {+ async disconnect(userId: string): Promise<SlackDisconnectResult> {const role = await this.access.assertMember(userId);if (!canManageConnections(role)) {diff --git a/apps/api/src/slack/slack.contracts.ts b/apps/api/src/slack/slack.contracts.tsindex 4e1ec82e..80d6b706 100644--- a/apps/api/src/slack/slack.contracts.ts+++ b/apps/api/src/slack/slack.contracts.ts@@ -1,5 +1,5 @@import { z } from "zod";-import { SLACK } from "./slack-config";+import { SLACK, SLACK_SYNC_STATES } from "./slack-config";export const slackChannelsInput = z.object({cursor: z.string().trim().min(1).max(64).nullish(),@@ -38,3 +38,103 @@ export const slackCreateChannelReply = z.union([]);export type SlackCreateChannelReply = z.infer<typeof slackCreateChannelReply>;++const slackSyncStateOutput = z.enum(SLACK_SYNC_STATES);++const slackAgentSummaryOutput = z.object({+ id: z.string(),+ name: z.string(),+ description: z.string().nullable(),+ status: z.enum([+ "DRAFT",+ "DEPLOYING",+ "LIVE",+ "PAUSED",+ "ARCHIVED",+ "DELETED",+ ]),+});++export const slackStatusOutput = z.object({+ configured: z.boolean(),+ connected: z.boolean(),+ workspace: z.string().nullable(),+ lastConnectedAt: z.string().nullable(),+ scopes: z.array(z.string()),+ canInviteItself: z.boolean(),+ canManage: z.boolean(),+ agents: z.array(slackAgentSummaryOutput),+ people: z.object({+ matched: z.number(),+ reviewed: z.number(),+ }),+});++export type SlackStatus = z.infer<typeof slackStatusOutput>;++const slackMemberMatchOutput = z.object({+ slackUserId: z.string().nullable(),+ slackHandle: z.string().nullable(),+ slackEmail: z.string().nullable(),+});++export const slackMatchesOutput = z.object({+ rows: z.array(+ z.object({+ crmUserId: z.string(),+ name: z.string(),+ email: z.string(),+ match: slackMemberMatchOutput.nullable(),+ }),+ ),+ sync: slackSyncStateOutput,+});++export type SlackMatches = z.infer<typeof slackMatchesOutput>;++export const slackChannelsOutput = z.object({+ canInviteItself: z.boolean(),+ sync: slackSyncStateOutput,+ nextCursor: z.string().nullable(),+ rows: z.array(+ z.object({+ id: z.string(),+ name: z.string(),+ memberCount: z.number().nullable(),+ isPrivate: z.boolean(),+ isMember: z.boolean(),+ classified: z.boolean(),+ inviteRequestedAt: z.string().nullable(),+ }),+ ),+});++export type SlackChannelsResult = z.infer<typeof slackChannelsOutput>;++export const slackJoinChannelOutput = z.object({+ queued: z.boolean(),+ alreadyJoined: z.boolean(),+});++export type SlackJoinChannelResult = z.infer<typeof slackJoinChannelOutput>;++export const slackRefreshPeopleOutput = z.object({+ requested: z.boolean(),+});++export type SlackRefreshPeopleResult = z.infer<typeof slackRefreshPeopleOutput>;++export const slackCreateChannelOutput = z.object({+ channel: z.object({+ id: z.string(),+ name: z.string(),+ }),+});++export type SlackCreateChannelResult = z.infer<typeof slackCreateChannelOutput>;++export const slackDisconnectOutput = z.object({+ disconnected: z.boolean(),+});++export type SlackDisconnectResult = z.infer<typeof slackDisconnectOutput>;diff --git a/apps/api/src/slack/slack.router.ts b/apps/api/src/slack/slack.router.tsindex bee3f2af..9d8914a5 100644--- a/apps/api/src/slack/slack.router.ts+++ b/apps/api/src/slack/slack.router.ts@@ -10,10 +10,18 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import {slackChannelsInput,+ slackChannelsOutput,slackCreateChannelInput,+ slackCreateChannelOutput,+ slackDisconnectOutput,slackJoinChannelInput,+ slackJoinChannelOutput,+ slackMatchesOutput,+ slackRefreshPeopleOutput,+ slackStatusOutput,} from "./slack.contracts";import { SlackConnectionService } from "./slack-connection.service";@@ -25,17 +33,27 @@ export class SlackRouter {private readonly connection: SlackConnectionService,) {}- @Query()+ @Query({+ output: slackStatusOutput,+ meta: restMeta("GET", "/slack/status", ["Slack"]),+ })status(@Ctx() ctx: AuthedTrpcContext) {return this.connection.status(ctx.user.id);}- @Query()+ @Query({+ output: slackMatchesOutput,+ meta: restMeta("GET", "/slack/matches", ["Slack"]),+ })matches(@Ctx() ctx: AuthedTrpcContext) {return this.connection.matches(ctx.user.id);}- @Query({ input: slackChannelsInput })+ @Query({+ input: slackChannelsInput,+ output: slackChannelsOutput,+ meta: restMeta("GET", "/slack/channels", ["Slack"]),+ })channels(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof slackChannelsInput>,@@ -43,7 +61,11 @@ export class SlackRouter {return this.connection.channels(input, ctx.user.id);}- @Mutation({ input: slackJoinChannelInput })+ @Mutation({+ input: slackJoinChannelInput,+ output: slackJoinChannelOutput,+ meta: restMeta("POST", "/slack/channels/{channelId}/join", ["Slack"]),+ })joinChannel(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof slackJoinChannelInput>,@@ -51,12 +73,19 @@ export class SlackRouter {return this.connection.joinChannel(input, ctx.user.id);}- @Mutation()+ @Mutation({+ output: slackRefreshPeopleOutput,+ meta: restMeta("POST", "/slack/people/refresh", ["Slack"]),+ })refreshPeople(@Ctx() ctx: AuthedTrpcContext) {return this.connection.refreshPeople(ctx.user.id);}- @Mutation({ input: slackCreateChannelInput })+ @Mutation({+ input: slackCreateChannelInput,+ output: slackCreateChannelOutput,+ meta: restMeta("POST", "/slack/channels", ["Slack"]),+ })createChannel(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof slackCreateChannelInput>,@@ -64,7 +93,10 @@ export class SlackRouter {return this.connection.createChannel(input, ctx.user.id);}- @Mutation()+ @Mutation({+ output: slackDisconnectOutput,+ meta: restMeta("DELETE", "/slack/connection", ["Slack"]),+ })disconnect(@Ctx() ctx: AuthedTrpcContext) {return this.connection.disconnect(ctx.user.id);}diff --git a/apps/api/src/sso/sso.contracts.ts b/apps/api/src/sso/sso.contracts.tsindex d5620790..d36d63e5 100644--- a/apps/api/src/sso/sso.contracts.ts+++ b/apps/api/src/sso/sso.contracts.ts@@ -26,3 +26,45 @@ export const deleteSsoProviderInput = z.object({export type SsoProviderListInput = z.infer<typeof ssoProviderListInput>;export type RegisterSsoProviderInput = z.infer<typeof registerSsoProviderInput>;export type DeleteSsoProviderInput = z.infer<typeof deleteSsoProviderInput>;++const ssoPublicProviderOutput = z.object({+ providerId: z.string(),+ name: z.string(),+});++export const ssoSignInOptionsOutput = z.object({+ google: z.boolean(),+ microsoft: z.boolean(),+ providers: z.array(ssoPublicProviderOutput),+});++export type SignInOptions = z.infer<typeof ssoSignInOptionsOutput>;++export const ssoSettingsOutput = z.object({+ canConfigure: z.boolean(),+ callbackBase: z.string(),+});++export type SsoSettings = z.infer<typeof ssoSettingsOutput>;++export const ssoProviderOutput = z.object({+ providerId: z.string(),+ name: z.string(),+ type: z.enum(["oidc", "saml"]),+ issuer: z.string(),+ domains: z.array(z.string()),+ clientIdLastFour: z.string().nullable(),+ callbackURL: z.string(),+});++export type SsoProvider = z.infer<typeof ssoProviderOutput>;++export const ssoProviderListOutput = z.object({+ rows: z.array(ssoProviderOutput),+ total: z.number(),+ facetCounts: z.record(z.string(), z.record(z.string(), z.number())),+});++export const deleteSsoProviderOutput = z.object({+ providerId: z.string(),+});diff --git a/apps/api/src/sso/sso.router.ts b/apps/api/src/sso/sso.router.tsindex 84ba0ca7..978a0711 100644--- a/apps/api/src/sso/sso.router.ts+++ b/apps/api/src/sso/sso.router.ts@@ -11,10 +11,16 @@ import {import type { z } from "zod";import type { AuthedTrpcContext, BaseTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import {deleteSsoProviderInput,+ deleteSsoProviderOutput,registerSsoProviderInput,ssoProviderListInput,+ ssoProviderListOutput,+ ssoProviderOutput,+ ssoSettingsOutput,+ ssoSignInOptionsOutput,} from "./sso.contracts";import { SsoService } from "./sso.service";@@ -26,24 +32,40 @@ function headersOf(ctx: BaseTrpcContext): Headers {export class SsoRouter {constructor(@Inject(SsoService) private readonly sso: SsoService) {}- @Query()+ @Query({+ output: ssoSignInOptionsOutput,+ meta: restMeta("GET", "/sso/sign-in-options", ["SSO"], {+ protect: false,+ }),+ })async signInOptions() {return this.sso.signInOptions();}- @Query()+ @Query({+ output: ssoSettingsOutput,+ meta: restMeta("GET", "/sso/settings", ["SSO"]),+ })@UseMiddlewares(AuthMiddleware)async settings(@Ctx() ctx: AuthedTrpcContext) {return this.sso.settings(ctx.user.id);}- @Query({ input: ssoProviderListInput })+ @Query({+ input: ssoProviderListInput,+ output: ssoProviderListOutput,+ meta: restMeta("GET", "/sso", ["SSO"]),+ })@UseMiddlewares(AuthMiddleware)async list(@Input() input: z.infer<typeof ssoProviderListInput>) {return this.sso.list(input);}- @Mutation({ input: registerSsoProviderInput })+ @Mutation({+ input: registerSsoProviderInput,+ output: ssoProviderOutput,+ meta: restMeta("POST", "/sso", ["SSO"]),+ })@UseMiddlewares(AuthMiddleware)async register(@Ctx() ctx: AuthedTrpcContext,@@ -52,7 +74,11 @@ export class SsoRouter {return this.sso.register(ctx.user.id, headersOf(ctx), input);}- @Mutation({ input: deleteSsoProviderInput })+ @Mutation({+ input: deleteSsoProviderInput,+ output: deleteSsoProviderOutput,+ meta: restMeta("DELETE", "/sso/{providerId}", ["SSO"]),+ })@UseMiddlewares(AuthMiddleware)async remove(@Ctx() ctx: AuthedTrpcContext,diff --git a/apps/api/src/sso/sso.service.ts b/apps/api/src/sso/sso.service.tsindex bdb09d26..340efcb6 100644--- a/apps/api/src/sso/sso.service.ts+++ b/apps/api/src/sso/sso.service.ts@@ -30,35 +30,12 @@ import {import type {DeleteSsoProviderInput,RegisterSsoProviderInput,+ SignInOptions,+ SsoProvider,SsoProviderListInput,+ SsoSettings,} from "./sso.contracts";-export interface PublicSsoProvider {- providerId: string;- name: string;-}--export interface SignInOptions {- google: boolean;- microsoft: boolean;- providers: PublicSsoProvider[];-}--export interface SsoProvider {- providerId: string;- name: string;- type: "oidc" | "saml";- issuer: string;- domains: string[];- clientIdLastFour: string | null;- callbackURL: string;-}--export interface SsoSettings {- canConfigure: boolean;- callbackBase: string;-}-const PROVIDER_SELECT = {providerId: true,issuer: true,diff --git a/apps/api/src/sync/sync.controller.ts b/apps/api/src/sync/sync.controller.tsindex 9c819181..7464f607 100644--- a/apps/api/src/sync/sync.controller.ts+++ b/apps/api/src/sync/sync.controller.ts@@ -8,10 +8,27 @@ import {ServiceUnavailableException,} from "@nestjs/common";import { ConfigService } from "@nestjs/config";+import {+ ApiExcludeEndpoint,+ ApiForbiddenResponse,+ ApiHeader,+ ApiOkResponse,+ ApiOperation,+ ApiServiceUnavailableResponse,+ ApiTags,+} from "@nestjs/swagger";import { AllowAnonymous } from "@thallesp/nestjs-better-auth";import type { EnvironmentVariables } from "../config/env.validation";import { MailboxSyncService } from "./mailbox-sync.service";+@ApiTags("Internal — Cron")+@ApiHeader({+ name: "authorization",+ description: "`Bearer <CRON_SECRET>`",+ required: true,+})+@ApiForbiddenResponse({ description: "CRON_SECRET did not match." })+@ApiServiceUnavailableResponse({ description: "CRON_SECRET is not set." })@Controller("internal/sync")export class SyncController {private readonly logger = new Logger(SyncController.name);@@ -26,24 +43,32 @@ export class SyncController {@Get("mailboxes")@AllowAnonymous()+ @ApiOperation({ summary: "Run any due Gmail, Outlook or calendar sync" })+ @ApiOkResponse({ description: "The sync ran; per-mailbox results." })async mailboxesViaGet(@Headers("authorization") authorization?: string) {return this.run(authorization);}@Post("mailboxes")@AllowAnonymous()+ @ApiExcludeEndpoint()async mailboxesViaPost(@Headers("authorization") authorization?: string) {return this.run(authorization);}@Get("google")@AllowAnonymous()+ @ApiOperation({+ summary: "Alias of `mailboxes`, kept for existing cron deployments",+ })+ @ApiOkResponse({ description: "The sync ran; per-mailbox results." })async googleViaGet(@Headers("authorization") authorization?: string) {return this.run(authorization);}@Post("google")@AllowAnonymous()+ @ApiExcludeEndpoint()async googleViaPost(@Headers("authorization") authorization?: string) {return this.run(authorization);}diff --git a/apps/api/src/telemetry/telemetry.controller.ts b/apps/api/src/telemetry/telemetry.controller.tsindex 0ccd1b85..90ba0aaa 100644--- a/apps/api/src/telemetry/telemetry.controller.ts+++ b/apps/api/src/telemetry/telemetry.controller.ts@@ -8,10 +8,27 @@ import {ServiceUnavailableException,} from "@nestjs/common";import { ConfigService } from "@nestjs/config";+import {+ ApiExcludeEndpoint,+ ApiForbiddenResponse,+ ApiHeader,+ ApiOkResponse,+ ApiOperation,+ ApiServiceUnavailableResponse,+ ApiTags,+} from "@nestjs/swagger";import { AllowAnonymous } from "@thallesp/nestjs-better-auth";import type { EnvironmentVariables } from "../config/env.validation";import { RollupService } from "./rollup.service";+@ApiTags("Internal — Cron")+@ApiHeader({+ name: "authorization",+ description: "`Bearer <CRON_SECRET>`",+ required: true,+})+@ApiForbiddenResponse({ description: "CRON_SECRET did not match." })+@ApiServiceUnavailableResponse({ description: "CRON_SECRET is not set." })@Controller("internal/telemetry")export class TelemetryController {private readonly logger = new Logger(TelemetryController.name);@@ -26,12 +43,15 @@ export class TelemetryController {@Get("rollup")@AllowAnonymous()+ @ApiOperation({ summary: "Roll up raw telemetry events into daily counts" })+ @ApiOkResponse({ description: "The rollup ran." })async rollupViaGet(@Headers("authorization") authorization?: string) {return this.run(authorization);}@Post("rollup")@AllowAnonymous()+ @ApiExcludeEndpoint()async rollupViaPost(@Headers("authorization") authorization?: string) {return this.run(authorization);}diff --git a/apps/api/src/tracking/tracking-filing.service.ts b/apps/api/src/tracking/tracking-filing.service.tsindex 16aa5427..257307a6 100644--- a/apps/api/src/tracking/tracking-filing.service.ts+++ b/apps/api/src/tracking/tracking-filing.service.ts@@ -86,8 +86,8 @@ export class TrackingFilingService {const suppressed = await this.suppressed(email, domain);if (suppressed) return this.skip(submission.id, suppressed);- const existing = await this.db.contact.findUnique({- where: { email },+ const existing = await this.db.contact.findFirst({+ where: { email, archivedAt: null },select: { id: true },});@@ -156,8 +156,8 @@ export class TrackingFilingService {return null;}- return this.db.contact.findUnique({- where: { email },+ return this.db.contact.findFirst({+ where: { email, archivedAt: null },select: { id: true },});}diff --git a/apps/api/src/tracking/tracking.contracts.ts b/apps/api/src/tracking/tracking.contracts.tsindex 40b4b91e..c9b714fd 100644--- a/apps/api/src/tracking/tracking.contracts.ts+++ b/apps/api/src/tracking/tracking.contracts.ts@@ -36,3 +36,110 @@ export const companyActivityInput = z.object({export const contactActivityInput = z.object({contactId: z.string().min(1),});++const domainScopeOutput = z.enum(["SITE_AND_SUBDOMAINS", "EXACT_HOST"]);++export const trackedDomainOutput = z.object({+ id: z.string(),+ host: z.string(),+ scope: domainScopeOutput,+ pageViews: z.number(),+ lastSeenAt: z.string().nullable(),+});++export const trackingSettingsOutput = z.object({+ siteId: z.string().nullable(),+ ready: z.boolean(),+ scriptUrl: z.string(),+ snippet: z.string().nullable(),+ tagManagerSnippet: z.string().nullable(),+ crossDomain: z.boolean(),+ limitToDomains: z.boolean(),+ cookieSubdomains: z.boolean(),+ secureCookies: z.boolean(),+ honourDnt: z.boolean(),+ cookieDays: z.number(),+ paused: z.boolean(),+ cookieLifetimes: z.array(z.object({ days: z.number(), label: z.string() })),+ domains: z.array(trackedDomainOutput),+ receivingSince: z.string().nullable(),+ pageViews: z.number(),+ submissions: z.number(),+ canManage: z.boolean(),+});++export const rotateSiteIdOutput = z.object({+ siteId: z.string(),+});++const foundInContainerOutput = z.object({+ id: z.string(),+ carriesSiteId: z.boolean(),+});++export const verifyOutput = z.discriminatedUnion("status", [+ z.object({+ status: z.literal("found"),+ host: z.string(),+ responseMs: z.number(),+ allowed: z.boolean(),+ pageView: z.boolean(),+ container: foundInContainerOutput.nullable(),+ }),+ z.object({+ status: z.literal("missing"),+ host: z.string(),+ responseMs: z.number(),+ containers: z.array(z.string()),+ }),+ z.object({+ status: z.literal("unreachable"),+ host: z.string(),+ detail: z.string(),+ }),+]);++export const sourceRowOutput = z.object({+ source: z.string(),+ medium: z.string().nullable(),+ views: z.number(),+ contacts: z.number(),+});++export const sourcesOutput = z.array(sourceRowOutput);++const touchSummaryOutput = z.object({+ label: z.string(),+ source: z.string(),+ medium: z.string().nullable(),+ campaign: z.string().nullable(),+ landing: z.string().nullable(),+ referrer: z.string().nullable(),+ at: z.string().nullable(),+});++const visitedPageOutput = z.object({+ host: z.string(),+ path: z.string(),+ views: z.number(),+ lastSeenAt: z.string(),+});++export const websiteActivityOutput = z.object({+ identified: z.boolean(),+ visitors: z.number(),+ views: z.number(),+ lastSeenAt: z.string().nullable(),+ pages: z.array(visitedPageOutput),+ firstTouch: touchSummaryOutput.nullable(),+ lastTouch: touchSummaryOutput.nullable(),+});++export type TrackedDomainRow = z.infer<typeof trackedDomainOutput>;+export type TrackingSettings = z.infer<typeof trackingSettingsOutput>;+export type FoundInContainer = z.infer<typeof foundInContainerOutput>;+export type VerifyResult = z.infer<typeof verifyOutput>;+export type SourceRow = z.infer<typeof sourceRowOutput>;+export type TouchSummary = z.infer<typeof touchSummaryOutput>;+export type VisitedPage = z.infer<typeof visitedPageOutput>;+export type WebsiteActivity = z.infer<typeof websiteActivityOutput>;diff --git a/apps/api/src/tracking/tracking.controller.ts b/apps/api/src/tracking/tracking.controller.tsindex 21ccbf23..2a3603e7 100644--- a/apps/api/src/tracking/tracking.controller.ts+++ b/apps/api/src/tracking/tracking.controller.ts@@ -19,6 +19,17 @@ import {ServiceUnavailableException,} from "@nestjs/common";import { ConfigService } from "@nestjs/config";+import {+ ApiExcludeEndpoint,+ ApiForbiddenResponse,+ ApiHeader,+ ApiNoContentResponse,+ ApiOkResponse,+ ApiOperation,+ ApiParam,+ ApiServiceUnavailableResponse,+ ApiTags,+} from "@nestjs/swagger";import { AllowAnonymous } from "@thallesp/nestjs-better-auth";import type { Response } from "express";import { z } from "zod";@@ -48,6 +59,7 @@ const parsedBody = zconst trackingRequest = z.object({ body: parsedBody }).catch({ body: null });+@ApiTags("Tracking")@Controller("api/t")export class TrackingController {private readonly logger = new Logger(TrackingController.name);@@ -59,6 +71,13 @@ export class TrackingController {@Get("config/:siteId")@AllowAnonymous()+ @ApiOperation({+ summary: "Fetch a site's compiled tracking config, for the tracking script",+ })+ @ApiParam({ name: "siteId", description: "Public site identifier." })+ @ApiOkResponse({+ description: "The compiled config, or null if the site is unknown.",+ })async publicConfig(@Param("siteId") siteId: string) {if (!isSiteId(siteId)) return { config: null };@@ -72,6 +91,13 @@ export class TrackingController {@Post("e")@AllowAnonymous()@HttpCode(204)+ @ApiOperation({+ summary: "Ingest a batch of events from the tracking script",+ })+ @ApiNoContentResponse({+ description:+ "Always returned, even when the batch was rejected or unreadable.",+ })async collect(@Req() request: IncomingMessage,@Res({ passthrough: true }) response: Response,@@ -106,6 +132,14 @@ export class TrackingController {}}+@ApiTags("Internal — Cron")+@ApiHeader({+ name: "authorization",+ description: "`Bearer <CRON_SECRET>`",+ required: true,+})+@ApiForbiddenResponse({ description: "CRON_SECRET did not match." })+@ApiServiceUnavailableResponse({ description: "CRON_SECRET is not set." })@Controller("internal/tracking")export class TrackingRetentionController {private readonly logger = new Logger(TrackingRetentionController.name);@@ -122,12 +156,17 @@ export class TrackingRetentionController {@Get("retention")@AllowAnonymous()+ @ApiOperation({+ summary: "Roll up and sweep tracking data older than the retention window",+ })+ @ApiOkResponse({ description: "The sweep ran; removed and rolled counts." })async viaGet(@Headers("authorization") authorization?: string) {return this.run(authorization);}@Post("retention")@AllowAnonymous()+ @ApiExcludeEndpoint()async viaPost(@Headers("authorization") authorization?: string) {return this.run(authorization);}diff --git a/apps/api/src/tracking/tracking.router.ts b/apps/api/src/tracking/tracking.router.tsindex 7b1b3853..36fe2887 100644--- a/apps/api/src/tracking/tracking.router.ts+++ b/apps/api/src/tracking/tracking.router.ts@@ -7,17 +7,24 @@ import {Router,UseMiddlewares,} from "nestjs-trpc";-import type { z } from "zod";+import { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import {addDomainInput,companyActivityInput,contactActivityInput,cookieLifetimeInput,removeDomainInput,+ rotateSiteIdOutput,+ sourcesOutput,+ trackedDomainOutput,trackingFlagInput,+ trackingSettingsOutput,verifyInput,+ verifyOutput,+ websiteActivityOutput,} from "./tracking.contracts";import { TrackingService } from "./tracking.service";@@ -28,12 +35,19 @@ export class TrackingRouter {@Inject(TrackingService) private readonly tracking: TrackingService,) {}- @Query()+ @Query({+ output: trackingSettingsOutput,+ meta: restMeta("GET", "/tracking/settings", ["Tracking"]),+ })async settings(@Ctx() ctx: AuthedTrpcContext) {return this.tracking.settings(ctx.user.id);}- @Mutation({ input: trackingFlagInput })+ @Mutation({+ input: trackingFlagInput,+ output: z.void(),+ meta: restMeta("PATCH", "/tracking/flags", ["Tracking"]),+ })async setFlag(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof trackingFlagInput>,@@ -41,7 +55,11 @@ export class TrackingRouter {return this.tracking.setFlag(ctx.user.id, input.flag, input.enabled);}- @Mutation({ input: cookieLifetimeInput })+ @Mutation({+ input: cookieLifetimeInput,+ output: z.void(),+ meta: restMeta("PATCH", "/tracking/cookie-lifetime", ["Tracking"]),+ })async setCookieLifetime(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof cookieLifetimeInput>,@@ -49,7 +67,11 @@ export class TrackingRouter {return this.tracking.setCookieDays(ctx.user.id, input.days);}- @Mutation({ input: addDomainInput })+ @Mutation({+ input: addDomainInput,+ output: trackedDomainOutput,+ meta: restMeta("POST", "/tracking/domains", ["Tracking"]),+ })async addDomain(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof addDomainInput>,@@ -57,7 +79,11 @@ export class TrackingRouter {return this.tracking.addDomain(ctx.user.id, input);}- @Mutation({ input: removeDomainInput })+ @Mutation({+ input: removeDomainInput,+ output: z.void(),+ meta: restMeta("DELETE", "/tracking/domains/{id}", ["Tracking"]),+ })async removeDomain(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof removeDomainInput>,@@ -65,12 +91,19 @@ export class TrackingRouter {return this.tracking.removeDomain(ctx.user.id, input.id);}- @Mutation()+ @Mutation({+ output: rotateSiteIdOutput,+ meta: restMeta("POST", "/tracking/site-id/rotate", ["Tracking"]),+ })async rotateSiteId(@Ctx() ctx: AuthedTrpcContext) {return this.tracking.rotateSiteId(ctx.user.id);}- @Mutation({ input: verifyInput })+ @Mutation({+ input: verifyInput,+ output: verifyOutput,+ meta: restMeta("POST", "/tracking/verify", ["Tracking"]),+ })async verify(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof verifyInput>,@@ -78,17 +111,32 @@ export class TrackingRouter {return this.tracking.verify(ctx.user.id, input.url);}- @Query()+ @Query({+ output: sourcesOutput,+ meta: restMeta("GET", "/tracking/sources", ["Tracking"]),+ })async sources(@Ctx() ctx: AuthedTrpcContext) {return this.tracking.sources(ctx.user.id);}- @Query({ input: companyActivityInput })+ @Query({+ input: companyActivityInput,+ output: websiteActivityOutput,+ meta: restMeta("GET", "/tracking/companies/{companyId}/activity", [+ "Tracking",+ ]),+ })async companyActivity(@Input() input: z.infer<typeof companyActivityInput>) {return this.tracking.activityForCompany(input.companyId);}- @Query({ input: contactActivityInput })+ @Query({+ input: contactActivityInput,+ output: websiteActivityOutput,+ meta: restMeta("GET", "/tracking/contacts/{contactId}/activity", [+ "Tracking",+ ]),+ })async contactActivity(@Input() input: z.infer<typeof contactActivityInput>) {return this.tracking.activityForContact(input.contactId);}diff --git a/apps/api/src/tracking/tracking.service.ts b/apps/api/src/tracking/tracking.service.tsindex 982df1cd..7b67416c 100644--- a/apps/api/src/tracking/tracking.service.ts+++ b/apps/api/src/tracking/tracking.service.ts@@ -30,93 +30,18 @@ import {NotFoundException,} from "@nestjs/common";import { InjectDatabase } from "../database/database.constants";+import type {+ FoundInContainer,+ SourceRow,+ TouchSummary,+ TrackedDomainRow,+ TrackingSettings,+ VerifyResult,+ VisitedPage,+ WebsiteActivity,+} from "./tracking.contracts";import { TrackingConfigService } from "./tracking-config.service";-export interface TrackedDomainRow {- id: string;- host: string;- scope: DomainScope;- pageViews: number;- lastSeenAt: string | null;-}--export interface TrackingSettings {- siteId: string | null;- ready: boolean;- scriptUrl: string;- snippet: string | null;- tagManagerSnippet: string | null;- crossDomain: boolean;- limitToDomains: boolean;- cookieSubdomains: boolean;- secureCookies: boolean;- honourDnt: boolean;- cookieDays: number;- paused: boolean;- cookieLifetimes: { days: number; label: string }[];- domains: TrackedDomainRow[];- receivingSince: string | null;- pageViews: number;- submissions: number;- canManage: boolean;-}--export interface VisitedPage {- host: string;- path: string;- views: number;- lastSeenAt: string;-}--export interface TouchSummary {- label: string;- source: string;- medium: string | null;- campaign: string | null;- landing: string | null;- referrer: string | null;- at: string | null;-}--export interface WebsiteActivity {- identified: boolean;- visitors: number;- views: number;- lastSeenAt: string | null;- pages: VisitedPage[];- firstTouch: TouchSummary | null;- lastTouch: TouchSummary | null;-}--export interface SourceRow {- source: string;- medium: string | null;- views: number;- contacts: number;-}--export interface FoundInContainer {- id: string;- carriesSiteId: boolean;-}--export type VerifyResult =- | {- status: "found";- host: string;- responseMs: number;- allowed: boolean;- pageView: boolean;- container: FoundInContainer | null;- }- | {- status: "missing";- host: string;- responseMs: number;- containers: string[];- }- | { status: "unreachable"; host: string; detail: string };-@Injectable()export class TrackingService {constructor(diff --git a/apps/api/src/trpc/list-input.ts b/apps/api/src/trpc/list-input.tsindex e207d96e..c2325f19 100644--- a/apps/api/src/trpc/list-input.ts+++ b/apps/api/src/trpc/list-input.ts@@ -68,9 +68,62 @@ export const FACET_ALL = "all";export const FACET_UNASSIGNED = "unassigned";-export function ownerFilter(- value: string,-): { ownerId: string | null } | undefined {- if (value === FACET_ALL) return undefined;- return { ownerId: value === FACET_UNASSIGNED ? null : value };+export function splitSentinel(values: string[], sentinel: string) {+ const ids = values.filter((value) => value !== sentinel);+ return { ids, includesSentinel: ids.length !== values.length };+}++export function ownerFilter<+ TWhere =+ | { ownerId: { in: string[] } }+ | { ownerId: null }+ | { OR: unknown[] },+>(values: string[]): TWhere | undefined {+ if (values.length === 0) return undefined;++ const { ids, includesSentinel } = splitSentinel(values, FACET_UNASSIGNED);+ if (includesSentinel && ids.length === 0) return { ownerId: null } as TWhere;+ if (!includesSentinel) return { ownerId: { in: ids } } as TWhere;+ return { OR: [{ ownerId: { in: ids } }, { ownerId: null }] } as TWhere;+}++export function archivedFilter(archived: boolean) {+ return { archivedAt: archived ? { not: null } : null };+}++export const ACTIVITY_WINDOWS = ["7", "30", "90"] as const;++export type ActivityWindow = (typeof ACTIVITY_WINDOWS)[number];++const activityWindowSet: ReadonlySet<string> = new Set(ACTIVITY_WINDOWS);++export const activityFacetInput = z+ .array(z.string())+ .refine((values) => values.every((value) => activityWindowSet.has(value)), {+ message: `Activity must be one of: ${ACTIVITY_WINDOWS.join(", ")}.`,+ });++function activityCutoff(days: number): Date {+ return new Date(Date.now() - days * 24 * 60 * 60 * 1000);+}++export function activityFilter(+ values: string[],+): { lastActivityAt: { gte: Date } } | undefined {+ if (values.length === 0) return undefined;+ const days = values.reduce((max, value) => Math.max(max, Number(value)), 0);+ return { lastActivityAt: { gte: activityCutoff(days) } };+}++export async function activityFacetCounts(+ countWhere: (where: { lastActivityAt: { gte: Date } }) => Promise<number>,+): Promise<FacetCount> {+ const counts = await Promise.all(+ ACTIVITY_WINDOWS.map((days) =>+ countWhere({ lastActivityAt: { gte: activityCutoff(Number(days)) } }),+ ),+ );+ return Object.fromEntries(+ ACTIVITY_WINDOWS.map((days, index) => [days, counts[index]]),+ ) as FacetCount;}diff --git a/apps/api/src/trpc/middlewares/session-only.middleware.ts b/apps/api/src/trpc/middlewares/session-only.middleware.tsnew file mode 100644index 00000000..1216ad99--- /dev/null+++ b/apps/api/src/trpc/middlewares/session-only.middleware.ts@@ -0,0 +1,20 @@+import { API_KEY_HEADER } from "@crm/auth";+import { Injectable } from "@nestjs/common";+import { TRPCError } from "@trpc/server";+import type {+ MiddlewareOptions,+ MiddlewareResponse,+ TRPCMiddleware,+} from "nestjs-trpc";+import type { BaseTrpcContext } from "../context.types";++@Injectable()+export class SessionOnlyMiddleware implements TRPCMiddleware {+ async use(opts: MiddlewareOptions): Promise<MiddlewareResponse> {+ const ctx = opts.ctx as BaseTrpcContext;+ if (ctx.req?.headers[API_KEY_HEADER]) {+ throw new TRPCError({ code: "UNAUTHORIZED" });+ }+ return opts.next();+ }+}diff --git a/apps/api/src/trpc/openapi.ts b/apps/api/src/trpc/openapi.tsnew file mode 100644index 00000000..7cca22ca--- /dev/null+++ b/apps/api/src/trpc/openapi.ts@@ -0,0 +1,21 @@+import type { OpenApiMeta } from "trpc-to-openapi";++export const REST_BRIDGE_PATH = "/rest";++export type RestMethod = "GET" | "POST" | "PATCH" | "PUT" | "DELETE";++export function restMeta(+ method: RestMethod,+ path: `/${string}`,+ tags: string[],+ options: { protect?: boolean } = {},+): OpenApiMeta {+ return {+ openapi: {+ method,+ path,+ tags,+ protect: options.protect ?? true,+ },+ };+}diff --git a/apps/api/src/trpc/trpc.context.ts b/apps/api/src/trpc/trpc.context.tsindex 55ecc7a7..873d5a80 100644--- a/apps/api/src/trpc/trpc.context.ts+++ b/apps/api/src/trpc/trpc.context.ts@@ -1,18 +1,25 @@import { auth } from "@crm/auth";import { Injectable } from "@nestjs/common";import { fromNodeHeaders } from "better-auth/node";+import type { Request } from "express";import type { ContextOptions, TRPCContext } from "nestjs-trpc";import type { BaseTrpcContext } from "./context.types";+export async function createBaseTrpcContext(+ req: Request | undefined,+): Promise<BaseTrpcContext> {+ const session = req+ ? await auth.api+ .getSession({ headers: fromNodeHeaders(req.headers) })+ .catch(() => null)+ : null;+ return { req, session };+}+@Injectable()export class TrpcContext implements TRPCContext {async create(opts: ContextOptions): Promise<BaseTrpcContext> {const req = "req" in opts ? opts.req : undefined;- const session = req- ? await auth.api- .getSession({ headers: fromNodeHeaders(req.headers) })- .catch(() => null)- : null;- return { req, session };+ return createBaseTrpcContext(req);}}diff --git a/apps/api/src/trpc/trpc.module.ts b/apps/api/src/trpc/trpc.module.tsindex 4aa38a25..a4ffa560 100644--- a/apps/api/src/trpc/trpc.module.ts+++ b/apps/api/src/trpc/trpc.module.ts@@ -5,6 +5,7 @@ import { formatTrpcError } from "./error-formatter";import { AuthMiddleware } from "./middlewares/auth.middleware";import { DomainErrorMiddleware } from "./middlewares/domain-error.middleware";import { LoggingMiddleware } from "./middlewares/logging.middleware";+import { SessionOnlyMiddleware } from "./middlewares/session-only.middleware";import { TrpcContext } from "./trpc.context";import { TrpcErrorHandler } from "./trpc-error.handler";@@ -25,7 +26,8 @@ import { TrpcErrorHandler } from "./trpc-error.handler";LoggingMiddleware,DomainErrorMiddleware,AuthMiddleware,+ SessionOnlyMiddleware,],- exports: [AuthMiddleware],+ exports: [AuthMiddleware, SessionOnlyMiddleware],})export class TrpcModule {}diff --git a/apps/api/src/users/users.router.ts b/apps/api/src/users/users.router.tsindex 8a603433..1a49e6d5 100644--- a/apps/api/src/users/users.router.ts+++ b/apps/api/src/users/users.router.ts@@ -1,10 +1,21 @@import { Inject } from "@nestjs/common";import { Ctx, Query, Router, UseMiddlewares } from "nestjs-trpc";+import { z } from "zod";import { AuthService } from "../auth/auth.service";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import { UsersService } from "./users.service";+const usersListOutput = z.array(+ z.object({+ id: z.string(),+ name: z.string(),+ email: z.string(),+ image: z.string().nullable(),+ }),+);+@Router({ alias: "users" })@UseMiddlewares(AuthMiddleware)export class UsersRouter {@@ -18,7 +29,10 @@ export class UsersRouter {return this.auth.getProfile(ctx.user.id);}- @Query()+ @Query({+ output: usersListOutput,+ meta: restMeta("GET", "/users", ["Users"]),+ })async list() {return this.users.list();}diff --git a/apps/api/src/workspace/workspace.contracts.ts b/apps/api/src/workspace/workspace.contracts.tsindex 55d57784..a3f50172 100644--- a/apps/api/src/workspace/workspace.contracts.ts+++ b/apps/api/src/workspace/workspace.contracts.ts@@ -4,7 +4,7 @@ import { z } from "zod";import { listInput } from "../trpc/list-input";export const memberListInput = listInput.extend({- role: z.string().default("all"),+ role: z.array(z.string()).default([]),});export type MemberListInput = z.infer<typeof memberListInput>;@@ -28,3 +28,35 @@ export const setMemberRoleInput = z.object({export type UpdateWorkspaceInput = z.infer<typeof updateWorkspaceInput>;export type SetMemberRoleInput = z.infer<typeof setMemberRoleInput>;++export const workspaceOutput = z.object({+ id: z.string(),+ slug: z.string(),+ name: z.string(),+ website: z.string().nullable(),+ onboarded: z.boolean(),+ viewerRole: z.enum(WORKSPACE_ROLES).nullable(),+ canRename: z.boolean(),+ canChangeRoles: z.boolean(),+});++export type Workspace = z.infer<typeof workspaceOutput>;++export const workspaceMemberOutput = z.object({+ id: z.string(),+ userId: z.string(),+ name: z.string(),+ email: z.string(),+ image: z.string().nullable(),+ role: z.enum(WORKSPACE_ROLES),+ joinedAt: z.string(),+ isViewer: z.boolean(),+});++export type WorkspaceMember = z.infer<typeof workspaceMemberOutput>;++export const memberListOutput = z.object({+ rows: z.array(workspaceMemberOutput),+ total: z.number(),+ facetCounts: z.record(z.string(), z.record(z.string(), z.number())),+});diff --git a/apps/api/src/workspace/workspace.router.ts b/apps/api/src/workspace/workspace.router.tsindex ea8e0324..1dddb91c 100644--- a/apps/api/src/workspace/workspace.router.ts+++ b/apps/api/src/workspace/workspace.router.ts@@ -10,10 +10,14 @@ import {import type { z } from "zod";import type { AuthedTrpcContext } from "../trpc/context.types";import { AuthMiddleware } from "../trpc/middlewares/auth.middleware";+import { restMeta } from "../trpc/openapi";import {memberListInput,+ memberListOutput,setMemberRoleInput,updateWorkspaceInput,+ workspaceMemberOutput,+ workspaceOutput,} from "./workspace.contracts";import { WorkspaceService } from "./workspace.service";@@ -24,12 +28,19 @@ export class WorkspaceRouter {@Inject(WorkspaceService) private readonly workspace: WorkspaceService,) {}- @Query()+ @Query({+ output: workspaceOutput,+ meta: restMeta("GET", "/workspace", ["Workspace"]),+ })async get(@Ctx() ctx: AuthedTrpcContext) {return this.workspace.get(ctx.user.id);}- @Query({ input: memberListInput })+ @Query({+ input: memberListInput,+ output: memberListOutput,+ meta: restMeta("POST", "/workspace/members/search", ["Workspace"]),+ })async members(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof memberListInput>,@@ -37,7 +48,11 @@ export class WorkspaceRouter {return this.workspace.members(ctx.user.id, input);}- @Mutation({ input: updateWorkspaceInput })+ @Mutation({+ input: updateWorkspaceInput,+ output: workspaceOutput,+ meta: restMeta("PATCH", "/workspace", ["Workspace"]),+ })async update(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof updateWorkspaceInput>,@@ -45,7 +60,13 @@ export class WorkspaceRouter {return this.workspace.update(ctx.user.id, input);}- @Mutation({ input: setMemberRoleInput })+ @Mutation({+ input: setMemberRoleInput,+ output: workspaceMemberOutput,+ meta: restMeta("PATCH", "/workspace/members/{memberId}/role", [+ "Workspace",+ ]),+ })async setMemberRole(@Ctx() ctx: AuthedTrpcContext,@Input() input: z.infer<typeof setMemberRoleInput>,diff --git a/apps/api/src/workspace/workspace.service.ts b/apps/api/src/workspace/workspace.service.tsindex 8e49e6f2..65cc99ab 100644--- a/apps/api/src/workspace/workspace.service.ts+++ b/apps/api/src/workspace/workspace.service.ts@@ -22,7 +22,6 @@ import { normalizeDomain } from "../companies/domain";import { InjectDatabase } from "../database/database.constants";import {countsByKey,- FACET_ALL,type ListResult,type OrderByColumns,paginate,@@ -32,30 +31,10 @@ import type {MemberListInput,SetMemberRoleInput,UpdateWorkspaceInput,+ Workspace,+ WorkspaceMember,} from "./workspace.contracts";-export interface Workspace {- id: string;- slug: string;- name: string;- website: string | null;- onboarded: boolean;- viewerRole: WorkspaceRole | null;- canRename: boolean;- canChangeRoles: boolean;-}--export interface WorkspaceMember {- id: string;- userId: string;- name: string;- email: string;- image: string | null;- role: WorkspaceRole;- joinedAt: string;- isViewer: boolean;-}-const MEMBER_SELECT = {id: true,role: true,@@ -278,8 +257,8 @@ export class WorkspaceService {private buildWhere(input: MemberListInput): Prisma.MemberWhereInput {const where = this.searchWhere(input.q);- if (input.role !== FACET_ALL) {- where.role = input.role;+ if (input.role.length > 0) {+ where.role = { in: input.role };}return where;diff --git a/apps/api/test/bulk.spec.ts b/apps/api/test/bulk.spec.tsindex b357c2d2..3b887183 100644--- a/apps/api/test/bulk.spec.ts+++ b/apps/api/test/bulk.spec.ts@@ -105,7 +105,13 @@ describe("assigning an owner to a selection", () => {ids: [first.id, second.id],ownerId: secondOwnerId,}),- ).toEqual({ requested: 2, succeeded: 2, failed: 0, message: null });+ ).toEqual({+ requested: 2,+ succeeded: 2,+ skipped: 0,+ failed: 0,+ message: null,+ });expect(await db.contact.count({@@ -125,7 +131,13 @@ describe("assigning an owner to a selection", () => {ids: [only.id, only.id],ownerId,}),- ).toEqual({ requested: 1, succeeded: 1, failed: 0, message: null });+ ).toEqual({+ requested: 1,+ succeeded: 1,+ skipped: 0,+ failed: 0,+ message: null,+ });});it("refuses an owner who does not work here", async () => {@@ -154,7 +166,7 @@ describe("assigning an owner to a selection", () => {});});-describe("deleting a selection", () => {+describe("purging a selection", () => {it("suppresses every address, exactly as deleting them one by one would", async () => {const first = await contacts.create({firstName: "Gone",@@ -165,9 +177,10 @@ describe("deleting a selection", () => {email: `also-gone@${domain}`,});- expect(await contacts.bulkDelete([first.id, second.id])).toEqual({+ expect(await contacts.bulkPurge([first.id, second.id])).toEqual({requested: 2,succeeded: 2,+ skipped: 0,failed: 0,message: null,});@@ -185,10 +198,7 @@ describe("deleting a selection", () => {email: `doomed@${domain}`,});- const result = await contacts.bulkDelete([- survivor.id,- `missing-${suffix}`,- ]);+ const result = await contacts.bulkPurge([survivor.id, `missing-${suffix}`]);expect(result.succeeded).toBe(1);expect(result.failed).toBe(1);@@ -209,9 +219,10 @@ describe("deleting a selection", () => {ownerId,});- expect(await companies.bulkDelete([doomed.id])).toEqual({+ expect(await companies.bulkPurge([doomed.id])).toEqual({requested: 1,succeeded: 1,+ skipped: 0,failed: 0,message: null,});@@ -268,7 +279,13 @@ describe("moving a selection of deals to a stage", () => {},ownerId,),- ).toEqual({ requested: 2, succeeded: 2, failed: 0, message: null });+ ).toEqual({+ requested: 2,+ succeeded: 2,+ skipped: 0,+ failed: 0,+ message: null,+ });const closed = await db.deal.findMany({where: { id: { in: [first.id, second.id] } },diff --git a/apps/api/test/currency-totals.integration.spec.ts b/apps/api/test/currency-totals.integration.spec.tsindex f51b637e..5cb97c7a 100644--- a/apps/api/test/currency-totals.integration.spec.ts+++ b/apps/api/test/currency-totals.integration.spec.ts@@ -234,9 +234,11 @@ describe("the deals list", () => {sort: "amount",dir: "desc",status: "open",- owner: userId,- stage: "all",- closing: "all",+ owner: [userId],+ stage: [],+ closing: [],+ fields: {},+ archived: false,});expect(list.reportingCurrency).toBe("USD");diff --git a/apps/api/test/fields.spec.ts b/apps/api/test/fields.spec.tsindex 9a824991..73e83a1d 100644--- a/apps/api/test/fields.spec.ts+++ b/apps/api/test/fields.spec.ts@@ -23,15 +23,26 @@ const suffix = process.env.TEST_RUN_ID ?? "fields-spec";const domain = `fields-${suffix}.test`;const ownerId = `owner-${suffix}`;-const queued: { entity: FieldEntity; key: string; reason: string }[] = [];+const queued: {+ entity: FieldEntity;+ keys: string[];+ ids: string[];+ reason: string;+}[] = [];const agent = {contactCreated: async () => undefined,companyCreated: async () => undefined,companyRequested: async () => undefined,withCrmEvents: withDiscardedCrmEvents,- fieldBackfill: async (entity: FieldEntity, key: string, reason: string) => {- queued.push({ entity, key, reason });+ fieldBackfillRecords: async (+ entity: FieldEntity,+ keys: string[],+ ids: string[],+ reason: string,+ ) => {+ queued.push({ entity, keys, ids, reason });+ return { queued: ids.length, merged: 0 };},} as unknown as AgentTriggerService;@@ -68,9 +79,21 @@ async function clean() {select: { id: true },});const companyIds = owned.map((row) => row.id);+ const ownedContacts = await db.contact.findMany({+ where: { companyId: { in: companyIds } },+ select: { id: true },+ });+ const contactIds = ownedContacts.map((row) => row.id);await db.agentTask.deleteMany({- where: { kind: "field-backfill", reason: { contains: "spec_" } },+ where: {+ kind: "field-backfill",+ OR: [+ { reason: { contains: "spec_" } },+ { companyId: { in: companyIds } },+ { contactId: { in: contactIds } },+ ],+ },});await db.deal.deleteMany({ where: { companyId: { in: companyIds } } });await db.contact.deleteMany({ where: { companyId: { in: companyIds } } });@@ -132,6 +155,7 @@ describe("field definitions", () => {required: false,showOnSheet: true,showOnTable: false,+ showOnFilter: false,});expect(field.key).toBe("spec_runs_on");@@ -139,9 +163,13 @@ describe("field definitions", () => {"AWS","Azure",]);- expect(queued).toEqual([- { entity: "COMPANY", key: "spec_runs_on", reason: "New field" },- ]);+ expect(queued).toHaveLength(1);+ expect(queued[0]).toMatchObject({+ entity: "COMPANY",+ keys: ["spec_runs_on"],+ reason: "New field: Spec runs on",+ });+ expect(queued[0]?.ids).toContain(companyId);});it("refuses a duplicate key", async () => {@@ -156,6 +184,7 @@ describe("field definitions", () => {required: false,showOnSheet: true,showOnTable: false,+ showOnFilter: false,}),).rejects.toThrow(/already a field/);});@@ -196,6 +225,7 @@ describe("field definitions", () => {required: false,showOnSheet: true,showOnTable: false,+ showOnFilter: false,});let refused: Error | null = null;@@ -242,6 +272,7 @@ describe("field definitions", () => {required: false,showOnSheet: true,showOnTable: false,+ showOnFilter: false,});const first = await fields.byKey("COMPANY", "spec_runs_on");@@ -280,6 +311,7 @@ describe("field values", () => {required: false,showOnSheet: true,showOnTable: false,+ showOnFilter: false,});await fields.applyValues(db, "COMPANY", companyId, {@@ -364,6 +396,7 @@ describe("field values", () => {required: false,showOnSheet: true,showOnTable: false,+ showOnFilter: false,});let refused: Error | null = null;@@ -426,6 +459,7 @@ describe("a select option that was taken away", () => {required: false,showOnSheet: true,showOnTable: false,+ showOnFilter: false,});const gold = field.options.find((option) => option.label === "Gold");@@ -474,6 +508,7 @@ describe("a select option that was taken away", () => {required: false,showOnSheet: true,showOnTable: true,+ showOnFilter: false,});const rollout = field.options.find((option) => option.label === "Rollout");@@ -520,6 +555,7 @@ describe("a record update that fails", () => {required: false,showOnSheet: true,showOnTable: false,+ showOnFilter: false,});const contact = await db.contact.create({@@ -558,6 +594,7 @@ describe("a record update that fails", () => {required: false,showOnSheet: true,showOnTable: false,+ showOnFilter: false,});const deal = await db.deal.create({@@ -585,21 +622,65 @@ describe("a record update that fails", () => {});describe("queueing a backfill", () => {- it("keeps one entity's field apart from another's with the same key", async () => {+ it("targets the record, and merges a second field into the same pending task", async () => {const trigger = new AgentTriggerService(db);+ const otherCompanyId = await makeCompany("fields-co-2");++ const first = await trigger.fieldBackfillRecords(+ "COMPANY",+ ["spec_website"],+ [companyId, otherCompanyId],+ "New field",+ );+ expect(first).toEqual({ queued: 2, merged: 0 });- await trigger.fieldBackfill("COMPANY", "spec_website", "New field");- await trigger.fieldBackfill("CONTACT", "spec_website", "New field");- await trigger.fieldBackfill("COMPANY", "spec_website", "Brief changed");+ const second = await trigger.fieldBackfillRecords(+ "COMPANY",+ ["spec_segment"],+ [companyId],+ "New field",+ );+ expect(second).toEqual({ queued: 0, merged: 1 });const tasks = await db.agentTask.findMany({- where: { kind: "field-backfill", reason: { contains: "spec_website" } },- select: { reason: true },+ where: {+ kind: "field-backfill",+ companyId: { in: [companyId, otherCompanyId] },+ },+ select: { companyId: true, payload: true },});- expect(tasks.map((task) => task.reason).sort()).toEqual([- "company.spec_website: New field",- "contact.spec_website: New field",- ]);+ expect(tasks).toHaveLength(2);+ const mine = tasks.find((task) => task.companyId === companyId);+ expect(mine?.payload).toEqual({+ entity: "COMPANY",+ keys: ["spec_website", "spec_segment"],+ });+ });++ it("keeps a company's field apart from a contact's field with the same key", async () => {+ const trigger = new AgentTriggerService(db);+ const contact = await db.contact.create({+ data: { firstName: "Backfill", email: `backfill@${domain}`, companyId },+ select: { id: true },+ });++ await trigger.fieldBackfillRecords(+ "CONTACT",+ ["spec_website"],+ [contact.id],+ "New field",+ );++ const tasks = await db.agentTask.findMany({+ where: { kind: "field-backfill", contactId: contact.id },+ select: { payload: true },+ });++ expect(tasks).toHaveLength(1);+ expect(tasks[0]?.payload).toEqual({+ entity: "CONTACT",+ keys: ["spec_website"],+ });});});diff --git a/apps/api/test/logging.spec.ts b/apps/api/test/logging.spec.tsindex 20664959..f5ca0308 100644--- a/apps/api/test/logging.spec.ts+++ b/apps/api/test/logging.spec.ts@@ -9,13 +9,14 @@ import {import { RequestLoggerMiddleware } from "../src/logging/request-logger.middleware";function withNodeEnv(value: string, fn: () => void): void {- const previous = process.env.NODE_ENV;- process.env.NODE_ENV = value;+ const env = process.env as { NODE_ENV: string };+ const previous = env.NODE_ENV;+ env.NODE_ENV = value;try {fn();} finally {- process.env.NODE_ENV = previous;+ env.NODE_ENV = previous;}}diff --git a/apps/api/test/record-delete.spec.ts b/apps/api/test/record-delete.spec.tsindex 15c03b24..244920a7 100644--- a/apps/api/test/record-delete.spec.ts+++ b/apps/api/test/record-delete.spec.ts@@ -120,7 +120,7 @@ beforeAll(async () => {afterAll(clean);-describe("deleting a contact", () => {+describe("purging a contact", () => {let contactId: string;it("takes the record, its queued research and its transcript with it", async () => {@@ -145,7 +145,7 @@ describe("deleting a contact", () => {},});- expect(await contacts.delete(contactId)).toEqual({+ expect(await contacts.purge(contactId)).toEqual({id: contactId,name: "Gone Person",});@@ -222,7 +222,7 @@ describe("deleting a contact", () => {}),).toEqual({ email: asSynced });- await contacts.delete(created.id);+ await contacts.purge(created.id);expect(await db.suppressedContact.findUnique({ where: { email: asSynced } }),@@ -245,7 +245,7 @@ describe("deleting a contact", () => {});});-describe("deleting a company", () => {+describe("purging a company", () => {it("takes its deals and leaves its people without a company", async () => {const company = await companies.create({name: "Doomed",@@ -264,7 +264,7 @@ describe("deleting a company", () => {await parked({ companyId: company.id });- expect(await companies.delete(company.id)).toEqual({+ expect(await companies.purge(company.id)).toEqual({id: company.id,name: "Doomed",});@@ -284,7 +284,7 @@ describe("deleting a company", () => {});});-describe("the activity stamps a delete leaves behind", () => {+describe("the activity stamps a purge leaves behind", () => {it("are recomputed on every record the deleted one's activities touched", async () => {const company = await companies.create({name: "Stamped",@@ -317,7 +317,7 @@ describe("the activity stamps a delete leaves behind", () => {at,);- await contacts.delete(contact.id);+ await contacts.purge(contact.id);expect(await db.company.findUnique({@@ -361,7 +361,7 @@ describe("the activity stamps a delete leaves behind", () => {});await stamp.touch({ contactId: contact.id, dealId: deal.id }, at);- await companies.delete(company.id);+ await companies.purge(company.id);expect(await db.contact.findUnique({diff --git a/apps/api/vercel.json b/apps/api/vercel.jsonindex 28973399..ffce1ccc 100644--- a/apps/api/vercel.json+++ b/apps/api/vercel.json@@ -16,6 +16,10 @@{"path": "/internal/tracking/retention","schedule": "0 4 * * *"+ },+ {+ "path": "/internal/archive/prune",+ "schedule": "0 5 * * *"}]}diff --git a/apps/app/app/(app)/[slug]/companies/companies-bulk-actions.tsx b/apps/app/app/(app)/[slug]/companies/companies-bulk-actions.tsxindex 9658fe74..3ac14002 100644--- a/apps/app/app/(app)/[slug]/companies/companies-bulk-actions.tsx+++ b/apps/app/app/(app)/[slug]/companies/companies-bulk-actions.tsx@@ -1,7 +1,8 @@"use client";+import Archive from "@carbon/icons-react/es/Archive";import Renew from "@carbon/icons-react/es/Renew";-import TrashCan from "@carbon/icons-react/es/TrashCan";+import Undo from "@carbon/icons-react/es/Undo";import {DropdownMenuGroup,DropdownMenuItem,@@ -27,9 +28,11 @@ function companies(count: number): string {export function CompaniesBulkActions({ids,onDone,+ archived,}: {ids: string[];onDone: () => void;+ archived: boolean;}) {const trpc = useTRPC();const cache = useCrmCache();@@ -63,11 +66,33 @@ export function CompaniesBulkActions({}),);- const remove = useMutation(- trpc.companies.bulkDelete.mutationOptions({+ const archive = useMutation(+ trpc.companies.bulkArchive.mutationOptions({onSuccess: async (result, variables) => {await cache.removedMany({ kind: "company", ids: variables.ids });- reportBulk(result, (count) => `${companies(count)} deleted.`);+ reportBulk(result, (count) => `${companies(count)} archived.`);+ onDone();+ },+ onError,+ }),+ );++ const restore = useMutation(+ trpc.companies.bulkRestore.mutationOptions({+ onSuccess: async (result) => {+ await cache.company();+ reportBulk(result, (count) => `${companies(count)} restored.`);+ onDone();+ },+ onError,+ }),+ );++ const purge = useMutation(+ trpc.companies.bulkPurge.mutationOptions({+ onSuccess: async (result, variables) => {+ await cache.removedMany({ kind: "company", ids: variables.ids });+ reportBulk(result, (count) => `${companies(count)} deleted forever.`);setConfirming(false);onDone();},@@ -75,41 +100,63 @@ export function CompaniesBulkActions({}),);- const pending = assignOwner.isPending || enrich.isPending || remove.isPending;+ if (archived) {+ const pending = restore.isPending || purge.isPending;- return (- <>- <BulkActionsMenu pending={pending}>- <BulkOwnerMenu- users={users.data ?? []}- unassignedLabel="Nobody"- onSelect={(ownerId) => assignOwner.mutate({ ids, ownerId })}+ return (+ <>+ <BulkActionsMenu pending={pending}>+ <DropdownMenuGroup>+ <DropdownMenuItem onSelect={() => restore.mutate({ ids })}>+ <Undo />+ Restore+ </DropdownMenuItem>+ </DropdownMenuGroup>+ <DropdownMenuSeparator />+ <DropdownMenuGroup>+ <DropdownMenuItem+ variant="destructive"+ onSelect={() => setConfirming(true)}+ >+ Delete forever+ </DropdownMenuItem>+ </DropdownMenuGroup>+ </BulkActionsMenu>++ <BulkDeleteDialog+ open={confirming}+ onOpenChange={setConfirming}+ title={`Delete ${companies(ids.length)} forever?`}+ description="This cannot be undone."+ onConfirm={() => purge.mutate({ ids })}/>- <DropdownMenuGroup>- <DropdownMenuItem onSelect={() => enrich.mutate({ ids })}>- <Renew />- Re-enrich- </DropdownMenuItem>- </DropdownMenuGroup>- <DropdownMenuSeparator />- <DropdownMenuGroup>- <DropdownMenuItem- variant="destructive"- onSelect={() => setConfirming(true)}- >- <TrashCan />- Delete- </DropdownMenuItem>- </DropdownMenuGroup>- </BulkActionsMenu>+ </>+ );+ }- <BulkDeleteDialog- open={confirming}- onOpenChange={setConfirming}- title={`Delete ${companies(ids.length)}?`}- description="Their contacts stay, with no company. Deals on these companies go with them, and none of it can be undone."- onConfirm={() => remove.mutate({ ids })}+ const pending =+ assignOwner.isPending || enrich.isPending || archive.isPending;++ return (+ <BulkActionsMenu pending={pending}>+ <BulkOwnerMenu+ users={users.data ?? []}+ unassignedLabel="Nobody"+ onSelect={(ownerId) => assignOwner.mutate({ ids, ownerId })}/>- </>+ <DropdownMenuGroup>+ <DropdownMenuItem onSelect={() => enrich.mutate({ ids })}>+ <Renew />+ Re-enrich+ </DropdownMenuItem>+ </DropdownMenuGroup>+ <DropdownMenuSeparator />+ <DropdownMenuGroup>+ <DropdownMenuItem onSelect={() => archive.mutate({ ids })}>+ <Archive />+ Archive+ </DropdownMenuItem>+ </DropdownMenuGroup>+ </BulkActionsMenu>);}diff --git a/apps/app/app/(app)/[slug]/companies/companies-search-params.ts b/apps/app/app/(app)/[slug]/companies/companies-search-params.tsindex fa38ad0c..122a9824 100644--- a/apps/app/app/(app)/[slug]/companies/companies-search-params.ts+++ b/apps/app/app/(app)/[slug]/companies/companies-search-params.ts@@ -3,5 +3,5 @@ import { createListSearchParams } from "@/components/data-table/list-search-paraexport const companiesSearchParams = createListSearchParams({defaultSort: "createdAt",defaultDir: "desc",- facetIds: ["owner", "industry", "enrichment"] as const,+ facetIds: ["owner", "industry", "enrichment", "activity"] as const,});diff --git a/apps/app/app/(app)/[slug]/companies/companies-table.tsx b/apps/app/app/(app)/[slug]/companies/companies-table.tsxindex 09439783..b2356b13 100644--- a/apps/app/app/(app)/[slug]/companies/companies-table.tsx+++ b/apps/app/app/(app)/[slug]/companies/companies-table.tsx@@ -1,5 +1,7 @@"use client";+import Archive from "@carbon/icons-react/es/Archive";+import { Button } from "@crm/ui/components/button";import {DataTable,type DataTableColumn,@@ -15,12 +17,15 @@ import { useQuery } from "@tanstack/react-query";import { useMemo } from "react";import { EnrichmentIndicator } from "@/components/crm/enrichment-status";import { useFieldColumns } from "@/components/crm/fields/field-columns";+import { useFieldFacets } from "@/components/crm/fields/field-facets";import { OwnerCell } from "@/components/crm/owner-cell";import { usePrefetchRecord } from "@/components/crm/record-sheet/record-prefetch";import { useOpenRecord } from "@/components/crm/record-sheet/record-stack";import { ListSearch } from "@/components/data-table/list-search";+import { SavedViewsMenu } from "@/components/data-table/saved-views-menu";import { useTableQuery } from "@/components/data-table/use-table-query";import { LocalRelativeTime } from "@/components/local-date-time";+import { ACTIVITY_FACET_OPTIONS } from "@/lib/activity-recency";import {ENRICHMENT_FACET_OPTIONS,ENRICHMENT_POLL_MS,@@ -147,11 +152,30 @@ const COLUMNS: DataTableColumn<CompanyRow>[] = [},];+const ARCHIVED_COLUMN: DataTableColumn<CompanyRow> = {+ id: "archivedAt",+ header: "Archived",+ label: "Archived date",+ sortable: true,+ align: "right",+ width: "w-[12%]",+ cell: (row) => (+ <span className="text-muted-foreground">+ {row.archivedAt ? (+ <LocalRelativeTime date={row.archivedAt} />+ ) : (+ <EmptyCellValue />+ )}+ </span>+ ),+};+export function CompaniesTable() {const openRecord = useOpenRecord();const trpc = useTRPC();const prefetchRecord = usePrefetchRecord();- const { query, input } = useTableQuery(companiesSearchParams);+ const table = useTableQuery(companiesSearchParams);+ const { query, input, setArchived } = table;const companies = useQuery({...trpc.companies.list.queryOptions(input),@@ -171,6 +195,7 @@ export function CompaniesTable() {);const facetCounts = companies.data?.facetCounts;+ const fieldFacets = useFieldFacets("COMPANY", facetCounts);const facets: DataTableFacet[] = [{@@ -198,15 +223,43 @@ export function CompaniesTable() {(option) => (facetCounts?.enrichment?.[option.value] ?? 0) > 0,),},+ {+ id: "activity",+ label: "Activity",+ options: ACTIVITY_FACET_OPTIONS.filter(+ (option) => (facetCounts?.activity?.[option.value] ?? 0) > 0,+ ),+ },+ ...fieldFacets,];const fieldColumns = useFieldColumns<CompanyRow>("COMPANY");- const columns = useMemo(() => [...COLUMNS, ...fieldColumns], [fieldColumns]);+ const columns = useMemo(+ () =>+ input.archived+ ? [...COLUMNS, ARCHIVED_COLUMN, ...fieldColumns]+ : [...COLUMNS, ...fieldColumns],+ [fieldColumns, input.archived],+ );return (<DataTablequery={query}search={<ListSearch placeholder="Search companies by name or domain…" />}+ actions={+ <>+ <SavedViewsMenu entity="COMPANY" table={table} />+ <Button+ variant={input.archived ? "contrast" : "outline"}+ size="sm"+ className="justify-start sm:justify-center"+ onClick={() => setArchived(!input.archived)}+ >+ <Archive data-icon="inline-start" />+ Archived+ </Button>+ </>+ }columns={columns}rows={rows}total={companies.data?.total ?? 0}@@ -215,7 +268,11 @@ export function CompaniesTable() {selection={{state: selection,actions: (- <CompaniesBulkActions ids={selection.ids} onDone={selection.clear} />+ <CompaniesBulkActions+ ids={selection.ids}+ onDone={selection.clear}+ archived={input.archived}+ />),rowLabel: (row) => row.name,}}@@ -223,7 +280,11 @@ export function CompaniesTable() {loading={companies.isFetching}onRowHover={(row) => prefetchRecord({ kind: "company", id: row.id })}onRowClick={(row) => openRecord({ kind: "company", id: row.id })}- empty="No companies match this view."+ empty={+ input.archived+ ? "No archived companies."+ : "No companies match this view."+ }/>);}diff --git a/apps/app/app/(app)/[slug]/contacts/contacts-bulk-actions.tsx b/apps/app/app/(app)/[slug]/contacts/contacts-bulk-actions.tsxindex 50139c4d..5fae7fb9 100644--- a/apps/app/app/(app)/[slug]/contacts/contacts-bulk-actions.tsx+++ b/apps/app/app/(app)/[slug]/contacts/contacts-bulk-actions.tsx@@ -1,7 +1,8 @@"use client";+import Archive from "@carbon/icons-react/es/Archive";import Renew from "@carbon/icons-react/es/Renew";-import TrashCan from "@carbon/icons-react/es/TrashCan";+import Undo from "@carbon/icons-react/es/Undo";import {DropdownMenuGroup,DropdownMenuItem,@@ -31,15 +32,17 @@ function contacts(count: number): string {export function ContactsBulkActions({ids,onDone,+ archived,}: {ids: string[];onDone: () => void;+ archived: boolean;}) {const trpc = useTRPC();const cache = useCrmCache();const users = useQuery(trpc.users.list.queryOptions());- const [confirming, setConfirming] = useState(false);const [menuOpen, setMenuOpen] = useState(false);+ const [confirming, setConfirming] = useState(false);const companySearch = useRef<HTMLInputElement>(null);const onError = (error: { message: string }) => toast.error(error.message);@@ -80,11 +83,33 @@ export function ContactsBulkActions({}),);- const remove = useMutation(- trpc.contacts.bulkDelete.mutationOptions({+ const archive = useMutation(+ trpc.contacts.bulkArchive.mutationOptions({+ onSuccess: async (result, variables) => {+ await cache.removedMany({ kind: "contact", ids: variables.ids });+ reportBulk(result, (count) => `${contacts(count)} archived.`);+ onDone();+ },+ onError,+ }),+ );++ const restore = useMutation(+ trpc.contacts.bulkRestore.mutationOptions({+ onSuccess: async (result) => {+ await cache.contact();+ reportBulk(result, (count) => `${contacts(count)} restored.`);+ onDone();+ },+ onError,+ }),+ );++ const purge = useMutation(+ trpc.contacts.bulkPurge.mutationOptions({onSuccess: async (result, variables) => {await cache.removedMany({ kind: "contact", ids: variables.ids });- reportBulk(result, (count) => `${contacts(count)} deleted.`);+ reportBulk(result, (count) => `${contacts(count)} deleted forever.`);setConfirming(false);onDone();},@@ -92,69 +117,90 @@ export function ContactsBulkActions({}),);+ if (archived) {+ const pending = restore.isPending || purge.isPending;++ return (+ <>+ <BulkActionsMenu pending={pending}>+ <DropdownMenuGroup>+ <DropdownMenuItem onSelect={() => restore.mutate({ ids })}>+ <Undo />+ Restore+ </DropdownMenuItem>+ </DropdownMenuGroup>+ <DropdownMenuSeparator />+ <DropdownMenuGroup>+ <DropdownMenuItem+ variant="destructive"+ onSelect={() => setConfirming(true)}+ >+ Delete forever+ </DropdownMenuItem>+ </DropdownMenuGroup>+ </BulkActionsMenu>++ <BulkDeleteDialog+ open={confirming}+ onOpenChange={setConfirming}+ title={`Delete ${contacts(ids.length)} forever?`}+ description="Their email addresses are suppressed, so the inbox sync will not file them again. This cannot be undone."+ onConfirm={() => purge.mutate({ ids })}+ />+ </>+ );+ }+const pending =assignOwner.isPending ||setCompany.isPending ||enrich.isPending ||- remove.isPending;+ archive.isPending;return (- <>- <BulkActionsMenu- pending={pending}- open={menuOpen}- onOpenChange={setMenuOpen}- >- <BulkOwnerMenu- users={users.data ?? []}- unassignedLabel="Nobody"- onSelect={(ownerId) => assignOwner.mutate({ ids, ownerId })}- />- <DropdownMenuSub>- <DropdownMenuSubTrigger>Move to company</DropdownMenuSubTrigger>- <DropdownMenuSubContent- className="w-64 p-0"- onFocus={(event) => {- if (event.target === event.currentTarget) {- companySearch.current?.focus();- }- }}- >- <CompanyMenuSearch- none="No company"- inputRef={companySearch}- onSelect={(companyId) => {- setMenuOpen(false);- setCompany.mutate({ ids, companyId });- }}- />- </DropdownMenuSubContent>- </DropdownMenuSub>- <DropdownMenuGroup>- <DropdownMenuItem onSelect={() => enrich.mutate({ ids })}>- <Renew />- Re-enrich- </DropdownMenuItem>- </DropdownMenuGroup>- <DropdownMenuSeparator />- <DropdownMenuGroup>- <DropdownMenuItem- variant="destructive"- onSelect={() => setConfirming(true)}- >- <TrashCan />- Delete- </DropdownMenuItem>- </DropdownMenuGroup>- </BulkActionsMenu>-- <BulkDeleteDialog- open={confirming}- onOpenChange={setConfirming}- title={`Delete ${contacts(ids.length)}?`}- description="Their email addresses are suppressed, so the inbox sync will not file them again. This cannot be undone."- onConfirm={() => remove.mutate({ ids })}+ <BulkActionsMenu+ pending={pending}+ open={menuOpen}+ onOpenChange={setMenuOpen}+ >+ <BulkOwnerMenu+ users={users.data ?? []}+ unassignedLabel="Nobody"+ onSelect={(ownerId) => assignOwner.mutate({ ids, ownerId })}/>- </>+ <DropdownMenuSub>+ <DropdownMenuSubTrigger>Move to company</DropdownMenuSubTrigger>+ <DropdownMenuSubContent+ className="w-64 p-0"+ onFocus={(event) => {+ if (event.target === event.currentTarget) {+ companySearch.current?.focus();+ }+ }}+ >+ <CompanyMenuSearch+ none="No company"+ inputRef={companySearch}+ onSelect={(companyId) => {+ setMenuOpen(false);+ setCompany.mutate({ ids, companyId });+ }}+ />+ </DropdownMenuSubContent>+ </DropdownMenuSub>+ <DropdownMenuGroup>+ <DropdownMenuItem onSelect={() => enrich.mutate({ ids })}>+ <Renew />+ Re-enrich+ </DropdownMenuItem>+ </DropdownMenuGroup>+ <DropdownMenuSeparator />+ <DropdownMenuGroup>+ <DropdownMenuItem onSelect={() => archive.mutate({ ids })}>+ <Archive />+ Archive+ </DropdownMenuItem>+ </DropdownMenuGroup>+ </BulkActionsMenu>);}diff --git a/apps/app/app/(app)/[slug]/contacts/contacts-search-params.ts b/apps/app/app/(app)/[slug]/contacts/contacts-search-params.tsindex 24da1e77..24e0cff3 100644--- a/apps/app/app/(app)/[slug]/contacts/contacts-search-params.ts+++ b/apps/app/app/(app)/[slug]/contacts/contacts-search-params.ts@@ -3,5 +3,12 @@ import { createListSearchParams } from "@/components/data-table/list-search-paraexport const contactsSearchParams = createListSearchParams({defaultSort: "createdAt",defaultDir: "desc",- facetIds: ["owner", "company"] as const,+ facetIds: [+ "owner",+ "company",+ "title",+ "seniority",+ "persona",+ "activity",+ ] as const,});diff --git a/apps/app/app/(app)/[slug]/contacts/contacts-table.tsx b/apps/app/app/(app)/[slug]/contacts/contacts-table.tsxindex 8b7ccb90..1847de03 100644--- a/apps/app/app/(app)/[slug]/contacts/contacts-table.tsx+++ b/apps/app/app/(app)/[slug]/contacts/contacts-table.tsx@@ -1,5 +1,7 @@"use client";+import Archive from "@carbon/icons-react/es/Archive";+import { Button } from "@crm/ui/components/button";import {DataTable,type DataTableColumn,@@ -10,16 +12,19 @@ import { PersonAvatar } from "@crm/ui/components/person-avatar";import { useSearchInput } from "@crm/ui/hooks/use-search-input";import { useTableSelection } from "@crm/ui/hooks/use-table-selection";import { useQuery } from "@tanstack/react-query";-import { useMemo, useState } from "react";+import { useEffect, useMemo, useState } from "react";import { CompanyCell } from "@/components/crm/company-cell";import { contactName } from "@/components/crm/contact-name";import { useFieldColumns } from "@/components/crm/fields/field-columns";+import { useFieldFacets } from "@/components/crm/fields/field-facets";import { OwnerCell } from "@/components/crm/owner-cell";import { usePrefetchRecord } from "@/components/crm/record-sheet/record-prefetch";import { useOpenRecord } from "@/components/crm/record-sheet/record-stack";import { ListSearch } from "@/components/data-table/list-search";+import { SavedViewsMenu } from "@/components/data-table/saved-views-menu";import { useTableQuery } from "@/components/data-table/use-table-query";import { LocalRelativeTime } from "@/components/local-date-time";+import { ACTIVITY_FACET_OPTIONS } from "@/lib/activity-recency";import { useTRPC } from "@/lib/trpc/client";import type { RouterOutputs } from "@/lib/trpc/types";import { ContactsBulkActions } from "./contacts-bulk-actions";@@ -120,11 +125,30 @@ const COLUMNS: DataTableColumn<ContactRow>[] = [},];+const ARCHIVED_COLUMN: DataTableColumn<ContactRow> = {+ id: "archivedAt",+ header: "Archived",+ label: "Archived date",+ sortable: true,+ align: "right",+ width: "w-[12%]",+ cell: (row) => (+ <span className="text-muted-foreground">+ {row.archivedAt ? (+ <LocalRelativeTime date={row.archivedAt} />+ ) : (+ <EmptyCellValue />+ )}+ </span>+ ),+};+export function ContactsTable() {const openRecord = useOpenRecord();const trpc = useTRPC();const prefetchRecord = usePrefetchRecord();- const { query, input } = useTableQuery(contactsSearchParams);+ const table = useTableQuery(contactsSearchParams);+ const { query, input, setArchived } = table;const contacts = useQuery({...trpc.contacts.list.queryOptions(input),@@ -146,8 +170,28 @@ export function ContactsTable() {const selection = useTableSelection(useMemo(() => rows.map((row) => row.id), [rows]),);+ const settledIds = useMemo(() => {+ const matching = new Set(+ rows+ .filter((row) => Boolean(row.archivedAt) === input.archived)+ .map((row) => row.id),+ );+ return selection.ids.filter((id) => matching.has(id));+ }, [rows, input.archived, selection.ids]);++ // biome-ignore lint/correctness/useExhaustiveDependencies: clearing on archived-mode change is the entire purpose of this effect.+ useEffect(() => {+ selection.clear();+ }, [input.archived]);++ const toggleArchived = (next: boolean) => {+ selection.clear();+ if (!next && query.sort === "archivedAt") query.setSort("");+ setArchived(next);+ };const facetCounts = contacts.data?.facetCounts;+ const fieldFacets = useFieldFacets("CONTACT", facetCounts);const facets: DataTableFacet[] = [{@@ -179,15 +223,64 @@ export function ContactsTable() {})),].filter((option) => (facetCounts?.company?.[option.value] ?? 0) > 0),},+ {+ id: "title",+ label: "Title",+ options: Object.keys(facetCounts?.title ?? {})+ .sort()+ .map((value) => ({ value, label: value })),+ },+ {+ id: "seniority",+ label: "Seniority",+ options: Object.keys(facetCounts?.seniority ?? {})+ .sort()+ .map((value) => ({ value, label: value })),+ },+ {+ id: "persona",+ label: "Persona",+ options: Object.keys(facetCounts?.persona ?? {})+ .sort()+ .map((value) => ({ value, label: value })),+ },+ {+ id: "activity",+ label: "Activity",+ options: ACTIVITY_FACET_OPTIONS.filter(+ (option) => (facetCounts?.activity?.[option.value] ?? 0) > 0,+ ),+ },+ ...fieldFacets,];const fieldColumns = useFieldColumns<ContactRow>("CONTACT");- const columns = useMemo(() => [...COLUMNS, ...fieldColumns], [fieldColumns]);+ const columns = useMemo(+ () =>+ input.archived+ ? [...COLUMNS, ARCHIVED_COLUMN, ...fieldColumns]+ : [...COLUMNS, ...fieldColumns],+ [fieldColumns, input.archived],+ );return (<DataTablequery={query}search={<ListSearch placeholder="Search by name, email or company…" />}+ actions={+ <>+ <SavedViewsMenu entity="CONTACT" table={table} />+ <Button+ variant={input.archived ? "contrast" : "outline"}+ size="sm"+ className="justify-start sm:justify-center"+ onClick={() => toggleArchived(!input.archived)}+ >+ <Archive data-icon="inline-start" />+ Archived+ </Button>+ </>+ }columns={columns}rows={rows}total={contacts.data?.total ?? 0}@@ -196,7 +289,11 @@ export function ContactsTable() {selection={{state: selection,actions: (- <ContactsBulkActions ids={selection.ids} onDone={selection.clear} />+ <ContactsBulkActions+ ids={settledIds}+ onDone={selection.clear}+ archived={input.archived}+ />),rowLabel: (row) => contactName(row),}}@@ -204,7 +301,11 @@ export function ContactsTable() {loading={contacts.isFetching}onRowHover={(row) => prefetchRecord({ kind: "contact", id: row.id })}onRowClick={(row) => openRecord({ kind: "contact", id: row.id })}- empty="No contacts match this view."+ empty={+ input.archived+ ? "No archived contacts."+ : "No contacts match this view."+ }/>);}diff --git a/apps/app/app/(app)/[slug]/deals/deals-bulk-actions.tsx b/apps/app/app/(app)/[slug]/deals/deals-bulk-actions.tsxindex 4ea27817..be440e9c 100644--- a/apps/app/app/(app)/[slug]/deals/deals-bulk-actions.tsx+++ b/apps/app/app/(app)/[slug]/deals/deals-bulk-actions.tsx@@ -1,6 +1,7 @@"use client";-import TrashCan from "@carbon/icons-react/es/TrashCan";+import Archive from "@carbon/icons-react/es/Archive";+import Undo from "@carbon/icons-react/es/Undo";import type { DealStage } from "@crm/db/enums";import { Button } from "@crm/ui/components/button";import {@@ -43,17 +44,19 @@ function deals(count: number): string {export function DealsBulkActions({ids,onDone,+ archived,}: {ids: string[];onDone: () => void;+ archived: boolean;}) {const trpc = useTRPC();const cache = useCrmCache();const users = useQuery(trpc.users.list.queryOptions());const reasonId = useId();- const [confirming, setConfirming] = useState(false);const [closing, setClosing] = useState<DealStage | null>(null);const [reason, setReason] = useState("");+ const [confirming, setConfirming] = useState(false);const onError = (error: { message: string }) => toast.error(error.message);@@ -81,11 +84,33 @@ export function DealsBulkActions({}),);- const remove = useMutation(- trpc.deals.bulkDelete.mutationOptions({+ const archive = useMutation(+ trpc.deals.bulkArchive.mutationOptions({onSuccess: async (result, variables) => {await cache.removedMany({ kind: "deal", ids: variables.ids });- reportBulk(result, (count) => `${deals(count)} deleted.`);+ reportBulk(result, (count) => `${deals(count)} archived.`);+ onDone();+ },+ onError,+ }),+ );++ const restore = useMutation(+ trpc.deals.bulkRestore.mutationOptions({+ onSuccess: async (result) => {+ await cache.deal();+ reportBulk(result, (count) => `${deals(count)} restored.`);+ onDone();+ },+ onError,+ }),+ );++ const purge = useMutation(+ trpc.deals.bulkPurge.mutationOptions({+ onSuccess: async (result, variables) => {+ await cache.removedMany({ kind: "deal", ids: variables.ids });+ reportBulk(result, (count) => `${deals(count)} deleted forever.`);setConfirming(false);onDone();},@@ -93,8 +118,42 @@ export function DealsBulkActions({}),);+ if (archived) {+ const archivedPending = restore.isPending || purge.isPending;++ return (+ <>+ <BulkActionsMenu pending={archivedPending}>+ <DropdownMenuGroup>+ <DropdownMenuItem onSelect={() => restore.mutate({ ids })}>+ <Undo />+ Restore+ </DropdownMenuItem>+ </DropdownMenuGroup>+ <DropdownMenuSeparator />+ <DropdownMenuGroup>+ <DropdownMenuItem+ variant="destructive"+ onSelect={() => setConfirming(true)}+ >+ Delete forever+ </DropdownMenuItem>+ </DropdownMenuGroup>+ </BulkActionsMenu>++ <BulkDeleteDialog+ open={confirming}+ onOpenChange={setConfirming}+ title={`Delete ${deals(ids.length)} forever?`}+ description="Everything filed against them — activity, notes, the amounts in your pipeline — goes too. This cannot be undone."+ onConfirm={() => purge.mutate({ ids })}+ />+ </>+ );+ }+const pending =- assignOwner.isPending || setStage.isPending || remove.isPending;+ assignOwner.isPending || setStage.isPending || archive.isPending;return (<>@@ -128,12 +187,9 @@ export function DealsBulkActions({</DropdownMenuSub><DropdownMenuSeparator /><DropdownMenuGroup>- <DropdownMenuItem- variant="destructive"- onSelect={() => setConfirming(true)}- >- <TrashCan />- Delete+ <DropdownMenuItem onSelect={() => archive.mutate({ ids })}>+ <Archive />+ Archive</DropdownMenuItem></DropdownMenuGroup></BulkActionsMenu>@@ -201,14 +257,6 @@ export function DealsBulkActions({</DialogFooter></DialogContent></Dialog>-- <BulkDeleteDialog- open={confirming}- onOpenChange={setConfirming}- title={`Delete ${deals(ids.length)}?`}- description="Everything filed against them — activity, notes, the amounts in your pipeline — goes too. This cannot be undone."- onConfirm={() => remove.mutate({ ids })}- /></>);}diff --git a/apps/app/app/(app)/[slug]/deals/deals-table.tsx b/apps/app/app/(app)/[slug]/deals/deals-table.tsxindex dc9ac3f2..0fb19ccb 100644--- a/apps/app/app/(app)/[slug]/deals/deals-table.tsx+++ b/apps/app/app/(app)/[slug]/deals/deals-table.tsx@@ -1,5 +1,7 @@"use client";+import Archive from "@carbon/icons-react/es/Archive";+import { Button } from "@crm/ui/components/button";import {DataTable,type DataTableColumn,@@ -9,10 +11,11 @@ import { EmptyCellValue } from "@crm/ui/components/empty-cell";import { useTableSelection } from "@crm/ui/hooks/use-table-selection";import { formatMoney } from "@crm/ui/lib/format";import { useQuery } from "@tanstack/react-query";-import { useMemo } from "react";+import { useEffect, useMemo } from "react";import { CLOSING_OPTIONS } from "@/components/crm/closing-window";import { CompanyCell } from "@/components/crm/company-cell";import { useFieldColumns } from "@/components/crm/fields/field-columns";+import { useFieldFacets } from "@/components/crm/fields/field-facets";import { OwnerCell } from "@/components/crm/owner-cell";import { usePrefetchRecord } from "@/components/crm/record-sheet/record-prefetch";import { useOpenRecord } from "@/components/crm/record-sheet/record-stack";@@ -123,11 +126,29 @@ const COLUMNS: DataTableColumn<DealRow>[] = [},];+const ARCHIVED_COLUMN: DataTableColumn<DealRow> = {+ id: "archivedAt",+ header: "Archived",+ label: "Archived date",+ sortable: true,+ align: "right",+ width: "w-[12%]",+ cell: (row) => (+ <span className="text-muted-foreground">+ {row.archivedAt ? (+ <LocalRelativeTime date={row.archivedAt} />+ ) : (+ <EmptyCellValue />+ )}+ </span>+ ),+};+export function DealsTable() {const openRecord = useOpenRecord();const trpc = useTRPC();const prefetchRecord = usePrefetchRecord();- const { query, input } = useTableQuery(dealsSearchParams);+ const { query, input, setArchived } = useTableQuery(dealsSearchParams);const deals = useQuery({...trpc.deals.list.queryOptions(input),@@ -139,8 +160,28 @@ export function DealsTable() {const selection = useTableSelection(useMemo(() => rows.map((row) => row.id), [rows]),);+ const settledIds = useMemo(() => {+ const matching = new Set(+ rows+ .filter((row) => Boolean(row.archivedAt) === input.archived)+ .map((row) => row.id),+ );+ return selection.ids.filter((id) => matching.has(id));+ }, [rows, input.archived, selection.ids]);++ // biome-ignore lint/correctness/useExhaustiveDependencies: clearing on archived-mode change is the entire purpose of this effect.+ useEffect(() => {+ selection.clear();+ }, [input.archived]);++ const toggleArchived = (next: boolean) => {+ selection.clear();+ if (!next && query.sort === "archivedAt") query.setSort("");+ setArchived(next);+ };const facetCounts = deals.data?.facetCounts;+ const fieldFacets = useFieldFacets("DEAL", facetCounts);const facets: DataTableFacet[] = [{@@ -168,6 +209,7 @@ export function DealsTable() {: [],),},+ ...fieldFacets,];const openValueCents = deals.data?.openValueCents;@@ -177,12 +219,29 @@ export function DealsTable() {const openPipelineCents = openValueCents ?? (uncounted > 0 ? 0 : null);const fieldColumns = useFieldColumns<DealRow>("DEAL");- const columns = useMemo(() => [...COLUMNS, ...fieldColumns], [fieldColumns]);+ const columns = useMemo(+ () =>+ input.archived+ ? [...COLUMNS, ARCHIVED_COLUMN, ...fieldColumns]+ : [...COLUMNS, ...fieldColumns],+ [fieldColumns, input.archived],+ );return (<DataTablequery={query}search={<ListSearch placeholder="Search deals by name or company…" />}+ actions={+ <Button+ variant={input.archived ? "contrast" : "outline"}+ size="sm"+ className="justify-start sm:justify-center"+ onClick={() => toggleArchived(!input.archived)}+ >+ <Archive data-icon="inline-start" />+ Archived+ </Button>+ }columns={columns}rows={rows}total={deals.data?.total ?? 0}@@ -199,7 +258,11 @@ export function DealsTable() {selection={{state: selection,actions: (- <DealsBulkActions ids={selection.ids} onDone={selection.clear} />+ <DealsBulkActions+ ids={settledIds}+ onDone={selection.clear}+ archived={input.archived}+ />),rowLabel: (row) => row.name,}}@@ -207,9 +270,11 @@ export function DealsTable() {loading={deals.isFetching}onRowHover={(row) => prefetchRecord({ kind: "deal", id: row.id })}onRowClick={(row) => openRecord({ kind: "deal", id: row.id })}- empty="No deals match this view."+ empty={+ input.archived ? "No archived deals." : "No deals match this view."+ }meta={- openPipelineCents === null ? undefined : (+ input.archived || openPipelineCents === null ? undefined : (<span>{deals.data?.total ?? 0} deals ·{" "}<span className="tabular-nums">diff --git a/apps/app/app/(app)/[slug]/settings/api-keys/api-keys-search-params.ts b/apps/app/app/(app)/[slug]/settings/api-keys/api-keys-search-params.tsnew file mode 100644index 00000000..ba14fcd7--- /dev/null+++ b/apps/app/app/(app)/[slug]/settings/api-keys/api-keys-search-params.ts@@ -0,0 +1,6 @@+import { createListSearchParams } from "@/components/data-table/list-search-params";++export const apiKeysSearchParams = createListSearchParams({+ defaultSort: "createdAt",+ defaultDir: "desc",+});diff --git a/apps/app/app/(app)/[slug]/settings/api-keys/api-keys-table.tsx b/apps/app/app/(app)/[slug]/settings/api-keys/api-keys-table.tsxnew file mode 100644index 00000000..a6737ee7--- /dev/null+++ b/apps/app/app/(app)/[slug]/settings/api-keys/api-keys-table.tsx@@ -0,0 +1,194 @@+"use client";++import TrashCan from "@carbon/icons-react/es/TrashCan";+import {+ AlertDialog,+ AlertDialogAction,+ AlertDialogCancel,+ AlertDialogContent,+ AlertDialogDescription,+ AlertDialogFooter,+ AlertDialogHeader,+ AlertDialogTitle,+ AlertDialogTrigger,+} from "@crm/ui/components/alert-dialog";+import { Badge } from "@crm/ui/components/badge";+import { Button } from "@crm/ui/components/button";+import { DataTable, type DataTableColumn } from "@crm/ui/components/data-table";+import { Icon } from "@crm/ui/components/icon";+import { useMutation, useQuery } from "@tanstack/react-query";+import { toast } from "sonner";+import { ListSearch } from "@/components/data-table/list-search";+import { useTableQuery } from "@/components/data-table/use-table-query";+import { LocalRelativeTime } from "@/components/local-date-time";+import { useCrmCache } from "@/lib/trpc/cache";+import { useTRPC } from "@/lib/trpc/client";+import type { RouterOutputs } from "@/lib/trpc/types";+import { apiKeysSearchParams } from "./api-keys-search-params";++type ApiKeyRow = RouterOutputs["apiKeys"]["list"]["rows"][number];++function isExpired(expiresAt: string | null): boolean {+ return expiresAt !== null && new Date(expiresAt).getTime() < Date.now();+}++function columns(+ onRevoke: (apiKey: ApiKeyRow) => void,+ pending: boolean,+): DataTableColumn<ApiKeyRow>[] {+ return [+ {+ id: "name",+ header: "Name",+ sortable: true,+ hideable: false,+ width: "w-[28%]",+ cell: (row) => (+ <span className="truncate font-medium">+ {row.name ?? "Untitled key"}+ </span>+ ),+ },+ {+ id: "start",+ header: "Key",+ width: "w-[20%]",+ hideBelow: "sm",+ cell: (row) => (+ <Badge variant="mono">{row.start ? `${row.start}…` : "—"}</Badge>+ ),+ },+ {+ id: "createdAt",+ header: "Created",+ sortable: true,+ width: "w-[16%]",+ hideBelow: "md",+ cell: (row) => (+ <span className="text-muted-foreground">+ <LocalRelativeTime date={row.createdAt} />+ </span>+ ),+ },+ {+ id: "lastRequest",+ header: "Last used",+ label: "Last used date",+ sortable: true,+ width: "w-[16%]",+ hideBelow: "lg",+ cell: (row) => (+ <span className="text-muted-foreground">+ {row.lastRequest ? (+ <LocalRelativeTime date={row.lastRequest} />+ ) : (+ "Never"+ )}+ </span>+ ),+ },+ {+ id: "expiresAt",+ header: "Expires",+ sortable: true,+ width: "w-[14%]",+ hideBelow: "lg",+ cell: (row) =>+ row.expiresAt ? (+ <span+ className={+ isExpired(row.expiresAt)+ ? "text-destructive"+ : "text-muted-foreground"+ }+ >+ <LocalRelativeTime date={row.expiresAt} />+ </span>+ ) : (+ <span className="text-muted-foreground">Never</span>+ ),+ },+ {+ id: "actions",+ header: <span className="sr-only">Actions</span>,+ label: "Actions",+ hideable: false,+ align: "right",+ width: "w-[6%]",+ cell: (row) => (+ <AlertDialog>+ <AlertDialogTrigger asChild>+ <Button variant="ghost" size="icon" disabled={pending}>+ <Icon icon={TrashCan} />+ <span className="sr-only">+ Revoke {row.name ?? "this API key"}+ </span>+ </Button>+ </AlertDialogTrigger>++ <AlertDialogContent>+ <AlertDialogHeader>+ <AlertDialogTitle>+ Revoke {row.name ?? "this API key"}?+ </AlertDialogTitle>+ <AlertDialogDescription>+ Anything using it stops working immediately. This cannot be+ undone.+ </AlertDialogDescription>+ </AlertDialogHeader>++ <AlertDialogFooter>+ <AlertDialogCancel>Cancel</AlertDialogCancel>+ <AlertDialogAction+ variant="destructive"+ onClick={() => onRevoke(row)}+ >+ Revoke+ </AlertDialogAction>+ </AlertDialogFooter>+ </AlertDialogContent>+ </AlertDialog>+ ),+ },+ ];+}++export function ApiKeysTable() {+ const trpc = useTRPC();+ const cache = useCrmCache();+ const { query, input } = useTableQuery(apiKeysSearchParams);++ const apiKeys = useQuery({+ ...trpc.apiKeys.list.queryOptions(input),+ placeholderData: (previous) => previous,+ });++ const revoke = useMutation(+ trpc.apiKeys.revoke.mutationOptions({+ onSuccess: async () => {+ if (apiKeys.data?.rows.length === 1 && query.page > 1) {+ await query.setPage(query.page - 1);+ }+ await cache.apiKeys();+ toast.success("API key revoked.");+ },+ onError: (error) => toast.error(error.message),+ }),+ );++ return (+ <DataTable+ query={query}+ search={<ListSearch placeholder="Search by name…" />}+ columns={columns(+ (apiKey) => revoke.mutate({ id: apiKey.id }),+ revoke.isPending,+ )}+ rows={apiKeys.data?.rows ?? []}+ total={apiKeys.data?.total ?? 0}+ getRowId={(row) => row.id}+ loading={apiKeys.isFetching}+ empty="No API keys yet."+ />+ );+}diff --git a/apps/app/app/(app)/[slug]/settings/api-keys/create-api-key-sheet.tsx b/apps/app/app/(app)/[slug]/settings/api-keys/create-api-key-sheet.tsxnew file mode 100644index 00000000..d35e5677--- /dev/null+++ b/apps/app/app/(app)/[slug]/settings/api-keys/create-api-key-sheet.tsx@@ -0,0 +1,193 @@+"use client";++import Add from "@carbon/icons-react/es/Add";+import { Button } from "@crm/ui/components/button";+import {+ Field,+ FieldDescription,+ FieldGroup,+ FieldLabel,+} from "@crm/ui/components/field";+import { Icon } from "@crm/ui/components/icon";+import { Input } from "@crm/ui/components/input";+import {+ Select,+ SelectContent,+ SelectItem,+ SelectTrigger,+ SelectValue,+} from "@crm/ui/components/select";+import {+ Sheet,+ SheetClose,+ SheetContent,+ SheetDescription,+ SheetFooter,+ SheetHeader,+ SheetTitle,+ SheetTrigger,+} from "@crm/ui/components/sheet";+import { Spinner } from "@crm/ui/components/spinner";+import { useMutation } from "@tanstack/react-query";+import { parseAsBoolean, useQueryState } from "nuqs";+import { type ComponentProps, Suspense, useId, useState } from "react";+import { toast } from "sonner";+import { useCrmCache } from "@/lib/trpc/cache";+import { useTRPC } from "@/lib/trpc/client";+import type { RouterOutputs } from "@/lib/trpc/types";+import { CreatedApiKeyDialog } from "./created-api-key-dialog";++const FORM = "create-api-key";++const EXPIRATION_OPTIONS = [+ { value: "30", label: "30 days" },+ { value: "90", label: "90 days" },+ { value: "365", label: "1 year" },+ { value: "never", label: "No expiration" },+] as const;++type ExpirationValue = (typeof EXPIRATION_OPTIONS)[number]["value"];++type CreatedApiKey = RouterOutputs["apiKeys"]["create"];++function NewApiKeyButton(props: ComponentProps<typeof Button>) {+ return (+ <Button {...props}>+ <Icon icon={Add} data-icon="inline-start" />+ New API key+ </Button>+ );+}++export function CreateApiKeySheet() {+ return (+ <Suspense fallback={<NewApiKeyButton disabled />}>+ <CreateApiKeyForm />+ </Suspense>+ );+}++function CreateApiKeyForm() {+ const trpc = useTRPC();+ const cache = useCrmCache();++ const nameId = useId();+ const expirationId = useId();++ const [open, setOpen] = useQueryState(+ "new",+ parseAsBoolean.withDefault(false),+ );+ const [name, setName] = useState("");+ const [expiration, setExpiration] = useState<ExpirationValue>("90");+ const [created, setCreated] = useState<CreatedApiKey | null>(null);++ const create = useMutation(+ trpc.apiKeys.create.mutationOptions({+ onSuccess: async (apiKey) => {+ await cache.apiKeys();+ await setOpen(null);+ setName("");+ setExpiration("90");+ setCreated(apiKey);+ },+ onError: (error) => toast.error(error.message),+ }),+ );++ return (+ <>+ <Sheet open={open} onOpenChange={(next) => setOpen(next || null)}>+ <SheetTrigger asChild>+ <NewApiKeyButton />+ </SheetTrigger>++ <SheetContent side="right">+ <SheetHeader>+ <SheetTitle>New API key</SheetTitle>+ <SheetDescription>+ Acts as you. Anything it can read or change is exactly what you+ can.+ </SheetDescription>+ </SheetHeader>++ <form+ id={FORM}+ className="flex-1 overflow-y-auto px-4"+ onSubmit={(event) => {+ event.preventDefault();+ create.mutate({+ name: name.trim(),+ expiresInDays:+ expiration === "never" ? null : Number(expiration),+ });+ }}+ >+ <FieldGroup>+ <Field>+ <FieldLabel htmlFor={nameId}>Name</FieldLabel>+ <Input+ id={nameId}+ value={name}+ onChange={(event) => setName(event.target.value)}+ placeholder="CI pipeline"+ maxLength={64}+ autoComplete="off"+ autoCapitalize="off"+ autoCorrect="off"+ spellCheck={false}+ required+ />+ <FieldDescription>+ Something you will recognise later, like where it runs.+ </FieldDescription>+ </Field>++ <Field>+ <FieldLabel htmlFor={expirationId}>Expires</FieldLabel>+ <Select+ value={expiration}+ onValueChange={(value) =>+ setExpiration(value as ExpirationValue)+ }+ >+ <SelectTrigger id={expirationId} className="w-full">+ <SelectValue />+ </SelectTrigger>+ <SelectContent>+ {EXPIRATION_OPTIONS.map((option) => (+ <SelectItem key={option.value} value={option.value}>+ {option.label}+ </SelectItem>+ ))}+ </SelectContent>+ </Select>+ </Field>+ </FieldGroup>+ </form>++ <SheetFooter>+ <Button+ type="submit"+ form={FORM}+ disabled={!name.trim() || create.isPending}+ >+ {create.isPending ? <Spinner /> : null}+ Create key+ </Button>+ <SheetClose asChild>+ <Button variant="outline">Cancel</Button>+ </SheetClose>+ </SheetFooter>+ </SheetContent>+ </Sheet>++ <CreatedApiKeyDialog+ apiKey={created}+ onOpenChange={(next) => {+ if (!next) setCreated(null);+ }}+ />+ </>+ );+}diff --git a/apps/app/app/(app)/[slug]/settings/api-keys/created-api-key-dialog.tsx b/apps/app/app/(app)/[slug]/settings/api-keys/created-api-key-dialog.tsxnew file mode 100644index 00000000..1baa59c4--- /dev/null+++ b/apps/app/app/(app)/[slug]/settings/api-keys/created-api-key-dialog.tsx@@ -0,0 +1,56 @@+"use client";++import { Button } from "@crm/ui/components/button";+import {+ Dialog,+ DialogContent,+ DialogDescription,+ DialogFooter,+ DialogHeader,+ DialogTitle,+} from "@crm/ui/components/dialog";+import {+ InputGroup,+ InputGroupAddon,+ InputGroupInput,+} from "@crm/ui/components/input-group";+import type { RouterOutputs } from "@/lib/trpc/types";+import { CopyValue } from "../copy-value";++type CreatedApiKey = RouterOutputs["apiKeys"]["create"];++export function CreatedApiKeyDialog({+ apiKey,+ onOpenChange,+}: {+ apiKey: CreatedApiKey | null;+ onOpenChange: (open: boolean) => void;+}) {+ return (+ <Dialog open={apiKey !== null} onOpenChange={onOpenChange}>+ <DialogContent>+ <DialogHeader>+ <DialogTitle>{apiKey?.name ?? "API key"} created</DialogTitle>+ <DialogDescription>+ Copy it now. Nobody, including us, can show it to you again.+ </DialogDescription>+ </DialogHeader>++ <InputGroup>+ <InputGroupInput+ value={apiKey?.key ?? ""}+ readOnly+ className="font-mono"+ />+ <InputGroupAddon align="inline-end">+ <CopyValue value={apiKey?.key ?? ""} label="API key" />+ </InputGroupAddon>+ </InputGroup>++ <DialogFooter>+ <Button onClick={() => onOpenChange(false)}>Done</Button>+ </DialogFooter>+ </DialogContent>+ </Dialog>+ );+}diff --git a/apps/app/app/(app)/[slug]/settings/api-keys/page.tsx b/apps/app/app/(app)/[slug]/settings/api-keys/page.tsxnew file mode 100644index 00000000..9503fda8--- /dev/null+++ b/apps/app/app/(app)/[slug]/settings/api-keys/page.tsx@@ -0,0 +1,71 @@+import type { Metadata } from "next";+import { Suspense } from "react";+import {+ PageShell,+ PageShellActions,+ PageShellContent,+ PageShellDescription,+ PageShellHeader,+ PageShellHeading,+ PageShellLoading,+ PageShellTitle,+} from "@/components/page-shell";+import { requireSession } from "@/lib/session";+import { HydrateClient } from "@/lib/trpc/hydrate";+import { getServerQueryClient, getServerTrpc } from "@/lib/trpc/server";+import { apiKeysSearchParams } from "./api-keys-search-params";+import { ApiKeysTable } from "./api-keys-table";+import { CreateApiKeySheet } from "./create-api-key-sheet";++export const metadata: Metadata = {+ title: "API Keys",+};++export default function ApiKeysSettingsPage({+ searchParams,+}: PageProps<"/[slug]/settings/api-keys">) {+ return (+ <PageShell className="min-h-0">+ <PageShellHeader>+ <PageShellHeading>+ <PageShellTitle>API Keys</PageShellTitle>+ <PageShellDescription>+ Personal keys for calling the CRM API. Each one acts as you —+ anything it can read or change is exactly what you can.+ </PageShellDescription>+ </PageShellHeading>++ <PageShellActions>+ <CreateApiKeySheet />+ </PageShellActions>+ </PageShellHeader>++ <PageShellContent className="min-h-0">+ <Suspense fallback={<PageShellLoading />}>+ <ApiKeys searchParams={searchParams} />+ </Suspense>+ </PageShellContent>+ </PageShell>+ );+}++async function ApiKeys({+ searchParams,+}: Pick<PageProps<"/[slug]/settings/api-keys">, "searchParams">) {+ await requireSession();++ const values = await apiKeysSearchParams.load(searchParams);++ const trpc = getServerTrpc();+ const queryClient = getServerQueryClient();++ await queryClient.prefetchQuery(+ trpc.apiKeys.list.queryOptions(apiKeysSearchParams.toInput(values)),+ );++ return (+ <HydrateClient>+ <ApiKeysTable />+ </HydrateClient>+ );+}diff --git a/apps/app/app/(app)/[slug]/settings/archive-retention.tsx b/apps/app/app/(app)/[slug]/settings/archive-retention.tsxnew file mode 100644index 00000000..d43eef32--- /dev/null+++ b/apps/app/app/(app)/[slug]/settings/archive-retention.tsx@@ -0,0 +1,109 @@+"use client";++import { Button } from "@crm/ui/components/button";+import {+ Card,+ CardAction,+ CardContent,+ CardDescription,+ CardHeader,+ CardTitle,+} from "@crm/ui/components/card";+import {+ Field,+ FieldDescription,+ FieldGroup,+ FieldLabel,+} from "@crm/ui/components/field";+import { Input } from "@crm/ui/components/input";+import { Spinner } from "@crm/ui/components/spinner";+import { useMutation, useQuery } from "@tanstack/react-query";+import { useEffect, useId, useState } from "react";+import { toast } from "sonner";+import { useCrmCache } from "@/lib/trpc/cache";+import { useTRPC } from "@/lib/trpc/client";++export function ArchiveRetention() {+ const trpc = useTRPC();+ const cache = useCrmCache();+ const daysId = useId();+ const [draft, setDraft] = useState("");++ const retention = useQuery(trpc.settings.archiveRetention.queryOptions());++ useEffect(() => {+ if (retention.data) setDraft(String(retention.data.days));+ }, [retention.data]);++ const save = useMutation(+ trpc.settings.setArchiveRetention.mutationOptions({+ onSuccess: async () => {+ await cache.settings();+ toast.success("Archive retention saved.");+ },+ onError: (error) => toast.error(error.message),+ }),+ );++ if (!retention.data) return null;++ const days = Number.parseInt(draft, 10);+ const unchanged = days === retention.data.days;++ return (+ <Card>+ <CardHeader>+ <CardTitle>Archived records</CardTitle>+ <CardDescription>+ Deleted records are archived and hidden, then pruned for good.+ </CardDescription>++ <CardAction>+ <Button+ type="submit"+ form="archive-retention"+ disabled={+ save.isPending ||+ unchanged ||+ draft.trim() === "" ||+ !Number.isFinite(days)+ }+ >+ {save.isPending ? <Spinner data-icon="inline-start" /> : null}+ Save+ </Button>+ </CardAction>+ </CardHeader>++ <CardContent>+ <form+ id="archive-retention"+ onSubmit={(event) => {+ event.preventDefault();+ if (!Number.isFinite(days)) {+ toast.error("Enter a number of days.");+ return;+ }+ save.mutate({ days });+ }}+ >+ <FieldGroup>+ <Field>+ <FieldLabel htmlFor={daysId}>+ Prune archived records after+ </FieldLabel>+ <Input+ id={daysId}+ inputMode="numeric"+ value={draft}+ disabled={save.isPending}+ onChange={(event) => setDraft(event.target.value)}+ />+ <FieldDescription>Days. 180 is the default.</FieldDescription>+ </Field>+ </FieldGroup>+ </form>+ </CardContent>+ </Card>+ );+}diff --git a/apps/app/app/(app)/[slug]/settings/sso/copy-value.tsx b/apps/app/app/(app)/[slug]/settings/copy-value.tsxsimilarity index 100%rename from apps/app/app/(app)/[slug]/settings/sso/copy-value.tsxrename to apps/app/app/(app)/[slug]/settings/copy-value.tsxdiff --git a/apps/app/app/(app)/[slug]/settings/page.tsx b/apps/app/app/(app)/[slug]/settings/page.tsxindex 4a6a3d66..284c9f0e 100644--- a/apps/app/app/(app)/[slug]/settings/page.tsx+++ b/apps/app/app/(app)/[slug]/settings/page.tsx@@ -13,6 +13,7 @@ import { requireSession } from "@/lib/session";import { HydrateClient } from "@/lib/trpc/hydrate";import { getServerQueryClient, getServerTrpc } from "@/lib/trpc/server";import { AgentModel } from "./agent-model";+import { ArchiveRetention } from "./archive-retention";import { ResearchKey } from "./research-key";import { WorkspaceForm } from "./workspace-form";@@ -52,6 +53,7 @@ async function Settings() {queryClient.prefetchQuery(trpc.settings.agentModel.queryOptions()),queryClient.prefetchQuery(trpc.settings.modelCatalog.queryOptions()),queryClient.prefetchQuery(trpc.settings.researchKey.queryOptions()),+ queryClient.prefetchQuery(trpc.settings.archiveRetention.queryOptions()),]);return (@@ -59,6 +61,7 @@ async function Settings() {<div className="flex max-w-3xl flex-col gap-6"><WorkspaceForm /><ResearchKey />+ <ArchiveRetention /><AgentModel /></div></HydrateClient>diff --git a/apps/app/app/(app)/[slug]/settings/settings-sidebar.tsx b/apps/app/app/(app)/[slug]/settings/settings-sidebar.tsxindex 34a647f4..cdce91b4 100644--- a/apps/app/app/(app)/[slug]/settings/settings-sidebar.tsx+++ b/apps/app/app/(app)/[slug]/settings/settings-sidebar.tsx@@ -20,6 +20,7 @@ const ITEMS: SettingsNavItem[] = [{ title: "Connections", href: `${ROOT}/connections` },{ title: "Currencies", href: `${ROOT}/currencies` },{ title: "Members", href: `${ROOT}/members` },+ { title: "API Keys", href: `${ROOT}/api-keys` },{ title: "SSO", href: `${ROOT}/sso` },];diff --git a/apps/app/app/(app)/[slug]/settings/sso/add-sso-provider-sheet.tsx b/apps/app/app/(app)/[slug]/settings/sso/add-sso-provider-sheet.tsxindex ef5ca645..bbe04110 100644--- a/apps/app/app/(app)/[slug]/settings/sso/add-sso-provider-sheet.tsx+++ b/apps/app/app/(app)/[slug]/settings/sso/add-sso-provider-sheet.tsx@@ -32,7 +32,7 @@ import { type ComponentProps, Suspense, useId, useState } from "react";import { toast } from "sonner";import { useCrmCache } from "@/lib/trpc/cache";import { useTRPC } from "@/lib/trpc/client";-import { CopyValue } from "./copy-value";+import { CopyValue } from "../copy-value";const FORM = "add-sso-provider";diff --git a/apps/app/app/(app)/[slug]/settings/sso/sso-table.tsx b/apps/app/app/(app)/[slug]/settings/sso/sso-table.tsxindex 928a1353..010a7f5b 100644--- a/apps/app/app/(app)/[slug]/settings/sso/sso-table.tsx+++ b/apps/app/app/(app)/[slug]/settings/sso/sso-table.tsx@@ -22,7 +22,7 @@ import { useTableQuery } from "@/components/data-table/use-table-query";import { useCrmCache } from "@/lib/trpc/cache";import { useTRPC } from "@/lib/trpc/client";import type { RouterOutputs } from "@/lib/trpc/types";-import { CopyValue } from "./copy-value";+import { CopyValue } from "../copy-value";import { ssoSearchParams } from "./sso-search-params";type ProviderRow = RouterOutputs["sso"]["list"]["rows"][number];diff --git a/apps/app/components/agent-builder/team-agent-detail.tsx b/apps/app/components/agent-builder/team-agent-detail.tsxindex 4bfb6777..fa4c0e3e 100644--- a/apps/app/components/agent-builder/team-agent-detail.tsx+++ b/apps/app/components/agent-builder/team-agent-detail.tsx@@ -349,8 +349,7 @@ function DraftAgentActions({const trpc = useTRPC();const queryClient = useQueryClient();const workspaceUrl = useWorkspaceUrl();- const deployable =- version?.status === "READY" || version?.status === "DEPLOYED";+ const deployable = version?.status === "READY";const deploy = useMutation(trpc.agents.deploy.mutationOptions({onSuccess: async () => {diff --git a/apps/app/components/app-icon-rail.tsx b/apps/app/components/app-icon-rail.tsxindex bb5b9063..ad3440e0 100644--- a/apps/app/components/app-icon-rail.tsx+++ b/apps/app/components/app-icon-rail.tsx@@ -1,15 +1,15 @@"use client";import Building from "@carbon/icons-react/es/Building";-import type { CarbonIconType } from "@carbon/icons-react/es/CarbonIcon";-import Chat from "@carbon/icons-react/es/Chat";import Close from "@carbon/icons-react/es/Close";import Dashboard from "@carbon/icons-react/es/Dashboard";import Partnership from "@carbon/icons-react/es/Partnership";import Settings from "@carbon/icons-react/es/Settings";import UserMultiple from "@carbon/icons-react/es/UserMultiple";import { Button } from "@crm/ui/components/button";+import type { CarbonIcon } from "@crm/ui/components/icon";import { Icon } from "@crm/ui/components/icon";+import Bot from "@crm/ui/components/icons/bot";import {Sheet,SheetContent,@@ -33,7 +33,8 @@ import { useWorkspaceUrl } from "@/lib/use-workspace-url";type RailItem = {title: string;href: string;- icon: CarbonIconType;+ icon: CarbonIcon;+ iconClassName?: string;match: "exact" | "prefix";related?: string[];};@@ -43,7 +44,8 @@ const ITEMS: RailItem[] = [{title: "Chat",href: "/chat",- icon: Chat,+ icon: Bot,+ iconClassName: "size-5",match: "prefix",related: ["/agents"],},@@ -96,7 +98,7 @@ function RailLink({aria-current={active ? "page" : undefined}transitionTypes={["nav-lateral"]}>- <Icon icon={item.icon} />+ <Icon icon={item.icon} className={item.iconClassName} /><span className="sr-only">{item.title}</span></Link></Button>@@ -138,7 +140,7 @@ function MobileRailLink({item.title === "Chat" ? "nav-forward" : "nav-lateral",]}>- <Icon icon={item.icon} />+ <Icon icon={item.icon} className={item.iconClassName} /><span>{item.title}</span></Link></Button>@@ -175,7 +177,7 @@ function MobileRailIconLink({aria-current={active ? "page" : undefined}onClick={onNavigate}>- <Icon icon={item.icon} />+ <Icon icon={item.icon} className={item.iconClassName} /><span className="sr-only">{item.title}</span></Link></Button>@@ -197,7 +199,7 @@ export function AppIconRailFallback() {disabledclassName="text-muted-foreground">- <Icon icon={item.icon} />+ <Icon icon={item.icon} className={item.iconClassName} /><span className="sr-only">{item.title}</span></Button>))}diff --git a/apps/app/components/crm/company-picker.tsx b/apps/app/components/crm/company-picker.tsxindex 31c870bb..8847a9a1 100644--- a/apps/app/components/crm/company-picker.tsx+++ b/apps/app/components/crm/company-picker.tsx@@ -143,9 +143,9 @@ export function CompanyMenuSearch({disabled={stale}onSelect={() => onSelect(company.id)}>- <span className="truncate">{company.name}</span>+ <span className="w-32 shrink-0 truncate">{company.name}</span>{company.domain ? (- <span className="ml-auto truncate text-muted-foreground text-xs">+ <span className="truncate text-muted-foreground text-xs">{company.domain}</span>) : null}diff --git a/apps/app/components/crm/fields/field-editor.tsx b/apps/app/components/crm/fields/field-editor.tsxindex e5afe92d..ab0e5ef9 100644--- a/apps/app/components/crm/fields/field-editor.tsx+++ b/apps/app/components/crm/fields/field-editor.tsx@@ -55,6 +55,7 @@ import {BRIEF_LABEL,CANCEL,FILL_REST,+ filterPlacement,KEY_HELP,KEY_LABEL,LABEL_LABEL,@@ -83,6 +84,7 @@ type Draft = {agentBrief: string;showOnSheet: boolean;showOnTable: boolean;+ showOnFilter: boolean;};const TYPE_HINTS = {@@ -117,6 +119,7 @@ function draftFrom(field: FieldRecord | undefined): Draft {agentBrief: field?.agentBrief ?? "",showOnSheet: field?.showOnSheet ?? true,showOnTable: field?.showOnTable ?? false,+ showOnFilter: field?.showOnFilter ?? false,};}@@ -220,6 +223,7 @@ export function FieldEditor({const key = field?.key ?? fieldKeyFromLabel(draft.label);const saving = create.isPending || update.isPending;+ const filterable = draft.type === "SELECT" || draft.type === "USER";const save = () => {const payload = {@@ -230,6 +234,7 @@ export function FieldEditor({agentBrief: draft.agentBrief.trim() || null,showOnSheet: draft.showOnSheet,showOnTable: draft.showOnTable,+ showOnFilter: filterable && draft.showOnFilter,};if (field) {@@ -402,6 +407,17 @@ export function FieldEditor({/>{tablePlacement(entity)}</FieldLabel>+ {filterable ? (+ <FieldLabel className="items-center gap-2 font-normal">+ <Checkbox+ checked={draft.showOnFilter}+ onCheckedChange={(checked) =>+ patch({ showOnFilter: checked === true })+ }+ />+ {filterPlacement(entity)}+ </FieldLabel>+ ) : null}</div></div>diff --git a/apps/app/components/crm/fields/field-facets.tsx b/apps/app/components/crm/fields/field-facets.tsxnew file mode 100644index 00000000..76e4b081--- /dev/null+++ b/apps/app/components/crm/fields/field-facets.tsx@@ -0,0 +1,44 @@+"use client";++import type { DataTableFacet } from "@crm/ui/components/data-table";+import { useQuery } from "@tanstack/react-query";+import { useMemo } from "react";+import { useTRPC } from "@/lib/trpc/client";+import type { FieldEntity } from "./fields-entity";++/**+ * SELECT and USER admin fields become filter facets automatically — no+ * per-field opt-in, mirroring `fields.filterableFieldsFor` on the API.+ */+export function useFieldFacets(+ entity: FieldEntity,+ facetCounts: Record<string, Record<string, number>> | undefined,+): DataTableFacet[] {+ const trpc = useTRPC();+ const fields = useQuery(trpc.fields.filters.queryOptions({ entity }));+ const users = useQuery(trpc.users.list.queryOptions());++ return useMemo(() => {+ if (!fields.data) return [];++ return fields.data.map((field) => {+ const counts = facetCounts?.[`field:${field.key}`];+ const options =+ field.type === "USER"+ ? (users.data ?? []).map((user) => ({+ value: user.id,+ label: user.name,+ }))+ : field.options.map((option) => ({+ value: option.id,+ label: option.label,+ }));++ return {+ id: `field:${field.key}`,+ label: field.label,+ options: options.filter((option) => (counts?.[option.value] ?? 0) > 0),+ };+ });+ }, [fields.data, users.data, facetCounts]);+}diff --git a/apps/app/components/crm/fields/fields-copy.ts b/apps/app/components/crm/fields/fields-copy.tsindex 9c2648f6..7f209b58 100644--- a/apps/app/components/crm/fields/fields-copy.ts+++ b/apps/app/components/crm/fields/fields-copy.ts@@ -15,6 +15,9 @@ export function subtitleFor(kind: RecordKind): string {export const STANDARD_ROW = "Standard fields";export const STANDARD_NOTE = "reorder and hide only";+export const SUGGESTED_ROW = "Suggested fields";+export const SUGGESTED_NOTE = "one click to add";+export const ADD = "Add";export const CUSTOM_GROUP = "Custom fields";export const DRAG_NOTE = "Drag to order";export const ARCHIVED_ROW = "Archived";@@ -23,6 +26,7 @@ export const NEW_FIELD = "New field";export const ORDER_NOTE = "Order here is the order on the sheet";export const MANUAL_ONLY = "Manual only";export const TABLE_NOTE = "also a column on the table";+export const FILTER_NOTE = "also a filter";export const EMPTY_TITLE = "No custom fields yet";export const EMPTY_BODY =@@ -69,6 +73,12 @@ const TABLE_PLACEMENT = {DEAL: "Offer as a column on the Deals table",} satisfies Record<FieldEntity, string>;+const FILTER_PLACEMENT = {+ COMPANY: "Offer as a filter on the Companies table",+ CONTACT: "Offer as a filter on the Contacts table",+ DEAL: "Offer as a filter on the Deals table",+} satisfies Record<FieldEntity, string>;+export function sheetPlacement(entity: FieldEntity): string {return SHEET_PLACEMENT[entity];}@@ -77,6 +87,10 @@ export function tablePlacement(entity: FieldEntity): string {return TABLE_PLACEMENT[entity];}+export function filterPlacement(entity: FieldEntity): string {+ return FILTER_PLACEMENT[entity];+}+export const ENTITY_TABS = [{ kind: "company", label: "Companies" },{ kind: "contact", label: "Contacts" },diff --git a/apps/app/components/crm/fields/fields-list.tsx b/apps/app/components/crm/fields/fields-list.tsxindex b95b18c0..83521701 100644--- a/apps/app/components/crm/fields/fields-list.tsx+++ b/apps/app/components/crm/fields/fields-list.tsx@@ -5,6 +5,7 @@ import ChevronRight from "@carbon/icons-react/es/ChevronRight";import OverflowMenuVertical from "@carbon/icons-react/es/OverflowMenuVertical";import Renew from "@carbon/icons-react/es/Renew";import Warning from "@carbon/icons-react/es/Warning";+import { fieldKeyFromLabel, typeLabel } from "@crm/db/fields-shape";import { Badge } from "@crm/ui/components/badge";import { Button } from "@crm/ui/components/button";import {@@ -30,12 +31,14 @@ import {import { Icon } from "@crm/ui/components/icon";import { SortableItem, SortableList } from "@crm/ui/components/sortable-list";import { Spinner } from "@crm/ui/components/spinner";+import { FIELD_TEMPLATES } from "@crm/validation/field-templates";import { useMutation, useQuery, useQueryClient } from "@tanstack/react-query";import { toast } from "sonner";import { useCrmCache } from "@/lib/trpc/cache";import { useTRPC } from "@/lib/trpc/client";import type { RouterOutputs } from "@/lib/trpc/types";import {+ ADD,ARCHIVED_NOTE,ARCHIVED_ROW,CUSTOM_GROUP,@@ -44,12 +47,15 @@ import {EMPTY_TITLE,ERROR_BODY,ERROR_TITLE,+ FILTER_NOTE,MANUAL_ONLY,NEW_FIELD,ORDER_NOTE,RETRY,STANDARD_NOTE,STANDARD_ROW,+ SUGGESTED_NOTE,+ SUGGESTED_ROW,TABLE_NOTE,} from "./fields-copy";import { type FieldEntity, kindOf } from "./fields-entity";@@ -75,6 +81,7 @@ function summaryOf(field: Field): string {}if (field.showOnTable) parts.push(TABLE_NOTE);+ if (field.showOnFilter) parts.push(FILTER_NOTE);return parts.join(" · ");}@@ -177,11 +184,23 @@ export function FieldsList({}),);+ const addSuggested = useMutation(+ trpc.fields.create.mutationOptions({+ onSuccess: () => cache.fields(kindOf(entity)),+ onError: (error) => toast.error(error.message),+ }),+ );+const all = query.data ?? [];const live = all.filter((field) => !field.archived);const archived = all.filter((field) => field.archived);const standard = STANDARD_FIELDS[entity];+ const existingKeys = new Set(all.map((field) => field.key));+ const suggestions = FIELD_TEMPLATES[entity].filter(+ (template) => !existingKeys.has(fieldKeyFromLabel(template.label)),+ );+return (<><div className="flex min-h-0 flex-1 flex-col overflow-y-auto">@@ -201,6 +220,54 @@ export function FieldsList({</ul></DisclosureRow>+ {suggestions.length > 0 && (+ <DisclosureRow+ title={SUGGESTED_ROW}+ note={`${suggestions.length} · ${SUGGESTED_NOTE}`}+ >+ <ul className="border-b bg-muted/40 py-1">+ {suggestions.map((template) => (+ <li+ key={template.label}+ className="flex items-center gap-2.5 px-5 py-1.5"+ >+ <span className="flex-1 truncate text-muted-foreground text-xs">+ {template.label}+ {template.options && template.options.length > 0+ ? ` · ${template.options.join(", ")}`+ : ` · ${typeLabel(template.type)}`}+ </span>+ <Button+ variant="outline"+ size="xs"+ disabled={addSuggested.isPending}+ onClick={() =>+ addSuggested.mutate({+ entity,+ label: template.label,+ type: template.type,+ options: (template.options ?? []).map((label) => ({+ label,+ })),+ agentFilled:+ template.type !== "USER" &&+ template.type !== "NUMBER",+ required: false,+ showOnSheet: true,+ showOnTable: false,+ showOnFilter: false,+ })+ }+ >+ <Icon icon={Add} data-icon="inline-start" />+ {ADD}+ </Button>+ </li>+ ))}+ </ul>+ </DisclosureRow>+ )}+{query.isPending ? (<div className="flex flex-1 items-center justify-center"><Spinner />diff --git a/apps/app/components/crm/record-sheet/company-sheet.tsx b/apps/app/components/crm/record-sheet/company-sheet.tsxindex bddb2368..90d89214 100644--- a/apps/app/components/crm/record-sheet/company-sheet.tsx+++ b/apps/app/components/crm/record-sheet/company-sheet.tsx@@ -259,6 +259,7 @@ export function CompanySheet({ companyId }: { companyId: string }) {record={{ kind: "company", id: company.id }}name={company.name}consequence={companyConsequence(company)}+ archivedAt={company.archivedAt}/></>) : nulldiff --git a/apps/app/components/crm/record-sheet/contact-sheet.tsx b/apps/app/components/crm/record-sheet/contact-sheet.tsxindex bd665b66..1eb78e1a 100644--- a/apps/app/components/crm/record-sheet/contact-sheet.tsx+++ b/apps/app/components/crm/record-sheet/contact-sheet.tsx@@ -208,6 +208,7 @@ export function ContactSheet({ contactId }: { contactId: string }) {record={{ kind: "contact", id: contact.id }}name={contactName(contact)}consequence={`Their notes, agent conversations and everything the agent found go too; emails and meetings stay filed against the company.${contact.email ? ` The sync will not bring ${contact.email} back — only adding them yourself will.` : ""}`}+ archivedAt={contact.archivedAt}/></>) : nulldiff --git a/apps/app/components/crm/record-sheet/deal-sheet.tsx b/apps/app/components/crm/record-sheet/deal-sheet.tsxindex e8228e75..681a15ec 100644--- a/apps/app/components/crm/record-sheet/deal-sheet.tsx+++ b/apps/app/components/crm/record-sheet/deal-sheet.tsx@@ -206,6 +206,7 @@ export function DealSheet({ dealId }: { dealId: string }) {record={{ kind: "deal", id: deal.id }}name={deal.name}consequence={`Its stage history, notes and agent conversations go too. ${deal.company.name} and the ${deal.contacts.length === 1 ? "person" : "people"} on it stay in the CRM.`}+ archivedAt={deal.archivedAt}/></>) : nulldiff --git a/apps/app/components/crm/record-sheet/record-actions.tsx b/apps/app/components/crm/record-sheet/record-actions.tsxindex d826c36f..a82a43cf 100644--- a/apps/app/components/crm/record-sheet/record-actions.tsx+++ b/apps/app/components/crm/record-sheet/record-actions.tsx@@ -1,7 +1,9 @@"use client";+import Archive from "@carbon/icons-react/es/Archive";import OverflowMenuVertical from "@carbon/icons-react/es/OverflowMenuVertical";import TrashCan from "@carbon/icons-react/es/TrashCan";+import Undo from "@carbon/icons-react/es/Undo";import {AlertDialog,AlertDialogAction,@@ -37,15 +39,59 @@ const NOUN = {deal: "deal",} satisfies Record<RecordKind, string>;-function useDeleteRecord(record: RecordRef) {+const RECORD_PROCEDURES = {+ company: "companies",+ contact: "contacts",+ deal: "deals",+} satisfies Record<RecordKind, "companies" | "contacts" | "deals">;++function useArchiveRecord(record: RecordRef) {+ const trpc = useTRPC();+ const cache = useCrmCache();++ const handlers = {+ onSuccess: (archived: { name: string }) => {+ toast.success(+ `${archived.name || `The ${NOUN[record.kind]}`} was archived.`,+ );+ void cache[record.kind](record.id);+ },+ onError: (error: { message: string }) => toast.error(error.message),+ };++ return useMutation(+ trpc[RECORD_PROCEDURES[record.kind]].archive.mutationOptions(handlers),+ );+}++function useRestoreRecord(record: RecordRef) {+ const trpc = useTRPC();+ const cache = useCrmCache();++ const handlers = {+ onSuccess: (restored: { name: string }) => {+ toast.success(+ `${restored.name || `The ${NOUN[record.kind]}`} was restored.`,+ );+ void cache[record.kind](record.id);+ },+ onError: (error: { message: string }) => toast.error(error.message),+ };++ return useMutation(+ trpc[RECORD_PROCEDURES[record.kind]].restore.mutationOptions(handlers),+ );+}++function usePurgeRecord(record: RecordRef) {const trpc = useTRPC();const cache = useCrmCache();const { close } = useRecordStack();const handlers = {- onSuccess: (deleted: { name: string }) => {+ onSuccess: (purged: { name: string }) => {toast.success(- `${deleted.name || `The ${NOUN[record.kind]}`} was deleted.`,+ `${purged.name || `The ${NOUN[record.kind]}`} was deleted forever.`,);void cache.removed(record);close();@@ -53,52 +99,70 @@ function useDeleteRecord(record: RecordRef) {onError: (error: { message: string }) => toast.error(error.message),};- const options =- record.kind === "contact"- ? trpc.contacts.delete.mutationOptions(handlers)- : record.kind === "company"- ? trpc.companies.delete.mutationOptions(handlers)- : trpc.deals.delete.mutationOptions(handlers);-- return useMutation(options);+ return useMutation(+ trpc[RECORD_PROCEDURES[record.kind]].purge.mutationOptions(handlers),+ );}export function RecordActions({record,name,consequence,+ archivedAt,}: {record: RecordRef;name: string;consequence: string;+ archivedAt: string | null;}) {const [confirming, setConfirming] = useState(false);- const remove = useDeleteRecord(record);+ const archive = useArchiveRecord(record);+ const restore = useRestoreRecord(record);+ const purge = usePurgeRecord(record);++ const pending = archive.isPending || restore.isPending || purge.isPending;return (<><DropdownMenu><DropdownMenuTrigger asChild>- <Button variant="ghost" size="icon-sm" disabled={remove.isPending}>+ <Button variant="ghost" size="icon-sm" disabled={pending}><Icon icon={OverflowMenuVertical} /><span className="sr-only">More actions</span></Button></DropdownMenuTrigger><DropdownMenuContent align="end" className="min-w-44">- <DropdownMenuItem- variant="destructive"- onSelect={() => setConfirming(true)}- >- <Icon icon={TrashCan} />- Delete {NOUN[record.kind]}- </DropdownMenuItem>+ {archivedAt ? (+ <>+ <DropdownMenuItem+ onSelect={() => restore.mutate({ id: record.id })}+ >+ <Icon icon={Undo} />+ Restore {NOUN[record.kind]}+ </DropdownMenuItem>+ <DropdownMenuItem+ variant="destructive"+ onSelect={() => setConfirming(true)}+ >+ <Icon icon={TrashCan} />+ Delete {NOUN[record.kind]} forever+ </DropdownMenuItem>+ </>+ ) : (+ <DropdownMenuItem+ onSelect={() => archive.mutate({ id: record.id })}+ >+ <Icon icon={Archive} />+ Archive {NOUN[record.kind]}+ </DropdownMenuItem>+ )}</DropdownMenuContent></DropdownMenu><AlertDialog open={confirming} onOpenChange={setConfirming}><AlertDialogContent><AlertDialogHeader>- <AlertDialogTitle>Delete {name}?</AlertDialogTitle>+ <AlertDialogTitle>Delete {name} forever?</AlertDialogTitle><AlertDialogDescription>{consequence}</AlertDialogDescription></AlertDialogHeader>@@ -106,9 +170,9 @@ export function RecordActions({<AlertDialogCancel>Cancel</AlertDialogCancel><AlertDialogActionvariant="destructive"- onClick={() => remove.mutate({ id: record.id })}+ onClick={() => purge.mutate({ id: record.id })}>- Delete+ Delete forever</AlertDialogAction></AlertDialogFooter></AlertDialogContent>diff --git a/apps/app/components/data-table/list-search-params.ts b/apps/app/components/data-table/list-search-params.tsindex ae28102f..b0fd4592 100644--- a/apps/app/components/data-table/list-search-params.ts+++ b/apps/app/components/data-table/list-search-params.ts@@ -1,43 +1,61 @@import type { SortDirection } from "@crm/ui/lib/table-query";import {createLoader,+ type GenericParserBuilder,type LoaderFunction,type ParserBuilder,+ parseAsBoolean,parseAsInteger,+ parseAsJson,+ parseAsNativeArrayOf,parseAsString,parseAsStringLiteral,} from "nuqs/server";+import { z } from "zod";const SORT_DIRECTIONS = ["asc", "desc"] as const;type StringParser = ParserBuilder<string> & { defaultValue: string };+type ArrayParser = GenericParserBuilder<string[]> & { defaultValue: string[] };++const fieldFiltersSchema = z.record(z.string(), z.array(z.string()));++export type FieldFilters = z.infer<typeof fieldFiltersSchema>;export const searchParsers = {q: parseAsString.withDefault(""),page: parseAsInteger.withDefault(1).withOptions({ history: "push" }),+ fields: parseAsJson<FieldFilters>(fieldFiltersSchema.parse).withDefault({}),+ archived: parseAsBoolean.withDefault(false),};-type ListParsers<TKey extends string> = {+type ListParsers<TTab extends string, TFacet extends string> = {q: StringParser;sort: StringParser;dir: ParserBuilder<SortDirection> & { defaultValue: SortDirection };page: ParserBuilder<number> & { defaultValue: number };-} & { [K in TKey]: StringParser };+ fields: ParserBuilder<FieldFilters> & { defaultValue: FieldFilters };+ archived: ParserBuilder<boolean> & { defaultValue: boolean };+} & { [K in TTab]: StringParser } & { [K in TFacet]: ArrayParser };-export type ListSearchValues<TKey extends string> = {+export type ListSearchValues<TTab extends string, TFacet extends string> = {q: string;sort: string;dir: SortDirection;page: number;-} & { [K in TKey]: string };+ fields: FieldFilters;+ archived: boolean;+} & { [K in TTab]: string } & { [K in TFacet]: string[] };-export type ListInput<TKey extends string> = {+export type ListInput<TTab extends string, TFacet extends string> = {q: string;sort: string;dir: SortDirection;page: number;pageSize: number;-} & { [K in TKey]: string };+ fields: FieldFilters;+ archived: boolean;+} & { [K in TTab]: string } & { [K in TFacet]: string[] };export type ListTableConfig<TTab extends string, TFacet extends string> = {defaultSort?: string;@@ -45,7 +63,7 @@ export type ListTableConfig<TTab extends string, TFacet extends string> = {pageSize?: number;tabId?: TTab;facetIds?: readonly TFacet[];- facetDefaults?: Partial<Record<TFacet, string>>;+ facetDefaults?: Partial<Record<TFacet, string[]>>;};export type ListSearchParams<TTab extends string, TFacet extends string> = {@@ -54,12 +72,10 @@ export type ListSearchParams<TTab extends string, TFacet extends string> = {defaultDir: SortDirection;pageSize: number;};- parsers: ListParsers<TTab | TFacet>;- load: LoaderFunction<ListParsers<TTab | TFacet>>;- toInput: (- values: ListSearchValues<TTab | TFacet>,- ) => ListInput<TTab | TFacet>;- defaultInput: () => ListInput<TTab | TFacet>;+ parsers: ListParsers<TTab, TFacet>;+ load: LoaderFunction<ListParsers<TTab, TFacet>>;+ toInput: (values: ListSearchValues<TTab, TFacet>) => ListInput<TTab, TFacet>;+ defaultInput: () => ListInput<TTab, TFacet>;};export function createListSearchParams<@@ -75,30 +91,35 @@ export function createListSearchParams<facetDefaults,} = config;- const extras: Record<string, StringParser> = {};+ const tabExtras: Record<string, StringParser> = {};+ if (tabId) tabExtras[tabId] = parseAsString.withDefault("all");- if (tabId) extras[tabId] = parseAsString.withDefault("all");+ const facetExtras: Record<string, ArrayParser> = {};for (const id of facetIds) {- extras[id] = parseAsString.withDefault(facetDefaults?.[id] ?? "all");+ facetExtras[id] = parseAsNativeArrayOf(parseAsString).withDefault(+ facetDefaults?.[id] ?? [],+ );}const parsers = {...searchParsers,sort: parseAsString.withDefault(defaultSort),dir: parseAsStringLiteral(SORT_DIRECTIONS).withDefault(defaultDir),- ...extras,- } as ListParsers<TTab | TFacet>;-- const keys = [...(tabId ? [tabId] : []), ...facetIds] as (TTab | TFacet)[];+ ...tabExtras,+ ...facetExtras,+ } as ListParsers<TTab, TFacet>;const defaults = Object.fromEntries(Object.entries(parsers).map(([key, parser]) => [key, parser.defaultValue]),- ) as ListSearchValues<TTab | TFacet>;+ ) as ListSearchValues<TTab, TFacet>;++ const toInput = (values: ListSearchValues<TTab, TFacet>) => {+ const selectedTab: Record<string, string> = {};+ if (tabId) selectedTab[tabId] = values[tabId] ?? "all";- const toInput = (values: ListSearchValues<TTab | TFacet>) => {- const selected: Record<string, string> = {};- for (const key of keys) {- selected[key] = values[key] ?? "all";+ const selectedFacets: Record<string, string[]> = {};+ for (const id of facetIds) {+ selectedFacets[id] = values[id] ?? facetDefaults?.[id] ?? [];}return {@@ -107,8 +128,11 @@ export function createListSearchParams<dir: values.dir,page: values.page > 0 ? values.page : 1,pageSize,- ...selected,- } as ListInput<TTab | TFacet>;+ fields: values.fields,+ archived: values.archived,+ ...selectedTab,+ ...selectedFacets,+ } as ListInput<TTab, TFacet>;};return {diff --git a/apps/app/components/data-table/saved-views-menu.tsx b/apps/app/components/data-table/saved-views-menu.tsxnew file mode 100644index 00000000..a1734239--- /dev/null+++ b/apps/app/components/data-table/saved-views-menu.tsx@@ -0,0 +1,207 @@+"use client";++import Bookmark from "@carbon/icons-react/es/Bookmark";+import Close from "@carbon/icons-react/es/Close";+import { Button } from "@crm/ui/components/button";+import {+ Dialog,+ DialogContent,+ DialogFooter,+ DialogHeader,+ DialogTitle,+} from "@crm/ui/components/dialog";+import {+ DropdownMenu,+ DropdownMenuContent,+ DropdownMenuItem,+ DropdownMenuLabel,+ DropdownMenuSeparator,+ DropdownMenuTrigger,+} from "@crm/ui/components/dropdown-menu";+import { Field, FieldLabel } from "@crm/ui/components/field";+import { Input } from "@crm/ui/components/input";+import { Switch } from "@crm/ui/components/switch";+import { useMutation, useQuery } from "@tanstack/react-query";+import { useState } from "react";+import { toast } from "sonner";+import type { FieldEntity } from "@/components/crm/fields/fields-entity";+import { useCrmCache } from "@/lib/trpc/cache";+import { useTRPC } from "@/lib/trpc/client";+import type { RouterOutputs } from "@/lib/trpc/types";+import type { TableQuery } from "./use-table-query";++type SavedView = RouterOutputs["savedViews"]["list"][number];++const RECORD_KIND = {+ COMPANY: "company",+ CONTACT: "contact",+ DEAL: "deal",+} as const satisfies Record<FieldEntity, "company" | "contact" | "deal">;++export function SavedViewsMenu({+ entity,+ table,+}: {+ entity: FieldEntity;+ table: Pick<TableQuery<string, string>, "currentView" | "applyView">;+}) {+ const trpc = useTRPC();+ const cache = useCrmCache();+ const views = useQuery(trpc.savedViews.list.queryOptions({ entity }));++ const [dialogOpen, setDialogOpen] = useState(false);+ const [name, setName] = useState("");+ const [shared, setShared] = useState(false);++ const closeDialog = () => {+ setDialogOpen(false);+ setName("");+ setShared(false);+ };++ const settle = () => cache.savedViews(RECORD_KIND[entity]);++ const create = useMutation(+ trpc.savedViews.create.mutationOptions({+ onSuccess: async () => {+ await settle();+ toast.success("View saved.");+ closeDialog();+ },+ onError: (error) => toast.error(error.message),+ }),+ );++ const remove = useMutation(+ trpc.savedViews.delete.mutationOptions({+ onSuccess: async () => {+ await settle();+ toast.success("View deleted.");+ },+ onError: (error) => toast.error(error.message),+ }),+ );++ const list = views.data ?? [];+ const mine = list.filter((view) => view.mine);+ const shared_ = list.filter((view) => !view.mine);++ return (+ <>+ <DropdownMenu>+ <DropdownMenuTrigger asChild>+ <Button+ variant="outline"+ size="sm"+ className="justify-start sm:justify-center"+ >+ <Bookmark data-icon="inline-start" />+ Views+ </Button>+ </DropdownMenuTrigger>+ <DropdownMenuContent align="end" className="min-w-56">+ <DropdownMenuItem onSelect={() => setDialogOpen(true)}>+ Save current view…+ </DropdownMenuItem>+ {list.length > 0 && <DropdownMenuSeparator />}+ {mine.length > 0 && <DropdownMenuLabel>My views</DropdownMenuLabel>}+ {mine.map((view) => (+ <ViewItem+ key={view.id}+ view={view}+ onApply={() => table.applyView(view.filters)}+ onDelete={() => remove.mutate({ id: view.id })}+ />+ ))}+ {shared_.length > 0 && (+ <DropdownMenuLabel>Shared with the team</DropdownMenuLabel>+ )}+ {shared_.map((view) => (+ <DropdownMenuItem+ key={view.id}+ onSelect={() => table.applyView(view.filters)}+ >+ <span className="truncate">{view.name}</span>+ </DropdownMenuItem>+ ))}+ </DropdownMenuContent>+ </DropdownMenu>++ <Dialog+ open={dialogOpen}+ onOpenChange={(open) => (open ? setDialogOpen(true) : closeDialog())}+ >+ <DialogContent>+ <DialogHeader>+ <DialogTitle>Save this view</DialogTitle>+ </DialogHeader>+ <div className="flex flex-col gap-4">+ <Field>+ <FieldLabel htmlFor="saved-view-name">Name</FieldLabel>+ <Input+ id="saved-view-name"+ value={name}+ onChange={(event) => setName(event.target.value)}+ autoFocus+ />+ </Field>+ <Field orientation="horizontal">+ <FieldLabel htmlFor="saved-view-shared">+ Share with the team+ </FieldLabel>+ <Switch+ id="saved-view-shared"+ checked={shared}+ onCheckedChange={setShared}+ />+ </Field>+ </div>+ <DialogFooter>+ <Button variant="outline" onClick={closeDialog}>+ Cancel+ </Button>+ <Button+ disabled={name.trim() === "" || create.isPending}+ onClick={() =>+ create.mutate({+ entity,+ name: name.trim(),+ shared,+ filters: table.currentView,+ })+ }+ >+ Save+ </Button>+ </DialogFooter>+ </DialogContent>+ </Dialog>+ </>+ );+}++function ViewItem({+ view,+ onApply,+ onDelete,+}: {+ view: SavedView;+ onApply: () => void;+ onDelete: () => void;+}) {+ return (+ <div className="flex items-center gap-1">+ <DropdownMenuItem className="min-w-0 flex-1" onSelect={onApply}>+ <span className="truncate">{view.name}</span>+ </DropdownMenuItem>+ <DropdownMenuItem+ variant="destructive"+ className="shrink-0"+ onSelect={onDelete}+ >+ <Close />+ <span className="sr-only">Delete {view.name}</span>+ </DropdownMenuItem>+ </div>+ );+}diff --git a/apps/app/components/data-table/use-table-query.ts b/apps/app/components/data-table/use-table-query.tsindex e3e98df4..ef0a2c07 100644--- a/apps/app/components/data-table/use-table-query.ts+++ b/apps/app/components/data-table/use-table-query.ts@@ -1,60 +1,183 @@"use client";-import type { TableQueryState } from "@crm/ui/lib/table-query";+import type { SortDirection, TableQueryState } from "@crm/ui/lib/table-query";+import type { SavedViewFilters } from "@crm/validation/saved-view";+import type { Nullable, Values } from "nuqs";import { useQueryStates } from "nuqs";+import { z } from "zod";import type {+ FieldFilters,ListInput,ListSearchParams,ListSearchValues,} from "./list-search-params";-export type TableQuery<TKey extends string> = {+export type TableQuery<TTab extends string, TFacet extends string = never> = {query: TableQueryState;- input: ListInput<TKey>;+ input: ListInput<TTab, TFacet>;+ setArchived: (value: boolean) => void;+ currentView: SavedViewFilters;+ applyView: (view: SavedViewFilters) => void;};+const FIELD_FILTER_PREFIX = "field:";++const fieldFiltersValueSchema = z.record(z.string(), z.array(z.string()));++const queryValueSchema = z.union([+ z.string(),+ z.number(),+ z.boolean(),+ z.array(z.string()),+ fieldFiltersValueSchema,+ z.null(),+]);++type QueryValue = z.infer<typeof queryValueSchema>;++const rawValuesSchema = z+ .object({+ q: z.string().default(""),+ sort: z.string().default(""),+ dir: z.string().default("asc"),+ page: z.number().default(1),+ fields: fieldFiltersValueSchema.default({}),+ archived: z.boolean().default(false),+ })+ .catchall(queryValueSchema);++type RawUpdate = Record<string, QueryValue | undefined>;++const stringSchema = z.string();+const stringArraySchema = z.array(z.string());++function asString(value: QueryValue, fallback = ""): string {+ const result = stringSchema.safeParse(value);+ return result.success ? result.data : fallback;+}++function asStringArray(value: QueryValue): string[] {+ const result = stringArraySchema.safeParse(value);+ return result.success ? result.data : [];+}+export function useTableQuery<TTab extends string, TFacet extends string>(searchParams: ListSearchParams<TTab, TFacet>,-): TableQuery<TTab | TFacet> {+): TableQuery<TTab, TFacet> {const { parsers, config, toInput } = searchParams;- const { defaultDir, pageSize, tabId, facetIds, facetDefaults } = config;+ const { defaultDir, pageSize, tabId, facetIds } = config;++ const [rawState, rawSetState] = useQueryStates(parsers);+ const values = rawValuesSchema.parse(rawState);- const [state, setState] = useQueryStates(parsers);- const values = state as ListSearchValues<TTab | TFacet>;+ type NuqsValues = Partial<Nullable<Values<typeof parsers>>>;- const page = values.page > 0 ? values.page : 1;- const tab = tabId ? values[tabId] : "all";+ function setValues(update: Partial<RawUpdate>): Promise<void> {+ return rawSetState(update as NuqsValues).then(() => undefined);+ }- const filters: Record<string, string> = {};- if (tabId) filters[tabId] = tab;+ const q = values.q;+ const sort = values.sort;+ const dir = values.dir === "desc" ? "desc" : "asc";+ const rawPage = values.page;+ const page = rawPage > 0 ? rawPage : 1;+ const fields = values.fields;+ const archived = values.archived;+ const tab = tabId ? asString(values[tabId]) : "all";++ const filters: Record<string, string[]> = {};+ if (tabId) filters[tabId] = [tab];for (const id of facetIds ?? []) {- filters[id] = values[id] ?? facetDefaults?.[id] ?? "all";+ filters[id] = asStringArray(values[id]);+ }+ for (const [key, selected] of Object.entries(fields)) {+ filters[`${FIELD_FILTER_PREFIX}${key}`] = selected;}const query: TableQueryState = {- sort: values.sort,- dir: values.dir,+ sort,+ dir,page,pageSize,tab,tabId,filters,toggleSort: (id) =>- setState((prev) =>- prev.sort === id- ? { ...prev, dir: prev.dir === "asc" ? "desc" : "asc", page: 1 }- : { ...prev, sort: id, dir: defaultDir, page: 1 },- ),- setSort: (id) => setState((prev) => ({ ...prev, sort: id, page: 1 })),- setDir: (dir) => setState((prev) => ({ ...prev, dir, page: 1 })),- setPage: (next) => setState((prev) => ({ ...prev, page: next })),+ rawSetState((old) => {+ const current = rawValuesSchema.parse(old);+ const nextDir: SortDirection = current.dir === "asc" ? "desc" : "asc";+ const update: RawUpdate =+ current.sort === id+ ? { dir: nextDir, page: 1 }+ : { sort: id, dir: defaultDir, page: 1 };+ return update as NuqsValues;+ }),+ setSort: (id) => setValues({ sort: id, page: 1 }),+ setDir: (nextDir) => setValues({ dir: nextDir, page: 1 }),+ setPage: (next) => setValues({ page: next }),setTab: (value) => {if (!tabId) return;- setState((prev) => ({ ...prev, [tabId]: value, page: 1 }));+ setValues({ [tabId]: value, page: 1 });+ },+ setFilter: (id, selected) => {+ if (id.startsWith(FIELD_FILTER_PREFIX)) {+ const key = id.slice(FIELD_FILTER_PREFIX.length);+ const nextFields: FieldFilters = { ...fields };+ if (selected.length === 0) delete nextFields[key];+ else nextFields[key] = selected;+ setValues({ fields: nextFields, page: 1 });+ return;+ }++ setValues({ [id]: selected, page: 1 });},- setFilter: (id, value) =>- setState((prev) => ({ ...prev, [id]: value, page: 1 })),};- return { query, input: toInput(values) };+ const input = toInput({+ q,+ sort,+ dir,+ page: rawPage,+ fields,+ archived,+ ...Object.fromEntries(+ [...(tabId ? [tabId] : []), ...(facetIds ?? [])].map((id) => [+ id,+ id === tabId ? tab : (filters[id] ?? []),+ ]),+ ),+ } as ListSearchValues<TTab, TFacet>);++ const setArchived = (value: boolean) =>+ setValues({ archived: value, page: 1 });++ const currentView: SavedViewFilters = { q, sort, dir, archived, filters };++ const applyView = (view: SavedViewFilters) => {+ const update: RawUpdate = {+ q: view.q,+ sort: view.sort,+ dir: view.dir,+ archived: view.archived,+ page: 1,+ };++ for (const id of facetIds ?? []) update[id] = [];++ const nextFields: FieldFilters = {};+ for (const [key, selected] of Object.entries(view.filters)) {+ if (key.startsWith(FIELD_FILTER_PREFIX)) {+ nextFields[key.slice(FIELD_FILTER_PREFIX.length)] = selected;+ } else if (key === tabId) {+ update[key] = selected[0] ?? "all";+ } else {+ update[key] = selected;+ }+ }+ update.fields = nextFields;++ setValues(update);+ };++ return { query, input, setArchived, currentView, applyView };}diff --git a/apps/app/lib/activity-recency.ts b/apps/app/lib/activity-recency.tsnew file mode 100644index 00000000..bb117725--- /dev/null+++ b/apps/app/lib/activity-recency.ts@@ -0,0 +1,5 @@+export const ACTIVITY_FACET_OPTIONS = [+ { value: "7", label: "Active within 7 days" },+ { value: "30", label: "Active within 30 days" },+ { value: "90", label: "Active within 90 days" },+];diff --git a/apps/app/lib/trpc/cache.ts b/apps/app/lib/trpc/cache.tsindex 574574fd..790e3721 100644--- a/apps/app/lib/trpc/cache.ts+++ b/apps/app/lib/trpc/cache.ts@@ -11,6 +11,12 @@ type Options = {type RecordKind = "company" | "contact" | "deal";+const ENTITY_FOR = {+ company: "COMPANY",+ contact: "CONTACT",+ deal: "DEAL",+} as const satisfies Record<RecordKind, string>;+type RemovedRecord = { kind: RecordKind; id: string };type RemovedRecords = { kind: RecordKind; ids: string[] };@@ -21,6 +27,7 @@ export type CrmCache = {deal(id?: string, options?: Options): Promise<void>;fields(entity?: RecordKind, options?: Options): Promise<void>;fieldCoverage(id?: string, options?: Options): Promise<void>;+ savedViews(entity?: RecordKind, options?: Options): Promise<void>;removed(record: RemovedRecord): Promise<void>;removedMany(records: RemovedRecords): Promise<void>;conversationRemoved(id: string): Promise<void>;@@ -32,6 +39,7 @@ export type CrmCache = {workspace(options?: Options): Promise<void>;slack(options?: Options): Promise<void>;sso(options?: Options): Promise<void>;+ apiKeys(options?: Options): Promise<void>;tracking(options?: Options): Promise<void>;everything(): Promise<void>;};@@ -119,7 +127,12 @@ export function useCrmCache(): CrmCache {return {fields: (entity, options) =>run(- [trpc.fields.list.queryKey()],+ [+ trpc.fields.list.queryKey(),+ entity+ ? trpc.fields.filters.queryKey({ entity: ENTITY_FOR[entity] })+ : trpc.fields.filters.queryKey(),+ ],entity? [RECORD_BY_ID[entity](), RECORD_LIST[entity]()]: [...Object.values(RECORD_BY_ID).map((key) => key()), ...listKeys()],@@ -137,6 +150,19 @@ export function useCrmCache(): CrmCache {options,),+ savedViews: (entity, options) =>+ run(+ [+ entity+ ? trpc.savedViews.list.queryKey({+ entity: ENTITY_FOR[entity],+ })+ : trpc.savedViews.list.queryKey(),+ ],+ [],+ options,+ ),+company: (id, options) =>run([@@ -146,6 +172,7 @@ export function useCrmCache(): CrmCache {],[...listKeys(),+ ...activityKeys(),trpc.contacts.byId.queryKey(),trpc.deals.byId.queryKey(),trpc.dashboard.summary.queryKey(),@@ -162,6 +189,7 @@ export function useCrmCache(): CrmCache {],[...listKeys(),+ ...activityKeys(),trpc.companies.byId.queryKey(),trpc.deals.byId.queryKey(),trpc.deals.contactOptions.queryKey(),@@ -248,6 +276,7 @@ export function useCrmCache(): CrmCache {[trpc.settings.agentModel.queryKey(),trpc.settings.researchKey.queryKey(),+ trpc.settings.archiveRetention.queryKey(),],[],options,@@ -286,6 +315,8 @@ export function useCrmCache(): CrmCache {options,),+ apiKeys: (options) => run([trpc.apiKeys.list.pathKey()], [], options),+tracking: (options) =>run([trpc.tracking.settings.queryKey()],diff --git a/bun.lock b/bun.lockindex 3176e6ce..1c6df3e6 100644--- a/bun.lock+++ b/bun.lock@@ -48,6 +48,7 @@"@nestjs/config": "^4.0.4","@nestjs/core": "^11.0.1","@nestjs/platform-express": "^11.0.1",+ "@nestjs/swagger": "^11.4.7","@thallesp/nestjs-better-auth": "^2.7.0","@trpc/server": "^11.18.0","@vercel/blob": "^2.6.1",@@ -60,6 +61,7 @@"nestjs-trpc": "^2.13.0","reflect-metadata": "^0.2.2","rxjs": "^7.8.1",+ "trpc-to-openapi": "^3.3.0","zod": "^4.4.3",},"devDependencies": {@@ -119,6 +121,7 @@"name": "@crm/auth","version": "0.0.0","dependencies": {+ "@better-auth/api-key": "1.6.25","@better-auth/sso": "1.6.25","@crm/db": "workspace:*","@crm/env": "workspace:*",@@ -327,6 +330,8 @@"@babel/types": ["@babel/[email protected]", "", { "dependencies": { "@babel/helper-string-parser": "^7.29.7", "@babel/helper-validator-identifier": "^7.29.7" } }, "sha512-4zBIxpPzowiZpusoFkyGVwakdRJUyuH5PxQ/PrqghfdFWWasvnCdPfQXHrenDai+gyLARulZjZowCOj6fjT4pA=="],+ "@better-auth/api-key": ["@better-auth/[email protected]", "", { "dependencies": { "zod": "^4.3.6" }, "peerDependencies": { "@better-auth/core": "^1.6.25", "@better-auth/utils": "0.4.2", "better-auth": "^1.6.25", "better-call": "1.3.7" } }, "sha512-A6f3YLN8Ve+D4R7f8jrSKh8Mpu9+bmc8PIb9BFgGgspcedM1PjpSEI5JKAWPUhiGgMeJdCGeCpRP+27jQmW9/w=="],+"@better-auth/cli": ["@better-auth/[email protected]", "", { "dependencies": { "@babel/core": "^7.28.4", "@babel/preset-react": "^7.27.1", "@babel/preset-typescript": "^7.27.1", "@better-auth/core": "1.4.22", "@better-auth/telemetry": "1.4.22", "@better-auth/utils": "0.3.0", "@clack/prompts": "^0.11.0", "@mrleebo/prisma-ast": "^0.13.0", "@prisma/client": "^5.22.0", "@types/pg": "^8.15.5", "better-auth": "1.4.22", "better-sqlite3": "^12.2.0", "c12": "^3.2.0", "chalk": "^5.6.2", "commander": "^12.1.0", "dotenv": "^17.2.2", "drizzle-orm": "^0.41.0", "open": "^10.2.0", "pg": "^8.16.3", "prettier": "^3.6.2", "prompts": "^2.4.2", "semver": "^7.7.2", "yocto-spinner": "^0.2.3", "zod": "^4.3.5" }, "bin": { "better-auth": "dist/index.mjs" } }, "sha512-7azgrNiP1zJXMLqoLgCVj3KsZeYWLHeaGMapYlLblS6yU/o5n//sn1HBasRD2z4HBy2Etz/C7V483/mYvRHI2g=="],"@better-auth/core": ["@better-auth/[email protected]", "", { "dependencies": { "@standard-schema/spec": "^1.0.0", "zod": "^4.3.5" }, "peerDependencies": { "@better-auth/utils": "0.3.0", "@better-fetch/fetch": "1.1.21", "better-call": "1.1.8", "jose": "^6.1.0", "kysely": "^0.28.5", "nanostores": "^1.0.1" } }, "sha512-l20Ia10lI9iGL+bkjggamQP9lQuiAeB/EYfEx5EQ4AcPrLojG6Doc0UDw5VZM66VXcMGs3bgC8P7WiaJv4Walg=="],@@ -439,6 +444,8 @@"@floating-ui/utils": ["@floating-ui/[email protected]", "", {}, "sha512-HpCo8tmWzLVad5s2d19EhAz5zqrrQ6s69qd6moPMQvkOuSwDT1YgRfWSVuc4ennqrgv3OHppiOGMQ7oC13yIww=="],+ "@hapi/bourne": ["@hapi/[email protected]", "", {}, "sha512-Waj1cwPXJDucOib4a3bAISsKJVb15MKi9IvmTI/7ssVEm6sywXGjVJDhl6/umt1pK1ZS7PacXU3A1PmFKHEZ2w=="],+"@hono/node-server": ["@hono/[email protected]", "", { "peerDependencies": { "hono": "^4" } }, "sha512-eWpQYr67tqJLeaSUl0Q+TquuYfUdTibpOJlUMV2FfUP7+KqCC5TufnwnlXL6mobZBJbGAYRd7ZvEBDCbLInjhg=="],"@ibm/telemetry-js": ["@ibm/[email protected]", "", { "bin": { "ibmtelemetry": "dist/collect.js" } }, "sha512-RO/9j+URJnSfseWg9ZkEX9p+a3Ousd33DBU7rOafoZB08RqdzxFVYJ2/iM50dkBuD0o7WX7GYt1sLbNgCoE+pA=="],@@ -529,6 +536,8 @@"@mermaid-js/parser": ["@mermaid-js/[email protected]", "", { "dependencies": { "@chevrotain/types": "~11.1.2" } }, "sha512-oYPyv8A4As1yH5Bx+04iQEQxXuIQDe0GKCNSRgao6z8AM9jixXIfP0vsppRLvGf+nKIOb9/LdpWA4YuJiVvESA=="],+ "@microsoft/tsdoc": ["@microsoft/[email protected]", "", {}, "sha512-xgAyonlVVS+q7Vc7qLW0UrJU7rSFcETRWsqdXZtjzRU8dF+6CkozTK4V4y1LwOX7j8r/vHphjDeMeGI4tNGeGA=="],+"@mixmark-io/domino": ["@mixmark-io/[email protected]", "", {}, "sha512-Y28PR25bHXUg88kCV7nivXrP2Nj2RueZ3/l/jdx6J9f8J4nsEGcgX0Qe6lt7Pa+J79+kPiJU3LguR6O/6zrLOw=="],"@modelcontextprotocol/sdk": ["@modelcontextprotocol/[email protected]", "", { "dependencies": { "@hono/node-server": "^1.19.9 || ^2.0.5", "ajv": "^8.17.1", "ajv-formats": "^3.0.1", "content-type": "^1.0.5", "cors": "^2.8.5", "cross-spawn": "^7.0.5", "eventsource": "^3.0.2", "eventsource-parser": "^3.0.0", "express": "^5.2.1", "express-rate-limit": "^8.2.1", "hono": "^4.11.4", "jose": "^6.1.3", "json-schema-typed": "^8.0.2", "pkce-challenge": "^5.0.0", "raw-body": "^3.0.0", "zod": "^3.25 || ^4.0", "zod-to-json-schema": "^3.25.1" }, "peerDependencies": { "@cfworker/json-schema": "^4.1.1" }, "optionalPeers": ["@cfworker/json-schema"] }, "sha512-xKd8OIzlqNzcqcNumGAa6g+PW2kjD5vrpcKOnfldAUPP3j7lnqMPwlTXQm8gF+UwH72z0lqaRbjr9hqGz0eITA=="],@@ -547,8 +556,12 @@"@nestjs/core": ["@nestjs/[email protected]", "", { "dependencies": { "fast-safe-stringify": "2.1.1", "iterare": "1.2.1", "path-to-regexp": "8.4.2", "tslib": "2.8.1", "uid": "2.0.2" }, "peerDependencies": { "@nestjs/common": "^11.0.0", "@nestjs/microservices": "^11.0.0", "@nestjs/platform-express": "^11.0.0", "@nestjs/websockets": "^11.0.0", "reflect-metadata": "^0.1.12 || ^0.2.0", "rxjs": "^7.1.0" }, "optionalPeers": ["@nestjs/microservices", "@nestjs/platform-express", "@nestjs/websockets"] }, "sha512-06m63xIRj8+l8uOeh/8LnYupGubkyu4f+bPKIadaSui6vK9KpXgoz7HveT1yOVLcEt0M0oCOEW5EuEXZkEmBBQ=="],+ "@nestjs/mapped-types": ["@nestjs/[email protected]", "", { "peerDependencies": { "@nestjs/common": "^10.0.0 || ^11.0.0", "class-transformer": "^0.4.0 || ^0.5.0", "class-validator": "^0.13.0 || ^0.14.0 || ^0.15.0", "reflect-metadata": "^0.1.12 || ^0.2.0" }, "optionalPeers": ["class-transformer", "class-validator"] }, "sha512-SCCoMEJ6jdeI5h/N+KCVF1+pmg/hmEkNA5nHTS8Gvww7T/LCl4o1gFLinw2iQ60w7slFkszHcGLKGdazVI4F8A=="],+"@nestjs/platform-express": ["@nestjs/[email protected]", "", { "dependencies": { "cors": "2.8.6", "express": "5.2.1", "multer": "2.2.0", "path-to-regexp": "8.4.2", "tslib": "2.8.1" }, "peerDependencies": { "@nestjs/common": "^11.0.0", "@nestjs/core": "^11.0.0" } }, "sha512-hU+9Sz4m+onHrR5AmelI59QKmY/Re546bPnygnpqqeQdHDiJpBgjWbL4t6Jr73CBpS60cpyng7WzjgphNB9iwA=="],+ "@nestjs/swagger": ["@nestjs/[email protected]", "", { "dependencies": { "@microsoft/tsdoc": "0.16.0", "@nestjs/mapped-types": "2.1.1", "js-yaml": "5.3.0", "lodash": "4.18.1", "path-to-regexp": "8.4.2", "swagger-ui-dist": "5.32.13" }, "peerDependencies": { "@fastify/static": "^8.0.0 || ^9.0.0 || ^10.0.0", "@nestjs/common": "^11.0.1", "@nestjs/core": "^11.0.1", "class-transformer": "*", "class-validator": "*", "reflect-metadata": "^0.1.12 || ^0.2.0" }, "optionalPeers": ["@fastify/static", "class-transformer", "class-validator"] }, "sha512-QyDYnmfP4IRucgmtQxMqzgRBdWtjFoDp8eFvvgf92+3wdLCL+Q0xOFO1948j/ntW/Wi7qT2dyck6ka8ADzPWQQ=="],+"@nestjs/testing": ["@nestjs/[email protected]", "", { "dependencies": { "tslib": "2.8.1" }, "peerDependencies": { "@nestjs/common": "^11.0.0", "@nestjs/core": "^11.0.0", "@nestjs/microservices": "^11.0.0", "@nestjs/platform-express": "^11.0.0" }, "optionalPeers": ["@nestjs/microservices", "@nestjs/platform-express"] }, "sha512-B+VgRxeLaH7jkOMgAyUP3N3rpFlisQ7JRxixRbgHvG6a0VgKbbkNSofKExexCgKmQQak80undb3+2kE1lUBmRQ=="],"@next/env": ["@next/[email protected]", "", {}, "sha512-d0Z5Bc13Fa4nR8pFAKx2jay2yhJM16vlfHbTzYnUQAxlNb6B6lmn4hjt69lYNt4kRtyYP6gEM49lPRHNbIyneg=="],@@ -901,6 +914,10 @@"@rolldown/pluginutils": ["@rolldown/[email protected]", "", {}, "sha512-2j9bGt5Jh8hj+vPtgzPtl72j0yRxHAyumoo6TNfAjsLB04UtpSvPbPcDcBMxz7n+9CYB0c1GxQFxYRg2jimqGw=="],+ "@rollup/rollup-linux-x64-gnu": ["@rollup/[email protected]", "", { "os": "linux", "cpu": "x64" }, "sha512-DNGZvZDO5YF7jN5fX8ZqmGLjZEXIJRdJEdTFMhiyXqyXubBa0WVLDWSNlQ5JR2PNgDbEV1VQowhVRUh+74D+RA=="],++ "@scarf/scarf": ["@scarf/[email protected]", "", {}, "sha512-xxeapPiUXdZAE3che6f3xogoJPeZgig6omHEy1rIY5WVsB3H2BHNnZH+gHG6x91SCWyQCzWGsuL2Hh3ClO5/qQ=="],+"@sec-ant/readable-stream": ["@sec-ant/[email protected]", "", {}, "sha512-831qok9r2t8AlxLko40y2ebgSDhenenCatLVeW/uBtnHPyhHOvG0C7TvfgecV+wHzIm5KUICgzmVpWS+IMEAeg=="],"@shadcn/react": ["@shadcn/[email protected]", "", { "peerDependencies": { "@types/react": ">=19", "react": ">=19" }, "optionalPeers": ["@types/react", "react"] }, "sha512-iKN0NuYe850VDHlxEfvppFrpa7CMV3zArTHusXlaSmeFeQhohGbIqclv6WwPTs/44I8EkXQpcuRt6sXEVKkWqQ=="],@@ -1301,6 +1318,8 @@"cmdk": ["[email protected]", "", { "dependencies": { "@radix-ui/react-compose-refs": "^1.1.1", "@radix-ui/react-dialog": "^1.1.6", "@radix-ui/react-id": "^1.1.0", "@radix-ui/react-primitive": "^2.0.2" }, "peerDependencies": { "react": "^18 || ^19 || ^19.0.0-rc", "react-dom": "^18 || ^19 || ^19.0.0-rc" } }, "sha512-Vsv7kFaXm+ptHDMZ7izaRsP70GgrW9NBNGswt9OZaVBLlE0SNpDq8eu/VGXyF9r7M0azK3Wy7OlYXsuyYLFzHg=="],+ "co-body": ["[email protected]", "", { "dependencies": { "@hapi/bourne": "^3.0.0", "inflation": "^2.0.0", "qs": "^6.5.2", "raw-body": "^2.3.3", "type-is": "^1.6.16" } }, "sha512-Kbpv2Yd1NdL1V/V4cwLVxraHDV6K8ayohr2rmH0J87Er8+zJjcTa6dAn9QMPC9CRgU8+aNajKbSf1TzDB1yKPA=="],+"code-block-writer": ["[email protected]", "", {}, "sha512-Oofo0pq3IKnsFtuHqSF7TqBfr71aeyZDVJ0HpmqB7FBM2qEigL0iPONSCZSO9pE9dZTAxANe5XHG9Uy0YMv8cg=="],"color-convert": ["[email protected]", "", { "dependencies": { "color-name": "~1.1.4" } }, "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ=="],@@ -1335,6 +1354,8 @@"cookie": ["[email protected]", "", {}, "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w=="],+ "cookie-es": ["[email protected]", "", {}, "sha512-lXVyvUvrNXblMqzIRrxHb57UUVmqsSWlxqt3XIjCkUP0wDAf6uicO6KMbEgYrMNtEvWgWHwe42CKxPu9MYAnWw=="],+"cookie-signature": ["[email protected]", "", {}, "sha512-D76uU73ulSXrD1UXF4KE2TMxVVwhsnCgfAyTg9k8P6KGZjlXKrOLe4dJQKI3Bxi5wjesZoFXJWElNWBjPZMbhg=="],"cookiejar": ["[email protected]", "", {}, "sha512-LDx6oHrK+PhzLKJU9j5S7/Y3jM/mUHvD/DeI1WQmJn652iPC5Y4TBzC9l+5OMOXlyTTA+SmVUPm0HQUwpD5Jqw=="],@@ -1661,7 +1682,7 @@"graphmatch": ["[email protected]", "", {}, "sha512-5ykVn/EXM1hF0XCaWh05VbYvEiOL2lY1kBxZtaYsyvjp7cmWOU1XsAdfQBwClraEofXDT197lFbXOEVMHpvQOg=="],- "h3": ["[email protected]", "", { "dependencies": { "rou3": "^0.8.1", "srvx": "^0.11.15" }, "peerDependencies": { "crossws": "^0.4.1" }, "optionalPeers": ["crossws"], "bin": { "h3": "bin/h3.mjs" } }, "sha512-Esv0DMIuPkCTSWCA0vO73vcTqwzH1wjSrAO1TXNu/K3up1sZHa9EKMapbmxCDYBeymC3fVTk4qxp7ogQWQ+KgA=="],+ "h3": ["[email protected]", "", { "dependencies": { "cookie-es": "^1.2.3", "crossws": "^0.3.5", "defu": "^6.1.6", "destr": "^2.0.5", "iron-webcrypto": "^1.2.1", "node-mock-http": "^1.0.4", "radix3": "^1.1.2", "ufo": "^1.6.3", "uncrypto": "^0.1.3" } }, "sha512-L3THSe2MPeBwgIZVSH5zLdBBU90TOxarvhK9d04IDY2AmVS8j2Jz2LIWtwsGOU3lu2I5jCN7FNvVfY2+XyF+mg=="],"hachure-fill": ["[email protected]", "", {}, "sha512-3GKBOn+m2LX9iq+JC1064cSFprJY4jL1jCXTcpnfER5HYE2l/4EfWSGzkPa/ZDBmYI0ZOEj5VHV/eKnPGkHuOg=="],@@ -1723,6 +1744,8 @@"import-meta-resolve": ["[email protected]", "", {}, "sha512-Iqv2fzaTQN28s/FwZAoFq0ZSs/7hMAHJVX+w8PZl3cY19Pxk6jFFalxQoIfW2826i/fDLXv8IiEZRIT0lDuWcg=="],+ "inflation": ["[email protected]", "", {}, "sha512-t54PPJHG1Pp7VQvxyVCJ9mBbjG3Hqryges9bXoOO6GExCPa+//i/d5GSuFtpx3ALLd7lgIAur6zrIlBQyJuMlQ=="],+"inherits": ["[email protected]", "", {}, "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ=="],"ini": ["[email protected]", "", {}, "sha512-IBTdIkzZNOpqm7q3dRqJvMaldXjDHWkEDfrwGEQTs5eaQMWV+djAhR+wahyNNMAa+qpbDUhBMVt4ZKNwpPm7xQ=="],@@ -1735,6 +1758,8 @@"ipaddr.js": ["[email protected]", "", {}, "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g=="],+ "iron-webcrypto": ["[email protected]", "", {}, "sha512-feOM6FaSr6rEABp/eDfVseKyTMDt+KGpeB35SkVn9Tyn0CqvVsY3EwI0v5i8nMHyJnzCIQf7nsy3p41TPkJZhg=="],+"is-alphabetical": ["[email protected]", "", {}, "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ=="],"is-alphanumerical": ["[email protected]", "", { "dependencies": { "is-alphabetical": "^2.0.0", "is-decimal": "^2.0.0" } }, "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw=="],@@ -1793,7 +1818,7 @@"js-tokens": ["[email protected]", "", {}, "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="],- "js-yaml": ["[email protected]", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-1td788aAnnZ5qs7V2QIRl1owjtYpbKt749Y3xauqQgwIIGF/xXWz1wMTEBx5O3LK3lXLVuqXPdPxj2BoFHaW9Q=="],+ "js-yaml": ["[email protected]", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.mjs" } }, "sha512-muutsYr+e2+d3rTgUGslq5rxbBlUy3cJ61IsHag2QNDQV+7zXWjkUpmALIajhrlLlrgRUiymj6U3zUr/TMK84Q=="],"jsesc": ["[email protected]", "", { "bin": { "jsesc": "bin/jsesc" } }, "sha512-/sM3dO2FOzXjKQhJuo0Q173wf2KOo8t4I8vHy6lF9poUp7bKT0/NHE8fPX23PwfhnykfqnC2xRxOnVw5XuGIaA=="],@@ -2049,6 +2074,8 @@"node-liblzma": ["[email protected]", "", { "dependencies": { "node-addon-api": "^8.5.0", "node-gyp-build": "^4.8.4" }, "bin": { "nxz": "lib/cli/nxz.js" } }, "sha512-s0KzNOWwOJJgPG6wxg6cKohnAl9Wk/oW1KrQaVzJBjQwVcUGPQCzpR46Ximygjqj/3KhOrtJXnYMp/xYAXp75g=="],+ "node-mock-http": ["[email protected]", "", {}, "sha512-KQyt/wLjG3TAc7DOUhpqWzgd4ERxR80JOlTK5VE5R1S12IaPVN5qkj4klBce9HPG1Njuup4Sb5bljaT34lIyjw=="],+"node-releases": ["[email protected]", "", {}, "sha512-wRNIrw4DmVLKQlbgOMdkMx27Wrpzes2hh5Jtbi2bjPd+4wJstWIqP5A+lscnqbm0xxmT5Bpg8Lec5ItEBwx6BQ=="],"node-rsa": ["[email protected]", "", { "dependencies": { "asn1": "^0.2.4" } }, "sha512-Jd4cvbJMryN21r5HgxQOpMEqv+ooke/korixNNK3mGqfGJmy0M77WDDzo/05969+OkMy3XW1UuZsSmW9KQm7Fw=="],@@ -2081,6 +2108,8 @@"open": ["[email protected]", "", { "dependencies": { "default-browser": "^5.2.1", "define-lazy-prop": "^3.0.0", "is-inside-container": "^1.0.0", "wsl-utils": "^0.1.0" } }, "sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA=="],+ "openapi3-ts": ["[email protected]", "", { "dependencies": { "yaml": "^2.5.0" } }, "sha512-9asTNB9IkKEzWMcHmVZE7Ts3kC9G7AFHfs8i7caD8HbI76gEjdkId4z/AkP83xdZsH7PLAnnbl47qZkXuxpArw=="],+"ora": ["[email protected]", "", { "dependencies": { "chalk": "^5.3.0", "cli-cursor": "^5.0.0", "cli-spinners": "^2.9.2", "is-interactive": "^2.0.0", "is-unicode-supported": "^2.0.0", "log-symbols": "^6.0.0", "stdin-discarder": "^0.2.2", "string-width": "^7.2.0", "strip-ansi": "^7.1.0" } }, "sha512-weP+BZ8MVNnlCm8c0Qdc1WSWq4Qn7I+9CJGm7Qali6g44e/PUzbjNqJX5NJ9ljlNMosfJvg1fKEGILklK9cwnw=="],"os-paths": ["[email protected]", "", {}, "sha512-wrAwOeXp1RRMFfQY8Sy7VaGVmPocaLwSFOYCGKSyo8qmJ+/yaafCl5BCA1IQZWqFSRBrKDYFeR9d/VyQzfH/jg=="],@@ -2217,6 +2246,8 @@"radix-ui": ["[email protected]", "", { "dependencies": { "@radix-ui/primitive": "1.1.7", "@radix-ui/react-accessible-icon": "1.1.15", "@radix-ui/react-accordion": "1.2.20", "@radix-ui/react-alert-dialog": "1.1.23", "@radix-ui/react-arrow": "1.1.15", "@radix-ui/react-aspect-ratio": "1.1.15", "@radix-ui/react-avatar": "1.2.6", "@radix-ui/react-checkbox": "1.3.11", "@radix-ui/react-collapsible": "1.1.20", "@radix-ui/react-collection": "1.1.15", "@radix-ui/react-compose-refs": "1.1.5", "@radix-ui/react-context": "1.2.2", "@radix-ui/react-context-menu": "2.3.7", "@radix-ui/react-dialog": "1.1.23", "@radix-ui/react-direction": "1.1.4", "@radix-ui/react-dismissable-layer": "1.1.19", "@radix-ui/react-dropdown-menu": "2.1.24", "@radix-ui/react-focus-guards": "1.1.6", "@radix-ui/react-focus-scope": "1.1.16", "@radix-ui/react-form": "0.1.16", "@radix-ui/react-hover-card": "1.1.23", "@radix-ui/react-label": "2.1.15", "@radix-ui/react-menu": "2.1.24", "@radix-ui/react-menubar": "1.1.24", "@radix-ui/react-navigation-menu": "1.2.22", "@radix-ui/react-one-time-password-field": "0.1.16", "@radix-ui/react-password-toggle-field": "0.1.11", "@radix-ui/react-popover": "1.1.23", "@radix-ui/react-popper": "1.3.7", "@radix-ui/react-portal": "1.1.17", "@radix-ui/react-presence": "1.1.10", "@radix-ui/react-primitive": "2.1.10", "@radix-ui/react-progress": "1.1.16", "@radix-ui/react-radio-group": "1.4.7", "@radix-ui/react-roving-focus": "1.1.19", "@radix-ui/react-scroll-area": "1.2.18", "@radix-ui/react-select": "2.3.7", "@radix-ui/react-separator": "1.1.15", "@radix-ui/react-slider": "1.4.7", "@radix-ui/react-slot": "1.3.3", "@radix-ui/react-switch": "1.3.7", "@radix-ui/react-tabs": "1.1.21", "@radix-ui/react-toast": "1.2.23", "@radix-ui/react-toggle": "1.1.18", "@radix-ui/react-toggle-group": "1.1.19", "@radix-ui/react-toolbar": "1.1.19", "@radix-ui/react-tooltip": "1.2.16", "@radix-ui/react-use-callback-ref": "1.1.4", "@radix-ui/react-use-controllable-state": "1.2.6", "@radix-ui/react-use-effect-event": "0.0.5", "@radix-ui/react-use-escape-keydown": "1.1.5", "@radix-ui/react-use-is-hydrated": "0.1.3", "@radix-ui/react-use-layout-effect": "1.1.4", "@radix-ui/react-use-size": "1.1.4", "@radix-ui/react-visually-hidden": "1.2.11" }, "peerDependencies": { "@types/react": "*", "@types/react-dom": "*", "react": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc", "react-dom": "^16.8 || ^17.0 || ^18.0 || ^19.0 || ^19.0.0-rc" }, "optionalPeers": ["@types/react", "@types/react-dom"] }, "sha512-QBdhh1arIEUvPC0dQ5+nwWAxt7+N+oP/9jPwjJkGFoSk/sqxg32gJtSXGtFh8frAIcS6oC9cx2Q+7KYCQLOAeA=="],+ "radix3": ["[email protected]", "", {}, "sha512-b484I/7b8rDEdSDKckSSBA8knMpcdsXudlE/LNL639wFoHKwLbEkQFZHWEYwDC0wa0FKUcCY+GAF73Z7wxNVFA=="],+"range-parser": ["[email protected]", "", {}, "sha512-hek2mFQpPuI4E1BBKrSto+BU3e3x4xuarsbiwr3+lf7p44juvFMV0XFWQAP3xUyqXA4RrXLIoaSUGbSt056ZMw=="],"raw-body": ["[email protected]", "", { "dependencies": { "bytes": "~3.1.2", "http-errors": "~2.0.1", "iconv-lite": "~0.7.0", "unpipe": "~1.0.0" } }, "sha512-K5zQjDllxWkf7Z5xJdV0/B0WTNqx6vxG70zJE4N0kBs4LovmEYWJzQGxC9bS9RAKu3bgM40lrd5zoLJ12MQ5BA=="],@@ -2435,6 +2466,8 @@"supports-color": ["[email protected]", "", { "dependencies": { "has-flag": "^4.0.0" } }, "sha512-MpUEN2OodtUzxvKQl72cUF7RQ5EiHsGvSsVG0ia9c5RbWGL2CI4C7EpPS8UTBIplnlzZiNuV56w+FuNxy3ty2Q=="],+ "swagger-ui-dist": ["[email protected]", "", { "dependencies": { "@scarf/scarf": "=1.4.0" } }, "sha512-qQobzb3DeC2LeK0j3E8812Ef4aIq1y9flJxvZkimkqUC/w4u7wS+yCc+VakqGJLweUUBrI24effhwo8OsAvNAw=="],+"systeminformation": ["[email protected]", "", { "os": "!aix", "bin": { "systeminformation": "lib/cli.js" } }, "sha512-DEN6ICHk3Tk0Uf/hrAHh7xlt7iL5CJFBtPZinA0H62DrGG/KPKqq/Nzj6lCXPS4Ay/sf/14zNnk9LpqKzBIc+w=="],"tailwind-merge": ["[email protected]", "", {}, "sha512-uxL7qAVQriqRQPAyK3pj66VqskWqoZ37PW94jwOTwNfq/z9oyu1V+eqrZqtR2+fCiXdYOZe/Modt8GtvqNzu+w=="],@@ -2471,6 +2504,8 @@"trough": ["[email protected]", "", {}, "sha512-tmMpK00BjZiUyVyvrBK7knerNgmgvcV/KLVyuma/SC+TQN167GrMRciANTz09+k3zW8L8t60jWO1GpfkZdjTaw=="],+ "trpc-to-openapi": ["[email protected]", "", { "dependencies": { "co-body": "6.2.0", "h3": "^1.15.5", "openapi3-ts": "4.4.0" }, "optionalDependencies": { "@rollup/rollup-linux-x64-gnu": "4.6.1" }, "peerDependencies": { "@trpc/server": "^11.1.0", "zod": "^3.25.0 || ^4.0.0", "zod-openapi": "^5.4.4" } }, "sha512-PNMXq0K37Ott5ysNACYN1XLaM5xZGNJrx1QiQVTlk4hmgJomoyiAKhVrpwrK02JW3joSQmHYBOZ7pK6Hdioekw=="],+"ts-dedent": ["[email protected]", "", {}, "sha512-JfJeIHke7y2egdGGgRAvpCwYFUsHlM2gPcrVOxFkznt/4uzQ7HFmvE63iFHVLBJNDuyDOQgijDK/tXH/f6Msjg=="],"ts-morph": ["[email protected]", "", { "dependencies": { "@ts-morph/common": "~0.27.0", "code-block-writer": "^13.0.3" } }, "sha512-ztMO++owQnz8c/gIENcM9XfCEzgoGphTv+nKpYNM1bgsdOVC/jRZuEBf6N+mLLDNg68Kl+GgUZfOySaRiG1/Ug=="],@@ -2493,12 +2528,16 @@"typescript": ["[email protected]", "", { "bin": { "tsc": "bin/tsc", "tsserver": "bin/tsserver" } }, "sha512-CWBzXQrc/qOkhidw1OzBTQuYRbfyxDXJMVJ1XNwUHGROVmuaeiEm3OslpZ1RV96d7SKKjZKrSJu3+t/xlw3R9A=="],+ "ufo": ["[email protected]", "", {}, "sha512-JFNbkD1Svwe0KvGi8GOeLcP4kAWQ609twvCdcHxq1oSL8svv39ZuSvajcD8B+5D0eL4+s1Is2D/O6KN3qcTeRA=="],+"uid": ["[email protected]", "", { "dependencies": { "@lukeed/csprng": "^1.0.0" } }, "sha512-u3xV3X7uzvi5b1MncmZo3i2Aw222Zk1keqLA1YkHldREkAhAqi65wuPfe7lHx8H/Wzy+8CE7S7uS3jekIM5s8g=="],"uint8array-extras": ["[email protected]", "", {}, "sha512-rvKSBiC5zqCCiDZ9kAOszZcDvdAHwwIKJG33Ykj43OKcWsnmcBRL09YTU4nOeHZ8Y2a7l1MgTd08SBe9A8Qj6A=="],"unbash": ["[email protected]", "", {}, "sha512-b7zoBQvpWp0vuN5q2vK2RRBR2SvuruQAs50DApdDveBSn3eSYd84IaHodFqQIMlvY9K2VnyBUEXgwOBuGU9GBg=="],+ "uncrypto": ["[email protected]", "", {}, "sha512-Ql87qFHB3s/De2ClA9e0gsnS6zXG27SkTiSJwjCc9MebbfapQfuPzumMIUMi38ezPZVNFcHI9sUIepeQfw8J8Q=="],+"undici": ["[email protected]", "", {}, "sha512-LIY910g9TI13YS95lrMFrs8Rm/u/irgHeTWoKCoteeJ04CUJ92eEfj0rVn+7VKMPBpUPiUoBKfhNyLI23EE/KA=="],"undici-types": ["[email protected]", "", {}, "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w=="],@@ -2605,6 +2644,8 @@"zod": ["[email protected]", "", {}, "sha512-ytENFjIJFl2UwYglde2jchW2Hwm4GJFLDiSXWdTrJQBIN9Fcyp7n4DhxJEiWNAJMV1/BqWfW/kkg71UDcHJyTQ=="],+ "zod-openapi": ["[email protected]", "", { "peerDependencies": { "zod": "^3.25.74 || ^4.0.0" } }, "sha512-P2jsOOBAq/6hCwUsMCjUATZ8szkMsV5VAwZENfyxp2Hc/XPJQpVwAgevWZc65xZauCwWB9LAn7zYeiCJFAEL+A=="],+"zod-to-json-schema": ["[email protected]", "", { "peerDependencies": { "zod": "^3.25.28 || ^4" } }, "sha512-O/PgfnpT1xKSDeQYSCfRI5Gy3hPf91mKVDuYLUHZJMiDFptvP41MSnWofm8dnCm0256ZNfZIM7DSzuSMAFnjHA=="],"zwitch": ["[email protected]", "", {}, "sha512-bXE4cR/kVZhKZX/RjPEflHaKVhUVl85noU3v6b8apfQEc1x4A+zBxjZ4lN8LqGd6WZ3dl98pY4o717VFmoPp+A=="],@@ -2621,6 +2662,10 @@"@babel/helper-create-class-features-plugin/semver": ["[email protected]", "", { "bin": { "semver": "bin/semver.js" } }, "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA=="],+ "@better-auth/api-key/@better-auth/core": ["@better-auth/[email protected]", "", { "dependencies": { "@opentelemetry/semantic-conventions": "^1.39.0", "@standard-schema/spec": "^1.1.0", "zod": "^4.3.6" }, "peerDependencies": { "@better-auth/utils": "0.4.2", "@better-fetch/fetch": "1.3.1", "@cloudflare/workers-types": ">=4", "@opentelemetry/api": "^1.9.0", "better-call": "1.3.7", "jose": "^6.1.0", "kysely": "^0.28.5 || ^0.29.0", "nanostores": "^1.0.1" }, "optionalPeers": ["@cloudflare/workers-types", "@opentelemetry/api"] }, "sha512-lMTlhtwyK4NpY9kPF+2rQCRKYpg136d3gM2xl8esxT1PjJx5Nh5YwZvxcYCIjDuO759sx6TCloJTuwcZGG6ZBw=="],++ "@better-auth/api-key/@better-auth/utils": ["@better-auth/[email protected]", "", { "dependencies": { "@noble/hashes": "^2.0.1" } }, "sha512-AUxrvu+HaaODsUyzDxFgwd/8RZ1yZaYo42LXKSrU2oGgR38pS1ij8nqQKNgtTWoYGpNevNXtCfgTy6loHveW9A=="],+"@better-auth/cli/@prisma/client": ["@prisma/[email protected]", "", { "peerDependencies": { "prisma": "*" }, "optionalPeers": ["prisma"] }, "sha512-M0SVXfyHnQREBKxCgyo7sffrKttwE6R8PMq330MIUF0pTwjUhLbW84pFDlf06B27XyCR++VtjugEnIHdr07SVA=="],"@better-auth/cli/better-auth": ["[email protected]", "", { "dependencies": { "@better-auth/core": "1.4.22", "@better-auth/telemetry": "1.4.22", "@better-auth/utils": "0.3.0", "@better-fetch/fetch": "1.1.21", "@noble/ciphers": "^2.0.0", "@noble/hashes": "^2.0.0", "better-call": "1.1.8", "defu": "^6.1.4", "jose": "^6.1.0", "kysely": "^0.28.5", "nanostores": "^1.0.1", "zod": "^4.3.5" }, "peerDependencies": { "@lynx-js/react": "*", "@prisma/client": "^5.0.0 || ^6.0.0 || ^7.0.0", "@sveltejs/kit": "^2.0.0", "@tanstack/react-start": "^1.0.0", "@tanstack/solid-start": "^1.0.0", "better-sqlite3": "^12.0.0", "drizzle-kit": ">=0.31.4", "drizzle-orm": ">=0.41.0", "mongodb": "^6.0.0 || ^7.0.0", "mysql2": "^3.0.0", "next": "^14.0.0 || ^15.0.0 || ^16.0.0", "pg": "^8.0.0", "prisma": "^5.0.0 || ^6.0.0 || ^7.0.0", "react": "^18.0.0 || ^19.0.0", "react-dom": "^18.0.0 || ^19.0.0", "solid-js": "^1.0.0", "svelte": "^4.0.0 || ^5.0.0", "vitest": "^2.0.0 || ^3.0.0 || ^4.0.0", "vue": "^3.0.0" }, "optionalPeers": ["@lynx-js/react", "@prisma/client", "@sveltejs/kit", "@tanstack/react-start", "@tanstack/solid-start", "better-sqlite3", "drizzle-kit", "drizzle-orm", "mongodb", "mysql2", "next", "pg", "prisma", "react", "react-dom", "solid-js", "svelte", "vitest", "vue"] }, "sha512-CXQ7ZLDkf/I9iaVTNuejJ7FlWal50hRPIv1n0lqMipvthEoMx+2RQyNXUvzGRjltSe5d9rcZPI3IxdtS1A5+YA=="],@@ -2891,12 +2936,18 @@"cliui/strip-ansi": ["[email protected]", "", { "dependencies": { "ansi-regex": "^5.0.1" } }, "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A=="],+ "co-body/raw-body": ["[email protected]", "", { "dependencies": { "bytes": "~3.1.2", "http-errors": "~2.0.1", "iconv-lite": "~0.4.24", "unpipe": "~1.0.0" } }, "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA=="],++ "co-body/type-is": ["[email protected]", "", { "dependencies": { "media-typer": "0.3.0", "mime-types": "~2.1.24" } }, "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g=="],+"concurrently/chalk": ["[email protected]", "", { "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" } }, "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA=="],"conf/ajv-formats": ["[email protected]", "", { "dependencies": { "ajv": "^8.0.0" } }, "sha512-Wx0Kx52hxE7C18hkMEggYlEifqWZtYaRgouJor+WMdPnQyEK13vgEWyVNup7SoeeoLMsr4kf5h6dOW11I15MUA=="],"conf/json-schema-typed": ["[email protected]", "", {}, "sha512-7DE8mpG+/fVw+dTpjbxnx47TaMnDfOI1jwft9g1VybltZCduyRQPJPvc+zzKY9WPHxhPWczyFuYa6I8Mw4iU5A=="],+ "cosmiconfig/js-yaml": ["[email protected]", "", { "dependencies": { "argparse": "^2.0.1" }, "bin": { "js-yaml": "bin/js-yaml.js" } }, "sha512-1td788aAnnZ5qs7V2QIRl1owjtYpbKt749Y3xauqQgwIIGF/xXWz1wMTEBx5O3LK3lXLVuqXPdPxj2BoFHaW9Q=="],+"cross-spawn/which": ["[email protected]", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="],"cytoscape-fcose/cose-base": ["[email protected]", "", { "dependencies": { "layout-base": "^2.0.0" } }, "sha512-AzlgcsCbUMymkADOJtQm3wO9S3ltPfYOFD5033keQn9NJzIbtnZj+UdBJe7DYml/8TdbtHJW3j58SOnKhWY/5g=="],@@ -2919,7 +2970,7 @@"form-data/mime-types": ["[email protected]", "", { "dependencies": { "mime-db": "1.52.0" } }, "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw=="],- "h3/rou3": ["[email protected]", "", {}, "sha512-ePa+XGk00/3HuCqrEnK3LxJW7I0SdNg6EFzKUJG73hMAdDcOUC/i/aSz7LSDwLrGr33kal/rqOGydzwl6U7zBA=="],+ "h3/crossws": ["[email protected]", "", { "dependencies": { "uncrypto": "^0.1.3" } }, "sha512-ojKiDvcmByhwa8YYqbQI/hg7MEU0NC03+pSdEq4ZUnZR9xXpwk7E43SMNGkn+JxJGPFtNvQ48+vV2p+P1ml5PA=="],"just-bash/undici": ["[email protected]", "", {}, "sha512-IDxfleLmmbSskfWSUATiN1nfn2rDuvnMOqb5CWR92iIfojA0Ud+ulOAAEQ57LPr9rWmsreUyf5lwyao+7GNNVw=="],@@ -2937,6 +2988,8 @@"next/postcss": ["[email protected]", "", { "dependencies": { "nanoid": "^3.3.6", "picocolors": "^1.0.0", "source-map-js": "^1.0.2" } }, "sha512-PS08Iboia9mts/2ygV3eLpY5ghnUcfLV/EXTOW1E2qYxJKGGBUtNjN76FYHnMs36RmARn41bC0AZmn+rR0OVpQ=="],+ "nitro/h3": ["[email protected]", "", { "dependencies": { "rou3": "^0.8.1", "srvx": "^0.11.15" }, "peerDependencies": { "crossws": "^0.4.1" }, "optionalPeers": ["crossws"], "bin": { "h3": "bin/h3.mjs" } }, "sha512-Esv0DMIuPkCTSWCA0vO73vcTqwzH1wjSrAO1TXNu/K3up1sZHa9EKMapbmxCDYBeymC3fVTk4qxp7ogQWQ+KgA=="],+"npm-run-path/path-key": ["[email protected]", "", {}, "sha512-haREypq7xkM7ErfgIyA0z+Bj4AGKlMSdlQE2jvJo6huWD1EdkKYV+G/T4nq0YEF2vgTT8kqMFKo1uHn950r4SQ=="],"onetime/mimic-fn": ["[email protected]", "", {}, "sha512-OqbOk5oEQeAZ8WXWydlu9HJjz9WVdEIvamMCcXmuqUYjTknH/sqsWvhQ3vgwKFRR1HpjvNBKQ37nbJgYzGqGcg=="],@@ -3065,6 +3118,12 @@"cliui/strip-ansi/ansi-regex": ["[email protected]", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],+ "co-body/raw-body/iconv-lite": ["[email protected]", "", { "dependencies": { "safer-buffer": ">= 2.1.2 < 3" } }, "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA=="],++ "co-body/type-is/media-typer": ["[email protected]", "", {}, "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ=="],++ "co-body/type-is/mime-types": ["[email protected]", "", { "dependencies": { "mime-db": "1.52.0" } }, "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw=="],+"concurrently/chalk/supports-color": ["[email protected]", "", { "dependencies": { "has-flag": "^4.0.0" } }, "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw=="],"cross-spawn/which/isexe": ["[email protected]", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="],@@ -3083,6 +3142,8 @@"multer/type-is/mime-types": ["[email protected]", "", { "dependencies": { "mime-db": "1.52.0" } }, "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw=="],+ "nitro/h3/rou3": ["[email protected]", "", {}, "sha512-ePa+XGk00/3HuCqrEnK3LxJW7I0SdNg6EFzKUJG73hMAdDcOUC/i/aSz7LSDwLrGr33kal/rqOGydzwl6U7zBA=="],+"shadcn/open/wsl-utils": ["[email protected]", "", { "dependencies": { "is-wsl": "^3.1.0", "powershell-utils": "^0.1.0" } }, "sha512-g/eziiSUNBSsdDJtCLB8bdYEUMj4jR7AGeUo96p/3dTafgjHhpF4RiCFPiRILwjQoDXx5MqkBr4fwWtR3Ky4Wg=="],"wrap-ansi/string-width/emoji-regex": ["[email protected]", "", {}, "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="],@@ -3147,6 +3208,8 @@"app/next/sharp/@img/sharp-win32-x64": ["@img/[email protected]", "", { "os": "win32", "cpu": "x64" }, "sha512-D4y1vNeZrIIJCN+uHaWVtH86B+aCrdMYYjicy9pXHvbGZeGYLLSd3wdVuC37FxVXlU1ARsk84eKWfWMXGYEqvA=="],+ "co-body/type-is/mime-types/mime-db": ["[email protected]", "", {}, "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg=="],+"multer/type-is/mime-types/mime-db": ["[email protected]", "", {}, "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg=="],"yargs/string-width/strip-ansi/ansi-regex": ["[email protected]", "", {}, "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ=="],diff --git a/docs/api.md b/docs/api.mdindex 56c9e7d5..99f1d009 100644--- a/docs/api.md+++ b/docs/api.md@@ -207,12 +207,38 @@ picker reads.- **`role` is blanked to null, never stored as `""`** — `blankToNull`, as everywhereelse.-## Deleting a record--`contacts.delete`, `companies.delete`, `deals.delete`. No soft delete, no archive.--- **A deleted contact is suppressed by address**, or the sync recreates them from the- next thread. `ContactsService.delete` writes `SuppressedContact`, and+## Deleting a record is archive first, purge later++`contacts.archive`, `companies.archive`, `deals.archive` set `archivedAt`. Nothing+else changes — no suppression, no cascade cleanup, no stamp recompute — because the+row is still there, just filtered out of every list.++- **`archivedFilter(input.archived)` is in every `buildWhere` and every `facetCounts`+ where.** A list call defaults to `archived: false`; the Archived view is the same+ procedure with `archived: true`. There is no third "everything" mode — mixing+ active and archived rows in one table is exactly what this feature removes.+- **`archive`/`restore` are a bare `update({ archivedAt })`, nothing more.** They do+ not touch `AgentTask`, `SuppressedContact`, or `lastActivityAt` — the record is+ unchanged, only hidden.+- **`purge` is the old `delete`.** Same transaction, same suppression, same+ `AgentTask`/`AgentEvent` cleanup, same `ActivityStampService.recomputeAfterDelete`.+ Read the rest of this section as `purge`'s contract, not `archive`'s.+- **A rep can `purge` straight from the Archived view — retention is a ceiling, not a+ wait.** `bulkPurge`/the per-record "Delete forever" action call it directly, no+ different from the cron.++**Pruning**: `ArchiveRetentionController` (`internal/archive/prune`, `CRON_SECRET`-gated,+`apps/api/vercel.json`) reads `AppSetting.archiveRetentionDays`+(`readArchiveRetentionDays`, `@crm/db/settings`, default 180) and calls each service's+`purgeExpired(before)` — `findMany({ archivedAt: { lte: before } })` capped at+`ARCHIVE.prune.maxBatch` (`archive/archive-config.ts`), then `purge` per row through+the ordinary `runBulk`. Settings → General has the day count+(`settings.archiveRetention` / `setArchiveRetention`).++Below is `purge`'s contract — everything that used to be `delete`'s:++- **A purged contact is suppressed by address**, or the sync recreates them from the+ next thread. `ContactsService.purge` writes `SuppressedContact`, and`externalParticipants` drops it like a `SuppressedDomain` — one filter coveringcontact creation, company auto-creation and attribution.- **Keyed lower case.** `normalizeEmail` (`crm/values.ts`) is the one canonicaliser,@@ -223,11 +249,11 @@ picker reads.404 is that statement's own `P2025` through `translate`.- **Adding them back lifts the suppression** via `allowAgain` **inside the write'stransaction**. Never automatic.-- **Deleting a company does not suppress its domain** — its people survive with no+- **Purging a company does not suppress its domain** — its people survive with nocompany, and domain suppression stays the explicit Settings → Connections control.- **Clear `AgentTask` and `AgentEvent` yourself** — they carry `contactId`/`companyId`with no foreign key, so nothing cascades.-- **Recompute `lastActivityAt` on exactly the records the delete reached.**+- **Recompute `lastActivityAt` on exactly the records the purge reached.**`ActivityStampService.targetsOf(where)` collects them *inside* the transaction (theevidence is what gets deleted); `recomputeMany` restamps. A company's `where` mustfollow its deals: `{ OR: [{ companyId }, { deal: { companyId } }] }`.diff --git a/docs/list-building-roadmap.md b/docs/list-building-roadmap.mdnew file mode 100644index 00000000..762d0206--- /dev/null+++ b/docs/list-building-roadmap.md@@ -0,0 +1,147 @@+# List-Building Roadmap++A plan to answer the Director of Sales Development's read on the CRM: filtering+looks thin for real BDR list-building. Integrations are out of scope, by his own+note — this is about fields, filters, and views inside the CRM itself.++## 1. What he saw++> "As it stands it looks like a research/automation layer more than a system of+> record — I'd be concerned about moving off HubSpot/Salesforce-caliber+> filtering without seeing those gaps closed first."+>+> — Director of Sales Development, first-look feedback++He is right about the current state. Today's filtering is this small:++- **3** Company filters — owner, industry, enrichment+- **2** Contact filters — owner, company+- **1** value per filter — no "is any of" yet+- **0** saved or shared list views++## 2. Why this is cheaper than it looks++Two systems already in the CRM cover most of the fields on his list. Neither is+exposed as a filter yet — that is the actual gap, not missing intelligence.++**Already built — admin fields.** An admin-configurable field system already+backs every record sheet and table: `FieldDefinition` + `FieldOption` ++`FieldValue`, with a `SELECT` type for picklists and a `USER` type for a second+owner. Account type, segment/tier, territory, lifecycle stage, and lead source+all fit this today — no database migration required.++**Already built — agent inference.** The agent already scores `seniority` and+`function` (persona) per contact from evidence, the same pipeline that fills+title and LinkedIn today. It just isn't wired to a column, so it never reaches+the table or a filter.++## 3. The gap map++Every field from his note, what backs it today, and the plan to close it.++### Companies view++All seven rows below are already seeded as `FieldDefinition` rows+(`seedCompanyFields` in `packages/db/prisma/seed.ts`) with real option sets. The+gap is not the field — it is that none of them show on the table or reach the+filter bar yet.++| Field he wants | Where it stands today | Plan | Effort |+| --- | --- | --- | --- |+| Account type (prospect / customer / partner / churned) | Seeded `SELECT` field — Prospect, Customer, Partner, Churned | Turn on table + filter | Small |+| Inside Sales / BDR owner (separate from AE / account owner) | Seeded `USER` field, sits beside Owner | Turn on table + filter | Small |+| Segment / tier | Seeded `SELECT` field — Enterprise, Mid-Market, SMB | Turn on table + filter | Small |+| ICP fit score | Seeded `NUMBER` field; agent scoring is a natural next step, not a v1 requirement | Turn on table + filter | Small |+| Territory | Seeded `SELECT` field — AMER, EMEA, APAC | Turn on table + filter | Small |+| Lifecycle stage | Seeded `SELECT` field — Lead, MQL, SQL, Opportunity, Customer, … | Turn on table + filter | Small |+| Lead source (IB / OB / Event) | Seeded `SELECT` field — Inbound, Outbound, Event, kept separate from the `source` enum that records how a row entered the CRM | Turn on table + filter | Small |++### Contacts view++| Field he wants | Where it stands today | Plan | Effort |+| --- | --- | --- | --- |+| Title filter | Column exists, shown on the table, no filter | Add it as a filter | Small |+| Seniority | The agent already infers and scores this per contact — never synced anywhere filterable | Sync into a real column the same way title already syncs; then filter on it | Medium |+| Persona | Agent infers this as "function" — same situation as seniority | Same fix as seniority, same pipeline | Medium |+| Engagement / activity recency | Last-activity date is tracked and shown, not filterable | Add an "active within 7 / 30 / 90 days" filter | Medium |+| Sequence status | No source of truth — this CRM does not run sequences | Needs an outreach-tool connection. Deferred, per your note to set integrations aside. | Deferred |++## 4. The part that actually blocks list-building++Adding every field above still will not give a BDR a HubSpot-style+list-builder. The filter bar itself is one value at a time. This is the real+foundation, and it comes before the fields above pay off.++1. **Filters are single-select** *(Medium)* — a BDR cannot say "VP or Director"+ or "SF Bay Area or NYC" in one filter today — each filter holds exactly one+ value.+2. **Admin fields are not filterable at all** *(Medium)* — every custom+ field — present or future — shows up as a column only. None of it reaches+ the filter bar without new plumbing.+3. **No saved or shared views** *(Large)* — a working list a BDR builds today+ lives only in the URL. There is no way to name it, save it, or hand it to a+ teammate.++## 5. Sequence++Four phases, in order — each phase's fields are inert without the phase before+it.++### Phase 1 — Filter engine foundation *(ships first)*++Multi-select ("is any of") on every filter. Any admin-defined `SELECT` or+`USER` field becomes a filter automatically. An activity-recency filter goes in+here too.++Resolves: unlocks every field below · engagement / activity recency++### Phase 2 — Company segmentation fields++Turn on table and filter visibility for the seven Company fields from the gap+map — account type, BDR owner, segment/tier, territory, lifecycle stage, lead+source, ICP fit score. All seven are already seeded; nothing new to create.++Resolves: account type · BDR owner · segment/tier · territory · lifecycle+stage · lead source · ICP fit score++### Phase 3 — Contact intelligence, surfaced++Sync the agent's existing seniority and persona facts into real, filterable+fields. Add the title filter.++Resolves: seniority · persona · title filter++### Phase 4 — Saved & shared views *(later, on request)*++Name a filter combination, save it, share it with the team. Sequence status+waits here too, tied to an outreach-tool connection if that scope reopens.++Resolves: reusable BDR lists · sequence status (needs an integration)++## 6. Issues++Reported in full, including risks this plan does not remove.++1. RISK — New fields alone do not fix list-building. Filters stay single-select+ without phase 1.+ Fix: build multi-select filtering first. Sequence, above, already orders+ this first.+2. NOT DONE — Custom fields are not wired into any filter today. They render as+ table columns only.+ Fix: not done. Planned in phase 1 as automatic facet generation.+3. NOT DONE — Sequence status has no source of truth inside this CRM.+ Fix: not done. Needs an outreach-tool integration — out of scope now, per+ your note.+4. RISK — A BDR owner shipped as an admin field will not appear in+ owner-based reports until someone decides it should.+ Fix: ship as an admin field first. Promote to a first-class column only if+ reporting needs it later.+5. UNKNOWN — No user role distinguishes an AE from a BDR today, so no field+ can default itself by role.+ Fix: not investigated. Confirm before phase 2 whether role-based defaults+ matter to him.++---++Scoped to the CRM's own data model and filter UI. Integrations, per your note,+are out of scope for this plan.diff --git a/packages/auth/package.json b/packages/auth/package.jsonindex 8c501eda..ea671ffc 100644--- a/packages/auth/package.json+++ b/packages/auth/package.json@@ -18,6 +18,7 @@"clean": "rm -rf .turbo node_modules"},"dependencies": {+ "@better-auth/api-key": "1.6.25","@better-auth/sso": "1.6.25","@crm/db": "workspace:*","@crm/env": "workspace:*",diff --git a/packages/auth/src/api-keys.ts b/packages/auth/src/api-keys.tsnew file mode 100644index 00000000..ce3a5c0d--- /dev/null+++ b/packages/auth/src/api-keys.ts@@ -0,0 +1,9 @@+export const API_KEY_HEADER = "x-api-key";+export const API_KEY_PREFIX = "crm_";++export const DAY_SECONDS = 24 * 60 * 60;++export const API_KEY_EXPIRATION = {+ minDays: 1,+ maxDays: 365,+} as const;diff --git a/packages/auth/src/auth.ts b/packages/auth/src/auth.tsindex 5bdc5120..c59c9825 100644--- a/packages/auth/src/auth.ts+++ b/packages/auth/src/auth.ts@@ -1,3 +1,4 @@+import { apiKey } from "@better-auth/api-key";import { sso } from "@better-auth/sso";import { db } from "@crm/db";import { schemas } from "@crm/validation";@@ -6,6 +7,7 @@ import { prismaAdapter } from "better-auth/adapters/prisma";import { APIError } from "better-auth/api";import { genericOAuth } from "better-auth/plugins/generic-oauth";import { organization } from "better-auth/plugins/organization";+import { API_KEY_EXPIRATION, API_KEY_HEADER, API_KEY_PREFIX } from "./api-keys";import { AUTH_COOKIE_PREFIX } from "./cookies";import { env } from "./env";import { ensureWorkspaceMembership } from "./organization";@@ -228,6 +230,20 @@ export const auth = betterAuth({sso({organizationProvisioning: { disabled: true },}),++ apiKey({+ apiKeyHeaders: API_KEY_HEADER,+ defaultPrefix: API_KEY_PREFIX,+ enableSessionForAPIKeys: true,+ requireName: true,+ defaultKeyLength: 32,+ maximumNameLength: 64,+ rateLimit: { enabled: false },+ keyExpiration: {+ maxExpiresIn: API_KEY_EXPIRATION.maxDays,+ minExpiresIn: API_KEY_EXPIRATION.minDays,+ },+ }),],databaseHooks: {diff --git a/packages/auth/src/client.ts b/packages/auth/src/client.tsindex 50159629..980a37b6 100644--- a/packages/auth/src/client.ts+++ b/packages/auth/src/client.ts@@ -1,10 +1,11 @@+import { apiKeyClient } from "@better-auth/api-key/client";import { ssoClient } from "@better-auth/sso/client";import { genericOAuthClient } from "better-auth/client/plugins";import { createAuthClient } from "better-auth/react";export const authClient = createAuthClient({baseURL: globalThis.window?.location.origin,- plugins: [ssoClient(), genericOAuthClient()],+ plugins: [ssoClient(), genericOAuthClient(), apiKeyClient()],});export const { getSession, signIn, signOut, useSession } = authClient;diff --git a/packages/auth/src/cookies.ts b/packages/auth/src/cookies.tsindex 0b00c295..be62b522 100644--- a/packages/auth/src/cookies.ts+++ b/packages/auth/src/cookies.ts@@ -1 +1,2 @@export const AUTH_COOKIE_PREFIX = "crm";+export const SESSION_COOKIE_NAME = `${AUTH_COOKIE_PREFIX}.session_token`;diff --git a/packages/auth/src/index.ts b/packages/auth/src/index.tsindex f673bff7..31fbcbaa 100644--- a/packages/auth/src/index.ts+++ b/packages/auth/src/index.ts@@ -1,6 +1,13 @@+export {+ API_KEY_EXPIRATION,+ API_KEY_HEADER,+ API_KEY_PREFIX,+ DAY_SECONDS,+} from "./api-keys";export { type Auth, auth, type Session, type SessionUser } from "./auth";-export { AUTH_COOKIE_PREFIX } from "./cookies";+export { AUTH_COOKIE_PREFIX, SESSION_COOKIE_NAME } from "./cookies";export {+ apiUrl,appUrl,isGoogleConfigured,isMicrosoftConfigured,diff --git a/packages/db/prisma/migrations/20260820150251_archive_crm_records/migration.sql b/packages/db/prisma/migrations/20260820150251_archive_crm_records/migration.sqlnew file mode 100644index 00000000..28e5ee77--- /dev/null+++ b/packages/db/prisma/migrations/20260820150251_archive_crm_records/migration.sql@@ -0,0 +1,20 @@+-- AlterTable+ALTER TABLE "appSetting" ADD COLUMN "archiveRetentionDays" INTEGER NOT NULL DEFAULT 180;++-- AlterTable+ALTER TABLE "company" ADD COLUMN "archivedAt" TIMESTAMP(3);++-- AlterTable+ALTER TABLE "contact" ADD COLUMN "archivedAt" TIMESTAMP(3);++-- AlterTable+ALTER TABLE "deal" ADD COLUMN "archivedAt" TIMESTAMP(3);++-- CreateIndex+CREATE INDEX "company_archivedAt_idx" ON "company"("archivedAt");++-- CreateIndex+CREATE INDEX "contact_archivedAt_idx" ON "contact"("archivedAt");++-- CreateIndex+CREATE INDEX "deal_archivedAt_idx" ON "deal"("archivedAt");diff --git a/packages/db/prisma/migrations/20260820150700_list_building_fields/migration.sql b/packages/db/prisma/migrations/20260820150700_list_building_fields/migration.sqlnew file mode 100644index 00000000..8979286d--- /dev/null+++ b/packages/db/prisma/migrations/20260820150700_list_building_fields/migration.sql@@ -0,0 +1,3 @@+-- AlterTable+ALTER TABLE "contact" ADD COLUMN "function" TEXT,+ADD COLUMN "seniority" TEXT;diff --git a/packages/db/prisma/migrations/20260820152910_add_api_keys/migration.sql b/packages/db/prisma/migrations/20260820152910_add_api_keys/migration.sqlnew file mode 100644index 00000000..b2bba7c7--- /dev/null+++ b/packages/db/prisma/migrations/20260820152910_add_api_keys/migration.sql@@ -0,0 +1,39 @@+-- CreateTable+CREATE TABLE "apikey" (+ "id" TEXT NOT NULL,+ "configId" TEXT NOT NULL DEFAULT 'default',+ "name" TEXT,+ "start" TEXT,+ "referenceId" TEXT NOT NULL,+ "prefix" TEXT,+ "key" TEXT NOT NULL,+ "refillInterval" INTEGER,+ "refillAmount" INTEGER,+ "lastRefillAt" TIMESTAMP(3),+ "enabled" BOOLEAN DEFAULT true,+ "rateLimitEnabled" BOOLEAN DEFAULT true,+ "rateLimitTimeWindow" INTEGER,+ "rateLimitMax" INTEGER,+ "requestCount" INTEGER DEFAULT 0,+ "remaining" INTEGER,+ "lastRequest" TIMESTAMP(3),+ "expiresAt" TIMESTAMP(3),+ "createdAt" TIMESTAMP(3) NOT NULL,+ "updatedAt" TIMESTAMP(3) NOT NULL,+ "permissions" TEXT,+ "metadata" TEXT,++ CONSTRAINT "apikey_pkey" PRIMARY KEY ("id")+);++-- CreateIndex+CREATE INDEX "apikey_referenceId_idx" ON "apikey"("referenceId");++-- CreateIndex+CREATE INDEX "apikey_configId_idx" ON "apikey"("configId");++-- CreateIndex+CREATE INDEX "apikey_key_idx" ON "apikey"("key");++-- AddForeignKey+ALTER TABLE "apikey" ADD CONSTRAINT "apikey_referenceId_fkey" FOREIGN KEY ("referenceId") REFERENCES "user"("id") ON DELETE CASCADE ON UPDATE CASCADE;diff --git a/packages/db/prisma/migrations/20260820154345_saved_views/migration.sql b/packages/db/prisma/migrations/20260820154345_saved_views/migration.sqlnew file mode 100644index 00000000..a724f2ca--- /dev/null+++ b/packages/db/prisma/migrations/20260820154345_saved_views/migration.sql@@ -0,0 +1,22 @@+-- CreateTable+CREATE TABLE "savedView" (+ "id" TEXT NOT NULL,+ "entity" "FieldEntity" NOT NULL,+ "name" TEXT NOT NULL,+ "shared" BOOLEAN NOT NULL DEFAULT false,+ "filters" JSONB NOT NULL,+ "ownerId" TEXT NOT NULL,+ "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,+ "updatedAt" TIMESTAMP(3) NOT NULL,++ CONSTRAINT "savedView_pkey" PRIMARY KEY ("id")+);++-- CreateIndex+CREATE INDEX "savedView_entity_shared_idx" ON "savedView"("entity", "shared");++-- CreateIndex+CREATE UNIQUE INDEX "savedView_entity_ownerId_name_key" ON "savedView"("entity", "ownerId", "name");++-- AddForeignKey+ALTER TABLE "savedView" ADD CONSTRAINT "savedView_ownerId_fkey" FOREIGN KEY ("ownerId") REFERENCES "user"("id") ON DELETE CASCADE ON UPDATE CASCADE;diff --git a/packages/db/prisma/migrations/20260820154825_field_show_on_filter/migration.sql b/packages/db/prisma/migrations/20260820154825_field_show_on_filter/migration.sqlnew file mode 100644index 00000000..e7353a4a--- /dev/null+++ b/packages/db/prisma/migrations/20260820154825_field_show_on_filter/migration.sql@@ -0,0 +1,2 @@+-- AlterTable+ALTER TABLE "fieldDefinition" ADD COLUMN "showOnFilter" BOOLEAN NOT NULL DEFAULT false;diff --git a/packages/db/prisma/migrations/20260820160000_backfill_seniority_function/migration.sql b/packages/db/prisma/migrations/20260820160000_backfill_seniority_function/migration.sqlnew file mode 100644index 00000000..2ad69c70--- /dev/null+++ b/packages/db/prisma/migrations/20260820160000_backfill_seniority_function/migration.sql@@ -0,0 +1,30 @@+-- DataMigration+-- Copies the already-APPLIED seniority/function contactFact values onto the+-- contact columns added in 20260820150700_list_building_fields. Those facts+-- were recorded before the columns existed, so recordFact's own write path+-- never touched them. A contact can have more than one APPLIED fact for the+-- same field (re-applied over time); DISTINCT ON picks the most recently+-- observed one deterministically, breaking ties by id.+UPDATE "contact" c+SET "seniority" = f."value"+FROM (+ SELECT DISTINCT ON (f."contactId") f."contactId", f."value"+ FROM "contactFact" f+ WHERE f."field" = 'seniority'+ AND f."status" = 'APPLIED'+ ORDER BY f."contactId", f."observedAt" DESC, f."id" DESC+) f+WHERE f."contactId" = c."id"+ AND c."seniority" IS NULL;++UPDATE "contact" c+SET "function" = f."value"+FROM (+ SELECT DISTINCT ON (f."contactId") f."contactId", f."value"+ FROM "contactFact" f+ WHERE f."field" = 'function'+ AND f."status" = 'APPLIED'+ ORDER BY f."contactId", f."observedAt" DESC, f."id" DESC+) f+WHERE f."contactId" = c."id"+ AND c."function" IS NULL;diff --git a/packages/db/prisma/migrations/20260820161500_archive_scoped_uniqueness/migration.sql b/packages/db/prisma/migrations/20260820161500_archive_scoped_uniqueness/migration.sqlnew file mode 100644index 00000000..754562e3--- /dev/null+++ b/packages/db/prisma/migrations/20260820161500_archive_scoped_uniqueness/migration.sql@@ -0,0 +1,11 @@+-- DropIndex+DROP INDEX "company_domain_key";++-- DropIndex+DROP INDEX "contact_email_key";++-- CreateIndex+CREATE UNIQUE INDEX "company_domain_active_key" ON "company"("domain") WHERE ("archivedAt" IS NULL);++-- CreateIndex+CREATE UNIQUE INDEX "contact_email_active_key" ON "contact"("email") WHERE ("archivedAt" IS NULL);diff --git a/packages/db/prisma/schema.prisma b/packages/db/prisma/schema.prismaindex 28a49c39..82bc1f36 100644--- a/packages/db/prisma/schema.prisma+++ b/packages/db/prisma/schema.prisma@@ -31,6 +31,7 @@ model User {factDecisions ContactFact[] @relation("FactDecider")conversations AgentConversation[] @relation("ConversationOwner")fieldValues FieldValue[] @relation("FieldValueUser")+ savedViews SavedView[] @relation("SavedViewOwner")createdAgentDefinitions AgentDefinition[] @relation("AgentDefinitionCreator")createdAgentVersions AgentVersion[] @relation("AgentVersionCreator")@@ -47,19 +48,21 @@ model User {ssoproviders SsoProvider[]+ apiKeys Apikey[]+@@unique([email])@@map("user")}model SlackMemberMatch {- id String @id @default(cuid())- crmUserId String @unique- crmUser User @relation(fields: [crmUserId], references: [id], onDelete: Cascade)- slackUserId String?- slackHandle String?- slackEmail String?- createdAt DateTime @default(now())- updatedAt DateTime @updatedAt+ id String @id @default(cuid())+ crmUserId String @unique+ crmUser User @relation(fields: [crmUserId], references: [id], onDelete: Cascade)+ slackUserId String?+ slackHandle String?+ slackEmail String?+ createdAt DateTime @default(now())+ updatedAt DateTime @updatedAt@@index([slackUserId])@@map("slackMemberMatch")@@ -277,7 +280,7 @@ enum AgentResponseRating {model Company {id String @id @default(cuid())name String- domain String? @unique+ domain String?website String?description String?@@ -316,6 +319,7 @@ model Company {source RecordSource @default(MANUAL)lastActivityAt DateTime?+ archivedAt DateTime?contacts Contact[] @relation("CompanyContacts")conversations AgentConversation[]@@ -327,9 +331,11 @@ model Company {createdAt DateTime @default(now())updatedAt DateTime @updatedAt+ @@unique([domain], map: "company_domain_active_key", where: { archivedAt: null })@@index([ownerId])@@index([name])@@index([lastActivityAt])+ @@index([archivedAt])@@map("company")}@@ -347,9 +353,11 @@ model Contact {id String @id @default(cuid())firstName StringlastName String?- email String? @unique+ email String?phone String?title String?+ seniority String?+ function String?linkedinUrl String?twitterUrl String?githubUrl String?@@ -374,6 +382,7 @@ model Contact {source RecordSource @default(MANUAL)lastActivityAt DateTime?+ archivedAt DateTime?deals DealContact[]activities Activity[]@@ -386,9 +395,11 @@ model Contact {createdAt DateTime @default(now())updatedAt DateTime @updatedAt+ @@unique([email], map: "contact_email_active_key", where: { archivedAt: null })@@index([companyId])@@index([ownerId])@@index([lastActivityAt])+ @@index([archivedAt])@@map("contact")}@@ -926,6 +937,7 @@ model Deal {fxRateAt DateTime?lastActivityAt DateTime?+ archivedAt DateTime?contacts DealContact[]activities Activity[]@@ -940,6 +952,7 @@ model Deal {@@index([lastActivityAt])@@index([baseAmount])@@index([currency])+ @@index([archivedAt])@@map("deal")}@@ -1005,10 +1018,11 @@ model FieldDefinition {agentFilled Boolean @default(true)agentBrief String?- required Boolean @default(false)- showOnSheet Boolean @default(true)- showOnTable Boolean @default(false)- position Int+ required Boolean @default(false)+ showOnSheet Boolean @default(true)+ showOnTable Boolean @default(false)+ showOnFilter Boolean @default(false)+ position IntarchivedAt DateTime?@@ -1074,6 +1088,24 @@ model FieldValue {@@map("fieldValue")}+model SavedView {+ id String @id @default(cuid())+ entity FieldEntity+ name String+ shared Boolean @default(false)+ filters Json++ ownerId String+ owner User @relation("SavedViewOwner", fields: [ownerId], references: [id], onDelete: Cascade)++ createdAt DateTime @default(now())+ updatedAt DateTime @updatedAt++ @@unique([entity, ownerId, name])+ @@index([entity, shared])+ @@map("savedView")+}+model Activity {id String @id @default(cuid())type ActivityType@@ -1277,15 +1309,17 @@ model AppSetting {ratesRefreshedAt DateTime?- trackingSiteId String? @unique- trackingCrossDomain Boolean @default(true)- trackingLimitToDomains Boolean @default(true)- trackingCookieSubdomains Boolean @default(false)- trackingSecureCookies Boolean @default(true)- trackingHonourDnt Boolean @default(true)- trackingCookieDays Int @default(395)+ archiveRetentionDays Int @default(180)++ trackingSiteId String? @unique+ trackingCrossDomain Boolean @default(true)+ trackingLimitToDomains Boolean @default(true)+ trackingCookieSubdomains Boolean @default(false)+ trackingSecureCookies Boolean @default(true)+ trackingHonourDnt Boolean @default(true)+ trackingCookieDays Int @default(395)trackingConfigHash String?- trackingPaused Boolean @default(false)+ trackingPaused Boolean @default(false)updatedAt DateTime @updatedAt@@ -1316,14 +1350,14 @@ model TrackedVisitor {contactId String?contact Contact? @relation("VisitorContact", fields: [contactId], references: [id], onDelete: SetNull)- firstSource String?- firstMedium String?- firstCampaign String?- firstTerm String?- firstContent String?- firstReferrer String?- firstLanding String?- firstTouchAt DateTime?+ firstSource String?+ firstMedium String?+ firstCampaign String?+ firstTerm String?+ firstContent String?+ firstReferrer String?+ firstLanding String?+ firstTouchAt DateTime?lastSource String?lastMedium String?@@ -1518,3 +1552,34 @@ model SsoProvider {@@unique([providerId])@@map("ssoProvider")}++model Apikey {+ id String @id+ configId String @default("default")+ name String?+ start String?+ referenceId String+ user User @relation(fields: [referenceId], references: [id], onDelete: Cascade)+ prefix String?+ key String+ refillInterval Int?+ refillAmount Int?+ lastRefillAt DateTime?+ enabled Boolean? @default(true)+ rateLimitEnabled Boolean? @default(true)+ rateLimitTimeWindow Int?+ rateLimitMax Int?+ requestCount Int? @default(0)+ remaining Int?+ lastRequest DateTime?+ expiresAt DateTime?+ createdAt DateTime+ updatedAt DateTime+ permissions String?+ metadata String?++ @@index([referenceId])+ @@index([configId])+ @@index([key])+ @@map("apikey")+}diff --git a/packages/db/prisma/seed.ts b/packages/db/prisma/seed.tsindex 1ba1dcc0..556f2e2e 100644--- a/packages/db/prisma/seed.ts+++ b/packages/db/prisma/seed.ts@@ -2,9 +2,12 @@ import { mirror } from "../src/blob";import { db } from "../src/client";import { DEFAULT_REPORTING_CURRENCY } from "../src/currency";import { resolveFavicon } from "../src/favicon";+import { fieldKeyFromLabel } from "../src/fields-shape";import {ActivityType,DealStage,+ type FieldEntity,+ FieldType,RateSource,} from "../src/generated/prisma/enums";import { readReportingCurrency, SETTINGS_ID } from "../src/settings";@@ -422,6 +425,228 @@ async function seedIcons(console.log(`Resolved ${resolved} of ${missing.length} company icons.`);}+const ACCOUNT_TYPES = ["Prospect", "Customer", "Partner", "Churned"] as const;+const SEGMENT_TIERS = ["Enterprise", "Mid-Market", "SMB"] as const;+const TERRITORIES = ["AMER", "EMEA", "APAC"] as const;+const LIFECYCLE_STAGES = [+ "Lead",+ "MQL",+ "SQL",+ "Opportunity",+ "Customer",+] as const;+const LEAD_SOURCES = ["Inbound", "Outbound", "Event"] as const;++type SeededField = {+ id: string;+ key: string;+ options: { id: string; label: string }[];+};++type SeededFieldSet = {+ accountType: SeededField;+ segment: SeededField;+ territory: SeededField;+ lifecycleStage: SeededField;+ leadSource: SeededField;+ icpFitScore: SeededField;+ bdrOwner: SeededField;+};++async function upsertField(+ entity: FieldEntity,+ label: string,+ type: FieldType,+ position: number,+ options: readonly string[] = [],+): Promise<SeededField> {+ const key = fieldKeyFromLabel(label);+ const definition = await db.fieldDefinition.upsert({+ where: { entity_key: { entity, key } },+ create: {+ entity,+ key,+ label,+ type,+ showOnTable: false,+ showOnFilter: false,+ agentFilled: type !== "USER" && type !== "NUMBER",+ position,+ options: {+ create: options.map((optionLabel, index) => ({+ label: optionLabel,+ position: index,+ })),+ },+ },+ update: {},+ include: { options: true },+ });++ return {+ id: definition.id,+ key: definition.key,+ options: definition.options,+ };+}++async function seedCompanyFields(): Promise<SeededFieldSet> {+ const [+ accountType,+ segment,+ territory,+ lifecycleStage,+ leadSource,+ icpFitScore,+ bdrOwner,+ ] = await Promise.all([+ upsertField("COMPANY", "Account type", FieldType.SELECT, 0, ACCOUNT_TYPES),+ upsertField("COMPANY", "Segment", FieldType.SELECT, 1, SEGMENT_TIERS),+ upsertField("COMPANY", "Territory", FieldType.SELECT, 2, TERRITORIES),+ upsertField(+ "COMPANY",+ "Lifecycle stage",+ FieldType.SELECT,+ 3,+ LIFECYCLE_STAGES,+ ),+ upsertField("COMPANY", "Lead source", FieldType.SELECT, 4, LEAD_SOURCES),+ upsertField("COMPANY", "ICP fit score", FieldType.NUMBER, 5),+ upsertField("COMPANY", "BDR owner", FieldType.USER, 6),+ ]);++ return {+ accountType,+ segment,+ territory,+ lifecycleStage,+ leadSource,+ icpFitScore,+ bdrOwner,+ };+}++function optionIdFor(field: SeededField, label: string): string {+ const option = field.options.find((entry) => entry.label === label);+ if (!option)+ throw new Error(`Seed field "${field.key}" has no "${label}" option.`);+ return option.id;+}++async function seedCompanyFieldValues(+ fields: SeededFieldSet,+ companies: { id: string }[],+ ownerIds: string[],+): Promise<void> {+ for (const company of companies) {+ const accountType = pick(ACCOUNT_TYPES);++ await Promise.all([+ db.fieldValue.upsert({+ where: {+ fieldId_companyId: {+ fieldId: fields.accountType.id,+ companyId: company.id,+ },+ },+ create: {+ fieldId: fields.accountType.id,+ companyId: company.id,+ optionId: optionIdFor(fields.accountType, accountType),+ },+ update: {},+ }),+ db.fieldValue.upsert({+ where: {+ fieldId_companyId: {+ fieldId: fields.segment.id,+ companyId: company.id,+ },+ },+ create: {+ fieldId: fields.segment.id,+ companyId: company.id,+ optionId: optionIdFor(fields.segment, pick(SEGMENT_TIERS)),+ },+ update: {},+ }),+ db.fieldValue.upsert({+ where: {+ fieldId_companyId: {+ fieldId: fields.territory.id,+ companyId: company.id,+ },+ },+ create: {+ fieldId: fields.territory.id,+ companyId: company.id,+ optionId: optionIdFor(fields.territory, pick(TERRITORIES)),+ },+ update: {},+ }),+ db.fieldValue.upsert({+ where: {+ fieldId_companyId: {+ fieldId: fields.lifecycleStage.id,+ companyId: company.id,+ },+ },+ create: {+ fieldId: fields.lifecycleStage.id,+ companyId: company.id,+ optionId: optionIdFor(+ fields.lifecycleStage,+ accountType === "Customer" ? "Customer" : pick(LIFECYCLE_STAGES),+ ),+ },+ update: {},+ }),+ db.fieldValue.upsert({+ where: {+ fieldId_companyId: {+ fieldId: fields.leadSource.id,+ companyId: company.id,+ },+ },+ create: {+ fieldId: fields.leadSource.id,+ companyId: company.id,+ optionId: optionIdFor(fields.leadSource, pick(LEAD_SOURCES)),+ },+ update: {},+ }),+ db.fieldValue.upsert({+ where: {+ fieldId_companyId: {+ fieldId: fields.icpFitScore.id,+ companyId: company.id,+ },+ },+ create: {+ fieldId: fields.icpFitScore.id,+ companyId: company.id,+ number: integer(40, 95),+ },+ update: {},+ }),+ db.fieldValue.upsert({+ where: {+ fieldId_companyId: {+ fieldId: fields.bdrOwner.id,+ companyId: company.id,+ },+ },+ create: {+ fieldId: fields.bdrOwner.id,+ companyId: company.id,+ userId: pick(ownerIds),+ },+ update: {},+ }),+ ]);+ }+}+type SeededContact = { id: string; companyId: string };async function seedContacts(@@ -773,10 +998,13 @@ async function main() {const contacts = await seedContacts(companies, ownerIds);const deals = await seedDeals(companies, contacts, ownerIds);const activities = await seedActivities(companies, contacts, deals, ownerIds);+ const companyFields = await seedCompanyFields();+ await seedCompanyFieldValues(companyFields, companies, ownerIds);console.log(`Seeded ${companies.length} companies, ${contacts.length} contacts, ` +- `${deals.length} deals, ${activities} activities, ${rates} exchange rates.`,+ `${deals.length} deals, ${activities} activities, ${rates} exchange rates, ` ++ "7 company fields.",);}diff --git a/packages/db/src/fields.ts b/packages/db/src/fields.tsindex 8b0b88ea..4c34ad0b 100644--- a/packages/db/src/fields.ts+++ b/packages/db/src/fields.ts@@ -39,6 +39,7 @@ export type SerializedField = {required: boolean;showOnSheet: boolean;showOnTable: boolean;+ showOnFilter: boolean;position: number;archived: boolean;options: SerializedFieldOption[];@@ -59,6 +60,7 @@ export function serializeField(required: definition.required,showOnSheet: definition.showOnSheet,showOnTable: definition.showOnTable,+ showOnFilter: definition.showOnFilter,position: definition.position,archived: definition.archivedAt !== null,options: definition.optionsdiff --git a/packages/db/src/settings.ts b/packages/db/src/settings.tsindex 7e90d5ba..2959bf05 100644--- a/packages/db/src/settings.ts+++ b/packages/db/src/settings.ts@@ -121,6 +121,39 @@ export async function writeRatesRefreshedAt(});}+export const DEFAULT_ARCHIVE_RETENTION_DAYS = 180;++export const MIN_ARCHIVE_RETENTION_DAYS = 1;++export const MAX_ARCHIVE_RETENTION_DAYS = 3650;++export async function readArchiveRetentionDays(db: Db): Promise<number> {+ const row = await db.appSetting.findUnique({+ where: { id: SETTINGS_ID },+ select: { archiveRetentionDays: true },+ });++ return row?.archiveRetentionDays ?? DEFAULT_ARCHIVE_RETENTION_DAYS;+}++export async function writeArchiveRetentionDays(+ db: Db,+ days: number,+): Promise<number> {+ const archiveRetentionDays = Math.min(+ Math.max(Math.round(days), MIN_ARCHIVE_RETENTION_DAYS),+ MAX_ARCHIVE_RETENTION_DAYS,+ );++ await db.appSetting.upsert({+ where: { id: SETTINGS_ID },+ create: { id: SETTINGS_ID, archiveRetentionDays },+ update: { archiveRetentionDays },+ });++ return archiveRetentionDays;+}+export function maskKey(key: string): string {const trimmed = key.trim();return trimmed.length > 4 ? `••••${trimmed.slice(-4)}` : "••••";diff --git a/packages/ui/src/components/combobox.tsx b/packages/ui/src/components/combobox.tsxindex 5014a6ab..8936e0e2 100644--- a/packages/ui/src/components/combobox.tsx+++ b/packages/ui/src/components/combobox.tsx@@ -114,9 +114,11 @@ function Combobox({onValueChange(option.value);}}>- <span className="truncate">{option.label}</span>+ <span className="min-w-0 flex-1 truncate">+ {option.label}+ </span>{option.hint ? (- <span className="ml-auto truncate text-muted-foreground text-xs">+ <span className="shrink-0 truncate text-muted-foreground text-xs">{option.hint}</span>) : null}diff --git a/packages/ui/src/components/data-table.tsx b/packages/ui/src/components/data-table.tsxindex dd7819ab..2f3663b4 100644--- a/packages/ui/src/components/data-table.tsx+++ b/packages/ui/src/components/data-table.tsx@@ -21,17 +21,16 @@ import {DropdownMenu,DropdownMenuCheckboxItem,DropdownMenuContent,+ DropdownMenuItem,DropdownMenuLabel,DropdownMenuRadioGroup,DropdownMenuRadioItem,DropdownMenuSeparator,+ DropdownMenuSub,+ DropdownMenuSubContent,+ DropdownMenuSubTrigger,DropdownMenuTrigger,} from "@crm/ui/components/dropdown-menu";-import {- Popover,- PopoverContent,- PopoverTrigger,-} from "@crm/ui/components/popover";import { Spinner } from "@crm/ui/components/spinner";import { TablePagination } from "@crm/ui/components/table-pagination";import {@@ -48,7 +47,6 @@ import type { TableQueryState } from "@crm/ui/lib/table-query";import { cn } from "@crm/ui/lib/utils";import { parseAsArrayOf, parseAsString, useQueryState } from "nuqs";import {- type ComponentProps,Fragment,type ReactNode,useDeferredValue,@@ -165,96 +163,103 @@ function SortIndicator({);}-function FacetTrigger({- label,- ...props-}: ComponentProps<typeof Button> & { label: string }) {- return (- <Button variant="outline" size="sm" className="justify-between" {...props}>- <span className="truncate">{label}</span>- <ChevronDown data-icon="inline-end" className="opacity-60" />- </Button>- );+function facetLabel(facet: DataTableFacet, selected: string[]): string {+ if (selected.length === 0) return facet.label;+ if (selected.length === 1) {+ const option = facet.options.find((o) => o.value === selected[0]);+ return option?.label ?? facet.label;+ }+ return `${facet.label} (${selected.length})`;}-function SearchableFacet({+function toggle(selected: string[], value: string, checked: boolean): string[] {+ return checked ? [...selected, value] : selected.filter((v) => v !== value);+}++function FacetSubmenu({facet,selected,- activeLabel,- onSelect,+ onChange,}: {facet: DataTableFacet;- selected: string;- activeLabel?: string;- onSelect: (value: string) => void;+ selected: string[];+ onChange: (values: string[]) => void;}) {- const [open, setOpen] = useState(false);- const [seen, setSeen] = useState<{ value: string; label: string } | null>(- null,- );-- if (activeLabel && (seen?.value !== selected || seen.label !== activeLabel)) {- setSeen({ value: selected, label: activeLabel });- }-- const label =- activeLabel ??- (seen?.value === selected ? seen.label : undefined) ??- facet.label;-- const choose = (value: string) => {- setOpen(false);- facet.onSearchChange?.("");- onSelect(value);- };-return (- <Popover- open={open}- onOpenChange={(next) => {- setOpen(next);- if (!next) facet.onSearchChange?.("");- }}- >- <PopoverTrigger asChild>- <FacetTrigger label={label} />- </PopoverTrigger>- <PopoverContent align="start" size="fit" className="w-64">- <Command shouldFilter={facet.onSearchChange === undefined}>- <CommandInput- placeholder={`Search ${facet.label.toLowerCase()}…`}- value={facet.search}- onValueChange={facet.onSearchChange}- />- <CommandList>- <CommandEmpty>{facet.empty ?? "Nothing matches."}</CommandEmpty>- <CommandGroup>- {facet.search?.trim() ? null : (- <CommandItem- value={facet.label}- disabled={facet.stale}- data-checked={selected === "all"}- onSelect={() => choose("all")}- >- {facet.label}- </CommandItem>- )}- {facet.options.map((option) => (- <CommandItem+ <DropdownMenuSub>+ <DropdownMenuSubTrigger>+ <span className="flex-1">{facet.label}</span>+ {selected.length > 0 && (+ <span className="tabular-nums opacity-60">({selected.length})</span>+ )}+ </DropdownMenuSubTrigger>+ <DropdownMenuSubContent className="max-h-72 min-w-52 overflow-hidden">+ {facet.searchable ? (+ <Command+ shouldFilter={facet.onSearchChange === undefined}+ className="max-h-72"+ >+ <CommandInput+ placeholder={`Search ${facet.label.toLowerCase()}…`}+ value={facet.search}+ onValueChange={facet.onSearchChange}+ onKeyDown={(event) => event.stopPropagation()}+ />+ <CommandList>+ <CommandEmpty>{facet.empty ?? "Nothing matches."}</CommandEmpty>+ <CommandGroup>+ {facet.options.map((option) => {+ const checked = selected.includes(option.value);+ return (+ <CommandItem+ key={option.value}+ value={option.label}+ disabled={facet.stale}+ data-checked={checked}+ onSelect={() =>+ onChange(toggle(selected, option.value, !checked))+ }+ >+ <Checkbox+ checked={checked}+ className="pointer-events-none"+ />+ <span className="truncate">{option.label}</span>+ </CommandItem>+ );+ })}+ </CommandGroup>+ </CommandList>+ </Command>+ ) : (+ <div className="max-h-72 overflow-y-auto">+ {selected.length > 0 && (+ <>+ <DropdownMenuItem onSelect={() => onChange([])}>+ Clear+ </DropdownMenuItem>+ <DropdownMenuSeparator />+ </>+ )}+ {facet.options.map((option) => {+ const checked = selected.includes(option.value);+ return (+ <DropdownMenuCheckboxItemkey={option.value}- value={option.label}- disabled={facet.stale}- data-checked={selected === option.value}- onSelect={() => choose(option.value)}+ checked={checked}+ onSelect={(event) => event.preventDefault()}+ onCheckedChange={(next) =>+ onChange(toggle(selected, option.value, next))+ }>- <span className="truncate">{option.label}</span>- </CommandItem>- ))}- </CommandGroup>- </CommandList>- </Command>- </PopoverContent>- </Popover>+ {option.label}+ </DropdownMenuCheckboxItem>+ );+ })}+ </div>+ )}+ </DropdownMenuSubContent>+ </DropdownMenuSub>);}@@ -320,18 +325,30 @@ export function DataTable<TRow, TSub = unknown>({const pageSize = query.pageSize;const totalPages = Math.max(1, Math.ceil(total / pageSize));+ const availableFacets = useMemo(+ () =>+ (facets ?? []).filter(+ (facet) =>+ facet.options.length > 0 ||+ facet.searchable ||+ (query.filters[facet.id]?.length ?? 0) > 0,+ ),+ [facets, query.filters],+ );+const hasFilterControls =tabs != null ||- (facets?.length ?? 0) > 0 ||+ availableFacets.length > 0 ||sortableColumns.length > 0 ||anyExpandable ||hideable.length > 0 ||actions != null ||leadingActions != null;+ const activeFacetFilterCount = availableFacets.filter(+ (facet) => (query.filters[facet.id]?.length ?? 0) > 0,+ ).length;const activeFilterCount =- (tabs && query.tab !== "all" ? 1 : 0) +- (facets?.filter((facet) => (query.filters[facet.id] ?? "all") !== "all")- .length ?? 0);+ (tabs && query.tab !== "all" ? 1 : 0) + activeFacetFilterCount;return (<div className={cn("flex min-h-0 flex-1 flex-col gap-3", className)}>@@ -439,48 +456,35 @@ export function DataTable<TRow, TSub = unknown>({{leadingActions}<div className="grid grid-cols-1 gap-2 sm:flex sm:flex-wrap sm:items-center lg:ml-auto">- {facets?.map((facet) => {- const selected = query.filters[facet.id] ?? "all";- const active = facet.options.find((o) => o.value === selected);-- if (facet.searchable) {- return (- <SearchableFacet- key={facet.id}- facet={facet}- selected={selected}- activeLabel={active?.label}- onSelect={(value) => query.setFilter(facet.id, value)}- />- );- }-- return (- <DropdownMenu key={facet.id}>- <DropdownMenuTrigger asChild>- <FacetTrigger label={active ? active.label : facet.label} />- </DropdownMenuTrigger>- <DropdownMenuContent align="start" className="min-w-44">- <DropdownMenuRadioGroup- value={selected}- onValueChange={(value) => query.setFilter(facet.id, value)}- >- <DropdownMenuRadioItem value="all">- {facet.label}- </DropdownMenuRadioItem>- {facet.options.map((option) => (- <DropdownMenuRadioItem- key={option.value}- value={option.value}- >- {option.label}- </DropdownMenuRadioItem>- ))}- </DropdownMenuRadioGroup>- </DropdownMenuContent>- </DropdownMenu>- );- })}+ {availableFacets.length > 0 && (+ <DropdownMenu>+ <DropdownMenuTrigger asChild>+ <Button+ variant="outline"+ size="sm"+ className="justify-start sm:justify-center"+ >+ <Filter data-icon="inline-start" />+ Filters+ {activeFacetFilterCount > 0 && (+ <span className="tabular-nums opacity-60">+ ({activeFacetFilterCount})+ </span>+ )}+ </Button>+ </DropdownMenuTrigger>+ <DropdownMenuContent align="start" className="min-w-48">+ {availableFacets.map((facet) => (+ <FacetSubmenu+ key={facet.id}+ facet={facet}+ selected={query.filters[facet.id] ?? []}+ onChange={(values) => query.setFilter(facet.id, values)}+ />+ ))}+ </DropdownMenuContent>+ </DropdownMenu>+ )}{(sortableColumns.length > 0 || anyExpandable) && (<DropdownMenu><DropdownMenuTrigger asChild>diff --git a/packages/ui/src/components/icons/bot.tsx b/packages/ui/src/components/icons/bot.tsxnew file mode 100644index 00000000..1449efff--- /dev/null+++ b/packages/ui/src/components/icons/bot.tsx@@ -0,0 +1,39 @@+import type * as React from "react";++type BotProps = React.SVGProps<SVGSVGElement> & {+ size?: number | string;+};++export default function Bot({ size = 16, ...rest }: BotProps) {+ return (+ <svg+ width={size}+ height={size}+ viewBox="0 0 32 32"+ xmlns="http://www.w3.org/2000/svg"+ fill="currentColor"+ {...rest}+ >+ <path+ fillRule="evenodd"+ d="M2,16a14,14,0,1,0,28,0a14,14,0,1,0,-28,0Z M4,16a12,12,0,1,0,24,0a12,12,0,1,0,-24,0Z"+ />+ <rect+ x="9.5"+ y="11"+ width="3"+ height="8"+ rx="1.5"+ transform="rotate(-10 11 15)"+ />+ <rect+ x="19.5"+ y="11"+ width="3"+ height="8"+ rx="1.5"+ transform="rotate(10 21 15)"+ />+ </svg>+ );+}diff --git a/packages/ui/src/lib/table-query.ts b/packages/ui/src/lib/table-query.tsindex 3b5549ea..af4c97ff 100644--- a/packages/ui/src/lib/table-query.ts+++ b/packages/ui/src/lib/table-query.ts@@ -7,11 +7,11 @@ export type TableQueryState = {pageSize: number;tab: string;tabId?: string;- filters: Record<string, string>;+ filters: Record<string, string[]>;toggleSort: (id: string) => void;setSort: (id: string) => void;setDir: (dir: SortDirection) => void;- setPage: (page: number) => void;+ setPage: (page: number) => Promise<void>;setTab: (value: string) => void;- setFilter: (id: string, value: string) => void;+ setFilter: (id: string, values: string[]) => void;};diff --git a/packages/validation/package.json b/packages/validation/package.jsonindex 0ab67f1f..d6fb2c36 100644--- a/packages/validation/package.json+++ b/packages/validation/package.json@@ -11,7 +11,10 @@"./builder-question": "./src/builder-question.ts","./enrichment-queue": "./src/enrichment-queue.ts","./eve-stream": "./src/eve-stream.ts",- "./eve-tool": "./src/eve-tool.ts"+ "./eve-tool": "./src/eve-tool.ts",+ "./field-backfill": "./src/field-backfill.ts",+ "./field-templates": "./src/field-templates.ts",+ "./saved-view": "./src/saved-view.ts"},"scripts": {"check-types": "tsc --noEmit",diff --git a/packages/validation/src/field-backfill.ts b/packages/validation/src/field-backfill.tsnew file mode 100644index 00000000..55e8aaeb--- /dev/null+++ b/packages/validation/src/field-backfill.ts@@ -0,0 +1,8 @@+import { z } from "zod";++export const fieldBackfillPayload = z.object({+ entity: z.enum(["COMPANY", "CONTACT", "DEAL"]),+ keys: z.array(z.string()).min(1),+});++export type FieldBackfillPayload = z.infer<typeof fieldBackfillPayload>;diff --git a/packages/validation/src/field-templates.ts b/packages/validation/src/field-templates.tsnew file mode 100644index 00000000..52f15e62--- /dev/null+++ b/packages/validation/src/field-templates.ts@@ -0,0 +1,39 @@+export type FieldTemplate = {+ label: string;+ type: "SELECT" | "USER" | "NUMBER";+ options?: readonly string[];+};++export const FIELD_TEMPLATES = {+ COMPANY: [+ {+ label: "Account type",+ type: "SELECT",+ options: ["Prospect", "Customer", "Partner", "Churned"],+ },+ {+ label: "Segment",+ type: "SELECT",+ options: ["Enterprise", "Mid-Market", "SMB"],+ },+ {+ label: "Territory",+ type: "SELECT",+ options: ["AMER", "EMEA", "APAC"],+ },+ {+ label: "Lifecycle stage",+ type: "SELECT",+ options: ["Lead", "MQL", "SQL", "Opportunity", "Customer"],+ },+ {+ label: "Lead source",+ type: "SELECT",+ options: ["Inbound", "Outbound", "Event"],+ },+ { label: "ICP fit score", type: "NUMBER" },+ { label: "BDR owner", type: "USER" },+ ],+ CONTACT: [],+ DEAL: [],+} satisfies Record<"COMPANY" | "CONTACT" | "DEAL", readonly FieldTemplate[]>;diff --git a/packages/validation/src/saved-view.ts b/packages/validation/src/saved-view.tsnew file mode 100644index 00000000..f92a708e--- /dev/null+++ b/packages/validation/src/saved-view.ts@@ -0,0 +1,16 @@+import { z } from "zod";+import { parse } from "./index";++export const savedViewFilters = z.object({+ q: z.string().default(""),+ sort: z.string().default(""),+ dir: z.enum(["asc", "desc"]).default("asc"),+ archived: z.boolean().default(false),+ filters: z.record(z.string(), z.array(z.string())).default({}),+});++export type SavedViewFilters = z.infer<typeof savedViewFilters>;++export function parseSavedViewFilters(value: unknown): SavedViewFilters {+ return parse(savedViewFilters, value, "saved view filters");+}diff --git a/turbo.json b/turbo.jsonindex bdfff23f..110f9bd9 100644--- a/turbo.json+++ b/turbo.json@@ -1,37 +1,7 @@{"$schema": "https://turborepo.dev/schema.json","ui": "tui",-"globalEnv": ["NODE_ENV"],-- /**- * Turborepo hides environment variables from tasks unless they are declared,- * and the failure is silent: the build succeeds having read `undefined`.- *- * That is not hypothetical here. `API_URL` was stripped from the Next.js- * build, so the browser bundle was compiled with the localhost fallback and- * every request from a deployed page went to the reader's own machine; and- * `DATABASE_URL` was stripped from the agent build, where `eve build`- * evaluates the authored modules and `@crm/db` throws without it. The- * `MICROSOFT_*` trio was the same omission again: undeclared, so- * `microsoftCredentials()` read nothing, `isMicrosoftConfigured()` was- * false, and the sign-in page dropped the Microsoft button with no error- * anywhere. A configured `MICROSOFT_TENANT_ID` was ignored the same way.- *- * `globalPassThroughEnv` is the right list for all of them, because none- * change what a build *produces* — they are read at runtime, or inlined from- * the separately-declared public copy — so they must not become part of the- * cache key. A secret in the cache key means a cache miss every rotation and- * a secret in the cache metadata.- *- * `TEST_DATABASE_URL` is here for the same reason and learned the same way.- * `NODE_ENV` is in `globalEnv`, so `bun test` sets it to `test` in every- * package, and `@crm/db` then demands the test database and refuses to fall- * back. Undeclared, it was stripped from every test task — so the suite went- * red on a machine that had the variable set, complaining it was not set.- * Locally it passed throughout, because `@crm/env/load` reads the root `.env`- * from disk and CI has no such file.- */"globalPassThroughEnv": ["DATABASE_URL","DATABASE_URL_UNPOOLED",@@ -72,12 +42,6 @@},"build": {"dependsOn": ["^build"],- /**- * These two *are* cache keys, because they are inlined into the- * browser bundle at build time — the same source compiled against a- * different `API_URL` is a different artefact, and reusing a cached- * one would ship the wrong origin.- */"env": ["API_URL", "APP_URL", "NEXT_PUBLIC_API_URL"],"inputs": ["$TURBO_DEFAULT$", ".env*"],"outputs": [