@mailwoman/resolver-wof-sqlite 5.9.0 → 5.10.0

package/out/street-morphology-fst-builder.d.ts

@@ -22,8 +22,8 @@
  *   Output: an `FSTMatcher` ready to serialize via `serializeFST` to e.g.
  *   `fst-street-morphology.bin`.
  */
-import { FSTMatcher } from "./fst-matcher.js";
-import type { FSTProvenance } from "./fst-types.js";
+import { FSTMatcher } from "./fst-matcher.ts";
+import type { FSTProvenance } from "./fst-types.ts";
 export interface BuildStreetMorphologyFSTOpts {
     /** Path to the `core/data/libpostal/dictionaries` directory containing per-locale subfolders. */
     dictionariesDir: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailwoman/resolver-wof-sqlite",
-  "version": "5.9.0",
+  "version": "5.10.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": {
@@ -8,12 +8,6 @@
     "url": "https://github.com/sister-software/mailwoman.git",
     "directory": "resolver-wof-sqlite"
   },
-  "bin": {
-    "mailwoman-wof-build-candidate": "./out/build-candidate-cli.js",
-    "mailwoman-wof-build-coincident-roles": "./out/build-coincident-roles-cli.js",
-    "mailwoman-wof-build-fts": "./out/build-fts-cli.js",
-    "mailwoman-wof-build-slim": "./out/build-slim-cli.js"
-  },
   "files": [
     "out/**/*.js",
     "out/**/*.js.map",
@@ -24,38 +18,202 @@
   "type": "module",
   "exports": {
     "./package.json": "./package.json",
-    ".": "./out/index.js",
-    "./fts": "./out/fts.js",
-    "./build-slim": "./out/build-slim.js",
-    "./fst-builder": "./out/fst-builder.js",
-    "./street-morphology-fst-builder": "./out/street-morphology-fst-builder.js",
-    "./fst-matcher": "./out/fst-matcher.js",
-    "./fst-serialize": "./out/fst-serialize.js",
-    "./fst-autocomplete": "./out/fst-autocomplete.js",
-    "./fst-types": "./out/fst-types.js",
-    "./fst-deserialize-web": "./out/fst-deserialize-web.js",
-    "./unified-schema": "./out/unified-schema.js",
-    "./ancestry-backfill": "./out/ancestry-backfill.js",
-    "./coincident-roles": "./out/coincident-roles.js",
-    "./geonames-aliases": "./out/geonames-aliases.js",
-    "./geonames-postal": "./out/geonames-postal.js",
-    "./geo": "./out/geo.js",
-    "./street-normalize": "./out/street-normalize.js",
-    "./build-candidate": "./out/build-candidate.js",
-    "./candidate-schema": "./out/candidate-schema.js",
-    "./postal-city-alias-schema": "./out/postal-city-alias-schema.js",
-    "./address-point-schema": "./out/address-point-schema.js",
-    "./street-centroid-schema": "./out/street-centroid-schema.js",
-    "./street-segment-schema": "./out/street-segment-schema.js"
+    ".": {
+      "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"
+    }
   },
   "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": "5.9.0",
-    "@mailwoman/core": "5.9.0",
-    "@mailwoman/resolver": "5.9.0",
-    "@mailwoman/spatial": "5.9.0",
+    "@mailwoman/codex": "5.10.0",
+    "@mailwoman/core": "5.10.0",
+    "@mailwoman/resolver": "5.10.0",
+    "@mailwoman/spatial": "5.10.0",
     "kysely": "^0.29.2"
   }
 }

package/out/build-candidate-cli.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `mailwoman-wof-build-candidate --in <admin.db> --out <candidate.db>`
- *
- *   Operator-side one-shot CLI that builds the global byte-range "candidate" lookup DB for the
- *   browser demo (the FTS-free, single-probe gazetteer). Delegates to
- *   {@linkcode buildCandidateTable}; the CLI is just argument parsing + stderr progress. The
- *   TypeScript port of the 2026-06-20 prototype — it lives in the package (not /scripts) so the
- *   name_key normalizer is the SAME shared `normalizeLocalityForKey` the query-side resolver uses.
- */
-export declare function main(rawArgv: string[]): Promise<number>;
-//# sourceMappingURL=build-candidate-cli.d.ts.map

package/out/build-candidate-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build-candidate-cli.d.ts","sourceRoot":"","sources":["../build-candidate-cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AA+DH,wBAAsB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB7D"}

package/out/build-candidate-cli.js

@@ -1,86 +0,0 @@
-#!/usr/bin/env node
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `mailwoman-wof-build-candidate --in <admin.db> --out <candidate.db>`
- *
- *   Operator-side one-shot CLI that builds the global byte-range "candidate" lookup DB for the
- *   browser demo (the FTS-free, single-probe gazetteer). Delegates to
- *   {@linkcode buildCandidateTable}; the CLI is just argument parsing + stderr progress. The
- *   TypeScript port of the 2026-06-20 prototype — it lives in the package (not /scripts) so the
- *   name_key normalizer is the SAME shared `normalizeLocalityForKey` the query-side resolver uses.
- */
-import { exit, stderr } from "node:process";
-import { cliArguments, runIfScript } from "@mailwoman/core/utils";
-import { buildCandidateTable } from "./build-candidate.js";
-function printUsageAndExit(code) {
-    stderr.write([
-        "usage: mailwoman-wof-build-candidate --in <admin.db> --out <candidate.db> [--postcodes <pc.db>]...",
-        "",
-        "Builds the global candidate lookup DB (FTS-free, single B-tree probe per resolve) from a",
-        "unified admin WOF DB (needs spr, place_population, place_search, place_abbr, ancestors).",
-        "--postcodes folds a postcode shard (spr placetype='postalcode' + coords, e.g. postalcode-us.db)",
-        "in as postalcode rows so findPlace(postalcode) resolves a ZIP. Name keys use the shared",
-        "normalizeLocalityForKey — the query side MUST match.",
-        "",
-    ].join("\n"));
-    exit(code);
-}
-function parseArgs(argv) {
-    let input;
-    let output;
-    const postcodes = [];
-    for (let i = 0; i < argv.length; i++) {
-        const a = argv[i];
-        if (a === "--in" || a === "--input") {
-            input = argv[++i];
-        }
-        else if (a === "--out" || a === "--output") {
-            output = argv[++i];
-        }
-        else if (a === "--postcodes") {
-            const v = argv[++i];
-            if (v) {
-                postcodes.push(v);
-            }
-        }
-        else if (a === "-h" || a === "--help") {
-            printUsageAndExit(0);
-        }
-        else {
-            stderr.write(`unknown argument: ${a}\n`);
-            printUsageAndExit(1);
-        }
-    }
-    if (!input || !output) {
-        printUsageAndExit(1);
-    }
-    return { input, output, postcodes };
-}
-export async function main(rawArgv) {
-    const args = parseArgs(rawArgv);
-    const t0 = Date.now();
-    const result = await buildCandidateTable({
-        input: args.input,
-        output: args.output,
-        postcodes: args.postcodes,
-        onProgress: (phase, message) => stderr.write(`  [${phase}] ${message}\n`),
-    });
-    const secs = ((Date.now() - t0) / 1000).toFixed(1);
-    stderr.write(`done in ${secs}s: ${result.rows.toLocaleString()} rows ` +
-        `(${result.primaries.toLocaleString()} primary, ${result.aliases.toLocaleString()} alias, ` +
-        `${result.abbrevs} abbr, ${result.postcodes.toLocaleString()} postcode) ` +
-        `from ${result.places.toLocaleString()} places → ${args.output}\n`);
-    return 0;
-}
-void runIfScript(import.meta, async () => {
-    main(cliArguments())
-        .then((code) => exit(code))
-        .catch((err) => {
-        stderr.write(`${err instanceof Error ? err.stack : String(err)}\n`);
-        exit(1);
-    });
-});
-//# sourceMappingURL=build-candidate-cli.js.map

package/out/build-candidate-cli.js.map

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

package/out/build-coincident-roles-cli.d.ts

@@ -1,16 +0,0 @@
-#!/usr/bin/env node
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `mailwoman-wof-build-coincident-roles <path-to-admin.db>... [--drop]`
- *
- *   Operator-side one-shot CLI (#403, epic #402): derives the `coincident_roles` relation into an
- *   existing admin gazetteer — the dual-role places (city-states, capital-seat provinces,
- *   consolidated city-counties) the hierarchy-completion step (#405) consults. Additive +
- *   idempotent; re-run after refreshing `spr`/`ancestors`. Mirrors `build-fts-cli.ts`. Should also
- *   be invoked as a post-step of the main `scripts/build-unified-wof.ts`.
- */
-export declare function main(argv: readonly string[]): number;
-//# sourceMappingURL=build-coincident-roles-cli.d.ts.map

package/out/build-coincident-roles-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build-coincident-roles-cli.d.ts","sourceRoot":"","sources":["../build-coincident-roles-cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AA6DH,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAmCpD"}

package/out/build-coincident-roles-cli.js

@@ -1,99 +0,0 @@
-#!/usr/bin/env node
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `mailwoman-wof-build-coincident-roles <path-to-admin.db>... [--drop]`
- *
- *   Operator-side one-shot CLI (#403, epic #402): derives the `coincident_roles` relation into an
- *   existing admin gazetteer — the dual-role places (city-states, capital-seat provinces,
- *   consolidated city-counties) the hierarchy-completion step (#405) consults. Additive +
- *   idempotent; re-run after refreshing `spr`/`ancestors`. Mirrors `build-fts-cli.ts`. Should also
- *   be invoked as a post-step of the main `scripts/build-unified-wof.ts`.
- */
-import { existsSync } from "node:fs";
-import { exit, stderr } from "node:process";
-import { DatabaseSync } from "node:sqlite";
-import { cliArguments, runIfScript } from "@mailwoman/core/utils";
-import { buildCoincidentRoles } from "./coincident-roles.js";
-function printUsageAndExit(code) {
-    stderr.write([
-        "usage: mailwoman-wof-build-coincident-roles <path-to-admin.db>... [--drop]",
-        "",
-        "Derives the coincident_roles relation (dual-role places — city-states, capital-seat",
-        "provinces, consolidated city-counties) into one or more admin gazetteers. The",
-        "hierarchy-completion resolver step (#405) consults it. Additive + idempotent.",
-        "",
-        "  --drop   Drop and rebuild coincident_roles if it already exists (default: rebuild).",
-        "",
-        "Example:",
-        "  mailwoman-wof-build-coincident-roles /data/wof/admin-global-priority.db",
-        "",
-    ].join("\n"));
-    exit(code);
-}
-function buildOne(path, drop) {
-    if (!existsSync(path)) {
-        stderr.write(`mailwoman-wof-build-coincident-roles: file not found: ${path}\n`);
-        return 1;
-    }
-    stderr.write(`Opening ${path}…\n`);
-    const db = new DatabaseSync(path);
-    try {
-        const result = buildCoincidentRoles(db, {
-            drop,
-            onProgress: (phase, detail) => stderr.write(`  [${phase}]${detail ? ` — ${detail}` : ""}\n`),
-        });
-        const top = Object.entries(result.byCountry)
-            .sort((a, b) => b[1] - a[1])
-            .map(([cc, n]) => `${cc} ${n}`)
-            .join(", ");
-        stderr.write(`Built: ${result.rowCount} coincident-role rows (${(result.durationMs / 1000).toFixed(2)}s)\n  by country: ${top}\n`);
-        return 0;
-    }
-    catch (err) {
-        stderr.write(`mailwoman-wof-build-coincident-roles: ${err instanceof Error ? err.message : String(err)}\n`);
-        return 1;
-    }
-    finally {
-        db.close();
-    }
-}
-export function main(argv) {
-    const paths = [];
-    // The relation is a cheap (~2 s) derived table that must reflect the current spr/ancestors, so it
-    // rebuilds by default (idempotent). `--no-drop` appends instead — only useful for incremental tests.
-    let drop = true;
-    for (const a of argv) {
-        if (a === "--drop") {
-            drop = true;
-        }
-        else if (a === "--no-drop") {
-            drop = false;
-        }
-        else if (a === "--help" || a === "-h") {
-            printUsageAndExit(0);
-        }
-        else if (a.startsWith("-")) {
-            stderr.write(`mailwoman-wof-build-coincident-roles: unknown flag ${JSON.stringify(a)}\n`);
-            printUsageAndExit(2);
-        }
-        else {
-            paths.push(a);
-        }
-    }
-    if (paths.length === 0) {
-        printUsageAndExit(2);
-    }
-    let worst = 0;
-    for (const path of paths) {
-        const rc = buildOne(path, drop);
-        if (rc > worst) {
-            worst = rc;
-        }
-    }
-    return worst;
-}
-void runIfScript(import.meta, () => exit(main(cliArguments())));
-//# sourceMappingURL=build-coincident-roles-cli.js.map

package/out/build-coincident-roles-cli.js.map

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

package/out/build-fts-cli.d.ts

@@ -1,23 +0,0 @@
-#!/usr/bin/env node
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `mailwoman-wof-build-fts <path-to-wof.db>... [--drop]`
- *
- *   Operator-side one-shot CLI: takes one or more Who's On First SQLite distributions and adds the
- *   `place_search` FTS5 + `place_bbox` R*Tree virtual tables needed by `WOFSqlitePlaceLookup`. Run
- *   this once per downloaded WOF shard so production callers can skip the (~minutes-long) lazy
- *   build.
- *
- *   Multiple positional args process each DB in sequence — useful when you've just pulled the admin +
- *   postcode shards in one go.
- *
- *   Why a plain-args CLI rather than Ink / Pastel: this is a one-shot operator script, not an
- *   interactive TUI. The dep weight of inkjs / pastel would dominate the script's footprint and
- *   doesn't match how operators expect to drive a build step (`script /path/to/db` + stderr
- *   progress). Matches the spirit of `corpus/scripts/*.ts`.
- */
-export declare function main(argv: readonly string[]): number;
-//# sourceMappingURL=build-fts-cli.d.ts.map

package/out/build-fts-cli.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build-fts-cli.d.ts","sourceRoot":"","sources":["../build-fts-cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;GAmBG;AAuGH,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAcpD"}

package/out/build-fts-cli.js

@@ -1,120 +0,0 @@
-#!/usr/bin/env node
-/**
- * @copyright Sister Software
- * @license AGPL-3.0
- * @author Teffen Ellis, et al.
- *
- *   `mailwoman-wof-build-fts <path-to-wof.db>... [--drop]`
- *
- *   Operator-side one-shot CLI: takes one or more Who's On First SQLite distributions and adds the
- *   `place_search` FTS5 + `place_bbox` R*Tree virtual tables needed by `WOFSqlitePlaceLookup`. Run
- *   this once per downloaded WOF shard so production callers can skip the (~minutes-long) lazy
- *   build.
- *
- *   Multiple positional args process each DB in sequence — useful when you've just pulled the admin +
- *   postcode shards in one go.
- *
- *   Why a plain-args CLI rather than Ink / Pastel: this is a one-shot operator script, not an
- *   interactive TUI. The dep weight of inkjs / pastel would dominate the script's footprint and
- *   doesn't match how operators expect to drive a build step (`script /path/to/db` + stderr
- *   progress). Matches the spirit of `corpus/scripts/*.ts`.
- */
-import { existsSync } from "node:fs";
-import { exit, stderr } from "node:process";
-import { DatabaseSync } from "node:sqlite";
-import { cliArguments, runIfScript } from "@mailwoman/core/utils";
-import { buildPlaceSearchFTS } from "./fts.js";
-function printUsageAndExit(code) {
-    stderr.write([
-        "usage: mailwoman-wof-build-fts <path-to-wof.db>... [--drop]",
-        "",
-        "Builds the place_search FTS5 + place_bbox R*Tree virtual tables in one or more",
-        "Who's On First SQLite distributions. Run this once per downloaded WOF shard so",
-        "production WOFSqlitePlaceLookup instances skip the lazy-build cost at first open.",
-        "",
-        "  --drop   Drop and rebuild place_search + place_bbox if they already exist.",
-        "           Apply after refreshing the spr / names tables from a newer dump.",
-        "",
-        "Examples:",
-        "  mailwoman-wof-build-fts /data/wof/admin-us.db",
-        "  mailwoman-wof-build-fts /data/wof/admin-us.db /data/wof/postalcode-us.db",
-        "  mailwoman-wof-build-fts /data/wof/admin-us.db --drop",
-        "",
-        "See https://github.com/sister-software/mailwoman/tree/main/resolver-wof-sqlite for",
-        "the recommended WOF distribution sources + attribution requirements.",
-        "",
-    ].join("\n"));
-    exit(code);
-}
-function parseArgs(argv) {
-    const args = [];
-    let drop = false;
-    for (const a of argv) {
-        if (a === "--drop") {
-            drop = true;
-        }
-        else if (a === "--help" || a === "-h") {
-            printUsageAndExit(0);
-        }
-        else if (a.startsWith("-")) {
-            stderr.write(`mailwoman-wof-build-fts: unknown flag ${JSON.stringify(a)}\n`);
-            printUsageAndExit(2);
-        }
-        else {
-            args.push(a);
-        }
-    }
-    if (args.length === 0) {
-        stderr.write(`mailwoman-wof-build-fts: expected at least one positional arg\n`);
-        printUsageAndExit(2);
-    }
-    return { databasePaths: args, drop };
-}
-/**
- * Build indexes on a single DB. Returns 0 on success, 1 on failure. Errors are written to stderr but the call doesn't
- * throw — `main()` aggregates the exit code across multi-DB invocations.
- */
-function buildOne(path, drop) {
-    if (!existsSync(path)) {
-        stderr.write(`mailwoman-wof-build-fts: file not found: ${path}\n`);
-        return 1;
-    }
-    stderr.write(`Opening ${path}…\n`);
-    const db = new DatabaseSync(path);
-    try {
-        const result = buildPlaceSearchFTS(db, {
-            drop,
-            onProgress: (phase, detail) => {
-                const suffix = detail ? ` — ${detail}` : "";
-                stderr.write(`  [${phase}]${suffix}\n`);
-            },
-        });
-        const verb = result.created ? "Built" : "Already present";
-        stderr.write(`${verb}: place_search has ${result.indexedRows.toLocaleString()} rows ` +
-            `(${(result.durationMs / 1000).toFixed(2)}s)\n`);
-        return 0;
-    }
-    catch (err) {
-        const message = err instanceof Error ? err.message : String(err);
-        stderr.write(`mailwoman-wof-build-fts: ${message}\n`);
-        return 1;
-    }
-    finally {
-        db.close();
-    }
-}
-export function main(argv) {
-    const args = parseArgs(argv);
-    // Process every DB; if any fail, the worst exit code wins (so CI / scripts see failure).
-    let worst = 0;
-    for (const path of args.databasePaths) {
-        const rc = buildOne(path, args.drop);
-        if (rc > worst) {
-            worst = rc;
-        }
-    }
-    return worst;
-}
-// Entry point — only run when invoked directly, not when imported by tests.
-void runIfScript(import.meta, () => exit(main(cliArguments())));
-//# sourceMappingURL=build-fts-cli.js.map