@mailwoman/corpus 10.0.0 → 10.2.0

package/out/adapters/wof/postalcode-json/adapter.d.ts

@@ -3,60 +3,44 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `wof-postalcode`: Who's On First postalcode GeoJSON-bundle adapter.
+ *   Emits corpus rows from Who's On First postalcode GeoJSON repositories.
  *
- *   **Phase 1.5.1 pivot.** Replaces the previous SpatiaLite-backed implementation (formerly at
- *   `packages/corpus/lib/adapters/wof-postalcode/`, removed in this same change). The rationale is
- *   in `wof-admin-json/adapter.ts` and in `DECISIONS.md` — short version: the SQLite distribution
- *   mirror is dead, the live distro tags every postcode row `mz:is_current = -1` which the old
- *   `is_current = 1` predicate excluded, and localized `name:*` variants don't ship in the SQLite
- *   export at all.
+ *   The input directory must hold the `whosonfirst-data-postalcode-<cc>` repositories and the matching
+ *   `whosonfirst-data-admin-<cc>` repositories. Postcode records point to their ancestors by `wof:parent_id`, so the
+ *   admin records must be in the same walk.
  *
- *   Input: a directory containing one or more cloned `whosonfirst-data-postalcode-<cc>` repos plus
- *   the relevant `whosonfirst-data-admin-<cc>` repos (postcode records reference admin ancestry by
- *   `wof:parent_id`, so the locality / region / country records must be in the same walk for the
- *   ancestry chain to resolve). The corpus pipeline clones all four repos under
- *   `/data/corpus/sources/wof/repos/` and points the adapter at that root.
+ *   Each postcode record produces one row per pair of name slot and hierarchy variant. The name slots are the canonical
+ *   `wof:name` (slot `default`) plus any `name:*` variants. The hierarchy variants are the postcode by itself, then with
+ *   locality, region and country added in turn. Ancestor names always use the canonical `wof:name`.
  *
- *   Per live postalcode record, the adapter emits one row per `(name-variant, hierarchy-variant)`
- *   pair:
- *
- *   - **Name variants**: canonical `wof:name` (slot key `default`, typically the postcode digits
- *       themselves) plus any `name:*` variants on the postcode feature. In practice WOF postcode
- *       records rarely carry localized name variants, so this expansion is usually a no-op — but
- *       the code path stays symmetric with the admin adapter for consistency.
- *   - **Hierarchy variants** (unchanged from the SQLite adapter): self, +locality, +locality+region,
- *       +locality+region+country.
- *
- *   `source_id` is `wof-postalcode-<wof_id>-<name-slot>-<hierarchy-variant>`. Ancestor names always
- *   come from the ancestor's canonical `wof:name`; this adapter does NOT iterate ancestor name
- *   variants (e.g. it does not emit `"75008 Париж"` even when Paris has a `name:rus_x_preferred`).
- *   That cross-product belongs to a future synthesis pass; emitting it here would multiply row
- *   counts ~10× without a clear training-value story.
- *
- *   License: CC0.
+ *   `source_id` has the form `wof-postalcode-<wof_id>-<name-slot>-<hierarchy-variant>`.
  */
 import { type WOFVariantSpec } from "#adapters/wof/json-rows";
-import type { CorpusAdapter } from "#types";
-import { type WOFRecord } from "#utils";
+import { type CorpusAdapter } from "#types";
+import { type AncestorNames, type WOFRecord } from "#utils";
 /**
- * Compute hierarchy variants for a postcode record. `selfName` is the postcode surface form (canonical `wof:name` for
- * the `default` slot, a `name:*` localized variant otherwise).
+ * Builds the hierarchy variants for a postcode record, or returns an empty list for any other placetype.
+ *
+ * `selfName` is the postcode text for the current name slot.
  */
-export declare function postcodeVariantsFor(row: WOFRecord, ancestry: WOFRecord[], selfName: string): WOFVariantSpec[];
+export declare function postcodeVariantsFor(row: WOFRecord, ancestry: AncestorNames, selfName: string): WOFVariantSpec[];
 /**
- * Build the per-record name-slot list. The `default` slot uses `wof:name` verbatim (postcode digits); subsequent slots
- * come from `name:*` variants dedup'd against the default.
+ * Returns a record's name slots.
+ *
+ * The `default` slot holds `wof:name` unchanged.
+ * The other slots hold `name:*` variants that differ from it.
  */
 export declare function nameSlotsFor(rec: WOFRecord): Array<{
     key: string;
     value: string;
 }>;
 /**
- * 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.
+ * The source ID on rows from this adapter.
  */
 export declare const WOF_POSTALCODE_ADAPTER_ID = "wof-postalcode";
+/**
+ * Creates the WOF postalcode adapter.
+ */
 export declare function createWOFPostalcodeAdapter(): CorpusAdapter;
 /**
  * The configured adapter instance registered with the corpus builder.

package/out/adapters/wof/postalcode-json/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/adapters/wof/postalcode-json/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAKH,OAAO,EAKN,KAAK,cAAc,EACnB,MAAM,yBAAyB,CAAA;AAChC,OAAO,KAAK,EAAgC,aAAa,EAAE,MAAM,QAAQ,CAAA;AAEzE,OAAO,EAAoC,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAA;AA6CzE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAqC7G;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAElF;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AAEzD,wBAAgB,0BAA0B,IAAI,aAAa,CAqC1D;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAA+B,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/adapters/wof/postalcode-json/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,EAKN,KAAK,cAAc,EACnB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G,OAAO,EAAwC,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,QAAQ,CAAA;AAoDjG;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CAqC/G;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAElF;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,mBAAmB,CAAA;AAEzD;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,aAAa,CA+C1D;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,eAA+B,CAAA"}

package/out/adapters/wof/postalcode-json/adapter.js

@@ -3,63 +3,51 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   `wof-postalcode`: Who's On First postalcode GeoJSON-bundle adapter.
+ *   Emits corpus rows from Who's On First postalcode GeoJSON repositories.
  *
- *   **Phase 1.5.1 pivot.** Replaces the previous SpatiaLite-backed implementation (formerly at
- *   `packages/corpus/lib/adapters/wof-postalcode/`, removed in this same change). The rationale is
- *   in `wof-admin-json/adapter.ts` and in `DECISIONS.md` — short version: the SQLite distribution
- *   mirror is dead, the live distro tags every postcode row `mz:is_current = -1` which the old
- *   `is_current = 1` predicate excluded, and localized `name:*` variants don't ship in the SQLite
- *   export at all.
+ *   The input directory must hold the `whosonfirst-data-postalcode-<cc>` repositories and the matching
+ *   `whosonfirst-data-admin-<cc>` repositories. Postcode records point to their ancestors by `wof:parent_id`, so the
+ *   admin records must be in the same walk.
  *
- *   Input: a directory containing one or more cloned `whosonfirst-data-postalcode-<cc>` repos plus
- *   the relevant `whosonfirst-data-admin-<cc>` repos (postcode records reference admin ancestry by
- *   `wof:parent_id`, so the locality / region / country records must be in the same walk for the
- *   ancestry chain to resolve). The corpus pipeline clones all four repos under
- *   `/data/corpus/sources/wof/repos/` and points the adapter at that root.
+ *   Each postcode record produces one row per pair of name slot and hierarchy variant. The name slots are the canonical
+ *   `wof:name` (slot `default`) plus any `name:*` variants. The hierarchy variants are the postcode by itself, then with
+ *   locality, region and country added in turn. Ancestor names always use the canonical `wof:name`.
  *
- *   Per live postalcode record, the adapter emits one row per `(name-variant, hierarchy-variant)`
- *   pair:
- *
- *   - **Name variants**: canonical `wof:name` (slot key `default`, typically the postcode digits
- *       themselves) plus any `name:*` variants on the postcode feature. In practice WOF postcode
- *       records rarely carry localized name variants, so this expansion is usually a no-op — but
- *       the code path stays symmetric with the admin adapter for consistency.
- *   - **Hierarchy variants** (unchanged from the SQLite adapter): self, +locality, +locality+region,
- *       +locality+region+country.
- *
- *   `source_id` is `wof-postalcode-<wof_id>-<name-slot>-<hierarchy-variant>`. Ancestor names always
- *   come from the ancestor's canonical `wof:name`; this adapter does NOT iterate ancestor name
- *   variants (e.g. it does not emit `"75008 Париж"` even when Paris has a `name:rus_x_preferred`).
- *   That cross-product belongs to a future synthesis pass; emitting it here would multiply row
- *   counts ~10× without a clear training-value story.
- *
- *   License: CC0.
+ *   `source_id` has the form `wof-postalcode-<wof_id>-<name-slot>-<hierarchy-variant>`.
  */
 import { COUNTRY_DISPLAY_NAME, emitWOFJSONRows, LOCALE_BY_COUNTRY, nameSlotsFor as wofNameSlotsFor, } from "#adapters/wof/json-rows";
+import { SourceRegister } from "#registers";
+import { AddressRole, SurfaceOrigin } from "#types";
 import { US_STATE_BY_ABBREVIATION } from "#us/fips-state";
-import { buildAncestryIndex, walkFeatures } from "#utils";
+import { buildAncestorNameIndex, walkFeatures } from "#utils";
 /**
- * US state name → USPS alpha-2, the surface form a US postal address carries.
+ * Maps a lowercase US state name to its USPS code.
  *
- * WOF names the region in full (`Oregon`); the layout renders whatever it is given, because a layout is an ORDER and
- * not a vocabulary. Choosing the surface form is therefore this adapter's decision, and the postal one is the code.
+ * WOF stores full state names such as `Oregon`, and the address layout prints components unchanged.
+ * The adapter substitutes the USPS code so the row matches how a US postal address is written.
  */
 const US_STATE_ABBREVIATION_BY_NAME = new Map(Object.values(US_STATE_BY_ABBREVIATION).map((state) => [state.name.toLowerCase(), state.abbreviation]));
 /**
- * The region surface form to print for `country`, given the name WOF carries.
+ * Returns the region text to print.
+ *
+ * The adapter converts US state names to USPS codes.
+ * Other names pass through.
  */
 function regionSurface(country, name) {
+    // country-branch: the codex holds a name-to-code table for US states only.
+    // The WOF admin database's `place_abbr` holds codes for ten countries
+    // and an ISO 3166-2 table would cover every country.
+    // The tree holds neither as a lookup yet.
     if (country !== "US")
         return name;
     return US_STATE_ABBREVIATION_BY_NAME.get(name.trim().toLowerCase()) ?? name;
 }
 /**
- * Map a WOF placetype to a Mailwoman `ComponentTag`, or `undefined` to skip.
+ * Maps a WOF placetype to a component tag, or returns `undefined` for a placetype this adapter skips.
  *
- * Per-adapter deliberately (the admin adapter carries its own): each table is a record FILTER for its adapter's
- * emission set — this one keeps `postalcode` plus the ancestry placetypes its variants render — not a shared
- * vocabulary.
+ * The mapping also filters records, so it covers only `postalcode`
+ * and the ancestor placetypes the variants use.
+ * The admin adapter keeps its own mapping.
  */
 function placetypeToTag(placetype) {
     switch (placetype) {
@@ -74,31 +62,32 @@ function placetypeToTag(placetype) {
         case "postalcode":
             return "postcode";
         default:
-            return undefined;
+            return null;
     }
 }
 /**
- * Compute hierarchy variants for a postcode record. `selfName` is the postcode surface form (canonical `wof:name` for
- * the `default` slot, a `name:*` localized variant otherwise).
+ * Builds the hierarchy variants for a postcode record, or returns an empty list for any other placetype.
+ *
+ * `selfName` is the postcode text for the current name slot.
  */
 export function postcodeVariantsFor(row, ancestry, selfName) {
     if (placetypeToTag(row.placetype) !== "postcode")
         return [];
-    const locality = ancestry.find((a) => placetypeToTag(a.placetype) === "locality");
-    const region = ancestry.find((a) => placetypeToTag(a.placetype) === "region");
-    const country = ancestry.find((a) => placetypeToTag(a.placetype) === "country");
-    const countryDisplay = COUNTRY_DISPLAY_NAME[row.country] ?? country?.name ?? row.country;
+    const locality = ancestry.locality;
+    const region = ancestry.region;
+    const country = ancestry.country;
+    const countryDisplay = COUNTRY_DISPLAY_NAME[row.country] ?? country ?? row.country;
     const variants = [{ suffix: "self", components: { postcode: selfName } }];
     if (locality) {
         variants.push({
             suffix: "with-locality",
-            components: { postcode: selfName, locality: locality.name },
+            components: { postcode: selfName, locality },
         });
     }
     if (locality && region) {
         variants.push({
             suffix: "with-locality-region",
-            components: { postcode: selfName, locality: locality.name, region: region.name },
+            components: { postcode: selfName, locality, region },
         });
     }
     if (locality && region && country) {
@@ -106,8 +95,8 @@ export function postcodeVariantsFor(row, ancestry, selfName) {
             suffix: "with-locality-region-country",
             components: {
                 postcode: selfName,
-                locality: locality.name,
-                region: regionSurface(row.country, region.name),
+                locality,
+                region: regionSurface(row.country, region),
                 country: countryDisplay,
             },
         });
@@ -115,26 +104,31 @@ export function postcodeVariantsFor(row, ancestry, selfName) {
     return variants;
 }
 /**
- * Build the per-record name-slot list. The `default` slot uses `wof:name` verbatim (postcode digits); subsequent slots
- * come from `name:*` variants dedup'd against the default.
+ * Returns a record's name slots.
+ *
+ * The `default` slot holds `wof:name` unchanged.
+ * The other slots hold `name:*` variants that differ from it.
  */
 export function nameSlotsFor(rec) {
     return wofNameSlotsFor(rec);
 }
 /**
- * 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.
+ * The source ID on rows from this adapter.
  */
 export const WOF_POSTALCODE_ADAPTER_ID = "wof-postalcode";
+/**
+ * Creates the WOF postalcode adapter.
+ */
 export function createWOFPostalcodeAdapter() {
     return {
         id: WOF_POSTALCODE_ADAPTER_ID,
         defaultLicense: "CC0-1.0",
+        addressRole: AddressRole.Premise,
+        register: SourceRegister.WhosOnFirst,
+        surface: SurfaceOrigin.Rendered,
         description: "Who's On First postalcode GeoJSON bundles (postcode → locality/region pairs). Ancestor names from sibling admin repos.",
         async *rows(opts) {
-            // Pass 1: full walk. We keep every record whose placetype maps to a ComponentTag — the
-            // postcode adapter needs locality / region / country admin records in the index so it
-            // can resolve postcode ancestry, even though it only emits rows for postcode records.
+            // The index keeps admin records as well as postcodes so that postcode ancestry resolves.
             const byID = new Map();
             for await (const rec of walkFeatures(opts.inputPath, { signal: opts.signal })) {
                 if (opts.signal?.aborted)
@@ -145,8 +139,16 @@ export function createWOFPostalcodeAdapter() {
                     continue;
                 byID.set(rec.id, rec);
             }
-            const ancestry = buildAncestryIndex(byID);
-            // Pass 2: emit postcode rows only, sorted by id for determinism.
+            const ancestry = buildAncestorNameIndex(byID, placetypeToTag);
+            // The adapter read admin records so postcode ancestry resolves.
+            // The index above now holds the three ancestor names read by each postcode variant.
+            // Their removal here releases every admin record's `nameVariants` map before the emit pass.
+            // `shouldEmit` skipped those records anyway.
+            for (const [id, record] of byID) {
+                if (placetypeToTag(record.placetype) !== "postcode") {
+                    byID.delete(id);
+                }
+            }
             yield* emitWOFJSONRows({
                 records: byID,
                 ancestry,

package/out/adapters/wof/postalcode-json/adapter.js.map

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

package/out/adapters.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Adapter registry bootstrap.
+ *
+ *   The module registers every built-in adapter with `defaultAdapterRegistry` when loaded. The CLI
+ *   (`commands/corpus/list.tsx`, `commands/corpus/run.tsx`) imports it once at startup.
+ *
+ *   Each adapter has its own directory, and the publisher decides which parent it sits under. An
+ *   adapter reading one country's publisher lives under that country, at `lib/<iso2>/adapters/<id>/`:
+ *   G-NAF under `au`, Digitaal Vlaanderen under `be`, ČÚZK under `cz`, Klimadatastyrelsen under
+ *   `dk`, Maa- ja Ruumiamet under `ee`, Ryhti under `fi`, BAN, FINESS and the Annuaire de l'éducation under `fr`, ANAC under `it`, the
+ *   Administration du
+ *   cadastre et de la topographie under `lu`, the State Address Register under `lv`, Kartverket's Matrikkelen
+ *   under `no`, EMUiA under `pl`, Romania's school network under `ro`, and the FCC and USGov readers under `us`. A national publisher
+ *   stays there even when its own files cover that state's dependencies, because the publisher is
+ *   what the adapter reads: BAN covers France and ten overseas jurisdictions, Matrikkelen covers
+ *   Norway and Svalbard, and Ryhti's one national file covers Åland beside the Finnish mainland.
+ *
+ *   Flanders is the counter-case worth stating. Its adapter sits under `be` and covers the Flemish
+ *   Region only, because Brussels and Wallonia publish the INSPIRE theme through their own
+ *   services, so Belgium needs three adapters rather than one.
+ *
+ *   Spain needs four, for the same reason. `es-catastro` reads the Dirección General del Catastro's
+ *   52 provinces. `es-bizkaia`, `es-gipuzkoa` and `es-navarra` read the foral cadastres. Those
+ *   cadastres state their own terms. The national feed links them rather than serving them.
+ *
+ *   An adapter reading a publisher that is not any one country's lives here, at `lib/adapters/<id>/`.
+ *   That is the aggregators, `./openaddresses/`, `./osm/`, `./overture/`, `./geonames/` and `./wof/`,
+ *   plus `./po-box/`.
+ *
+ *   A new adapter joins the `BUILTIN_ADAPTERS` list below. A test that needs a pristine registry
+ *   constructs its own `InMemoryAdapterRegistry` rather than mutating the default.
+ *
+ *   The WOF adapters keep their canonical ids, `wof-admin` and `wof-postalcode`, so existing
+ *   `mailwoman corpus build` callsites continue to work. `./wof/admin/json/` and
+ *   `./wof/postalcode-json/` hold the implementations.
+ */
+import type { CorpusAdapter } from "#types";
+/**
+ * Built-in adapters.
+ *
+ * Order is significant, because `corpus build` iterates this list to drive every adapter in turn.
+ * The order runs coarse-first (admin, then postcode), then street-level
+ * (BAN FR, tiger US, OpenAddresses global), then adversarial-source (FCC BDC US, HRSA fqhc US).
+ *
+ * The `usgov-samhsa-treatment-locator` adapter is intentionally absent from this list.
+ * The samhsa Open Data Foundry bulk CSV it was written against is no longer publicly distributed.
+ *
+ * Its factory and export remain available so an operator who obtains a compatible CSV can hand-register it.
+ * Re-add it here once a stable public source returns.
+ */
+export declare const BUILTIN_ADAPTERS: readonly CorpusAdapter[];
+export { BAN_ADAPTER_ID, banAdapter } from "#fr/adapters/ban/adapter";
+export { MATRIKKELEN_ADAPTER_ID, matrikkelenAdapter } from "#no/adapters/matrikkelen/adapter";
+export { FCC_BDC_ADAPTER_ID, FCC_BDC_DEFAULT_LICENSE, fccBdcAdapter } from "#us/adapters/fcc-bdc/adapter";
+export { GEONAMES_POSTAL_ADAPTER_ID, GEONAMES_POSTAL_DEFAULT_LICENSE, geonamesPostalAdapter, } from "#adapters/geonames/postal/adapter";
+export { GEONAMES_ADAPTER_ID, GEONAMES_DEFAULT_LICENSE, geonamesAdapter } from "#adapters/geonames/adapter";
+export { OPENADDRESSES_ADAPTER_ID, OPENADDRESSES_DEFAULT_LICENSE, openaddressesAdapter, } from "#adapters/openaddresses/adapter";
+export { STATE_HI_SCHOOLS_ADAPTER_ID, STATE_HI_SCHOOLS_DEFAULT_LICENSE, stateHiSchoolsAdapter, } from "#us/adapters/state/hi-schools/adapter";
+export { STATE_IA_CONTRACTORS_ADAPTER_ID, STATE_IA_CONTRACTORS_DEFAULT_LICENSE, stateIaContractorsAdapter, } from "#us/adapters/state/ia-contractors/adapter";
+export { STATE_NY_NOTARIES_ADAPTER_ID, STATE_NY_NOTARIES_DEFAULT_LICENSE, stateNyNotariesAdapter, } from "#us/adapters/state/ny-notaries/adapter";
+export { STATE_TX_NOTARIES_ADAPTER_ID, STATE_TX_NOTARIES_DEFAULT_LICENSE, stateTxNotariesAdapter, } from "#us/adapters/state/tx-notaries/adapter";
+export { TIGER_ADAPTER_ID, TIGER_DEFAULT_LICENSE, tigerAdapter } from "#us/adapters/tiger/adapter";
+export { USGOV_HRSA_FQHC_ADAPTER_ID, USGOV_HRSA_FQHC_DEFAULT_LICENSE, usgovHrsaFqhcAdapter, } from "#us/adapters/usgov/hrsa-fqhc/adapter";
+export { USGOV_IMLS_PLS_ADAPTER_ID, USGOV_IMLS_PLS_DEFAULT_LICENSE, usgovImlsPlsAdapter, } from "#us/adapters/usgov/imls-pls/adapter";
+export { USGOV_IRS_BMF_ADAPTER_ID, USGOV_IRS_BMF_DEFAULT_LICENSE, USGovIRSBMFAdapter, } from "#us/adapters/usgov/irs-bmf/adapter";
+export { USGOV_NAD_ADAPTER_ID, USGOV_NAD_DEFAULT_LICENSE, usgovNADAdapter } from "#us/adapters/usgov/nad/adapter";
+export { USGOV_NPPES_ADAPTER_ID, USGOV_NPPES_DEFAULT_LICENSE, usgovNPPESAdapter, } from "#us/adapters/usgov/nppes/adapter";
+export { USGOV_SAMHSA_ADAPTER_ID, USGOV_SAMHSA_DEFAULT_LICENSE, usgovSamhsaTreatmentLocatorAdapter, } from "#us/adapters/usgov/samhsa-treatment-locator/adapter";
+export { WOF_ADMIN_ADAPTER_ID, wofAdminAdapter } from "#adapters/wof/admin/json/adapter";
+export { WOF_POSTALCODE_ADAPTER_ID, wofPostalcodeAdapter } from "#adapters/wof/postalcode-json/adapter";
+//# sourceMappingURL=adapters.d.ts.map

package/out/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../lib/adapters.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AAmCH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AAa3C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,aAAa,EA4CpD,CAAA;AAQD,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAC7F,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAA;AAEzG,OAAO,EACN,0BAA0B,EAC1B,+BAA+B,EAC/B,qBAAqB,GACrB,MAAM,mCAAmC,CAAA;AAE1C,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAE3G,OAAO,EACN,wBAAwB,EACxB,6BAA6B,EAC7B,oBAAoB,GACpB,MAAM,iCAAiC,CAAA;AAExC,OAAO,EACN,2BAA2B,EAC3B,gCAAgC,EAChC,qBAAqB,GACrB,MAAM,uCAAuC,CAAA;AAE9C,OAAO,EACN,+BAA+B,EAC/B,oCAAoC,EACpC,yBAAyB,GACzB,MAAM,2CAA2C,CAAA;AAElD,OAAO,EACN,4BAA4B,EAC5B,iCAAiC,EACjC,sBAAsB,GACtB,MAAM,wCAAwC,CAAA;AAE/C,OAAO,EACN,4BAA4B,EAC5B,iCAAiC,EACjC,sBAAsB,GACtB,MAAM,wCAAwC,CAAA;AAE/C,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAElG,OAAO,EACN,0BAA0B,EAC1B,+BAA+B,EAC/B,oBAAoB,GACpB,MAAM,sCAAsC,CAAA;AAE7C,OAAO,EACN,yBAAyB,EACzB,8BAA8B,EAC9B,mBAAmB,GACnB,MAAM,qCAAqC,CAAA;AAE5C,OAAO,EACN,wBAAwB,EACxB,6BAA6B,EAC7B,kBAAkB,GAClB,MAAM,oCAAoC,CAAA;AAE3C,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAEjH,OAAO,EACN,sBAAsB,EACtB,2BAA2B,EAC3B,iBAAiB,GACjB,MAAM,kCAAkC,CAAA;AAEzC,OAAO,EACN,uBAAuB,EACvB,4BAA4B,EAC5B,kCAAkC,GAClC,MAAM,qDAAqD,CAAA;AAE5D,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAA;AACxF,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,uCAAuC,CAAA"}

package/out/adapters.js

@@ -0,0 +1,167 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Adapter registry bootstrap.
+ *
+ *   The module registers every built-in adapter with `defaultAdapterRegistry` when loaded. The CLI
+ *   (`commands/corpus/list.tsx`, `commands/corpus/run.tsx`) imports it once at startup.
+ *
+ *   Each adapter has its own directory, and the publisher decides which parent it sits under. An
+ *   adapter reading one country's publisher lives under that country, at `lib/<iso2>/adapters/<id>/`:
+ *   G-NAF under `au`, Digitaal Vlaanderen under `be`, ČÚZK under `cz`, Klimadatastyrelsen under
+ *   `dk`, Maa- ja Ruumiamet under `ee`, Ryhti under `fi`, BAN, FINESS and the Annuaire de l'éducation under `fr`, ANAC under `it`, the
+ *   Administration du
+ *   cadastre et de la topographie under `lu`, the State Address Register under `lv`, Kartverket's Matrikkelen
+ *   under `no`, EMUiA under `pl`, Romania's school network under `ro`, and the FCC and USGov readers under `us`. A national publisher
+ *   stays there even when its own files cover that state's dependencies, because the publisher is
+ *   what the adapter reads: BAN covers France and ten overseas jurisdictions, Matrikkelen covers
+ *   Norway and Svalbard, and Ryhti's one national file covers Åland beside the Finnish mainland.
+ *
+ *   Flanders is the counter-case worth stating. Its adapter sits under `be` and covers the Flemish
+ *   Region only, because Brussels and Wallonia publish the INSPIRE theme through their own
+ *   services, so Belgium needs three adapters rather than one.
+ *
+ *   Spain needs four, for the same reason. `es-catastro` reads the Dirección General del Catastro's
+ *   52 provinces. `es-bizkaia`, `es-gipuzkoa` and `es-navarra` read the foral cadastres. Those
+ *   cadastres state their own terms. The national feed links them rather than serving them.
+ *
+ *   An adapter reading a publisher that is not any one country's lives here, at `lib/adapters/<id>/`.
+ *   That is the aggregators, `./openaddresses/`, `./osm/`, `./overture/`, `./geonames/` and `./wof/`,
+ *   plus `./po-box/`.
+ *
+ *   A new adapter joins the `BUILTIN_ADAPTERS` list below. A test that needs a pristine registry
+ *   constructs its own `InMemoryAdapterRegistry` rather than mutating the default.
+ *
+ *   The WOF adapters keep their canonical ids, `wof-admin` and `wof-postalcode`, so existing
+ *   `mailwoman corpus build` callsites continue to work. `./wof/admin/json/` and
+ *   `./wof/postalcode-json/` hold the implementations.
+ */
+import { cordisAdapter } from "#adapters/cordis/adapter";
+import { geonamesAdapter } from "#adapters/geonames/adapter";
+import { geonamesPostalAdapter } from "#adapters/geonames/postal/adapter";
+import { gleifAdapter } from "#adapters/gleif/adapter";
+import { openaddressesAdapter } from "#adapters/openaddresses/adapter";
+import { osmAdapter } from "#adapters/osm/adapter";
+import { overtureAdapter } from "#adapters/overture/adapter";
+import { defaultAdapterRegistry } from "#adapters/registry";
+import { wofAdminAdapter } from "#adapters/wof/admin/json/adapter";
+import { wofPostalcodeAdapter } from "#adapters/wof/postalcode-json/adapter";
+import { gnafAdapter } from "#au/adapters/gnaf/adapter";
+import { brusselsAdapter } from "#be/adapters/brussels/adapter";
+import { vlaanderenAdapter } from "#be/adapters/vlaanderen/adapter";
+import { wallonieAdapter } from "#be/adapters/wallonie/adapter";
+import { czCuzkAdapter } from "#cz/adapters/cuzk/adapter";
+import { dkInspireAdapter } from "#dk/adapters/inspire/adapter";
+import { adsAdapter } from "#ee/adapters/ads/adapter";
+import { esBizkaiaAdapter } from "#es/adapters/bizkaia/adapter";
+import { esCatastroAdapter } from "#es/adapters/catastro/adapter";
+import { esGipuzkoaAdapter } from "#es/adapters/gipuzkoa/adapter";
+import { esNavarraAdapter } from "#es/adapters/navarra/adapter";
+import { ryhtiAdapter } from "#fi/adapters/ryhti/adapter";
+import { annuaireEducationAdapter } from "#fr/adapters/annuaire-education/adapter";
+import { banAdapter } from "#fr/adapters/ban/adapter";
+import { finessAdapter } from "#fr/adapters/finess/adapter";
+import { itANACAdapter } from "#it/adapters/anac/adapter";
+import { bdAdressesAdapter } from "#lu/adapters/bd-adresses/adapter";
+import { varisAdapter } from "#lv/adapters/varis/adapter";
+import { nlKadasterAdapter } from "#nl/adapters/kadaster/adapter";
+import { matrikkelenAdapter } from "#no/adapters/matrikkelen/adapter";
+import { emuiaAdapter } from "#pl/adapters/emuia/adapter";
+import { reteaScolaraAdapter } from "#ro/adapters/retea-scolara/adapter";
+import { skInspireAdapter } from "#sk/adapters/inspire/adapter";
+import { fccBdcAdapter } from "#us/adapters/fcc-bdc/adapter";
+import { stateHiSchoolsAdapter } from "#us/adapters/state/hi-schools/adapter";
+import { stateIaContractorsAdapter } from "#us/adapters/state/ia-contractors/adapter";
+import { stateNyNotariesAdapter } from "#us/adapters/state/ny-notaries/adapter";
+import { stateTxNotariesAdapter } from "#us/adapters/state/tx-notaries/adapter";
+import { tigerAdapter } from "#us/adapters/tiger/adapter";
+import { usgovHrsaFqhcAdapter } from "#us/adapters/usgov/hrsa-fqhc/adapter";
+import { usgovImlsPlsAdapter } from "#us/adapters/usgov/imls-pls/adapter";
+import { USGovIRSBMFAdapter } from "#us/adapters/usgov/irs-bmf/adapter";
+import { usgovNADAdapter } from "#us/adapters/usgov/nad/adapter";
+import { usgovNPPESAdapter } from "#us/adapters/usgov/nppes/adapter";
+/**
+ * Built-in adapters.
+ *
+ * Order is significant, because `corpus build` iterates this list to drive every adapter in turn.
+ * The order runs coarse-first (admin, then postcode), then street-level
+ * (BAN FR, tiger US, OpenAddresses global), then adversarial-source (FCC BDC US, HRSA fqhc US).
+ *
+ * The `usgov-samhsa-treatment-locator` adapter is intentionally absent from this list.
+ * The samhsa Open Data Foundry bulk CSV it was written against is no longer publicly distributed.
+ *
+ * Its factory and export remain available so an operator who obtains a compatible CSV can hand-register it.
+ * Re-add it here once a stable public source returns.
+ */
+export const BUILTIN_ADAPTERS = [
+    wofAdminAdapter,
+    wofPostalcodeAdapter,
+    geonamesAdapter,
+    geonamesPostalAdapter,
+    banAdapter,
+    matrikkelenAdapter,
+    ryhtiAdapter,
+    czCuzkAdapter,
+    dkInspireAdapter,
+    adsAdapter,
+    emuiaAdapter,
+    vlaanderenAdapter,
+    wallonieAdapter,
+    brusselsAdapter,
+    nlKadasterAdapter,
+    bdAdressesAdapter,
+    skInspireAdapter,
+    esCatastroAdapter,
+    esBizkaiaAdapter,
+    esGipuzkoaAdapter,
+    esNavarraAdapter,
+    tigerAdapter,
+    openaddressesAdapter,
+    overtureAdapter,
+    osmAdapter,
+    gnafAdapter,
+    fccBdcAdapter,
+    usgovHrsaFqhcAdapter,
+    usgovNPPESAdapter,
+    usgovNADAdapter,
+    usgovImlsPlsAdapter,
+    USGovIRSBMFAdapter,
+    stateIaContractorsAdapter,
+    stateTxNotariesAdapter,
+    stateNyNotariesAdapter,
+    stateHiSchoolsAdapter,
+    itANACAdapter,
+    reteaScolaraAdapter,
+    cordisAdapter,
+    varisAdapter,
+    finessAdapter,
+    annuaireEducationAdapter,
+    gleifAdapter,
+];
+for (const adapter of BUILTIN_ADAPTERS) {
+    if (!defaultAdapterRegistry.get(adapter.id)) {
+        defaultAdapterRegistry.register(adapter);
+    }
+}
+export { BAN_ADAPTER_ID, banAdapter } from "#fr/adapters/ban/adapter";
+export { MATRIKKELEN_ADAPTER_ID, matrikkelenAdapter } from "#no/adapters/matrikkelen/adapter";
+export { FCC_BDC_ADAPTER_ID, FCC_BDC_DEFAULT_LICENSE, fccBdcAdapter } from "#us/adapters/fcc-bdc/adapter";
+export { GEONAMES_POSTAL_ADAPTER_ID, GEONAMES_POSTAL_DEFAULT_LICENSE, geonamesPostalAdapter, } from "#adapters/geonames/postal/adapter";
+export { GEONAMES_ADAPTER_ID, GEONAMES_DEFAULT_LICENSE, geonamesAdapter } from "#adapters/geonames/adapter";
+export { OPENADDRESSES_ADAPTER_ID, OPENADDRESSES_DEFAULT_LICENSE, openaddressesAdapter, } from "#adapters/openaddresses/adapter";
+export { STATE_HI_SCHOOLS_ADAPTER_ID, STATE_HI_SCHOOLS_DEFAULT_LICENSE, stateHiSchoolsAdapter, } from "#us/adapters/state/hi-schools/adapter";
+export { STATE_IA_CONTRACTORS_ADAPTER_ID, STATE_IA_CONTRACTORS_DEFAULT_LICENSE, stateIaContractorsAdapter, } from "#us/adapters/state/ia-contractors/adapter";
+export { STATE_NY_NOTARIES_ADAPTER_ID, STATE_NY_NOTARIES_DEFAULT_LICENSE, stateNyNotariesAdapter, } from "#us/adapters/state/ny-notaries/adapter";
+export { STATE_TX_NOTARIES_ADAPTER_ID, STATE_TX_NOTARIES_DEFAULT_LICENSE, stateTxNotariesAdapter, } from "#us/adapters/state/tx-notaries/adapter";
+export { TIGER_ADAPTER_ID, TIGER_DEFAULT_LICENSE, tigerAdapter } from "#us/adapters/tiger/adapter";
+export { USGOV_HRSA_FQHC_ADAPTER_ID, USGOV_HRSA_FQHC_DEFAULT_LICENSE, usgovHrsaFqhcAdapter, } from "#us/adapters/usgov/hrsa-fqhc/adapter";
+export { USGOV_IMLS_PLS_ADAPTER_ID, USGOV_IMLS_PLS_DEFAULT_LICENSE, usgovImlsPlsAdapter, } from "#us/adapters/usgov/imls-pls/adapter";
+export { USGOV_IRS_BMF_ADAPTER_ID, USGOV_IRS_BMF_DEFAULT_LICENSE, USGovIRSBMFAdapter, } from "#us/adapters/usgov/irs-bmf/adapter";
+export { USGOV_NAD_ADAPTER_ID, USGOV_NAD_DEFAULT_LICENSE, usgovNADAdapter } from "#us/adapters/usgov/nad/adapter";
+export { USGOV_NPPES_ADAPTER_ID, USGOV_NPPES_DEFAULT_LICENSE, usgovNPPESAdapter, } from "#us/adapters/usgov/nppes/adapter";
+export { USGOV_SAMHSA_ADAPTER_ID, USGOV_SAMHSA_DEFAULT_LICENSE, usgovSamhsaTreatmentLocatorAdapter, } from "#us/adapters/usgov/samhsa-treatment-locator/adapter";
+export { WOF_ADMIN_ADAPTER_ID, wofAdminAdapter } from "#adapters/wof/admin/json/adapter";
+export { WOF_POSTALCODE_ADAPTER_ID, wofPostalcodeAdapter } from "#adapters/wof/postalcode-json/adapter";
+//# sourceMappingURL=adapters.js.map

package/out/adapters.js.map

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