@elevasis/core 0.12.0 → 0.14.0

package/src/execution/engine/tools/lead-service-types.ts

@@ -14,11 +14,14 @@ import type {
   AcqContact,
   AcqDealTask,
   AcqDealTaskKind,
-  CompanyListStage,
-  ContactListStage,
-  ListConfig,
-  ListTelemetry
+  ListStatus,
+  ScrapingConfig,
+  IcpRubric,
+  PipelineConfig,
+  ListTelemetry,
+  DealDetail
 } from '../../../business/acquisition/types'
+import type { ListProgress } from '../../../business/acquisition/api-schemas'
 
 export type {
   AcqList,
@@ -26,10 +29,13 @@ export type {
   AcqContact,
   AcqDealTask,
   AcqDealTaskKind,
-  CompanyListStage,
-  ContactListStage,
-  ListConfig,
-  ListTelemetry
+  ListStatus,
+  ScrapingConfig,
+  IcpRubric,
+  PipelineConfig,
+  ListTelemetry,
+  DealDetail,
+  ListProgress
 }
 
 // Pagination types
@@ -53,17 +59,24 @@ export interface CreateListParams {
   type?: string
   batchIds?: string[]
   instantlyCampaignId?: string
-  status?: string
+  status?: ListStatus
   metadata?: Record<string, unknown>
-  config?: ListConfig
+  scrapingConfig?: ScrapingConfig
+  icp?: IcpRubric
+  pipelineConfig?: PipelineConfig
 }
 
-export interface UpdateListParams {
-  name?: string
-  description?: string
-  status?: string
-  batchIds?: string[]
-}
+export interface UpdateListParams {
+  name?: string
+  description?: string
+  batchIds?: string[]
+}
+
+export interface UpdateListStatusParams {
+  organizationId: string
+  listId: string
+  status: ListStatus
+}
 
 // Company params
 export interface CreateCompanyParams {
@@ -99,6 +112,12 @@ export interface UpdateCompanyParams {
   batchId?: string
   status?: 'active' | 'invalid'
   verticalResearch?: string | null
+  /** Track A: flat qualification score column (null until a scoring rubric is defined) */
+  qualificationScore?: number | null
+  /** Track A: flat qualification signals jsonb — mirrors the former pipeline_status.qualification shape */
+  qualificationSignals?: Record<string, unknown> | null
+  /** Track A: key identifying the rubric used for qualification */
+  qualificationRubricKey?: string | null
 }
 
 export type UpsertCompanyParams = CreateCompanyParams
@@ -190,7 +209,6 @@ export interface UpdateProposalDataParams {
   contactEmail: string
   proposalData: unknown
   proposalPdfUrl?: string
-  proposalStatus?: string
 }
 
 export interface MarkProposalSentParams {
@@ -219,10 +237,14 @@ export interface UpdateFeesParams {
   monthlyFee?: number
 }
 
-export interface SyncDealStageParams {
+export interface TransitionItemParams {
   organizationId: string
   dealId: string
-  stage: string
+  pipelineKey: string
+  stageKey: string
+  stateKey?: string | null
+  reason?: string
+  expectedUpdatedAt?: string
 }
 
 export interface SetContactNurtureParams {
@@ -256,7 +278,6 @@ export interface ClearDealFieldsParams {
   dealId?: string
   fields: (
     | 'proposalPdfUrl'
-    | 'proposalStatus'
     | 'proposalGeneratedAt'
     | 'initialFee'
     | 'monthlyFee'
@@ -323,10 +344,11 @@ export interface AcqDeal {
   id: string
   organizationId: string
   contactEmail: string
-  cachedStage?: string | null
+  pipelineKey: string
+  stageKey?: string | null
+  stateKey?: string | null
   discoveryData?: Json | null
   proposalData?: Json | null
-  proposalStatus?: string | null
   proposalSentAt?: string | null
   proposalPdfUrl?: string | null
   signatureEnvelopeId?: string | null
@@ -405,6 +427,24 @@ export interface RecordDealActivityParams {
   payload?: Record<string, unknown>
 }
 
+export interface SetDealStateKeyParams {
+  organizationId: string
+  dealId: string
+  stateKey: string
+}
+
+export interface TransitionDealParams {
+  organizationId: string
+  dealId: string
+  toStage: string
+  toState?: string
+}
+
+export interface LoadDealParams {
+  organizationId: string
+  dealId: string
+}
+
 // Deal analytics types (for /meta status and platform-status workflow)
 
 export interface DealStageSummary {
@@ -417,7 +457,7 @@ export interface DealStageSummary {
 export interface StaleDeal {
   id: string
   contactEmail: string
-  cachedStage: string
+  stageKey: string
   updatedAt: string
   daysStale: number
 }
@@ -456,15 +496,16 @@ export interface AddContactsToListResult {
 export interface UpdateListConfigParams {
   organizationId: string
   listId: string
-  /** Deep-partial patch — any subtree that is present is replaced at that level. */
-  configPatch: Record<string, unknown>
+  scrapingConfig?: ScrapingConfig
+  icp?: IcpRubric
+  pipelineConfig?: PipelineConfig
 }
 
 export interface UpdateCompanyStageParams {
   organizationId: string
   listId: string
   companyId: string
-  stage: CompanyListStage
+  stage: string
   executionId?: string
 }
 
@@ -472,7 +513,7 @@ export interface UpdateContactStageParams {
   organizationId: string
   listId: string
   contactId: string
-  stage: ContactListStage
+  stage: string
   executionId?: string
 }
 
@@ -622,9 +663,10 @@ export interface ILeadService {
   getListsTelemetry(organizationId: string): Promise<ListTelemetry[]>
 
   /**
-   * Single live rollup read from list junction stage columns.
+   * On-demand progress aggregation: COUNT(*) FILTER over processing_state flags,
+   * keyed by the list's pipeline_config.stages[].key (Decision #4 + #7).
    */
-  getListProgress(listId: string, organizationId: string): Promise<ListTelemetry | null>
+  getListProgress(listId: string, organizationId: string): Promise<ListProgress | null>
 
   /**
    * Advance a company row within a list's explicit stage journey.
@@ -801,7 +843,7 @@ export interface ILeadService {
 
   updateFees(params: UpdateFeesParams): Promise<void>
 
-  syncDealStage(params: SyncDealStageParams): Promise<void>
+  transitionItem(params: TransitionItemParams): Promise<void>
 
   setContactNurture(params: SetContactNurtureParams): Promise<void>
 
@@ -876,6 +918,24 @@ export interface ILeadService {
    */
   recordDealActivity(params: RecordDealActivityParams): Promise<void>
 
+  /**
+   * Update the state_key on an acq_deals row.
+   * @see LeadService.setDealStateKey (apps/api/src/business/acquisition/lead-service.ts)
+   */
+  setDealStateKey(params: SetDealStateKeyParams): Promise<{ ok: true }>
+
+  /**
+   * Transition a deal to a new stage, resolving pipeline_key automatically.
+   * @see LeadService.transitionDeal (apps/api/src/business/acquisition/lead-service.ts)
+   */
+  transitionDeal(params: TransitionDealParams): Promise<{ deal: AcqDeal }>
+
+  /**
+   * Load a deal with its joined contact and company data.
+   * @see LeadService.loadDeal (apps/api/src/business/acquisition/lead-service.ts)
+   */
+  loadDeal(params: LoadDealParams): Promise<DealDetail | null>
+
   // Social monitoring operations (acq_social_posts table)
   /**
    * Bulk upsert social posts (deduplicate by platform + platform_post_id)