@konfeature/ap-email-guessr 0.1.0

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

@@ -0,0 +1,123 @@
+"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.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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.
+ */
+import { type O365Namespace } from "../providers/o365";
+import type { Verifier } from "../verifier";
+export declare function createO365Verifier(namespace: O365Namespace, applicable: boolean, timeoutMs: number): Verifier;
+//# sourceMappingURL=o365-verifier.d.ts.map

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

@@ -0,0 +1,30 @@
+"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

package/package.json

@@ -0,0 +1,42 @@
+{
+    "name": "@konfeature/ap-email-guessr",
+    "version": "0.1.0",
+    "description": "Activepieces piece that finds a person's email from their name and company domain — free Microsoft 365 account checks plus no2bounce verification, with early-stop to minimize credits.",
+    "type": "commonjs",
+    "main": "./dist/src/index.js",
+    "types": "./dist/src/index.d.ts",
+    "files": ["dist/src/**/*.js", "dist/src/**/*.d.ts", "README.md"],
+    "license": "MIT",
+    "author": "KONFeature",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/KONFeature/ap-email-guessr.git"
+    },
+    "homepage": "https://github.com/KONFeature/ap-email-guessr#readme",
+    "bugs": {
+        "url": "https://github.com/KONFeature/ap-email-guessr/issues"
+    },
+    "keywords": [
+        "activepieces",
+        "activepieces-piece",
+        "email",
+        "email-finder",
+        "email-verification",
+        "no2bounce",
+        "office365"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "build": "tsc -p tsconfig.json",
+        "prepublishOnly": "npm run build"
+    },
+    "dependencies": {
+        "@activepieces/pieces-framework": "0.30.0"
+    },
+    "devDependencies": {
+        "@types/node": "^20.19.0",
+        "typescript": "^5.7.3"
+    }
+}