@excofy/utils 1.0.0 → 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;
@@ -341,6 +356,53 @@ function createValidator() {
         }
         return validator;
       }
+    },
+    asNumber(message) {
+      if (shouldSkipValidation()) return validator;
+      const value = current.value;
+      const num = typeof value === "number" ? value : Number(value);
+      if (Number.isNaN(num)) {
+        current.pushError(message);
+      } else {
+        current.value = num;
+        current.inputs[current.field] = num;
+      }
+      return validator;
+    },
+    asBoolean(message) {
+      if (shouldSkipValidation()) return validator;
+      const value = current.value;
+      let bool;
+      if (typeof value === "boolean") {
+        bool = value;
+      } else if (typeof value === "string") {
+        if (value.toLowerCase() === "true") bool = true;
+        else if (value.toLowerCase() === "false") bool = false;
+      }
+      if (typeof bool !== "boolean") {
+        current.pushError(message);
+      } else {
+        current.value = bool;
+        current.inputs[current.field] = bool;
+      }
+      return validator;
+    },
+    asStringArray(message) {
+      if (shouldSkipValidation()) return validator;
+      const value = current.value;
+      let arr;
+      if (Array.isArray(value)) {
+        arr = value.map((v) => String(v).trim());
+      } else if (typeof value === "string") {
+        arr = value.split(",").map((s) => s.trim()).filter(Boolean);
+      }
+      if (!arr || arr.some((item) => item === "")) {
+        current.pushError(message);
+      } else {
+        current.value = arr;
+        current.inputs[current.field] = arr;
+      }
+      return validator;
     }
   };
   return {

package/dist/index.d.cts

@@ -55,11 +55,15 @@ 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: {
                     youtube(message: string): /*elided*/ any;
                 };
+                asNumber(message: string): /*elided*/ any;
+                asBoolean(message: string): /*elided*/ any;
+                asStringArray(message: string): /*elided*/ any;
             };
         };
         isNotRequired(): {
@@ -75,11 +79,15 @@ 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: {
                     youtube(message: string): /*elided*/ any;
                 };
+                asNumber(message: string): /*elided*/ any;
+                asBoolean(message: string): /*elided*/ any;
+                asStringArray(message: string): /*elided*/ any;
             };
         };
     };

package/dist/index.d.ts

@@ -55,11 +55,15 @@ 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: {
                     youtube(message: string): /*elided*/ any;
                 };
+                asNumber(message: string): /*elided*/ any;
+                asBoolean(message: string): /*elided*/ any;
+                asStringArray(message: string): /*elided*/ any;
             };
         };
         isNotRequired(): {
@@ -75,11 +79,15 @@ 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: {
                     youtube(message: string): /*elided*/ any;
                 };
+                asNumber(message: string): /*elided*/ any;
+                asBoolean(message: string): /*elided*/ any;
+                asStringArray(message: string): /*elided*/ any;
             };
         };
     };

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;
@@ -314,6 +329,53 @@ function createValidator() {
         }
         return validator;
       }
+    },
+    asNumber(message) {
+      if (shouldSkipValidation()) return validator;
+      const value = current.value;
+      const num = typeof value === "number" ? value : Number(value);
+      if (Number.isNaN(num)) {
+        current.pushError(message);
+      } else {
+        current.value = num;
+        current.inputs[current.field] = num;
+      }
+      return validator;
+    },
+    asBoolean(message) {
+      if (shouldSkipValidation()) return validator;
+      const value = current.value;
+      let bool;
+      if (typeof value === "boolean") {
+        bool = value;
+      } else if (typeof value === "string") {
+        if (value.toLowerCase() === "true") bool = true;
+        else if (value.toLowerCase() === "false") bool = false;
+      }
+      if (typeof bool !== "boolean") {
+        current.pushError(message);
+      } else {
+        current.value = bool;
+        current.inputs[current.field] = bool;
+      }
+      return validator;
+    },
+    asStringArray(message) {
+      if (shouldSkipValidation()) return validator;
+      const value = current.value;
+      let arr;
+      if (Array.isArray(value)) {
+        arr = value.map((v) => String(v).trim());
+      } else if (typeof value === "string") {
+        arr = value.split(",").map((s) => s.trim()).filter(Boolean);
+      }
+      if (!arr || arr.some((item) => item === "")) {
+        current.pushError(message);
+      } else {
+        current.value = arr;
+        current.inputs[current.field] = arr;
+      }
+      return validator;
     }
   };
   return {

package/package.json

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

@@ -253,7 +253,6 @@ export function createValidator<
       current.inputs[current.field] = transformed as TRaw[keyof TRaw];
       return validator;
     },
-
     slug(message: string) {
       if (shouldSkipValidation()) {
         return validator;
@@ -293,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;
@@ -335,6 +352,71 @@ export function createValidator<
         return validator;
       },
     },
+
+    asNumber(message: string) {
+      if (shouldSkipValidation()) return validator;
+
+      const value = current.value;
+      const num = typeof value === 'number' ? value : Number(value);
+
+      if (Number.isNaN(num)) {
+        current.pushError(message);
+      } else {
+        current.value = num;
+        current.inputs[current.field] = num as TRaw[keyof TRaw];
+      }
+
+      return validator;
+    },
+
+    asBoolean(message: string) {
+      if (shouldSkipValidation()) return validator;
+
+      const value = current.value;
+
+      let bool: boolean | undefined;
+      if (typeof value === 'boolean') {
+        bool = value;
+      } else if (typeof value === 'string') {
+        if (value.toLowerCase() === 'true') bool = true;
+        else if (value.toLowerCase() === 'false') bool = false;
+      }
+
+      if (typeof bool !== 'boolean') {
+        current.pushError(message);
+      } else {
+        current.value = bool;
+        current.inputs[current.field] = bool as TRaw[keyof TRaw];
+      }
+
+      return validator;
+    },
+
+    asStringArray(message: string) {
+      if (shouldSkipValidation()) return validator;
+
+      const value = current.value;
+
+      let arr: string[] | undefined;
+
+      if (Array.isArray(value)) {
+        arr = value.map((v) => String(v).trim());
+      } else if (typeof value === 'string') {
+        arr = value
+          .split(',')
+          .map((s) => s.trim())
+          .filter(Boolean);
+      }
+
+      if (!arr || arr.some((item) => item === '')) {
+        current.pushError(message);
+      } else {
+        current.value = arr;
+        current.inputs[current.field] = arr as TRaw[keyof TRaw];
+      }
+
+      return validator;
+    },
   };
 
   return {