@elevasis/core 0.1.0

package/src/business/acquisition/api-schemas.ts

@@ -0,0 +1,759 @@
+import { z } from 'zod'
+import { UuidSchema } from '../../platform/utils/validation'
+
+/**
+ * Deal Management API Schemas
+ *
+ * Request/response validation for /api/deals surface.
+ * Used by both the API route handlers and the frontend hooks.
+ *
+ * Table mapping:
+ *   acq_deals       -> DealSchemas (list/detail)
+ *   acq_deal_notes  -> DealSchemas (note shapes)
+ *   acq_deal_tasks  -> DealSchemas (task shapes)
+ */
+
+// ---------------------------------------------------------------------------
+// Enum literals (must match DB CHECK constraints exactly)
+// ---------------------------------------------------------------------------
+
+export const DealStageSchema = z.enum(['interested', 'proposal', 'closing', 'closed_won', 'closed_lost', 'nurturing'])
+
+export const AcqDealTaskKindSchema = z.enum(['call', 'email', 'meeting', 'other'])
+
+// ---------------------------------------------------------------------------
+// Params
+// ---------------------------------------------------------------------------
+
+export const DealIdParamsSchema = z.object({
+  dealId: UuidSchema
+})
+
+export const DealTaskIdParamsSchema = z.object({
+  dealId: UuidSchema,
+  taskId: UuidSchema
+})
+
+// ---------------------------------------------------------------------------
+// Query schemas (coerce strings from query params)
+// ---------------------------------------------------------------------------
+
+export const ListDealsQuerySchema = z
+  .object({
+    stage: DealStageSchema.optional(),
+    search: z.string().optional(),
+    limit: z.coerce.number().int().positive().default(50),
+    offset: z.coerce.number().int().min(0).default(0)
+  })
+  .strict()
+
+export const ListDealTasksDueQuerySchema = z
+  .object({
+    window: z.enum(['overdue', 'today', 'today_and_overdue', 'upcoming']).optional(),
+    assigneeUserId: UuidSchema.optional()
+  })
+  .strict()
+
+// ---------------------------------------------------------------------------
+// Request body schemas (all use .strict() — rejects unknown fields)
+// ---------------------------------------------------------------------------
+
+export const CreateDealNoteRequestSchema = z
+  .object({
+    body: z.string().trim().min(1).max(10000)
+  })
+  .strict()
+
+export const CreateDealTaskRequestSchema = z
+  .object({
+    title: z.string().trim().min(1).max(255),
+    description: z.string().nullable().optional(),
+    kind: AcqDealTaskKindSchema.optional(),
+    dueAt: z.string().datetime().nullable().optional(),
+    assigneeUserId: UuidSchema.nullable().optional()
+  })
+  .strict()
+
+export const SyncDealStageRequestSchema = z
+  .object({
+    stage: DealStageSchema
+  })
+  .strict()
+
+// ---------------------------------------------------------------------------
+// Response schemas (no .strict() — allows forward-compatible additions)
+// ---------------------------------------------------------------------------
+
+/**
+ * Contact summary nested inside DealListItem / DealDetailResponse.
+ * Matches the joined shape returned by useDeals / useDealDetail Supabase queries.
+ */
+export const DealContactSummarySchema = z.object({
+  id: z.string(),
+  first_name: z.string().nullable(),
+  last_name: z.string().nullable(),
+  email: z.string(),
+  title: z.string().nullable(),
+  headline: z.string().nullable(),
+  linkedin_url: z.string().nullable(),
+  pipeline_status: z.record(z.string(), z.unknown()).nullable(),
+  enrichment_data: z.record(z.string(), z.unknown()).nullable(),
+  company: z
+    .object({
+      id: z.string(),
+      name: z.string(),
+      domain: z.string().nullable(),
+      website: z.string().nullable(),
+      linkedin_url: z.string().nullable(),
+      segment: z.string().nullable(),
+      category: z.string().nullable(),
+      num_employees: z.number().nullable()
+    })
+    .nullable()
+})
+
+/**
+ * Deal list item with joined contact (and company via contact).
+ * Matches DealListItem from @repo/core types.
+ */
+export const DealListItemSchema = z.object({
+  // acq_deals columns
+  id: z.string(),
+  organization_id: z.string(),
+  contact_id: z.string().nullable(),
+  contact_email: z.string(),
+  cached_stage: z.string().nullable(),
+  activity_log: z.unknown(),
+  discovery_data: z.unknown().nullable(),
+  discovery_submitted_at: z.string().nullable(),
+  discovery_submitted_by: z.string().nullable(),
+  proposal_data: z.unknown().nullable(),
+  proposal_status: z.string().nullable(),
+  proposal_sent_at: z.string().nullable(),
+  proposal_pdf_url: z.string().nullable(),
+  signature_envelope_id: z.string().nullable(),
+  source_list_id: z.string().nullable(),
+  source_type: z.string().nullable(),
+  initial_fee: z.number().nullable(),
+  monthly_fee: z.number().nullable(),
+  closed_lost_at: z.string().nullable(),
+  closed_lost_reason: z.string().nullable(),
+  created_at: z.string(),
+  updated_at: z.string(),
+  // joined relation
+  contact: DealContactSummarySchema.nullable()
+})
+
+export const DealListResponseSchema = z.array(DealListItemSchema)
+
+/**
+ * Deal detail shape — currently the same as a list item (full joined record).
+ * useDealDetail returns DealDetail which is typed as DealListItem.
+ */
+export const DealDetailResponseSchema = DealListItemSchema
+
+/**
+ * Single acq_deal_notes row (camelCase API representation).
+ */
+export const DealNoteResponseSchema = z.object({
+  id: z.string(),
+  dealId: z.string(),
+  organizationId: z.string(),
+  authorUserId: z.string().nullable(),
+  body: z.string(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+})
+
+export const DealNoteListResponseSchema = z.array(DealNoteResponseSchema)
+
+/**
+ * Single acq_deal_tasks row (camelCase API representation).
+ * Matches AcqDealTask domain type from types.ts.
+ */
+export const DealTaskResponseSchema = z.object({
+  id: z.string(),
+  organizationId: z.string(),
+  dealId: z.string(),
+  title: z.string(),
+  description: z.string().nullable(),
+  kind: AcqDealTaskKindSchema,
+  dueAt: z.string().nullable(),
+  assigneeUserId: z.string().nullable(),
+  completedAt: z.string().nullable(),
+  completedByUserId: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string(),
+  createdByUserId: z.string().nullable()
+})
+
+export const DealTaskListResponseSchema = z.array(DealTaskResponseSchema)
+
+// ---------------------------------------------------------------------------
+// Bundled export
+// ---------------------------------------------------------------------------
+
+export const DealSchemas = {
+  // Params
+  DealIdParams: DealIdParamsSchema,
+  DealTaskIdParams: DealTaskIdParamsSchema,
+
+  // Queries
+  ListDealsQuery: ListDealsQuerySchema,
+  ListDealTasksDueQuery: ListDealTasksDueQuerySchema,
+
+  // Request bodies
+  CreateDealNoteRequest: CreateDealNoteRequestSchema,
+  CreateDealTaskRequest: CreateDealTaskRequestSchema,
+  SyncDealStageRequest: SyncDealStageRequestSchema,
+
+  // Responses
+  DealListResponse: DealListResponseSchema,
+  DealDetailResponse: DealDetailResponseSchema,
+  DealNoteResponse: DealNoteResponseSchema,
+  DealNoteListResponse: DealNoteListResponseSchema,
+  DealTaskResponse: DealTaskResponseSchema,
+  DealTaskListResponse: DealTaskListResponseSchema
+}
+
+// ---------------------------------------------------------------------------
+// Inferred types
+// ---------------------------------------------------------------------------
+
+export type DealStage = z.infer<typeof DealStageSchema>
+export type AcqDealTaskKind = z.infer<typeof AcqDealTaskKindSchema>
+export type DealIdParams = z.infer<typeof DealIdParamsSchema>
+export type DealTaskIdParams = z.infer<typeof DealTaskIdParamsSchema>
+export type ListDealsQuery = z.infer<typeof ListDealsQuerySchema>
+export type ListDealTasksDueQuery = z.infer<typeof ListDealTasksDueQuerySchema>
+export type CreateDealNoteRequest = z.infer<typeof CreateDealNoteRequestSchema>
+export type CreateDealTaskRequest = z.infer<typeof CreateDealTaskRequestSchema>
+export type SyncDealStageRequest = z.infer<typeof SyncDealStageRequestSchema>
+export type DealListResponse = z.infer<typeof DealListResponseSchema>
+export type DealDetailResponse = z.infer<typeof DealDetailResponseSchema>
+export type DealNoteResponse = z.infer<typeof DealNoteResponseSchema>
+export type DealNoteListResponse = z.infer<typeof DealNoteListResponseSchema>
+export type DealTaskResponse = z.infer<typeof DealTaskResponseSchema>
+export type DealTaskListResponse = z.infer<typeof DealTaskListResponseSchema>
+
+// ---------------------------------------------------------------------------
+// List Management API Schemas
+//
+// Request/response validation for /api/acquisition/lists surface.
+// Used by both the API route handlers and the frontend hooks.
+//
+// Table mapping:
+//   acq_lists            -> AcqListSchemas (list/detail/progress)
+//   acq_list_companies   -> AcqListSchemas (add/remove company membership)
+//   acq_list_contacts    -> AcqListSchemas (add/remove contact membership)
+//   acq_list_executions  -> AcqListSchemas (execution history)
+// ---------------------------------------------------------------------------
+
+// ---------------------------------------------------------------------------
+// Primitives — list config subtrees
+// ---------------------------------------------------------------------------
+
+export const ListQualificationSchema = z.object({
+  targetDescription: z.string(),
+  minReviewCount: z.number().int().min(0),
+  minRating: z.number().min(0).max(5),
+  excludeFranchises: z.boolean(),
+  customRules: z.string()
+})
+
+export const ListEnrichmentSchema = z.object({
+  emailDiscovery: z
+    .object({
+      primary: z.enum(['tomba', 'anymailfinder']),
+      credentialName: z.string().optional()
+    })
+    .optional(),
+  emailVerification: z
+    .object({
+      provider: z.literal('millionverifier'),
+      threshold: z.enum(['ok', 'ok+catch_all']).optional()
+    })
+    .optional()
+})
+
+export const ListPersonalizationSchema = z.object({
+  industryContext: z.string().optional(),
+  emailBody: z.string().optional(),
+  creativeDirection: z.string().optional(),
+  exclusionRules: z.array(z.string()).optional()
+})
+
+export const PipelineStepSchema = z.object({
+  key: z.string(),
+  label: z.string(),
+  resourceId: z.string(),
+  inputTemplate: z.record(z.string(), z.unknown()),
+  enabled: z.boolean(),
+  order: z.number().int()
+})
+
+export const ListPipelineSchema = z.object({
+  steps: z.array(PipelineStepSchema)
+})
+
+/**
+ * Full ListConfig shape. `qualification` is required; everything else optional.
+ * Matches `acq_lists.config` jsonb and ListConfig type in types.ts.
+ */
+export const ListConfigSchema = z.object({
+  qualification: ListQualificationSchema,
+  enrichment: ListEnrichmentSchema.optional(),
+  personalization: ListPersonalizationSchema.optional(),
+  pipeline: ListPipelineSchema.optional()
+})
+
+// ---------------------------------------------------------------------------
+// List telemetry / progress schemas
+// ---------------------------------------------------------------------------
+
+export const ListStageCountsSchema = z.object({
+  stageCounts: z.object({
+    populated: z.number().int(),
+    extracted: z.number().int(),
+    qualified: z.number().int(),
+    discovered: z.number().int(),
+    verified: z.number().int(),
+    personalized: z.number().int(),
+    uploaded: z.number().int()
+  }),
+  deliverability: z.object({
+    valid: z.number().int(),
+    risky: z.number().int(),
+    invalid: z.number().int(),
+    unknown: z.number().int(),
+    bounced: z.number().int()
+  })
+})
+
+export const ListTelemetrySchema = z.object({
+  listId: UuidSchema,
+  totalCompanies: z.number().int(),
+  totalContacts: z.number().int(),
+  stageCounts: ListStageCountsSchema.shape.stageCounts,
+  deliverability: ListStageCountsSchema.shape.deliverability,
+  activeWorkflows: z.array(z.string()).optional()
+})
+
+// ---------------------------------------------------------------------------
+// Params
+// ---------------------------------------------------------------------------
+
+export const ListIdParamsSchema = z.object({
+  listId: UuidSchema
+})
+
+// ---------------------------------------------------------------------------
+// Request body schemas (all use .strict() — rejects unknown fields)
+// ---------------------------------------------------------------------------
+
+export const CreateListRequestSchema = z
+  .object({
+    name: z.string().trim().min(1).max(255),
+    description: z.string().trim().nullable().optional(),
+    type: z.string().default('manual'),
+    config: ListConfigSchema.optional()
+  })
+  .strict()
+
+export const UpdateListRequestSchema = z
+  .object({
+    name: z.string().trim().min(1).max(255).optional(),
+    description: z.string().trim().nullable().optional(),
+    status: z.string().optional()
+  })
+  .strict()
+  .refine((data) => data.name !== undefined || data.description !== undefined || data.status !== undefined, {
+    message: 'At least one field (name, description, or status) must be provided'
+  })
+
+/**
+ * Partial patch for list.config — UI sends only the edited tab's subtree.
+ * Zod v4: use .partial() on each subtree and remake the root schema.
+ * Since the root ListConfigSchema marks `qualification` as required, we must
+ * produce a manually-built deep-partial that makes qualification optional too.
+ */
+export const UpdateListConfigRequestSchema = z
+  .object({
+    qualification: ListQualificationSchema.partial().optional(),
+    enrichment: ListEnrichmentSchema.partial().optional(),
+    personalization: ListPersonalizationSchema.partial().optional(),
+    pipeline: ListPipelineSchema.partial().optional()
+  })
+  .strict()
+
+export const AddCompaniesToListRequestSchema = z
+  .object({
+    companyIds: z.array(UuidSchema).min(1).max(1000)
+  })
+  .strict()
+
+export const RemoveCompaniesFromListRequestSchema = z
+  .object({
+    companyIds: z.array(UuidSchema).min(1).max(1000)
+  })
+  .strict()
+
+export const AddContactsToListRequestSchema = z
+  .object({
+    contactIds: z.array(UuidSchema).min(1).max(1000)
+  })
+  .strict()
+
+export const RecordListExecutionRequestSchema = z
+  .object({
+    executionId: UuidSchema,
+    configSnapshot: z.record(z.string(), z.unknown()).optional()
+  })
+  .strict()
+
+// ---------------------------------------------------------------------------
+// Response schemas (no .strict() — allows forward-compatible additions)
+// ---------------------------------------------------------------------------
+
+/**
+ * Single list as returned by /api/acquisition/lists/:id etc.
+ * Camel-cased domain shape matching AcqList in types.ts.
+ */
+export const AcqListResponseSchema = z.object({
+  id: z.string(),
+  organizationId: z.string(),
+  name: z.string(),
+  description: z.string().nullable(),
+  type: z.string(),
+  batchIds: z.array(z.string()),
+  instantlyCampaignId: z.string().nullable(),
+  status: z.string(),
+  metadata: z.record(z.string(), z.unknown()),
+  launchedAt: z.string().nullable(),
+  completedAt: z.string().nullable(),
+  createdAt: z.string(),
+  config: ListConfigSchema
+})
+
+export const AcqListListResponseSchema = z.array(AcqListResponseSchema)
+
+export const ListTelemetryResponseSchema = ListTelemetrySchema
+
+export const ListTelemetryListResponseSchema = z.array(ListTelemetrySchema)
+
+/**
+ * Row from acq_list_executions joined with the execution summary,
+ * shaped for the /lists/:id/executions response.
+ */
+export const ListExecutionSummarySchema = z.object({
+  executionId: z.string(),
+  resourceId: z.string(),
+  status: z.string(),
+  createdAt: z.string(),
+  completedAt: z.string().nullable(),
+  durationMs: z.number().int().nullable()
+})
+
+export const ListExecutionsResponseSchema = z.array(ListExecutionSummarySchema)
+
+// ---------------------------------------------------------------------------
+// Company / Contact API Schemas
+// ---------------------------------------------------------------------------
+
+const QueryBooleanSchema = z.preprocess((value) => {
+  if (value === 'true' || value === '1' || value === true) return true
+  if (value === 'false' || value === '0' || value === false) return false
+  return value
+}, z.boolean())
+
+export const AcqCompanyStatusSchema = z.enum(['active', 'invalid'])
+export const AcqContactStatusSchema = z.enum(['active', 'invalid'])
+export const AcqEmailValidSchema = z.enum(['VALID', 'INVALID', 'RISKY', 'UNKNOWN'])
+
+export const CompanyIdParamsSchema = z.object({
+  companyId: UuidSchema
+})
+
+export const ContactIdParamsSchema = z.object({
+  contactId: UuidSchema
+})
+
+export const ListCompaniesQuerySchema = z
+  .object({
+    search: z.string().trim().min(1).max(200).optional(),
+    listId: UuidSchema.optional(),
+    domain: z.string().trim().min(1).max(255).optional(),
+    website: z.string().trim().min(1).max(2048).optional(),
+    segment: z.string().trim().min(1).max(255).optional(),
+    category: z.string().trim().min(1).max(255).optional(),
+    batchId: z.string().trim().min(1).max(255).optional(),
+    status: AcqCompanyStatusSchema.optional(),
+    includeAll: QueryBooleanSchema.optional()
+  })
+  .strict()
+
+export const ListContactsQuerySchema = z
+  .object({
+    search: z.string().trim().min(1).max(200).optional(),
+    listId: UuidSchema.optional(),
+    openingLineIsNull: QueryBooleanSchema.optional(),
+    batchId: z.string().trim().min(1).max(255).optional(),
+    contactStatus: AcqContactStatusSchema.optional(),
+    limit: z.coerce.number().int().min(1).max(5000).default(5000),
+    offset: z.coerce.number().int().min(0).default(0)
+  })
+  .strict()
+
+export const CreateCompanyRequestSchema = z
+  .object({
+    name: z.string().trim().min(1).max(255),
+    domain: z.string().trim().min(1).max(255).optional(),
+    linkedinUrl: z.string().trim().url().optional(),
+    website: z.string().trim().url().optional(),
+    numEmployees: z.number().int().min(0).optional(),
+    foundedYear: z.number().int().optional(),
+    locationCity: z.string().trim().min(1).max(255).optional(),
+    locationState: z.string().trim().min(1).max(255).optional(),
+    category: z.string().trim().min(1).max(255).optional(),
+    source: z.string().trim().min(1).max(255).optional(),
+    batchId: z.string().trim().min(1).max(255).optional(),
+    verticalResearch: z.string().trim().min(1).max(5000).optional()
+  })
+  .strict()
+
+export const UpdateCompanyRequestSchema = z
+  .object({
+    name: z.string().trim().min(1).max(255).optional(),
+    domain: z.string().trim().min(1).max(255).optional(),
+    linkedinUrl: z.string().trim().url().optional(),
+    website: z.string().trim().url().optional(),
+    numEmployees: z.number().int().min(0).optional(),
+    foundedYear: z.number().int().optional(),
+    locationCity: z.string().trim().min(1).max(255).optional(),
+    locationState: z.string().trim().min(1).max(255).optional(),
+    category: z.string().trim().min(1).max(255).optional(),
+    segment: z.string().trim().min(1).max(255).optional(),
+    pipelineStatus: z.record(z.string(), z.unknown()).optional(),
+    enrichmentData: z.record(z.string(), z.unknown()).optional(),
+    source: z.string().trim().min(1).max(255).optional(),
+    batchId: z.string().trim().min(1).max(255).optional(),
+    status: AcqCompanyStatusSchema.optional(),
+    verticalResearch: z.string().trim().min(1).max(5000).nullable().optional()
+  })
+  .strict()
+  .refine(
+    (data) =>
+      data.name !== undefined ||
+      data.domain !== undefined ||
+      data.linkedinUrl !== undefined ||
+      data.website !== undefined ||
+      data.numEmployees !== undefined ||
+      data.foundedYear !== undefined ||
+      data.locationCity !== undefined ||
+      data.locationState !== undefined ||
+      data.category !== undefined ||
+      data.segment !== undefined ||
+      data.pipelineStatus !== undefined ||
+      data.enrichmentData !== undefined ||
+      data.source !== undefined ||
+      data.batchId !== undefined ||
+      data.status !== undefined ||
+      data.verticalResearch !== undefined,
+    {
+      message: 'At least one field must be provided'
+    }
+  )
+
+export const CreateContactRequestSchema = z
+  .object({
+    email: z.string().trim().email(),
+    companyId: UuidSchema.optional(),
+    firstName: z.string().trim().min(1).max(255).optional(),
+    lastName: z.string().trim().min(1).max(255).optional(),
+    linkedinUrl: z.string().trim().url().optional(),
+    title: z.string().trim().min(1).max(255).optional(),
+    source: z.string().trim().min(1).max(255).optional(),
+    sourceId: z.string().trim().min(1).max(255).optional(),
+    batchId: z.string().trim().min(1).max(255).optional()
+  })
+  .strict()
+
+export const UpdateContactRequestSchema = z
+  .object({
+    companyId: UuidSchema.optional(),
+    emailValid: AcqEmailValidSchema.optional(),
+    firstName: z.string().trim().min(1).max(255).optional(),
+    lastName: z.string().trim().min(1).max(255).optional(),
+    linkedinUrl: z.string().trim().url().optional(),
+    title: z.string().trim().min(1).max(255).optional(),
+    headline: z.string().trim().min(1).max(5000).optional(),
+    filterReason: z.string().trim().min(1).max(5000).optional(),
+    openingLine: z.string().trim().min(1).max(5000).optional(),
+    pipelineStatus: z.record(z.string(), z.unknown()).optional(),
+    enrichmentData: z.record(z.string(), z.unknown()).optional(),
+    status: AcqContactStatusSchema.optional()
+  })
+  .strict()
+  .refine(
+    (data) =>
+      data.companyId !== undefined ||
+      data.emailValid !== undefined ||
+      data.firstName !== undefined ||
+      data.lastName !== undefined ||
+      data.linkedinUrl !== undefined ||
+      data.title !== undefined ||
+      data.headline !== undefined ||
+      data.filterReason !== undefined ||
+      data.openingLine !== undefined ||
+      data.pipelineStatus !== undefined ||
+      data.enrichmentData !== undefined ||
+      data.status !== undefined,
+    {
+      message: 'At least one field must be provided'
+    }
+  )
+
+export const AcqCompanyResponseSchema = z.object({
+  id: z.string(),
+  organizationId: z.string(),
+  name: z.string(),
+  domain: z.string().nullable(),
+  linkedinUrl: z.string().nullable(),
+  website: z.string().nullable(),
+  numEmployees: z.number().nullable(),
+  foundedYear: z.number().nullable(),
+  locationCity: z.string().nullable(),
+  locationState: z.string().nullable(),
+  category: z.string().nullable(),
+  categoryPain: z.string().nullable(),
+  segment: z.string().nullable(),
+  pipelineStatus: z.record(z.string(), z.unknown()).nullable(),
+  enrichmentData: z.record(z.string(), z.unknown()).nullable(),
+  source: z.string().nullable(),
+  batchId: z.string().nullable(),
+  status: AcqCompanyStatusSchema,
+  verticalResearch: z.string().nullable(),
+  createdAt: z.string(),
+  updatedAt: z.string()
+})
+
+export const AcqCompanyListResponseSchema = z.array(AcqCompanyResponseSchema)
+
+export const AcqContactResponseSchema = z.object({
+  id: z.string(),
+  organizationId: z.string(),
+  companyId: z.string().nullable(),
+  email: z.string(),
+  emailValid: AcqEmailValidSchema.nullable(),
+  firstName: z.string().nullable(),
+  lastName: z.string().nullable(),
+  linkedinUrl: z.string().nullable(),
+  title: z.string().nullable(),
+  headline: z.string().nullable(),
+  filterReason: z.string().nullable(),
+  openingLine: z.string().nullable(),
+  source: z.string().nullable(),
+  sourceId: z.string().nullable(),
+  pipelineStatus: z.record(z.string(), z.unknown()).nullable(),
+  enrichmentData: z.record(z.string(), z.unknown()).nullable(),
+  attioPersonId: z.string().nullable(),
+  batchId: z.string().nullable(),
+  status: AcqContactStatusSchema,
+  createdAt: z.string(),
+  updatedAt: z.string()
+})
+
+export const AcqContactListResponseSchema = z.object({
+  data: z.array(AcqContactResponseSchema),
+  total: z.number().int(),
+  limit: z.number().int(),
+  offset: z.number().int()
+})
+
+export const AcqCompanySchemas = {
+  CompanyIdParams: CompanyIdParamsSchema,
+  ListCompaniesQuery: ListCompaniesQuerySchema,
+  CreateCompanyRequest: CreateCompanyRequestSchema,
+  UpdateCompanyRequest: UpdateCompanyRequestSchema,
+  AcqCompanyResponse: AcqCompanyResponseSchema,
+  AcqCompanyListResponse: AcqCompanyListResponseSchema
+}
+
+export const AcqContactSchemas = {
+  ContactIdParams: ContactIdParamsSchema,
+  ListContactsQuery: ListContactsQuerySchema,
+  CreateContactRequest: CreateContactRequestSchema,
+  UpdateContactRequest: UpdateContactRequestSchema,
+  AcqContactResponse: AcqContactResponseSchema,
+  AcqContactListResponse: AcqContactListResponseSchema
+}
+
+export type AcqCompanyStatus = z.infer<typeof AcqCompanyStatusSchema>
+export type AcqContactStatus = z.infer<typeof AcqContactStatusSchema>
+export type AcqEmailValid = z.infer<typeof AcqEmailValidSchema>
+export type CompanyIdParams = z.infer<typeof CompanyIdParamsSchema>
+export type ContactIdParams = z.infer<typeof ContactIdParamsSchema>
+export type ListCompaniesQuery = z.infer<typeof ListCompaniesQuerySchema>
+export type ListContactsQuery = z.infer<typeof ListContactsQuerySchema>
+export type CreateCompanyRequest = z.infer<typeof CreateCompanyRequestSchema>
+export type UpdateCompanyRequest = z.infer<typeof UpdateCompanyRequestSchema>
+export type CreateContactRequest = z.infer<typeof CreateContactRequestSchema>
+export type UpdateContactRequest = z.infer<typeof UpdateContactRequestSchema>
+export type AcqCompanyResponse = z.infer<typeof AcqCompanyResponseSchema>
+export type AcqCompanyListResponse = z.infer<typeof AcqCompanyListResponseSchema>
+export type AcqContactResponse = z.infer<typeof AcqContactResponseSchema>
+export type AcqContactListResponse = z.infer<typeof AcqContactListResponseSchema>
+
+// ---------------------------------------------------------------------------
+// Bundled export
+// ---------------------------------------------------------------------------
+
+export const AcqListSchemas = {
+  // Params
+  ListIdParams: ListIdParamsSchema,
+
+  // Primitives (for UI / tests)
+  ListConfig: ListConfigSchema,
+  ListStageCounts: ListStageCountsSchema,
+  ListTelemetry: ListTelemetrySchema,
+  PipelineStep: PipelineStepSchema,
+
+  // Requests
+  CreateListRequest: CreateListRequestSchema,
+  UpdateListRequest: UpdateListRequestSchema,
+  UpdateListConfigRequest: UpdateListConfigRequestSchema,
+  AddCompaniesToListRequest: AddCompaniesToListRequestSchema,
+  RemoveCompaniesFromListRequest: RemoveCompaniesFromListRequestSchema,
+  AddContactsToListRequest: AddContactsToListRequestSchema,
+  RecordListExecutionRequest: RecordListExecutionRequestSchema,
+
+  // Responses
+  AcqListResponse: AcqListResponseSchema,
+  AcqListListResponse: AcqListListResponseSchema,
+  ListTelemetryResponse: ListTelemetryResponseSchema,
+  ListTelemetryListResponse: ListTelemetryListResponseSchema,
+  ListExecutionsResponse: ListExecutionsResponseSchema
+}
+
+// ---------------------------------------------------------------------------
+// Inferred types
+// ---------------------------------------------------------------------------
+
+export type ListConfigInput = z.infer<typeof ListConfigSchema>
+export type ListStageCountsInput = z.infer<typeof ListStageCountsSchema>['stageCounts']
+export type ListTelemetryInput = z.infer<typeof ListTelemetrySchema>
+export type PipelineStepInput = z.infer<typeof PipelineStepSchema>
+export type ListIdParams = z.infer<typeof ListIdParamsSchema>
+export type CreateListRequest = z.infer<typeof CreateListRequestSchema>
+export type UpdateListRequest = z.infer<typeof UpdateListRequestSchema>
+export type UpdateListConfigRequest = z.infer<typeof UpdateListConfigRequestSchema>
+export type AddCompaniesToListRequest = z.infer<typeof AddCompaniesToListRequestSchema>
+export type RemoveCompaniesFromListRequest = z.infer<typeof RemoveCompaniesFromListRequestSchema>
+export type AddContactsToListRequest = z.infer<typeof AddContactsToListRequestSchema>
+export type RecordListExecutionRequest = z.infer<typeof RecordListExecutionRequestSchema>
+export type AcqListResponse = z.infer<typeof AcqListResponseSchema>
+export type AcqListListResponse = z.infer<typeof AcqListListResponseSchema>
+export type ListTelemetryResponse = z.infer<typeof ListTelemetryResponseSchema>
+export type ListTelemetryListResponse = z.infer<typeof ListTelemetryListResponseSchema>
+export type ListExecutionSummaryInput = z.infer<typeof ListExecutionSummarySchema>
+export type ListExecutionsResponse = z.infer<typeof ListExecutionsResponseSchema>