lacspace-leads 0.3.0 → 1.3.0

package/dist/lib.d.cts

@@ -1,5 +1,7 @@
 /** The fields a {@link Lead} can carry — request any subset via `fields`. */
-type LeadField = "name" | "category" | "rating" | "reviews" | "priceLevel" | "address" | "phone" | "website" | "email" | "facebook" | "instagram" | "whatsapp" | "linkedin" | "twitter" | "youtube" | "tiktok" | "telegram" | "plusCode" | "latitude" | "longitude" | "hours" | "mapsUrl";
+type LeadField = "name" | "category" | "rating" | "reviews" | "priceLevel" | "address" | "phone" | "website" | "email" | "facebook" | "instagram" | "whatsapp" | "linkedin" | "twitter" | "youtube" | "tiktok" | "telegram" | "emailStatus" | "plusCode" | "latitude" | "longitude" | "distanceKm" | "hours" | "mapsUrl";
+/** Deliverability verdict for a discovered email (see `verifyEmails`). */
+type EmailStatus = "valid" | "no-mx" | "invalid-format" | "unknown";
 /** Every field, in a sensible column order for exports. */
 declare const ALL_FIELDS: LeadField[];
 /** Fields that require visiting the business website (via `enrich`). */
@@ -43,12 +45,16 @@ interface Lead {
     tiktok?: string;
     /** Telegram link, from the website (needs enrichment). */
     telegram?: string;
+    /** Email deliverability verdict (set by `verifyEmails`). */
+    emailStatus?: EmailStatus;
     /** Google Plus Code, when shown. */
     plusCode?: string;
     /** Latitude, parsed from the listing's Maps URL. */
     latitude?: number;
     /** Longitude, parsed from the listing's Maps URL. */
     longitude?: number;
+    /** Distance in km from the `near` point (set only in radius search). */
+    distanceKm?: number;
     /** Opening-hours summary, when shown. */
     hours?: string;
     /** Canonical Google Maps URL for the listing. */
@@ -66,11 +72,13 @@ interface LeadFilters {
     hasWebsite?: boolean;
     /** Keep only leads that have an email (implies enrichment). */
     hasEmail?: boolean;
+    /** Keep only leads whose email passed MX verification (implies `verifyEmails`). */
+    hasValidEmail?: boolean;
 }
 /** Output formats the tool can write. */
 type OutputFormat = "json" | "ndjson" | "csv" | "xlsx";
 /** How to sort collected leads before export. */
-type SortKey$1 = "rating" | "reviews" | "name" | "priceLevel";
+type SortKey$1 = "rating" | "reviews" | "name" | "priceLevel" | "distance";
 /** Options for a lead search. */
 interface SearchOptions {
     /** City, e.g. "Kathmandu". */
@@ -81,6 +89,16 @@ interface SearchOptions {
     type: string;
     /** A ready-made query, used verbatim instead of composing city/area/type. */
     query?: string;
+    /**
+     * Centre the search on a coordinate. Results are biased to this point, and —
+     * when `radiusM` is set — filtered to within it. Each lead gets `distanceKm`.
+     */
+    near?: {
+        lat: number;
+        lng: number;
+    };
+    /** Keep only leads within this many metres of `near`. Requires `near`. */
+    radiusM?: number;
     /** Max number of leads to collect. Default 60. */
     limit?: number;
     /** Fields to collect. Default: all of {@link ALL_FIELDS}. */
@@ -103,8 +121,12 @@ interface SearchOptions {
     enrich?: boolean;
     /** Drop leads that don't pass these filters. */
     filters?: LeadFilters;
-    /** Drop duplicate leads by this key. Default "website" when present else "name". */
-    dedupe?: "website" | "phone" | "name" | "none";
+    /**
+     * Drop duplicate leads by this key. `"smart"` uses the strongest identity
+     * available per lead (website → phone → name) and is best for accumulating
+     * across runs. Default "website".
+     */
+    dedupe?: "website" | "phone" | "name" | "smart" | "none";
     /** Sort the results by this key before returning. */
     sort?: SortKey$1;
     /** Sort direction. Defaults to "desc" for numbers, "asc" for name. */
@@ -122,17 +144,43 @@ interface SearchOptions {
     cleanUrls?: boolean;
     /** How many websites to enrich in parallel. Default 3. */
     concurrency?: number;
+    /**
+     * Verify each discovered email by checking its domain has MX records (DNS,
+     * no message is sent). Populates `emailStatus`. Implies `enrich`. Default off.
+     */
+    verifyEmails?: boolean;
     /** Browser/UI locale, e.g. "en-US", "ne-NP". Default "en-US". */
     locale?: string;
     /** Google region bias (ccTLD-style), e.g. "np", "us". Sets Maps `gl`. */
     region?: string;
+    /** Route the browser through this proxy, e.g. "http://user:pass@host:port". */
+    proxy?: string;
+    /** Retry a listing that fails to open, up to this many times. Default 1. */
+    retries?: number;
+    /** Randomise the delay between listings by ±40% to look more human. */
+    jitter?: boolean;
     /** Stop collecting after this many milliseconds (best-effort). */
     maxMs?: number;
     /** Called with a short progress message as the search runs. */
     onProgress?: (message: string) => void;
+    /**
+     * Called with each lead as it's collected (before enrichment), for live UIs
+     * or crash-safe incremental writing. Never throws into the run.
+     */
+    onLead?: (lead: Lead) => void;
     /** An AbortSignal to cancel a running search. */
     signal?: AbortSignal;
 }
+/** Aggregate counts over a lead list — see `computeStats`. */
+interface LeadStats {
+    total: number;
+    withPhone: number;
+    withWebsite: number;
+    withEmail: number;
+    withValidEmail: number;
+    withSocial: number;
+    avgRating?: number;
+}
 
 /** Error thrown by the scraper. Carries a machine `code` and optional cause. */
 declare class LeadsError extends Error {
@@ -162,6 +210,18 @@ declare function parseLatLng(url: string): {
  * @throws {LeadsError} when no browser can be launched, or the search is aborted.
  */
 declare function scrapeLeads(opts: SearchOptions): Promise<Lead[]>;
+/** A search result with aggregate stats and timing. */
+interface DetailedResult {
+    leads: Lead[];
+    stats: LeadStats;
+    /** Wall-clock time of the search, in milliseconds. */
+    elapsedMs: number;
+}
+/**
+ * Like {@link scrapeLeads}, but also returns aggregate {@link LeadStats} and the
+ * elapsed time — handy for dashboards, reports and CI summaries.
+ */
+declare function searchLeadsDetailed(opts: SearchOptions): Promise<DetailedResult>;
 
 /** One sub-search in a batch. */
 interface BatchQuery {
@@ -198,6 +258,37 @@ declare function serialize(leads: Lead[], format: OutputFormat, fields?: LeadFie
     data: string | Uint8Array;
     binary: boolean;
 };
+/** Aggregate counts over a lead list — for summaries and reports. Pure. */
+declare function computeStats(leads: Lead[]): LeadStats;
+/**
+ * Map arbitrary rows (as read back from a JSON/CSV/Excel export, keyed by field
+ * name or header label) into {@link Lead}s. Unknown columns are ignored, blanks
+ * dropped, and numeric fields coerced. Powers `--append` / resume. Pure.
+ */
+declare function rowsToLeads(rows: Record<string, unknown>[]): Lead[];
+
+/** True when `email` is a plausibly-valid address shape. Pure. */
+declare function emailFormatValid(email: string | undefined): boolean;
+/** The domain part of an email, lower-cased, or undefined. Pure. */
+declare function emailDomain(email: string | undefined): string | undefined;
+/**
+ * Classify a single email: `invalid-format` → `no-mx` → `valid`. `unknown` is
+ * reserved for a missing address. Never throws.
+ */
+declare function verifyEmail(email: string | undefined, opts?: {
+    cache?: Map<string, boolean>;
+    timeoutMs?: number;
+}): Promise<EmailStatus>;
+/**
+ * Verify the `email` on each lead in place, setting `emailStatus`. Domains are
+ * looked up once (shared cache) and checked a few in parallel. Leads without an
+ * email are left untouched. Node-only; never throws.
+ */
+declare function verifyEmails(leads: Lead[], opts?: {
+    concurrency?: number;
+    timeoutMs?: number;
+    onProgress?: (m: string) => void;
+}): Promise<Lead[]>;
 
 /**
  * Compose the human search query from options: an explicit `query` wins,
@@ -211,11 +302,17 @@ declare function composeQuery(opts: {
 }): string;
 /**
  * The Google Maps search URL for a query. `hl` (interface language) keeps the
- * scraped aria-labels predictable; `gl` biases results to a region.
+ * scraped aria-labels predictable; `gl` biases results to a region; `center`
+ * (`{lat,lng,zoom}`) points the map at a location for a radius search.
  */
 declare function mapsSearchUrl(query: string, opts?: {
     hl?: string;
     gl?: string;
+    center?: {
+        lat: number;
+        lng: number;
+        zoom?: number;
+    };
 }): string;
 /**
  * Expand a possibly-multi search request into individual `{type, city, area}`
@@ -280,10 +377,11 @@ declare function callingCode(country?: string): string | undefined;
  */
 declare function normalizePhone(raw?: string, country?: string): string | undefined;
 /** Keys a lead list can be sorted by. */
-type SortKey = "rating" | "reviews" | "name" | "priceLevel";
+type SortKey = "rating" | "reviews" | "name" | "priceLevel" | "distance";
 /**
  * Sort leads by a key, missing values always last. Stable, pure, new array.
- * `dir` defaults to descending for numeric keys and ascending for `name`.
+ * `dir` defaults to descending for numeric quality keys, ascending for `name`
+ * and `distance` (nearest first).
  */
 declare function sortLeads(leads: Lead[], by?: SortKey, dir?: "asc" | "desc"): Lead[];
 
@@ -320,6 +418,34 @@ declare function enrichContacts(website: string, opts?: {
     contactPages?: boolean;
 }): Promise<Contacts>;
 
+/**
+ * Geo helpers for radius search — parse a coordinate/radius, measure distance
+ * (haversine), and pick a Maps zoom that frames a radius. All pure, unit-tested.
+ */
+/** A latitude/longitude point. */
+interface LatLng {
+    lat: number;
+    lng: number;
+}
+/** Great-circle distance between two points, in metres. Pure. */
+declare function haversineMeters(a: LatLng, b: LatLng): number;
+/**
+ * Parse a `"lat,lng"` pair (also accepts a bare `@lat,lng` or whitespace).
+ * Returns `undefined` if it isn't two in-range numbers. Pure.
+ */
+declare function parseLatLngPair(input: string | undefined): LatLng | undefined;
+/**
+ * Parse a distance like `"2km"`, `"500m"`, `"1.5mi"` (or a bare number = metres)
+ * into metres. Returns `undefined` for junk or non-positive values. Pure.
+ */
+declare function parseDistance(input: string | undefined): number | undefined;
+/**
+ * A Google Maps zoom level (integer) that roughly frames a circle of `radiusM`
+ * at a given latitude in the map viewport. Clamped to 3–19. Pure/best-effort —
+ * Maps re-fits results anyway; this just centres the search sensibly.
+ */
+declare function zoomForRadius(radiusM: number, lat?: number): number;
+
 /** An arbitrary tabular row. */
 type DataRow = Record<string, unknown>;
 /** Infer the format from a filename extension. Throws on an unknown extension. */
@@ -346,4 +472,4 @@ declare function convertFile(input: string, opts?: {
     count: number;
 }>;
 
-export { ALL_FIELDS, type BatchQuery, CALLING_CODES, type Contacts, DEFAULT_FIELDS, type DataRow, ENRICHED_FIELDS, FIELD_PRESETS, type Lead, type LeadField, type LeadFilters, LeadsError, type OutputFormat, type SearchOptions, type SortKey$1 as SortKey, callingCode, cleanWebsite, columnsOf, composeQuery, convertFile, dedupeLeads, defaultFilename, detectFormat, enrichContacts, expandQueries, extractEmails, extractSocials, filterLeads, mapsSearchUrl, normalizeFields, normalizePhone, parseLatLng, parseRating, parseReviewCount, readRows, resolvePreset, scrapeLeads, scrapeLeads as searchLeads, searchLeadsBatch, searchLeadsMulti, serialize, serializeRows, sortLeads, toRows };
+export { ALL_FIELDS, type BatchQuery, CALLING_CODES, type Contacts, DEFAULT_FIELDS, type DataRow, type DetailedResult, ENRICHED_FIELDS, type EmailStatus, FIELD_PRESETS, type LatLng, type Lead, type LeadField, type LeadFilters, type LeadStats, LeadsError, type OutputFormat, type SearchOptions, type SortKey$1 as SortKey, callingCode, 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, scrapeLeads as searchLeads, searchLeadsBatch, searchLeadsDetailed, searchLeadsMulti, serialize, serializeRows, sortLeads, toRows, verifyEmail, verifyEmails, zoomForRadius };

package/dist/lib.d.ts

@@ -1,5 +1,7 @@
 /** The fields a {@link Lead} can carry — request any subset via `fields`. */
-type LeadField = "name" | "category" | "rating" | "reviews" | "priceLevel" | "address" | "phone" | "website" | "email" | "facebook" | "instagram" | "whatsapp" | "linkedin" | "twitter" | "youtube" | "tiktok" | "telegram" | "plusCode" | "latitude" | "longitude" | "hours" | "mapsUrl";
+type LeadField = "name" | "category" | "rating" | "reviews" | "priceLevel" | "address" | "phone" | "website" | "email" | "facebook" | "instagram" | "whatsapp" | "linkedin" | "twitter" | "youtube" | "tiktok" | "telegram" | "emailStatus" | "plusCode" | "latitude" | "longitude" | "distanceKm" | "hours" | "mapsUrl";
+/** Deliverability verdict for a discovered email (see `verifyEmails`). */
+type EmailStatus = "valid" | "no-mx" | "invalid-format" | "unknown";
 /** Every field, in a sensible column order for exports. */
 declare const ALL_FIELDS: LeadField[];
 /** Fields that require visiting the business website (via `enrich`). */
@@ -43,12 +45,16 @@ interface Lead {
     tiktok?: string;
     /** Telegram link, from the website (needs enrichment). */
     telegram?: string;
+    /** Email deliverability verdict (set by `verifyEmails`). */
+    emailStatus?: EmailStatus;
     /** Google Plus Code, when shown. */
     plusCode?: string;
     /** Latitude, parsed from the listing's Maps URL. */
     latitude?: number;
     /** Longitude, parsed from the listing's Maps URL. */
     longitude?: number;
+    /** Distance in km from the `near` point (set only in radius search). */
+    distanceKm?: number;
     /** Opening-hours summary, when shown. */
     hours?: string;
     /** Canonical Google Maps URL for the listing. */
@@ -66,11 +72,13 @@ interface LeadFilters {
     hasWebsite?: boolean;
     /** Keep only leads that have an email (implies enrichment). */
     hasEmail?: boolean;
+    /** Keep only leads whose email passed MX verification (implies `verifyEmails`). */
+    hasValidEmail?: boolean;
 }
 /** Output formats the tool can write. */
 type OutputFormat = "json" | "ndjson" | "csv" | "xlsx";
 /** How to sort collected leads before export. */
-type SortKey$1 = "rating" | "reviews" | "name" | "priceLevel";
+type SortKey$1 = "rating" | "reviews" | "name" | "priceLevel" | "distance";
 /** Options for a lead search. */
 interface SearchOptions {
     /** City, e.g. "Kathmandu". */
@@ -81,6 +89,16 @@ interface SearchOptions {
     type: string;
     /** A ready-made query, used verbatim instead of composing city/area/type. */
     query?: string;
+    /**
+     * Centre the search on a coordinate. Results are biased to this point, and —
+     * when `radiusM` is set — filtered to within it. Each lead gets `distanceKm`.
+     */
+    near?: {
+        lat: number;
+        lng: number;
+    };
+    /** Keep only leads within this many metres of `near`. Requires `near`. */
+    radiusM?: number;
     /** Max number of leads to collect. Default 60. */
     limit?: number;
     /** Fields to collect. Default: all of {@link ALL_FIELDS}. */
@@ -103,8 +121,12 @@ interface SearchOptions {
     enrich?: boolean;
     /** Drop leads that don't pass these filters. */
     filters?: LeadFilters;
-    /** Drop duplicate leads by this key. Default "website" when present else "name". */
-    dedupe?: "website" | "phone" | "name" | "none";
+    /**
+     * Drop duplicate leads by this key. `"smart"` uses the strongest identity
+     * available per lead (website → phone → name) and is best for accumulating
+     * across runs. Default "website".
+     */
+    dedupe?: "website" | "phone" | "name" | "smart" | "none";
     /** Sort the results by this key before returning. */
     sort?: SortKey$1;
     /** Sort direction. Defaults to "desc" for numbers, "asc" for name. */
@@ -122,17 +144,43 @@ interface SearchOptions {
     cleanUrls?: boolean;
     /** How many websites to enrich in parallel. Default 3. */
     concurrency?: number;
+    /**
+     * Verify each discovered email by checking its domain has MX records (DNS,
+     * no message is sent). Populates `emailStatus`. Implies `enrich`. Default off.
+     */
+    verifyEmails?: boolean;
     /** Browser/UI locale, e.g. "en-US", "ne-NP". Default "en-US". */
     locale?: string;
     /** Google region bias (ccTLD-style), e.g. "np", "us". Sets Maps `gl`. */
     region?: string;
+    /** Route the browser through this proxy, e.g. "http://user:pass@host:port". */
+    proxy?: string;
+    /** Retry a listing that fails to open, up to this many times. Default 1. */
+    retries?: number;
+    /** Randomise the delay between listings by ±40% to look more human. */
+    jitter?: boolean;
     /** Stop collecting after this many milliseconds (best-effort). */
     maxMs?: number;
     /** Called with a short progress message as the search runs. */
     onProgress?: (message: string) => void;
+    /**
+     * Called with each lead as it's collected (before enrichment), for live UIs
+     * or crash-safe incremental writing. Never throws into the run.
+     */
+    onLead?: (lead: Lead) => void;
     /** An AbortSignal to cancel a running search. */
     signal?: AbortSignal;
 }
+/** Aggregate counts over a lead list — see `computeStats`. */
+interface LeadStats {
+    total: number;
+    withPhone: number;
+    withWebsite: number;
+    withEmail: number;
+    withValidEmail: number;
+    withSocial: number;
+    avgRating?: number;
+}
 
 /** Error thrown by the scraper. Carries a machine `code` and optional cause. */
 declare class LeadsError extends Error {
@@ -162,6 +210,18 @@ declare function parseLatLng(url: string): {
  * @throws {LeadsError} when no browser can be launched, or the search is aborted.
  */
 declare function scrapeLeads(opts: SearchOptions): Promise<Lead[]>;
+/** A search result with aggregate stats and timing. */
+interface DetailedResult {
+    leads: Lead[];
+    stats: LeadStats;
+    /** Wall-clock time of the search, in milliseconds. */
+    elapsedMs: number;
+}
+/**
+ * Like {@link scrapeLeads}, but also returns aggregate {@link LeadStats} and the
+ * elapsed time — handy for dashboards, reports and CI summaries.
+ */
+declare function searchLeadsDetailed(opts: SearchOptions): Promise<DetailedResult>;
 
 /** One sub-search in a batch. */
 interface BatchQuery {
@@ -198,6 +258,37 @@ declare function serialize(leads: Lead[], format: OutputFormat, fields?: LeadFie
     data: string | Uint8Array;
     binary: boolean;
 };
+/** Aggregate counts over a lead list — for summaries and reports. Pure. */
+declare function computeStats(leads: Lead[]): LeadStats;
+/**
+ * Map arbitrary rows (as read back from a JSON/CSV/Excel export, keyed by field
+ * name or header label) into {@link Lead}s. Unknown columns are ignored, blanks
+ * dropped, and numeric fields coerced. Powers `--append` / resume. Pure.
+ */
+declare function rowsToLeads(rows: Record<string, unknown>[]): Lead[];
+
+/** True when `email` is a plausibly-valid address shape. Pure. */
+declare function emailFormatValid(email: string | undefined): boolean;
+/** The domain part of an email, lower-cased, or undefined. Pure. */
+declare function emailDomain(email: string | undefined): string | undefined;
+/**
+ * Classify a single email: `invalid-format` → `no-mx` → `valid`. `unknown` is
+ * reserved for a missing address. Never throws.
+ */
+declare function verifyEmail(email: string | undefined, opts?: {
+    cache?: Map<string, boolean>;
+    timeoutMs?: number;
+}): Promise<EmailStatus>;
+/**
+ * Verify the `email` on each lead in place, setting `emailStatus`. Domains are
+ * looked up once (shared cache) and checked a few in parallel. Leads without an
+ * email are left untouched. Node-only; never throws.
+ */
+declare function verifyEmails(leads: Lead[], opts?: {
+    concurrency?: number;
+    timeoutMs?: number;
+    onProgress?: (m: string) => void;
+}): Promise<Lead[]>;
 
 /**
  * Compose the human search query from options: an explicit `query` wins,
@@ -211,11 +302,17 @@ declare function composeQuery(opts: {
 }): string;
 /**
  * The Google Maps search URL for a query. `hl` (interface language) keeps the
- * scraped aria-labels predictable; `gl` biases results to a region.
+ * scraped aria-labels predictable; `gl` biases results to a region; `center`
+ * (`{lat,lng,zoom}`) points the map at a location for a radius search.
  */
 declare function mapsSearchUrl(query: string, opts?: {
     hl?: string;
     gl?: string;
+    center?: {
+        lat: number;
+        lng: number;
+        zoom?: number;
+    };
 }): string;
 /**
  * Expand a possibly-multi search request into individual `{type, city, area}`
@@ -280,10 +377,11 @@ declare function callingCode(country?: string): string | undefined;
  */
 declare function normalizePhone(raw?: string, country?: string): string | undefined;
 /** Keys a lead list can be sorted by. */
-type SortKey = "rating" | "reviews" | "name" | "priceLevel";
+type SortKey = "rating" | "reviews" | "name" | "priceLevel" | "distance";
 /**
  * Sort leads by a key, missing values always last. Stable, pure, new array.
- * `dir` defaults to descending for numeric keys and ascending for `name`.
+ * `dir` defaults to descending for numeric quality keys, ascending for `name`
+ * and `distance` (nearest first).
  */
 declare function sortLeads(leads: Lead[], by?: SortKey, dir?: "asc" | "desc"): Lead[];
 
@@ -320,6 +418,34 @@ declare function enrichContacts(website: string, opts?: {
     contactPages?: boolean;
 }): Promise<Contacts>;
 
+/**
+ * Geo helpers for radius search — parse a coordinate/radius, measure distance
+ * (haversine), and pick a Maps zoom that frames a radius. All pure, unit-tested.
+ */
+/** A latitude/longitude point. */
+interface LatLng {
+    lat: number;
+    lng: number;
+}
+/** Great-circle distance between two points, in metres. Pure. */
+declare function haversineMeters(a: LatLng, b: LatLng): number;
+/**
+ * Parse a `"lat,lng"` pair (also accepts a bare `@lat,lng` or whitespace).
+ * Returns `undefined` if it isn't two in-range numbers. Pure.
+ */
+declare function parseLatLngPair(input: string | undefined): LatLng | undefined;
+/**
+ * Parse a distance like `"2km"`, `"500m"`, `"1.5mi"` (or a bare number = metres)
+ * into metres. Returns `undefined` for junk or non-positive values. Pure.
+ */
+declare function parseDistance(input: string | undefined): number | undefined;
+/**
+ * A Google Maps zoom level (integer) that roughly frames a circle of `radiusM`
+ * at a given latitude in the map viewport. Clamped to 3–19. Pure/best-effort —
+ * Maps re-fits results anyway; this just centres the search sensibly.
+ */
+declare function zoomForRadius(radiusM: number, lat?: number): number;
+
 /** An arbitrary tabular row. */
 type DataRow = Record<string, unknown>;
 /** Infer the format from a filename extension. Throws on an unknown extension. */
@@ -346,4 +472,4 @@ declare function convertFile(input: string, opts?: {
     count: number;
 }>;
 
-export { ALL_FIELDS, type BatchQuery, CALLING_CODES, type Contacts, DEFAULT_FIELDS, type DataRow, ENRICHED_FIELDS, FIELD_PRESETS, type Lead, type LeadField, type LeadFilters, LeadsError, type OutputFormat, type SearchOptions, type SortKey$1 as SortKey, callingCode, cleanWebsite, columnsOf, composeQuery, convertFile, dedupeLeads, defaultFilename, detectFormat, enrichContacts, expandQueries, extractEmails, extractSocials, filterLeads, mapsSearchUrl, normalizeFields, normalizePhone, parseLatLng, parseRating, parseReviewCount, readRows, resolvePreset, scrapeLeads, scrapeLeads as searchLeads, searchLeadsBatch, searchLeadsMulti, serialize, serializeRows, sortLeads, toRows };
+export { ALL_FIELDS, type BatchQuery, CALLING_CODES, type Contacts, DEFAULT_FIELDS, type DataRow, type DetailedResult, ENRICHED_FIELDS, type EmailStatus, FIELD_PRESETS, type LatLng, type Lead, type LeadField, type LeadFilters, type LeadStats, LeadsError, type OutputFormat, type SearchOptions, type SortKey$1 as SortKey, callingCode, 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, scrapeLeads as searchLeads, searchLeadsBatch, searchLeadsDetailed, searchLeadsMulti, serialize, serializeRows, sortLeads, toRows, verifyEmail, verifyEmails, zoomForRadius };