@mailwoman/corpus 9.2.0 → 9.3.0

package/src/adapters/usgov-nad/adapter.ts

@@ -1,348 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `usgov-nad`: US DOT National Address Database — ~97M structured address-point records.
- *
- *   The single largest US address source available — federal aggregation of state + local 911-grade
- *   address points (every addressable location). Compared to TIGER ADDRFEAT (~20M segment-level, no
- *   city/locality) and NPPES (~7M provider-centric venues), NAD covers the entire residential +
- *   commercial address space with full structured components.
- *
- *   The adapter consumes NDJSON shards produced by `fetch-nad.ts`'s featureserver mode (operator
- *   pre-downloads via `mailwoman corpus fetch nad`). Each shard is per-OID-range
- *   `oids_<start>-<end>.ndjson` with a sibling `.manifest.json`. Adapter iterates every `.ndjson`
- *   in the input directory, skipping the `quarantined-bash-bug/` subdir (legacy of the bash-
- *   fetcher's silent-page-failure bug).
- *
- *   Field mapping (NAD v9 → CanonicalRow components):
- *
- *   - House_number: `AddNo_Full` (pre-composed); falls back to AddNum_Pre + Add_Number + AddNum_Suf
- *   - Street: `StNam_Full` (pre-composed); falls back to St_PreDir + St_PreTyp + St_Name + St_PosTyp
- *
- *       - St_PosDir + St_PosMod composition
- *   - Locality: `Post_City` > `Inc_Muni` > `Census_Plc` > `Uninc_Comm` (first non-empty)
- *   - Region: `State` (2-char USPS code, including territories: PR, GU, VI, AS, MP)
- *   - Postcode: `Zip_Code` + `Plus_4` (joined as `XXXXX-NNNN` when both present)
- *   - Venue: `LandmkName` (typically a park, school, hospital, named facility — when present)
- *
- *   License: stamped `"Public Domain"` per 17 U.S.C. § 105 (US federal works).
- */
-
-import { readdir } from "node:fs/promises"
-import { join } from "node:path"
-
-import { isPresent, tryParsingJSON } from "@mailwoman/core/objects"
-import { reconcileComponents } from "@mailwoman/formatter"
-import { TextSpliterator } from "spliterator"
-
-import type { AdapterOptions, CanonicalRow, 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 const USGOV_NAD_ADAPTER_ID = "usgov-nad"
-/**
- * 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 USGOV_NAD_DEFAULT_LICENSE = "Public Domain"
-
-interface NADRecord {
-	OBJECTID?: number
-	UUID?: string | null
-	// House number
-	AddNum_Pre?: string | null
-	Add_Number?: number | string | null
-	AddNum_Suf?: string | null
-	AddNo_Full?: string | null
-	// Street parts
-	St_PreMod?: string | null
-	St_PreDir?: string | null
-	St_PreTyp?: string | null
-	St_PreSep?: string | null
-	St_Name?: string | null
-	St_PosTyp?: string | null
-	St_PosDir?: string | null
-	St_PosMod?: string | null
-	StNam_Full?: string | null
-	// Sub-address (carried as part of street for now; Phase 1 has no unit/floor labels)
-	Building?: string | null
-	Floor?: string | null
-	Unit?: string | null
-	Room?: string | null
-	Seat?: string | null
-	Addtl_Loc?: string | null
-	SubAddress?: string | null
-	// Landmark / venue
-	LandmkName?: string | null
-	// Locality alternates (we prefer Post_City for what a human would type)
-	County?: string | null
-	Inc_Muni?: string | null
-	Post_City?: string | null
-	Census_Plc?: string | null
-	Uninc_Comm?: string | null
-	Nbrhd_Comm?: string | null
-	NatAmArea?: string | null
-	NatAmSub?: string | null
-	Urbnztn_PR?: string | null
-	PlaceOther?: string | null
-	PlaceNmTyp?: string | null
-	// State + ZIP
-	State?: string | null
-	Zip_Code?: string | null
-	Plus_4?: string | null
-}
-
-const US_STATES_SET = new Set([
-	"AL",
-	"AK",
-	"AZ",
-	"AR",
-	"CA",
-	"CO",
-	"CT",
-	"DE",
-	"DC",
-	"FL",
-	"GA",
-	"HI",
-	"ID",
-	"IL",
-	"IN",
-	"IA",
-	"KS",
-	"KY",
-	"LA",
-	"ME",
-	"MD",
-	"MA",
-	"MI",
-	"MN",
-	"MS",
-	"MO",
-	"MT",
-	"NE",
-	"NV",
-	"NH",
-	"NJ",
-	"NM",
-	"NY",
-	"NC",
-	"ND",
-	"OH",
-	"OK",
-	"OR",
-	"PA",
-	"RI",
-	"SC",
-	"SD",
-	"TN",
-	"TX",
-	"UT",
-	"VT",
-	"VA",
-	"WA",
-	"WV",
-	"WI",
-	"WY",
-	// Territories that ship in NAD
-	"PR",
-	"GU",
-	"VI",
-	"AS",
-	"MP",
-])
-
-function nonEmpty(...values: Array<string | null | undefined>): string | undefined {
-	for (const v of values) {
-		const trimmed = (v ?? "").toString().trim()
-
-		if (trimmed) return trimmed
-	}
-
-	return undefined
-}
-
-function composeHouseNumber(r: NADRecord): string | undefined {
-	const full = (r.AddNo_Full ?? "").toString().trim()
-
-	if (full) return full
-	const num = r.Add_Number == null ? "" : String(r.Add_Number).trim()
-
-	if (!num) return undefined
-	const pre = (r.AddNum_Pre ?? "").toString().trim()
-	const suf = (r.AddNum_Suf ?? "").toString().trim()
-
-	return [pre, num, suf].filter(isPresent).join(" ").trim() || undefined
-}
-
-interface DecomposedNADStreet {
-	prefix?: string
-	street?: string
-	suffix?: string
-	full: string
-}
-
-function decomposeNADStreet(r: NADRecord): DecomposedNADStreet | undefined {
-	const name = (r.St_Name ?? "").toString().trim()
-
-	if (name) {
-		const preDir = (r.St_PreDir ?? "").toString().trim()
-		const preTyp = (r.St_PreTyp ?? "").toString().trim()
-		const preSep = (r.St_PreSep ?? "").toString().trim()
-		const posTyp = (r.St_PosTyp ?? "").toString().trim()
-		const posDir = (r.St_PosDir ?? "").toString().trim()
-		const prefix = [preDir, preTyp, preSep].filter(isPresent).join(" ") || undefined
-		const suffix = [posTyp, posDir].filter(isPresent).join(" ") || undefined
-		const full = [prefix, name, suffix].filter(isPresent).join(" ")
-
-		return { prefix, street: name, suffix, full }
-	}
-
-	const full = (r.StNam_Full ?? "").toString().trim()
-
-	if (full) return { full, street: full }
-
-	return undefined
-}
-
-function composeLocality(r: NADRecord): string | undefined {
-	return nonEmpty(r.Post_City, r.Inc_Muni, r.Census_Plc, r.Uninc_Comm)
-}
-
-function composePostcode(r: NADRecord): string | undefined {
-	const zip = (r.Zip_Code ?? "").toString().trim()
-
-	if (!zip) return undefined
-	const plus4 = (r.Plus_4 ?? "").toString().trim()
-
-	return plus4 ? `${zip}-${plus4}` : zip
-}
-
-function composeRaw(parts: {
-	venue?: string
-	houseNumber?: string
-	street?: string
-	unit?: string
-	locality: string
-	region: string
-	postcode: string
-}): string {
-	const streetLine = [parts.houseNumber, parts.street, parts.unit].filter(isPresent).join(" ").trim()
-	const tail = `${parts.locality}, ${parts.region} ${parts.postcode}`
-
-	return [parts.venue, streetLine || undefined, tail].filter(isPresent).join(", ")
-}
-
-export function createUsgovNADAdapter(): CorpusAdapter {
-	return {
-		id: USGOV_NAD_ADAPTER_ID,
-		defaultLicense: USGOV_NAD_DEFAULT_LICENSE,
-		description:
-			"US DOT National Address Database — ~97M structured US address points (911-grade). Single largest US source.",
-
-		async *rows(opts: AdapterOptions): AsyncIterable<CanonicalRow> {
-			if (opts.country && opts.country !== "US") {
-				throw new Error(`usgov-nad adapter: only US supported, got country=${opts.country}`)
-			}
-
-			// inputPath is a directory of NDJSON shards (per fetch-nad.ts featureserver output).
-			// Single-file inputs (e.g. a bulk-extracted CSV) are not currently supported — the
-			// featureserver shard pattern is the primary distribution.
-			const entries = await readdir(opts.inputPath)
-			const shards = entries.filter((n) => n.endsWith(".ndjson")).toSorted()
-
-			let emitted = 0
-			outer: for (const shard of shards) {
-				if (opts.signal?.aborted) break
-				// TextSpliterator streams string lines; the per-line tryParsingJSON below keeps the reader
-				// tolerant of malformed rows (skip silently), so TextSpliterator + a non-throwing parse —
-				// not JSONSpliterator, which would throw. The path string lets the lib own + dispose each
-				// shard's file handle, including on the `break outer` early exit.
-				const lines = TextSpliterator.fromAsync(join(opts.inputPath, shard))
-
-				for await (const line of lines) {
-					if (opts.signal?.aborted) break outer
-
-					if (opts.limit !== undefined && emitted >= opts.limit) break outer
-
-					if (!line) continue
-
-					const record = tryParsingJSON<NADRecord>(line)
-
-					if (record === null) continue // malformed line — skip silently
-
-					const state = (record.State ?? "").toString().trim().toUpperCase()
-
-					if (!US_STATES_SET.has(state)) continue
-
-					const locality = composeLocality(record)
-
-					if (!locality) continue
-
-					const postcode = composePostcode(record)
-
-					if (!postcode) continue
-
-					const decomposed = decomposeNADStreet(record)
-					const houseNumber = composeHouseNumber(record)
-					const venue = nonEmpty(record.LandmkName)
-					const unit = nonEmpty(record.Unit, record.Building, record.Floor, record.Room)
-
-					const components: CanonicalRow["components"] = {
-						...(venue ? { venue } : {}),
-						...(houseNumber ? { house_number: houseNumber } : {}),
-						...(decomposed?.prefix ? { street_prefix: decomposed.prefix } : {}),
-						...(decomposed?.street ? { street: decomposed.street } : {}),
-						...(decomposed?.suffix ? { street_suffix: decomposed.suffix } : {}),
-						...(unit ? { unit } : {}),
-						locality,
-						region: state,
-						postcode,
-					}
-
-					const raw = composeRaw({
-						venue,
-						houseNumber,
-						street: decomposed?.full,
-						unit,
-						locality,
-						region: state,
-						postcode,
-					})
-
-					if (!raw) continue
-
-					const aligned = reconcileComponents(components, raw)
-
-					if (Object.keys(aligned).length <= 2) continue
-
-					const sourceID = record.UUID
-						? `${USGOV_NAD_ADAPTER_ID}-${record.UUID}`
-						: `${USGOV_NAD_ADAPTER_ID}-${record.OBJECTID ?? `${shard}:${emitted}`}`
-
-					yield {
-						raw,
-						components: aligned,
-						country: "US",
-						locale: "en-US",
-						source: USGOV_NAD_ADAPTER_ID,
-						source_id: sourceID,
-						corpus_version: "",
-						license: USGOV_NAD_DEFAULT_LICENSE,
-					}
-
-					emitted++
-				}
-			}
-		},
-	}
-}
-
-/**
- * The configured adapter instance registered with the corpus builder.
- */
-export const usgovNADAdapter = createUsgovNADAdapter()

package/src/adapters/usgov-nppes/adapter.ts

@@ -1,159 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `usgov-nppes`: CMS National Plan and Provider Enumeration System (NPI registry) CSV consumer.
- *
- *   NPPES is the authoritative US healthcare provider registry, published monthly by CMS. Each row
- *   carries a provider's business practice location address together with their legal business name
- *   or individual name. At ~7M rows it is the single largest venue+address signal source
- *   available.
- *
- *   The adapter consumes the monthly full-replacement CSV (operator pre-downloads via
- *   `fetch-nppes.ts`). Column names match the canonical NPPES "Full Replacement Monthly NPI File"
- *   header published at `https://download.cms.gov/nppes/NPI_Files.html`.
- *
- *   Output: one row per CSV record where the practice location address is populated. Organization
- *   rows carry `venue` from the legal business name; individual rows compose `attention` from
- *   last+first name. Address quad goes on `(house_number, street, locality, region, postcode)`.
- *
- *   License: stamped `"Public Domain"` per CMS's federal government distribution 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"
-import type { AdapterOptions, CanonicalRow, 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 const USGOV_NPPES_ADAPTER_ID = "usgov-nppes"
-/**
- * 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 USGOV_NPPES_DEFAULT_LICENSE = "Public Domain"
-
-interface NPPESRow {
-	NPI: string
-	"Entity Type Code": string
-	"Provider Organization Name (Legal Business Name)": string
-	"Provider Last Name (Legal Name)": string
-	"Provider First Name": string
-	"Provider First Line Business Practice Location Address": string
-	"Provider Second Line Business Practice Location Address": string
-	"Provider Business Practice Location Address City Name": string
-	"Provider Business Practice Location Address State Name": string
-	"Provider Business Practice Location Address Postcode": string
-}
-
-function composeRaw(
-	venue: string | undefined,
-	house: string | undefined,
-	street: string,
-	city: string,
-	state: string,
-	postcode: string
-): string {
-	const streetPart = [house, street].filter(isPresent).join(" ").trim()
-
-	const cityPart = [city.trim(), [state, postcode].filter(isPresent).join(" ").trim()].filter(isPresent).join(", ")
-
-	return [venue, streetPart, cityPart].filter(isPresent).join(", ")
-}
-
-export function createUsgovNPPESAdapter(): CorpusAdapter {
-	return {
-		id: USGOV_NPPES_ADAPTER_ID,
-		defaultLicense: USGOV_NPPES_DEFAULT_LICENSE,
-		description:
-			"CMS National Plan and Provider Enumeration System — 7M provider practice locations (public-domain). Venue+address co-occurrence at scale.",
-
-		async *rows(opts: AdapterOptions): AsyncIterable<CanonicalRow> {
-			if (opts.country && opts.country !== "US") {
-				throw new Error(`usgov-nppes 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 as AsyncIterable<NPPESRow>) {
-				if (opts.signal?.aborted) break
-
-				if (opts.limit !== undefined && emitted >= opts.limit) break
-
-				const npi = (record.NPI ?? "").trim()
-				const orgName = (record["Provider Organization Name (Legal Business Name)"] ?? "").trim()
-				const lastName = (record["Provider Last Name (Legal Name)"] ?? "").trim()
-				const firstName = (record["Provider First Name"] ?? "").trim()
-
-				const address1 = (record["Provider First Line Business Practice Location Address"] ?? "").trim()
-				const address2 = (record["Provider Second Line Business Practice Location Address"] ?? "").trim()
-				const city = (record["Provider Business Practice Location Address City Name"] ?? "").trim()
-				const stateRaw = (record["Provider Business Practice Location Address State Name"] ?? "").trim()
-				const postcode = (record["Provider Business Practice Location Address Postcode"] ?? "").trim()
-
-				if (!city || !postcode) continue
-
-				const state = lookupStateAbbreviation(stateRaw)
-
-				if (!state) continue
-
-				const fullStreet = [address1, address2].filter(isPresent).join(" ")
-				const split = splitStreetLine(fullStreet)
-
-				if (!split) continue
-
-				const venue = orgName || [firstName, lastName].filter(isPresent).join(" ") || undefined
-
-				const components: CanonicalRow["components"] = {
-					...(venue ? { venue } : {}),
-					...(split.house_number ? { house_number: split.house_number } : {}),
-					street: split.street,
-					locality: city,
-					region: state.abbreviation,
-					postcode,
-				}
-
-				const raw = composeRaw(venue, split.house_number, split.street, city, state.abbreviation, postcode)
-
-				if (!raw) continue
-
-				const aligned = reconcileComponents(components, raw)
-
-				if (Object.keys(aligned).length <= 2) continue
-
-				const sourceID = npi ? `${USGOV_NPPES_ADAPTER_ID}-${npi}` : stableSourceID(USGOV_NPPES_ADAPTER_ID, aligned)
-
-				yield {
-					raw,
-					components: aligned,
-					country: "US",
-					locale: "en-US",
-					source: USGOV_NPPES_ADAPTER_ID,
-					source_id: sourceID,
-					corpus_version: "",
-					license: USGOV_NPPES_DEFAULT_LICENSE,
-				}
-
-				emitted++
-			}
-		},
-	}
-}
-
-/**
- * The configured adapter instance registered with the corpus builder.
- */
-export const usgovNPPESAdapter = createUsgovNPPESAdapter()

package/src/adapters/usgov-samhsa-treatment-locator/adapter.ts

@@ -1,204 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `usgov-samhsa-treatment-locator`: SAMHSA Behavioral Health Treatment Services Locator CSV
- *   consumer.
- *
- *   SAMHSA's Treatment Locator (`findtreatment.gov`) is the federal directory of substance-use and
- *   mental-health treatment facilities. The published CSV carries the facility name, an optional
- *   secondary name (typically the organizational parent), and the postal address quad split into
- *   primary + secondary street lines. Phase 1.6 §1.2 (#22) selects this source for the same reason
- *   it selects HRSA: facility names are hand-typed venue strings and the addresses pass through
- *   enough human + system hands to accumulate the suite-designator + sub-tenant chaos ("Suite C,
- *   behind main building") that pure gazetteer data does not.
- *
- *   SAMHSA's two-line address shape is the key adapter-specific concern. `street1` typically carries
- *   the canonical postal address (`"123 Main St"`); `street2` carries the suite / unit / "second
- *   floor" surface form. The adapter joins them with `", "` into a single `street` component (Phase
- *   1 keeps `unit` as a deferred slot since the OpenCage template doesn't have a clean rendering
- *   for it). Operators wanting a different join policy can subclass the factory.
- *
- *   Column names below match the canonical SAMHSA Behavioral Health Treatment Services Locator CSV
- *   export header. Operators substituting a closely-related extract should rename columns to match;
- *   the README has the mapping cheatsheet.
- *
- *   License: stamped `"Public Domain"` per the SAMHSA Open Data Foundry's federal-government
- *   distribution 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"
-import type { AdapterOptions, CanonicalRow, 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 const USGOV_SAMHSA_ADAPTER_ID = "usgov-samhsa-treatment-locator"
-/**
- * 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 USGOV_SAMHSA_DEFAULT_LICENSE = "Public Domain"
-
-/**
- * Subset of SAMHSA Treatment Locator CSV columns consulted by the adapter. Column names match the canonical SAMHSA Open
- * Data Foundry export header. `name1` is the venue; `name2` is optional and folded into the venue when present.
- */
-interface SamhsaSiteRow {
-	name1: string
-	name2?: string
-	street1: string
-	street2?: string
-	city: string
-	state: string
-	zip: string
-	/**
-	 * Optional. Falls back to `stableSourceID` derived from components when missing.
-	 */
-	frid?: string
-}
-
-/**
- * Join the SAMHSA two-line street: primary street + optional secondary line (suite / unit / floor / "behind main
- * building") on `", "`. The combined value is the `street` component surface form. Phase 1 does not break this out into
- * the `unit` component — see the file-level comment.
- */
-function joinTwoLineStreet(street1: string, street2: string | undefined): string {
-	const s1 = street1.trim()
-	const s2 = (street2 ?? "").trim()
-
-	if (!s1 && !s2) return ""
-
-	if (!s2) return s1
-
-	if (!s1) return s2
-
-	return `${s1}, ${s2}`
-}
-
-/**
- * Combine `name1` + optional `name2` into a single venue surface form. SAMHSA conventions:
- *
- * - `name1` is the program / clinic name ("Mountain Plains Counseling Services").
- * - `name2` is the parent organization ("Catholic Charities of Wyoming"), if any.
- *
- * Both render together as `"<name1> - <name2>"` when both are present — geocoder users typically type either form, so
- * the model benefits from the joined surface.
- */
-function composeVenue(name1: string, name2: string | undefined): string {
-	const n1 = name1.trim()
-	const n2 = (name2 ?? "").trim()
-
-	if (!n1 && !n2) return ""
-
-	if (!n2) return n1
-
-	if (!n1) return n2
-
-	return `${n1} - ${n2}`
-}
-
-/**
- * Same envelope-style format as HRSA: venue prefix, street body, city/state/zip suffix.
- */
-function composeRaw(
-	venue: string,
-	house: string | undefined,
-	street: string,
-	city: string,
-	state: string,
-	postcode: string
-): string {
-	const streetPart = [house, street].filter(isPresent).join(" ").trim()
-	const cityPart = [city.trim(), [state, postcode].filter(isPresent).join(" ").trim()].filter(isPresent).join(", ")
-
-	return [venue.trim(), streetPart, cityPart].filter(isPresent).join(", ")
-}
-
-export function createUsgovSamhsaTreatmentLocatorAdapter(): CorpusAdapter {
-	return {
-		id: USGOV_SAMHSA_ADAPTER_ID,
-		defaultLicense: USGOV_SAMHSA_DEFAULT_LICENSE,
-		description:
-			"SAMHSA Behavioral Health Treatment Services Locator (public-domain). Adversarial source: venue + two-line address co-occurrence, hand-entered.",
-
-		async *rows(opts: AdapterOptions): AsyncIterable<CanonicalRow> {
-			if (opts.country && opts.country !== "US") {
-				throw new Error(`usgov-samhsa 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 as AsyncIterable<SamhsaSiteRow>) {
-				if (opts.signal?.aborted) break
-
-				if (opts.limit !== undefined && emitted >= opts.limit) break
-
-				const venue = composeVenue(record.name1 ?? "", record.name2)
-				const street = joinTwoLineStreet(record.street1 ?? "", record.street2)
-				const split = splitStreetLine(street)
-				const city = (record.city ?? "").trim()
-				const stateAbbr = (record.state ?? "").trim()
-				const postcode = (record.zip ?? "").trim()
-
-				if (!venue || !split || !city || !postcode) continue
-				const state = lookupStateAbbreviation(stateAbbr)
-
-				if (!state) continue
-
-				// venue first — same kryptonite-defending insertion order as HRSA.
-				const components: CanonicalRow["components"] = {
-					venue,
-					...(split.house_number ? { house_number: split.house_number } : {}),
-					street: split.street,
-					locality: city,
-					region: state.abbreviation,
-					postcode,
-				}
-
-				const raw = composeRaw(venue, split.house_number, split.street, city, state.abbreviation, postcode)
-
-				if (!raw) continue
-
-				const aligned = reconcileComponents(components, raw)
-
-				if (!Object.keys(aligned).length) continue
-
-				const frID = (record.frid ?? "").trim()
-
-				const sourceID = frID ? `${USGOV_SAMHSA_ADAPTER_ID}-${frID}` : stableSourceID(USGOV_SAMHSA_ADAPTER_ID, aligned)
-
-				yield {
-					raw,
-					components: aligned,
-					country: "US",
-					locale: "en-US",
-					source: USGOV_SAMHSA_ADAPTER_ID,
-					source_id: sourceID,
-					corpus_version: "",
-					license: USGOV_SAMHSA_DEFAULT_LICENSE,
-				}
-
-				emitted++
-			}
-		},
-	}
-}
-
-/**
- * The configured adapter instance registered with the corpus builder.
- */
-export const usgovSamhsaTreatmentLocatorAdapter = createUsgovSamhsaTreatmentLocatorAdapter()