@mailwoman/resolver-wof-sqlite 11.0.0 → 11.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (542) hide show
  1. package/README.md +1 -1
  2. package/lib/address/duplicate.ts +133 -0
  3. package/lib/address/keys/attribution.ts +119 -0
  4. package/lib/address/keys/build.ts +768 -0
  5. package/lib/address/keys/layout.ts +166 -0
  6. package/lib/address/keys/local-runner.ts +18 -0
  7. package/lib/address/keys/lookup.ts +205 -0
  8. package/lib/address/keys/open.ts +33 -0
  9. package/lib/address/keys/point-lookup.ts +130 -0
  10. package/lib/address/keys/postcode.ts +27 -0
  11. package/lib/address/keys/schema.ts +264 -0
  12. package/lib/address/number-forms.ts +61 -0
  13. package/lib/address/point/interpolation.ts +28 -23
  14. package/lib/address/point/schema.ts +2 -5
  15. package/lib/address/point/spine-schema.ts +4 -4
  16. package/lib/address/point.ts +12 -79
  17. package/lib/address/record.ts +155 -0
  18. package/lib/address/stack.ts +20 -0
  19. package/lib/address/subdivision-bounds.ts +81 -0
  20. package/lib/address.ts +2 -5
  21. package/lib/ancestry/backfill.ts +5 -4
  22. package/lib/ancestry.ts +10 -10
  23. package/lib/build/candidate.ts +2 -46
  24. package/lib/build/population-corrections.ts +4 -4
  25. package/lib/build/slim.ts +3 -6
  26. package/lib/candidate/alias-bags.ts +4 -4
  27. package/lib/candidate/ancestors/schema.ts +63 -43
  28. package/lib/candidate/ancestors/sidecar.ts +3 -3
  29. package/lib/candidate/bare-admin-names.ts +3 -3
  30. package/lib/candidate/country-display-names.ts +2 -5
  31. package/lib/candidate/extract-fold.ts +2 -5
  32. package/lib/candidate/fts.ts +5 -5
  33. package/lib/candidate/importance.ts +29 -24
  34. package/lib/candidate/lookup.ts +2 -5
  35. package/lib/candidate/name-roles.ts +4 -4
  36. package/lib/candidate/own-name.ts +12 -10
  37. package/lib/candidate/place-attrs.ts +4 -4
  38. package/lib/candidate/schema.ts +2 -5
  39. package/lib/candidate/scoring.ts +3 -6
  40. package/lib/capital-schema.ts +11 -10
  41. package/lib/capitals.ts +15 -12
  42. package/lib/convention/schema.ts +7 -7
  43. package/lib/convention.ts +3 -3
  44. package/lib/coverage-manifest-schema.ts +4 -4
  45. package/lib/env.ts +7 -6
  46. package/lib/exact-match.ts +6 -7
  47. package/lib/extracts.ts +11 -9
  48. package/lib/fst/autocomplete.ts +19 -15
  49. package/lib/fst/binary-matcher.ts +10 -9
  50. package/lib/fst/builder.ts +32 -11
  51. package/lib/fst/deserialize-web.ts +9 -8
  52. package/lib/fst/format.ts +9 -7
  53. package/lib/fst/freshness.ts +3 -4
  54. package/lib/fst/matcher.ts +6 -6
  55. package/lib/fst/serialize.ts +5 -9
  56. package/lib/fst/types.ts +4 -4
  57. package/lib/fst.ts +2 -5
  58. package/lib/fts/query.ts +3 -4
  59. package/lib/fts.ts +2 -5
  60. package/lib/geonames/aliases.ts +193 -43
  61. package/lib/geonames/postal.ts +17 -15
  62. package/lib/geonames.ts +2 -5
  63. package/lib/index.ts +4 -5
  64. package/lib/interpolation.ts +7 -6
  65. package/lib/landmark/rows.ts +5 -5
  66. package/lib/landmark.ts +6 -6
  67. package/lib/lookup.ts +8 -8
  68. package/lib/name-score.ts +7 -6
  69. package/lib/nsul/lookup.ts +19 -15
  70. package/lib/nsul/schema.ts +4 -5
  71. package/lib/nsul.ts +2 -5
  72. package/lib/paths.ts +7 -7
  73. package/lib/place-importance-schema.ts +5 -8
  74. package/lib/poi/lookup.ts +11 -10
  75. package/lib/poi/schema.ts +16 -10
  76. package/lib/poi.ts +2 -5
  77. package/lib/polygon-schema.ts +10 -9
  78. package/lib/postal/city/alias/lookup.ts +14 -13
  79. package/lib/postal/city/alias/schema.ts +12 -12
  80. package/lib/postal/city/candidate-schema.ts +15 -12
  81. package/lib/postal.ts +2 -5
  82. package/lib/postcode-point-lookup.ts +2 -5
  83. package/lib/primary-preference.ts +2 -5
  84. package/lib/proximity-rerank.ts +23 -19
  85. package/lib/ranking-weights.ts +8 -7
  86. package/lib/region-keys.ts +15 -14
  87. package/lib/reverse.ts +16 -17
  88. package/lib/schema.ts +20 -6
  89. package/lib/search-fetch.ts +15 -11
  90. package/lib/sqlite/convention-source.ts +2 -5
  91. package/lib/sqlite/utils.ts +4 -4
  92. package/lib/street/centroid/schema.ts +6 -6
  93. package/lib/street/centroid.ts +3 -3
  94. package/lib/street/locale.ts +64 -0
  95. package/lib/street/morphology/fst/builder.ts +21 -19
  96. package/lib/street/morphology/fst/loader.ts +15 -13
  97. package/lib/street/name-lookup.ts +15 -14
  98. package/lib/street/normalize.ts +20 -17
  99. package/lib/street/segment-schema.ts +16 -14
  100. package/lib/street/table.ts +276 -0
  101. package/lib/street.ts +3 -5
  102. package/lib/types.ts +3 -6
  103. package/lib/unified-schema.ts +31 -9
  104. package/lib/uprn/existence.ts +10 -10
  105. package/lib/uprn/lookup.ts +7 -8
  106. package/lib/uprn/schema.ts +5 -5
  107. package/lib/uprn.ts +2 -5
  108. package/lib/weights-overlay-linker.ts +5 -8
  109. package/out/address/duplicate.d.ts +74 -0
  110. package/out/address/duplicate.d.ts.map +1 -0
  111. package/out/address/duplicate.js +79 -0
  112. package/out/address/duplicate.js.map +1 -0
  113. package/out/address/keys/attribution.d.ts +56 -0
  114. package/out/address/keys/attribution.d.ts.map +1 -0
  115. package/out/address/keys/attribution.js +64 -0
  116. package/out/address/keys/attribution.js.map +1 -0
  117. package/out/address/keys/build.d.ts +154 -0
  118. package/out/address/keys/build.d.ts.map +1 -0
  119. package/out/address/keys/build.js +423 -0
  120. package/out/address/keys/build.js.map +1 -0
  121. package/out/address/keys/layout.d.ts +92 -0
  122. package/out/address/keys/layout.d.ts.map +1 -0
  123. package/out/address/keys/layout.js +87 -0
  124. package/out/address/keys/layout.js.map +1 -0
  125. package/out/address/keys/local-runner.d.ts +9 -0
  126. package/out/address/keys/local-runner.d.ts.map +1 -0
  127. package/out/address/keys/local-runner.js +13 -0
  128. package/out/address/keys/local-runner.js.map +1 -0
  129. package/out/address/keys/lookup.d.ts +80 -0
  130. package/out/address/keys/lookup.d.ts.map +1 -0
  131. package/out/address/keys/lookup.js +104 -0
  132. package/out/address/keys/lookup.js.map +1 -0
  133. package/out/address/keys/open.d.ts +10 -0
  134. package/out/address/keys/open.d.ts.map +1 -0
  135. package/out/address/keys/open.js +28 -0
  136. package/out/address/keys/open.js.map +1 -0
  137. package/out/address/keys/point-lookup.d.ts +25 -0
  138. package/out/address/keys/point-lookup.d.ts.map +1 -0
  139. package/out/address/keys/point-lookup.js +100 -0
  140. package/out/address/keys/point-lookup.js.map +1 -0
  141. package/out/address/keys/postcode.d.ts +9 -0
  142. package/out/address/keys/postcode.d.ts.map +1 -0
  143. package/out/address/keys/postcode.js +25 -0
  144. package/out/address/keys/postcode.js.map +1 -0
  145. package/out/address/keys/schema.d.ts +156 -0
  146. package/out/address/keys/schema.d.ts.map +1 -0
  147. package/out/address/keys/schema.js +119 -0
  148. package/out/address/keys/schema.js.map +1 -0
  149. package/out/address/number-forms.d.ts +19 -0
  150. package/out/address/number-forms.d.ts.map +1 -0
  151. package/out/address/number-forms.js +50 -0
  152. package/out/address/number-forms.js.map +1 -0
  153. package/out/address/point/interpolation.d.ts +24 -22
  154. package/out/address/point/interpolation.d.ts.map +1 -1
  155. package/out/address/point/interpolation.js +3 -31
  156. package/out/address/point/interpolation.js.map +1 -1
  157. package/out/address/point/schema.d.ts +0 -5
  158. package/out/address/point/schema.d.ts.map +1 -1
  159. package/out/address/point/schema.js +2 -5
  160. package/out/address/point/schema.js.map +1 -1
  161. package/out/address/point/spine-schema.d.ts +1 -4
  162. package/out/address/point/spine-schema.d.ts.map +1 -1
  163. package/out/address/point/spine-schema.js +3 -4
  164. package/out/address/point/spine-schema.js.map +1 -1
  165. package/out/address/point.d.ts +0 -3
  166. package/out/address/point.d.ts.map +1 -1
  167. package/out/address/point.js +12 -71
  168. package/out/address/point.js.map +1 -1
  169. package/out/address/record.d.ts +125 -0
  170. package/out/address/record.d.ts.map +1 -0
  171. package/out/address/record.js +49 -0
  172. package/out/address/record.js.map +1 -0
  173. package/out/address/stack.d.ts +14 -0
  174. package/out/address/stack.d.ts.map +1 -0
  175. package/out/address/stack.js +19 -0
  176. package/out/address/stack.js.map +1 -0
  177. package/out/address/subdivision-bounds.d.ts +32 -0
  178. package/out/address/subdivision-bounds.d.ts.map +1 -0
  179. package/out/address/subdivision-bounds.js +48 -0
  180. package/out/address/subdivision-bounds.js.map +1 -0
  181. package/out/address.d.ts +0 -5
  182. package/out/address.d.ts.map +1 -1
  183. package/out/address.js +2 -5
  184. package/out/address.js.map +1 -1
  185. package/out/ancestry/backfill.d.ts +0 -7
  186. package/out/ancestry/backfill.d.ts.map +1 -1
  187. package/out/ancestry/backfill.js +4 -4
  188. package/out/ancestry/backfill.js.map +1 -1
  189. package/out/ancestry.d.ts +0 -14
  190. package/out/ancestry.d.ts.map +1 -1
  191. package/out/ancestry.js +9 -10
  192. package/out/ancestry.js.map +1 -1
  193. package/out/build/candidate.d.ts +0 -22
  194. package/out/build/candidate.d.ts.map +1 -1
  195. package/out/build/candidate.js +2 -26
  196. package/out/build/candidate.js.map +1 -1
  197. package/out/build/population-corrections.d.ts +1 -4
  198. package/out/build/population-corrections.d.ts.map +1 -1
  199. package/out/build/population-corrections.js +2 -19
  200. package/out/build/population-corrections.js.map +1 -1
  201. package/out/build/slim.d.ts +0 -5
  202. package/out/build/slim.d.ts.map +1 -1
  203. package/out/build/slim.js +3 -6
  204. package/out/build/slim.js.map +1 -1
  205. package/out/candidate/alias-bags.d.ts +1 -4
  206. package/out/candidate/alias-bags.d.ts.map +1 -1
  207. package/out/candidate/alias-bags.js +3 -7
  208. package/out/candidate/alias-bags.js.map +1 -1
  209. package/out/candidate/ancestors/schema.d.ts +60 -43
  210. package/out/candidate/ancestors/schema.d.ts.map +1 -1
  211. package/out/candidate/ancestors/schema.js +62 -43
  212. package/out/candidate/ancestors/schema.js.map +1 -1
  213. package/out/candidate/ancestors/sidecar.d.ts +0 -3
  214. package/out/candidate/ancestors/sidecar.d.ts.map +1 -1
  215. package/out/candidate/ancestors/sidecar.js +2 -6
  216. package/out/candidate/ancestors/sidecar.js.map +1 -1
  217. package/out/candidate/bare-admin-names.d.ts +0 -6
  218. package/out/candidate/bare-admin-names.d.ts.map +1 -1
  219. package/out/candidate/bare-admin-names.js +2 -3
  220. package/out/candidate/bare-admin-names.js.map +1 -1
  221. package/out/candidate/country-display-names.d.ts +0 -5
  222. package/out/candidate/country-display-names.d.ts.map +1 -1
  223. package/out/candidate/country-display-names.js +2 -5
  224. package/out/candidate/country-display-names.js.map +1 -1
  225. package/out/candidate/extract-fold.d.ts +0 -5
  226. package/out/candidate/extract-fold.d.ts.map +1 -1
  227. package/out/candidate/extract-fold.js +2 -5
  228. package/out/candidate/extract-fold.js.map +1 -1
  229. package/out/candidate/fts.d.ts +2 -5
  230. package/out/candidate/fts.d.ts.map +1 -1
  231. package/out/candidate/fts.js +2 -7
  232. package/out/candidate/fts.js.map +1 -1
  233. package/out/candidate/importance.d.ts +3 -33
  234. package/out/candidate/importance.d.ts.map +1 -1
  235. package/out/candidate/importance.js +28 -24
  236. package/out/candidate/importance.js.map +1 -1
  237. package/out/candidate/lookup.d.ts +0 -5
  238. package/out/candidate/lookup.d.ts.map +1 -1
  239. package/out/candidate/lookup.js +2 -5
  240. package/out/candidate/lookup.js.map +1 -1
  241. package/out/candidate/name-roles.d.ts +0 -6
  242. package/out/candidate/name-roles.d.ts.map +1 -1
  243. package/out/candidate/name-roles.js +3 -4
  244. package/out/candidate/name-roles.js.map +1 -1
  245. package/out/candidate/own-name.d.ts +0 -18
  246. package/out/candidate/own-name.d.ts.map +1 -1
  247. package/out/candidate/own-name.js +11 -10
  248. package/out/candidate/own-name.js.map +1 -1
  249. package/out/candidate/place-attrs.d.ts +1 -4
  250. package/out/candidate/place-attrs.d.ts.map +1 -1
  251. package/out/candidate/place-attrs.js +2 -12
  252. package/out/candidate/place-attrs.js.map +1 -1
  253. package/out/candidate/schema.d.ts +0 -5
  254. package/out/candidate/schema.d.ts.map +1 -1
  255. package/out/candidate/schema.js +2 -5
  256. package/out/candidate/schema.js.map +1 -1
  257. package/out/candidate/scoring.d.ts +0 -5
  258. package/out/candidate/scoring.d.ts.map +1 -1
  259. package/out/candidate/scoring.js +3 -6
  260. package/out/candidate/scoring.js.map +1 -1
  261. package/out/capital-schema.d.ts +0 -14
  262. package/out/capital-schema.d.ts.map +1 -1
  263. package/out/capital-schema.js +10 -10
  264. package/out/capital-schema.js.map +1 -1
  265. package/out/capitals.d.ts +0 -16
  266. package/out/capitals.d.ts.map +1 -1
  267. package/out/capitals.js +14 -12
  268. package/out/capitals.js.map +1 -1
  269. package/out/convention/schema.d.ts +4 -7
  270. package/out/convention/schema.d.ts.map +1 -1
  271. package/out/convention/schema.js +2 -10
  272. package/out/convention/schema.js.map +1 -1
  273. package/out/convention.d.ts +0 -3
  274. package/out/convention.d.ts.map +1 -1
  275. package/out/convention.js +2 -8
  276. package/out/convention.js.map +1 -1
  277. package/out/coverage-manifest-schema.d.ts +1 -4
  278. package/out/coverage-manifest-schema.d.ts.map +1 -1
  279. package/out/coverage-manifest-schema.js +2 -3
  280. package/out/coverage-manifest-schema.js.map +1 -1
  281. package/out/env.d.ts +0 -8
  282. package/out/env.d.ts.map +1 -1
  283. package/out/env.js +6 -6
  284. package/out/env.js.map +1 -1
  285. package/out/exact-match.d.ts +2 -6
  286. package/out/exact-match.d.ts.map +1 -1
  287. package/out/exact-match.js +3 -9
  288. package/out/exact-match.js.map +1 -1
  289. package/out/extracts.d.ts +8 -9
  290. package/out/extracts.d.ts.map +1 -1
  291. package/out/extracts.js +9 -8
  292. package/out/extracts.js.map +1 -1
  293. package/out/fst/autocomplete.d.ts +1 -19
  294. package/out/fst/autocomplete.d.ts.map +1 -1
  295. package/out/fst/autocomplete.js +2 -18
  296. package/out/fst/autocomplete.js.map +1 -1
  297. package/out/fst/binary-matcher.d.ts +6 -8
  298. package/out/fst/binary-matcher.d.ts.map +1 -1
  299. package/out/fst/binary-matcher.js +3 -13
  300. package/out/fst/binary-matcher.js.map +1 -1
  301. package/out/fst/builder.d.ts +0 -12
  302. package/out/fst/builder.d.ts.map +1 -1
  303. package/out/fst/builder.js +23 -11
  304. package/out/fst/builder.js.map +1 -1
  305. package/out/fst/deserialize-web.d.ts +1 -12
  306. package/out/fst/deserialize-web.d.ts.map +1 -1
  307. package/out/fst/deserialize-web.js +8 -8
  308. package/out/fst/deserialize-web.js.map +1 -1
  309. package/out/fst/format.d.ts +6 -7
  310. package/out/fst/format.d.ts.map +1 -1
  311. package/out/fst/format.js +3 -10
  312. package/out/fst/format.js.map +1 -1
  313. package/out/fst/freshness.d.ts +0 -7
  314. package/out/fst/freshness.d.ts.map +1 -1
  315. package/out/fst/freshness.js +2 -4
  316. package/out/fst/freshness.js.map +1 -1
  317. package/out/fst/matcher.d.ts +3 -6
  318. package/out/fst/matcher.d.ts.map +1 -1
  319. package/out/fst/matcher.js +2 -9
  320. package/out/fst/matcher.js.map +1 -1
  321. package/out/fst/serialize.d.ts +0 -23
  322. package/out/fst/serialize.d.ts.map +1 -1
  323. package/out/fst/serialize.js +4 -8
  324. package/out/fst/serialize.js.map +1 -1
  325. package/out/fst/types.d.ts +1 -4
  326. package/out/fst/types.d.ts.map +1 -1
  327. package/out/fst/types.js +2 -6
  328. package/out/fst/types.js.map +1 -1
  329. package/out/fst.d.ts +0 -5
  330. package/out/fst.d.ts.map +1 -1
  331. package/out/fst.js +2 -5
  332. package/out/fst.js.map +1 -1
  333. package/out/fts/query.d.ts +0 -4
  334. package/out/fts/query.d.ts.map +1 -1
  335. package/out/fts/query.js +2 -7
  336. package/out/fts/query.js.map +1 -1
  337. package/out/fts.d.ts +0 -5
  338. package/out/fts.d.ts.map +1 -1
  339. package/out/fts.js +2 -5
  340. package/out/fts.js.map +1 -1
  341. package/out/geonames/aliases.d.ts +43 -5
  342. package/out/geonames/aliases.d.ts.map +1 -1
  343. package/out/geonames/aliases.js +109 -41
  344. package/out/geonames/aliases.js.map +1 -1
  345. package/out/geonames/postal.d.ts +1 -25
  346. package/out/geonames/postal.d.ts.map +1 -1
  347. package/out/geonames/postal.js +15 -14
  348. package/out/geonames/postal.js.map +1 -1
  349. package/out/geonames.d.ts +0 -5
  350. package/out/geonames.d.ts.map +1 -1
  351. package/out/geonames.js +2 -5
  352. package/out/geonames.js.map +1 -1
  353. package/out/index.d.ts +2 -5
  354. package/out/index.d.ts.map +1 -1
  355. package/out/index.js +4 -5
  356. package/out/index.js.map +1 -1
  357. package/out/interpolation.d.ts +0 -7
  358. package/out/interpolation.d.ts.map +1 -1
  359. package/out/interpolation.js +6 -6
  360. package/out/interpolation.js.map +1 -1
  361. package/out/landmark/rows.d.ts +2 -5
  362. package/out/landmark/rows.d.ts.map +1 -1
  363. package/out/landmark/rows.js +2 -8
  364. package/out/landmark/rows.js.map +1 -1
  365. package/out/landmark.d.ts +3 -6
  366. package/out/landmark.d.ts.map +1 -1
  367. package/out/landmark.js +2 -8
  368. package/out/landmark.js.map +1 -1
  369. package/out/lookup.d.ts +0 -7
  370. package/out/lookup.d.ts.map +1 -1
  371. package/out/lookup.js +7 -8
  372. package/out/lookup.js.map +1 -1
  373. package/out/name-score.d.ts +4 -6
  374. package/out/name-score.d.ts.map +1 -1
  375. package/out/name-score.js +6 -6
  376. package/out/name-score.js.map +1 -1
  377. package/out/nsul/lookup.d.ts +16 -15
  378. package/out/nsul/lookup.d.ts.map +1 -1
  379. package/out/nsul/lookup.js +2 -25
  380. package/out/nsul/lookup.js.map +1 -1
  381. package/out/nsul/schema.d.ts +1 -5
  382. package/out/nsul/schema.d.ts.map +1 -1
  383. package/out/nsul/schema.js +3 -8
  384. package/out/nsul/schema.js.map +1 -1
  385. package/out/nsul.d.ts +0 -5
  386. package/out/nsul.d.ts.map +1 -1
  387. package/out/nsul.js +2 -5
  388. package/out/nsul.js.map +1 -1
  389. package/out/paths.d.ts +1 -13
  390. package/out/paths.d.ts.map +1 -1
  391. package/out/paths.js +6 -7
  392. package/out/paths.js.map +1 -1
  393. package/out/place-importance-schema.d.ts +3 -8
  394. package/out/place-importance-schema.d.ts.map +1 -1
  395. package/out/place-importance-schema.js +3 -6
  396. package/out/place-importance-schema.js.map +1 -1
  397. package/out/poi/lookup.d.ts +0 -13
  398. package/out/poi/lookup.d.ts.map +1 -1
  399. package/out/poi/lookup.js +10 -10
  400. package/out/poi/lookup.js.map +1 -1
  401. package/out/poi/schema.d.ts +13 -10
  402. package/out/poi/schema.d.ts.map +1 -1
  403. package/out/poi/schema.js +2 -13
  404. package/out/poi/schema.js.map +1 -1
  405. package/out/poi.d.ts +0 -5
  406. package/out/poi.d.ts.map +1 -1
  407. package/out/poi.js +2 -5
  408. package/out/poi.js.map +1 -1
  409. package/out/polygon-schema.d.ts +7 -9
  410. package/out/polygon-schema.d.ts.map +1 -1
  411. package/out/polygon-schema.js +2 -12
  412. package/out/polygon-schema.js.map +1 -1
  413. package/out/postal/city/alias/lookup.d.ts +11 -13
  414. package/out/postal/city/alias/lookup.d.ts.map +1 -1
  415. package/out/postal/city/alias/lookup.js +13 -13
  416. package/out/postal/city/alias/lookup.js.map +1 -1
  417. package/out/postal/city/alias/schema.d.ts +9 -12
  418. package/out/postal/city/alias/schema.d.ts.map +1 -1
  419. package/out/postal/city/alias/schema.js +2 -17
  420. package/out/postal/city/alias/schema.js.map +1 -1
  421. package/out/postal/city/candidate-schema.d.ts +12 -12
  422. package/out/postal/city/candidate-schema.d.ts.map +1 -1
  423. package/out/postal/city/candidate-schema.js +14 -12
  424. package/out/postal/city/candidate-schema.js.map +1 -1
  425. package/out/postal.d.ts +0 -5
  426. package/out/postal.d.ts.map +1 -1
  427. package/out/postal.js +2 -5
  428. package/out/postal.js.map +1 -1
  429. package/out/postcode-point-lookup.d.ts +0 -5
  430. package/out/postcode-point-lookup.d.ts.map +1 -1
  431. package/out/postcode-point-lookup.js +2 -5
  432. package/out/postcode-point-lookup.js.map +1 -1
  433. package/out/primary-preference.d.ts +0 -5
  434. package/out/primary-preference.d.ts.map +1 -1
  435. package/out/primary-preference.js +2 -5
  436. package/out/primary-preference.js.map +1 -1
  437. package/out/proximity-rerank.d.ts +2 -26
  438. package/out/proximity-rerank.d.ts.map +1 -1
  439. package/out/proximity-rerank.js +22 -19
  440. package/out/proximity-rerank.js.map +1 -1
  441. package/out/ranking-weights.d.ts +5 -7
  442. package/out/ranking-weights.d.ts.map +1 -1
  443. package/out/ranking-weights.js +2 -9
  444. package/out/ranking-weights.js.map +1 -1
  445. package/out/region-keys.d.ts +0 -15
  446. package/out/region-keys.d.ts.map +1 -1
  447. package/out/region-keys.js +14 -14
  448. package/out/region-keys.js.map +1 -1
  449. package/out/reverse.d.ts +1 -24
  450. package/out/reverse.d.ts.map +1 -1
  451. package/out/reverse.js +14 -16
  452. package/out/reverse.js.map +1 -1
  453. package/out/schema.d.ts +17 -6
  454. package/out/schema.d.ts.map +1 -1
  455. package/out/schema.js +2 -15
  456. package/out/schema.js.map +1 -1
  457. package/out/search-fetch.d.ts +0 -13
  458. package/out/search-fetch.d.ts.map +1 -1
  459. package/out/search-fetch.js +14 -11
  460. package/out/search-fetch.js.map +1 -1
  461. package/out/sqlite/convention-source.d.ts +0 -5
  462. package/out/sqlite/convention-source.d.ts.map +1 -1
  463. package/out/sqlite/convention-source.js +2 -5
  464. package/out/sqlite/convention-source.js.map +1 -1
  465. package/out/sqlite/utils.d.ts +1 -7
  466. package/out/sqlite/utils.d.ts.map +1 -1
  467. package/out/sqlite/utils.js +3 -4
  468. package/out/sqlite/utils.js.map +1 -1
  469. package/out/street/centroid/schema.d.ts +3 -6
  470. package/out/street/centroid/schema.d.ts.map +1 -1
  471. package/out/street/centroid/schema.js +2 -7
  472. package/out/street/centroid/schema.js.map +1 -1
  473. package/out/street/centroid.d.ts +0 -3
  474. package/out/street/centroid.d.ts.map +1 -1
  475. package/out/street/centroid.js +2 -6
  476. package/out/street/centroid.js.map +1 -1
  477. package/out/street/locale.d.ts +12 -0
  478. package/out/street/locale.d.ts.map +1 -0
  479. package/out/street/locale.js +54 -0
  480. package/out/street/locale.js.map +1 -0
  481. package/out/street/morphology/fst/builder.d.ts +1 -26
  482. package/out/street/morphology/fst/builder.d.ts.map +1 -1
  483. package/out/street/morphology/fst/builder.js +19 -18
  484. package/out/street/morphology/fst/builder.js.map +1 -1
  485. package/out/street/morphology/fst/loader.d.ts +0 -20
  486. package/out/street/morphology/fst/loader.d.ts.map +1 -1
  487. package/out/street/morphology/fst/loader.js +14 -13
  488. package/out/street/morphology/fst/loader.js.map +1 -1
  489. package/out/street/name-lookup.d.ts +11 -13
  490. package/out/street/name-lookup.d.ts.map +1 -1
  491. package/out/street/name-lookup.js +14 -14
  492. package/out/street/name-lookup.js.map +1 -1
  493. package/out/street/normalize.d.ts +10 -12
  494. package/out/street/normalize.d.ts.map +1 -1
  495. package/out/street/normalize.js +15 -13
  496. package/out/street/normalize.js.map +1 -1
  497. package/out/street/segment-schema.d.ts +11 -12
  498. package/out/street/segment-schema.d.ts.map +1 -1
  499. package/out/street/segment-schema.js +13 -12
  500. package/out/street/segment-schema.js.map +1 -1
  501. package/out/street/table.d.ts +154 -0
  502. package/out/street/table.d.ts.map +1 -0
  503. package/out/street/table.js +122 -0
  504. package/out/street/table.js.map +1 -0
  505. package/out/street.d.ts +1 -5
  506. package/out/street.d.ts.map +1 -1
  507. package/out/street.js +3 -5
  508. package/out/street.js.map +1 -1
  509. package/out/types.d.ts +1 -6
  510. package/out/types.d.ts.map +1 -1
  511. package/out/types.js +2 -5
  512. package/out/types.js.map +1 -1
  513. package/out/unified-schema.d.ts +18 -7
  514. package/out/unified-schema.d.ts.map +1 -1
  515. package/out/unified-schema.js +14 -10
  516. package/out/unified-schema.js.map +1 -1
  517. package/out/uprn/existence.d.ts +7 -10
  518. package/out/uprn/existence.d.ts.map +1 -1
  519. package/out/uprn/existence.js +9 -10
  520. package/out/uprn/existence.js.map +1 -1
  521. package/out/uprn/lookup.d.ts +1 -8
  522. package/out/uprn/lookup.d.ts.map +1 -1
  523. package/out/uprn/lookup.js +6 -8
  524. package/out/uprn/lookup.js.map +1 -1
  525. package/out/uprn/schema.d.ts +2 -5
  526. package/out/uprn/schema.d.ts.map +1 -1
  527. package/out/uprn/schema.js +2 -7
  528. package/out/uprn/schema.js.map +1 -1
  529. package/out/uprn.d.ts +0 -5
  530. package/out/uprn.d.ts.map +1 -1
  531. package/out/uprn.js +2 -5
  532. package/out/uprn.js.map +1 -1
  533. package/out/weights-overlay-linker.d.ts +3 -8
  534. package/out/weights-overlay-linker.d.ts.map +1 -1
  535. package/out/weights-overlay-linker.js +5 -8
  536. package/out/weights-overlay-linker.js.map +1 -1
  537. package/package.json +12 -12
  538. package/lib/currency-backfill.ts +0 -289
  539. package/out/currency-backfill.d.ts +0 -68
  540. package/out/currency-backfill.d.ts.map +0 -1
  541. package/out/currency-backfill.js +0 -169
  542. package/out/currency-backfill.js.map +0 -1
@@ -1,8 +1,7 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- *
6
5
  * Does an `fst-*.bin` still match the gazetteer it was built from?
7
6
  */
8
7
 
@@ -1,11 +1,11 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
+ * In-memory FST matcher.
5
6
  *
6
- * In-memory FST matcher. Built by `fst-builder.ts`, queried at runtime for emission priors and CLI
7
- * introspection. The structure is a deterministic trie over normalized tokens with PlaceEntry
8
- * arrays at accepting states.
7
+ * Built by `fst-builder.ts`, queried at runtime for emission priors and CLI introspection.
8
+ * The structure is a deterministic trie over normalized tokens with PlaceEntry arrays at accepting states.
9
9
  */
10
10
 
11
11
  import type { AncestrieMatch } from "@mailwoman/ancestrie"
@@ -1,7 +1,7 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
5
  * @file Binary serialization for the FST gazetteer.
6
6
  *
7
7
  * All integers are little-endian. The writer emits the current version. The reader accepts every earlier version.
@@ -53,11 +53,7 @@ const MAGIC = Buffer.from(FST_MAGIC_BYTES)
53
53
  */
54
54
  const MAX_CHAIN_LEN = 8
55
55
 
56
- const placetypeToIdx = new Map<string, number>()
57
-
58
- for (let i = 0; i < PLACETYPE_ORDER.length; i++) {
59
- placetypeToIdx.set(PLACETYPE_ORDER[i]!, i)
60
- }
56
+ const placetypeToIdx = new Map<string, number>(PLACETYPE_ORDER.map((placetype, index) => [placetype, index]))
61
57
 
62
58
  /**
63
59
  * Serializes a matcher, with optional provenance, into the current FST binary format.
@@ -303,7 +299,7 @@ export function deserializeFST(buf: Buffer): FSTMatcher {
303
299
  ? buf.readFloatLE(pp + 12)
304
300
  : Math.min(1, Math.log2(1 + buf.readUInt32LE(pp + 12) / 1000) / 14)
305
301
 
306
- // Files before version 5 have no encyclopedic score, so their reserved byte is not read as a flag.
302
+ // Files before version 5 have no encyclopedic score, so their reserved byte isn't read as a flag.
307
303
  const hasEncyclopedic =
308
304
  isSplit && (buf.readUInt8(pp + 7) & PLACE_FLAG_HAS_ENCYCLOPEDIC) === PLACE_FLAG_HAS_ENCYCLOPEDIC
309
305
 
package/lib/fst/types.ts CHANGED
@@ -1,7 +1,7 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
5
  * @file Types for the FST gazetteer. These types map place-name token sequences to place entries.
6
6
  */
7
7
 
@@ -150,7 +150,7 @@ export interface BuildFSTOpts {
150
150
  */
151
151
  excludeSurfaces?: ReadonlySet<string>
152
152
  /**
153
- * Tokens that a name must not consist of entirely, such as "de la".
153
+ * Tokens that a name mustn't consist of entirely, such as "de la".
154
154
  *
155
155
  * Build this set from stopwords only.
156
156
  * A street-type word can be part of a real name, as in "Avenue Road".
package/lib/fst.ts CHANGED
@@ -1,8 +1,5 @@
1
- /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- */
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
6
3
 
7
4
  export * from "#fst/autocomplete"
8
5
  export * from "#fst/binary-matcher"
package/lib/fts/query.ts CHANGED
@@ -1,8 +1,7 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- *
6
5
  * Query shaping for the FTS5 lookup: placetype normalization and the match-expression sanitizer.
7
6
  */
8
7
 
package/lib/fts.ts CHANGED
@@ -1,8 +1,5 @@
1
- /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- */
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
6
3
 
7
4
  import type { DatabaseClient } from "@mailwoman/sqlite/client"
8
5
  import { tableExists } from "@mailwoman/sqlite/introspection"
@@ -1,14 +1,11 @@
1
- /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- */
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
6
3
 
7
4
  import { isOfficialLanguage } from "@mailwoman/codex/country"
8
5
  import { readUnquotedTSV } from "@mailwoman/core/fs/delimited"
9
6
  import { pathExists } from "@mailwoman/core/fs/readers/stat"
10
7
  import { GEONAMES_ID_BASE, GEONAMES_POSTAL_ID_BASE } from "@mailwoman/core/resolver/synthetic-id-ranges"
11
- import type { DatabaseClient } from "@mailwoman/sqlite/client"
8
+ import type { DatabaseClient, StatementSync } from "@mailwoman/sqlite/client"
12
9
  import { type PathBuilderLike, resolvePathBuilder } from "path-ts"
13
10
 
14
11
  import type { WOFDatabase } from "#schema"
@@ -64,6 +61,12 @@ export interface GeonamesIngestProgress {
64
61
  * It distinguishes a sparse source from aliases that the fold discarded.
65
62
  */
66
63
  aliasesRefused: number | null
64
+
65
+ /**
66
+ * The number of populated places that matched an existing record and added their
67
+ * names to it, or null when the fold had no matcher.
68
+ */
69
+ matched?: number | null
67
70
  }
68
71
 
69
72
  /**
@@ -74,7 +77,9 @@ export function formatGeonamesIngestProgress(event: GeonamesIngestProgress, miss
74
77
  return `${event.country}: ${missingFile ? `${missingFile} missing` : "dump missing"} — download from download.geonames.org/export/dump/${event.country}.zip; skipped`
75
78
  }
76
79
 
77
- return `${event.country}: ${event.places.toLocaleString()} places, ${(event.aliasesRefused ?? 0).toLocaleString()} alt-names refused`
80
+ const matched = event.matched == null ? "" : `, ${event.matched.toLocaleString()} matched an existing record`
81
+
82
+ return `${event.country}: ${event.places.toLocaleString()} places${matched}, ${(event.aliasesRefused ?? 0).toLocaleString()} alt-names refused`
78
83
  }
79
84
 
80
85
  interface V2Alias {
@@ -139,6 +144,113 @@ async function parseAlternateNamesV2(
139
144
  return v2
140
145
  }
141
146
 
147
+ /**
148
+ * A GeoNames place the fold is about to write.
149
+ */
150
+ export interface GeonamesFoldPlace {
151
+ geonamesID: number
152
+ name: string
153
+ placetype: "country" | "region" | "locality"
154
+ country: string
155
+ latitude: number
156
+ longitude: number
157
+ }
158
+
159
+ /**
160
+ * The record a GeoNames place matched in the database being folded into.
161
+ */
162
+ export interface GeonamesFoldMatch {
163
+ id: number
164
+ placetype: string
165
+ }
166
+
167
+ /**
168
+ * Matches GeoNames places against the records already in the database being folded into.
169
+ */
170
+ export interface GeonamesFoldMatcher {
171
+ match(place: GeonamesFoldPlace): GeonamesFoldMatch | null
172
+ /**
173
+ * Answers whether the matched record lacks a name, recording it so the name is written once.
174
+ */
175
+ claimName(match: GeonamesFoldMatch, country: string, name: string): boolean
176
+ onGap(place: GeonamesFoldPlace & { id: number }): void
177
+ }
178
+
179
+ /**
180
+ * Folds one country's GeoNames `A`-class rows, its country and its ADM1 regions,
181
+ * and links each region the fold wrote to the country.
182
+ *
183
+ * A row that matches an existing record writes no row and adds its name to that record,
184
+ * and its id is the existing record's.
185
+ * Only regions the fold wrote are re-parented, so an existing region keeps its own parent.
186
+ */
187
+ function foldAdminRows(
188
+ statements: { db: DatabaseClient<WOFDatabase>; spr: StatementSync; names: StatementSync; ancestors: StatementSync },
189
+ input: {
190
+ rows: readonly string[][]
191
+ country: string
192
+ clean: (s: string) => string | null
193
+ existing: GeonamesFoldMatcher | undefined
194
+ claim: (match: GeonamesFoldMatch, name: string) => void
195
+ nextID: number
196
+ }
197
+ ): { countryID: number; adminMap: Map<string, number>; nextID: number } {
198
+ const { rows, country: cc, clean, existing, claim } = input
199
+ let id = input.nextID
200
+ let countryID = -1
201
+ const adminMap = new Map<string, number>()
202
+ // The regions this fold wrote, as opposed to existing records a region matched.
203
+ const writtenRegions = new Set<number>()
204
+
205
+ for (const f of rows) {
206
+ const aname = clean(f[2] ?? "") ?? clean(f[1] ?? "")
207
+
208
+ if (!aname) continue
209
+ const lat = Number(f[4]) || 0
210
+ const lon = Number(f[5]) || 0
211
+ const placetype: GeonamesFoldPlace["placetype"] = f[7]?.startsWith("PCL") ? "country" : "region"
212
+
213
+ if (placetype === "country" && countryID >= 0) continue
214
+
215
+ if (placetype === "region" && !(f[7] === "ADM1" && f[10])) continue
216
+
217
+ const place = { geonamesID: Number(f[0]), name: aname, placetype, country: cc, latitude: lat, longitude: lon }
218
+ const matched = existing?.match(place) ?? null
219
+
220
+ if (matched) {
221
+ claim(matched, aname)
222
+ }
223
+
224
+ const rid = matched?.id ?? id++
225
+
226
+ if (!matched) {
227
+ statements.spr.run(rid, -1, aname, placetype, cc, lat, lon, lat, lon, lat, lon, 1, 0, 0, 0, 0, 0)
228
+ statements.names.run(rid, aname, placetype, cc, "", "", 0, 0)
229
+ statements.ancestors.run(rid, rid, placetype)
230
+ existing?.onGap({ ...place, id: rid })
231
+ }
232
+
233
+ if (placetype === "country") {
234
+ countryID = rid
235
+ } else {
236
+ adminMap.set(f[10]!, rid)
237
+
238
+ if (!matched) {
239
+ writtenRegions.add(rid)
240
+ }
241
+ }
242
+ }
243
+
244
+ if (countryID >= 0) {
245
+ for (const rid of writtenRegions) {
246
+ statements.db.prepare("UPDATE spr SET parent_id = ? WHERE id = ?").run(countryID, rid)
247
+ statements.ancestors.run(rid, countryID, "country")
248
+ }
249
+ }
250
+
251
+ return { countryID, adminMap, nextID: id }
252
+ }
253
+
142
254
  /**
143
255
  * Purges the fold's id range, then adds GeoNames `P`-class places and their
144
256
  * alternate names for `countries` to `db`.
@@ -156,6 +268,13 @@ export async function ingestGeonamesAliases(
156
268
  adminForCountries?: ReadonlySet<string>
157
269
 
158
270
  alternateDir?: PathBuilderLike
271
+ /**
272
+ * The records already in `db` to match against.
273
+ *
274
+ * A GeoNames place that matches one adds its names to that record and writes no row.
275
+ * A place that matches none is written and reported to `onGap`.
276
+ */
277
+ existing?: GeonamesFoldMatcher
159
278
  }
160
279
  ): Promise<number> {
161
280
  const LATIN_NAME = /^[\p{Script=Latin}\p{M}\s\-'.]{2,60}$/u
@@ -184,7 +303,7 @@ export async function ingestGeonamesAliases(
184
303
  )
185
304
 
186
305
  const namesInsert = db.prepare(
187
- `INSERT INTO names (id, name, placetype, country, language, privateuse, official, lastmodified) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`
306
+ `INSERT INTO names (id, name, placetype, country, language, privateuse, official, lastmodified, source) VALUES (?, ?, ?, ?, ?, ?, ?, ?, 'geonames')`
188
307
  )
189
308
 
190
309
  const populationInsert = db.prepare(`INSERT OR REPLACE INTO place_population (id, population) VALUES (?, ?)`)
@@ -218,6 +337,7 @@ export async function ingestGeonamesAliases(
218
337
 
219
338
  let nc = 0
220
339
  let refused = 0
340
+ let matchedPlaces = 0
221
341
 
222
342
  const addAdmin = opts?.adminForCountries?.has(cc) ?? false
223
343
  const v2File = opts?.alternateDir ? resolvePathBuilder(opts.alternateDir, `${cc}.txt`) : null
@@ -244,40 +364,26 @@ export async function ingestGeonamesAliases(
244
364
 
245
365
  const v2 = readV2 ? await parseAlternateNamesV2(v2File!, cc, wanted) : null
246
366
 
247
- let countryID = -1
248
- const adminMap = new Map<string, number>()
249
-
250
- if (addAdmin) {
251
- for (const f of adminRows) {
252
- const aname = clean(f[2] ?? "") ?? clean(f[1] ?? "")
253
-
254
- if (!aname) continue
255
- const lat = Number(f[4]) || 0
256
- const lon = Number(f[5]) || 0
257
-
258
- if (f[7]?.startsWith("PCL")) {
259
- if (countryID >= 0) continue
260
- countryID = id++
261
- sprInsert.run(countryID, -1, aname, "country", cc, lat, lon, lat, lon, lat, lon, 1, 0, 0, 0, 0, 0)
262
- namesInsert.run(countryID, aname, "country", cc, "", "", 0, 0)
263
- ancestorInsert.run(countryID, countryID, "country")
264
- } else if (f[7] === "ADM1" && f[10]) {
265
- const rid = id++
266
- sprInsert.run(rid, -1, aname, "region", cc, lat, lon, lat, lon, lat, lon, 1, 0, 0, 0, 0, 0)
267
- namesInsert.run(rid, aname, "region", cc, "", "", 0, 0)
268
- ancestorInsert.run(rid, rid, "region")
269
- adminMap.set(f[10], rid)
270
- }
271
- }
272
-
273
- if (countryID >= 0) {
274
- for (const rid of adminMap.values()) {
275
- db.prepare("UPDATE spr SET parent_id = ? WHERE id = ?").run(countryID, rid)
276
- ancestorInsert.run(rid, countryID, "country")
277
- }
367
+ /**
368
+ * Writes a place's name onto the existing record it matched, once.
369
+ */
370
+ const claim = (match: GeonamesFoldMatch, name: string, language = "", privateuse = "", official = 0) => {
371
+ if (opts?.existing?.claimName(match, cc, name)) {
372
+ namesInsert.run(match.id, name, match.placetype, cc, language, privateuse, official, 0)
278
373
  }
279
374
  }
280
375
 
376
+ const admin = addAdmin
377
+ ? foldAdminRows(
378
+ { db, spr: sprInsert, names: namesInsert, ancestors: ancestorInsert },
379
+ { rows: adminRows, country: cc, clean, existing: opts?.existing, claim, nextID: id }
380
+ )
381
+ : { countryID: -1, adminMap: new Map<string, number>(), nextID: id }
382
+
383
+ const { countryID, adminMap } = admin
384
+
385
+ id = admin.nextID
386
+
281
387
  for await (const f of readUnquotedTSV(file)) {
282
388
  if (f[6] !== "P") continue
283
389
  const lat = Number(f[4])
@@ -287,8 +393,47 @@ export async function ingestGeonamesAliases(
287
393
  const name = clean(f[1] ?? "")
288
394
 
289
395
  if (!name) continue
396
+
397
+ const tags = v2?.get(Number(f[0]))
398
+ const alternates = [f[2] ?? "", ...(f[3] ? f[3].split(",") : [])]
399
+
400
+ const place = {
401
+ geonamesID: Number(f[0]),
402
+ name,
403
+ placetype: "locality" as const,
404
+ country: cc,
405
+ latitude: lat,
406
+ longitude: lon,
407
+ }
408
+
409
+ const matched = opts?.existing?.match(place) ?? null
410
+
411
+ if (matched) {
412
+ claim(matched, name)
413
+
414
+ for (const raw of alternates) {
415
+ const alt = cleanAlias(raw)
416
+
417
+ if (!alt && raw.trim()) {
418
+ refused++
419
+ }
420
+
421
+ if (alt) {
422
+ const tag = tags?.get(alt)
423
+
424
+ claim(matched, alt, tag?.language ?? "", tag?.privateuse ?? "", tag?.official ?? 0)
425
+ }
426
+ }
427
+
428
+ matchedPlaces++
429
+
430
+ continue
431
+ }
432
+
290
433
  const nid = id++
291
434
 
435
+ opts?.existing?.onGap({ ...place, id: nid })
436
+
292
437
  const regionID = addAdmin ? (adminMap.get(f[10] ?? "") ?? -1) : -1
293
438
  const parentID = regionID >= 0 ? regionID : addAdmin && countryID >= 0 ? countryID : -1
294
439
 
@@ -309,9 +454,7 @@ export async function ingestGeonamesAliases(
309
454
 
310
455
  const seen = new Set([name])
311
456
 
312
- const tags = v2?.get(Number(f[0]))
313
-
314
- for (const raw of [f[2] ?? "", ...(f[3] ? f[3].split(",") : [])]) {
457
+ for (const raw of alternates) {
315
458
  const alt = cleanAlias(raw)
316
459
 
317
460
  if (!alt && raw.trim()) {
@@ -335,7 +478,14 @@ export async function ingestGeonamesAliases(
335
478
  nc++
336
479
  }
337
480
 
338
- report({ country: cc, places: nc, skipped: false, aliasesRefused: refused })
481
+ report({
482
+ country: cc,
483
+ places: nc,
484
+ skipped: false,
485
+ aliasesRefused: refused,
486
+ matched: opts?.existing ? matchedPlaces : null,
487
+ })
488
+
339
489
  total += nc
340
490
  }
341
491
 
@@ -1,20 +1,22 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- *
6
- * Fold GeoNames postcode rows into a WOF or unified postcode extract as first-class `postalcode`
7
- * places for countries whose WOF postalcode repos do not exist.
5
+ * Fold GeoNames postcode rows into a WOF or unified postcode extract as first-class
6
+ * `postalcode` places for countries whose WOF postalcode repos do not exist.
8
7
  *
9
8
  * Two laws are enforced here in code rather than in a runbook.
10
9
  *
11
- * 1. The name law. A postcode row's `name` is stored in the sanitized-query token shape with
12
- * every non-letter and non-number stripped. `sanitizeFTSQuery` reduces the parsed token to
13
- * that shape at lookup time. A stored `"110 00"` or `"11-041"` can never match the
14
- * query `"11000"` or `"11041"`. The display form is preserved as an alt row in `names`.
15
- * 2. The medoid law. A postcode whose rows contain scattered points has no single true center.
16
- * Their average puts the code somewhere no address is. The medoid is the member point
17
- * nearest the group's mean.
10
+ * 1. The name law.
11
+ * A postcode row's `name` is stored in the sanitized-query token shape with
12
+ * every non-letter and non-number stripped.
13
+ * `sanitizeFTSQuery` reduces the parsed token to that shape at lookup time.
14
+ * A stored `"110 00"` or `"11-041"` can never match the query `"11000"` or `"11041"`.
15
+ * The display form is preserved as an alt row in `names`.
16
+ * 2. The medoid law.
17
+ * A postcode whose rows contain scattered points has no single true center.
18
+ * Their average puts the code somewhere no address is.
19
+ * The medoid is the member point nearest the group's mean.
18
20
  *
19
21
  * `build-unified-wof --geonames-postal-countries`, standalone folds and the `mailwoman
20
22
  * gazetteer` commands share one implementation. The GeoNames postal dump is
@@ -77,7 +79,7 @@ export interface MedoidSupport {
77
79
  * Distinct coordinates among them.
78
80
  *
79
81
  * One means every row refers to the same point.
80
- * In a dump whose coordinates are computed, that is one value inherited N times
82
+ * In a dump whose coordinates are computed, that's one value inherited N times
81
83
  * rather than N sources agreeing.
82
84
  */
83
85
  distinctPoints: number
@@ -223,7 +225,7 @@ export async function ingestGeonamesPostal(
223
225
  )
224
226
 
225
227
  const namesInsert = db.prepare(
226
- `INSERT INTO names (id, name, placetype, country, language, lastmodified) VALUES (?, ?, 'postalcode', ?, '', 0)`
228
+ `INSERT INTO names (id, name, placetype, country, language, lastmodified, source) VALUES (?, ?, 'postalcode', ?, '', 0, 'geonames')`
227
229
  )
228
230
 
229
231
  let nextID = GEONAMES_POSTAL_ID_BASE
package/lib/geonames.ts CHANGED
@@ -1,8 +1,5 @@
1
- /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- */
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
6
3
 
7
4
  export * from "#geonames/aliases"
8
5
  export * from "#geonames/postal"
package/lib/index.ts CHANGED
@@ -1,8 +1,5 @@
1
- /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- */
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
6
3
 
7
4
  export type { FindPlaceQuery, PlaceCandidate, PlaceLookup, WOFPlacetype } from "#types"
8
5
 
@@ -122,6 +119,8 @@ export {
122
119
 
123
120
  export { AddressPointInterpolator } from "#address/point/interpolation"
124
121
  export { AddressPointSqliteLookup } from "#address/point"
122
+ export { openAddressLayerLookup } from "#address/keys/open"
123
+ export { readLatestAddressLayerManifest } from "#address/keys/layout"
125
124
 
126
125
  export {
127
126
  STREET_CENTROID_COLUMNS,
@@ -1,9 +1,10 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- *
6
- * House-number interpolation: when the exact address-point tier misses, estimate the coordinate from tiger street-segment ranges by parity-aware range match and linear interpolation along the segment polyline.
5
+ * House-number interpolation: when the exact address-point tier misses,
6
+ * estimate the coordinate from tiger street-segment ranges by parity-aware range match
7
+ * and linear interpolation along the segment polyline.
7
8
  */
8
9
 
9
10
  import { parseJSONStrict } from "@mailwoman/core/json"
@@ -134,7 +135,7 @@ export class StreetInterpolator<
134
135
  /**
135
136
  * Resources this instance opened.
136
137
  *
137
- * A caller-supplied connection is not in here, so disposal cannot reach it.
138
+ * A caller-supplied connection isn't in here, so disposal cannot reach it.
138
139
  */
139
140
  readonly #resources: DisposableStack
140
141
  readonly #byPostcode:
@@ -1,10 +1,10 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
+ * The landmark table's read, shared by the native lookup and the range-read lookup a Worker uses.
5
6
  *
6
- * The landmark table's read, shared by the native lookup and the range-read lookup a Worker uses. It holds no database
7
- * client, so a Worker bundle can import it.
7
+ * It holds no database client, so a Worker bundle can import it.
8
8
  */
9
9
 
10
10
  import type { LandmarkHit, LandmarkKind } from "@mailwoman/core/resolver"
package/lib/landmark.ts CHANGED
@@ -1,10 +1,10 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- *
6
- * The landmark layer: Wikidata places keyed by every name and alias they are written with, ranked by the number of
7
- * Wikipedia language editions that describe them. The source is CC0, so the database may ship.
5
+ * The landmark layer: Wikidata places keyed by every name and alias they're written with,
6
+ * ranked by the number of Wikipedia language editions that describe them.
7
+ * The source is CC0, so the database may ship.
8
8
  */
9
9
 
10
10
  import type { LandmarkHit, LandmarkLookup } from "@mailwoman/core/resolver"
package/lib/lookup.ts CHANGED
@@ -1,9 +1,9 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
- *
6
- * `WOFSQLitePlaceLookup` — the resolver implementation backed by `node:sqlite` plus a Kysely-typed query layer where the queries are non-trivial and raw SQL where they are not.
5
+ * `WOFSQLitePlaceLookup` — the resolver implementation backed by `node:sqlite` plus a
6
+ * Kysely-typed query layer where the queries are non-trivial and raw SQL where they're not.
7
7
  */
8
8
 
9
9
  import { expandPlacetypeFilter } from "@mailwoman/codex/placetype-map"
@@ -550,7 +550,7 @@ export class WOFSQLitePlaceLookup extends SQLiteLookup<WOFDatabase> implements P
550
550
  /**
551
551
  * Coordinate-first locality resolution: union the postcode's containing
552
552
  * and closest neighboring localities with the FTS name candidates and soft-score them,
553
- * returning null when the postcode is not in the table.
553
+ * returning null when the postcode isn't in the table.
554
554
  */
555
555
  async #findLocalityCoordFirst(
556
556
  query: FindPlaceQuery,
@@ -583,7 +583,7 @@ export class WOFSQLitePlaceLookup extends SQLiteLookup<WOFDatabase> implements P
583
583
  }
584
584
 
585
585
  // Observed postal-city aliases for this postcode keyed by geographic locality name,
586
- // empty when the reader is not supplied.
586
+ // empty when the reader isn't supplied.
587
587
  const postalAliasByGeo = new Map<string, string[]>()
588
588
 
589
589
  if (this.#postalCityAliases) {
@@ -635,7 +635,7 @@ export class WOFSQLitePlaceLookup extends SQLiteLookup<WOFDatabase> implements P
635
635
  // with the soft score breaking ties within a tier.
636
636
  scored.sort((a, b) => Number(b.exact) - Number(a.exact) || b.score - a.score)
637
637
 
638
- // When the chosen locality is not the postcode's containing locality and sits far
638
+ // When the chosen locality isn't the postcode's containing locality and sits far
639
639
  // from it, flag `mismatch` rather than overriding the name.
640
640
  const top = scored[0]
641
641
 
package/lib/name-score.ts CHANGED
@@ -1,11 +1,12 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
1
4
  /**
2
- * @copyright Sister Software
3
- * @license AGPL-3.0
4
- * @author Teffen Ellis, et al.
5
+ * Soft name matching for locality ranking: case/diacritic folding, padded character
6
+ * trigrams and the trigram-Jaccard score built on them.
5
7
  *
6
- * Soft name matching for locality ranking: case/diacritic folding, padded character trigrams and the
7
- * trigram-Jaccard score built on them. Shared by the FTS lookup and the candidate-table backend so
8
- * both rank the same typo identically — the whole reason this is one module rather than two copies.
8
+ * Shared by the FTS lookup and the candidate-table backend so both rank the same typo
9
+ * identically — the whole reason this is one module rather than two copies.
9
10
  */
10
11
 
11
12
  /**