@nexim/sanitizer 1.1.1 → 1.1.3

package/CHANGELOG.md

@@ -3,6 +3,14 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.1.3](https://github.com/the-nexim/nanolib/compare/@nexim/sanitizer@1.1.2...@nexim/sanitizer@1.1.3) (2025-11-22)
+
+**Note:** Version bump only for package @nexim/sanitizer
+
+## [1.1.2](https://github.com/the-nexim/nanolib/compare/@nexim/sanitizer@1.1.1...@nexim/sanitizer@1.1.2) (2025-08-30)
+
+**Note:** Version bump only for package @nexim/sanitizer
+
 ## [1.1.1](https://github.com/the-nexim/nanolib/compare/@nexim/sanitizer@1.1.0...@nexim/sanitizer@1.1.1) (2025-08-19)
 
 **Note:** Version bump only for package @nexim/sanitizer

package/dist/main.cjs

@@ -1,96 +1,4 @@
-/* @nexim/sanitizer v1.1.1 */
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/main.ts
-var main_exports = {};
-__export(main_exports, {
-  sanitizeNumberStringToEnglish: () => sanitizeNumberStringToEnglish,
-  sanitizeNumberToEnglish: () => sanitizeNumberToEnglish,
-  sanitizePhoneNumber: () => sanitizePhoneNumber
-});
-module.exports = __toCommonJS(main_exports);
-var import_is_number = require("@alwatr/is-number");
-var import_logger = require("@alwatr/logger");
-var import_package_tracer = require("@alwatr/package-tracer");
-var import_unicode_digits = require("@alwatr/unicode-digits");
-__dev_mode__: import_package_tracer.packageTracer.add("@nexim/sanitizer", "1.1.1");
-var logger = (0, import_logger.createLogger)("@nexim/sanitizer");
-var unicodeDigits = new import_unicode_digits.UnicodeDigits("en");
-function sanitizeNumberToEnglish(number) {
-  if (typeof number === "number") {
-    return number;
-  }
-  if (typeof number === "string") {
-    let str = number.trim();
-    if (str === "") {
-      logger.incident?.("sanitizeNumberToEnglish", "empty_string", { number });
-      return null;
-    }
-    str = unicodeDigits.translate(str);
-    if (!(0, import_is_number.isNumber)(str)) {
-      logger.incident?.("sanitizeNumberToEnglish", "not_a_number", { number });
-      return null;
-    }
-    return +str;
-  }
-  logger.incident?.("sanitizeNumberToEnglish", "invalid_input", { number });
-  return null;
-}
-function sanitizeNumberStringToEnglish(number) {
-  if (typeof number === "number") {
-    return String(number);
-  }
-  if (typeof number === "string") {
-    let str = number.trim();
-    if (str === "") {
-      logger.incident?.("sanitizeNumberStringToEnglish", "empty_string", { number });
-      return null;
-    }
-    str = unicodeDigits.translate(str);
-    if (!(0, import_is_number.isNumber)(str)) {
-      logger.incident?.("sanitizeNumberStringToEnglish", "not_a_number", { number });
-      return null;
-    }
-    return str;
-  }
-  logger.incident?.("sanitizeNumberStringToEnglish", "invalid_input", { number });
-  return null;
-}
-function sanitizePhoneNumber(input, countryCode = "98") {
-  if (input == null) {
-    logger.incident?.("sanitizePhoneNumber", "undefined_or_null_input", { input });
-    return null;
-  }
-  const inputStr = typeof input === "string" ? input.trim() : String(input);
-  if (inputStr === "") {
-    logger.incident?.("sanitizePhoneNumber", "empty_input_string", { input });
-    return null;
-  }
-  const englishDigits = unicodeDigits.translate(inputStr);
-  const withoutSpecialChars = englishDigits.replace(/[ )(-]+/g, "");
-  const cleanNumber = withoutSpecialChars.replace(new RegExp(`^(\\+${countryCode}|${countryCode}|^0)`), "");
-  const fullNumber = countryCode + cleanNumber;
-  if (fullNumber.length !== countryCode.length + 10 || !(0, import_is_number.isNumber)(fullNumber)) {
-    logger.incident?.("sanitizePhoneNumber", "invalid_full_number", { fullNumber });
-    return null;
-  }
-  return +fullNumber;
-}
+/** 📦 @nexim/sanitizer v1.1.3 */
+__dev_mode__: console.debug("📦 @nexim/sanitizer v1.1.3");
+"use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:true})};var __copyProps=(to,from,except,desc)=>{if(from&&typeof from==="object"||typeof from==="function"){for(let key of __getOwnPropNames(from))if(!__hasOwnProp.call(to,key)&&key!==except)__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable})}return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:true}),mod);var main_exports={};__export(main_exports,{sanitizeNumberStringToEnglish:()=>sanitizeNumberStringToEnglish,sanitizeNumberToEnglish:()=>sanitizeNumberToEnglish,sanitizePhoneNumber:()=>sanitizePhoneNumber});module.exports=__toCommonJS(main_exports);var import_is_number=require("@alwatr/is-number");var import_logger=require("@alwatr/logger");var import_package_tracer=require("@alwatr/package-tracer");var import_unicode_digits=require("@alwatr/unicode-digits");__dev_mode__:import_package_tracer.packageTracer.add("@nexim/sanitizer","1.1.3");var logger=(0,import_logger.createLogger)("@nexim/sanitizer");var unicodeDigits=new import_unicode_digits.UnicodeDigits("en");function sanitizeNumberToEnglish(number){if(typeof number==="number"){return number}if(typeof number==="string"){let str=number.trim();if(str===""){logger.incident?.("sanitizeNumberToEnglish","empty_string",{number});return null}str=unicodeDigits.translate(str);if(!(0,import_is_number.isNumber)(str)){logger.incident?.("sanitizeNumberToEnglish","not_a_number",{number});return null}return+str}logger.incident?.("sanitizeNumberToEnglish","invalid_input",{number});return null}function sanitizeNumberStringToEnglish(number){if(typeof number==="number"){return String(number)}if(typeof number==="string"){let str=number.trim();if(str===""){logger.incident?.("sanitizeNumberStringToEnglish","empty_string",{number});return null}str=unicodeDigits.translate(str);if(!(0,import_is_number.isNumber)(str)){logger.incident?.("sanitizeNumberStringToEnglish","not_a_number",{number});return null}return str}logger.incident?.("sanitizeNumberStringToEnglish","invalid_input",{number});return null}function sanitizePhoneNumber(input,countryCode="98"){if(input==null){logger.incident?.("sanitizePhoneNumber","undefined_or_null_input",{input});return null}const inputStr=typeof input==="string"?input.trim():String(input);if(inputStr===""){logger.incident?.("sanitizePhoneNumber","empty_input_string",{input});return null}const englishDigits=unicodeDigits.translate(inputStr);const withoutSpecialChars=englishDigits.replace(/[ )(-]+/g,"");const cleanNumber=withoutSpecialChars.replace(new RegExp(`^(\\+${countryCode}|${countryCode}|^0)`),"");const fullNumber=countryCode+cleanNumber;if(fullNumber.length!==countryCode.length+10||!(0,import_is_number.isNumber)(fullNumber)){logger.incident?.("sanitizePhoneNumber","invalid_full_number",{fullNumber});return null}return+fullNumber}
 //# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/main.ts"],
   "sourcesContent": ["import { isNumber } from '@alwatr/is-number';\nimport { createLogger } from '@alwatr/logger';\nimport { packageTracer } from '@alwatr/package-tracer';\nimport { UnicodeDigits } from '@alwatr/unicode-digits';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nconst logger = createLogger(__package_name__);\nconst unicodeDigits = new UnicodeDigits('en');\n\n/**\n * Sanitizes a number to English format. If input is already a number, returns it as-is.\n * If input is a string, converts Unicode digits to English and validates it's a valid number.\n *\n * @param number - The input to sanitize (number or string)\n * @returns The sanitized number or string, or null if invalid\n *\n * @example\n * ```ts\n * sanitizeNumberToEnglish(123); // returns 123\n * sanitizeNumberToEnglish('۱۲۳'); // returns '123'\n * sanitizeNumberToEnglish('abc'); // returns null\n * ```\n */\nexport function sanitizeNumberToEnglish(number: number): number;\nexport function sanitizeNumberToEnglish<T>(number: T): number | null;\nexport function sanitizeNumberToEnglish(number: unknown): number | null {\n  // logger.logMethodArgs?.('sanitizeNumberToEnglish', { number });\n\n  if (typeof number === 'number') {\n    return number;\n  }\n\n  if (typeof number === 'string') {\n    let str = number.trim();\n    if (str === '') {\n      logger.incident?.('sanitizeNumberToEnglish', 'empty_string', { number });\n      return null;\n    }\n\n    str = unicodeDigits.translate(str);\n    if (!isNumber(str)) {\n      logger.incident?.('sanitizeNumberToEnglish', 'not_a_number', { number });\n      return null;\n    }\n\n    return +str;\n  }\n\n  logger.incident?.('sanitizeNumberToEnglish', 'invalid_input', { number });\n  return null;\n}\n\n/**\n * Sanitizes a number to English string format, preserving leading zeros.\n * If input is a string, converts Unicode digits to English and validates it's a valid number.\n * If input is already a number, converts it to string.\n *\n * @param number - The input to sanitize (number or string)\n * @returns The sanitized number as string, or null if invalid\n *\n * @example\n * ```ts\n * sanitizeNumberStringToEnglish(123); // returns '123'\n * sanitizeNumberStringToEnglish('۰۱۲۳'); // returns '0123' (preserves leading zero)\n * sanitizeNumberStringToEnglish('abc'); // returns null\n * ```\n */\nexport function sanitizeNumberStringToEnglish<T>(number: T): string | null;\nexport function sanitizeNumberStringToEnglish(number: unknown): string | null {\n  // logger.logMethodArgs?.('sanitizeNumberStringToEnglish', { number });\n\n  if (typeof number === 'number') {\n    return String(number);\n  }\n\n  if (typeof number === 'string') {\n    let str = number.trim();\n    if (str === '') {\n      logger.incident?.('sanitizeNumberStringToEnglish', 'empty_string', { number });\n      return null;\n    }\n\n    str = unicodeDigits.translate(str);\n    if (!isNumber(str)) {\n      logger.incident?.('sanitizeNumberStringToEnglish', 'not_a_number', { number });\n      return null;\n    }\n\n    return str; // Return string to preserve leading zeros\n  }\n\n  logger.incident?.('sanitizeNumberStringToEnglish', 'invalid_input', { number });\n  return null;\n}\n\n/**\n * Sanitizes a phone number by converting Unicode digits, removing special characters,\n * and standardizing the format with country code.\n *\n * @param input - The phone number input to sanitize\n * @param countryCode - The country code to apply (default: '98' for Iran)\n * @returns The sanitized phone number as a number, or null if invalid\n *\n * @example\n * ```ts\n * sanitizePhoneNumber('09123456789'); // returns 989123456789\n * sanitizePhoneNumber('+98 912 345 6789'); // returns 989123456789\n * sanitizePhoneNumber('۰۹۱۲۳۴۵۶۷۸۹'); // returns 989123456789\n * sanitizePhoneNumber('invalid'); // returns null\n * ```\n */\nexport function sanitizePhoneNumber(input: unknown, countryCode = '98'): number | null {\n  // logger.logMethodArgs?.('sanitizePhoneNumber', { input, countryCode });\n\n  if (input == null) {\n    logger.incident?.('sanitizePhoneNumber', 'undefined_or_null_input', { input });\n    return null;\n  }\n\n  const inputStr = typeof input === 'string' ? input.trim() : String(input);\n\n  if (inputStr === '') {\n    logger.incident?.('sanitizePhoneNumber', 'empty_input_string', { input });\n    return null;\n  }\n\n  const englishDigits = unicodeDigits.translate(inputStr);\n  const withoutSpecialChars = englishDigits.replace(/[ )(-]+/g, '');\n  const cleanNumber = withoutSpecialChars.replace(new RegExp(`^(\\\\+${countryCode}|${countryCode}|^0)`), '');\n  const fullNumber = countryCode + cleanNumber;\n\n  if (fullNumber.length !== countryCode.length + 10 || !isNumber(fullNumber)) {\n    logger.incident?.('sanitizePhoneNumber', 'invalid_full_number', { fullNumber });\n    return null;\n  }\n\n  return +fullNumber;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAAyB;AACzB,oBAA6B;AAC7B,4BAA8B;AAC9B,4BAA8B;AAE9B,aAAc,qCAAc,IAAI,oBAAkB,OAAmB;AAErE,IAAM,aAAS,4BAAa,kBAAgB;AAC5C,IAAM,gBAAgB,IAAI,oCAAc,IAAI;AAkBrC,SAAS,wBAAwB,QAAgC;AAGtE,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,WAAW,UAAU;AAC9B,QAAI,MAAM,OAAO,KAAK;AACtB,QAAI,QAAQ,IAAI;AACd,aAAO,WAAW,2BAA2B,gBAAgB,EAAE,OAAO,CAAC;AACvE,aAAO;AAAA,IACT;AAEA,UAAM,cAAc,UAAU,GAAG;AACjC,QAAI,KAAC,2BAAS,GAAG,GAAG;AAClB,aAAO,WAAW,2BAA2B,gBAAgB,EAAE,OAAO,CAAC;AACvE,aAAO;AAAA,IACT;AAEA,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,WAAW,2BAA2B,iBAAiB,EAAE,OAAO,CAAC;AACxE,SAAO;AACT;AAkBO,SAAS,8BAA8B,QAAgC;AAG5E,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO,OAAO,MAAM;AAAA,EACtB;AAEA,MAAI,OAAO,WAAW,UAAU;AAC9B,QAAI,MAAM,OAAO,KAAK;AACtB,QAAI,QAAQ,IAAI;AACd,aAAO,WAAW,iCAAiC,gBAAgB,EAAE,OAAO,CAAC;AAC7E,aAAO;AAAA,IACT;AAEA,UAAM,cAAc,UAAU,GAAG;AACjC,QAAI,KAAC,2BAAS,GAAG,GAAG;AAClB,aAAO,WAAW,iCAAiC,gBAAgB,EAAE,OAAO,CAAC;AAC7E,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAEA,SAAO,WAAW,iCAAiC,iBAAiB,EAAE,OAAO,CAAC;AAC9E,SAAO;AACT;AAkBO,SAAS,oBAAoB,OAAgB,cAAc,MAAqB;AAGrF,MAAI,SAAS,MAAM;AACjB,WAAO,WAAW,uBAAuB,2BAA2B,EAAE,MAAM,CAAC;AAC7E,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI,OAAO,KAAK;AAExE,MAAI,aAAa,IAAI;AACnB,WAAO,WAAW,uBAAuB,sBAAsB,EAAE,MAAM,CAAC;AACxE,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,cAAc,UAAU,QAAQ;AACtD,QAAM,sBAAsB,cAAc,QAAQ,YAAY,EAAE;AAChE,QAAM,cAAc,oBAAoB,QAAQ,IAAI,OAAO,QAAQ,WAAW,IAAI,WAAW,MAAM,GAAG,EAAE;AACxG,QAAM,aAAa,cAAc;AAEjC,MAAI,WAAW,WAAW,YAAY,SAAS,MAAM,KAAC,2BAAS,UAAU,GAAG;AAC1E,WAAO,WAAW,uBAAuB,uBAAuB,EAAE,WAAW,CAAC;AAC9E,WAAO;AAAA,EACT;AAEA,SAAO,CAAC;AACV;",
+  "mappings": ";;qqBAAA,4QAAyB,6BACzB,kBAA6B,0BAC7B,0BAA8B,kCAC9B,0BAA8B,kCAE9B,aAAc,oCAAc,IAAI,mBAAkB,OAAmB,EAErE,IAAM,UAAS,4BAAa,kBAAgB,EAC5C,IAAM,cAAgB,IAAI,oCAAc,IAAI,EAkBrC,SAAS,wBAAwB,OAAgC,CAGtE,GAAI,OAAO,SAAW,SAAU,CAC9B,OAAO,MACT,CAEA,GAAI,OAAO,SAAW,SAAU,CAC9B,IAAI,IAAM,OAAO,KAAK,EACtB,GAAI,MAAQ,GAAI,CACd,OAAO,WAAW,0BAA2B,eAAgB,CAAE,MAAO,CAAC,EACvE,OAAO,IACT,CAEA,IAAM,cAAc,UAAU,GAAG,EACjC,GAAI,IAAC,2BAAS,GAAG,EAAG,CAClB,OAAO,WAAW,0BAA2B,eAAgB,CAAE,MAAO,CAAC,EACvE,OAAO,IACT,CAEA,MAAO,CAAC,GACV,CAEA,OAAO,WAAW,0BAA2B,gBAAiB,CAAE,MAAO,CAAC,EACxE,OAAO,IACT,CAkBO,SAAS,8BAA8B,OAAgC,CAG5E,GAAI,OAAO,SAAW,SAAU,CAC9B,OAAO,OAAO,MAAM,CACtB,CAEA,GAAI,OAAO,SAAW,SAAU,CAC9B,IAAI,IAAM,OAAO,KAAK,EACtB,GAAI,MAAQ,GAAI,CACd,OAAO,WAAW,gCAAiC,eAAgB,CAAE,MAAO,CAAC,EAC7E,OAAO,IACT,CAEA,IAAM,cAAc,UAAU,GAAG,EACjC,GAAI,IAAC,2BAAS,GAAG,EAAG,CAClB,OAAO,WAAW,gCAAiC,eAAgB,CAAE,MAAO,CAAC,EAC7E,OAAO,IACT,CAEA,OAAO,GACT,CAEA,OAAO,WAAW,gCAAiC,gBAAiB,CAAE,MAAO,CAAC,EAC9E,OAAO,IACT,CAkBO,SAAS,oBAAoB,MAAgB,YAAc,KAAqB,CAGrF,GAAI,OAAS,KAAM,CACjB,OAAO,WAAW,sBAAuB,0BAA2B,CAAE,KAAM,CAAC,EAC7E,OAAO,IACT,CAEA,MAAM,SAAW,OAAO,QAAU,SAAW,MAAM,KAAK,EAAI,OAAO,KAAK,EAExE,GAAI,WAAa,GAAI,CACnB,OAAO,WAAW,sBAAuB,qBAAsB,CAAE,KAAM,CAAC,EACxE,OAAO,IACT,CAEA,MAAM,cAAgB,cAAc,UAAU,QAAQ,EACtD,MAAM,oBAAsB,cAAc,QAAQ,WAAY,EAAE,EAChE,MAAM,YAAc,oBAAoB,QAAQ,IAAI,OAAO,QAAQ,WAAW,IAAI,WAAW,MAAM,EAAG,EAAE,EACxG,MAAM,WAAa,YAAc,YAEjC,GAAI,WAAW,SAAW,YAAY,OAAS,IAAM,IAAC,2BAAS,UAAU,EAAG,CAC1E,OAAO,WAAW,sBAAuB,sBAAuB,CAAE,UAAW,CAAC,EAC9E,OAAO,IACT,CAEA,MAAO,CAAC,UACV",
   "names": []
 }

package/dist/main.mjs

@@ -1,76 +1,4 @@
-/* @nexim/sanitizer v1.1.1 */
-
-// src/main.ts
-import { isNumber } from "@alwatr/is-number";
-import { createLogger } from "@alwatr/logger";
-import { packageTracer } from "@alwatr/package-tracer";
-import { UnicodeDigits } from "@alwatr/unicode-digits";
-__dev_mode__: packageTracer.add("@nexim/sanitizer", "1.1.1");
-var logger = createLogger("@nexim/sanitizer");
-var unicodeDigits = new UnicodeDigits("en");
-function sanitizeNumberToEnglish(number) {
-  if (typeof number === "number") {
-    return number;
-  }
-  if (typeof number === "string") {
-    let str = number.trim();
-    if (str === "") {
-      logger.incident?.("sanitizeNumberToEnglish", "empty_string", { number });
-      return null;
-    }
-    str = unicodeDigits.translate(str);
-    if (!isNumber(str)) {
-      logger.incident?.("sanitizeNumberToEnglish", "not_a_number", { number });
-      return null;
-    }
-    return +str;
-  }
-  logger.incident?.("sanitizeNumberToEnglish", "invalid_input", { number });
-  return null;
-}
-function sanitizeNumberStringToEnglish(number) {
-  if (typeof number === "number") {
-    return String(number);
-  }
-  if (typeof number === "string") {
-    let str = number.trim();
-    if (str === "") {
-      logger.incident?.("sanitizeNumberStringToEnglish", "empty_string", { number });
-      return null;
-    }
-    str = unicodeDigits.translate(str);
-    if (!isNumber(str)) {
-      logger.incident?.("sanitizeNumberStringToEnglish", "not_a_number", { number });
-      return null;
-    }
-    return str;
-  }
-  logger.incident?.("sanitizeNumberStringToEnglish", "invalid_input", { number });
-  return null;
-}
-function sanitizePhoneNumber(input, countryCode = "98") {
-  if (input == null) {
-    logger.incident?.("sanitizePhoneNumber", "undefined_or_null_input", { input });
-    return null;
-  }
-  const inputStr = typeof input === "string" ? input.trim() : String(input);
-  if (inputStr === "") {
-    logger.incident?.("sanitizePhoneNumber", "empty_input_string", { input });
-    return null;
-  }
-  const englishDigits = unicodeDigits.translate(inputStr);
-  const withoutSpecialChars = englishDigits.replace(/[ )(-]+/g, "");
-  const cleanNumber = withoutSpecialChars.replace(new RegExp(`^(\\+${countryCode}|${countryCode}|^0)`), "");
-  const fullNumber = countryCode + cleanNumber;
-  if (fullNumber.length !== countryCode.length + 10 || !isNumber(fullNumber)) {
-    logger.incident?.("sanitizePhoneNumber", "invalid_full_number", { fullNumber });
-    return null;
-  }
-  return +fullNumber;
-}
-export {
-  sanitizeNumberStringToEnglish,
-  sanitizeNumberToEnglish,
-  sanitizePhoneNumber
-};
+/** 📦 @nexim/sanitizer v1.1.3 */
+__dev_mode__: console.debug("📦 @nexim/sanitizer v1.1.3");
+import{isNumber}from"@alwatr/is-number";import{createLogger}from"@alwatr/logger";import{packageTracer}from"@alwatr/package-tracer";import{UnicodeDigits}from"@alwatr/unicode-digits";__dev_mode__:packageTracer.add("@nexim/sanitizer","1.1.3");var logger=createLogger("@nexim/sanitizer");var unicodeDigits=new UnicodeDigits("en");function sanitizeNumberToEnglish(number){if(typeof number==="number"){return number}if(typeof number==="string"){let str=number.trim();if(str===""){logger.incident?.("sanitizeNumberToEnglish","empty_string",{number});return null}str=unicodeDigits.translate(str);if(!isNumber(str)){logger.incident?.("sanitizeNumberToEnglish","not_a_number",{number});return null}return+str}logger.incident?.("sanitizeNumberToEnglish","invalid_input",{number});return null}function sanitizeNumberStringToEnglish(number){if(typeof number==="number"){return String(number)}if(typeof number==="string"){let str=number.trim();if(str===""){logger.incident?.("sanitizeNumberStringToEnglish","empty_string",{number});return null}str=unicodeDigits.translate(str);if(!isNumber(str)){logger.incident?.("sanitizeNumberStringToEnglish","not_a_number",{number});return null}return str}logger.incident?.("sanitizeNumberStringToEnglish","invalid_input",{number});return null}function sanitizePhoneNumber(input,countryCode="98"){if(input==null){logger.incident?.("sanitizePhoneNumber","undefined_or_null_input",{input});return null}const inputStr=typeof input==="string"?input.trim():String(input);if(inputStr===""){logger.incident?.("sanitizePhoneNumber","empty_input_string",{input});return null}const englishDigits=unicodeDigits.translate(inputStr);const withoutSpecialChars=englishDigits.replace(/[ )(-]+/g,"");const cleanNumber=withoutSpecialChars.replace(new RegExp(`^(\\+${countryCode}|${countryCode}|^0)`),"");const fullNumber=countryCode+cleanNumber;if(fullNumber.length!==countryCode.length+10||!isNumber(fullNumber)){logger.incident?.("sanitizePhoneNumber","invalid_full_number",{fullNumber});return null}return+fullNumber}export{sanitizeNumberStringToEnglish,sanitizeNumberToEnglish,sanitizePhoneNumber};
 //# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -2,6 +2,6 @@
   "version": 3,
   "sources": ["../src/main.ts"],
   "sourcesContent": ["import { isNumber } from '@alwatr/is-number';\nimport { createLogger } from '@alwatr/logger';\nimport { packageTracer } from '@alwatr/package-tracer';\nimport { UnicodeDigits } from '@alwatr/unicode-digits';\n\n__dev_mode__: packageTracer.add(__package_name__, __package_version__);\n\nconst logger = createLogger(__package_name__);\nconst unicodeDigits = new UnicodeDigits('en');\n\n/**\n * Sanitizes a number to English format. If input is already a number, returns it as-is.\n * If input is a string, converts Unicode digits to English and validates it's a valid number.\n *\n * @param number - The input to sanitize (number or string)\n * @returns The sanitized number or string, or null if invalid\n *\n * @example\n * ```ts\n * sanitizeNumberToEnglish(123); // returns 123\n * sanitizeNumberToEnglish('۱۲۳'); // returns '123'\n * sanitizeNumberToEnglish('abc'); // returns null\n * ```\n */\nexport function sanitizeNumberToEnglish(number: number): number;\nexport function sanitizeNumberToEnglish<T>(number: T): number | null;\nexport function sanitizeNumberToEnglish(number: unknown): number | null {\n  // logger.logMethodArgs?.('sanitizeNumberToEnglish', { number });\n\n  if (typeof number === 'number') {\n    return number;\n  }\n\n  if (typeof number === 'string') {\n    let str = number.trim();\n    if (str === '') {\n      logger.incident?.('sanitizeNumberToEnglish', 'empty_string', { number });\n      return null;\n    }\n\n    str = unicodeDigits.translate(str);\n    if (!isNumber(str)) {\n      logger.incident?.('sanitizeNumberToEnglish', 'not_a_number', { number });\n      return null;\n    }\n\n    return +str;\n  }\n\n  logger.incident?.('sanitizeNumberToEnglish', 'invalid_input', { number });\n  return null;\n}\n\n/**\n * Sanitizes a number to English string format, preserving leading zeros.\n * If input is a string, converts Unicode digits to English and validates it's a valid number.\n * If input is already a number, converts it to string.\n *\n * @param number - The input to sanitize (number or string)\n * @returns The sanitized number as string, or null if invalid\n *\n * @example\n * ```ts\n * sanitizeNumberStringToEnglish(123); // returns '123'\n * sanitizeNumberStringToEnglish('۰۱۲۳'); // returns '0123' (preserves leading zero)\n * sanitizeNumberStringToEnglish('abc'); // returns null\n * ```\n */\nexport function sanitizeNumberStringToEnglish<T>(number: T): string | null;\nexport function sanitizeNumberStringToEnglish(number: unknown): string | null {\n  // logger.logMethodArgs?.('sanitizeNumberStringToEnglish', { number });\n\n  if (typeof number === 'number') {\n    return String(number);\n  }\n\n  if (typeof number === 'string') {\n    let str = number.trim();\n    if (str === '') {\n      logger.incident?.('sanitizeNumberStringToEnglish', 'empty_string', { number });\n      return null;\n    }\n\n    str = unicodeDigits.translate(str);\n    if (!isNumber(str)) {\n      logger.incident?.('sanitizeNumberStringToEnglish', 'not_a_number', { number });\n      return null;\n    }\n\n    return str; // Return string to preserve leading zeros\n  }\n\n  logger.incident?.('sanitizeNumberStringToEnglish', 'invalid_input', { number });\n  return null;\n}\n\n/**\n * Sanitizes a phone number by converting Unicode digits, removing special characters,\n * and standardizing the format with country code.\n *\n * @param input - The phone number input to sanitize\n * @param countryCode - The country code to apply (default: '98' for Iran)\n * @returns The sanitized phone number as a number, or null if invalid\n *\n * @example\n * ```ts\n * sanitizePhoneNumber('09123456789'); // returns 989123456789\n * sanitizePhoneNumber('+98 912 345 6789'); // returns 989123456789\n * sanitizePhoneNumber('۰۹۱۲۳۴۵۶۷۸۹'); // returns 989123456789\n * sanitizePhoneNumber('invalid'); // returns null\n * ```\n */\nexport function sanitizePhoneNumber(input: unknown, countryCode = '98'): number | null {\n  // logger.logMethodArgs?.('sanitizePhoneNumber', { input, countryCode });\n\n  if (input == null) {\n    logger.incident?.('sanitizePhoneNumber', 'undefined_or_null_input', { input });\n    return null;\n  }\n\n  const inputStr = typeof input === 'string' ? input.trim() : String(input);\n\n  if (inputStr === '') {\n    logger.incident?.('sanitizePhoneNumber', 'empty_input_string', { input });\n    return null;\n  }\n\n  const englishDigits = unicodeDigits.translate(inputStr);\n  const withoutSpecialChars = englishDigits.replace(/[ )(-]+/g, '');\n  const cleanNumber = withoutSpecialChars.replace(new RegExp(`^(\\\\+${countryCode}|${countryCode}|^0)`), '');\n  const fullNumber = countryCode + cleanNumber;\n\n  if (fullNumber.length !== countryCode.length + 10 || !isNumber(fullNumber)) {\n    logger.incident?.('sanitizePhoneNumber', 'invalid_full_number', { fullNumber });\n    return null;\n  }\n\n  return +fullNumber;\n}\n"],
-  "mappings": ";;;AAAA,SAAS,gBAAgB;AACzB,SAAS,oBAAoB;AAC7B,SAAS,qBAAqB;AAC9B,SAAS,qBAAqB;AAE9B,aAAc,eAAc,IAAI,oBAAkB,OAAmB;AAErE,IAAM,SAAS,aAAa,kBAAgB;AAC5C,IAAM,gBAAgB,IAAI,cAAc,IAAI;AAkBrC,SAAS,wBAAwB,QAAgC;AAGtE,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,WAAW,UAAU;AAC9B,QAAI,MAAM,OAAO,KAAK;AACtB,QAAI,QAAQ,IAAI;AACd,aAAO,WAAW,2BAA2B,gBAAgB,EAAE,OAAO,CAAC;AACvE,aAAO;AAAA,IACT;AAEA,UAAM,cAAc,UAAU,GAAG;AACjC,QAAI,CAAC,SAAS,GAAG,GAAG;AAClB,aAAO,WAAW,2BAA2B,gBAAgB,EAAE,OAAO,CAAC;AACvE,aAAO;AAAA,IACT;AAEA,WAAO,CAAC;AAAA,EACV;AAEA,SAAO,WAAW,2BAA2B,iBAAiB,EAAE,OAAO,CAAC;AACxE,SAAO;AACT;AAkBO,SAAS,8BAA8B,QAAgC;AAG5E,MAAI,OAAO,WAAW,UAAU;AAC9B,WAAO,OAAO,MAAM;AAAA,EACtB;AAEA,MAAI,OAAO,WAAW,UAAU;AAC9B,QAAI,MAAM,OAAO,KAAK;AACtB,QAAI,QAAQ,IAAI;AACd,aAAO,WAAW,iCAAiC,gBAAgB,EAAE,OAAO,CAAC;AAC7E,aAAO;AAAA,IACT;AAEA,UAAM,cAAc,UAAU,GAAG;AACjC,QAAI,CAAC,SAAS,GAAG,GAAG;AAClB,aAAO,WAAW,iCAAiC,gBAAgB,EAAE,OAAO,CAAC;AAC7E,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAEA,SAAO,WAAW,iCAAiC,iBAAiB,EAAE,OAAO,CAAC;AAC9E,SAAO;AACT;AAkBO,SAAS,oBAAoB,OAAgB,cAAc,MAAqB;AAGrF,MAAI,SAAS,MAAM;AACjB,WAAO,WAAW,uBAAuB,2BAA2B,EAAE,MAAM,CAAC;AAC7E,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI,OAAO,KAAK;AAExE,MAAI,aAAa,IAAI;AACnB,WAAO,WAAW,uBAAuB,sBAAsB,EAAE,MAAM,CAAC;AACxE,WAAO;AAAA,EACT;AAEA,QAAM,gBAAgB,cAAc,UAAU,QAAQ;AACtD,QAAM,sBAAsB,cAAc,QAAQ,YAAY,EAAE;AAChE,QAAM,cAAc,oBAAoB,QAAQ,IAAI,OAAO,QAAQ,WAAW,IAAI,WAAW,MAAM,GAAG,EAAE;AACxG,QAAM,aAAa,cAAc;AAEjC,MAAI,WAAW,WAAW,YAAY,SAAS,MAAM,CAAC,SAAS,UAAU,GAAG;AAC1E,WAAO,WAAW,uBAAuB,uBAAuB,EAAE,WAAW,CAAC;AAC9E,WAAO;AAAA,EACT;AAEA,SAAO,CAAC;AACV;",
+  "mappings": ";;AAAA,OAAS,aAAgB,oBACzB,OAAS,iBAAoB,iBAC7B,OAAS,kBAAqB,yBAC9B,OAAS,kBAAqB,yBAE9B,aAAc,cAAc,IAAI,mBAAkB,OAAmB,EAErE,IAAM,OAAS,aAAa,kBAAgB,EAC5C,IAAM,cAAgB,IAAI,cAAc,IAAI,EAkBrC,SAAS,wBAAwB,OAAgC,CAGtE,GAAI,OAAO,SAAW,SAAU,CAC9B,OAAO,MACT,CAEA,GAAI,OAAO,SAAW,SAAU,CAC9B,IAAI,IAAM,OAAO,KAAK,EACtB,GAAI,MAAQ,GAAI,CACd,OAAO,WAAW,0BAA2B,eAAgB,CAAE,MAAO,CAAC,EACvE,OAAO,IACT,CAEA,IAAM,cAAc,UAAU,GAAG,EACjC,GAAI,CAAC,SAAS,GAAG,EAAG,CAClB,OAAO,WAAW,0BAA2B,eAAgB,CAAE,MAAO,CAAC,EACvE,OAAO,IACT,CAEA,MAAO,CAAC,GACV,CAEA,OAAO,WAAW,0BAA2B,gBAAiB,CAAE,MAAO,CAAC,EACxE,OAAO,IACT,CAkBO,SAAS,8BAA8B,OAAgC,CAG5E,GAAI,OAAO,SAAW,SAAU,CAC9B,OAAO,OAAO,MAAM,CACtB,CAEA,GAAI,OAAO,SAAW,SAAU,CAC9B,IAAI,IAAM,OAAO,KAAK,EACtB,GAAI,MAAQ,GAAI,CACd,OAAO,WAAW,gCAAiC,eAAgB,CAAE,MAAO,CAAC,EAC7E,OAAO,IACT,CAEA,IAAM,cAAc,UAAU,GAAG,EACjC,GAAI,CAAC,SAAS,GAAG,EAAG,CAClB,OAAO,WAAW,gCAAiC,eAAgB,CAAE,MAAO,CAAC,EAC7E,OAAO,IACT,CAEA,OAAO,GACT,CAEA,OAAO,WAAW,gCAAiC,gBAAiB,CAAE,MAAO,CAAC,EAC9E,OAAO,IACT,CAkBO,SAAS,oBAAoB,MAAgB,YAAc,KAAqB,CAGrF,GAAI,OAAS,KAAM,CACjB,OAAO,WAAW,sBAAuB,0BAA2B,CAAE,KAAM,CAAC,EAC7E,OAAO,IACT,CAEA,MAAM,SAAW,OAAO,QAAU,SAAW,MAAM,KAAK,EAAI,OAAO,KAAK,EAExE,GAAI,WAAa,GAAI,CACnB,OAAO,WAAW,sBAAuB,qBAAsB,CAAE,KAAM,CAAC,EACxE,OAAO,IACT,CAEA,MAAM,cAAgB,cAAc,UAAU,QAAQ,EACtD,MAAM,oBAAsB,cAAc,QAAQ,WAAY,EAAE,EAChE,MAAM,YAAc,oBAAoB,QAAQ,IAAI,OAAO,QAAQ,WAAW,IAAI,WAAW,MAAM,EAAG,EAAE,EACxG,MAAM,WAAa,YAAc,YAEjC,GAAI,WAAW,SAAW,YAAY,OAAS,IAAM,CAAC,SAAS,UAAU,EAAG,CAC1E,OAAO,WAAW,sBAAuB,sBAAuB,CAAE,UAAW,CAAC,EAC9E,OAAO,IACT,CAEA,MAAO,CAAC,UACV",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexim/sanitizer",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "A collection of sanitization utilities for phone numbers and numeric inputs with TypeScript type safety.",
   "keywords": [
     "sanitizer",
@@ -44,19 +44,19 @@
     "watch": "wireit"
   },
   "dependencies": {
-    "@alwatr/is-number": "^5.7.0",
-    "@alwatr/logger": "^5.5.3",
-    "@alwatr/package-tracer": "^5.5.3",
-    "@alwatr/unicode-digits": "^5.5.3"
+    "@alwatr/is-number": "^5.7.21",
+    "@alwatr/logger": "^5.6.2",
+    "@alwatr/package-tracer": "^5.5.23",
+    "@alwatr/unicode-digits": "^5.5.24"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "^5.5.3",
+    "@alwatr/nano-build": "^6.3.9",
     "@nexim/typescript-config": "^2.0.1",
     "ava": "^6.4.1",
-    "typedoc": "^0.28.10",
-    "typedoc-plugin-markdown": "^4.8.1",
+    "typedoc": "^0.28.14",
+    "typedoc-plugin-markdown": "^4.9.0",
     "typedoc-plugin-no-inherit": "^1.6.1",
-    "typescript": "^5.9.2",
+    "typescript": "^5.9.3",
     "wireit": "^0.14.12"
   },
   "publishConfig": {
@@ -109,5 +109,5 @@
       "command": "typedoc"
     }
   },
-  "gitHead": "e67fe3938015270ff3bb71c5d76334faebc4c142"
+  "gitHead": "aa1bbda5f949163da8a2e11e658afe02aad75458"
 }