@elevasis/core 0.23.0 → 0.24.0

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

@@ -1,240 +1,240 @@
-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 {
+  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)
+    }
+  })
+})