/** * @copyright Sister Software * @license AGPL-3.0 * @author Teffen Ellis, et al. * * `overture`: Overture Maps Addresses adapter (epic #470 — the gated corpus adapter, realized * 2026-06-20). Overture's global Addresses theme is the single-schema, well-normalized address * dataset that fixes OpenAddresses' per-country patchiness (OA dropped Spain; OA-DE omits the * Bundesland) — it even re-hosts the OA Spain data the standalone OA bucket no longer serves. * * This adapter consumes a per-country LINE-DELIMITED JSON dump of the corpus-relevant fields (`{ * street, number, unit, postcode, locality }`), produced by `scripts/ingest-overture-addresses.ts * --corpus-jsonl` (which does the DuckDB / S3 heavy lifting and flattens `address_levels` → the * municipality locality). The split keeps `@mailwoman/corpus` — a RUNTIME dep of the `mailwoman` * CLI — free of the heavy native `@duckdb/node-api`; the adapter just streams JSONL line-by-line, * exactly like `openaddresses`. * * The `street` surface carries the locale's street keyword verbatim (`"CALLE JULAN"`, `"VIA * ROMA"`). We map it to `street` whole and let the downstream affix-relabel split `street_prefix` * — the same path every other source rides. This shard exists because the model was * en-us/fr-trained and never saw non-en/fr street formats (the 2026-06-19 EU parse-blocker * measured loc-correct ES 21% / IT 59% / NL 64% vs FR/US ~98%). * * `--country` is REQUIRED (the JSONL is per-country and the rows omit a country field), matching * `openaddresses`. License is Overture's CDLA-Permissive-2.0 (attribution; not share-alike). * * | Field | ComponentTag | | --------- | ---------------------------------------------- | | * `street` | `street` (keyword incl.; affix-relabel splits prefix) | | `number` | `house_number` * (skipped when "S-N"/"S/N" = sin número) | | `unit` | `unit` (if non-empty) | | `postcode`| * `postcode` | | `locality`| `locality` (Overture address_levels municipality, or postal_city) | */ import type { CorpusAdapter } from "@mailwoman/corpus/types"; /** * Registry id for this adapter. Stamped into every row it emits, so a corpus record can be traced back to the dataset * it came from. */ export declare const OVERTURE_ADAPTER_ID = "overture"; /** * License carried by this source (CDLA-Permissive-2.0), attached to each row so downstream consumers inherit the terms * rather than having to look them up. */ export declare const OVERTURE_DEFAULT_LICENSE = "CDLA-Permissive-2.0"; export declare function createOvertureAdapter(): CorpusAdapter; /** * The configured adapter instance registered with the corpus builder. */ export declare const overtureAdapter: CorpusAdapter; //# sourceMappingURL=adapter.d.ts.map