@isofh/chuyen-doi-dia-chi-2-cap 1.0.10 → 2.0.0

package/index.js

@@ -11,14 +11,21 @@ let dataXa = null;
 let dataXaPromise = null;
 
 // Resolve global runtime để hỗ trợ các hook override giống contract gốc ở repo cũ.
-const getGlobalTarget = () =>
-  typeof globalThis !== "undefined"
-    ? globalThis
-    : typeof window !== "undefined"
-      ? window
-      : typeof global !== "undefined"
-        ? global
-        : null;
+const getGlobalTarget = () => {
+  if (typeof self !== "undefined") {
+    return self;
+  }
+
+  if (typeof window !== "undefined") {
+    return window;
+  }
+
+  if (typeof global !== "undefined") {
+    return global;
+  }
+
+  return null;
+};
 
 // Nạp dataset hành chính ở thời điểm cần dùng thay vì load ngay khi require package.
 const getDataXaSync = () => {
@@ -43,11 +50,11 @@ const loadDataXa = async (customDataXa) => {
 };
 
 // Dùng helper của string-utils để tạo key tìm kiếm không dấu, không khoảng trắng.
-const createUniqueText = (text = "") => `${text ?? ""}`.createUniqueText();
+const createUniqueText = (text = "") => `${text == null ? "" : text}`.createUniqueText();
 
 // Bóc các tiền tố hành chính để so sánh tên xã/tỉnh ổn định hơn.
 const stripAdministrativePrefix = (value = "") => {
-  let text = `${value ?? ""}`.trim();
+  let text = `${value == null ? "" : value}`.trim();
   let previous = "";
 
   while (text !== previous) {
@@ -76,10 +83,10 @@ const normalizeAdministrativeCode = (value = "") => {
 // Tách input địa chỉ về mảng các vế để các hàm phía sau xử lý thống nhất.
 const splitAddressParts = (input) => {
   if (Array.isArray(input)) {
-    return input.map((item) => `${item ?? ""}`.trim()).filter(Boolean);
+    return input.map((item) => `${item == null ? "" : item}`.trim()).filter(Boolean);
   }
 
-  return `${input ?? ""}`
+  return `${input == null ? "" : input}`
     .split(",")
     .map((item) => item.trim())
     .filter(Boolean);
@@ -87,7 +94,7 @@ const splitAddressParts = (input) => {
 
 // Parse chuỗi QR CCCD dạng `soGiayTo||hoTen|ngaySinh|gioiTinh|diaChi|ngayCap|...`.
 const parseCccdQrString = (input = "") => {
-  const sourceText = `${input ?? ""}`.replace(/\r?\n/g, "").trim();
+  const sourceText = `${input == null ? "" : input}`.replace(/\r?\n/g, "").trim();
   const fields = sourceText.split("|");
 
   if (fields.length !== 7 && fields.length !== 11) {
@@ -108,7 +115,7 @@ const parseCccdQrString = (input = "") => {
 
 // Chuẩn hóa ngày `DDMMYYYY` từ QR CCCD về format parse được bởi `new Date()` trong `toAddress`.
 const normalizeCccdIssueDate = (value = "") => {
-  const text = `${value ?? ""}`.trim();
+  const text = `${value == null ? "" : value}`.trim();
 
   if (!/^\d{8}$/.test(text)) {
     return text;
@@ -124,7 +131,7 @@ const normalizeCccdIssueDate = (value = "") => {
 // Lấy riêng field địa chỉ từ chuỗi QR CCCD dạng pipe.
 const extractCccdAddressText = (input = "") => {
   const parsedQr = parseCccdQrString(input);
-  return parsedQr?.diaChi?.trim() || "";
+  return (parsedQr && parsedQr.diaChi ? parsedQr.diaChi.trim() : "") || "";
 };
 
 // Gom chữ ký hàm để support cả kiểu truyền `(tenXa, tinh, options)` và object options.
@@ -155,6 +162,14 @@ const getProvinceSearchKeys = (value = "") => {
   return [...new Set(keys)];
 };
 
+const getLegacyProvinces = (province) => {
+  return province && Array.isArray(province.dsTinh) ? province.dsTinh : [];
+};
+
+const getMergedFromList = (xa) => {
+  return xa && Array.isArray(xa.satNhapTu) ? xa.satNhapTu : [];
+};
+
 // Thu hẹp danh sách tỉnh cần dò, bao gồm cả tỉnh hiện tại và các tỉnh cũ trong `dsTinh`.
 const getProvinceCandidates = (tinh, sourceDataXa) => {
   const provinceKeys = getProvinceSearchKeys(tinh);
@@ -164,16 +179,17 @@ const getProvinceCandidates = (tinh, sourceDataXa) => {
   }
 
   return sourceDataXa.filter((item) => {
+    const legacyKeys = getLegacyProvinces(item).reduce((result, item2) => {
+      result.push(item2.timKiem, createUniqueText(item2.ten), normalizeAdministrativeCode(item2.ten));
+      return result;
+    }, []);
     const candidateKeys = [
       item.timKiem,
       createUniqueText(item.ten),
       normalizeAdministrativeCode(item.ten),
-      ...(item.dsTinh || []).flatMap((item2) => [
-        item2.timKiem,
-        createUniqueText(item2.ten),
-        normalizeAdministrativeCode(item2.ten),
-      ]),
-    ].filter(Boolean);
+    ]
+      .concat(legacyKeys)
+      .filter(Boolean);
 
     return provinceKeys.some((key) => candidateKeys.includes(key));
   });
@@ -191,7 +207,7 @@ const findProvinceByText = (value = "", sourceDataXa = []) => {
     sourceDataXa.find(
       (item) =>
         normalizedValue.indexOf(item.timKiem) !== -1 ||
-        item.dsTinh?.some((item2) => normalizedValue.indexOf(item2.timKiem) !== -1)
+        getLegacyProvinces(item).some((item2) => normalizedValue.indexOf(item2.timKiem) !== -1)
     ) || null
   );
 };
@@ -314,7 +330,7 @@ const verifyXaName = (tenXa, tinhOrOptions, maybeOptions) => {
         });
       }
 
-      xa.satNhapTu?.forEach((satNhapItem) => {
+      getMergedFromList(xa).forEach((satNhapItem) => {
         if (
           satNhapItem.timKiem === normalizedXa &&
           isDistrictCompatible(satNhapItem.huyen || xa.huyen)
@@ -411,14 +427,14 @@ const splitAddressByValidXa = (input, tinhOrOptions, maybeOptions) => {
 
 // Bóc địa chỉ từ text căn cước rồi trả về output theo đúng contract của `String.prototype.toAddress`.
 const extractAndConvertCccdAddress = async (input, ngayCap, options = {}) => {
-  const sourceText = `${input ?? ""}`;
+  const sourceText = `${input == null ? "" : input}`;
   const parsedQr = parseCccdQrString(sourceText);
   const extractedText = extractCccdAddressText(sourceText);
-  const issueDate = normalizeCccdIssueDate(ngayCap || parsedQr?.ngayCap);
+  const issueDate = normalizeCccdIssueDate(ngayCap || (parsedQr ? parsedQr.ngayCap : ""));
   const parsedAddress = extractedText.toAddress({ ngayCap: issueDate, verifyXaName });
-  const soNha = parsedAddress?.soNha || "";
-  const diaChiGoc = parsedAddress?.diaChi || "";
-  const convertedDiaChi = parsedAddress?.diaChi
+  const soNha = parsedAddress && parsedAddress.soNha ? parsedAddress.soNha : "";
+  const diaChiGoc = parsedAddress && parsedAddress.diaChi ? parsedAddress.diaChi : "";
+  const convertedDiaChi = parsedAddress && parsedAddress.diaChi
     ? await convertDiaChiMoi(parsedAddress.diaChi, options)
     : "";
 
@@ -427,9 +443,9 @@ const extractAndConvertCccdAddress = async (input, ngayCap, options = {}) => {
     soNha,
     diaChi: convertedDiaChi,
     data: {
-      ...(parsedAddress?.data || {}),
+      ...((parsedAddress && parsedAddress.data) || {}),
       cccdText: sourceText,
-      cccdFields: parsedQr?.fields || [],
+      cccdFields: parsedQr ? parsedQr.fields || [] : [],
       extractedText,
       issueDate,
       soNha,
@@ -473,7 +489,7 @@ const convertDiaChiMoi = async (diaChi2CapCu, options = {}) => {
   const globalTarget = getGlobalTarget();
 
   if (
-    !globalTarget?.convertDiaChiMoi &&
+    !(globalTarget && globalTarget.convertDiaChiMoi) &&
     typeof diaChi2CapCu === "string" &&
     diaChi2CapCu.length <= 6
   ) {
@@ -482,11 +498,11 @@ const convertDiaChiMoi = async (diaChi2CapCu, options = {}) => {
 
   let sourceDataXa = await loadDataXa(options.dataXa);
 
-  if (globalTarget?.modifyDataXa) {
+  if (globalTarget && globalTarget.modifyDataXa) {
     sourceDataXa = globalTarget.modifyDataXa(sourceDataXa);
   }
 
-  if (globalTarget?.convertDiaChiMoi) {
+  if (globalTarget && globalTarget.convertDiaChiMoi) {
     return await Promise.resolve(globalTarget.convertDiaChiMoi(diaChi2CapCu, sourceDataXa));
   }
 
@@ -504,7 +520,7 @@ const convertDiaChiMoi = async (diaChi2CapCu, options = {}) => {
   const tinh = sourceDataXa.find(
     (item) =>
       tinhCu.indexOf(item.timKiem) !== -1 ||
-      item.dsTinh?.find((item2) => tinhCu.indexOf(item2.timKiem) !== -1)
+      getLegacyProvinces(item).find((item2) => tinhCu.indexOf(item2.timKiem) !== -1)
   );
 
   if (!tinh) {
@@ -524,7 +540,8 @@ const convertDiaChiMoi = async (diaChi2CapCu, options = {}) => {
     xa = tinh.dsXa.find((item) =>
       //khi đó tinhCu chính là xaCu
       /^\d+$/.test(tinhCu) ? tinhCu === item.timKiem : tinhCu.indexOf(item.timKiem) !== -1
-    )?.ten;
+    );
+    xa = xa ? xa.ten : xa;
   }
 
   //B2: Tìm kiếm theo tên sau sát nhập kèm theo huyện vì một số trường hợp có case sau
@@ -539,8 +556,9 @@ const convertDiaChiMoi = async (diaChi2CapCu, options = {}) => {
           (item) =>
             xaCu === item.timKiem &&
             (!huyenCu || !item.huyen || `${item.huyen}`.indexOf(huyenCu) !== -1)
-        )?.ten
+        )
       : ""; //mục đích tách riêng ra không tìm kiếm chung với xã sát nhập để ưu tiên xã có tên trùng trước
+    xa = xa ? xa.ten : xa;
   }
 
   //B3: Nếu B2 không ra kết quả nào thì tiếp tục tìm kiếm theo các xã bị sát nhập xem có xã nào trùng không
@@ -551,7 +569,7 @@ const convertDiaChiMoi = async (diaChi2CapCu, options = {}) => {
     //đầu tiên là lấy ra tất cả các xã phù hợp
     dsXa = xaCu
       ? tinh.dsXa.filter((item) =>
-          item.satNhapTu?.find(
+          getMergedFromList(item).find(
             (item2) =>
               xaCu === item2.timKiem &&
               (!huyenCu || !item2.huyen || `${item2.huyen}`.indexOf(huyenCu) !== -1)
@@ -567,16 +585,17 @@ const convertDiaChiMoi = async (diaChi2CapCu, options = {}) => {
       if (huyenCu) {
         //thì ưu tiên xã nào trùng huyện
         xa = dsXa.find((item) =>
-          item.satNhapTu.some(
+          getMergedFromList(item).some(
             (satNhapItem) =>
               satNhapItem.huyen && `${satNhapItem.huyen}`.indexOf(huyenCu) !== -1
           )
-        )?.ten;
+        );
+        xa = xa ? xa.ten : xa;
       }
 
       //ngược lại thì trả về bản ghi đầu tiên
       if (!xa) {
-        xa = dsXa[0]?.ten;
+        xa = dsXa[0] ? dsXa[0].ten : "";
       }
     }
   }
@@ -585,18 +604,20 @@ const convertDiaChiMoi = async (diaChi2CapCu, options = {}) => {
   if (!xa) {
     xa = xaCu
       ? tinh.dsXa.find((item) =>
-          item.satNhapTu?.find((item2) => xaCu.indexOf(item2.timKiem) !== -1)
-        )?.ten
+          getMergedFromList(item).find((item2) => xaCu.indexOf(item2.timKiem) !== -1)
+        )
       : "";
+    xa = xa ? xa.ten : xa;
   }
 
   //B5 thì lúc này sẽ tìm kiếm những xã sau sát nhập nhưng không theo điều kiện huyện nữa
   //Bước này là bước mở rộng của B2 sau khi tất cả đều không ra kết quả thì bỏ bớt điều kiện đi
   if (!xa) {
-    xa = xaCu ? tinh.dsXa.find((item) => xaCu === item.timKiem)?.ten : ""; //mục đích tách riêng ra không tìm kiếm chung với xã sát nhập để ưu tiên xã có tên trùng trước
+    xa = xaCu ? tinh.dsXa.find((item) => xaCu === item.timKiem) : ""; //mục đích tách riêng ra không tìm kiếm chung với xã sát nhập để ưu tiên xã có tên trùng trước
+    xa = xa ? xa.ten : xa;
   }
 
-  return [xa, tinh?.ten].filter(Boolean).join(", ");
+  return [xa, tinh ? tinh.ten : ""].filter(Boolean).join(", ");
 };
 
 // Mount helper lên global để các package khác có thể dùng runtime mà không cần dependency ngược.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@isofh/chuyen-doi-dia-chi-2-cap",
-  "version": "1.0.10",
+  "version": "2.0.0",
   "description": "Chuan hoa dia chi hanh chinh cu sang format 2 cap moi",
   "main": "index.js",
   "files": [