@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
@@ -0,0 +1,264 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
4
+ /**
5
+ * The address layer's two files.
6
+ *
7
+ * `lookup.db` holds one clustered key table per level of precision a parse can reach,
8
+ * each row holding its answer, plus street aggregates and the `source` table.
9
+ * `detail.db` holds the full `address` record.
10
+ * A reader opens it only to show one result in detail.
11
+ *
12
+ * Every key table is `WITHOUT ROWID` and clustered on its key, so a lookup is one B-tree
13
+ * descent over contiguous pages, the property a reader of the file by HTTP range depends on.
14
+ */
15
+
16
+ import type { layerschemadatabase } from "@mailwoman/core/layers/schema"
17
+ import { type Kysely, sql } from "kysely"
18
+
19
+ /**
20
+ * One source of address points: its wire id, publisher and terms.
21
+ */
22
+ export interface AddressSourceTable {
23
+ source_id: number
24
+ /**
25
+ * The wire source id the adapter writes, such as `usgov-nad` or `openaddresses:us/wi/statewide`.
26
+ */
27
+ name: string
28
+ /**
29
+ * The license expression its rows are published under, such as `CC-BY-4.0`,
30
+ * or `null` when its terms are unread.
31
+ */
32
+ license: string | null
33
+ /**
34
+ * The publisher or assigning authority, such as `co.adams.wi.us`, or `null` when unstated.
35
+ */
36
+ authority: string | null
37
+ /**
38
+ * The address points the file holds from this source.
39
+ */
40
+ records: number
41
+ }
42
+
43
+ /**
44
+ * One key row: the street and number under one scope, with the point that answers it.
45
+ *
46
+ * `scope` is the level's own value: a postcode, a locality form's key, or a county's key.
47
+ */
48
+ export interface AddressKeyTable {
49
+ scope: string
50
+ street: string
51
+ number: string
52
+ address_id: number
53
+ lat: number
54
+ lon: number
55
+ source_id: number
56
+ }
57
+
58
+ /**
59
+ * A key row under a Who's On First place id, for a locality the gazetteer resolved.
60
+ */
61
+ export interface AddressPlaceKeyTable extends Omit<AddressKeyTable, "scope"> {
62
+ wof_id: number
63
+ }
64
+
65
+ /**
66
+ * A key row for the file's whole region, keyed by street and number without a scope.
67
+ */
68
+ export type AddressRegionKeyTable = Omit<AddressKeyTable, "scope">
69
+
70
+ /**
71
+ * One street under one scope, for a parse with no house number or a number the source lacks.
72
+ */
73
+ export interface AddressStreetTable {
74
+ scope: string
75
+ street: string
76
+ lat: number
77
+ lon: number
78
+ min_lat: number
79
+ max_lat: number
80
+ min_lon: number
81
+ max_lon: number
82
+ points: number
83
+ }
84
+
85
+ /**
86
+ * The `lookup.db` schema, for `new DatabaseClient<AddressLookupDatabase>(...)`,
87
+ * with the layer interface's `layer_manifest` and `layer_coverage` tables.
88
+ */
89
+ export interface AddressLookupDatabase extends layerschemadatabase {
90
+ source: AddressSourceTable
91
+ key_postcode: AddressKeyTable
92
+ key_locality: AddressKeyTable
93
+ key_subregion: AddressKeyTable
94
+ key_place: AddressPlaceKeyTable
95
+ key_region: AddressRegionKeyTable
96
+ street_postcode: AddressStreetTable
97
+ street_locality: AddressStreetTable
98
+ }
99
+
100
+ /**
101
+ * The key tables scoped by a text value, in the order a reader falls back through them.
102
+ */
103
+ export const ADDRESS_SCOPED_KEY_TABLES = ["key_postcode", "key_locality", "key_subregion"] as const
104
+
105
+ export type AddressScopedKeyTableName = (typeof ADDRESS_SCOPED_KEY_TABLES)[number]
106
+
107
+ /**
108
+ * The street aggregate tables, one per scoped level a parse without a number can state.
109
+ */
110
+ export const ADDRESS_STREET_TABLES = ["street_postcode", "street_locality"] as const
111
+
112
+ export type AddressStreetTableName = (typeof ADDRESS_STREET_TABLES)[number]
113
+
114
+ /**
115
+ * One address point's full record, kept apart from the lookup file.
116
+ */
117
+ export interface AddressDetailTable {
118
+ address_id: number
119
+ source_id: number
120
+ /**
121
+ * The publisher's own id for the point.
122
+ */
123
+ source_record_id: string
124
+ country: string
125
+ number: string
126
+ unit: string | null
127
+ street_raw: string
128
+ postcode: string | null
129
+ /**
130
+ * Every name the record states, as JSON: `[{"level", "form", "value"}]`.
131
+ */
132
+ names: string
133
+ admin_code: string | null
134
+ lat: number
135
+ lon: number
136
+ placement: string | null
137
+ authority: string | null
138
+ }
139
+
140
+ /**
141
+ * The `detail.db` schema, for `new DatabaseClient<AddressDetailDatabase>(...)`.
142
+ */
143
+ export interface AddressDetailDatabase {
144
+ address: AddressDetailTable
145
+ }
146
+
147
+ /**
148
+ * Creates the `source` table.
149
+ */
150
+ export async function createAddressSourceTable(db: Kysely<AddressLookupDatabase>): Promise<void> {
151
+ await db.schema
152
+ .createTable("source")
153
+ .addColumn("source_id", "integer", (c) => c.primaryKey())
154
+ .addColumn("name", "text", (c) => c.notNull().unique())
155
+ .addColumn("license", "text")
156
+ .addColumn("authority", "text")
157
+ .addColumn("records", "integer", (c) => c.notNull())
158
+ .execute()
159
+ }
160
+
161
+ /**
162
+ * Creates one scoped key table, clustered on `(scope, street, number, address_id)`.
163
+ */
164
+ export async function createAddressScopedKeyTable(
165
+ db: Kysely<AddressLookupDatabase>,
166
+ table: AddressScopedKeyTableName
167
+ ): Promise<void> {
168
+ await db.schema
169
+ .createTable(table)
170
+ .addColumn("scope", "text", (c) => c.notNull())
171
+ .addColumn("street", "text", (c) => c.notNull())
172
+ .addColumn("number", "text", (c) => c.notNull())
173
+ .addColumn("address_id", "integer", (c) => c.notNull())
174
+ .addColumn("lat", "real", (c) => c.notNull())
175
+ .addColumn("lon", "real", (c) => c.notNull())
176
+ .addColumn("source_id", "integer", (c) => c.notNull())
177
+ .addPrimaryKeyConstraint(`${table}_pk`, ["scope", "street", "number", "address_id"])
178
+ // `without rowid` has no first-class builder. The raw modifier is the idiomatic fallback.
179
+ .modifyEnd(sql`without rowid`)
180
+ .execute()
181
+ }
182
+
183
+ /**
184
+ * Creates the place key table, clustered on `(wof_id, street, number, address_id)`.
185
+ */
186
+ export async function createAddressPlaceKeyTable(db: Kysely<AddressLookupDatabase>): Promise<void> {
187
+ await db.schema
188
+ .createTable("key_place")
189
+ .addColumn("wof_id", "integer", (c) => c.notNull())
190
+ .addColumn("street", "text", (c) => c.notNull())
191
+ .addColumn("number", "text", (c) => c.notNull())
192
+ .addColumn("address_id", "integer", (c) => c.notNull())
193
+ .addColumn("lat", "real", (c) => c.notNull())
194
+ .addColumn("lon", "real", (c) => c.notNull())
195
+ .addColumn("source_id", "integer", (c) => c.notNull())
196
+ .addPrimaryKeyConstraint("key_place_pk", ["wof_id", "street", "number", "address_id"])
197
+ .modifyEnd(sql`without rowid`)
198
+ .execute()
199
+ }
200
+
201
+ /**
202
+ * Creates the region key table, clustered on `(street, number, address_id)`.
203
+ */
204
+ export async function createAddressRegionKeyTable(db: Kysely<AddressLookupDatabase>): Promise<void> {
205
+ await db.schema
206
+ .createTable("key_region")
207
+ .addColumn("street", "text", (c) => c.notNull())
208
+ .addColumn("number", "text", (c) => c.notNull())
209
+ .addColumn("address_id", "integer", (c) => c.notNull())
210
+ .addColumn("lat", "real", (c) => c.notNull())
211
+ .addColumn("lon", "real", (c) => c.notNull())
212
+ .addColumn("source_id", "integer", (c) => c.notNull())
213
+ .addPrimaryKeyConstraint("key_region_pk", ["street", "number", "address_id"])
214
+ .modifyEnd(sql`without rowid`)
215
+ .execute()
216
+ }
217
+
218
+ /**
219
+ * Creates one street aggregate table, clustered on `(scope, street)`.
220
+ */
221
+ export async function createAddressStreetTable(
222
+ db: Kysely<AddressLookupDatabase>,
223
+ table: AddressStreetTableName
224
+ ): Promise<void> {
225
+ await db.schema
226
+ .createTable(table)
227
+ .addColumn("scope", "text", (c) => c.notNull())
228
+ .addColumn("street", "text", (c) => c.notNull())
229
+ .addColumn("lat", "real", (c) => c.notNull())
230
+ .addColumn("lon", "real", (c) => c.notNull())
231
+ .addColumn("min_lat", "real", (c) => c.notNull())
232
+ .addColumn("max_lat", "real", (c) => c.notNull())
233
+ .addColumn("min_lon", "real", (c) => c.notNull())
234
+ .addColumn("max_lon", "real", (c) => c.notNull())
235
+ .addColumn("points", "integer", (c) => c.notNull())
236
+ .addPrimaryKeyConstraint(`${table}_pk`, ["scope", "street"])
237
+ .modifyEnd(sql`without rowid`)
238
+ .execute()
239
+ }
240
+
241
+ /**
242
+ * Creates the `address` detail table, keyed by `address_id`.
243
+ *
244
+ * The rows store their names as JSON and are read one at a time by id, so the table keeps its rowid.
245
+ */
246
+ export async function createAddressDetailTable(db: Kysely<AddressDetailDatabase>): Promise<void> {
247
+ await db.schema
248
+ .createTable("address")
249
+ .addColumn("address_id", "integer", (c) => c.primaryKey())
250
+ .addColumn("source_id", "integer", (c) => c.notNull())
251
+ .addColumn("source_record_id", "text", (c) => c.notNull())
252
+ .addColumn("country", "text", (c) => c.notNull())
253
+ .addColumn("number", "text", (c) => c.notNull())
254
+ .addColumn("unit", "text")
255
+ .addColumn("street_raw", "text", (c) => c.notNull())
256
+ .addColumn("postcode", "text")
257
+ .addColumn("names", "text", (c) => c.notNull())
258
+ .addColumn("admin_code", "text")
259
+ .addColumn("lat", "real", (c) => c.notNull())
260
+ .addColumn("lon", "real", (c) => c.notNull())
261
+ .addColumn("placement", "text")
262
+ .addColumn("authority", "text")
263
+ .execute()
264
+ }
@@ -0,0 +1,61 @@
1
+ // SPDX-FileCopyrightText: Teffen Ellis and Mailwoman contributors
2
+ // SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Commercial
3
+
4
+ import { isJoinedHouseNumber } from "@mailwoman/match/address-point"
5
+
6
+ import type { StreetLocale } from "#street/normalize"
7
+
8
+ /**
9
+ * The forms a normalized house number is probed under, the written form first,
10
+ * each later form tried only after every earlier one missed.
11
+ *
12
+ * - A hyphenated number that cannot be a range is joined: Hawaii's `19-4074`
13
+ * is stored as `194074` by some sources.
14
+ * This runs ahead of the range form, because that form reads it as house number 19.
15
+ * - A grid number leads with a compass letter, and one writer's `n3971` is another source's `n 3971`.
16
+ * - A range such as `385-387` falls back to its low end, since a register stores one number per point.
17
+ * - A number with one letter retries the other spacing, then the bare number:
18
+ * BAN stores `3 a`, while G-NAF and most OpenAddresses sources store `3a`.
19
+ * - Under `zh`, `14之12` and `30附40` fall back to `14` and `30`, the number the Taiwanese register stores.
20
+ * That answer is approximate.
21
+ *
22
+ * Both address readers call this, so they try one number in one order.
23
+ */
24
+ export function* houseNumberForms(number: string, locale: StreetLocale): Generator<string> {
25
+ yield number
26
+
27
+ if (isJoinedHouseNumber(number)) {
28
+ yield number.replace("-", "")
29
+ }
30
+
31
+ const grid = /^([nesw])(?:\s+)?(\d+)$/.exec(number)
32
+
33
+ if (grid) {
34
+ yield number.includes(" ") ? `${grid[1]}${grid[2]}` : `${grid[1]} ${grid[2]}`
35
+ }
36
+
37
+ const low = /^(\d+[a-z]?)-\d+[a-z]?$/.exec(number)?.[1]
38
+
39
+ if (low) {
40
+ yield low
41
+ }
42
+
43
+ const joined = /^(\d+)\s+([a-z])$/.exec(number)
44
+ const spaced = /^(\d+)([a-z])$/.exec(number)
45
+
46
+ if (joined) {
47
+ yield `${joined[1]}${joined[2]}`
48
+ yield joined[1]!
49
+ } else if (spaced) {
50
+ yield `${spaced[1]} ${spaced[2]}`
51
+ yield spaced[1]!
52
+ }
53
+
54
+ if (locale === "zh") {
55
+ const base = /^(\d+)(?:[之附]\d+)+$/u.exec(number)?.[1]
56
+
57
+ if (base) {
58
+ yield base
59
+ }
60
+ }
61
+ }
@@ -1,30 +1,35 @@
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
+ * Address-point interpolation, the second method of the resolution ladder.
6
+ *
7
+ * When the exact address-point tier misses a house number, bracket the number with real neighbor
8
+ * points on the same street and interpolate linearly in house-number space between them.
9
+ * Real occupancy replaces the tiger range tier's uniform-spacing assumption.
10
+ *
11
+ * Tiger range interpolation (`StreetInterpolator`) is the fallback for streets too sparse to bracket.
5
12
  *
6
- * Address-point interpolation, the second method of the resolution ladder. When the exact
7
- * address-point tier misses a house number, bracket the number with real neighbor points on the
8
- * same street and interpolate linearly in house-number space between them. Real occupancy
9
- * replaces the tiger range tier's uniform-spacing assumption. Tiger range interpolation
10
- * (`StreetInterpolator`) is the fallback for streets too sparse to bracket.
13
+ * The matching key is `street_key`, the shared normalizer plus the route fold (`canonicalizeRouteKey`),
14
+ * identical at build time (`mailwoman situs address-points`) and query time by construction.
15
+ * Scope is postcode-first like the segment tier.
11
16
  *
12
- * The matching key is `street_key`, the shared normalizer plus the route fold
13
- * (`canonicalizeRouteKey`), identical at build time (`mailwoman situs address-points`) and query
14
- * time by construction. Scope is postcode-first like the segment tier. A query without a postcode
15
- * goes straight to the fallback. The fallback has its own statewide-ambiguity abstention.
17
+ * A query without a postcode goes straight to the fallback.
18
+ * The fallback has its own statewide-ambiguity abstention.
16
19
  *
17
- * Neighbor candidates never include the queried number itself, so production never overrides an
18
- * on-file number and grading against the same extract is non-circular.
20
+ * Neighbor candidates never include the queried number itself, so production never
21
+ * overrides an on-file number and grading against the same extract is non-circular.
19
22
  *
20
- * - Both-sided bracket (`bracket: "both"`): linear interpolation between the nearest known number
21
- * below and above. `uncertaintyM` is half the distance between them.
22
- * - Single-sided (`bracket: "single"`): linear extrapolation along the two nearest known numbers
23
- * on that side, capped at one pair-span beyond the nearest point (`t ≤ 2`, past which the line
24
- * provides no evidence and the query falls through). `uncertaintyM` is the pair distance plus
25
- * the extrapolated overshoot, larger than the both-sided radius.
26
- * - No bracket, meaning no neighbors, a single known number, or past the extrapolation cap: fall
27
- * through to the tiger fallback when configured, else null.
23
+ * - Both-sided bracket (`bracket: "both"`): linear interpolation between the
24
+ * nearest known number below and above.
25
+ * `uncertaintyM` is half the distance between them.
26
+ * - Single-sided (`bracket: "single"`): linear extrapolation along the two nearest
27
+ * known numbers on that side, capped at one pair-span beyond the nearest point
28
+ * (`t ≤ 2`, past which the line provides no evidence and the query falls through).
29
+ * `uncertaintyM` is the pair distance plus the extrapolated overshoot,
30
+ * larger than the both-sided radius.
31
+ * - No bracket, meaning no neighbors, a single known number, or past the extrapolation cap:
32
+ * fall through to the tiger fallback when configured, else null.
28
33
  *
29
34
  * Standalone like the segment tier, wired through the ordered `spatialTiers` list.
30
35
  */
@@ -71,7 +76,7 @@ export class AddressPointInterpolator<
71
76
  /**
72
77
  * Resources this instance opened.
73
78
  *
74
- * A connection handed in by a caller is not in here, so disposal cannot reach it.
79
+ * A connection handed in by a caller isn't in here, so disposal cannot reach it.
75
80
  * Ownership is membership rather than a flag a later branch checks.
76
81
  */
77
82
  readonly #resources: DisposableStack
@@ -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 { Kysely } from "kysely"
8
5
 
@@ -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 The shared rooftop schema with an H3 spine column and the layer-interface tables.
6
6
  *
7
7
  * The OpenStreetMap and G-NAF rooftop builders write this shape. Readers of existing address points
@@ -52,7 +52,7 @@ export async function createSpineAddressPointTables(db: Kysely<SpineAddressPoint
52
52
  }
53
53
 
54
54
  /**
55
- * Build after the bulk load so the spine index is not updated on every streaming insert.
55
+ * Build after the bulk load so the spine index isn't updated on every streaming insert.
56
56
  */
57
57
  export async function createSpineAddressPointIndexes(db: Kysely<SpineAddressPointDatabase>): Promise<void> {
58
58
  await db.schema.createIndex("idx_ap_h3").on("address_point").column("h3_cell").execute()
@@ -1,15 +1,17 @@
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 SQLite implementation of core's `AddressPointLookup`.
6
6
  */
7
7
 
8
8
  import type { AddressPointHit, AddressPointLookup } from "@mailwoman/core/resolver"
9
+ import { latLonBoundsContain } from "@mailwoman/spatial/bbox"
9
10
  import { DatabaseClient } from "@mailwoman/sqlite/client"
10
11
  import { indexExists } from "@mailwoman/sqlite/introspection"
11
12
  import type { PathBuilderLike } from "path-ts"
12
13
 
14
+ import { houseNumberForms } from "#address/number-forms"
13
15
  import type { AddressPointDatabase, AddressPointTable } from "#address/point/schema"
14
16
  import { hasTable, prepareGet, type PreparedGet } from "#sqlite-utils"
15
17
  import {
@@ -36,27 +38,6 @@ type AddressPointRow = Pick<AddressPointTable, "lat" | "lon" | "source" | "relea
36
38
  */
37
39
  const SELECT_COLS = "lat, lon, source, release, locality_norm, postcode"
38
40
 
39
- /**
40
- * The widest span of numbers a written range covers on one building or block.
41
- */
42
- const WIDEST_HOUSE_NUMBER_RANGE = 200
43
-
44
- /**
45
- * Returns whether two hyphenated numbers read as one number rather than a range of houses.
46
- *
47
- * `8-9 Upper St` is a range, and joining it would answer the different house at number 89.
48
- * `19-4074` and Queens's `123-45` cannot be ranges, because a range climbs by a short step.
49
- */
50
- function isJoinedHyphenNumber(number: string): boolean {
51
- const parts = /^(\d+)-(\d+)$/.exec(number)
52
-
53
- if (!parts) return false
54
-
55
- const span = Number(parts[2]) - Number(parts[1])
56
-
57
- return span < 0 || span > WIDEST_HOUSE_NUMBER_RANGE
58
- }
59
-
60
41
  /**
61
42
  * Finds an address point by exact normalized `(street, number)` within a postcode,
62
43
  * a locality, or a bounding box.
@@ -243,61 +224,13 @@ export class AddressPointSqliteLookup<DB extends AddressPointDatabase = AddressP
243
224
  bbox: { minLat: number; maxLat: number; minLon: number; maxLon: number } | null
244
225
  }
245
226
  ) {
246
- let row = this.#probe(streetNorm, number, query)
247
-
248
- // A hyphenated number can be one number written two ways: Hawaii's `19-4074`
249
- // is stored as `194074` by some sources.
250
- // This runs ahead of the range fallback, because that fallback reads it as house number 19.
251
- if (!row && isJoinedHyphenNumber(number)) {
252
- row = this.#probe(streetNorm, number.replace("-", ""), query)
253
- }
227
+ for (const form of houseNumberForms(number, this.#locale)) {
228
+ const row = this.#probe(streetNorm, form, query)
254
229
 
255
- // A grid number leads with a compass letter.
256
- // One writer's `N3971` is another source's `n 3971`.
257
- if (!row) {
258
- const grid = /^([nesw])(?:\s+)?(\d+)$/.exec(number)
259
-
260
- if (grid) {
261
- row = this.#probe(streetNorm, number.includes(" ") ? `${grid[1]}${grid[2]}` : `${grid[1]} ${grid[2]}`, query)
262
- }
263
- }
264
-
265
- // The registers store one number per point, so a range such as "385-387" falls back to its low end.
266
- if (!row) {
267
- const low = /^(\d+[a-z]?)-\d+[a-z]?$/.exec(number)?.[1]
268
-
269
- if (low) {
270
- row = this.#probe(streetNorm, low, query)
271
- }
272
- }
273
-
274
- // BAN stores a letter suffix as "3 a", while G-NAF and most OA sources store "3a".
275
- // For a number of digits plus one letter, the lookup retries the other spacing
276
- // and then the bare number.
277
- if (!row) {
278
- const joined = /^(\d+)\s+([a-z])$/.exec(number)
279
- const spaced = /^(\d+)([a-z])$/.exec(number)
280
-
281
- if (joined) {
282
- row = this.#probe(streetNorm, `${joined[1]}${joined[2]}`, query) ?? this.#probe(streetNorm, joined[1]!, query)
283
- } else if (spaced) {
284
- row = this.#probe(streetNorm, `${spaced[1]} ${spaced[2]}`, query) ?? this.#probe(streetNorm, spaced[1]!, query)
285
- }
230
+ if (row) return row
286
231
  }
287
232
 
288
- // The Taiwanese register stores `14之12` and `30附40` as numbers `14` and `30`.
289
- // It stores the rest in `unit`.
290
- // A query number that still includes the sub-number falls back to the base number.
291
- // That result is approximate.
292
- if (!row && this.#locale === "zh") {
293
- const base = /^(\d+)(?:[之附]\d+)+$/u.exec(number)?.[1]
294
-
295
- if (base) {
296
- row = this.#probe(streetNorm, base, query)
297
- }
298
- }
299
-
300
- return row
233
+ return null
301
234
  }
302
235
 
303
236
  /**
@@ -376,11 +309,11 @@ export class AddressPointSqliteLookup<DB extends AddressPointDatabase = AddressP
376
309
  /**
377
310
  * Returns whether the row's own postcode or locality differs from the query's.
378
311
  *
379
- * A row field that is empty never contradicts.
312
+ * A row field that's empty never contradicts.
380
313
  * The locality is compared only when the extract's `localityKeys` is `"full"`,
381
314
  * because abbreviated keys would reject correct rows.
382
315
  *
383
- * Two locality keys agree when they are equal or when one is the leading words of the other.
316
+ * Two locality keys agree when they're equal or when one is the leading words of the other.
384
317
  * A German disambiguated name such as `Lauta b Hoyerswerda` or `Freiberg Sachs` begins with the place
385
318
  * name that OSM's `addr:city` records, and a word boundary keeps `lauta` apart from `lautabach`.
386
319
  */
@@ -428,7 +361,7 @@ export class AddressPointSqliteLookup<DB extends AddressPointDatabase = AddressP
428
361
 
429
362
  if (!bbox) return true
430
363
 
431
- return row.lat >= bbox.minLat && row.lat <= bbox.maxLat && row.lon >= bbox.minLon && row.lon <= bbox.maxLon
364
+ return latLonBoundsContain(bbox, row.lat, row.lon)
432
365
  }
433
366
 
434
367
  [Symbol.dispose](): void {