open-local-audit 0.67.0 → 0.69.0

package/dist/discovery-cache.js

@@ -0,0 +1,312 @@
+import { createHash } from "node:crypto";
+import { constants } from "node:fs";
+import { lstat, mkdir, open } from "node:fs/promises";
+import { isIP } from "node:net";
+import { homedir } from "node:os";
+import { isAbsolute, join, parse, relative, resolve, sep } from "node:path";
+const cacheSchemaVersion = 1;
+const cacheFreshnessMs = 7 * 24 * 60 * 60 * 1000;
+const maximumCacheBytes = 2 * 1024 * 1024;
+const minimumConfidence = 0.5;
+const socialProfileHosts = ["facebook.com", "instagram.com", "linkedin.com", "x.com", "twitter.com", "tiktok.com", "youtube.com", "wa.me", "whatsapp.com"];
+const shortLinkHosts = ["fbf.bz", "fb.me", "bit.ly", "tinyurl.com", "t.co", "goo.gl", "maps.app.goo.gl", "linktr.ee"];
+export function defaultDiscoveryCacheDirectory() {
+    if (process.platform === "win32") {
+        const localAppData = process.env.LOCALAPPDATA;
+        return join(localAppData && isAbsolute(localAppData) ? localAppData : join(homedir(), "AppData", "Local"), "open-local-audit", "cache", "discovery");
+    }
+    if (process.platform === "darwin") {
+        return join(homedir(), "Library", "Caches", "open-local-audit", "discovery");
+    }
+    const xdgCacheHome = process.env.XDG_CACHE_HOME;
+    return join(xdgCacheHome && isAbsolute(xdgCacheHome) ? xdgCacheHome : join(homedir(), ".cache"), "open-local-audit", "discovery");
+}
+export function discoveryCacheKey(input) {
+    return createHash("sha256")
+        .update(JSON.stringify({ schemaVersion: cacheSchemaVersion, category: input.category, bbox: input.bbox, limit: input.limit, release: input.release }))
+        .digest("hex");
+}
+function cacheFilePath(input) {
+    return join(input.cacheDir, `${discoveryCacheKey(input)}.json`);
+}
+function cacheError(error) {
+    return error instanceof Error && error.message ? error.message : "Cache storage was unavailable";
+}
+function isPublicHttpUrl(value) {
+    try {
+        const url = new URL(value);
+        const host = url.hostname.toLowerCase().replace(/^\[|\]$/g, "");
+        if ((url.protocol !== "http:" && url.protocol !== "https:") || url.username || url.password || host === "localhost" || host.endsWith(".localhost")) {
+            return false;
+        }
+        if (isIP(host) === 4) {
+            const octets = host.split(".").map(Number);
+            return !(octets[0] === 0 || octets[0] === 10 || octets[0] === 127 || (octets[0] === 169 && octets[1] === 254) || (octets[0] === 172 && octets[1] >= 16 && octets[1] <= 31) || (octets[0] === 192 && octets[1] === 168));
+        }
+        if (isIP(host) === 6) {
+            const mappedIpv4 = host.match(/^::ffff:(\d+\.\d+\.\d+\.\d+)$/i)?.[1];
+            return !(host === "::1" || host.startsWith("fc") || host.startsWith("fd") || host.startsWith("fe80:") || (mappedIpv4 !== undefined && !isPublicHttpUrl(`http://${mappedIpv4}`)));
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function hasHost(value, hosts) {
+    try {
+        const host = new URL(value).hostname.toLowerCase();
+        return hosts.some((entry) => host === entry || host.endsWith(`.${entry}`));
+    }
+    catch {
+        return false;
+    }
+}
+function isSafeWebsite(value) {
+    return typeof value === "string" && isPublicHttpUrl(value) && !hasHost(value, socialProfileHosts) && !hasHost(value, shortLinkHosts);
+}
+function isPastIsoDate(value, now) {
+    const time = typeof value === "string" ? Date.parse(value) : Number.NaN;
+    return Number.isFinite(time) && time <= now;
+}
+function isStringList(value, predicate) {
+    return Array.isArray(value) && value.every((entry) => typeof entry === "string" && predicate(entry));
+}
+function isOptionalString(value) {
+    return value === undefined || typeof value === "string";
+}
+function isFiniteCoordinate(value, minimum, maximum) {
+    return value === undefined || (typeof value === "number" && Number.isFinite(value) && value >= minimum && value <= maximum);
+}
+function isStringRecord(value, allowedKeys) {
+    return typeof value === "object"
+        && value !== null
+        && !Array.isArray(value)
+        && Object.keys(value).every((key) => allowedKeys.includes(key) && typeof value[key] === "string");
+}
+function isSafeCandidate(value, request, now, allowProfile = false) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const candidate = value;
+    if (candidate.source !== "overture" || typeof candidate.sourceId !== "string" || !candidate.sourceId.trim() || candidate.segment !== request.category)
+        return false;
+    if (candidate.label !== undefined && typeof candidate.label !== "string")
+        return false;
+    if (candidate.websiteUri !== undefined && !isSafeWebsite(candidate.websiteUri))
+        return false;
+    if (!Object.keys(candidate).every((key) => ["source", "sourceId", "label", "segment", "websiteUri", "sourceMetadata", ...(allowProfile ? ["profile"] : [])].includes(key)))
+        return false;
+    if (candidate.profile !== undefined && !["generic", "dental", "beauty", "restaurant", "contractor", "lawyer", "clinic", "gym", "hotel", "auto-service"].includes(candidate.profile))
+        return false;
+    if (typeof candidate.sourceMetadata !== "object" || candidate.sourceMetadata === null || Array.isArray(candidate.sourceMetadata))
+        return false;
+    const metadata = candidate.sourceMetadata;
+    if (metadata.datasetRelease !== request.release || !isPastIsoDate(metadata.retrievedAt, now))
+        return false;
+    if (!Object.keys(metadata).every((key) => ["address", "country", "locality", "region", "latitude", "longitude", "phones", "emails", "socials", "confidence", "operatingStatus", "datasetRelease", "sourceUrl", "sourceUrls", "sourceProvenance", "retrievedAt"].includes(key)))
+        return false;
+    if (![metadata.address, metadata.country, metadata.locality, metadata.region, metadata.operatingStatus].every(isOptionalString))
+        return false;
+    if (!isFiniteCoordinate(metadata.latitude, -90, 90) || !isFiniteCoordinate(metadata.longitude, -180, 180))
+        return false;
+    if (!isStringList(metadata.phones, () => true) || !isStringList(metadata.emails, () => true) || !isStringList(metadata.socials, isPublicHttpUrl))
+        return false;
+    if (metadata.confidence !== undefined && (typeof metadata.confidence !== "number" || !Number.isFinite(metadata.confidence) || metadata.confidence < minimumConfidence || metadata.confidence > 1))
+        return false;
+    if (typeof metadata.operatingStatus === "string" && metadata.operatingStatus.toLowerCase() === "closed_permanently")
+        return false;
+    if (typeof metadata.sourceUrl !== "string" || !isPublicHttpUrl(metadata.sourceUrl))
+        return false;
+    if (!isStringList(metadata.sourceUrls, isPublicHttpUrl))
+        return false;
+    if (!Array.isArray(metadata.sourceProvenance) || !metadata.sourceProvenance.every((entry) => isStringRecord(entry, ["provider", "dataset", "license", "recordId", "resource", "version", "updateTime"])))
+        return false;
+    return true;
+}
+function isSafeRecord(value, request, now) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const record = value;
+    if (record.schemaVersion !== cacheSchemaVersion || record.source !== "overture" || record.category !== request.category || record.limit !== request.limit || record.release !== request.release)
+        return false;
+    if (!Array.isArray(record.bbox) || record.bbox.length !== 4 || record.bbox.some((entry, index) => entry !== request.bbox[index]))
+        return false;
+    if (!isPastIsoDate(record.fetchedAt, now) || !isPastIsoDate(record.cachedAt, now) || Date.parse(record.cachedAt) < Date.parse(record.fetchedAt) || now - Date.parse(record.cachedAt) > cacheFreshnessMs)
+        return false;
+    if (!Array.isArray(record.candidates) || record.candidates.length > request.limit || !record.candidates.every((candidate) => isSafeCandidate(candidate, request, now)))
+        return false;
+    return new Set(record.candidates.map((candidate) => candidate.sourceId)).size === record.candidates.length;
+}
+async function ensureSafeDirectory(cacheDir) {
+    if (!isAbsolute(cacheDir))
+        throw new Error("Discovery cache directory must be absolute");
+    const normalized = resolve(cacheDir);
+    const parsed = parse(normalized);
+    const parts = relative(parsed.root, normalized).split(sep).filter(Boolean);
+    let current = parsed.root;
+    for (const part of parts) {
+        current = join(current, part);
+        try {
+            const entry = await lstat(current);
+            if (!entry.isDirectory() || entry.isSymbolicLink())
+                throw new Error("Discovery cache path is not a safe directory");
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+            await mkdir(current);
+            const created = await lstat(current);
+            if (!created.isDirectory() || created.isSymbolicLink())
+                throw new Error("Discovery cache path is not a safe directory");
+        }
+    }
+}
+async function safeCacheFile(path) {
+    try {
+        const entry = await lstat(path);
+        if (!entry.isFile() || entry.isSymbolicLink() || entry.nlink !== 1)
+            return { state: "unsafe" };
+        return { state: "file", stat: entry };
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return { state: "missing" };
+        throw error;
+    }
+}
+function noFollow(flags) {
+    return process.platform === "win32" ? flags : flags | constants.O_NOFOLLOW;
+}
+function matchesCacheFile(expected, actual) {
+    return actual.isFile() && actual.nlink === 1 && actual.dev === expected.dev && actual.ino === expected.ino;
+}
+async function openExistingCacheFile(path, expected, flags) {
+    const handle = await open(path, noFollow(flags));
+    try {
+        const actual = await handle.stat();
+        if (!matchesCacheFile(expected, actual))
+            throw new Error("Discovery cache entry changed while opening");
+        return handle;
+    }
+    catch (error) {
+        await handle.close();
+        throw error;
+    }
+}
+async function openNewCacheFile(path) {
+    const handle = await open(path, noFollow(constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL));
+    try {
+        const actual = await handle.stat();
+        if (!actual.isFile() || actual.nlink !== 1)
+            throw new Error("Discovery cache entry was unsafe");
+        return handle;
+    }
+    catch (error) {
+        await handle.close();
+        throw error;
+    }
+}
+export async function readDiscoveryCache(request) {
+    try {
+        await ensureSafeDirectory(request.cacheDir);
+        const path = cacheFilePath(request);
+        const file = await safeCacheFile(path);
+        if (file.state === "missing")
+            return { info: { status: "miss", release: request.release } };
+        if (file.state !== "file" || file.stat.size > maximumCacheBytes)
+            return { info: { status: "unavailable", release: request.release, message: "Discovery cache entry was unsafe or oversized" } };
+        const handle = await openExistingCacheFile(path, file.stat, constants.O_RDONLY);
+        let content;
+        try {
+            await ensureSafeDirectory(request.cacheDir);
+            if (!matchesCacheFile(file.stat, await handle.stat()))
+                throw new Error("Discovery cache entry changed while reading");
+            const buffer = Buffer.alloc(maximumCacheBytes + 1);
+            const { bytesRead } = await handle.read(buffer, 0, buffer.length, 0);
+            if (bytesRead > maximumCacheBytes) {
+                return { info: { status: "unavailable", release: request.release, message: "Discovery cache record exceeded its size limit" } };
+            }
+            content = buffer.subarray(0, bytesRead).toString("utf8");
+        }
+        finally {
+            await handle.close();
+        }
+        if (Buffer.byteLength(content, "utf8") > maximumCacheBytes) {
+            return { info: { status: "unavailable", release: request.release, message: "Discovery cache record exceeded its size limit" } };
+        }
+        const record = JSON.parse(content);
+        const now = Date.now();
+        if (!isSafeRecord(record, request, now)) {
+            return { info: { status: "unavailable", release: request.release, message: "Discovery cache record was invalid or expired" } };
+        }
+        return { candidates: record.candidates, info: { status: "hit", release: request.release, fetchedAt: record.fetchedAt, cachedAt: record.cachedAt } };
+    }
+    catch (error) {
+        return { info: { status: "unavailable", release: request.release, message: cacheError(error) } };
+    }
+}
+export async function writeDiscoveryCache(request, candidates, fetchedAt, status) {
+    try {
+        const now = Date.now();
+        if (!isPastIsoDate(fetchedAt, now) || !candidates.every((candidate) => isSafeCandidate(candidate, request, now, true))) {
+            return { status: "unavailable", release: request.release, message: "Discovery results did not satisfy the cache record contract" };
+        }
+        await ensureSafeDirectory(request.cacheDir);
+        const path = cacheFilePath(request);
+        const existing = await safeCacheFile(path);
+        if (existing.state === "unsafe")
+            return { status: "unavailable", release: request.release, message: "Discovery cache entry was unsafe" };
+        const cachedAt = new Date().toISOString();
+        const sourceCandidates = candidates.map(({ profile: _profile, ...candidate }) => candidate);
+        const record = {
+            schemaVersion: cacheSchemaVersion,
+            source: "overture",
+            category: request.category,
+            bbox: request.bbox,
+            limit: request.limit,
+            release: request.release,
+            fetchedAt,
+            cachedAt,
+            candidates: sourceCandidates
+        };
+        const content = JSON.stringify(record);
+        if (Buffer.byteLength(content, "utf8") > maximumCacheBytes)
+            return { status: "unavailable", release: request.release, message: "Discovery cache record exceeded its size limit" };
+        let handle;
+        let expected;
+        if (existing.state === "file") {
+            expected = existing.stat;
+            handle = await openExistingCacheFile(path, existing.stat, constants.O_WRONLY);
+        }
+        else {
+            try {
+                handle = await openNewCacheFile(path);
+            }
+            catch (error) {
+                if (error.code !== "EEXIST")
+                    throw error;
+                const createdByPeer = await safeCacheFile(path);
+                if (createdByPeer.state !== "file")
+                    throw new Error("Discovery cache entry was unsafe");
+                expected = createdByPeer.stat;
+                handle = await openExistingCacheFile(path, createdByPeer.stat, constants.O_WRONLY);
+            }
+        }
+        try {
+            await ensureSafeDirectory(request.cacheDir);
+            const current = await handle.stat();
+            if (expected ? !matchesCacheFile(expected, current) : !current.isFile() || current.nlink !== 1)
+                throw new Error("Discovery cache entry changed while writing");
+            await handle.truncate(0);
+            await handle.writeFile(content, "utf8");
+        }
+        finally {
+            await handle.close();
+        }
+        return { status, release: request.release, fetchedAt, cachedAt };
+    }
+    catch (error) {
+        return { status: "unavailable", release: request.release, message: cacheError(error) };
+    }
+}
+//# sourceMappingURL=discovery-cache.js.map

package/dist/discovery-cache.js.map

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

package/dist/discovery-location.d.ts

@@ -0,0 +1,13 @@
+import type { BoundingBox } from "./overture.js";
+export declare const maximumDiscoveryBboxSpan = 5;
+export interface DiscoveryCity {
+    name: string;
+    country: string;
+    region: string;
+    latitude: number;
+    longitude: number;
+}
+export declare function findDiscoveryCity(data: string, name: string, country: string): DiscoveryCity;
+export declare function parseDiscoveryBbox(value: string): BoundingBox;
+export declare function cityBoundingBox(city: DiscoveryCity, radiusKm?: number): BoundingBox;
+export declare function resolveDiscoveryCity(name: string, country: string, cacheDir: string): Promise<DiscoveryCity>;

package/dist/discovery-location.js

@@ -0,0 +1,99 @@
+import { mkdir, readFile, stat, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { strFromU8, unzipSync } from "fflate";
+export const maximumDiscoveryBboxSpan = 5;
+function normalizedName(value) {
+    return value.normalize("NFKD").replace(/\p{M}/gu, "").toLowerCase().replace(/ı/g, "i").trim();
+}
+export function findDiscoveryCity(data, name, country) {
+    if (!name.trim() || !/^[A-Z]{2}$/i.test(country)) {
+        throw new Error("City and two-letter country code are required, for example --city Istanbul --country TR");
+    }
+    const query = normalizedName(name);
+    const matches = [];
+    for (const line of data.split("\n")) {
+        const cells = line.split("\t");
+        if (cells[8] !== country.toUpperCase())
+            continue;
+        if (![cells[1], cells[2], ...(cells[3] ?? "").split(",")].some((value) => normalizedName(value ?? "") === query))
+            continue;
+        const latitude = Number(cells[4]);
+        const longitude = Number(cells[5]);
+        if (!Number.isFinite(latitude) || !Number.isFinite(longitude))
+            continue;
+        matches.push({ name: cells[1], country: cells[8], region: cells[10], latitude, longitude });
+    }
+    if (!matches.length)
+        throw new Error(`City not found in GeoNames cities15000: ${name}, ${country}. Use --bbox for smaller places.`);
+    if (matches.length > 1)
+        throw new Error(`City is ambiguous: ${name}, ${country}. Use --bbox to select the intended area.`);
+    return matches[0];
+}
+export function parseDiscoveryBbox(value) {
+    const parts = value.split(",");
+    const values = parts.map(Number);
+    if (parts.length !== 4 || parts.some((part) => !part.trim()) || values.some((entry) => !Number.isFinite(entry))) {
+        throw new Error("--bbox must be west,south,east,north in decimal degrees");
+    }
+    const [west, south, east, north] = values;
+    if (west < -180 || east > 180 || south < -90 || north > 90 || west >= east || south >= north) {
+        throw new Error("Invalid --bbox: use increasing longitude/latitude bounds within world coordinates");
+    }
+    if (east - west > maximumDiscoveryBboxSpan || north - south > maximumDiscoveryBboxSpan) {
+        throw new Error(`Search bounds must span at most ${maximumDiscoveryBboxSpan} degrees on each axis`);
+    }
+    return [west, south, east, north];
+}
+export function cityBoundingBox(city, radiusKm = 10) {
+    if (!Number.isFinite(radiusKm) || radiusKm <= 0 || radiusKm > 50)
+        throw new Error("--radius-km must be greater than 0 and at most 50");
+    const dy = radiusKm / 111.32;
+    const dx = dy / Math.cos(city.latitude * Math.PI / 180);
+    return parseDiscoveryBbox([Math.max(-180, city.longitude - dx), Math.max(-90, city.latitude - dy), Math.min(180, city.longitude + dx), Math.min(90, city.latitude + dy)].join(","));
+}
+export async function resolveDiscoveryCity(name, country, cacheDir) {
+    const path = join(cacheDir, "geonames-cities15000.txt");
+    let data;
+    try {
+        const info = await stat(path);
+        if (Date.now() - info.mtimeMs < 30 * 24 * 60 * 60 * 1000 && info.size < 40 * 1024 * 1024)
+            data = await readFile(path, "utf8");
+    }
+    catch (error) {
+        if (!(error && typeof error === "object" && "code" in error && error.code === "ENOENT"))
+            throw error;
+    }
+    if (data === undefined) {
+        const response = await fetch("https://download.geonames.org/export/dump/cities15000.zip", { signal: AbortSignal.timeout(60000) });
+        if (!response.ok || !response.body)
+            throw new Error(`GeoNames city download failed: HTTP ${response.status}`);
+        const reader = response.body.getReader();
+        const chunks = [];
+        let bytes = 0;
+        try {
+            for (;;) {
+                const { value, done } = await reader.read();
+                if (done)
+                    break;
+                bytes += value.length;
+                if (bytes > 20 * 1024 * 1024)
+                    throw new Error("GeoNames download exceeds 20 MB limit");
+                chunks.push(value);
+            }
+        }
+        finally {
+            await reader.cancel();
+        }
+        const files = unzipSync(Buffer.concat(chunks), { filter: (file) => file.name === "cities15000.txt" && file.originalSize < 40 * 1024 * 1024 });
+        if (!files["cities15000.txt"])
+            throw new Error("GeoNames archive has no bounded cities15000.txt dataset");
+        data = strFromU8(files["cities15000.txt"]);
+        // Validate before retaining downloaded content for subsequent runs.
+        const city = findDiscoveryCity(data, name, country);
+        await mkdir(cacheDir, { recursive: true });
+        await writeFile(path, data, "utf8");
+        return city;
+    }
+    return findDiscoveryCity(data, name, country);
+}
+//# sourceMappingURL=discovery-location.js.map

package/dist/discovery-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-location.js","sourceRoot":"","sources":["../src/discovery-location.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAG9C,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAU1C,SAAS,cAAc,CAAC,KAAa;IACnC,OAAO,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY,EAAE,IAAY,EAAE,OAAe;IAC3E,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,yFAAyF,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,WAAW,EAAE;YAAE,SAAS;QACjD,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,IAAI,EAAE,CAAC,KAAK,KAAK,CAAC;YAAE,SAAS;QAC3H,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC;YAAE,SAAS;QACxE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,IAAI,KAAK,OAAO,kCAAkC,CAAC,CAAC;IACpI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,KAAK,OAAO,2CAA2C,CAAC,CAAC;IAC3H,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAa;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAChH,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC;IAC1C,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,IAAI,GAAG,GAAG,IAAI,KAAK,GAAG,CAAC,EAAE,IAAI,KAAK,GAAG,EAAE,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;QAC7F,MAAM,IAAI,KAAK,CAAC,mFAAmF,CAAC,CAAC;IACvG,CAAC;IACD,IAAI,IAAI,GAAG,IAAI,GAAG,wBAAwB,IAAI,KAAK,GAAG,KAAK,GAAG,wBAAwB,EAAE,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,mCAAmC,wBAAwB,uBAAuB,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAmB,EAAE,QAAQ,GAAG,EAAE;IAChE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,IAAI,CAAC,IAAI,QAAQ,GAAG,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvI,MAAM,EAAE,GAAG,QAAQ,GAAG,MAAM,CAAC;IAC7B,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC;IACxD,OAAO,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACtL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,OAAe,EAAE,QAAgB;IACxF,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,0BAA0B,CAAC,CAAC;IACxD,IAAI,IAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;YAAE,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChI,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;YAAE,MAAM,KAAK,CAAC;IACvG,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,2DAA2D,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClI,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9G,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACzC,MAAM,MAAM,GAAiB,EAAE,CAAC;QAChC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,CAAC;YACH,SAAS,CAAC;gBACR,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC5C,IAAI,IAAI;oBAAE,MAAM;gBAChB,KAAK,IAAI,KAAK,CAAC,MAAM,CAAC;gBACtB,IAAI,KAAK,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;gBACvF,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,MAAM,EAAE,CAAC;QACxB,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QAC9I,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC1G,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAC3C,oEAAoE;QACpE,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/dist/discovery-runner.d.ts

@@ -1,5 +1,6 @@
 import { type DiscoveryProviderName, type DiscoverySummary, type ProspectCsvExportPreset, type ProspectExportRow } from "./discovery.js";
 import type { AuditProfile, ReportBrandConfig } from "./types.js";
+import type { DiscoveryCacheInfo } from "./discovery-cache.js";
 export interface DiscoveryRunOptions {
     provider: DiscoveryProviderName;
     query?: string;
@@ -18,11 +19,40 @@ export interface DiscoveryRunOptions {
     minOpportunityScore?: number;
     concurrency: number;
     apiKey?: string;
+    city?: string;
+    country?: string;
+    bbox?: string;
+    radiusKm?: number;
+    release?: string;
+    cacheDir?: string;
+    refreshCache?: boolean;
     managedOutputRoot?: string;
     brand?: ReportBrandConfig;
 }
 export interface DiscoveryRunResult {
     rows: ProspectExportRow[];
     summary: DiscoverySummary;
+    metrics?: {
+        discoveryMs: number;
+        auditMs: number;
+        totalMs: number;
+        cache?: DiscoveryCacheInfo;
+        sourceCoverage?: {
+            denominator: number;
+            website: number;
+            phone: number;
+            email: number;
+            address: number;
+        };
+        websites: Array<{
+            url: string;
+            status: string;
+            durationMs: number;
+            pagesFetched: number;
+            sourceUrls: string[];
+            error?: string;
+            warnings?: string[];
+        }>;
+    };
 }
 export declare function runDiscovery(options: DiscoveryRunOptions): Promise<DiscoveryRunResult>;