@excofy/utils 2.3.2 → 2.4.0

package/dist/index.cjs

@@ -71,13 +71,13 @@ function isValidCNPJ(cnpj) {
   function validCalc(x, numbers2) {
     const slice = numbers2.slice(0, x);
     let factor = x - 7;
-    let sum = 0;
+    let sum2 = 0;
     for (let i = x; i >= 1; i--) {
       const n = slice[x - i];
-      sum += n * factor--;
+      sum2 += n * factor--;
       if (factor < 2) factor = 9;
     }
-    const result = 11 - sum % 11;
+    const result = 11 - sum2 % 11;
     return result > 9 ? 0 : result;
   }
   function matchNumbers(value = "") {
@@ -155,6 +155,9 @@ function sanitizeValue(value, allowedTags) {
   return filter.process(value);
 }
 function htmlEntityDecode(str = "") {
+  if (!str || typeof str !== "string" || str.length === 0) {
+    return "";
+  }
   return str.replace(/&#(\d+);/g, (_, code) => String.fromCharCode(code)).replace(
     /&#x([0-9a-f]+);/gi,
     (_, code) => String.fromCharCode(Number.parseInt(code, 16))
@@ -908,8 +911,11 @@ var removeTrailingNumber = (slug) => {
 // src/helpers/number.ts
 var number_exports = {};
 __export(number_exports, {
+  divide: () => divide,
+  sum: () => sum,
   toCents: () => toCents,
-  toDecimal: () => toDecimal
+  toDecimal: () => toDecimal,
+  truncateDecimal: () => truncateDecimal
 });
 var import_big = __toESM(require("big.js"), 1);
 var toCents = (value) => {
@@ -924,6 +930,28 @@ var toDecimal = (value) => {
   }
   return new import_big.default(value).div(100).round(2).toNumber();
 };
+var truncateDecimal = (value, decimalPlaces) => {
+  if (!value) {
+    return 0;
+  }
+  const bigValue = new import_big.default(value);
+  const factor = new import_big.default(10).pow(decimalPlaces);
+  return bigValue.times(factor).round(0, import_big.default.roundDown).div(factor).toNumber();
+};
+var sum = (values) => {
+  return values.reduce((acc, value) => {
+    if (value) {
+      return acc.plus(value);
+    }
+    return acc;
+  }, new import_big.default(0)).toNumber();
+};
+var divide = (numerator, denominator) => {
+  if (denominator === 0) {
+    return 0;
+  }
+  return new import_big.default(numerator).div(denominator).toNumber();
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ExpiredTokenError,

package/dist/index.d.cts

@@ -195,11 +195,30 @@ declare const toCents: (value?: number) => number;
  * @returns {number} The decimal value (e.g., 10.90).
  */
 declare const toDecimal: (value?: number) => number;
+/**
+ * Truncates a decimal number to a specified number of decimal places.
+ *
+ * @example
+ * ```typescript
+ * const truncated = truncateDecimal(10.98765, 2);
+ * console.log(truncated); // 10.98
+ * ```
+ *
+ * @param {number} value - The decimal number to truncate.
+ * @param {number} decimalPlaces - The number of decimal places to keep.
+ * @returns {number} The truncated decimal number.
+ */
+declare const truncateDecimal: (value: number, decimalPlaces: number) => number;
+declare const sum: (values: (number | undefined)[]) => number;
+declare const divide: (numerator: number, denominator: number) => number;
 
+declare const number_divide: typeof divide;
+declare const number_sum: typeof sum;
 declare const number_toCents: typeof toCents;
 declare const number_toDecimal: typeof toDecimal;
+declare const number_truncateDecimal: typeof truncateDecimal;
 declare namespace number {
-  export { number_toCents as toCents, number_toDecimal as toDecimal };
+  export { number_divide as divide, number_sum as sum, number_toCents as toCents, number_toDecimal as toDecimal, number_truncateDecimal as truncateDecimal };
 }
 
 /**

package/dist/index.d.ts

@@ -195,11 +195,30 @@ declare const toCents: (value?: number) => number;
  * @returns {number} The decimal value (e.g., 10.90).
  */
 declare const toDecimal: (value?: number) => number;
+/**
+ * Truncates a decimal number to a specified number of decimal places.
+ *
+ * @example
+ * ```typescript
+ * const truncated = truncateDecimal(10.98765, 2);
+ * console.log(truncated); // 10.98
+ * ```
+ *
+ * @param {number} value - The decimal number to truncate.
+ * @param {number} decimalPlaces - The number of decimal places to keep.
+ * @returns {number} The truncated decimal number.
+ */
+declare const truncateDecimal: (value: number, decimalPlaces: number) => number;
+declare const sum: (values: (number | undefined)[]) => number;
+declare const divide: (numerator: number, denominator: number) => number;
 
+declare const number_divide: typeof divide;
+declare const number_sum: typeof sum;
 declare const number_toCents: typeof toCents;
 declare const number_toDecimal: typeof toDecimal;
+declare const number_truncateDecimal: typeof truncateDecimal;
 declare namespace number {
-  export { number_toCents as toCents, number_toDecimal as toDecimal };
+  export { number_divide as divide, number_sum as sum, number_toCents as toCents, number_toDecimal as toDecimal, number_truncateDecimal as truncateDecimal };
 }
 
 /**

package/dist/index.js

@@ -33,13 +33,13 @@ function isValidCNPJ(cnpj) {
   function validCalc(x, numbers2) {
     const slice = numbers2.slice(0, x);
     let factor = x - 7;
-    let sum = 0;
+    let sum2 = 0;
     for (let i = x; i >= 1; i--) {
       const n = slice[x - i];
-      sum += n * factor--;
+      sum2 += n * factor--;
       if (factor < 2) factor = 9;
     }
-    const result = 11 - sum % 11;
+    const result = 11 - sum2 % 11;
     return result > 9 ? 0 : result;
   }
   function matchNumbers(value = "") {
@@ -117,6 +117,9 @@ function sanitizeValue(value, allowedTags) {
   return filter.process(value);
 }
 function htmlEntityDecode(str = "") {
+  if (!str || typeof str !== "string" || str.length === 0) {
+    return "";
+  }
   return str.replace(/&#(\d+);/g, (_, code) => String.fromCharCode(code)).replace(
     /&#x([0-9a-f]+);/gi,
     (_, code) => String.fromCharCode(Number.parseInt(code, 16))
@@ -870,8 +873,11 @@ var removeTrailingNumber = (slug) => {
 // src/helpers/number.ts
 var number_exports = {};
 __export(number_exports, {
+  divide: () => divide,
+  sum: () => sum,
   toCents: () => toCents,
-  toDecimal: () => toDecimal
+  toDecimal: () => toDecimal,
+  truncateDecimal: () => truncateDecimal
 });
 import Big from "big.js";
 var toCents = (value) => {
@@ -886,6 +892,28 @@ var toDecimal = (value) => {
   }
   return new Big(value).div(100).round(2).toNumber();
 };
+var truncateDecimal = (value, decimalPlaces) => {
+  if (!value) {
+    return 0;
+  }
+  const bigValue = new Big(value);
+  const factor = new Big(10).pow(decimalPlaces);
+  return bigValue.times(factor).round(0, Big.roundDown).div(factor).toNumber();
+};
+var sum = (values) => {
+  return values.reduce((acc, value) => {
+    if (value) {
+      return acc.plus(value);
+    }
+    return acc;
+  }, new Big(0)).toNumber();
+};
+var divide = (numerator, denominator) => {
+  if (denominator === 0) {
+    return 0;
+  }
+  return new Big(numerator).div(denominator).toNumber();
+};
 export {
   ExpiredTokenError,
   InvalidTokenError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excofy/utils",
-  "version": "2.3.2",
+  "version": "2.4.0",
   "description": "Biblioteca de utilitários para o Excofy",
   "main": "dist/index.js",
   "type": "module",

package/src/helpers/number.ts

@@ -29,3 +29,48 @@ export const toDecimal = (value?: number): number => {
 
   return new Big(value).div(100).round(2).toNumber();
 };
+
+/**
+ * Truncates a decimal number to a specified number of decimal places.
+ *
+ * @example
+ * ```typescript
+ * const truncated = truncateDecimal(10.98765, 2);
+ * console.log(truncated); // 10.98
+ * ```
+ *
+ * @param {number} value - The decimal number to truncate.
+ * @param {number} decimalPlaces - The number of decimal places to keep.
+ * @returns {number} The truncated decimal number.
+ */
+export const truncateDecimal = (
+  value: number,
+  decimalPlaces: number,
+): number => {
+  if (!value) {
+    return 0;
+  }
+
+  const bigValue = new Big(value);
+  const factor = new Big(10).pow(decimalPlaces);
+  return bigValue.times(factor).round(0, Big.roundDown).div(factor).toNumber();
+};
+
+export const sum = (values: (number | undefined)[]): number => {
+  return values
+    .reduce((acc: Big.Big, value) => {
+      if (value) {
+        return acc.plus(value);
+      }
+      return acc;
+    }, new Big(0))
+    .toNumber();
+};
+
+export const divide = (numerator: number, denominator: number) => {
+  if (denominator === 0) {
+    return 0;
+  }
+
+  return new Big(numerator).div(denominator).toNumber();
+};

package/src/helpers/sanitize.ts

@@ -102,6 +102,10 @@ export function sanitizeValue(
 }
 
 export function htmlEntityDecode(str = ''): string {
+  if (!str || typeof str !== 'string' || str.length === 0) {
+    return '';
+  }
+
   return str
     .replace(/&#(\d+);/g, (_, code) => String.fromCharCode(code))
     .replace(/&#x([0-9a-f]+);/gi, (_, code) =>

package/tsconfig.json

@@ -5,7 +5,7 @@
     "declaration": true,
     "declarationMap": true,
     "outDir": "dist",
-    "moduleResolution": "Node",
+    "moduleResolution": "bundler",
     "esModuleInterop": true,
     "forceConsistentCasingInFileNames": true,
     "strict": true,