lacspace-leads 0.3.0 → 1.3.0

package/dist/lib.cjs

@@ -30,31 +30,42 @@ __export(lib_exports, {
   cleanWebsite: () => cleanWebsite,
   columnsOf: () => columnsOf,
   composeQuery: () => composeQuery,
+  computeStats: () => computeStats,
   convertFile: () => convertFile,
   dedupeLeads: () => dedupeLeads,
   defaultFilename: () => defaultFilename,
   detectFormat: () => detectFormat,
+  emailDomain: () => emailDomain,
+  emailFormatValid: () => emailFormatValid,
   enrichContacts: () => enrichContacts,
   expandQueries: () => expandQueries,
   extractEmails: () => extractEmails,
   extractSocials: () => extractSocials,
   filterLeads: () => filterLeads,
+  haversineMeters: () => haversineMeters,
   mapsSearchUrl: () => mapsSearchUrl,
   normalizeFields: () => normalizeFields,
   normalizePhone: () => normalizePhone,
+  parseDistance: () => parseDistance,
   parseLatLng: () => parseLatLng,
+  parseLatLngPair: () => parseLatLngPair,
   parseRating: () => parseRating,
   parseReviewCount: () => parseReviewCount,
   readRows: () => readRows,
   resolvePreset: () => resolvePreset,
+  rowsToLeads: () => rowsToLeads,
   scrapeLeads: () => scrapeLeads,
   searchLeads: () => scrapeLeads,
   searchLeadsBatch: () => searchLeadsBatch,
+  searchLeadsDetailed: () => searchLeadsDetailed,
   searchLeadsMulti: () => searchLeadsMulti,
   serialize: () => serialize,
   serializeRows: () => serializeRows,
   sortLeads: () => sortLeads,
-  toRows: () => toRows
+  toRows: () => toRows,
+  verifyEmail: () => verifyEmail,
+  verifyEmails: () => verifyEmails,
+  zoomForRadius: () => zoomForRadius
 });
 module.exports = __toCommonJS(lib_exports);
 
@@ -80,12 +91,15 @@ var ALL_FIELDS = [
   "youtube",
   "tiktok",
   "telegram",
+  "emailStatus",
   "plusCode",
   "latitude",
   "longitude",
+  "distanceKm",
   "hours",
   "mapsUrl"
 ];
+var DERIVED_FIELDS = ["distanceKm"];
 var ENRICHED_FIELDS = [
   "email",
   "facebook",
@@ -95,7 +109,8 @@ var ENRICHED_FIELDS = [
   "twitter",
   "youtube",
   "tiktok",
-  "telegram"
+  "telegram",
+  "emailStatus"
 ];
 var FIELD_PRESETS = {
   /** Just enough to place a business: name, phone, website. */
@@ -107,11 +122,13 @@ var FIELD_PRESETS = {
   /** Map/geo columns for plotting. */
   geo: ["name", "address", "latitude", "longitude", "plusCode", "mapsUrl"],
   /** Everything Maps shows, no website enrichment. */
-  full: ALL_FIELDS.filter((f) => !ENRICHED_FIELDS.includes(f)),
+  full: ALL_FIELDS.filter((f) => !ENRICHED_FIELDS.includes(f) && !DERIVED_FIELDS.includes(f)),
   /** Every field, including enriched ones. */
   everything: [...ALL_FIELDS]
 };
-var DEFAULT_FIELDS = ALL_FIELDS.filter((f) => !ENRICHED_FIELDS.includes(f));
+var DEFAULT_FIELDS = ALL_FIELDS.filter(
+  (f) => !ENRICHED_FIELDS.includes(f) && !DERIVED_FIELDS.includes(f)
+);
 
 // src/query.ts
 function composeQuery(opts) {
@@ -125,7 +142,9 @@ function mapsSearchUrl(query, opts = {}) {
   const hl = (opts.hl ?? "en").split("-")[0] || "en";
   const params = new URLSearchParams({ hl });
   if (opts.gl) params.set("gl", opts.gl.toLowerCase());
-  return `https://www.google.com/maps/search/${encodeURIComponent(query)}?${params.toString()}`;
+  const base = `https://www.google.com/maps/search/${encodeURIComponent(query)}`;
+  const at = opts.center ? `/@${opts.center.lat},${opts.center.lng},${Math.round(opts.center.zoom ?? 14)}z` : "";
+  return `${base}${at}?${params.toString()}`;
 }
 function expandQueries(opts) {
   if (opts.query && opts.query.trim()) return [{ query: opts.query.trim() }];
@@ -283,6 +302,7 @@ function filterLeads(leads, filters = {}) {
     if (filters.hasPhone && !l.phone) return false;
     if (filters.hasWebsite && !l.website) return false;
     if (filters.hasEmail && !l.email) return false;
+    if (filters.hasValidEmail && l.emailStatus !== "valid") return false;
     return true;
   });
 }
@@ -290,7 +310,8 @@ function dedupeKey(lead, by) {
   if (by === "none") return void 0;
   if (by === "website") return normalizeHost(lead.website);
   if (by === "phone") return lead.phone?.replace(/[^0-9]/g, "") || void 0;
-  return lead.name?.trim().toLowerCase() || void 0;
+  if (by === "name") return lead.name?.trim().toLowerCase() || void 0;
+  return normalizeHost(lead.website) ?? (lead.phone?.replace(/[^0-9]/g, "") || void 0) ?? (lead.name?.trim().toLowerCase() || void 0);
 }
 function normalizeHost(url) {
   if (!url) return void 0;
@@ -423,12 +444,14 @@ function plausible(digits) {
   return digits.length >= 8 && digits.length <= 15;
 }
 var priceRank = (p) => p ? p.replace(/[^$€£₹¥₩]/g, "").length : 0;
+var ASC_BY_DEFAULT = /* @__PURE__ */ new Set(["name", "distance"]);
 function sortLeads(leads, by, dir) {
   if (!by) return [...leads];
-  const desc = dir ? dir === "desc" : by !== "name";
+  const desc = dir ? dir === "desc" : !ASC_BY_DEFAULT.has(by);
   const val = (l) => {
     if (by === "name") return l.name?.toLowerCase();
     if (by === "priceLevel") return l.priceLevel ? priceRank(l.priceLevel) : void 0;
+    if (by === "distance") return l.distanceKm;
     return l[by];
   };
   return [...leads].map((lead, i) => ({ lead, i })).sort((a, b) => {
@@ -447,6 +470,196 @@ function sortLeads(leads, by, dir) {
   }).map((x) => x.lead);
 }
 
+// src/verify.ts
+var import_promises = require("dns/promises");
+var EMAIL_SHAPE = /^[^\s@]+@([^\s@.]+\.)+[^\s@.]{2,}$/;
+function emailFormatValid(email) {
+  return !!email && EMAIL_SHAPE.test(email.trim());
+}
+function emailDomain(email) {
+  if (!email) return void 0;
+  const at = email.lastIndexOf("@");
+  return at >= 0 ? email.slice(at + 1).trim().toLowerCase() || void 0 : void 0;
+}
+async function domainHasMail(domain, cache, timeoutMs) {
+  const cached = cache.get(domain);
+  if (cached !== void 0) return cached;
+  const timer = new Promise((res) => setTimeout(() => res(false), timeoutMs));
+  const lookup = (0, import_promises.resolveMx)(domain).then((records) => Array.isArray(records) && records.length > 0).catch(() => false);
+  const ok = await Promise.race([lookup, timer]);
+  cache.set(domain, ok);
+  return ok;
+}
+async function verifyEmail(email, opts = {}) {
+  if (!email) return "unknown";
+  if (!emailFormatValid(email)) return "invalid-format";
+  const domain = emailDomain(email);
+  if (!domain) return "invalid-format";
+  const has = await domainHasMail(domain, opts.cache ?? /* @__PURE__ */ new Map(), opts.timeoutMs ?? 5e3);
+  return has ? "valid" : "no-mx";
+}
+async function verifyEmails(leads, opts = {}) {
+  const cache = /* @__PURE__ */ new Map();
+  const targets = leads.filter((l) => l.email);
+  const n = Math.max(1, Math.min(opts.concurrency ?? 5, targets.length || 1));
+  let next = 0;
+  let done = 0;
+  const verifyOpts = { cache };
+  if (opts.timeoutMs !== void 0) verifyOpts.timeoutMs = opts.timeoutMs;
+  const workers = Array.from({ length: n }, async () => {
+    for (; ; ) {
+      const i = next++;
+      if (i >= targets.length) return;
+      const lead = targets[i];
+      lead.emailStatus = await verifyEmail(lead.email, verifyOpts);
+      opts.onProgress?.(`verifying email ${++done}/${targets.length}: ${lead.email}\u2026`);
+    }
+  });
+  await Promise.all(workers);
+  return leads;
+}
+
+// src/geo.ts
+var R_EARTH_M = 63710088e-1;
+var toRad = (deg) => deg * Math.PI / 180;
+function haversineMeters(a, b) {
+  const dLat = toRad(b.lat - a.lat);
+  const dLng = toRad(b.lng - a.lng);
+  const lat1 = toRad(a.lat);
+  const lat2 = toRad(b.lat);
+  const h = Math.sin(dLat / 2) ** 2 + Math.cos(lat1) * Math.cos(lat2) * Math.sin(dLng / 2) ** 2;
+  return 2 * R_EARTH_M * Math.asin(Math.min(1, Math.sqrt(h)));
+}
+function parseLatLngPair(input) {
+  if (!input) return void 0;
+  const m = input.replace(/^@/, "").match(/(-?\d+(?:\.\d+)?)\s*[, ]\s*(-?\d+(?:\.\d+)?)/);
+  if (!m) return void 0;
+  const lat = parseFloat(m[1]);
+  const lng = parseFloat(m[2]);
+  if (!Number.isFinite(lat) || !Number.isFinite(lng)) return void 0;
+  if (lat < -90 || lat > 90 || lng < -180 || lng > 180) return void 0;
+  return { lat, lng };
+}
+function parseDistance(input) {
+  if (!input) return void 0;
+  const m = input.trim().toLowerCase().match(/^(\d+(?:\.\d+)?)\s*(km|m|mi|mile|miles|meters?|metres?)?$/);
+  if (!m) return void 0;
+  const value = parseFloat(m[1]);
+  if (!Number.isFinite(value) || value <= 0) return void 0;
+  const unit = m[2] ?? "m";
+  const metres = unit === "km" ? value * 1e3 : unit.startsWith("mi") ? value * 1609.344 : value;
+  return metres;
+}
+function zoomForRadius(radiusM, lat = 0) {
+  const mpp = 2 * Math.max(50, radiusM) / 600;
+  const zoom = Math.log2(156543.03392 * Math.cos(toRad(lat)) / mpp);
+  return Math.max(3, Math.min(19, Math.round(zoom)));
+}
+
+// src/export.ts
+var import_csv = require("@lacspace/csv");
+var import_xlsx = require("@lacspace/xlsx");
+var HEADERS = {
+  name: "Name",
+  category: "Category",
+  rating: "Rating",
+  reviews: "Reviews",
+  priceLevel: "Price",
+  address: "Address",
+  phone: "Phone",
+  website: "Website",
+  email: "Email",
+  facebook: "Facebook",
+  instagram: "Instagram",
+  whatsapp: "WhatsApp",
+  linkedin: "LinkedIn",
+  twitter: "Twitter/X",
+  youtube: "YouTube",
+  tiktok: "TikTok",
+  telegram: "Telegram",
+  emailStatus: "Email Status",
+  plusCode: "Plus Code",
+  latitude: "Latitude",
+  longitude: "Longitude",
+  distanceKm: "Distance (km)",
+  hours: "Hours",
+  mapsUrl: "Maps URL"
+};
+function toRows(leads, fields = ALL_FIELDS) {
+  return leads.map((lead) => {
+    const row = {};
+    for (const f of fields) {
+      const v = lead[f];
+      row[HEADERS[f]] = v === void 0 || v === null ? "" : v;
+    }
+    return row;
+  });
+}
+function serialize(leads, format, fields = ALL_FIELDS, opts = {}) {
+  if (format === "json" || format === "ndjson") {
+    const picked = leads.map((lead) => {
+      const o = {};
+      for (const f of fields) if (lead[f] !== void 0) o[f] = lead[f];
+      return o;
+    });
+    const data = format === "ndjson" ? picked.map((o) => JSON.stringify(o)).join("\n") + (picked.length ? "\n" : "") : JSON.stringify(picked, null, 2);
+    return { data, binary: false };
+  }
+  const rows = toRows(leads, fields);
+  if (format === "csv") {
+    const csvRows = rows;
+    return { data: (0, import_csv.stringify)(csvRows, { escapeFormulas: true }), binary: false };
+  }
+  const columns = fields.map((f) => {
+    const header = HEADERS[f];
+    const widest = rows.reduce((m, r) => Math.max(m, String(r[header] ?? "").length), header.length);
+    return { header, width: Math.min(60, Math.max(8, widest + 2)) };
+  });
+  return {
+    data: (0, import_xlsx.jsonToXlsx)(rows, { sheetName: opts.sheetName ?? "Leads", columns }),
+    binary: true
+  };
+}
+function computeStats(leads) {
+  const socialKeys = ["facebook", "instagram", "whatsapp", "linkedin", "twitter", "youtube", "tiktok", "telegram"];
+  const ratings = leads.map((l) => l.rating).filter((r) => typeof r === "number");
+  const stats = {
+    total: leads.length,
+    withPhone: leads.filter((l) => l.phone).length,
+    withWebsite: leads.filter((l) => l.website).length,
+    withEmail: leads.filter((l) => l.email).length,
+    withValidEmail: leads.filter((l) => l.emailStatus === "valid").length,
+    withSocial: leads.filter((l) => socialKeys.some((k) => l[k])).length
+  };
+  if (ratings.length) stats.avgRating = Math.round(ratings.reduce((a, b) => a + b, 0) / ratings.length * 10) / 10;
+  return stats;
+}
+var FIELD_BY_KEY = (() => {
+  const m = /* @__PURE__ */ new Map();
+  for (const f of ALL_FIELDS) {
+    m.set(f.toLowerCase(), f);
+    m.set(HEADERS[f].toLowerCase(), f);
+  }
+  return m;
+})();
+var NUMERIC_FIELDS = /* @__PURE__ */ new Set(["rating", "reviews", "latitude", "longitude", "distanceKm"]);
+function rowsToLeads(rows) {
+  return rows.map((row) => {
+    const lead = {};
+    for (const [key, raw] of Object.entries(row)) {
+      const field = FIELD_BY_KEY.get(key.trim().toLowerCase());
+      if (!field || raw === null || raw === void 0 || raw === "") continue;
+      if (NUMERIC_FIELDS.has(field)) {
+        const n = typeof raw === "number" ? raw : parseFloat(String(raw));
+        if (Number.isFinite(n)) lead[field] = n;
+      } else {
+        lead[field] = String(raw);
+      }
+    }
+    return lead;
+  });
+}
+
 // src/scrape.ts
 async function pool(items, n, fn, signal) {
   let next = 0;
@@ -496,17 +709,19 @@ function parseLatLng(url) {
   if (at) return { latitude: parseFloat(at[1]), longitude: parseFloat(at[2]) };
   return {};
 }
-async function launchBrowser(headless) {
+async function launchBrowser(headless, proxy) {
   let lastErr;
+  const base = { headless };
+  if (proxy) base.proxy = { server: proxy };
   for (const channel of ["chrome", "msedge"]) {
     try {
-      return await import_playwright_core.chromium.launch({ headless, channel });
+      return await import_playwright_core.chromium.launch({ ...base, channel });
     } catch (e) {
       lastErr = e;
     }
   }
   try {
-    return await import_playwright_core.chromium.launch({ headless });
+    return await import_playwright_core.chromium.launch(base);
   } catch (e) {
     lastErr = e;
   }
@@ -629,17 +844,26 @@ async function scrapeLeads(opts) {
   const fields = new Set(normalizeFields(opts.fields ?? DEFAULT_FIELDS));
   const delayMs = Math.max(0, Math.trunc(opts.delayMs ?? 700));
   const headless = opts.headless ?? false;
+  const retries = Math.max(0, Math.trunc(opts.retries ?? 1));
   const onProgress = opts.onProgress;
+  const onLead = opts.onLead;
   const signal = opts.signal;
   const startedAt = Date.now();
   const overBudget = () => opts.maxMs !== void 0 && Date.now() - startedAt > opts.maxMs;
-  const wantEnrich = Boolean(opts.enrich) || ENRICHED_FIELDS.some((f) => fields.has(f)) || Boolean(opts.filters?.hasEmail);
+  const pauseMs = () => opts.jitter ? Math.round(delayMs * (0.6 + Math.random() * 0.8)) : delayMs;
+  const wantVerify = Boolean(opts.verifyEmails) || Boolean(opts.filters?.hasValidEmail) || fields.has("emailStatus");
+  const wantEnrich = Boolean(opts.enrich) || ENRICHED_FIELDS.some((f) => fields.has(f)) || Boolean(opts.filters?.hasEmail) || wantVerify;
+  const near = opts.near;
   const collect = new Set(fields);
   if (wantEnrich) collect.add("website");
+  if (near) {
+    collect.add("latitude");
+    collect.add("longitude");
+  }
   const detailOnly = ["name", "mapsUrl"];
   const wantDetails = (opts.details ?? true) && ([...collect].some((f) => !detailOnly.includes(f)) || wantEnrich);
   onProgress?.(`searching Google Maps for "${query}"\u2026`);
-  const browser = await launchBrowser(headless);
+  const browser = await launchBrowser(headless, opts.proxy);
   try {
     const locale = opts.locale ?? "en-US";
     const context = await browser.newContext({
@@ -649,6 +873,7 @@ async function scrapeLeads(opts) {
     const page = await context.newPage();
     const urlOpts = { hl: locale };
     if (opts.region) urlOpts.gl = opts.region;
+    if (near) urlOpts.center = { lat: near.lat, lng: near.lng, zoom: zoomForRadius(opts.radiusM ?? 2e3, near.lat) };
     await page.goto(mapsSearchUrl(query, urlOpts), { waitUntil: "domcontentloaded", timeout: 45e3 });
     await dismissConsent(page);
     await loadResults(page, limit, delayMs, onProgress, signal);
@@ -677,25 +902,47 @@ async function scrapeLeads(opts) {
         }
         return lead;
       });
+      for (const lead of leads) {
+        try {
+          onLead?.(lead);
+        } catch {
+        }
+      }
     } else {
       for (let i = 0; i < cards.length; i++) {
         if (signal?.aborted || overBudget()) break;
         const card = cards[i];
         onProgress?.(`reading ${i + 1}/${cards.length}: ${card.name ?? "listing"}\u2026`);
-        try {
-          await page.goto(card.href, { waitUntil: "domcontentloaded", timeout: 3e4 });
-          await page.locator("h1.DUwDvf").first().waitFor({ timeout: 8e3 }).catch(() => {
-          });
-          leads.push(await extractDetail(page, collect, card.name));
-        } catch {
+        let lead;
+        for (let attempt = 0; attempt <= retries; attempt++) {
+          try {
+            await page.goto(card.href, { waitUntil: "domcontentloaded", timeout: 3e4 });
+            await page.locator("h1.DUwDvf").first().waitFor({ timeout: 8e3 }).catch(() => {
+            });
+            lead = await extractDetail(page, collect, card.name);
+            break;
+          } catch {
+            if (attempt < retries && !signal?.aborted) {
+              onProgress?.(`  retrying ${i + 1}/${cards.length} (attempt ${attempt + 2})\u2026`);
+              if (delayMs) await page.waitForTimeout(pauseMs());
+            }
+          }
+        }
+        if (!lead) {
           if (card.name && (collect.has("name") || collect.has("mapsUrl"))) {
-            const partial = {};
-            if (collect.has("name")) partial.name = card.name;
-            if (collect.has("mapsUrl")) partial.mapsUrl = card.href;
-            leads.push(partial);
+            lead = {};
+            if (collect.has("name")) lead.name = card.name;
+            if (collect.has("mapsUrl")) lead.mapsUrl = card.href;
+          }
+        }
+        if (lead) {
+          leads.push(lead);
+          try {
+            onLead?.(lead);
+          } catch {
           }
         }
-        if (delayMs) await page.waitForTimeout(delayMs);
+        if (delayMs) await page.waitForTimeout(pauseMs());
       }
     }
     onProgress?.(`collected ${leads.length} listing${leads.length === 1 ? "" : "s"}.`);
@@ -704,6 +951,19 @@ async function scrapeLeads(opts) {
         if (lead.website) lead.website = cleanWebsite(lead.website);
       }
     }
+    if (near) {
+      for (const lead of leads) {
+        if (typeof lead.latitude === "number" && typeof lead.longitude === "number") {
+          const m = haversineMeters(near, { lat: lead.latitude, lng: lead.longitude });
+          lead.distanceKm = Math.round(m / 1e3 * 100) / 100;
+        }
+      }
+      if (opts.radiusM !== void 0) {
+        const r = opts.radiusM;
+        leads = leads.filter((l) => l.distanceKm !== void 0 && l.distanceKm * 1e3 <= r);
+        onProgress?.(`within ${Math.round(r)} m: ${leads.length} listing${leads.length === 1 ? "" : "s"}.`);
+      }
+    }
     leads = dedupeLeads(leads, opts.dedupe ?? "website");
     if (wantEnrich) {
       const socialFields = ENRICHED_FIELDS.filter((f) => f !== "email");
@@ -728,6 +988,14 @@ async function scrapeLeads(opts) {
         signal
       );
     }
+    if (wantVerify && !signal?.aborted) {
+      onProgress?.("verifying email domains\u2026");
+      const vOpts = {
+        concurrency: Math.max(1, Math.trunc(opts.concurrency ?? 5))
+      };
+      if (onProgress) vOpts.onProgress = (m) => onProgress(m);
+      await verifyEmails(leads, vOpts);
+    }
     if (opts.country && fields.has("phone")) {
       for (const lead of leads) {
         if (lead.phone) lead.phone = normalizePhone(lead.phone, opts.country);
@@ -735,6 +1003,17 @@ async function scrapeLeads(opts) {
     }
     if (opts.filters) leads = filterLeads(leads, opts.filters);
     if (opts.sort) leads = sortLeads(leads, opts.sort, opts.sortDir);
+    if (wantVerify && !fields.has("emailStatus")) for (const l of leads) delete l.emailStatus;
+    if (near) {
+      const keepLat = fields.has("latitude");
+      const keepLng = fields.has("longitude");
+      const keepDist = fields.has("distanceKm");
+      for (const l of leads) {
+        if (!keepLat) delete l.latitude;
+        if (!keepLng) delete l.longitude;
+        if (!keepDist) delete l.distanceKm;
+      }
+    }
     onProgress?.(`collected ${leads.length} lead${leads.length === 1 ? "" : "s"}.`);
     return leads;
   } finally {
@@ -742,6 +1021,11 @@ async function scrapeLeads(opts) {
     });
   }
 }
+async function searchLeadsDetailed(opts) {
+  const started = Date.now();
+  const leads = await scrapeLeads(opts);
+  return { leads, stats: computeStats(leads), elapsedMs: Date.now() - started };
+}
 
 // src/batch.ts
 async function searchLeadsBatch(queries, opts = {}) {
@@ -806,71 +1090,8 @@ async function searchLeadsMulti(opts) {
   return searchLeadsBatch(queries, opts);
 }
 
-// src/export.ts
-var import_csv = require("@lacspace/csv");
-var import_xlsx = require("@lacspace/xlsx");
-var HEADERS = {
-  name: "Name",
-  category: "Category",
-  rating: "Rating",
-  reviews: "Reviews",
-  priceLevel: "Price",
-  address: "Address",
-  phone: "Phone",
-  website: "Website",
-  email: "Email",
-  facebook: "Facebook",
-  instagram: "Instagram",
-  whatsapp: "WhatsApp",
-  linkedin: "LinkedIn",
-  twitter: "Twitter/X",
-  youtube: "YouTube",
-  tiktok: "TikTok",
-  telegram: "Telegram",
-  plusCode: "Plus Code",
-  latitude: "Latitude",
-  longitude: "Longitude",
-  hours: "Hours",
-  mapsUrl: "Maps URL"
-};
-function toRows(leads, fields = ALL_FIELDS) {
-  return leads.map((lead) => {
-    const row = {};
-    for (const f of fields) {
-      const v = lead[f];
-      row[HEADERS[f]] = v === void 0 || v === null ? "" : v;
-    }
-    return row;
-  });
-}
-function serialize(leads, format, fields = ALL_FIELDS, opts = {}) {
-  if (format === "json" || format === "ndjson") {
-    const picked = leads.map((lead) => {
-      const o = {};
-      for (const f of fields) if (lead[f] !== void 0) o[f] = lead[f];
-      return o;
-    });
-    const data = format === "ndjson" ? picked.map((o) => JSON.stringify(o)).join("\n") + (picked.length ? "\n" : "") : JSON.stringify(picked, null, 2);
-    return { data, binary: false };
-  }
-  const rows = toRows(leads, fields);
-  if (format === "csv") {
-    const csvRows = rows;
-    return { data: (0, import_csv.stringify)(csvRows, { escapeFormulas: true }), binary: false };
-  }
-  const columns = fields.map((f) => {
-    const header = HEADERS[f];
-    const widest = rows.reduce((m, r) => Math.max(m, String(r[header] ?? "").length), header.length);
-    return { header, width: Math.min(60, Math.max(8, widest + 2)) };
-  });
-  return {
-    data: (0, import_xlsx.jsonToXlsx)(rows, { sheetName: opts.sheetName ?? "Leads", columns }),
-    binary: true
-  };
-}
-
 // src/convert.ts
-var import_promises = require("fs/promises");
+var import_promises2 = require("fs/promises");
 var import_node_path = require("path");
 var import_csv2 = require("@lacspace/csv");
 var import_xlsx2 = require("@lacspace/xlsx");
@@ -884,10 +1105,10 @@ function detectFormat(file) {
 async function readRows(file, format) {
   const fmt = format ?? detectFormat(file);
   if (fmt === "xlsx") {
-    const bytes = await (0, import_promises.readFile)(file);
+    const bytes = await (0, import_promises2.readFile)(file);
     return await (0, import_xlsx2.xlsxToJson)(bytes);
   }
-  const text = await (0, import_promises.readFile)(file, "utf8");
+  const text = await (0, import_promises2.readFile)(file, "utf8");
   if (fmt === "csv") {
     return (0, import_csv2.parse)(text, { header: true });
   }
@@ -939,7 +1160,7 @@ async function convertFile(input, opts = {}) {
   const format = opts.format ?? (opts.out ? detectFormat(opts.out) : "json");
   const out = (0, import_node_path.resolve)(opts.out ?? input.replace(/\.[^.]+$/, "") + "." + format);
   const { data, binary } = serializeRows(rows, format, { sheetName: opts.sheetName ?? "Sheet1" });
-  await (0, import_promises.writeFile)(out, binary ? Buffer.from(data) : data);
+  await (0, import_promises2.writeFile)(out, binary ? Buffer.from(data) : data);
   return { out, format, count: rows.length };
 }
 // Annotate the CommonJS export names for ESM import in node:
@@ -954,29 +1175,40 @@ async function convertFile(input, opts = {}) {
   cleanWebsite,
   columnsOf,
   composeQuery,
+  computeStats,
   convertFile,
   dedupeLeads,
   defaultFilename,
   detectFormat,
+  emailDomain,
+  emailFormatValid,
   enrichContacts,
   expandQueries,
   extractEmails,
   extractSocials,
   filterLeads,
+  haversineMeters,
   mapsSearchUrl,
   normalizeFields,
   normalizePhone,
+  parseDistance,
   parseLatLng,
+  parseLatLngPair,
   parseRating,
   parseReviewCount,
   readRows,
   resolvePreset,
+  rowsToLeads,
   scrapeLeads,
   searchLeads,
   searchLeadsBatch,
+  searchLeadsDetailed,
   searchLeadsMulti,
   serialize,
   serializeRows,
   sortLeads,
-  toRows
+  toRows,
+  verifyEmail,
+  verifyEmails,
+  zoomForRadius
 });