@nexim/sanitizer 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.1.0](https://github.com/the-nexim/nanolib/compare/@nexim/sanitizer@1.0.0...@nexim/sanitizer@1.1.0) (2025-06-18)
+
+### Features
+
+* **sanitizer:** add sanitize number string to english to prevent remove first zero ([13446d8](https://github.com/the-nexim/nanolib/commit/13446d852252342bccd9d62cfe5d56cc33a87514)) by @njfamirm
+
 ## 1.0.0 (2025-06-18)
 
 ### Features

package/dist/main.cjs

@@ -1,4 +1,4 @@
-/* @nexim/sanitizer v1.0.0 */
+/* @nexim/sanitizer v1.1.0 */
 "use strict";
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/main.ts
 var main_exports = {};
 __export(main_exports, {
+  sanitizeNumberStringToEnglish: () => sanitizeNumberStringToEnglish,
   sanitizeNumberToEnglish: () => sanitizeNumberToEnglish,
   sanitizePhoneNumber: () => sanitizePhoneNumber
 });
@@ -29,7 +30,7 @@ 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.0.0");
+__dev_mode__: import_package_tracer.packageTracer.add("@nexim/sanitizer", "1.1.0");
 var logger = (0, import_logger.createLogger)("@nexim/sanitizer");
 var unicodeDigits = new import_unicode_digits.UnicodeDigits("en");
 function sanitizeNumberToEnglish(number) {
@@ -52,6 +53,26 @@ function sanitizeNumberToEnglish(number) {
   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 });

package/dist/main.cjs.map

@@ -1,7 +1,7 @@
 {
   "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(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 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,uBAAyB;AACzB,oBAA6B;AAC7B,4BAA8B;AAC9B,4BAA8B;AAE9B,aAAc,qCAAc,IAAI,oBAAkB,OAAmB;AAErE,IAAM,aAAS,4BAAa,kBAAgB;AAC5C,IAAM,gBAAgB,IAAI,oCAAc,IAAI;AAiBrC,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,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;",
+  "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;",
   "names": []
 }

package/dist/main.d.ts

@@ -13,6 +13,23 @@
  * ```
  */
 export declare function sanitizeNumberToEnglish(number: number): number;
+export declare function sanitizeNumberToEnglish<T>(number: T): number | null;
+/**
+ * Sanitizes a number to English string format, preserving leading zeros.
+ * If input is a string, converts Unicode digits to English and validates it's a valid number.
+ * If input is already a number, converts it to string.
+ *
+ * @param number - The input to sanitize (number or string)
+ * @returns The sanitized number as string, or null if invalid
+ *
+ * @example
+ * ```ts
+ * sanitizeNumberStringToEnglish(123); // returns '123'
+ * sanitizeNumberStringToEnglish('۰۱۲۳'); // returns '0123' (preserves leading zero)
+ * sanitizeNumberStringToEnglish('abc'); // returns null
+ * ```
+ */
+export declare function sanitizeNumberStringToEnglish<T>(number: T): string | null;
 /**
  * Sanitizes a phone number by converting Unicode digits, removing special characters,
  * and standardizing the format with country code.

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;AA4BhE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,SAAO,GAAG,MAAM,GAAG,IAAI,CA0BrF"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;AAChE,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;AA4BrE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;AA4B3E;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,SAAO,GAAG,MAAM,GAAG,IAAI,CA0BrF"}

package/dist/main.mjs

@@ -1,11 +1,11 @@
-/* @nexim/sanitizer v1.0.0 */
+/* @nexim/sanitizer v1.1.0 */
 
 // 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.0.0");
+__dev_mode__: packageTracer.add("@nexim/sanitizer", "1.1.0");
 var logger = createLogger("@nexim/sanitizer");
 var unicodeDigits = new UnicodeDigits("en");
 function sanitizeNumberToEnglish(number) {
@@ -28,6 +28,26 @@ function sanitizeNumberToEnglish(number) {
   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 });
@@ -49,6 +69,7 @@ function sanitizePhoneNumber(input, countryCode = "98") {
   return +fullNumber;
 }
 export {
+  sanitizeNumberStringToEnglish,
   sanitizeNumberToEnglish,
   sanitizePhoneNumber
 };

package/dist/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "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(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 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;AAiBrC,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,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;",
+  "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;",
   "names": []
 }

package/docs/README.md

@@ -2,7 +2,8 @@
 
 ## Functions
 
-| Function                                                        | Description                                                                                                                                                                       |
-| --------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| [sanitizeNumberToEnglish](functions/sanitizeNumberToEnglish.md) | Sanitizes a number to English format. If input is already a number, returns it as-is. If input is a string, converts Unicode digits to English and validates it's a valid number. |
-| [sanitizePhoneNumber](functions/sanitizePhoneNumber.md)         | Sanitizes a phone number by converting Unicode digits, removing special characters, and standardizing the format with country code.                                               |
+| Function                                                                    | Description                                                                                                                                                                                                             |
+| --------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| [sanitizeNumberStringToEnglish](functions/sanitizeNumberStringToEnglish.md) | Sanitizes a number to English string format, preserving leading zeros. If input is a string, converts Unicode digits to English and validates it's a valid number. If input is already a number, converts it to string. |
+| [sanitizeNumberToEnglish](functions/sanitizeNumberToEnglish.md)             | Sanitizes a number to English format. If input is already a number, returns it as-is. If input is a string, converts Unicode digits to English and validates it's a valid number.                                       |
+| [sanitizePhoneNumber](functions/sanitizePhoneNumber.md)                     | Sanitizes a phone number by converting Unicode digits, removing special characters, and standardizing the format with country code.                                                                                     |

package/docs/functions/sanitizeNumberStringToEnglish.md

@@ -0,0 +1,35 @@
+[@nexim/sanitizer](../README.md) / sanitizeNumberStringToEnglish
+
+# Function: sanitizeNumberStringToEnglish()
+
+> **sanitizeNumberStringToEnglish**\<`T`\>(`number`: `T`): `null` \| `string`
+
+Sanitizes a number to English string format, preserving leading zeros.
+If input is a string, converts Unicode digits to English and validates it's a valid number.
+If input is already a number, converts it to string.
+
+## Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+
+## Parameters
+
+| Parameter | Type | Description                              |
+| --------- | ---- | ---------------------------------------- |
+| `number`  | `T`  | The input to sanitize (number or string) |
+
+## Returns
+
+`null` \| `string`
+
+The sanitized number as string, or null if invalid
+
+## Example
+
+```ts
+sanitizeNumberStringToEnglish(123); // returns '123'
+sanitizeNumberStringToEnglish('۰۱۲۳'); // returns '0123' (preserves leading zero)
+sanitizeNumberStringToEnglish('abc'); // returns null
+```

package/docs/functions/sanitizeNumberToEnglish.md

@@ -2,24 +2,59 @@
 
 # Function: sanitizeNumberToEnglish()
 
+## Call Signature
+
 > **sanitizeNumberToEnglish**(`number`: `number`): `number`
 
 Sanitizes a number to English format. If input is already a number, returns it as-is.
 If input is a string, converts Unicode digits to English and validates it's a valid number.
 
-## Parameters
+### Parameters
 
 | Parameter | Type     | Description                              |
 | --------- | -------- | ---------------------------------------- |
 | `number`  | `number` | The input to sanitize (number or string) |
 
-## Returns
+### Returns
 
 `number`
 
 The sanitized number or string, or null if invalid
 
-## Example
+### Example
+
+```ts
+sanitizeNumberToEnglish(123); // returns 123
+sanitizeNumberToEnglish('۱۲۳'); // returns '123'
+sanitizeNumberToEnglish('abc'); // returns null
+```
+
+## Call Signature
+
+> **sanitizeNumberToEnglish**\<`T`\>(`number`: `T`): `null` \| `number`
+
+Sanitizes a number to English format. If input is already a number, returns it as-is.
+If input is a string, converts Unicode digits to English and validates it's a valid number.
+
+### Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+
+### Parameters
+
+| Parameter | Type | Description                              |
+| --------- | ---- | ---------------------------------------- |
+| `number`  | `T`  | The input to sanitize (number or string) |
+
+### Returns
+
+`null` \| `number`
+
+The sanitized number or string, or null if invalid
+
+### Example
 
 ```ts
 sanitizeNumberToEnglish(123); // returns 123

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexim/sanitizer",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A collection of sanitization utilities for phone numbers and numeric inputs with TypeScript type safety.",
   "keywords": [
     "sanitizer",
@@ -109,5 +109,5 @@
       "command": "typedoc"
     }
   },
-  "gitHead": "0310d2636f626d479b6e925167ebc361468232c7"
+  "gitHead": "b98c4af4c1d206ce778413fa9061f85c8748ac58"
 }