@mailwoman/corpus 2.0.0

package/out/src/adapter.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Adapter framework helpers — the pieces every corpus adapter and the runner share.
+ *
+ *   This file does **not** define `CorpusAdapter` (that lives in `./types.ts`, which is the single
+ *   canonical schema module). It exposes:
+ *
+ *   - `AdapterRegistry`: a tiny lookup table the CLI + build pipeline use to find adapters by id.
+ *   - `InMemoryAdapterRegistry`: the default implementation.
+ *   - `stableSourceId(adapterId, components)`: deterministic content-addressed id for adapters whose
+ *       source data has no native primary key (CSV, GeoJSON).
+ *   - `canonicalDedupKey(row)`: normalized signature used to drop near-identical rows during a run.
+ *       Adapter-internal dedup; cross-adapter dedup is the runner's job.
+ *   - `streamingSha256()`: thin wrapper around `node:crypto` so the runner can hash JSONL output as it
+ *       streams (avoids re-reading the shard for the manifest checksum).
+ *
+ *   Everything here is pure (no I/O); side-effecting code goes in `./runner.ts`.
+ */
+import type { ComponentTag } from "@mailwoman/core/types";
+import type { CanonicalRow, CorpusAdapter } from "./types.js";
+/**
+ * Lookup table for corpus adapters.
+ *
+ * The CLI's `npx mailwoman corpus run <adapter-id>` resolves `<adapter-id>` against this registry;
+ * the same registry is iterated by the `corpus build` pipeline. Adapters do not self-register at
+ * module load — they're added explicitly so the dependency graph stays traceable.
+ */
+export interface AdapterRegistry {
+    /** Add an adapter. Throws if `adapter.id` is already registered. */
+    register(adapter: CorpusAdapter): void;
+    /** Return the adapter for `id`, or `undefined`. */
+    get(id: string): CorpusAdapter | undefined;
+    /** All registered adapters, in insertion order. */
+    list(): readonly CorpusAdapter[];
+    /** Convenience: ids only, in insertion order. */
+    ids(): readonly string[];
+}
+/**
+ * Default in-memory registry. The runner constructs one per invocation; the CLI re-uses a shared
+ * singleton (`defaultAdapterRegistry`) populated by `./adapters/index.ts` as adapters come online.
+ */
+export declare class InMemoryAdapterRegistry implements AdapterRegistry {
+    #private;
+    register(adapter: CorpusAdapter): void;
+    get(id: string): CorpusAdapter | undefined;
+    list(): readonly CorpusAdapter[];
+    ids(): readonly string[];
+}
+/**
+ * Process-wide default registry. Populated by `./adapters/index.ts` as adapters are built; imported
+ * by the CLI. Tests should construct their own `InMemoryAdapterRegistry` to avoid cross-test
+ * pollution.
+ */
+export declare const defaultAdapterRegistry: InMemoryAdapterRegistry;
+/**
+ * Deterministic content-addressed source id.
+ *
+ * For adapters whose upstream source has no native primary key (CSV rows, GeoJSON features), the
+ * runner expects a stable id so dedup, holdout manifests, and resumability work across reruns. This
+ * helper produces one by hashing the adapter id and a canonical serialization of the components
+ * dict (keys sorted, values verbatim).
+ *
+ * Output format: `<adapterId>-<first-12-hex-chars-of-sha256>`. 48 bits of entropy is enough for
+ * ~17M rows per adapter before the expected collision count exceeds 1 (birthday paradox); adapters
+ * with more rows should extend the prefix length.
+ */
+export declare function stableSourceId(adapterId: string, components: Partial<Record<ComponentTag, string>>): string;
+/**
+ * Canonical dedup key for a row.
+ *
+ * Two rows that share this key are treated as duplicates and only the first wins. The key is built
+ * from `country`, the sorted `components` dict, and a normalized `raw` (lower-cased, whitespace
+ * collapsed). License and provenance fields are intentionally excluded so the same address from
+ * multiple adapters is recognized as a duplicate.
+ *
+ * Synthetic rows are never deduplicated against natural rows: `synth.method` is folded into the key
+ * when present, ensuring each augmentation variant survives.
+ */
+export declare function canonicalDedupKey(row: CanonicalRow): string;
+/**
+ * Streaming SHA-256 hasher.
+ *
+ * The runner feeds every JSONL line into one of these so the per-shard checksum can be recorded in
+ * `MANIFEST.json` without a second pass over the shard. Implementation is a one-line wrapper, but
+ * giving it a name keeps the runner's hash-tracking intent obvious.
+ */
+export interface StreamingHasher {
+    update(chunk: string | Uint8Array): void;
+    digest(): string;
+}
+/** Default `StreamingHasher` (SHA-256, hex). */
+export declare function streamingSha256(): StreamingHasher;
+//# sourceMappingURL=adapter.d.ts.map

package/out/src/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAEzD,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAA;IAEtC,mDAAmD;IACnD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;IAE1C,mDAAmD;IACnD,IAAI,IAAI,SAAS,aAAa,EAAE,CAAA;IAEhC,iDAAiD;IACjD,GAAG,IAAI,SAAS,MAAM,EAAE,CAAA;CACxB;AAED;;;GAGG;AACH,qBAAa,uBAAwB,YAAW,eAAe;;IAG9D,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAOtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI1C,IAAI,IAAI,SAAS,aAAa,EAAE;IAIhC,GAAG,IAAI,SAAS,MAAM,EAAE;CAGxB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,yBAAgC,CAAA;AAEnE;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAK3G;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,MAAM,CAM3D;AAED;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC/B,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAA;IACxC,MAAM,IAAI,MAAM,CAAA;CAChB;AAED,gDAAgD;AAChD,wBAAgB,eAAe,IAAI,eAAe,CAiBjD"}

package/out/src/adapter.js

@@ -0,0 +1,107 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Adapter framework helpers — the pieces every corpus adapter and the runner share.
+ *
+ *   This file does **not** define `CorpusAdapter` (that lives in `./types.ts`, which is the single
+ *   canonical schema module). It exposes:
+ *
+ *   - `AdapterRegistry`: a tiny lookup table the CLI + build pipeline use to find adapters by id.
+ *   - `InMemoryAdapterRegistry`: the default implementation.
+ *   - `stableSourceId(adapterId, components)`: deterministic content-addressed id for adapters whose
+ *       source data has no native primary key (CSV, GeoJSON).
+ *   - `canonicalDedupKey(row)`: normalized signature used to drop near-identical rows during a run.
+ *       Adapter-internal dedup; cross-adapter dedup is the runner's job.
+ *   - `streamingSha256()`: thin wrapper around `node:crypto` so the runner can hash JSONL output as it
+ *       streams (avoids re-reading the shard for the manifest checksum).
+ *
+ *   Everything here is pure (no I/O); side-effecting code goes in `./runner.ts`.
+ */
+import { createHash } from "node:crypto";
+/**
+ * Default in-memory registry. The runner constructs one per invocation; the CLI re-uses a shared
+ * singleton (`defaultAdapterRegistry`) populated by `./adapters/index.ts` as adapters come online.
+ */
+export class InMemoryAdapterRegistry {
+    #byId = new Map();
+    register(adapter) {
+        if (this.#byId.has(adapter.id)) {
+            throw new Error(`AdapterRegistry: id ${JSON.stringify(adapter.id)} already registered`);
+        }
+        this.#byId.set(adapter.id, adapter);
+    }
+    get(id) {
+        return this.#byId.get(id);
+    }
+    list() {
+        return Array.from(this.#byId.values());
+    }
+    ids() {
+        return Array.from(this.#byId.keys());
+    }
+}
+/**
+ * Process-wide default registry. Populated by `./adapters/index.ts` as adapters are built; imported
+ * by the CLI. Tests should construct their own `InMemoryAdapterRegistry` to avoid cross-test
+ * pollution.
+ */
+export const defaultAdapterRegistry = new InMemoryAdapterRegistry();
+/**
+ * Deterministic content-addressed source id.
+ *
+ * For adapters whose upstream source has no native primary key (CSV rows, GeoJSON features), the
+ * runner expects a stable id so dedup, holdout manifests, and resumability work across reruns. This
+ * helper produces one by hashing the adapter id and a canonical serialization of the components
+ * dict (keys sorted, values verbatim).
+ *
+ * Output format: `<adapterId>-<first-12-hex-chars-of-sha256>`. 48 bits of entropy is enough for
+ * ~17M rows per adapter before the expected collision count exceeds 1 (birthday paradox); adapters
+ * with more rows should extend the prefix length.
+ */
+export function stableSourceId(adapterId, components) {
+    const sortedKeys = Object.keys(components).sort();
+    const payload = sortedKeys.map((k) => `${k}=${components[k] ?? ""}`).join("\x1f");
+    const digest = createHash("sha256").update(adapterId).update("\x1e").update(payload).digest("hex");
+    return `${adapterId}-${digest.slice(0, 12)}`;
+}
+/**
+ * Canonical dedup key for a row.
+ *
+ * Two rows that share this key are treated as duplicates and only the first wins. The key is built
+ * from `country`, the sorted `components` dict, and a normalized `raw` (lower-cased, whitespace
+ * collapsed). License and provenance fields are intentionally excluded so the same address from
+ * multiple adapters is recognized as a duplicate.
+ *
+ * Synthetic rows are never deduplicated against natural rows: `synth.method` is folded into the key
+ * when present, ensuring each augmentation variant survives.
+ */
+export function canonicalDedupKey(row) {
+    const sortedKeys = Object.keys(row.components).sort();
+    const compPart = sortedKeys.map((k) => `${k}=${row.components[k] ?? ""}`).join("\x1f");
+    const rawNorm = row.raw.toLowerCase().replace(/\s+/g, " ").trim();
+    const synthPart = row.synth ? `\x1e${row.synth.method}` : "";
+    return `${row.country}\x1e${rawNorm}\x1e${compPart}${synthPart}`;
+}
+/** Default `StreamingHasher` (SHA-256, hex). */
+export function streamingSha256() {
+    const h = createHash("sha256");
+    let finalized = false;
+    let digestHex = "";
+    return {
+        update(chunk) {
+            if (finalized)
+                throw new Error("streamingSha256: update() called after digest()");
+            h.update(typeof chunk === "string" ? chunk : chunk);
+        },
+        digest() {
+            if (!finalized) {
+                digestHex = h.digest("hex");
+                finalized = true;
+            }
+            return digestHex;
+        },
+    };
+}
+//# sourceMappingURL=adapter.js.map

package/out/src/adapter.js.map

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

package/out/src/adapters/ban/adapter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `ban`: Base Adresse Nationale CSV adapter (FR street-level).
+ *
+ *   Input: a CSV dump from `adresse.data.gouv.fr` (semicolon-separated, ~25M rows nationally). The
+ *   adapter only reads the small set of columns needed for the corpus:
+ *
+ *   - `numero` → `house_number`
+ *   - `rep` → repetition index ("bis", "ter") appended to house_number
+ *   - `nom_voie` → `street` (full road name; includes the prefix "Rue", "Avenue", etc.)
+ *   - `code_postal` → `postcode`
+ *   - `nom_commune` → `locality`
+ *
+ *   `region` and `country` are not in BAN. The adapter stamps `country: "FR"` on every row; region is
+ *   left for the wof-postalcode + wof-admin cross-reference at corpus build time (a future pass;
+ *   for Phase 1 the row's region is simply absent).
+ *
+ *   License: ODbL / Licence Ouverte. Stamped onto every row as `ODbL-1.0` (the OpenStreetMap-
+ *   compatible label most consumers expect).
+ *
+ *   The adapter is streaming-aware: it uses `csv-parse` in streaming mode so a 25M-row dump never
+ *   sits in memory. Honors `opts.limit` for fixture / smoke runs, `opts.signal` for cancellation,
+ *   and `opts.country` for a self-consistency check (errors if country !== FR).
+ */
+import type { CorpusAdapter } from "../../types.js";
+export declare const BAN_ADAPTER_ID = "ban";
+export declare function createBanAdapter(): CorpusAdapter;
+export declare const banAdapter: CorpusAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/out/src/adapters/ban/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/ban/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAMH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEjF,eAAO,MAAM,cAAc,QAAQ,CAAA;AA4CnC,wBAAgB,gBAAgB,IAAI,aAAa,CAqEhD;AAED,eAAO,MAAM,UAAU,eAAqB,CAAA"}

package/out/src/adapters/ban/adapter.js

@@ -0,0 +1,133 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `ban`: Base Adresse Nationale CSV adapter (FR street-level).
+ *
+ *   Input: a CSV dump from `adresse.data.gouv.fr` (semicolon-separated, ~25M rows nationally). The
+ *   adapter only reads the small set of columns needed for the corpus:
+ *
+ *   - `numero` → `house_number`
+ *   - `rep` → repetition index ("bis", "ter") appended to house_number
+ *   - `nom_voie` → `street` (full road name; includes the prefix "Rue", "Avenue", etc.)
+ *   - `code_postal` → `postcode`
+ *   - `nom_commune` → `locality`
+ *
+ *   `region` and `country` are not in BAN. The adapter stamps `country: "FR"` on every row; region is
+ *   left for the wof-postalcode + wof-admin cross-reference at corpus build time (a future pass;
+ *   for Phase 1 the row's region is simply absent).
+ *
+ *   License: ODbL / Licence Ouverte. Stamped onto every row as `ODbL-1.0` (the OpenStreetMap-
+ *   compatible label most consumers expect).
+ *
+ *   The adapter is streaming-aware: it uses `csv-parse` in streaming mode so a 25M-row dump never
+ *   sits in memory. Honors `opts.limit` for fixture / smoke runs, `opts.signal` for cancellation,
+ *   and `opts.country` for a self-consistency check (errors if country !== FR).
+ */
+import { parse as csvParse } from "csv-parse";
+import { createReadStream } from "node:fs";
+import { stableSourceId } from "../../adapter.js";
+import { reconcileComponents } from "../../format.js";
+export const BAN_ADAPTER_ID = "ban";
+/**
+ * Compose `house_number` from `numero` + `rep`. BAN uses `rep` for repetition indices ("bis",
+ * "ter", "quater") that follow the house number. Result: `"10 bis"`, `"45"`, etc.
+ */
+function composeHouseNumber(numero, rep) {
+    const n = numero.trim();
+    const r = rep.trim();
+    if (!n)
+        return "";
+    return r ? `${n} ${r}` : n;
+}
+/**
+ * Compose the raw FR-style address line. Two common BAN-derived shapes:
+ *
+ * "10 bis Avenue des Champs-Élysées, 75008 Paris" "45 Cours Lafayette, 69003 Lyon"
+ *
+ * FR convention puts postcode on the same line as the locality, comma-separated from the street.
+ * The adapter renders that directly rather than relying on OpenCage's template — BAN already gives
+ * us the canonical FR strings; the template would round-trip identically.
+ */
+function composeRaw(house, street, postcode, locality) {
+    const parts = [];
+    const streetPart = [house, street].filter(Boolean).join(" ").trim();
+    if (streetPart)
+        parts.push(streetPart);
+    const cityPart = [postcode, locality].filter(Boolean).join(" ").trim();
+    if (cityPart)
+        parts.push(cityPart);
+    return parts.join(", ").replace(/\s+/g, " ").trim();
+}
+export function createBanAdapter() {
+    return {
+        id: BAN_ADAPTER_ID,
+        defaultLicense: "ODbL-1.0",
+        description: "Base Adresse Nationale (FR): house-number-level street addresses (~25M rows).",
+        async *rows(opts) {
+            if (opts.country && opts.country !== "FR") {
+                throw new Error(`ban adapter: only FR supported, got country=${opts.country}`);
+            }
+            const stream = createReadStream(opts.inputPath, { encoding: "utf8" });
+            const parser = stream.pipe(csvParse({
+                delimiter: ";",
+                columns: true,
+                skip_empty_lines: true,
+                relax_quotes: true,
+                relax_column_count: true,
+            }));
+            let emitted = 0;
+            try {
+                for await (const record of parser) {
+                    if (opts.signal?.aborted)
+                        break;
+                    if (opts.limit !== undefined && emitted >= opts.limit)
+                        break;
+                    const house = composeHouseNumber(record.numero ?? "", record.rep ?? "");
+                    const street = (record.nom_voie ?? "").trim();
+                    const postcode = (record.code_postal ?? "").trim();
+                    const locality = (record.nom_commune ?? "").trim();
+                    if (!street || !locality)
+                        continue;
+                    if (!house && !postcode)
+                        continue;
+                    const components = {};
+                    if (house)
+                        components.house_number = house;
+                    if (street)
+                        components.street = street;
+                    if (postcode)
+                        components.postcode = postcode;
+                    if (locality)
+                        components.locality = locality;
+                    const raw = composeRaw(house, street, postcode, locality);
+                    if (!raw)
+                        continue;
+                    const aligned = reconcileComponents(components, raw);
+                    if (Object.keys(aligned).length === 0)
+                        continue;
+                    const sourceId = record.id?.trim()
+                        ? `${BAN_ADAPTER_ID}-${record.id.trim()}`
+                        : stableSourceId(BAN_ADAPTER_ID, aligned);
+                    yield {
+                        raw,
+                        components: aligned,
+                        country: "FR",
+                        locale: "fr-FR",
+                        source: BAN_ADAPTER_ID,
+                        source_id: sourceId,
+                        corpus_version: "",
+                        license: "ODbL-1.0",
+                    };
+                    emitted++;
+                }
+            }
+            finally {
+                stream.destroy();
+            }
+        },
+    };
+}
+export const banAdapter = createBanAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/src/adapters/ban/adapter.js.map

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

package/out/src/adapters/fcc-bdc/adapter.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `fcc-bdc`: FCC Broadband Data Collection (BDC) — Fabric-derived location consumer.
+ *
+ *   The first member of Phase 1.6's "adversarial sources" class. BDC ships the public-domain US
+ *   broadband-serviceable-location (BSL) fabric: ~120M addresses keyed by stable `location_id`,
+ *   carrying `address_primary` + `city` + `state` + `zip` + `zip_suffix`. Compared to the clean
+ *   gazetteer rows from WOF / TIGER / BAN, BDC carries the chaos of address data that has passed
+ *   through several layers of human entry + automated geocoding + revision: abbreviation drift,
+ *   inconsistent unit designators, "RR" / "HC" / "PSC" rural-route shapes, embedded apartment /
+ *   suite numbers that did not survive the address parser cleanly. This is the highest-signal,
+ *   hardest-to-normalize address corpus in the federal public-domain catalog.
+ *
+ *   Following the `tiger` / `wof-admin` pattern, this adapter consumes a SQLite database the operator
+ *   pre-builds via the isp-nexus BDC ETL (`/srv/isp-nexus/sync/fcc/bdc/`) or any equivalent
+ *   host-side pipeline. The mailwoman side does not download or parse the raw CSV/ZIP distribution
+ *   directly — that keeps the adapter narrow and the BDC ingest pluggable.
+ *
+ *   The SQLite schema is documented in README.md and modeled after `NTIARecord`
+ *   (`isp-nexus/fcc/bdc/data-collection.ts`): one row per `location_id`. The adapter splits
+ *   `address_primary` into `house_number` (leading numeric prefix, if any) + `street` (everything
+ *   after), and combines `zip` + `zip_suffix` into the canonical USPS `postcode` slot.
+ *
+ *   One CanonicalRow per fabric record. Unlike `tiger` (multiple postcode variants per segment) or
+ *   `wof-admin` (multiple hierarchy variants per place), BDC records already represent fully
+ *   specified addresses; no fan-out is warranted. Adversarial composition (Phase 1.6 §2.1) is the
+ *   mechanism for deriving multiple training rows per BDC record.
+ *
+ *   License: stamped `"Public Domain"` per the BDC fabric's US federal-government distribution terms.
+ *   The CostQuest Fabric source data has its own license; consumers who substitute that path should
+ *   re-stamp accordingly.
+ */
+import type { CorpusAdapter } from "../../types.js";
+export declare const FCC_BDC_ADAPTER_ID = "fcc-bdc";
+export declare const FCC_BDC_DEFAULT_LICENSE = "Public Domain";
+interface SplitAddress {
+    house_number?: string;
+    street: string;
+}
+export declare function splitAddressPrimary(address: string): SplitAddress | null;
+/**
+ * Combine `zip` + optional `zip_suffix` into the canonical USPS postcode surface form.
+ *
+ * NTIARecord doc is ambiguous about whether `zip_suffix` is the 4-digit extension alone or the full
+ * ZIP+4 string. This handles both:
+ *
+ * - Bare 4-digit extension (`zip="94103"`, `zip_suffix="1234"`) → `"94103-1234"`
+ * - Already-joined form (`zip_suffix="94103-1234"`) → returned as-is
+ * - No suffix → bare `zip`
+ *
+ * Empty / whitespace-only suffix is treated as missing.
+ */
+export declare function buildPostcode(zip: string, suffix: string | null): string;
+/** Build a BDC adapter. Pure factory so multiple instances can be created in tests. */
+export declare function createFccBdcAdapter(): CorpusAdapter;
+export declare const fccBdcAdapter: CorpusAdapter;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/out/src/adapters/fcc-bdc/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../src/adapters/fcc-bdc/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAKH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAEjF,eAAO,MAAM,kBAAkB,YAAY,CAAA;AAC3C,eAAO,MAAM,uBAAuB,kBAAkB,CAAA;AA0BtD,UAAU,YAAY;IACrB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,CAAA;CACd;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAQxE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAOxE;AAED,uFAAuF;AACvF,wBAAgB,mBAAmB,IAAI,aAAa,CAgEnD;AAED,eAAO,MAAM,aAAa,eAAwB,CAAA"}

package/out/src/adapters/fcc-bdc/adapter.js

@@ -0,0 +1,153 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `fcc-bdc`: FCC Broadband Data Collection (BDC) — Fabric-derived location consumer.
+ *
+ *   The first member of Phase 1.6's "adversarial sources" class. BDC ships the public-domain US
+ *   broadband-serviceable-location (BSL) fabric: ~120M addresses keyed by stable `location_id`,
+ *   carrying `address_primary` + `city` + `state` + `zip` + `zip_suffix`. Compared to the clean
+ *   gazetteer rows from WOF / TIGER / BAN, BDC carries the chaos of address data that has passed
+ *   through several layers of human entry + automated geocoding + revision: abbreviation drift,
+ *   inconsistent unit designators, "RR" / "HC" / "PSC" rural-route shapes, embedded apartment /
+ *   suite numbers that did not survive the address parser cleanly. This is the highest-signal,
+ *   hardest-to-normalize address corpus in the federal public-domain catalog.
+ *
+ *   Following the `tiger` / `wof-admin` pattern, this adapter consumes a SQLite database the operator
+ *   pre-builds via the isp-nexus BDC ETL (`/srv/isp-nexus/sync/fcc/bdc/`) or any equivalent
+ *   host-side pipeline. The mailwoman side does not download or parse the raw CSV/ZIP distribution
+ *   directly — that keeps the adapter narrow and the BDC ingest pluggable.
+ *
+ *   The SQLite schema is documented in README.md and modeled after `NTIARecord`
+ *   (`isp-nexus/fcc/bdc/data-collection.ts`): one row per `location_id`. The adapter splits
+ *   `address_primary` into `house_number` (leading numeric prefix, if any) + `street` (everything
+ *   after), and combines `zip` + `zip_suffix` into the canonical USPS `postcode` slot.
+ *
+ *   One CanonicalRow per fabric record. Unlike `tiger` (multiple postcode variants per segment) or
+ *   `wof-admin` (multiple hierarchy variants per place), BDC records already represent fully
+ *   specified addresses; no fan-out is warranted. Adversarial composition (Phase 1.6 §2.1) is the
+ *   mechanism for deriving multiple training rows per BDC record.
+ *
+ *   License: stamped `"Public Domain"` per the BDC fabric's US federal-government distribution terms.
+ *   The CostQuest Fabric source data has its own license; consumers who substitute that path should
+ *   re-stamp accordingly.
+ */
+import Database from "better-sqlite3";
+import { lookupStateAbbreviation } from "../../codex/us-fips-state.js";
+import { formatAddress, reconcileComponents } from "../../format.js";
+export const FCC_BDC_ADAPTER_ID = "fcc-bdc";
+export const FCC_BDC_DEFAULT_LICENSE = "Public Domain";
+/**
+ * Split `address_primary` into a `(house_number, street)` pair.
+ *
+ * BDC's `address_primary` follows USPS Publication 28 conventions but with hand-entry drift. The
+ * canonical leading-digit prefix is the house number (`"123 Main St"`, `"6450 W Indian School Rd"`,
+ * even hyphenated forms `"40-12 Bell Blvd"`). Anything that doesn't match the prefix shape (`"PO
+ * Box 1234"`, `"RR 2 Box 67"`, `"HC 1"`) is left as a single `street` value — the model sees the
+ * original surface form, and downstream classifiers/po-box handling can pick it up.
+ *
+ * The regex tolerates one trailing letter (`"123A Main St"`) and an optional hyphenated half
+ * (`"40-12"`) which is common in NYC + suburban garden-apartment numbering.
+ */
+const HOUSE_NUMBER_PREFIX = /^(\d+(?:-\d+)?[A-Za-z]?)\s+(.+)$/;
+export function splitAddressPrimary(address) {
+    const trimmed = address.trim();
+    if (!trimmed)
+        return null;
+    const match = HOUSE_NUMBER_PREFIX.exec(trimmed);
+    if (match) {
+        return { house_number: match[1], street: match[2].trim() };
+    }
+    return { street: trimmed };
+}
+/**
+ * Combine `zip` + optional `zip_suffix` into the canonical USPS postcode surface form.
+ *
+ * NTIARecord doc is ambiguous about whether `zip_suffix` is the 4-digit extension alone or the full
+ * ZIP+4 string. This handles both:
+ *
+ * - Bare 4-digit extension (`zip="94103"`, `zip_suffix="1234"`) → `"94103-1234"`
+ * - Already-joined form (`zip_suffix="94103-1234"`) → returned as-is
+ * - No suffix → bare `zip`
+ *
+ * Empty / whitespace-only suffix is treated as missing.
+ */
+export function buildPostcode(zip, suffix) {
+    const z = zip.trim();
+    if (!z)
+        return "";
+    const s = suffix?.trim() ?? "";
+    if (!s)
+        return z;
+    if (s.includes("-"))
+        return s;
+    return `${z}-${s}`;
+}
+/** Build a BDC adapter. Pure factory so multiple instances can be created in tests. */
+export function createFccBdcAdapter() {
+    return {
+        id: FCC_BDC_ADAPTER_ID,
+        defaultLicense: FCC_BDC_DEFAULT_LICENSE,
+        description: "FCC Broadband Data Collection — Fabric-derived BSL addresses (public-domain); SQLite DB the operator builds via the isp-nexus BDC ETL.",
+        async *rows(opts) {
+            if (opts.country && opts.country !== "US") {
+                throw new Error(`fcc-bdc adapter: only US supported, got country=${opts.country}`);
+            }
+            const db = new Database(opts.inputPath, { readonly: true, fileMustExist: true });
+            let emitted = 0;
+            try {
+                const stmt = db.prepare(`SELECT location_id, address_primary, city, state, zip, zip_suffix
+					 FROM bdc_locations
+					 ORDER BY location_id`);
+                for (const row of stmt.iterate()) {
+                    if (opts.signal?.aborted)
+                        return;
+                    if (opts.limit !== undefined && emitted >= opts.limit)
+                        return;
+                    const split = splitAddressPrimary(row.address_primary ?? "");
+                    if (!split)
+                        continue;
+                    const state = lookupStateAbbreviation(row.state);
+                    if (!state)
+                        continue;
+                    const locality = row.city?.trim();
+                    if (!locality)
+                        continue;
+                    const postcode = buildPostcode(row.zip ?? "", row.zip_suffix ?? null);
+                    if (!postcode)
+                        continue;
+                    const components = {
+                        ...(split.house_number ? { house_number: split.house_number } : {}),
+                        street: split.street,
+                        locality,
+                        region: state.abbreviation,
+                        postcode,
+                    };
+                    const raw = formatAddress(components, "US", { separator: ", " });
+                    if (!raw)
+                        continue;
+                    const aligned = reconcileComponents(components, raw);
+                    if (Object.keys(aligned).length === 0)
+                        continue;
+                    yield {
+                        raw,
+                        components: aligned,
+                        country: "US",
+                        locale: "en-US",
+                        source: FCC_BDC_ADAPTER_ID,
+                        source_id: `${FCC_BDC_ADAPTER_ID}-${row.location_id}`,
+                        corpus_version: "",
+                        license: FCC_BDC_DEFAULT_LICENSE,
+                    };
+                    emitted++;
+                }
+            }
+            finally {
+                db.close();
+            }
+        },
+    };
+}
+export const fccBdcAdapter = createFccBdcAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/src/adapters/fcc-bdc/adapter.js.map

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