@mailwoman/resolver-wof-sqlite 7.0.0 → 7.2.0

package/out/poi-lookup.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Node reader for `poi.db` (spec §3.4) — the res-9 k-ring reader over the clustered `poi`
+ *   `WITHOUT ROWID` B-tree Task 1's schema (`poi-schema.ts`) builds. Three search modes share one
+ *   artifact:
+ *
+ *   - **Category**: `latLngToCell(center, 9)` → `gridDisk` ring-by-ring expansion, probing each
+ *     cell's clustered `(h3_cell, category_id, neg_rank, …)` range. Rings accumulate until `limit`
+ *     rows are on hand after a completed ring, or `maxRings` is exhausted; the pool is sorted by
+ *     haversine distance from `center` after every ring.
+ *   - **Brand**: the same k-ring walk, but probing on `brand_wikidata` instead — category
+ *     unconstrained, so a chain's rows surface regardless of how they were categorized.
+ *   - **Name**: FTS5 `MATCH` against the `poi_search` virtual table, hydrated back to full rows by
+ *     `name_key`. No center required; if one is given, hits are still distance-sorted.
+ *
+ *   `latLngToCell`/`gridDisk` come from `h3-js`; the 48-bit short-cell packing that turns a raw H3
+ *   cell into the integer `poi.h3_cell` stores is `@mailwoman/spatial`'s `shortenH3Cell` — that math
+ *   is NEVER reimplemented here (see AGENTS.md on `@mailwoman/spatial` being the one true home for
+ *   it).
+ */
+import { DatabaseSync } from "node:sqlite";
+/** Resolution the `poi` table's `h3_cell` column is keyed at — matches the builder (spec §3.4). */
+export declare const POI_H3_RESOLUTION = 9;
+export interface POISearchQuery {
+    /** Poi-taxonomy category id (string side of the dictionary). Ignored when `brandWikidata` is also set — brand wins. */
+    categoryID?: string;
+    /** Wikidata QID for brand-exact search. */
+    brandWikidata?: string;
+    /** Free-text name (FTS5). */
+    name?: string;
+    /** Search center. Required for category/brand queries (k-ring expansion). */
+    center?: {
+        latitude: number;
+        longitude: number;
+    };
+    /**
+     * Ring budget: how many res-9 k-rings to expand before giving up (default 12 ≈ ~4 km). Counts ring 0, so k reaches
+     * `maxRings - 1`.
+     */
+    maxRings?: number;
+    limit?: number;
+}
+export interface POISearchHit {
+    name: string | null;
+    categoryID: string | null;
+    brandWikidata: string | null;
+    latitude: number;
+    longitude: number;
+    country: string;
+    confidence: number;
+    distanceM?: number;
+}
+export interface POILookupOpts {
+    /** Path to a `poi.db` built by the (future) POI builder. Opened read-only. */
+    databasePath?: string;
+    /** Pre-opened handle (tests / shared connections). Mutually exclusive with `databasePath`. */
+    database?: DatabaseSync;
+}
+/**
+ * Node reader over `poi.db`. `implements Disposable` so callers can `using lookup = new POILookup(...)` (or call
+ * `[Symbol.dispose]()` explicitly), the same precedent as {@link WOFCandidateTableLookup} /
+ * {@link WOFSqlitePlaceLookup}.
+ */
+export declare class POILookup implements Disposable {
+    #private;
+    constructor(opts: POILookupOpts);
+    search(query: POISearchQuery): POISearchHit[];
+    close(): void;
+    [Symbol.dispose](): void;
+}
+//# sourceMappingURL=poi-lookup.d.ts.map

package/out/poi-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poi-lookup.d.ts","sourceRoot":"","sources":["../poi-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAO1C,mGAAmG;AACnG,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAQlC,MAAM,WAAW,cAAc;IAC9B,uHAAuH;IACvH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,6BAA6B;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,MAAM,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;IAChD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC7B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,YAAY,CAAA;CACvB;AAQD;;;;GAIG;AACH,qBAAa,SAAU,YAAW,UAAU;;gBAa/B,IAAI,EAAE,aAAa;IAiC/B,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,YAAY,EAAE;IA8H7C,KAAK,IAAI,IAAI;IAMb,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI;CAGxB"}

package/out/poi-lookup.js

@@ -0,0 +1,226 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Node reader for `poi.db` (spec §3.4) — the res-9 k-ring reader over the clustered `poi`
+ *   `WITHOUT ROWID` B-tree Task 1's schema (`poi-schema.ts`) builds. Three search modes share one
+ *   artifact:
+ *
+ *   - **Category**: `latLngToCell(center, 9)` → `gridDisk` ring-by-ring expansion, probing each
+ *     cell's clustered `(h3_cell, category_id, neg_rank, …)` range. Rings accumulate until `limit`
+ *     rows are on hand after a completed ring, or `maxRings` is exhausted; the pool is sorted by
+ *     haversine distance from `center` after every ring.
+ *   - **Brand**: the same k-ring walk, but probing on `brand_wikidata` instead — category
+ *     unconstrained, so a chain's rows surface regardless of how they were categorized.
+ *   - **Name**: FTS5 `MATCH` against the `poi_search` virtual table, hydrated back to full rows by
+ *     `name_key`. No center required; if one is given, hits are still distance-sorted.
+ *
+ *   `latLngToCell`/`gridDisk` come from `h3-js`; the 48-bit short-cell packing that turns a raw H3
+ *   cell into the integer `poi.h3_cell` stores is `@mailwoman/spatial`'s `shortenH3Cell` — that math
+ *   is NEVER reimplemented here (see AGENTS.md on `@mailwoman/spatial` being the one true home for
+ *   it).
+ */
+import { DatabaseSync } from "node:sqlite";
+import { haversineKm, shortenH3Cell } from "@mailwoman/spatial";
+import { gridDisk, latLngToCell } from "h3-js";
+/** Resolution the `poi` table's `h3_cell` column is keyed at — matches the builder (spec §3.4). */
+export const POI_H3_RESOLUTION = 9;
+/** Ring budget default: 12 res-9 k-rings ≈ ~4 km. */
+const DEFAULT_MAX_RINGS = 12;
+/** Row-count default when a query doesn't specify `limit`. */
+const DEFAULT_LIMIT = 20;
+/**
+ * Node reader over `poi.db`. `implements Disposable` so callers can `using lookup = new POILookup(...)` (or call
+ * `[Symbol.dispose]()` explicitly), the same precedent as {@link WOFCandidateTableLookup} /
+ * {@link WOFSqlitePlaceLookup}.
+ */
+export class POILookup {
+    #db;
+    #ownsDB;
+    #categoryToID = new Map();
+    #idToCategory = new Map();
+    /** `(h3_cell, category_id)` → the cell's category-clustered range, most-confident-first. */
+    #categoryCellProbe;
+    /** `(h3_cell, brand_wikidata)` → the cell's brand-matched rows (category unconstrained). */
+    #brandCellProbe;
+    /** FTS5 `MATCH` over `poi_search`, returning candidate `name_key`s to hydrate. */
+    #nameFTSProbe;
+    constructor(opts) {
+        if (opts.database) {
+            this.#db = opts.database;
+            this.#ownsDB = false;
+        }
+        else if (opts.databasePath) {
+            this.#db = new DatabaseSync(opts.databasePath, { readOnly: true });
+            this.#ownsDB = true;
+        }
+        else {
+            throw new Error("POILookup needs `databasePath` or `database`");
+        }
+        // The category dictionary is tiny (poi-taxonomy's category count) — load it once at
+        // construction so `search` never round-trips to it.
+        for (const r of this.#db
+            .prepare("SELECT id, category FROM poi_category_codes")
+            .all()) {
+            this.#categoryToID.set(String(r.category), Number(r.id));
+            this.#idToCategory.set(Number(r.id), String(r.category));
+        }
+        const columns = "name, category_id, brand_wikidata, latitude, longitude, country, confidence, name_key";
+        this.#categoryCellProbe = this.#db.prepare(`SELECT ${columns} FROM poi WHERE h3_cell = ? AND category_id = ? ORDER BY neg_rank ASC LIMIT ?`);
+        this.#brandCellProbe = this.#db.prepare(`SELECT ${columns} FROM poi WHERE h3_cell = ? AND brand_wikidata = ? ORDER BY neg_rank ASC LIMIT ?`);
+        this.#nameFTSProbe = this.#db.prepare("SELECT name_key FROM poi_search WHERE poi_search MATCH ? ORDER BY bm25(poi_search) LIMIT ?");
+    }
+    search(query) {
+        const limit = Math.max(1, query.limit ?? DEFAULT_LIMIT);
+        if (query.name) {
+            return this.#searchByName(query.name, limit, query.center);
+        }
+        if (query.categoryID || query.brandWikidata) {
+            if (!query.center) {
+                throw new Error("POILookup.search: category/brand search requires a `center`");
+            }
+            return this.#searchKRing(query, limit);
+        }
+        return [];
+    }
+    /** Category or brand path: k-ring expansion from `query.center`'s res-9 cell, probing each new ring's cells. */
+    #searchKRing(query, limit) {
+        const center = query.center;
+        const maxRings = query.maxRings ?? DEFAULT_MAX_RINGS;
+        let categoryId;
+        // brandWikidata wins over categoryID when both are set — see POISearchQuery.categoryID.
+        if (!query.brandWikidata) {
+            categoryId = this.#categoryToID.get(query.categoryID);
+            // An unknown category (not in the dictionary) can't have rows — a clean miss, not a throw.
+            if (categoryId === undefined)
+                return [];
+        }
+        const origin = latLngToCell(center.latitude, center.longitude, POI_H3_RESOLUTION);
+        const seenCells = new Set();
+        let rows = [];
+        // `ring` starts at 0 (the origin cell itself), so this loop's k reaches `maxRings - 1`.
+        for (let ring = 0; ring < maxRings; ring++) {
+            // gridDisk(origin, ring) returns the WHOLE disk out to `ring`; diffing against what's
+            // already been probed derives just this ring's new cells.
+            const diskCells = gridDisk(origin, ring);
+            const newCells = diskCells.filter((cell) => !seenCells.has(cell));
+            for (const cell of newCells) {
+                seenCells.add(cell);
+                const shortCell = h3CellToInt(cell);
+                const hits = query.brandWikidata
+                    ? this.#brandCellProbe.all(shortCell, query.brandWikidata, limit)
+                    : this.#categoryCellProbe.all(shortCell, categoryId, limit);
+                rows.push(...hits);
+            }
+            rows = sortByDistance(rows, center);
+            if (rows.length >= limit)
+                break;
+        }
+        return rows.slice(0, limit).map((row) => toHit(row, this.#idToCategory, center));
+    }
+    /**
+     * Name path: FTS5 MATCH → hydrate by name_key. No center required; distance-sorts if one is given anyway.
+     *
+     * Hydration is ONE batched `WHERE name_key IN (...)` query over the FTS hits' unique `name_key`s, not a per-hit probe
+     * — with up to `limit` FTS hits, a per-hit probe was up to `limit` full table scans before `createPOINameKeyIndex`
+     * (poi-schema.ts) + this batching.
+     */
+    #searchByName(name, limit, center) {
+        const matchQuery = sanitizePOINameQuery(name);
+        if (!matchQuery)
+            return [];
+        const ftsHits = this.#nameFTSProbe.all(matchQuery, limit);
+        const uniqueKeys = [];
+        const seenKeys = new Set();
+        for (const hit of ftsHits) {
+            if (!hit.name_key || seenKeys.has(hit.name_key))
+                continue;
+            seenKeys.add(hit.name_key);
+            uniqueKeys.push(hit.name_key);
+        }
+        if (uniqueKeys.length === 0)
+            return [];
+        const hydrated = this.#hydrateByNameKeys(uniqueKeys);
+        const rowsByKey = new Map();
+        for (const row of hydrated) {
+            if (row.name_key === null)
+                continue;
+            const bucket = rowsByKey.get(row.name_key);
+            if (bucket) {
+                bucket.push(row);
+            }
+            else {
+                rowsByKey.set(row.name_key, [row]);
+            }
+        }
+        let rows = [];
+        for (const key of uniqueKeys) {
+            rows.push(...(rowsByKey.get(key) ?? []));
+        }
+        if (center) {
+            rows = sortByDistance(rows, center);
+        }
+        return rows.slice(0, limit).map((row) => toHit(row, this.#idToCategory, center));
+    }
+    /**
+     * Batched hydration for the FTS name path: `WHERE name_key IN (?, ?, …)`, one query for the whole batch instead of
+     * one probe per FTS hit. This is a cold path (name search only) with variable arity per call, so the statement is
+     * prepared fresh each time rather than cached.
+     */
+    #hydrateByNameKeys(nameKeys) {
+        const columns = "name, category_id, brand_wikidata, latitude, longitude, country, confidence, name_key";
+        const placeholders = nameKeys.map(() => "?").join(", ");
+        const stmt = this.#db.prepare(`SELECT ${columns} FROM poi WHERE name_key IN (${placeholders})`);
+        return stmt.all(...nameKeys);
+    }
+    close() {
+        if (this.#ownsDB) {
+            this.#db.close();
+        }
+    }
+    [Symbol.dispose]() {
+        this.close();
+    }
+}
+/** `poi.h3_cell` is the SHORTENED (48-bit) cell — never the full h3-js cell string. */
+function h3CellToInt(cell) {
+    return Number(BigInt(`0x${shortenH3Cell(cell)}`));
+}
+function sortByDistance(rows, center) {
+    return [...rows].sort((a, b) => haversineKm(center.latitude, center.longitude, a.latitude, a.longitude) -
+        haversineKm(center.latitude, center.longitude, b.latitude, b.longitude));
+}
+function toHit(row, idToCategory, center) {
+    return {
+        name: row.name,
+        categoryID: row.category_id !== 0 ? (idToCategory.get(row.category_id) ?? null) : null,
+        brandWikidata: row.brand_wikidata,
+        latitude: row.latitude,
+        longitude: row.longitude,
+        country: row.country,
+        confidence: row.confidence,
+        ...(center
+            ? { distanceM: haversineKm(center.latitude, center.longitude, row.latitude, row.longitude) * 1000 }
+            : {}),
+    };
+}
+/**
+ * Sanitize free text into an FTS5-safe MATCH query: strip the characters FTS5 would otherwise read as syntax (`"`
+ * phrase delimiters, `*` prefix wildcards, `:` column-filter separators), then phrase-quote each whitespace-separated
+ * token (AND-joined).
+ *
+ * `resolver-wof-sqlite` already has this discipline — `lookup.ts`'s `sanitizeFTSQuery` — but that function is
+ * module-private there (not re-exported from `fts.ts` or the package's `index.ts`), so this replicates the same
+ * discipline locally rather than reaching across the module boundary for a private helper.
+ */
+function sanitizePOINameQuery(text) {
+    return text
+        .replace(/["*:]/g, "")
+        .trim()
+        .split(/\s+/u)
+        .filter(Boolean)
+        .map((token) => `"${token.replace(/"/g, '""')}"`)
+        .join(" ");
+}
+//# sourceMappingURL=poi-lookup.js.map

package/out/poi-lookup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poi-lookup.js","sourceRoot":"","sources":["../poi-lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAe,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAI9C,mGAAmG;AACnG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAA;AAElC,qDAAqD;AACrD,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAE5B,8DAA8D;AAC9D,MAAM,aAAa,GAAG,EAAE,CAAA;AA2CxB;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACrB,GAAG,CAAc;IACjB,OAAO,CAAS;IACP,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAA;IACzC,aAAa,GAAG,IAAI,GAAG,EAAkB,CAAA;IAElD,4FAA4F;IACnF,kBAAkB,CAAqC;IAChE,4FAA4F;IACnF,eAAe,CAAqC;IAC7D,kFAAkF;IACzE,aAAa,CAAqC;IAE3D,YAAY,IAAmB;QAC9B,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAA;YACxB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAA;QACrB,CAAC;aAAM,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAA;YAClE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACpB,CAAC;aAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;QAChE,CAAC;QAED,oFAAoF;QACpF,oDAAoD;QACpD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG;aACtB,OAAO,CAAC,6CAA6C,CAAC;aACtD,GAAG,EAAuC,EAAE,CAAC;YAC9C,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YACxD,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;QACzD,CAAC;QAED,MAAM,OAAO,GAAG,uFAAuF,CAAA;QAEvG,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CACzC,UAAU,OAAO,+EAA+E,CAChG,CAAA;QACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CACtC,UAAU,OAAO,kFAAkF,CACnG,CAAA;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CACpC,4FAA4F,CAC5F,CAAA;IACF,CAAC;IAED,MAAM,CAAC,KAAqB;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,IAAI,aAAa,CAAC,CAAA;QAEvD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;QAC3D,CAAC;QAED,IAAI,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;YAC7C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAA;YAC/E,CAAC;YAED,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QACvC,CAAC;QAED,OAAO,EAAE,CAAA;IACV,CAAC;IAED,gHAAgH;IAChH,YAAY,CAAC,KAAqB,EAAE,KAAa;QAChD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAO,CAAA;QAC5B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,iBAAiB,CAAA;QACpD,IAAI,UAA8B,CAAA;QAElC,wFAAwF;QACxF,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;YAC1B,UAAU,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,UAAW,CAAC,CAAA;YAEtD,2FAA2F;YAC3F,IAAI,UAAU,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAA;QACxC,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAW,CAAA;QAC3F,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAA;QACnC,IAAI,IAAI,GAAa,EAAE,CAAA;QAEvB,wFAAwF;QACxF,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAC;YAC5C,sFAAsF;YACtF,0DAA0D;YAC1D,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAa,CAAA;YACpD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;YAEjE,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;gBAC7B,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBACnB,MAAM,SAAS,GAAG,WAAW,CAAC,IAAc,CAAC,CAAA;gBAE7C,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa;oBAC/B,CAAC,CAAE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,aAAa,EAAE,KAAK,CAAyB;oBAC1F,CAAC,CAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,UAAW,EAAE,KAAK,CAAyB,CAAA;gBAEtF,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;YACnB,CAAC;YAED,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;YAEnC,IAAI,IAAI,CAAC,MAAM,IAAI,KAAK;gBAAE,MAAK;QAChC,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAA;IACjF,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,IAAY,EAAE,KAAa,EAAE,MAAgD;QAC1F,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAA;QAE7C,IAAI,CAAC,UAAU;YAAE,OAAO,EAAE,CAAA;QAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,UAAU,EAAE,KAAK,CAAkD,CAAA;QAC1G,MAAM,UAAU,GAAa,EAAE,CAAA;QAC/B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;QAElC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC;gBAAE,SAAQ;YACzD,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAC1B,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAC9B,CAAC;QAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAA;QAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAA;QACpD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAA;QAE7C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI;gBAAE,SAAQ;YACnC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;YAE1C,IAAI,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACjB,CAAC;iBAAM,CAAC;gBACP,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC,CAAA;YACnC,CAAC;QACF,CAAC;QAED,IAAI,IAAI,GAAa,EAAE,CAAA;QAEvB,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC9B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QACzC,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACZ,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QACpC,CAAC;QAED,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAA;IACjF,CAAC;IAED;;;;OAIG;IACH,kBAAkB,CAAC,QAAkB;QACpC,MAAM,OAAO,GAAG,uFAAuF,CAAA;QACvG,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACvD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,OAAO,gCAAgC,YAAY,GAAG,CAAC,CAAA;QAE/F,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAwB,CAAA;IACpD,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;QACjB,CAAC;IACF,CAAC;IAED,CAAC,MAAM,CAAC,OAAO,CAAC;QACf,IAAI,CAAC,KAAK,EAAE,CAAA;IACb,CAAC;CACD;AAED,uFAAuF;AACvF,SAAS,WAAW,CAAC,IAAY;IAChC,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAA;AAClD,CAAC;AAED,SAAS,cAAc,CAAC,IAAc,EAAE,MAA+C;IACtF,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CACpB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACR,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC;QACvE,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,CACxE,CAAA;AACF,CAAC;AAED,SAAS,KAAK,CACb,GAAW,EACX,YAAyC,EACzC,MAAgD;IAEhD,OAAO;QACN,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,UAAU,EAAE,GAAG,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;QACtF,aAAa,EAAE,GAAG,CAAC,cAAc;QACjC,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,GAAG,CAAC,MAAM;YACT,CAAC,CAAC,EAAE,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE;YACnG,CAAC,CAAC,EAAE,CAAC;KACN,CAAA;AACF,CAAC;AAED;;;;;;;;GAQG;AACH,SAAS,oBAAoB,CAAC,IAAY;IACzC,OAAO,IAAI;SACT,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,IAAI,EAAE;SACN,KAAK,CAAC,MAAM,CAAC;SACb,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;SAChD,IAAI,CAAC,GAAG,CAAC,CAAA;AACZ,CAAC"}

package/out/poi-schema.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Typed schema for poi.db — spatial layer #1 (spec §3.4). One clustered `WITHOUT ROWID` B-tree
+ *   keyed `(h3_cell, category_id, neg_rank, rowid_key)` so "everything near this res-9 cell" is a
+ *   contiguous key range (the byte-range/httpvfs access pattern, same discipline as the candidate
+ *   gazetteer). Rows carry denormalized name/brand/coords; category ids are small ints via the
+ *   `poi_category_codes` dictionary (poi-taxonomy category ids are the string side). The DB also
+ *   embeds the layer-contract tables from `@mailwoman/core/layers` — the builder writes the
+ *   manifest (tier `shipped`, spine `h3` res 9) and per-res-6-cell coverage.
+ */
+import type { DatabaseSync } from "node:sqlite";
+import type { LayerContractDatabase } from "@mailwoman/core/layers";
+import { type Kysely } from "kysely";
+/** One POI row. Clustered PK: h3_cell → category_id → neg_rank → rowid_key. */
+export interface POITable {
+    /** 48-bit short H3 cell at res 9 (`latLngToCell` → `shortenH3Cell`). */
+    h3_cell: number;
+    /** Small int from {@link POICategoryCodeTable}; 0 = uncategorized. */
+    category_id: number;
+    /** `-log10(confidence + epsilon)` so ASC = most-confident-first within a cell+category. */
+    neg_rank: number;
+    /** Uniquifier within the clustered key (builder-assigned monotonic int). */
+    rowid_key: number;
+    name: string | null;
+    /** Lowercased, diacritic-flattened probe key for exact name lookups. */
+    name_key: string | null;
+    brand_wikidata: string | null;
+    latitude: number;
+    longitude: number;
+    /** ISO 3166-1 alpha-2 (from the Overture partition). */
+    country: string;
+    /** Overture existence confidence (already filtered ≥ 0.85 at build). */
+    confidence: number;
+    /** GERS id — nullable METADATA ONLY, never a key (the #470 rule). */
+    gers_id: string | null;
+}
+/**
+ * Staging mirror — every column nullable except the coords (the loader fills positionally; the materialize SELECT
+ * enforces completeness).
+ */
+export interface POIStageTable {
+    h3_cell: number | null;
+    category_id: number | null;
+    neg_rank: number | null;
+    rowid_key: number | null;
+    name: string | null;
+    name_key: string | null;
+    brand_wikidata: string | null;
+    latitude: number;
+    longitude: number;
+    country: string | null;
+    confidence: number | null;
+    gers_id: string | null;
+}
+/** `(id → poi-taxonomy category id)` dictionary, e.g. `3 → "cafe"`. */
+export interface POICategoryCodeTable {
+    id: number;
+    category: string;
+}
+export interface POIDatabase extends LayerContractDatabase {
+    poi: POITable;
+    poi_stage: POIStageTable;
+    poi_category_codes: POICategoryCodeTable;
+}
+/** Clustered-key-order column list shared by builder + `INSERT INTO poi SELECT … FROM poi_stage`. */
+export declare const POI_COLUMNS: readonly ["h3_cell", "category_id", "neg_rank", "rowid_key", "name", "name_key", "brand_wikidata", "latitude", "longitude", "country", "confidence", "gers_id"];
+export declare function createPOIStagingTables(db: Kysely<POIDatabase>): Promise<void>;
+export declare function createPOITable(db: Kysely<POIDatabase>): Promise<void>;
+/** Secondary index for the FTS-hydration path. Builders call this AFTER the bulk materialize (index-after-load). */
+export declare function createPOINameKeyIndex(db: Kysely<POIDatabase>): Promise<void>;
+export declare const POI_FTS_TABLE = "poi_search";
+/** FTS5 stays raw SQL by project rule (Kysely can't express virtual tables). Content-keyed by name_key. */
+export declare function createPOISearchFTS(db: DatabaseSync): void;
+//# sourceMappingURL=poi-schema.d.ts.map

package/out/poi-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poi-schema.d.ts","sourceRoot":"","sources":["../poi-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AACnE,OAAO,EAAO,KAAK,MAAM,EAAE,MAAM,QAAQ,CAAA;AAEzC,+EAA+E;AAC/E,MAAM,WAAW,QAAQ;IACxB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAA;IACf,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAA;IACnB,2FAA2F;IAC3F,QAAQ,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAY,SAAQ,qBAAqB;IACzD,GAAG,EAAE,QAAQ,CAAA;IACb,SAAS,EAAE,aAAa,CAAA;IACxB,kBAAkB,EAAE,oBAAoB,CAAA;CACxC;AAED,qGAAqG;AACrG,eAAO,MAAM,WAAW,iKAad,CAAA;AAEV,wBAAsB,sBAAsB,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBnF;AAED,wBAAsB,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB3E;AAED,oHAAoH;AACpH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAElF;AAED,eAAO,MAAM,aAAa,eAAe,CAAA;AAEzC,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAIzD"}

package/out/poi-schema.js

@@ -0,0 +1,81 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Typed schema for poi.db — spatial layer #1 (spec §3.4). One clustered `WITHOUT ROWID` B-tree
+ *   keyed `(h3_cell, category_id, neg_rank, rowid_key)` so "everything near this res-9 cell" is a
+ *   contiguous key range (the byte-range/httpvfs access pattern, same discipline as the candidate
+ *   gazetteer). Rows carry denormalized name/brand/coords; category ids are small ints via the
+ *   `poi_category_codes` dictionary (poi-taxonomy category ids are the string side). The DB also
+ *   embeds the layer-contract tables from `@mailwoman/core/layers` — the builder writes the
+ *   manifest (tier `shipped`, spine `h3` res 9) and per-res-6-cell coverage.
+ */
+import { sql } from "kysely";
+/** Clustered-key-order column list shared by builder + `INSERT INTO poi SELECT … FROM poi_stage`. */
+export const POI_COLUMNS = [
+    "h3_cell",
+    "category_id",
+    "neg_rank",
+    "rowid_key",
+    "name",
+    "name_key",
+    "brand_wikidata",
+    "latitude",
+    "longitude",
+    "country",
+    "confidence",
+    "gers_id",
+];
+export async function createPOIStagingTables(db) {
+    await db.schema
+        .createTable("poi_category_codes")
+        .addColumn("id", "integer", (c) => c.primaryKey())
+        .addColumn("category", "text", (c) => c.unique())
+        .execute();
+    await db.schema
+        .createTable("poi_stage")
+        .addColumn("h3_cell", "integer")
+        .addColumn("category_id", "integer")
+        .addColumn("neg_rank", "real")
+        .addColumn("rowid_key", "integer")
+        .addColumn("name", "text")
+        .addColumn("name_key", "text")
+        .addColumn("brand_wikidata", "text")
+        .addColumn("latitude", "real")
+        .addColumn("longitude", "real")
+        .addColumn("country", "text")
+        .addColumn("confidence", "real")
+        .addColumn("gers_id", "text")
+        .execute();
+}
+export async function createPOITable(db) {
+    await db.schema
+        .createTable("poi")
+        .addColumn("h3_cell", "integer", (c) => c.notNull())
+        .addColumn("category_id", "integer", (c) => c.notNull())
+        .addColumn("neg_rank", "real", (c) => c.notNull())
+        .addColumn("rowid_key", "integer", (c) => c.notNull())
+        .addColumn("name", "text")
+        .addColumn("name_key", "text")
+        .addColumn("brand_wikidata", "text")
+        .addColumn("latitude", "real", (c) => c.notNull())
+        .addColumn("longitude", "real", (c) => c.notNull())
+        .addColumn("country", "text", (c) => c.notNull())
+        .addColumn("confidence", "real", (c) => c.notNull())
+        .addColumn("gers_id", "text")
+        .addPrimaryKeyConstraint("poi_pk", ["h3_cell", "category_id", "neg_rank", "rowid_key"])
+        // `WITHOUT ROWID` has no first-class builder; the raw modifier is the idiomatic fallback.
+        .modifyEnd(sql `without rowid`)
+        .execute();
+}
+/** Secondary index for the FTS-hydration path. Builders call this AFTER the bulk materialize (index-after-load). */
+export async function createPOINameKeyIndex(db) {
+    await db.schema.createIndex("poi_name_key").on("poi").column("name_key").execute();
+}
+export const POI_FTS_TABLE = "poi_search";
+/** FTS5 stays raw SQL by project rule (Kysely can't express virtual tables). Content-keyed by name_key. */
+export function createPOISearchFTS(db) {
+    db.exec(`CREATE VIRTUAL TABLE ${POI_FTS_TABLE} USING fts5(name, name_key UNINDEXED, h3_cell UNINDEXED, tokenize = 'unicode61')`);
+}
+//# sourceMappingURL=poi-schema.js.map

package/out/poi-schema.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailwoman/resolver-wof-sqlite",
-  "version": "7.0.0",
+  "version": "7.2.0",
   "description": "Who's On First SQLite resolver — FTS5-backed PlaceLookup that resolves text queries to WOF place IDs + coordinates. Optional dependency for callers who want geocoding.",
   "license": "AGPL-3.0-only OR LicenseRef-Commercial",
   "repository": {
@@ -19,201 +19,140 @@
   "exports": {
     "./package.json": "./package.json",
     ".": {
-      "types": "./out/index.d.ts",
-      "default": "./out/index.js"
+      "node": "./index.ts",
+      "default": "./out/index.js",
+      "types": "./out/index.d.ts"
     },
     "./fts": {
-      "types": "./out/fts.d.ts",
-      "default": "./out/fts.js"
+      "node": "./fts.ts",
+      "default": "./out/fts.js",
+      "types": "./out/fts.d.ts"
     },
     "./build-slim": {
-      "types": "./out/build-slim.d.ts",
-      "default": "./out/build-slim.js"
+      "node": "./build-slim.ts",
+      "default": "./out/build-slim.js",
+      "types": "./out/build-slim.d.ts"
     },
     "./fst-builder": {
-      "types": "./out/fst-builder.d.ts",
-      "default": "./out/fst-builder.js"
+      "node": "./fst-builder.ts",
+      "default": "./out/fst-builder.js",
+      "types": "./out/fst-builder.d.ts"
     },
     "./street-morphology-fst-builder": {
-      "types": "./out/street-morphology-fst-builder.d.ts",
-      "default": "./out/street-morphology-fst-builder.js"
+      "node": "./street-morphology-fst-builder.ts",
+      "default": "./out/street-morphology-fst-builder.js",
+      "types": "./out/street-morphology-fst-builder.d.ts"
     },
     "./fst-matcher": {
-      "types": "./out/fst-matcher.d.ts",
-      "default": "./out/fst-matcher.js"
+      "node": "./fst-matcher.ts",
+      "default": "./out/fst-matcher.js",
+      "types": "./out/fst-matcher.d.ts"
     },
     "./fst-serialize": {
-      "types": "./out/fst-serialize.d.ts",
-      "default": "./out/fst-serialize.js"
+      "node": "./fst-serialize.ts",
+      "default": "./out/fst-serialize.js",
+      "types": "./out/fst-serialize.d.ts"
     },
     "./fst-autocomplete": {
-      "types": "./out/fst-autocomplete.d.ts",
-      "default": "./out/fst-autocomplete.js"
+      "node": "./fst-autocomplete.ts",
+      "default": "./out/fst-autocomplete.js",
+      "types": "./out/fst-autocomplete.d.ts"
     },
     "./fst-types": {
-      "types": "./out/fst-types.d.ts",
-      "default": "./out/fst-types.js"
+      "node": "./fst-types.ts",
+      "default": "./out/fst-types.js",
+      "types": "./out/fst-types.d.ts"
     },
     "./fst-deserialize-web": {
-      "types": "./out/fst-deserialize-web.d.ts",
-      "default": "./out/fst-deserialize-web.js"
+      "node": "./fst-deserialize-web.ts",
+      "default": "./out/fst-deserialize-web.js",
+      "types": "./out/fst-deserialize-web.d.ts"
     },
     "./unified-schema": {
-      "types": "./out/unified-schema.d.ts",
-      "default": "./out/unified-schema.js"
+      "node": "./unified-schema.ts",
+      "default": "./out/unified-schema.js",
+      "types": "./out/unified-schema.d.ts"
     },
     "./ancestry-backfill": {
-      "types": "./out/ancestry-backfill.d.ts",
-      "default": "./out/ancestry-backfill.js"
+      "node": "./ancestry-backfill.ts",
+      "default": "./out/ancestry-backfill.js",
+      "types": "./out/ancestry-backfill.d.ts"
     },
     "./coincident-roles": {
-      "types": "./out/coincident-roles.d.ts",
-      "default": "./out/coincident-roles.js"
+      "node": "./coincident-roles.ts",
+      "default": "./out/coincident-roles.js",
+      "types": "./out/coincident-roles.d.ts"
     },
     "./geonames-aliases": {
-      "types": "./out/geonames-aliases.d.ts",
-      "default": "./out/geonames-aliases.js"
+      "node": "./geonames-aliases.ts",
+      "default": "./out/geonames-aliases.js",
+      "types": "./out/geonames-aliases.d.ts"
     },
     "./geonames-postal": {
-      "types": "./out/geonames-postal.d.ts",
-      "default": "./out/geonames-postal.js"
+      "node": "./geonames-postal.ts",
+      "default": "./out/geonames-postal.js",
+      "types": "./out/geonames-postal.d.ts"
     },
     "./geo": {
-      "types": "./out/geo.d.ts",
-      "default": "./out/geo.js"
+      "node": "./geo.ts",
+      "default": "./out/geo.js",
+      "types": "./out/geo.d.ts"
     },
     "./street-normalize": {
-      "types": "./out/street-normalize.d.ts",
-      "default": "./out/street-normalize.js"
+      "node": "./street-normalize.ts",
+      "default": "./out/street-normalize.js",
+      "types": "./out/street-normalize.d.ts"
     },
     "./build-candidate": {
-      "types": "./out/build-candidate.d.ts",
-      "default": "./out/build-candidate.js"
+      "node": "./build-candidate.ts",
+      "default": "./out/build-candidate.js",
+      "types": "./out/build-candidate.d.ts"
     },
     "./candidate-schema": {
-      "types": "./out/candidate-schema.d.ts",
-      "default": "./out/candidate-schema.js"
+      "node": "./candidate-schema.ts",
+      "default": "./out/candidate-schema.js",
+      "types": "./out/candidate-schema.d.ts"
     },
     "./postal-city-alias-schema": {
-      "types": "./out/postal-city-alias-schema.d.ts",
-      "default": "./out/postal-city-alias-schema.js"
+      "node": "./postal-city-alias-schema.ts",
+      "default": "./out/postal-city-alias-schema.js",
+      "types": "./out/postal-city-alias-schema.d.ts"
     },
     "./address-point-schema": {
-      "types": "./out/address-point-schema.d.ts",
-      "default": "./out/address-point-schema.js"
+      "node": "./address-point-schema.ts",
+      "default": "./out/address-point-schema.js",
+      "types": "./out/address-point-schema.d.ts"
     },
     "./street-centroid-schema": {
-      "types": "./out/street-centroid-schema.d.ts",
-      "default": "./out/street-centroid-schema.js"
+      "node": "./street-centroid-schema.ts",
+      "default": "./out/street-centroid-schema.js",
+      "types": "./out/street-centroid-schema.d.ts"
     },
     "./street-segment-schema": {
-      "types": "./out/street-segment-schema.d.ts",
-      "default": "./out/street-segment-schema.js"
+      "node": "./street-segment-schema.ts",
+      "default": "./out/street-segment-schema.js",
+      "types": "./out/street-segment-schema.d.ts"
+    },
+    "./poi-schema": {
+      "node": "./poi-schema.ts",
+      "default": "./out/poi-schema.js",
+      "types": "./out/poi-schema.d.ts"
+    },
+    "./poi-lookup": {
+      "node": "./poi-lookup.ts",
+      "default": "./out/poi-lookup.js",
+      "types": "./out/poi-lookup.d.ts"
     }
   },
   "publishConfig": {
-    "exports": {
-      "./package.json": "./package.json",
-      ".": {
-        "types": "./out/index.d.ts",
-        "default": "./out/index.js"
-      },
-      "./fts": {
-        "types": "./out/fts.d.ts",
-        "default": "./out/fts.js"
-      },
-      "./build-slim": {
-        "types": "./out/build-slim.d.ts",
-        "default": "./out/build-slim.js"
-      },
-      "./fst-builder": {
-        "types": "./out/fst-builder.d.ts",
-        "default": "./out/fst-builder.js"
-      },
-      "./street-morphology-fst-builder": {
-        "types": "./out/street-morphology-fst-builder.d.ts",
-        "default": "./out/street-morphology-fst-builder.js"
-      },
-      "./fst-matcher": {
-        "types": "./out/fst-matcher.d.ts",
-        "default": "./out/fst-matcher.js"
-      },
-      "./fst-serialize": {
-        "types": "./out/fst-serialize.d.ts",
-        "default": "./out/fst-serialize.js"
-      },
-      "./fst-autocomplete": {
-        "types": "./out/fst-autocomplete.d.ts",
-        "default": "./out/fst-autocomplete.js"
-      },
-      "./fst-types": {
-        "types": "./out/fst-types.d.ts",
-        "default": "./out/fst-types.js"
-      },
-      "./fst-deserialize-web": {
-        "types": "./out/fst-deserialize-web.d.ts",
-        "default": "./out/fst-deserialize-web.js"
-      },
-      "./unified-schema": {
-        "types": "./out/unified-schema.d.ts",
-        "default": "./out/unified-schema.js"
-      },
-      "./ancestry-backfill": {
-        "types": "./out/ancestry-backfill.d.ts",
-        "default": "./out/ancestry-backfill.js"
-      },
-      "./coincident-roles": {
-        "types": "./out/coincident-roles.d.ts",
-        "default": "./out/coincident-roles.js"
-      },
-      "./geonames-aliases": {
-        "types": "./out/geonames-aliases.d.ts",
-        "default": "./out/geonames-aliases.js"
-      },
-      "./geonames-postal": {
-        "types": "./out/geonames-postal.d.ts",
-        "default": "./out/geonames-postal.js"
-      },
-      "./geo": {
-        "types": "./out/geo.d.ts",
-        "default": "./out/geo.js"
-      },
-      "./street-normalize": {
-        "types": "./out/street-normalize.d.ts",
-        "default": "./out/street-normalize.js"
-      },
-      "./build-candidate": {
-        "types": "./out/build-candidate.d.ts",
-        "default": "./out/build-candidate.js"
-      },
-      "./candidate-schema": {
-        "types": "./out/candidate-schema.d.ts",
-        "default": "./out/candidate-schema.js"
-      },
-      "./postal-city-alias-schema": {
-        "types": "./out/postal-city-alias-schema.d.ts",
-        "default": "./out/postal-city-alias-schema.js"
-      },
-      "./address-point-schema": {
-        "types": "./out/address-point-schema.d.ts",
-        "default": "./out/address-point-schema.js"
-      },
-      "./street-centroid-schema": {
-        "types": "./out/street-centroid-schema.d.ts",
-        "default": "./out/street-centroid-schema.js"
-      },
-      "./street-segment-schema": {
-        "types": "./out/street-segment-schema.d.ts",
-        "default": "./out/street-segment-schema.js"
-      }
-    },
     "access": "public"
   },
   "dependencies": {
-    "@mailwoman/codex": "7.0.0",
-    "@mailwoman/core": "7.0.0",
-    "@mailwoman/resolver": "7.0.0",
-    "@mailwoman/spatial": "7.0.0",
+    "@mailwoman/codex": "7.2.0",
+    "@mailwoman/core": "7.2.0",
+    "@mailwoman/resolver": "7.2.0",
+    "@mailwoman/spatial": "7.2.0",
+    "h3-js": "^4.5.0",
     "kysely": "^0.29.3"
   }
 }