@excofy/utils 1.0.1 → 1.0.2

package/dist/index.cjs

@@ -311,6 +311,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;

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: {

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: {

package/dist/index.js

@@ -284,6 +284,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excofy/utils",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "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;