@mailwoman/resolver-wof-wasm 0.1.0

package/README.md

@@ -0,0 +1,60 @@
+# @mailwoman/resolver-wof-wasm
+
+Browser-side WOF resolver backed by [`@sqlite.org/sqlite-wasm`](https://www.npmjs.com/package/@sqlite.org/sqlite-wasm). Drop-in `PlaceLookup` implementation for the browser-side mailwoman demo (Phase B of the demo plan — see [sister-software/mailwoman#98](https://github.com/sister-software/mailwoman/issues/98)).
+
+Pair with [`@mailwoman/resolver-wof-sqlite`](https://www.npmjs.com/package/@mailwoman/resolver-wof-sqlite)'s `mailwoman-wof-build-slim` CLI to produce a ~35 MB slim distribution suitable for static-asset deployment, then load it from a URL at runtime.
+
+## Status
+
+**v0.1.0 — scaffold + minimal `findPlace`.** Supports text + placetype + country + limit. Full ranking surface (parentId descendant filter, proximity boost, bbox hard filter, population weighting) lands in v0.2.0 once the shared query builder is extracted from `@mailwoman/resolver-wof-sqlite`.
+
+## Quick start
+
+```ts
+import { loadSlimWofDatabase, WofWasmPlaceLookup } from "@mailwoman/resolver-wof-wasm"
+
+// Load the slim DB. Either fetch from a URL or pass raw Uint8Array bytes.
+const { db } = await loadSlimWofDatabase({
+	source: "/static/wof-hot.db", // or a Uint8Array from bundler import
+	wasmUrl: new URL("../node_modules/@sqlite.org/sqlite-wasm/sqlite-wasm/jswasm/sqlite3.wasm", import.meta.url).href,
+})
+
+const lookup = new WofWasmPlaceLookup({ db })
+
+const matches = await lookup.findPlace({
+	text: "Springfield",
+	placetype: "locality",
+	country: "US",
+	limit: 5,
+})
+
+for (const m of matches) {
+	console.log(m.id, m.name, m.lat, m.lon, "score:", m.score)
+}
+
+lookup.close()
+```
+
+## Loading strategies
+
+`loadSlimWofDatabase` currently fetches the whole DB and opens it in memory via `sqlite3_deserialize`. For the ~35 MB default slim build that's a one-RTT transfer + a one-shot in-memory open — typically sub-second on broadband, and after that every query is in-process WASM.
+
+For larger DBs or low-bandwidth users, the future path is to swap the loader for an HTTP-VFS implementation (à la `sql.js-httpvfs`) so SQLite pages get fetched lazily via byte-range. The `WofWasmPlaceLookup` class is loader-agnostic — only the loader changes.
+
+## Bundling
+
+This package ships compiled TypeScript only. The `@sqlite.org/sqlite-wasm` runtime (`.wasm` + worker JS) is a peer asset your bundler needs to serve. For Vite:
+
+```ts
+import wasmUrl from "@sqlite.org/sqlite-wasm/sqlite-wasm/jswasm/sqlite3.wasm?url"
+```
+
+For webpack: use `asset/resource` rules on the `.wasm` extension and pass the resolved URL via the `wasmUrl` option.
+
+## Why not extend `WofSqlitePlaceLookup`?
+
+`WofSqlitePlaceLookup` is hard-bound to `node:sqlite` (the Node 22+ built-in). Subclassing across the Node/WASM line means dragging Node-only types into a browser package. We chose composition over inheritance: both classes implement the same `PlaceLookup` interface and (v0.2.0+) call the same shared query builder, but stay independently importable.
+
+## License
+
+AGPL-3.0-only (mirrors the rest of the mailwoman tree).

package/out/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export { loadSlimWofDatabase, type LoadSlimOpts } from "./loader.js";
+export { WofWasmPlaceLookup, type WofWasmPlaceLookupOpts } from "./lookup.js";
+export type { FindPlaceQuery, GeoBbox, GeoPoint, PlaceCandidate, PlaceLookup, WofPlacetype, } from "@mailwoman/resolver-wof-sqlite";
+//# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAAE,KAAK,sBAAsB,EAAE,MAAM,aAAa,CAAA;AAG7E,YAAY,EACX,cAAc,EACd,OAAO,EACP,QAAQ,EACR,cAAc,EACd,WAAW,EACX,YAAY,GACZ,MAAM,gCAAgC,CAAA"}

package/out/index.js

@@ -0,0 +1,8 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export { loadSlimWofDatabase } from "./loader.js";
+export { WofWasmPlaceLookup } from "./lookup.js";
+//# sourceMappingURL=index.js.map

package/out/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAqB,MAAM,aAAa,CAAA;AACpE,OAAO,EAAE,kBAAkB,EAA+B,MAAM,aAAa,CAAA"}

package/out/loader.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Loads a slim WOF SQLite distribution into an in-memory `@sqlite.org/sqlite-wasm` database.
+ *
+ *   V1 strategy: fetch the whole file (~35 MB for the default top-1k US slim) and open it via the OO1
+ *   API's "OPFS"-flavored constructor in transient mode. The full-fetch approach is fine for a
+ *   bundle this size — the slim DB is what the browser holds in RAM for the duration of the session
+ *   anyway, and HTTP/2 + gzip make the 35 MB transfer pay one RTT + transfer time, not the
+ *   "hundreds of byte-range requests" cost a HTTP-VFS approach would incur.
+ *
+ *   When we eventually want incremental loading (Phase B.x), this is the seam to swap — keep
+ *   `WofWasmPlaceLookup` unchanged and replace the loader with a `sql.js-httpvfs`-style VFS.
+ */
+import { type Database, type Sqlite3Static } from "@sqlite.org/sqlite-wasm";
+export interface LoadSlimOpts {
+    /**
+     * Either a URL to fetch the slim .db from, or a raw Uint8Array containing the file bytes.
+     *
+     * URL form is the public-demo path (load over HTTP). Uint8Array form is what tests use to skip
+     * the network entirely and is also useful if a caller wants to embed the DB in their own bundler
+     * output (Vite's `?url` / `?arraybuffer` imports both produce things that fit here).
+     */
+    source: string | Uint8Array;
+    /**
+     * Where the sqlite-wasm runtime can find its .wasm asset. Required in browser builds because the
+     * default URL is resolved relative to the worker script, which bundlers usually rewrite.
+     *
+     * Most bundlers will let you do `new
+     * URL("../node_modules/@sqlite.org/sqlite-wasm/sqlite-wasm/jswasm/sqlite3.wasm",
+     * import.meta.url).href`.
+     *
+     * Leave unset to use the runtime's defaults (works in Node + worker contexts where the path is
+     * resolvable directly).
+     */
+    wasmUrl?: string;
+    /**
+     * Optional fetch implementation override. Defaults to `globalThis.fetch`. Useful in test
+     * harnesses that want to short-circuit network calls.
+     */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Loads + opens the slim WOF DB. Returns `{ db, sqlite3 }` — `db` is the open Database; `sqlite3`
+ * is the runtime handle (in case the caller wants to call other OO1 APIs on it).
+ *
+ * Caller is responsible for `db.close()` when done.
+ */
+export declare function loadSlimWofDatabase(opts: LoadSlimOpts): Promise<{
+    db: Database;
+    sqlite3: Sqlite3Static;
+}>;
+//# sourceMappingURL=loader.d.ts.map

package/out/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAA0B,EAAE,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAE9F,MAAM,WAAW,YAAY;IAC5B;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,GAAG,UAAU,CAAA;IAC3B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC,CAuC/G"}

package/out/loader.js

@@ -0,0 +1,62 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Loads a slim WOF SQLite distribution into an in-memory `@sqlite.org/sqlite-wasm` database.
+ *
+ *   V1 strategy: fetch the whole file (~35 MB for the default top-1k US slim) and open it via the OO1
+ *   API's "OPFS"-flavored constructor in transient mode. The full-fetch approach is fine for a
+ *   bundle this size — the slim DB is what the browser holds in RAM for the duration of the session
+ *   anyway, and HTTP/2 + gzip make the 35 MB transfer pay one RTT + transfer time, not the
+ *   "hundreds of byte-range requests" cost a HTTP-VFS approach would incur.
+ *
+ *   When we eventually want incremental loading (Phase B.x), this is the seam to swap — keep
+ *   `WofWasmPlaceLookup` unchanged and replace the loader with a `sql.js-httpvfs`-style VFS.
+ */
+import sqlite3InitModule, {} from "@sqlite.org/sqlite-wasm";
+/**
+ * Loads + opens the slim WOF DB. Returns `{ db, sqlite3 }` — `db` is the open Database; `sqlite3`
+ * is the runtime handle (in case the caller wants to call other OO1 APIs on it).
+ *
+ * Caller is responsible for `db.close()` when done.
+ */
+export async function loadSlimWofDatabase(opts) {
+    const bytes = typeof opts.source === "string" ? await fetchBytes(opts.source, opts.fetchImpl) : opts.source;
+    // sqlite3InitModule's TS signature lies about its options bag — the runtime DOES accept the
+    // Emscripten-style {print, printErr, locateFile} options shown in the upstream docs. Cast to
+    // `any` for the call site rather than shadowing the typed wrapper for the entire file.
+    const sqlite3 = await sqlite3InitModule({
+        print: () => { }, // suppress stdout from the WASM runtime
+        printErr: (msg) => console.error("[sqlite-wasm]", msg),
+        ...(opts.wasmUrl ? { locateFile: (name) => (name.endsWith(".wasm") ? opts.wasmUrl : name) } : {}),
+    });
+    // OO1 transient-DB constructor: opens an in-memory DB then we restore the file bytes into it
+    // via `sqlite3.capi.sqlite3_deserialize`. This is the official way to "open a Uint8Array as a
+    // database" — `new DB(":memory:")` followed by deserialize is faster than CREATE TABLE +
+    // INSERT-from-dump and preserves the on-disk b-tree pages directly.
+    const db = new sqlite3.oo1.DB(":memory:", "ct");
+    // `allocFromTypedArray` has shape constraints across sqlite-wasm versions; the
+    // explicit alloc + HEAPU8.set pattern is the lowest-common-denominator path and
+    // avoids the "expecting 8/16/32/64" heap-shape mismatch seen on Node builds.
+    const p = sqlite3.wasm.alloc(bytes.byteLength);
+    const heap = sqlite3.wasm.heap8u();
+    heap.set(bytes, p);
+    const rc = sqlite3.capi.sqlite3_deserialize(db.pointer, "main", p, bytes.byteLength, bytes.byteLength, sqlite3.capi.SQLITE_DESERIALIZE_FREEONCLOSE | sqlite3.capi.SQLITE_DESERIALIZE_RESIZEABLE);
+    if (rc !== sqlite3.capi.SQLITE_OK) {
+        sqlite3.wasm.dealloc(p);
+        db.close();
+        throw new Error(`sqlite3_deserialize failed: rc=${rc}`);
+    }
+    return { db, sqlite3 };
+}
+async function fetchBytes(url, fetchImpl) {
+    const f = fetchImpl ?? globalThis.fetch;
+    if (!f)
+        throw new Error("no fetch implementation available — pass fetchImpl in non-fetch environments");
+    const res = await f(url);
+    if (!res.ok)
+        throw new Error(`fetch ${url} failed: ${res.status} ${res.statusText}`);
+    return new Uint8Array(await res.arrayBuffer());
+}
+//# sourceMappingURL=loader.js.map

package/out/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,iBAAiB,EAAE,EAAqC,MAAM,yBAAyB,CAAA;AA8B9F;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAkB;IAC3D,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA;IAE3G,4FAA4F;IAC5F,6FAA6F;IAC7F,uFAAuF;IACvF,MAAM,OAAO,GAAG,MAAO,iBAA0F,CAAC;QACjH,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,wCAAwC;QACzD,QAAQ,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC;QAC9D,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1G,CAAC,CAAA;IAEF,6FAA6F;IAC7F,8FAA8F;IAC9F,yFAAyF;IACzF,oEAAoE;IACpE,MAAM,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;IAE/C,+EAA+E;IAC/E,gFAAgF;IAChF,6EAA6E;IAC7E,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAA;IAClC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;IAClB,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAC1C,EAAE,CAAC,OAAQ,EACX,MAAM,EACN,CAAC,EACD,KAAK,CAAC,UAAU,EAChB,KAAK,CAAC,UAAU,EAChB,OAAO,CAAC,IAAI,CAAC,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,6BAA6B,CACxF,CAAA;IACD,IAAI,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACnC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QACvB,EAAE,CAAC,KAAK,EAAE,CAAA;QACV,MAAM,IAAI,KAAK,CAAC,kCAAkC,EAAE,EAAE,CAAC,CAAA;IACxD,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAA;AACvB,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,SAAwB;IAC9D,MAAM,CAAC,GAAG,SAAS,IAAI,UAAU,CAAC,KAAK,CAAA;IACvC,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAA;IACvG,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAA;IACxB,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,SAAS,GAAG,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAA;IACpF,OAAO,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;AAC/C,CAAC"}

package/out/lookup.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `WofWasmPlaceLookup` — browser-side `PlaceLookup` backed by `@sqlite.org/sqlite-wasm`.
+ *
+ *   V1 scope: text + placetype + limit + country. The full ranking surface from
+ *   `WofSqlitePlaceLookup` (parentId descendant filter, near-proximity boost, bbox hard filter,
+ *   population-weighted ordering) is queued for v2 in the same PR series — see Phase B tracking
+ *   issue #98. The v1 scope is the minimum that lets the public demo answer "type a US city /
+ *   postcode, get a hit".
+ *
+ *   Internally this is a thin facade over the OO1 DB returned by `loadSlimWofDatabase`. The SQL we
+ *   issue is the same SQLite dialect the Node implementation uses — once we extract the SQL
+ *   building into a shared helper (planned: `@mailwoman/resolver-wof-sqlite/query-builder`), both
+ *   implementations will call into the same builder and the parity guarantee becomes mechanical
+ *   rather than convention-driven.
+ */
+import type { Database } from "@sqlite.org/sqlite-wasm";
+import { type CoincidentLocality } from "@mailwoman/resolver";
+import type { FindPlaceQuery, PlaceCandidate, PlaceLookup } from "@mailwoman/resolver-wof-sqlite";
+export interface WofWasmPlaceLookupOpts {
+    /** Open `@sqlite.org/sqlite-wasm` Database (from `loadSlimWofDatabase`). */
+    db: Database;
+}
+export declare class WofWasmPlaceLookup implements PlaceLookup {
+    #private;
+    constructor(opts: WofWasmPlaceLookupOpts);
+    findPlace(query: FindPlaceQuery): Promise<PlaceCandidate[]>;
+    /**
+     * Dual-role localities coincident with an admin id, from the `coincident_roles` relation (#403)
+     * carried into the slim DB by build-slim. Backs the resolver's hierarchy completion (on by
+     * default) in the browser — mirrors `WofSqlitePlaceLookup.coincidentLocalitiesFor`. Returns `[]`
+     * when the slim DB predates the relation. Loaded once + memoized (the relation is ~hundreds of
+     * rows).
+     */
+    coincidentLocalitiesFor(adminId: number | string): CoincidentLocality[];
+    close(): void;
+}
+//# sourceMappingURL=lookup.d.ts.map

package/out/lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAEvD,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAgB,MAAM,gCAAgC,CAAA;AAK/G,MAAM,WAAW,sBAAsB;IACtC,4EAA4E;IAC5E,EAAE,EAAE,QAAQ,CAAA;CACZ;AAiBD,qBAAa,kBAAmB,YAAW,WAAW;;gBAUzC,IAAI,EAAE,sBAAsB;IAqClC,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoIjE;;;;;;OAMG;IACH,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,kBAAkB,EAAE;IAgDvE,KAAK,IAAI,IAAI;CAGb"}

package/out/lookup.js

@@ -0,0 +1,255 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `WofWasmPlaceLookup` — browser-side `PlaceLookup` backed by `@sqlite.org/sqlite-wasm`.
+ *
+ *   V1 scope: text + placetype + limit + country. The full ranking surface from
+ *   `WofSqlitePlaceLookup` (parentId descendant filter, near-proximity boost, bbox hard filter,
+ *   population-weighted ordering) is queued for v2 in the same PR series — see Phase B tracking
+ *   issue #98. The v1 scope is the minimum that lets the public demo answer "type a US city /
+ *   postcode, get a hit".
+ *
+ *   Internally this is a thin facade over the OO1 DB returned by `loadSlimWofDatabase`. The SQL we
+ *   issue is the same SQLite dialect the Node implementation uses — once we extract the SQL
+ *   building into a shared helper (planned: `@mailwoman/resolver-wof-sqlite/query-builder`), both
+ *   implementations will call into the same builder and the parity guarantee becomes mechanical
+ *   rather than convention-driven.
+ */
+import { expandPlacetypeFilter } from "@mailwoman/resolver";
+// Browser-safe subpath import (fts.ts's only node:sqlite import is type-only) — the shared
+// alias-bag parser keeps this backend's exact tier byte-identical to the Node resolver's.
+import { aliasBagExactMatch } from "@mailwoman/resolver-wof-sqlite/fts";
+/**
+ * Population-boost tunables, mirroring `resolver-wof-sqlite/lookup.ts` defaults. The boost is
+ * `POPULATION_BOOST * min(1, log10(1 + pop) / POPULATION_SCALE_LOG10)`, subtracted from bm25 (lower
+ * = better, matching SQLite's convention). A 1M-population city earns the full boost — enough to
+ * surface the famous same-name place ("New York" over "West New York") without steamrolling a
+ * clearly-better text match, because exact-name tiering is consulted FIRST.
+ */
+const POPULATION_BOOST = 4.0;
+const POPULATION_SCALE_LOG10 = 6.0;
+/** Normalize a name/query for exact-match tiering: lowercase, trim, collapse internal whitespace. */
+function normalizeName(s) {
+    return s.toLowerCase().trim().replace(/\s+/g, " ");
+}
+export class WofWasmPlaceLookup {
+    #db;
+    #hasPopulationCache;
+    #hasPlaceAbbrCache;
+    /**
+     * Lazily-built `admin_id → coincident localities` map from the #403 relation (the slim DB carries
+     * it).
+     */
+    #coincidentRolesCache;
+    constructor(opts) {
+        this.#db = opts.db;
+    }
+    /** Lazily probe (once) whether the slim DB carries the `place_population` aux table. */
+    #hasPopulation() {
+        if (this.#hasPopulationCache === undefined) {
+            const r = this.#db.selectObjects(`SELECT 1 FROM sqlite_master WHERE type='table' AND name='place_population' LIMIT 1`);
+            this.#hasPopulationCache = r.length > 0;
+        }
+        return this.#hasPopulationCache;
+    }
+    /** Lazily probe (once) whether the slim DB carries the `place_abbr` aux table (build-slim ≥ #189). */
+    #hasPlaceAbbr() {
+        if (this.#hasPlaceAbbrCache === undefined) {
+            const r = this.#db.selectObjects(`SELECT 1 FROM sqlite_master WHERE type='table' AND name='place_abbr' LIMIT 1`);
+            this.#hasPlaceAbbrCache = r.length > 0;
+        }
+        return this.#hasPlaceAbbrCache;
+    }
+    /**
+     * Ids whose region abbreviation exactly equals `text` (case-insensitive), from `place_abbr`. The
+     * exact-abbrev tier signal — see the `findPlace` call site. Empty on slim DBs without the table.
+     */
+    #abbrExactIds(text) {
+        const t = text.trim();
+        if (!t || !this.#hasPlaceAbbr())
+            return new Set();
+        const rows = this.#db.selectObjects(`SELECT id FROM place_abbr WHERE abbr = ? COLLATE NOCASE`, [t]);
+        return new Set(rows.map((r) => Number(r.id)));
+    }
+    async findPlace(query) {
+        const text = (query.text ?? "").trim();
+        if (!text)
+            return [];
+        const ftsQuery = sanitizeFtsQuery(text);
+        if (!ftsQuery)
+            return [];
+        const limit = Math.max(1, query.limit ?? 10);
+        // FTS5 MATCH on place_search joined to spr. Placetype + country filters are pushed into the
+        // WHERE clause because they reduce candidate count cheaply.
+        const conditions = ["place_search MATCH ?", "spr.is_current != 0", "spr.is_deprecated = 0"];
+        const params = [ftsQuery];
+        // Shared placetype-equivalence expansion (core/resolver): a `locality` query must also reach
+        // `borough` / `localadmin` rows. Without it, Brooklyn-the-borough (pop 2.5M, an EXACT name
+        // match) was unreachable and the fuzzy "Brooklyn Park, MN" won. Same table the Node resolver
+        // uses — the two backends can't drift.
+        const placetypes = expandPlacetypeFilter(normalizePlacetypes(query.placetype));
+        if (placetypes && placetypes.length > 0) {
+            conditions.push(`spr.placetype IN (${placetypes.map(() => "?").join(",")})`);
+            params.push(...placetypes);
+        }
+        if (query.country) {
+            conditions.push("spr.country = ?");
+            params.push(query.country.toUpperCase());
+        }
+        // Point-in-bbox filter. Used to constrain a locality lookup to a parsed region/state's bounds
+        // (e.g. "Roseville, Michigan" → only the Roseville whose centroid sits in Michigan's bbox),
+        // which the broken-in-the-slim-DB parent_id chain can't do via descendant filtering.
+        if (query.bbox) {
+            conditions.push("spr.latitude BETWEEN ? AND ?", "spr.longitude BETWEEN ? AND ?");
+            params.push(query.bbox.minLat, query.bbox.maxLat, query.bbox.minLon, query.bbox.maxLon);
+        }
+        // Over-fetch a pool ordered by raw BM25, then re-rank in JS (exact-name tier, then
+        // population-weighted bm25). The over-fetch is essential: a famous place can sit a few rows
+        // below a tiny same-name town on raw BM25 ("New York" loses to "West New York" by a hair), so a
+        // tight LIMIT on bm25 alone would truncate it before the re-rank could pull it up. This mirrors
+        // the post-scoring tier + population boost in resolver-wof-sqlite/lookup.ts. (v1 issued pure
+        // bm25, which is why the demo targeted West New York for "New York, NY".)
+        const hasPop = this.#hasPopulation();
+        const pool = Math.max(limit, 50);
+        const sql = `SELECT spr.id, spr.name, spr.placetype, spr.country, spr.latitude, spr.longitude, spr.parent_id, ` +
+            `spr.min_latitude, spr.max_latitude, spr.min_longitude, spr.max_longitude, ` +
+            `place_search.alt_names AS alt_names, ` +
+            `${hasPop ? "pp.population" : "NULL"} AS population, bm25(place_search) AS bm25 ` +
+            `FROM place_search JOIN spr ON spr.id = place_search.wof_id ` +
+            `${hasPop ? "LEFT JOIN place_population pp ON pp.id = spr.id " : ""}` +
+            `WHERE ${conditions.join(" AND ")} ` +
+            `ORDER BY bm25(place_search) ASC ` +
+            `LIMIT ?`;
+        params.push(pool);
+        const rows = this.#db.selectObjects(sql, params);
+        const normQuery = normalizeName(text);
+        // Exact-abbreviation ids: region/state abbreviations live in the slim DB's `place_abbr` table
+        // (carried by build-slim before `names` is dropped). A candidate whose abbreviation equals the
+        // query is an EXACT match — same tier as an exact name match — so "VT" → Vermont outranks a
+        // foreign region that merely token-matches "VT" via a multilingual name fragment. No-op on slim
+        // DBs built before place_abbr (the table is absent → empty set). This is the data-driven
+        // replacement for the demo's hardcoded `expandUsRegion` map; it also generalizes beyond US.
+        const abbrIds = this.#abbrExactIds(text);
+        // Strict exact = canonical name or region abbreviation equals the query. Computed for the whole
+        // pool FIRST because the ALIAS tier below only engages when no strict exact exists.
+        const strictExact = (row) => normalizeName(row.name) === normQuery || abbrIds.has(row.id);
+        const anyStrictExact = rows.some(strictExact);
+        return rows
+            .map((row) => {
+            // Alias tier: `alt_names` is the FTS row's alias bag (the slim DB's only surviving alias
+            // source), aliases joined on the boundary-preserving ALIAS_SEPARATOR (#523). The shared
+            // parser does a true per-alias equality check, ungated; on a LEGACY bag (pre-#523 slim
+            // artifact, boundaries lost) it falls back to padded containment gated on "no strictly
+            // exact candidate" so interior fragments ("York" inside "New York City") can't be
+            // false-promoted. Mirrors the Node resolver's alias tier
+            // (`WofSqlitePlaceLookup.#exactMatchIds`).
+            const aliasExact = aliasBagExactMatch(row.alt_names, normQuery, anyStrictExact);
+            const exactTier = strictExact(row) || aliasExact ? 0 : 1;
+            const popBoost = row.population && row.population > 0
+                ? POPULATION_BOOST * Math.min(1, Math.log10(1 + row.population) / POPULATION_SCALE_LOG10)
+                : 0;
+            // Lower adjScore = better, matching SQLite's bm25 convention (more negative = better).
+            const adjScore = row.bm25 - popBoost;
+            return { row, exactTier, adjScore };
+        })
+            .sort((a, b) => a.exactTier - b.exactTier || a.adjScore - b.adjScore)
+            .slice(0, limit)
+            .map(({ row, adjScore, exactTier }) => ({
+            id: row.id,
+            name: row.name,
+            placetype: row.placetype,
+            country: row.country,
+            lat: row.latitude,
+            lon: row.longitude,
+            parent_id: row.parent_id ?? undefined,
+            // Surface the exact-match tier so a downstream country re-rank (#369) can keep the country
+            // pin from crossing it — parity with `WofSqlitePlaceLookup`. See ResolvedPlace.exactMatch.
+            exactMatch: exactTier === 0,
+            bbox: row.min_latitude != null && row.max_latitude != null && row.min_longitude != null && row.max_longitude != null
+                ? {
+                    minLat: row.min_latitude,
+                    maxLat: row.max_latitude,
+                    minLon: row.min_longitude,
+                    maxLon: row.max_longitude,
+                }
+                : undefined,
+            // Flip sign so higher = better (PlaceLookup contract). The adjusted, population-aware
+            // score is what we sorted by, so callers see the same ordering they're shown.
+            score: -adjScore,
+        }));
+    }
+    /**
+     * Dual-role localities coincident with an admin id, from the `coincident_roles` relation (#403)
+     * carried into the slim DB by build-slim. Backs the resolver's hierarchy completion (on by
+     * default) in the browser — mirrors `WofSqlitePlaceLookup.coincidentLocalitiesFor`. Returns `[]`
+     * when the slim DB predates the relation. Loaded once + memoized (the relation is ~hundreds of
+     * rows).
+     */
+    coincidentLocalitiesFor(adminId) {
+        const id = typeof adminId === "number" ? adminId : Number(adminId);
+        if (!Number.isFinite(id))
+            return [];
+        if (!this.#coincidentRolesCache) {
+            const map = new Map();
+            const exists = this.#db.selectObjects(`SELECT 1 FROM sqlite_master WHERE type='table' AND name='coincident_roles' LIMIT 1`);
+            if (exists.length > 0) {
+                const rows = this.#db.selectObjects(`SELECT cr.admin_id AS adminId, s.id AS id, s.name AS name, s.country AS country,
+						s.latitude AS lat, s.longitude AS lon, cr.relationship_type AS relationshipType,
+						cr.locality_population AS population, cr.distance_km AS distanceKm
+					FROM coincident_roles cr JOIN spr s ON s.id = cr.locality_id`);
+                for (const r of rows) {
+                    const candidate = {
+                        id: r.id,
+                        name: r.name,
+                        placetype: "locality",
+                        country: r.country,
+                        lat: r.lat,
+                        lon: r.lon,
+                        score: 0,
+                        relationshipType: r.relationshipType,
+                        population: r.population,
+                        distanceKm: r.distanceKm,
+                    };
+                    const list = map.get(r.adminId);
+                    if (list)
+                        list.push(candidate);
+                    else
+                        map.set(r.adminId, [candidate]);
+                }
+            }
+            this.#coincidentRolesCache = map;
+        }
+        return this.#coincidentRolesCache.get(id) ?? [];
+    }
+    close() {
+        this.#db.close();
+    }
+}
+/**
+ * Trim raw user input into something FTS5 will accept. Preserves trailing `*` as the FTS5 prefix
+ * operator (matching the resolver-wof-sqlite implementation). Strips characters FTS5 treats as
+ * punctuation or operators so a user typing `Paris's` or `St. (Petersburg)` doesn't trigger an
+ * "fts5: syntax error" inside the WASM runtime.
+ */
+function sanitizeFtsQuery(text) {
+    const out = [];
+    for (const rawToken of text.normalize("NFKC").split(/\s+/u)) {
+        const trimmed = rawToken.trim();
+        if (!trimmed)
+            continue;
+        const hasPrefixStar = trimmed.endsWith("*");
+        const body = trimmed.replace(/[^\p{L}\p{N}]/gu, "");
+        if (!body)
+            continue;
+        out.push(hasPrefixStar ? `${body}*` : `"${body.replace(/"/g, '""')}"`);
+    }
+    return out.join(" ");
+}
+function normalizePlacetypes(input) {
+    if (!input)
+        return null;
+    return Array.isArray(input) ? input : [input];
+}
+//# sourceMappingURL=lookup.js.map

package/out/lookup.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@mailwoman/resolver-wof-wasm",
+  "version": "0.1.0",
+  "description": "Who's On First WASM resolver — browser-side PlaceLookup backed by @sqlite.org/sqlite-wasm. Drop-in replacement for @mailwoman/resolver-wof-sqlite when you need a static-asset deploy (Phase B of the demo plan).",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sister-software/mailwoman.git",
+    "directory": "resolver-wof-wasm"
+  },
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./out/index.js"
+  },
+  "dependencies": {
+    "@mailwoman/core": "4.14.0",
+    "@mailwoman/resolver": "4.14.0",
+    "@mailwoman/resolver-wof-sqlite": "4.14.0",
+    "@sqlite.org/sqlite-wasm": "^3.53.0-build1"
+  },
+  "files": [
+    "out/**/*.js",
+    "out/**/*.js.map",
+    "out/**/*.d.ts",
+    "out/**/*.d.ts.map",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}