@isofh/chuyen-doi-dia-chi-2-cap 0.1.0

package/index.js

@@ -0,0 +1,460 @@
+require("mainam-react-native-string-utils");
+
+const dataXa = require("./dataXa.json");
+
+// 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();
+
+// 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 previous = "";
+
+  while (text !== previous) {
+    previous = text;
+    text = text
+      .replace(/^(xã|phường|thị trấn|huyện|quận|thị xã|tỉnh|thành phố)\s+/i, "")
+      .replace(/^(tp|tt|tx)\.?\s*/i, "")
+      .replace(/^([xXpPqQhH])\.?(?=\s*\d+\b|\s|$)\s*/i, "")
+      .trim();
+  }
+
+  return text;
+};
+
+// Chuẩn hóa mã tìm kiếm hành chính và co gọn các case chỉ chứa số.
+const normalizeAdministrativeCode = (value = "") => {
+  const text = createUniqueText(stripAdministrativePrefix(value));
+
+  if (/^\d+$/.test(text)) {
+    return `${Number(text)}`;
+  }
+
+  return text;
+};
+
+// 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 ?? ""}`
+    .split(",")
+    .map((item) => item.trim())
+    .filter(Boolean);
+};
+
+// 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 fields = sourceText.split("|");
+
+  if (fields.length !== 7 && fields.length !== 11) {
+    return null;
+  }
+
+  return {
+    sourceText,
+    fields,
+    soGiayTo: fields[0] || "",
+    hoTen: fields[2] || "",
+    ngaySinh: fields[3] || "",
+    gioiTinh: fields[4] || "",
+    diaChi: fields[5] || "",
+    ngayCap: fields[6] || "",
+  };
+};
+
+// 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();
+
+  if (!/^\d{8}$/.test(text)) {
+    return text;
+  }
+
+  const day = text.slice(0, 2);
+  const month = text.slice(2, 4);
+  const year = text.slice(4, 8);
+
+  return `${year}-${month}-${day}`;
+};
+
+// 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() || "";
+};
+
+// Gom chữ ký hàm để support cả kiểu truyền `(tenXa, tinh, options)` và object options.
+const getVerifyOptions = (tinhOrOptions, maybeOptions) => {
+  if (
+    tinhOrOptions &&
+    typeof tinhOrOptions === "object" &&
+    !Array.isArray(tinhOrOptions)
+  ) {
+    return {
+      tinh: tinhOrOptions.tinh,
+      options: tinhOrOptions,
+    };
+  }
+
+  return {
+    tinh: tinhOrOptions,
+    options: maybeOptions || {},
+  };
+};
+
+// Tạo tập khóa tìm kiếm của tỉnh từ cả tên gốc lẫn tên đã bỏ prefix.
+const getProvinceSearchKeys = (value = "") => {
+  const keys = [createUniqueText(value), normalizeAdministrativeCode(value)].filter(Boolean);
+  return [...new Set(keys)];
+};
+
+// 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);
+
+  if (!provinceKeys.length) {
+    return sourceDataXa;
+  }
+
+  return sourceDataXa.filter((item) => {
+    const candidateKeys = [
+      item.timKiem,
+      createUniqueText(item.ten),
+      normalizeAdministrativeCode(item.ten),
+      ...(item.dsTinh || []).flatMap((item2) => [
+        item2.timKiem,
+        createUniqueText(item2.ten),
+        normalizeAdministrativeCode(item2.ten),
+      ]),
+    ].filter(Boolean);
+
+    return provinceKeys.some((key) => candidateKeys.includes(key));
+  });
+};
+
+// Loại bỏ kết quả trùng và ưu tiên match theo tên xã hiện tại trước `satNhapTu`.
+const dedupeMatches = (matches = []) => {
+  const uniqueMatches = matches.filter((item, index, arr) => {
+    const key = [item.matchType, item.tenXa, item.tenTinh, item.tenXaCu || ""].join("|");
+    return (
+      arr.findIndex(
+        (candidate) =>
+          [
+            candidate.matchType,
+            candidate.tenXa,
+            candidate.tenTinh,
+            candidate.tenXaCu || "",
+          ].join("|") === key
+      ) === index
+    );
+  });
+
+  return uniqueMatches.sort((a, b) => {
+    if (a.matchType === b.matchType) return 0;
+    if (a.matchType === "current") return -1;
+    if (b.matchType === "current") return 1;
+    return 0;
+  });
+};
+
+// Kiểm tra một tên xã có hợp lệ trong phạm vi tỉnh đích hay không.
+const verifyXaName = (tenXa, tinhOrOptions, maybeOptions) => {
+  const { tinh, options } = getVerifyOptions(tinhOrOptions, maybeOptions);
+  const sourceDataXa = options.dataXa || dataXa;
+  const normalizedXa = normalizeAdministrativeCode(tenXa);
+  const normalizedTinh = normalizeAdministrativeCode(tinh);
+  const matchedProvinces = getProvinceCandidates(tinh, sourceDataXa);
+
+  if (!normalizedXa) {
+    return {
+      input: tenXa,
+      provinceInput: tinh || "",
+      normalizedInput: normalizedXa,
+      normalizedProvince: normalizedTinh,
+      isValid: false,
+      matches: [],
+    };
+  }
+
+  const matches = [];
+
+  matchedProvinces.forEach((province) => {
+    province.dsXa.forEach((xa) => {
+      if (xa.timKiem === normalizedXa) {
+        matches.push({
+          matchType: "current",
+          tenXa: xa.ten,
+          tenTinh: province.ten,
+        });
+      }
+
+      xa.satNhapTu?.forEach((satNhapItem) => {
+        if (satNhapItem.timKiem === normalizedXa) {
+          matches.push({
+            matchType: "satNhapTu",
+            tenXa: xa.ten,
+            tenTinh: province.ten,
+            tenXaCu: satNhapItem.ten,
+          });
+        }
+      });
+    });
+  });
+
+  const uniqueMatches = dedupeMatches(matches);
+
+  return {
+    input: tenXa,
+    provinceInput: tinh || "",
+    normalizedInput: normalizedXa,
+    normalizedProvince: normalizedTinh,
+    isValid: uniqueMatches.length > 0,
+    matches: uniqueMatches,
+  };
+};
+
+// Tìm xã hợp lệ đầu tiên trong chuỗi địa chỉ để tách các vế đứng trước thành `soNha`.
+const splitAddressByValidXa = (input, tinhOrOptions, maybeOptions) => {
+  const { tinh, options } = getVerifyOptions(tinhOrOptions, maybeOptions);
+  const sourceDataXa = options.dataXa || dataXa;
+  const parts = splitAddressParts(input);
+
+  if (!parts.length) {
+    return {
+      input,
+      soNha: "",
+      diaChi: "",
+      parts: [],
+      matchedXaIndex: -1,
+      matchedXa: null,
+    };
+  }
+
+  if (parts.length < 2) {
+    return {
+      input,
+      soNha: "",
+      diaChi: parts.join(", "),
+      parts,
+      matchedXaIndex: -1,
+      matchedXa: null,
+    };
+  }
+
+  const provinceCandidate = tinh || parts[parts.length - 1];
+  let matchedXaIndex = -1;
+  let matchedXa = null;
+
+  for (let index = 0; index < parts.length - 1; index += 1) {
+    const verifyResult = verifyXaName(parts[index], provinceCandidate, {
+      dataXa: sourceDataXa,
+    });
+
+    if (verifyResult.isValid) {
+      matchedXaIndex = index;
+      matchedXa = verifyResult.matches[0] || null;
+      break;
+    }
+  }
+
+  if (matchedXaIndex <= 0) {
+    return {
+      input,
+      soNha: "",
+      diaChi: parts.join(", "),
+      parts,
+      matchedXaIndex,
+      matchedXa,
+    };
+  }
+
+  return {
+    input,
+    soNha: parts.slice(0, matchedXaIndex).join(", "),
+    diaChi: parts.slice(matchedXaIndex).join(", "),
+    parts,
+    matchedXaIndex,
+    matchedXa,
+  };
+};
+
+// 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 = (input, ngayCap, options = {}) => {
+  const sourceText = `${input ?? ""}`;
+  const parsedQr = parseCccdQrString(sourceText);
+  const extractedText = extractCccdAddressText(sourceText);
+  const issueDate = normalizeCccdIssueDate(ngayCap || parsedQr?.ngayCap);
+  const parsedAddress = extractedText.toAddress({ ngayCap: issueDate, verifyXaName });
+  const convertedDiaChi = parsedAddress?.diaChi
+    ? convertDiaChiMoi(parsedAddress.diaChi, options)
+    : "";
+
+  return {
+    ...(parsedAddress || {}),
+    diaChi: convertedDiaChi,
+    data: {
+      ...(parsedAddress?.data || {}),
+      cccdText: sourceText,
+      cccdFields: parsedQr?.fields || [],
+      extractedText,
+      issueDate,
+      convertedDiaChi,
+    },
+  };
+};
+
+/**
+ * Nghiệp vụ chuẩn hóa địa chỉ hành chính cũ về format 2 cấp mới.
+ *
+ * Logic phần này được bê ra từ repo cũ, chỉ thay phần lấy dữ liệu sang `dataXa` local
+ * và giữ khả năng override bằng `options.dataXa` để tiện test/publish package.
+ */
+const convertDiaChiMoi = (diaChi2CapCu, options = {}) => {
+  const sourceDataXa = options.dataXa || dataXa;
+
+  if (typeof diaChi2CapCu === "string" && diaChi2CapCu.length <= 6) {
+    return diaChi2CapCu;
+  }
+
+  let diaChi = [];
+  const arr = splitAddressParts(diaChi2CapCu);
+
+  if (arr.length === 2) diaChi = [arr[0], arr[1]];
+  if (arr.length === 3) diaChi = [arr[0], arr[2]];
+  if (arr.length === 1) diaChi = [arr[0]];
+
+  const tinhCu = createUniqueText(diaChi[diaChi.length - 1] || "");
+  const xaCu = diaChi.length > 1 ? normalizeAdministrativeCode(diaChi[0]) : "";
+  const huyenCu = arr.length === 3 ? normalizeAdministrativeCode(arr[1]) : "";
+
+  const tinh = sourceDataXa.find(
+    (item) =>
+      tinhCu.indexOf(item.timKiem) !== -1 ||
+      item.dsTinh?.find((item2) => tinhCu.indexOf(item2.timKiem) !== -1)
+  );
+
+  if (!tinh) {
+    //nếu không có tỉnh, thì có thể đó là xã
+    return diaChi2CapCu;
+  }
+
+  let xa = null;
+  let dsXa = null;
+
+  //B1: Tìm kiếm theo tên tỉnh trước
+  if (!xaCu) {
+    /* có một số trường hợp Điện Biên Phủ, tỉnh Điện Biên 
+    nhập vào Điện Biên Phủ nhưng lại đang hiểu là tỉnh Điện Biên
+    trong trường hợp này thì thử tìm xem có xã nào trong tỉnh đó trùng với tên vừa nhập không      
+    */
+    xa = tinh.dsXa.find((item) =>
+      //khi đó tinhCu chính là xaCu
+      /^\d+$/.test(tinhCu) ? tinhCu === item.timKiem : tinhCu.indexOf(item.timKiem) !== -1
+    )?.ten;
+  }
+
+  //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
+  //Xuân Thành, Xuân Lộc, Đồng Nai -> Xuân Thành, Đồng Nai
+  //Xuân Thanh, Long Khánh, Đồng Nai -> Long Khánh, Đồng Nai
+  //Địa chỉ người dùng là Xuân Thanh, Long Khánh, Đồng Nai nhưng lại tìm ra Xuân Thành, Đồng Nai
+  //Vì tìm theo tên sau sát nhập vô tình lại trùng Xuân Thành, Đồng Nai vì xóa dấu rồi
+  //Nên để chắc chắn thì B2 này sẽ search thêm cả huyện (nếu có) trùng với huyện từ địa chỉ của người dùng
+  if (!xa) {
+    xa = xaCu
+      ? tinh.dsXa.find(
+          (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
+  }
+
+  //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
+  //Ở bước này thì cũng so sanh luôn nếu xã có thông tin huyện, vì trong 1 tỉnh có nhiều xã trùng tên nhau
+  //Trả ra danh sách xã, và sẽ ưu tiên xã nào trùng huyện, nếu không có thì lấy bản ghi đầu tiên tim được
+  if (!xa) {
+    //nếu không có xã nào trùng tên thì mới tìm kiếm các xã đã bị sát nhập tìm kiếm chính xác
+    //đầ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(
+            (item2) =>
+              xaCu === item2.timKiem &&
+              (!huyenCu || !item2.huyen || `${item2.huyen}`.indexOf(huyenCu) !== -1)
+          )
+        )
+      : [];
+
+    //nếu chỉ ra 1 kết quả thì trả về luôn
+    if (dsXa.length === 1) {
+      xa = dsXa[0].ten;
+    } else if (dsXa.length) {
+      //nếu có thông tin huyện
+      if (huyenCu) {
+        //thì ưu tiên xã nào trùng huyện
+        xa = dsXa.find((item) =>
+          item.satNhapTu.some(
+            (satNhapItem) =>
+              satNhapItem.huyen && `${satNhapItem.huyen}`.indexOf(huyenCu) !== -1
+          )
+        )?.ten;
+      }
+
+      //ngược lại thì trả về bản ghi đầu tiên
+      if (!xa) {
+        xa = dsXa[0]?.ten;
+      }
+    }
+  }
+
+  //B4: Nếu B3 không ra kết quả thì lúc này sẽ không tìm kiếm theo điều kiện huyện nữa
+  if (!xa) {
+    xa = xaCu
+      ? tinh.dsXa.find((item) =>
+          item.satNhapTu?.find((item2) => xaCu.indexOf(item2.timKiem) !== -1)
+        )?.ten
+      : "";
+  }
+
+  //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
+  }
+
+  return [xa, 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.
+const globalTarget =
+  typeof globalThis !== "undefined"
+    ? globalThis
+    : typeof window !== "undefined"
+      ? window
+      : typeof global !== "undefined"
+        ? global
+        : null;
+
+if (globalTarget) {
+  globalTarget.verifyXaName = verifyXaName;
+  globalTarget.splitAddressByValidXa = splitAddressByValidXa;
+  globalTarget.extractAndConvertCccdAddress = extractAndConvertCccdAddress;
+}
+
+module.exports = {
+  dataXa,
+  createUniqueText,
+  stripAdministrativePrefix,
+  normalizeAdministrativeCode,
+  convertDiaChiMoi,
+  verifyXaName,
+  splitAddressByValidXa,
+  parseCccdQrString,
+  normalizeCccdIssueDate,
+  extractCccdAddressText,
+  extractAndConvertCccdAddress,
+};

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@isofh/chuyen-doi-dia-chi-2-cap",
+  "version": "0.1.0",
+  "description": "Chuan hoa dia chi hanh chinh cu sang format 2 cap moi",
+  "main": "index.js",
+  "files": [
+    "index.js",
+    "dataXa.json",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "address",
+    "vietnam",
+    "administrative",
+    "isofh"
+  ],
+  "dependencies": {
+    "mainam-react-native-string-utils": "^4.0.12"
+  },
+  "author": "ISOFH",
+  "license": "ISC"
+}