@mailwoman/resolver-wof-sqlite 10.0.0 → 10.2.0

package/lib/fts/index.ts

@@ -1,361 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   FTS5 index lifecycle for the WOF SQLite distribution.
- *
- *   Shared by `WOFSQLitePlaceLookup` (lazy build via `buildFTS: true`) and the operator-side
- *   `mailwoman gazetteer build fts` CLI (ahead-of-time build to avoid first-open latency in production).
- *
- *   Upstream WOF SQLite distributions do NOT ship FTS5. The index lives in a `place_search` virtual
- *   table whose rows mirror `(spr.id, spr.name, GROUP_CONCAT(names.name))` — one current,
- *   non-deprecated place per row, with all alternate names concatenated into a single search-token
- *   bag.
- */
-
-import type { DatabaseClient } from "@mailwoman/sqlite/client"
-import { tableExists } from "@mailwoman/sqlite/introspection"
-
-/**
- * Name of the FTS5 virtual table this module owns. Centralized so `WOFSQLitePlaceLookup` and the CLI can't drift apart.
- */
-export const PLACE_SEARCH_TABLE = "place_search"
-
-/**
- * Boundary-preserving separator between aliases in the `alt_names` bag (#523): U+E000, the first Private Use Area
- * codepoint, written as an escape so the source stays plain ASCII.
- *
- * Why a PUA codepoint and not punctuation: the goal is to stop a phrase query from matching ACROSS two adjacent
- * aliases' concatenation boundary ("York" + "New City" must not phrase-match `"york new"`). FTS5 assigns token
- * positions to TOKENS only — separator characters never consume a position — so any character the tokenizer treats as a
- * boundary leaves the two aliases' tokens adjacent and the false phrase match intact. The separator must therefore be
- * an INDEXED TOKEN that sits between the aliases and breaks positional adjacency.
- *
- * Empirical probe (node:sqlite, `tokenize = 'unicode61 remove_diacritics 2'` — the exact config below). Bag = the
- * aliases "York" and "New City" joined by each candidate separator; query = the cross-boundary phrase `MATCH '"york
- * new"'`:
- *
- * - `' '` (the pre-#523 join, no separator) — false HIT
- * - `' ; '` (punctuation) — false HIT
- * - `' \u2016 '` (double vertical line) — false HIT
- * - `' \x1F '` (ASCII unit separator) — false HIT
- * - `' \uE000 '` (PUA, this constant) — NO match, while `'"york"'` and `'"new city"'` still match the bag individually
- *   under every variant above.
- *
- * U+E000 works because unicode61 classifies it (category Co — neither space nor punctuation) as a token character, so
- * the standalone `\uE000` between aliases is indexed as its own token and the aliases' tokens are no longer
- * positionally adjacent. The remaining requirements also hold:
- *
- * - **Unreachable from queries**: `sanitizeFTSQuery` (Node + WASM resolvers) strips everything outside `\p{L}\p{N}` from
- *   token bodies, and U+E000 is neither — no user query can ever address the separator token. The demo's `sanitizeFTS`
- *   strips it explicitly.
- * - **Never in place names**: PUA codepoints are unassigned by definition; real-world WOF names don't carry them.
- *   Defensively, the INSERT below also strips any embedded U+E000 from source names so a poisoned row can't forge an
- *   alias boundary.
- * - **Survives GROUP_CONCAT**: verified — `GROUP_CONCAT(name, ' ' || char(57344) || ' ')` emits the codepoint intact
- *   (`57344` = 0xE000).
- * - **Cost**: one extra token per alias boundary in the FTS document. Marginal BM25 length-norm impact, on a column whose
- *   length stats are already the known #189 problem.
- *
- * Interaction with #189 (split `alt_names` into its own FTS table for independent BM25 length stats): the separator
- * SURVIVES that split as proposed — #189 still GROUP_CONCATs all aliases into one `place_search_alt` row per place, so
- * both the separator and the bag-parsing exact check (`aliasBagExactMatch`) carry over unchanged, just pointed at the
- * new table. Only if #189 were instead built as one-row-per-alias would both become moot (per-alias rows give exact
- * equality and phrase isolation for free). Sequencing: if #189 lands before the next slim-DB artifact rebuild, fold
- * both into ONE rebuild rather than shipping two FTS schema bumps.
- */
-export const ALIAS_SEPARATOR = "\uE000"
-
-/**
- * `char()` argument for {@link ALIAS_SEPARATOR} in SQL — keeps the SQL text plain ASCII.
- */
-const ALIAS_SEPARATOR_CODEPOINT = ALIAS_SEPARATOR.codePointAt(0) as number
-
-/**
- * The query/name fold every exact-tier comparison uses: lowercase, trim, collapse internal whitespace. The `alt_names`
- * bag is compared alias-by-alias against a query folded THIS way, so the fold lives beside the bag parser — every
- * consumer (the Node resolver's exact tier, the WASM resolver, the name-exact sub-tier sort) folds through this one
- * function.
- */
-export function foldQueryText(input: string): string {
-	return input.toLowerCase().trim().replaceAll(/\s+/g, " ")
-}
-
-/**
- * Does any alias in an `alt_names` bag exactly equal the (already-normalized) query? The single shared implementation
- * of the exact-tier alias check for every consumer of the bag — the Node resolver's `#exactMatchIDs` fallback, the WASM
- * resolver, and the demo's httpvfs resolver — so the bag format and its parsers can't drift.
- *
- * Two formats exist in the wild:
- *
- * - **Separated bags** (built since #523): aliases joined with {@link ALIAS_SEPARATOR}, plus a trailing separator so even
- *   a single-alias bag self-identifies as separator-formatted. Split + per-alias equality — a true exact-alias check,
- *   matching the semantics of the full `names` table (`names.name = ? COLLATE NOCASE`), so it runs unrestricted: an
- *   alias match is an exact match whether or not another candidate matched on its canonical name.
- * - **Legacy bags** (pre-#523 artifacts, e.g. an already-deployed slim DB): aliases space-joined, boundaries lost. Falls
- *   back to the historical padded-containment check, conditioned on `anyStrictExact` — unrestricted containment would
- *   false-promote interior fragments ("York" inside the alias "New York City") and cross-boundary fragments ("York New"
- *   across "…York" + "New…"). Delete this branch once every shipped artifact carries the separator.
- *
- * @param altNames The `alt_names` bag from `place_search` (null when the row has no aliases).
- * @param normalizedQuery The query, pre-normalized: lowercased, trimmed, internal whitespace collapsed (every consumer
- *   already normalizes this way).
- * @param anyStrictExact Whether ANY candidate in the pool already matched strictly (canonical name or region
- *   abbreviation). Only consulted for legacy bags.
- */
-export function aliasBagExactMatch(altNames: string | null, normalizedQuery: string, anyStrictExact: boolean): boolean {
-	if (altNames === null || altNames === "" || !normalizedQuery) return false
-
-	if (altNames.includes(ALIAS_SEPARATOR)) {
-		return altNames.split(ALIAS_SEPARATOR).some((alias) => foldQueryText(alias) === normalizedQuery)
-	}
-
-	if (anyStrictExact) return false
-
-	return ` ${foldQueryText(altNames)} `.includes(` ${normalizedQuery} `)
-}
-
-/**
- * Name of the R*Tree virtual table that indexes WOF places' bounding boxes for proximity / bbox lookups. Built
- * alongside `place_search` by the CLI and `buildFTS: true`. Pure SQLite — no extensions needed, the `rtree`
- * virtual-table module ships with the core library.
- */
-export const PLACE_BBOX_TABLE = "place_bbox"
-
-/**
- * Name of the auxiliary table holding `wof:population` per place. Powers the population-weighted ranking boost. Sparse
- * — WOF only populates this field for ~15% of localities (and mostly larger ones); missing means no boost, never a
- * penalty. Built upstream by `scripts/build-unified-wof.ts` at ingest (and copied through by `build-slim`) — this
- * module consumes it, never builds it.
- *
- * Schema: `(id INTEGER PRIMARY KEY, population INTEGER NOT NULL)`. Plain table, not virtual.
- */
-export const PLACE_POPULATION_TABLE = "place_population"
-
-/**
- * Name of the auxiliary table holding the two salience scores per place — `referential` (population-anchored, the
- * ranking backbone) and `encyclopedic` (the Wikipedia join, NULL when there is no article). Built by `mailwoman
- * gazetteer importance`; schema and derivations in `place-importance-schema.ts`.
- *
- * The lookup reads ONLY `encyclopedic` from it, and only to CARRY the value onto the result — referential is derived
- * from the population already joined, and no ORDER BY anywhere touches this table (ROAD_TO_V9 §2). Sparse and
- * schema-versioned: a pre-split gazetteer has this table with a single conflated `importance` column instead, which the
- * lookup's column probe deliberately refuses to read.
- */
-export const PLACE_IMPORTANCE_TABLE = "place_importance"
-
-/**
- * Counters for a single `buildPlaceSearchFTS` run. Exposed so callers (CLI, lazy-build) can render progress to the
- * user.
- */
-export interface BuildPlaceSearchFTSResult {
-	/**
-	 * Whether the FTS5 index was created (true) or already existed and was left alone (false).
-	 */
-	created: boolean
-	/**
-	 * Number of rows in the `place_search` table after the call.
-	 */
-	indexedRows: number
-	/**
-	 * Whether the R*Tree bbox index was created (true) or already existed (false).
-	 */
-	bboxCreated: boolean
-	/**
-	 * Number of rows in the `place_bbox` R*Tree after the call.
-	 */
-	bboxIndexedRows: number
-	/**
-	 * Wall-clock duration of the build step, in milliseconds.
-	 */
-	durationMs: number
-}
-
-export interface BuildPlaceSearchFTSOpts {
-	/**
-	 * Drop the existing `place_search` AND `place_bbox` tables before building. Default false — if either already exists
-	 * the corresponding build step is skipped. Set true when you want to rebuild against an updated `spr` / `names`
-	 * snapshot.
-	 */
-	drop?: boolean
-	/**
-	 * Optional progress callback invoked after each phase. Useful for CLI output on the planet-scale builds where the
-	 * INSERT step can take minutes.
-	 */
-	onProgress?: (
-		phase: "checking" | "dropping" | "creating" | "populating" | "creating-bbox" | "populating-bbox" | "done",
-		detail?: string
-	) => void
-}
-
-/**
- * Build (or rebuild, with `drop: true`) the `place_search` FTS5 virtual table AND the `place_bbox` R*Tree virtual table
- * from the existing `spr` + `names` tables in a WOF SQLite distribution.
- *
- * The FTS5 index is used for name-based MATCH queries; the R*Tree is used for bbox + proximity filtering. Both are pure
- * SQLite — no extensions required.
- *
- * Returns a `BuildPlaceSearchFTSResult` summary. Idempotent when `drop: false` — re-running against an already-indexed
- * DB skips whichever indexes already exist.
- */
-export function buildPlaceSearchFTS<DB>(
-	db: DatabaseClient<DB>,
-	opts: BuildPlaceSearchFTSOpts = {}
-): BuildPlaceSearchFTSResult {
-	const start = Date.now()
-	const onProgress = opts.onProgress ?? (() => {})
-
-	onProgress("checking")
-	const ftsExisting = tableExists(db, PLACE_SEARCH_TABLE)
-	const bboxExisting = tableExists(db, PLACE_BBOX_TABLE)
-
-	// ─── FTS5 phase ──────────────────────────────────────────────────
-	let ftsCreated = false
-
-	if (ftsExisting && opts.drop) {
-		onProgress("dropping", PLACE_SEARCH_TABLE)
-		db.exec(`DROP TABLE ${PLACE_SEARCH_TABLE}`)
-	}
-
-	if (!ftsExisting || opts.drop) {
-		onProgress("creating")
-
-		db.exec(`
-			CREATE VIRTUAL TABLE ${PLACE_SEARCH_TABLE} USING fts5(
-				wof_id UNINDEXED,
-				name,
-				alt_names,
-				tokenize = 'unicode61 remove_diacritics 2'
-			);
-		`)
-
-		onProgress("populating")
-
-		// Excludes only definitively-not-current places. WOF's `is_current` carries TWO conventions:
-		// `-1` (modern Who's On First) and `1` (legacy Mapzen-era), both meaning "currently valid".
-		// Only `0` means "no longer current". Filtering on `= -1` strict (as Phase 4.2 did) excluded
-		// ~42% of admin-US and ~68% of postcode-US — see #91 for the diagnostic + magnitude.
-		//
-		// Aliases join on the boundary-preserving ALIAS_SEPARATOR token (#523) — space-padded so each
-		// alias still tokenizes normally — and any U+E000 embedded in a source name is defensively
-		// flattened to a space so it can't forge a boundary. A TRAILING separator marks the bag as
-		// separator-formatted even when it holds a single alias, so `aliasBagExactMatch` never
-		// mistakes a new bag for a legacy (pre-#523) one. See the ALIAS_SEPARATOR docs for the
-		// probe + rationale.
-		db.exec(`
-			INSERT INTO ${PLACE_SEARCH_TABLE} (wof_id, name, alt_names)
-			SELECT
-				spr.id,
-				spr.name,
-				COALESCE((
-					SELECT GROUP_CONCAT(
-						REPLACE(name, char(${ALIAS_SEPARATOR_CODEPOINT}), ' '),
-						' ' || char(${ALIAS_SEPARATOR_CODEPOINT}) || ' '
-					) || ' ' || char(${ALIAS_SEPARATOR_CODEPOINT})
-					FROM names WHERE names.id = spr.id
-				), '')
-			FROM spr
-			WHERE spr.is_current != 0
-				AND spr.is_deprecated = 0
-				AND spr.name IS NOT NULL;
-		`)
-
-		ftsCreated = true
-	}
-
-	const ftsCountRow = db.prepare(`SELECT COUNT(*) AS n FROM ${PLACE_SEARCH_TABLE}`).get() as { n: number }
-
-	// ─── R*Tree phase ────────────────────────────────────────────────
-	let bboxCreated = false
-
-	if (bboxExisting && opts.drop) {
-		onProgress("dropping", PLACE_BBOX_TABLE)
-		db.exec(`DROP TABLE ${PLACE_BBOX_TABLE}`)
-	}
-
-	if (!bboxExisting || opts.drop) {
-		onProgress("creating-bbox")
-
-		// R*Tree requires INTEGER PRIMARY KEY (id) + paired min/max for each indexed dimension.
-		// `rtree` (not `rtree_i32`) keeps coordinates as REAL — what we want for WGS-84.
-		db.exec(`
-			CREATE VIRTUAL TABLE ${PLACE_BBOX_TABLE} USING rtree(
-				id,
-				min_lat, max_lat,
-				min_lon, max_lon
-			);
-		`)
-
-		onProgress("populating-bbox")
-
-		// Only index places that have non-zero coordinates AND a real bbox. WOF stores both the
-		// centroid (latitude/longitude) and the bounding box (min_*/max_*). A subset of rows have
-		// all-zero coordinates — likely placeholders for deprecated / unmapped entries; the
-		// is_current / is_deprecated filter mostly catches them, but we double-check at insert.
-		db.exec(`
-			INSERT INTO ${PLACE_BBOX_TABLE} (id, min_lat, max_lat, min_lon, max_lon)
-			SELECT
-				spr.id,
-				spr.min_latitude,
-				spr.max_latitude,
-				spr.min_longitude,
-				spr.max_longitude
-			FROM spr
-			WHERE spr.is_current != 0
-				AND spr.is_deprecated = 0
-				AND spr.min_latitude IS NOT NULL
-				AND spr.max_latitude IS NOT NULL
-				AND spr.min_longitude IS NOT NULL
-				AND spr.max_longitude IS NOT NULL
-				AND NOT (spr.min_latitude = 0 AND spr.max_latitude = 0
-				     AND spr.min_longitude = 0 AND spr.max_longitude = 0);
-		`)
-
-		bboxCreated = true
-	}
-
-	const bboxCountRow = db.prepare(`SELECT COUNT(*) AS n FROM ${PLACE_BBOX_TABLE}`).get() as { n: number }
-
-	// NOTE: `place_population` is NOT built here. `scripts/build-unified-wof.ts` extracts
-	// `wof:population` straight into that table at ingest (the canonical source carries no `geojson`
-	// table), and `build-slim` copies it through. This function only owns the two FTS-derived virtual
-	// tables, both of which build from `spr` + `names` alone. `placePopulationExists` lets callers
-	// check for the pre-built table.
-
-	onProgress(
-		"done",
-		`${ftsCountRow.n} FTS rows + ${bboxCountRow.n} bbox rows ` +
-			`(${ftsCreated ? "built" : "preexisting"} / ${bboxCreated ? "built" : "preexisting"})`
-	)
-
-	return {
-		created: ftsCreated,
-		indexedRows: ftsCountRow.n,
-		bboxCreated,
-		bboxIndexedRows: bboxCountRow.n,
-		durationMs: Date.now() - start,
-	}
-}
-
-/**
- * Returns true iff the `place_search` table exists in the connected DB. Used by `WOFSQLitePlaceLookup` for its "FTS
- * missing — pass buildFTS:true or run the CLI" guard.
- */
-export function placeSearchFTSExists<DB>(db: DatabaseClient<DB>): boolean {
-	return tableExists(db, PLACE_SEARCH_TABLE)
-}
-
-/**
- * Returns true iff the `place_bbox` R*Tree table exists. Used for opt-in proximity lookup checks.
- */
-export function placeBboxExists<DB>(db: DatabaseClient<DB>): boolean {
-	return tableExists(db, PLACE_BBOX_TABLE)
-}
-
-/**
- * Returns true iff the `place_population` table exists. Used for opt-in population-ranking checks.
- */
-export function placePopulationExists<DB>(db: DatabaseClient<DB>): boolean {
-	return tableExists(db, PLACE_POPULATION_TABLE)
-}

package/out/address/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/address/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAA;AACpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA"}

package/out/address/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/address/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAA;AACpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA"}

package/out/address/point/index.d.ts

@@ -1,53 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   SQLite implementation of core's `AddressPointLookup` (#476): exact `(street, number)` within a
- *   postcode (preferred), locality, or — for extracts whose points carry no scope tag (OSM, #247) —
- *   the resolved locality's BBOX. Query-side normalization is THE shared normalizer
- *   (`street-normalize.ts`), selected per the extract's `streetLocale` so build-side and probe-side
- *   stay identical by construction (US delegates to the USPS pipeline; FR/DE/NL use the locale rules).
- *
- *   Matching is exact-after-normalization only — no fuzzy street matching in this tier (measure how
- *   far exact gets first; fuzz is a later, separate decision). Scope order is most-selective first:
- *   postcode, then locality, then the bbox fall-through (only when a bbox is supplied AND the prior
- *   scopes missed). Multiple hits return the first by rowid — unit siblings share the building coord.
- */
-import type { AddressPointHit, AddressPointLookup } from "@mailwoman/core/resolver";
-import type { AddressPointDatabase } from "#address/point/schema";
-import { type StreetLocale } from "#street/normalize";
-export declare class AddressPointSqliteLookup<DB extends AddressPointDatabase = AddressPointDatabase> implements AddressPointLookup, Disposable {
-    #private;
-    /**
-     * @param dbPath Extract path.
-     * @param opts.streetLocale The street-normalization locale this extract was BUILT with — must match, or every key
-     *   misses. Defaults to `"us"` (the situs tier), so existing callers are unchanged.
-     * @param opts.localityKeys Whether the extract's `locality_norm` is a FULL place name a query can be held to. The BAN
-     *   and OSM extracts write the commune or `addr:city` in full; the US situs extract writes the NAD city field, which
-     *   several counties abbreviate (`addi` for Addison on 5,174 Texas rows, 327,264 Texas rows at four characters or
-     *   fewer) or give as the parent town (`easton` for North Easton). A key like that can steer WHICH row answers but
-     *   cannot refuse one, so it never contradicts. Defaults from the street locale: `"us"` is abbreviated, the rest
-     *   full.
-     */
-    constructor(dbPath: string, opts?: {
-        streetLocale?: StreetLocale;
-        localityKeys?: "full" | "abbreviated";
-    });
-    find(query: {
-        street: string;
-        number: string;
-        postcode?: string;
-        locality?: string;
-        region?: string;
-        subregion?: string;
-        bbox?: {
-            minLat: number;
-            maxLat: number;
-            minLon: number;
-            maxLon: number;
-        };
-    }): AddressPointHit | null;
-    [Symbol.dispose](): void;
-}
-//# sourceMappingURL=index.d.ts.map

package/out/address/point/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/address/point/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAGnF,OAAO,KAAK,EAAE,oBAAoB,EAAqB,MAAM,uBAAuB,CAAA;AAEpF,OAAO,EASN,KAAK,YAAY,EACjB,MAAM,mBAAmB,CAAA;AAc1B,qBAAa,wBAAwB,CAAC,EAAE,SAAS,oBAAoB,GAAG,oBAAoB,CAC3F,YAAW,kBAAkB,EAAE,UAAU;;IAwBzC;;;;;;;;;;OAUG;IACH,YAAY,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,YAAY,CAAC,EAAE,YAAY,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,GAAG,aAAa,CAAA;KAAO,EAsC5G;IAED,IAAI,CAAC,KAAK,EAAE;QACX,MAAM,EAAE,MAAM,CAAA;QACd,MAAM,EAAE,MAAM,CAAA;QACd,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,IAAI,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KACzE,GAAG,eAAe,GAAG,IAAI,CAsCzB;IA4JD,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAEvB;CACD"}

package/out/address/point/index.js

@@ -1,222 +0,0 @@
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   SQLite implementation of core's `AddressPointLookup` (#476): exact `(street, number)` within a
- *   postcode (preferred), locality, or — for extracts whose points carry no scope tag (OSM, #247) —
- *   the resolved locality's BBOX. Query-side normalization is THE shared normalizer
- *   (`street-normalize.ts`), selected per the extract's `streetLocale` so build-side and probe-side
- *   stay identical by construction (US delegates to the USPS pipeline; FR/DE/NL use the locale rules).
- *
- *   Matching is exact-after-normalization only — no fuzzy street matching in this tier (measure how
- *   far exact gets first; fuzz is a later, separate decision). Scope order is most-selective first:
- *   postcode, then locality, then the bbox fall-through (only when a bbox is supplied AND the prior
- *   scopes missed). Multiple hits return the first by rowid — unit siblings share the building coord.
- */
-import { DatabaseClient } from "@mailwoman/sqlite/client";
-import { hasTable, prepareGet } from "#sqlite-utils";
-import { normalizeHouseNumberForKey, normalizeLocalityForKey, normalizeLocalityForKeyLocale, streetKeyVariants, streetLocaleForSurface, stripArrondissement, } from "#street/normalize";
-/**
- * The 4 columns the reader SELECTs, in the schema's order — referenced by the prepared SELECTs so the projected
- * `AddressPointRow` stays in lockstep with the shared schema.
- */
-const SELECT_COLS = "lat, lon, source, release, locality_norm, postcode";
-export class AddressPointSqliteLookup {
-    #db;
-    #locale;
-    #localityKeys;
-    #byPostcode;
-    #byPostcodeLocality;
-    #byLocality;
-    /**
-     * The scope key matched by its TAIL — a `zh` query that names the 鄉鎮市區 without its 縣市. Narrowed by the (street,
-     * number) index first, so the LIKE walks the handful of rows that share the pair.
-     */
-    #byLocalityTail;
-    #byBbox;
-    /**
-     * @param dbPath Extract path.
-     * @param opts.streetLocale The street-normalization locale this extract was BUILT with — must match, or every key
-     *   misses. Defaults to `"us"` (the situs tier), so existing callers are unchanged.
-     * @param opts.localityKeys Whether the extract's `locality_norm` is a FULL place name a query can be held to. The BAN
-     *   and OSM extracts write the commune or `addr:city` in full; the US situs extract writes the NAD city field, which
-     *   several counties abbreviate (`addi` for Addison on 5,174 Texas rows, 327,264 Texas rows at four characters or
-     *   fewer) or give as the parent town (`easton` for North Easton). A key like that can steer WHICH row answers but
-     *   cannot refuse one, so it never contradicts. Defaults from the street locale: `"us"` is abbreviated, the rest
-     *   full.
-     */
-    constructor(dbPath, opts = {}) {
-        this.#db = new DatabaseClient(dbPath, { readOnly: true });
-        this.#locale = opts.streetLocale ?? "us";
-        this.#localityKeys = opts.localityKeys ?? (this.#locale === "us" ? "abbreviated" : "full");
-        // Degrade gracefully on an empty/tableless extract (interrupted build, stray 0-byte file): with no
-        // `address_point` table this lookup is a no-op miss, not a crash that loses the whole state (#568).
-        if (hasTable(this.#db, "address_point")) {
-            this.#byPostcode = prepareGet(this.#db, `SELECT ${SELECT_COLS} FROM address_point
-				 WHERE postcode = ? AND street_norm = ? AND number = ? LIMIT 1`);
-            this.#byPostcodeLocality = prepareGet(this.#db, `SELECT ${SELECT_COLS} FROM address_point
-				 WHERE postcode = ? AND locality_norm = ? AND street_norm = ? AND number = ? LIMIT 1`);
-            this.#byLocality = prepareGet(this.#db, `SELECT ${SELECT_COLS} FROM address_point
-				 WHERE locality_norm = ? AND street_norm = ? AND number = ? LIMIT 1`);
-            this.#byBbox = prepareGet(this.#db, `SELECT ${SELECT_COLS} FROM address_point
-				 WHERE street_norm = ? AND number = ? AND lat BETWEEN ? AND ? AND lon BETWEEN ? AND ? LIMIT 1`);
-            this.#byLocalityTail = prepareGet(this.#db, `SELECT ${SELECT_COLS} FROM address_point
-				 WHERE street_norm = ? AND number = ? AND locality_norm LIKE ? LIMIT 1`);
-        }
-    }
-    find(query) {
-        if (!this.#byPostcode || !this.#byLocality || !this.#byBbox)
-            return null;
-        const number = normalizeHouseNumberForKey(query.number, this.#locale);
-        if (!number)
-            return null;
-        // A `zh` extract scopes a point by 縣市 + 鄉鎮市區, the pair the parse tags `region` + `subregion`; the Taiwanese
-        // register carries no postcode and the parse no `locality`. The pair becomes the locality key here, on the
-        // reader that was built with the same fold, and a Latin extract never sees the two fields. A line that names
-        // only the 鄉鎮市區 (`中和區中興街281號`, 14.7% of the TW board) matches the stored pair by its tail instead.
-        const scoped = this.#locale === "zh" && !query.locality && query.subregion
-            ? query.region
-                ? { ...query, locality: `${query.region}${query.subregion}` }
-                : { ...query, localityTail: normalizeLocalityForKeyLocale(query.subregion, "zh") }
-            : query;
-        // Key-variant ladder (see `streetKeyVariants`): the literal key first, then the doubled-type
-        // collapse and the saint↔st register swap — each variant runs the FULL number ladder below, and
-        // the first variant to answer wins, so an attested literal key is never second-guessed.
-        let row;
-        for (const streetNorm of streetKeyVariants(query.street, streetLocaleForSurface(query.street, this.#locale))) {
-            row = this.#findForKey(streetNorm, number, scoped);
-            if (row)
-                break;
-        }
-        if (!row)
-            return null;
-        return {
-            lat: row.lat,
-            lon: row.lon,
-            source: row.source,
-            release: row.release,
-            ...(row.locality_norm ? { localityNorm: row.locality_norm } : {}),
-            ...(row.postcode ? { postcode: row.postcode } : {}),
-        };
-    }
-    /**
-     * The full number ladder for ONE normalized street key: exact, then the range low-end, then letter-suffix spacing
-     * with the base-number fall — see each rung's note in place.
-     */
-    #findForKey(streetNorm, number, query) {
-        let row = this.#probe(streetNorm, number, query);
-        // Range-surface fallback: every register this reader serves stores ONE number per point
-        // (G-NAF `NUMBER_FIRST`, BAN, OA, OSM `addr:housenumber`), but the attested surface is often
-        // a range — "385-387 Esplanade" keys `385`. Null-only: an exact range key that matched above
-        // (some OSM points DO carry "385-387" verbatim) is never second-guessed.
-        if (!row) {
-            const low = /^(\d+[a-z]?)-\d+[a-z]?$/.exec(number)?.[1];
-            if (low) {
-                row = this.#probe(streetNorm, low, query);
-            }
-        }
-        // Letter-suffix spacing fallback: the registers disagree on the joint — BAN stores "3 a"
-        // (space-separated), G-NAF and most OA sources store "3a" — and the parsed surface can arrive
-        // either way. On a miss, retry the OTHER spacing; on a double miss, the BASE number (the
-        // register attests no 3A but does attest 3 — the adjacent-parcel approximation, priced the
-        // same as the range fallback's low end). Null-only throughout, and only for the
-        // digits+single-letter shape (never touches "12 1/2" or unit-bearing forms).
-        if (!row) {
-            const joined = /^(\d+)\s+([a-z])$/.exec(number);
-            const spaced = /^(\d+)([a-z])$/.exec(number);
-            if (joined) {
-                row = this.#probe(streetNorm, `${joined[1]}${joined[2]}`, query) ?? this.#probe(streetNorm, joined[1], query);
-            }
-            else if (spaced) {
-                row = this.#probe(streetNorm, `${spaced[1]} ${spaced[2]}`, query) ?? this.#probe(streetNorm, spaced[1], query);
-            }
-        }
-        // Sub-number fallback for the Taiwanese register: `14之12` is building 12 off number 14, `30附40` an attached
-        // number, stored as number `14` / `30` with the rest in `unit`. A query that kept the pair on the number span
-        // falls to the base number — the same adjacent-parcel approximation the letter-suffix rung makes, priced the
-        // same: on the 2,000-row served read the rows answered this way sit a median 256 m and at most 1.0 km from the
-        // building.
-        if (!row && this.#locale === "zh") {
-            const base = /^(\d+)(?:[之附]\d+)+$/u.exec(number)?.[1];
-            if (base) {
-                row = this.#probe(streetNorm, base, query);
-            }
-        }
-        return row;
-    }
-    /**
-     * The scope ladder for one (street, number) key: postcode, then locality, then the bbox fall-through — each rung only
-     * when the prior missed.
-     */
-    #probe(streetNorm, number, query) {
-        let row;
-        if (query.postcode) {
-            const postcode = query.postcode.trim();
-            const localityKey = query.locality ? this.#localityKey(query.locality) : undefined;
-            // A postcode can span several places — DE 04509 covers Schönwölkau and Werlitzsch, both with a Teichstraße 3 —
-            // so when the query names a locality the row whose own locality agrees is asked for FIRST. Only when no such
-            // row exists does the postcode-only row answer, and then only if its locality does not name a different place
-            // (see `#scopeContradicts` for what "different" tolerates): a query naming a third village under the postcode
-            // falls through to the locality rung rather than answering the wrong rooftop.
-            const agreeing = localityKey ? this.#byPostcodeLocality(postcode, localityKey, streetNorm, number) : undefined;
-            const candidate = agreeing ?? this.#byPostcode(postcode, streetNorm, number);
-            row = candidate && !this.#scopeContradicts(candidate, query) ? candidate : undefined;
-        }
-        if (!row && query.locality) {
-            // FR extracts key arrondissement communes at the base city (both-sides fold, see the BAN
-            // builder + stripArrondissement) — fold the probe too so "Paris 13e Arrondissement" and
-            // "Paris" both hit. No-op for "us" extracts and every non-arrondissement commune.
-            row = this.#byLocality(this.#localityKey(query.locality), streetNorm, number);
-        }
-        if (!row && query.localityTail && this.#byLocalityTail) {
-            // A Han key carries no `%` or `_`, so the tail is a literal suffix pattern.
-            row = this.#byLocalityTail(streetNorm, number, `%${query.localityTail}`);
-        }
-        // Bbox fall-through (#247): the point carries no postcode/locality of its own, but its coordinate falls
-        // inside the resolved locality's box. Only reached when the scoped probes missed AND a bbox was supplied.
-        if (!row && query.bbox) {
-            const b = query.bbox;
-            const candidate = this.#byBbox(streetNorm, number, b.minLat, b.maxLat, b.minLon, b.maxLon);
-            // A register row that carries its own scope and was NOT found by the scoped rungs is a different address that
-            // happens to share the street and number inside the box: `10 rue de la République, 75008 Paris` reached
-            // Servon's `10 rue de la République` (postcode 77170) 26 km away this way, at rooftop tier and 1 m uncertainty.
-            // The rung exists for points with no scope of their own; a point whose scope disagrees with the query is a miss.
-            row = candidate && !this.#scopeContradicts(candidate, query) ? candidate : undefined;
-        }
-        return row;
-    }
-    /**
-     * The query's locality folded the way the extract's builder folded its `locality_norm`. FR extracts key
-     * arrondissement communes at the base city (both-sides fold, see the BAN builder + stripArrondissement), so "Paris
-     * 13e Arrondissement" and "Paris" both hit; a no-op for every other locale.
-     */
-    #localityKey(locality) {
-        if (this.#locale === "fr")
-            return stripArrondissement(normalizeLocalityForKey(locality));
-        return normalizeLocalityForKeyLocale(locality, this.#locale);
-    }
-    /**
-     * Whether a row's OWN postcode or locality names a different place than the query did. Absent scope on the row is not
-     * a contradiction — it is the case the bbox rung was built for — and a rung that matched ON a field cannot contradict
-     * it, so at the postcode rung only the locality can disagree and at the bbox rung either can.
-     *
-     * The locality is consulted only on an extract whose keys are full names (the constructor's `localityKeys`). Under
-     * exact comparison against the US extract's abbreviated keys, the postcode rung refused `4900 Airport Pkwy, Addison
-     * TX 75001`'s own rooftop row (`addi`) and `678 Depot St, North Easton, MA 02356`'s (`easton`), and both `pass` board
-     * rows fell to interpolation 144–198 m away — invisible to a 1 km grade (#2155). `servon` against `paris` and
-     * `werlitzsch` against `krensitz`, on the BAN and OSM extracts, are different places and still refuse.
-     */
-    #scopeContradicts(row, query) {
-        if (query.postcode && row.postcode && row.postcode.trim() !== query.postcode.trim())
-            return true;
-        if (this.#localityKeys === "full" && query.locality && row.locality_norm) {
-            return row.locality_norm !== this.#localityKey(query.locality);
-        }
-        return false;
-    }
-    [Symbol.dispose]() {
-        this.#db[Symbol.dispose]();
-    }
-}
-//# sourceMappingURL=index.js.map

package/out/address/point/index.js.map

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