@dealdesk/server 2026.602.0 → 2026.603.0

package/dist/deal-desk/enrichment/__tests__/hunter-client.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hunter-client.test.d.ts.map

package/dist/deal-desk/enrichment/__tests__/hunter-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hunter-client.test.d.ts","sourceRoot":"","sources":["../../../../src/deal-desk/enrichment/__tests__/hunter-client.test.ts"],"names":[],"mappings":""}

package/dist/deal-desk/enrichment/__tests__/hunter-client.test.js

@@ -0,0 +1,106 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { hunterFindEmail, resolveHunterEmail, probeHunterKeyCapabilities, HunterApiError, } from "../hunter-client.js";
+const fetchMock = vi.fn();
+beforeEach(() => {
+    vi.stubGlobal("fetch", fetchMock);
+    fetchMock.mockReset();
+});
+describe("hunterFindEmail", () => {
+    it("GETs email-finder with domain, names and api_key, and maps a valid result", async () => {
+        fetchMock.mockResolvedValueOnce({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                data: { email: "alice@acme.com", score: 95, verification: { status: "valid" } },
+            }),
+        });
+        const r = await hunterFindEmail({
+            firstName: "Alice",
+            lastName: "Smith",
+            companyDomain: "acme.com",
+            apiKey: "hk-123",
+        });
+        expect(fetchMock).toHaveBeenCalledOnce();
+        const [url, init] = fetchMock.mock.calls[0];
+        const u = new URL(url);
+        expect(u.origin + u.pathname).toBe("https://api.hunter.io/v2/email-finder");
+        expect(u.searchParams.get("domain")).toBe("acme.com");
+        expect(u.searchParams.get("first_name")).toBe("Alice");
+        expect(u.searchParams.get("last_name")).toBe("Smith");
+        expect(u.searchParams.get("api_key")).toBe("hk-123");
+        expect(init?.method ?? "GET").toBe("GET");
+        expect(r).toEqual({ email: "alice@acme.com", emailStatus: "verified", score: 95 });
+    });
+    it("maps verification status invalid -> invalid and other statuses -> unverified", async () => {
+        fetchMock.mockResolvedValueOnce({
+            ok: true,
+            status: 200,
+            json: async () => ({ data: { email: "x@y.com", score: 40, verification: { status: "invalid" } } }),
+        });
+        expect((await hunterFindEmail({ firstName: "A", lastName: "B", companyDomain: "y.com", apiKey: "k" })).emailStatus).toBe("invalid");
+        fetchMock.mockResolvedValueOnce({
+            ok: true,
+            status: 200,
+            json: async () => ({ data: { email: "x@y.com", score: 60, verification: { status: "accept_all" } } }),
+        });
+        expect((await hunterFindEmail({ firstName: "A", lastName: "B", companyDomain: "y.com", apiKey: "k" })).emailStatus).toBe("unverified");
+    });
+    it("returns null email when Hunter finds none", async () => {
+        fetchMock.mockResolvedValueOnce({
+            ok: true,
+            status: 200,
+            json: async () => ({ data: { email: null, score: 0, verification: { status: "unknown" } } }),
+        });
+        const r = await hunterFindEmail({ firstName: "A", lastName: "B", companyDomain: "y.com", apiKey: "k" });
+        expect(r).toEqual({ email: null, emailStatus: null, score: 0 });
+    });
+    it("throws HunterApiError with hunter_auth_failed on 401", async () => {
+        fetchMock.mockResolvedValueOnce({
+            ok: false,
+            status: 401,
+            text: async () => JSON.stringify({ errors: [{ id: "unauthorized", code: 401, details: "Invalid API key" }] }),
+        });
+        await expect(hunterFindEmail({ firstName: "A", lastName: "B", companyDomain: "y.com", apiKey: "bad" })).rejects.toMatchObject({ code: "hunter_auth_failed" });
+    });
+    it("maps 429 to hunter_rate_limited and 451 to hunter_pii_restricted", async () => {
+        fetchMock.mockResolvedValueOnce({ ok: false, status: 429, text: async () => "too many" });
+        await expect(hunterFindEmail({ firstName: "A", lastName: "B", companyDomain: "y.com", apiKey: "k" })).rejects.toMatchObject({ code: "hunter_rate_limited" });
+        fetchMock.mockResolvedValueOnce({ ok: false, status: 451, text: async () => "pii" });
+        await expect(hunterFindEmail({ firstName: "A", lastName: "B", companyDomain: "y.com", apiKey: "k" })).rejects.toMatchObject({ code: "hunter_pii_restricted" });
+    });
+});
+describe("resolveHunterEmail", () => {
+    it("returns the finder result in the apollo-compatible shape", async () => {
+        fetchMock.mockResolvedValueOnce({
+            ok: true,
+            status: 200,
+            json: async () => ({ data: { email: "a@b.com", score: 88, verification: { status: "valid" } } }),
+        });
+        const r = await resolveHunterEmail({ firstName: "A", lastName: "B", companyDomain: "b.com", apiKey: "k" });
+        expect(r).toEqual({ email: "a@b.com", emailStatus: "verified" });
+    });
+});
+describe("probeHunterKeyCapabilities", () => {
+    it("validates the key via /account and reports search credits", async () => {
+        fetchMock.mockResolvedValueOnce({
+            ok: true,
+            status: 200,
+            json: async () => ({
+                data: { plan_name: "Growth", requests: { searches: { used: 500, available: 10000 } } },
+            }),
+        });
+        const caps = await probeHunterKeyCapabilities("hk-123");
+        const [url] = fetchMock.mock.calls[0];
+        expect(url.startsWith("https://api.hunter.io/v2/account")).toBe(true);
+        expect(caps.valid).toBe(true);
+        expect(caps.planName).toBe("Growth");
+        expect(caps.searchesUsed).toBe(500);
+        expect(caps.searchesAvailable).toBe(10000);
+        expect(typeof caps.lastValidatedAt).toBe("string");
+    });
+    it("throws on an invalid key (401)", async () => {
+        fetchMock.mockResolvedValueOnce({ ok: false, status: 401, text: async () => "nope" });
+        await expect(probeHunterKeyCapabilities("bad")).rejects.toBeInstanceOf(HunterApiError);
+    });
+});
+//# sourceMappingURL=hunter-client.test.js.map

package/dist/deal-desk/enrichment/__tests__/hunter-client.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hunter-client.test.js","sourceRoot":"","sources":["../../../../src/deal-desk/enrichment/__tests__/hunter-client.test.ts"],"names":[],"mappings":"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"}

package/dist/deal-desk/enrichment/__tests__/hunter-config.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hunter-config.test.d.ts.map

package/dist/deal-desk/enrichment/__tests__/hunter-config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hunter-config.test.d.ts","sourceRoot":"","sources":["../../../../src/deal-desk/enrichment/__tests__/hunter-config.test.ts"],"names":[],"mappings":""}

package/dist/deal-desk/enrichment/__tests__/hunter-config.test.js

@@ -0,0 +1,73 @@
+import { describe, it, expect } from "vitest";
+import { saveHunterApiKey, loadHunterApiKey, deleteHunterApiKey, saveHunterCapabilities, loadHunterCapabilities, HUNTER_API_KEY_SECRET_KEY, } from "../hunter-config.js";
+function makeStore(initial = {}) {
+    const byKey = new Map(Object.entries(initial));
+    return {
+        async getByKey(_companyId, key) {
+            const v = byKey.get(key);
+            return v ? { id: v.id } : null;
+        },
+        async create(_companyId, args) {
+            const id = `secret-${byKey.size + 1}`;
+            byKey.set(args.key, { id, value: args.value });
+            return { id };
+        },
+        async replace(secretId, args) {
+            for (const [k, v] of byKey.entries()) {
+                if (v.id === secretId) {
+                    byKey.set(k, { ...v, value: args.value });
+                    return;
+                }
+            }
+            throw new Error("secret not found");
+        },
+        async remove(secretId) {
+            for (const [k, v] of byKey.entries()) {
+                if (v.id === secretId) {
+                    byKey.delete(k);
+                    return;
+                }
+            }
+        },
+        async load(_companyId, secretId) {
+            for (const v of byKey.values()) {
+                if (v.id === secretId)
+                    return v.value;
+            }
+            return null;
+        },
+    };
+}
+describe("hunter-config", () => {
+    it("creates the secret on first save and rotates on subsequent save", async () => {
+        const store = makeStore();
+        await saveHunterApiKey({ companyId: "c1", apiKey: "hk-aaa" }, { store });
+        expect(await loadHunterApiKey({ companyId: "c1" }, { store })).toBe("hk-aaa");
+        await saveHunterApiKey({ companyId: "c1", apiKey: "hk-bbb" }, { store });
+        expect(await loadHunterApiKey({ companyId: "c1" }, { store })).toBe("hk-bbb");
+    });
+    it("loadHunterApiKey returns null when not configured", async () => {
+        const store = makeStore();
+        expect(await loadHunterApiKey({ companyId: "c1" }, { store })).toBeNull();
+    });
+    it("deleteHunterApiKey removes both the key and cached capabilities", async () => {
+        const store = makeStore();
+        const caps = {
+            valid: true,
+            planName: "Free",
+            searchesUsed: 1,
+            searchesAvailable: 25,
+            lastValidatedAt: "2026-06-01T00:00:00.000Z",
+        };
+        await saveHunterApiKey({ companyId: "c1", apiKey: "hk-aaa" }, { store });
+        await saveHunterCapabilities({ companyId: "c1", capabilities: caps }, { store });
+        expect(await loadHunterCapabilities({ companyId: "c1" }, { store })).toEqual(caps);
+        await deleteHunterApiKey({ companyId: "c1" }, { store });
+        expect(await loadHunterApiKey({ companyId: "c1" }, { store })).toBeNull();
+        expect(await loadHunterCapabilities({ companyId: "c1" }, { store })).toBeNull();
+    });
+    it("uses the documented secret key", () => {
+        expect(HUNTER_API_KEY_SECRET_KEY).toBe("hunter.api_key");
+    });
+});
+//# sourceMappingURL=hunter-config.test.js.map

package/dist/deal-desk/enrichment/__tests__/hunter-config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hunter-config.test.js","sourceRoot":"","sources":["../../../../src/deal-desk/enrichment/__tests__/hunter-config.test.ts"],"names":[],"mappings":"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"}

package/dist/deal-desk/enrichment/__tests__/provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=provider.test.d.ts.map

package/dist/deal-desk/enrichment/__tests__/provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.test.d.ts","sourceRoot":"","sources":["../../../../src/deal-desk/enrichment/__tests__/provider.test.ts"],"names":[],"mappings":""}

package/dist/deal-desk/enrichment/__tests__/provider.test.js

@@ -0,0 +1,77 @@
+import { describe, it, expect } from "vitest";
+import { resolveEffectiveProvider, savePreferredProvider, loadPreferredProvider, PREFERRED_PROVIDER_SECRET_KEY, } from "../provider.js";
+function makeStore(initial = {}) {
+    const byKey = new Map(Object.entries(initial));
+    return {
+        async getByKey(_companyId, key) {
+            const v = byKey.get(key);
+            return v ? { id: v.id } : null;
+        },
+        async create(_companyId, args) {
+            const id = `secret-${byKey.size + 1}`;
+            byKey.set(args.key, { id, value: args.value });
+            return { id };
+        },
+        async replace(secretId, args) {
+            for (const [k, v] of byKey.entries()) {
+                if (v.id === secretId) {
+                    byKey.set(k, { ...v, value: args.value });
+                    return;
+                }
+            }
+            throw new Error("secret not found");
+        },
+        async remove(secretId) {
+            for (const [k, v] of byKey.entries()) {
+                if (v.id === secretId) {
+                    byKey.delete(k);
+                    return;
+                }
+            }
+        },
+        async load(_companyId, secretId) {
+            for (const v of byKey.values()) {
+                if (v.id === secretId)
+                    return v.value;
+            }
+            return null;
+        },
+    };
+}
+describe("resolveEffectiveProvider", () => {
+    it("returns null when neither provider is configured", () => {
+        expect(resolveEffectiveProvider({ apolloConfigured: false, hunterConfigured: false, preferred: null })).toBeNull();
+    });
+    it("auto-uses the only configured provider", () => {
+        expect(resolveEffectiveProvider({ apolloConfigured: true, hunterConfigured: false, preferred: null })).toBe("apollo");
+        expect(resolveEffectiveProvider({ apolloConfigured: false, hunterConfigured: true, preferred: null })).toBe("hunter");
+    });
+    it("ignores the preference when only one provider is configured", () => {
+        expect(resolveEffectiveProvider({ apolloConfigured: true, hunterConfigured: false, preferred: "hunter" })).toBe("apollo");
+        expect(resolveEffectiveProvider({ apolloConfigured: false, hunterConfigured: true, preferred: "apollo" })).toBe("hunter");
+    });
+    it("uses the preference when both are configured", () => {
+        expect(resolveEffectiveProvider({ apolloConfigured: true, hunterConfigured: true, preferred: "hunter" })).toBe("hunter");
+        expect(resolveEffectiveProvider({ apolloConfigured: true, hunterConfigured: true, preferred: "apollo" })).toBe("apollo");
+    });
+    it("defaults to apollo when both are configured and no preference is set", () => {
+        expect(resolveEffectiveProvider({ apolloConfigured: true, hunterConfigured: true, preferred: null })).toBe("apollo");
+    });
+});
+describe("preferred provider persistence", () => {
+    it("saves and loads the preferred provider", async () => {
+        const store = makeStore();
+        expect(await loadPreferredProvider({ companyId: "c1" }, { store })).toBeNull();
+        await savePreferredProvider({ companyId: "c1", provider: "hunter" }, { store });
+        expect(await loadPreferredProvider({ companyId: "c1" }, { store })).toBe("hunter");
+        await savePreferredProvider({ companyId: "c1", provider: "apollo" }, { store });
+        expect(await loadPreferredProvider({ companyId: "c1" }, { store })).toBe("apollo");
+    });
+    it("returns null for an unrecognized stored value", async () => {
+        const store = makeStore({
+            [PREFERRED_PROVIDER_SECRET_KEY]: { id: "s1", value: "bogus" },
+        });
+        expect(await loadPreferredProvider({ companyId: "c1" }, { store })).toBeNull();
+    });
+});
+//# sourceMappingURL=provider.test.js.map

package/dist/deal-desk/enrichment/__tests__/provider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.test.js","sourceRoot":"","sources":["../../../../src/deal-desk/enrichment/__tests__/provider.test.ts"],"names":[],"mappings":"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"}

package/dist/deal-desk/enrichment/__tests__/resolve-contact-email.test.js

@@ -72,6 +72,39 @@ describe("resolveContactEmail", () => {
         if (!result.ok)
             expect(result.code).toBe("apollo_plan_blocked");
     });
+    it("resolves via Hunter when the selected provider is hunter", async () => {
+        const resolveHunterMock = vi.fn().mockResolvedValueOnce({
+            email: "alice@acme.com",
+            emailStatus: "verified",
+        });
+        const result = await resolveContactEmail({
+            db: db(),
+            companyId: "co-1",
+            contactId: "contact-1",
+            loadEnrichment: async () => ({ provider: "hunter", apiKey: "hk-xyz" }),
+            resolveHunterEmailFn: resolveHunterMock,
+        });
+        expect(resolveHunterMock).toHaveBeenCalledOnce();
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.email).toBe("alice@acme.com");
+            expect(result.source).toBe("hunter");
+        }
+    });
+    it("maps hunter PII-restricted errors", async () => {
+        const { HunterApiError } = await import("../hunter-client.js");
+        const resolveHunterMock = vi.fn().mockRejectedValueOnce(new HunterApiError(451, "pii"));
+        const result = await resolveContactEmail({
+            db: db(),
+            companyId: "co-1",
+            contactId: "contact-1",
+            loadEnrichment: async () => ({ provider: "hunter", apiKey: "hk-xyz" }),
+            resolveHunterEmailFn: resolveHunterMock,
+        });
+        expect(result.ok).toBe(false);
+        if (!result.ok)
+            expect(result.code).toBe("hunter_pii_restricted");
+    });
 });
 describe("contactNeedsApolloEnrichment", () => {
     it("returns true when email is missing", () => {

package/dist/deal-desk/enrichment/__tests__/resolve-contact-email.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-contact-email.test.js","sourceRoot":"","sources":["../../../../src/deal-desk/enrichment/__tests__/resolve-contact-email.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resolve-contact-email.test.js","sourceRoot":"","sources":["../../../../src/deal-desk/enrichment/__tests__/resolve-contact-email.test.ts"],"names":[],"mappings":"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"}

package/dist/deal-desk/enrichment/enrichment-types.d.ts

@@ -0,0 +1,38 @@
+/** Which enrichment provider resolved (or should resolve) a contact email. */
+export type EnrichmentProvider = "apollo" | "hunter";
+/**
+ * Normalized email deliverability status used across providers and persisted on
+ * ddContacts.emailStatus. Apollo and Hunter both map their native statuses here.
+ */
+export type EmailStatus = "verified" | "unverified" | "bounced" | "invalid";
+/**
+ * A resolved enrichment selection: the effective provider for a company plus the
+ * API key to use. Returned by the provider-aware loader wired in tools/index.ts.
+ */
+export interface EnrichmentSelection {
+    provider: EnrichmentProvider;
+    apiKey: string;
+}
+/**
+ * Minimal per-company encrypted key/value store shape shared by the Apollo,
+ * Hunter, and preferred-provider config helpers. Backed by company_secrets.
+ */
+export interface SecretConfigStore {
+    getByKey(companyId: string, key: string): Promise<{
+        id: string;
+    } | null>;
+    create(companyId: string, args: {
+        name: string;
+        key: string;
+        value: string;
+        description?: string;
+    }): Promise<{
+        id: string;
+    }>;
+    replace(secretId: string, args: {
+        value: string;
+    }): Promise<void>;
+    remove(secretId: string): Promise<void>;
+    load(companyId: string, secretId: string): Promise<string | null>;
+}
+//# sourceMappingURL=enrichment-types.d.ts.map

package/dist/deal-desk/enrichment/enrichment-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment-types.d.ts","sourceRoot":"","sources":["../../../src/deal-desk/enrichment/enrichment-types.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAErD;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,YAAY,GAAG,SAAS,GAAG,SAAS,CAAC;AAE5E;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACzE,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GACvE,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3B,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACnE"}

package/dist/deal-desk/enrichment/enrichment-types.js

@@ -0,0 +1,3 @@
+// DEAL DESK: Shared types for contact-enrichment providers (Apollo, Hunter).
+export {};
+//# sourceMappingURL=enrichment-types.js.map

package/dist/deal-desk/enrichment/enrichment-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrichment-types.js","sourceRoot":"","sources":["../../../src/deal-desk/enrichment/enrichment-types.ts"],"names":[],"mappings":"AAAA,6EAA6E"}

package/dist/deal-desk/enrichment/hunter-client.d.ts

@@ -0,0 +1,44 @@
+import type { EmailStatus } from "./enrichment-types.js";
+export type HunterErrorCode = "hunter_auth_failed" | "hunter_rate_limited" | "hunter_pii_restricted" | "hunter_unknown";
+export declare class HunterApiError extends Error {
+    readonly status: number;
+    readonly code: HunterErrorCode;
+    readonly rawBody: string;
+    constructor(status: number, rawBody: string);
+}
+export interface HunterFindInput {
+    firstName: string;
+    lastName: string;
+    companyDomain: string;
+    apiKey: string;
+}
+export interface HunterFindResult {
+    email: string | null;
+    emailStatus: EmailStatus | null;
+    score: number | null;
+}
+export declare function hunterFindEmail(input: HunterFindInput): Promise<HunterFindResult>;
+export interface ResolveHunterEmailInput {
+    firstName: string;
+    lastName: string;
+    companyDomain: string;
+    /** Accepted for signature-compatibility with the Apollo resolver; Hunter ignores it. */
+    title?: string;
+    apiKey: string;
+}
+export interface ResolveHunterEmailResult {
+    email: string | null;
+    emailStatus: EmailStatus | null;
+}
+/** Apollo-resolver-compatible entry point used by the shared orchestration. */
+export declare function resolveHunterEmail(input: ResolveHunterEmailInput): Promise<ResolveHunterEmailResult>;
+export interface HunterKeyCapabilities {
+    valid: boolean;
+    planName: string | null;
+    searchesUsed: number | null;
+    searchesAvailable: number | null;
+    lastValidatedAt: string;
+}
+/** Validate a key and read plan/search-credit info via GET /v2/account. */
+export declare function probeHunterKeyCapabilities(apiKey: string): Promise<HunterKeyCapabilities>;
+//# sourceMappingURL=hunter-client.d.ts.map

package/dist/deal-desk/enrichment/hunter-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hunter-client.d.ts","sourceRoot":"","sources":["../../../src/deal-desk/enrichment/hunter-client.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKzD,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,qBAAqB,GACrB,uBAAuB,GACvB,gBAAgB,CAAC;AAsBrB,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAQ5C;AAsBD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;IAChC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAsB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8BvF;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAC;CACjC;AAED,+EAA+E;AAC/E,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CAQnC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,2EAA2E;AAC3E,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA2B/F"}

package/dist/deal-desk/enrichment/hunter-client.js

@@ -0,0 +1,112 @@
+const HUNTER_EMAIL_FINDER_ENDPOINT = "https://api.hunter.io/v2/email-finder";
+const HUNTER_ACCOUNT_ENDPOINT = "https://api.hunter.io/v2/account";
+function classifyHunterError(status) {
+    if (status === 401)
+        return "hunter_auth_failed";
+    if (status === 403 || status === 429)
+        return "hunter_rate_limited";
+    if (status === 451)
+        return "hunter_pii_restricted";
+    return "hunter_unknown";
+}
+function formatHunterErrorMessage(status, rawBody, code) {
+    if (code === "hunter_auth_failed") {
+        return "Hunter.io API key is invalid or unauthorized.";
+    }
+    if (code === "hunter_rate_limited") {
+        return "Hunter.io usage limit reached. Check your plan at https://hunter.io/api-keys";
+    }
+    if (code === "hunter_pii_restricted") {
+        return "Hunter.io cannot return this email for legal (PII) reasons.";
+    }
+    return `Hunter.io API failed (${status}): ${rawBody}`;
+}
+export class HunterApiError extends Error {
+    status;
+    code;
+    rawBody;
+    constructor(status, rawBody) {
+        const code = classifyHunterError(status);
+        super(formatHunterErrorMessage(status, rawBody, code));
+        this.name = "HunterApiError";
+        this.status = status;
+        this.code = code;
+        this.rawBody = rawBody;
+    }
+}
+async function readHunterError(res) {
+    let body = "";
+    try {
+        body = await res.text();
+    }
+    catch {
+        body = "";
+    }
+    throw new HunterApiError(res.status, body);
+}
+/**
+ * Map Hunter's verification.status to DealDesk's normalized EmailStatus.
+ * Hunter statuses: valid | invalid | accept_all | webmail | disposable | unknown.
+ */
+function normalizeHunterStatus(raw) {
+    if (raw === "valid")
+        return "verified";
+    if (raw === "invalid")
+        return "invalid";
+    return "unverified";
+}
+export async function hunterFindEmail(input) {
+    const params = new URLSearchParams();
+    params.set("domain", input.companyDomain);
+    params.set("first_name", input.firstName);
+    params.set("last_name", input.lastName);
+    params.set("api_key", input.apiKey);
+    const res = await fetch(`${HUNTER_EMAIL_FINDER_ENDPOINT}?${params.toString()}`, {
+        method: "GET",
+        headers: { Accept: "application/json" },
+    });
+    if (!res.ok) {
+        await readHunterError(res);
+    }
+    const payload = (await res.json());
+    const data = payload.data ?? null;
+    const email = data?.email ?? null;
+    const score = typeof data?.score === "number" ? data.score : null;
+    if (!email) {
+        return { email: null, emailStatus: null, score };
+    }
+    return { email, emailStatus: normalizeHunterStatus(data?.verification?.status), score };
+}
+/** Apollo-resolver-compatible entry point used by the shared orchestration. */
+export async function resolveHunterEmail(input) {
+    const found = await hunterFindEmail({
+        firstName: input.firstName,
+        lastName: input.lastName,
+        companyDomain: input.companyDomain,
+        apiKey: input.apiKey,
+    });
+    return { email: found.email, emailStatus: found.emailStatus };
+}
+/** Validate a key and read plan/search-credit info via GET /v2/account. */
+export async function probeHunterKeyCapabilities(apiKey) {
+    const lastValidatedAt = new Date().toISOString();
+    const params = new URLSearchParams({ api_key: apiKey });
+    const res = await fetch(`${HUNTER_ACCOUNT_ENDPOINT}?${params.toString()}`, {
+        method: "GET",
+        headers: { Accept: "application/json" },
+    });
+    if (!res.ok) {
+        await readHunterError(res);
+    }
+    const payload = (await res.json());
+    const data = payload.data ?? null;
+    const searches = data?.requests?.searches ?? null;
+    return {
+        valid: true,
+        planName: data?.plan_name ?? null,
+        searchesUsed: typeof searches?.used === "number" ? searches.used : null,
+        searchesAvailable: typeof searches?.available === "number" ? searches.available : null,
+        lastValidatedAt,
+    };
+}
+//# sourceMappingURL=hunter-client.js.map

package/dist/deal-desk/enrichment/hunter-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hunter-client.js","sourceRoot":"","sources":["../../../src/deal-desk/enrichment/hunter-client.ts"],"names":[],"mappings":"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"}