open-local-audit 0.67.0 → 0.68.0

package/dist/overture.js

@@ -0,0 +1,319 @@
+import { isIP } from "node:net";
+import { DuckDBInstance } from "@duckdb/node-api";
+import { maximumDiscoveryBboxSpan } from "./discovery-location.js";
+const overtureStacUrl = "https://stac.overturemaps.org/catalog.json";
+const overturePlacesGuideUrl = "https://docs.overturemaps.org/guides/places/";
+const overtureS3BaseUrl = "s3://overturemaps-us-west-2/release";
+const defaultLimit = 25;
+const maximumLimit = 100;
+const defaultTimeoutMs = 90_000;
+const minimumConfidence = 0.5;
+const releasePattern = /^\d{4}-\d{2}-\d{2}\.\d+$/;
+const categoryPattern = /^[a-z][a-z0-9_]{0,80}$/;
+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 const overtureCategoryMappings = {
+    dental: ["dentist", "dental_clinic"],
+    restaurant: ["restaurant"],
+    beauty: ["beauty_salon", "hair_salon", "nail_salon", "spa"],
+    hotel: ["hotel", "motel", "resort_hotel"],
+    gym: ["gym", "fitness_center"]
+};
+function stringOrUndefined(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function stringList(value) {
+    return Array.isArray(value)
+        ? value.map(stringOrUndefined).filter((item) => item !== undefined)
+        : [];
+}
+function numberOrUndefined(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function isPublicHttpUrl(value) {
+    try {
+        const url = new URL(value);
+        const host = url.hostname.toLowerCase().replace(/^\[|\]$/g, "");
+        if (url.protocol !== "http:" && url.protocol !== "https:") {
+            return false;
+        }
+        if (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 firstPublicHttpUrl(value) {
+    const website = stringList(value).find((url) => isPublicHttpUrl(url) && !hasHost(url, socialProfileHosts) && !hasHost(url, shortLinkHosts));
+    return website ? new URL(website).toString() : undefined;
+}
+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 sourceItems(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "object" && item !== null) : [];
+}
+function sourceUrl(item) {
+    const provider = stringOrUndefined(item.provider)?.toLowerCase();
+    const recordId = stringOrUndefined(item.record_id);
+    if ((provider === "meta" || provider === "facebook") && recordId && /^\d+$/.test(recordId)) {
+        return `https://www.facebook.com/${recordId}`;
+    }
+    if (provider === "osm" && recordId) {
+        const match = recordId.match(/^([nwr])(\d+)(?:@\d+)?$/);
+        if (match) {
+            const type = match[1] === "n" ? "node" : match[1] === "w" ? "way" : "relation";
+            return `https://www.openstreetmap.org/${type}/${match[2]}`;
+        }
+    }
+    const resource = stringOrUndefined(item.resource);
+    return resource && isPublicHttpUrl(resource) ? new URL(resource).toString() : undefined;
+}
+function sourceProvenance(items) {
+    return items.map((item) => {
+        const entry = {};
+        const fields = [
+            ["provider", item.provider],
+            ["dataset", item.dataset],
+            ["license", item.license],
+            ["recordId", item.record_id],
+            ["resource", item.resource],
+            ["version", item.version],
+            ["updateTime", item.update_time]
+        ];
+        for (const [name, value] of fields) {
+            const normalized = stringOrUndefined(value);
+            if (normalized) {
+                entry[name] = normalized;
+            }
+        }
+        return entry;
+    });
+}
+function validateBoundingBox(bbox) {
+    const [west, south, east, north] = bbox;
+    if (![west, south, east, north].every(Number.isFinite)) {
+        throw new Error("Bounding box coordinates must be finite numbers");
+    }
+    if (west < -180 || east > 180 || south < -90 || north > 90) {
+        throw new Error("Bounding box coordinates are outside WGS84 limits");
+    }
+    if (west >= east || south >= north) {
+        throw new Error("Bounding box must have west < east and south < north");
+    }
+    if (east - west > maximumDiscoveryBboxSpan || north - south > maximumDiscoveryBboxSpan) {
+        throw new Error(`Bounding box must span at most ${maximumDiscoveryBboxSpan} degrees per axis`);
+    }
+}
+function resolveCategories(category) {
+    const normalized = category.trim().toLowerCase();
+    if (!categoryPattern.test(normalized)) {
+        throw new Error("Unsupported Overture category");
+    }
+    return overtureCategoryMappings[normalized] ?? [normalized];
+}
+function normalizeLimit(limit) {
+    if (limit === undefined) {
+        return defaultLimit;
+    }
+    if (!Number.isInteger(limit) || limit < 1 || limit > maximumLimit) {
+        throw new Error(`Overture limit must be an integer between 1 and ${maximumLimit}`);
+    }
+    return limit;
+}
+function normalizeTimeout(timeoutMs) {
+    if (timeoutMs === undefined) {
+        return defaultTimeoutMs;
+    }
+    if (!Number.isInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 120_000) {
+        throw new Error("Overture timeout must be an integer between 1 and 120000ms");
+    }
+    return timeoutMs;
+}
+function validateRelease(release) {
+    if (!releasePattern.test(release)) {
+        throw new Error("Invalid Overture release");
+    }
+    return release;
+}
+async function fetchLatestRelease(timeoutMs) {
+    let response;
+    try {
+        response = await fetch(overtureStacUrl, { signal: AbortSignal.timeout(timeoutMs) });
+    }
+    catch (error) {
+        throw new Error(`Unable to retrieve the current Overture release: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!response.ok) {
+        throw new Error(`Unable to retrieve the current Overture release: STAC returned HTTP ${response.status}`);
+    }
+    const body = await response.json();
+    const release = typeof body === "object" && body !== null ? body.latest : undefined;
+    return validateRelease(stringOrUndefined(release) ?? "");
+}
+function categorySql(categories) {
+    return categories.map((category) => `'${category}'`).join(", ");
+}
+function buildQuery(release, categories) {
+    const source = `${overtureS3BaseUrl}/${release}/theme=places/type=place/*`;
+    return `
+    SELECT
+      id,
+      names.primary AS label,
+      addresses[1].freeform AS address,
+      addresses[1].country AS country,
+      addresses[1].locality AS locality,
+      addresses[1].region AS region,
+      bbox.ymin AS latitude,
+      bbox.xmin AS longitude,
+      websites,
+      phones,
+      emails,
+      socials,
+      sources,
+      confidence,
+      operating_status
+    FROM read_parquet('${source}')
+    WHERE bbox.xmin BETWEEN $west AND $east
+      AND bbox.ymin BETWEEN $south AND $north
+      AND (
+        taxonomy.primary IN (${categorySql(categories)})
+        OR list_has_any(taxonomy.hierarchy, [${categorySql(categories)}])
+      )
+      AND (confidence IS NULL OR confidence >= ${minimumConfidence})
+      AND (operating_status IS NULL OR lower(operating_status) <> 'closed_permanently')
+    ORDER BY id ASC
+    LIMIT $limit
+  `;
+}
+async function runWithinDeadline(operation, connection, deadline, timeoutMs) {
+    const settledOperation = Promise.resolve(operation);
+    const remainingMs = deadline - Date.now();
+    const timeoutError = new Error(`Overture query timed out after ${timeoutMs}ms`);
+    if (remainingMs <= 0) {
+        connection.interrupt();
+        void settledOperation.catch(() => undefined);
+        throw timeoutError;
+    }
+    let timer;
+    let timedOut = false;
+    try {
+        return await Promise.race([
+            settledOperation,
+            new Promise((_resolve, reject) => {
+                timer = setTimeout(() => {
+                    timedOut = true;
+                    reject(timeoutError);
+                    queueMicrotask(() => connection.interrupt());
+                }, remainingMs);
+            })
+        ]);
+    }
+    finally {
+        if (timer) {
+            clearTimeout(timer);
+        }
+        if (timedOut) {
+            void settledOperation.catch(() => undefined);
+        }
+    }
+}
+function mapCandidate(row, category, defaultProfile, release, retrievedAt) {
+    const sourceId = stringOrUndefined(row.id);
+    if (!sourceId) {
+        return undefined;
+    }
+    const sources = sourceItems(row.sources);
+    const sourceUrls = [...new Set(sources.map(sourceUrl).filter((url) => url !== undefined))];
+    const candidate = {
+        source: "overture",
+        sourceId,
+        label: stringOrUndefined(row.label),
+        segment: category,
+        profile: defaultProfile,
+        sourceMetadata: {
+            address: stringOrUndefined(row.address),
+            country: stringOrUndefined(row.country),
+            locality: stringOrUndefined(row.locality),
+            region: stringOrUndefined(row.region),
+            latitude: numberOrUndefined(row.latitude),
+            longitude: numberOrUndefined(row.longitude),
+            phones: stringList(row.phones),
+            emails: stringList(row.emails),
+            socials: [...new Set([...stringList(row.socials).filter(isPublicHttpUrl), ...stringList(row.websites).filter((url) => isPublicHttpUrl(url) && hasHost(url, socialProfileHosts))])],
+            confidence: numberOrUndefined(row.confidence),
+            operatingStatus: stringOrUndefined(row.operating_status),
+            datasetRelease: release,
+            sourceUrl: sourceUrls[0] ?? overturePlacesGuideUrl,
+            sourceUrls,
+            sourceProvenance: sourceProvenance(sources),
+            retrievedAt
+        }
+    };
+    const websiteUri = firstPublicHttpUrl(row.websites);
+    return websiteUri ? { ...candidate, websiteUri } : candidate;
+}
+export async function fetchOvertureCandidates(options) {
+    validateBoundingBox(options.bbox);
+    const categories = resolveCategories(options.category);
+    const limit = normalizeLimit(options.limit);
+    const timeoutMs = normalizeTimeout(options.timeoutMs);
+    const deadline = Date.now() + timeoutMs;
+    const release = options.release ? validateRelease(options.release) : await fetchLatestRelease(Math.max(1, deadline - Date.now()));
+    const [west, south, east, north] = options.bbox;
+    const instance = await DuckDBInstance.create(":memory:", { threads: "2", memory_limit: "256MB" });
+    let connection;
+    try {
+        connection = await instance.connect();
+        await runWithinDeadline(connection.run("INSTALL httpfs"), connection, deadline, timeoutMs);
+        await runWithinDeadline(connection.run("LOAD httpfs"), connection, deadline, timeoutMs);
+        await runWithinDeadline(connection.run("SET http_timeout=15"), connection, deadline, timeoutMs);
+        await runWithinDeadline(connection.run("SET http_retries=1"), connection, deadline, timeoutMs);
+        await runWithinDeadline(connection.run("SET s3_region='us-west-2'"), connection, deadline, timeoutMs);
+        const reader = await runWithinDeadline(connection.runAndReadAll(buildQuery(release, categories), { west, south, east, north, limit }), connection, deadline, timeoutMs);
+        const retrievedAt = new Date().toISOString();
+        const candidates = reader
+            .getRowObjectsJS()
+            .map((row) => mapCandidate(row, options.category.trim().toLowerCase(), options.defaultProfile, release, retrievedAt))
+            .filter((candidate) => candidate !== undefined)
+            .filter((candidate) => {
+            const metadata = candidate.sourceMetadata ?? {};
+            const confidence = numberOrUndefined(metadata.confidence);
+            const operatingStatus = stringOrUndefined(metadata.operatingStatus)?.toLowerCase();
+            return operatingStatus !== "closed_permanently" && (confidence === undefined || confidence >= minimumConfidence);
+        })
+            .sort((left, right) => left.sourceId.localeCompare(right.sourceId));
+        return candidates.filter((candidate, index) => index === 0 || candidate.sourceId !== candidates[index - 1]?.sourceId);
+    }
+    finally {
+        connection?.closeSync();
+        instance.closeSync();
+    }
+}
+//# sourceMappingURL=overture.js.map

package/dist/overture.js.map

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

package/dist/schema.d.ts

@@ -5,7 +5,7 @@ export declare const failOnSchema: z.ZodEnum<["none", "high", "medium", "low"]>;
 export declare const batchIndexSortSchema: z.ZodEnum<["score-asc", "severity-desc"]>;
 export declare const exportPresetSchema: z.ZodEnum<["standard", "crm"]>;
 export declare const auditProfileSchema: z.ZodEnum<["generic", "dental", "beauty", "restaurant", "contractor", "lawyer", "clinic", "gym", "hotel", "auto-service"]>;
-export declare const discoveryProviderSchema: z.ZodEnum<["manual-csv", "google-places"]>;
+export declare const discoveryProviderSchema: z.ZodEnum<["manual-csv", "google-places", "overture"]>;
 export declare const cliOptionsSchema: z.ZodObject<{
     format: z.ZodDefault<z.ZodEnum<["json", "markdown", "html", "pdf", "all"]>>;
     out: z.ZodOptional<z.ZodString>;
@@ -23,7 +23,12 @@ export declare const cliOptionsSchema: z.ZodObject<{
     profile: z.ZodDefault<z.ZodEnum<["generic", "dental", "beauty", "restaurant", "contractor", "lawyer", "clinic", "gym", "hotel", "auto-service"]>>;
     exportCsv: z.ZodOptional<z.ZodString>;
     exportPreset: z.ZodDefault<z.ZodEnum<["standard", "crm"]>>;
-    provider: z.ZodDefault<z.ZodEnum<["manual-csv", "google-places"]>>;
+    provider: z.ZodDefault<z.ZodEnum<["manual-csv", "google-places", "overture"]>>;
+    city: z.ZodOptional<z.ZodString>;
+    country: z.ZodOptional<z.ZodString>;
+    bbox: z.ZodOptional<z.ZodString>;
+    radiusKm: z.ZodDefault<z.ZodNumber>;
+    release: z.ZodOptional<z.ZodString>;
     dryRun: z.ZodDefault<z.ZodBoolean>;
     limit: z.ZodDefault<z.ZodNumber>;
     maxAudits: z.ZodOptional<z.ZodNumber>;
@@ -53,7 +58,8 @@ export declare const cliOptionsSchema: z.ZodObject<{
     format: "html" | "json" | "markdown" | "pdf" | "all";
     concurrency: number;
     exportPreset: "standard" | "crm";
-    provider: "manual-csv" | "google-places";
+    provider: "manual-csv" | "google-places" | "overture";
+    radiusKm: number;
     dryRun: boolean;
     limit: number;
     timeout: number;
@@ -70,6 +76,10 @@ export declare const cliOptionsSchema: z.ZodObject<{
     auditStatus?: string | undefined;
     hasWebsite?: string | undefined;
     exportCsv?: string | undefined;
+    city?: string | undefined;
+    country?: string | undefined;
+    bbox?: string | undefined;
+    release?: string | undefined;
     maxAudits?: number | undefined;
     summaryJson?: string | undefined;
     suppressionList?: string | undefined;
@@ -100,7 +110,12 @@ export declare const cliOptionsSchema: z.ZodObject<{
     concurrency?: number | undefined;
     exportCsv?: string | undefined;
     exportPreset?: "standard" | "crm" | undefined;
-    provider?: "manual-csv" | "google-places" | undefined;
+    provider?: "manual-csv" | "google-places" | "overture" | undefined;
+    city?: string | undefined;
+    country?: string | undefined;
+    bbox?: string | undefined;
+    radiusKm?: number | undefined;
+    release?: string | undefined;
     dryRun?: boolean | undefined;
     limit?: number | undefined;
     maxAudits?: number | undefined;

package/dist/schema.js

@@ -29,7 +29,7 @@ export const auditProfileSchema = z.enum([
     "hotel",
     "auto-service"
 ]);
-export const discoveryProviderSchema = z.enum(["manual-csv", "google-places"]);
+export const discoveryProviderSchema = z.enum(["manual-csv", "google-places", "overture"]);
 export const cliOptionsSchema = z.object({
     format: outputFormatSchema.default("markdown"),
     out: z.string().optional(),
@@ -48,6 +48,11 @@ export const cliOptionsSchema = z.object({
     exportCsv: z.string().optional(),
     exportPreset: exportPresetSchema.default("standard"),
     provider: discoveryProviderSchema.default("manual-csv"),
+    city: z.string().trim().min(1).optional(),
+    country: z.string().trim().regex(/^[A-Za-z]{2}$/).optional(),
+    bbox: z.string().trim().min(1).optional(),
+    radiusKm: z.coerce.number().positive().max(50).default(10),
+    release: z.string().regex(/^\d{4}-\d{2}-\d{2}\.\d+$/).optional(),
     dryRun: z.boolean().default(false),
     limit: z.coerce.number().int().positive().default(10),
     maxAudits: z.coerce.number().int().min(0).optional(),

package/dist/schema.js.map

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

package/dist/website-enrichment.d.ts

@@ -0,0 +1,21 @@
+import type { PageSnapshot, PublicContact } from "./types.js";
+type Resolver = (hostname: string) => Promise<string[]>;
+export interface WebsiteEnrichmentResult {
+    status: "success" | "blocked" | "failed";
+    snapshot?: PageSnapshot;
+    contact?: PublicContact;
+    sourceUrls: string[];
+    pagesFetched: number;
+    durationMs: number;
+    error?: string;
+    warnings?: string[];
+}
+export interface WebsiteEnrichmentOptions {
+    timeoutMs?: number;
+    maxPages?: number;
+    fetch?: typeof fetch;
+    /** Test seam for deterministic DNS checks. Production uses Node's resolver. */
+    resolve?: Resolver;
+}
+export declare function enrichWebsite(url: string, options?: WebsiteEnrichmentOptions): Promise<WebsiteEnrichmentResult>;
+export {};