@elevasis/core 0.18.0 → 0.19.0

package/src/business/acquisition/build-templates.test.ts

@@ -0,0 +1,212 @@
+import { describe, expect, it } from 'vitest'
+import {
+  DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID,
+  PROSPECTING_BUILD_TEMPLATE_OPTIONS,
+  createBuildPlanSnapshotFromTemplateId,
+  isProspectingBuildTemplateId
+} from './build-templates'
+
+// ---------------------------------------------------------------------------
+// isProspectingBuildTemplateId
+// ---------------------------------------------------------------------------
+
+describe('isProspectingBuildTemplateId', () => {
+  it('returns true for every id in PROSPECTING_BUILD_TEMPLATE_OPTIONS', () => {
+    for (const option of PROSPECTING_BUILD_TEMPLATE_OPTIONS) {
+      expect(isProspectingBuildTemplateId(option.id)).toBe(true)
+    }
+  })
+
+  it('returns true for the known "local-services" template id', () => {
+    expect(isProspectingBuildTemplateId('local-services')).toBe(true)
+  })
+
+  it('returns true for the known "dtc-subscription-apollo-clickup" template id', () => {
+    expect(isProspectingBuildTemplateId('dtc-subscription-apollo-clickup')).toBe(true)
+  })
+
+  it('returns false for an unknown string', () => {
+    expect(isProspectingBuildTemplateId('not-a-template')).toBe(false)
+  })
+
+  it('returns false for an empty string', () => {
+    expect(isProspectingBuildTemplateId('')).toBe(false)
+  })
+
+  it('returns false for a partial id match', () => {
+    expect(isProspectingBuildTemplateId('local')).toBe(false)
+    expect(isProspectingBuildTemplateId('dtc-subscription')).toBe(false)
+  })
+
+  it('returns false for a whitespace-padded id', () => {
+    expect(isProspectingBuildTemplateId(' local-services ')).toBe(false)
+  })
+
+  it('verifies PROSPECTING_BUILD_TEMPLATE_OPTIONS contains at least two entries', () => {
+    expect(PROSPECTING_BUILD_TEMPLATE_OPTIONS.length).toBeGreaterThanOrEqual(2)
+  })
+
+  it('verifies DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID is itself a valid template id', () => {
+    expect(isProspectingBuildTemplateId(DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID)).toBe(true)
+  })
+})
+
+// ---------------------------------------------------------------------------
+// createBuildPlanSnapshotFromTemplateId — unknown id
+// ---------------------------------------------------------------------------
+
+describe('createBuildPlanSnapshotFromTemplateId — unknown id', () => {
+  it('returns null for an unknown template id', () => {
+    expect(createBuildPlanSnapshotFromTemplateId('not-a-template')).toBeNull()
+  })
+
+  it('returns null for an empty string', () => {
+    expect(createBuildPlanSnapshotFromTemplateId('')).toBeNull()
+  })
+})
+
+// ---------------------------------------------------------------------------
+// createBuildPlanSnapshotFromTemplateId — "local-services"
+// ---------------------------------------------------------------------------
+
+describe('createBuildPlanSnapshotFromTemplateId — "local-services"', () => {
+  const snapshot = createBuildPlanSnapshotFromTemplateId('local-services')
+
+  it('returns a non-null snapshot', () => {
+    expect(snapshot).not.toBeNull()
+  })
+
+  it('preserves the template id in the snapshot', () => {
+    expect(snapshot?.templateId).toBe('local-services')
+  })
+
+  it('includes a non-empty templateLabel', () => {
+    expect(snapshot?.templateLabel).toBeTruthy()
+  })
+
+  it('produces a steps array with length matching the catalog (7 steps)', () => {
+    expect(snapshot?.steps).toHaveLength(7)
+  })
+
+  it('every step has required fields: id, label, primaryEntity, outputs, stageKey, dependencyMode, capabilityKey', () => {
+    for (const step of snapshot?.steps ?? []) {
+      expect(step.id).toBeTruthy()
+      expect(step.label).toBeTruthy()
+      expect(['company', 'contact']).toContain(step.primaryEntity)
+      expect(step.outputs.length).toBeGreaterThanOrEqual(1)
+      expect(step.stageKey).toBeTruthy()
+      expect(step.dependencyMode).toBe('per-record-eligibility')
+      expect(step.capabilityKey).toBeTruthy()
+    }
+  })
+
+  it('every step has positive defaultBatchSize and maxBatchSize', () => {
+    for (const step of snapshot?.steps ?? []) {
+      expect(step.defaultBatchSize).toBeGreaterThan(0)
+      expect(step.maxBatchSize).toBeGreaterThanOrEqual(step.defaultBatchSize)
+    }
+  })
+
+  it('steps with declared dependsOn in the catalog have dependsOn in the snapshot', () => {
+    const withDeps = snapshot?.steps.filter((step) => step.dependsOn !== undefined) ?? []
+    expect(withDeps.length).toBeGreaterThan(0)
+    for (const step of withDeps) {
+      expect(Array.isArray(step.dependsOn)).toBe(true)
+      expect((step.dependsOn ?? []).length).toBeGreaterThan(0)
+    }
+  })
+
+  it('the first step (source-companies) has no dependsOn', () => {
+    const first = snapshot?.steps[0]
+    expect(first?.id).toBe('source-companies')
+    expect(first?.dependsOn).toBeUndefined()
+  })
+
+  it('outputs arrays are copies (mutation does not affect subsequent calls)', () => {
+    const snapshotA = createBuildPlanSnapshotFromTemplateId('local-services')
+    const snapshotB = createBuildPlanSnapshotFromTemplateId('local-services')
+    snapshotA?.steps[0]?.outputs.push('export' as never)
+    expect(snapshotB?.steps[0]?.outputs).not.toContain('export')
+  })
+})
+
+// ---------------------------------------------------------------------------
+// createBuildPlanSnapshotFromTemplateId — "dtc-subscription-apollo-clickup"
+// ---------------------------------------------------------------------------
+
+describe('createBuildPlanSnapshotFromTemplateId — "dtc-subscription-apollo-clickup"', () => {
+  const snapshot = createBuildPlanSnapshotFromTemplateId('dtc-subscription-apollo-clickup')
+
+  it('returns a non-null snapshot', () => {
+    expect(snapshot).not.toBeNull()
+  })
+
+  it('preserves the template id in the snapshot', () => {
+    expect(snapshot?.templateId).toBe('dtc-subscription-apollo-clickup')
+  })
+
+  it('produces a steps array with length matching the catalog (6 steps)', () => {
+    expect(snapshot?.steps).toHaveLength(6)
+  })
+
+  it('every step has required fields: id, label, primaryEntity, outputs, stageKey, dependencyMode, capabilityKey', () => {
+    for (const step of snapshot?.steps ?? []) {
+      expect(step.id).toBeTruthy()
+      expect(step.label).toBeTruthy()
+      expect(['company', 'contact']).toContain(step.primaryEntity)
+      expect(step.outputs.length).toBeGreaterThanOrEqual(1)
+      expect(step.stageKey).toBeTruthy()
+      expect(step.dependencyMode).toBe('per-record-eligibility')
+      expect(step.capabilityKey).toBeTruthy()
+    }
+  })
+
+  it('every step has positive defaultBatchSize and maxBatchSize', () => {
+    for (const step of snapshot?.steps ?? []) {
+      expect(step.defaultBatchSize).toBeGreaterThan(0)
+      expect(step.maxBatchSize).toBeGreaterThanOrEqual(step.defaultBatchSize)
+    }
+  })
+
+  it('the first step (import-apollo-search) has no dependsOn', () => {
+    const first = snapshot?.steps[0]
+    expect(first?.id).toBe('import-apollo-search')
+    expect(first?.dependsOn).toBeUndefined()
+  })
+
+  it('the first step outputs both company and contact', () => {
+    const first = snapshot?.steps[0]
+    expect(first?.outputs).toContain('company')
+    expect(first?.outputs).toContain('contact')
+  })
+
+  it('the final step (review-and-export) outputs export', () => {
+    const last = snapshot?.steps[snapshot.steps.length - 1]
+    expect(last?.id).toBe('review-and-export')
+    expect(last?.outputs).toContain('export')
+  })
+
+  it('steps with descriptions in the catalog include description in the snapshot', () => {
+    const withDesc = snapshot?.steps.filter((step) => step.description !== undefined) ?? []
+    expect(withDesc.length).toBeGreaterThan(0)
+    for (const step of withDesc) {
+      expect(typeof step.description).toBe('string')
+      expect(step.description!.length).toBeGreaterThan(0)
+    }
+  })
+})
+
+// ---------------------------------------------------------------------------
+// Snapshot shape contract — applies to every valid template id
+// ---------------------------------------------------------------------------
+
+describe('createBuildPlanSnapshotFromTemplateId — shape contract for all templates', () => {
+  it('returns a snapshot for every id that isProspectingBuildTemplateId reports valid', () => {
+    for (const option of PROSPECTING_BUILD_TEMPLATE_OPTIONS) {
+      const snapshot = createBuildPlanSnapshotFromTemplateId(option.id)
+      expect(snapshot).not.toBeNull()
+      expect(snapshot?.templateId).toBe(option.id)
+      expect(snapshot?.steps.length).toBeGreaterThan(0)
+    }
+  })
+})

package/src/business/acquisition/types.ts

@@ -1,5 +1,7 @@
 import type { Database } from '../../supabase/database.types'
-import type { PipelineStage } from './api-schemas'
+import type { CAPABILITY_REGISTRY } from '../../organization-model/domains/prospecting'
+import type { LEAD_GEN_STAGE_CATALOG } from '../../organization-model/domains/sales'
+import type { PipelineStage, ProcessingStageStatus } from './api-schemas'
 
 // =============================================================================
 // Supabase-Generated Types (Re-exported from database.types)
@@ -49,43 +51,20 @@ export interface WebPost {
   aiInsight?: string
 }
 
-/**
- * Tracks pipeline status for a company across all processing stages.
- */
-export interface CompanyPipelineStatus {
-  acquired: boolean
-  enrichment: {
-    [source: string]: {
-      status: 'pending' | 'complete' | 'failed' | 'skipped'
-      completedAt?: string
-      error?: string
-    }
-  }
-}
+export type LeadGenStageKey = (typeof LEAD_GEN_STAGE_CATALOG)[keyof typeof LEAD_GEN_STAGE_CATALOG]['key']
+export type LeadGenCapabilityKey = keyof typeof CAPABILITY_REGISTRY
 
-/**
- * Tracks pipeline status for a contact across all processing stages.
- */
-export interface ContactPipelineStatus {
-  enrichment: {
-    [source: string]: {
-      status: 'pending' | 'complete' | 'failed' | 'skipped'
-      completedAt?: string
-      error?: string
-    }
-  }
-  personalization: {
-    status: 'pending' | 'complete' | 'failed' | 'skipped'
-    completedAt?: string
-  }
-  outreach: {
-    status: 'pending' | 'sent' | 'replied' | 'bounced' | 'opted-out'
-    sentAt?: string
-    channel?: string
-    campaignId?: string
-  }
+export interface ProcessingStateEntry {
+  status: ProcessingStageStatus
+  data?: unknown
 }
 
+export type ProcessingState = Partial<Record<LeadGenStageKey, ProcessingStateEntry>>
+export type CompanyProcessingState = ProcessingState
+export type ContactProcessingState = ProcessingState
+/** @deprecated Use `processingState`. Retained only as a compile-time/read-shape bridge for external tenants. */
+export type LegacyPipelineStatus = unknown
+
 /**
  * Enrichment data collected for a company from various sources.
  */
@@ -241,7 +220,9 @@ export interface AcqCompany {
   category: string | null
   categoryPain: string | null
   segment: string | null
-  pipelineStatus: CompanyPipelineStatus | null
+  processingState: CompanyProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
   enrichmentData: CompanyEnrichmentData | null
   source: string | null
   batchId: string | null
@@ -277,7 +258,9 @@ export interface AcqContact {
   openingLine: string | null
   source: string | null
   sourceId: string | null
-  pipelineStatus: ContactPipelineStatus | null
+  processingState: ContactProcessingState | null
+  /** @deprecated Use `processingState`. This legacy DB column has been removed; responses return null. */
+  pipelineStatus?: LegacyPipelineStatus | null
   enrichmentData: ContactEnrichmentData | null
   /** Attio Person record ID - set when contact responds and is added to CRM */
   attioPersonId: string | null
@@ -318,7 +301,7 @@ export interface DealContact {
   title: string | null
   headline: string | null
   linkedin_url: string | null
-  pipeline_status: Record<string, unknown> | null
+  processing_state: Record<string, unknown> | null
   enrichment_data: Record<string, unknown> | null
   company: {
     id: string