@dealdesk/server 2026.527.0-canary.0

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

@@ -0,0 +1,263 @@
+export class ApolloApiError extends Error {
+    status;
+    code;
+    rawBody;
+    constructor(status, rawBody) {
+        const code = classifyApolloError(status, rawBody);
+        super(formatApolloErrorMessage(status, rawBody, code));
+        this.name = "ApolloApiError";
+        this.status = status;
+        this.code = code;
+        this.rawBody = rawBody;
+    }
+}
+function classifyApolloError(status, rawBody) {
+    const lower = rawBody.toLowerCase();
+    if (lower.includes("master api key") || lower.includes("master_api_key")) {
+        return "apollo_master_key_required";
+    }
+    if (status === 403 &&
+        (lower.includes("api_inaccessible") ||
+            lower.includes("not accessible with this api_key") ||
+            lower.includes("upgrade your plan"))) {
+        return "apollo_plan_blocked";
+    }
+    if (lower.includes("credit") &&
+        (lower.includes("exhaust") || lower.includes("insufficient") || lower.includes("limit"))) {
+        return "apollo_credits_exhausted";
+    }
+    if (status === 401 || status === 403) {
+        return "apollo_auth_failed";
+    }
+    return "apollo_unknown";
+}
+function formatApolloErrorMessage(status, rawBody, code) {
+    if (code === "apollo_plan_blocked") {
+        return "Apollo cannot reveal emails on this plan. Upgrade at https://app.apollo.io/";
+    }
+    if (code === "apollo_credits_exhausted") {
+        return "Apollo enrichment credits exhausted. Add credits at https://app.apollo.io/";
+    }
+    if (code === "apollo_master_key_required") {
+        return "Apollo requires a Master API key for this endpoint. Create one at https://app.apollo.io/#/settings/integrations/api";
+    }
+    return `Apollo API failed (${status}): ${rawBody}`;
+}
+const APOLLO_MATCH_ENDPOINT = "https://api.apollo.io/api/v1/people/match";
+const APOLLO_SEARCH_ENDPOINT = "https://api.apollo.io/api/v1/mixed_people/api_search";
+const APOLLO_BULK_MATCH_ENDPOINT = "https://api.apollo.io/api/v1/people/bulk_match";
+function normalizeStatus(raw) {
+    if (raw === "verified")
+        return "verified";
+    if (raw === "bounced")
+        return "bounced";
+    if (raw === "invalid")
+        return "invalid";
+    if (raw === "guessed" || raw === "unverified")
+        return "unverified";
+    return null;
+}
+function apolloHeaders(apiKey) {
+    return {
+        "Content-Type": "application/json",
+        "X-Api-Key": apiKey,
+    };
+}
+async function readApolloError(res) {
+    const text = await res.text().catch(() => "");
+    throw new ApolloApiError(res.status, text);
+}
+function personFromPayload(payload) {
+    const person = payload.person ?? null;
+    if (!person || !person.email) {
+        return { email: null, emailStatus: null, apolloPersonId: person?.id ?? null };
+    }
+    return {
+        email: person.email,
+        emailStatus: normalizeStatus(person.email_status),
+        apolloPersonId: person.id ?? null,
+    };
+}
+export async function apolloMatchPerson(input) {
+    const res = await fetch(APOLLO_MATCH_ENDPOINT, {
+        method: "POST",
+        headers: apolloHeaders(input.apiKey),
+        body: JSON.stringify({
+            first_name: input.firstName,
+            last_name: input.lastName,
+            domain: input.companyDomain,
+            reveal_personal_emails: false,
+        }),
+    });
+    if (!res.ok) {
+        await readApolloError(res);
+    }
+    const payload = (await res.json());
+    return personFromPayload(payload);
+}
+export async function apolloSearchPeople(input) {
+    const params = new URLSearchParams();
+    params.set("q_keywords", `${input.firstName} ${input.lastName}`.trim());
+    params.set("q_organization_domains_list[]", input.companyDomain);
+    params.set("per_page", "5");
+    params.set("page", "1");
+    if (input.title) {
+        params.set("person_titles[]", input.title);
+    }
+    const res = await fetch(`${APOLLO_SEARCH_ENDPOINT}?${params.toString()}`, {
+        method: "POST",
+        headers: apolloHeaders(input.apiKey),
+    });
+    if (!res.ok) {
+        await readApolloError(res);
+    }
+    const payload = (await res.json());
+    const people = payload.people ?? [];
+    const normalizedFirst = input.firstName.toLowerCase();
+    const normalizedLast = input.lastName.toLowerCase();
+    const personIds = people
+        .filter((p) => {
+        const fn = (p.first_name ?? "").toLowerCase();
+        const ln = (p.last_name ?? "").toLowerCase();
+        return fn.includes(normalizedFirst) && ln.includes(normalizedLast);
+    })
+        .map((p) => p.id)
+        .filter((id) => typeof id === "string" && id.length > 0);
+    return { personIds };
+}
+export async function apolloBulkMatchPeople(input) {
+    if (input.personIds.length === 0) {
+        return { email: null, emailStatus: null };
+    }
+    const res = await fetch(APOLLO_BULK_MATCH_ENDPOINT, {
+        method: "POST",
+        headers: apolloHeaders(input.apiKey),
+        body: JSON.stringify({
+            details: input.personIds.slice(0, 10).map((id) => ({ id })),
+            reveal_personal_emails: false,
+        }),
+    });
+    if (!res.ok) {
+        await readApolloError(res);
+    }
+    const payload = (await res.json());
+    const matches = payload.matches ?? [];
+    for (const match of matches) {
+        const result = personFromPayload({ person: match.person ?? null });
+        if (result.email) {
+            return result;
+        }
+    }
+    return { email: null, emailStatus: null };
+}
+export async function resolvePersonEmail(input) {
+    try {
+        const direct = await apolloMatchPerson({
+            firstName: input.firstName,
+            lastName: input.lastName,
+            companyDomain: input.companyDomain,
+            apiKey: input.apiKey,
+        });
+        if (direct.email) {
+            return direct;
+        }
+    }
+    catch (err) {
+        if (err instanceof ApolloApiError && err.code !== "apollo_plan_blocked") {
+            throw err;
+        }
+        if (!(err instanceof ApolloApiError)) {
+            throw err;
+        }
+    }
+    const search = await apolloSearchPeople({
+        firstName: input.firstName,
+        lastName: input.lastName,
+        companyDomain: input.companyDomain,
+        title: input.title,
+        apiKey: input.apiKey,
+    });
+    if (search.personIds.length === 0) {
+        return { email: null, emailStatus: null };
+    }
+    return apolloBulkMatchPeople({
+        personIds: search.personIds,
+        apiKey: input.apiKey,
+    });
+}
+const PROBE_PERSON = {
+    firstName: "Tim",
+    lastName: "Zheng",
+    companyDomain: "apollo.io",
+};
+function isAuthFailure(err) {
+    return err instanceof ApolloApiError && err.code === "apollo_auth_failed";
+}
+export async function probeApolloKeyCapabilities(apiKey) {
+    const lastValidatedAt = new Date().toISOString();
+    let matchEnabled = false;
+    let searchEnabled = false;
+    let enrichmentEnabled = false;
+    let planLimited = false;
+    let masterKeyRequired = false;
+    try {
+        const match = await apolloMatchPerson({ ...PROBE_PERSON, apiKey });
+        matchEnabled = true;
+        if (match.email) {
+            enrichmentEnabled = true;
+        }
+    }
+    catch (err) {
+        if (isAuthFailure(err))
+            throw err;
+        if (err instanceof ApolloApiError && err.code === "apollo_plan_blocked") {
+            planLimited = true;
+        }
+    }
+    let searchPersonIds = [];
+    try {
+        const search = await apolloSearchPeople({ ...PROBE_PERSON, apiKey });
+        searchEnabled = true;
+        searchPersonIds = search.personIds;
+    }
+    catch (err) {
+        if (isAuthFailure(err))
+            throw err;
+        if (err instanceof ApolloApiError && err.code === "apollo_master_key_required") {
+            masterKeyRequired = true;
+        }
+        else if (err instanceof ApolloApiError && err.code === "apollo_plan_blocked") {
+            planLimited = true;
+        }
+    }
+    if (searchPersonIds.length > 0 && !enrichmentEnabled) {
+        try {
+            await apolloBulkMatchPeople({ personIds: searchPersonIds.slice(0, 1), apiKey });
+            enrichmentEnabled = true;
+        }
+        catch (err) {
+            if (isAuthFailure(err))
+                throw err;
+            if (err instanceof ApolloApiError) {
+                if (err.code === "apollo_plan_blocked") {
+                    planLimited = true;
+                }
+                else if (err.code === "apollo_credits_exhausted") {
+                    enrichmentEnabled = true;
+                }
+                else if (err.code === "apollo_master_key_required") {
+                    masterKeyRequired = true;
+                }
+            }
+        }
+    }
+    return {
+        matchEnabled,
+        searchEnabled,
+        enrichmentEnabled,
+        planLimited,
+        masterKeyRequired,
+        lastValidatedAt,
+    };
+}
+//# sourceMappingURL=apollo-client.js.map

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

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

package/dist/deal-desk/enrichment/apollo-config.d.ts

@@ -0,0 +1,56 @@
+export declare const APOLLO_API_KEY_SECRET_KEY: "apollo.api_key";
+export declare const APOLLO_CAPABILITIES_SECRET_KEY: "apollo.capabilities";
+export interface ApolloCapabilities {
+    matchEnabled: boolean;
+    searchEnabled: boolean;
+    enrichmentEnabled: boolean;
+    planLimited: boolean;
+    masterKeyRequired: boolean;
+    lastValidatedAt: string;
+}
+export interface ApolloConfigStore {
+    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>;
+}
+export declare function saveApolloApiKey(args: {
+    companyId: string;
+    apiKey: string;
+}, ctx: {
+    store: ApolloConfigStore;
+}): Promise<void>;
+export declare function loadApolloApiKey(args: {
+    companyId: string;
+}, ctx: {
+    store: ApolloConfigStore;
+}): Promise<string | null>;
+export declare function deleteApolloApiKey(args: {
+    companyId: string;
+}, ctx: {
+    store: ApolloConfigStore;
+}): Promise<void>;
+export declare function saveApolloCapabilities(args: {
+    companyId: string;
+    capabilities: ApolloCapabilities;
+}, ctx: {
+    store: ApolloConfigStore;
+}): Promise<void>;
+export declare function loadApolloCapabilities(args: {
+    companyId: string;
+}, ctx: {
+    store: ApolloConfigStore;
+}): Promise<ApolloCapabilities | null>;
+//# sourceMappingURL=apollo-config.d.ts.map

package/dist/deal-desk/enrichment/apollo-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apollo-config.d.ts","sourceRoot":"","sources":["../../../src/deal-desk/enrichment/apollo-config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,EAAG,gBAAyB,CAAC;AACnE,eAAO,MAAM,8BAA8B,EAAG,qBAA8B,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,OAAO,CAAC;IACtB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,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;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3C,GAAG,EAAE;IAAE,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAChC,OAAO,CAAC,IAAI,CAAC,CAYf;AAED,wBAAsB,gBAAgB,CACpC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3B,GAAG,EAAE;IAAE,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAIxB;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3B,GAAG,EAAE;IAAE,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAChC,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,kBAAkB,CAAA;CAAE,EAC7D,GAAG,EAAE;IAAE,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAChC,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3B,GAAG,EAAE;IAAE,KAAK,EAAE,iBAAiB,CAAA;CAAE,GAChC,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAUpC"}

package/dist/deal-desk/enrichment/apollo-config.js

@@ -0,0 +1,58 @@
+export const APOLLO_API_KEY_SECRET_KEY = "apollo.api_key";
+export const APOLLO_CAPABILITIES_SECRET_KEY = "apollo.capabilities";
+export async function saveApolloApiKey(args, ctx) {
+    const existing = await ctx.store.getByKey(args.companyId, APOLLO_API_KEY_SECRET_KEY);
+    if (existing) {
+        await ctx.store.replace(existing.id, { value: args.apiKey });
+        return;
+    }
+    await ctx.store.create(args.companyId, {
+        name: "Apollo.io API Key",
+        key: APOLLO_API_KEY_SECRET_KEY,
+        value: args.apiKey,
+        description: "Apollo.io API key for contact enrichment",
+    });
+}
+export async function loadApolloApiKey(args, ctx) {
+    const existing = await ctx.store.getByKey(args.companyId, APOLLO_API_KEY_SECRET_KEY);
+    if (!existing)
+        return null;
+    return ctx.store.load(args.companyId, existing.id);
+}
+export async function deleteApolloApiKey(args, ctx) {
+    const existing = await ctx.store.getByKey(args.companyId, APOLLO_API_KEY_SECRET_KEY);
+    if (existing)
+        await ctx.store.remove(existing.id);
+    const caps = await ctx.store.getByKey(args.companyId, APOLLO_CAPABILITIES_SECRET_KEY);
+    if (caps)
+        await ctx.store.remove(caps.id);
+}
+export async function saveApolloCapabilities(args, ctx) {
+    const payload = JSON.stringify(args.capabilities);
+    const existing = await ctx.store.getByKey(args.companyId, APOLLO_CAPABILITIES_SECRET_KEY);
+    if (existing) {
+        await ctx.store.replace(existing.id, { value: payload });
+        return;
+    }
+    await ctx.store.create(args.companyId, {
+        name: "Apollo.io Capabilities",
+        key: APOLLO_CAPABILITIES_SECRET_KEY,
+        value: payload,
+        description: "Validated Apollo.io API capabilities for contact enrichment",
+    });
+}
+export async function loadApolloCapabilities(args, ctx) {
+    const existing = await ctx.store.getByKey(args.companyId, APOLLO_CAPABILITIES_SECRET_KEY);
+    if (!existing)
+        return null;
+    const raw = await ctx.store.load(args.companyId, existing.id);
+    if (!raw)
+        return null;
+    try {
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=apollo-config.js.map

package/dist/deal-desk/enrichment/apollo-config.js.map

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

package/dist/deal-desk/enrichment/resolve-contact-email.d.ts

@@ -0,0 +1,62 @@
+import type { Db } from "@dealdesk/db";
+import { resolvePersonEmail, type ApolloEmailStatus } from "./apollo-client.js";
+export type ResolveContactEmailErrorCode = "apollo_not_configured" | "contact_not_found" | "company_mismatch" | "missing_contact_fields" | "apollo_master_key_required" | "apollo_plan_blocked" | "apollo_credits_exhausted" | "apollo_lookup_failed" | "no_email_found";
+export type ResolveContactEmailSuccess = {
+    ok: true;
+    email: string;
+    emailStatus: ApolloEmailStatus;
+    source: "apollo";
+    apolloPersonId?: string | null;
+    contactId: string;
+    firstName: string;
+    lastName: string;
+    companyDomain: string;
+};
+export type ResolveContactEmailFailure = {
+    ok: false;
+    reason: string;
+    code: ResolveContactEmailErrorCode;
+};
+export type ResolveContactEmailResult = ResolveContactEmailSuccess | ResolveContactEmailFailure;
+export interface ResolveContactEmailDeps {
+    db: Db;
+    companyId: string;
+    contactId: string;
+    loadApolloKey: (companyId: string) => Promise<string | null>;
+    resolvePersonEmailFn?: typeof resolvePersonEmail;
+}
+export declare function loadContactForEnrichment(db: Db, args: {
+    companyId: string;
+    contactId: string;
+}): Promise<{
+    id: string;
+    dealDeskCompanyId: string;
+    firstName: string;
+    lastName: string | null;
+    title: string | null;
+    email: string | null;
+    source: string | null;
+    emailStatus: string;
+    companyDomain: string | null;
+} | null>;
+export declare function contactNeedsApolloEnrichment(contact: {
+    email: string | null;
+    source: string | null;
+    emailStatus: string;
+}): boolean;
+export declare function resolveContactEmail(deps: ResolveContactEmailDeps): Promise<ResolveContactEmailResult>;
+export declare function persistResolvedContactEmail(db: Db, args: {
+    contactId: string;
+    email: string;
+    emailStatus: ApolloEmailStatus;
+    enrichedByAgentId?: string | null;
+}): Promise<void>;
+export declare function ensureContactEmailFromApollo(deps: ResolveContactEmailDeps & {
+    enrichedByAgentId?: string | null;
+}): Promise<{
+    ok: true;
+    email: string;
+    emailStatus: ApolloEmailStatus;
+    enriched: boolean;
+} | ResolveContactEmailFailure>;
+//# sourceMappingURL=resolve-contact-email.d.ts.map

package/dist/deal-desk/enrichment/resolve-contact-email.d.ts.map

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

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

@@ -0,0 +1,199 @@
+import { and, eq } from "drizzle-orm";
+import { ddContacts, ddTargets } from "@dealdesk/db";
+import { ApolloApiError, resolvePersonEmail, } from "./apollo-client.js";
+function extractCompanyDomain(website) {
+    if (!website)
+        return null;
+    try {
+        return new URL(website).hostname;
+    }
+    catch {
+        return website;
+    }
+}
+export async function loadContactForEnrichment(db, args) {
+    const rows = await db
+        .select({
+        id: ddContacts.id,
+        dealDeskCompanyId: ddContacts.dealDeskCompanyId,
+        firstName: ddContacts.firstName,
+        lastName: ddContacts.lastName,
+        title: ddContacts.title,
+        email: ddContacts.email,
+        source: ddContacts.source,
+        emailStatus: ddContacts.emailStatus,
+        website: ddTargets.website,
+    })
+        .from(ddContacts)
+        .innerJoin(ddTargets, eq(ddContacts.targetId, ddTargets.id))
+        .where(and(eq(ddContacts.id, args.contactId), eq(ddContacts.dealDeskCompanyId, args.companyId)))
+        .limit(1);
+    const row = rows[0];
+    if (!row)
+        return null;
+    return {
+        id: row.id,
+        dealDeskCompanyId: row.dealDeskCompanyId,
+        firstName: row.firstName,
+        lastName: row.lastName,
+        title: row.title,
+        email: row.email,
+        source: row.source,
+        emailStatus: row.emailStatus,
+        companyDomain: extractCompanyDomain(row.website),
+    };
+}
+export function contactNeedsApolloEnrichment(contact) {
+    if (!contact.email)
+        return true;
+    // Only Apollo-sourced emails are trusted as-is; anything else gets Apollo-verified.
+    if (contact.source !== "apollo")
+        return true;
+    return contact.emailStatus === "unverified";
+}
+export async function resolveContactEmail(deps) {
+    const resolveFn = deps.resolvePersonEmailFn ?? resolvePersonEmail;
+    const apiKey = await deps.loadApolloKey(deps.companyId);
+    if (!apiKey) {
+        return {
+            ok: false,
+            code: "apollo_not_configured",
+            reason: "Apollo.io API key not configured for this company. Visit /deal-desk/email-accounts to set it up.",
+        };
+    }
+    const contact = await loadContactForEnrichment(deps.db, {
+        companyId: deps.companyId,
+        contactId: deps.contactId,
+    });
+    if (!contact) {
+        return {
+            ok: false,
+            code: "contact_not_found",
+            reason: "contact not found",
+        };
+    }
+    if (contact.dealDeskCompanyId !== deps.companyId) {
+        return {
+            ok: false,
+            code: "company_mismatch",
+            reason: "contact does not belong to this company",
+        };
+    }
+    if (!contact.firstName || !contact.lastName || !contact.companyDomain) {
+        return {
+            ok: false,
+            code: "missing_contact_fields",
+            reason: "contact missing firstName, lastName, or target company website/domain",
+        };
+    }
+    let match;
+    try {
+        match = await resolveFn({
+            firstName: contact.firstName,
+            lastName: contact.lastName,
+            companyDomain: contact.companyDomain,
+            title: contact.title ?? undefined,
+            apiKey,
+        });
+    }
+    catch (err) {
+        if (err instanceof ApolloApiError) {
+            if (err.code === "apollo_plan_blocked") {
+                return {
+                    ok: false,
+                    code: "apollo_plan_blocked",
+                    reason: "Apollo cannot reveal emails on this plan. Upgrade at https://app.apollo.io/ or add a verified email manually.",
+                };
+            }
+            if (err.code === "apollo_master_key_required") {
+                return {
+                    ok: false,
+                    code: "apollo_master_key_required",
+                    reason: "Apollo requires a Master API key for enrichment. Create one at https://app.apollo.io/#/settings/integrations/api",
+                };
+            }
+            if (err.code === "apollo_credits_exhausted") {
+                return {
+                    ok: false,
+                    code: "apollo_credits_exhausted",
+                    reason: "Apollo enrichment credits exhausted. Add credits at https://app.apollo.io/ or add a verified email manually.",
+                };
+            }
+        }
+        const message = err instanceof Error ? err.message : "Apollo lookup failed";
+        return {
+            ok: false,
+            code: "apollo_lookup_failed",
+            reason: message,
+        };
+    }
+    if (!match.email) {
+        return {
+            ok: false,
+            code: "no_email_found",
+            reason: `No email found for ${contact.firstName} ${contact.lastName} at ${contact.companyDomain}`,
+        };
+    }
+    return {
+        ok: true,
+        email: match.email,
+        emailStatus: match.emailStatus ?? "unverified",
+        source: "apollo",
+        apolloPersonId: match.apolloPersonId ?? null,
+        contactId: contact.id,
+        firstName: contact.firstName,
+        lastName: contact.lastName,
+        companyDomain: contact.companyDomain,
+    };
+}
+export async function persistResolvedContactEmail(db, args) {
+    await db
+        .update(ddContacts)
+        .set({
+        email: args.email,
+        emailStatus: args.emailStatus,
+        source: "apollo",
+        enrichedAt: new Date(),
+        enrichedByAgentId: args.enrichedByAgentId ?? null,
+        updatedAt: new Date(),
+    })
+        .where(eq(ddContacts.id, args.contactId));
+}
+export async function ensureContactEmailFromApollo(deps) {
+    const contact = await loadContactForEnrichment(deps.db, {
+        companyId: deps.companyId,
+        contactId: deps.contactId,
+    });
+    if (!contact) {
+        return {
+            ok: false,
+            code: "contact_not_found",
+            reason: "contact not found",
+        };
+    }
+    if (!contactNeedsApolloEnrichment(contact)) {
+        return {
+            ok: true,
+            email: contact.email,
+            emailStatus: contact.emailStatus,
+            enriched: false,
+        };
+    }
+    const resolved = await resolveContactEmail(deps);
+    if (!resolved.ok) {
+        return resolved;
+    }
+    await persistResolvedContactEmail(deps.db, {
+        contactId: resolved.contactId,
+        email: resolved.email,
+        emailStatus: resolved.emailStatus,
+        enrichedByAgentId: deps.enrichedByAgentId ?? null,
+    });
+    return {
+        ok: true,
+        email: resolved.email,
+        emailStatus: resolved.emailStatus,
+        enriched: true,
+    };
+}
+//# sourceMappingURL=resolve-contact-email.js.map