@accitdg/web-helpers 0.0.13 → 0.0.17

package/README.md

@@ -76,6 +76,17 @@ Removes the data URL prefix from a Base64 string, leaving only the encoded data.
 ```javascript
 const cleaned = webHelpers.cleanBase64("data:image/png;base64,iVBORw0KG...");
 // Output: "iVBORw0KG..."
+
+## Supported File Types
+
+The `cleanBase64` function supports:
+
+- Images: png, jpg, jpeg, gif, webp, etc.
+- PDF documents
+- Word documents (.docx, .dotx)
+- Excel spreadsheets (.xlsx)
+
+
 ```
 
 ---
@@ -240,14 +251,84 @@ const short = createPayload2({ payload: { x: 1 } });
 // uses configured applicationId/notificationId unless overridden in the call
 ```
 
-## Supported File Types
+### formatNumberWithCommas(number: number): string
 
-The `cleanBase64` function supports:
+Formats a number with comma separators for thousands, preserving decimal places.
 
-- Images: png, jpg, jpeg, gif, webp, etc.
-- PDF documents
-- Word documents (.docx, .dotx)
-- Excel spreadsheets (.xlsx)
+Parameters:
+
+number (number): The number to format
+Returns: Formatted number string with commas as thousand separators
+
+Example:
+
+```ts
+webHelpers.formatNumberWithCommas(1000);
+// Output: "1,000"
+
+webHelpers.formatNumberWithCommas(1234567.89);
+// Output: "1,234,567.89"
+
+webHelpers.formatNumberWithCommas(500);
+// Output: "500"
+```
+
+### `titleCase(str: string): string`
+
+Converts a string to title case, capitalizing the first letter of each word and converting the rest to lowercase.
+
+**Parameters:**
+
+- `str` (string): The string to convert to title case
+
+**Returns:** Title case formatted string, or the original input if not a string
+
+**Example:**
+
+````javascript
+webHelpers.titleCase("hello world");
+// Output: "Hello World"
+
+webHelpers.titleCase("tHIS IS A TEST");
+// Output: "This Is A Test"
+
+webHelpers.titleCase("javascript  typescript");
+// Output: "Javascript Typescript"
+
+webHelpers.titleCase("single");
+// Output: "Single"
+
+webHelpers.titleCase(123);
+// Output: 123 (returns original value if not a string)
+
+### `maskFormatPhilippineNumber(number: string): string`
+
+Formats a Philippine phone number string into a standardized mask format (+63 XXXX XXXX XXX). Accepts numbers with various input formats and cleans them before formatting.
+
+**Parameters:**
+
+- `number` (string): The phone number string to format (can include non-numeric characters)
+
+**Returns:** Formatted Philippine phone number in the format "+63 XXXX XXXX XXX", or the original input if invalid
+
+**Example:**
+
+```javascript
+webHelpers.maskFormatPhilippineNumber("09171234567");
+// Output: "+63 9171 2345 67"
+
+webHelpers.maskFormatPhilippineNumber("+639171234567");
+// Output: "+63 9171 2345 67"
+
+webHelpers.maskFormatPhilippineNumber("63 917 123 4567");
+// Output: "+63 9171 2345 67"
+
+webHelpers.maskFormatPhilippineNumber("09171234");
+// Output: "09171234" (returns original - invalid length)
+
+webHelpers.maskFormatPhilippineNumber("(0917) 123-4567");
+// Output: "+63 9171 2345 67"
+````
 
 ## License
 

package/dist/index.cjs.js

@@ -53,6 +53,18 @@ var convertNumberToCurrency = function convertNumberToCurrency(numberValue) {
   });
   return formattedValue;
 };
+var formatNumberWithCommas = function formatNumberWithCommas(number) {
+  var numStr = number.toString();
+  var parts = numStr.split(".");
+  var integerPart = parts[0];
+  var pattern = /(\d)(?=(\d{3})+(?!\d))/g;
+  integerPart = integerPart.replace(pattern, "$1,");
+  if (parts.length > 1) {
+    return integerPart + "." + parts[1];
+  } else {
+    return integerPart;
+  }
+};
 var restoreBase64 = function restoreBase64(cleanedBase64) {
   var imageType = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "png";
   return "data:image/".concat(imageType, ";base64,").concat(cleanedBase64);
@@ -151,6 +163,29 @@ var createPayload2 = function createPayload2() {
 var configureHelpers = function configureHelpers(config) {
   globalThis.__WEB_HELPERS_CONFIG = _objectSpread2(_objectSpread2({}, globalThis.__WEB_HELPERS_CONFIG || {}), config);
 };
+var titleCase = function titleCase(str) {
+  return typeof str === "string" ? str.split(/\s+/).filter(Boolean).map(function (w) {
+    return w.charAt(0).toUpperCase() + w.slice(1).toLowerCase();
+  }).join(" ") : str;
+};
+var maskFormatPhilippineNumber = function maskFormatPhilippineNumber(number) {
+  var cleanedNumber = number.replace(/[^0-9+]/g, "");
+  var formattedNumber;
+  if (cleanedNumber.startsWith("+63")) {
+    formattedNumber = cleanedNumber.substring(3);
+  } else if (cleanedNumber.startsWith("0")) {
+    formattedNumber = cleanedNumber.substring(1);
+  } else if (cleanedNumber.length === 11) {
+    formattedNumber = cleanedNumber;
+  } else {
+    return number;
+  }
+  if (formattedNumber.length !== 11) {
+    return number;
+  }
+  formattedNumber = "+63 ".concat(formattedNumber.slice(0, 4), " ").concat(formattedNumber.slice(4, 8), " ").concat(formattedNumber.slice(8));
+  return formattedNumber;
+};
 
 var index = {
   convertNumberToCurrency: convertNumberToCurrency,
@@ -161,7 +196,10 @@ var index = {
   getFileExtensionFromBase64: getFileExtensionFromBase64,
   configureHelpers: configureHelpers,
   createPayload: createPayload,
-  createPayload2: createPayload2
+  createPayload2: createPayload2,
+  formatNumberWithCommas: formatNumberWithCommas,
+  titleCase: titleCase,
+  maskFormatPhilippineNumber: maskFormatPhilippineNumber
 };
 
 exports.arrayBufferToBase64 = arrayBufferToBase64;
@@ -172,5 +210,8 @@ exports.createPayload = createPayload;
 exports.createPayload2 = createPayload2;
 exports["default"] = index;
 exports.downloadBase64File = downloadBase64File;
+exports.formatNumberWithCommas = formatNumberWithCommas;
 exports.getFileExtensionFromBase64 = getFileExtensionFromBase64;
+exports.maskFormatPhilippineNumber = maskFormatPhilippineNumber;
 exports.restoreBase64 = restoreBase64;
+exports.titleCase = titleCase;

package/dist/index.esm.js

@@ -49,6 +49,18 @@ var convertNumberToCurrency = function convertNumberToCurrency(numberValue) {
   });
   return formattedValue;
 };
+var formatNumberWithCommas = function formatNumberWithCommas(number) {
+  var numStr = number.toString();
+  var parts = numStr.split(".");
+  var integerPart = parts[0];
+  var pattern = /(\d)(?=(\d{3})+(?!\d))/g;
+  integerPart = integerPart.replace(pattern, "$1,");
+  if (parts.length > 1) {
+    return integerPart + "." + parts[1];
+  } else {
+    return integerPart;
+  }
+};
 var restoreBase64 = function restoreBase64(cleanedBase64) {
   var imageType = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "png";
   return "data:image/".concat(imageType, ";base64,").concat(cleanedBase64);
@@ -147,6 +159,29 @@ var createPayload2 = function createPayload2() {
 var configureHelpers = function configureHelpers(config) {
   globalThis.__WEB_HELPERS_CONFIG = _objectSpread2(_objectSpread2({}, globalThis.__WEB_HELPERS_CONFIG || {}), config);
 };
+var titleCase = function titleCase(str) {
+  return typeof str === "string" ? str.split(/\s+/).filter(Boolean).map(function (w) {
+    return w.charAt(0).toUpperCase() + w.slice(1).toLowerCase();
+  }).join(" ") : str;
+};
+var maskFormatPhilippineNumber = function maskFormatPhilippineNumber(number) {
+  var cleanedNumber = number.replace(/[^0-9+]/g, "");
+  var formattedNumber;
+  if (cleanedNumber.startsWith("+63")) {
+    formattedNumber = cleanedNumber.substring(3);
+  } else if (cleanedNumber.startsWith("0")) {
+    formattedNumber = cleanedNumber.substring(1);
+  } else if (cleanedNumber.length === 11) {
+    formattedNumber = cleanedNumber;
+  } else {
+    return number;
+  }
+  if (formattedNumber.length !== 11) {
+    return number;
+  }
+  formattedNumber = "+63 ".concat(formattedNumber.slice(0, 4), " ").concat(formattedNumber.slice(4, 8), " ").concat(formattedNumber.slice(8));
+  return formattedNumber;
+};
 
 var index = {
   convertNumberToCurrency: convertNumberToCurrency,
@@ -157,7 +192,10 @@ var index = {
   getFileExtensionFromBase64: getFileExtensionFromBase64,
   configureHelpers: configureHelpers,
   createPayload: createPayload,
-  createPayload2: createPayload2
+  createPayload2: createPayload2,
+  formatNumberWithCommas: formatNumberWithCommas,
+  titleCase: titleCase,
+  maskFormatPhilippineNumber: maskFormatPhilippineNumber
 };
 
-export { arrayBufferToBase64, cleanBase64, configureHelpers, convertNumberToCurrency, createPayload, createPayload2, index as default, downloadBase64File, getFileExtensionFromBase64, restoreBase64 };
+export { arrayBufferToBase64, cleanBase64, configureHelpers, convertNumberToCurrency, createPayload, createPayload2, index as default, downloadBase64File, formatNumberWithCommas, getFileExtensionFromBase64, maskFormatPhilippineNumber, restoreBase64, titleCase };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@accitdg/web-helpers",
-  "version": "0.0.13",
+  "version": "0.0.17",
   "type": "module",
   "main": "dist/index.cjs.js",
   "module": "dist/index.esm.js",