@excofy/utils 1.0.1 → 1.0.3

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,13 +17,23 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
   createValidator: () => createValidator,
-  htmlEntityDecode: () => htmlEntityDecode
+  htmlEntityDecode: () => htmlEntityDecode,
+  numberUtils: () => number_exports,
+  slugUtils: () => slug_exports
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -311,6 +323,21 @@ function createValidator() {
       }
       return validator;
     },
+    url(message) {
+      if (shouldSkipValidation()) {
+        return validator;
+      }
+      if (typeof current.value === "string") {
+        try {
+          new URL(current.value);
+        } catch {
+          current.pushError(message);
+        }
+      } else {
+        current.pushError(message);
+      }
+      return validator;
+    },
     uuid(message) {
       if (shouldSkipValidation()) {
         return validator;
@@ -452,8 +479,48 @@ function createValidator() {
     }
   };
 }
+
+// src/helpers/slug.ts
+var slug_exports = {};
+__export(slug_exports, {
+  generateUniqueSlug: () => generateUniqueSlug,
+  removeTrailingNumber: () => removeTrailingNumber
+});
+var generateUniqueSlug = (baseSlug, existingSlugs) => {
+  const suffixes = existingSlugs.map((slug) => {
+    const match = slug.match(new RegExp(`^${baseSlug}-(\\d+)$`));
+    return match ? Number(match[1]) : slug === baseSlug ? 0 : null;
+  }).filter((num) => num !== null);
+  const nextSuffix = suffixes.length > 0 ? Math.max(...suffixes) + 1 : 0;
+  return nextSuffix === 0 ? baseSlug : `${baseSlug}-${nextSuffix}`;
+};
+var removeTrailingNumber = (slug) => {
+  return slug.replace(/-\d+$/, "");
+};
+
+// src/helpers/number.ts
+var number_exports = {};
+__export(number_exports, {
+  toCents: () => toCents,
+  toDecimal: () => toDecimal
+});
+var import_big = __toESM(require("big.js"), 1);
+var toCents = (value) => {
+  if (!value) {
+    return 0;
+  }
+  return new import_big.default(value).mul(100).round(0).toNumber();
+};
+var toDecimal = (value) => {
+  if (!value) {
+    return 0;
+  }
+  return new import_big.default(value).div(100).round(2).toNumber();
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createValidator,
-  htmlEntityDecode
+  htmlEntityDecode,
+  numberUtils,
+  slugUtils
 });

package/dist/index.d.cts

@@ -55,6 +55,7 @@ declare function createValidator<TRaw extends Record<string, TInputValue>, TPars
                 slug(message: string): /*elided*/ any;
                 sanitize(): /*elided*/ any;
                 sanitizeHTML(tags?: AllowedTag[]): /*elided*/ any;
+                url(message: string): /*elided*/ any;
                 uuid(message: string): /*elided*/ any;
                 oneOf: (types: string[], message: string) => /*elided*/ any;
                 videoUrl: {
@@ -78,6 +79,7 @@ declare function createValidator<TRaw extends Record<string, TInputValue>, TPars
                 slug(message: string): /*elided*/ any;
                 sanitize(): /*elided*/ any;
                 sanitizeHTML(tags?: AllowedTag[]): /*elided*/ any;
+                url(message: string): /*elided*/ any;
                 uuid(message: string): /*elided*/ any;
                 oneOf: (types: string[], message: string) => /*elided*/ any;
                 videoUrl: {
@@ -91,4 +93,66 @@ declare function createValidator<TRaw extends Record<string, TInputValue>, TPars
     };
 };
 
-export { createValidator, htmlEntityDecode };
+/**
+ * Generates a unique slug by appending a numeric suffix to the base slug if necessary.
+ *
+ * If the base slug is already used (either exactly or with a numeric suffix),
+ * the function finds the highest existing suffix and returns the next one in sequence.
+ *
+ * @example
+ * generateUniqueSlug('my-product', ['my-product', 'my-product-1', 'my-product-2'])
+ * // returns 'my-product-3'
+ *
+ * generateUniqueSlug('item', ['item-1', 'item-2'])
+ * // returns 'item'
+ *
+ * @param {string} baseSlug - The initial slug to use as a base.
+ * @param {string[]} existingSlugs - A list of existing slugs to avoid duplicates.
+ * @returns {string} A unique slug not present in the existingSlugs list.
+ */
+declare const generateUniqueSlug: (baseSlug: string, existingSlugs: string[]) => string;
+/**
+ * Removes a trailing numeric suffix from a slug, if present.
+ *
+ * This is useful for extracting the base part of a slug before checking
+ * or generating new unique variations.
+ *
+ * @example
+ * removeTrailingNumber('product-3') // returns 'product'
+ * removeTrailingNumber('item')      // returns 'item'
+ *
+ * @param {string} slug - The slug from which to remove the trailing number.
+ * @returns {string} The slug without the trailing numeric suffix.
+ */
+declare const removeTrailingNumber: (slug: string) => string;
+
+declare const slug_generateUniqueSlug: typeof generateUniqueSlug;
+declare const slug_removeTrailingNumber: typeof removeTrailingNumber;
+declare namespace slug {
+  export { slug_generateUniqueSlug as generateUniqueSlug, slug_removeTrailingNumber as removeTrailingNumber };
+}
+
+/**
+ * Converts a decimal number to an integer by multiplying it by 100.
+ * Commonly used to convert monetary values from dollars to cents.
+ *
+ * @param {number} value - The decimal number to convert (e.g., 10.90).
+ * @returns {number} The integer value in cents (e.g., 1090).
+ */
+declare const toCents: (value?: number) => number;
+/**
+ * Converts an integer back to a decimal by dividing it by 100.
+ * Commonly used to convert monetary values from cents to dollars.
+ *
+ * @param {number} value - The integer value in cents (e.g., 1090).
+ * @returns {number} The decimal value (e.g., 10.90).
+ */
+declare const toDecimal: (value?: number) => number;
+
+declare const number_toCents: typeof toCents;
+declare const number_toDecimal: typeof toDecimal;
+declare namespace number {
+  export { number_toCents as toCents, number_toDecimal as toDecimal };
+}
+
+export { createValidator, htmlEntityDecode, number as numberUtils, slug as slugUtils };

package/dist/index.d.ts

@@ -55,6 +55,7 @@ declare function createValidator<TRaw extends Record<string, TInputValue>, TPars
                 slug(message: string): /*elided*/ any;
                 sanitize(): /*elided*/ any;
                 sanitizeHTML(tags?: AllowedTag[]): /*elided*/ any;
+                url(message: string): /*elided*/ any;
                 uuid(message: string): /*elided*/ any;
                 oneOf: (types: string[], message: string) => /*elided*/ any;
                 videoUrl: {
@@ -78,6 +79,7 @@ declare function createValidator<TRaw extends Record<string, TInputValue>, TPars
                 slug(message: string): /*elided*/ any;
                 sanitize(): /*elided*/ any;
                 sanitizeHTML(tags?: AllowedTag[]): /*elided*/ any;
+                url(message: string): /*elided*/ any;
                 uuid(message: string): /*elided*/ any;
                 oneOf: (types: string[], message: string) => /*elided*/ any;
                 videoUrl: {
@@ -91,4 +93,66 @@ declare function createValidator<TRaw extends Record<string, TInputValue>, TPars
     };
 };
 
-export { createValidator, htmlEntityDecode };
+/**
+ * Generates a unique slug by appending a numeric suffix to the base slug if necessary.
+ *
+ * If the base slug is already used (either exactly or with a numeric suffix),
+ * the function finds the highest existing suffix and returns the next one in sequence.
+ *
+ * @example
+ * generateUniqueSlug('my-product', ['my-product', 'my-product-1', 'my-product-2'])
+ * // returns 'my-product-3'
+ *
+ * generateUniqueSlug('item', ['item-1', 'item-2'])
+ * // returns 'item'
+ *
+ * @param {string} baseSlug - The initial slug to use as a base.
+ * @param {string[]} existingSlugs - A list of existing slugs to avoid duplicates.
+ * @returns {string} A unique slug not present in the existingSlugs list.
+ */
+declare const generateUniqueSlug: (baseSlug: string, existingSlugs: string[]) => string;
+/**
+ * Removes a trailing numeric suffix from a slug, if present.
+ *
+ * This is useful for extracting the base part of a slug before checking
+ * or generating new unique variations.
+ *
+ * @example
+ * removeTrailingNumber('product-3') // returns 'product'
+ * removeTrailingNumber('item')      // returns 'item'
+ *
+ * @param {string} slug - The slug from which to remove the trailing number.
+ * @returns {string} The slug without the trailing numeric suffix.
+ */
+declare const removeTrailingNumber: (slug: string) => string;
+
+declare const slug_generateUniqueSlug: typeof generateUniqueSlug;
+declare const slug_removeTrailingNumber: typeof removeTrailingNumber;
+declare namespace slug {
+  export { slug_generateUniqueSlug as generateUniqueSlug, slug_removeTrailingNumber as removeTrailingNumber };
+}
+
+/**
+ * Converts a decimal number to an integer by multiplying it by 100.
+ * Commonly used to convert monetary values from dollars to cents.
+ *
+ * @param {number} value - The decimal number to convert (e.g., 10.90).
+ * @returns {number} The integer value in cents (e.g., 1090).
+ */
+declare const toCents: (value?: number) => number;
+/**
+ * Converts an integer back to a decimal by dividing it by 100.
+ * Commonly used to convert monetary values from cents to dollars.
+ *
+ * @param {number} value - The integer value in cents (e.g., 1090).
+ * @returns {number} The decimal value (e.g., 10.90).
+ */
+declare const toDecimal: (value?: number) => number;
+
+declare const number_toCents: typeof toCents;
+declare const number_toDecimal: typeof toDecimal;
+declare namespace number {
+  export { number_toCents as toCents, number_toDecimal as toDecimal };
+}
+
+export { createValidator, htmlEntityDecode, number as numberUtils, slug as slugUtils };

package/dist/index.js

@@ -1,3 +1,9 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
 // src/helpers/sanitize.ts
 import { FilterXSS } from "xss";
 var allTags = [
@@ -284,6 +290,21 @@ function createValidator() {
       }
       return validator;
     },
+    url(message) {
+      if (shouldSkipValidation()) {
+        return validator;
+      }
+      if (typeof current.value === "string") {
+        try {
+          new URL(current.value);
+        } catch {
+          current.pushError(message);
+        }
+      } else {
+        current.pushError(message);
+      }
+      return validator;
+    },
     uuid(message) {
       if (shouldSkipValidation()) {
         return validator;
@@ -425,7 +446,47 @@ function createValidator() {
     }
   };
 }
+
+// src/helpers/slug.ts
+var slug_exports = {};
+__export(slug_exports, {
+  generateUniqueSlug: () => generateUniqueSlug,
+  removeTrailingNumber: () => removeTrailingNumber
+});
+var generateUniqueSlug = (baseSlug, existingSlugs) => {
+  const suffixes = existingSlugs.map((slug) => {
+    const match = slug.match(new RegExp(`^${baseSlug}-(\\d+)$`));
+    return match ? Number(match[1]) : slug === baseSlug ? 0 : null;
+  }).filter((num) => num !== null);
+  const nextSuffix = suffixes.length > 0 ? Math.max(...suffixes) + 1 : 0;
+  return nextSuffix === 0 ? baseSlug : `${baseSlug}-${nextSuffix}`;
+};
+var removeTrailingNumber = (slug) => {
+  return slug.replace(/-\d+$/, "");
+};
+
+// src/helpers/number.ts
+var number_exports = {};
+__export(number_exports, {
+  toCents: () => toCents,
+  toDecimal: () => toDecimal
+});
+import Big from "big.js";
+var toCents = (value) => {
+  if (!value) {
+    return 0;
+  }
+  return new Big(value).mul(100).round(0).toNumber();
+};
+var toDecimal = (value) => {
+  if (!value) {
+    return 0;
+  }
+  return new Big(value).div(100).round(2).toNumber();
+};
 export {
   createValidator,
-  htmlEntityDecode
+  htmlEntityDecode,
+  number_exports as numberUtils,
+  slug_exports as slugUtils
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excofy/utils",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Biblioteca de utilitários para o Excofy",
   "main": "dist/index.js",
   "type": "module",
@@ -30,11 +30,13 @@
   "homepage": "https://github.com/excofy/utils#readme",
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
+    "@types/big.js": "^6.2.2",
     "@types/node": "^24.0.3",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3"
   },
   "dependencies": {
+    "big.js": "^7.0.1",
     "xss": "^1.0.15"
   },
   "publishConfig": {

package/src/helpers/number.ts

@@ -0,0 +1,31 @@
+import Big from 'big.js';
+
+/**
+ * Converts a decimal number to an integer by multiplying it by 100.
+ * Commonly used to convert monetary values from dollars to cents.
+ *
+ * @param {number} value - The decimal number to convert (e.g., 10.90).
+ * @returns {number} The integer value in cents (e.g., 1090).
+ */
+export const toCents = (value?: number): number => {
+  if (!value) {
+    return 0;
+  }
+
+  return new Big(value).mul(100).round(0).toNumber();
+};
+
+/**
+ * Converts an integer back to a decimal by dividing it by 100.
+ * Commonly used to convert monetary values from cents to dollars.
+ *
+ * @param {number} value - The integer value in cents (e.g., 1090).
+ * @returns {number} The decimal value (e.g., 10.90).
+ */
+export const toDecimal = (value?: number): number => {
+  if (!value) {
+    return 0;
+  }
+
+  return new Big(value).div(100).round(2).toNumber();
+};

package/src/helpers/slug.ts

@@ -0,0 +1,50 @@
+/**
+ * Generates a unique slug by appending a numeric suffix to the base slug if necessary.
+ *
+ * If the base slug is already used (either exactly or with a numeric suffix),
+ * the function finds the highest existing suffix and returns the next one in sequence.
+ *
+ * @example
+ * generateUniqueSlug('my-product', ['my-product', 'my-product-1', 'my-product-2'])
+ * // returns 'my-product-3'
+ *
+ * generateUniqueSlug('item', ['item-1', 'item-2'])
+ * // returns 'item'
+ *
+ * @param {string} baseSlug - The initial slug to use as a base.
+ * @param {string[]} existingSlugs - A list of existing slugs to avoid duplicates.
+ * @returns {string} A unique slug not present in the existingSlugs list.
+ */
+export const generateUniqueSlug = (
+  baseSlug: string,
+  existingSlugs: string[]
+): string => {
+  const suffixes = existingSlugs
+    .map((slug) => {
+      const match = slug.match(new RegExp(`^${baseSlug}-(\\d+)$`));
+      return match ? Number(match[1]) : slug === baseSlug ? 0 : null;
+    })
+    .filter((num): num is number => num !== null);
+
+  const nextSuffix = suffixes.length > 0 ? Math.max(...suffixes) + 1 : 0;
+
+  return nextSuffix === 0 ? baseSlug : `${baseSlug}-${nextSuffix}`;
+};
+
+/**
+ * Removes a trailing numeric suffix from a slug, if present.
+ *
+ * This is useful for extracting the base part of a slug before checking
+ * or generating new unique variations.
+ *
+ * @example
+ * removeTrailingNumber('product-3') // returns 'product'
+ * removeTrailingNumber('item')      // returns 'item'
+ *
+ * @param {string} slug - The slug from which to remove the trailing number.
+ * @returns {string} The slug without the trailing numeric suffix.
+ */
+
+export const removeTrailingNumber = (slug: string): string => {
+  return slug.replace(/-\d+$/, '');
+};

package/src/helpers/validator.ts

@@ -292,6 +292,24 @@ export function createValidator<
       return validator;
     },
 
+    url(message: string) {
+      if (shouldSkipValidation()) {
+        return validator;
+      }
+
+      if (typeof current.value === 'string') {
+        try {
+          new URL(current.value);
+        } catch {
+          current.pushError(message);
+        }
+      } else {
+        current.pushError(message);
+      }
+
+      return validator;
+    },
+
     uuid(message: string) {
       if (shouldSkipValidation()) {
         return validator;

package/src/index.ts

@@ -1,4 +1,6 @@
 import { createValidator } from './helpers/validator';
 import { htmlEntityDecode } from './helpers/sanitize';
+import * as slugUtils from './helpers/slug';
+import * as numberUtils from './helpers/number';
 
-export { createValidator, htmlEntityDecode };
+export { createValidator, htmlEntityDecode, slugUtils, numberUtils };