@konfeature/ap-email-guessr 0.1.0 → 0.1.1

package/{dist/src → src}/lib/common/providers/o365.js

@@ -25,6 +25,7 @@ exports.isMicrosoftConsumerDomain = isMicrosoftConsumerDomain;
 exports.interpretIfExists = interpretIfExists;
 exports.getUserRealm = getUserRealm;
 exports.checkO365Account = checkO365Account;
+const tslib_1 = require("tslib");
 const http_1 = require("../http");
 exports.O365_UNCHECKED = {
     checked: false,
@@ -76,55 +77,60 @@ function interpretIfExists(code) {
     return null;
 }
 /** Classify a domain's Microsoft namespace. Returns null on any failure. */
-async function getUserRealm(domain, timeoutMs) {
-    const login = encodeURIComponent(`probe@${domain}`);
-    try {
-        const res = await (0, http_1.httpRequest)({
-            url: `https://login.microsoftonline.com/getuserrealm.srf?login=${login}&json=1`,
-            method: "GET",
-            timeoutMs,
-        });
-        if (res.status !== 200) {
+function getUserRealm(domain, timeoutMs) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        const login = encodeURIComponent(`probe@${domain}`);
+        try {
+            const res = yield (0, http_1.httpRequest)({
+                url: `https://login.microsoftonline.com/getuserrealm.srf?login=${login}&json=1`,
+                method: "GET",
+                timeoutMs,
+            });
+            if (res.status !== 200) {
+                return null;
+            }
+            const data = JSON.parse(res.body);
+            const ns = data.NameSpaceType;
+            if (ns === "Managed" || ns === "Federated" || ns === "Unknown") {
+                return ns;
+            }
             return null;
         }
-        const data = JSON.parse(res.body);
-        const ns = data.NameSpaceType;
-        if (ns === "Managed" || ns === "Federated" || ns === "Unknown") {
-            return ns;
+        catch (_a) {
+            return null;
         }
-        return null;
-    }
-    catch {
-        return null;
-    }
+    });
 }
 /** Query GetCredentialType for a single address. Returns null code on failure. */
-async function probeCredentialType(email, timeoutMs) {
-    try {
-        const res = await (0, http_1.httpRequest)({
-            url: "https://login.microsoftonline.com/common/GetCredentialType?mkt=en-US",
-            method: "POST",
-            headers: { "Content-Type": "application/json; charset=UTF-8" },
-            body: JSON.stringify({
-                Username: email,
-                isOtherIdpSupported: true,
-            }),
-            timeoutMs,
-        });
-        if (res.status !== 200) {
+function probeCredentialType(email, timeoutMs) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        var _a;
+        try {
+            const res = yield (0, http_1.httpRequest)({
+                url: "https://login.microsoftonline.com/common/GetCredentialType?mkt=en-US",
+                method: "POST",
+                headers: { "Content-Type": "application/json; charset=UTF-8" },
+                body: JSON.stringify({
+                    Username: email,
+                    isOtherIdpSupported: true,
+                }),
+                timeoutMs,
+            });
+            if (res.status !== 200) {
+                return { ifExistsResult: null, throttled: false };
+            }
+            const data = JSON.parse(res.body);
+            return {
+                ifExistsResult: typeof data.IfExistsResult === "number"
+                    ? data.IfExistsResult
+                    : null,
+                throttled: ((_a = data.ThrottleStatus) !== null && _a !== void 0 ? _a : 0) !== 0,
+            };
+        }
+        catch (_b) {
             return { ifExistsResult: null, throttled: false };
         }
-        const data = JSON.parse(res.body);
-        return {
-            ifExistsResult: typeof data.IfExistsResult === "number"
-                ? data.IfExistsResult
-                : null,
-            throttled: (data.ThrottleStatus ?? 0) !== 0,
-        };
-    }
-    catch {
-        return { ifExistsResult: null, throttled: false };
-    }
+    });
 }
 /**
  * Run the account-existence check for one email, given a pre-resolved namespace
@@ -132,40 +138,42 @@ async function probeCredentialType(email, timeoutMs) {
  * be Microsoft-backed (Managed namespace, Microsoft MX, or a consumer domain);
  * otherwise GetCredentialType returns noise for unrelated domains.
  */
-async function checkO365Account(email, namespace, applicable, timeoutMs) {
-    if (!applicable) {
-        return { ...exports.O365_UNCHECKED, namespace, reason: "not_microsoft_domain" };
-    }
-    const probe = await probeCredentialType(email, timeoutMs);
-    if (probe.throttled) {
+function checkO365Account(email, namespace, applicable, timeoutMs) {
+    return tslib_1.__awaiter(this, void 0, void 0, function* () {
+        if (!applicable) {
+            return Object.assign(Object.assign({}, exports.O365_UNCHECKED), { namespace, reason: "not_microsoft_domain" });
+        }
+        const probe = yield probeCredentialType(email, timeoutMs);
+        if (probe.throttled) {
+            return {
+                checked: false,
+                exists: null,
+                namespace,
+                ifExistsResult: probe.ifExistsResult,
+                reason: "throttled",
+            };
+        }
+        if (probe.ifExistsResult === null) {
+            return {
+                checked: false,
+                exists: null,
+                namespace,
+                ifExistsResult: null,
+                reason: "no_result",
+            };
+        }
+        const exists = interpretIfExists(probe.ifExistsResult);
         return {
-            checked: false,
-            exists: null,
+            checked: exists !== null,
+            exists,
             namespace,
             ifExistsResult: probe.ifExistsResult,
-            reason: "throttled",
-        };
-    }
-    if (probe.ifExistsResult === null) {
-        return {
-            checked: false,
-            exists: null,
-            namespace,
-            ifExistsResult: null,
-            reason: "no_result",
+            reason: exists === true
+                ? "account_exists"
+                : exists === false
+                    ? "account_not_found"
+                    : "inconclusive",
         };
-    }
-    const exists = interpretIfExists(probe.ifExistsResult);
-    return {
-        checked: exists !== null,
-        exists,
-        namespace,
-        ifExistsResult: probe.ifExistsResult,
-        reason: exists === true
-            ? "account_exists"
-            : exists === false
-                ? "account_not_found"
-                : "inconclusive",
-    };
+    });
 }
 //# sourceMappingURL=o365.js.map

package/src/lib/common/providers/o365.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"o365.js","sourceRoot":"","sources":["../../../../../src/lib/common/providers/o365.ts"],"names":[],"mappings":"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"}

package/src/lib/common/verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../../../src/lib/common/verifier.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;IACvB,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACjD"}

package/src/lib/common/verifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.js","sourceRoot":"","sources":["../../../../src/lib/common/verifier.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/src/lib/common/verifiers/no2bounce-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no2bounce-verifier.d.ts","sourceRoot":"","sources":["../../../../../src/lib/common/verifiers/no2bounce-verifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAiB,aAAa,EAAE,MAAM,aAAa,CAAC;AAI1E,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,UAAU,UAAU;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,aAAa,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACrB;AAKD,wBAAgB,YAAY,CAAC,CAAC,EAAE,UAAU,GAAG,aAAa,CAiBzD;AAaD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CAiF3E"}

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

@@ -0,0 +1,135 @@
+"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 tslib_1 = require("tslib");
+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) {
+    var _a, _b, _c, _d, _e;
+    if (((_a = r.Deliverable) !== null && _a !== void 0 ? _a : 0) >= 1) {
+        return { verdict: "valid", catchAll: false };
+    }
+    if (((_b = r["Deliverable/AcceptAll"]) !== null && _b !== void 0 ? _b : 0) >= 1) {
+        return { verdict: "valid", catchAll: true };
+    }
+    if (((_c = r["Risky/AcceptAll"]) !== null && _c !== void 0 ? _c : 0) >= 1) {
+        return { verdict: "catch_all", catchAll: true };
+    }
+    if (((_d = r.Undeliverable) !== null && _d !== void 0 ? _d : 0) >= 1) {
+        return { verdict: "invalid", catchAll: false };
+    }
+    if (((_e = r["UnDeliverable/AcceptAll"]) !== null && _e !== void 0 ? _e : 0) >= 1) {
+        return { verdict: "invalid", catchAll: true };
+    }
+    return { verdict: "unknown", catchAll: false };
+}
+function isComplete(r) {
+    var _a, _b;
+    return (String((_a = r.overallStatus) !== null && _a !== void 0 ? _a : "")
+        .toLowerCase()
+        .startsWith("complet") || ((_b = r.percent) !== null && _b !== void 0 ? _b : 0) >= 100);
+}
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+function createNo2BounceVerifier(options) {
+    var _a, _b;
+    const pollIntervalMs = (_a = options.pollIntervalMs) !== null && _a !== void 0 ? _a : 2000;
+    const maxWaitMs = (_b = options.maxWaitMs) !== null && _b !== void 0 ? _b : 30000;
+    const authHeader = { apitoken: options.apitoken };
+    function submit(email) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c;
+            const res = yield (0, http_1.httpRequest)({
+                url: ENDPOINT,
+                method: "POST",
+                headers: Object.assign(Object.assign({}, 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 = (_b = (_a = json.data) === null || _a === void 0 ? void 0 : _a.trackingId) !== null && _b !== void 0 ? _b : (_c = json.data) === null || _c === void 0 ? void 0 : _c.taskId;
+            return id === undefined ? undefined : String(id);
+        });
+    }
+    function poll(trackingId) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const url = `${ENDPOINT}?trackingId=${encodeURIComponent(trackingId)}`;
+            const deadline = Date.now() + maxWaitMs;
+            while (Date.now() < deadline) {
+                yield sleep(pollIntervalMs);
+                try {
+                    const res = yield (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 (_a) {
+                    // Transient poll error; keep trying until the deadline.
+                }
+            }
+            return null;
+        });
+    }
+    return {
+        name: "no2bounce",
+        verify(email) {
+            return tslib_1.__awaiter(this, void 0, void 0, function* () {
+                var _a;
+                let trackingId;
+                try {
+                    trackingId = yield 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 = yield poll(trackingId);
+                if (!parsed) {
+                    return { email, verdict: "unknown", creditsUsed: 1, reason: "poll_timeout" };
+                }
+                const { verdict, catchAll } = decodeSingle(parsed);
+                return {
+                    email,
+                    verdict,
+                    catchAll,
+                    creditsUsed: (_a = parsed.creditDebited) !== null && _a !== void 0 ? _a : 1,
+                    reason: `n2b_${verdict}${catchAll ? "_acceptall" : ""}`,
+                    raw: parsed,
+                };
+            });
+        },
+    };
+}
+//# sourceMappingURL=no2bounce-verifier.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"no2bounce-verifier.js","sourceRoot":"","sources":["../../../../../src/lib/common/verifiers/no2bounce-verifier.ts"],"names":[],"mappings":"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"}

package/src/lib/common/verifiers/o365-verifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o365-verifier.d.ts","sourceRoot":"","sources":["../../../../../src/lib/common/verifiers/o365-verifier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAoB,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,aAAa,CAAC;AAE3D,wBAAgB,kBAAkB,CAC9B,SAAS,EAAE,aAAa,EACxB,UAAU,EAAE,OAAO,EACnB,SAAS,EAAE,MAAM,GAClB,QAAQ,CAyBV"}

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

@@ -0,0 +1,33 @@
+"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 tslib_1 = require("tslib");
+const o365_1 = require("../providers/o365");
+function createO365Verifier(namespace, applicable, timeoutMs) {
+    return {
+        name: "o365",
+        verify(email) {
+            return tslib_1.__awaiter(this, void 0, void 0, function* () {
+                const result = yield (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

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

@@ -0,0 +1 @@
+{"version":3,"file":"o365-verifier.js","sourceRoot":"","sources":["../../../../../src/lib/common/verifiers/o365-verifier.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAKH,gDA6BC;;AAhCD,4CAAyE;AAGzE,SAAgB,kBAAkB,CAC9B,SAAwB,EACxB,UAAmB,EACnB,SAAiB;IAEjB,OAAO;QACH,IAAI,EAAE,MAAM;QACN,MAAM,CAAC,KAAa;;gBACtB,MAAM,MAAM,GAAG,MAAM,IAAA,uBAAgB,EACjC,KAAK,EACL,SAAS,EACT,UAAU,EACV,SAAS,CACZ,CAAC;gBACF,MAAM,OAAO,GACT,MAAM,CAAC,MAAM,KAAK,IAAI;oBAClB,CAAC,CAAC,OAAO;oBACT,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK;wBACvB,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC,SAAS,CAAC;gBACtB,OAAO;oBACH,KAAK;oBACL,OAAO;oBACP,WAAW,EAAE,CAAC;oBACd,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,GAAG,EAAE,MAAM;iBACd,CAAC;YACN,CAAC;SAAA;KACJ,CAAC;AACN,CAAC"}

package/README.md

@@ -1,128 +0,0 @@
-# ap-email-guessr
-
-An [Activepieces](https://www.activepieces.com) community piece that finds a person's email
-address from their name and company domain. It ships two actions:
-
-| Action | What it does |
-| --- | --- |
-| **Generate Email List** | Builds likely addresses from a first name, last name and domain, ordered by real-world corporate naming frequency (`john.doe@`, `jdoe@`, `john@`, ...). |
-| **Find Email** | Generates the candidates, then verifies them top-down — stopping at the first hit or on a catch-all domain — routing Microsoft domains through a free O365 check and everything else through [no2bounce](https://www.no2bounce.com). Returns the found address, a verdict and the credits spent. |
-
-## Setup
-
-The piece auth is an optional **no2bounce API Token** (Settings → API in no2bounce). It is only
-needed to verify **non-Microsoft** domains; Microsoft-backed domains are verified for free via the
-O365 account check, so the token can be left empty if you only target those.
-
-## Actions
-
-### Generate Email List
-
-Inputs: `firstName`, `lastName`, `domain`, plus optional `patternSet` (`common` ≈ 10 patterns /
-`all` ≈ 20, default `all`) and `maxVariants` (hard cap).
-
-Output — candidates ordered most-likely first:
-
-```json
-{ "emails": ["john.doe@example.com", "jdoe@example.com", "john@example.com"], "count": 3 }
-```
-
-Names are normalized (accents stripped, lowercased, non-alphanumerics removed) and the domain is
-cleaned of protocol/path/leading `@`.
-
-### Find Email
-
-Inputs:
-
-- `firstName`, `lastName`, `domain` (required).
-- `patternSet` (optional, default `common`) — `common` checks only the ~10 highest-probability
-  patterns; `all` considers the full ~20.
-- `maxChecks` (optional) — hard ceiling on how many candidates are verified before giving up. This
-  is the per-person credit cap.
-- `useO365` (optional, default `true`) — verify Microsoft-backed domains with the free Azure AD
-  account check instead of spending no2bounce credits.
-- `timeout` (optional, default `15`) — per-request timeout in seconds.
-
-Output:
-
-```json
-{
-    "found": true,
-    "email": "jessie.han@cupshe.com",
-    "status": "valid",
-    "confidence": 0.9,
-    "catchAll": false,
-    "domain": "cupshe.com",
-    "mxProvider": "microsoft",
-    "verifier": "o365",
-    "reason": "o365_valid",
-    "creditsUsed": 0,
-    "candidatesChecked": 1,
-    "candidatesConsidered": 10,
-    "attempts": [{ "email": "jessie.han@cupshe.com", "verdict": "valid", "reason": "account_exists" }]
-}
-```
-
-## How verification works
-
-**Routing.** Per domain the piece resolves MX and fingerprints the provider:
-
-- **Microsoft-backed** (Microsoft/consumer MX, or a `Managed` Azure AD realm on a domain that is
-  *not* a known non-Microsoft mailbox host) → the **free O365 check** (`GetCredentialType`). No port
-  25, no credits. The "Managed realm on a Google/Zoho domain" case is deliberately excluded — that
-  is a leftover tenant, not Microsoft mail, and trusting it produces false negatives.
-- **Everything else** → **no2bounce**. no2bounce is async: submit a 1-email batch to get a
-  `trackingId` (under `data`), then poll `?trackingId=` until the top-level `overallStatus` is
-  `Completed`. For a single email the top-level counts — `Deliverable`, `Undeliverable`,
-  `Deliverable/AcceptAll`, `UnDeliverable/AcceptAll`, `Risky/AcceptAll` — are that email's verdict.
-
-**Credit minimization.** Candidates are verified in likelihood order and the search:
-
-1. **uses no2bounce's per-address catch-all scoring** — on an accept-all domain a predicted-deliverable
-   address counts as a hit (with reduced confidence), a predicted-undeliverable one is skipped, and a
-   genuinely `Risky/AcceptAll` result stops the search;
-2. **verifies non-Microsoft candidates in concurrent rounds of 5 and stops at the first round with a
-   hit** (early-stop) — checking 5 at a time is faster than one-by-one, but since no2bounce bills per
-   email with no refund a round is paid for in full once submitted (a hit at candidate #3 still costs
-   the first round of 5), so the search stops as soon as a round yields a valid address or a catch-all
-   rather than walking the whole list;
-3. uses the **`common` pattern set** by default, capping the not-found tail at ~10 instead of ~20.
-
-no2bounce bills **1 credit per verified email**; the O365 path is **0 credits**. The actual spend is
-returned as `creditsUsed`.
-
-## Verdicts
-
-| `status` | Meaning |
-| --- | --- |
-| `valid` | The mailbox exists (`found: true`, with `email`). |
-| `invalid` | No candidate verified, or null MX / no MX. |
-| `catch_all` | Domain accepts everything — the specific address can't be confirmed. |
-| `unknown` | Verification was inconclusive (e.g. no2bounce token missing, poll timeout, O365 throttled). |
-
-> **Note.** The no2bounce wire format above is confirmed against the live API (the published docs were
-> out of date). The O365 (`login.microsoftonline.com`) check and DNS use only Node built-ins; the only
-> external dependency is the no2bounce HTTP API.
-
-## Build
-
-```sh
-npm install   # or: bun install
-npm run build # tsc -> dist/
-```
-
-The compiled entry point is `dist/src/index.js` (referenced by `main` in `package.json`).
-
-## Publish & install in self-hosted Activepieces
-
-1. Set a unique package name in `package.json` if `ap-email-guessr` is taken on npm, then publish:
-
-    ```sh
-    npm publish --access public
-    ```
-
-2. In your self-hosted Activepieces instance, add the piece from npm
-   (**Platform Admin → Pieces → Install**, or set `AP_DEV_PIECES` when developing) using the
-   published package name and version.
-
-See the Activepieces docs for details: <https://www.activepieces.com/docs/build-pieces/building-pieces/piece-definition>

package/dist/src/lib/common/dns.js

@@ -1,37 +0,0 @@
-"use strict";
-/**
- * Domain mail-routing resolution (DNS only, Node built-ins).
- *
- * Used by the verifier router to fingerprint the provider and detect domains
- * that cannot receive mail (no MX, or an explicit RFC 7505 null MX).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveMail = resolveMail;
-const node_dns_1 = require("node:dns");
-async function resolveMail(domain) {
-    try {
-        const records = await node_dns_1.promises.resolveMx(domain);
-        const real = records.filter((record) => record.exchange && record.exchange !== ".");
-        // Records exist but every exchange is empty/"." → explicit null MX.
-        if (records.length > 0 && real.length === 0) {
-            return { hosts: [], nullMx: true };
-        }
-        if (real.length > 0) {
-            const hosts = real
-                .sort((a, b) => a.priority - b.priority)
-                .map((record) => record.exchange);
-            return { hosts, nullMx: false };
-        }
-    }
-    catch {
-        // No MX records; fall back to the implicit-MX (A/AAAA) lookup below.
-    }
-    try {
-        await node_dns_1.promises.lookup(domain);
-        return { hosts: [domain], nullMx: false };
-    }
-    catch {
-        return { hosts: [], nullMx: false };
-    }
-}
-//# sourceMappingURL=dns.js.map

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

@@ -1,78 +0,0 @@
-"use strict";
-/**
- * Credit-minimizing email search (layers 1 + 2).
- *
- * Candidates arrive pre-ordered by likelihood and are verified top-down in
- * rounds of `batchSize` (1 = strictly sequential). Each completed round is read
- * back in candidate order, so the verdict is identical to checking one at a time:
- *  - stop at the first `valid` hit (layer 2: early-stop), and
- *  - stop immediately on a `catch_all` verdict, since a catch-all domain the
- *    verifier can't score further can't disambiguate individual mailboxes —
- *    continuing would just burn credits for no extra signal (layer 1).
- *
- * no2bounce bills per email with no refund, so a round is paid for the moment it
- * is submitted: `creditsUsed` counts every email in the rounds we started, even
- * when an early candidate in the final round is the hit. A larger `batchSize` is
- * thus faster (fewer submit/poll cycles) but coarser on credits. `maxChecks` is a
- * hard ceiling; a `valid` hit on an accept-all domain is reported with reduced
- * confidence and `catchAll: true`.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.findEmail = findEmail;
-const CONFIDENCE = {
-    valid: 0.9,
-    catch_all: 0.5,
-    invalid: 0.05,
-    unknown: 0.5,
-};
-function result(found, email, verdict, catchAll, attempts, creditsUsed) {
-    // An accept-all "hit" is probabilistic, so trust it less than a clean one.
-    const confidence = verdict === "valid" && catchAll ? 0.6 : CONFIDENCE[verdict];
-    return {
-        found,
-        email,
-        verdict,
-        confidence,
-        catchAll,
-        candidatesChecked: attempts.length,
-        creditsUsed,
-        attempts,
-    };
-}
-async function findEmail(candidates, verifier, options = {}) {
-    const stopOnFirstHit = options.stopOnFirstHit ?? true;
-    const batchSize = Math.max(1, options.batchSize ?? 1);
-    const limit = Math.min(options.maxChecks ?? candidates.length, candidates.length);
-    const attempts = [];
-    let creditsUsed = 0;
-    let firstValid = null;
-    for (let start = 0; start < limit; start += batchSize) {
-        const round = candidates.slice(start, Math.min(start + batchSize, limit));
-        const outcomes = await Promise.all(round.map((email) => verifier.verify(email)));
-        // The whole round is billed on submit (no2bounce charges per email with
-        // no refund), so count every result before deciding the verdict.
-        for (const outcome of outcomes) {
-            attempts.push(outcome);
-            creditsUsed += outcome.creditsUsed;
-        }
-        for (const outcome of outcomes) {
-            if (outcome.verdict === "catch_all") {
-                return result(false, null, "catch_all", true, attempts, creditsUsed);
-            }
-            if (outcome.verdict === "valid") {
-                if (!firstValid) {
-                    firstValid = outcome;
-                }
-                if (stopOnFirstHit) {
-                    return result(true, outcome.email, "valid", outcome.catchAll ?? false, attempts, creditsUsed);
-                }
-            }
-        }
-    }
-    if (firstValid) {
-        return result(true, firstValid.email, "valid", firstValid.catchAll ?? false, attempts, creditsUsed);
-    }
-    const sawUnknown = attempts.some((a) => a.verdict === "unknown");
-    return result(false, null, sawUnknown ? "unknown" : "invalid", attempts.some((a) => a.catchAll === true), attempts, creditsUsed);
-}
-//# sourceMappingURL=find-email.js.map