@excofy/utils 2.3.3 → 2.5.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 = "") {
@@ -809,6 +809,19 @@ async function verifyDeterministicHash(inputCode, storedHash, secret) {
 }
 var cryptoUtils = {
   uuidV4: () => crypto.randomUUID(),
+  ulid: () => {
+    function randomChar() {
+      const chars = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+      return chars[Math.floor(Math.random() * chars.length)];
+    }
+    const timestamp = Date.now();
+    const timestampStr = timestamp.toString(36).toUpperCase().padStart(10, "0");
+    let randomPart = "";
+    for (let i = 0; i < 16; i++) {
+      randomPart += randomChar();
+    }
+    return timestampStr + randomPart;
+  },
   hash: async (password, salt = 10) => {
     const importedKey = await crypto.subtle.importKey(
       "raw",
@@ -911,8 +924,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) => {
@@ -927,6 +943,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

@@ -122,6 +122,7 @@ interface IValidateAccessToken {
 }
 interface ICrypto {
     uuidV4: () => string;
+    ulid: () => string;
     hash: (password: string, salt: number) => Promise<string>;
     isMatch: (password: string, hash: string, salt?: number) => Promise<boolean>;
     generateAccessToken: (data: IGenerateAccessToken) => Promise<string>;
@@ -195,11 +196,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

@@ -122,6 +122,7 @@ interface IValidateAccessToken {
 }
 interface ICrypto {
     uuidV4: () => string;
+    ulid: () => string;
     hash: (password: string, salt: number) => Promise<string>;
     isMatch: (password: string, hash: string, salt?: number) => Promise<boolean>;
     generateAccessToken: (data: IGenerateAccessToken) => Promise<string>;
@@ -195,11 +196,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 = "") {
@@ -771,6 +771,19 @@ async function verifyDeterministicHash(inputCode, storedHash, secret) {
 }
 var cryptoUtils = {
   uuidV4: () => crypto.randomUUID(),
+  ulid: () => {
+    function randomChar() {
+      const chars = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+      return chars[Math.floor(Math.random() * chars.length)];
+    }
+    const timestamp = Date.now();
+    const timestampStr = timestamp.toString(36).toUpperCase().padStart(10, "0");
+    let randomPart = "";
+    for (let i = 0; i < 16; i++) {
+      randomPart += randomChar();
+    }
+    return timestampStr + randomPart;
+  },
   hash: async (password, salt = 10) => {
     const importedKey = await crypto.subtle.importKey(
       "raw",
@@ -873,8 +886,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) => {
@@ -889,6 +905,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.3",
+  "version": "2.5.0",
   "description": "Biblioteca de utilitários para o Excofy",
   "main": "dist/index.js",
   "type": "module",

package/src/helpers/crypto.ts

@@ -17,6 +17,7 @@ interface IValidateAccessToken {
 
 interface ICrypto {
   uuidV4: () => string;
+  ulid: () => string;
   hash: (password: string, salt: number) => Promise<string>;
   isMatch: (password: string, hash: string, salt?: number) => Promise<boolean>;
   generateAccessToken: (data: IGenerateAccessToken) => Promise<string>;
@@ -34,7 +35,7 @@ interface ICrypto {
   verifyDeterministicHash: (
     inputCode: string,
     storedHash: string,
-    secret: string
+    secret: string,
   ) => Promise<boolean>;
 }
 
@@ -54,7 +55,7 @@ const signatureKey = async (AUTH_SIGN_SECRET: string) =>
     encoder.encode(AUTH_SIGN_SECRET),
     { name: 'HMAC', hash: 'SHA-256' },
     false,
-    ['sign', 'verify']
+    ['sign', 'verify'],
   );
 
 const payloadKey = async (AUTH_PAYLOAD_SECRET: string) =>
@@ -63,7 +64,7 @@ const payloadKey = async (AUTH_PAYLOAD_SECRET: string) =>
     encoder.encode(AUTH_PAYLOAD_SECRET.substring(0, 32)),
     { name: 'AES-GCM', length: 256 },
     true,
-    ['encrypt', 'decrypt']
+    ['encrypt', 'decrypt'],
   );
 
 /* --------------------- Payload (encrypt/decrypt) --------------------- */
@@ -80,7 +81,7 @@ const encryptPayload = async ({
   const buffer = await crypto.subtle.encrypt(
     { name: 'AES-GCM', iv },
     key,
-    encoder.encode(payload)
+    encoder.encode(payload),
   );
 
   return `${toBase64(iv)}.${toBase64(buffer)}`;
@@ -99,7 +100,7 @@ const decryptPayload = async ({
   const buffer = await crypto.subtle.decrypt(
     { name: 'AES-GCM', iv: fromBase64(header).buffer as ArrayBuffer },
     key,
-    fromBase64(payload).buffer as ArrayBuffer
+    fromBase64(payload).buffer as ArrayBuffer,
   );
 
   return decoder.decode(buffer);
@@ -115,14 +116,14 @@ const decryptPayload = async ({
  */
 export async function generateDeterministicHash(
   code: string,
-  secret: string
+  secret: string,
 ): Promise<string> {
   const key = await crypto.subtle.importKey(
     'raw',
     encoder.encode(secret),
     { name: 'HMAC', hash: 'SHA-256' },
     false,
-    ['sign']
+    ['sign'],
   );
 
   const signature = await crypto.subtle.sign('HMAC', key, encoder.encode(code));
@@ -143,7 +144,7 @@ export async function generateDeterministicHash(
 export async function verifyDeterministicHash(
   inputCode: string,
   storedHash: string,
-  secret: string
+  secret: string,
 ): Promise<boolean> {
   const hash = await generateDeterministicHash(inputCode, secret);
   return hash === storedHash;
@@ -153,13 +154,30 @@ export async function verifyDeterministicHash(
 export const cryptoUtils: ICrypto = {
   uuidV4: (): string => crypto.randomUUID(),
 
+  ulid: (): string => {
+    function randomChar() {
+      const chars = '0123456789ABCDEFGHJKMNPQRSTVWXYZ'; // Crockford's Base32
+      return chars[Math.floor(Math.random() * chars.length)];
+    }
+
+    const timestamp = Date.now();
+    const timestampStr = timestamp.toString(36).toUpperCase().padStart(10, '0');
+
+    let randomPart = '';
+    for (let i = 0; i < 16; i++) {
+      randomPart += randomChar();
+    }
+
+    return timestampStr + randomPart;
+  },
+
   hash: async (password: string, salt = 10): Promise<string> => {
     const importedKey = await crypto.subtle.importKey(
       'raw',
       encoder.encode(password),
       { name: 'PBKDF2' },
       false,
-      ['deriveBits']
+      ['deriveBits'],
     );
 
     const derivedKey = await crypto.subtle.deriveBits(
@@ -170,7 +188,7 @@ export const cryptoUtils: ICrypto = {
         hash: 'SHA-256',
       },
       importedKey,
-      256
+      256,
     );
 
     return Array.from(new Uint8Array(derivedKey))
@@ -200,7 +218,7 @@ export const cryptoUtils: ICrypto = {
     const signatureBuffer = await crypto.subtle.sign(
       'HMAC',
       key,
-      encoder.encode(payload)
+      encoder.encode(payload),
     );
     const signature = toBase64(signatureBuffer);
 
@@ -227,7 +245,7 @@ export const cryptoUtils: ICrypto = {
         'HMAC',
         key,
         fromBase64(signature).buffer as ArrayBuffer,
-        encoder.encode(payloadDecrypted)
+        encoder.encode(payloadDecrypted),
       );
 
       if (!valid) throw new Error('Invalid access token');

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/tsconfig.json

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