feat(enrichments): add Wiza + Prospeo phone reveal to phone-number waterfall

Author: TheodoreSpeaks

apps/sim/enrichments/phone-number/phone-number.test.ts

@@ -0,0 +1,57 @@
+/**
+ * @vitest-environment node
+ */
+import { describe, expect, it } from 'vitest'
+import { phoneNumberEnrichment } from '@/enrichments/phone-number/phone-number'
+import type { EnrichmentProvider } from '@/enrichments/types'
+
+function provider(id: string): EnrichmentProvider {
+  const p = phoneNumberEnrichment.providers.find((x) => x.id === id)
+  if (!p) throw new Error(`Provider ${id} not found in phone-number cascade`)
+  return p
+}
+
+const inputs = { fullName: 'John Doe', companyDomain: 'https://www.acme.com/careers' }
+
+describe('phone-number enrichment cascade', () => {
+  it('chains PDL then the phone-capable hosted providers', () => {
+    expect(phoneNumberEnrichment.providers.map((p) => p.id)).toEqual(['pdl', 'wiza', 'prospeo'])
+  })
+
+  describe('wiza', () => {
+    const p = provider('wiza')
+    it('reveals phone (5 credits) and maps mobile_phone/phones', () => {
+      expect(p.toolId).toBe('wiza_individual_reveal')
+      expect(p.buildParams(inputs)).toEqual({
+        full_name: 'John Doe',
+        domain: 'acme.com',
+        enrichment_level: 'phone',
+      })
+      expect(p.mapOutput({ mobile_phone: '+1555', phones: [] })).toEqual({ phone: '+1555' })
+      expect(p.mapOutput({ phones: [{ number: '+1777' }] })).toEqual({ phone: '+1777' })
+      expect(p.mapOutput({ mobile_phone: null, phone_number: null, phones: [] })).toBeNull()
+    })
+    it('skips without a company domain', () => {
+      expect(p.buildParams({ fullName: 'John Doe', companyDomain: '' })).toBeNull()
+    })
+  })
+
+  describe('prospeo', () => {
+    const p = provider('prospeo')
+    it('requests mobile enrichment and maps person.mobile.mobile', () => {
+      expect(p.toolId).toBe('prospeo_enrich_person')
+      expect(p.buildParams(inputs)).toEqual({
+        full_name: 'John Doe',
+        company_website: 'acme.com',
+        enrich_mobile: true,
+      })
+      expect(p.mapOutput({ person: { mobile: { mobile: '+1555', status: 'VERIFIED' } } })).toEqual({
+        phone: '+1555',
+      })
+      expect(p.mapOutput({ person: { mobile: { mobile: '' } } })).toBeNull()
+    })
+    it('skips without a company domain', () => {
+      expect(p.buildParams({ fullName: 'John Doe', companyDomain: '' })).toBeNull()
+    })
+  })
+})

apps/sim/enrichments/phone-number/phone-number.ts

@@ -5,7 +5,10 @@ import type { EnrichmentConfig } from '@/enrichments/types'
 
 /**
  * Phone Number enrichment. Finds a contact's phone number from their full name
- * and (optionally) company domain via a People Data Labs person match.
+ * and (optionally) company domain via a waterfall: People Data Labs first
+ * (cheapest, name-only capable), then Wiza and Prospeo mobile reveals as
+ * fallbacks. Wiza/Prospeo need a company domain, so they self-skip without one.
+ * The first provider to return a phone wins; all support hosted keys.
  */
 export const phoneNumberEnrichment: EnrichmentConfig = {
   id: 'phone-number',
@@ -37,5 +40,41 @@ export const phoneNumberEnrichment: EnrichmentConfig = {
         return phone ? { phone } : null
       },
     }),
+    toolProvider({
+      id: 'wiza',
+      label: 'Wiza',
+      toolId: 'wiza_individual_reveal',
+      buildParams: (inputs) => {
+        const fullName = str(inputs.fullName)
+        const domain = normalizeDomain(inputs.companyDomain)
+        if (!fullName || !domain) return null
+        // 'phone' reveals the mobile number (5 credits).
+        return { full_name: fullName, domain, enrichment_level: 'phone' }
+      },
+      mapOutput: (output) => {
+        const phones = Array.isArray(output.phones)
+          ? (output.phones as Record<string, unknown>[])
+          : []
+        const phone = str(output.mobile_phone) || str(output.phone_number) || str(phones[0]?.number)
+        return phone ? { phone } : null
+      },
+    }),
+    toolProvider({
+      id: 'prospeo',
+      label: 'Prospeo',
+      toolId: 'prospeo_enrich_person',
+      buildParams: (inputs) => {
+        const fullName = str(inputs.fullName)
+        const companyWebsite = normalizeDomain(inputs.companyDomain)
+        if (!fullName || !companyWebsite) return null
+        return { full_name: fullName, company_website: companyWebsite, enrich_mobile: true }
+      },
+      mapOutput: (output) => {
+        const person = output.person as Record<string, unknown> | undefined
+        const mobile = person?.mobile as Record<string, unknown> | undefined
+        const phone = str(mobile?.mobile)
+        return phone ? { phone } : null
+      },
+    }),
   ],
 }