@elevasis/core 0.28.0 → 0.29.0

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

@@ -1,240 +1,187 @@
-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, actionKey', () => {
-    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.actionKey).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, actionKey', () => {
-    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.actionKey).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('preserves Apollo credential requirements for source import and decision-maker enrichment', () => {
-    const importApolloSearch = snapshot?.steps.find((step) => step.id === 'import-apollo-search')
-    const enrichDecisionMakers = snapshot?.steps.find((step) => step.id === 'enrich-decision-makers')
-
-    const expectedRequirement = {
-      key: 'apollo',
-      provider: 'apollo',
-      credentialType: 'api-key-secret',
-      label: 'Apollo API key',
-      required: true,
-      selectionMode: 'single',
-      inputPath: 'credential'
-    }
-
-    expect(importApolloSearch?.credentialRequirements).toEqual([expectedRequirement])
-    expect(enrichDecisionMakers?.credentialRequirements).toEqual([expectedRequirement])
-  })
-
-  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('preserves contact records metadata for the company-owned decision-maker step', () => {
-    const decisionMakers = snapshot?.steps.find((step) => step.id === 'enrich-decision-makers')
-    expect(decisionMakers).toMatchObject({
-      primaryEntity: 'company',
-      recordEntity: 'contact',
-      stageKey: 'decision-makers-enriched'
-    })
-    expect(decisionMakers?.recordColumns?.contact?.length).toBeGreaterThan(0)
-  })
-
-  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)
-    }
-  })
-})
+import { describe, expect, it } from 'vitest'
+import type { ProspectingBuildTemplate } from '../../organization-model/domains/prospecting'
+import {
+  createBuildPlanSnapshotFromTemplate,
+  createBuildPlanSnapshotFromTemplateId,
+  getProspectingBuildTemplateOptions,
+  isProspectingBuildTemplateId
+} from './build-templates'
+
+const templates: ProspectingBuildTemplate[] = [
+  {
+    id: 'source-and-qualify',
+    label: 'Source and Qualify',
+    description: 'Source companies, analyze websites, and qualify fit.',
+    steps: [
+      {
+        id: 'source-companies',
+        label: 'Companies found',
+        primaryEntity: 'company',
+        outputs: ['company'],
+        stageKey: 'populated',
+        dependencyMode: 'per-record-eligibility',
+        actionKey: 'lead-gen.company.source',
+        defaultBatchSize: 100,
+        maxBatchSize: 250,
+        recordColumns: {
+          company: [{ key: 'name', label: 'Company', path: 'company.name' }]
+        }
+      },
+      {
+        id: 'qualify-companies',
+        label: 'Companies qualified',
+        description: 'Score companies against the active ICP.',
+        primaryEntity: 'company',
+        outputs: ['company'],
+        stageKey: 'qualified',
+        dependsOn: ['source-companies'],
+        dependencyMode: 'per-record-eligibility',
+        actionKey: 'lead-gen.company.qualify',
+        defaultBatchSize: 50,
+        maxBatchSize: 100
+      }
+    ]
+  },
+  {
+    id: 'export-ready',
+    label: 'Export Ready',
+    steps: [
+      {
+        id: 'review-and-export',
+        label: 'Reviewed and exported',
+        primaryEntity: 'company',
+        outputs: ['export'],
+        stageKey: 'uploaded',
+        recordsStageKey: 'uploaded',
+        recordSourceStageKey: 'qualified',
+        dependencyMode: 'per-record-eligibility',
+        actionKey: 'lead-gen.export.list',
+        defaultBatchSize: 25,
+        maxBatchSize: 100,
+        credentialRequirements: [
+          {
+            key: 'export',
+            provider: 'export-provider',
+            credentialType: 'api-key-secret',
+            label: 'Export API token',
+            required: true,
+            selectionMode: 'single',
+            inputPath: 'credential',
+            verifyOnRun: true
+          }
+        ]
+      }
+    ]
+  }
+]
+
+describe('getProspectingBuildTemplateOptions', () => {
+  it('projects option metadata from caller-supplied templates', () => {
+    expect(getProspectingBuildTemplateOptions(templates)).toEqual([
+      {
+        id: 'source-and-qualify',
+        label: 'Source and Qualify',
+        description: 'Source companies, analyze websites, and qualify fit.'
+      },
+      {
+        id: 'export-ready',
+        label: 'Export Ready',
+        description: undefined
+      }
+    ])
+  })
+})
+
+describe('isProspectingBuildTemplateId', () => {
+  it('checks membership against caller-supplied templates', () => {
+    expect(isProspectingBuildTemplateId('source-and-qualify', templates)).toBe(true)
+    expect(isProspectingBuildTemplateId('not-a-template', templates)).toBe(false)
+  })
+
+  it('has no published default template catalog', () => {
+    expect(isProspectingBuildTemplateId('source-and-qualify')).toBe(false)
+  })
+})
+
+describe('createBuildPlanSnapshotFromTemplate', () => {
+  it('creates an immutable build-plan snapshot shape from a supplied template', () => {
+    const snapshot = createBuildPlanSnapshotFromTemplate(templates[0]!)
+
+    expect(snapshot).toMatchObject({
+      templateId: 'source-and-qualify',
+      templateLabel: 'Source and Qualify',
+      steps: [
+        {
+          id: 'source-companies',
+          label: 'Companies found',
+          primaryEntity: 'company',
+          outputs: ['company'],
+          stageKey: 'populated',
+          recordsStageKey: 'populated',
+          recordSourceStageKey: 'populated',
+          dependencyMode: 'per-record-eligibility',
+          actionKey: 'lead-gen.company.source',
+          defaultBatchSize: 100,
+          maxBatchSize: 250,
+          recordColumns: {
+            company: [{ key: 'name', label: 'Company', path: 'company.name' }]
+          }
+        },
+        {
+          id: 'qualify-companies',
+          dependsOn: ['source-companies'],
+          description: 'Score companies against the active ICP.'
+        }
+      ]
+    })
+  })
+
+  it('copies array/object fields so subsequent snapshots are isolated', () => {
+    const snapshotA = createBuildPlanSnapshotFromTemplate(templates[0]!)
+    const snapshotB = createBuildPlanSnapshotFromTemplate(templates[0]!)
+
+    snapshotA.steps[0]?.outputs.push('export')
+    snapshotA.steps[0]?.recordColumns?.company?.push({ key: 'domain', label: 'Domain', path: 'company.domain' })
+
+    expect(snapshotB.steps[0]?.outputs).toEqual(['company'])
+    expect(snapshotB.steps[0]?.recordColumns?.company).toEqual([
+      { key: 'name', label: 'Company', path: 'company.name' }
+    ])
+  })
+
+  it('preserves credential requirements and explicit record stage fields', () => {
+    const snapshot = createBuildPlanSnapshotFromTemplate(templates[1]!)
+
+    expect(snapshot.steps[0]).toMatchObject({
+      id: 'review-and-export',
+      recordsStageKey: 'uploaded',
+      recordSourceStageKey: 'qualified',
+      credentialRequirements: [
+        {
+          key: 'export',
+          provider: 'export-provider',
+          credentialType: 'api-key-secret',
+          label: 'Export API token',
+          required: true,
+          selectionMode: 'single',
+          inputPath: 'credential',
+          verifyOnRun: true
+        }
+      ]
+    })
+  })
+})
+
+describe('createBuildPlanSnapshotFromTemplateId', () => {
+  it('creates snapshots from caller-supplied template catalogs', () => {
+    const snapshot = createBuildPlanSnapshotFromTemplateId('export-ready', templates)
+
+    expect(snapshot?.templateId).toBe('export-ready')
+    expect(snapshot?.steps).toHaveLength(1)
+  })
+
+  it('returns null for unknown ids or when no template catalog is supplied', () => {
+    expect(createBuildPlanSnapshotFromTemplateId('not-a-template', templates)).toBeNull()
+    expect(createBuildPlanSnapshotFromTemplateId('source-and-qualify')).toBeNull()
+  })
+})

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

@@ -1,98 +1,87 @@
-// Phase 4: DEFAULT_ORGANIZATION_MODEL_PROSPECTING was deleted (compound domain removed per D8).
-// Build-template definitions are now sourced inline from PROSPECTING_STEPS, which retains
-// the step catalog. The template catalog (id, label, description, steps[]) is declared here
-// as a local constant — Wave 2 will author these as system.content entries on the canonical OM.
-import {
-  PROSPECTING_STEPS,
-  type CredentialRequirement,
-  type ListBuilderStep,
-  type RecordColumnConfig
-} from '../../organization-model/domains/prospecting'
-import type { BuildPlanSnapshot, BuildPlanSnapshotStep } from './types'
-
-interface BuildTemplateCatalogEntry {
-  id: string
-  label: string
-  description?: string
-  steps: ListBuilderStep[]
-}
-
-// Template catalog — mirrors the data that lived in DEFAULT_ORGANIZATION_MODEL_PROSPECTING.buildTemplates.
-// Wave 2 canonical OM will author these as (kind:'schema', type:'template') content nodes.
-const BUILD_TEMPLATE_CATALOG: BuildTemplateCatalogEntry[] = [
-  {
-    id: 'local-services',
-    label: 'Local Services',
-    description: 'Source, analyze, qualify, and personalize local service businesses for outreach.',
-    steps: Object.values(PROSPECTING_STEPS.localServices)
-  },
-  {
-    id: 'dtc-subscription-apollo-clickup',
-    label: 'DTC Subscription (Apollo + ClickUp)',
-    description:
-      'Import DTC brand leads from Apollo, crawl their websites, score fit, enrich contacts, and export via ClickUp.',
-    steps: Object.values(PROSPECTING_STEPS.dtcApolloClickup)
-  }
-]
-
-export const DEFAULT_PROSPECTING_BUILD_TEMPLATE_ID = 'local-services'
-
-export const PROSPECTING_BUILD_TEMPLATE_OPTIONS = BUILD_TEMPLATE_CATALOG.map(({ id, label, description }) => ({
-  id,
-  label,
-  description
-}))
-
-export function isProspectingBuildTemplateId(value: string): boolean {
-  return PROSPECTING_BUILD_TEMPLATE_OPTIONS.some((template) => template.id === value)
-}
-
-export function createBuildPlanSnapshotFromTemplateId(templateId: string): BuildPlanSnapshot | null {
-  const template = BUILD_TEMPLATE_CATALOG.find((item: BuildTemplateCatalogEntry) => item.id === templateId)
-  if (!template) return null
-
-  return {
-    templateId: template.id,
-    templateLabel: template.label,
-    steps: template.steps.map((step: ListBuilderStep): BuildPlanSnapshotStep => {
-      const snapshotStep: BuildPlanSnapshotStep = {
-        id: step.id,
-        label: step.label,
-        primaryEntity: step.primaryEntity,
-        outputs: [...step.outputs],
-        stageKey: step.stageKey,
-        recordsStageKey: step.recordsStageKey ?? step.stageKey,
-        recordSourceStageKey: step.recordSourceStageKey ?? step.recordsStageKey ?? step.stageKey,
-        dependencyMode: step.dependencyMode,
-        actionKey: step.actionKey,
-        defaultBatchSize: step.defaultBatchSize,
-        maxBatchSize: step.maxBatchSize
-      }
-
-      if (step.description) snapshotStep.description = step.description
-      if (step.recordEntity) snapshotStep.recordEntity = step.recordEntity
-      if (step.dependsOn?.length) snapshotStep.dependsOn = [...step.dependsOn]
-      if (step.credentialRequirements?.length) {
-        snapshotStep.credentialRequirements = step.credentialRequirements.map((requirement: CredentialRequirement) => ({
-          ...requirement
-        }))
-      }
-      if (step.recordColumns) {
-        snapshotStep.recordColumns = {
-          ...(step.recordColumns.company
-            ? {
-                company: step.recordColumns.company.map((column: RecordColumnConfig) => ({ ...column }))
-              }
-            : {}),
-          ...(step.recordColumns.contact
-            ? {
-                contact: step.recordColumns.contact.map((column: RecordColumnConfig) => ({ ...column }))
-              }
-            : {})
-        }
-      }
-
-      return snapshotStep
-    })
-  }
-}
+import type {
+  CredentialRequirement,
+  ListBuilderStep,
+  ProspectingBuildTemplate,
+  RecordColumnConfig
+} from '../../organization-model/domains/prospecting'
+import type { BuildPlanSnapshot, BuildPlanSnapshotStep } from './types'
+
+export interface ProspectingBuildTemplateOption {
+  id: string
+  label: string
+  description?: string | undefined
+}
+
+export function getProspectingBuildTemplateOptions(
+  templates: readonly ProspectingBuildTemplate[]
+): ProspectingBuildTemplateOption[] {
+  return templates.map(({ id, label, description }) => ({
+    id,
+    label,
+    description
+  }))
+}
+
+export function isProspectingBuildTemplateId(
+  value: string,
+  templates: readonly ProspectingBuildTemplate[] = []
+): boolean {
+  return templates.some((template) => template.id === value)
+}
+
+export function createBuildPlanSnapshotFromTemplate(template: ProspectingBuildTemplate): BuildPlanSnapshot {
+  return {
+    templateId: template.id,
+    templateLabel: template.label,
+    steps: template.steps.map((step: ListBuilderStep): BuildPlanSnapshotStep => {
+      const snapshotStep: BuildPlanSnapshotStep = {
+        id: step.id,
+        label: step.label,
+        primaryEntity: step.primaryEntity,
+        outputs: [...step.outputs],
+        stageKey: step.stageKey,
+        recordsStageKey: step.recordsStageKey ?? step.stageKey,
+        recordSourceStageKey: step.recordSourceStageKey ?? step.recordsStageKey ?? step.stageKey,
+        dependencyMode: step.dependencyMode,
+        actionKey: step.actionKey,
+        defaultBatchSize: step.defaultBatchSize,
+        maxBatchSize: step.maxBatchSize
+      }
+
+      if (step.description) snapshotStep.description = step.description
+      if (step.recordEntity) snapshotStep.recordEntity = step.recordEntity
+      if (step.dependsOn?.length) snapshotStep.dependsOn = [...step.dependsOn]
+      if (step.credentialRequirements?.length) {
+        snapshotStep.credentialRequirements = step.credentialRequirements.map((requirement: CredentialRequirement) => ({
+          ...requirement
+        }))
+      }
+      if (step.recordColumns) {
+        snapshotStep.recordColumns = {
+          ...(step.recordColumns.company
+            ? {
+                company: step.recordColumns.company.map((column: RecordColumnConfig) => ({ ...column }))
+              }
+            : {}),
+          ...(step.recordColumns.contact
+            ? {
+                contact: step.recordColumns.contact.map((column: RecordColumnConfig) => ({ ...column }))
+              }
+            : {})
+        }
+      }
+
+      return snapshotStep
+    })
+  }
+}
+
+export function createBuildPlanSnapshotFromTemplateId(
+  templateId: string,
+  templates: readonly ProspectingBuildTemplate[] = []
+): BuildPlanSnapshot | null {
+  const template = templates.find((item) => item.id === templateId)
+  if (!template) return null
+
+  return createBuildPlanSnapshotFromTemplate(template)
+}