salesprompter-cli 0.1.23 → 0.1.25

package/dist/hunter-emails.js

@@ -0,0 +1,291 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+function escapeSqlString(value) {
+    return value.replaceAll("\\", "\\\\").replaceAll("'", "\\'");
+}
+function sqlStringLiteral(value) {
+    if (value == null) {
+        return "NULL";
+    }
+    return `'${escapeSqlString(value)}'`;
+}
+function sqlNumberLiteral(value) {
+    if (value == null || Number.isNaN(value)) {
+        return "NULL";
+    }
+    return String(value);
+}
+function sqlBooleanLiteral(value) {
+    if (value == null) {
+        return "NULL";
+    }
+    return value ? "TRUE" : "FALSE";
+}
+const DEFAULT_HUNTER_INPUT_TABLE = "icpidentifier.SalesPrompter.hunter_emailFinder_input";
+const DEFAULT_HUNTER_OUTPUT_TABLE = "icpidentifier.SalesPrompter.hunter_emailFinder_output";
+const DEFAULT_HUNTER_API_BASE_URL = "https://api.hunter.io/v2";
+const DEFAULT_HUNTER_RATE_LIMIT_PER_MINUTE = 300;
+const DEFAULT_HUNTER_REQUEST_TIMEOUT_MS = 30_000;
+const DEFAULT_HUNTER_LOCATION = "europe-west3";
+const ENV_FILE_PATHS = [
+    resolve(dirname(fileURLToPath(import.meta.url)), "..", ".env.local"),
+    resolve(dirname(fileURLToPath(import.meta.url)), "..", ".env"),
+    resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "salesprompter-app", ".env.local"),
+    resolve(dirname(fileURLToPath(import.meta.url)), "..", "..", "salesprompter-app", ".env.vercel.local")
+];
+const envFileCache = new Map();
+export class HunterRateLimitError extends Error {
+    constructor(message = "Hunter rate limit exceeded") {
+        super(message);
+        this.name = "HunterRateLimitError";
+    }
+}
+function parseDotEnvFile(filePath) {
+    if (envFileCache.has(filePath)) {
+        return envFileCache.get(filePath);
+    }
+    const parsed = new Map();
+    if (existsSync(filePath)) {
+        const content = readFileSync(filePath, "utf8");
+        for (const line of content.split(/\r?\n/)) {
+            const trimmed = line.trim();
+            if (trimmed.length === 0 || trimmed.startsWith("#")) {
+                continue;
+            }
+            const separatorIndex = trimmed.indexOf("=");
+            if (separatorIndex <= 0) {
+                continue;
+            }
+            const key = trimmed.slice(0, separatorIndex).trim();
+            let value = trimmed.slice(separatorIndex + 1).trim();
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+            if (key.length > 0 && value.length > 0) {
+                parsed.set(key, value);
+            }
+        }
+    }
+    envFileCache.set(filePath, parsed);
+    return parsed;
+}
+function resolveConfiguredEnvValue(env, key) {
+    const directValue = env[key]?.trim() || "";
+    if (directValue.length > 0) {
+        return directValue;
+    }
+    if (env !== process.env) {
+        return null;
+    }
+    for (const filePath of ENV_FILE_PATHS) {
+        const parsed = parseDotEnvFile(filePath);
+        const value = parsed.get(key)?.trim() || "";
+        if (value.length > 0) {
+            return value;
+        }
+    }
+    return null;
+}
+function requireTrimmedString(row, field) {
+    const value = String(row[field] ?? "").trim();
+    if (value.length === 0) {
+        throw new Error(`Hunter email input row missing required field: ${field}`);
+    }
+    return value;
+}
+function parseNullableInt(value) {
+    if (value == null || value === "") {
+        return null;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed)) {
+        throw new Error(`Expected integer-compatible value, received ${String(value)}`);
+    }
+    return parsed;
+}
+export function resolveHunterApiKey(env = process.env) {
+    return resolveConfiguredEnvValue(env, "HUNTER_API_KEY");
+}
+export function getHunterLocation(env = process.env) {
+    return resolveConfiguredEnvValue(env, "HUNTER_BIGQUERY_LOCATION") ?? DEFAULT_HUNTER_LOCATION;
+}
+export function buildHunterEmailFinderInputSql(options) {
+    const trimmedQuery = options.sqlQuery?.trim() || "";
+    if (trimmedQuery.length > 0) {
+        if (options.clientId == null) {
+            return trimmedQuery;
+        }
+        const upper = trimmedQuery.toUpperCase();
+        return `${trimmedQuery}\n${upper.includes(" WHERE ") ? "AND" : "WHERE"} clientId = ${options.clientId}`;
+    }
+    const table = options.table ?? DEFAULT_HUNTER_INPUT_TABLE;
+    const where = options.clientId == null ? "" : `\nWHERE clientId = ${options.clientId}`;
+    return [
+        "SELECT",
+        "  clientId,",
+        "  contactId,",
+        "  companyId,",
+        "  firstName_cleaned,",
+        "  lastName_cleaned,",
+        "  domain",
+        `FROM \`${table}\``,
+        `${where}`,
+        "ORDER BY clientId, contactId",
+        `LIMIT ${options.limit}`
+    ]
+        .filter((line) => line.length > 0)
+        .join("\n");
+}
+export function normalizeHunterEmailInputRows(rows) {
+    return rows.map((row) => ({
+        clientId: parseNullableInt(row.clientId) ?? 0,
+        contactId: parseNullableInt(row.contactId) ?? 0,
+        companyId: parseNullableInt(row.companyId),
+        firstName: requireTrimmedString(row, "firstName_cleaned"),
+        lastName: requireTrimmedString(row, "lastName_cleaned"),
+        domain: requireTrimmedString(row, "domain")
+    }));
+}
+function normalizeHunterErrorCode(payload) {
+    const errors = Array.isArray(payload?.errors) ? payload.errors : [];
+    const firstError = (errors[0] ?? null);
+    const code = String(firstError?.code ?? payload?.code ?? "").trim();
+    if (code.length > 0) {
+        return code.toLowerCase();
+    }
+    const message = String(firstError?.details ?? payload?.message ?? "").trim();
+    return message.length > 0 ? message.toLowerCase().replace(/\s+/g, "_") : null;
+}
+export async function lookupHunterEmail(input, options) {
+    const fetchImpl = options.fetchImpl ?? fetch;
+    const baseUrl = options.baseUrl ?? DEFAULT_HUNTER_API_BASE_URL;
+    const timeoutMs = options.timeoutMs ?? DEFAULT_HUNTER_REQUEST_TIMEOUT_MS;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), timeoutMs);
+    const ts = new Date().toISOString();
+    try {
+        const url = new URL("/email-finder", baseUrl);
+        url.searchParams.set("api_key", options.apiKey);
+        url.searchParams.set("first_name", input.firstName);
+        url.searchParams.set("last_name", input.lastName);
+        url.searchParams.set("domain", input.domain);
+        url.searchParams.set("max_duration", "20");
+        const response = await fetchImpl(url, {
+            method: "GET",
+            signal: controller.signal
+        });
+        const payload = (await response.json().catch(() => null));
+        if (response.status === 429) {
+            throw new HunterRateLimitError();
+        }
+        if (!response.ok) {
+            return {
+                clientId: input.clientId,
+                contactId: input.contactId,
+                companyId: input.companyId,
+                firstName: input.firstName,
+                lastName: input.lastName,
+                domain: input.domain,
+                email: null,
+                score: null,
+                acceptAll: null,
+                error: normalizeHunterErrorCode(payload) ?? `http_${response.status}`,
+                ts
+            };
+        }
+        const data = (payload?.data ?? null);
+        const email = String(data?.email ?? "").trim() || null;
+        const scoreValue = data?.score;
+        const acceptAllValue = data?.accept_all;
+        return {
+            clientId: input.clientId,
+            contactId: input.contactId,
+            companyId: input.companyId,
+            firstName: String(data?.first_name ?? input.firstName).trim() || input.firstName,
+            lastName: String(data?.last_name ?? input.lastName).trim() || input.lastName,
+            domain: String(data?.domain ?? input.domain).trim() || input.domain,
+            email,
+            score: typeof scoreValue === "number" ? scoreValue : scoreValue == null ? null : Number(scoreValue),
+            acceptAll: typeof acceptAllValue === "boolean" ? acceptAllValue : null,
+            error: null,
+            ts
+        };
+    }
+    catch (error) {
+        if (error instanceof HunterRateLimitError) {
+            throw error;
+        }
+        if (error instanceof Error && error.name === "AbortError") {
+            return {
+                clientId: input.clientId,
+                contactId: input.contactId,
+                companyId: input.companyId,
+                firstName: input.firstName,
+                lastName: input.lastName,
+                domain: input.domain,
+                email: null,
+                score: null,
+                acceptAll: null,
+                error: "timeout",
+                ts
+            };
+        }
+        return {
+            clientId: input.clientId,
+            contactId: input.contactId,
+            companyId: input.companyId,
+            firstName: input.firstName,
+            lastName: input.lastName,
+            domain: input.domain,
+            email: null,
+            score: null,
+            acceptAll: null,
+            error: error instanceof Error ? error.message : String(error),
+            ts
+        };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export function buildHunterEmailFinderWritebackSql(rows, options = {}) {
+    if (rows.length === 0) {
+        throw new Error("No Hunter email result rows to write");
+    }
+    const table = options.table ?? DEFAULT_HUNTER_OUTPUT_TABLE;
+    const values = rows
+        .map((row) => `(${sqlNumberLiteral(row.clientId)}, ${sqlNumberLiteral(row.contactId)}, ${sqlStringLiteral(row.firstName)}, ${sqlStringLiteral(row.lastName)}, ${sqlStringLiteral(row.domain)}, ${sqlStringLiteral(row.email)}, ${sqlNumberLiteral(row.score)}, ${sqlBooleanLiteral(row.acceptAll)}, ${sqlStringLiteral(row.error)}, TIMESTAMP(${sqlStringLiteral(row.ts)}))`)
+        .join(",\n  ");
+    return [
+        `INSERT INTO \`${table}\``,
+        "  (clientId, contactId, firstName, lastName, domain, email, score, accept_all, error, ts)",
+        "VALUES",
+        `  ${values};`
+    ].join("\n");
+}
+export function summarizeHunterEmailResults(rows) {
+    return rows.reduce((summary, row) => {
+        summary.processed += 1;
+        if (row.email) {
+            summary.found += 1;
+        }
+        else if (row.error == null) {
+            summary.notFound += 1;
+        }
+        else {
+            summary.failed += 1;
+        }
+        return summary;
+    }, {
+        fetched: rows.length,
+        processed: 0,
+        found: 0,
+        notFound: 0,
+        failed: 0
+    });
+}
+export function getHunterRateLimitDelayMs() {
+    return Math.ceil((60 / DEFAULT_HUNTER_RATE_LIMIT_PER_MINUTE) * 1000 + 50);
+}