japanese_address_parser 3.1.0 → 3.1.1

data/js/node_modules/@geolonia/normalize-japanese-addresses/dist/main-node.js

@@ -78,6 +78,7 @@ function __generator(thisArg, body) {
 
 var gh_pages_endpoint = 'https://geolonia.github.io/japanese-addresses/api/ja';
 var currentConfig = {
+    interfaceVersion: 1,
     japaneseAddressesApi: gh_pages_endpoint,
     townCacheSize: 1000,
 };
@@ -85,8 +86,13 @@ var currentConfig = {
 var kan2num = function (string) {
     var kanjiNumbers = japaneseNumeral.findKanjiNumbers(string);
     for (var i = 0; i < kanjiNumbers.length; i++) {
-        // @ts-ignore
-        string = string.replace(kanjiNumbers[i], japaneseNumeral.kanji2number(kanjiNumbers[i]));
+        try {
+            // @ts-ignore
+            string = string.replace(kanjiNumbers[i], japaneseNumeral.kanji2number(kanjiNumbers[i]));
+        }
+        catch (error) {
+            // ignore
+        }
     }
     return string;
 };
@@ -191,6 +197,7 @@ var cachedPrefectures = undefined;
 var cachedTowns = {};
 var cachedGaikuListItem = {};
 var cachedResidentials = {};
+var cachedAddrs = {}; // TODO: use LRU
 var cachedSameNamedPrefectureCityRegexPatterns = undefined;
 var getPrefectures = function () { return __awaiter(void 0, void 0, void 0, function () {
     var prefsResp, data;
@@ -200,7 +207,7 @@ var getPrefectures = function () { return __awaiter(void 0, void 0, void 0, func
                 if (typeof cachedPrefectures !== 'undefined') {
                     return [2 /*return*/, cachedPrefectures];
                 }
-                return [4 /*yield*/, __internals.fetch('.json')]; // ja.json
+                return [4 /*yield*/, __internals.fetch('.json', { level: 1 })]; // ja.json
             case 1:
                 prefsResp = _a.sent() // ja.json
                 ;
@@ -254,7 +261,7 @@ var getTowns = function (pref, city) { return __awaiter(void 0, void 0, void 0,
                 if (typeof cachedTown !== 'undefined') {
                     return [2 /*return*/, cachedTown];
                 }
-                return [4 /*yield*/, __internals.fetch(['', encodeURI(pref), encodeURI(city) + '.json'].join('/'))];
+                return [4 /*yield*/, __internals.fetch(['', encodeURI(pref), encodeURI(city) + '.json'].join('/'), { level: 3, pref: pref, city: city })];
             case 1:
                 townsResp = _a.sent();
                 return [4 /*yield*/, townsResp.json()];
@@ -269,7 +276,10 @@ var getGaikuList = function (pref, city, town) { return __awaiter(void 0, void 0
     return __generator(this, function (_b) {
         switch (_b.label) {
             case 0:
-                cacheKey = pref + "-" + city + "-" + town;
+                if (currentConfig.interfaceVersion > 1) {
+                    throw new Error("Invalid config.interfaceVersion: " + currentConfig.interfaceVersion + "'}. Please set config.interfaceVersion to 1.");
+                }
+                cacheKey = pref + "-" + city + "-" + town + "-v" + currentConfig.interfaceVersion;
                 cache = cachedGaikuListItem[cacheKey];
                 if (typeof cache !== 'undefined') {
                     return [2 /*return*/, cache];
@@ -297,7 +307,10 @@ var getResidentials = function (pref, city, town) { return __awaiter(void 0, voi
     return __generator(this, function (_b) {
         switch (_b.label) {
             case 0:
-                cacheKey = pref + "-" + city + "-" + town;
+                if (currentConfig.interfaceVersion > 1) {
+                    throw new Error("Invalid config.interfaceVersion: " + currentConfig.interfaceVersion + "'}. Please set config.interfaceVersion to 1.");
+                }
+                cacheKey = pref + "-" + city + "-" + town + "-v" + currentConfig.interfaceVersion;
                 cache = cachedResidentials[cacheKey];
                 if (typeof cache !== 'undefined') {
                     return [2 /*return*/, cache];
@@ -331,6 +344,39 @@ var getResidentials = function (pref, city, town) { return __awaiter(void 0, voi
         }
     });
 }); };
+var getAddrs = function (pref, city, town) { return __awaiter(void 0, void 0, void 0, function () {
+    var cacheKey, cache, addrsResp, addrs;
+    return __generator(this, function (_b) {
+        switch (_b.label) {
+            case 0:
+                if (currentConfig.interfaceVersion < 2) {
+                    throw new Error("Invalid config.interfaceVersion: " + currentConfig.interfaceVersion + "'}. Please set config.interfaceVersion to 2 or higher");
+                }
+                cacheKey = pref + "-" + city + "-" + town + "-v" + currentConfig.interfaceVersion;
+                cache = cachedAddrs[cacheKey];
+                if (typeof cache !== 'undefined') {
+                    return [2 /*return*/, cache];
+                }
+                return [4 /*yield*/, __internals.fetch(['', encodeURI(pref), encodeURI(city), encodeURI(town) + '.json'].join('/'), { level: 8, pref: pref, city: city, town: town })];
+            case 1:
+                addrsResp = _b.sent();
+                _b.label = 2;
+            case 2:
+                _b.trys.push([2, 4, , 5]);
+                return [4 /*yield*/, addrsResp.json()];
+            case 3:
+                addrs = (_b.sent());
+                return [3 /*break*/, 5];
+            case 4:
+                _b.sent();
+                addrs = [];
+                return [3 /*break*/, 5];
+            case 5:
+                addrs.sort(function (res1, res2) { return res1.addr.length - res2.addr.length; });
+                return [2 /*return*/, (cachedAddrs[cacheKey] = addrs)];
+        }
+    });
+}); };
 // 十六町 のように漢数字と町が連結しているか
 var isKanjiNumberFollewedByCho = function (targetTownName) {
     var xCho = targetTownName.match(/.町/g);
@@ -551,10 +597,32 @@ var normalizeResidentialPart = function (addr, pref, city, town) { return __awai
         }
     });
 }); };
+var normalizeAddrPart = function (addr, pref, city, town) { return __awaiter(void 0, void 0, void 0, function () {
+    var addrListItem, addrItem, other;
+    return __generator(this, function (_a) {
+        switch (_a.label) {
+            case 0: return [4 /*yield*/, getAddrs(pref, city, town)
+                // 住居表示住所、および地番住所が見つからなかった
+            ];
+            case 1:
+                addrListItem = _a.sent();
+                // 住居表示住所、および地番住所が見つからなかった
+                if (addrListItem.length === 0) {
+                    return [2 /*return*/, null];
+                }
+                addrItem = addrListItem.find(function (item) { return addr.startsWith(item.addr); });
+                if (addrItem) {
+                    other = addr.replace(addrItem.addr, '').trim();
+                    return [2 /*return*/, { addr: addrItem.addr, other: other, lat: addrItem.lat, lng: addrItem.lng }];
+                }
+                return [2 /*return*/, null];
+        }
+    });
+}); };
 var normalize$1 = function (address, _option) {
     if (_option === void 0) { _option = defaultOption; }
     return __awaiter(void 0, void 0, void 0, function () {
-        var option, addr, pref, city, town, lat, lng, level, normalized, prefectures, prefs, prefPatterns, sameNamedPrefectureCityRegexPatterns, i, _a, prefectureCity, reg, match, i, _b, _pref, pattern, match, matched, _pref, cities, cityPatterns, i, _c, _city, pattern, match, i, normalized_1, cities, cityPatterns, i, _d, _city, pattern, match, result;
+        var option, addr, pref, city, town, lat, lng, level, normalized, prefectures, prefs, prefPatterns, sameNamedPrefectureCityRegexPatterns, i, _a, prefectureCity, reg, match, i, _b, _pref, pattern, match, matched, _pref, cities, cityPatterns, i, _c, _city, pattern, match, i, normalized_1, cities, cityPatterns, i, _d, _city, pattern, match, normalizedAddrPart, other, result, result;
         return __generator(this, function (_e) {
             switch (_e.label) {
                 case 0:
@@ -714,7 +782,7 @@ var normalize$1 = function (address, _option) {
                             // `-1` のようなケース
                             return kan2num(s);
                         })
-                            .replace(/-[^0-9]+([0-9〇一二三四五六七八九十百千]+)/, function (s) {
+                            .replace(/-[^0-9]([0-9〇一二三四五六七八九十百千]+)/, function (s) {
                             // `-あ1` のようなケース
                             return kan2num(zen2han(s));
                         })
@@ -727,12 +795,52 @@ var normalize$1 = function (address, _option) {
                     _e.label = 8;
                 case 8:
                     addr = patchAddr(pref, city, town, addr);
-                    if (!(option.level > 3 && normalized && town)) return [3 /*break*/, 10];
-                    return [4 /*yield*/, normalizeResidentialPart(addr, pref, city, town)];
+                    if (pref)
+                        level = level + 1;
+                    if (city)
+                        level = level + 1;
+                    if (town)
+                        level = level + 1;
+                    if (option.level <= 3 || level < 3) {
+                        return [2 /*return*/, { pref: pref, city: city, town: town, addr: addr, level: level, lat: lat, lng: lng }];
+                    }
+                    if (!(currentConfig.interfaceVersion === 2)) return [3 /*break*/, 10];
+                    return [4 /*yield*/, normalizeAddrPart(addr, pref, city, town)];
                 case 9:
-                    normalized = _e.sent();
-                    _e.label = 10;
+                    normalizedAddrPart = _e.sent();
+                    other = undefined;
+                    if (normalizedAddrPart) {
+                        addr = normalizedAddrPart.addr;
+                        if (normalizedAddrPart.other) {
+                            other = normalizedAddrPart.other;
+                        }
+                        if (normalizedAddrPart.lat !== null)
+                            lat = parseFloat(normalizedAddrPart.lat);
+                        if (normalizedAddrPart.lng !== null)
+                            lng = parseFloat(normalizedAddrPart.lng);
+                        level = 8;
+                    }
+                    result = {
+                        pref: pref,
+                        city: city,
+                        town: town,
+                        addr: addr,
+                        level: level,
+                        lat: lat,
+                        lng: lng,
+                    };
+                    if (other) {
+                        result.other = other;
+                    }
+                    return [2 /*return*/, result];
                 case 10:
+                    if (!(currentConfig.interfaceVersion === 1)) return [3 /*break*/, 13];
+                    if (!(option.level > 3 && normalized && town)) return [3 /*break*/, 12];
+                    return [4 /*yield*/, normalizeResidentialPart(addr, pref, city, town)];
+                case 11:
+                    normalized = _e.sent();
+                    _e.label = 12;
+                case 12:
                     if (normalized) {
                         lat = parseFloat(normalized.lat);
                         lng = parseFloat(normalized.lng);
@@ -741,12 +849,6 @@ var normalize$1 = function (address, _option) {
                         lat = null;
                         lng = null;
                     }
-                    if (pref)
-                        level = level + 1;
-                    if (city)
-                        level = level + 1;
-                    if (town)
-                        level = level + 1;
                     result = {
                         pref: pref,
                         city: city,
@@ -766,45 +868,79 @@ var normalize$1 = function (address, _option) {
                         result.level = 8;
                     }
                     return [2 /*return*/, result];
+                case 13: throw new Error('invalid interfaceVersion');
             }
         });
     });
 };
 
-var fetchOrReadFile = function (input) { return __awaiter(void 0, void 0, void 0, function () {
-    var fileURL, filePath_1;
-    return __generator(this, function (_a) {
-        fileURL = new URL("" + config$1.japaneseAddressesApi + input);
-        if (fileURL.protocol === 'http:' || fileURL.protocol === 'https:') {
-            if (config$1.geoloniaApiKey) {
-                fileURL.search = "?geolonia-api-key=" + config$1.geoloniaApiKey;
-            }
-            return [2 /*return*/, unfetch__default['default'](fileURL.toString())];
-        }
-        else if (fileURL.protocol === 'file:') {
-            filePath_1 = process.platform === 'win32' ? decodeURI(fileURL.pathname).substr(1) : decodeURI(fileURL.pathname);
-            return [2 /*return*/, {
-                    json: function () { return __awaiter(void 0, void 0, void 0, function () {
-                        var contents;
-                        return __generator(this, function (_a) {
-                            switch (_a.label) {
-                                case 0: return [4 /*yield*/, fs.promises.readFile(filePath_1)];
-                                case 1:
-                                    contents = _a.sent();
-                                    return [2 /*return*/, JSON.parse(contents.toString('utf-8'))];
-                            }
-                        });
-                    }); },
-                }];
-        }
-        else {
-            throw new Error("Unknown URL schema: " + fileURL.protocol);
+var requestHandlers = {
+    file: function (fileURL) {
+        var filePath = process.platform === 'win32'
+            ? decodeURI(fileURL.pathname).substr(1)
+            : decodeURI(fileURL.pathname);
+        return {
+            json: function () { return __awaiter(void 0, void 0, void 0, function () {
+                var contents;
+                return __generator(this, function (_a) {
+                    switch (_a.label) {
+                        case 0: return [4 /*yield*/, fs.promises.readFile(filePath)];
+                        case 1:
+                            contents = _a.sent();
+                            return [2 /*return*/, JSON.parse(contents.toString('utf-8'))];
+                    }
+                });
+            }); },
+        };
+    },
+    http: function (fileURL) {
+        if (config$1.geoloniaApiKey) {
+            fileURL.search = "?geolonia-api-key=" + config$1.geoloniaApiKey;
         }
+        return unfetch__default['default'](fileURL.toString());
+    },
+};
+/**
+ * 正規化のためのデータを取得する
+ * @param input - Path part like '東京都/文京区.json'
+ * @param requestOptions - input を構造化したデータ
+ */
+var fetchOrReadFile = function (input, requestOptions) {
+    if (requestOptions === void 0) { requestOptions = { level: -1 }; }
+    return __awaiter(void 0, void 0, void 0, function () {
+        var fileURL, result_1;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    fileURL = new URL("" + config$1.japaneseAddressesApi + input);
+                    if (!(config$1.transformRequest && requestOptions.level !== -1)) return [3 /*break*/, 2];
+                    return [4 /*yield*/, config$1.transformRequest(fileURL, requestOptions)];
+                case 1:
+                    result_1 = _a.sent();
+                    return [2 /*return*/, {
+                            json: function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+                                return [2 /*return*/, Promise.resolve(result_1)];
+                            }); }); },
+                        }];
+                case 2:
+                    if (fileURL.protocol === 'http:' || fileURL.protocol === 'https:') {
+                        return [2 /*return*/, requestHandlers.http(fileURL)];
+                    }
+                    else if (fileURL.protocol === 'file:') {
+                        return [2 /*return*/, requestHandlers.file(fileURL)];
+                    }
+                    else {
+                        throw new Error("Unknown URL schema: " + fileURL.protocol);
+                    }
+                case 3: return [2 /*return*/];
+            }
+        });
     });
-}); };
+};
 __internals.fetch = fetchOrReadFile;
 var config = config$1;
 var normalize = normalize$1;
 
 exports.config = config;
 exports.normalize = normalize;
+exports.requestHandlers = requestHandlers;

data/js/node_modules/@geolonia/normalize-japanese-addresses/dist/normalize.d.ts

@@ -1,18 +1,35 @@
+import { PrefectureList, TownList, AddrList } from './lib/cacheRegexes';
+declare type TransformRequestResponse = null | PrefectureList | TownList | AddrList;
+export declare type TransformRequestQuery = {
+    level: number;
+    pref?: string;
+    city?: string;
+    town?: string;
+};
+export declare type TransformRequestFunction = (url: URL, query: TransformRequestQuery) => TransformRequestResponse | Promise<TransformRequestResponse>;
 /**
  * normalize {@link Normalizer} の動作オプション。
  */
 export interface Config {
+    /**
+     * レスポンス型のバージョン。デフォルト 1
+     * 1 の場合は jyukyo: string, gaiku: string
+     * 2 の場合は addr: string,　other: string
+     */
+    interfaceVersion: number;
     /** 住所データを URL 形式で指定。 file:// 形式で指定するとローカルファイルを参照できます。 */
     japaneseAddressesApi: string;
     /** 町丁目のデータを何件までキャッシュするか。デフォルト 1,000 */
     townCacheSize: number;
+    /** 住所データへのリクエストを変形するオプション。 interfaceVersion === 2 で有効 */
+    transformRequest?: TransformRequestFunction;
     geoloniaApiKey?: string;
 }
 export declare const config: Config;
 /**
  * 住所の正規化結果として戻されるオブジェクト
  */
-export interface NormalizeResult {
+interface NormalizeResult_v1 {
     /** 都道府県 */
     pref: string;
     /** 市区町村 */
@@ -40,6 +57,32 @@ export interface NormalizeResult {
      */
     level: number;
 }
+declare type NormalizeResult_v2 = {
+    /** 都道府県 */
+    pref: string;
+    /** 市区町村 */
+    city: string;
+    /** 町丁目 */
+    town: string;
+    /** 住居表示または地番 */
+    addr: string;
+    /** 正規化後の住所文字列 */
+    other?: string;
+    /** 緯度。データが存在しない場合は null */
+    lat: number | null;
+    /** 経度。データが存在しない場合は null */
+    lng: number | null;
+    /**
+     * 住所文字列をどこまで判別できたかを表す正規化レベル
+     * - 0 - 都道府県も判別できなかった。
+     * - 1 - 都道府県まで判別できた。
+     * - 2 - 市区町村まで判別できた。
+     * - 3 - 町丁目まで判別できた。
+     * - 8 - 住居表示住所の街区符号・住居番号までの判別または地番住所の判別ができた。
+     */
+    level: number;
+};
+export declare type NormalizeResult = NormalizeResult_v1 | NormalizeResult_v2;
 /**
  * 正規化関数の {@link normalize} のオプション
  */
@@ -64,7 +107,7 @@ export interface Option {
  * @see https://github.com/geolonia/normalize-japanese-addresses#normalizeaddress-string
  */
 export declare type Normalizer = (input: string, option?: Option) => Promise<NormalizeResult>;
-export declare type FetchLike = (input: string) => Promise<Response | {
+export declare type FetchLike = (input: string, requestQuery?: TransformRequestQuery) => Promise<Response | {
     json: () => Promise<unknown>;
 }>;
 /**
@@ -74,3 +117,4 @@ export declare const __internals: {
     fetch: FetchLike;
 };
 export declare const normalize: Normalizer;
+export {};

data/js/node_modules/@geolonia/normalize-japanese-addresses/package.json

@@ -1,16 +1,17 @@
 {
   "name": "@geolonia/normalize-japanese-addresses",
-  "version": "2.8.0",
+  "version": "2.9.2",
   "description": "",
   "browser": "./dist/main-browser.js",
   "main": "./dist/main-node.js",
   "types": "./dist/normalize.d.ts",
   "scripts": {
-    "test": "npm run test:main && npm run test:addresses && npm run test:node:platform && npm run test:residential",
+    "test": "npm run test:main && npm run test:addresses && npm run test:node:platform && npm run test:advanced",
     "test:node:platform": "npm run test:node-win || npm run test:node",
     "test:main": "jest test/main.test.ts",
     "test:addresses": "jest test/addresses.test.ts",
-    "test:residential": "jest test/residential.test.ts --runInBand",
+    "test:advanced": "jest test/advanced --runInBand",
+    "test:util": "jest test/util.test.ts",
     "test:node": "curl -sL https://github.com/geolonia/japanese-addresses/archive/refs/heads/master.tar.gz | tar xvfz - -C ./test > nul 2>&1 && jest test/fs.test.ts",
     "test:node-win": "curl -sL https://github.com/geolonia/japanese-addresses/archive/refs/heads/master.tar.gz -o master.tar.gz && 7z x master.tar.gz -y -o./ && 7z x ./master.tar -y -o./test && del master.tar.gz master.tar && jest test/fs.test.ts",
     "test:generate-test-data": "npx ts-node -O '{\"module\":\"commonjs\"}' test/build-test-data.ts > test/addresses.csv",

data/js/node_modules/@geolonia/normalize-japanese-addresses/src/config.ts

@@ -4,6 +4,7 @@ export const gh_pages_endpoint =
   'https://geolonia.github.io/japanese-addresses/api/ja'
 
 export const currentConfig: Config = {
+  interfaceVersion: 1,
   japaneseAddressesApi: gh_pages_endpoint,
   townCacheSize: 1_000,
 }

data/js/node_modules/@geolonia/normalize-japanese-addresses/src/lib/cacheRegexes.ts

@@ -5,7 +5,7 @@ import { currentConfig } from '../config'
 import { __internals } from '../normalize'
 import { findKanjiNumbers } from '@geolonia/japanese-numeral'
 
-type PrefectureList = { [key: string]: string[] }
+export type PrefectureList = { [key: string]: string[] }
 interface SingleTown {
   town: string
   originalTown?: string
@@ -13,8 +13,13 @@ interface SingleTown {
   lat: string
   lng: string
 }
-type TownList = SingleTown[]
-
+export type TownList = SingleTown[]
+interface SingleAddr {
+  addr: string
+  lat: string | null
+  lng: string | null
+}
+export type AddrList = SingleAddr[]
 interface GaikuListItem {
   gaiku: string
   lat: string
@@ -40,16 +45,16 @@ let cachedPrefectures: PrefectureList | undefined = undefined
 const cachedTowns: { [key: string]: TownList } = {}
 const cachedGaikuListItem: { [key: string]: GaikuListItem[] } = {}
 const cachedResidentials: { [key: string]: ResidentialList } = {}
-let cachedSameNamedPrefectureCityRegexPatterns:
-  | [string, string][]
-  | undefined = undefined
+const cachedAddrs: { [key: string]: AddrList } = {} // TODO: use LRU
+let cachedSameNamedPrefectureCityRegexPatterns: [string, string][] | undefined =
+  undefined
 
 export const getPrefectures = async () => {
   if (typeof cachedPrefectures !== 'undefined') {
     return cachedPrefectures
   }
 
-  const prefsResp = await __internals.fetch('.json') // ja.json
+  const prefsResp = await __internals.fetch('.json', { level: 1 }) // ja.json
   const data = (await prefsResp.json()) as PrefectureList
   return cachePrefectures(data)
 }
@@ -104,6 +109,7 @@ export const getTowns = async (pref: string, city: string) => {
 
   const townsResp = await __internals.fetch(
     ['', encodeURI(pref), encodeURI(city) + '.json'].join('/'),
+    { level: 3, pref, city },
   )
   const towns = (await townsResp.json()) as TownList
   return (cachedTowns[cacheKey] = towns)
@@ -114,7 +120,13 @@ export const getGaikuList = async (
   city: string,
   town: string,
 ) => {
-  const cacheKey = `${pref}-${city}-${town}`
+  if (currentConfig.interfaceVersion > 1) {
+    throw new Error(
+      `Invalid config.interfaceVersion: ${currentConfig.interfaceVersion}'}. Please set config.interfaceVersion to 1.`,
+    )
+  }
+
+  const cacheKey = `${pref}-${city}-${town}-v${currentConfig.interfaceVersion}`
   const cache = cachedGaikuListItem[cacheKey]
   if (typeof cache !== 'undefined') {
     return cache
@@ -136,7 +148,13 @@ export const getResidentials = async (
   city: string,
   town: string,
 ) => {
-  const cacheKey = `${pref}-${city}-${town}`
+  if (currentConfig.interfaceVersion > 1) {
+    throw new Error(
+      `Invalid config.interfaceVersion: ${currentConfig.interfaceVersion}'}. Please set config.interfaceVersion to 1.`,
+    )
+  }
+
+  const cacheKey = `${pref}-${city}-${town}-v${currentConfig.interfaceVersion}`
   const cache = cachedResidentials[cacheKey]
   if (typeof cache !== 'undefined') {
     return cache
@@ -166,6 +184,34 @@ export const getResidentials = async (
   return (cachedResidentials[cacheKey] = residentials)
 }
 
+export const getAddrs = async (pref: string, city: string, town: string) => {
+  if (currentConfig.interfaceVersion < 2) {
+    throw new Error(
+      `Invalid config.interfaceVersion: ${currentConfig.interfaceVersion}'}. Please set config.interfaceVersion to 2 or higher`,
+    )
+  }
+
+  const cacheKey = `${pref}-${city}-${town}-v${currentConfig.interfaceVersion}`
+  const cache = cachedAddrs[cacheKey]
+  if (typeof cache !== 'undefined') {
+    return cache
+  }
+
+  const addrsResp = await __internals.fetch(
+    ['', encodeURI(pref), encodeURI(city), encodeURI(town) + '.json'].join('/'),
+    { level: 8, pref, city, town },
+  )
+  let addrs: AddrList
+  try {
+    addrs = (await addrsResp.json()) as AddrList
+  } catch {
+    addrs = []
+  }
+
+  addrs.sort((res1, res2) => res1.addr.length - res2.addr.length)
+  return (cachedAddrs[cacheKey] = addrs)
+}
+
 // 十六町 のように漢数字と町が連結しているか
 const isKanjiNumberFollewedByCho = (targetTownName: string) => {
   const xCho = targetTownName.match(/.町/g)

data/js/node_modules/@geolonia/normalize-japanese-addresses/src/lib/kan2num.ts

@@ -3,8 +3,12 @@ import { kanji2number, findKanjiNumbers } from '@geolonia/japanese-numeral'
 export const kan2num = (string: string) => {
   const kanjiNumbers = findKanjiNumbers(string)
   for (let i = 0; i < kanjiNumbers.length; i++) {
-    // @ts-ignore
-    string = string.replace(kanjiNumbers[i], kanji2number(kanjiNumbers[i]))
+    try {
+      // @ts-ignore
+      string = string.replace(kanjiNumbers[i], kanji2number(kanjiNumbers[i]));
+    } catch (error) {
+      // ignore
+    }
   }
 
   return string

data/js/node_modules/@geolonia/normalize-japanese-addresses/src/main-node.ts

@@ -1,26 +1,55 @@
 import * as Normalize from './normalize'
 import { promises as fs } from 'fs'
 import unfetch from 'isomorphic-unfetch'
+import { TransformRequestQuery } from './normalize'
 
-const fetchOrReadFile = async (
-  input: string,
-): Promise<Response | { json: () => Promise<unknown> }> => {
-  const fileURL = new URL(`${Normalize.config.japaneseAddressesApi}${input}`)
-  if (fileURL.protocol === 'http:' || fileURL.protocol === 'https:') {
-    if (Normalize.config.geoloniaApiKey) {
-      fileURL.search = `?geolonia-api-key=${Normalize.config.geoloniaApiKey}`
-    }
-    return unfetch(fileURL.toString())
-  } else if (fileURL.protocol === 'file:') {
-    const filePath = process.platform === 'win32' ? decodeURI(fileURL.pathname).substr(1) : decodeURI(fileURL.pathname);
+export const requestHandlers = {
+  file: (fileURL: URL) => {
+    const filePath =
+      process.platform === 'win32'
+        ? decodeURI(fileURL.pathname).substr(1)
+        : decodeURI(fileURL.pathname)
     return {
       json: async () => {
         const contents = await fs.readFile(filePath)
         return JSON.parse(contents.toString('utf-8'))
       },
     }
+  },
+  http: (fileURL: URL) => {
+    if (Normalize.config.geoloniaApiKey) {
+      fileURL.search = `?geolonia-api-key=${Normalize.config.geoloniaApiKey}`
+    }
+    return unfetch(fileURL.toString())
+  },
+}
+
+/**
+ * 正規化のためのデータを取得する
+ * @param input - Path part like '東京都/文京区.json'
+ * @param requestOptions - input を構造化したデータ
+ */
+const fetchOrReadFile = async (
+  input: string,
+  requestOptions: TransformRequestQuery = { level: -1 },
+): Promise<Response | { json: () => Promise<unknown> }> => {
+  const fileURL = new URL(`${Normalize.config.japaneseAddressesApi}${input}`)
+  if (Normalize.config.transformRequest && requestOptions.level !== -1) {
+    const result = await Normalize.config.transformRequest(
+      fileURL,
+      requestOptions,
+    )
+    return {
+      json: async () => Promise.resolve(result),
+    }
   } else {
-    throw new Error(`Unknown URL schema: ${fileURL.protocol}`)
+    if (fileURL.protocol === 'http:' || fileURL.protocol === 'https:') {
+      return requestHandlers.http(fileURL)
+    } else if (fileURL.protocol === 'file:') {
+      return requestHandlers.file(fileURL)
+    } else {
+      throw new Error(`Unknown URL schema: ${fileURL.protocol}`)
+    }
   }
 }