@mailwoman/corpus 9.1.0 → 9.3.0

package/out/adapters/overture/adapter.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `overture`: Overture Maps Addresses adapter (epic #470 — the conditional 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 slice 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 "#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

package/out/adapters/overture/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../lib/adapters/overture/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAOH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,QAAQ,CAAA;AAEzE;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aAAa,CAAA;AAC7C;;;GAGG;AACH,eAAO,MAAM,wBAAwB,wBAAwB,CAAA;AAuB7D,wBAAgB,qBAAqB,IAAI,aAAa,CAqFrD;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,eAA0B,CAAA"}

package/out/adapters/overture/adapter.js

@@ -0,0 +1,125 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `overture`: Overture Maps Addresses adapter (epic #470 — the conditional 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 slice 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 { tryParsingJSON } from "@mailwoman/core/json";
+import { formatAddress, reconcileComponents } from "@mailwoman/formatter";
+import { TextSpliterator } from "spliterator";
+import { stableSourceID } from "#adapters/utils";
+/**
+ * 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 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 const OVERTURE_DEFAULT_LICENSE = "CDLA-Permissive-2.0";
+function parseLine(line) {
+    const t = line.trim();
+    if (!t || t.startsWith("#"))
+        return null;
+    const o = tryParsingJSON(t);
+    return o && typeof o === "object" ? o : null;
+}
+export function createOvertureAdapter() {
+    return {
+        id: OVERTURE_ADAPTER_ID,
+        defaultLicense: OVERTURE_DEFAULT_LICENSE,
+        description: "Overture Maps Addresses (global): per-country JSONL of street/number/postcode/locality.",
+        async *rows(opts) {
+            if (!opts.country) {
+                throw new Error("overture adapter: --country is required (the Overture JSONL is per-country and rows omit a country field)");
+            }
+            const country = opts.country;
+            // TextSpliterator streams string lines (parseLine keeps tolerating blank/`#`/malformed
+            // lines by returning null); the path string lets the lib own + dispose the file handle,
+            // including on an early `break`.
+            const lines = TextSpliterator.fromAsync(opts.inputPath);
+            let emitted = 0;
+            for await (const line of lines) {
+                if (opts.signal?.aborted)
+                    break;
+                if (opts.limit !== undefined && emitted >= opts.limit)
+                    break;
+                const r = parseLine(line);
+                if (!r)
+                    continue;
+                const street = r.street?.trim() ?? "";
+                const number = r.number?.trim() ?? "";
+                const unit = r.unit?.trim() ?? "";
+                const postcode = r.postcode?.trim() ?? "";
+                const locality = r.locality?.trim() ?? "";
+                // Only useful with a street + (postcode OR locality); point-only rows quarantine anyway.
+                if (!street)
+                    continue;
+                if (!postcode && !locality)
+                    continue;
+                const components = {};
+                // Overture "S-N" / "S/N" = sin número; only keep a real numeric house number.
+                if (/^\d/.test(number)) {
+                    components.house_number = number;
+                }
+                components.street = street;
+                if (unit) {
+                    components.unit = unit;
+                }
+                if (postcode) {
+                    components.postcode = postcode;
+                }
+                if (locality) {
+                    components.locality = locality;
+                }
+                const raw = formatAddress(components, country, { separator: ", " });
+                if (!raw)
+                    continue;
+                const aligned = reconcileComponents(components, raw);
+                if (!Object.keys(aligned).length)
+                    continue;
+                yield {
+                    raw,
+                    components: aligned,
+                    country,
+                    source: OVERTURE_ADAPTER_ID,
+                    source_id: stableSourceID(OVERTURE_ADAPTER_ID, aligned),
+                    corpus_version: "",
+                    license: OVERTURE_DEFAULT_LICENSE,
+                };
+                emitted++;
+            }
+        },
+    };
+}
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export const overtureAdapter = createOvertureAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/adapters/overture/adapter.js.map

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

package/out/adapters/state-hi-schools/adapter.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `state-hi-schools`: Hawaii DOE public + charter school workbook consumer.
+ *
+ *   The Hawaii State Department of Education publishes a directory of all HIDOE schools and public
+ *   charter schools (PCS) as an XLSX workbook (`SchoolList.xlsx`) with two sheets: `HIDOE` (~258
+ *   rows) and `PCS` (~38 rows). Total ~296 rows statewide. Each row carries a school name,
+ *   single-line street address, city, ZIP, a numeric `code`, and HI-specific administrative columns
+ *   (complex, complex_area, district, island, charter).
+ *
+ *   The adapter consumes the original XLSX retained by the fetcher and reads both worksheets directly.
+ *   Legacy flat CSV artifacts remain accepted so existing source caches do not need conversion.
+ *
+ *   Address parsing notes: Hawaii's residential numbering is hyphenated on Oahu (`47-470 Hui Aeko
+ *   Place`), Kauai (`2-4035 Kaumualii Hwy`), and elsewhere. The shared HOUSE_NUMBER_PREFIX regex
+ *   covers this via its optional `(?:-\d+)?` group.
+ *
+ *   The `island` and `district` columns are HIDOE administrative labels (Honolulu, Central, Leeward,
+ *   Windward, Hilo, Hawaii, Maui, Kauai) — they are NOT US counties and intentionally are not
+ *   surfaced as `subregion`.
+ *
+ *   Output: one row per school with `venue` (school name), `(house_number?, street, locality,
+ *   region=HI, postcode)`, and a stable `source_id` derived from the school `code`.
+ *
+ *   License: stamped `"Public Domain"` per Hawaii state government open-data terms.
+ */
+import type { CorpusAdapter } from "#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 STATE_HI_SCHOOLS_ADAPTER_ID = "state-hi-schools";
+/**
+ * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
+ * than having to look them up.
+ */
+export declare const STATE_HI_SCHOOLS_DEFAULT_LICENSE = "Public Domain";
+export declare function createStateHiSchoolsAdapter(): CorpusAdapter;
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export declare const stateHiSchoolsAdapter: CorpusAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/out/adapters/state-hi-schools/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../lib/adapters/state-hi-schools/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AASH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,QAAQ,CAAA;AAEzE;;;GAGG;AACH,eAAO,MAAM,2BAA2B,qBAAqB,CAAA;AAC7D;;;GAGG;AACH,eAAO,MAAM,gCAAgC,kBAAkB,CAAA;AAqC/D,wBAAgB,2BAA2B,IAAI,aAAa,CA+E3D;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,eAAgC,CAAA"}

package/out/adapters/state-hi-schools/adapter.js

@@ -0,0 +1,145 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `state-hi-schools`: Hawaii DOE public + charter school workbook consumer.
+ *
+ *   The Hawaii State Department of Education publishes a directory of all HIDOE schools and public
+ *   charter schools (PCS) as an XLSX workbook (`SchoolList.xlsx`) with two sheets: `HIDOE` (~258
+ *   rows) and `PCS` (~38 rows). Total ~296 rows statewide. Each row carries a school name,
+ *   single-line street address, city, ZIP, a numeric `code`, and HI-specific administrative columns
+ *   (complex, complex_area, district, island, charter).
+ *
+ *   The adapter consumes the original XLSX retained by the fetcher and reads both worksheets directly.
+ *   Legacy flat CSV artifacts remain accepted so existing source caches do not need conversion.
+ *
+ *   Address parsing notes: Hawaii's residential numbering is hyphenated on Oahu (`47-470 Hui Aeko
+ *   Place`), Kauai (`2-4035 Kaumualii Hwy`), and elsewhere. The shared HOUSE_NUMBER_PREFIX regex
+ *   covers this via its optional `(?:-\d+)?` group.
+ *
+ *   The `island` and `district` columns are HIDOE administrative labels (Honolulu, Central, Leeward,
+ *   Windward, Hilo, Hawaii, Maui, Kauai) — they are NOT US counties and intentionally are not
+ *   surfaced as `subregion`.
+ *
+ *   Output: one row per school with `venue` (school name), `(house_number?, street, locality,
+ *   region=HI, postcode)`, and a stable `source_id` derived from the school `code`.
+ *
+ *   License: stamped `"Public Domain"` per Hawaii state government open-data terms.
+ */
+import { isPresent } from "@mailwoman/core/objects";
+import { reconcileComponents } from "@mailwoman/formatter";
+import { CSVSpliterator, XLSXSpliterator } from "spliterator";
+import { schoolCellText, STATE_HI_SCHOOL_SHEETS } from "#adapters/state-hi-schools/workbook";
+import { splitStreetLine, stableSourceID } from "#adapters/utils";
+import { lookupStateAbbreviation } from "#codex/us-fips-state";
+/**
+ * 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 const STATE_HI_SCHOOLS_ADAPTER_ID = "state-hi-schools";
+/**
+ * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
+ * than having to look them up.
+ */
+export const STATE_HI_SCHOOLS_DEFAULT_LICENSE = "Public Domain";
+const HI_STATE_ABBR = "HI";
+function normalizeZip(raw) {
+    const trimmed = schoolCellText(raw);
+    if (!trimmed)
+        return "";
+    // XLSX → CSV conversion may emit numeric ZIPs without leading zeros. HI ZIPs all begin
+    // with 96, so a 4-digit value indicates a leading-zero stripped during numeric coercion
+    // (defensive — has not been observed in the published file as of 2026-05).
+    if (/^\d{4}$/.test(trimmed))
+        return `0${trimmed}`;
+    return trimmed;
+}
+async function* readSchoolRows(inputPath) {
+    if (inputPath.toLowerCase().endsWith(".xlsx")) {
+        for (const sheet of STATE_HI_SCHOOL_SHEETS) {
+            yield* XLSXSpliterator.fromAsync(inputPath, {
+                sheet,
+                mode: "object",
+                normalizeKeys: false,
+            });
+        }
+        return;
+    }
+    yield* CSVSpliterator.fromAsync(inputPath, {
+        mode: "object",
+        normalizeKeys: false,
+        enableQuoteHandling: true,
+    });
+}
+export function createStateHiSchoolsAdapter() {
+    return {
+        id: STATE_HI_SCHOOLS_ADAPTER_ID,
+        defaultLicense: STATE_HI_SCHOOLS_DEFAULT_LICENSE,
+        description: "Hawaii DOE School Directory — ~300 K-12 public + charter schools with venue+address (public-domain).",
+        async *rows(opts) {
+            if (opts.country && opts.country !== "US") {
+                throw new Error(`state-hi-schools adapter: only US supported, got country=${opts.country}`);
+            }
+            const state = lookupStateAbbreviation(HI_STATE_ABBR);
+            if (!state) {
+                throw new Error(`state-hi-schools adapter: HI not found in state codex (corpus bug)`);
+            }
+            let emitted = 0;
+            for await (const record of readSchoolRows(opts.inputPath)) {
+                if (opts.signal?.aborted)
+                    break;
+                if (opts.limit !== undefined && emitted >= opts.limit)
+                    break;
+                const name = schoolCellText(record.name);
+                const address = schoolCellText(record.address);
+                const city = schoolCellText(record.city);
+                const zip = normalizeZip(record.zip);
+                if (!name || !address || !city || !zip)
+                    continue;
+                const split = splitStreetLine(address);
+                if (!split)
+                    continue;
+                const components = {
+                    venue: name,
+                    ...(split.house_number ? { house_number: split.house_number } : {}),
+                    street: split.street,
+                    locality: city,
+                    region: state.abbreviation,
+                    postcode: zip,
+                };
+                const streetPart = [split.house_number, split.street].filter(isPresent).join(" ").trim();
+                const raw = [
+                    name,
+                    streetPart,
+                    [city, [HI_STATE_ABBR, zip].filter(isPresent).join(" ")].filter(isPresent).join(", "),
+                ]
+                    .filter(isPresent)
+                    .join(", ");
+                const aligned = reconcileComponents(components, raw);
+                if (Object.keys(aligned).length <= 2)
+                    continue;
+                const code = schoolCellText(record.code);
+                const sourceID = code
+                    ? `${STATE_HI_SCHOOLS_ADAPTER_ID}-${code}`
+                    : stableSourceID(STATE_HI_SCHOOLS_ADAPTER_ID, aligned);
+                yield {
+                    raw,
+                    components: aligned,
+                    country: "US",
+                    locale: "en-US",
+                    source: STATE_HI_SCHOOLS_ADAPTER_ID,
+                    source_id: sourceID,
+                    corpus_version: "",
+                    license: STATE_HI_SCHOOLS_DEFAULT_LICENSE,
+                };
+                emitted++;
+            }
+        },
+    };
+}
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export const stateHiSchoolsAdapter = createStateHiSchoolsAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/adapters/state-hi-schools/adapter.js.map

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

package/out/adapters/state-hi-schools/workbook.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { XLSXCellValue } from "spliterator";
+/**
+ * The two worksheets that together form the public-school directory.
+ */
+export declare const STATE_HI_SCHOOL_SHEETS: readonly ["HIDOE", "PCS"];
+/**
+ * Columns required to construct a corpus row. Fetch validation uses the same contract as the adapter.
+ */
+export declare const STATE_HI_SCHOOL_REQUIRED_COLUMNS: readonly ["code", "name", "address", "city", "zip"];
+/**
+ * Workbook row fields consumed by the adapter. XLSX cells are typed; the legacy CSV path supplies strings.
+ */
+export interface HiSchoolRow {
+    code: XLSXCellValue | undefined;
+    name: XLSXCellValue | undefined;
+    address: XLSXCellValue | undefined;
+    city: XLSXCellValue | undefined;
+    zip: XLSXCellValue | undefined;
+}
+/**
+ * Convert a typed workbook cell or legacy CSV field to the trimmed text used by the corpus row.
+ */
+export declare function schoolCellText(value: XLSXCellValue | undefined): string;
+//# sourceMappingURL=workbook.d.ts.map

package/out/adapters/state-hi-schools/workbook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbook.d.ts","sourceRoot":"","sources":["../../../lib/adapters/state-hi-schools/workbook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAEhD;;GAEG;AACH,eAAO,MAAM,sBAAsB,2BAA4B,CAAA;AAE/D;;GAEG;AACH,eAAO,MAAM,gCAAgC,qDAAsD,CAAA;AAEnG;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;IAC/B,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;IAC/B,OAAO,EAAE,aAAa,GAAG,SAAS,CAAA;IAClC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAA;IAC/B,GAAG,EAAE,aAAa,GAAG,SAAS,CAAA;CAC9B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,GAAG,MAAM,CAEvE"}

package/out/adapters/state-hi-schools/workbook.js

@@ -0,0 +1,20 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * The two worksheets that together form the public-school directory.
+ */
+export const STATE_HI_SCHOOL_SHEETS = ["HIDOE", "PCS"];
+/**
+ * Columns required to construct a corpus row. Fetch validation uses the same contract as the adapter.
+ */
+export const STATE_HI_SCHOOL_REQUIRED_COLUMNS = ["code", "name", "address", "city", "zip"];
+/**
+ * Convert a typed workbook cell or legacy CSV field to the trimmed text used by the corpus row.
+ */
+export function schoolCellText(value) {
+    return value === null || value === undefined ? "" : String(value).trim();
+}
+//# sourceMappingURL=workbook.js.map

package/out/adapters/state-hi-schools/workbook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workbook.js","sourceRoot":"","sources":["../../../lib/adapters/state-hi-schools/workbook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,OAAO,EAAE,KAAK,CAAU,CAAA;AAE/D;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAU,CAAA;AAanG;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAgC;IAC9D,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;AACzE,CAAC"}

package/out/adapters/state-ia-contractors/adapter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `state-ia-contractors`: Iowa Active Construction Contractor Registrations CSV consumer.
+ *
+ *   Iowa Workforce Development publishes a public registry of active construction contractors. Each
+ *   row carries a business name, street address, city/state/zip, and contact info.
+ *
+ *   The adapter consumes the CSV the operator pre-downloads via `fetch-state-sources.ts`.
+ *
+ *   Output: one row per contractor with `venue` (business name) and address quad `(house_number,
+ *   street, locality, region, postcode)`.
+ *
+ *   License: stamped `"Public Domain"` per Iowa state government open-data terms.
+ */
+import type { CorpusAdapter } from "#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 STATE_IA_CONTRACTORS_ADAPTER_ID = "state-ia-contractors";
+/**
+ * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
+ * than having to look them up.
+ */
+export declare const STATE_IA_CONTRACTORS_DEFAULT_LICENSE = "Public Domain";
+export declare function createStateIaContractorsAdapter(): CorpusAdapter;
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export declare const stateIaContractorsAdapter: CorpusAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/out/adapters/state-ia-contractors/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../lib/adapters/state-ia-contractors/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,QAAQ,CAAA;AAEzE;;;GAGG;AACH,eAAO,MAAM,+BAA+B,yBAAyB,CAAA;AACrE;;;GAGG;AACH,eAAO,MAAM,oCAAoC,kBAAkB,CAAA;AAcnE,wBAAgB,+BAA+B,IAAI,aAAa,CAyF/D;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,eAAoC,CAAA"}

package/out/adapters/state-ia-contractors/adapter.js

@@ -0,0 +1,111 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `state-ia-contractors`: Iowa Active Construction Contractor Registrations CSV consumer.
+ *
+ *   Iowa Workforce Development publishes a public registry of active construction contractors. Each
+ *   row carries a business name, street address, city/state/zip, and contact info.
+ *
+ *   The adapter consumes the CSV the operator pre-downloads via `fetch-state-sources.ts`.
+ *
+ *   Output: one row per contractor with `venue` (business name) and address quad `(house_number,
+ *   street, locality, region, postcode)`.
+ *
+ *   License: stamped `"Public Domain"` per Iowa state government open-data terms.
+ */
+import { isPresent } from "@mailwoman/core/objects";
+import { reconcileComponents } from "@mailwoman/formatter";
+import { CSVSpliterator } from "spliterator";
+import { splitStreetLine, stableSourceID } from "#adapters/utils";
+import { lookupStateAbbreviation } from "#codex/us-fips-state";
+/**
+ * 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 const STATE_IA_CONTRACTORS_ADAPTER_ID = "state-ia-contractors";
+/**
+ * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
+ * than having to look them up.
+ */
+export const STATE_IA_CONTRACTORS_DEFAULT_LICENSE = "Public Domain";
+export function createStateIaContractorsAdapter() {
+    return {
+        id: STATE_IA_CONTRACTORS_ADAPTER_ID,
+        defaultLicense: STATE_IA_CONTRACTORS_DEFAULT_LICENSE,
+        description: "Iowa Active Construction Contractor Registrations — business name + full street address (public-domain).",
+        async *rows(opts) {
+            if (opts.country && opts.country !== "US") {
+                throw new Error(`state-ia-contractors adapter: only US supported, got country=${opts.country}`);
+            }
+            const rows = CSVSpliterator.fromAsync(opts.inputPath, {
+                mode: "object",
+                normalizeKeys: false,
+                enableQuoteHandling: true,
+            });
+            let emitted = 0;
+            for await (const record of rows) {
+                if (opts.signal?.aborted)
+                    break;
+                if (opts.limit !== undefined && emitted >= opts.limit)
+                    break;
+                const businessName = (record["Business Name"] ?? "").trim();
+                const address1 = (record["Address 1"] ?? "").trim();
+                const address2 = (record["Address 2"] ?? "").trim();
+                const city = (record.City ?? "").trim();
+                const stateAbbr = (record.State ?? "").trim();
+                const zip = (record["Zip Code"] ?? "").trim();
+                if (!city || !zip)
+                    continue;
+                const state = lookupStateAbbreviation(stateAbbr);
+                if (!state)
+                    continue;
+                const fullAddress = [address1, address2].filter(isPresent).join(" ");
+                const split = splitStreetLine(fullAddress);
+                if (!split)
+                    continue;
+                const venue = businessName || undefined;
+                const components = {
+                    ...(venue ? { venue } : {}),
+                    ...(split.house_number ? { house_number: split.house_number } : {}),
+                    street: split.street,
+                    locality: city,
+                    region: state.abbreviation,
+                    postcode: zip,
+                };
+                const streetPart = [split.house_number, split.street].filter(isPresent).join(" ").trim();
+                const raw = [
+                    venue,
+                    streetPart,
+                    [city, [stateAbbr, zip].filter(isPresent).join(" ")].filter(isPresent).join(", "),
+                ]
+                    .filter(isPresent)
+                    .join(", ");
+                const aligned = reconcileComponents(components, raw);
+                if (Object.keys(aligned).length <= 2)
+                    continue;
+                const regNum = (record["Registration #"] ?? "").trim();
+                const sourceID = regNum
+                    ? `${STATE_IA_CONTRACTORS_ADAPTER_ID}-${regNum}`
+                    : stableSourceID(STATE_IA_CONTRACTORS_ADAPTER_ID, aligned);
+                yield {
+                    raw,
+                    components: aligned,
+                    country: "US",
+                    locale: "en-US",
+                    source: STATE_IA_CONTRACTORS_ADAPTER_ID,
+                    source_id: sourceID,
+                    corpus_version: "",
+                    license: STATE_IA_CONTRACTORS_DEFAULT_LICENSE,
+                };
+                emitted++;
+            }
+        },
+    };
+}
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export const stateIaContractorsAdapter = createStateIaContractorsAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/adapters/state-ia-contractors/adapter.js.map

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

package/out/adapters/state-ny-notaries/adapter.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `state-ny-notaries`: New York Commissioned Notaries CSV consumer.
+ *
+ *   The New York Department of State publishes a registry of commissioned notaries public. Each row
+ *   optionally carries a business name and business address (~1-5% fill rate).
+ *
+ *   The adapter consumes the CSV the operator pre-downloads via `fetch-state-sources.ts`. Column
+ *   names match the data.ny.gov export header (note: some columns have leading spaces).
+ *
+ *   License: stamped `"Public Domain"` per New York state government open-data terms.
+ */
+import type { CorpusAdapter } from "#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 STATE_NY_NOTARIES_ADAPTER_ID = "state-ny-notaries";
+/**
+ * License carried by this source (Public Domain), attached to each row so downstream consumers inherit the terms rather
+ * than having to look them up.
+ */
+export declare const STATE_NY_NOTARIES_DEFAULT_LICENSE = "Public Domain";
+export declare function createStateNyNotariesAdapter(): CorpusAdapter;
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export declare const stateNyNotariesAdapter: CorpusAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/out/adapters/state-ny-notaries/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../lib/adapters/state-ny-notaries/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,QAAQ,CAAA;AAEzE;;;GAGG;AACH,eAAO,MAAM,4BAA4B,sBAAsB,CAAA;AAC/D;;;GAGG;AACH,eAAO,MAAM,iCAAiC,kBAAkB,CAAA;AAEhE,wBAAgB,4BAA4B,IAAI,aAAa,CAoG5D;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,eAAiC,CAAA"}