tele_number_utils 1.0.0

package/dist/country/getCountry.d.ts

@@ -0,0 +1,9 @@
+export type Country = {
+    name: string;
+    dialingCode: string;
+    flagUrl: string;
+    alphaTwoCode: string;
+};
+/** Main function */
+export declare const getCountry: (number: string) => Country | string;
+//# sourceMappingURL=getCountry.d.ts.map

package/dist/country/getCountry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCountry.d.ts","sourceRoot":"","sources":["../../src/country/getCountry.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAgCF,oBAAoB;AACpB,eAAO,MAAM,UAAU,GAAI,QAAQ,MAAM,KAAG,OAAO,GAAG,MAwBrD,CAAC"}

package/dist/country/getCountry.js

@@ -0,0 +1,49 @@
+import { parsePhoneNumber } from "../parsed";
+import { country_list } from "./country";
+import { UK_COUNTRY_CODE, UK_DEPENDENCIES, CANADIAN_AREA_CODES, US_CANADA_COUNTRY_CODE, PUERTO_RICO_COUNTRY_CODE, } from "./util";
+/** Get country by alphaTwoCode */
+const getCountryByAlpha = (alpha) => country_list.find((c) => c.alphaTwoCode === alpha) || null;
+/** Get country by dialing code */
+const getCountryByDialingCode = (code) => country_list.find((c) => c.dialingCode.replace("+", "") === code) || null;
+/** Handle US & Canada numbers */
+const handleUSCanada = (nationalNumber) => {
+    const areaCode = nationalNumber.slice(0, 3);
+    if (PUERTO_RICO_COUNTRY_CODE.includes(areaCode))
+        return getCountryByAlpha("PR");
+    if (CANADIAN_AREA_CODES.includes(areaCode))
+        return getCountryByAlpha("CA");
+    return getCountryByAlpha("US");
+};
+/** Handle UK numbers, including dependencies */
+const handleUK = (nationalNumber) => {
+    const areaPrefix = nationalNumber.substring(0, 4);
+    const dependency = UK_DEPENDENCIES.find((d) => areaPrefix.startsWith(d.PREFIX));
+    return dependency
+        ? getCountryByAlpha(dependency.CODE)
+        : getCountryByAlpha("GB");
+};
+/** Main function */
+export const getCountry = (number) => {
+    try {
+        const parsed = parsePhoneNumber(number);
+        if (!parsed)
+            return "Invalid Phone number";
+        let matched = null;
+        switch (parsed.callingCode) {
+            case US_CANADA_COUNTRY_CODE:
+                matched = handleUSCanada(parsed.nationalNumber || "");
+                break;
+            case UK_COUNTRY_CODE:
+                matched = handleUK(parsed.nationalNumber || "");
+                break;
+            default:
+                matched =
+                    getCountryByAlpha(parsed.country || "") ||
+                        getCountryByDialingCode(parsed.callingCode || "");
+        }
+        return matched || "Country not found";
+    }
+    catch {
+        return "Invalid Phone number";
+    }
+};

package/dist/country/util.d.ts

@@ -0,0 +1,29 @@
+export declare const UK_COUNTRY_CODE = "44";
+export declare const UK_MAIN: {
+    CODE: string;
+    NAME: string;
+};
+export declare const ISLE_OF_MAN: {
+    CODE: string;
+    NAME: string;
+    PREFIX: string;
+};
+export declare const JERSEY: {
+    CODE: string;
+    NAME: string;
+    PREFIX: string;
+};
+export declare const GUERNSEY: {
+    CODE: string;
+    NAME: string;
+    PREFIX: string;
+};
+export declare const CANADIAN_AREA_CODES: string[];
+export declare const UK_DEPENDENCIES: {
+    CODE: string;
+    NAME: string;
+    PREFIX: string;
+}[];
+export declare const US_CANADA_COUNTRY_CODE = "1";
+export declare const PUERTO_RICO_COUNTRY_CODE: string[];
+//# sourceMappingURL=util.d.ts.map

package/dist/country/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/country/util.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,OAAO,CAAC;AAEpC,eAAO,MAAM,OAAO;;;CAGnB,CAAC;AAEF,eAAO,MAAM,WAAW;;;;CAIvB,CAAC;AAEF,eAAO,MAAM,MAAM;;;;CAIlB,CAAC;AAEF,eAAO,MAAM,QAAQ;;;;CAIpB,CAAC;AAEF,eAAO,MAAM,mBAAmB,UA4C/B,CAAC;AAEF,eAAO,MAAM,eAAe;;;;GAAkC,CAAC;AAE/D,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAC1C,eAAO,MAAM,wBAAwB,UAAiB,CAAC"}

package/dist/country/util.js

@@ -0,0 +1,68 @@
+export const UK_COUNTRY_CODE = "44";
+export const UK_MAIN = {
+    CODE: "GB",
+    NAME: "United Kingdom",
+};
+export const ISLE_OF_MAN = {
+    CODE: "IM",
+    NAME: "Isle of Man",
+    PREFIX: "1624",
+};
+export const JERSEY = {
+    CODE: "JE",
+    NAME: "Jersey",
+    PREFIX: "1534",
+};
+export const GUERNSEY = {
+    CODE: "GG",
+    NAME: "Guernsey",
+    PREFIX: "1481",
+};
+export const CANADIAN_AREA_CODES = [
+    "403",
+    "587",
+    "780",
+    "825",
+    "368",
+    "236",
+    "250",
+    "604",
+    "672",
+    "778",
+    "204",
+    "431",
+    "506",
+    "709",
+    "867",
+    "782",
+    "902",
+    "226",
+    "249",
+    "289",
+    "343",
+    "365",
+    "416",
+    "437",
+    "519",
+    "548",
+    "613",
+    "647",
+    "683",
+    "705",
+    "807",
+    "905",
+    "367",
+    "418",
+    "438",
+    "450",
+    "514",
+    "579",
+    "581",
+    "873",
+    "306",
+    "639",
+    "474",
+];
+export const UK_DEPENDENCIES = [ISLE_OF_MAN, JERSEY, GUERNSEY];
+export const US_CANADA_COUNTRY_CODE = "1";
+export const PUERTO_RICO_COUNTRY_CODE = ["787", "939"];

package/dist/formatter/index.d.ts

@@ -0,0 +1,10 @@
+type Separator = " " | "-" | "()";
+/**
+ * Formats a number string into groups dynamically
+ * @param value The input string (digits)
+ * @param groupSizes Array of group sizes, e.g., [3,3,4]
+ * @param separator Separator between groups: " ", "-", "/", "()" (default: " ")
+ */
+export declare const formatter: (value?: string, groupSizes?: number[], separator?: Separator) => string;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/formatter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/formatter/index.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;AAElC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GACpB,QAAO,MAAW,EAClB,aAAY,MAAM,EAAc,EAChC,YAAW,SAAe,KACzB,MA4BF,CAAC"}

package/dist/formatter/index.js

@@ -0,0 +1,32 @@
+/**
+ * Formats a number string into groups dynamically
+ * @param value The input string (digits)
+ * @param groupSizes Array of group sizes, e.g., [3,3,4]
+ * @param separator Separator between groups: " ", "-", "/", "()" (default: " ")
+ */
+export const formatter = (value = "", groupSizes = [3, 3, 4], separator = " ") => {
+    const digits = value.replace(/\D/g, ""); // remove non-digits
+    if (!digits)
+        return "";
+    // If length <= 6, return as-is
+    if (digits.length <= 6)
+        return digits;
+    const groups = [];
+    let start = 0;
+    for (let size of groupSizes) {
+        if (start >= digits.length)
+            break;
+        groups.push(digits.slice(start, start + size));
+        start += size;
+    }
+    // Remaining digits
+    if (start < digits.length) {
+        groups.push(digits.slice(start));
+    }
+    // Handle parentheses specially: wrap first group
+    if (separator === "()") {
+        const [first, ...rest] = groups;
+        return `(${first}) ${rest.join(" ")}`;
+    }
+    return groups.join(separator);
+};

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { parsePhoneNumber } from "./parsed";
+export { getCountry } from "./country/getCountry";
+export { formatter } from "./formatter";
+export { country_list } from "./country/country";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { parsePhoneNumber } from "./parsed";
+export { getCountry } from "./country/getCountry";
+export { formatter } from "./formatter";
+export { country_list } from "./country/country";

package/dist/parsed/index.d.ts

@@ -0,0 +1,36 @@
+export declare const countryCodeMap: Record<string, string>;
+export declare const NANPA_MAP: Record<string, string>;
+export declare const UK_COUNTRY_CODE = "44";
+export declare const UK_MAIN: {
+    CODE: string;
+    NAME: string;
+};
+export declare const ISLE_OF_MAN: {
+    CODE: string;
+    NAME: string;
+    PREFIX: string;
+};
+export declare const JERSEY: {
+    CODE: string;
+    NAME: string;
+    PREFIX: string;
+};
+export declare const GUERNSEY: {
+    CODE: string;
+    NAME: string;
+    PREFIX: string;
+};
+export declare const UK_DEPENDENCIES: {
+    CODE: string;
+    NAME: string;
+    PREFIX: string;
+}[];
+export declare const AUSTRALIAN_TERRITORIES: string[];
+export interface ParsedPhoneNumber {
+    country?: string;
+    callingCode?: string;
+    nationalNumber?: string;
+    formatted?: string;
+}
+export declare function parsePhoneNumber(phone: string): ParsedPhoneNumber;
+//# sourceMappingURL=index.d.ts.map

package/dist/parsed/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/parsed/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAgKjD,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwD5C,CAAC;AAEF,eAAO,MAAM,eAAe,OAAO,CAAC;AACpC,eAAO,MAAM,OAAO;;;CAAyC,CAAC;AAC9D,eAAO,MAAM,WAAW;;;;CAAsD,CAAC;AAC/E,eAAO,MAAM,MAAM;;;;CAAiD,CAAC;AACrE,eAAO,MAAM,QAAQ;;;;CAAmD,CAAC;AACzE,eAAO,MAAM,eAAe;;;;GAAkC,CAAC;AAE/D,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAE9C,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CAoDjE"}

package/dist/parsed/index.js

@@ -0,0 +1,275 @@
+export const countryCodeMap = {
+    "93": "AF",
+    "355": "AL",
+    "213": "DZ",
+    "1": "US",
+    "376": "AD",
+    "244": "AO",
+    "54": "AR",
+    "374": "AM",
+    "297": "AW",
+    "61": "AU",
+    "43": "AT",
+    "994": "AZ",
+    "973": "BH",
+    "880": "BD",
+    "32": "BE",
+    "501": "BZ",
+    "229": "BJ",
+    "975": "BT",
+    "591": "BO",
+    "387": "BA",
+    "267": "BW",
+    "55": "BR",
+    "359": "BG",
+    "226": "BF",
+    "257": "BI",
+    "855": "KH",
+    "237": "CM",
+    "238": "CV",
+    "236": "CF",
+    "235": "TD",
+    "56": "CL",
+    "86": "CN",
+    "57": "CO",
+    "269": "KM",
+    "243": "CD",
+    "242": "CG",
+    "682": "CK",
+    "506": "CR",
+    "225": "CI",
+    "385": "HR",
+    "53": "CU",
+    "357": "CY",
+    "420": "CZ",
+    "45": "DK",
+    "253": "DJ",
+    "593": "EC",
+    "20": "EG",
+    "503": "SV",
+    "240": "GQ",
+    "291": "ER",
+    "372": "EE",
+    "251": "ET",
+    "298": "FO",
+    "679": "FJ",
+    "358": "FI",
+    "33": "FR",
+    "594": "GF",
+    "689": "PF",
+    "241": "GA",
+    "220": "GM",
+    "995": "GE",
+    "49": "DE",
+    "233": "GH",
+    "350": "GI",
+    "30": "GR",
+    "502": "GT",
+    "224": "GN",
+    "245": "GW",
+    "592": "GY",
+    "509": "HT",
+    "504": "HN",
+    "852": "HK",
+    "36": "HU",
+    "354": "IS",
+    "91": "IN",
+    "62": "ID",
+    "98": "IR",
+    "964": "IQ",
+    "353": "IE",
+    "972": "IL",
+    "39": "IT",
+    "81": "JP",
+    "962": "JO",
+    "254": "KE",
+    "686": "KI",
+    "965": "KW",
+    "996": "KG",
+    "856": "LA",
+    "371": "LV",
+    "961": "LB",
+    "266": "LS",
+    "231": "LR",
+    "218": "LY",
+    "423": "LI",
+    "370": "LT",
+    "352": "LU",
+    "261": "MG",
+    "265": "MW",
+    "60": "MY",
+    "960": "MV",
+    "223": "ML",
+    "356": "MT",
+    "692": "MH",
+    "596": "MQ",
+    "222": "MR",
+    "230": "MU",
+    "52": "MX",
+    "691": "FM",
+    "373": "MD",
+    "377": "MC",
+    "976": "MN",
+    "382": "ME",
+    "212": "MA",
+    "258": "MZ",
+    "95": "MM",
+    "264": "NA",
+    "674": "NR",
+    "977": "NP",
+    "31": "NL",
+    "687": "NC",
+    "64": "NZ",
+    "505": "NI",
+    "227": "NE",
+    "234": "NG",
+    "683": "NU",
+    "672": "NF",
+    "47": "NO",
+    "968": "OM",
+    "92": "PK",
+    "680": "PW",
+    "507": "PA",
+    "675": "PG",
+    "595": "PY",
+    "51": "PE",
+    "63": "PH",
+    "48": "PL",
+    "351": "PT",
+    "974": "QA",
+    "40": "RO",
+    "7": "RU",
+    "250": "RW",
+    "290": "SH",
+    "216": "TN",
+    "90": "TR",
+    "993": "TM",
+    "688": "TV",
+    "256": "UG",
+    "380": "UA",
+    "971": "AE",
+    "44": "GB",
+    "598": "UY",
+    "998": "UZ",
+    "678": "VU",
+    "58": "VE",
+    "84": "VN",
+    "681": "WF",
+    "967": "YE",
+    "260": "ZM",
+    "263": "ZW",
+};
+export const NANPA_MAP = {
+    // Canada
+    "204": "CA",
+    "236": "CA",
+    "249": "CA",
+    "250": "CA",
+    "289": "CA",
+    "306": "CA",
+    "343": "CA",
+    "365": "CA",
+    "367": "CA",
+    "403": "CA",
+    "416": "CA",
+    "418": "CA",
+    "431": "CA",
+    "437": "CA",
+    "438": "CA",
+    "450": "CA",
+    "506": "CA",
+    "514": "CA",
+    "519": "CA",
+    "548": "CA",
+    "579": "CA",
+    "581": "CA",
+    "587": "CA",
+    "600": "CA",
+    "604": "CA",
+    "613": "CA",
+    "639": "CA",
+    "647": "CA",
+    "672": "CA",
+    "705": "CA",
+    "709": "CA",
+    "778": "CA",
+    "780": "CA",
+    "782": "CA",
+    "807": "CA",
+    "819": "CA",
+    "825": "CA",
+    "867": "CA",
+    "873": "CA",
+    "902": "CA",
+    // Puerto Rico
+    "787": "PR",
+    "939": "PR",
+    // US
+    "201": "US",
+    "202": "US",
+    "203": "US",
+    "212": "US",
+    "213": "US",
+    "312": "US",
+    "305": "US",
+    "415": "US",
+};
+export const UK_COUNTRY_CODE = "44";
+export const UK_MAIN = { CODE: "GB", NAME: "United Kingdom" };
+export const ISLE_OF_MAN = { CODE: "IM", NAME: "Isle of Man", PREFIX: "1624" };
+export const JERSEY = { CODE: "JE", NAME: "Jersey", PREFIX: "1534" };
+export const GUERNSEY = { CODE: "GG", NAME: "Guernsey", PREFIX: "1481" };
+export const UK_DEPENDENCIES = [ISLE_OF_MAN, JERSEY, GUERNSEY];
+export const AUSTRALIAN_TERRITORIES = ["672"]; // Norfolk, Christmas, Cocos
+export function parsePhoneNumber(phone) {
+    if (!phone?.startsWith("+"))
+        return { formatted: phone };
+    const digits = phone.slice(1);
+    let country;
+    let callingCode;
+    let nationalNumber = digits;
+    // Match 1-3 digit country code
+    for (let len = 3; len > 0; len--) {
+        const code = digits.slice(0, len);
+        if (countryCodeMap[code]) {
+            callingCode = code;
+            country = countryCodeMap[code];
+            nationalNumber = digits.slice(len);
+            break;
+        }
+    }
+    if (!country)
+        return { formatted: phone, nationalNumber: digits };
+    // Handle +1 NANPA
+    if (callingCode === "1" && nationalNumber.length >= 10) {
+        const areaCode = nationalNumber.slice(0, 3);
+        if (NANPA_MAP[areaCode])
+            country = NANPA_MAP[areaCode];
+        else
+            country = "US";
+    }
+    // Handle +44 UK dependencies
+    if (callingCode === UK_COUNTRY_CODE) {
+        for (const dep of UK_DEPENDENCIES) {
+            if (nationalNumber.startsWith(dep.PREFIX)) {
+                country = dep.CODE;
+                break;
+            }
+        }
+        if (!country)
+            country = UK_MAIN.CODE;
+    }
+    // Handle +672 Australian territories
+    if (AUSTRALIAN_TERRITORIES.includes(callingCode || "")) {
+        country = "AU";
+    }
+    // Handle +7 Russia/Kazakhstan
+    if (callingCode === "7") {
+        if (nationalNumber.startsWith("6"))
+            country = "KZ";
+        else
+            country = "RU";
+    }
+    const formatted = `+${callingCode} ${nationalNumber}`;
+    return { country, callingCode, nationalNumber, formatted };
+}

package/dist/parsed/test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/parsed/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/parsed/test.ts"],"names":[],"mappings":""}

package/dist/parsed/test.js

@@ -0,0 +1,30 @@
+import { parsePhoneNumber } from ".";
+// Test numbers
+const testNumbers = [
+    // ---- UK +44 ----
+    "+442071234567", // UK main
+    "+441632960123", // Isle of Man
+    "+441534123456", // Jersey
+    "+441481987654", // Guernsey
+    // ---- NANPA +1 ----
+    "+12015551234", // US
+    "+14165551234", // Canada
+    "+17875551234", // Puerto Rico
+    // ---- Russia / Kazakhstan +7 ----
+    "+79161234567", // Russia
+    "+76171234567", // Kazakhstan
+    // ---- Australian territories +672 ----
+    "+67212345678", // Australian external territory
+    // ---- Regular countries ----
+    "+919876543210", // India
+    "+4915123456789", // Germany
+    // ---- Edge cases ----
+    "4915123456789", // Missing +
+    "+999123456789", // Unknown code
+];
+// Run parser and log results
+console.log("===== Phone Number Parsing Test =====");
+for (const number of testNumbers) {
+    const parsed = parsePhoneNumber(number);
+    console.log(`${number} =>`, parsed);
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "tele_number_utils",
+  "version": "1.0.0",
+  "description": "",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "clean": "rm -rf dist",
+    "lint": "eslint 'src/**/*.{ts,tsx}'",
+    "format": "prettier --write 'src/**/*.{ts,tsx,js,json,md}'"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "@types/node": "^25.0.7",
+    "@typescript-eslint/eslint-plugin": "^8.53.0",
+    "@typescript-eslint/parser": "^8.53.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^3.7.4",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
+  }
+}