@konfeature/ap-email-guessr 0.1.0 → 0.1.1

package/dist/src/lib/common/find-person.js

@@ -1,102 +0,0 @@
-"use strict";
-/**
- * Per-person email finder: generate ordered candidates, pick the right verifier
- * for the domain, then run the credit-minimizing early-stop search.
- *
- * Routing: use the free O365 account check when mail genuinely routes through
- * Microsoft (Microsoft/consumer MX, or a "Managed" realm on a domain that is not
- * a known non-Microsoft mailbox host). Everything else goes to no2bounce. The
- * "Managed realm but Google/Zoho MX" exclusion is the louyetu.fr false-negative
- * fix: a leftover Azure AD tenant must not be trusted as Microsoft mail.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.findPersonEmail = findPersonEmail;
-const dns_1 = require("./dns");
-const find_email_1 = require("./find-email");
-const mx_fingerprint_1 = require("./mx-fingerprint");
-const o365_1 = require("./providers/o365");
-const patterns_1 = require("./patterns");
-const no2bounce_verifier_1 = require("./verifiers/no2bounce-verifier");
-const o365_verifier_1 = require("./verifiers/o365-verifier");
-const NO2BOUNCE_BATCH_SIZE = 5;
-function earlyExit(candidatesConsidered, domain, mxProvider, verdict, confidence, reason) {
-    return {
-        found: false,
-        email: null,
-        verdict,
-        confidence,
-        catchAll: false,
-        candidatesChecked: 0,
-        creditsUsed: 0,
-        attempts: [],
-        reason,
-        domain,
-        mxProvider,
-        verifierUsed: "none",
-        candidatesConsidered,
-    };
-}
-async function findPersonEmail(firstName, lastName, domain, options) {
-    const candidates = (0, patterns_1.generateEmailCandidates)({
-        firstName,
-        lastName,
-        domain,
-        patternSet: options.patternSet,
-        maxVariants: options.maxVariants,
-    });
-    const cleanDomain = (0, patterns_1.normalizeDomain)(domain);
-    if (candidates.length === 0) {
-        return earlyExit(0, cleanDomain, "none", "invalid", 0.03, "no_candidates");
-    }
-    const routing = await (0, dns_1.resolveMail)(cleanDomain);
-    const provider = (0, mx_fingerprint_1.fingerprintMx)(routing.hosts);
-    if (routing.nullMx) {
-        return earlyExit(candidates.length, cleanDomain, provider.id, "invalid", 0.02, "null_mx");
-    }
-    if (routing.hosts.length === 0) {
-        return earlyExit(candidates.length, cleanDomain, provider.id, "invalid", 0.03, "no_mx_record");
-    }
-    const consumer = (0, o365_1.isMicrosoftConsumerDomain)(cleanDomain);
-    let namespace = null;
-    let microsoftBacked = consumer || provider.microsoftBacked;
-    // Only spend a realm lookup on ambiguous MX (not obviously Microsoft, not a
-    // known foreign mailbox host) — that's where O365-behind-a-gateway hides.
-    if (options.useO365 &&
-        !microsoftBacked &&
-        !(0, mx_fingerprint_1.hostsNonMicrosoftMailboxes)(provider)) {
-        namespace = await (0, o365_1.getUserRealm)(cleanDomain, options.timeoutMs);
-        if (namespace === "Managed") {
-            microsoftBacked = true;
-        }
-    }
-    let verifier;
-    let verifierUsed;
-    if (options.useO365 && microsoftBacked) {
-        verifier = (0, o365_verifier_1.createO365Verifier)(namespace ?? "Managed", true, options.timeoutMs);
-        verifierUsed = "o365";
-    }
-    else if (options.no2bounceToken) {
-        verifier = (0, no2bounce_verifier_1.createNo2BounceVerifier)({
-            apitoken: options.no2bounceToken,
-            timeoutMs: options.timeoutMs,
-        });
-        verifierUsed = "no2bounce";
-    }
-    else {
-        return earlyExit(candidates.length, cleanDomain, provider.id, "unknown", 0.5, "no2bounce_token_required");
-    }
-    const result = await (0, find_email_1.findEmail)(candidates, verifier, {
-        maxChecks: options.maxChecks,
-        stopOnFirstHit: options.stopOnFirstHit,
-        batchSize: verifierUsed === "no2bounce" ? NO2BOUNCE_BATCH_SIZE : 1,
-    });
-    return {
-        ...result,
-        reason: `${verifierUsed}_${result.verdict}`,
-        domain: cleanDomain,
-        mxProvider: provider.id,
-        verifierUsed,
-        candidatesConsidered: candidates.length,
-    };
-}
-//# sourceMappingURL=find-person.js.map

package/dist/src/lib/common/verifiers/no2bounce-verifier.js

@@ -1,123 +0,0 @@
-"use strict";
-/**
- * Verifier adapter for the no2bounce API (wire format confirmed against the
- * live API).
- *
- * Async flow: POST a 1-email batch to get a `trackingId` (under `data`), then
- * GET-poll `?trackingId=` until the *top-level* `overallStatus` is "Completed".
- * For a single email the top-level count fields are that email's verdict.
- * Billing is 1 credit per email (`creditDebited`), with no refund on undeliverable.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.decodeSingle = decodeSingle;
-exports.createNo2BounceVerifier = createNo2BounceVerifier;
-const http_1 = require("../http");
-const ENDPOINT = "https://connect.no2bounce.com/v2/n2b_validate_bulk";
-// no2bounce risk-scores accept-all domains per address: "Deliverable/AcceptAll"
-// is a predicted hit, "UnDeliverable/AcceptAll" a predicted miss, and
-// "Risky/AcceptAll" genuinely uncertain (so we stop on it).
-function decodeSingle(r) {
-    if ((r.Deliverable ?? 0) >= 1) {
-        return { verdict: "valid", catchAll: false };
-    }
-    if ((r["Deliverable/AcceptAll"] ?? 0) >= 1) {
-        return { verdict: "valid", catchAll: true };
-    }
-    if ((r["Risky/AcceptAll"] ?? 0) >= 1) {
-        return { verdict: "catch_all", catchAll: true };
-    }
-    if ((r.Undeliverable ?? 0) >= 1) {
-        return { verdict: "invalid", catchAll: false };
-    }
-    if ((r["UnDeliverable/AcceptAll"] ?? 0) >= 1) {
-        return { verdict: "invalid", catchAll: true };
-    }
-    return { verdict: "unknown", catchAll: false };
-}
-function isComplete(r) {
-    return (String(r.overallStatus ?? "")
-        .toLowerCase()
-        .startsWith("complet") || (r.percent ?? 0) >= 100);
-}
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-function createNo2BounceVerifier(options) {
-    const pollIntervalMs = options.pollIntervalMs ?? 2000;
-    const maxWaitMs = options.maxWaitMs ?? 30000;
-    const authHeader = { apitoken: options.apitoken };
-    async function submit(email) {
-        const res = await (0, http_1.httpRequest)({
-            url: ENDPOINT,
-            method: "POST",
-            headers: { ...authHeader, "Content-Type": "application/json" },
-            body: JSON.stringify({ emailList: [email] }),
-            timeoutMs: options.timeoutMs,
-        });
-        if (res.status !== 200) {
-            throw new Error(`submit_${res.status}`);
-        }
-        const json = JSON.parse(res.body);
-        const id = json.data?.trackingId ?? json.data?.taskId;
-        return id === undefined ? undefined : String(id);
-    }
-    async function poll(trackingId) {
-        const url = `${ENDPOINT}?trackingId=${encodeURIComponent(trackingId)}`;
-        const deadline = Date.now() + maxWaitMs;
-        while (Date.now() < deadline) {
-            await sleep(pollIntervalMs);
-            try {
-                const res = await (0, http_1.httpRequest)({
-                    url,
-                    method: "GET",
-                    headers: authHeader,
-                    timeoutMs: options.timeoutMs,
-                });
-                if (res.status !== 200) {
-                    continue;
-                }
-                const parsed = JSON.parse(res.body);
-                if (isComplete(parsed)) {
-                    return parsed;
-                }
-            }
-            catch {
-                // Transient poll error; keep trying until the deadline.
-            }
-        }
-        return null;
-    }
-    return {
-        name: "no2bounce",
-        async verify(email) {
-            let trackingId;
-            try {
-                trackingId = await submit(email);
-            }
-            catch (error) {
-                // Submission rejected → no credit charged.
-                return {
-                    email,
-                    verdict: "unknown",
-                    creditsUsed: 0,
-                    reason: error instanceof Error ? error.message : "submit_failed",
-                };
-            }
-            if (!trackingId) {
-                return { email, verdict: "unknown", creditsUsed: 0, reason: "no_tracking_id" };
-            }
-            const parsed = await poll(trackingId);
-            if (!parsed) {
-                return { email, verdict: "unknown", creditsUsed: 1, reason: "poll_timeout" };
-            }
-            const { verdict, catchAll } = decodeSingle(parsed);
-            return {
-                email,
-                verdict,
-                catchAll,
-                creditsUsed: parsed.creditDebited ?? 1,
-                reason: `n2b_${verdict}${catchAll ? "_acceptall" : ""}`,
-                raw: parsed,
-            };
-        },
-    };
-}
-//# sourceMappingURL=no2bounce-verifier.js.map

package/dist/src/lib/common/verifiers/o365-verifier.js

@@ -1,30 +0,0 @@
-"use strict";
-/**
- * Verifier adapter for the direct Microsoft 365 account check. Free (no
- * credits): it asks Azure AD whether the account exists over HTTPS, so it never
- * touches port 25 and never spends a no2bounce credit.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createO365Verifier = createO365Verifier;
-const o365_1 = require("../providers/o365");
-function createO365Verifier(namespace, applicable, timeoutMs) {
-    return {
-        name: "o365",
-        async verify(email) {
-            const result = await (0, o365_1.checkO365Account)(email, namespace, applicable, timeoutMs);
-            const verdict = result.exists === true
-                ? "valid"
-                : result.exists === false
-                    ? "invalid"
-                    : "unknown";
-            return {
-                email,
-                verdict,
-                creditsUsed: 0,
-                reason: result.reason,
-                raw: result,
-            };
-        },
-    };
-}
-//# sourceMappingURL=o365-verifier.js.map